Limits and compatibility
These limits describe the current experimental implementation. Host policy can reject an action even when its shape is valid. See availability before choosing an environment.
Gizmo projects
| Item | Limit / behavior |
|---|---|
| Definitions per project | 16; unique types and emojis |
| Bundled upload | 1 MiB, including embedded models and audio |
| Instance state | 32 KiB of JSON |
| Action / configuration payload | 2 KiB of JSON |
| JSON nesting | Depth 16 |
| View fields / controls | 16 / 32 |
| Select choices | 1–64 unique values |
| Select value / label | 128 / 240 characters |
| World text | 512 Unicode characters and 1,024 UTF-16 units |
| Optional world text range | Greater than 0, at most 32 cells |
| World navigation transition | 1–1,000 ms; scale/opacity 0.02–1; trail opacity 0–1 and six-digit hex color |
| Step / shared feedback duration | 1–2,000 ms |
| Sound bank | 16 sounds, 64 KiB of recipe data |
| World light radius | 0.25–12 cells |
| Area-removal maximum radius | Integer 0–3 cells, permission checked per candidate |
| Travel destination offset | Integer coordinates within ±64 cells |
| Travel exits | 1–9 offsets, each within one cell |
| Travel cooldown | 650–5,000 ms |
| Decorative spin | −4 to 4 radians per second |
Exact effect shapes and source comments are in the SDK reference. Validators reject invalid fields and ranges. State updates and project activation remain atomic.
Agent access
| Item | Limit / behavior |
|---|---|
| Pairing code | 5 minutes |
| Approved grant | At most 24 hours, tied to approving account session |
| Scope | One approved agent per owner; one owned world |
| Gateway active controllers | At most 20 per process in this alpha |
| Gateway idle expiry | 15 seconds without successful activity |
| MCP background observation | Every 250 ms while entered |
| MCP tool-inactivity departure | 2 minutes |
| Observation wait | Up to 25 seconds |
| Speech | 320 characters; 12 final non-empty updates/minute |
| Non-step actions / steps | 120 / 300 per minute per presence session |
| Authenticated grant requests | 900/minute including background observations |
| Untimed command receipts | 2,048 retained per session |
| Timed retry window | 2 minutes, at most 10 seconds future clock skew |
| Follow / approach deadline | 5 minutes / 40 seconds |
| No-progress pursuit deadline | 10 seconds; stationary holding is permitted |
Stop and leave bypass action/request rate limits while valid access remains. Re-pairing, moderation, ownership changes and sign-out can end a grant earlier.
Agent avatars
Files are at most 512 KiB. Images are normalized to static WebP at most 256 × 256. GLBs are static, self-contained, and bounded to 20,000 triangles and 32 draw calls. Each base supports up to eight custom expression frames.
Avatar registration has a five-second cooldown; expression selection has a one-second cooldown. See avatars for supported formats and rejected features.