MCO Runtime Architecture

mco-org/mco · explicit provider policy · parallel invocation · durable raw answers

MCO Runtime Architecture mco-org/mco · explicit provider policy · parallel invocation · durable raw answers mco local package / Python runtime explicit execution-policy boundary Callers · human · coding agent · Architecture component Callers human · coding agent Entry Surfaces · npm shim · Python CLI · MCP · mco local package / Python runtime Entry Surfaces npm shim · Python CLI · MCP Command Router · run · review · doctor · session · mco local package / Python runtime Command Router run · review · doctor · session Config + Selection · files · explicit provider team · mco local package / Python runtime · no silent team Config + Selection files · explicit provider team no silent team Execution Policy · read_only · write · yolo · mco local package / Python runtime › explicit execution-policy boundary · explicit boundary Execution Policy read_only · write · yolo explicit boundary Invocation Workflow · parallel · chain · debate · synthesize · mco local package / Python runtime › explicit execution-policy boundary Invocation Workflow parallel · chain · debate · synthesize Provider Adapters · shim / ACP · detect · run · poll · cancel · mco local package / Python runtime › explicit execution-policy boundary Provider Adapters shim / ACP · detect · run · poll · cancel Provider CLIs · Claude · Codex · Pi · 7 more · Architecture component Provider CLIs Claude · Codex · Pi · 7 more Answer Transport · plain · JSON · JSONL · ACP events · mco local package / Python runtime Answer Transport plain · JSON · JSONL · ACP events Invocation Artifacts · answers · result.md · run.json · mco local package / Python runtime · raw evidence Invocation Artifacts answers · result.md · run.json raw evidence Output Consumers · terminal · calling agent · CI · Architecture component Output Consumers terminal · calling agent · CI Session Daemon · detached worker · Unix socket · mco local package / Python runtime Session Daemon detached worker · Unix socket Session State · state.json · history.jsonl · mco local package / Python runtime · .mco/sessions Session State state.json · history.jsonl .mco/sessions native CLI / ACP decode events raw answers start · send · resume persist Legend External Frontend Backend Database Security Message bus Cloud

Source-backed dispatch

  • • runtime/cli.py requires an explicit provider or named agent team
  • • runtime/policy.py validates models, context, permissions, and risk
  • • runtime/invocation_runtime.py owns parallelism, timeouts, and cancellation

Raw-answer contract

  • • Adapters keep each provider CLI behind one shared runtime contract
  • • answer_transport.py decodes output without inventing findings or consensus
  • • Artifacts persist answers and run metadata for terminal, agents, or CI

Real repository proof

  • • Repository: github.com/mco-org/mco
  • • Source snapshot: main @ 9f1a1cf
  • • Evidence read: README, CLI, policy, adapters, invocation runtime, sessions

Architecture diagram • Built with Archify • Create yours ↗ • Hover to trace • R route • Click to focus • +/− zoom • M radar • [/] views • P play story • T theme • E export