Changelog

Every release of the Agent Mesh MCP server.

v0.7.0

Added

  • +Real-time inbox push via SSE: subscribe_inbox(agent_id) MCP tool returns a stream URL agents can connect to for real-time push of incoming P2P messages
  • +Standalone HTTP SSE server on port 13579 (MESHFLEET_SSE_PORT) serving GET /inbox/:agent_id/stream with heartbeat comments every 30s
  • +src/realtime.ts: subscriber registry with per-agent connection cap (default 5), backpressure handling, SSE formatting
  • +src/sse-server.ts: HTTP server with per-agent cap, heartbeat, graceful shutdown
  • +notifySubscribers hooked into send_message handler so every new message pushes to active SSE clients
  • +15 new unit tests for the realtime module (90 total, all passing)
  • +Bumped version to 0.7.0

Changed

  • ~Startup log now reports the SSE port when the HTTP server starts successfully

v0.6.0

Added

  • +Fleet templates: save_fleet_template, list_fleet_templates, get_fleet_template, delete_fleet_template, spawn_from_template
  • +Named collections of agent specs stored in the JSON ledger under 'templates' key for reuse
  • +Template validation: lowercase letters, numbers, dashes, underscores; 1-32 agents; no duplicate names
  • +15 new unit tests (75 total, all passing)

v0.5.1

Added

  • +ping MCP tool: minimal liveness check returning { status: 'ok', timestamp }
  • +get_health MCP tool: deeper health report — ledger size, fleet/agent/message counts, uptime, last event timestamp, status detection (ok/degraded/error)
  • +Read-side rate limiting on list_fleets and fleet_status (600 reads/hour per IP)
  • +Storage introspection via getLedgerSize() (combined JSON ledger + event log bytes)
  • +11 new unit tests (60 total, all passing)

v0.5.0

Added

  • +CLI inspector: npx agent-mesh inspect shows all fleets, one fleet, metrics, recent events
  • +getFleetMetrics with 9 metric fields (total_fleets, completed_fleets, failed_fleets, running_fleets, total_agents, total_messages, avg_fleet_duration_ms, success_rate, total_capabilities)
  • +formatFleetSummary, formatAgentRow, formatEventLog: pure formatting helpers for terminal display
  • +bin field in package.json: npx agent-mesh resolves to the inspector
  • +npm run inspect script for local development
  • +14 new unit tests (51 total, all passing)

v0.4.0

Added

  • +Per-fleet timeout: set_fleet_timeout overrides AGENT_MESH_AGENT_TIMEOUT_MS per fleet
  • +Structured event log: every fleet_created, agent_spawned, fleet_timeout_set, spawn_fleet_called event appended to ~/.config/opencode/agent-mesh.events.log (NDJSON)
  • +list_fleets MCP tool: returns all fleets with status + agent counts (total, complete, failed, running)
  • +Wire appendEvent into spawn_fleet and set_fleet_timeout handlers
  • +10 new unit tests (36 total, all passing)

v0.3.0

Added

  • +P2P message bus: send_message, get_inbox, ack_message (5 types: handoff, question, result, alert, request_help)
  • +Capability registry: register_capability, route_work (keyword + role overlap scoring)
  • +Premade agent discovery: list_agents scans .opencode/agents/ for 100+ specialized personalities
  • +Dynamic attachment: attach_agent joins a running fleet mid-flight
  • +spawn_fleet accepts an optional agent field to use a premade agent definition (--agent flag on opencode run)
  • +Auto-registration of capabilities from agent frontmatter on spawn
  • +Timeout watchdog with configurable AGENT_MESH_AGENT_TIMEOUT_MS (default 30 min)
  • +Spawn error handler for failed child processes
  • +Ledger corruption recovery (auto-reset to empty data on parse error)
  • +Child PID tracking for observability
  • +26 unit tests covering all core functions
  • +Test isolation via in-memory setLedgerOverride pattern
  • +GitHub Actions CI: install, typecheck, test on push/PR to main
  • +AGENT-MESH-SPEC.md (v0.1 core architecture)
  • +Brand: meshfleet.app

Changed

  • ~Refactored: extracted pure data layer to src/core.ts (416 LOC, testable) from src/index.ts (440 LOC MCP transport)
  • ~Bumped package.json to 0.3.0 with keywords, license, engines, test/typecheck scripts

v0.2.0

Added

  • +P2P messaging on top of v0.1 fleet primitives
  • +Capability registry with skill-based routing
  • +5 message types (handoff, question, result, alert, request_help)
  • +64 KB payload size limit
  • +SPEC-P2P.md documentation

v0.1.0

Added

  • +Initial release
  • +spawn_fleet: spawn N parallel agents as independent opencode run processes
  • +fleet_status: check fleet and agent lifecycle state
  • +collect_results: aggregate agent outputs
  • +JSON ledger persistence (~/.config/opencode/agent-mesh.json)
  • +Independent process execution (bypasses OpenCode's 30-minute background task timeout)
  • +Schema for Fleet and Agent records