Packages
The package catalog is the source of truth for mono-agent ownership and dependency boundaries. Use this directory to find the package that owns a capability; use the linked README for its public API and embedding guidance.
For the dependency graph and the distinction between static dependencies and runtime composition, see the repository package map.
Reading the directory
Section titled “Reading the directory”coretier packages live underpackages/and may participate in the built-in app composition when their category boundary allows it.plugintier packages live underextras/, publish in the same lockstep, and load only through an explicit plugin, backend, request extension, or MCP-companion selection.- The
aliastier is the unscopedcreate-mono-agentinstaller that forwards its commands to@mono-agent/agent-app.
Category describes responsibility (runtime, communication, context, and so on); tier describes how the package joins the product and release graph.
Packages
Section titled “Packages”| Package | Tier / category | Responsibility | Links |
|---|---|---|---|
@mono-agent/agent-app | core / app | Runs a config-first agent host: loads mono-agent.config.json, owns configured responder/harness/runtime/memory composition, and starts every configured channel and traceability. | README for @mono-agent/agent-app · npm for @mono-agent/agent-app |
create-mono-agent | alias / app | Unscoped npm-init installer (npm create mono-agent) shipping create-mono-agent and mono-agent bins that forward every command to @mono-agent/agent-app’s CLI. | README for create-mono-agent · npm for create-mono-agent |
@mono-agent/tui | core / operator-surface | pi-tui operator console: live chat with structured stream-event insight, bounded recorded-run replay, and read-only config view for running agents. | README for @mono-agent/tui · npm for @mono-agent/tui |
@mono-agent/web | core / operator-surface | Serves the always-on browser operator console for persistent multi-agent conversations, streamed turns, and local-device attachments. | README for @mono-agent/web · npm for @mono-agent/web |
@mono-agent/a2a-adapter | plugin / communication | Exposes agent responders over A2A and consumes remote A2A agents through direct discovery. | README for @mono-agent/a2a-adapter · npm for @mono-agent/a2a-adapter |
@mono-agent/cron-adapter | core / communication | Invokes agent responders from cron schedules with configurable skip, queue, or replace overlap policies. | README for @mono-agent/cron-adapter · npm for @mono-agent/cron-adapter |
@mono-agent/messenger-adapter | plugin / communication | Adapts Facebook Messenger webhook events to structural agent requests and delivers final-only replies through the Send API. | README for @mono-agent/messenger-adapter · npm for @mono-agent/messenger-adapter |
@mono-agent/openai-api-adapter | core / communication | Exposes agent responders through OpenAI-compatible model discovery and Chat Completions endpoints. | README for @mono-agent/openai-api-adapter · npm for @mono-agent/openai-api-adapter |
@mono-agent/operator-adapter | core / communication | Exposes the structured local TUI NDJSON endpoint used by the terminal and browser operator consoles. | README for @mono-agent/operator-adapter · npm for @mono-agent/operator-adapter |
@mono-agent/slack-adapter | core / communication | Adapts Slack Socket Mode events to structural agent requests and streamed replies. | README for @mono-agent/slack-adapter · npm for @mono-agent/slack-adapter |
@mono-agent/telegram-adapter | core / communication | Adapts Telegram updates to structural agent requests and streamed replies. | README for @mono-agent/telegram-adapter · npm for @mono-agent/telegram-adapter |
@mono-agent/webhook-adapter | core / communication | Invokes agent responders from HTTP webhook requests with sync and async modes. | README for @mono-agent/webhook-adapter · npm for @mono-agent/webhook-adapter |
@mono-agent/whatsapp-adapter | plugin / communication | Adapts WhatsApp messages to structural agent requests and buffered final-only replies. | README for @mono-agent/whatsapp-adapter · npm for @mono-agent/whatsapp-adapter |
@mono-agent/agent-harness | core / execution | Composes prompt context, selected skills, runtime, memory, history, tool policy, and observability for one request. | README for @mono-agent/agent-harness · npm for @mono-agent/agent-harness |
@mono-agent/agent-orchestrator | plugin / execution | Exposes named collaborator responders to an orchestrator runtime through a bounded MCP tool. | README for @mono-agent/agent-orchestrator · npm for @mono-agent/agent-orchestrator |
@mono-agent/docs-mcp | plugin / context | Provides offline hybrid search and guided reading over version-matched mono-agent documentation through MCP. | README for @mono-agent/docs-mcp · npm for @mono-agent/docs-mcp |
@mono-agent/memory | core / context | Provides local memory subpaths for the SQLite substrate, embedding search, and Bullet-Journal memory engine. | README for @mono-agent/memory · npm for @mono-agent/memory |
@mono-agent/memory-supermemory | plugin / context | Provides a MemoryStore over an external Supermemory instance (local OSS binary or hosted cloud) via its REST API: server-side extraction, hybrid recall, awaited completed-turn admission, and legacy best-effort writes. | README for @mono-agent/memory-supermemory · npm for @mono-agent/memory-supermemory |
@mono-agent/observability | core / observability | Records and reads local JSONL run artifacts, summaries, trace source manifests, and exposes the OTLP/Phoenix exporter through the ./otel subpath. | README for @mono-agent/observability · npm for @mono-agent/observability |
@mono-agent/agent-contracts | core / core | Defines shared structural request/response contracts plus adapter-neutral settings JSON, env, safe-bind, and bearer helpers. | README for @mono-agent/agent-contracts · npm for @mono-agent/agent-contracts |
@mono-agent/config | core / core | Loads adapter-neutral runtime, context, memory, tool, and artifact settings. | README for @mono-agent/config · npm for @mono-agent/config |
@mono-agent/agent-runtime | core / runtime | Provides the Pi SDK runtime bridge with native tools, MCP, sessions, compaction, and provider-catalog integration. | README for @mono-agent/agent-runtime · npm for @mono-agent/agent-runtime |
@mono-agent/runtime-adapter | core / runtime | Wraps @mono-agent/agent-runtime behind runtime contracts and owns sandbox policy/process wrapping. | README for @mono-agent/runtime-adapter · npm for @mono-agent/runtime-adapter |