agentdraft 0.1.1__tar.gz → 0.1.2__tar.gz

{agentdraft-0.1.1 → agentdraft-0.1.2}/PKG-INFO

@@ -1,13 +1,15 @@
 Metadata-Version: 2.4
 Name: agentdraft
-Version: 0.1.1
-Summary: Coordination layer for AI scheduling agents — race-free multi-agent booking with priority ranking and an audit log.
+Version: 0.1.2
+Summary: AgentDraft SDK — ops API for AI agents with inbox, conflict-free calendar booking, and audit trail.
 Author-email: AgentDraft Labs <hello@agentdraft.io>
 License: MIT
 Project-URL: Homepage, https://agentdraft.io
 Project-URL: Documentation, https://agentdraft.io/docs
 Project-URL: Specification, https://agentdraft.io/spec
 Project-URL: Changelog, https://agentdraft.io/changelog
+Project-URL: Repository, https://github.com/ryabinski-labs/agentdraft
+Project-URL: Issues, https://github.com/ryabinski-labs/agentdraft/issues
 Keywords: agentdraft,ai-agents,agents,calendar,scheduling,booking,coordination,langchain,crewai,autogen,mcp
 Classifier: Development Status :: 4 - Beta
 Classifier: Intended Audience :: Developers
@@ -54,6 +56,14 @@ pip install agentdraft
 
 Requires Python 3.9+.
 
+## Upgrade
+
+```bash
+pip install -U agentdraft
+```
+
+Release notes: <https://agentdraft.io/changelog>
+
 ## Quickstart
 
 ```python
@@ -69,13 +79,21 @@ try:
     booking = client.bookings.commit(
         start=start, end=end,
         idempotency_key="ik_call_42",
-        metadata={"title": "Discovery call"},
+        title="Discovery call",
+        invitee={"name": "Ada Lovelace", "email": "ada@example.com"},
     )
     print("booked:", booking.booking_id)
 except Conflict as e:
     print(f"outranked by {e.winning_agent_id} (rank {e.winning_agent_priority})")
 ```
 
+`title` and `invitee` (`{name, email, notes}`, all optional) are first-class
+fields: they're persisted on the booking, echoed back on the returned
+`Booking`, and shown to the calendar owner in the dashboard. A top-level
+`title` supersedes the legacy `metadata={"title": ...}`. `client.agents.me()`
+also returns the owner's `timezone` so a client can render slots in their
+zone.
+
 A losing agent gets a typed `Conflict` exception, not a timeout — it
 knows who won, by what priority, and where the audit row lives, so
 fallback behavior (propose an alternate, escalate, defer) is a clean
@@ -104,7 +122,7 @@ configurable bump window.
 The repo ships a multi-agent race demo. With the local stack up:
 
 ```bash
-git clone https://github.com/GipsyChef/agentdraft && cd agentdraft
+git clone https://github.com/ryabinski-labs/agentdraft && cd agentdraft
 docker compose up -d dynamodb
 pip install -e ".[dev]" -e sdks/python
 uvicorn app.main:app --port 8080 &
@@ -177,8 +195,8 @@ wrappers is on the roadmap.
 - Protocol spec: <https://agentdraft.io/spec>
 - API docs: <https://agentdraft.io/docs>
 - Changelog: <https://agentdraft.io/changelog>
-- Source & issues: <https://github.com/GipsyChef/agentdraft>
-- TypeScript SDK: [`@agentdraft/sdk`](https://www.npmjs.com/package/@agentdraft/sdk)
+- Source & issues: <https://github.com/ryabinski-labs/agentdraft>
+- TypeScript SDK: [`agentdraft`](https://www.npmjs.com/package/agentdraft)
 
 ## Security
 

{agentdraft-0.1.1 → agentdraft-0.1.2}/README.md

@@ -25,6 +25,14 @@ pip install agentdraft
 
 Requires Python 3.9+.
 
+## Upgrade
+
+```bash
+pip install -U agentdraft
+```
+
+Release notes: <https://agentdraft.io/changelog>
+
 ## Quickstart
 
 ```python
@@ -40,13 +48,21 @@ try:
     booking = client.bookings.commit(
         start=start, end=end,
         idempotency_key="ik_call_42",
-        metadata={"title": "Discovery call"},
+        title="Discovery call",
+        invitee={"name": "Ada Lovelace", "email": "ada@example.com"},
     )
     print("booked:", booking.booking_id)
 except Conflict as e:
     print(f"outranked by {e.winning_agent_id} (rank {e.winning_agent_priority})")
 ```
 
+`title` and `invitee` (`{name, email, notes}`, all optional) are first-class
+fields: they're persisted on the booking, echoed back on the returned
+`Booking`, and shown to the calendar owner in the dashboard. A top-level
+`title` supersedes the legacy `metadata={"title": ...}`. `client.agents.me()`
+also returns the owner's `timezone` so a client can render slots in their
+zone.
+
 A losing agent gets a typed `Conflict` exception, not a timeout — it
 knows who won, by what priority, and where the audit row lives, so
 fallback behavior (propose an alternate, escalate, defer) is a clean
@@ -75,7 +91,7 @@ configurable bump window.
 The repo ships a multi-agent race demo. With the local stack up:
 
 ```bash
-git clone https://github.com/GipsyChef/agentdraft && cd agentdraft
+git clone https://github.com/ryabinski-labs/agentdraft && cd agentdraft
 docker compose up -d dynamodb
 pip install -e ".[dev]" -e sdks/python
 uvicorn app.main:app --port 8080 &
@@ -148,8 +164,8 @@ wrappers is on the roadmap.
 - Protocol spec: <https://agentdraft.io/spec>
 - API docs: <https://agentdraft.io/docs>
 - Changelog: <https://agentdraft.io/changelog>
-- Source & issues: <https://github.com/GipsyChef/agentdraft>
-- TypeScript SDK: [`@agentdraft/sdk`](https://www.npmjs.com/package/@agentdraft/sdk)
+- Source & issues: <https://github.com/ryabinski-labs/agentdraft>
+- TypeScript SDK: [`agentdraft`](https://www.npmjs.com/package/agentdraft)
 
 ## Security
 

{agentdraft-0.1.1 → agentdraft-0.1.2}/agentdraft/__init__.py

@@ -16,24 +16,35 @@ Quickstart::
         booking = client.bookings.commit(
             start=start, end=end,
             idempotency_key="ik_call_42",
-            metadata={"title": "Discovery call"},
+            title="Discovery call",
+            invitee={"name": "Ada Lovelace", "email": "ada@example.com"},
         )
         print("booked:", booking.booking_id)
     except Conflict as e:
         print(f"outranked by {e.winning_agent_id} (rank {e.winning_agent_priority})")
 """
 
-__version__ = "0.1.1"
+__version__ = "0.1.2"
 
 from .client import Client
-from .errors import AgentDraftError, AuthError, Conflict, RateLimited, RuleViolation
+from .errors import (
+    AgentDraftError,
+    ApprovalTimeout,
+    AuthError,
+    Conflict,
+    ConsentRequired,
+    RateLimited,
+    RuleViolation,
+)
 from .models import Booking, Hold, Slot
 
 __all__ = [
     "Client",
     "AgentDraftError",
+    "ApprovalTimeout",
     "AuthError",
     "Conflict",
+    "ConsentRequired",
     "RateLimited",
     "RuleViolation",
     "Booking",

{agentdraft-0.1.1 → agentdraft-0.1.2}/agentdraft/client.py

@@ -3,13 +3,22 @@
 from __future__ import annotations
 
 import os
+import time
 from datetime import datetime
 from typing import Any, Optional
 
 import httpx
 
 from . import __version__
-from .errors import AgentDraftError, AuthError, Conflict, RateLimited, RuleViolation
+from .errors import (
+    AgentDraftError,
+    ApprovalTimeout,
+    AuthError,
+    Conflict,
+    ConsentRequired,
+    RateLimited,
+    RuleViolation,
+)
 from .models import AgentIdentity, Booking, Slot
 
 DEFAULT_BASE_URL = "https://api.agentdraft.io"
@@ -57,6 +66,7 @@ class Client:
         self.bookings = _Bookings(self)
         self.agents = _Agents(self)
         self.mailbox = _Mailbox(self)
+        self.approvals = _Approvals(self)
 
     def close(self) -> None:
         self._http.close()
@@ -92,6 +102,15 @@ class Client:
     def _raise_for(self, status: int, body: dict, headers: dict) -> None:
         if status == 401 or status == 403:
             raise AuthError(body.get("detail") or str(body), status=status, body=body)
+        if status == 409 and body.get("error") == "consent_required":
+            raise ConsentRequired(
+                "consent_required",
+                body=body,
+                consent_request_id=body.get("consent_request_id"),
+                action=body.get("action"),
+                hold_id=body.get("hold_id"),
+                expires_at=body.get("expires_at"),
+            )
         if status == 409:
             raise Conflict(
                 body.get("error", "outranked"),
@@ -162,6 +181,9 @@ class _Bookings(_Resource):
         buffer_after_min: int = 0,
         bump_window_seconds: Optional[int] = None,
         metadata: Optional[dict] = None,
+        with_conferencing: bool = False,
+        title: Optional[str] = None,
+        invitee: Optional[dict] = None,
     ) -> Booking:
         return self._post(
             start=start,
@@ -172,6 +194,9 @@ class _Bookings(_Resource):
             buffer_after_min=buffer_after_min,
             bump_window_seconds=bump_window_seconds,
             metadata=metadata,
+            with_conferencing=with_conferencing,
+            title=title,
+            invitee=invitee,
         )
 
     def hold(
@@ -183,6 +208,8 @@ class _Bookings(_Resource):
         buffer_before_min: int = 0,
         buffer_after_min: int = 0,
         metadata: Optional[dict] = None,
+        title: Optional[str] = None,
+        invitee: Optional[dict] = None,
     ) -> Booking:
         return self._post(
             start=start,
@@ -192,6 +219,8 @@ class _Bookings(_Resource):
             buffer_before_min=buffer_before_min,
             buffer_after_min=buffer_after_min,
             metadata=metadata,
+            title=title,
+            invitee=invitee,
         )
 
     def release(self, hold_id: str) -> None:
@@ -214,6 +243,12 @@ class _Bookings(_Resource):
             body["bump_window_seconds"] = kwargs["bump_window_seconds"]
         if kwargs.get("metadata"):
             body["metadata"] = kwargs["metadata"]
+        if kwargs.get("with_conferencing"):
+            body["with_conferencing"] = True
+        if kwargs.get("title"):
+            body["title"] = kwargs["title"]
+        if kwargs.get("invitee"):
+            body["invitee"] = kwargs["invitee"]
 
         headers = {"Idempotency-Key": idempotency_key} if idempotency_key else None
         _, j, _ = self._c._request("POST", "/v1/bookings", json=body, headers=headers)
@@ -312,3 +347,84 @@ class _Mailbox(_Resource):
             "GET", f"/v1/mailbox/suppressions/{quote(address, safe='@+.')}"
         )
         return j
+
+
+TERMINAL_APPROVAL_STATUSES = frozenset({"approved", "denied", "expired"})
+
+
+class _Approvals(_Resource):
+    """Human sign-off for anything your agent is about to do (#446).
+
+    The action need not be an AgentDraft one — gate a deploy, a refund, or an
+    outbound email on the same call. Requires the ``approvals:request`` scope.
+
+        approval = client.approvals.request(
+            action_type="deploy.production",
+            summary="Ship v2.3.0 to production",
+            evidence={"commit": "a1b2c3d", "migrations": 2},
+        )
+        result = client.approvals.wait(approval["approval_id"])
+        if result["status"] != "approved":
+            raise SystemExit(f"stood down: {result['status']}")
+    """
+
+    def request(
+        self,
+        action_type: str,
+        summary: str,
+        *,
+        evidence: Optional[dict] = None,
+        ttl_seconds: Optional[int] = None,
+        idempotency_key: Optional[str] = None,
+    ) -> dict:
+        """Open a request and return immediately with ``{approval_id, status,
+        expires_at}``. Nothing blocks until you call :meth:`wait`."""
+        body: dict[str, Any] = {"action_type": action_type, "summary": summary}
+        if evidence is not None:
+            body["evidence"] = evidence
+        if ttl_seconds is not None:
+            body["ttl_seconds"] = ttl_seconds
+        headers = {"Idempotency-Key": idempotency_key} if idempotency_key else None
+        _, j, _ = self._c._request("POST", "/v1/approvals", json=body, headers=headers)
+        return j
+
+    def get(self, approval_id: str) -> dict:
+        """Current state of a request, including its resolution once decided."""
+        _, j, _ = self._c._request("GET", f"/v1/approvals/{approval_id}")
+        return j
+
+    def wait(
+        self,
+        approval_id: str,
+        *,
+        timeout: Optional[float] = None,
+        poll_interval: float = 5.0,
+    ) -> dict:
+        """Block until a human decides, then return the resolved approval.
+
+        Returns on any terminal status — ``approved``, ``denied``, or
+        ``expired`` — so check ``result["status"]`` rather than assuming a
+        return means yes.
+
+        ``timeout`` is a client-side ceiling in seconds. Left unset, the wait
+        follows the request's own ``expires_at``: once it lapses the server
+        sweeps it to ``expired`` and this returns that, so the default never
+        loops forever. :class:`ApprovalTimeout` therefore only fires when *you*
+        set a timeout shorter than the request's life — the request stays
+        pending and resolvable when it does.
+        """
+        started = time.monotonic()
+        deadline = started + timeout if timeout is not None else None
+        while True:
+            current = self.get(approval_id)
+            if current.get("status") in TERMINAL_APPROVAL_STATUSES:
+                return current
+
+            waited = time.monotonic() - started
+            if deadline is not None and time.monotonic() + poll_interval > deadline:
+                raise ApprovalTimeout(
+                    f"approval {approval_id} still pending after {waited:.0f}s",
+                    approval_id=approval_id,
+                    waited_seconds=waited,
+                )
+            time.sleep(poll_interval)

{agentdraft-0.1.1 → agentdraft-0.1.2}/agentdraft/errors.py

@@ -46,6 +46,49 @@ class Conflict(AgentDraftError):
         self.reason = reason
 
 
+class ConsentRequired(AgentDraftError):
+    """409 — a high-impact action is gated on a human approve/deny (#236).
+
+    The slot is parked as a HOLD until a person decides on the dashboard, so the
+    action is neither committed nor lost. ``consent_request_id`` identifies the
+    pending decision; ``hold_id`` is the parked hold; ``expires_at`` is when the
+    park (and the request) lapse if nobody acts. Distinct from ``Conflict``: you
+    did not lose to another agent — you're waiting on a human.
+    """
+
+    def __init__(
+        self,
+        message: str,
+        *,
+        status: int = 409,
+        body: dict,
+        consent_request_id: Optional[str] = None,
+        action: Optional[str] = None,
+        hold_id: Optional[str] = None,
+        expires_at: Optional[str] = None,
+    ):
+        super().__init__(message, status=status, body=body)
+        self.consent_request_id = consent_request_id
+        self.action = action
+        self.hold_id = hold_id
+        self.expires_at = expires_at
+
+
+class ApprovalTimeout(AgentDraftError):
+    """``approvals.wait()`` gave up before a human decided (#446).
+
+    Client-side only — the request is still pending on the server and a human
+    can still resolve it, so treat this as "not yet", not "denied". Poll again
+    with :meth:`Client.approvals.get` or wait again; ``approval_id`` is carried
+    so you can.
+    """
+
+    def __init__(self, message: str, *, approval_id: str, waited_seconds: float):
+        super().__init__(message)
+        self.approval_id = approval_id
+        self.waited_seconds = waited_seconds
+
+
 class RuleViolation(AgentDraftError):
     """422 — the proposed booking violates a rule (working hours, focus block, etc.)."""
 

{agentdraft-0.1.1 → agentdraft-0.1.2}/agentdraft/models.py

@@ -19,14 +19,33 @@ class Booking:
     status: str  # "COMMITTED" | "HOLD"
     expires_at: Optional[datetime] = None
     audit_event_id: Optional[str] = None
+    # First-class booking identity (echoed back when you set them on commit/hold).
+    # `title` is the human-readable label; `invitee` is the `{name, email, notes}`
+    # of the person the slot is for. Both are None when not supplied.
+    title: Optional[str] = None
+    invitee: Optional[dict] = None
+    # Present only when the booking was committed with `with_conferencing=True`.
+    # `conferencing_provider` is e.g. "jitsi" or "google_meet". `conferencing_url`
+    # is None when a link could not be produced — `conferencing_status` then says
+    # why ("no_provider", "auth_expired", "api_error", "no_link_returned");
+    # "attached" means the url is populated.
+    conferencing_url: Optional[str] = None
+    conferencing_provider: Optional[str] = None
+    conferencing_status: Optional[str] = None
 
     @classmethod
     def from_json(cls, j: dict) -> "Booking":
+        conf = j.get("conferencing") or {}
         return cls(
             booking_id=j["booking_id"],
             status=j["status"],
             expires_at=_parse_dt(j.get("expires_at")),
             audit_event_id=j.get("audit_event_id"),
+            title=j.get("title"),
+            invitee=j.get("invitee"),
+            conferencing_url=conf.get("url"),
+            conferencing_provider=conf.get("provider"),
+            conferencing_status=conf.get("status"),
         )
 
 
@@ -53,6 +72,10 @@ class AgentIdentity:
     user_id: str
     priority: int
     scopes: list[str]
+    # The owner's IANA timezone (e.g. "America/New_York"), so a client can render
+    # slots in the owner's zone instead of converting blind. "UTC" until the owner
+    # sets one in the dashboard.
+    timezone: str = "UTC"
 
     @classmethod
     def from_json(cls, j: dict) -> "AgentIdentity":
@@ -61,4 +84,5 @@ class AgentIdentity:
             user_id=j["user_id"],
             priority=j["priority"],
             scopes=j.get("scopes", []),
+            timezone=j.get("timezone") or "UTC",
         )

{agentdraft-0.1.1 → agentdraft-0.1.2}/agentdraft.egg-info/PKG-INFO

@@ -1,13 +1,15 @@
 Metadata-Version: 2.4
 Name: agentdraft
-Version: 0.1.1
-Summary: Coordination layer for AI scheduling agents — race-free multi-agent booking with priority ranking and an audit log.
+Version: 0.1.2
+Summary: AgentDraft SDK — ops API for AI agents with inbox, conflict-free calendar booking, and audit trail.
 Author-email: AgentDraft Labs <hello@agentdraft.io>
 License: MIT
 Project-URL: Homepage, https://agentdraft.io
 Project-URL: Documentation, https://agentdraft.io/docs
 Project-URL: Specification, https://agentdraft.io/spec
 Project-URL: Changelog, https://agentdraft.io/changelog
+Project-URL: Repository, https://github.com/ryabinski-labs/agentdraft
+Project-URL: Issues, https://github.com/ryabinski-labs/agentdraft/issues
 Keywords: agentdraft,ai-agents,agents,calendar,scheduling,booking,coordination,langchain,crewai,autogen,mcp
 Classifier: Development Status :: 4 - Beta
 Classifier: Intended Audience :: Developers
@@ -54,6 +56,14 @@ pip install agentdraft
 
 Requires Python 3.9+.
 
+## Upgrade
+
+```bash
+pip install -U agentdraft
+```
+
+Release notes: <https://agentdraft.io/changelog>
+
 ## Quickstart
 
 ```python
@@ -69,13 +79,21 @@ try:
     booking = client.bookings.commit(
         start=start, end=end,
         idempotency_key="ik_call_42",
-        metadata={"title": "Discovery call"},
+        title="Discovery call",
+        invitee={"name": "Ada Lovelace", "email": "ada@example.com"},
     )
     print("booked:", booking.booking_id)
 except Conflict as e:
     print(f"outranked by {e.winning_agent_id} (rank {e.winning_agent_priority})")
 ```
 
+`title` and `invitee` (`{name, email, notes}`, all optional) are first-class
+fields: they're persisted on the booking, echoed back on the returned
+`Booking`, and shown to the calendar owner in the dashboard. A top-level
+`title` supersedes the legacy `metadata={"title": ...}`. `client.agents.me()`
+also returns the owner's `timezone` so a client can render slots in their
+zone.
+
 A losing agent gets a typed `Conflict` exception, not a timeout — it
 knows who won, by what priority, and where the audit row lives, so
 fallback behavior (propose an alternate, escalate, defer) is a clean
@@ -104,7 +122,7 @@ configurable bump window.
 The repo ships a multi-agent race demo. With the local stack up:
 
 ```bash
-git clone https://github.com/GipsyChef/agentdraft && cd agentdraft
+git clone https://github.com/ryabinski-labs/agentdraft && cd agentdraft
 docker compose up -d dynamodb
 pip install -e ".[dev]" -e sdks/python
 uvicorn app.main:app --port 8080 &
@@ -177,8 +195,8 @@ wrappers is on the roadmap.
 - Protocol spec: <https://agentdraft.io/spec>
 - API docs: <https://agentdraft.io/docs>
 - Changelog: <https://agentdraft.io/changelog>
-- Source & issues: <https://github.com/GipsyChef/agentdraft>
-- TypeScript SDK: [`@agentdraft/sdk`](https://www.npmjs.com/package/@agentdraft/sdk)
+- Source & issues: <https://github.com/ryabinski-labs/agentdraft>
+- TypeScript SDK: [`agentdraft`](https://www.npmjs.com/package/agentdraft)
 
 ## Security
 

{agentdraft-0.1.1 → agentdraft-0.1.2}/pyproject.toml

@@ -1,7 +1,7 @@
 [project]
 name = "agentdraft"
-version = "0.1.1"
-description = "Coordination layer for AI scheduling agents — race-free multi-agent booking with priority ranking and an audit log."
+version = "0.1.2"
+description = "AgentDraft SDK — ops API for AI agents with inbox, conflict-free calendar booking, and audit trail."
 readme = "README.md"
 requires-python = ">=3.9"
 license = { text = "MIT" }
@@ -40,6 +40,8 @@ Homepage = "https://agentdraft.io"
 Documentation = "https://agentdraft.io/docs"
 Specification = "https://agentdraft.io/spec"
 Changelog = "https://agentdraft.io/changelog"
+Repository = "https://github.com/ryabinski-labs/agentdraft"
+Issues = "https://github.com/ryabinski-labs/agentdraft/issues"
 
 [build-system]
 requires = ["setuptools>=68"]