How solvent-labs-org/metaorcha works
Metaorcha is a multi-protocol agent harness: a user submits a goal, the platform discovers and plans agent work, executes it through protocol bridges, verifies the run, and presents structured results. The README documents the Registry → Planning & Discovery → SuperAgent path and the MCP, A2A, and computer-use bridges. The sampled execution middleware shows validation, payment, preflight, output normalization, and settlement responsibilities; the README documents the broader seven-step pipeline and CanvasKit rendering. Several subsystems are represented from documentation and the file tree because their implementation was not sampled.
Main entry points: middleware/pipeline.py Call Middleware · routes.py Run API · planning/pipeline.py Plan And Resolve · App.tsx Web Dashboard
Components 20
User Interface
- Web Dashboard
frontend/src/App.tsx - API Client
frontend/src/api/client.ts
Gateway And Identity
- Authentication
services/gateway/src/gateway/auth/routes.py - Session Gateway
services/gateway/src/gateway/sessions/routes.py
Agent Discovery
- Agent Registry
services/registry/src/api/v1/agents.py - Planning API
services/planning-discovery/src/planning_discovery/api/routes/planning.py - Plan And Resolve
services/planning-discovery/src/planning_discovery/planning/pipeline.py - Agent Embeddings
services/planning-discovery/src/planning_discovery/manifest_processing/storage.py
Run Execution
- Run API
services/superagent/src/superagent/api/routes.py - Workflow Runner
services/superagent/src/superagent/graph/runner.py - Agent Call Execution
services/superagent/src/superagent/nodes/execute_agent_calls.py - Call Middleware
services/superagent/src/superagent/middleware/pipeline.py - MCP Bridge
services/superagent/src/superagent/handlers/mcp_handler.py - A2A Bridge
services/superagent/src/superagent/handlers/a2a_handler.py - Computer Use Bridge
services/superagent/src/superagent/handlers/computer_use_handler.py
Verification And Output
- Run Verification
services/validator/src/validator/attestation.py - Evidence Package
services/superagent/src/superagent/api/audit.py - Canvas Renderer
frontend/src/components/canvas/CanvasRenderer.tsx
Other components
- User
- External Agents
Connections 22
- User → Web Dashboard: submits goal
README.md - Web Dashboard → API Client: requests API
- API Client → Authentication: authenticates
frontend/src/api/client.ts - API Client → Session Gateway: sends session
frontend/src/api/client.ts - Session Gateway → Run API: forwards sessions
services/gateway/src/gateway/sessions/routes.py - Agent Registry → Plan And Resolve: supplies agents
README.md - Planning API → Plan And Resolve: builds plan
- Plan And Resolve → Agent Embeddings: resolves candidates
services/planning-discovery/src/planning_discovery/planning/pipeline.py - Plan And Resolve → Workflow Runner: provides workflow
README.md - Run API → Workflow Runner: runs turn
services/superagent/src/superagent/api/routes.py - Workflow Runner → Agent Call Execution: dispatches calls
README.md - Agent Call Execution → Call Middleware: runs call pipeline
services/superagent/src/superagent/middleware/pipeline.py - Call Middleware → MCP Bridge: dispatches protocol
services/superagent/src/superagent/middleware/pipeline.py - Call Middleware → A2A Bridge: dispatches protocol
services/superagent/src/superagent/middleware/pipeline.py - Call Middleware → Computer Use Bridge: dispatches protocol
services/superagent/src/superagent/middleware/pipeline.py - MCP Bridge → External Agents: calls agents
README.md - A2A Bridge → External Agents: calls agents
README.md - Computer Use Bridge → External Agents: operates systems
README.md - Run API → Run Verification: seals run
services/superagent/src/superagent/api/routes.py - Run API → Evidence Package: serves evidence
services/superagent/src/superagent/api/routes.py - Web Dashboard → Canvas Renderer: renders dashboard
README.md - Call Middleware → External Agents: settles calls