arize-phoenix 11.14.0__tar.gz → 11.16.0__tar.gz

{arize_phoenix-11.14.0 → arize_phoenix-11.16.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: arize-phoenix
-Version: 11.14.0
+Version: 11.16.0
 Summary: AI Observability and Evaluation
 Project-URL: Documentation, https://arize.com/docs/phoenix/
 Project-URL: Issues, https://github.com/Arize-ai/phoenix/issues

{arize_phoenix-11.14.0 → arize_phoenix-11.16.0}/pyproject.toml

@@ -302,6 +302,7 @@ target-version = "py39"
 [tool.ruff.lint.per-file-ignores]
 "*.ipynb" = ["E402", "E501"]
 "examples/**/*.py" = ["E501"]
+"tests/**/*.py" = ["E501"]
 
 [tool.ruff.lint]
 select = ["E", "F", "W", "I", "NPY201"]

{arize_phoenix-11.14.0 → arize_phoenix-11.16.0}/src/phoenix/config.py

@@ -57,6 +57,11 @@ ENV_PHOENIX_FULLSTORY_ORG = "PHOENIX_FULLSTORY_ORG"
 The FullStory organization ID for web analytics tracking. When set, FullStory tracking
 will be enabled in the Phoenix web interface.
 """
+ENV_PHOENIX_ALLOW_EXTERNAL_RESOURCES = "PHOENIX_ALLOW_EXTERNAL_RESOURCES"
+"""
+Allows calls to external resources, like Google Fonts in the web interface
+Defaults to True. Set to False in air-gapped environments to prevent external requests.
+"""
 ENV_PHOENIX_SQL_DATABASE_URL = "PHOENIX_SQL_DATABASE_URL"
 """
 The SQL database URL to use when logging traces and evals.
@@ -1690,3 +1695,11 @@ def _validate_file_exists_and_is_readable(
             f.read(1)  # Read just one byte to verify readability
     except Exception as e:
         raise ValueError(f"{description} file is not readable: {e}")
+
+
+def get_env_allow_external_resources() -> bool:
+    """
+    Gets the value of the PHOENIX_ALLOW_EXTERNAL_RESOURCES environment variable.
+    Defaults to True if not set.
+    """
+    return _bool_val(ENV_PHOENIX_ALLOW_EXTERNAL_RESOURCES, True)

{arize_phoenix-11.14.0 → arize_phoenix-11.16.0}/src/phoenix/db/models.py

@@ -841,6 +841,41 @@ def _(element: Any, compiler: Any, **kw: Any) -> Any:
     return compiler.process(func.text_contains(string, substring) > 0, **kw)
 
 
+class CaseInsensitiveContains(expression.FunctionElement[bool]):
+    # See https://docs.sqlalchemy.org/en/20/core/compiler.html
+    inherit_cache = True
+    type = Boolean()
+    name = "case_insensitive_contains"
+
+
+@compiles(CaseInsensitiveContains)
+def _(element: Any, compiler: Any, **kw: Any) -> Any:
+    string, substring = list(element.clauses)
+    result = compiler.process(func.lower(string).contains(func.lower(substring)), **kw)
+    return result
+
+
+@compiles(CaseInsensitiveContains, "postgresql")
+def _(element: Any, compiler: Any, **kw: Any) -> Any:
+    string, substring = list(element.clauses)
+    escaped = func.replace(
+        func.replace(func.replace(substring, "\\", "\\\\"), "%", "\\%"), "_", "\\_"
+    )
+    pattern = func.concat("%", escaped, "%")
+    result = compiler.process(string.ilike(pattern), **kw)
+    return result
+
+
+@compiles(CaseInsensitiveContains, "sqlite")
+def _(element: Any, compiler: Any, **kw: Any) -> Any:
+    # Use sqlean's `text_lower` to handle non-ASCII characters
+    string, substring = list(element.clauses)
+    result = compiler.process(
+        func.text_contains(func.text_lower(string), func.text_lower(substring)), **kw
+    )
+    return result
+
+
 async def init_models(engine: AsyncEngine) -> None:
     async with engine.begin() as conn:
         await conn.run_sync(Base.metadata.create_all)

{arize_phoenix-11.14.0 → arize_phoenix-11.16.0}/src/phoenix/experiments/evaluators/utils.py

@@ -19,9 +19,9 @@ def unwrap_json(obj: JSONSerializable) -> JSONSerializable:
         if len(obj) == 1:
             key = next(iter(obj.keys()))
             output = obj[key]
-            assert isinstance(
-                output, (dict, list, str, int, float, bool, type(None))
-            ), "Output must be JSON serializable"
+            assert isinstance(output, (dict, list, str, int, float, bool, type(None))), (
+                "Output must be JSON serializable"
+            )
             return output
     return obj
 

{arize_phoenix-11.14.0 → arize_phoenix-11.16.0}/src/phoenix/experiments/functions.py

@@ -363,9 +363,9 @@ def run_experiment(
             span.set_attribute(SpanAttributes.OPENINFERENCE_SPAN_KIND, root_span_kind)
             span.set_status(status)
 
-        assert isinstance(
-            output, (dict, list, str, int, float, bool, type(None))
-        ), "Output must be JSON serializable"
+        assert isinstance(output, (dict, list, str, int, float, bool, type(None))), (
+            "Output must be JSON serializable"
+        )
 
         exp_run = ExperimentRun(
             start_time=_decode_unix_nano(cast(int, span.start_time)),
@@ -477,9 +477,9 @@ def run_experiment(
             span.set_attribute(OPENINFERENCE_SPAN_KIND, root_span_kind)
             span.set_status(status)
 
-        assert isinstance(
-            output, (dict, list, str, int, float, bool, type(None))
-        ), "Output must be JSON serializable"
+        assert isinstance(output, (dict, list, str, int, float, bool, type(None))), (
+            "Output must be JSON serializable"
+        )
 
         exp_run = ExperimentRun(
             start_time=_decode_unix_nano(cast(int, span.start_time)),

{arize_phoenix-11.14.0 → arize_phoenix-11.16.0}/src/phoenix/experiments/types.py

@@ -322,7 +322,7 @@ class _HasStats:
             text = self.stats.__str__()
         else:
             text = self.stats.to_markdown(index=False)
-        return f"{self.title}\n{'-'*len(self.title)}\n" + text
+        return f"{self.title}\n{'-' * len(self.title)}\n" + text
 
 
 @dataclass(frozen=True)

{arize_phoenix-11.14.0 → arize_phoenix-11.16.0}/src/phoenix/server/api/mutations/trace_annotations_mutations.py

@@ -49,8 +49,7 @@ class TraceAnnotationMutationMixin:
                 trace_rowid = from_global_id_with_expected_type(annotation_input.trace_id, "Trace")
             except ValueError:
                 raise BadRequest(
-                    f"Invalid trace ID for annotation at index {idx}: "
-                    f"{annotation_input.trace_id}"
+                    f"Invalid trace ID for annotation at index {idx}: {annotation_input.trace_id}"
                 )
             trace_rowids.append(trace_rowid)
 

{arize_phoenix-11.14.0 → arize_phoenix-11.16.0}/src/phoenix/server/api/routers/v1/datasets.py

@@ -714,7 +714,7 @@ async def get_dataset_examples(
     version_id: Optional[str] = Query(
         default=None,
         description=(
-            "The ID of the dataset version " "(if omitted, returns data from the latest version)"
+            "The ID of the dataset version (if omitted, returns data from the latest version)"
         ),
     ),
 ) -> ListDatasetExamplesResponseBody:
@@ -833,7 +833,7 @@ async def get_dataset_csv(
     version_id: Optional[str] = Query(
         default=None,
         description=(
-            "The ID of the dataset version " "(if omitted, returns data from the latest version)"
+            "The ID of the dataset version (if omitted, returns data from the latest version)"
         ),
     ),
 ) -> Response:
@@ -876,7 +876,7 @@ async def get_dataset_jsonl_openai_ft(
     version_id: Optional[str] = Query(
         default=None,
         description=(
-            "The ID of the dataset version " "(if omitted, returns data from the latest version)"
+            "The ID of the dataset version (if omitted, returns data from the latest version)"
         ),
     ),
 ) -> bytes:
@@ -916,7 +916,7 @@ async def get_dataset_jsonl_openai_evals(
     version_id: Optional[str] = Query(
         default=None,
         description=(
-            "The ID of the dataset version " "(if omitted, returns data from the latest version)"
+            "The ID of the dataset version (if omitted, returns data from the latest version)"
         ),
     ),
 ) -> bytes:

{arize_phoenix-11.14.0 → arize_phoenix-11.16.0}/src/phoenix/server/api/routers/v1/evaluations.py

@@ -55,8 +55,7 @@ router = APIRouter(tags=["traces"], include_in_schema=True)
             {
                 "status_code": HTTP_415_UNSUPPORTED_MEDIA_TYPE,
                 "description": (
-                    "Unsupported content type, "
-                    "only gzipped protobuf and pandas-arrow are supported"
+                    "Unsupported content type, only gzipped protobuf and pandas-arrow are supported"
                 ),
             },
             HTTP_422_UNPROCESSABLE_ENTITY,

{arize_phoenix-11.14.0 → arize_phoenix-11.16.0}/src/phoenix/server/api/routers/v1/spans.py

@@ -205,8 +205,7 @@ class OtlpEvent(BaseModel):
     name: Optional[str] = Field(
         None,
         description=(
-            "name of the event. "
-            "This field is semantically required to be set to non-empty string."
+            "name of the event. This field is semantically required to be set to non-empty string."
         ),
     )
     time_unix_nano: Optional[
@@ -282,7 +281,7 @@ class OtlpSpan(BaseModel):
     )
     events: Optional[list[OtlpEvent]] = Field(
         None,
-        description=("events is a collection of Event items. " "A span with no events is valid."),
+        description=("events is a collection of Event items. A span with no events is valid."),
     )
     flags: Optional[Annotated[int, Field(ge=0, le=4294967295)]] = Field(
         None,

{arize_phoenix-11.14.0 → arize_phoenix-11.16.0}/src/phoenix/server/api/routers/v1/traces.py

@@ -2,14 +2,14 @@ import gzip
 import zlib
 from typing import Any, Literal, Optional
 
-from fastapi import APIRouter, BackgroundTasks, Depends, Header, HTTPException, Query
+from fastapi import APIRouter, BackgroundTasks, Depends, Header, HTTPException, Path, Query
 from google.protobuf.message import DecodeError
 from opentelemetry.proto.collector.trace.v1.trace_service_pb2 import (
     ExportTraceServiceRequest,
     ExportTraceServiceResponse,
 )
 from pydantic import Field
-from sqlalchemy import insert, select
+from sqlalchemy import delete, insert, select
 from starlette.concurrency import run_in_threadpool
 from starlette.datastructures import State
 from starlette.requests import Request
@@ -26,7 +26,7 @@ from phoenix.db.insertion.helpers import as_kv
 from phoenix.db.insertion.types import Precursors
 from phoenix.server.authorization import is_not_locked
 from phoenix.server.bearer_auth import PhoenixUser
-from phoenix.server.dml_event import TraceAnnotationInsertEvent
+from phoenix.server.dml_event import SpanDeleteEvent, TraceAnnotationInsertEvent
 from phoenix.trace.otel import decode_otlp_span
 from phoenix.utilities.project import get_project_name
 
@@ -225,3 +225,52 @@ async def _add_spans(req: ExportTraceServiceRequest, state: State) -> None:
             for otlp_span in scope_span.spans:
                 span = await run_in_threadpool(decode_otlp_span, otlp_span)
                 await state.queue_span_for_bulk_insert(span, project_name)
+
+
+@router.delete(
+    "/traces/{trace_id}",
+    operation_id="deleteTrace",
+    summary="Delete a trace by trace_id",
+    description=(
+        "Delete an entire trace by its OpenTelemetry trace_id. "
+        "This will permanently remove all spans in the trace and their associated data."
+    ),
+    responses=add_errors_to_responses([HTTP_404_NOT_FOUND]),
+    status_code=204,  # No Content for successful deletion
+)
+async def delete_trace(
+    request: Request,
+    trace_id: str = Path(description="The OpenTelemetry trace_id of the trace to delete"),
+) -> None:
+    """
+    Delete a trace by trace_id.
+
+    This endpoint will:
+    1. Find and delete the trace with the given trace_id (and all its spans via CASCADE)
+    2. Trigger cache invalidation events
+    3. Return 204 No Content on success
+
+    Note: This deletes the entire trace, including all spans, which maintains data consistency
+    and avoids orphaned spans or inconsistent cached cumulative fields.
+    """
+    async with request.app.state.db() as session:
+        # Delete the trace directly and get project_id for cache invalidation
+        delete_stmt = (
+            delete(models.Trace)
+            .where(models.Trace.trace_id == trace_id)
+            .returning(models.Trace.project_rowid)
+        )
+
+        project_id = await session.scalar(delete_stmt)
+
+        if project_id is None:
+            raise HTTPException(
+                status_code=HTTP_404_NOT_FOUND,
+                detail=f"Trace with trace_id '{trace_id}' not found",
+            )
+
+    # Trigger cache invalidation event
+    request.state.event_queue.put(SpanDeleteEvent((project_id,)))
+
+    # Return 204 No Content (successful deletion with no response body)
+    return None

{arize_phoenix-11.14.0 → arize_phoenix-11.16.0}/src/phoenix/server/api/types/Project.py

@@ -404,11 +404,11 @@ class Project(Node):
                 .where(models.Span.parent_id.is_(None))
                 .where(
                     or_(
-                        models.TextContains(
+                        models.CaseInsensitiveContains(
                             models.Span.attributes[INPUT_VALUE].as_string(),
                             filter_io_substring,
                         ),
-                        models.TextContains(
+                        models.CaseInsensitiveContains(
                             models.Span.attributes[OUTPUT_VALUE].as_string(),
                             filter_io_substring,
                         ),

{arize_phoenix-11.14.0 → arize_phoenix-11.16.0}/src/phoenix/server/api/types/Span.py

@@ -537,8 +537,7 @@ class Span(Node):
 
     @strawberry.field(
         description=(
-            "Annotations associated with the span. This encompasses both "
-            "LLM and human annotations."
+            "Annotations associated with the span. This encompasses both LLM and human annotations."
         )
     )  # type: ignore
     async def span_annotations(

{arize_phoenix-11.14.0 → arize_phoenix-11.16.0}/src/phoenix/server/app.py

@@ -55,6 +55,7 @@ from phoenix.config import (
     ENV_PHOENIX_CSRF_TRUSTED_ORIGINS,
     SERVER_DIR,
     OAuth2ClientConfig,
+    get_env_allow_external_resources,
     get_env_csrf_trusted_origins,
     get_env_database_allocated_storage_capacity_gibibytes,
     get_env_database_usage_insertion_blocking_threshold_percentage,
@@ -245,6 +246,8 @@ class AppConfig(NamedTuple):
     """ Support email address for user assistance """
     has_db_threshold: bool = False
     """ Whether the database has a threshold for usage """
+    allow_external_resources: bool = True
+    """ Whether to allow external resources like Google Fonts in the web interface """
 
 
 class Static(StaticFiles):
@@ -314,6 +317,7 @@ class Static(StaticFiles):
                     "management_url": self._app_config.management_url,
                     "support_email": self._app_config.support_email,
                     "has_db_threshold": self._app_config.has_db_threshold,
+                    "allow_external_resources": self._app_config.allow_external_resources,
                 },
             )
         except Exception as e:
@@ -1085,6 +1089,7 @@ def create_app(
                         get_env_database_allocated_storage_capacity_gibibytes()
                         and get_env_database_usage_insertion_blocking_threshold_percentage()
                     ),
+                    allow_external_resources=get_env_allow_external_resources(),
                 ),
             ),
             name="static",

{arize_phoenix-11.14.0 → arize_phoenix-11.16.0}/src/phoenix/server/daemons/db_disk_usage_monitor.py

@@ -159,8 +159,7 @@ class DbDiskUsageMonitor(DaemonTask):
                 admin_emails = (await session.scalars(stmt)).all()
         except Exception:
             logger.exception(
-                "Failed to fetch admin emails from database, "
-                "skipping database usage warning emails"
+                "Failed to fetch admin emails from database, skipping database usage warning emails"
             )
             return
 

{arize_phoenix-11.14.0 → arize_phoenix-11.16.0}/src/phoenix/server/dml_event_handler.py

@@ -128,6 +128,10 @@ class _SpanDmlEventHandler(_DmlEventHandler[SpanDmlEvent]):
 class _SpanDeleteEventHandler(_SpanDmlEventHandler):
     @staticmethod
     def _clear(cache: CacheForDataLoaders, project_id: int) -> None:
+        # Call parent's cache invalidation first (core span caches)
+        _SpanDmlEventHandler._clear(cache, project_id)
+
+        # Then invalidate annotation-specific caches
         cache.annotation_summary.invalidate_project(project_id)
         cache.document_evaluation_summary.invalidate_project(project_id)
 

{arize_phoenix-11.14.0 → arize_phoenix-11.16.0}/src/phoenix/server/templates/index.html

@@ -55,9 +55,11 @@
     <meta property="og:description" content="AI Observability & Evaluation" />
     <meta property="og:image" content="https://raw.githubusercontent.com/Arize-ai/phoenix-assets/main/images/socal/social-preview-horizontal.jpg" />
     <meta name="theme-color" content="#ffffff" />
+    {% if allow_external_resources %}
     <link rel="preconnect" href="https://fonts.googleapis.com">
     <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
     <link href="https://fonts.googleapis.com/css2?family=Geist:wght@100..900&display=swap" rel="stylesheet">
+    {% endif %}
     {% if not is_development -%}
       {% set _ = collect_assets('index.tsx') -%}
       {{- render_css() -}}
@@ -111,6 +113,7 @@
               managementUrl: {{management_url | tojson}},
               supportEmail: {{support_email | tojson}},
               hasDbThreshold: Boolean("{{has_db_threshold}}" == "True"),
+              allowExternalResources: Boolean("{{allow_external_resources}}" == "True"),
           }),
           writable: false
       });

{arize_phoenix-11.14.0 → arize_phoenix-11.16.0}/src/phoenix/session/client.py

@@ -68,8 +68,7 @@ class Client(TraceDataExtractor):
         """
         if kwargs.pop("use_active_session_if_available", None) is not None:
             print(
-                "`use_active_session_if_available` is deprecated "
-                "and will be removed in the future."
+                "`use_active_session_if_available` is deprecated and will be removed in the future."
             )
         if kwargs:
             raise TypeError(f"Unexpected keyword arguments: {', '.join(kwargs)}")

{arize_phoenix-11.14.0 → arize_phoenix-11.16.0}/src/phoenix/trace/dsl/query.py

@@ -456,16 +456,16 @@ class SpanQuery(_HasTmpSuffix):
         return replace(self, _filter=_filter)
 
     def explode(self, key: str, **kwargs: str) -> "SpanQuery":
-        assert (
-            isinstance(key, str) and key
-        ), "The field name for explosion must be a non-empty string."
+        assert isinstance(key, str) and key, (
+            "The field name for explosion must be a non-empty string."
+        )
         _explode = Explosion(key=key, kwargs=kwargs, primary_index_key=self._index.key)
         return replace(self, _explode=_explode)
 
     def concat(self, key: str, **kwargs: str) -> "SpanQuery":
-        assert (
-            isinstance(key, str) and key
-        ), "The field name for concatenation must be a non-empty string."
+        assert isinstance(key, str) and key, (
+            "The field name for concatenation must be a non-empty string."
+        )
         _concat = (
             Concatenation(key=key, kwargs=kwargs, separator=self._concat.separator)
             if self._concat

arize_phoenix-11.16.0/src/phoenix/version.py

@@ -0,0 +1 @@
+__version__ = "11.16.0"

arize_phoenix-11.14.0/src/phoenix/version.py

@@ -1 +0,0 @@
-__version__ = "11.14.0"