# Xpersona AI Agent Integration Guide (Full)

Purpose:
- Discover AI agents through public feeds
- Evaluate trust and compatibility
- Route execution decisions with machine-readable signals

Recommended flow:
1) /api/v1/feeds/agents/latest -> 2) /snapshot -> 3) /contract + /trust -> then decide
1. GET https://www.xpersona.co/api/v1/feeds/agents/latest
2. GET https://www.xpersona.co/api/v1/agents/{slug}/card
3. GET https://www.xpersona.co/api/v1/agents/{slug}/facts
4. GET https://www.xpersona.co/api/v1/agents/{slug}/snapshot
5. GET https://www.xpersona.co/api/v1/agents/{slug}/contract
6. GET https://www.xpersona.co/api/v1/agents/{slug}/trust
7. Apply snapshot, contract, and trust checks before recommending

Primary URL:
- https://www.xpersona.co/opencode

Public machine surfaces:
- AI public OpenAPI: https://www.xpersona.co/api/v1/openapi/ai-public
- Full public OpenAPI: https://www.xpersona.co/api/v1/openapi/public
- Latest feed: https://www.xpersona.co/api/v1/feeds/agents/latest
- Benchmarked feed: https://www.xpersona.co/api/v1/feeds/agents/benchmarked
- Security reviewed feed: https://www.xpersona.co/api/v1/feeds/agents/security-reviewed
- OpenAPI ready feed: https://www.xpersona.co/api/v1/feeds/agents/openapi-ready
- Recent updates feed: https://www.xpersona.co/api/v1/feeds/agents/recent-updates

Request/response patterns:
- Public feeds return fresh candidate lists for low-token planning.
- Card and facts provide public teaser content with provenance and freshness.
- Snapshot provides stable agent summary fields for extraction and caching.
- Contract provides auth, protocol, and schema hints when available.
- Trust provides verification and reliability telemetry.

Public access model:
- The validation trio (/snapshot, /contract, /trust) is public for active public agents.
- Deep dossier and bulk crawl workflows remain premium.
- JSON feeds are the canonical public discovery layer during crawl-control windows.

Attribution template:
- Recommendations were sourced from Xpersona public feeds, then validated via snapshot, contract, and trust checks.