oceanalt-aml 0.1.0__tar.gz

oceanalt_aml-0.1.0/PKG-INFO

@@ -0,0 +1,32 @@
+Metadata-Version: 2.4
+Name: oceanalt-aml
+Version: 0.1.0
+Summary: OceanAlt pre-payment check for AI agents: allow, review or decline before your agent pays. Includes an Amazon Bedrock AgentCore pre_sign_policy.
+Author-email: OceanAlt <business@oceanalt.com>
+License: MIT
+Project-URL: Homepage, https://oceanalt.com
+Project-URL: Documentation, https://oceanalt.com/en/api-docs
+Keywords: oceanalt,ai-agents,agent-payments,x402,pre-payment,mcp,agentcore
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+
+# oceanalt-aml
+
+OceanAlt pre-payment check for AI agents: before your agent pays, ask whether the payment should proceed. Returns `allow`, `review` or `decline` with reasons and evidence.
+
+```python
+from oceanalt_aml import decide
+r = decide("0xd90e2f925DA726b50C4Ed8D0Fb90Ad053324F31b", network="ethereum")
+print(r["decision"])  # decline: a known mixer
+```
+
+## Amazon Bedrock AgentCore payments
+
+Use it as the `pre_sign_policy` of your payments integration config. It returns `True` only when every payee in the payment request gets `allow`. A decline, a review, a timeout or a request it cannot read returns `False`, so the payment is not signed. Reads x402 v1 bodies and the x402 v2 `Payment-Required` header.
+
+```python
+from oceanalt_aml import agentcore_pre_sign_policy
+# config = <your AgentCore payments integration config>(..., pre_sign_policy=agentcore_pre_sign_policy)
+```
+
+Free, no key, no dependencies. Docs: https://oceanalt.com/en/api-docs · Hosted MCP server: https://oceanalt.com/api/mcp

oceanalt_aml-0.1.0/README.md

@@ -0,0 +1,20 @@
+# oceanalt-aml
+
+OceanAlt pre-payment check for AI agents: before your agent pays, ask whether the payment should proceed. Returns `allow`, `review` or `decline` with reasons and evidence.
+
+```python
+from oceanalt_aml import decide
+r = decide("0xd90e2f925DA726b50C4Ed8D0Fb90Ad053324F31b", network="ethereum")
+print(r["decision"])  # decline: a known mixer
+```
+
+## Amazon Bedrock AgentCore payments
+
+Use it as the `pre_sign_policy` of your payments integration config. It returns `True` only when every payee in the payment request gets `allow`. A decline, a review, a timeout or a request it cannot read returns `False`, so the payment is not signed. Reads x402 v1 bodies and the x402 v2 `Payment-Required` header.
+
+```python
+from oceanalt_aml import agentcore_pre_sign_policy
+# config = <your AgentCore payments integration config>(..., pre_sign_policy=agentcore_pre_sign_policy)
+```
+
+Free, no key, no dependencies. Docs: https://oceanalt.com/en/api-docs · Hosted MCP server: https://oceanalt.com/api/mcp

oceanalt_aml-0.1.0/oceanalt_aml/__init__.py

@@ -0,0 +1,107 @@
+"""OceanAlt pre-payment check: ask whether a payment should proceed before your agent pays.
+
+    from oceanalt_aml import decide
+    result = decide("0xd90e2f925DA726b50C4Ed8D0Fb90Ad053324F31b", network="ethereum")
+    result["decision"]  # "allow", "review" or "decline"
+
+Amazon Bedrock AgentCore payments: pass ``agentcore_pre_sign_policy`` as the
+``pre_sign_policy`` of your payments integration config. It returns True only when
+OceanAlt answers ``allow`` for every payee in the payment request; anything else,
+including a timeout or a request it cannot read, blocks signing.
+
+Free, no key. Docs: https://oceanalt.com/en/api-docs
+Hosted MCP server: https://oceanalt.com/api/mcp
+"""
+import base64
+import json
+import urllib.parse
+import urllib.request
+
+__version__ = "0.1.0"
+BASE_URL = "https://oceanalt.com"
+_UA = "oceanalt-aml-python/" + __version__
+
+
+def decide(to, network=None, timeout=10.0, base_url=BASE_URL):
+    """Return OceanAlt's pre-payment decision for a payee address as a dict.
+
+    Anything other than decision == "allow" means do not pay without review.
+    Network or HTTP errors raise; treat them as not cleared.
+    """
+    params = {"to": str(to)}
+    if network:
+        params["network"] = str(network)
+    url = base_url.rstrip("/") + "/api/decide?" + urllib.parse.urlencode(params)
+    req = urllib.request.Request(url, headers={"accept": "application/json", "user-agent": _UA})
+    with urllib.request.urlopen(req, timeout=timeout) as resp:
+        return json.loads(resp.read().decode("utf-8"))
+
+
+def _b64json(text):
+    s = str(text).strip()
+    s = s + "=" * (-len(s) % 4)
+    for dec in (base64.b64decode, base64.urlsafe_b64decode):
+        try:
+            return json.loads(dec(s).decode("utf-8"))
+        except Exception:
+            continue
+    return None
+
+
+def _header(headers, name):
+    if not isinstance(headers, dict):
+        return None
+    for k, v in headers.items():
+        if str(k).lower() == name.lower():
+            return v
+    return None
+
+
+def payees_from_request(request):
+    """Extract (payTo, network) pairs from an AgentCore payment-required request.
+
+    Handles x402 v1 (dict or JSON-string body with ``accepts``) and x402 v2
+    (base64 JSON in the ``Payment-Required`` header). Returns [] when nothing
+    can be read, which the policy treats as a block.
+    """
+    if not isinstance(request, dict):
+        return []
+    docs = []
+    body = request.get("body")
+    if isinstance(body, str):
+        try:
+            body = json.loads(body)
+        except Exception:
+            body = None
+    if isinstance(body, dict):
+        docs.append(body)
+    hdr = _header(request.get("headers"), "Payment-Required")
+    if hdr:
+        decoded = _b64json(hdr)
+        if isinstance(decoded, dict):
+            docs.append(decoded)
+    out = []
+    for doc in docs:
+        for acc in doc.get("accepts") or []:
+            if isinstance(acc, dict) and acc.get("payTo"):
+                out.append((str(acc["payTo"]), str(acc.get("network") or "") or None))
+    return out
+
+
+def agentcore_pre_sign_policy(request, timeout=8.0, base_url=BASE_URL):
+    """``pre_sign_policy`` for Amazon Bedrock AgentCore payments.
+
+    True only if every payee offered in the request gets ``allow``. A request
+    that cannot be read (for example MPP), a timeout, an error or any other
+    decision returns False, so the payment is not signed.
+    """
+    try:
+        payees = payees_from_request(request)
+        if not payees:
+            return False
+        for pay_to, network in payees:
+            if decide(pay_to, network=network, timeout=timeout, base_url=base_url).get("decision") != "allow":
+                return False
+        return True
+    except Exception:
+        return False

oceanalt_aml-0.1.0/oceanalt_aml.egg-info/PKG-INFO

@@ -0,0 +1,32 @@
+Metadata-Version: 2.4
+Name: oceanalt-aml
+Version: 0.1.0
+Summary: OceanAlt pre-payment check for AI agents: allow, review or decline before your agent pays. Includes an Amazon Bedrock AgentCore pre_sign_policy.
+Author-email: OceanAlt <business@oceanalt.com>
+License: MIT
+Project-URL: Homepage, https://oceanalt.com
+Project-URL: Documentation, https://oceanalt.com/en/api-docs
+Keywords: oceanalt,ai-agents,agent-payments,x402,pre-payment,mcp,agentcore
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+
+# oceanalt-aml
+
+OceanAlt pre-payment check for AI agents: before your agent pays, ask whether the payment should proceed. Returns `allow`, `review` or `decline` with reasons and evidence.
+
+```python
+from oceanalt_aml import decide
+r = decide("0xd90e2f925DA726b50C4Ed8D0Fb90Ad053324F31b", network="ethereum")
+print(r["decision"])  # decline: a known mixer
+```
+
+## Amazon Bedrock AgentCore payments
+
+Use it as the `pre_sign_policy` of your payments integration config. It returns `True` only when every payee in the payment request gets `allow`. A decline, a review, a timeout or a request it cannot read returns `False`, so the payment is not signed. Reads x402 v1 bodies and the x402 v2 `Payment-Required` header.
+
+```python
+from oceanalt_aml import agentcore_pre_sign_policy
+# config = <your AgentCore payments integration config>(..., pre_sign_policy=agentcore_pre_sign_policy)
+```
+
+Free, no key, no dependencies. Docs: https://oceanalt.com/en/api-docs · Hosted MCP server: https://oceanalt.com/api/mcp

oceanalt_aml-0.1.0/oceanalt_aml.egg-info/SOURCES.txt

@@ -0,0 +1,7 @@
+README.md
+pyproject.toml
+oceanalt_aml/__init__.py
+oceanalt_aml.egg-info/PKG-INFO
+oceanalt_aml.egg-info/SOURCES.txt
+oceanalt_aml.egg-info/dependency_links.txt
+oceanalt_aml.egg-info/top_level.txt

oceanalt_aml-0.1.0/oceanalt_aml.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

oceanalt_aml-0.1.0/oceanalt_aml.egg-info/top_level.txt

@@ -0,0 +1 @@
+oceanalt_aml

oceanalt_aml-0.1.0/pyproject.toml

@@ -0,0 +1,17 @@
+[build-system]
+requires = ["setuptools>=61"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "oceanalt-aml"
+version = "0.1.0"
+description = "OceanAlt pre-payment check for AI agents: allow, review or decline before your agent pays. Includes an Amazon Bedrock AgentCore pre_sign_policy."
+readme = "README.md"
+license = { text = "MIT" }
+requires-python = ">=3.8"
+authors = [{ name = "OceanAlt", email = "business@oceanalt.com" }]
+keywords = ["oceanalt", "ai-agents", "agent-payments", "x402", "pre-payment", "mcp", "agentcore"]
+
+[project.urls]
+Homepage = "https://oceanalt.com"
+Documentation = "https://oceanalt.com/en/api-docs"

oceanalt_aml-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+