open-agentpay 0.2.0__tar.gz → 0.2.2__tar.gz

{open_agentpay-0.2.0 → open_agentpay-0.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: open-agentpay
-Version: 0.2.0
+Version: 0.2.2
 Summary: The Open-Source Payment Infrastructure & Financial Firewall for Autonomous AI Agents
 Project-URL: Homepage, https://github.com/open-agentpay/AgentPay
 Project-URL: Documentation, https://open-agentpay.github.io/AgentPay/
@@ -67,7 +67,7 @@ Description-Content-Type: text/markdown
 
 **AgentPay** equips autonomous AI agents with micro-payments (Circle USDC on Arbitrum Sepolia & Base) governed by an in-process, non-custodial **Financial Firewall**. It transparently intercepts `HTTP 402 Payment Required` responses, validates policy limits, and signs off-chain authorizations—protecting agent wallets against runaway loops and LLM hallucinations.
 
-> 📦 **Package Name Note**: The canonical PyPI distribution is [`open-agentpay`](https://pypi.org/project/open-agentpay/) (official aliases: `agentpay-core`, `agent-pay`, `agentpay-firewall`). Regardless of which package you install, you import `agentpay` in Python code.
+> 📦 **Package Name Note**: The canonical PyPI distribution is [`open-agentpay`](https://pypi.org/project/open-agentpay/) (official aliases: `agentpay-core`, `agentpay-firewall`). Regardless of which package you install, you import `agentpay` in Python code.
 
 ---
 

{open_agentpay-0.2.0 → open_agentpay-0.2.2}/README.md

@@ -33,7 +33,7 @@
 
 **AgentPay** equips autonomous AI agents with micro-payments (Circle USDC on Arbitrum Sepolia & Base) governed by an in-process, non-custodial **Financial Firewall**. It transparently intercepts `HTTP 402 Payment Required` responses, validates policy limits, and signs off-chain authorizations—protecting agent wallets against runaway loops and LLM hallucinations.
 
-> 📦 **Package Name Note**: The canonical PyPI distribution is [`open-agentpay`](https://pypi.org/project/open-agentpay/) (official aliases: `agentpay-core`, `agent-pay`, `agentpay-firewall`). Regardless of which package you install, you import `agentpay` in Python code.
+> 📦 **Package Name Note**: The canonical PyPI distribution is [`open-agentpay`](https://pypi.org/project/open-agentpay/) (official aliases: `agentpay-core`, `agentpay-firewall`). Regardless of which package you install, you import `agentpay` in Python code.
 
 ---
 

{open_agentpay-0.2.0 → open_agentpay-0.2.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "open-agentpay"
-version = "0.2.0"
+version = "0.2.2"
 description = "The Open-Source Payment Infrastructure & Financial Firewall for Autonomous AI Agents"
 readme = "README.md"
 license = "Apache-2.0"

{open_agentpay-0.2.0 → open_agentpay-0.2.2}/src/agentpay/__init__.py

@@ -3,7 +3,7 @@ AgentPay Python SDK
 The Open-Source Payment Infrastructure & Financial Firewall for Autonomous AI Agents.
 """
 
-__version__ = "0.2.0"
+__version__ = "0.2.2"
 
 from agentpay.client import (
     AgentPayClient,

open_agentpay-0.2.2/src/agentpay/client/client.py

@@ -0,0 +1,170 @@
+"""
+AgentPayClient: Drop-in httpx.Client with automatic 402 payment negotiation.
+
+Wraps the financial firewall and EIP-712 cryptographic signer to automatically
+satisfy HTTP 402 Payment Required challenges.
+
+Note on ``transport=``: unlike a plain httpx.Client, the transport you pass here is the
+INNER transport. It is always wrapped by AgentPayTransport so every request passes the firewall.
+"""
+
+from __future__ import annotations
+
+from collections.abc import Callable
+from typing import Any
+
+import httpx
+
+from agentpay.client.interfaces import ISigner
+from agentpay.client.transport import (
+    DEFAULT_CREDENTIAL_HEADERS,
+    DEFAULT_CREDENTIAL_VALUE_PREFIXES,
+    AgentPayTransport,
+    AsyncAgentPayTransport,
+    CredentialMode,
+)
+from agentpay.policy.interfaces import IPolicyEngine
+
+# Client kwargs that configure the default network transport. httpx only applies them when it builds
+# the transport itself; since we always inject ours, they must be forwarded to the inner transport.
+_INNER_PASSTHROUGH = ("verify", "cert", "http1", "http2", "limits", "trust_env")
+
+
+def _inner_transport_kwargs(kwargs: dict[str, Any]) -> dict[str, Any]:
+    """Collect inner-transport settings from client kwargs (mutates ``kwargs``: removes ``proxy``)."""
+    if "mounts" in kwargs or "proxies" in kwargs:
+        # httpx routes matching URLs to mounted transports BEFORE the default transport,
+        # which would skip the payment firewall entirely.
+        raise TypeError(
+            "AgentPayClient does not support 'mounts'/'proxies': they bypass the payment firewall. "
+            "Pass a pre-configured inner transport via transport=... or use proxy=..."
+        )
+    out = {k: kwargs[k] for k in _INNER_PASSTHROUGH if k in kwargs}
+    if "proxy" in kwargs:
+        # Left in kwargs, httpx would create a proxy mount that bypasses AgentPayTransport.
+        out["proxy"] = kwargs.pop("proxy")
+    return out
+
+
+class AgentPayClient(httpx.Client):
+    """
+    HTTP client for autonomous AI agents with integrated financial firewall.
+
+    Inherits from httpx.Client: fully compatible with LangChain, LlamaIndex,
+    and standard Python HTTP toolchains. Set ``wallet_challenge_mode=True`` when
+    sending AgentPay Gateway API-key requests so the first request can receive
+    a price challenge before any wallet hold is placed.
+    """
+
+    def __init__(
+            self,
+            signer: ISigner,
+            policy: IPolicyEngine,
+            *,
+            transport: httpx.BaseTransport | None = None,
+            auto_retry_on_402: bool = True,
+            raise_on_policy_rejection: bool = False,
+            clock: Callable[[], int] | None = None,
+            unmetered_credential_policy: CredentialMode = "block",
+            credential_headers: tuple[str, ...] = DEFAULT_CREDENTIAL_HEADERS,
+            credential_value_prefixes: tuple[str, ...] = DEFAULT_CREDENTIAL_VALUE_PREFIXES,
+            estimate_cost: Callable[[httpx.Request], int] | None = None,
+            actual_cost: Callable[[httpx.Response], int | None] | None = None,
+            credential_ttl_seconds: int = 60,
+            wallet_challenge_mode: bool = False,
+            **kwargs: Any,
+    ) -> None:
+        inner_kwargs = _inner_transport_kwargs(kwargs)
+
+        self.signer = signer
+        self.policy = policy
+        self.auto_retry_on_402 = auto_retry_on_402
+        self.raise_on_policy_rejection = raise_on_policy_rejection
+        self._clock = clock
+        self.unmetered_credential_policy = unmetered_credential_policy
+        # Single source of truth, reused by async_client() so both clients behave identically.
+        self._agentpay_options: dict[str, Any] = {
+            "auto_retry_on_402": auto_retry_on_402,
+            "raise_on_policy_rejection": raise_on_policy_rejection,
+            "clock": clock,
+            "unmetered_credential_policy": unmetered_credential_policy,
+            "credential_headers": credential_headers,
+            "credential_value_prefixes": credential_value_prefixes,
+            "estimate_cost": estimate_cost,
+            "actual_cost": actual_cost,
+            "credential_ttl_seconds": credential_ttl_seconds,
+            "wallet_challenge_mode": wallet_challenge_mode,
+        }
+
+        inner = transport if transport is not None else httpx.HTTPTransport(**inner_kwargs)
+        agent_transport = AgentPayTransport(inner, signer, policy, **self._agentpay_options)
+        super().__init__(transport=agent_transport, **kwargs)
+
+    def async_client(
+            self,
+            *,
+            transport: httpx.AsyncBaseTransport | None = None,
+            **kwargs: Any,
+    ) -> AsyncAgentPayClient:
+        """Create an AsyncAgentPayClient sharing the same signer, policy and firewall options."""
+        options = {**self._agentpay_options, **{k: v for k, v in kwargs.items() if k in self._agentpay_options}}
+        client_kwargs = {k: v for k, v in kwargs.items() if k not in self._agentpay_options}
+        return AsyncAgentPayClient(
+            signer=self.signer,
+            policy=self.policy,
+            transport=transport,
+            **options,
+            **client_kwargs,
+        )
+
+
+class AsyncAgentPayClient(httpx.AsyncClient):
+    """
+    Asynchronous HTTP client for autonomous AI agents with integrated financial firewall.
+
+    Inherits from httpx.AsyncClient. Use ``wallet_challenge_mode=True`` for
+    AgentPay Gateway API-key requests that must be priced before wallet payment.
+    """
+
+    def __init__(
+            self,
+            signer: ISigner,
+            policy: IPolicyEngine,
+            *,
+            transport: httpx.AsyncBaseTransport | None = None,
+            auto_retry_on_402: bool = True,
+            raise_on_policy_rejection: bool = False,
+            clock: Callable[[], int] | None = None,
+            unmetered_credential_policy: CredentialMode = "block",
+            credential_headers: tuple[str, ...] = DEFAULT_CREDENTIAL_HEADERS,
+            credential_value_prefixes: tuple[str, ...] = DEFAULT_CREDENTIAL_VALUE_PREFIXES,
+            estimate_cost: Callable[[httpx.Request], int] | None = None,
+            actual_cost: Callable[[httpx.Response], int | None] | None = None,
+            credential_ttl_seconds: int = 60,
+            wallet_challenge_mode: bool = False,
+            **kwargs: Any,
+    ) -> None:
+        inner_kwargs = _inner_transport_kwargs(kwargs)
+
+        self.signer = signer
+        self.policy = policy
+        self.auto_retry_on_402 = auto_retry_on_402
+        self.raise_on_policy_rejection = raise_on_policy_rejection
+        self._clock = clock
+        self.unmetered_credential_policy = unmetered_credential_policy
+        self._agentpay_options: dict[str, Any] = {
+            "auto_retry_on_402": auto_retry_on_402,
+            "raise_on_policy_rejection": raise_on_policy_rejection,
+            "clock": clock,
+            "unmetered_credential_policy": unmetered_credential_policy,
+            "credential_headers": credential_headers,
+            "credential_value_prefixes": credential_value_prefixes,
+            "estimate_cost": estimate_cost,
+            "actual_cost": actual_cost,
+            "credential_ttl_seconds": credential_ttl_seconds,
+            "wallet_challenge_mode": wallet_challenge_mode,
+        }
+
+        inner = transport if transport is not None else httpx.AsyncHTTPTransport(**inner_kwargs)
+        agent_transport = AsyncAgentPayTransport(inner, signer, policy, **self._agentpay_options)
+        super().__init__(transport=agent_transport, **kwargs)