Architecture

openfang-types (base layer — no dependencies)
       ↓
   ┌───┴────────┬──────────┬──────────┐
   ↓            ↓          ↓          ↓
memory      runtime     wire     extensions
   ↓            ↓          ↓          ↓
   └────────────┴──────────┴──────────┘
                ↓
             kernel
          ↓     ↓     ↓
        api   cli  desktop
         ↓
     channels

// In openfang-runtime
pub trait KernelHandle: Send + Sync {
    fn spawn_agent(&self, manifest: AgentManifest) -> Result<AgentId>;
    fn check_capability(&self, agent_id: AgentId, cap: Capability) -> bool;
    fn get_budget_remaining(&self, agent_id: AgentId) -> Option<f64>;
}

// In openfang-kernel
impl KernelHandle for OpenFangKernel {
    fn spawn_agent(&self, manifest: AgentManifest) -> Result<AgentId> {
        // actual implementation
    }
}

#[async_trait]
pub trait Memory: Send + Sync {
    async fn recall(&self, query: &str, limit: usize) -> Vec<MemoryFragment>;
    async fn store(&self, agent_id: AgentId, content: &str, source: MemorySource);
    async fn get(&self, agent_id: AgentId, key: &str) -> Option<Value>;
    async fn set(&self, agent_id: AgentId, key: &str, value: Value);
    // ... knowledge graph operations
}

Telegram Webhook → API Route → Channel Bridge → Kernel Event Bus → Agent Runtime
                                     ↓
                              Response Queue
                                     ↓
                            Telegram Bot API ← HTTP Client

# Run all tests (currently 1,767+ passing)
cargo test --workspace

# Run only kernel tests
cargo test -p openfang-kernel

# Run integration tests with real LLM calls (requires API keys)
GROQ_API_KEY=xxx cargo test --test api_integration_test -- --ignored