Docs
Everything you need to ship with Mesedi.
Mesedi observes agent executions in production, detects when an agent is going wrong, clusters related failures so the same problem doesn't page you a hundred times, optionally halts a misbehaving execution before it burns more budget, and notifies you out-of-band the first time a new failure class appears. Pick a section below to dive in.
5 min
Quickstart
Install the SDK, wrap your agent, see the first execution land in the dashboard. The fastest way to confirm Mesedi is observing your workload.
Python
Python SDK
@wrap and @tool decorators, AsyncShipper, Anthropic auto-instrumentation, hard-halt with budgets, and the framework adapters.
TypeScript
TypeScript SDK
wrap() and tool(), AsyncShipper, Anthropic patching, hard-halt + SSE remote channel, and framework adapters.
HTTP
API reference
Authentication, the executions and events ingest endpoints, schema versioning, rate limiting, and the webhook delivery contract.
Concepts
Failure classes and playbooks
Every detector signature Mesedi ships (twenty-plus and growing), what it looks at, and the Tier 1 Playbook each one renders alongside the failure group.
Multi-agent
Topology and handoffs
Parent/child execution graph via parent_execution_id, the agent_handoff event, and how cascading_failure + coordination_deadlock + provider_incident cluster cross-execution signals.
HITL
Human-in-the-loop
Pause an execution while the host application waits on a human decision. SLA tracking, the human_intervention event capturing question + response, and the hitl_timeout / hitl_rejection_spike detectors.
OTel
OpenTelemetry parallel emission
Route Mesedi events to your existing Datadog, Honeycomb, or Grafana Tempo backend via OTLP/HTTP. GenAI semantic conventions honored, multi-agent topology preserved, opt-in via env var.
Self-host
Self-hosting guide
Run the Go backend behind your own infrastructure. SQLite for single-instance, Postgres for production. The repo is MIT-licensed.
Prefer the source?
Every line of the backend, both SDKs, and the playbook content is on GitHub under MIT license. If you'd rather read the code than the docs, the repo is at github.com/mesedi-ai/mesedi. Each subdirectory has its own README, which is what most of these docs pages are built from.
Questions or corrections? Open an issue on GitHub or email hello@mesedi.ai.