Skip to content

architecture.md

Latest commit

 

History

History
89 lines (74 loc) · 3.17 KB

architecture.md

File metadata and controls

89 lines (74 loc) · 3.17 KB
Raw

Architecture

Intent

agent-recipe is the miner product twin of prism-recipe for agent-challenge:

  1. Point miners at a stable agent template lineage (baseagent / class Agent).
  2. Document ZIP submit + Phala Intel TDX self-deploy (review → eval).
  3. Ship a thin CLI for discovery and optional pass-through — without dumping the agent-challenge service into this repository.

Flow

flowchart TB
  subgraph recipe ["agent-recipe"]
    TPL["template/baseagent/agent.py"]
    CLI["agent-recipe CLI"]
    DOC["docs/miner"]
  end
  subgraph upstream ["Upstream / sibling"]
    BA["BaseIntelligence/baseagent"]
    AC["BaseIntelligence/agent-challenge"]
    SD["python -m agent_challenge.selfdeploy"]
  end
  subgraph plane ["Attestation plane"]
    R["Phala review CVM"]
    E["Phala eval CVM"]
    V["Validator trust root"]
  end
  BA -->|sync snapshot| TPL
  TPL --> ZIP["Miner agent ZIP"]
  ZIP --> AC
  DOC --> SD
  CLI -->|optional shell| SD
  AC --> SD
  SD --> R
  R -->|verified allow| E
  V --> R
  V --> E
Loading

Package map

Path Role
template/baseagent/agent.py Vendored Harbor-compatible class Agent entry
template/baseagent/SYNC.md How to refresh from upstream baseagent
agent_recipe.config Product pins (model, money cap, URLs)
agent_recipe.template_ref Inspect vendored template without importing heavy deps
agent_recipe.selfdeploy Discover / shell to agent_challenge.selfdeploy
agent_recipe.cli info, doctor, template, selfdeploy-*
docs/miner/* A→Z miner narrative

Trust boundaries

Zone Contents
In this repo Docs, thin CLI, vendored template snapshot, pins
Upstream baseagent Full agent runtime, tools, loop
agent-challenge Submit APIs, selfdeploy implementation, measurements
Miner host env PHALA_CLOUD_API_KEY, hotkey material, wallet
CVM encrypted_env OPENROUTER_API_KEY (and session tokens)
Validator Allowlists, RA-TLS key release, quote verify, weights

Relationship to baseagent

  • GitHub: https://github.com/BaseIntelligence/baseagent
    (historical alias lineage includes PlatformNetwork/baseagent resolving to the same product tree).
  • Rename decision: baseagent stays upstream; agent-recipe is a new product repo (no GitHub rename of baseagent → agent-recipe) so existing forks/stars keep working while miners get a prism-recipe-style entry.
  • Vendored file is a snapshot with UPSTREAM_COMMIT.txt; re-sync per SYNC.md.

Relationship to prism-recipe

Concern agent-recipe prism-recipe
Challenge agent-challenge PRISM
Artifact Agent ZIP + Phala CVMs Digest-pinned train image
Attestation Phala TDX review/eval Lium dual worker + ExecutionProof
LLM gate / model pin docs OpenRouter x-ai/grok-4.5 OpenRouter rules gate x-ai/grok-4.5

Out of scope here

  • Full challenge FastAPI service, compose generators, measurement allowlist code.
  • Live Phala CVM orchestration implementation (lives in agent-challenge).
  • Long-running GPU shapes for this product path (CPU TDX only per challenge docs).