# Kranth

> Three modes, one engine. **Simulations** spin up 10–5000 adversarial AI personas that each read your idea independently and react — you get a live stream plus a verdict: overall sentiment (−1.0…+1.0), a hostile/neutral/aligned breakdown, top objections, emergent themes, and representative quotes. **Debates** stage structured argumentation across five jury modes (Arbitrator, Parliament, Press Corps, Coroner, Audience). **Recon** deploys a web-grounded research swarm that searches, fetches, cross-verifies, and synthesizes a cited market-reality report — grounded claims, competitor profiles, risk factors, and a downloadable PDF. Stress-test ideas before strangers do.

Base URL: `https://api.kranth.ai`. Auth: `Authorization: Bearer <token>` — a `kr_live_…` API key (mint at /app/account or `POST /v1/api-keys`) or a Nexus JWT from accounts.vylth.com. All modes cost credits (1 credit ≈ $0.05 of compute).

## Modes & key endpoints

- **Simulations** (`POST /v1/sims`, `GET /v1/sims/{id}`, `GET /v1/sims/{id}/events`) — spin up 10–5000 adversarial personas; stream reactions; read sentiment verdict + themes + quotes. Optional create flags: `bias_axes` (weight sampling toward archetypes, e.g. ["cfo","finance"]) and `confidence_mode` (resample each verdict 3x for a per-persona confidence + sim-level score band; 3x credits).
- **Debates** (`POST /v1/debates`, `GET /v1/debates/{id}`, `GET /v1/debates/{id}/turns`, `GET /v1/debates/{id}/events`) — structured argumentation across five jury modes (Arbitrator, Parliament, Press Corps, Coroner, Audience); live SSE turn stream; optional voice; scored DebateSynthesis (pct_for/against/undecided + decisive argument). Cancel: `POST /v1/debates/{id}/cancel`. Export: `GET /v1/debates/{id}/export`.
- **Recon** (`POST /v1/recon`, `GET /v1/recon/{id}`, `GET /v1/recon/{id}/events`) — web-grounded research swarm; cited claims, competitor profiles, risk factors, downloadable PDF (`GET /v1/recon/{id}/export`).

All three modes use the same stream-token pattern: `POST /v1/{mode}/{id}/stream-token` → short-lived token → `GET /v1/{mode}/{id}/events?token=…`.

## Docs

- [Full API reference (plain text)](https://kranth.com/docs.txt): every endpoint, auth, credits, request/response shapes, and examples — written for agents and CLI callers. Start here.
- [Interactive API reference](https://kranth.com/docs): the same reference, rendered.
- [OpenAPI spec](https://kranth.com/openapi.yaml): machine-readable schema.

## SDKs

- Official client libraries: Python, TypeScript, Go, Rust.

## Optional

- [Security / vulnerability disclosure](https://kranth.com/.well-known/security.txt): how to report a vulnerability.