arize-phoenix 11.7.0__py3-none-any.whl → 11.8.0__py3-none-any.whl

{arize_phoenix-11.7.0.dist-info → arize_phoenix-11.8.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: arize-phoenix
-Version: 11.7.0
+Version: 11.8.0
 Summary: AI Observability and Evaluation
 Project-URL: Documentation, https://arize.com/docs/phoenix/
 Project-URL: Issues, https://github.com/Arize-ai/phoenix/issues
@@ -205,6 +205,7 @@ The `arize-phoenix` package includes the entire Phoenix platfom. However if you
 | [arize-phoenix-client](https://github.com/Arize-ai/phoenix/tree/main/packages/phoenix-client)       | Python [![PyPI Version](https://img.shields.io/pypi/v/arize-phoenix-client)](https://pypi.org/project/arize-phoenix-client/)                 | Lightweight client for interacting with the Phoenix server via its OpenAPI REST interface         |
 | [arize-phoenix-evals](https://github.com/Arize-ai/phoenix/tree/main/packages/phoenix-evals)         | Python [![PyPI Version](https://img.shields.io/pypi/v/arize-phoenix-evals)](https://pypi.org/project/arize-phoenix-evals/)                   | Tooling to evaluate LLM applications including RAG relevance, answer relevance, and more          |
 | [@arizeai/phoenix-client](https://github.com/Arize-ai/phoenix/tree/main/js/packages/phoenix-client) | JavaScript [![NPM Version](https://img.shields.io/npm/v/%40arizeai%2Fphoenix-client)](https://www.npmjs.com/package/@arizeai/phoenix-client) | Client for the Arize Phoenix API                                                                  |
+| [@arizeai/phoenix-evals](https://github.com/Arize-ai/phoenix/tree/main/js/packages/phoenix-evals)   | TypeScript [![NPM Version](https://img.shields.io/npm/v/%40arizeai%2Fphoenix-evals)](https://www.npmjs.com/package/@arizeai/phoenix-evals)   | TypeScript evaluation library for LLM applications (alpha release)                                |
 | [@arizeai/phoenix-mcp](https://github.com/Arize-ai/phoenix/tree/main/js/packages/phoenix-mcp)       | JavaScript [![NPM Version](https://img.shields.io/npm/v/%40arizeai%2Fphoenix-mcp)](https://www.npmjs.com/package/@arizeai/phoenix-mcp)       | MCP server implementation for Arize Phoenix providing unified interface to Phoenix's capabilities |
 
 ## Tracing Integrations
@@ -248,9 +249,20 @@ Phoenix is built on top of OpenTelemetry and is vendor, language, and framework
 | [BeeAI](https://arize.com/docs/phoenix/tracing/integrations-tracing/beeai)                 | `@arizeai/openinference-instrumentation-beeai`     | [![NPM Version](https://img.shields.io/npm/v/@arizeai/openinference-vercel)](https://www.npmjs.com/package/@arizeai/openinference-instrumentation-beeai)                            |
 | [Mastra](https://arize.com/docs/phoenix/integrations/mastra)                               | `@arizeai/openinference-mastra`                    | [![NPM Version](https://img.shields.io/npm/v/@arizeai/openinference-mastra.svg)](https://www.npmjs.com/package/@arizeai/openinference-mastra)                                       |
 
+### Java Integrations
+
+| Integration                                                                                                                       | Package                                     | Version Badge                                                                                                                                                                                                 |
+| --------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| [LangChain4j](https://github.com/Arize-ai/openinference/tree/main/java/instrumentation/openinference-instrumentation-langchain4j) | `openinference-instrumentation-langchain4j` | [![Maven Central](https://img.shields.io/maven-central/v/com.arize/openinference-instrumentation-langchain4j.svg)](https://central.sonatype.com/artifact/com.arize/openinference-instrumentation-langchain4j) |
+
 ### Platforms
 
-Phoenix has native integrations with [LangFlow](https://arize.com/docs/phoenix/tracing/integrations-tracing/langflow), LiteLLM Proxy, and [BeeAI](https://docs.beeai.dev/observability/agents-traceability).
+| Platform                                                                                                 | Description                                                    | Docs                                                                                                          |
+| -------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------- |
+| [Dify](https://docs.dify.ai/en/guides/monitoring/integrate-external-ops-tools/integrate-phoenix)         | Open-source LLM app development platform                       | [Integration Guide](https://docs.dify.ai/en/guides/monitoring/integrate-external-ops-tools/integrate-phoenix) |
+| [LangFlow](https://arize.com/docs/phoenix/tracing/integrations-tracing/langflow)                         | Visual framework for building multi-agent and RAG applications | [Integration Guide](https://arize.com/docs/phoenix/tracing/integrations-tracing/langflow)                     |
+| [BeeAI](https://docs.beeai.dev/observability/agents-traceability)                                        | AI agent framework with built-in observability                 | [Integration Guide](https://docs.beeai.dev/observability/agents-traceability)                                 |
+| [LiteLLM Proxy](https://docs.litellm.ai/docs/observability/phoenix_integration#using-with-litellm-proxy) | Proxy server for LLMs                                          | [Integration Guide](https://docs.litellm.ai/docs/observability/phoenix_integration#using-with-litellm-proxy)  |
 
 ## Community
 

{arize_phoenix-11.7.0.dist-info → arize_phoenix-11.8.0.dist-info}/RECORD

@@ -1,12 +1,12 @@
 phoenix/__init__.py,sha256=xkpXH76HFbEDCq8IhiFp-2GnEHx39xPMdOpV5Skew1w,5481
 phoenix/auth.py,sha256=yW78f1xWNjTE30ACGUM14nOd5BzkukhlzA9B45kSUkM,11053
-phoenix/config.py,sha256=Xir2ke9AZluThsYeaiq57a8GyQOuumjIqqqeCh8PKw8,60350
-phoenix/datetime_utils.py,sha256=fpISOdaeDBdfIa-psFp6FJyAUPWEsiT5s3-_aLV12bg,3576
+phoenix/config.py,sha256=NqSYbx1-Fdr0SSOt5RSQ5jmTz3r3xvGElVXvd9kK1gc,61495
+phoenix/datetime_utils.py,sha256=pRD-nzxXYKlMWNtd3r2tKGKfPFhwuJhfOAtlGLVAO60,8784
 phoenix/exceptions.py,sha256=n2L2KKuecrdflB9MsCdAYCiSEvGJptIsfRkXMoJle7A,169
 phoenix/py.typed,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
 phoenix/services.py,sha256=ngkyKGVatX3cO2WJdo2hKdaVKP-xJCMvqthvga6kJss,5196
 phoenix/settings.py,sha256=2kHfT3BNOVd4dAO1bq-syEQbHSG8oX2-7NhOwK2QREk,896
-phoenix/version.py,sha256=rSjRBQs9AcakQYnfj7YZFHQKbSsnq8BzM_MJeZ3UZ1M,23
+phoenix/version.py,sha256=i-ilTWt69mdcN4GqSDKAmTIOlguLxG2mm9Xhzz2U_aw,23
 phoenix/core/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 phoenix/core/embedding_dimension.py,sha256=zKGbcvwOXgLf-yrJBpQyKtd-LEOPRKHnUToyAU8Owis,87
 phoenix/core/model.py,sha256=qBFraOtmwCCnWJltKNP18DDG0mULXigytlFsa6YOz6k,4837
@@ -20,7 +20,7 @@ phoenix/db/constants.py,sha256=-YE2rkzcROG06_rerfnX5hC7fLzOHx1Gjw4nXhX_um4,46
 phoenix/db/engines.py,sha256=tB_8iWMDz0folryVvw29sbBUxJOB2XZ-Xx0Uexj3uns,6889
 phoenix/db/enums.py,sha256=w3O5YuJEEzVTwVDZb8b2UUFhU8yK_GosF081VVrrno0,188
 phoenix/db/facilitator.py,sha256=aRbkIJkIDP2zMsLKbO7Y8jJq4U2HbV7Lf6GYVWXVImU,20151
-phoenix/db/helpers.py,sha256=rbbHcl-STzcEpcXCYx6jbKzko7r3ggrWHHsXjZ48HsM,5352
+phoenix/db/helpers.py,sha256=dsGONSgkhmVtjMpJh-84KRVTf5uPdQ5c8O2AhUgHkRg,14150
 phoenix/db/migrate.py,sha256=oUrXH8yEbcpL4eh09aSCuUiSrhFli0eT5D_j4ZmYChY,2797
 phoenix/db/models.py,sha256=0avhbUmDEBZ1_NgBSr9Ck9BYxXtJTraPfQqDGZFE2-Y,60388
 phoenix/db/pg_config.py,sha256=h6mB7qF7t4Zk6VGvAiyefHGVu74o-yJynaWzeE39k9Y,6001
@@ -91,8 +91,8 @@ phoenix/pointcloud/pointcloud.py,sha256=SN_1wXZcwKrtSnHGZLDZGx71orqE1WyVF7E-D58d
 phoenix/pointcloud/projectors.py,sha256=TQgwc9cJDjJkin1WZyZzgl3HsYrLLiyWD7Czy4jNW3U,1088
 phoenix/pointcloud/umap_parameters.py,sha256=db_WEPoamuWtopZx7tQfAXPnoE0MS8FkAV0_ThjEx_Q,1735
 phoenix/server/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-phoenix/server/app.py,sha256=GwItmVRwSM5JspXIHwEO1hXjRAqQRQ4djZfbzJjnh3Q,46694
-phoenix/server/authorization.py,sha256=AGpQT6HpPn2ROOxxVBvjPV1393KF4v-K5IHJ4JaTOHM,2175
+phoenix/server/app.py,sha256=tB00x9r0PcCLYkvOtTQ7LqdSyw7jqy8OY5e7UVYl5UE,46951
+phoenix/server/authorization.py,sha256=OxROn7ibpKtCTrcgDkzWuNxVaQcSQ8MAx7zbjZiliK0,3201
 phoenix/server/bearer_auth.py,sha256=f4v4W94KyTdGGCPsK1tXOe0vouPuvanAEa03XSdCvPE,6650
 phoenix/server/dml_event.py,sha256=MjJmVEKytq75chBOSyvYDusUnEbg1pHpIjR3pZkUaJA,2838
 phoenix/server/dml_event_handler.py,sha256=gkDIONyTz9sLbSA6qOZCigiO5val-fvVcLzDrWNcVcg,8306
@@ -108,9 +108,9 @@ phoenix/server/thread_server.py,sha256=Ea2AWreN1lwJsT2wYvGaRaiXrzBqH4kgkZpx0FO5O
 phoenix/server/types.py,sha256=j8erl9iRNaR8t0DCQG84-uDVbHy9Qnm7T2EuTtDNNsU,8013
 phoenix/server/api/README.md,sha256=Pyq1PLPgTzXAswrfIhGXrjI3Skq8it2jTVnanT6Ba4Q,1162
 phoenix/server/api/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-phoenix/server/api/auth.py,sha256=6GgM0l_h7mbsP7WadE3PmPmqfeLw5TUnXDEfY3m8rkk,1600
+phoenix/server/api/auth.py,sha256=AyYhnZIbY9ALVjg2K6aC2UXSa3Pva5GVDBXyaZ3nD3o,2749
 phoenix/server/api/context.py,sha256=mqsq_8Ru50e-PxKWNTzh9zptb1PFjYFUf58uW59UYL0,8996
-phoenix/server/api/exceptions.py,sha256=TA0JuY2YRnj35qGuMSQ8d0ToHum9gWm9W--3fSKHrX0,1171
+phoenix/server/api/exceptions.py,sha256=E2W0x63CBzc0CoQPptrLr9nZxPF9zIP8MCJ3RuJMddw,1322
 phoenix/server/api/interceptor.py,sha256=ykDnoC_apUd-llVli3m1CW18kNSIgjz2qZ6m5JmPDu8,1294
 phoenix/server/api/queries.py,sha256=fvbdyhJ57I6DPrNEBkWwhw8BRF7DyIZ3LtYwXwI7yVw,45651
 phoenix/server/api/schema.py,sha256=fcs36xQwFF_Qe41_5cWR8wYpDvOrnbcyTeo5WNMbDsA,1702
@@ -152,7 +152,7 @@ phoenix/server/api/dataloaders/span_cost_detail_summary_entries_by_project_sessi
 phoenix/server/api/dataloaders/span_cost_detail_summary_entries_by_span.py,sha256=6I0Fdu2RYRm2gN64PYO3-bCY_e8vQX-BdOgoFFDjLCE,1723
 phoenix/server/api/dataloaders/span_cost_detail_summary_entries_by_trace.py,sha256=pxgMRFGLQHqf9swuJf7c-n5ONaE7k8NCJaqROa-QK3o,2067
 phoenix/server/api/dataloaders/span_cost_details_by_span_cost.py,sha256=f8ztQACGfKuf-nigyXiBUnGxXVzhNG9tOsPujxvOoX4,974
-phoenix/server/api/dataloaders/span_cost_summary_by_experiment.py,sha256=O3KVRgoAfuP32w2wmQdnXAa8GWnxm9wFJPqng9Ct2LQ,2577
+phoenix/server/api/dataloaders/span_cost_summary_by_experiment.py,sha256=EvivIoLsg1KxlRm4MM-LiInxFsRzqZpLarsvjyQk8e8,2453
 phoenix/server/api/dataloaders/span_cost_summary_by_experiment_run.py,sha256=IJFirEPeR1UGKTg6Gz3MJQGDigoPy6SaFnUdBibyVac,2539
 phoenix/server/api/dataloaders/span_cost_summary_by_generative_model.py,sha256=Fhp0NPsoSbTBgnE38hregVVeVHEhPw_QANiOfNyaTf8,2295
 phoenix/server/api/dataloaders/span_cost_summary_by_project.py,sha256=UjLkGvsVAY5-vltd08iR_NyWZ-_dWLc70yglMKSPPzY,5203
@@ -222,6 +222,7 @@ phoenix/server/api/input_types/PromptVersionInput.py,sha256=n6zBeSkK8ZFRHTjtVx4B
 phoenix/server/api/input_types/SpanAnnotationFilter.py,sha256=-djfIXYCxV6sV3GPOZQUV0SPfiWDhRlTORfeQ7tCBgQ,2671
 phoenix/server/api/input_types/SpanAnnotationSort.py,sha256=T5pAGzmh4MiJp9JMAzNDByFVTczfw02FH4WFWwFezyI,361
 phoenix/server/api/input_types/SpanSort.py,sha256=GReQx9yOo0Kehi2y4AtY69aZhRtcqvcg-9bSIFru69U,7540
+phoenix/server/api/input_types/TimeBinConfig.py,sha256=s4p0SNTGRY6rbHfZhEMwmon5zX85j-DbN06GkapF6jg,516
 phoenix/server/api/input_types/TimeRange.py,sha256=pwhC2jx6dFIgT0qFfnO68qiJp9-m7Je5QkNscNsuVxA,700
 phoenix/server/api/input_types/TraceAnnotationSort.py,sha256=BzwiUnMh2VsgQYnhDlbJ6ljHugqIS4YDUlYzvq_tl3o,365
 phoenix/server/api/input_types/UserRoleInput.py,sha256=xxhFe0ITZOgRVEJbVem_W6F1Ip_H6xDENdQqMMx-kKE,129
@@ -249,7 +250,7 @@ phoenix/server/api/openapi/schema.py,sha256=WGmHWSIyJhtc5EIh_M3vlXU-EgHkFuTlyVof
 phoenix/server/api/routers/__init__.py,sha256=YIzHsIFOOXuCRbDkMUHx-McrANFJK5UfUn6a4BNIzmo,277
 phoenix/server/api/routers/auth.py,sha256=nwoum3HKlrSkNF0MWN91rrsTcWMVKefGI9xPz9s0DGw,11604
 phoenix/server/api/routers/embeddings.py,sha256=BpZGJee0pdL0W5Rp1L0b30dEtZTgJeVqXky8LgZ0ZXw,898
-phoenix/server/api/routers/oauth2.py,sha256=EUoBeh4Ix-Uwt_q_RD75xbMcdVdd0xJLDYjELdVHBTw,24051
+phoenix/server/api/routers/oauth2.py,sha256=rwIqeJe4T5jK5NeuPAmrfNsbBqUZhMSFRNJdOJYyFPc,24445
 phoenix/server/api/routers/utils.py,sha256=M41BoH-fl37izhRuN2aX7lWm7jOC20A_3uClv9TVUUY,583
 phoenix/server/api/routers/v1/__init__.py,sha256=ngLMPjC7lgZxgKy_Is33KxTRnMzSqy25qTTChCVx_Mo,2696
 phoenix/server/api/routers/v1/annotation_configs.py,sha256=xp5lJmKYlRsINCUrRD9-lTAElw2v4hdFndS5BWrxICA,16048
@@ -276,7 +277,7 @@ phoenix/server/api/types/AuthMethod.py,sha256=M25usT6FCNKi-QFMdtMqRjJVGfq1ACnVoS
 phoenix/server/api/types/ChatCompletionMessageRole.py,sha256=kmQOilOlVntlmqbaHkqXZuimfljfYaHc3kbo53uK8_0,227
 phoenix/server/api/types/ChatCompletionSubscriptionPayload.py,sha256=G0YsirJzDMFDqEK7I_FCkPmIugAof-8D9fNfFlHdhjY,1031
 phoenix/server/api/types/Cluster.py,sha256=duX0pSC7P3YT1IztduuJtPsRj1x6oOOLfmWf2Y-FdEk,5699
-phoenix/server/api/types/CostBreakdown.py,sha256=YeLfvHSK4Ik-ApEmBqtLR1ZjGGZcazFXdjXVudpP45A,328
+phoenix/server/api/types/CostBreakdown.py,sha256=yw9dlb0blGIB_dWNP8yEvDHJztHjpiV6_CN7waC-ILY,292
 phoenix/server/api/types/CreateDatasetPayload.py,sha256=R-6zCmuD0f76RU9Giu78xwTHlASQs6Aq8yzvX1Kxc3g,140
 phoenix/server/api/types/CronExpression.py,sha256=R7oxuSSX_eTUHQWaoaSueQqWDmkkHr5dBKRN6q-6ROk,331
 phoenix/server/api/types/DataQualityMetric.py,sha256=Aieg3bHeBFaAf4mqeRcH1zT04sXAtQD8ATSHJt7FaBQ,1538
@@ -318,7 +319,7 @@ phoenix/server/api/types/ModelInterface.py,sha256=Qe7H23wDb_Q2-HmeY2t0R5Jsn4aAfY
 phoenix/server/api/types/NumericRange.py,sha256=afEjgF97Go_OvmjMggbPBt-zGM8IONewAyEiKEHRds0,192
 phoenix/server/api/types/PerformanceMetric.py,sha256=KFkmJDqP43eDUtARQOUqR7NYcxvL6Vh2uisHWU6H3ko,387
 phoenix/server/api/types/PlaygroundModel.py,sha256=IqJFxsAAJMRyaFI9ryI3GQrpFOJ5Llf6kIutEO-tFvM,321
-phoenix/server/api/types/Project.py,sha256=-Be5ZL0mBfCV2pTi6oKYt8napwQWiCnUjSGdoSfnSJU,31154
+phoenix/server/api/types/Project.py,sha256=byVCH6gG1o0G5OZwa4M_MA76HmfpPZQAugFcoTr8SfQ,41592
 phoenix/server/api/types/ProjectSession.py,sha256=uwqTsDTfSGz13AvP-cwS_mJR5JZ1lHqu10ungbl7g5s,6245
 phoenix/server/api/types/ProjectTraceRetentionPolicy.py,sha256=tYy2kgalPDyuaYZr0VUHjH0YpXaiF_QOzg5yfaV_c7c,3782
 phoenix/server/api/types/Prompt.py,sha256=ccP4eq1e38xbF0afclGWLOuDpBVpNbJ3AOSRClF8yFQ,4955
@@ -355,7 +356,7 @@ phoenix/server/api/types/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZ
 phoenix/server/api/types/node.py,sha256=BLl_IOFr0zrqUxaAtGLGui5aeM5VNVXFTzGeAKrztr0,822
 phoenix/server/api/types/pagination.py,sha256=BXm46gXZfrBS4hpiLvVSEdsbb29ctUMVJYjKXlOLxUA,9064
 phoenix/server/cost_tracking/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-phoenix/server/cost_tracking/cost_details_calculator.py,sha256=ywWQO6foRZC0CmbNPGpa3DaPoWzuIp3ke9s4NqHLuUw,8736
+phoenix/server/cost_tracking/cost_details_calculator.py,sha256=Tt0YcuLhgPuXKWJemWVmYQfG0xQUvH4VziIj6KcDnoA,8945
 phoenix/server/cost_tracking/cost_model_lookup.py,sha256=jhtVdnQBzrTUHeOGPWgOebk-Io5hpJ1vAgWOu8ojeJ4,6801
 phoenix/server/cost_tracking/helpers.py,sha256=Pk6ECjnYreTxrldtRwxnwFcxIPVsvDq_yAwDA_spkOc,2122
 phoenix/server/cost_tracking/model_cost_manifest.json,sha256=sMXOjssVwcJkmdMapA5-eYjXIboUu8FDosuXGL3q1Cw,53862
@@ -364,12 +365,12 @@ phoenix/server/cost_tracking/token_cost_calculator.py,sha256=2JEZnvusx2-xbhp8krp
 phoenix/server/daemons/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 phoenix/server/daemons/db_disk_usage_monitor.py,sha256=_MckKf9GbQ3Is4WZ3RmwJmvVElkF9Ipss3yNHjF8R3c,8016
 phoenix/server/daemons/generative_model_store.py,sha256=CkMG0jFWtxcUNP_7iFTgzHPyl5IgnXUwwJb7584pmkI,1566
-phoenix/server/daemons/span_cost_calculator.py,sha256=0BXMe9sHN8k5RjIQjCBzZdwvFuBHu8zDqAJc8rXbQA0,3199
+phoenix/server/daemons/span_cost_calculator.py,sha256=M7bG8fas99xz37bZUkBXnG37U2otUcu1-FI5RmrtPgU,3052
 phoenix/server/email/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-phoenix/server/email/sender.py,sha256=mTZUdf_M9GRiA2_MXmWO6hXvQHXbuRUyea-_YoTC5Mo,4974
+phoenix/server/email/sender.py,sha256=qUurj76b9IKFEbYsKO7lB7Lxie3GOFrnhZ5ahBzFaCs,5048
 phoenix/server/email/types.py,sha256=f1XXk4OQJlLSCHweujrGlkZic7CtbUSnfdPXzqP9WRI,772
 phoenix/server/email/templates/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-phoenix/server/email/templates/db_disk_usage_notification.html,sha256=VsGW_yPXPgspwp_xhFYANoqDENaO3En36qSw26l4fh4,733
+phoenix/server/email/templates/db_disk_usage_notification.html,sha256=Atv2XnKkC7HasTTCZYAWySr7VbupAGwbIiJ9eQ4r2l0,906
 phoenix/server/email/templates/password_reset.html,sha256=jv0Pe-06JloPZcubRWxPdAFHYEn9eDj_4SjmuoIwshI,441
 phoenix/server/email/templates/welcome.html,sha256=AyVsIOtpmyYwWmmkXjuEgXwkbsag4YHHKfkmOTiNo-M,316
 phoenix/server/middleware/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -385,16 +386,16 @@ phoenix/server/static/apple-touch-icon-76x76.png,sha256=CT_xT12I0u2i0WU8JzBZBuOQ
 phoenix/server/static/apple-touch-icon.png,sha256=fOfpjqGpWYbJ0eAurKsyoZP1EAs6ZVooBJ_SGk2ZkDs,3801
 phoenix/server/static/favicon.ico,sha256=bY0vvCKRftemZfPShwZtE93DiiQdaYaozkPGwNFr6H8,34494
 phoenix/server/static/modernizr.js,sha256=mvK-XtkNqjOral-QvzoqsyOMECXIMu5BQwSVN_wcU9c,2564
-phoenix/server/static/.vite/manifest.json,sha256=ds-n_Eo2eRbzplNS-h2Dzaj-_lbPCBYySCioOAnl4uA,2165
-phoenix/server/static/assets/components-J3qjrjBf.js,sha256=Za9a7UixoZeWyxhjTMt9iJ4nPnHB7qoQp1ADPYy_gXg,613734
-phoenix/server/static/assets/index-CEObsQf_.js,sha256=N77fIXIIiRijOKu6RNWX3dozZj0ewUASn1BC639Nyi0,61724
-phoenix/server/static/assets/pages-CW1UdBht.js,sha256=Y9ZOHX-y5Hpdwmy_EKZULiebIsK_KQAjVwmToCvHSW4,1148455
-phoenix/server/static/assets/vendor-BnPh9i9e.js,sha256=K_Ewiog0baSwYbnjeDO5efkeYEi7FRYTiRLmD4_oLaw,2738792
+phoenix/server/static/.vite/manifest.json,sha256=TyIBjaXaDHUOqmU0l4oXKq2CPJP8mvLfjzljq2lvLSI,2165
+phoenix/server/static/assets/components-5M9nebi4.js,sha256=q_bd0ZLoJNT4GRB6t3HlPFge6BE7_Zm0Ba1pPMszXho,617280
+phoenix/server/static/assets/index-OU2WTnGN.js,sha256=Ffe2oGJzh4KIQBhqrGMSJmLB0IDtzQZqTzEHCfJ1n00,61725
+phoenix/server/static/assets/pages-DF8rqxJ4.js,sha256=2SsqPLQAtFywkipQhDy-Vvp6Xyud-DDhHGb-85JYzSQ,1150693
+phoenix/server/static/assets/vendor-Bl7CyFDw.js,sha256=RX9lDZywB-FfD-MNfY5KYxVVq5laI2AcmH9rhVuCsnE,2739824
 phoenix/server/static/assets/vendor-WIZid84E.css,sha256=spZD2r7XL5GfLO13ln-IuXfnjAref8l6g_n_AvxxOlI,5517
-phoenix/server/static/assets/vendor-arizeai-Cr9o_Iu_.js,sha256=kybhi48Pux2UUA1gfmDGLDkwRbWyLwwAIS_F7pUMOXE,176579
-phoenix/server/static/assets/vendor-codemirror-k3zCIjlN.js,sha256=zuUSept08wa_k0xCJ-XtMhLVyerrbRZKXkn5Qxtd8GQ,781264
-phoenix/server/static/assets/vendor-recharts-BdblEuGB.js,sha256=JjY_9IvRxXNz-fXWV-ddK4BzNOejSLq0ql_lOacO8Ec,282150
-phoenix/server/static/assets/vendor-shiki-DPtuv2M4.js,sha256=8JbN-Qx5EiaQw_FgHLDqVhDsJ7gDgCFJDQXrZ8imczY,8980312
+phoenix/server/static/assets/vendor-arizeai-B_viEUUA.js,sha256=ir0WQ2dSxIEhK6wDi7A1FKPaG7Bmgze_V5S7RfBxFBM,167428
+phoenix/server/static/assets/vendor-codemirror-vlcH1_iR.js,sha256=BFxUiyr9u03kekfUjR4JIVR1D8-VnZjUo8bjmAigUtw,781264
+phoenix/server/static/assets/vendor-recharts-C9cQu72o.js,sha256=fm3quX1HWJ9sbIZhDrHsnZZpSg0LhsQtMV21NB5MPTM,282150
+phoenix/server/static/assets/vendor-shiki-BsknB7bv.js,sha256=5X-FxGYbuoFMIfOtX9LD9Qju-2oT1smMbgYyoHprI7k,8980312
 phoenix/server/static/assets/vendor-three-C5WAXd5r.js,sha256=ELkg06u70N7h8oFmvqdoHyPuUf9VgGEWeT4LKFx4VWo,620975
 phoenix/server/templates/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 phoenix/server/templates/index.html,sha256=rTdJZOlbZmm1dMCrHWikAwcecZDxduPU5zCFd2h2cbs,6819
@@ -435,9 +436,9 @@ phoenix/utilities/project.py,sha256=auVpARXkDb-JgeX5f2aStyFIkeKvGwN9l7qrFeJMVxI,
 phoenix/utilities/re.py,sha256=6YyUWIkv0zc2SigsxfOWIHzdpjKA_TZo2iqKq7zJKvw,2081
 phoenix/utilities/span_store.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 phoenix/utilities/template_formatters.py,sha256=gh9PJD6WEGw7TEYXfSst1UR4pWWwmjxMLrDVQ_CkpkQ,2779
-arize_phoenix-11.7.0.dist-info/METADATA,sha256=zbc4IVpy2eyDH5X8918cyrIj3FgCFtlXtyE_4nP_QIU,27804
-arize_phoenix-11.7.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-arize_phoenix-11.7.0.dist-info/entry_points.txt,sha256=Pgpn8Upxx9P8z8joPXZWl2LlnAlGc3gcQoVchb06X1Q,94
-arize_phoenix-11.7.0.dist-info/licenses/IP_NOTICE,sha256=JBqyyCYYxGDfzQ0TtsQgjts41IJoa-hiwDrBjCb9gHM,469
-arize_phoenix-11.7.0.dist-info/licenses/LICENSE,sha256=HFkW9REuMOkvKRACuwLPT0hRydHb3zNg-fdFt94td18,3794
-arize_phoenix-11.7.0.dist-info/RECORD,,
+arize_phoenix-11.8.0.dist-info/METADATA,sha256=QEqV4jJ6yjmlUIiyR2119BCyHw-Hi-pH6wm6rUc5c8k,30850
+arize_phoenix-11.8.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+arize_phoenix-11.8.0.dist-info/entry_points.txt,sha256=Pgpn8Upxx9P8z8joPXZWl2LlnAlGc3gcQoVchb06X1Q,94
+arize_phoenix-11.8.0.dist-info/licenses/IP_NOTICE,sha256=JBqyyCYYxGDfzQ0TtsQgjts41IJoa-hiwDrBjCb9gHM,469
+arize_phoenix-11.8.0.dist-info/licenses/LICENSE,sha256=HFkW9REuMOkvKRACuwLPT0hRydHb3zNg-fdFt94td18,3794
+arize_phoenix-11.8.0.dist-info/RECORD,,

phoenix/config.py

@@ -246,7 +246,14 @@ The URL to use for redirecting to a management interface that may be hosting Pho
 the current user is within PHOENIX_ADMINS, a link will be added to the navigation menu to return to
 this URL.
 """
+ENV_PHOENIX_SUPPORT_EMAIL = "PHOENIX_SUPPORT_EMAIL"
+"""
+The support email address to display in error messages and notifications.
 
+When set, this email will be included in error messages for insufficient storage
+conditions and database usage notification emails, providing users with a direct
+contact for assistance. If not set, error messages will not include contact information.
+"""
 
 # SMTP settings
 ENV_PHOENIX_SMTP_HOSTNAME = "PHOENIX_SMTP_HOSTNAME"
@@ -1599,6 +1606,31 @@ def get_env_management_url() -> Optional[str]:
     return getenv(ENV_PHOENIX_MANAGEMENT_URL)
 
 
+def get_env_support_email() -> Optional[str]:
+    """
+    Get the support email address from the PHOENIX_SUPPORT_EMAIL environment variable.
+
+    Returns:
+        The support email address if set, None otherwise.
+    """
+    return getenv(ENV_PHOENIX_SUPPORT_EMAIL)
+
+
+def validate_env_support_email() -> None:
+    """
+    Validate the support email address configured in PHOENIX_SUPPORT_EMAIL.
+
+    Raises:
+        ValueError: If the email address is invalid.
+    """
+    if not (email := get_env_support_email()):
+        return
+    try:
+        validate_email(email, check_deliverability=False)
+    except EmailNotValidError as e:
+        raise ValueError(f"Invalid email in {ENV_PHOENIX_SUPPORT_EMAIL}: '{email}'") from e
+
+
 def verify_server_environment_variables() -> None:
     """Verify that the environment variables are set correctly. Raises an error otherwise."""
     get_env_root_url()
@@ -1607,6 +1639,7 @@ def verify_server_environment_variables() -> None:
     get_env_database_allocated_storage_capacity_gibibytes()
     get_env_database_usage_email_warning_threshold_percentage()
     get_env_database_usage_insertion_blocking_threshold_percentage()
+    validate_env_support_email()
 
     # Notify users about deprecated environment variables if they are being used.
     if os.getenv("PHOENIX_ENABLE_WEBSOCKETS") is not None:

phoenix/datetime_utils.py

@@ -1,5 +1,5 @@
 from datetime import datetime, timedelta, timezone, tzinfo
-from typing import Any, Optional, cast
+from typing import Any, Iterator, Literal, Optional, cast
 
 import pandas as pd
 import pytz
@@ -10,6 +10,7 @@ from pandas.core.dtypes.common import (
     is_numeric_dtype,
     is_object_dtype,
 )
+from typing_extensions import assert_never
 
 _LOCAL_TIMEZONE = datetime.now(timezone.utc).astimezone().tzinfo
 
@@ -113,3 +114,113 @@ def is_timezone_aware(dt: datetime) -> bool:
     Returns True if the datetime is timezone-aware, False otherwise.
     """
     return dt.tzinfo is not None and dt.tzinfo.utcoffset(dt) is not None
+
+
+def get_timestamp_range(
+    start_time: datetime,
+    end_time: datetime,
+    stride: Literal["minute", "hour", "day", "week", "month", "year"] = "minute",
+    utc_offset_minutes: int = 0,
+) -> Iterator[datetime]:
+    """
+    Generate a sequence of datetime objects at regular intervals between start and end times.
+
+    This function creates time intervals by rounding down the start time to the nearest
+    stride boundary in the specified timezone, then yielding timestamps at regular
+    intervals until reaching the end time. All returned timestamps are in UTC.
+
+    Args:
+        start_time: The starting datetime (inclusive after rounding down to stride boundary).
+                   Must be timezone-aware.
+        end_time: The ending datetime (exclusive). Must be timezone-aware.
+        stride: The interval between generated timestamps. Options:
+               - "minute": Generate timestamps every minute
+               - "hour": Generate timestamps every hour
+               - "day": Generate timestamps every day at midnight
+               - "week": Generate timestamps every week at Monday midnight
+               - "month": Generate timestamps on the 1st of each month at midnight
+               - "year": Generate timestamps on January 1st of each year at midnight
+        utc_offset_minutes: Timezone offset in minutes from UTC. Used to determine
+                           the correct stride boundaries in local time. Positive values
+                           are east of UTC, negative values are west of UTC.
+
+    Returns:
+        Iterator of datetime objects in UTC timezone, spaced at the specified stride
+        interval. The first timestamp is rounded down to the nearest stride boundary
+        in the local timezone (considering utc_offset_minutes).
+
+    Examples:
+        >>> from datetime import datetime, timezone
+        >>> start = datetime(2024, 1, 1, 12, 30, 45, tzinfo=timezone.utc)
+        >>> end = datetime(2024, 1, 1, 12, 33, 0, tzinfo=timezone.utc)
+        >>> list(get_timestamp_range(start, end, "minute"))
+        [datetime(2024, 1, 1, 12, 30, tzinfo=timezone.utc),
+         datetime(2024, 1, 1, 12, 31, tzinfo=timezone.utc),
+         datetime(2024, 1, 1, 12, 32, tzinfo=timezone.utc)]
+
+        >>> # Week stride rounds down to Monday
+        >>> start = datetime(2024, 1, 10, 12, 0, tzinfo=timezone.utc)  # Wednesday
+        >>> end = datetime(2024, 1, 22, 0, 0, tzinfo=timezone.utc)
+        >>> list(get_timestamp_range(start, end, "week"))
+        [datetime(2024, 1, 8, 0, 0, tzinfo=timezone.utc),   # Monday
+         datetime(2024, 1, 15, 0, 0, tzinfo=timezone.utc)]  # Next Monday
+
+    Note:
+        - If end_time <= start_time (after rounding), returns an empty iterator
+        - Week intervals always start on Monday (weekday 0)
+        - Month intervals handle variable month lengths correctly including leap years
+        - The function works in local timezone for stride calculations but returns UTC
+    """
+    if not is_timezone_aware(start_time) or not is_timezone_aware(end_time):
+        raise ValueError("start_time and end_time must be timezone-aware")
+
+    # Apply UTC offset to work in local timezone
+    offset_delta = timedelta(minutes=utc_offset_minutes)
+    local_start_time = start_time + offset_delta
+
+    # round down start_time to the nearest stride in local timezone
+    if stride == "minute":
+        t = local_start_time.replace(second=0, microsecond=0)
+    elif stride == "hour":
+        t = local_start_time.replace(minute=0, second=0, microsecond=0)
+    elif stride == "day":
+        t = local_start_time.replace(hour=0, minute=0, second=0, microsecond=0)
+    elif stride == "week":
+        # Round down to the beginning of the week (Monday)
+        days_since_monday = local_start_time.weekday()
+        t = local_start_time.replace(hour=0, minute=0, second=0, microsecond=0) - timedelta(
+            days=days_since_monday
+        )
+    elif stride == "month":
+        t = local_start_time.replace(day=1, hour=0, minute=0, second=0, microsecond=0)
+    elif stride == "year":
+        t = local_start_time.replace(month=1, day=1, hour=0, minute=0, second=0, microsecond=0)
+    else:
+        assert_never(stride)
+
+    # Convert back to UTC for comparisons and yielding
+    local_end_time = end_time + offset_delta
+
+    while t < local_end_time:
+        # Yield timestamp converted back to UTC
+        yield t - offset_delta
+        if stride == "minute":
+            t += timedelta(minutes=1)
+        elif stride == "hour":
+            t += timedelta(hours=1)
+        elif stride == "day":
+            t += timedelta(days=1)
+        elif stride == "week":
+            t += timedelta(weeks=1)
+        elif stride == "month":
+            next_month = t.month % 12 + 1
+            next_year = t.year + (t.month // 12)
+            t = t.replace(
+                year=next_year, month=next_month, day=1, hour=0, minute=0, second=0, microsecond=0
+            )
+        elif stride == "year":
+            t = t.replace(
+                year=t.year + 1, month=1, day=1, hour=0, minute=0, second=0, microsecond=0
+            )
+        else:
+            assert_never(stride)

phoenix/db/helpers.py

@@ -1,7 +1,9 @@
 from collections.abc import Callable, Hashable, Iterable
+from datetime import datetime
 from enum import Enum
-from typing import Any, Optional, TypeVar
+from typing import Any, Literal, Optional, TypeVar, Union
 
+import sqlalchemy as sa
 from openinference.semconv.trace import (
     OpenInferenceSpanKindValues,
     RerankerAttributes,
@@ -17,6 +19,7 @@ from sqlalchemy import (
     func,
     select,
 )
+from sqlalchemy.orm import QueryableAttribute
 from typing_extensions import assert_never
 
 from phoenix.config import PLAYGROUND_PROJECT_NAME
@@ -173,3 +176,155 @@ def exclude_experiment_projects(
             models.Experiment.project_name != PLAYGROUND_PROJECT_NAME,
         ),
     ).where(models.Experiment.project_name.is_(None))
+
+
+def date_trunc(
+    dialect: SupportedSQLDialect,
+    field: Literal["minute", "hour", "day", "week", "month", "year"],
+    source: Union[QueryableAttribute[datetime], sa.TextClause],
+    utc_offset_minutes: int = 0,
+) -> SQLColumnExpression[datetime]:
+    """
+    Truncate a datetime to the specified field with optional UTC offset adjustment.
+
+    This function provides a cross-dialect way to truncate datetime values to a specific
+    time unit (minute, hour, day, week, month, or year). It handles UTC offset conversion
+    by applying the offset before truncation and then converting back to UTC.
+
+    Args:
+        dialect: The SQL dialect to use (PostgreSQL or SQLite).
+        field: The time unit to truncate to. Valid values are:
+            - "minute": Truncate to the start of the minute (seconds set to 0)
+            - "hour": Truncate to the start of the hour (minutes and seconds set to 0)
+            - "day": Truncate to the start of the day (time set to 00:00:00)
+            - "week": Truncate to the start of the week (Monday at 00:00:00)
+            - "month": Truncate to the first day of the month (day set to 1, time to 00:00:00)
+            - "year": Truncate to the first day of the year (date set to Jan 1, time to 00:00:00)
+        source: The datetime column or expression to truncate.
+        utc_offset_minutes: UTC offset in minutes to apply before truncation.
+            Positive values represent time zones ahead of UTC (e.g., +60 for UTC+1).
+            Negative values represent time zones behind UTC (e.g., -300 for UTC-5).
+            Defaults to 0 (no offset).
+
+    Returns:
+        A SQL column expression representing the truncated datetime in UTC.
+
+    Note:
+        - For PostgreSQL, uses the native `date_trunc` function with timezone support.
+        - For SQLite, implements custom truncation logic using datetime functions.
+        - Week truncation starts on Monday (ISO 8601 standard).
+        - The result is always returned in UTC, regardless of the input offset.
+
+    Examples:
+        >>> # Truncate to hour with no offset
+        >>> date_trunc(SupportedSQLDialect.POSTGRESQL, "hour", Span.start_time)
+
+        >>> # Truncate to day with UTC-5 offset (Eastern Time)
+        >>> date_trunc(SupportedSQLDialect.SQLITE, "day", Span.start_time, -300)
+    """
+    if dialect is SupportedSQLDialect.POSTGRESQL:
+        # Note: the usage of the timezone parameter in the form of e.g. "+05:00"
+        # appears to be an undocumented feature of PostgreSQL's date_trunc function.
+        # Below is an example query and its output executed on PostgreSQL v12 and v17.
+        # SELECT date_trunc('day', TIMESTAMP WITH TIME ZONE '2001-02-16 15:38:40-05'),
+        #        date_trunc('day', TIMESTAMP WITH TIME ZONE '2001-02-16 20:38:40+00', '+05:00'),
+        #        date_trunc('day', TIMESTAMP WITH TIME ZONE '2001-02-16 20:38:40+00', '-05:00');
+        # ┌────────────────────────┬────────────────────────┬────────────────────────┐
+        # │       date_trunc       │       date_trunc       │       date_trunc       │
+        # ├────────────────────────┼────────────────────────┼────────────────────────┤
+        # │ 2001-02-16 00:00:00+00 │ 2001-02-16 05:00:00+00 │ 2001-02-16 19:00:00+00 │
+        # └────────────────────────┴────────────────────────┴────────────────────────┘
+        # (1 row)
+        sign = "-" if utc_offset_minutes >= 0 else "+"
+        timezone = f"{sign}{abs(utc_offset_minutes) // 60}:{abs(utc_offset_minutes) % 60:02d}"
+        return sa.func.date_trunc(field, source, timezone)
+    elif dialect is SupportedSQLDialect.SQLITE:
+        return _date_trunc_for_sqlite(field, source, utc_offset_minutes)
+    else:
+        assert_never(dialect)
+
+
+def _date_trunc_for_sqlite(
+    field: Literal["minute", "hour", "day", "week", "month", "year"],
+    source: Union[QueryableAttribute[datetime], sa.TextClause],
+    utc_offset_minutes: int = 0,
+) -> SQLColumnExpression[datetime]:
+    """
+    SQLite-specific implementation of datetime truncation with UTC offset handling.
+
+    This private helper function implements date truncation for SQLite databases, which
+    lack a native date_trunc function. It uses SQLite's datetime and strftime functions
+    to achieve the same result as PostgreSQL's date_trunc function.
+
+    Args:
+        field: The time unit to truncate to. Valid values are:
+            - "minute": Truncate to the start of the minute (seconds set to 0)
+            - "hour": Truncate to the start of the hour (minutes and seconds set to 0)
+            - "day": Truncate to the start of the day (time set to 00:00:00)
+            - "week": Truncate to the start of the week (Monday at 00:00:00)
+            - "month": Truncate to the first day of the month (day set to 1, time to 00:00:00)
+            - "year": Truncate to the first day of the year (date set to Jan 1, time to 00:00:00)
+        source: The datetime column or expression to truncate.
+        utc_offset_minutes: UTC offset in minutes to apply before truncation.
+            Positive values represent time zones ahead of UTC (e.g., +60 for UTC+1).
+            Negative values represent time zones behind UTC (e.g., -300 for UTC-5).
+
+    Returns:
+        A SQL column expression representing the truncated datetime in UTC.
+
+    Implementation Details:
+        - Uses SQLite's strftime() function to format and extract date components
+        - Applies UTC offset before truncation using datetime(source, "N minutes")
+        - Converts result back to UTC by subtracting the offset
+        - Week truncation uses day-of-week calculations where:
+            * strftime('%w') returns 0=Sunday, 1=Monday, ..., 6=Saturday
+            * Truncates to Monday (start of week) using case-based day adjustments
+        - Month/year truncation reconstructs dates using extracted components
+
+    Raises:
+        ValueError: If the field parameter is not one of the supported values.
+
+    Note:
+        This is a private helper function intended only for use by the date_trunc function
+        when the dialect is SupportedSQLDialect.SQLITE.
+    """
+    # SQLite does not have a built-in date truncation function, so we use datetime functions
+    # First apply UTC offset, then truncate
+    offset_source = func.datetime(source, f"{utc_offset_minutes} minutes")
+
+    if field == "minute":
+        t = func.datetime(func.strftime("%Y-%m-%d %H:%M:00", offset_source))
+    elif field == "hour":
+        t = func.datetime(func.strftime("%Y-%m-%d %H:00:00", offset_source))
+    elif field == "day":
+        t = func.datetime(func.strftime("%Y-%m-%d 00:00:00", offset_source))
+    elif field == "week":
+        # Truncate to Monday (start of week)
+        # SQLite strftime('%w') returns: 0=Sunday, 1=Monday, ..., 6=Saturday
+        dow = func.strftime("%w", offset_source)
+        t = func.datetime(
+            case(
+                (dow == "0", func.date(offset_source, "-6 days")),  # Sunday -> go back 6 days
+                (dow == "1", func.date(offset_source, "+0 days")),  # Monday -> stay
+                (dow == "2", func.date(offset_source, "-1 days")),  # Tuesday -> go back 1 day
+                (dow == "3", func.date(offset_source, "-2 days")),  # Wednesday -> go back 2 days
+                (dow == "4", func.date(offset_source, "-3 days")),  # Thursday -> go back 3 days
+                (dow == "5", func.date(offset_source, "-4 days")),  # Friday -> go back 4 days
+                (dow == "6", func.date(offset_source, "-5 days")),  # Saturday -> go back 5 days
+            ),
+            "00:00:00",
+        )
+    elif field == "month":
+        # Extract year and month, then construct first day of month
+        year = func.strftime("%Y", offset_source)
+        month = func.strftime("%m", offset_source)
+        t = func.datetime(year + "-" + month + "-01 00:00:00")
+    elif field == "year":
+        # Extract year, then construct first day of year
+        year = func.strftime("%Y", offset_source)
+        t = func.datetime(year + "-01-01 00:00:00")
+    else:
+        raise ValueError(f"Unsupported field for date truncation: {field}")
+
+    # Convert back to UTC by subtracting the offset
+    return func.datetime(t, f"{-utc_offset_minutes} minutes")

phoenix/server/api/auth.py

@@ -3,8 +3,10 @@ from typing import Any
 
 from strawberry import Info
 from strawberry.permission import BasePermission
+from typing_extensions import override
 
-from phoenix.server.api.exceptions import Unauthorized
+from phoenix.config import get_env_support_email
+from phoenix.server.api.exceptions import InsufficientStorage, Unauthorized
 from phoenix.server.bearer_auth import PhoenixUser
 
 
@@ -20,15 +22,35 @@ class IsNotReadOnly(Authorization):
         return not info.context.read_only
 
 
-class IsLocked(Authorization):
-    """
-    Disables mutations and subscriptions that create or update data but allows
-    queries and delete mutations.
+class IsLocked(BasePermission):
     """
+    Permission class that restricts data-modifying operations when insufficient storage.
+
+    When database storage capacity is exceeded, this permission blocks mutations and
+    subscriptions that create or update data, while allowing queries and delete mutations
+    to continue. This prevents database overflow while maintaining read access and the
+    ability to free up space through deletions.
 
-    message = "Operations that write or modify data are locked"
+    Raises:
+        InsufficientStorage: When storage capacity is exceeded and data operations
+            are temporarily disabled. The error includes guidance for resolution
+            and support contact information if configured.
+    """
 
+    @override
+    def on_unauthorized(self) -> None:
+        """Create user-friendly error message when storage operations are blocked."""
+        message = (
+            "Database operations are disabled due to insufficient storage. "
+            "Please delete old data or increase storage."
+        )
+        if support_email := get_env_support_email():
+            message += f" Need help? Contact us at {support_email}"
+        raise InsufficientStorage(message)
+
+    @override
     def has_permission(self, source: Any, info: Info, **kwargs: Any) -> bool:
+        """Check if database operations are allowed based on storage capacity and lock status."""
         return not (info.context.db.should_not_insert_or_update or info.context.locked)