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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: threadify-sdk
-Version: 0.2.6
+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
@@ -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.6 → threadify_sdk-0.2.7}/README.md

@@ -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.6 → threadify_sdk-0.2.7}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "threadify-sdk"
-version = "0.2.6"
+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"

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

@@ -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.6 → 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.6 → threadify_sdk-0.2.7}/threadify/thread.py

@@ -300,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.6 → threadify_sdk-0.2.7/threadify_sdk.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: threadify-sdk
-Version: 0.2.6
+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
@@ -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: