pushary 2.2.1__tar.gz → 2.3.0__tar.gz

{pushary-2.2.1 → pushary-2.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: pushary
-Version: 2.2.1
+Version: 2.3.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
@@ -291,3 +291,8 @@ These keys intentionally differ from 2.0. Do not replay completed operations dur
 ### 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.
+## Personal reminders
+
+On an active Agent workspace, `client.reminders.schedule("Check the deploy", in_minutes=30)` saves a one-time reminder that survives the agent exiting. Use `at` with an explicit UTC offset for calendar times, up to 30 days away. `client.reminders.list()` lists your pending reminders; `client.reminders.cancel(reminder_id)` cancels one before dispatch starts. Confirm the returned `reminder.fireAt`. Delivery requires a connected phone and can be about a minute late. These personal reminders do not schedule agent work or Partner customer campaigns.
+
+Personal reminder bodies must fit 180 UTF-16 units after secret redaction (most emoji use two); titles must fit 100. Oversized text is rejected. Listing and cancelling accepted reminders remain available when billing access closes.

{pushary-2.2.1 → pushary-2.3.0}/README.md

@@ -263,3 +263,8 @@ These keys intentionally differ from 2.0. Do not replay completed operations dur
 ### 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.
+## Personal reminders
+
+On an active Agent workspace, `client.reminders.schedule("Check the deploy", in_minutes=30)` saves a one-time reminder that survives the agent exiting. Use `at` with an explicit UTC offset for calendar times, up to 30 days away. `client.reminders.list()` lists your pending reminders; `client.reminders.cancel(reminder_id)` cancels one before dispatch starts. Confirm the returned `reminder.fireAt`. Delivery requires a connected phone and can be about a minute late. These personal reminders do not schedule agent work or Partner customer campaigns.
+
+Personal reminder bodies must fit 180 UTF-16 units after secret redaction (most emoji use two); titles must fit 100. Oversized text is rejected. Listing and cancelling accepted reminders remain available when billing access closes.

{pushary-2.2.1 → pushary-2.3.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "pushary"
-version = "2.2.1"
+version = "2.3.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.2.1 → pushary-2.3.0}/src/pushary/__init__.py

@@ -19,15 +19,17 @@ from ._util import deterministic_key, is_approved
 from .client import PusharyServer
 from .decisions import DecisionsResource
 from .keys import KeysResource
+from .reminders import RemindersResource
 from .errors import PusharyError
 from .webhook import SIGNATURE_HEADER, parse_decision_callback, verify_webhook_signature
 
-__version__ = "2.2.1"
+__version__ = "2.3.0"
 
 __all__ = [
     "PusharyServer",
     "DecisionsResource",
     "KeysResource",
+    "RemindersResource",
     "PusharyError",
     "verify_webhook_signature",
     "parse_decision_callback",

{pushary-2.2.1 → pushary-2.3.0}/src/pushary/client.py

@@ -15,6 +15,7 @@ from urllib.parse import quote, urlencode
 
 from .decisions import DecisionsResource
 from .keys import KeysResource
+from .reminders import RemindersResource
 from .errors import PusharyError
 
 DEFAULT_BASE_URL = "https://pushary.com/api/v1/server"
@@ -49,6 +50,7 @@ class PusharyServer:
         self._timeout = DEFAULT_TIMEOUT_SECONDS
         self.decisions = DecisionsResource(self._request)
         self.keys = KeysResource(self._request)
+        self.reminders = RemindersResource(self._request)
 
     def evaluate_authorization(
         self,

pushary-2.3.0/src/pushary/reminders.py

@@ -0,0 +1,25 @@
+from __future__ import annotations
+from typing import Callable, Dict, Optional
+
+RequestFn = Callable[..., Dict[str, object]]
+
+
+class RemindersResource:
+    def __init__(self, request: RequestFn) -> None:
+        self._request = request
+
+    def schedule(
+        self, body: str, *, in_minutes: Optional[int] = None, at: Optional[str] = None,
+        title: Optional[str] = None, agent_name: Optional[str] = None,
+        session_id: Optional[str] = None, machine_id: Optional[str] = None,
+        env: Optional[str] = None,
+    ) -> Dict[str, object]:
+        values = {"body": body, "inMinutes": in_minutes, "at": at, "title": title,
+                  "agentName": agent_name, "sessionId": session_id, "machineId": machine_id, "env": env}
+        return self._request("POST", "/reminders", body={key: value for key, value in values.items() if value is not None})
+
+    def list(self) -> Dict[str, object]:
+        return self._request("GET", "/reminders")
+
+    def cancel(self, reminder_id: str) -> Dict[str, object]:
+        return self._request("POST", "/reminders", body={"cancelReminderId": reminder_id})

pushary-2.3.0/tests/test_reminders.py

@@ -0,0 +1,17 @@
+import unittest
+from unittest import mock
+from pushary import PusharyServer
+
+
+class ReminderTests(unittest.TestCase):
+    def test_schedule_list_and_cancel_use_authenticated_reminder_resource(self):
+        with mock.patch.object(PusharyServer, '_request', return_value={'pending': []}) as request:
+            client = PusharyServer('pk_test.secret')
+            client.reminders.schedule('Check deploy', in_minutes=30)
+            client.reminders.list()
+            client.reminders.cancel('id')
+        self.assertEqual(request.call_args_list, [
+            mock.call('POST', '/reminders', body={'body': 'Check deploy', 'inMinutes': 30}),
+            mock.call('GET', '/reminders'),
+            mock.call('POST', '/reminders', body={'cancelReminderId': 'id'}),
+        ])