agentcheck-sdk 0.1.0__tar.gz

agentcheck_sdk-0.1.0/PKG-INFO

@@ -0,0 +1,80 @@
+Metadata-Version: 2.4
+Name: agentcheck-sdk
+Version: 0.1.0
+Summary: Record what your AI agent is allowed to do
+Author-email: AgentCheck <dev@agentcheck.io>
+License: MIT
+Project-URL: Homepage, https://agentcheck.io
+Project-URL: Repository, https://github.com/agentcheck/agentcheck-python
+Keywords: ai,agent,delegation,trust,authorization
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Security
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: httpx>=0.25
+Requires-Dist: pydantic>=2.0
+
+# agentcheck
+
+Record what your AI agent is allowed to do.
+
+## Install
+
+```bash
+pip install agentcheck
+```
+
+## Quickstart
+
+```python
+import agentcheck
+
+agentcheck.init(api_key="ak_live_...", base_url="https://agentcheck.fly.dev")
+
+proof = agentcheck.record(
+    agent="factory-bot",
+    scope="order parts under $10K, monitor equipment 24/7",
+    authorized_by="kim@factory.com"
+)
+
+# Kim gets an email, clicks "Approve"
+# Anyone can verify: /api/v1/verify/{proof.id}
+
+record = agentcheck.get(proof.id)
+print(record.status)  # "approved"
+```
+
+## API
+
+| Function | Description |
+|----------|-------------|
+| `agentcheck.init(api_key, base_url)` | Initialize with your API key |
+| `agentcheck.record(agent, scope, authorized_by)` | Create agreement |
+| `agentcheck.get(id)` | Get agreement details |
+| `agentcheck.list(status, agent)` | List agreements |
+| `agentcheck.amend(id, new_scope)` | Amend agreement scope |
+
+## Sign Up
+
+```python
+from agentcheck import Client
+
+result = Client.signup(
+    email="dev@company.com",
+    company_name="My Company",
+    base_url="https://agentcheck.fly.dev"
+)
+print(result["api_key"])  # Save this - shown once only
+```
+
+## License
+
+MIT

agentcheck_sdk-0.1.0/README.md

@@ -0,0 +1,56 @@
+# agentcheck
+
+Record what your AI agent is allowed to do.
+
+## Install
+
+```bash
+pip install agentcheck
+```
+
+## Quickstart
+
+```python
+import agentcheck
+
+agentcheck.init(api_key="ak_live_...", base_url="https://agentcheck.fly.dev")
+
+proof = agentcheck.record(
+    agent="factory-bot",
+    scope="order parts under $10K, monitor equipment 24/7",
+    authorized_by="kim@factory.com"
+)
+
+# Kim gets an email, clicks "Approve"
+# Anyone can verify: /api/v1/verify/{proof.id}
+
+record = agentcheck.get(proof.id)
+print(record.status)  # "approved"
+```
+
+## API
+
+| Function | Description |
+|----------|-------------|
+| `agentcheck.init(api_key, base_url)` | Initialize with your API key |
+| `agentcheck.record(agent, scope, authorized_by)` | Create agreement |
+| `agentcheck.get(id)` | Get agreement details |
+| `agentcheck.list(status, agent)` | List agreements |
+| `agentcheck.amend(id, new_scope)` | Amend agreement scope |
+
+## Sign Up
+
+```python
+from agentcheck import Client
+
+result = Client.signup(
+    email="dev@company.com",
+    company_name="My Company",
+    base_url="https://agentcheck.fly.dev"
+)
+print(result["api_key"])  # Save this - shown once only
+```
+
+## License
+
+MIT

agentcheck_sdk-0.1.0/agentcheck/__init__.py

@@ -0,0 +1,95 @@
+"""AgentCheck - Record what your AI agent is allowed to do."""
+
+from __future__ import annotations
+
+from .client import Client
+from .exceptions import (
+    AgentCheckError,
+    AuthenticationError,
+    NotFoundError,
+    ServerError,
+    ValidationError,
+)
+from .models import Agreement, AgreementList
+
+__version__ = "0.1.0"
+__all__ = [
+    "Client",
+    "Agreement",
+    "AgreementList",
+    "AgentCheckError",
+    "AuthenticationError",
+    "NotFoundError",
+    "ValidationError",
+    "ServerError",
+    "init",
+    "record",
+    "get",
+    "list",
+    "amend",
+]
+
+# -- Module-level convenience API --
+# Enables: agentcheck.record(agent, scope, authorized_by)
+
+_client: Client | None = None
+
+
+def init(api_key: str, base_url: str = "https://api.agentcheck.io"):
+    """Initialize the global client."""
+    global _client
+    _client = Client(api_key=api_key, base_url=base_url)
+
+
+def _get_client() -> Client:
+    if _client is None:
+        raise AgentCheckError(
+            "Call agentcheck.init(api_key='...') first",
+            code="not_initialized",
+        )
+    return _client
+
+
+def record(
+    agent: str,
+    scope: str,
+    authorized_by: str,
+    **kwargs,
+) -> Agreement:
+    """Create a new agreement. One line is all you need."""
+    return _get_client().record(
+        agent=agent,
+        scope=scope,
+        authorized_by=authorized_by,
+        **kwargs,
+    )
+
+
+def get(agreement_id: str) -> Agreement:
+    """Get agreement details."""
+    return _get_client().get(agreement_id)
+
+
+def list(
+    status: str | None = None,
+    agent: str | None = None,
+    limit: int = 50,
+    offset: int = 0,
+) -> AgreementList:
+    """List agreements."""
+    return _get_client().list(status=status, agent=agent, limit=limit, offset=offset)
+
+
+def amend(
+    agreement_id: str,
+    new_scope: str,
+    reason: str | None = None,
+    require_reauth: bool = True,
+) -> Agreement:
+    """Amend an agreement's scope."""
+    return _get_client().amend(
+        agreement_id=agreement_id,
+        new_scope=new_scope,
+        reason=reason,
+        require_reauth=require_reauth,
+    )

agentcheck_sdk-0.1.0/agentcheck/client.py

@@ -0,0 +1,157 @@
+from __future__ import annotations
+
+import httpx
+
+from .exceptions import (
+    AgentCheckError,
+    AuthenticationError,
+    NotFoundError,
+    ServerError,
+    ValidationError,
+)
+from .models import Agreement, AgreementList
+
+_DEFAULT_BASE_URL = "https://api.agentcheck.io"
+
+
+class Client:
+    """AgentCheck API client."""
+
+    def __init__(
+        self,
+        api_key: str,
+        base_url: str = _DEFAULT_BASE_URL,
+        timeout: float = 30.0,
+    ):
+        self._api_key = api_key
+        self._base_url = base_url.rstrip("/")
+        self._http = httpx.Client(
+            base_url=self._base_url,
+            headers={"X-API-Key": api_key},
+            timeout=timeout,
+        )
+
+    def _handle_response(self, resp: httpx.Response) -> dict:
+        if resp.status_code == 401:
+            raise AuthenticationError("Invalid API key", code="unauthorized")
+        if resp.status_code == 404:
+            raise NotFoundError("Resource not found", code="not_found")
+        if resp.status_code == 400:
+            data = resp.json()
+            msg = data.get("error", {}).get("message", "Bad request")
+            raise ValidationError(msg, code="bad_request")
+        if resp.status_code >= 500:
+            raise ServerError("Server error", code="server_error")
+        if not resp.is_success:
+            raise AgentCheckError(f"HTTP {resp.status_code}")
+        return resp.json()
+
+    def record(
+        self,
+        agent: str,
+        scope: str,
+        authorized_by: str,
+        agent_provider: str | None = None,
+        expires_in_days: int | None = None,
+        metadata: dict | None = None,
+    ) -> Agreement:
+        """Create a new agreement and send approval email."""
+        body: dict = {
+            "agent": agent,
+            "scope": scope,
+            "authorized_by": authorized_by,
+        }
+        if agent_provider is not None:
+            body["agent_provider"] = agent_provider
+        if expires_in_days is not None:
+            body["expires_in_days"] = expires_in_days
+        if metadata is not None:
+            body["metadata"] = metadata
+
+        resp = self._http.post("/api/v1/record", json=body)
+        data = self._handle_response(resp)
+        return Agreement.model_validate(data["data"])
+
+    def get(self, agreement_id: str) -> Agreement:
+        """Get agreement details by ID."""
+        resp = self._http.get(f"/api/v1/record/{agreement_id}")
+        data = self._handle_response(resp)
+        return Agreement.model_validate(data["data"])
+
+    def list(
+        self,
+        status: str | None = None,
+        agent: str | None = None,
+        limit: int = 50,
+        offset: int = 0,
+    ) -> AgreementList:
+        """List agreements with optional filters."""
+        params: dict = {"limit": limit, "offset": offset}
+        if status is not None:
+            params["status"] = status
+        if agent is not None:
+            params["agent"] = agent
+
+        resp = self._http.get("/api/v1/records", params=params)
+        data = self._handle_response(resp)
+        return AgreementList.model_validate(data["data"])
+
+    def amend(
+        self,
+        agreement_id: str,
+        new_scope: str,
+        reason: str | None = None,
+        require_reauth: bool = True,
+    ) -> Agreement:
+        """Amend an agreement's scope. Creates a new version."""
+        body: dict = {
+            "new_scope": new_scope,
+            "require_reauth": require_reauth,
+        }
+        if reason is not None:
+            body["reason"] = reason
+
+        resp = self._http.post(f"/api/v1/record/{agreement_id}/amend", json=body)
+        data = self._handle_response(resp)
+        return Agreement.model_validate(data["data"])
+
+    def register_webhook(
+        self,
+        url: str,
+        events: list[str],
+    ) -> dict:
+        """Register a webhook endpoint."""
+        resp = self._http.post(
+            "/api/v1/webhooks",
+            json={"url": url, "events": events},
+        )
+        data = self._handle_response(resp)
+        return data["data"]
+
+    @staticmethod
+    def signup(
+        email: str,
+        company_name: str | None = None,
+        base_url: str = _DEFAULT_BASE_URL,
+    ) -> dict:
+        """Self-service signup. Returns API key (shown once)."""
+        body: dict = {"email": email}
+        if company_name is not None:
+            body["company_name"] = company_name
+        resp = httpx.post(f"{base_url}/api/v1/signup", json=body)
+        if resp.status_code == 429:
+            raise AgentCheckError("Rate limited", code="rate_limited")
+        if not resp.is_success:
+            data = resp.json()
+            msg = data.get("error", {}).get("message", "Signup failed")
+            raise AgentCheckError(msg)
+        return resp.json()["data"]
+
+    def close(self):
+        self._http.close()
+
+    def __enter__(self):
+        return self
+
+    def __exit__(self, *args):
+        self.close()

agentcheck_sdk-0.1.0/agentcheck/exceptions.py

@@ -0,0 +1,23 @@
+class AgentCheckError(Exception):
+    """Base exception for AgentCheck SDK."""
+
+    def __init__(self, message: str, code: str | None = None):
+        self.message = message
+        self.code = code
+        super().__init__(message)
+
+
+class AuthenticationError(AgentCheckError):
+    """Invalid or missing API key."""
+
+
+class NotFoundError(AgentCheckError):
+    """Resource not found."""
+
+
+class ValidationError(AgentCheckError):
+    """Invalid request parameters."""
+
+
+class ServerError(AgentCheckError):
+    """Server-side error."""

agentcheck_sdk-0.1.0/agentcheck/models.py

@@ -0,0 +1,26 @@
+from __future__ import annotations
+
+from datetime import datetime
+
+from pydantic import BaseModel
+
+
+class Agreement(BaseModel):
+    id: str
+    status: str
+    agent: str
+    agent_provider: str | None = None
+    scope: str
+    authorized_by: str
+    created_at: datetime
+    approved_at: datetime | None = None
+    expires_at: datetime | None = None
+    verify_url: str
+    signature: str | None = None
+    sig_algorithm: str = "HMAC-SHA256"
+
+
+class AgreementList(BaseModel):
+    records: list[Agreement]
+    limit: int
+    offset: int

agentcheck_sdk-0.1.0/agentcheck/webhook/__init__.py

@@ -0,0 +1,3 @@
+from .handler import WebhookHandler, WebhookEvent
+
+__all__ = ["WebhookHandler", "WebhookEvent"]

agentcheck_sdk-0.1.0/agentcheck/webhook/handler.py

@@ -0,0 +1,59 @@
+from __future__ import annotations
+
+import hashlib
+import hmac
+import json
+from dataclasses import dataclass
+from datetime import datetime
+
+from ..exceptions import AgentCheckError
+
+
+@dataclass
+class WebhookEvent:
+    id: str
+    type: str
+    created_at: str
+    data: dict
+
+
+class WebhookHandler:
+    """Verify and parse incoming webhook events."""
+
+    def __init__(self, secret: str):
+        self._secret = secret
+
+    def verify_and_parse(self, body: str | bytes, signature: str) -> WebhookEvent:
+        """Verify HMAC signature and parse webhook payload.
+
+        Args:
+            body: Raw request body (str or bytes).
+            signature: Value from X-AgentCheck-Signature header.
+
+        Returns:
+            Parsed WebhookEvent.
+
+        Raises:
+            AgentCheckError: If signature is invalid.
+        """
+        if isinstance(body, str):
+            body_bytes = body.encode("utf-8")
+        else:
+            body_bytes = body
+
+        expected = hmac.new(
+            self._secret.encode("utf-8"),
+            body_bytes,
+            hashlib.sha256,
+        ).hexdigest()
+
+        if not hmac.compare_digest(expected, signature):
+            raise AgentCheckError("Invalid webhook signature", code="invalid_signature")
+
+        payload = json.loads(body_bytes)
+        return WebhookEvent(
+            id=payload["id"],
+            type=payload["type"],
+            created_at=payload["created_at"],
+            data=payload.get("data", {}),
+        )

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

@@ -0,0 +1,80 @@
+Metadata-Version: 2.4
+Name: agentcheck-sdk
+Version: 0.1.0
+Summary: Record what your AI agent is allowed to do
+Author-email: AgentCheck <dev@agentcheck.io>
+License: MIT
+Project-URL: Homepage, https://agentcheck.io
+Project-URL: Repository, https://github.com/agentcheck/agentcheck-python
+Keywords: ai,agent,delegation,trust,authorization
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Security
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: httpx>=0.25
+Requires-Dist: pydantic>=2.0
+
+# agentcheck
+
+Record what your AI agent is allowed to do.
+
+## Install
+
+```bash
+pip install agentcheck
+```
+
+## Quickstart
+
+```python
+import agentcheck
+
+agentcheck.init(api_key="ak_live_...", base_url="https://agentcheck.fly.dev")
+
+proof = agentcheck.record(
+    agent="factory-bot",
+    scope="order parts under $10K, monitor equipment 24/7",
+    authorized_by="kim@factory.com"
+)
+
+# Kim gets an email, clicks "Approve"
+# Anyone can verify: /api/v1/verify/{proof.id}
+
+record = agentcheck.get(proof.id)
+print(record.status)  # "approved"
+```
+
+## API
+
+| Function | Description |
+|----------|-------------|
+| `agentcheck.init(api_key, base_url)` | Initialize with your API key |
+| `agentcheck.record(agent, scope, authorized_by)` | Create agreement |
+| `agentcheck.get(id)` | Get agreement details |
+| `agentcheck.list(status, agent)` | List agreements |
+| `agentcheck.amend(id, new_scope)` | Amend agreement scope |
+
+## Sign Up
+
+```python
+from agentcheck import Client
+
+result = Client.signup(
+    email="dev@company.com",
+    company_name="My Company",
+    base_url="https://agentcheck.fly.dev"
+)
+print(result["api_key"])  # Save this - shown once only
+```
+
+## License
+
+MIT

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

@@ -0,0 +1,13 @@
+README.md
+pyproject.toml
+agentcheck/__init__.py
+agentcheck/client.py
+agentcheck/exceptions.py
+agentcheck/models.py
+agentcheck/webhook/__init__.py
+agentcheck/webhook/handler.py
+agentcheck_sdk.egg-info/PKG-INFO
+agentcheck_sdk.egg-info/SOURCES.txt
+agentcheck_sdk.egg-info/dependency_links.txt
+agentcheck_sdk.egg-info/requires.txt
+agentcheck_sdk.egg-info/top_level.txt

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

@@ -0,0 +1 @@
+

agentcheck_sdk-0.1.0/agentcheck_sdk.egg-info/requires.txt

@@ -0,0 +1,2 @@
+httpx>=0.25
+pydantic>=2.0

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

@@ -0,0 +1 @@
+agentcheck

agentcheck_sdk-0.1.0/pyproject.toml

@@ -0,0 +1,36 @@
+[build-system]
+requires = ["setuptools>=68.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "agentcheck-sdk"
+version = "0.1.0"
+description = "Record what your AI agent is allowed to do"
+readme = "README.md"
+license = {text = "MIT"}
+requires-python = ">=3.9"
+authors = [{name = "AgentCheck", email = "dev@agentcheck.io"}]
+keywords = ["ai", "agent", "delegation", "trust", "authorization"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Security",
+]
+dependencies = [
+    "httpx>=0.25",
+    "pydantic>=2.0",
+]
+
+[project.urls]
+Homepage = "https://agentcheck.io"
+Repository = "https://github.com/agentcheck/agentcheck-python"
+
+[tool.setuptools.packages.find]
+include = ["agentcheck*"]

agentcheck_sdk-0.1.0/setup.cfg

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