elydora 1.0.0__tar.gz

elydora-1.0.0/PKG-INFO

@@ -0,0 +1,252 @@
+Metadata-Version: 2.4
+Name: elydora
+Version: 1.0.0
+Summary: Python SDK for the Elydora tamper-evident audit platform
+License: MIT
+Classifier: Development Status :: 5 - Production/Stable
+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: Typing :: Typed
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: requests>=2.28.0
+Requires-Dist: aiohttp>=3.8.0
+Requires-Dist: cryptography>=41.0.0
+Requires-Dist: typing_extensions>=4.0.0; python_version < "3.11"
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.21; extra == "dev"
+Requires-Dist: mypy>=1.0; extra == "dev"
+
+# Elydora Python SDK
+
+Official Python SDK for the [Elydora](https://elydora.com) tamper-evident audit platform. Build cryptographically verifiable audit trails for AI agent operations.
+
+## Installation
+
+```bash
+pip install elydora
+```
+
+Requires Python 3.9+.
+
+## Quick Start
+
+```python
+from elydora import ElydoraClient
+
+# Authenticate
+auth = ElydoraClient.login("https://api.elydora.com", "user@example.com", "password")
+
+# Create client
+client = ElydoraClient(
+    org_id=auth["user"]["org_id"],
+    agent_id="my-agent-id",
+    private_key="<base64url-encoded-ed25519-seed>",
+    base_url="https://api.elydora.com",
+    token=auth["token"],
+)
+
+# Create and submit an operation
+eor = client.create_operation(
+    operation_type="data.access",
+    subject={"user_id": "u-123", "resource": "patient-record"},
+    action={"type": "read", "scope": "full"},
+    payload={"record_id": "rec-456"},
+)
+response = client.submit_operation(eor)
+print("Receipt:", response["receipt"]["receipt_id"])
+```
+
+## Async Support
+
+```python
+from elydora import AsyncElydoraClient
+
+async def main():
+    client = AsyncElydoraClient(
+        org_id="org-123",
+        agent_id="agent-456",
+        private_key="<base64url-encoded-ed25519-seed>",
+        token="<jwt-token>",
+    )
+
+    eor = client.create_operation(
+        operation_type="inference",
+        subject={"model": "gpt-4"},
+        action={"type": "completion"},
+    )
+    response = await client.submit_operation(eor)
+    await client.close()
+```
+
+## CLI
+
+The SDK includes a CLI for installing audit hooks into AI coding agents.
+
+```bash
+elydora install \
+  --agent claudecode \
+  --org_id org-123 \
+  --agent_id agent-456 \
+  --private_key <key> \
+  --kid agent-456-key-v1
+```
+
+### Commands
+
+| Command | Description |
+|---------|-------------|
+| `elydora install` | Install Elydora audit hook for a coding agent |
+| `elydora uninstall` | Remove Elydora audit hook for a coding agent |
+| `elydora status` | Show installation status for all agents |
+| `elydora agents` | List supported coding agents |
+
+### Supported Agents
+
+| Agent | Key |
+|-------|-----|
+| Claude Code | `claudecode` |
+| Cursor | `cursor` |
+| Gemini CLI | `gemini` |
+| Augment Code | `augment` |
+| Kiro | `kiro` |
+| OpenCode | `opencode` |
+
+## API Reference
+
+### Configuration
+
+```python
+client = ElydoraClient(
+    org_id="org-123",           # Organization ID
+    agent_id="agent-456",       # Agent ID
+    private_key="<seed>",       # Base64url-encoded Ed25519 seed
+    base_url="https://...",     # API base URL (default: https://api.elydora.com)
+    ttl_ms=30000,               # Operation TTL in ms (default: 30000)
+    max_retries=3,              # Max retries on transient failures (default: 3)
+    token="<jwt>",              # Optional JWT bearer token
+)
+```
+
+### Authentication
+
+```python
+# Register a new user and organization
+reg = ElydoraClient.register(base_url, email, password, display_name=None, org_name=None)
+
+# Login and receive a JWT
+auth = ElydoraClient.login(base_url, email, password)
+```
+
+### Operations
+
+```python
+# Create a signed EOR locally (no network call)
+eor = client.create_operation(
+    operation_type="inference",
+    subject={"model": "gpt-4"},
+    action={"type": "completion"},
+    payload={"prompt": "Hello"},
+)
+
+# Submit to API
+response = client.submit_operation(eor)
+
+# Retrieve an operation
+op = client.get_operation(operation_id)
+
+# Verify integrity
+result = client.verify_operation(operation_id)
+```
+
+### Agent Management
+
+```python
+# Register a new agent
+agent = client.register_agent({
+    "agent_id": "my-agent",
+    "display_name": "My Agent",
+    "responsible_entity": "team@example.com",
+    "keys": [{"kid": "key-v1", "public_key": "<base64url>", "algorithm": "ed25519"}],
+})
+
+# Get agent details
+details = client.get_agent(agent_id)
+
+# Freeze an agent
+client.freeze_agent(agent_id, reason="security review")
+
+# Revoke a key
+client.revoke_key(agent_id, kid, reason="key rotation")
+```
+
+### Audit
+
+```python
+import time
+
+results = client.query_audit(
+    agent_id="agent-123",
+    operation_type="inference",
+    start_time=int(time.time() * 1000) - 86400000,
+    end_time=int(time.time() * 1000),
+    limit=50,
+)
+```
+
+### Epochs
+
+```python
+epochs = client.list_epochs()
+epoch = client.get_epoch(epoch_id)
+```
+
+### Exports
+
+```python
+export = client.create_export(
+    start_time=start,
+    end_time=end,
+    format="json",
+)
+
+exports = client.list_exports()
+detail = client.get_export(export_id)
+```
+
+### JWKS
+
+```python
+jwks = client.get_jwks()
+```
+
+## Error Handling
+
+```python
+from elydora import ElydoraError
+
+try:
+    client.submit_operation(eor)
+except ElydoraError as e:
+    print(e.code)        # e.g. "INVALID_SIGNATURE"
+    print(e.message)     # Human-readable message
+    print(e.status_code) # HTTP status code
+    print(e.request_id)  # Request ID for support
+```
+
+## Dependencies
+
+- [requests](https://pypi.org/project/requests/) - Sync HTTP client
+- [aiohttp](https://pypi.org/project/aiohttp/) - Async HTTP client
+- [cryptography](https://pypi.org/project/cryptography/) - Ed25519 signing
+
+## License
+
+MIT

elydora-1.0.0/README.md

@@ -0,0 +1,226 @@
+# Elydora Python SDK
+
+Official Python SDK for the [Elydora](https://elydora.com) tamper-evident audit platform. Build cryptographically verifiable audit trails for AI agent operations.
+
+## Installation
+
+```bash
+pip install elydora
+```
+
+Requires Python 3.9+.
+
+## Quick Start
+
+```python
+from elydora import ElydoraClient
+
+# Authenticate
+auth = ElydoraClient.login("https://api.elydora.com", "user@example.com", "password")
+
+# Create client
+client = ElydoraClient(
+    org_id=auth["user"]["org_id"],
+    agent_id="my-agent-id",
+    private_key="<base64url-encoded-ed25519-seed>",
+    base_url="https://api.elydora.com",
+    token=auth["token"],
+)
+
+# Create and submit an operation
+eor = client.create_operation(
+    operation_type="data.access",
+    subject={"user_id": "u-123", "resource": "patient-record"},
+    action={"type": "read", "scope": "full"},
+    payload={"record_id": "rec-456"},
+)
+response = client.submit_operation(eor)
+print("Receipt:", response["receipt"]["receipt_id"])
+```
+
+## Async Support
+
+```python
+from elydora import AsyncElydoraClient
+
+async def main():
+    client = AsyncElydoraClient(
+        org_id="org-123",
+        agent_id="agent-456",
+        private_key="<base64url-encoded-ed25519-seed>",
+        token="<jwt-token>",
+    )
+
+    eor = client.create_operation(
+        operation_type="inference",
+        subject={"model": "gpt-4"},
+        action={"type": "completion"},
+    )
+    response = await client.submit_operation(eor)
+    await client.close()
+```
+
+## CLI
+
+The SDK includes a CLI for installing audit hooks into AI coding agents.
+
+```bash
+elydora install \
+  --agent claudecode \
+  --org_id org-123 \
+  --agent_id agent-456 \
+  --private_key <key> \
+  --kid agent-456-key-v1
+```
+
+### Commands
+
+| Command | Description |
+|---------|-------------|
+| `elydora install` | Install Elydora audit hook for a coding agent |
+| `elydora uninstall` | Remove Elydora audit hook for a coding agent |
+| `elydora status` | Show installation status for all agents |
+| `elydora agents` | List supported coding agents |
+
+### Supported Agents
+
+| Agent | Key |
+|-------|-----|
+| Claude Code | `claudecode` |
+| Cursor | `cursor` |
+| Gemini CLI | `gemini` |
+| Augment Code | `augment` |
+| Kiro | `kiro` |
+| OpenCode | `opencode` |
+
+## API Reference
+
+### Configuration
+
+```python
+client = ElydoraClient(
+    org_id="org-123",           # Organization ID
+    agent_id="agent-456",       # Agent ID
+    private_key="<seed>",       # Base64url-encoded Ed25519 seed
+    base_url="https://...",     # API base URL (default: https://api.elydora.com)
+    ttl_ms=30000,               # Operation TTL in ms (default: 30000)
+    max_retries=3,              # Max retries on transient failures (default: 3)
+    token="<jwt>",              # Optional JWT bearer token
+)
+```
+
+### Authentication
+
+```python
+# Register a new user and organization
+reg = ElydoraClient.register(base_url, email, password, display_name=None, org_name=None)
+
+# Login and receive a JWT
+auth = ElydoraClient.login(base_url, email, password)
+```
+
+### Operations
+
+```python
+# Create a signed EOR locally (no network call)
+eor = client.create_operation(
+    operation_type="inference",
+    subject={"model": "gpt-4"},
+    action={"type": "completion"},
+    payload={"prompt": "Hello"},
+)
+
+# Submit to API
+response = client.submit_operation(eor)
+
+# Retrieve an operation
+op = client.get_operation(operation_id)
+
+# Verify integrity
+result = client.verify_operation(operation_id)
+```
+
+### Agent Management
+
+```python
+# Register a new agent
+agent = client.register_agent({
+    "agent_id": "my-agent",
+    "display_name": "My Agent",
+    "responsible_entity": "team@example.com",
+    "keys": [{"kid": "key-v1", "public_key": "<base64url>", "algorithm": "ed25519"}],
+})
+
+# Get agent details
+details = client.get_agent(agent_id)
+
+# Freeze an agent
+client.freeze_agent(agent_id, reason="security review")
+
+# Revoke a key
+client.revoke_key(agent_id, kid, reason="key rotation")
+```
+
+### Audit
+
+```python
+import time
+
+results = client.query_audit(
+    agent_id="agent-123",
+    operation_type="inference",
+    start_time=int(time.time() * 1000) - 86400000,
+    end_time=int(time.time() * 1000),
+    limit=50,
+)
+```
+
+### Epochs
+
+```python
+epochs = client.list_epochs()
+epoch = client.get_epoch(epoch_id)
+```
+
+### Exports
+
+```python
+export = client.create_export(
+    start_time=start,
+    end_time=end,
+    format="json",
+)
+
+exports = client.list_exports()
+detail = client.get_export(export_id)
+```
+
+### JWKS
+
+```python
+jwks = client.get_jwks()
+```
+
+## Error Handling
+
+```python
+from elydora import ElydoraError
+
+try:
+    client.submit_operation(eor)
+except ElydoraError as e:
+    print(e.code)        # e.g. "INVALID_SIGNATURE"
+    print(e.message)     # Human-readable message
+    print(e.status_code) # HTTP status code
+    print(e.request_id)  # Request ID for support
+```
+
+## Dependencies
+
+- [requests](https://pypi.org/project/requests/) - Sync HTTP client
+- [aiohttp](https://pypi.org/project/aiohttp/) - Async HTTP client
+- [cryptography](https://pypi.org/project/cryptography/) - Ed25519 signing
+
+## License
+
+MIT

elydora-1.0.0/elydora/__init__.py

@@ -0,0 +1,86 @@
+"""Elydora Python SDK — tamper-evident audit trail for AI agents."""
+
+from .client import ElydoraClient
+from .async_client import AsyncElydoraClient
+from .errors import ElydoraError
+from .crypto import (
+    compute_chain_hash,
+    compute_payload_hash,
+    jcs_canonicalize,
+    sha256_base64url,
+    sign_ed25519,
+    sign_eor,
+    get_public_key_base64url,
+)
+from .utils import base64url_encode, base64url_decode, generate_nonce, generate_uuidv7
+from .types import (
+    EOR,
+    EAR,
+    Agent,
+    AgentKey,
+    Operation,
+    Receipt,
+    Epoch,
+    Export,
+    Organization,
+    User,
+    RegisterAgentRequest,
+    RegisterAgentResponse,
+    GetAgentResponse,
+    SubmitOperationResponse,
+    GetOperationResponse,
+    VerifyOperationResponse,
+    AuditQueryResponse,
+    GetEpochResponse,
+    ListEpochsResponse,
+    CreateExportResponse,
+    GetExportResponse,
+    ListExportsResponse,
+    JWKSResponse,
+    AuthRegisterResponse,
+    AuthLoginResponse,
+)
+
+__version__ = "1.0.0"
+
+__all__ = [
+    "ElydoraClient",
+    "AsyncElydoraClient",
+    "ElydoraError",
+    "compute_chain_hash",
+    "compute_payload_hash",
+    "jcs_canonicalize",
+    "sha256_base64url",
+    "sign_ed25519",
+    "sign_eor",
+    "get_public_key_base64url",
+    "base64url_encode",
+    "base64url_decode",
+    "generate_nonce",
+    "generate_uuidv7",
+    "EOR",
+    "EAR",
+    "Agent",
+    "AgentKey",
+    "Operation",
+    "Receipt",
+    "Epoch",
+    "Export",
+    "Organization",
+    "User",
+    "RegisterAgentRequest",
+    "RegisterAgentResponse",
+    "GetAgentResponse",
+    "SubmitOperationResponse",
+    "GetOperationResponse",
+    "VerifyOperationResponse",
+    "AuditQueryResponse",
+    "GetEpochResponse",
+    "ListEpochsResponse",
+    "CreateExportResponse",
+    "GetExportResponse",
+    "ListExportsResponse",
+    "JWKSResponse",
+    "AuthRegisterResponse",
+    "AuthLoginResponse",
+]