foxhunt/AGENT_11.11_QUICK_REFERENCE.md

Agent 11.11 Quick Reference

Trading Agent Service Proto Definition

Status: ✅ COMPLETE Date: 2025-10-16

---

Files Created

1. Proto Definition

Path: services/trading_agent_service/proto/trading_agent.proto

• 615 lines
• 17 gRPC methods
• 60+ message types
• 10 enum types

2. Generated Code

Path: target/debug/build/trading_agent_service-*/out/trading_agent.rs

• 122 KB
• Service trait: TradingAgentService
• Client stub: TradingAgentServiceClient

---

Proto Structure

Service Methods (17)

Universe Management (3):

• SelectUniverse - Select tradable markets
• GetUniverse - Get current universe
• UpdateUniverseCriteria - Update selection criteria

Asset Selection (2):

• SelectAssets - Choose instruments to trade
• GetSelectedAssets - Get current selections

Portfolio Allocation (3):

• AllocatePortfolio - Distribute capital
• GetAllocation - Get current allocation
• RebalancePortfolio - Rebalance to target

Order Generation (2):

• GenerateOrders - Create order instructions
• SubmitAgentOrders - Send to Trading Service

Strategy Coordination (3):

• RegisterStrategy - Add new strategy
• ListStrategies - Get active strategies
• UpdateStrategyStatus - Enable/disable

Monitoring (3):

• GetAgentStatus - Current state
• StreamAgentActivity - Real-time events
• GetAgentPerformance - Performance metrics

Health (1):

• HealthCheck - Service health

---

Key Message Types

Universe

• Instrument - Trading instrument details
• UniverseCriteria - Selection filters
• UniverseMetrics - Quality metrics

Asset Selection

• AssetScore - Composite scoring
• AssetSelectionCriteria - Selection rules
• SelectionMetrics - Selection quality

Allocation

• AllocationStrategy - Allocation algorithm
• RiskConstraints - Risk limits
• AssetAllocation - Target allocation
• RebalanceAction - Rebalance instructions

Orders

• GeneratedOrder - Order instruction
• MLSignal - ML prediction
• OrderSubmissionResult - Execution result

Strategy

• Strategy - Strategy definition
• StrategyConfig - Configuration
• StrategyPerformance - Metrics

Monitoring

• AgentStatus - Current state
• AgentActivityEvent - Activity stream
• AgentPerformanceMetrics - Performance

---

Usage in Code

Import Proto

use trading_agent_service::proto::trading_agent::{
    TradingAgentService,
    SelectUniverseRequest,
    SelectUniverseResponse,
};

Implement Service

#[tonic::async_trait]
impl TradingAgentService for MyService {
    async fn select_universe(
        &self,
        request: Request<SelectUniverseRequest>,
    ) -> Result<Response<SelectUniverseResponse>, Status> {
        // Implementation
    }
}

Create Client

use trading_agent_service::proto::trading_agent::
    trading_agent_service_client::TradingAgentServiceClient;

let client = TradingAgentServiceClient::connect(
    "http://localhost:50055"
).await?;

---

Build & Test

Compile Proto

cargo build -p trading_agent_service

Check Generated Code

ls target/debug/build/trading_agent_service-*/out/

Verify Compilation

cargo check -p trading_agent_service

---

Integration

Trading Service

• Submit orders: GeneratedOrder → SubmitMLOrder
• Get positions: PositionSummary ← GetPositions

ML Training Service

• ML predictions: MLSignal ← GetMLPredictions
• Model scores: AssetScore.model_scores

API Gateway

• Proxy all 17 methods
• Auth middleware
• Rate limiting

TLI

tli agent universe select --min-liquidity 0.7
tli agent assets select --top-n 5
tli agent allocate --strategy risk-parity
tli agent status

---

Next Steps

Phase 1 Remaining:

1. Agent 11.12 - Basic gRPC server
2. Agent 11.13 - Database migrations
3. Agent 11.14 - Repository traits
4. Agent 11.15 - Docker integration

Phase 2-8:

• Universe & Asset Selection
• Portfolio Allocation
• Order Generation
• Strategy Coordination
• Monitoring & API Gateway
• Backtesting Integration
• Production Hardening

---

Documentation

Full Report: AGENT_11.11_TRADING_AGENT_PROTO.md Design Doc: docs/TRADING_AGENT_SERVICE_DESIGN.md Proto File: services/trading_agent_service/proto/trading_agent.proto