# Bindu

## Docs

- [Get the agent card](https://docs.getbindu.com/api-reference/agent-discovery/get-the-agent-card.md): The A2A standard discovery document. Any client that knows the agent's base URL can `GET` this to learn the agent's DID, capabilities, published skills, and where to send requests.
- [Root redirect to agent card](https://docs.getbindu.com/api-reference/agent-discovery/root-redirect-to-agent-card.md): A convenience: `GET /` returns `302 Found` pointing at the agent card. Useful for humans browsing to the agent's base URL — they end up at something meaningful instead of a 404.
- [Resolve a DID (via JSON body)](https://docs.getbindu.com/api-reference/did-resolution/resolve-a-did-via-json-body.md): Alternate form for clients that prefer POST (keeps the DID out of URL logs). Returns the same document `GET` would.
- [Liveness + readiness probe](https://docs.getbindu.com/api-reference/health-&-monitoring/liveness-+-readiness-probe.md): Returns 200 when healthy, 503 when any mandatory dependency (storage, scheduler, message bus, grpc) is degraded. The body carries per-component status so orchestrators can show which specific thing is broken.
- [Prometheus metrics (text exposition)](https://docs.getbindu.com/api-reference/health-&-monitoring/prometheus-metrics-text-exposition.md): Standard Prometheus text format. Key series include:
- [Liveness and basic configuration probe.](https://docs.getbindu.com/api-reference/health/liveness-and-basic-configuration-probe.md): Unauthenticated, cheap, returns immediately. Does NOT verify downstream connectivity (Supabase, OpenRouter, Hydra) — it only reports whether the gateway process has booted with the expected config. Use this for container liveness checks; for readiness probes that include downstream health, build a h…
- [The gateway's self-published DID document.](https://docs.getbindu.com/api-reference/identity/the-gateways-self-published-did-document.md): Returns a W3C DID Core v1-compatible document with the gateway's Ed25519 public key under `authentication[]`. A2A peers that accept `did_signed` requests fetch this to verify the gateway's outbound signatures.
- [JSON-RPC 2.0 endpoint (all agent operations dispatch here)](https://docs.getbindu.com/api-reference/json-rpc/json-rpc-20-endpoint-all-agent-operations-dispatch-here.md): Every write or read operation on tasks, messages, and contexts uses this endpoint. The `method` field in the body selects the operation. See the *Error catalog* in the top-level description for every possible `error.code`.
- [Ask whether this agent can handle a task](https://docs.getbindu.com/api-reference/negotiation/ask-whether-this-agent-can-handle-a-task.md): Orchestrators use this to pick the best agent for a task before sending a real `message/send`. The agent returns a capability score (0–1) weighted across skill match, I/O compatibility, performance, load, and cost.
- [Browser-facing payment capture page (HTML)](https://docs.getbindu.com/api-reference/payment-x402/browser-facing-payment-capture-page-html.md): HTML page users browse to in order to complete payment via a browser wallet. Not a machine-callable endpoint — clients that want programmatic payment should use the x402 flow directly.
- [Poll (or long-poll) a payment session](https://docs.getbindu.com/api-reference/payment-x402/poll-or-long-poll-a-payment-session.md)
- [Start an x402 payment session](https://docs.getbindu.com/api-reference/payment-x402/start-an-x402-payment-session.md): Initiates a payment session for agents that charge per request. Returns a session handle the caller uses with `message/send` (via the `X-PAYMENT` header or session-linked metadata) until the session is spent or expired.
- [Open a plan; stream SSE of the orchestration.](https://docs.getbindu.com/api-reference/plan/open-a-plan;-stream-sse-of-the-orchestration.md): Accepts a user question + agent catalog, starts (or resumes) a session, and streams Server-Sent Events as the planner runs.
- [Get details for one skill](https://docs.getbindu.com/api-reference/skills/get-details-for-one-skill.md)
- [Get skill documentation (Markdown)](https://docs.getbindu.com/api-reference/skills/get-skill-documentation-markdown.md): The authoritative user-facing doc for this skill. Returns the frontmatter-ed Markdown file the agent shipped. Use this instead of the short `description` when you need full usage guidance, examples, or input schemas.
- [List all skills this agent publishes](https://docs.getbindu.com/api-reference/skills/list-all-skills-this-agent-publishes.md)
- [API Introduction](https://docs.getbindu.com/api/introduction.md): Complete HTTP API reference for Bindu agents
- [Architecture: How Bindu Works](https://docs.getbindu.com/bindu/concepts/architecture.md): The layered architecture that powers Bindu task execution, protocol handling, storage, observability, and scale
- [Protocol Types](https://docs.getbindu.com/bindu/concepts/protocol.md)
- [Task-First Pattern & Architecture](https://docs.getbindu.com/bindu/concepts/task-first-and-architecture.md): Why Bindu treats tasks as the core execution unit and the layered architecture that powers it
- [Task-First Agent Pattern](https://docs.getbindu.com/bindu/concepts/task-first-pattern.md): Why Bindu treats tasks as the core execution unit for interactive and multi-agent workflows
- [Configuration](https://docs.getbindu.com/bindu/create-bindu-agent/configuration.md)
- [Deploy Your Agent](https://docs.getbindu.com/bindu/create-bindu-agent/deploy.md)
- [Overview](https://docs.getbindu.com/bindu/create-bindu-agent/overview.md)
- [Identity & Signed Calls](https://docs.getbindu.com/bindu/gateway/identity.md): Give the gateway a DID - every outbound call gets a cryptographic signature that agents can verify.
- [Adding a Second Agent](https://docs.getbindu.com/bindu/gateway/multi-agent.md): Three agents working on one question - the planner decides the order and passes results between them.
- [The Bindu Gateway](https://docs.getbindu.com/bindu/gateway/overview.md): An end to end story - planner, recipes, DID signing, all wired together.
- [Going to Production](https://docs.getbindu.com/bindu/gateway/production.md): What to read, what to try, what to pin down before you ship.
- [Quickstart](https://docs.getbindu.com/bindu/gateway/quickstart.md): Seven steps - one question, one agent, one streaming response.
- [Recipes - Teaching Patterns](https://docs.getbindu.com/bindu/gateway/recipes.md): Write a playbook once in plain markdown. The planner lazy-loads it when it recognizes a match.
- [Agent Implementation](https://docs.getbindu.com/bindu/grpc/agent-client.md): Handler patterns, state transitions, configuration, and how the bridge works under the hood
- [API Reference](https://docs.getbindu.com/bindu/grpc/api-reference.md): Complete gRPC contract between SDKs and the Bindu core
- [Custom SDKs](https://docs.getbindu.com/bindu/grpc/custom-sdks.md): How to build Bindu SDKs for Rust, Go, Swift, or any language with gRPC
- [gRPC Overview](https://docs.getbindu.com/bindu/grpc/overview.md): Why the gRPC sidecar exists, how the architecture works, and where the current limits are
- [gRPC Quickstart](https://docs.getbindu.com/bindu/grpc/quickstart.md): The fastest path to your first working gRPC agent
- [Install & Setup](https://docs.getbindu.com/bindu/how-to/install.md): Install Bindu with uv or pip and set up a local development environment
- [Complete Bindu Guide](https://docs.getbindu.com/bindu/introduction/bindu-consolidated-guide.md): Comprehensive guide to getting started with Bindu - from concepts to installation
- [Community](https://docs.getbindu.com/bindu/introduction/getting-help.md)
- [Join the Internet of Agents](https://docs.getbindu.com/bindu/introduction/join-the-internet-agents.md): Get a production-ready Bindu agent running in minutes with the cookiecutter template or bindufy()
- [Built for the Internet of Agents](https://docs.getbindu.com/bindu/introduction/key-concepts.md): The core ideas behind Bindu's protocol-native, task-first agent architecture
- [What is Bindu](https://docs.getbindu.com/bindu/introduction/what-is-bindu.md)
- [Authentication](https://docs.getbindu.com/bindu/learn/authentication/overview.md): How your agent decides whether to answer a stranger knocking on the door
- [Decentralized Identifiers (DIDs)](https://docs.getbindu.com/bindu/learn/did/overview.md): How agents prove they're really them — without trusting Big Tech
- [Health Check & Metrics](https://docs.getbindu.com/bindu/learn/health-metrics/overview.md): Monitor agent health and performance
- [Agent Negotiation](https://docs.getbindu.com/bindu/learn/negotiation/overview.md): Capability-based agent selection for intelligent orchestration
- [Long-Running Task Notification System](https://docs.getbindu.com/bindu/learn/notification/overview.md): Real-time webhook notifications for long-running tasks in Bindu
- [Observability & Monitoring](https://docs.getbindu.com/bindu/learn/observability/overview.md): Monitor and debug agents with OpenTelemetry and Sentry
- [Payment Integration (X402)](https://docs.getbindu.com/bindu/learn/payment/introduction.md): Monetize AI agents with verifiable, on-chain payments
- [Overview](https://docs.getbindu.com/bindu/learn/retry/overview.md)
- [Scheduler](https://docs.getbindu.com/bindu/learn/scheduler/overview.md): Queue and distribute tasks across agent workers
- [Storage](https://docs.getbindu.com/bindu/learn/storage/overview.md): Persist tasks, context, and artifacts across agent sessions
- [Tunneling](https://docs.getbindu.com/bindu/learn/tunneling/overview.md): Expose your local Bindu agent to the internet during development and testing
- [Skills](https://docs.getbindu.com/bindu/skills/introduction/overview.md): Define what your agent can do and make it discoverable across the Internet of Agents
- [v2026.12.5](https://docs.getbindu.com/changelog/v2026.12.5.md): A new document-reading agent, many-currency payments, and a pile of reliability fixes
- [v2026.3.3](https://docs.getbindu.com/changelog/v2026.3.3.md): Give each agent its own private room in the database
- [v2026.3.5](https://docs.getbindu.com/changelog/v2026.3.5.md): See how your agent is doing, live
- [v2026.6.6](https://docs.getbindu.com/changelog/v2026.6.6.md): One login system, done properly
- [v2026.7.3](https://docs.getbindu.com/changelog/v2026.7.3.md): Moving the UI out of the server
- [v2026.8.5](https://docs.getbindu.com/changelog/v2026.8.5.md): Less code, same agent
- [v2026.8.7](https://docs.getbindu.com/changelog/v2026.8.7.md): Bug fixes, updated packages, and three new example agents
- [v2026.9.4](https://docs.getbindu.com/changelog/v2026.9.4.md): Your agent keeps its identity, even after a restart
- [3.3 AG2 Research Team](https://docs.getbindu.com/examples/advanced/ag2-research-team.md)
- [3.1 Agent Swarm](https://docs.getbindu.com/examples/advanced/agent-swarm.md)
- [3.2 CBT Therapy Protocol](https://docs.getbindu.com/examples/advanced/cbt-therapy.md)
- [3.10 Hermes Agent](https://docs.getbindu.com/examples/advanced/hermes-agent.md)
- [3.4 Kotlin OpenAI Agent](https://docs.getbindu.com/examples/advanced/kotlin-openai-agent.md)
- [3.5 LangGraph Blog Writing Agent](https://docs.getbindu.com/examples/advanced/langgraph-blog-writing-agent.md)
- [3.9 Multilingual Collaborative Agent v2](https://docs.getbindu.com/examples/advanced/multilingual-collab-agent-v2.md)
- [3.8 Quiz Generator Agent](https://docs.getbindu.com/examples/advanced/quiz-generator-agent.md)
- [3.6 TypeScript LangChain Agent](https://docs.getbindu.com/examples/advanced/typescript-langchain-agent.md)
- [3.7 TypeScript OpenAI Agent](https://docs.getbindu.com/examples/advanced/typescript-openai-agent.md)
- [1.7 Question Answering Agent](https://docs.getbindu.com/examples/beginner/ag2-agent.md)
- [1.9 DSPy Question Answering Agent](https://docs.getbindu.com/examples/beginner/dspy-agent.md)
- [1.1 Echo Agent](https://docs.getbindu.com/examples/beginner/echo-agent.md)
- [1.5 FAQ Agent](https://docs.getbindu.com/examples/beginner/faq-agent.md)
- [1.3 Joke Generator](https://docs.getbindu.com/examples/beginner/joke-generator.md)
- [1.11 MiniMax Research Agent](https://docs.getbindu.com/examples/beginner/minimax-research-agent.md)
- [1.10 Motivational Agent](https://docs.getbindu.com/examples/beginner/motivational-agent.md)
- [1.6 Notion Agent](https://docs.getbindu.com/examples/beginner/notion-agent.md)
- [1.8 Premium Research Assistant](https://docs.getbindu.com/examples/beginner/premium-research-assistant.md)
- [1.4 Research Assistant](https://docs.getbindu.com/examples/beginner/research-assistant.md)
- [1.2 Zero Config Agent](https://docs.getbindu.com/examples/beginner/zero-config-agent.md)
- [2.4 AI Data Analysis Agent](https://docs.getbindu.com/examples/specialized/ai-data-analysis-agent.md)
- [2.5 Cybersecurity Newsletter Editor](https://docs.getbindu.com/examples/specialized/cybersecurity-newsletter-editor.md)
- [2.6 Document Analyzer](https://docs.getbindu.com/examples/specialized/document-analyzer.md)
- [2.10 Medical Research Agent](https://docs.getbindu.com/examples/specialized/medical-research-agent.md)
- [2.7 News Summarizer](https://docs.getbindu.com/examples/specialized/news-summarizer.md)
- [2.11 PDF Research Agent](https://docs.getbindu.com/examples/specialized/pdf-research-agent.md)
- [2.3 Premium Advisor](https://docs.getbindu.com/examples/specialized/premium-advisor.md)
- [2.8 Speech-to-Text Agent](https://docs.getbindu.com/examples/specialized/speech-to-text-agent.md)
- [2.1 Text Summarizer](https://docs.getbindu.com/examples/specialized/text-summarizer.md)
- [2.2 Weather Research](https://docs.getbindu.com/examples/specialized/weather-research.md)
- [2.9 Web Scraping AI Agent](https://docs.getbindu.com/examples/specialized/web-scraping-agent.md)
- [Frequently Asked Questions](https://docs.getbindu.com/faq/introduction/overview.md): Answers to common questions about Bindu, setup, architecture, and troubleshooting
- [Gateway API](https://docs.getbindu.com/gateway-api/introduction.md): The external HTTP surface of the Bindu Gateway — one endpoint, streaming SSE, many agents behind it.
- [Welcome to Bindu](https://docs.getbindu.com/index.md): The open-source trust and transaction layer for the autonomous web.
- [Roadmap](https://docs.getbindu.com/roadmap/introduction/overview.md)
- [Low](https://docs.getbindu.com/roadmap/known-issues/core/low.md): One small Core issue — artifact name sanitization
- [Medium](https://docs.getbindu.com/roadmap/known-issues/core/medium.md): Seven more Core bugs — auth edges, CORS, and a concurrency race
- [High](https://docs.getbindu.com/roadmap/known-issues/core/overview.md): Four real problems in the Python runtime — all about money
- [Low](https://docs.getbindu.com/roadmap/known-issues/gateway/low.md): Sixteen smaller gateway issues — mostly 'good to know'
- [Medium](https://docs.getbindu.com/roadmap/known-issues/gateway/medium.md): Thirteen gateway bugs worth skimming before you deploy
- [Nits](https://docs.getbindu.com/roadmap/known-issues/gateway/nits.md): Small stuff that bugs the careful reader
- [High](https://docs.getbindu.com/roadmap/known-issues/gateway/overview.md): Two gateway bugs you'll actually hit. Let's talk about them.
- [Overview](https://docs.getbindu.com/roadmap/known-issues/overview.md): A quiet, honest tour of where Bindu isn't great yet
- [DID resolution endpoint bypassed the camelCase wire contract](https://docs.getbindu.com/roadmap/known-issues/postmortems/core/did-document-endpoint-raw-dict.md): A fixed bug worth remembering.
- [DID signature middleware fails open when signature headers or public key are missing](https://docs.getbindu.com/roadmap/known-issues/postmortems/core/did-signature-fail-open.md): A bug that shipped serious. Here's what happened and what we changed.
- [verify_signature caught every exception and made real bugs look like bad signatures](https://docs.getbindu.com/roadmap/known-issues/postmortems/core/did-signature-overbroad-exceptions.md): A fixed bug worth remembering.
- [Any authenticated caller could read or mutate another caller's tasks and contexts](https://docs.getbindu.com/roadmap/known-issues/postmortems/core/idor-task-ownership.md): A bug that shipped serious. Here's what happened and what we changed.
- [Server rejected snake_case input even though Python types used snake_case attributes](https://docs.getbindu.com/roadmap/known-issues/postmortems/core/types-populate-by-name.md): A medium-severity bug we fixed. Here's the story.
- [Concurrent /plan requests on same session ran compaction twice, racing on the summary](https://docs.getbindu.com/roadmap/known-issues/postmortems/gateway/compaction-concurrent-races.md): A high-severity bug we fixed. Here's what happened and what we changed.
- [Session compaction overwrote prior summary, progressively losing facts](https://docs.getbindu.com/roadmap/known-issues/postmortems/gateway/compaction-lossy-second-pass.md): A bug that shipped serious. Here's what happened and what we changed.
- [Compaction split landed mid-turn, breaking tool_use/tool_result pairing](https://docs.getbindu.com/roadmap/known-issues/postmortems/gateway/compaction-mid-turn-cut.md): A bug that shipped serious. Here's what happened and what we changed.
- [A stuck peer could stall a /plan for five minutes per tool call](https://docs.getbindu.com/roadmap/known-issues/postmortems/gateway/poll-budget-unbounded-wall-clock.md): No wall-clock ceiling, no abort propagation — one hung peer held entire plans hostage.
- [SSE reader fibers never terminated, leaking PubSub subscribers per request](https://docs.getbindu.com/roadmap/known-issues/postmortems/gateway/spawnreader-fiber-leak.md): A bug that shipped serious. Here's what happened and what we changed.
- [SSE events leaked across concurrent /plan requests](https://docs.getbindu.com/roadmap/known-issues/postmortems/gateway/sse-cross-contamination.md): A bug that shipped serious. Here's what happened and what we changed.
- [Bearer token comparison was timing-unsafe, recoverable byte-by-byte](https://docs.getbindu.com/roadmap/known-issues/postmortems/gateway/timing-unsafe-token-compare.md): A high-severity bug we fixed. Here's what happened and what we changed.
- [Overview](https://docs.getbindu.com/roadmap/known-issues/postmortems/overview.md): The archive of fixed bugs worth remembering
- [Getting AI Agents to Work Together](https://docs.getbindu.com/sapthame/introduction/overview.md)

## OpenAPI Specs

- [gateway-openapi](https://docs.getbindu.com/gateway-openapi.yaml)
- [openapi](https://docs.getbindu.com/openapi.yaml)