paid-python 0.1.0__py3-none-any.whl → 0.1.1__py3-none-any.whl

paid/tracing/context_manager.py

@@ -62,7 +62,7 @@ class paid_tracing:
 
     def __init__(
         self,
-        external_customer_id: str,
+        external_customer_id: Optional[str] = None,
         *,
         external_agent_id: Optional[str] = None,
         tracing_token: Optional[int] = None,

paid/tracing/tracing.py

@@ -258,7 +258,7 @@ def get_paid_tracer() -> trace.Tracer:
 
 
 def trace_sync_(
-    external_customer_id: str,
+    external_customer_id: Optional[str],
     fn: Callable[..., T],
     external_agent_id: Optional[str] = None,
     tracing_token: Optional[int] = None,
@@ -316,9 +316,6 @@ def trace_sync_(
         tracer = get_paid_tracer()
         logger.info(f"Creating span for external_customer_id: {external_customer_id}")
         with tracer.start_as_current_span("parent_span", context=ctx) as span:
-            span.set_attribute("external_customer_id", external_customer_id)
-            if external_agent_id:
-                span.set_attribute("external_agent_id", external_agent_id)
             try:
                 result = fn(*args, **kwargs)
                 span.set_status(Status(StatusCode.OK))
@@ -335,7 +332,7 @@ def trace_sync_(
 
 
 async def trace_async_(
-    external_customer_id: str,
+    external_customer_id: Optional[str],
     fn: Callable[..., Union[T, Awaitable[T]]],
     external_agent_id: Optional[str] = None,
     tracing_token: Optional[int] = None,
@@ -393,9 +390,6 @@ async def trace_async_(
         tracer = get_paid_tracer()
         logger.info(f"Creating span for external_customer_id: {external_customer_id}")
         with tracer.start_as_current_span("parent_span", context=ctx) as span:
-            span.set_attribute("external_customer_id", external_customer_id)
-            if external_agent_id:
-                span.set_attribute("external_agent_id", external_agent_id)
             try:
                 if asyncio.iscoroutinefunction(fn):
                     result = await fn(*args, **kwargs)

{paid_python-0.1.0.dist-info → paid_python-0.1.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: paid-python
-Version: 0.1.0
+Version: 0.1.1
 Summary: 
 Requires-Python: >=3.9,<3.14
 Classifier: Intended Audience :: Developers
@@ -205,6 +205,98 @@ def image_generate():
 image_generate()
 ```
 
+### Passing User Metadata
+
+You can attach custom metadata to your traces by passing a `metadata` dictionary to the `paid_tracing()` decorator or context manager. This metadata will be stored with the trace and can be used to filter and query traces later.
+
+<Tabs>
+  <Tab title="Python - Decorator">
+    ```python
+    from paid.tracing import paid_tracing, signal
+    from paid.tracing.wrappers import PaidOpenAI
+    from openai import OpenAI
+
+    openai_client = PaidOpenAI(OpenAI(api_key="<OPENAI_API_KEY>"))
+
+    @paid_tracing(
+        "customer_123",
+        "agent_123",
+        metadata={
+            "campaign_id": "campaign_456",
+            "environment": "production",
+            "user_tier": "enterprise"
+        }
+    )
+    def process_event(event):
+        """Process event with custom metadata"""
+        response = openai_client.chat.completions.create(
+            model="gpt-4",
+            messages=[{"role": "user", "content": event.content}]
+        )
+
+        signal("event_processed", enable_cost_tracing=True)
+        return response
+
+    process_event(incoming_event)
+    ```
+  </Tab>
+
+  <Tab title="Python - Context Manager">
+    ```python
+    from paid.tracing import paid_tracing, signal
+    from paid.tracing.wrappers import PaidOpenAI
+    from openai import OpenAI
+
+    openai_client = PaidOpenAI(OpenAI(api_key="<OPENAI_API_KEY>"))
+
+    def process_event(event):
+        """Process event with custom metadata"""
+        response = openai_client.chat.completions.create(
+            model="gpt-4",
+            messages=[{"role": "user", "content": event.content}]
+        )
+
+        signal("event_processed", enable_cost_tracing=True)
+        return response
+
+    # Pass metadata to context manager
+    with paid_tracing(
+        "customer_123",
+        external_agent_id="agent_123",
+        metadata={
+            "campaign_id": "campaign_456",
+            "environment": "production",
+            "user_tier": "enterprise"
+        }
+    ):
+        process_event(incoming_event)
+    ```
+  </Tab>
+
+  <Tab title="Node.js">
+    ```typescript
+    // Metadata support is not yet available in the Node.js SDK.
+    // Please use Python for passing custom metadata to traces.
+    ```
+  </Tab>
+</Tabs>
+
+#### Querying Traces by Metadata
+
+Once you've added metadata to your traces, you can filter traces using the metadata parameter in the traces API endpoint:
+
+```bash
+# Filter by single metadata field
+curl -G "https://api.paid.ai/api/organizations/{orgId}/traces" \
+  --data-urlencode 'metadata={"campaign_id":"campaign_456"}' \
+  -H "Authorization: Bearer YOUR_API_KEY"
+
+# Filter by multiple metadata fields (all must match)
+curl -G "https://api.paid.ai/api/organizations/{orgId}/traces" \
+  --data-urlencode 'metadata={"campaign_id":"campaign_456","environment":"production"}' \
+  -H "Authorization: Bearer YOUR_API_KEY"
+```
+
 ### Auto-Instrumentation (OpenTelemetry Instrumentors)
 
 For maximum convenience, you can use OpenTelemetry auto-instrumentation to automatically track costs without modifying your AI library calls. This approach uses official OpenTelemetry instrumentors for supported AI libraries.

{paid_python-0.1.0.dist-info → paid_python-0.1.1.dist-info}/RECORD

@@ -38,10 +38,10 @@ paid/orders/raw_client.py,sha256=650e1Sj2vi9KVJc15M3ENXIKYoth0qMz66dzvXy1Sb4,162
 paid/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 paid/tracing/__init__.py,sha256=IP6OkV885_xlK1H68RxGTX_IhpVAkY266zsWgnQKKTs,440
 paid/tracing/autoinstrumentation.py,sha256=p57bU87x1Xi-nb_2C4O56tcgfvN2UYZAd9pJ0Vyh9Nw,6765
-paid/tracing/context_manager.py,sha256=ZVsmum4np_Eyub1_D0D5ChhvdBWnkFBFqzZHxSsljdU,9716
+paid/tracing/context_manager.py,sha256=qXWYwUisUnAGUjsGNDRR4b0m8DMiu5IfNVnBhE4bwlE,9733
 paid/tracing/distributed_tracing.py,sha256=CpUWpHai-4LxLLHbGxz41r9h5wLG-dC83YL5Vg29OBI,3967
 paid/tracing/signal.py,sha256=PfYxF6EFQS8j7RY5_C5NXrCBVu9Hq2E2tyG4fdQScJk,3252
-paid/tracing/tracing.py,sha256=Xtue-_vuAKLnZ1l6d-tSj9o0UWmMPgXggTVgXYb1Zz4,16230
+paid/tracing/tracing.py,sha256=Pqf7A9I0YU_sk8KEZlS1DF8-hdhNmqGtmfumoX_9jvQ,15878
 paid/tracing/wrappers/__init__.py,sha256=IIleLB_JUbzLw7FshrU2VHZAKF3dZHMGy1O5zCBwwqM,1588
 paid/tracing/wrappers/anthropic/__init__.py,sha256=_x1fjySAQxuT5cIGO_jU09LiGcZH-WQLqKg8mUFAu2w,115
 paid/tracing/wrappers/anthropic/anthropicWrapper.py,sha256=pGchbOb41CbTxc7H8xXoM-LjR085spqrzXqCVC_rrFk,4913
@@ -98,7 +98,7 @@ paid/usage/__init__.py,sha256=_VhToAyIt_5axN6CLJwtxg3-CO7THa_23pbUzqhXJa4,85
 paid/usage/client.py,sha256=280WJuepoovk3BAVbAx2yN2Q_qBdvx3CcPkLu8lXslc,3030
 paid/usage/raw_client.py,sha256=2acg5C4lxuZodZjepU9QYF0fmBxgG-3ZgXs1zUJG-wM,3709
 paid/version.py,sha256=QIpDFnOrxMxrs86eL0iNH0mSZ1DO078wWHYY9TYAoew,78
-paid_python-0.1.0.dist-info/LICENSE,sha256=Nz4baY1zvv0Qy7lqrQtbaiMhmEeGr2Q7A93aqzpml4c,1071
-paid_python-0.1.0.dist-info/METADATA,sha256=liDYbzbDdhe3sBUeAuPaBbD7P99Q3YLYClqGqIu9pYs,18729
-paid_python-0.1.0.dist-info/WHEEL,sha256=Zb28QaM1gQi8f4VCBhsUklF61CTlNYfs9YAZn-TOGFk,88
-paid_python-0.1.0.dist-info/RECORD,,
+paid_python-0.1.1.dist-info/LICENSE,sha256=Nz4baY1zvv0Qy7lqrQtbaiMhmEeGr2Q7A93aqzpml4c,1071
+paid_python-0.1.1.dist-info/METADATA,sha256=YMILAQJcALoQrcvdhyNUjn90d8nNGhJX9bJIVyf0tNw,21580
+paid_python-0.1.1.dist-info/WHEEL,sha256=Zb28QaM1gQi8f4VCBhsUklF61CTlNYfs9YAZn-TOGFk,88
+paid_python-0.1.1.dist-info/RECORD,,