# Architecture Reference

Exact timings, steps and failure handling behind [Platform Overview](https://kaltura.github.io/intelligent-agents-sdk/explanation/architecture/index.md). Read ARCHITECTURE.md first for the big picture. For a from-scratch client, see [ARCHITECTURE-RECIPE.md](https://github.com/kaltura/intelligent-agents-sdk/blob/main/docs/ARCHITECTURE-RECIPE.md). For every socket event, see [Wire Protocol](https://kaltura.github.io/intelligent-agents-sdk/reference/wire-protocol/index.md).

| Doc | Covers |
|---|---|
| [Architecture Reference · Connection and Handshake](https://kaltura.github.io/intelligent-agents-sdk/reference/architecture-reference/connection-and-handshake/index.md) | Endpoints and credentials, the full connect sequence, connect timeouts and errors, `prepare()`, connect timings |
| [Architecture Reference · Scale and Sticky Sessions](https://kaltura.github.io/intelligent-agents-sdk/reference/architecture-reference/scale-and-sticky-sessions/index.md) | Sticky routing, the capacity queue and `waitForCapacity` |
| [Architecture Reference · Resilience and Failure Handling](https://kaltura.github.io/intelligent-agents-sdk/reference/architecture-reference/resilience-and-failure-handling/index.md) | Recovery layers, ICE diagnostics, device permissions, the failure-mode matrix, the tool-call spiral breaker, page exit |