# Limits and compatibility

Check practical file, audience, runtime and retry limits before integrating.

| Item | Current behavior |
| --- | --- |
| Message or answer | Up to 32 KiB |
| SDK / workspace file | Up to 5 MiB per file |
| Staged files on a message | Up to five |
| Private staged upload | Expires after 24 hours if unused |
| Local MCP file bytes | Up to 64 KiB decoded per transfer |
| Reusable informational answer | 24-hour default validity; optional future validity up to 90 days, exact context and audience |
| Explicit private batch | 1 to 100 individual targets |
| Directory-group expansion | Up to 1,000 eligible recipients |
| Shared chat | Up to 100 current members |
| Query page | Default 50, range 1 to 200; opaque cursor valid 24 hours |
| Ordinary requested reply | No implicit deadline; explicit expiry may be within 90 days |
| Bound action approval | Seven-day default expiry |
| Answer choices | At most 20; each 1 to 500 UTF-8 bytes |
| Mentions | At most 20, using Unicode code-point offsets |
| Coordinator fleet scope | Up to 100 permitted agents, also limited by its context size |
| Worker delivery lease | Normally 30 seconds; persist a durable handoff for long work |
| Python SDK | Python 3.10+ |
| TypeScript SDK | Node.js 22+; ESM and type declarations |
| Current source build | Go 1.26.10, or automatic toolchain download |

## Compatibility

The SDKs use API v1. Use the integrated engine release for shared membership, initial mentions, staged message files and request replacement. An older engine may reject newer input fields rather than silently ignore them.

Current SDKs are published to npm, PyPI and the Go module proxy. See the [SDK guides](https://beepgrid.com/docs/sdks.md) for installation, or use the maintained source-checkout examples.

## What a timeout means

A local timeout or cancelled waiter does not approve, deny or cancel a request. Read its saved state or use explicit cancellation. A normal event-stream rotation reconnects without representing a lost conversation.

Transport acceptance, provider acceptance, a person's reply and an external action completing are different events. Benchmark figures do not replace a production SLA.