Vercel AI SDK: iMessage Adapter Skill

This skill provides a complete reference for using chat-adapter-imessage, the official Photon adapter for connecting the Vercel AI SDK (Chat SDK) to iMessage.

Overview

The adapter acts as a bridge, allowing you to build AI agents and assistants with the Vercel AI SDK that communicate with users over iMessage. It leverages @photon-ai/imessage-kit (self-hosted) and @photon-ai/advanced-imessage-kit (production infrastructure by Photon) under the hood.

Key Features

• Two Modes: Run in local mode on any Mac for development, or remote mode connected to Photon's production iMessage infrastructure.
• Unified Interface: Provides a consistent API for sending and receiving messages, regardless of the underlying mode.
• Vercel AI SDK Integration: Implements the Adapter interface from the chat package, making it a drop-in solution.
• Markdown Conversion: Automatically converts markdown from the AI SDK into iMessage-compatible plain text.

Setup and Initialization