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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: threadify-sdk
-Version: 0.2.6
+Version: 0.2.8
 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.8}/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.8}/pyproject.toml

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

@@ -35,6 +35,7 @@ from threadify.models import (
     FIELD_SERVICE_NAME,
     FIELD_STATUS,
     FIELD_STEP_NAME,
+    FIELD_TAGS,
     FIELD_THREAD_ID,
     FIELD_THREAD_ID_ACK,
     FIELD_THREAD_TOKEN,
@@ -144,6 +145,7 @@ class Connection:
         contract_name: str = "",
         service_name: str = "",
         refs: dict[str, Any] | None = None,
+        tags: list[str] | None = None,
     ) -> ThreadInstance:
         from threadify.thread import ThreadInstance
 
@@ -174,6 +176,13 @@ class Connection:
             
             msg[FIELD_ROLE] = role
 
+        # Validate and attach tags if provided
+        if tags:
+            for t in tags:
+                if not isinstance(t, str) or not t.strip():
+                    raise ValueError("Each tag must be a non-empty string")
+            msg[FIELD_TAGS] = list(tags)
+
         await self._send(msg)
 
         resp = await self._wait_response(lambda m: m.get(FIELD_ACTION) == ACTION_START_THREAD)
@@ -183,6 +192,7 @@ class Connection:
 
         thread_id = resp[FIELD_THREAD_ID]
         thread = ThreadInstance(self, thread_id, contract_name, "", resp.get(FIELD_ACCESS_LEVEL, ""), None)
+        thread.tags = list(tags) if tags else []
         self._threads[thread_id] = thread
         self._logger.debug(f"Thread started: {thread_id}")
         return thread
@@ -464,6 +474,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.8}/threadify/models.py

@@ -75,6 +75,7 @@ FIELD_OWNER_ID = "ownerId"
 FIELD_SEVERITY = "severity"
 FIELD_TIMESTAMP = "timestamp"
 FIELD_VIOLATION_TYPE = "violationType"
+FIELD_TAGS = "tags"
 
 # Protocol status values
 STATUS_SUCCESS = "success"

{threadify_sdk-0.2.6 → threadify_sdk-0.2.8}/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.8}/threadify/thread.py

@@ -71,6 +71,7 @@ class ThreadInstance:
         self.role = role
         self.access_level = access_level
         self.refs: dict[str, str] = refs or {}
+        self.tags: list[str] = []  # Tags applied at thread creation (immutable)
 
         self._steps: dict[str, Any] = {}
         self._pending_waits: dict[str, _PendingWait] = {}
@@ -300,6 +301,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.8/threadify_sdk.egg-info}/PKG-INFO

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