"use client"; import { useState } from "react"; import Link from "next/link"; function Icon({ name, className = "" }: { name: string; className?: string }) { return {name}; } // ─── Sidebar nav data ───────────────────────────────────────────────────────── const NAV = [ { group: "Introduction", items: [ { icon: "rocket_launch", label: "Getting Started", id: "getting-started", active: true }, { icon: "description", label: "Architecture", id: "architecture" }, ], }, { group: "Core Concepts", items: [ { icon: "person_search", label: "Agent Personas", id: "personas" }, { icon: "account_tree", label: "Mesh Topology", id: "topology" }, { icon: "memory", label: "Memory Systems", id: "memory" }, ], }, { group: "Development", items: [ { icon: "code", label: "API Reference", id: "api" }, { icon: "inventory_2", label: "SDKs & Tools", id: "sdks" }, { icon: "terminal", label: "CLI Tool", id: "cli" }, ], }, ]; // ─── Code block ─────────────────────────────────────────────────────────────── function CodeBlock({ filename, children }: { filename: string; children: React.ReactNode }) { const [copied, setCopied] = useState(false); return (
{filename}
{children}
); } // ─── Section wrapper ────────────────────────────────────────────────────────── function Section({ id, children }: { id: string; children: React.ReactNode }) { return
{children}
; } function SectionHeading({ title, badge }: { title: string; badge?: string }) { return (

{title}

{badge && ( {badge} )}
); } // ─── Main page ──────────────────────────────────────────────────────────────── export default function DocsPage() { return (
{/* ── Topbar ── */}

negoT8

Console
{/* ── Left sidebar ── */} {/* ── Main content ── */}
{/* Breadcrumb */} {/* ── Quick Start ── */}

Quick Start Guide

Deploy your first negoT8 negotiation in under five minutes. Two autonomous agents, one on-chain settlement.

{/* Step 1 */}

1 Install the SDK

${" "} pip install{" "} negot8
{/* Step 2 */}

2 Configure Your Instance

# Initialize negoT8
from negot8 import negoT8

mesh = negoT8{"({"}
api_key=os.environ["AM_KEY"],
region="us-east-mesh",
strategy="tit-for-tat"
{"}"}

# Connect to the protocol
await mesh.connect()
{/* Step 3 */}

3 Start a Negotiation

session = await mesh.negotiate{"({"}
feature="expenses",
agent_a="@alice",
agent_b="@bob",
limit=5000
{"}"}

# Settlement happens automatically
print(session.outcome) # AGREED: ...
{/* ── Architecture ── */}

negoT8 runs a bilateral negotiation protocol over a persistent WebSocket mesh. Each agent maintains a preference vector and personality profile. Rounds are logged immutably, and final settlement is recorded on Polygon POS.

{[ { icon: "person", label: "Personal Agents", desc: "Telegram-native, personality-driven" }, { icon: "sync_alt", label: "Negotiation Engine", desc: "Game-theoretic, multi-round" }, { icon: "link", label: "Blockchain Layer", desc: "Polygon POS — immutable record" }, ].map(({ icon, label, desc }) => (

{label}

{desc}

))}
{/* ── Agent Personas ── */}

Personas define the negotiation behaviour and cognitive boundaries of each agent. Assigning a persona controls how aggressively the agent bids, how empathetically it responds, and how analytically it evaluates proposals.

{[ { icon: "psychology", name: "Analytical", desc: "Pattern recognition, data-first decisions. Minimal emotional drift — best for financial negotiations." }, { icon: "terminal", name: "Aggressive", desc: "Opens high, concedes slow. Optimised for maximising individual outcome in competitive scenarios." }, { icon: "chat", name: "Empathetic", desc: "Human-centric, sentiment-aligned. Prioritises mutual satisfaction over raw gain." }, { icon: "balance", name: "Balanced", desc: "Default profile. Adapts strategy dynamically based on opponent behaviour and round history." }, { icon: "favorite", name: "People Pleaser", desc: "High concession rate, fast convergence. Ideal when relationship preservation matters most." }, { icon: "security", name: "Sentinel", desc: "Enforces fair-play policy. Flags anomalous proposals and prevents runaway concession spirals." }, ].map(({ icon, name, desc }) => (

{name}

{desc}

))}
{/* ── Mesh Topology ── */}

The negoT8 protocol supports 1:1 bilateral negotiations today, with n-party consensus rolling out in v2.1. Agents communicate over an encrypted Socket.IO channel. The backend orchestrator assigns feature handlers (expenses, scheduling, freelance, etc.) and routes messages to the correct agent pair.

Agent A → PROPOSE → Orchestrator → RELAY → Agent B
Agent B → COUNTER → Orchestrator → RELAY → Agent A
{'─'.repeat(52)}
CONSENSUSOrchestrator → SETTLE → Blockchain
{/* ── API Reference ── */}
{[ { path:"/negotiations", method:"POST", color:"text-emerald-400", desc:"Create a new negotiation session between two agents." }, { path:"/negotiations", method:"GET", color:"text-blue-400", desc:"List all negotiations with status and fairness score." }, { path:"/negotiations/:id", method:"GET", color:"text-blue-400", desc:"Fetch full detail, rounds, and analytics for a session." }, { path:"/negotiations/:id/start", method:"POST", color:"text-emerald-400", desc:"Kick off the negotiation loop between the two agents." }, { path:"/users", method:"POST", color:"text-emerald-400", desc:"Register a new Telegram user with a personality profile." }, { path:"/users/:id", method:"GET", color:"text-blue-400", desc:"Retrieve user profile and personality settings." }, { path:"/stats", method:"GET", color:"text-blue-400", desc:"Global platform metrics: resolved, active, fairness avg." }, ].map(({ path, method, color, desc }) => ( ))}
Endpoint Method Description
{path} {method} {desc}
{/* ── SDKs & Tools ── */}
{[ { icon:"smart_toy", name:"Python SDK", tag:"Official", desc:"pip install negot8" }, { icon:"send", name:"Telegram Bot", tag:"Built-in", desc:"@negoT8Bot on Telegram" }, { icon:"record_voice_over", name:"Voice API", tag:"ElevenLabs", desc:"AI-generated settlement summaries" }, ].map(({ icon, name, tag, desc }) => (

{name}

{tag}

{desc}

))}
{/* ── CLI ── */}

Run and inspect negotiations directly from your terminal.

$ negot8 negotiate --feature expenses --agent-a @alice --agent-b @bob

▶ Round 1 · Agent A proposes $54.20
▶ Round 2 · Agent B counters $58.00
▶ Round 3 · Convergence at 98.4%
✓ SETTLED · $56.10 · TX: 0x8fb…442b
{/* Footer */}
© 2026 negoT8 Protocol
Back to landing Open Dashboard
{/* ── Right TOC ── */}
); }