# API Codex

Repo: `jester/zpack-api`

Use this folder to track API-only work and API-owned integration contracts.

Read in this order:
1. `OVERVIEW.md`
2. `CURRENT_STATE.md`
3. `OPEN_ITEMS.md`
4. `DECISIONS.md`

Scope:
- agent transport and contract handling
- API readiness semantics
- backup forwarding and response contracts
- billing/auth/API-side lifecycle flows
- hosted IDE/API-side proxy and token flow
- API-owned service discovery and publish/teardown integration points

Do not put Portal-only or Agent-only implementation details here unless they directly affect API behavior or integration.