agent-trust-sdk 0.1.0__tar.gz → 0.2.0__tar.gz

{agent_trust_sdk-0.1.0 → agent_trust_sdk-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agent-trust-sdk
-Version: 0.1.0
+Version: 0.2.0
 Summary: Python client for the Agent Trust Verification API
 Home-page: https://github.com/your-org/agent-trust-infrastructure
 Author: Agent Trust Infrastructure
@@ -163,6 +163,53 @@ client.report_threat(
 )
 ```
 
+### Agent Verification
+
+Verify ownership of your agent via email or domain DNS records:
+
+#### Email Verification
+
+```python
+# Step 1: Start email verification
+result = client.start_email_verification(
+    agent_url="https://myagent.ai/agent",
+    email="owner@myagent.ai"
+)
+print(f"Verification email sent! Expires: {result['expires_at']}")
+
+# Step 2: Confirm with token from email
+confirmation = client.confirm_email_verification(
+    agent_url="https://myagent.ai/agent",
+    token="abc123..."  # Token from verification email
+)
+
+if confirmation['success']:
+    print(f"✅ Email verified: {confirmation['verified_email']}")
+```
+
+#### Domain Verification
+
+```python
+# Step 1: Get DNS record instructions
+result = client.start_domain_verification(
+    agent_url="https://myagent.ai/agent"
+)
+
+print("Add this DNS TXT record to your domain:")
+print(f"  Name:  {result['record_name']}")
+print(f"  Value: {result['record_value']}")
+
+# Step 2: After adding DNS record, check verification
+status = client.check_domain_verification(
+    agent_url="https://myagent.ai/agent"
+)
+
+if status['verified']:
+    print(f"✅ Domain verified at {status['verified_at']}")
+else:
+    print(f"⏳ DNS record not found yet. Expected: {status['expected_record']}")
+```
+
 ## Async Support
 
 For async/await usage:

{agent_trust_sdk-0.1.0 → agent_trust_sdk-0.2.0}/README.md

@@ -126,6 +126,53 @@ client.report_threat(
 )
 ```
 
+### Agent Verification
+
+Verify ownership of your agent via email or domain DNS records:
+
+#### Email Verification
+
+```python
+# Step 1: Start email verification
+result = client.start_email_verification(
+    agent_url="https://myagent.ai/agent",
+    email="owner@myagent.ai"
+)
+print(f"Verification email sent! Expires: {result['expires_at']}")
+
+# Step 2: Confirm with token from email
+confirmation = client.confirm_email_verification(
+    agent_url="https://myagent.ai/agent",
+    token="abc123..."  # Token from verification email
+)
+
+if confirmation['success']:
+    print(f"✅ Email verified: {confirmation['verified_email']}")
+```
+
+#### Domain Verification
+
+```python
+# Step 1: Get DNS record instructions
+result = client.start_domain_verification(
+    agent_url="https://myagent.ai/agent"
+)
+
+print("Add this DNS TXT record to your domain:")
+print(f"  Name:  {result['record_name']}")
+print(f"  Value: {result['record_value']}")
+
+# Step 2: After adding DNS record, check verification
+status = client.check_domain_verification(
+    agent_url="https://myagent.ai/agent"
+)
+
+if status['verified']:
+    print(f"✅ Domain verified at {status['verified_at']}")
+else:
+    print(f"⏳ DNS record not found yet. Expected: {status['expected_record']}")
+```
+
 ## Async Support
 
 For async/await usage:

{agent_trust_sdk-0.1.0 → agent_trust_sdk-0.2.0}/agent_trust/__init__.py

@@ -19,26 +19,31 @@ Usage:
         print(f"Agent blocked: {result.reasoning}")
 """
 
-from .client import AgentTrustClient
+from .client import AgentTrustClient, AsyncAgentTrustClient, AgentTrustError, APIError
 from .models import (
     VerificationResult,
     AgentReputation,
     InteractionResult,
     ScoreBreakdown,
     ThreatMatch,
+    TextScanResult,
     Verdict,
     ThreatLevel,
     InteractionOutcome,
 )
 
-__version__ = "0.1.0"
+__version__ = "0.2.0"
 __all__ = [
     "AgentTrustClient",
+    "AsyncAgentTrustClient",
+    "AgentTrustError",
+    "APIError",
     "VerificationResult",
     "AgentReputation", 
     "InteractionResult",
     "ScoreBreakdown",
     "ThreatMatch",
+    "TextScanResult",
     "Verdict",
     "ThreatLevel",
     "InteractionOutcome",

{agent_trust_sdk-0.1.0 → agent_trust_sdk-0.2.0}/agent_trust/client.py

@@ -366,6 +366,132 @@ class AgentTrustClient:
         
         return self._request("POST", "/threats/report", json=data)
     
+    # ========================================================================
+    # Agent Verification Endpoints
+    # ========================================================================
+    
+    def start_email_verification(self, agent_url: str, email: str) -> dict:
+        """
+        Start email verification for an agent.
+        
+        Initiates the email verification process by sending a verification
+        token to the specified email address.
+        
+        Args:
+            agent_url: URL of the agent to verify
+            email: Email address to verify ownership of
+        
+        Returns:
+            dict with verification token info:
+                - message: Status message
+                - email: The email address being verified
+                - expires_at: When the token expires (ISO format)
+                - token: The verification token (MVP only, for testing)
+        
+        Example:
+            result = client.start_email_verification(
+                agent_url="https://myagent.ai/agent",
+                email="owner@myagent.ai"
+            )
+            print(f"Check your email! Token expires: {result['expires_at']}")
+        """
+        encoded_url = quote(agent_url, safe="")
+        data = {"email": email}
+        return self._request("POST", f"/agents/{encoded_url}/verify/email", json=data)
+    
+    def confirm_email_verification(self, agent_url: str, token: str) -> dict:
+        """
+        Confirm email verification with the token.
+        
+        Completes the email verification process using the token received
+        via email (or returned from start_email_verification in MVP mode).
+        
+        Args:
+            agent_url: URL of the agent being verified
+            token: The verification token (64-character hex string)
+        
+        Returns:
+            dict with confirmation result:
+                - success: Whether verification succeeded
+                - message: Status message
+                - agent_url: The verified agent URL
+                - verified_email: The email that was verified
+                - verified_at: When verification completed (ISO format)
+        
+        Example:
+            result = client.confirm_email_verification(
+                agent_url="https://myagent.ai/agent",
+                token="abc123..."
+            )
+            if result['success']:
+                print(f"Email verified: {result['verified_email']}")
+        """
+        encoded_url = quote(agent_url, safe="")
+        return self._request("GET", f"/agents/{encoded_url}/verify/email/{token}")
+    
+    def start_domain_verification(self, agent_url: str) -> dict:
+        """
+        Start domain verification for an agent.
+        
+        Generates a DNS TXT record challenge that must be added to the
+        agent's domain to prove ownership.
+        
+        Args:
+            agent_url: URL of the agent to verify
+        
+        Returns:
+            dict with DNS record instructions:
+                - message: Status message
+                - domain: The domain being verified
+                - record_type: DNS record type (TXT)
+                - record_name: Where to add the record (e.g., _trustagents.domain.com)
+                - record_value: The value to set (e.g., trustagents-verify=<token>)
+                - instructions: Human-readable setup instructions
+                - expires_at: When the challenge expires (ISO format)
+        
+        Example:
+            result = client.start_domain_verification(
+                agent_url="https://myagent.ai/agent"
+            )
+            print(f"Add this DNS record:")
+            print(f"  Type: {result['record_type']}")
+            print(f"  Name: {result['record_name']}")
+            print(f"  Value: {result['record_value']}")
+        """
+        encoded_url = quote(agent_url, safe="")
+        return self._request("POST", f"/agents/{encoded_url}/verify/domain")
+    
+    def check_domain_verification(self, agent_url: str) -> dict:
+        """
+        Check if domain verification DNS record exists.
+        
+        Performs a DNS lookup to verify that the required TXT record
+        has been properly configured.
+        
+        Args:
+            agent_url: URL of the agent being verified
+        
+        Returns:
+            dict with verification status:
+                - verified: Whether the domain is verified
+                - message: Status message
+                - domain: The domain being checked
+                - expected_record: The expected DNS record value
+                - found_records: List of TXT records found (if any)
+                - verified_at: When verification completed (if verified)
+        
+        Example:
+            result = client.check_domain_verification(
+                agent_url="https://myagent.ai/agent"
+            )
+            if result['verified']:
+                print(f"Domain verified at {result['verified_at']}")
+            else:
+                print(f"Record not found. Expected: {result['expected_record']}")
+        """
+        encoded_url = quote(agent_url, safe="")
+        return self._request("GET", f"/agents/{encoded_url}/verify/domain/check")
+    
     # ========================================================================
     # Utility Methods
     # ========================================================================
@@ -543,3 +669,58 @@ class AsyncAgentTrustClient:
     async def health_check(self) -> dict:
         """Check API health status."""
         return await self._request("GET", "/health")
+    
+    async def start_email_verification(self, agent_url: str, email: str) -> dict:
+        """
+        Start email verification for an agent.
+        
+        Args:
+            agent_url: URL of the agent to verify
+            email: Email address to verify ownership of
+        
+        Returns:
+            dict with verification token info
+        """
+        encoded_url = quote(agent_url, safe="")
+        data = {"email": email}
+        return await self._request("POST", f"/agents/{encoded_url}/verify/email", json=data)
+    
+    async def confirm_email_verification(self, agent_url: str, token: str) -> dict:
+        """
+        Confirm email verification with the token.
+        
+        Args:
+            agent_url: URL of the agent being verified
+            token: The verification token
+        
+        Returns:
+            dict with confirmation result
+        """
+        encoded_url = quote(agent_url, safe="")
+        return await self._request("GET", f"/agents/{encoded_url}/verify/email/{token}")
+    
+    async def start_domain_verification(self, agent_url: str) -> dict:
+        """
+        Start domain verification for an agent.
+        
+        Args:
+            agent_url: URL of the agent to verify
+        
+        Returns:
+            dict with DNS record instructions
+        """
+        encoded_url = quote(agent_url, safe="")
+        return await self._request("POST", f"/agents/{encoded_url}/verify/domain")
+    
+    async def check_domain_verification(self, agent_url: str) -> dict:
+        """
+        Check if domain verification DNS record exists.
+        
+        Args:
+            agent_url: URL of the agent being verified
+        
+        Returns:
+            dict with verification status
+        """
+        encoded_url = quote(agent_url, safe="")
+        return await self._request("GET", f"/agents/{encoded_url}/verify/domain/check")

{agent_trust_sdk-0.1.0 → agent_trust_sdk-0.2.0}/agent_trust_sdk.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agent-trust-sdk
-Version: 0.1.0
+Version: 0.2.0
 Summary: Python client for the Agent Trust Verification API
 Home-page: https://github.com/your-org/agent-trust-infrastructure
 Author: Agent Trust Infrastructure
@@ -163,6 +163,53 @@ client.report_threat(
 )
 ```
 
+### Agent Verification
+
+Verify ownership of your agent via email or domain DNS records:
+
+#### Email Verification
+
+```python
+# Step 1: Start email verification
+result = client.start_email_verification(
+    agent_url="https://myagent.ai/agent",
+    email="owner@myagent.ai"
+)
+print(f"Verification email sent! Expires: {result['expires_at']}")
+
+# Step 2: Confirm with token from email
+confirmation = client.confirm_email_verification(
+    agent_url="https://myagent.ai/agent",
+    token="abc123..."  # Token from verification email
+)
+
+if confirmation['success']:
+    print(f"✅ Email verified: {confirmation['verified_email']}")
+```
+
+#### Domain Verification
+
+```python
+# Step 1: Get DNS record instructions
+result = client.start_domain_verification(
+    agent_url="https://myagent.ai/agent"
+)
+
+print("Add this DNS TXT record to your domain:")
+print(f"  Name:  {result['record_name']}")
+print(f"  Value: {result['record_value']}")
+
+# Step 2: After adding DNS record, check verification
+status = client.check_domain_verification(
+    agent_url="https://myagent.ai/agent"
+)
+
+if status['verified']:
+    print(f"✅ Domain verified at {status['verified_at']}")
+else:
+    print(f"⏳ DNS record not found yet. Expected: {status['expected_record']}")
+```
+
 ## Async Support
 
 For async/await usage:

{agent_trust_sdk-0.1.0 → agent_trust_sdk-0.2.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "agent-trust-sdk"
-version = "0.1.0"
+version = "0.2.0"
 description = "Python client for the Agent Trust Verification API"
 readme = "README.md"
 license = {text = "MIT"}

{agent_trust_sdk-0.1.0 → agent_trust_sdk-0.2.0}/setup.py

@@ -9,7 +9,7 @@ with open("README.md", "r", encoding="utf-8") as f:
 
 setup(
     name="agent-trust-sdk",
-    version="0.1.0",
+    version="0.2.0",
     author="Agent Trust Infrastructure",
     author_email="hello@agenttrust.dev",
     description="Python client for the Agent Trust Verification API",