Vion Protocol AI Agent

VION Protocol

V1.3.0 adds optional session governance, action limits, authority expiry, and JSON session audit reports while preserving the existing V1 validation pipeline.

Constitutional governance runtime for autonomous AI agents.

VION Protocol governs AI agents with constitutional law — defined rules, verified identities, bounded permissions, autonomous enforcement, and a tamper-evident audit chain. Works with any agent framework.

---

The Problem

AI agents are being deployed into production with access to real systems — databases, APIs, financial services, private data. But the tools for governing them are inadequate:

• System prompts can be ignored or overridden
• No cryptographic identity — you cannot prove which agent did what
• No autonomous enforcement — humans must watch every action
• No tamper-evident audit trail

VION Protocol solves all three.

---

What It Does

Owner Command
      │
      ▼
┌─────────────────────────────────────────────┐
│           VION GOVERNANCE RUNTIME           │
│                                             │
│  ① Constitutional integrity check          │
│  ② AUTH token validation                   │
│  ③ Agent identity verification             │
│  ④ Peer-to-peer detection                  │
│  ⑤ Scope validation                        │
│  ⑥ Risk cap enforcement                    │
│  ⑦ Mode resolution (DRY_RUN / LIVE)        │
│                                             │
│  → Execution → N Auditor → Output          │
│                                             │
│  Hash-chained audit log  │  Telegram alerts │
└─────────────────────────────────────────────┘
      │
      ▼
Your Agent (LangChain / CrewAI / OpenAI / Custom)

Every task is governed. Every event is logged. Any violation triggers an autonomous response.

---

Install

pip install nvion-protocol

---

3-Line Integration

from nvion.adapters import FunctionAdapter
import os

governed = FunctionAdapter(fn=your_agent, agent_id="VION-RSC-001")
result = governed.run(os.getenv("VION_AUTH_TOKEN"), "your task", "LIVE")
if result.ran:
    print(result.output)

---

Quick Start

# 1. Install
pip install nvion-protocol

# 2. Configure
cp .env.example .env
# Set VION_AUTH_TOKEN in .env

# 3. Register your agent in constitution/IDENTITY.md

# 4. Run the demo
python examples/demo.py

→ See docs/getting-started.md for the full 10-minute guide.

---

The 6 HALT/ESCALATE Conditions

VION Protocol enforces six autonomous kill-switch conditions:

#	Condition	Response
1	Unauthorized command source	ESCALATE → HALT on 3rd
2	Scope violation	ESCALATE → HALT on 2nd
3	Peer-to-peer communication	ESCALATE → HALT on 2nd
4	Output audit failure (N Auditor)	ESCALATE → HALT on 3rd
5	Risk cap breach	ESCALATE → HALT at 2× cap
6	Constitutional integrity violation	HALT IMMEDIATELY

No human intervention required. The system enforces itself.

---

Architecture

┌─────────────────────────────────────────────────────────┐
│                  CONSTITUTIONAL LAYER                    │
│   VION.md (Supreme Law)    IDENTITY.md (Agent Registry) │
└──────────────────────────┬──────────────────────────────┘
                           │ parsed + hashed
                           ▼
┌─────────────────────────────────────────────────────────┐
│                  GOVERNANCE RUNTIME                      │
│  ConstitutionValidator → IdentityRegistry               │
│           ↓                                             │
│       Orchestrator (7-stage pipeline)                   │
│           ↓                                             │
│       HALT Engine  │  Risk Caps  │  Peer Detector       │
└──────────────────────────┬──────────────────────────────┘
                           │ approved
                           ▼
             ┌─────────────────────────┐
             │   Your Agent Executes   │
             └─────────┬───────────────┘
                       │ output
                       ▼
             ┌─────────────────────────┐
             │    N Auditor Gates      │
             │    Output (6 checks)    │
             └─────────┬───────────────┘
                       │ approved output
                       ▼
                   Delivered

→ Full diagrams in docs/architecture.md

---

Supported Agent Frameworks

Framework	Adapter	Example
LangChain	LangChainAdapter	examples/langchain_governed_agent.py
CrewAI	CrewAIAdapter	examples/crewai_governed_agent.py
OpenAI	OpenAIAdapter	examples/openai_governed_agent.py
Any Python agent	CustomAgentAdapter	QUICKSTART.md
Any Python function	FunctionAdapter	QUICKSTART.md
Custom framework	BaseAgentAdapter	docs/sdk-guide.md

---

Tamper-Evident Audit Log

Every event is SHA-256 hash-chained to the previous entry. Tampering is mathematically detectable.

from nvion.core.logger import ActivityLogger

logger = ActivityLogger("./logs/activity.log")
logger.verify_chain()  # Raises LogIntegrityError if any entry was modified

---

Documentation

Document	Description
QUICKSTART.md	5-minute setup guide
SPECIFICATION.md	Full protocol specification
ROADMAP.md	Version roadmap
docs/getting-started.md	10-minute developer guide
docs/developer-guide.md	Architecture and code reference
docs/api-reference.md	Full API documentation
docs/sdk-guide.md	Building custom adapters and extensions
docs/architecture.md	Architecture diagrams (Mermaid)
docs/faq.md	Frequently asked questions
CONTRIBUTING.md	How to contribute

---

Run the Demo

git clone https://github.com/nataw-1/Vion-Protocol
cd Vion-Protocol
pip install -r requirements.txt
cp .env.example .env
python examples/demo.py

Watch VION Protocol approve a valid task, block a financial transaction, block a delete operation, reject a wrong token — and verify the tamper-evident audit chain.

---

Constitutional Documents

• constitution/VION.md — The supreme law. Defines all rules, conditions, and authority hierarchy.
• constitution/IDENTITY.md — The agent registry. Every agent is registered here before it can act.

---

License

MIT — free to use, modify, and build on.

---

Reference Deployment

Built for and tested on Ahadu-Labs — AI + Web3 ecosystem by Nathan Daniel.

---

VION Protocol — constitutional law for AI agents.