mailagent-agent 0.1.0__tar.gz

mailagent_agent-0.1.0/PKG-INFO

@@ -0,0 +1,42 @@
+Metadata-Version: 2.4
+Name: mailagent-agent
+Version: 0.1.0
+Summary: Python SDK for MailAgent agent verify API
+Author: MailAgent
+License: MIT
+Project-URL: Homepage, https://webmailagent.com/docs/agents.html
+Project-URL: Repository, https://github.com/Alex0nder/MailAgent
+Keywords: mailagent,agents,email,verification,otp
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+
+# mailagent-agent (Python)
+
+Minimal Python SDK for [MailAgent](https://webmailagent.com) agent verify flows — parity with `@mailagent/agent` core methods.
+
+```bash
+pip install mailagent-agent
+```
+
+```python
+from mailagent import MailAgent
+
+client = MailAgent("https://api.webmailagent.com", "ma_…")
+result = client.verify_signup(service="github", timeout_seconds=90, delete_after=True)
+print(result.get("agent", {}).get("primaryAction"))
+```
+
+## Methods
+
+- `verify_signup(**options)` — `POST /v1/agent/verify`
+- `get_profile()` — `GET /v1/me`
+- `create_inbox(**options)` / `delete_inbox(id)`
+- `list_messages(inbox_id, subject_contains=…)`
+- `simulate_message(inbox_id, scenario="otp", …)`
+- `diagnose_inbox(inbox_id, …)`
+- `list_runs(run_id=…, label=…)`
+
+Source: `packages/mailagent-agent-py` in [MailAgent](https://github.com/Alex0nder/MailAgent).

mailagent_agent-0.1.0/README.md

@@ -0,0 +1,27 @@
+# mailagent-agent (Python)
+
+Minimal Python SDK for [MailAgent](https://webmailagent.com) agent verify flows — parity with `@mailagent/agent` core methods.
+
+```bash
+pip install mailagent-agent
+```
+
+```python
+from mailagent import MailAgent
+
+client = MailAgent("https://api.webmailagent.com", "ma_…")
+result = client.verify_signup(service="github", timeout_seconds=90, delete_after=True)
+print(result.get("agent", {}).get("primaryAction"))
+```
+
+## Methods
+
+- `verify_signup(**options)` — `POST /v1/agent/verify`
+- `get_profile()` — `GET /v1/me`
+- `create_inbox(**options)` / `delete_inbox(id)`
+- `list_messages(inbox_id, subject_contains=…)`
+- `simulate_message(inbox_id, scenario="otp", …)`
+- `diagnose_inbox(inbox_id, …)`
+- `list_runs(run_id=…, label=…)`
+
+Source: `packages/mailagent-agent-py` in [MailAgent](https://github.com/Alex0nder/MailAgent).

mailagent_agent-0.1.0/mailagent/__init__.py

@@ -0,0 +1,5 @@
+"""MailAgent Python SDK — verify signup, inboxes, diagnose."""
+
+from mailagent.client import MailAgent
+
+__all__ = ["MailAgent"]

mailagent_agent-0.1.0/mailagent/client.py

@@ -0,0 +1,120 @@
+"""HTTP client for MailAgent REST API (parity with @mailagent/agent core flows)."""
+
+from __future__ import annotations
+
+import json
+import urllib.error
+import urllib.parse
+import urllib.request
+from typing import Any, Mapping, MutableMapping, Optional
+
+
+class MailAgentError(RuntimeError):
+    def __init__(self, status: int, body: Any):
+        super().__init__(f"MailAgent {status}: {json.dumps(body)}")
+        self.status = status
+        self.body = body
+
+
+class MailAgent:
+    def __init__(self, base_url: str, api_key: str):
+        self.base = base_url.rstrip("/")
+        self.api_key = api_key
+
+    def _request(
+        self,
+        method: str,
+        path: str,
+        body: Optional[Mapping[str, Any]] = None,
+        *,
+        accept: str = "application/json",
+    ) -> Any:
+        data = None
+        headers = {
+            "Authorization": f"Bearer {self.api_key}",
+            "Accept": accept,
+        }
+        if body is not None:
+            data = json.dumps(body).encode("utf-8")
+            headers["Content-Type"] = "application/json"
+
+        req = urllib.request.Request(
+            f"{self.base}{path}",
+            data=data,
+            headers=headers,
+            method=method,
+        )
+        try:
+            with urllib.request.urlopen(req, timeout=120) as res:
+                text = res.read().decode("utf-8")
+                return json.loads(text) if text else {}
+        except urllib.error.HTTPError as e:
+            raw = e.read().decode("utf-8")
+            try:
+                parsed = json.loads(raw) if raw else {}
+            except json.JSONDecodeError:
+                parsed = {"raw": raw}
+            raise MailAgentError(e.code, parsed) from e
+
+    def verify_signup(self, **options: Any) -> MutableMapping[str, Any]:
+        """POST /v1/agent/verify"""
+        return self._request("POST", "/v1/agent/verify", options)
+
+    def get_profile(self) -> MutableMapping[str, Any]:
+        """GET /v1/me"""
+        return self._request("GET", "/v1/me")
+
+    def get_agent_hub(self) -> MutableMapping[str, Any]:
+        """GET /v1/agent"""
+        return self._request("GET", "/v1/agent")
+
+    def create_inbox(self, **options: Any) -> MutableMapping[str, Any]:
+        """POST /v1/inboxes"""
+        return self._request("POST", "/v1/inboxes", options)
+
+    def delete_inbox(self, inbox_id: str) -> MutableMapping[str, Any]:
+        """DELETE /v1/inboxes/:id"""
+        return self._request("DELETE", f"/v1/inboxes/{inbox_id}")
+
+    def list_messages(
+        self, inbox_id: str, *, subject_contains: Optional[str] = None
+    ) -> MutableMapping[str, Any]:
+        q = ""
+        if subject_contains:
+            q = f"?subjectContains={urllib.parse.quote(subject_contains)}"
+        return self._request("GET", f"/v1/inboxes/{inbox_id}/messages{q}")
+
+    def simulate_message(
+        self, inbox_id: str, **options: Any
+    ) -> MutableMapping[str, Any]:
+        """POST /v1/inboxes/:id/simulate"""
+        return self._request(
+            "POST", f"/v1/inboxes/{inbox_id}/simulate", options
+        )
+
+    def diagnose_inbox(
+        self,
+        inbox_id: str,
+        *,
+        subject_contains: Optional[str] = None,
+        message_index: Optional[int] = None,
+    ) -> MutableMapping[str, Any]:
+        params: list[str] = []
+        if subject_contains:
+            params.append(
+                "subjectContains=" + urllib.parse.quote(subject_contains)
+            )
+        if message_index is not None:
+            params.append(f"messageIndex={message_index}")
+        q = f"?{'&'.join(params)}" if params else ""
+        return self._request("GET", f"/v1/inboxes/{inbox_id}/diagnose{q}")
+
+    def list_runs(
+        self, *, run_id: Optional[str] = None, label: Optional[str] = None, limit: int = 30
+    ) -> MutableMapping[str, Any]:
+        params: list[str] = [f"limit={limit}"]
+        if run_id:
+            params.append(f"runId={urllib.parse.quote(run_id)}")
+        if label:
+            params.append(f"label={urllib.parse.quote(label)}")
+        return self._request("GET", f"/v1/agent/runs?{'&'.join(params)}")

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

@@ -0,0 +1,42 @@
+Metadata-Version: 2.4
+Name: mailagent-agent
+Version: 0.1.0
+Summary: Python SDK for MailAgent agent verify API
+Author: MailAgent
+License: MIT
+Project-URL: Homepage, https://webmailagent.com/docs/agents.html
+Project-URL: Repository, https://github.com/Alex0nder/MailAgent
+Keywords: mailagent,agents,email,verification,otp
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+
+# mailagent-agent (Python)
+
+Minimal Python SDK for [MailAgent](https://webmailagent.com) agent verify flows — parity with `@mailagent/agent` core methods.
+
+```bash
+pip install mailagent-agent
+```
+
+```python
+from mailagent import MailAgent
+
+client = MailAgent("https://api.webmailagent.com", "ma_…")
+result = client.verify_signup(service="github", timeout_seconds=90, delete_after=True)
+print(result.get("agent", {}).get("primaryAction"))
+```
+
+## Methods
+
+- `verify_signup(**options)` — `POST /v1/agent/verify`
+- `get_profile()` — `GET /v1/me`
+- `create_inbox(**options)` / `delete_inbox(id)`
+- `list_messages(inbox_id, subject_contains=…)`
+- `simulate_message(inbox_id, scenario="otp", …)`
+- `diagnose_inbox(inbox_id, …)`
+- `list_runs(run_id=…, label=…)`
+
+Source: `packages/mailagent-agent-py` in [MailAgent](https://github.com/Alex0nder/MailAgent).

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

@@ -0,0 +1,8 @@
+README.md
+pyproject.toml
+mailagent/__init__.py
+mailagent/client.py
+mailagent_agent.egg-info/PKG-INFO
+mailagent_agent.egg-info/SOURCES.txt
+mailagent_agent.egg-info/dependency_links.txt
+mailagent_agent.egg-info/top_level.txt

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

@@ -0,0 +1 @@
+

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

@@ -0,0 +1 @@
+mailagent

mailagent_agent-0.1.0/pyproject.toml

@@ -0,0 +1,26 @@
+[build-system]
+requires = ["setuptools>=61"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "mailagent-agent"
+version = "0.1.0"
+description = "Python SDK for MailAgent agent verify API"
+readme = "README.md"
+requires-python = ">=3.9"
+license = { text = "MIT" }
+keywords = ["mailagent", "agents", "email", "verification", "otp"]
+authors = [{ name = "MailAgent" }]
+classifiers = [
+  "Programming Language :: Python :: 3",
+  "License :: OSI Approved :: MIT License",
+  "Operating System :: OS Independent",
+]
+
+[project.urls]
+Homepage = "https://webmailagent.com/docs/agents.html"
+Repository = "https://github.com/Alex0nder/MailAgent"
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["mailagent*"]

mailagent_agent-0.1.0/setup.cfg

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