paid-python 0.4.1__tar.gz → 0.5.0__tar.gz

{paid_python-0.4.1 → paid_python-0.5.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: paid-python
-Version: 0.4.1
+Version: 0.5.0
 Summary: 
 Requires-Python: >=3.9,<3.14
 Classifier: Intended Audience :: Developers
@@ -183,7 +183,7 @@ The easiest way to add cost tracking is using the `@paid_tracing` decorator or c
 ```python
 from paid.tracing import paid_tracing
 
-@paid_tracing("<external_customer_id>", external_agent_id="<optional_external_agent_id>")
+@paid_tracing("<external_customer_id>", external_product_id="<optional_external_product_id>")
 def some_agent_workflow():  # your function
     # Your logic - use any AI providers with Paid wrappers or send signals with signal().
     # This function is typically an event processor that should lead to AI calls or events emitted as Paid signals
@@ -197,11 +197,11 @@ You can also use `paid_tracing` as a context manager with `with` statements:
 from paid.tracing import paid_tracing
 
 # Synchronous
-with paid_tracing("customer_123", external_agent_id="agent_456"):
+with paid_tracing("customer_123", external_product_id="product_456"):
     result = workflow()
 
 # Asynchronous
-async with paid_tracing("customer_123", external_agent_id="agent_456"):
+async with paid_tracing("customer_123", external_product_id="product_456"):
     result = await workflow()
 ```
 
@@ -210,7 +210,7 @@ Both approaches:
 - Initialize tracing using your API key you provided to the Paid client, falls back to `PAID_API_KEY` environment variable.
 - Handle both sync and async functions/code blocks
 - Gracefully fall back to normal execution if tracing fails
-- Support the same parameters: `external_customer_id`, `external_agent_id`, `tracing_token`, `store_prompt`, `metadata`
+- Support the same parameters: `external_customer_id`, `external_product_id`, `tracing_token`, `store_prompt`, `metadata`
 
 * Note - if it happens that you're calling `paid_tracing` from non-main thread, then it's advised to initialize from main thread:
 ```python
@@ -249,7 +249,7 @@ openAIClient = PaidOpenAI(OpenAI(
     api_key="<OPENAI_API_KEY>",
 ))
 
-@paid_tracing("your_external_customer_id", "your_external_agent_id")
+@paid_tracing("your_external_customer_id", external_product_id="your_external_product_id")
 def image_generate():
     response = openAIClient.images.generate(
         model="dall-e-3",
@@ -281,7 +281,7 @@ You can attach custom metadata to your traces by passing a `metadata` dictionary
 
     @paid_tracing(
         "customer_123",
-        "agent_123",
+        external_product_id="product_123",
         metadata={
             "campaign_id": "campaign_456",
             "environment": "production",
@@ -325,7 +325,7 @@ You can attach custom metadata to your traces by passing a `metadata` dictionary
     # Pass metadata to context manager
     with paid_tracing(
         "customer_123",
-        external_agent_id="agent_123",
+        external_product_id="product_123",
         metadata={
             "campaign_id": "campaign_456",
             "environment": "production",
@@ -380,7 +380,7 @@ paid_autoinstrument()  # instruments all available: anthropic, gemini, openai, o
 # Now all OpenAI calls will be automatically traced
 openai_client = OpenAI(api_key="<OPENAI_API_KEY>")
 
-@paid_tracing("your_external_customer_id", "your_external_agent_id")
+@paid_tracing("your_external_customer_id", external_product_id="your_external_product_id")
 def chat_with_gpt():
     response = openai_client.chat.completions.create(
         model="gpt-4",
@@ -433,7 +433,7 @@ Here's an example of how to use it:
 ```python
 from paid.tracing import paid_tracing, signal
 
-@paid_tracing("your_external_customer_id", "your_external_agent_id")
+@paid_tracing("your_external_customer_id", external_product_id="your_external_product_id")
 def do_work():
     # ...do some work...
     signal(
@@ -457,7 +457,7 @@ def do_work():
     )
 
 # Use context manager instead
-with paid_tracing("your_external_customer_id", "your_external_agent_id"):
+with paid_tracing("your_external_customer_id", external_product_id="your_external_product_id"):
     do_work()
 ```
 
@@ -472,7 +472,7 @@ This will look something like this:
 ```python
 from paid.tracing import paid_tracing, signal
 
-@paid_tracing("your_external_customer_id", "your_external_agent_id")
+@paid_tracing("your_external_customer_id", external_product_id="your_external_product_id")
 def do_work():
     # ... your workflow logic
     # ... your AI calls made through Paid wrappers or hooks
@@ -516,7 +516,7 @@ print(f"Tracing token: {token}")
 # Store token for other processes (e.g., in Redis, database, message queue)
 save_to_storage("workflow_123", token)
 
-@paid_tracing("customer_123", tracing_token=token, external_agent_id="agent_123")
+@paid_tracing("customer_123", tracing_token=token, external_product_id="product_123")
 def process_part_1():
     # AI calls here will be traced
     response = openai_client.chat.completions.create(
@@ -531,7 +531,7 @@ process_part_1()
 # Process 2 (different machine/process): Retrieve and use token
 token = load_from_storage("workflow_123")
 
-@paid_tracing("customer_123", tracing_token=token, external_agent_id="agent_123")
+@paid_tracing("customer_123", tracing_token=token, external_product_id="product_123")
 def process_part_2():
     # AI calls here will be linked to the same trace
     response = openai_client.chat.completions.create(
@@ -561,7 +561,7 @@ openai_client = PaidOpenAI(OpenAI(api_key="<OPENAI_API_KEY>"))
 token = generate_tracing_token()
 save_to_storage("workflow_123", token)
 
-with paid_tracing("customer_123", external_agent_id="agent_123", tracing_token=token):
+with paid_tracing("customer_123", external_product_id="product_123", tracing_token=token):
     response = openai_client.chat.completions.create(
         model="gpt-4",
         messages=[{"role": "user", "content": "Analyze data"}]
@@ -571,7 +571,7 @@ with paid_tracing("customer_123", external_agent_id="agent_123", tracing_token=t
 # Process 2: Retrieve and use the same token
 token = load_from_storage("workflow_123")
 
-with paid_tracing("customer_123", external_agent_id="agent_123", tracing_token=token):
+with paid_tracing("customer_123", external_product_id="product_123", tracing_token=token):
     response = openai_client.chat.completions.create(
         model="gpt-4",
         messages=[{"role": "user", "content": "Generate response"}]
@@ -613,7 +613,7 @@ Alternatively the same `costData` payload can be passed to OTLP signaling mechan
 ```python
 from paid.tracing import paid_tracing, signal
 
-@paid_tracing("your_external_customer_id", "your_external_agent_id")
+@paid_tracing("your_external_customer_id", external_product_id="your_external_product_id")
 def do_work():
     # ...do some work...
     signal(
@@ -667,7 +667,7 @@ Same but via OTEL signaling:
 ```python
 from paid.tracing import paid_tracing, signal
 
-@paid_tracing("your_external_customer_id", "your_external_agent_id")
+@paid_tracing("your_external_customer_id", external_product_id="your_external_product_id")
 def do_work():
     # ...do some work...
     signal(
@@ -719,7 +719,7 @@ initialize_tracing()
 # Wrap the async OpenAI client
 openai_client = PaidAsyncOpenAI(AsyncOpenAI(api_key="<OPENAI_API_KEY>"))
 
-@paid_tracing("your_external_customer_id", "your_external_agent_id")
+@paid_tracing("your_external_customer_id", external_product_id="your_external_product_id")
 async def generate_image():
     response = await openai_client.images.generate(
         model="dall-e-3",
@@ -747,7 +747,7 @@ initialize_tracing()
 
 openai_client = PaidAsyncOpenAI(AsyncOpenAI(api_key="<OPENAI_API_KEY>"))
 
-@paid_tracing("your_external_customer_id", "your_external_agent_id")
+@paid_tracing("your_external_customer_id", external_product_id="your_external_product_id")
 async def do_work():
     # Perform async AI operations
     response = await openai_client.chat.completions.create(

{paid_python-0.4.1 → paid_python-0.5.0}/README.md

@@ -148,7 +148,7 @@ The easiest way to add cost tracking is using the `@paid_tracing` decorator or c
 ```python
 from paid.tracing import paid_tracing
 
-@paid_tracing("<external_customer_id>", external_agent_id="<optional_external_agent_id>")
+@paid_tracing("<external_customer_id>", external_product_id="<optional_external_product_id>")
 def some_agent_workflow():  # your function
     # Your logic - use any AI providers with Paid wrappers or send signals with signal().
     # This function is typically an event processor that should lead to AI calls or events emitted as Paid signals
@@ -162,11 +162,11 @@ You can also use `paid_tracing` as a context manager with `with` statements:
 from paid.tracing import paid_tracing
 
 # Synchronous
-with paid_tracing("customer_123", external_agent_id="agent_456"):
+with paid_tracing("customer_123", external_product_id="product_456"):
     result = workflow()
 
 # Asynchronous
-async with paid_tracing("customer_123", external_agent_id="agent_456"):
+async with paid_tracing("customer_123", external_product_id="product_456"):
     result = await workflow()
 ```
 
@@ -175,7 +175,7 @@ Both approaches:
 - Initialize tracing using your API key you provided to the Paid client, falls back to `PAID_API_KEY` environment variable.
 - Handle both sync and async functions/code blocks
 - Gracefully fall back to normal execution if tracing fails
-- Support the same parameters: `external_customer_id`, `external_agent_id`, `tracing_token`, `store_prompt`, `metadata`
+- Support the same parameters: `external_customer_id`, `external_product_id`, `tracing_token`, `store_prompt`, `metadata`
 
 * Note - if it happens that you're calling `paid_tracing` from non-main thread, then it's advised to initialize from main thread:
 ```python
@@ -214,7 +214,7 @@ openAIClient = PaidOpenAI(OpenAI(
     api_key="<OPENAI_API_KEY>",
 ))
 
-@paid_tracing("your_external_customer_id", "your_external_agent_id")
+@paid_tracing("your_external_customer_id", external_product_id="your_external_product_id")
 def image_generate():
     response = openAIClient.images.generate(
         model="dall-e-3",
@@ -246,7 +246,7 @@ You can attach custom metadata to your traces by passing a `metadata` dictionary
 
     @paid_tracing(
         "customer_123",
-        "agent_123",
+        external_product_id="product_123",
         metadata={
             "campaign_id": "campaign_456",
             "environment": "production",
@@ -290,7 +290,7 @@ You can attach custom metadata to your traces by passing a `metadata` dictionary
     # Pass metadata to context manager
     with paid_tracing(
         "customer_123",
-        external_agent_id="agent_123",
+        external_product_id="product_123",
         metadata={
             "campaign_id": "campaign_456",
             "environment": "production",
@@ -345,7 +345,7 @@ paid_autoinstrument()  # instruments all available: anthropic, gemini, openai, o
 # Now all OpenAI calls will be automatically traced
 openai_client = OpenAI(api_key="<OPENAI_API_KEY>")
 
-@paid_tracing("your_external_customer_id", "your_external_agent_id")
+@paid_tracing("your_external_customer_id", external_product_id="your_external_product_id")
 def chat_with_gpt():
     response = openai_client.chat.completions.create(
         model="gpt-4",
@@ -398,7 +398,7 @@ Here's an example of how to use it:
 ```python
 from paid.tracing import paid_tracing, signal
 
-@paid_tracing("your_external_customer_id", "your_external_agent_id")
+@paid_tracing("your_external_customer_id", external_product_id="your_external_product_id")
 def do_work():
     # ...do some work...
     signal(
@@ -422,7 +422,7 @@ def do_work():
     )
 
 # Use context manager instead
-with paid_tracing("your_external_customer_id", "your_external_agent_id"):
+with paid_tracing("your_external_customer_id", external_product_id="your_external_product_id"):
     do_work()
 ```
 
@@ -437,7 +437,7 @@ This will look something like this:
 ```python
 from paid.tracing import paid_tracing, signal
 
-@paid_tracing("your_external_customer_id", "your_external_agent_id")
+@paid_tracing("your_external_customer_id", external_product_id="your_external_product_id")
 def do_work():
     # ... your workflow logic
     # ... your AI calls made through Paid wrappers or hooks
@@ -481,7 +481,7 @@ print(f"Tracing token: {token}")
 # Store token for other processes (e.g., in Redis, database, message queue)
 save_to_storage("workflow_123", token)
 
-@paid_tracing("customer_123", tracing_token=token, external_agent_id="agent_123")
+@paid_tracing("customer_123", tracing_token=token, external_product_id="product_123")
 def process_part_1():
     # AI calls here will be traced
     response = openai_client.chat.completions.create(
@@ -496,7 +496,7 @@ process_part_1()
 # Process 2 (different machine/process): Retrieve and use token
 token = load_from_storage("workflow_123")
 
-@paid_tracing("customer_123", tracing_token=token, external_agent_id="agent_123")
+@paid_tracing("customer_123", tracing_token=token, external_product_id="product_123")
 def process_part_2():
     # AI calls here will be linked to the same trace
     response = openai_client.chat.completions.create(
@@ -526,7 +526,7 @@ openai_client = PaidOpenAI(OpenAI(api_key="<OPENAI_API_KEY>"))
 token = generate_tracing_token()
 save_to_storage("workflow_123", token)
 
-with paid_tracing("customer_123", external_agent_id="agent_123", tracing_token=token):
+with paid_tracing("customer_123", external_product_id="product_123", tracing_token=token):
     response = openai_client.chat.completions.create(
         model="gpt-4",
         messages=[{"role": "user", "content": "Analyze data"}]
@@ -536,7 +536,7 @@ with paid_tracing("customer_123", external_agent_id="agent_123", tracing_token=t
 # Process 2: Retrieve and use the same token
 token = load_from_storage("workflow_123")
 
-with paid_tracing("customer_123", external_agent_id="agent_123", tracing_token=token):
+with paid_tracing("customer_123", external_product_id="product_123", tracing_token=token):
     response = openai_client.chat.completions.create(
         model="gpt-4",
         messages=[{"role": "user", "content": "Generate response"}]
@@ -578,7 +578,7 @@ Alternatively the same `costData` payload can be passed to OTLP signaling mechan
 ```python
 from paid.tracing import paid_tracing, signal
 
-@paid_tracing("your_external_customer_id", "your_external_agent_id")
+@paid_tracing("your_external_customer_id", external_product_id="your_external_product_id")
 def do_work():
     # ...do some work...
     signal(
@@ -632,7 +632,7 @@ Same but via OTEL signaling:
 ```python
 from paid.tracing import paid_tracing, signal
 
-@paid_tracing("your_external_customer_id", "your_external_agent_id")
+@paid_tracing("your_external_customer_id", external_product_id="your_external_product_id")
 def do_work():
     # ...do some work...
     signal(
@@ -684,7 +684,7 @@ initialize_tracing()
 # Wrap the async OpenAI client
 openai_client = PaidAsyncOpenAI(AsyncOpenAI(api_key="<OPENAI_API_KEY>"))
 
-@paid_tracing("your_external_customer_id", "your_external_agent_id")
+@paid_tracing("your_external_customer_id", external_product_id="your_external_product_id")
 async def generate_image():
     response = await openai_client.images.generate(
         model="dall-e-3",
@@ -712,7 +712,7 @@ initialize_tracing()
 
 openai_client = PaidAsyncOpenAI(AsyncOpenAI(api_key="<OPENAI_API_KEY>"))
 
-@paid_tracing("your_external_customer_id", "your_external_agent_id")
+@paid_tracing("your_external_customer_id", external_product_id="your_external_product_id")
 async def do_work():
     # Perform async AI operations
     response = await openai_client.chat.completions.create(

{paid_python-0.4.1 → paid_python-0.5.0}/pyproject.toml

@@ -3,7 +3,7 @@ name = "paid-python"
 
 [tool.poetry]
 name = "paid-python"
-version = "0.4.1"
+version = "0.5.0"
 description = ""
 readme = "README.md"
 authors = []

{paid_python-0.4.1 → paid_python-0.5.0}/src/paid/__init__.py

@@ -25,22 +25,39 @@ from .types import (
     Order,
     OrderLine,
     OrderLineAttribute,
-    OrderLineAttributeCreate,
+    OrderLineAttributeCreateOne,
     OrderLineAttributePricing,
     OrderLineCreate,
     PaginationMeta,
+    Plan,
+    PlanPlanProductsItem,
+    PlanPlanProductsItemPlanProductAttributeItem,
     PricePoint,
     Pricing,
     PricingModelType,
+    Product,
+    ProductType,
+    ProductUpdate,
+    ProductUpdateType,
     Salutation,
     Signal,
+    SignalV2,
     TaxExemptStatus,
     Tier,
+    Trace,
+    TracesResponse,
+    UsagePaginationMeta,
+    UsageSummariesResponse,
+    UsageSummary,
+    UsageSummaryOrder,
+    UsageSummaryOrderLine,
 )
-from .errors import BadRequestError, ForbiddenError, NotFoundError
-from . import agents, contacts, customers, orders, usage
+from .errors import BadRequestError, ForbiddenError, InternalServerError, NotFoundError
+from . import agents, contacts, customers, orders, plans, products, traces, usage
 from .client import AsyncPaid, Paid
 from .environment import PaidEnvironment
+from .products import ProductCreateType
+from .usage import UsageCheckUsageResponse
 from .version import __version__
 
 __all__ = [
@@ -66,27 +83,48 @@ __all__ = [
     "EntitlementUsage",
     "Error",
     "ForbiddenError",
+    "InternalServerError",
     "NotFoundError",
     "Order",
     "OrderLine",
     "OrderLineAttribute",
-    "OrderLineAttributeCreate",
+    "OrderLineAttributeCreateOne",
     "OrderLineAttributePricing",
     "OrderLineCreate",
     "PaginationMeta",
     "Paid",
     "PaidEnvironment",
+    "Plan",
+    "PlanPlanProductsItem",
+    "PlanPlanProductsItemPlanProductAttributeItem",
     "PricePoint",
     "Pricing",
     "PricingModelType",
+    "Product",
+    "ProductCreateType",
+    "ProductType",
+    "ProductUpdate",
+    "ProductUpdateType",
     "Salutation",
     "Signal",
+    "SignalV2",
     "TaxExemptStatus",
     "Tier",
+    "Trace",
+    "TracesResponse",
+    "UsageCheckUsageResponse",
+    "UsagePaginationMeta",
+    "UsageSummariesResponse",
+    "UsageSummary",
+    "UsageSummaryOrder",
+    "UsageSummaryOrderLine",
     "__version__",
     "agents",
     "contacts",
     "customers",
     "orders",
+    "plans",
+    "products",
+    "traces",
     "usage",
 ]

{paid_python-0.4.1 → paid_python-0.5.0}/src/paid/agents/client.py

@@ -29,6 +29,8 @@ class AgentsClient:
 
     def list(self, *, request_options: typing.Optional[RequestOptions] = None) -> typing.List[Agent]:
         """
+        DEPRECATED: Use /products instead. Agents are now products with type='agent'.
+
         Parameters
         ----------
         request_options : typing.Optional[RequestOptions]
@@ -62,6 +64,8 @@ class AgentsClient:
         request_options: typing.Optional[RequestOptions] = None,
     ) -> Agent:
         """
+        DEPRECATED: Use POST /products instead.
+
         Parameters
         ----------
         name : str
@@ -107,6 +111,8 @@ class AgentsClient:
 
     def get(self, agent_id: str, *, request_options: typing.Optional[RequestOptions] = None) -> Agent:
         """
+        DEPRECATED: Use GET /products/{productId} instead.
+
         Parameters
         ----------
         agent_id : str
@@ -146,6 +152,8 @@ class AgentsClient:
         request_options: typing.Optional[RequestOptions] = None,
     ) -> Agent:
         """
+        DEPRECATED: Use PUT /products/{productId} instead.
+
         Parameters
         ----------
         agent_id : str
@@ -235,6 +243,8 @@ class AgentsClient:
 
     def delete(self, agent_id: str, *, request_options: typing.Optional[RequestOptions] = None) -> None:
         """
+        DEPRECATED: Use DELETE /products/{productId} instead.
+
         Parameters
         ----------
         agent_id : str
@@ -262,6 +272,8 @@ class AgentsClient:
 
     def get_by_external_id(self, external_id: str, *, request_options: typing.Optional[RequestOptions] = None) -> Agent:
         """
+        DEPRECATED: Use GET /products/external/{externalId} instead.
+
         Parameters
         ----------
         external_id : str
@@ -301,6 +313,8 @@ class AgentsClient:
         request_options: typing.Optional[RequestOptions] = None,
     ) -> Agent:
         """
+        DEPRECATED: Use PUT /products/external/{externalId} instead.
+
         Parameters
         ----------
         external_id_ : str
@@ -371,6 +385,8 @@ class AgentsClient:
         self, external_id: str, *, request_options: typing.Optional[RequestOptions] = None
     ) -> None:
         """
+        DEPRECATED: Use DELETE /products/external/{externalId} instead.
+
         Parameters
         ----------
         external_id : str
@@ -414,6 +430,8 @@ class AsyncAgentsClient:
 
     async def list(self, *, request_options: typing.Optional[RequestOptions] = None) -> typing.List[Agent]:
         """
+        DEPRECATED: Use /products instead. Agents are now products with type='agent'.
+
         Parameters
         ----------
         request_options : typing.Optional[RequestOptions]
@@ -455,6 +473,8 @@ class AsyncAgentsClient:
         request_options: typing.Optional[RequestOptions] = None,
     ) -> Agent:
         """
+        DEPRECATED: Use POST /products instead.
+
         Parameters
         ----------
         name : str
@@ -508,6 +528,8 @@ class AsyncAgentsClient:
 
     async def get(self, agent_id: str, *, request_options: typing.Optional[RequestOptions] = None) -> Agent:
         """
+        DEPRECATED: Use GET /products/{productId} instead.
+
         Parameters
         ----------
         agent_id : str
@@ -555,6 +577,8 @@ class AsyncAgentsClient:
         request_options: typing.Optional[RequestOptions] = None,
     ) -> Agent:
         """
+        DEPRECATED: Use PUT /products/{productId} instead.
+
         Parameters
         ----------
         agent_id : str
@@ -652,6 +676,8 @@ class AsyncAgentsClient:
 
     async def delete(self, agent_id: str, *, request_options: typing.Optional[RequestOptions] = None) -> None:
         """
+        DEPRECATED: Use DELETE /products/{productId} instead.
+
         Parameters
         ----------
         agent_id : str
@@ -689,6 +715,8 @@ class AsyncAgentsClient:
         self, external_id: str, *, request_options: typing.Optional[RequestOptions] = None
     ) -> Agent:
         """
+        DEPRECATED: Use GET /products/external/{externalId} instead.
+
         Parameters
         ----------
         external_id : str
@@ -736,6 +764,8 @@ class AsyncAgentsClient:
         request_options: typing.Optional[RequestOptions] = None,
     ) -> Agent:
         """
+        DEPRECATED: Use PUT /products/external/{externalId} instead.
+
         Parameters
         ----------
         external_id_ : str
@@ -814,6 +844,8 @@ class AsyncAgentsClient:
         self, external_id: str, *, request_options: typing.Optional[RequestOptions] = None
     ) -> None:
         """
+        DEPRECATED: Use DELETE /products/external/{externalId} instead.
+
         Parameters
         ----------
         external_id : str