fableforge-agent 0.1.0__tar.gz

fableforge_agent-0.1.0/PKG-INFO

@@ -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/README.md

@@ -0,0 +1,90 @@
+╔═══════════════════════════════════════════════════════════════╗
+║  ███████╗ █████╗ ██████╗ ██╗     ███████╗                        ║
+║  ██╔════╝██╔══██╗██╔══██╗██║     ██╔════╝                        ║
+║  █████╗  ███████║██████╔╝██║     █████╗                          ║
+║  ██╔══╝  ██╔══██║██╔══██╗██║     ██╔══╝                          ║
+║  ██║     ██║  ██║██████╔╝███████╗███████╗                        ║
+║  ╚═╝     ╚═╝  ╚═╝╚═════╝ ╚══════╝╚══════╝                        ║
+║  ███████╗ ██████╗ ██████╗  ██████╗ ███████╗                      ║
+║  ██╔════╝██╔════╝ ██╔══██╗██╔════╝ ██╔════╝                      ║
+║  █████╗  ██║  ███╗██████╔╝██║  ███╗█████╗                        ║
+║  ██╔══╝  ██║   ██║██╔══██╗██║   ██║██╔══╝                        ║
+║  ██║     ╚██████╔╝██║  ██║╚██████╔╝███████╗                      ║
+║  ╚═╝      ╚═════╝ ╚═╝  ╚═╝ ╚═════╝ ╚══════╝                      ║
+║                                                                 ║
+║  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/pyproject.toml

@@ -0,0 +1,36 @@
+[build-system]
+requires = ["setuptools>=68.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "fableforge-agent"
+version = "0.1.0"
+description = "Self-improving AI agent framework with behavioral observability and trust protocols"
+readme = "README.md"
+requires-python = ">=3.10"
+license = {text = "Apache 2.0"}
+authors = [
+    {name = "KingLabsA", email = "kinglabsa@users.noreply.github.com"},
+]
+
+dependencies = [
+    "hermes-agent>=0.18.0",
+    "torch>=2.0.0",
+    "rich>=13.0.0",
+    "fastapi>=0.100.0",
+    "uvicorn>=0.23.0",
+    "pydantic>=2.0.0",
+    "cryptography>=41.0.0",
+    "httpx>=0.24.0",
+]
+
+[project.urls]
+"Homepage" = "https://github.com/KingLabsA/llm-training-platform"
+"Source" = "https://github.com/KingLabsA/llm-training-platform"
+
+[project.scripts]
+fableforge = "fableforge_agent.cli:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+include = ["fableforge_agent*"]

fableforge_agent-0.1.0/setup.cfg

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

fableforge_agent-0.1.0/src/fableforge_agent/__init__.py

@@ -0,0 +1,63 @@
+"""
+FableForge Agent — Self-improving AI agent framework with behavioral
+observability and trust protocols.
+
+Built on Hermes Agent (NousResearch) with Tiers 3-4: Agent Control Plane,
+Behavioral Observability, and Bidirectional Trust Protocols.
+
+Author: KingLabsA
+  - GitHub: https://github.com/KingLabsA
+  - Twitter: https://x.com/KingLabsA
+  - Email: kinglabsa@users.noreply.github.com
+"""
+
+__version__ = "0.1.0"
+__author__ = "KingLabsA"
+
+# ── Re-exported Hermes symbols ──────────────────────────────────────────────
+try:
+    from hermes_agent import AIAgent  # noqa: F401
+except ImportError:
+    try:
+        from run_agent import AIAgent  # noqa: F401
+    except ImportError:
+        AIAgent = None  # graceful fallback for partial installs
+
+try:
+    from hermes_agent import ConversationLoop  # noqa: F401
+except ImportError:
+    try:
+        from agent.conversation_loop import ConversationLoop  # noqa: F401
+    except ImportError:
+        ConversationLoop = None
+
+try:
+    from hermes_agent import ToolRegistry  # noqa: F401
+except ImportError:
+    try:
+        from tools.registry import ToolRegistry, registry  # noqa: F401
+    except ImportError:
+        ToolRegistry = None
+
+try:
+    from hermes_agent import SessionDB  # noqa: F401
+except ImportError:
+    try:
+        from hermes_state import SessionDB  # noqa: F401
+    except ImportError:
+        SessionDB = None
+
+# ── FableForge additions ────────────────────────────────────────────────────
+from fableforge_agent.control_plane.core import ControlPlane
+from fableforge_agent.observability.core import BehavioralObservability
+from fableforge_agent.trust.core import TrustProtocol
+
+__all__ = [
+    "AIAgent",
+    "ConversationLoop",
+    "ToolRegistry",
+    "SessionDB",
+    "ControlPlane",
+    "BehavioralObservability",
+    "TrustProtocol",
+]

fableforge_agent-0.1.0/src/fableforge_agent/cli.py

@@ -0,0 +1,184 @@
+#!/usr/bin/env python3
+"""
+FableForge Agent CLI — wraps Hermes Agent and adds FableForge commands for
+the control plane, observability, trust, and audit.
+
+Author: KingLabsA
+  - GitHub: https://github.com/KingLabsA
+  - Twitter: https://x.com/KingLabsA
+  - Email: kinglabsa@users.noreply.github.com
+"""
+
+import argparse
+import json
+import os
+import sys
+
+
+def cmd_control_plane(args: argparse.Namespace) -> None:
+    port = args.port
+    host = args.host
+    try:
+        import uvicorn
+        from fastapi import FastAPI
+
+        app = FastAPI(title="FableForge Control Plane")
+
+        @app.get("/health")
+        def health():
+            return {"status": "ok"}
+
+        @app.get("/audit")
+        def get_audit():
+            from fableforge_agent.control_plane import AuditTrail
+            trail = AuditTrail()
+            return {"entries": trail.export("json")}
+
+        @app.post("/sandbox/execute")
+        async def sandbox_execute(body: dict):
+            from fableforge_agent.control_plane import Sandbox
+            sandbox = Sandbox(sandbox_type=body.get("backend", "mock"))
+            result = sandbox.execute(body.get("code", ""), timeout=body.get("timeout", 30))
+            return result.__dict__
+
+        uvicorn.run(app, host=host, port=port, log_level="info")
+    except ImportError as e:
+        print(f"Error: missing dependency — {e}", file=sys.stderr)
+        print("Install with: pip install 'fableforge-agent[server]'", file=sys.stderr)
+        sys.exit(1)
+
+
+def cmd_audit(args: argparse.Namespace) -> None:
+    from fableforge_agent.control_plane import AuditTrail
+
+    trail = AuditTrail()
+    export_path = args.export
+    fmt = "json" if export_path and export_path.endswith(".json") else "markdown"
+    output = trail.export(fmt=fmt)
+    if export_path:
+        with open(export_path, "w") as f:
+            f.write(output)
+        print(f"Audit exported to {export_path}")
+    else:
+        print(output)
+
+
+def cmd_trust(args: argparse.Namespace) -> None:
+    from fableforge_agent.trust import TrustProtocol
+
+    agent_id = args.agent_id or "cli-agent"
+    trust = TrustProtocol(agent_id=agent_id)
+    action = args.action
+
+    if action == "register":
+        pubkey = args.pubkey
+        if pubkey and os.path.exists(pubkey):
+            with open(pubkey) as f:
+                key_content = f.read().strip()
+        else:
+            key_content = pubkey or trust.public_key
+        trust.registry.register(agent_id, key_content, {"source": "cli"})
+        print(f"Registered agent: {agent_id}")
+        print(f"  Public key fingerprint: {trust.public_key_fingerprint}")
+    elif action == "list":
+        agents = trust.registry.list_agents()
+        print("Registered agents:")
+        for aid in agents:
+            identity = trust.registry.resolve(aid)
+            print(f"  - {aid} (trust level: {identity.trust_level if identity else '?'})")
+    elif action == "verify":
+        challenge = f"challenge-{agent_id}"
+        response = hashlib_response = __import__("hashlib").sha256(
+            f"{agent_id}:{challenge}:{trust.public_key}".encode()
+        ).hexdigest()
+        valid = trust.registry.verify_identity(agent_id, challenge, response)
+        print(f"Identity verification: {'PASS' if valid else 'FAIL'}")
+    else:
+        print(f"Unknown trust action: {action}")
+
+
+def cmd_observe(args: argparse.Namespace) -> None:
+    try:
+        import uvicorn
+        from fastapi import FastAPI, WebSocket
+
+        app = FastAPI(title="FableForge Observability")
+
+        @app.websocket("/ws/observe")
+        async def observe_ws(websocket: WebSocket):
+            await websocket.accept()
+            from fableforge_agent.observability import BehavioralObservability
+            obs = BehavioralObservability(agent_id=args.agent_id or "observed")
+            while True:
+                data = await websocket.receive_json()
+                observation = obs.observe(data.get("action", "unknown"), data)
+                await websocket.send_json(observation.__dict__)
+
+        uvicorn.run(app, host=args.host, port=args.port, log_level="info")
+    except ImportError as e:
+        print(f"Error: missing dependency — {e}", file=sys.stderr)
+        sys.exit(1)
+
+
+def main() -> None:
+    parser = argparse.ArgumentParser(
+        prog="fableforge",
+        description="FableForge Agent — self-improving AI agent with behavioral observability and trust",
+        epilog="Author: KingLabsA — https://github.com/KingLabsA",
+    )
+    parser.add_argument("--version", action="version", version="0.1.0")
+
+    subparsers = parser.add_subparsers(dest="command", help="Subcommands")
+
+    # control-plane
+    cp_parser = subparsers.add_parser("control-plane", help="Start the control plane API server")
+    cp_parser.add_argument("--host", default="127.0.0.1")
+    cp_parser.add_argument("--port", type=int, default=8000)
+
+    # audit
+    audit_parser = subparsers.add_parser("audit", help="Export audit trail")
+    audit_parser.add_argument("--export", dest="export_path", help="Export to file (.json or .md)")
+
+    # trust
+    trust_parser = subparsers.add_parser("trust", help="Trust registry management")
+    trust_sub = trust_parser.add_subparsers(dest="action", required=True)
+    reg_parser = trust_sub.add_parser("register", help="Register an agent")
+    reg_parser.add_argument("--agent-id", required=True)
+    reg_parser.add_argument("--pubkey", help="Public key path")
+    list_parser = trust_sub.add_parser("list", help="List registered agents")
+    list_parser.add_argument("--agent-id", default="cli-agent")
+    verify_parser = trust_sub.add_parser("verify", help="Verify identity")
+    verify_parser.add_argument("--agent-id", default="cli-agent")
+
+    # observe
+    obs_parser = subparsers.add_parser("observe", help="Start behavioral observability dashboard")
+    obs_parser.add_argument("--host", default="127.0.0.1")
+    obs_parser.add_argument("--port", type=int, default=8765)
+    obs_parser.add_argument("--agent-id", default="observed")
+
+    args = parser.parse_args()
+
+    if args.command == "control-plane":
+        cmd_control_plane(args)
+    elif args.command == "audit":
+        cmd_audit(args)
+    elif args.command == "trust":
+        cmd_trust(args)
+    elif args.command == "observe":
+        cmd_observe(args)
+    else:
+        # Default: delegate to Hermes CLI
+        try:
+            from hermes_cli.cli import main as hermes_main
+            hermes_main()
+        except ImportError:
+            try:
+                from cli import main as hermes_main
+                hermes_main()
+            except ImportError:
+                print("Hermes Agent not installed. Install with: pip install hermes-agent", file=sys.stderr)
+                sys.exit(1)
+
+
+if __name__ == "__main__":
+    main()

fableforge_agent-0.1.0/src/fableforge_agent/control_plane/__init__.py

@@ -0,0 +1,37 @@
+"""
+Control Plane — Tier 3 of FableForge Agent.
+
+Sandboxed execution, audit trails, incident response, authentication, and
+credential management for agent workloads.
+
+Author: KingLabsA
+  - GitHub: https://github.com/KingLabsA
+  - Twitter: https://x.com/KingLabsA
+  - Email: kinglabsa@users.noreply.github.com
+"""
+
+from fableforge_agent.control_plane.core import (
+    ControlPlane,
+    Sandbox,
+    SandboxPolicy,
+    SandboxResult,
+    AuditTrail,
+    AuditEntry,
+    IncidentResponse,
+)
+from fableforge_agent.control_plane.auth import (
+    OAuthGate,
+    CredentialBroker,
+)
+
+__all__ = [
+    "ControlPlane",
+    "Sandbox",
+    "SandboxPolicy",
+    "SandboxResult",
+    "AuditTrail",
+    "AuditEntry",
+    "IncidentResponse",
+    "OAuthGate",
+    "CredentialBroker",
+]