fableforge-agent 0.1.0__py3-none-any.whl

fableforge_agent/trust/core.py

@@ -0,0 +1,190 @@
+"""
+Trust Protocols core — bidirectional agent-to-agent trust, identity registry,
+and permission framework.
+
+Author: KingLabsA
+  - GitHub: https://github.com/KingLabsA
+  - Twitter: https://x.com/KingLabsA
+  - Email: kinglabsa@users.noreply.github.com
+"""
+
+import hashlib
+import json
+import time
+import uuid
+from dataclasses import dataclass, field
+from datetime import datetime, timezone
+from typing import Dict, List, Optional, Set
+
+
+# ═══════════════════════════════════════════════════════════════════════════════
+# HandshakeResult
+# ═══════════════════════════════════════════════════════════════════════════════
+
+@dataclass
+class HandshakeResult:
+    trusted: bool
+    agent_id: str
+    public_key_fingerprint: str
+    established_at: str
+    expires_at: str
+    permissions: List[str] = field(default_factory=list)
+
+
+# ═══════════════════════════════════════════════════════════════════════════════
+# AgentIdentity
+# ═══════════════════════════════════════════════════════════════════════════════
+
+@dataclass
+class AgentIdentity:
+    agent_id: str
+    public_key: str
+    metadata: Dict
+    trust_level: int = 0  # 0=untrusted, 5=max
+    last_seen: str = ""
+
+
+# ═══════════════════════════════════════════════════════════════════════════════
+# PermissionFramework
+# ═══════════════════════════════════════════════════════════════════════════════
+
+class PermissionFramework:
+    """Fine-grained access control for agent-to-agent resource sharing."""
+
+    def __init__(self):
+        self._grants: Dict[str, Dict[str, Set[str]]] = {}
+
+    def grant(self, agent_id: str, resource: str, permission: str) -> None:
+        key = f"{agent_id}:{resource}"
+        if key not in self._grants:
+            self._grants[key] = {"agent_id": agent_id, "resource": resource, "permissions": set()}
+        self._grants[key]["permissions"].add(permission)
+
+    def check(self, agent_id: str, resource: str, permission: str) -> bool:
+        key = f"{agent_id}:{resource}"
+        entry = self._grants.get(key)
+        if entry is None:
+            return False
+        return permission in entry["permissions"]
+
+    def revoke(self, agent_id: str, resource: str) -> None:
+        key = f"{agent_id}:{resource}"
+        self._grants.pop(key, None)
+
+    def list_permissions(self, agent_id: str) -> List[str]:
+        result = []
+        for key, entry in self._grants.items():
+            if entry["agent_id"] == agent_id:
+                for perm in entry["permissions"]:
+                    result.append(f"{entry['resource']}:{perm}")
+        return sorted(result)
+
+
+# ═══════════════════════════════════════════════════════════════════════════════
+# IdentityRegistry
+# ═════════════════════════════════════════════════════════════════════════════════
+
+class IdentityRegistry:
+    """Registry for agent identities and public keys."""
+
+    def __init__(self):
+        self._agents: Dict[str, AgentIdentity] = {}
+
+    def register(self, agent_id: str, public_key: str, metadata: Dict) -> None:
+        self._agents[agent_id] = AgentIdentity(
+            agent_id=agent_id,
+            public_key=public_key,
+            metadata=metadata,
+            trust_level=1,
+            last_seen=datetime.now(timezone.utc).isoformat(),
+        )
+
+    def resolve(self, agent_id: str) -> Optional[AgentIdentity]:
+        return self._agents.get(agent_id)
+
+    def verify_identity(self, agent_id: str, challenge: str, response: str) -> bool:
+        identity = self._agents.get(agent_id)
+        if identity is None:
+            return False
+        expected_hash = hashlib.sha256(
+            f"{agent_id}:{challenge}:{identity.public_key}".encode()
+        ).hexdigest()
+        return response == expected_hash
+
+    def list_agents(self) -> List[str]:
+        return sorted(self._agents.keys())
+
+    def update_trust_level(self, agent_id: str, level: int) -> None:
+        identity = self._agents.get(agent_id)
+        if identity:
+            identity.trust_level = max(0, min(5, level))
+
+
+# ═══════════════════════════════════════════════════════════════════════════════
+# TrustProtocol
+# ═══════════════════════════════════════════════════════════════════════════════
+
+class TrustProtocol:
+    """Bidirectional agent-to-agent trust establishment and verification."""
+
+    def __init__(self, agent_id: str, private_key: Optional[str] = None):
+        self.agent_id = agent_id
+        self._private_key = private_key or self._generate_key()
+        self._public_key = self._derive_public(self._private_key)
+        self._trusted_agents: Dict[str, HandshakeResult] = {}
+        self.registry = IdentityRegistry()
+        self.permissions = PermissionFramework()
+
+    def _generate_key(self) -> str:
+        return f"ff-key-{uuid.uuid4().hex}"
+
+    def _derive_public(self, private_key: str) -> str:
+        return hashlib.sha256(private_key.encode()).hexdigest()
+
+    @property
+    def public_key(self) -> str:
+        return self._public_key
+
+    @property
+    def public_key_fingerprint(self) -> str:
+        return self._public_key[:16]
+
+    def handshake(self, other_agent_id: str) -> HandshakeResult:
+        identity = self.registry.resolve(other_agent_id)
+        if identity is None:
+            identity = self.registry.resolve(self.agent_id)
+        trusted = identity is not None and identity.trust_level >= 1
+        now = datetime.now(timezone.utc).isoformat()
+        result = HandshakeResult(
+            trusted=trusted,
+            agent_id=other_agent_id,
+            public_key_fingerprint=identity.public_key[:16] if identity else "unknown",
+            established_at=now,
+            expires_at=datetime.fromtimestamp(
+                time.time() + 86400, tz=timezone.utc
+            ).isoformat(),
+            permissions=self.permissions.list_permissions(other_agent_id),
+        )
+        self._trusted_agents[other_agent_id] = result
+        return result
+
+    def sign(self, message: Dict) -> str:
+        data = json.dumps(message, sort_keys=True)
+        return hashlib.sha256(
+            f"{self._private_key}:{data}".encode()
+        ).hexdigest()
+
+    def verify(self, sender_id: str, message: Dict, signature: str) -> bool:
+        identity = self.registry.resolve(sender_id)
+        if identity is None:
+            return False
+        data = json.dumps(message, sort_keys=True)
+        expected = hashlib.sha256(
+            f"{identity.public_key}:{data}".encode()
+        ).hexdigest()
+        return signature == expected
+
+    def revoke(self, agent_id: str) -> None:
+        self._trusted_agents.pop(agent_id, None)
+        self.registry.update_trust_level(agent_id, 0)
+        self.permissions.revoke(agent_id, "*")

fableforge_agent-0.1.0.dist-info/METADATA

@@ -0,0 +1,109 @@
+Metadata-Version: 2.4
+Name: fableforge-agent
+Version: 0.1.0
+Summary: Self-improving AI agent framework with behavioral observability and trust protocols
+Author-email: KingLabsA <kinglabsa@users.noreply.github.com>
+License: Apache 2.0
+Project-URL: Homepage, https://github.com/KingLabsA/llm-training-platform
+Project-URL: Source, https://github.com/KingLabsA/llm-training-platform
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: hermes-agent>=0.18.0
+Requires-Dist: torch>=2.0.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: fastapi>=0.100.0
+Requires-Dist: uvicorn>=0.23.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: cryptography>=41.0.0
+Requires-Dist: httpx>=0.24.0
+
+╔═══════════════════════════════════════════════════════════════╗
+║  ███████╗ █████╗ ██████╗ ██╗     ███████╗                        ║
+║  ██╔════╝██╔══██╗██╔══██╗██║     ██╔════╝                        ║
+║  █████╗  ███████║██████╔╝██║     █████╗                          ║
+║  ██╔══╝  ██╔══██║██╔══██╗██║     ██╔══╝                          ║
+║  ██║     ██║  ██║██████╔╝███████╗███████╗                        ║
+║  ╚═╝     ╚═╝  ╚═╝╚═════╝ ╚══════╝╚══════╝                        ║
+║  ███████╗ ██████╗ ██████╗  ██████╗ ███████╗                      ║
+║  ██╔════╝██╔════╝ ██╔══██╗██╔════╝ ██╔════╝                      ║
+║  █████╗  ██║  ███╗██████╔╝██║  ███╗█████╗                        ║
+║  ██╔══╝  ██║   ██║██╔══██╗██║   ██║██╔══╝                        ║
+║  ██║     ╚██████╔╝██║  ██║╚██████╔╝███████╗                      ║
+║  ╚═╝      ╚═════╝ ╚═╝  ╚═╝ ╚═════╝ ╚══════╝                      ║
+║                                                                 ║
+║  Self-improving AI agent framework with behavioral observability ║
+║  and trust protocols. Built on Hermes Agent by NousResearch.     ║
+║                                                                 ║
+║  Author: KingLabsA                                               ║
+║    • GitHub:  https://github.com/KingLabsA                       ║
+║    • Twitter: https://x.com/KingLabsA                            ║
+║    • Email:   kinglabsa@users.noreply.github.com                 ║
+╚═══════════════════════════════════════════════════════════════╝
+
+---
+
+**FableForge Agent** is a self-improving AI agent framework built on top of
+[Hermes Agent](https://github.com/NousResearch/hermes-agent) by NousResearch.
+It extends Hermes with three additional tiers of capability:
+
+- **Tier 3: Agent Control Plane** — Sandboxed execution, audit trails, incident
+  response, OAuth gate, and credential broker.
+- **Tier 4: Behavioral Observability** — Real-time behavior observation,
+  semantic firewall, safety rules engine, and behavior reporting.
+- **Tier 4: Trust Protocols** — Bidirectional agent-to-agent trust,
+  identity registry, permission framework, and cryptographic signing.
+
+## Quickstart
+
+```bash
+pip install fableforge-agent
+fableforge --help
+```
+
+Or run with specific subcommands:
+
+```bash
+fableforge                          # Run the agent (passes through to Hermes CLI)
+fableforge control-plane --port 8000  # Start the control plane API server
+fableforge audit --export report.json # Export audit trail
+fableforge trust register --agent-id agent1 --pubkey ./key.pub  # Trust registry
+fableforge observe                   # Start behavioral observability dashboard
+```
+
+## Architecture
+
+```
+┌─────────────────────────────────────────────────────┐
+│                   FableForge Agent                    │
+├─────────────────────────────────────────────────────┤
+│  Tier 4:  Behavioral Observability + Trust Protocols │
+│  ┌────────────────────┐  ┌────────────────────────┐  │
+│  │ BehavioralObservability│  │   TrustProtocol       │  │
+│  │ SemanticFirewall     │  │   IdentityRegistry    │  │
+│  │ BehaviorReport       │  │   PermissionFramework │  │
+│  └────────────────────┘  └────────────────────────┘  │
+├─────────────────────────────────────────────────────┤
+│  Tier 3:  Agent Control Plane                        │
+│  ┌────────────────────┐  ┌────────────────────────┐  │
+│  │ Sandbox (execution)│  │   AuditTrail           │  │
+│  │ IncidentResponse   │  │   OAuthGate            │  │
+│  │ CredentialBroker   │  │   SandboxPolicy        │  │
+│  └────────────────────┘  └────────────────────────┘  │
+├─────────────────────────────────────────────────────┤
+│  Tiers 1-2:  Hermes Agent Foundation                 │
+│  ┌──────────────────────────────────────────────┐   │
+│  │ AIAgent · ToolRegistry · ConversationLoop    │   │
+│  │ Model Providers · Tool Calling · Memory      │   │
+│  └──────────────────────────────────────────────┘   │
+└─────────────────────────────────────────────────────┘
+```
+
+## Foundation
+
+FableForge Agent is built on [Hermes Agent](https://github.com/NousResearch/hermes-agent)
+by NousResearch. All credit for the underlying agent framework, tool calling,
+conversation loop, and model provider integration belongs to the NousResearch team.
+
+## License
+
+Apache 2.0 — see LICENSE for details.

fableforge_agent-0.1.0.dist-info/RECORD

@@ -0,0 +1,14 @@
+fableforge_agent/__init__.py,sha256=FNvtLX3cs2P7cUznhR0G2DZXpS_oe6x24qGpp33AIvk,2015
+fableforge_agent/cli.py,sha256=vtUyUUv-b8bHIwHmFCTCcQBkBofn-BRrngOH8wOYfjQ,6782
+fableforge_agent/control_plane/__init__.py,sha256=i552bJFshRWnlIxLsC_ynRKEH0ptoRAabZFZz6dhx9Y,772
+fableforge_agent/control_plane/auth.py,sha256=2Wzdn1etY09KdM3z6w9t6Ks3j9RggdbnUW-pbwIav1c,6151
+fableforge_agent/control_plane/core.py,sha256=eO2fPNaEYN-xrli1LmppAkk6Wh_0dTGnbCfwQsM4wdc,12777
+fableforge_agent/observability/__init__.py,sha256=Q4q5Pfmp-U03S8xYydGmkFnnUCPTJ0BHtiTkmheG3OM,635
+fableforge_agent/observability/core.py,sha256=3CQGx_2iYeWG7ytWnJA4UydM62TBYjdkVQPvjlO0jIk,9981
+fableforge_agent/trust/__init__.py,sha256=qCtGn8g6S3tqrqhE9OQOdcybMfu2L2_JBtTbDd3mpiQ,562
+fableforge_agent/trust/core.py,sha256=L1jLLTs0aPCZFvvvFBUXnw3K6xUM7HrztYmd2OFMDm0,8226
+fableforge_agent-0.1.0.dist-info/METADATA,sha256=vXxOXbsCgfWkzRcVdZlbgpfXF1h-FonbGUXz8yvnrj0,7404
+fableforge_agent-0.1.0.dist-info/WHEEL,sha256=K260EYznzXsJYBQGqmI8VTxEdiZYNvDZwW9cBh9-_MA,91
+fableforge_agent-0.1.0.dist-info/entry_points.txt,sha256=qDkyM2XVx_mMn0Tf1G9ilg1CColeSzzWJgBLpiBwUIs,57
+fableforge_agent-0.1.0.dist-info/top_level.txt,sha256=I8YHfNCClzAy9mcEgKtVMKLS8VuMvYtGtt6dxuybnY0,17
+fableforge_agent-0.1.0.dist-info/RECORD,,

fableforge_agent-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (83.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

fableforge_agent-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+fableforge = fableforge_agent.cli:main

fableforge_agent-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+fableforge_agent