threadify-sdk 0.2.5__tar.gz → 0.2.7__tar.gz

{threadify_sdk-0.2.5/threadify_sdk.egg-info → threadify_sdk-0.2.7}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: threadify-sdk
-Version: 0.2.5
-Summary: Python SDK for Threadify — service-delivery intelligence. Track every customer request from start to finish across every system, team, and partner. Visit: https://threadify.dev
+Version: 0.2.7
+Summary: Python SDK for Threadify — Service-delivery intelligence. Track every customer request from start to finish across every system, team, and partner. Visit: https://threadify.dev
 Author-email: Threadify Team <team@threadify.dev>
 License: MIT
 Keywords: threadify,workflow,orchestration,websocket,graphql
@@ -27,7 +27,7 @@ Dynamic: license-file
 
 # Threadify Python SDK
 
-Python SDK for [Threadify](https://threadify.dev) — service-delivery intelligence that tracks every customer request from start to finish across every system, team, and partner.
+Python SDK for [Threadify](https://threadify.dev) — Service-delivery intelligence that tracks every customer request from start to finish across every system, team, and partner.
 
 - **Documentation:** [https://docs.threadify.dev](https://docs.threadify.dev)
 - **Create an account:** [https://threadify.dev](https://threadify.dev)
@@ -167,6 +167,38 @@ This SDK follows [Semantic Versioning](https://semver.org/) and [Conventional Co
 - `feat: ...` -> Minor bump
 - `feat!: ...` or `BREAKING CHANGE: ...` -> Major bump
 
+## OpenTelemetry Integration
+
+The Python SDK includes the OpenTelemetry SpanExporter in the core package.
+
+```python
+from opentelemetry import trace
+from opentelemetry.sdk.trace import TracerProvider
+from opentelemetry.sdk.trace.export import BatchSpanProcessor
+from threadify import Threadify
+
+conn = await Threadify.connect("api-key", service_name="checkout-service")
+
+# Create exporter
+exporter = conn.create_span_exporter(options={"refs": ["order.id", "customer.id"]})
+
+# Filter spans by name — exact match or prefix wildcard with *
+exporter = conn.create_span_exporter(options={
+    "refs": ["order.id", "customer.id"],
+    "filters": ["invoke_llm", "adk.before*", "llm.*"],
+})
+
+provider = TracerProvider()
+provider.add_span_processor(BatchSpanProcessor(exporter))
+trace.set_tracer_provider(provider)
+```
+
+**Filter patterns:**
+
+- `"invoke_llm"` — exact match
+- `"adk.before*"` — prefix wildcard, drops any span starting with `adk.before`
+- `"llm.*"` — prefix wildcard, drops any span starting with `llm.`
+
 ## Testing
 
 To run the SDK tests, execute:

{threadify_sdk-0.2.5 → threadify_sdk-0.2.7}/README.md

@@ -1,6 +1,6 @@
 # Threadify Python SDK
 
-Python SDK for [Threadify](https://threadify.dev) — service-delivery intelligence that tracks every customer request from start to finish across every system, team, and partner.
+Python SDK for [Threadify](https://threadify.dev) — Service-delivery intelligence that tracks every customer request from start to finish across every system, team, and partner.
 
 - **Documentation:** [https://docs.threadify.dev](https://docs.threadify.dev)
 - **Create an account:** [https://threadify.dev](https://threadify.dev)
@@ -140,6 +140,38 @@ This SDK follows [Semantic Versioning](https://semver.org/) and [Conventional Co
 - `feat: ...` -> Minor bump
 - `feat!: ...` or `BREAKING CHANGE: ...` -> Major bump
 
+## OpenTelemetry Integration
+
+The Python SDK includes the OpenTelemetry SpanExporter in the core package.
+
+```python
+from opentelemetry import trace
+from opentelemetry.sdk.trace import TracerProvider
+from opentelemetry.sdk.trace.export import BatchSpanProcessor
+from threadify import Threadify
+
+conn = await Threadify.connect("api-key", service_name="checkout-service")
+
+# Create exporter
+exporter = conn.create_span_exporter(options={"refs": ["order.id", "customer.id"]})
+
+# Filter spans by name — exact match or prefix wildcard with *
+exporter = conn.create_span_exporter(options={
+    "refs": ["order.id", "customer.id"],
+    "filters": ["invoke_llm", "adk.before*", "llm.*"],
+})
+
+provider = TracerProvider()
+provider.add_span_processor(BatchSpanProcessor(exporter))
+trace.set_tracer_provider(provider)
+```
+
+**Filter patterns:**
+
+- `"invoke_llm"` — exact match
+- `"adk.before*"` — prefix wildcard, drops any span starting with `adk.before`
+- `"llm.*"` — prefix wildcard, drops any span starting with `llm.`
+
 ## Testing
 
 To run the SDK tests, execute:

{threadify_sdk-0.2.5 → threadify_sdk-0.2.7}/pyproject.toml

@@ -4,8 +4,8 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "threadify-sdk"
-version = "0.2.5"
-description = "Python SDK for Threadify — service-delivery intelligence. Track every customer request from start to finish across every system, team, and partner. Visit: https://threadify.dev"
+version = "0.2.7"
+description = "Python SDK for Threadify — Service-delivery intelligence. Track every customer request from start to finish across every system, team, and partner. Visit: https://threadify.dev"
 readme = "README.md"
 requires-python = ">=3.10"
 license = {text = "MIT"}

{threadify_sdk-0.2.5 → threadify_sdk-0.2.7}/threadify/__init__.py

@@ -5,6 +5,7 @@ from threadify.client import (
 from threadify.connection import Connection
 from threadify.data_retriever import ArchivedStep, ArchivedThread, DataRetriever
 from threadify.models import (
+    AccessLevel,
     CompleteDataOptions,
     ConnectOptions,
     HistoryQueryOptions,
@@ -46,6 +47,7 @@ __all__ = [
     "RefQuery",
     "CompleteDataOptions",
     "HistoryQueryOptions",
+    "AccessLevel",
 ]
 
 __version__ = "0.1.0"

{threadify_sdk-0.2.5 → threadify_sdk-0.2.7}/threadify/client.py

@@ -64,6 +64,10 @@ def _build_connect_options(
 class Threadify:
     """Factory for creating Threadify connections."""
 
+    FOR_EXTERNAL = "external"
+    FOR_OBSERVER = "observer"
+    FOR_PARTICIPANT = "participant"
+
     @staticmethod
     async def connect(
         api_key: str,

{threadify_sdk-0.2.5 → threadify_sdk-0.2.7}/threadify/connection.py

@@ -182,7 +182,7 @@ class Connection:
             raise RuntimeError(resp.get(FIELD_MESSAGE, "failed to start thread"))
 
         thread_id = resp[FIELD_THREAD_ID]
-        thread = ThreadInstance(self, thread_id, contract_name, "", None)
+        thread = ThreadInstance(self, thread_id, contract_name, "", resp.get(FIELD_ACCESS_LEVEL, ""), None)
         self._threads[thread_id] = thread
         self._logger.debug(f"Thread started: {thread_id}")
         return thread
@@ -231,7 +231,7 @@ class Connection:
 
         thread_id = resp[FIELD_THREAD_ID]
         thread_role = resp.get(FIELD_ROLE, "")
-        thread = ThreadInstance(self, thread_id, resp.get("contractId", ""), thread_role, None)
+        thread = ThreadInstance(self, thread_id, resp.get("contractId", ""), thread_role, resp.get(FIELD_ACCESS_LEVEL, ""), None)
         self._threads[thread_id] = thread
         self._logger.debug(f"Joined thread: {thread_id}, Role: {thread_role}")
         return thread
@@ -464,6 +464,9 @@ class Connection:
         Args:
             options: Optional configuration dict. Supported keys:
                 - ``refs``: list of attribute keys to map to Threadify refs.
+                - ``filters``: list of span-name patterns to drop. A trailing ``*``
+                  acts as a wildcard prefix match; otherwise an exact match is used.
+                  Example: ``["invoke_llm", "adk.before*", "llm.*"]``.
 
         Returns:
             A :class:`~threadify.otel_exporter.ThreadifySpanExporter` instance.

{threadify_sdk-0.2.5 → threadify_sdk-0.2.7}/threadify/models.py

@@ -109,6 +109,12 @@ class ValidationSeverity(str, Enum):
     CRITICAL = "critical"
 
 
+class AccessLevel(str, Enum):
+    EXTERNAL = "external"
+    OBSERVER = "observer"
+    PARTICIPANT = "participant"
+
+
 @dataclass
 class ConnectOptions:
     """Configuration for connecting to the Threadify Engine."""

{threadify_sdk-0.2.5 → threadify_sdk-0.2.7}/threadify/otel_exporter.py

@@ -73,6 +73,9 @@ class ThreadifySpanExporter(_SpanExporterBase):
         else:
             self._refs_map = {}
 
+        # Span-name filters; e.g. ["invoke_llm", "adk.before*", "llm.*"]
+        self._filters: list[str] = self._options.get("filters", [])
+
         # trace_id -> asyncio.Future[ThreadInstance]
         self._trace_threads: dict[str, asyncio.Future[Any]] = {}
 
@@ -111,6 +114,8 @@ class ThreadifySpanExporter(_SpanExporterBase):
 
     async def _process_all(self, spans: list[ReadableSpan]) -> None:
         for span in spans:
+            if self._should_drop(span.name):
+                continue
             await self._process_span(span)
 
     async def _process_span(self, span: ReadableSpan) -> None:
@@ -276,6 +281,18 @@ class ThreadifySpanExporter(_SpanExporterBase):
 
         return await self._trace_threads[trace_id]
 
+    def _should_drop(self, name: str) -> bool:
+        for f in self._filters:
+            if not f:
+                continue
+            if f.endswith("*"):
+                if name.startswith(f[:-1]):
+                    return True
+                continue
+            if name == f:
+                return True
+        return False
+
     @staticmethod
     def _span_attr(span: ReadableSpan, key: str) -> str | None:
         value = span.attributes.get(key)

{threadify_sdk-0.2.5 → threadify_sdk-0.2.7}/threadify/thread.py

@@ -62,12 +62,14 @@ class ThreadInstance:
         thread_id: str,
         contract_id: str = "",
         role: str = "",
+        access_level: str = "",
         refs: dict[str, str] | None = None,
     ):
         self._conn = conn
         self.thread_id = thread_id
         self.contract_id = contract_id
         self.role = role
+        self.access_level = access_level
         self.refs: dict[str, str] = refs or {}
 
         self._steps: dict[str, Any] = {}
@@ -298,6 +300,9 @@ class ThreadInstance:
         Args:
             options: Optional configuration dict. Supported keys:
                 - ``refs``: list of attribute keys to map to Threadify refs.
+                - ``filters``: list of span-name patterns to drop. A trailing ``*``
+                  acts as a wildcard prefix match; otherwise an exact match is used.
+                  Example: ``["invoke_llm", "adk.before*", "llm.*"]``.
 
         Returns:
             A :class:`~threadify.otel_exporter.ThreadifySpanExporter` instance.

{threadify_sdk-0.2.5 → threadify_sdk-0.2.7/threadify_sdk.egg-info}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: threadify-sdk
-Version: 0.2.5
-Summary: Python SDK for Threadify — service-delivery intelligence. Track every customer request from start to finish across every system, team, and partner. Visit: https://threadify.dev
+Version: 0.2.7
+Summary: Python SDK for Threadify — Service-delivery intelligence. Track every customer request from start to finish across every system, team, and partner. Visit: https://threadify.dev
 Author-email: Threadify Team <team@threadify.dev>
 License: MIT
 Keywords: threadify,workflow,orchestration,websocket,graphql
@@ -27,7 +27,7 @@ Dynamic: license-file
 
 # Threadify Python SDK
 
-Python SDK for [Threadify](https://threadify.dev) — service-delivery intelligence that tracks every customer request from start to finish across every system, team, and partner.
+Python SDK for [Threadify](https://threadify.dev) — Service-delivery intelligence that tracks every customer request from start to finish across every system, team, and partner.
 
 - **Documentation:** [https://docs.threadify.dev](https://docs.threadify.dev)
 - **Create an account:** [https://threadify.dev](https://threadify.dev)
@@ -167,6 +167,38 @@ This SDK follows [Semantic Versioning](https://semver.org/) and [Conventional Co
 - `feat: ...` -> Minor bump
 - `feat!: ...` or `BREAKING CHANGE: ...` -> Major bump
 
+## OpenTelemetry Integration
+
+The Python SDK includes the OpenTelemetry SpanExporter in the core package.
+
+```python
+from opentelemetry import trace
+from opentelemetry.sdk.trace import TracerProvider
+from opentelemetry.sdk.trace.export import BatchSpanProcessor
+from threadify import Threadify
+
+conn = await Threadify.connect("api-key", service_name="checkout-service")
+
+# Create exporter
+exporter = conn.create_span_exporter(options={"refs": ["order.id", "customer.id"]})
+
+# Filter spans by name — exact match or prefix wildcard with *
+exporter = conn.create_span_exporter(options={
+    "refs": ["order.id", "customer.id"],
+    "filters": ["invoke_llm", "adk.before*", "llm.*"],
+})
+
+provider = TracerProvider()
+provider.add_span_processor(BatchSpanProcessor(exporter))
+trace.set_tracer_provider(provider)
+```
+
+**Filter patterns:**
+
+- `"invoke_llm"` — exact match
+- `"adk.before*"` — prefix wildcard, drops any span starting with `adk.before`
+- `"llm.*"` — prefix wildcard, drops any span starting with `llm.`
+
 ## Testing
 
 To run the SDK tests, execute: