kanoniv-agent-auth 0.3.0

Sudo for AI agents - cryptographic delegation, Ed25519 identity, and signed audit trails
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65

"""
Agent Trust Quickstart - Zero dependencies, zero infra.

pip install kanoniv-trust
python quickstart.py
"""
from agent_trust import TrustAgent

# Create a trust orchestrator (SQLite, in-memory for this demo)
trust = TrustAgent(db_path=":memory:")
print(f"TrustAgent DID: {trust.did}\n")

# --- Register agents with verified identity (Ed25519 DIDs) ---
researcher = trust.register("researcher", capabilities=["search", "analyze"])
writer = trust.register("writer", capabilities=["draft", "edit"])
print(f"Researcher: {researcher.did}")
print(f"Writer:     {writer.did}\n")

# --- Grant scoped delegation ---
trust.delegate("researcher", scopes=["search", "analyze"])
trust.delegate("writer", scopes=["draft", "edit"])
print("Delegations granted.\n")

# --- Simulate work: researcher is reliable, writer struggles ---
outcomes = [
    ("researcher", "search",  "success", 0.9),
    ("researcher", "search",  "success", 0.8),
    ("researcher", "analyze", "success", 0.7),
    ("writer",     "draft",   "failure", 0.1),
    ("writer",     "draft",   "success", 0.6),
    ("writer",     "edit",    "failure", 0.2),
]

for agent, action, result, reward in outcomes:
    trust.observe(agent, action=action, result=result, reward=reward)

print("Recorded 6 outcomes with signed provenance.\n")

# --- Check reputation ---
for name in ["researcher", "writer"]:
    rep = trust.reputation(name)
    print(f"{name}:")
    print(f"  Score:        {rep.score:.0f}/100")
    print(f"  Success rate: {rep.success_rate:.0%}")
    print(f"  Avg reward:   {rep.avg_reward:.2f}")
    print(f"  Trend:        {rep.trend}")
    print(f"  Strengths:    {rep.top_strengths}")
    print(f"  Weaknesses:   {rep.top_weaknesses}")
    print()

# --- Trust-based selection (UCB) ---
best = trust.select(["researcher", "writer"], strategy="ucb")
print(f"UCB selected: {best}")

ranking = trust.rank(["researcher", "writer"])
print(f"Full ranking: {ranking}\n")

# --- Enforce: restrict the underperformer ---
trust.restrict("writer", scopes=["edit"])
print("Writer restricted to [edit] only - no more drafting.\n")

# --- Revoke entirely if needed ---
trust.revoke("writer")
print("Writer delegation revoked entirely.")
print("\nDone. Every action above was signed with Ed25519 and anchored to a DID.")