# WattSwarm

## Docs

- [Diagnostics API — Event Log and Swarm Observability](https://mx-6c34bcc6.mintlify.app/api/diagnostics.md): Inspect network service diagnostics, read the structured event log head, replay or verify the SEL, and advance the swarm tick-by-tick.
- [Executor Registry API — Register and Manage Runtimes](https://mx-6c34bcc6.mintlify.app/api/executors.md): Register local and remote executor runtimes with the WattSwarm kernel, list the executor registry, and health-check individual executors by name.
- [Knowledge API — Export WattSwarm Decision Memory Bundles](https://mx-6c34bcc6.mintlify.app/api/knowledge.md): Export WattSwarm decision memory bundles containing finalized records, evidence references, and reuse metrics by task type or task ID.
- [Node API — Start, Stop, and Inspect the WattSwarm Kernel](https://mx-6c34bcc6.mintlify.app/api/node.md): HTTP endpoints for bringing the WattSwarm node up and down, querying live runtime status, and reading or saving the startup configuration.
- [WattSwarm Kernel HTTP API — Complete Reference Overview](https://mx-6c34bcc6.mintlify.app/api/overview.md): Complete reference for the WattSwarm kernel HTTP API — all endpoint groups, JSON response format conventions, and links to each API reference page.
- [Peers API — Discovery, Relationships, and Direct Messaging](https://mx-6c34bcc6.mintlify.app/api/peers.md): List known WattSwarm peers, manage relationship state transitions, and send or receive encrypted direct messages between nodes over the P2P overlay.
- [Runs API — Submit and Orchestrate Multi-Agent Runs](https://mx-6c34bcc6.mintlify.app/api/runs.md): Submit multi-agent RunSubmitSpec payloads, kick off queued execution, poll per-step progress, retrieve aggregated results, and export knowledge bundles.
- [POST /execute — Runtime Task Execution API Endpoint](https://mx-6c34bcc6.mintlify.app/api/runtime-execute.md): Full reference for the /execute endpoint your runtime implements: request fields, response shape, stage semantics, and a Rust handler example.
- [Runtime Executor API — The Interface Your Agent Implements](https://mx-6c34bcc6.mintlify.app/api/runtime-overview.md): Learn how WattSwarm calls your executor HTTP service to run tasks, collect candidates, and verify outputs across the swarm network.
- [POST /verify — Runtime Candidate Verification Endpoint](https://mx-6c34bcc6.mintlify.app/api/runtime-verify.md): Full reference for the /verify endpoint your runtime implements: request fields, built-in policies, response shape, and a Rust handler example.
- [Tasks API — Submit Task Contracts and Poll Decisions](https://mx-6c34bcc6.mintlify.app/api/tasks.md): Submit TaskContract JSON to the WattSwarm kernel, run full synchronous execution flows, poll task state, and retrieve finalized decisions.
- [Topic Messaging API — Publish and Read Feed Messages](https://mx-6c34bcc6.mintlify.app/api/topics.md): Read and publish JSON messages on scoped WattSwarm topic feeds, manage feed subscriptions for gossip routing, and track read cursors for feed pagination.
- [wattswarm executors — Register Runtime Executors](https://mx-6c34bcc6.mintlify.app/cli/executors.md): Reference for wattswarm executors add, list, and check: register HTTP runtime executors, inspect the registry, and verify connectivity.
- [wattswarm knowledge — Export Decision Memory Bundles](https://mx-6c34bcc6.mintlify.app/cli/knowledge.md): Reference for wattswarm knowledge export: export decision bundles by task type or task ID for inspection, reuse analysis, and offline review.
- [wattswarm node — Node Lifecycle and Network Commands](https://mx-6c34bcc6.mintlify.app/cli/node.md): Reference for all wattswarm node subcommands: bring nodes online, manage bootstrap contacts, sign network params, and update authority sets.
- [WattSwarm CLI Reference — Commands and Global Flags](https://mx-6c34bcc6.mintlify.app/cli/overview.md): A complete map of every WattSwarm CLI command group, global flags, and invocation patterns for operating your node from the terminal.
- [wattswarm run — Multi-Agent Run Queue CLI Commands](https://mx-6c34bcc6.mintlify.app/cli/run.md): Reference for all wattswarm run subcommands: initialize the PostgreSQL queue, submit run specs, control run state, and operate the worker process.
- [wattswarm task — Task Submission and Lifecycle Commands](https://mx-6c34bcc6.mintlify.app/cli/task.md): Reference for all wattswarm task subcommands: submit contracts, watch lifecycle state, fetch decisions, and run complete end-to-end flows.
- [WattSwarm Architecture: Kernel, Nodes, and Executors](https://mx-6c34bcc6.mintlify.app/concepts/architecture.md): Understand how WattSwarm's kernel, executor runtimes, PostgreSQL, and P2P network fit together to coordinate multi-agent task orchestration.
- [Knowledge Store: Decision Memory, Reuse, and Reputation](https://mx-6c34bcc6.mintlify.app/concepts/knowledge-and-memory.md): Learn how WattSwarm stores finalized decisions, reuses prior results through active knowledge lookup, and updates reputation from verifier feedback.
- [Nodes, Networks, and Orgs: WattSwarm P2P Topologies](https://mx-6c34bcc6.mintlify.app/concepts/nodes-and-networks.md): Learn how WattSwarm separates networks, orgs, and nodes, how node identity works, how scopes route events, and how nodes sync with each other.
- [Task Lifecycle: From Submission to Finalized Decision](https://mx-6c34bcc6.mintlify.app/concepts/task-lifecycle.md): Trace every stage a WattSwarm task moves through, from TASK_CREATED to DECISION_FINALIZED, including voting, evidence, and aggregation.
- [WattSwarm Environment Variables: Complete Reference](https://mx-6c34bcc6.mintlify.app/configuration/environment-variables.md): Complete reference for every environment variable controlling WattSwarm: database connections, P2P networking, worker tuning, and Docker port overrides.
- [WattSwarm Network Modes: Local, LAN, and WAN Setup](https://mx-6c34bcc6.mintlify.app/configuration/network-modes.md): Choose the right WattSwarm network mode: local for single-machine dev, lan for LAN peer discovery, or wan for internet-connected distributed swarms.
- [WattSwarm startup_config.json: Fields and Examples](https://mx-6c34bcc6.mintlify.app/configuration/startup-config.md): Learn how startup_config.json controls network mode, bootstrap contacts, gateway URLs, and the default executor runtime for a WattSwarm node.
- [WattSwarm with Docker Compose: PostgreSQL to Kernel](https://mx-6c34bcc6.mintlify.app/docker-quickstart.md): Spin up PostgreSQL, the WattSwarm kernel, reference runtime, and worker with hot reload using Docker Compose — no manual Rust setup required.
- [Build a Custom Agent Runtime for WattSwarm Executors](https://mx-6c34bcc6.mintlify.app/guides/building-a-runtime.md): Implement the four required HTTP endpoints to create a WattSwarm executor, register it with the kernel, and run tasks against it end-to-end.
- [Connect WattSwarm Nodes into a Shared P2P Network Grid](https://mx-6c34bcc6.mintlify.app/guides/connecting-nodes.md): Launch a multi-node WattSwarm network, export bootstrap contacts, join additional nodes, and route tasks across the shared peer graph.
- [Orchestrate Multi-Agent Runs Using the WattSwarm Run Queue](https://mx-6c34bcc6.mintlify.app/guides/multi-agent-runs.md): Use the WattSwarm run queue to coordinate multiple agents in parallel, aggregate their decisions, and retrieve a single final answer.
- [Run Your First WattSwarm Task End-to-End with the CLI](https://mx-6c34bcc6.mintlify.app/guides/running-your-first-task.md): Submit a task contract to WattSwarm, execute it through the real runtime flow, and retrieve the finalized decision — all from the CLI.
- [Publish and Subscribe to Topic Message Feeds in WattSwarm](https://mx-6c34bcc6.mintlify.app/guides/topic-messaging.md): Use WattSwarm's decentralized topic exchange to publish messages, subscribe nodes to feeds, and read paginated history across your agent network.
- [WattSwarm: Swarm Coordination Kernel for Agent Networks](https://mx-6c34bcc6.mintlify.app/introduction.md): WattSwarm is an open-source swarm coordination kernel for multi-agent task execution, verification, voting, and consensus across distributed node networks.
- [WattSwarm Quickstart: Build and Run Your First Swarm Task](https://mx-6c34bcc6.mintlify.app/quickstart.md): Submit your first task to WattSwarm in minutes: start the reference runtime, bring a node up, register an executor, and read a finalized decision.
- [WattSwarm Diagnostics: API, CLI, and Console Tools](https://mx-6c34bcc6.mintlify.app/troubleshooting/diagnostics.md): Use the WattSwarm diagnostics endpoint, CLI log commands, and the kernel console to inspect P2P status, event flow, backfill gaps, and executor health.
- [WattSwarm FAQ: Troubleshooting Common Operator Issues](https://mx-6c34bcc6.mintlify.app/troubleshooting/faq.md): Answers to common WattSwarm operator questions: stuck tasks, lease conflicts, executor failures, PostgreSQL connection errors, and P2P sync issues.