pushary 2.1.2__tar.gz → 2.2.0__tar.gz

{pushary-2.1.2 → pushary-2.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: pushary
-Version: 2.1.2
+Version: 2.2.0
 Summary: The decision layer for AI agents. Your agent asks, your user decides on their phone.
 Project-URL: Homepage, https://pushary.com
 Project-URL: Documentation, https://pushary.com/docs
@@ -287,3 +287,7 @@ Shared approval gates now bind decision identity to the customer, session, tool
 These keys intentionally differ from 2.0. Do not replay completed operations during upgrade or silently migrate an old approval onto a new key. Drain pending runs on their original version, or explicitly request fresh review while preserving your application's operation idempotency. `policy=False` now records the full subject and presentation on the human decision; a failed legacy policy endpoint retains the prior minimal fallback for compatibility.
 
 `decisions.create` and `decisions.ask` accept `presentation`, using the existing server-validated shape with `label`, `effect`, optional `risk`, and `changes` that reference keys in `parameters`. Shared `ask_human` and `create_durable_decision` helpers forward that field plus target, actor, environment, parameters, placeholder, expiry, reachability, and callback settings. Parameter values remain the source of truth for display; presentation changes name a parameter rather than carrying a second copy of its value.
+
+### Upgrading to 2.2
+
+`ApprovalAsk` accepts `context`. The shared approval gate sends it with the decision, so the approver can read what the notification cannot fit, such as a tool's full arguments. Context is part of the approval identity when set. An ask without context keeps the key it had in 2.1, so pending approvals carry over.

{pushary-2.1.2 → pushary-2.2.0}/README.md

@@ -259,3 +259,7 @@ Shared approval gates now bind decision identity to the customer, session, tool
 These keys intentionally differ from 2.0. Do not replay completed operations during upgrade or silently migrate an old approval onto a new key. Drain pending runs on their original version, or explicitly request fresh review while preserving your application's operation idempotency. `policy=False` now records the full subject and presentation on the human decision; a failed legacy policy endpoint retains the prior minimal fallback for compatibility.
 
 `decisions.create` and `decisions.ask` accept `presentation`, using the existing server-validated shape with `label`, `effect`, optional `risk`, and `changes` that reference keys in `parameters`. Shared `ask_human` and `create_durable_decision` helpers forward that field plus target, actor, environment, parameters, placeholder, expiry, reachability, and callback settings. Parameter values remain the source of truth for display; presentation changes name a parameter rather than carrying a second copy of its value.
+
+### Upgrading to 2.2
+
+`ApprovalAsk` accepts `context`. The shared approval gate sends it with the decision, so the approver can read what the notification cannot fit, such as a tool's full arguments. Context is part of the approval identity when set. An ask without context keeps the key it had in 2.1, so pending approvals carry over.

{pushary-2.1.2 → pushary-2.2.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "pushary"
-version = "2.1.2"
+version = "2.2.0"
 description = "The decision layer for AI agents. Your agent asks, your user decides on their phone."
 readme = "README.md"
 requires-python = ">=3.9"

{pushary-2.1.2 → pushary-2.2.0}/src/pushary/__init__.py

@@ -22,7 +22,7 @@ from .keys import KeysResource
 from .errors import PusharyError
 from .webhook import SIGNATURE_HEADER, parse_decision_callback, verify_webhook_signature
 
-__version__ = "2.1.2"
+__version__ = "2.2.0"
 
 __all__ = [
     "PusharyServer",

{pushary-2.1.2 → pushary-2.2.0}/src/pushary/adapters.py

@@ -153,6 +153,7 @@ def _gate_key(ask: "ApprovalAsk", facts: Optional[Dict[str, Any]]) -> str:
         "input": ask.input,
         "parameters": facts,
         "presentation": ask.presentation,
+        **({"context": ask.context} if ask.context is not None else {}),
     })
 
 
@@ -251,6 +252,7 @@ class ApprovalAsk:
         "input",
         "parameters",
         "presentation",
+        "context",
     )
 
     def __init__(
@@ -267,6 +269,7 @@ class ApprovalAsk:
         input: Any = None,
         parameters: Optional[Dict[str, Any]] = None,
         presentation: Optional[Dict[str, Any]] = None,
+        context: Optional[str] = None,
     ) -> None:
         self.tool_name = tool_name
         self.call_id = call_id
@@ -286,6 +289,7 @@ class ApprovalAsk:
         #: Explicit facts for policy, used instead of deriving them from ``input``.
         self.parameters = parameters
         self.presentation = presentation
+        self.context = context
 
 
 class ApprovalDecision:
@@ -689,6 +693,7 @@ class AdapterKernel:
                 ask.question,
                 type="confirm",
                 external_id=ask.external_id,
+                context=ask.context,
                 agent_name=agent_name,
                 expires_in_seconds=expires_in_seconds,
                 timeout_seconds=timeout_seconds,

{pushary-2.1.2 → pushary-2.2.0}/tests/test_adapters.py

@@ -268,6 +268,55 @@ class GateTests(unittest.TestCase):
         self.assertEqual(keys[0], keys[1])
         self.assertNotEqual(keys[0], keys[2])
 
+    def test_shows_the_approver_the_context(self):
+        decisions = FakeDecisions(ask_result={"answered": True, "approved": True, "value": "yes", "decisionId": "d1"})
+        with WithFakeClient(FakeClient(decisions=decisions)):
+            kernel.create_gate()(
+                ApprovalAsk(
+                    tool_name="issue_refund",
+                    call_id="call_1",
+                    session_id="sess_1",
+                    question="Approve?",
+                    external_id="user_1",
+                    context='Tool arguments: {"amount": 99999}',
+                )
+            )
+        self.assertEqual(decisions.ask_calls[0]["context"], 'Tool arguments: {"amount": 99999}')
+
+    def test_context_is_part_of_the_approval_identity(self):
+        decisions = FakeDecisions(ask_result={"answered": True, "approved": True, "value": "yes", "decisionId": "d1"})
+        with WithFakeClient(FakeClient(decisions=decisions)):
+            gate = kernel.create_gate()
+            for context in ("Refund 5", "Refund 99999"):
+                gate(
+                    ApprovalAsk(
+                        tool_name="issue_refund",
+                        call_id="call_1",
+                        session_id="sess_1",
+                        question="Approve?",
+                        external_id="user_1",
+                        context=context,
+                    )
+                )
+        first, second = (call["idempotency_key"] for call in decisions.ask_calls)
+        self.assertNotEqual(first, second)
+
+    def test_an_ask_without_context_keeps_the_key_it_had_before_context_existed(self):
+        decisions = FakeDecisions(ask_result={"answered": True, "approved": True, "value": "yes", "decisionId": "d1"})
+        with WithFakeClient(FakeClient(decisions=decisions)):
+            kernel.create_gate()(
+                ApprovalAsk(
+                    tool_name="issue_refund",
+                    call_id="call_1",
+                    session_id="sess_1",
+                    question="Approve?",
+                    external_id="user_1",
+                    input={"amount": 5},
+                )
+            )
+        self.assertIsNone(decisions.ask_calls[0]["context"])
+        self.assertEqual(decisions.ask_calls[0]["idempotency_key"], "135e90787543c78d72b7008ce463da08d1ce8769")
+
     def test_allows_without_opening_a_decision_or_paging_anyone(self):
         decisions = FakeDecisions()
         client = FakeClient(