unique_toolkit 2026.34.0.dev7__py3-none-any.whl → 2026.34.0.dev9__py3-none-any.whl

unique_toolkit/app/unique_settings.py

@@ -379,7 +379,18 @@ class UniqueApi(BaseSettings):
         )
 
     @staticmethod
-    def _legacy_base_path(hostname: str | None) -> str:
+    def _legacy_base_path(hostname: str | None, port: int | None = None) -> str:
+        # ponytail: root path inferred from unique-api hostname / local :8096;
+        # ceiling = service rename or non-8096 local bind; upgrade = explicit ApiType.
+        if hostname and "unique-api" in hostname:
+            return ""
+        if (
+            hostname
+            and port == 8096
+            and (hostname in ("localhost", "127.0.0.1") or "localhost" in hostname)
+        ):
+            return ""
+
         base_path = "/public/chat"
         if hostname and (
             "gateway.qa.unique" in hostname or "gateway.unique" in hostname
@@ -409,7 +420,7 @@ class UniqueApi(BaseSettings):
             case ApiType.INTERNAL:
                 base_path = "public"
             case ApiType.LEGACY:
-                base_path = self._legacy_base_path(parsed.hostname)
+                base_path = self._legacy_base_path(parsed.hostname, parsed.port)
 
         return parsed, base_path
 

unique_toolkit/monitoring/__init__.py

@@ -4,6 +4,8 @@ from unique_toolkit.monitoring.tracing import (
     TracingSettings,
     configure_tracing,
     inject_trace_headers,
+    instrument_fastapi_app,
+    instrument_requests,
 )
 
 __all__ = [
@@ -12,6 +14,8 @@ __all__ = [
     "TracingSettings",
     "configure_tracing",
     "inject_trace_headers",
+    "instrument_fastapi_app",
+    "instrument_requests",
 ]
 
 _MONITORING_AVAILABLE = False

unique_toolkit/monitoring/tracing.py

@@ -9,7 +9,10 @@ from typing import TYPE_CHECKING, ClassVar, Self, TypeAlias, cast
 from pydantic import AliasChoices, Field
 from pydantic_settings import BaseSettings, SettingsConfigDict
 
+from unique_toolkit.app.find_env_file import find_env_file
+
 if TYPE_CHECKING:
+    from fastapi import FastAPI  # pyright: ignore[reportMissingImports]
     from opentelemetry.trace.propagation.tracecontext import (
         TraceContextTextMapPropagator,
     )
@@ -25,6 +28,10 @@ _OTEL_EXTRA_MESSAGE = (
     "OpenTelemetry tracing requires the unique_toolkit[otel] extra. "
     "Install it with: uv add 'unique-toolkit[otel]'"
 )
+_FASTAPI_EXTRA_MESSAGE = (
+    "FastAPI instrumentation requires the unique_toolkit[fastapi] extra. "
+    "Install it with: uv add 'unique-toolkit[fastapi]'"
+)
 
 
 class TraceExporter(StrEnum):
@@ -42,6 +49,8 @@ class TracingSettings(BaseSettings):
         env_prefix="OTEL_",
         env_ignore_empty=True,
         extra="ignore",
+        env_file=find_env_file(".env", required=False),
+        env_file_encoding="utf-8",
     )
 
     traces_exporter: TraceExporter | None = None
@@ -90,6 +99,11 @@ def _missing_otel_extra() -> ImportError:
     return ImportError(_OTEL_EXTRA_MESSAGE)
 
 
+def _missing_fastapi_extra() -> ImportError:
+    """Create a consistent error for an unavailable optional FastAPI dependency."""
+    return ImportError(_FASTAPI_EXTRA_MESSAGE)
+
+
 def _trace_context_propagator() -> TraceContextTextMapPropagator:
     """Return a W3C trace-context propagator without forwarding baggage."""
     try:
@@ -165,9 +179,12 @@ def configure_tracing(
 
     try:
         from opentelemetry import trace
+        from opentelemetry.baggage.propagation import W3CBaggagePropagator
         from opentelemetry.exporter.otlp.proto.http.trace_exporter import (
             OTLPSpanExporter,
         )
+        from opentelemetry.propagate import set_global_textmap
+        from opentelemetry.propagators.composite import CompositePropagator
         from opentelemetry.sdk.resources import Resource
         from opentelemetry.sdk.trace import TracerProvider
         from opentelemetry.sdk.trace.export import (
@@ -176,6 +193,9 @@ def configure_tracing(
             SimpleSpanProcessor,
         )
         from opentelemetry.trace import ProxyTracerProvider
+        from opentelemetry.trace.propagation.tracecontext import (
+            TraceContextTextMapPropagator,
+        )
     except ImportError as error:
         raise _missing_otel_extra() from error
 
@@ -196,6 +216,54 @@ def configure_tracing(
     if exporter is TraceExporter.CONSOLE:
         provider.add_span_processor(SimpleSpanProcessor(ConsoleSpanExporter()))
     else:
-        provider.add_span_processor(BatchSpanProcessor(OTLPSpanExporter()))
+        # Sizing pinned to match the Node services' instrumentation.ts.
+        provider.add_span_processor(
+            BatchSpanProcessor(
+                OTLPSpanExporter(),
+                max_queue_size=2048,
+                max_export_batch_size=512,
+                schedule_delay_millis=5000,
+            )
+        )
     trace.set_tracer_provider(provider)
+    # Trace-context + baggage, the shared subset of the Node services' propagator.
+    set_global_textmap(
+        CompositePropagator([TraceContextTextMapPropagator(), W3CBaggagePropagator()])
+    )
     return True
+
+
+def instrument_fastapi_app(app: FastAPI, *, excluded_urls: str | None = None) -> None:
+    """Trace inbound requests for an already-created FastAPI app instance.
+
+    Uses ``FastAPIInstrumentor.instrument_app`` rather than the global
+    ``FastAPIInstrumentor().instrument()``: the global form swaps out the
+    ``fastapi.FastAPI`` class, so it only takes effect for app objects created
+    afterward. Instrumenting the instance has no such ordering requirement.
+    """
+    try:
+        import fastapi  # noqa: F401  # pyright: ignore[reportMissingImports, reportUnusedImport]
+    except ImportError as error:
+        # opentelemetry-instrumentation-fastapi imports fastapi internally, so without
+        # this explicit check its own ImportError would be misreported below as a
+        # missing otel extra when fastapi itself is what's actually missing.
+        raise _missing_fastapi_extra() from error
+
+    try:
+        from opentelemetry.instrumentation.fastapi import FastAPIInstrumentor
+    except ImportError as error:
+        raise _missing_otel_extra() from error
+    FastAPIInstrumentor.instrument_app(app, excluded_urls=excluded_urls)
+
+
+def instrument_requests() -> None:
+    """Trace outbound calls made with the ``requests`` library.
+
+    Patches ``requests`` at module level, so callers that already imported it
+    are still covered.
+    """
+    try:
+        from opentelemetry.instrumentation.requests import RequestsInstrumentor
+    except ImportError as error:
+        raise _missing_otel_extra() from error
+    RequestsInstrumentor().instrument()

{unique_toolkit-2026.34.0.dev7.dist-info → unique_toolkit-2026.34.0.dev9.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: unique-toolkit
-Version: 2026.34.0.dev7
+Version: 2026.34.0.dev9
 Summary: 
 Author: Cedric Klinkert, Martin Fadler, Sadique Sheik, Fabian Schläpfer, Pascal Hauri, Ejiroghene Oki-Peter, Rami Azouz, Ricardo Visini, Sanzio Monti
 Author-email: Cedric Klinkert <cedric.klinkert@unique.ch>, Martin Fadler <martin.fadler@unique.ch>, Sadique Sheik <sadique@unique.ch>, Fabian Schläpfer <fabian@unique.ch>, Pascal Hauri <pascal@unique.ch>, Ejiroghene Oki-Peter <oki-peter.ejiroghene@unique.ai>, Rami Azouz <rami.ext@unique.ch>, Ricardo Visini <ricardo.visini@unique.ch>, Sanzio Monti <sanzio.monti@unique.ai>
@@ -16,7 +16,7 @@ Requires-Dist: sseclient>=0.0.27,<0.0.28
 Requires-Dist: openai>=1.105.0,<3
 Requires-Dist: platformdirs>=4.0.0,<5
 Requires-Dist: pillow>=12.1.1
-Requires-Dist: unique-sdk>=2026.34.0.dev3,<2026.34.0rc0
+Requires-Dist: unique-sdk>=2026.34.0.dev4,<2026.34.0rc0
 Requires-Dist: jambo>=0.1.2,<0.2
 Requires-Dist: jinja2>=3.1.6,<4
 Requires-Dist: docxtpl>=0.20.1,<0.21
@@ -44,6 +44,8 @@ Requires-Dist: langchain-core>=1.0.0,<2 ; extra == 'langchain'
 Requires-Dist: prometheus-client>=0.24.1,<1 ; extra == 'monitoring'
 Requires-Dist: opentelemetry-sdk>=1.27,<2 ; extra == 'otel'
 Requires-Dist: opentelemetry-exporter-otlp-proto-http>=1.27,<2 ; extra == 'otel'
+Requires-Dist: opentelemetry-instrumentation-fastapi>=0.65b0,<1 ; extra == 'otel'
+Requires-Dist: opentelemetry-instrumentation-requests>=0.65b0,<1 ; extra == 'otel'
 Requires-Python: >=3.12
 Provides-Extra: fastapi
 Provides-Extra: langchain

{unique_toolkit-2026.34.0.dev7.dist-info → unique_toolkit-2026.34.0.dev9.dist-info}/RECORD

@@ -251,7 +251,7 @@ unique_toolkit/app/init_sdk.py,sha256=5_oDoETr6akwYyBCb0ivTdMNu3SVgPSkrXcDS6ELyY
 unique_toolkit/app/performance/async_tasks.py,sha256=8Xv5kEmmFDJO7YyyBxv4e7bcNgq-3z_E2_4z1Yn9EqU,1970
 unique_toolkit/app/performance/async_wrapper.py,sha256=yVVcRDkcdyfjsxro-N29SBvi-7773wnfDplef6-y8xw,1077
 unique_toolkit/app/schemas.py,sha256=_jHuLDZO9YSP0xf-1AxNVorWYg2NgWfNZ9yXpGt2DHE,18518
-unique_toolkit/app/unique_settings.py,sha256=-bYvxwCw_DvhSViHXgc-pYoNboxhHB8VG2L9YNPiDHU,26861
+unique_toolkit/app/unique_settings.py,sha256=dfqqh1Nv2JaqL3fePndmuRAfJcARzImdwSOO1J3KS1E,27318
 unique_toolkit/app/verification.py,sha256=GxFFwcJMy25fCA_Xe89wKW7bgqOu8PAs5y8QpHF0GSc,3861
 unique_toolkit/app/webhook.py,sha256=evpxLDnvz7P3D7-TV1XBkl8WcoldXpjOkw3tvFRxHr0,2368
 unique_toolkit/chat/__init__.py,sha256=-239hRT9x8fJ5rL_qvGAhnxLO_F7gToTVVLo0wZbesU,1722
@@ -402,11 +402,11 @@ unique_toolkit/language_model/service.py,sha256=hDoJBBgG_wWs8WuC_c8tnmK8cNu8o5Eh
 unique_toolkit/language_model/settings.py,sha256=7szohExI-qmTfUf2Zp5AB5TzrsZy1UekAGyXx_UaPMc,1524
 unique_toolkit/language_model/stream_transform.py,sha256=iNNGpLY_7G6Bpp9Y4KtbIkQm3WB4yZt75BXcqx0DVkI,2775
 unique_toolkit/language_model/utils.py,sha256=bPQ4l6_YO71w-zaIPanUUmtbXC1_hCvLK0tAFc3VCRc,1902
-unique_toolkit/monitoring/__init__.py,sha256=auxvvOBwYrCD3TqEX0sIupDYx9nbCt2u4XN0Sy55qKI,1376
+unique_toolkit/monitoring/__init__.py,sha256=XHRzPx4LKcbKruRrf_gNv50amhvhy8Go2IkOoHMuLsw,1486
 unique_toolkit/monitoring/gunicorn.py,sha256=urTFFS5zYHKoxb1TEQHcLqb2byi-aYgFRHGwgYRzYYI,844
 unique_toolkit/monitoring/middleware.py,sha256=MNsUuKgt74mSnUwttXTB_AxX546Pz2zKoAP9OewVrwQ,4531
 unique_toolkit/monitoring/registry.py,sha256=De2Bx5QBBRJQY2MM3xtntiJ2JU2FoKkVT7rNMG7ewgA,5874
-unique_toolkit/monitoring/tracing.py,sha256=86yUIF8HrHVrkegOBOM7GqpbmVrYP07AZ4HtP-3X9QY,7128
+unique_toolkit/monitoring/tracing.py,sha256=0lmLuQjyyC3iFpNTw8rOyCpEZ6PTvp16nVbzcO9d2sQ,10043
 unique_toolkit/protocols/support.py,sha256=x5edzbBmKAUuvm3oLFh52gkgQsqR5LU7M0t8RHK0DZk,5161
 unique_toolkit/services/__init__.py,sha256=b9Wl7Wvz1JmZDbDexIZzBoXZ0wscXuczGAH8LoL-Qak,572
 unique_toolkit/services/chat_service.py,sha256=6lVMSwvi2ztPebK6meo9BVLOL_Wdje5wPSUBp5dMZIg,99268
@@ -420,6 +420,6 @@ unique_toolkit/short_term_memory/service.py,sha256=2JMBEBn6GoyK-a0xvdcWpPft-3C74
 unique_toolkit/smart_rules/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 unique_toolkit/smart_rules/compile.py,sha256=vRe0aMJWuVIK-VsqomgxQImzke7MDmwgSxxJfYCa7zw,1386
 unique_toolkit/test_utilities/events.py,sha256=FLrhMh0A_mQutAUjoD0FdMcVQ4Gq31r35OVGzRjvLro,6760
-unique_toolkit-2026.34.0.dev7.dist-info/WHEEL,sha256=eh7sammvW2TypMMMGKgsM83HyA_3qQ5Lgg3ynoecH3M,79
-unique_toolkit-2026.34.0.dev7.dist-info/METADATA,sha256=23fTKIILLrhEk-wSV7lRMJs6hhguyDHBChVkldd8wTc,7656
-unique_toolkit-2026.34.0.dev7.dist-info/RECORD,,
+unique_toolkit-2026.34.0.dev9.dist-info/WHEEL,sha256=eh7sammvW2TypMMMGKgsM83HyA_3qQ5Lgg3ynoecH3M,79
+unique_toolkit-2026.34.0.dev9.dist-info/METADATA,sha256=u_HrX_80XqfWG54ud1CwTxBiJF2lKD0L9Go050etA4c,7821
+unique_toolkit-2026.34.0.dev9.dist-info/RECORD,,