AAI Protocol Specification Index
This directory contains the full technical specification for the AAI (Agent App Interface) protocol.
Specification Documents
| Document | Description |
|---|---|
| Overview | Why AAI? Motivation, current limitations, and the dual-interface vision |
| Architecture | System architecture diagram, component responsibilities, key principles |
| aai.json Descriptor | App description file format, file locations, structure, and all field descriptions |
| Security Model | Platform authorization flows (macOS TCC, Windows COM, Linux Polkit, Web App OAuth) |
| Progressive Discovery | 3-step skill discovery via MCP resource model (list, read, call) |
| Error Codes | Standardized error response format and error code table |
| Call Flow | Complete end-to-end call flow example |
| Glossary | Definitions of key terms |
Platform Guides
| Platform | Description |
|---|---|
| macOS | AppleScript / JXA automation, integration guide |
| Windows | COM automation, integration guide |
| Linux | DBus automation, integration guide |
| Web App | REST API + OAuth 2.0, Web App integration guide |
Schema and Examples
| Resource | Description |
|---|---|
| aai.schema.json | Machine-readable JSON Schema for aai.json validation |
| com.apple.mail.aai.json | Example: Apple Mail (desktop, multi-platform) |
| com.notion.api.aai.json | Example: Notion (Web App, OAuth + REST API) |