trustprotocol 1.0.0__tar.gz

trustprotocol-1.0.0/PKG-INFO

@@ -0,0 +1,130 @@
+Metadata-Version: 2.4
+Name: trustprotocol
+Version: 1.0.0
+Summary: Python SDK for TrustProtocol — AI agent governance and audit trail
+Home-page: https://trustprotocol.tech
+Author: TrustProtocol
+Author-email: contact@trustprotocol.tech
+Project-URL: Documentation, https://trustprotocol.tech/docs
+Project-URL: Source, https://github.com/chada-hash/trustprotocol-python
+Keywords: ai,governance,audit,agents,eu-ai-act,compliance
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+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: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: requests>=2.28.0
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: project-url
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# TrustProtocol Python SDK
+
+Governance and cryptographic audit trail for AI agents.
+
+## Installation
+
+```bash
+pip install trustprotocol
+```
+
+## Quick Start
+
+```python
+from trustprotocol import TrustProtocol
+
+tp = TrustProtocol("your-api-key")
+
+result = tp.intercept(
+    agent_id="finance-agent-01",
+    action="Transfer 5000 EUR to supplier ACME",
+    cost_eur=5000.0,
+    user_id="marie@yourcompany.com"
+)
+
+if result.authorized:
+    print(f"✓ Authorized — Risk score: {result.risk_score}/100")
+    # Execute the action
+else:
+    print(f"✗ Blocked — {result.block_reason}")
+```
+
+## Raise on block
+
+```python
+from trustprotocol import TrustProtocol, TrustProtocolError
+
+tp = TrustProtocol("your-api-key")
+
+try:
+    result = tp.intercept(
+        agent_id="finance-agent-01",
+        action="Transfer 150000 EUR to new beneficiary",
+        cost_eur=150000.0,
+        user_id="marie@yourcompany.com",
+        raise_on_block=True
+    )
+    # Execute action
+except TrustProtocolError as e:
+    print(f"Blocked: {e.block_reason}")
+    print(f"Risk score: {e.risk_score}/100")
+    print(f"Reasons: {e.reasons}")
+```
+
+## With LangChain
+
+```python
+from trustprotocol import TrustProtocol
+from langchain.tools import tool
+
+tp = TrustProtocol("your-api-key")
+
+@tool
+def governed_payment(amount: float, recipient: str, user_id: str) -> str:
+    """Execute a payment with TrustProtocol governance."""
+    result = tp.intercept(
+        agent_id="payment-agent",
+        action=f"Transfer {amount} EUR to {recipient}",
+        cost_eur=amount,
+        user_id=user_id,
+        raise_on_block=True
+    )
+    return f"Payment authorized. Attestation: {result.attestation_id}"
+```
+
+## Audit & Verification
+
+```python
+# Get audit ledger
+ledger = tp.ledger(agent_id="finance-agent-01")
+print(f"Total actions: {ledger['total']}")
+
+# Verify chain integrity
+verification = tp.verify_chain()
+print(f"Chain valid: {verification['chain_valid']}")
+
+# Pending approvals
+approvals = tp.approvals()
+print(f"Pending: {len(approvals.get('approvals', []))}")
+```
+
+## Links
+
+- [Dashboard](https://trustprotocol.tech/dashboard)
+- [Documentation](https://trustprotocol.tech/docs)
+- [Trust Center](https://trustprotocol.tech/trust)

trustprotocol-1.0.0/README.md

@@ -0,0 +1,95 @@
+# TrustProtocol Python SDK
+
+Governance and cryptographic audit trail for AI agents.
+
+## Installation
+
+```bash
+pip install trustprotocol
+```
+
+## Quick Start
+
+```python
+from trustprotocol import TrustProtocol
+
+tp = TrustProtocol("your-api-key")
+
+result = tp.intercept(
+    agent_id="finance-agent-01",
+    action="Transfer 5000 EUR to supplier ACME",
+    cost_eur=5000.0,
+    user_id="marie@yourcompany.com"
+)
+
+if result.authorized:
+    print(f"✓ Authorized — Risk score: {result.risk_score}/100")
+    # Execute the action
+else:
+    print(f"✗ Blocked — {result.block_reason}")
+```
+
+## Raise on block
+
+```python
+from trustprotocol import TrustProtocol, TrustProtocolError
+
+tp = TrustProtocol("your-api-key")
+
+try:
+    result = tp.intercept(
+        agent_id="finance-agent-01",
+        action="Transfer 150000 EUR to new beneficiary",
+        cost_eur=150000.0,
+        user_id="marie@yourcompany.com",
+        raise_on_block=True
+    )
+    # Execute action
+except TrustProtocolError as e:
+    print(f"Blocked: {e.block_reason}")
+    print(f"Risk score: {e.risk_score}/100")
+    print(f"Reasons: {e.reasons}")
+```
+
+## With LangChain
+
+```python
+from trustprotocol import TrustProtocol
+from langchain.tools import tool
+
+tp = TrustProtocol("your-api-key")
+
+@tool
+def governed_payment(amount: float, recipient: str, user_id: str) -> str:
+    """Execute a payment with TrustProtocol governance."""
+    result = tp.intercept(
+        agent_id="payment-agent",
+        action=f"Transfer {amount} EUR to {recipient}",
+        cost_eur=amount,
+        user_id=user_id,
+        raise_on_block=True
+    )
+    return f"Payment authorized. Attestation: {result.attestation_id}"
+```
+
+## Audit & Verification
+
+```python
+# Get audit ledger
+ledger = tp.ledger(agent_id="finance-agent-01")
+print(f"Total actions: {ledger['total']}")
+
+# Verify chain integrity
+verification = tp.verify_chain()
+print(f"Chain valid: {verification['chain_valid']}")
+
+# Pending approvals
+approvals = tp.approvals()
+print(f"Pending: {len(approvals.get('approvals', []))}")
+```
+
+## Links
+
+- [Dashboard](https://trustprotocol.tech/dashboard)
+- [Documentation](https://trustprotocol.tech/docs)
+- [Trust Center](https://trustprotocol.tech/trust)

trustprotocol-1.0.0/setup.cfg

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

trustprotocol-1.0.0/setup.py

@@ -0,0 +1,32 @@
+from setuptools import setup, find_packages
+
+setup(
+    name="trustprotocol",
+    version="1.0.0",
+    description="Python SDK for TrustProtocol — AI agent governance and audit trail",
+    long_description=open("README.md").read(),
+    long_description_content_type="text/markdown",
+    author="TrustProtocol",
+    author_email="contact@trustprotocol.tech",
+    url="https://trustprotocol.tech",
+    project_urls={
+        "Documentation": "https://trustprotocol.tech/docs",
+        "Source": "https://github.com/chada-hash/trustprotocol-python",
+    },
+    packages=find_packages(),
+    python_requires=">=3.8",
+    install_requires=["requests>=2.28.0"],
+    keywords=["ai", "governance", "audit", "agents", "eu-ai-act", "compliance"],
+    classifiers=[
+        "Development Status :: 4 - Beta",
+        "Intended Audience :: Developers",
+        "License :: OSI Approved :: MIT License",
+        "Programming Language :: Python :: 3",
+        "Programming Language :: Python :: 3.8",
+        "Programming Language :: Python :: 3.9",
+        "Programming Language :: Python :: 3.10",
+        "Programming Language :: Python :: 3.11",
+        "Programming Language :: Python :: 3.12",
+        "Topic :: Software Development :: Libraries :: Python Modules",
+    ],
+)

trustprotocol-1.0.0/trustprotocol/__init__.py

@@ -0,0 +1,3 @@
+from .client import TrustProtocol
+__all__ = ["TrustProtocol"]
+__version__ = "1.0.0"

trustprotocol-1.0.0/trustprotocol/client.py

@@ -0,0 +1,217 @@
+"""
+TrustProtocol Python SDK
+Governance and cryptographic audit trail for AI agents.
+https://trustprotocol.tech
+"""
+
+import requests
+from typing import Optional, List
+
+
+class TrustProtocolError(Exception):
+    """Raised when an action is blocked by TrustProtocol."""
+    def __init__(self, message: str, block_reason: str = "", risk_score: int = 0, reasons: List[str] = []):
+        super().__init__(message)
+        self.block_reason = block_reason
+        self.risk_score = risk_score
+        self.reasons = reasons
+
+
+class AttestationResult:
+    """Result returned by TrustProtocol after intercepting an action."""
+    def __init__(self, data: dict):
+        self.attestation_id: str = data.get("attestation_id", "")
+        self.blocked: bool = data.get("blocked", False)
+        self.decision: str = data.get("decision", "authorized")
+        self.block_reason: str = data.get("block_reason", "")
+        self.risk_score: int = data.get("risk_score", 0)
+        self.risk_level: str = data.get("risk_level", "low")
+        self.risk_reasons: List[str] = data.get("risk_reasons", [])
+        self.hash_sha256: str = data.get("hash_sha256", "")
+        self.signature: str = data.get("signature", "")
+        self.timestamp: str = data.get("timestamp", "")
+        self.chain_height: int = data.get("chain_height", 0)
+        self.retained_until: str = data.get("retained_until", "")
+        self._raw = data
+
+    @property
+    def authorized(self) -> bool:
+        return not self.blocked
+
+    @property
+    def approval_required(self) -> bool:
+        return self.decision == "approval_required"
+
+    def __repr__(self):
+        return (f"AttestationResult(decision={self.decision!r}, "
+                f"risk_score={self.risk_score}, "
+                f"attestation_id={self.attestation_id!r})")
+
+
+class TrustProtocol:
+    """
+    TrustProtocol client.
+
+    Usage:
+        from trustprotocol import TrustProtocol
+
+        tp = TrustProtocol("your-api-key")
+
+        # Intercept an AI agent action before execution
+        result = tp.intercept(
+            agent_id="finance-agent-01",
+            action="Transfer 5000 EUR to supplier ACME",
+            cost_eur=5000.0,
+            user_id="marie@yourcompany.com"
+        )
+
+        if result.authorized:
+            # Execute the action
+            pass
+    """
+
+    BASE_URL = "https://api.trustprotocol.tech"
+
+    def __init__(self, api_key: str, base_url: Optional[str] = None, timeout: int = 10):
+        """
+        Initialize the TrustProtocol client.
+
+        Args:
+            api_key: Your TrustProtocol API key (tp-...)
+            base_url: Custom API URL (optional, defaults to production)
+            timeout: Request timeout in seconds (default: 10)
+        """
+        if not api_key:
+            raise ValueError("TrustProtocol: api_key is required.")
+        self.api_key = api_key
+        self.base_url = (base_url or self.BASE_URL).rstrip("/")
+        self.timeout = timeout
+        self._session = requests.Session()
+        self._session.headers.update({
+            "x-api-key": self.api_key,
+            "Content-Type": "application/json",
+            "User-Agent": "trustprotocol-python/1.0.0"
+        })
+
+    def intercept(
+        self,
+        agent_id: str,
+        action: str,
+        cost_eur: float = 0.0,
+        user_id: str = "",
+        model_id: Optional[str] = None,
+        session_id: Optional[str] = None,
+        budget_limit: Optional[float] = None,
+        raise_on_block: bool = False,
+    ) -> AttestationResult:
+        """
+        Intercept an AI agent action before execution.
+
+        Args:
+            agent_id:     Identifier of the AI agent
+            action:       Description of what the agent wants to do
+            cost_eur:     Estimated cost in euros (default: 0)
+            user_id:      Human user responsible for this action (required for Art.12)
+            model_id:     AI model used (e.g. "gpt-4o", "claude-sonnet-4-6")
+            session_id:   Optional session or workflow identifier
+            budget_limit: Budget limit in euros for this agent
+            raise_on_block: If True, raises TrustProtocolError when blocked
+
+        Returns:
+            AttestationResult with decision, risk score, and cryptographic proof
+
+        Raises:
+            TrustProtocolError: If raise_on_block=True and action is blocked
+            requests.HTTPError: If the API returns an error
+        """
+        payload = {
+            "agent_id": agent_id,
+            "action": action,
+            "cost_eur": cost_eur,
+            "user_id": user_id,
+        }
+        if model_id:
+            payload["model_id"] = model_id
+        if session_id:
+            payload["session_id"] = session_id
+        if budget_limit is not None:
+            payload["budget_limit"] = budget_limit
+
+        response = self._session.post(
+            f"{self.base_url}/intercept",
+            json=payload,
+            timeout=self.timeout
+        )
+        response.raise_for_status()
+        result = AttestationResult(response.json())
+
+        if raise_on_block and result.blocked:
+            raise TrustProtocolError(
+                f"Action blocked: {result.block_reason}",
+                block_reason=result.block_reason,
+                risk_score=result.risk_score,
+                reasons=result.risk_reasons
+            )
+
+        return result
+
+    def ledger(self, agent_id: Optional[str] = None) -> dict:
+        """
+        Retrieve the audit ledger for your account.
+
+        Args:
+            agent_id: Filter by specific agent (optional)
+
+        Returns:
+            dict with 'entries' list and 'total' count
+        """
+        params = {}
+        if agent_id:
+            params["agent_id"] = agent_id
+        response = self._session.get(
+            f"{self.base_url}/ledger",
+            params=params,
+            timeout=self.timeout
+        )
+        response.raise_for_status()
+        return response.json()
+
+    def verify_chain(self) -> dict:
+        """
+        Verify the integrity of your attestation chain.
+
+        Returns:
+            dict with 'chain_valid' bool and 'chain_length' int
+        """
+        response = self._session.get(
+            f"{self.base_url}/verify-chain",
+            timeout=self.timeout
+        )
+        response.raise_for_status()
+        return response.json()
+
+    def approvals(self) -> dict:
+        """
+        List actions pending human approval.
+
+        Returns:
+            dict with 'approvals' list
+        """
+        response = self._session.get(
+            f"{self.base_url}/approvals",
+            timeout=self.timeout
+        )
+        response.raise_for_status()
+        return response.json()
+
+    def health(self) -> dict:
+        """Check API status."""
+        response = self._session.get(
+            f"{self.base_url}/health",
+            timeout=self.timeout
+        )
+        response.raise_for_status()
+        return response.json()
+
+    def __repr__(self):
+        return f"TrustProtocol(base_url={self.base_url!r})"

trustprotocol-1.0.0/trustprotocol.egg-info/PKG-INFO

@@ -0,0 +1,130 @@
+Metadata-Version: 2.4
+Name: trustprotocol
+Version: 1.0.0
+Summary: Python SDK for TrustProtocol — AI agent governance and audit trail
+Home-page: https://trustprotocol.tech
+Author: TrustProtocol
+Author-email: contact@trustprotocol.tech
+Project-URL: Documentation, https://trustprotocol.tech/docs
+Project-URL: Source, https://github.com/chada-hash/trustprotocol-python
+Keywords: ai,governance,audit,agents,eu-ai-act,compliance
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+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: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: requests>=2.28.0
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: project-url
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# TrustProtocol Python SDK
+
+Governance and cryptographic audit trail for AI agents.
+
+## Installation
+
+```bash
+pip install trustprotocol
+```
+
+## Quick Start
+
+```python
+from trustprotocol import TrustProtocol
+
+tp = TrustProtocol("your-api-key")
+
+result = tp.intercept(
+    agent_id="finance-agent-01",
+    action="Transfer 5000 EUR to supplier ACME",
+    cost_eur=5000.0,
+    user_id="marie@yourcompany.com"
+)
+
+if result.authorized:
+    print(f"✓ Authorized — Risk score: {result.risk_score}/100")
+    # Execute the action
+else:
+    print(f"✗ Blocked — {result.block_reason}")
+```
+
+## Raise on block
+
+```python
+from trustprotocol import TrustProtocol, TrustProtocolError
+
+tp = TrustProtocol("your-api-key")
+
+try:
+    result = tp.intercept(
+        agent_id="finance-agent-01",
+        action="Transfer 150000 EUR to new beneficiary",
+        cost_eur=150000.0,
+        user_id="marie@yourcompany.com",
+        raise_on_block=True
+    )
+    # Execute action
+except TrustProtocolError as e:
+    print(f"Blocked: {e.block_reason}")
+    print(f"Risk score: {e.risk_score}/100")
+    print(f"Reasons: {e.reasons}")
+```
+
+## With LangChain
+
+```python
+from trustprotocol import TrustProtocol
+from langchain.tools import tool
+
+tp = TrustProtocol("your-api-key")
+
+@tool
+def governed_payment(amount: float, recipient: str, user_id: str) -> str:
+    """Execute a payment with TrustProtocol governance."""
+    result = tp.intercept(
+        agent_id="payment-agent",
+        action=f"Transfer {amount} EUR to {recipient}",
+        cost_eur=amount,
+        user_id=user_id,
+        raise_on_block=True
+    )
+    return f"Payment authorized. Attestation: {result.attestation_id}"
+```
+
+## Audit & Verification
+
+```python
+# Get audit ledger
+ledger = tp.ledger(agent_id="finance-agent-01")
+print(f"Total actions: {ledger['total']}")
+
+# Verify chain integrity
+verification = tp.verify_chain()
+print(f"Chain valid: {verification['chain_valid']}")
+
+# Pending approvals
+approvals = tp.approvals()
+print(f"Pending: {len(approvals.get('approvals', []))}")
+```
+
+## Links
+
+- [Dashboard](https://trustprotocol.tech/dashboard)
+- [Documentation](https://trustprotocol.tech/docs)
+- [Trust Center](https://trustprotocol.tech/trust)

trustprotocol-1.0.0/trustprotocol.egg-info/SOURCES.txt

@@ -0,0 +1,9 @@
+README.md
+setup.py
+trustprotocol/__init__.py
+trustprotocol/client.py
+trustprotocol.egg-info/PKG-INFO
+trustprotocol.egg-info/SOURCES.txt
+trustprotocol.egg-info/dependency_links.txt
+trustprotocol.egg-info/requires.txt
+trustprotocol.egg-info/top_level.txt

trustprotocol-1.0.0/trustprotocol.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

trustprotocol-1.0.0/trustprotocol.egg-info/requires.txt

@@ -0,0 +1 @@
+requests>=2.28.0

trustprotocol-1.0.0/trustprotocol.egg-info/top_level.txt

@@ -0,0 +1 @@
+trustprotocol