oneshot-python 0.14.0__tar.gz → 0.15.0__tar.gz

{oneshot_python-0.14.0 → oneshot_python-0.15.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: oneshot-python
-Version: 0.14.0
+Version: 0.15.0
 Summary: Core Python SDK for the OneShot API — HTTP client with x402 payment handling
 License-Expression: MIT
 Requires-Python: >=3.10

{oneshot_python-0.14.0 → oneshot_python-0.15.0}/oneshot/client.py

@@ -38,7 +38,7 @@ try:
 
     SDK_VERSION = _pkg_version("oneshot-python")
 except Exception:  # pragma: no cover - editable/source runs without dist metadata
-    SDK_VERSION = "0.12.1"
+    SDK_VERSION = "0.15.0"
 
 # ---------------------------------------------------------------------------
 # Environment configuration
@@ -968,21 +968,27 @@ class OneShotClient:
         value_tag: Optional[dict[str, Any]] = None,
         *,
         request_id: Optional[str] = None,
+        goal_id: Optional[str] = None,
     ) -> dict:
-        """Tag a receipt with a value for RoCS computation. Blocking.
+        """Tag business value for RoCS computation. Blocking.
 
-        Identify the receipt by ``receipt_id`` (``rcpt_…``) or, equivalently, by
-        the ``request_id`` returned from the originating tool call — the API
-        resolves a ``request_id`` via the receipt's ``job_id``, so you can tag
-        value without a prior receipts lookup.
+        Address the value three ways: by ``receipt_id`` (``rcpt_…``); by the
+        ``request_id`` returned from the originating tool call (the API resolves
+        it via the receipt's ``job_id``); or by ``goal_id`` — a correlation key
+        that attributes a whole *cadence's* outcome (a closed deal across the
+        intro email + follow-ups + find/verify/enrich calls sharing
+        ``decisionContext.goalId``) in one call. Read goal-level rollups back via
+        ``rocs_by_goal``.
 
         ``value_tag`` shape: ``{"type": ..., "amount": ..., "label": ...}``.
         ``type`` must be one of ``revenue``, ``lead``, ``conversion``,
-        ``savings``, ``engagement``. Tags are stored as ``pending`` until a
-        judge service confirms them against inbound signals.
+        ``savings``, ``engagement``. Stored as ``pending`` until a judge service
+        confirms them against inbound signals.
         """
         return asyncio.get_event_loop().run_until_complete(
-            self.atag_receipt_value(receipt_id, value_tag, request_id=request_id)
+            self.atag_receipt_value(
+                receipt_id, value_tag, request_id=request_id, goal_id=goal_id
+            )
         )
 
     async def atag_receipt_value(
@@ -991,15 +997,24 @@ class OneShotClient:
         value_tag: Optional[dict[str, Any]] = None,
         *,
         request_id: Optional[str] = None,
+        goal_id: Optional[str] = None,
     ) -> dict:
-        """Tag a receipt with a value for RoCS computation. Async."""
+        """Tag business value for RoCS computation. Async."""
+        if not isinstance(value_tag, dict) or not value_tag.get("type"):
+            raise ValidationError("value_tag.type is required", "value_tag.type")
+
+        # Cadence-level: route to the outcome ledger by correlation key.
+        if goal_id and not receipt_id and not request_id:
+            return await self.acall_free_post(
+                "/v1/analytics/outcomes",
+                {"goal_id": goal_id, **value_tag},
+            )
+
         target = receipt_id or request_id
         if not target:
             raise ValidationError(
-                "receipt_id or request_id is required", "receipt_id"
+                "receipt_id, request_id, or goal_id is required", "receipt_id"
             )
-        if not isinstance(value_tag, dict) or not value_tag.get("type"):
-            raise ValidationError("value_tag.type is required", "value_tag.type")
         return await self.acall_free_patch(
             f"/v1/analytics/receipts/{target}/value",
             value_tag,

{oneshot_python-0.14.0 → oneshot_python-0.15.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "oneshot-python"
-version = "0.14.0"
+version = "0.15.0"
 description = "Core Python SDK for the OneShot API — HTTP client with x402 payment handling"
 readme = {text = "Core Python SDK for the OneShot API", content-type = "text/plain"}
 license = "MIT"