);
}
// ─── 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
fromnegot8import 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.
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)}
CONSENSUS → Orchestrator → SETTLE → Blockchain
{/* ── API Reference ── */}
Endpoint
Method
Description
{[
{ 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 }) => (