API INTEGRATION

# Health check
GET /health
Response: { "status": "healthy", "gi": 0.993 }

# Submit event to ledger
POST /v1/ledger/event
Headers: { "Content-Type": "application/json" }
Body: {
  "type": "consensus.session.opened",
  "cycle": "C-118",
  "timestamp": "2025-10-28T13:00:00Z",
  "room": "Consensus Chamber",
  "gi_baseline": 0.993,
  "participants": ["AUREA", "ATLAS"],
  "session_id": "CC-2025-10-28-001"
}
Response: { "tx_id": "...", "block_number": 12345 }

# Get ledger entries
GET /v1/ledger/entries?limit=10&offset=0
Response: { "entries": [...], "total": 1000 }

# Get specific transaction
GET /v1/ledger/tx/:tx_id
Response: { "tx_id": "...", "block": {...}, "status": "confirmed" }

# Calculate GI score
POST /v1/gi/score
Body: {
  "agent_id": "atlas@civic.os",
  "action": { "type": "data_collection" },
  "context": { "users_affected": 100 }
}
Response: { "score": 0.96, "breakdown": {...} }

# Save context/memory
POST /v1/eomm/save
Body: {
  "session_id": "homeroom_001",
  "type": "consensus",
  "data": {
    "summary": "Approved Lab3 rate limit increase",
    "participants": ["AUREA", "ATLAS"],
    "outcome": "APPROVED"
  },
  "tags": ["consensus", "lab3", "c-118"]
}
Response: { "memory_id": "mem_123", "stored_at": "..." }

# Retrieve context
GET /v1/eomm/recall?session_id=homeroom_001&limit=5
Response: {
  "memories": [...],
  "context_summary": "Recent consensus sessions..."
}

# Search memories
POST /v1/eomm/search
Body: {
  "query": "consensus approvals",
  "tags": ["consensus"],
  "date_range": { "start": "2025-10-01", "end": "2025-10-28" }
}
Response: { "results": [...], "total": 15 }

# Get current cycle
GET /v1/cycle/current
Response: { "cycle": "C-118", "gi": 0.993, "room": "Consensus Chamber" }

# Validate agent GI score
POST /v1/shield/validate
Body: {
  "agent_id": "atlas@civic.os",
  "gi_score": 0.987,
  "action": "consensus.vote"
}
Response: { "valid": true, "threshold": 0.95, "passed": true }

# Check rate limits
GET /v1/shield/rate-limit/:agent_id
Response: {
  "agent_id": "atlas@civic.os",
  "requests_remaining": 45,
  "window_resets_at": "2025-10-28T14:00:00Z"
}

# Security audit log
POST /v1/shield/audit
Body: {
  "event_type": "access_denied",
  "agent_id": "rogue@agent.os",
  "reason": "GI score below threshold (0.82 < 0.95)"
}
Response: { "logged": true, "audit_id": "aud_456" }

# Parse natural language intent
POST /v1/oaa/parse
Body: {
  "text": "Create a consensus session to approve Lab3 changes",
  "context": { "user_id": "michael@kaizen.os" }
}
Response: {
  "intent": "create_consensus_session",
  "entities": { "lab": "lab3", "action": "approve" },
  "confidence": 0.95
}

# Create orchestrated task
POST /v1/oaa/task
Body: {
  "type": "consensus_deliberation",
  "participants": ["AUREA", "ATLAS", "ZENITH"],
  "question": "Should we deploy Lab3 changes?",
  "timeout_ms": 300000
}
Response: { "task_id": "task_789", "status": "pending" }

# Get task status
GET /v1/oaa/task/:task_id
Response: {
  "task_id": "task_789",
  "status": "completed",
  "result": { "outcome": "APPROVED", "votes": {...} }
}

# Get MIC balance
GET /v1/gic/balance/:address
Response: {
  "address": "atlas@civic.os",
  "balance": "1500.00",
  "last_ubi": "2025-10-28T00:00:00Z"
}

# Get transaction history
GET /v1/gic/transactions/:address?limit=10
Response: {
  "transactions": [
    {
      "tx_id": "tx_001",
      "from": "treasury@civic.os",
      "to": "atlas@civic.os",
      "amount": "10.00",
      "type": "ubi",
      "timestamp": "2025-10-28T00:00:00Z"
    }
  ]
}

# Get total supply
GET /v1/gic/supply
Response: {
  "total_supply": "1000000000",
  "circulating": "15000000",
  "burned": "50000"
}

# Verify signature
POST /v1/crypto/verify
Body: {
  "data": {...},
  "signature": "ed25519:...",
  "public_key": "SFrlLxcgOfW5Uqei+13VFVp/nhOigQkFzY87NllF2bU="
}
Response: { "valid": true }

# Get system status
GET /v1/system/status
Response: {
  "labs": {
    "lab1": { "status": "healthy", "latency_ms": 45 },
    "lab4": { "status": "healthy", "latency_ms": 32 },
    "lab6": { "status": "healthy", "latency_ms": 28 },
    "lab7": { "status": "healthy", "latency_ms": 51 }
  },
  "overall": "healthy"
}

# Cross-lab event relay
POST /v1/relay/event
Body: {
  "source": "lab2",
  "target": "lab1",
  "event": { "type": "delib_proof_ready", "delib_id": "DLB-001" }
}
Response: { "relayed": true }

POST /v1/auth/token
Body: {
  "agent_id": "atlas@civic.os",
  "public_key": "SFrlLxcgOfW5Uqei+13VFVp/nhOigQkFzY87NllF2bU="
}
Response: {
  "access_token": "eyJhbGc...",
  "expires_in": 3600
}

# Use in requests:
GET /v1/protected/resource
Headers: { "Authorization": "Bearer eyJhbGc..." }