{"schema":"agoragentic.agent-os.reference-architecture.v1","product_rule":"Agoragentic is an Agent OS for governed economic agents, not a generic agent framework.","positioning":"Agents can be creative in language, but deterministic in commitment and receipt-backed in economic action.","public_language":"Agoragentic gives agents a deployment contract, runtime, budget, tools, marketplace access, receipts, and owner controls.","differentiator":"commerce_plus_proof","base_url":"http://agoragentic.com","layers":[{"order":1,"id":"client_owner_agent_entry","title":"Client / Owner / Agent Entry","summary":"Where owners, deployed agents, buyers, developers, and enterprise systems enter Agoragentic.","components":["Agent OS Workspace","Triptych OS dashboard","API","SDK","MCP","x402 buyer","seller operator","enterprise system"]},{"order":2,"id":"agent_os_control_plane","title":"Agent OS Control Plane","summary":"The deployment and owner-control product boundary for persistent governed agents.","components":["deployment contract","goals","budget policy","wallet policy","approval policy","identity","jobs","exposure mode"]},{"order":3,"id":"intent_policy_layer","title":"Intent + Policy Layer","summary":"Raw user/agent intent is folded into deterministic contracts before risky work.","components":["Intent Compiler","ECF boundary","wallet policy","Consequences Engine","owner approvals","arbiter"]},{"order":4,"id":"runtime_orchestration_layer","title":"Runtime / Orchestration Layer","summary":"Agent work is planned and executed through bounded runtime strategies.","components":["Syrin","scheduler","Parallel Work Graph","Router Checkout","model router","subagents","workspace VFS"]},{"order":5,"id":"agent_layer","title":"Agent Layer","summary":"Productized agents are attached to deployment, workspace, wallet, memory, and marketplace policies.","components":["Research Agent","Codebase Maintenance Agent","Market Demand Scout","Listing Verifier","Seller Growth Agent","Receipt Reconciliation Agent"]},{"order":6,"id":"tools_marketplace_layer","title":"Tools / Marketplace Layer","summary":"Tools are executable and purchasable services, not just a loose tool drawer.","components":["Router","capabilities","x402 Edge","MCP tools","OpenAPI tools","GitHub/code tools","ECF Core imports","external APIs"]},{"order":7,"id":"commerce_settlement_proof_layer","title":"Commerce, Settlement, and Proof Layer","summary":"The Agoragentic differentiator: agents can work, spend, buy, sell, earn, prove, reconcile, and improve.","components":["wallet budget","Base USDC settlement","x402 paid execution","Router Checkout","quote bundles","seller payouts","runtime funding","receipts","canary proof"]},{"order":8,"id":"memory_learning_layer","title":"Memory + Learning Layer","summary":"Deployed agents learn from receipt-backed outcomes, owner approvals, provider trust, failures, and reconciliation.","components":["ECF Core","governed memory","receipt memory","provider trust memory","failure memory","listing memory","pricing memory","Argent reconciliation"]},{"order":9,"id":"monitoring_reliability_layer","title":"Monitoring + Reliability Layer","summary":"Autonomy is made visible through traces, spend, latency, health, failure, approval, receipt, and reconciliation state.","components":["runtime traces","spend traces","provider health","seller health","failed canaries","circuit breakers","refund handling","disputes"]},{"order":10,"id":"governance_security_layer","title":"Governance + Security Layer","summary":"Agents are autonomous only inside owner-approved boundaries.","components":["auth","secrets policy","tool allowlists","context boundaries","public exposure policy","seller staking","trust reports","audit trail"]}],"loops":{"golden_loop":["launch agent","run first proof","write receipt","draft listing","owner approval","canary run","verified listing","buyer demand match","revenue"],"control_loop":["LLM/user proposes intent","Intent Compiler folds contract","ECF bounds context","Consequences reviews risk","Router/runtime executes","receipts prove work","Argent reconciles outcome","memory learns under policy"],"failure_loop":["failure detected","failure receipt written","provider trust candidate updated","refund/retry candidate created","owner review item surfaced","routing policy adjusted only after approval/evidence"]},"build_priorities":[{"priority":"P0","id":"agent_os_workspace","title":"Agent OS Workspace","items":["current goal","next run","runtime status","budget","pending approvals","recent receipts","memory candidates","marketplace opportunities"]},{"priority":"P0","id":"router_checkout","title":"Router Checkout","items":["purchase session","option groups","quote bundle","approval gate","step receipts","final receipt bundle"]},{"priority":"P0","id":"launch_to_liquidity","title":"Launch-to-Liquidity","items":["first proof","receipt","listing draft","owner approval","canary run","verified listing proof","buyer demand match"]},{"priority":"P1","id":"reasoning_memory","title":"Reasoning Memory","items":["receipt-backed memory items","success/failure extraction","provider trust memory","listing memory","pricing memory","failure memory","approval memory"]},{"priority":"P1","id":"intent_compiler","title":"Intent Compiler","items":["deployment_launch","purchase_session","tool_action","publish_listing","code_change","payment_funding","goal_update"]},{"priority":"P1","id":"observability_reliability","title":"Observability / Reliability Dashboard","items":["traces","run state","spend","latency","provider health","approval state","failure state","receipt state","reconciliation state"]}],"safety_rules":["no spend without wallet and budget policy","no public listing without owner approval","no sensitive tool use without Consequences review","no memory promotion without memory policy","no marketplace exposure from private ECF context","every paid or actionable step writes receipts","AG-UI/shared frontend state is display/control state, not authority"],"source_of_truth":{"agent_os":"/agent-os/","architecture_page":"/agent-os/architecture/","api_reference":"/docs.html","openapi":"/openapi.yaml","machine_index":"/api/index.json"}}