telemetry-dev 0.2.2__tar.gz → 0.2.3__tar.gz

telemetry_dev-0.2.3/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 telemetry.dev
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

{telemetry_dev-0.2.2 → telemetry_dev-0.2.3}/PKG-INFO

@@ -1,10 +1,11 @@
 Metadata-Version: 2.4
 Name: telemetry-dev
-Version: 0.2.2
+Version: 0.2.3
 Summary: telemetry.dev SDK for Python — OpenTelemetry-native GenAI tracing, logs, and metrics
 Keywords: telemetry,opentelemetry,llm,genai,tracing,observability
 Author: telemetry.dev
 License-Expression: MIT
+License-File: LICENSE
 Classifier: Development Status :: 4 - Beta
 Classifier: Intended Audience :: Developers
 Classifier: Programming Language :: Python :: 3
@@ -18,7 +19,7 @@ Requires-Dist: opentelemetry-sdk>=1.35.0,<2
 Requires-Dist: opentelemetry-exporter-otlp-proto-http>=1.35.0,<2
 Requires-Python: >=3.10
 Project-URL: Homepage, https://telemetry.dev
-Project-URL: Repository, https://github.com/telemetry-dev/telemetry.dev
+Project-URL: Repository, https://github.com/telemetry-dev/sdks
 Description-Content-Type: text/markdown
 
 # telemetry-dev
@@ -85,6 +86,12 @@ routed to the `on_error` hook / `telemetry_dev` logger — never raised into you
 
 Explicit `init()` arguments take precedence over environment variables.
 
+Root spans remain independent by default. `telemetry_dev.init(session_mode="process")` groups
+otherwise uncorrelated spans and logs using a fresh opaque UUID for each enabled SDK
+initialization. Explicit and propagated session IDs take precedence, and valid parent trace
+context is preserved. The generated session ends when the client is shut down or replaced; a
+later `init()` generates a new ID. It is not persisted across processes.
+
 ## API reference
 
 | Name | Description |

{telemetry_dev-0.2.2 → telemetry_dev-0.2.3}/README.md

@@ -62,6 +62,12 @@ routed to the `on_error` hook / `telemetry_dev` logger — never raised into you
 
 Explicit `init()` arguments take precedence over environment variables.
 
+Root spans remain independent by default. `telemetry_dev.init(session_mode="process")` groups
+otherwise uncorrelated spans and logs using a fresh opaque UUID for each enabled SDK
+initialization. Explicit and propagated session IDs take precedence, and valid parent trace
+context is preserved. The generated session ends when the client is shut down or replaced; a
+later `init()` generates a new ID. It is not persisted across processes.
+
 ## API reference
 
 | Name | Description |

{telemetry_dev-0.2.2 → telemetry_dev-0.2.3}/pyproject.toml

@@ -1,9 +1,10 @@
 [project]
 name = "telemetry-dev"
-version = "0.2.2"
+version = "0.2.3"
 description = "telemetry.dev SDK for Python — OpenTelemetry-native GenAI tracing, logs, and metrics"
 readme = "README.md"
 license = "MIT"
+license-files = ["LICENSE"]
 requires-python = ">=3.10"
 keywords = [
     "telemetry",
@@ -34,7 +35,7 @@ name = "telemetry.dev"
 
 [project.urls]
 Homepage = "https://telemetry.dev"
-Repository = "https://github.com/telemetry-dev/telemetry.dev"
+Repository = "https://github.com/telemetry-dev/sdks"
 
 [dependency-groups]
 dev = [

{telemetry_dev-0.2.2 → telemetry_dev-0.2.3}/pyproject.toml.orig

@@ -1,9 +1,10 @@
 [project]
 name = "telemetry-dev"
-version = "0.2.2"
+version = "0.2.3"
 description = "telemetry.dev SDK for Python — OpenTelemetry-native GenAI tracing, logs, and metrics"
 readme = "README.md"
 license = "MIT"
+license-files = ["LICENSE"]
 requires-python = ">=3.10"
 authors = [{ name = "telemetry.dev" }]
 keywords = ["telemetry", "opentelemetry", "llm", "genai", "tracing", "observability"]
@@ -25,7 +26,7 @@ dependencies = [
 
 [project.urls]
 Homepage = "https://telemetry.dev"
-Repository = "https://github.com/telemetry-dev/telemetry.dev"
+Repository = "https://github.com/telemetry-dev/sdks"
 
 [dependency-groups]
 dev = [

{telemetry_dev-0.2.2 → telemetry_dev-0.2.3}/src/telemetry_dev/_capture.py

@@ -3,6 +3,7 @@
 from __future__ import annotations
 
 from collections.abc import Iterable
+from itertools import chain
 from typing import Final, cast
 
 _DEFAULT_MAX_BYTES: Final = 64 * 1024
@@ -133,33 +134,7 @@ class CaptureBudget:
                 mapping = cast("dict[object, object]", attributes)
 
         if mapping is not None:
-            for key, child in mapping.items():
-                measured = cls._measure(
-                    key,
-                    remaining_bytes=remaining_bytes - byte_count,
-                    remaining_items=remaining_items - item_count,
-                    depth=depth + 1,
-                    seen=seen,
-                )
-                if measured is None:
-                    return None
-                child_bytes, child_items = measured
-                byte_count += child_bytes
-                item_count += child_items
-
-                measured = cls._measure(
-                    child,
-                    remaining_bytes=remaining_bytes - byte_count,
-                    remaining_items=remaining_items - item_count,
-                    depth=depth + 1,
-                    seen=seen,
-                )
-                if measured is None:
-                    return None
-                child_bytes, child_items = measured
-                byte_count += child_bytes
-                item_count += child_items
-            return byte_count, item_count
+            children = chain.from_iterable(mapping.items())
 
         for child in children:
             measured = cls._measure(

{telemetry_dev-0.2.2 → telemetry_dev-0.2.3}/src/telemetry_dev/_client.py

@@ -2,6 +2,7 @@ from __future__ import annotations
 
 import atexit
 import threading
+import uuid
 from collections.abc import Callable
 from typing import Any
 
@@ -33,6 +34,7 @@ from ._config import (
     SDK_VERSION,
     LogLevelOption,
     ResolvedConfig,
+    SessionMode,
     configure_logger,
     logger,
     report_error,
@@ -123,6 +125,7 @@ class Client:
         *,
         config: ResolvedConfig,
         enabled: bool,
+        session_mode: SessionMode = "explicit",
         register_global: bool = False,
         export_mode: ExportMode = "batched",
         capture_input: bool = True,
@@ -145,6 +148,9 @@ class Client:
         self.mask = mask
         self.max_attribute_length = max_attribute_length
         self.on_error = on_error
+        self._process_session_id: str | None = (
+            str(uuid.uuid4()) if enabled and session_mode == "process" else None
+        )
         self._shutdown = False
         self._atexit_registered = False
 
@@ -316,6 +322,7 @@ def init(
     environment: str | None = None,
     service_name: str | None = None,
     enabled: bool = True,
+    session_mode: SessionMode = "explicit",
     register_global: bool = False,
     export_mode: ExportMode = "batched",
     log_level: LogLevelOption = "warn",
@@ -348,9 +355,12 @@ def init(
         logger.debug("telemetry-dev disabled: no API key")
 
     try:
+        if session_mode not in ("explicit", "process"):
+            raise ValueError(f"invalid session_mode: {session_mode!r}")
         client = Client(
             config=config,
             enabled=effective_enabled,
+            session_mode=session_mode,
             register_global=register_global,
             export_mode=export_mode,
             capture_input=capture_input,

{telemetry_dev-0.2.2 → telemetry_dev-0.2.3}/src/telemetry_dev/_config.py

@@ -22,6 +22,7 @@ def _resolve_version() -> str:
 SDK_VERSION = _resolve_version()
 
 LogLevelOption = Literal["debug", "info", "warn", "error", "silent"]
+SessionMode = Literal["explicit", "process"]
 
 logger = logging.getLogger("telemetry_dev")
 

{telemetry_dev-0.2.2 → telemetry_dev-0.2.3}/src/telemetry_dev/_context.py

@@ -78,6 +78,13 @@ def propagated_attributes(context: Context | None = None) -> dict[str, Attribute
     return {}
 
 
+def context_with_propagated_attributes(
+    attributes: Mapping[str, AttributeValue], context: Context | None = None
+) -> Context:
+    base = context if context is not None else otel_context.get_current()
+    return otel_context.set_value(_PROPAGATED_KEY, attributes, context=base)
+
+
 @contextmanager
 def propagate_attributes(
     *,

{telemetry_dev-0.2.2 → telemetry_dev-0.2.3}/src/telemetry_dev/_logs.py

@@ -7,8 +7,8 @@ from opentelemetry._logs import SeverityNumber
 
 from ._client import get_client
 from ._config import logger
-from ._context import propagated_attributes
-from ._semconv import SEVERITY, LogLevel
+from ._context import context_with_propagated_attributes, propagated_attributes
+from ._semconv import ATTR_SESSION_ID, SEVERITY, LogLevel
 from ._serialize import AttributeValue, coerce_attr_value
 
 
@@ -41,9 +41,21 @@ def log(
                 )
                 if attr is not None:
                     attrs[key] = attr
+        propagated = propagated_attributes()
+        process_session_id = client._process_session_id  # pyright: ignore[reportPrivateUsage]
+        explicit_session = attributes is not None and ATTR_SESSION_ID in attributes
+        if (
+            not explicit_session
+            and ATTR_SESSION_ID not in propagated
+            and process_session_id is not None
+        ):
+            propagated[ATTR_SESSION_ID] = process_session_id
+        context = otel_context.get_current()
+        if propagated:
+            context = context_with_propagated_attributes(propagated, context)
         # Propagated correlation attrs win on key collisions, matching the span-processor
         # stamping model and the TypeScript SDK.
-        for key, value in propagated_attributes().items():
+        for key, value in propagated.items():
             attr = coerce_attr_value(
                 value,
                 max_len=client.max_attribute_length,
@@ -54,7 +66,7 @@ def log(
                 attrs[key] = attr
         body = client.serialize(message, "log.message") or ""
         client.otel_logger.emit(
-            context=otel_context.get_current(),
+            context=context,
             severity_number=SeverityNumber(severity),
             severity_text=normalized.upper(),
             body=body,

{telemetry_dev-0.2.2 → telemetry_dev-0.2.3}/src/telemetry_dev/_spans.py

@@ -19,6 +19,7 @@ from ._client import Client, get_client
 from ._config import logger
 from ._context import (
     context_from_parent,
+    context_with_propagated_attributes,
     propagated_attributes,
     traceparent_of,
     with_session_parent,
@@ -317,10 +318,17 @@ class SpanHandle:
     """Handle around an OTel span. Use as a context manager to activate the span in the
     current context, or keep it detached and call .end() manually."""
 
-    def __init__(self, span: Span, client: Client | None, state: _SpanState | None) -> None:
+    def __init__(
+        self,
+        span: Span,
+        client: Client | None,
+        state: _SpanState | None,
+        context: Context | None = None,
+    ) -> None:
         self.span = span
         self._client = client
         self._state = state
+        self._context = context
         self._context_token: Token[Context] | None = None
         self._ended = False
 
@@ -480,7 +488,9 @@ class SpanHandle:
 
     def __enter__(self) -> SpanHandle:
         if self._client is not None and self._state is not None:
-            self._context_token = otel_context.attach(trace.set_span_in_context(self.span))
+            self._context_token = otel_context.attach(
+                trace.set_span_in_context(self.span, self._context)
+            )
         return self
 
     def __exit__(self, exc_type: Any, exc: Any, tb: Any) -> Literal[False]:
@@ -593,6 +603,11 @@ def start_span(
             if isinstance(explicit_session_id, str)
             else propagated.get(ATTR_SESSION_ID)
         )
+        if not isinstance(session_id, str):
+            session_id = client._process_session_id  # pyright: ignore[reportPrivateUsage]
+        if isinstance(session_id, str):
+            propagated[ATTR_SESSION_ID] = session_id
+            ctx = context_with_propagated_attributes(propagated, ctx)
         ctx = with_session_parent(
             ctx, session_id if isinstance(session_id, str) else None, client.config.api_key
         )
@@ -605,7 +620,7 @@ def start_span(
             start_time=_to_ns(start_time),
         )
         _SPAN_STATES[span] = state
-        handle = SpanHandle(span, client, state)
+        handle = SpanHandle(span, client, state, ctx)
         # The processor stamps propagation on start; explicit fields still win.
         if attrs:
             span.set_attributes(attrs)