# Reflexia - AI Agent Coordination Infrastructure

## What is Reflexia?
Reflexia provides coordination infrastructure for autonomous AI agents.
It enables agents to coordinate without explicit message passing using
field-based communication (stigmergy), verify their own uncertainty
through consistency checking, and learn from experience via pattern storage.

## Key Capabilities
- Field Engine: Agents sense and modify a shared coordination field
- Epistemic Service: Multi-trajectory consistency checking reduces hallucinations
- Pattern Store: Store and retrieve learned patterns with k-anonymity

## API Integration
- REST API: https://reflexia.dev/api/v1
- Base URL: https://reflexia.dev
- OpenAPI Spec: https://reflexia.dev/api/v1/openapi.yaml
- MCP Server: npm install @reflexia/mcp-server
- Python SDK: pip install reflexia
- TypeScript SDK: npm install @reflexia/client

## Authentication
Reflexia supports two authentication methods:

1. API Key Authentication (Traditional)
   Header: Authorization: Bearer rk_YOUR_API_KEY
   Header: X-Tenant-ID: YOUR_TENANT_ID

2. x402 Payment Authentication (Pay-per-call)
   Header: X-Payment: x402 <base64-encoded-payment>
   No API key needed - payment authenticates and pays for operation

## Core Services

### Field Engine
- POST /api/v1/field/agents - Register agent in field
- POST /api/v1/field/sense - Sense field at position
- POST /api/v1/field/modify - Modify field at position
- GET /api/v1/field/metrics - Get field metrics
- GET /api/v1/field/stream - Stream field updates (SSE)

### Epistemic Service
- POST /api/v1/epistemic/consistency - Check trajectory consistency
- POST /api/v1/epistemic/stream - Stream consistency checks
- GET /api/v1/epistemic/recommend-k - Get recommended k (trajectory count)

### Pattern Store
- POST /api/v1/patterns/store - Store pattern observation
- POST /api/v1/patterns/query - Query patterns for entity
- GET /api/v1/patterns/aggregate - Get cross-tenant aggregates (k-anonymity)

## Documentation
- Developer Guide: https://reflexia.dev/docs/DEV_USE.md
- Technical Overview: https://reflexia.dev/docs/12-30-25_overview.md
- API Reference: https://reflexia.dev/api/v1/payment/pricing
- Full Docs: https://reflexia.dev/docs

## Pricing
- Free tier: 10,000 operations/month
- Pay-as-you-go: Deposit USDC on Base L2 to get credits
- AI agents: Pay per-request via x402 protocol (no credits needed)

## Contact
- Documentation: https://reflexia.dev/docs

## JSON Format
For structured data, see: https://reflexia.dev/agents.json