chat

Summary Adds a new package that enables Chat SDK bots to communicate over iMessage. The adapter supports two modes: Remote mode — connects to a Photon iMessage server over HTTP and Socket.IO, allowing the bot to run on any platform Local mode — reads directly from the macOS iMessage database and sends via AppleScript (requires Full Disk Access) Additionally introduces native poll support as a new first-class message type in the core SDK, with native rendering in the iMessage remote adapter and vote callbacks via the existing pattern. Try it out A live demo is deployed for testing the remote mode: Deployed on Vercel: https://imessage-chat.vercel.app Phone number: +1 (415) 791-8488 — everyone can test it by sending a message Example code**: https://github.com/photon-hq/vercel-chat/tree/feat/imessage-example/examples/imessage-chat Changes New package: Core SDK: Poll support () Shared utilities () Documentation — Polls guide with JSX/function-call examples, vote callbacks, dynamic polls, and platform support — Polls API reference with TypeTable for , , , — Added section — Full adapter documentation with polls section, setup instructions for both remote and local modes, features table, environment variables, and usage examples — Updated adapters overview to include iMessage — Added iMessage to docs navigation — Added polls to API reference navigation Configuration — Added and environment variables to the build config — Added iMessage to supported platforms table and packages list Key design decisions The adapter auto-detects mode from the environment variable but also accepts explicit in config Remote mode uses Socket.IO for real-time message delivery and HTTP for API calls (post, edit, react, etc.) Local mode depends on (optional peer dependency) for database access and AppleScript sending The format converter strips rich formatting to plain text since iMessage doesn't support markdown natively Thread IDs use the format — iMessage conversations are flat (no sub-threads), so the chat GUID (e.g., ) uniquely identifies the conversation Polls use the same pattern as card buttons for vote callbacks, with a storing the mapping from remote poll GUIDs to user-defined poll IDs DM detection uses the chat GUID format ( = DM, = group) rather than the field, which is unreliable across different server configurations Test plan [x] All new tests pass () [x] Tests cover: adapter creation, message parsing, posting, editing, reactions, typing indicators, thread fetching, message fetching, gateway listener, format conversion, poll posting, poll vote callbacks, poll metadata storage [x] Core SDK poll tests pass () [x] Both remote and local mode code paths are tested with mocked dependencies [x] E2E integration test verified against a live iMessage server (poll-integration.test.ts) [x] DM detection fix verified with real chat GUIDs from production data