Your Convex Agent Can Send and Receive iMessage with Photon

0:00This audio is presented by Hacker Nune, where anyone can learn anything about any technology. Your convex agent can send and receive iMessage with Photon, by Photon. Convex developers can now add a durable iMessage inbox and outbox to an agent back end with the new convex component for Photon Spectrum. The component receives Photon web hooks, writes each verified delivery to Convex before returning an HTTP 200 and hands everything after that to Convex's scheduler. Outbound messages move through a paste outbox to a Photon sender running inside a Convex node action. No separately hosted message loop, no sidecar server just to keep alive. The component is now available on NPM and listed on Convex components. What the component does, handles the messaging pipeline that sits between Photon and your agent. Verified, durable web hook ingestion. The root verifies Photon's HMAX signature and persists the delivery before returning 200. An acknowledged inbound message is already in Convex.

1:00Immediate or collapsed turns. Immediate mode handles every message separately. Collapse mode lets a follow-up supersede an unfinished turn and carries its earlier messages into the next handler call. Cooperative cancellation. Convex cannot interrupt an action that is already running, so your handler checks after slow work and before it sends a reply. A paste outbox, sends are queued in Convex, spaced when needed, and delivered by an app-owned node action over Photon's GRPC transport. Deduplication at the durable boundaries. Inbound redeliveries are deadooped on the provider message ID. The outbox uses a deterministic client GUID to avoid queuing the same logical send twice. The result is a messaging component built around Convex's execution model instead of a long-lived process pretending to be serverless. Why this needed a Convex component? The normal spectrum receive loop is intentionally long-lived. That model works in a normal server process. It does not fit a Convex HTTP action, which runs for a request and may be frozen as soon as

2:03the response returns. The usual webhook shortcut has the same problem. Photon's dispatches its handler after the HTTP response. On Convex, work started after that response is not a safe durability boundary. So the component reverses the order. Persistence comes first. Once the delivery is acknowledged, the scheduler owns the remaining work. How collapse mode handles real conversations? People do not send one perfectly composed prompt. They send. Greater than hey greater than greater than so I was thinking greater than greater than can you check XA naive agent starts three model calls and sends three replies. Collapse modatrates that sequence is an evolving turn. If another message arrives before the previous reply ships, the new message supersedes that turn. Messages already drained by the earlier handler return his context, and the new burst arrives in. Your agent can answer the final intent without forgetting what came before it. Cancelation is cooperative. Convex's scheduler cannot stop an action that is already running,

3:05so the handler must recheck after the model call and before speaking. That check is what keeps a stale reply out of the conversation. Set it up. The component itself is one package. Cloud sending also needs photons iMessage provider and its GRPC peers. The setup below is adapted from the repositories complete app at commit. The agent handler replaces its echo function with the integration point. One, registered THE components set three variables in the Convex dashboard. Variable purpose verifies the HMAX signature on inbound webhooks identifies the spectrum cloud project authenticates the photon sender to. Configure the turn policy and sender is the default. Use it for commands, notifications, or other cases where every inbound message should produce its own handler call. Use when the reply is expensive or when answering each fragment would make the agent talk over Thesar. Three, register the webhook root point to spectrum cloud webhook at that root. Four, run your agent once per settled turn as your agent logic. The

4:06component owns the turn lifecycle around it. Five, add the photon sender the component stores and schedules outbound work. A node action in your app performs the GRPC call. The spectrum runtime is cached once per convex node container. So warm sends do not rebuild the connection every time. Six, make the GRPC peers available TO convex add the dynamically loaded peers to. Convex installs an external package only when the bundle contains a static reference to it. The GRPC packages are optional peers loaded dynamically. So add this small bundling shim. Nothing imports this file. Its job is to make the peer dependencies visible to the convex bundler. That is the complete path. Component state and scheduling inside convex, with the provider call performed by a convex node action. There is no separate railway or render process to operate. What is guaranteed, and what is not? The component draws a deliberate boundary around reliability. A correctly signed inbound delivery is durable before the webhook returns 200. Redeliveries with the same provider message ID

5:12do not create another inbound row or handler call. The outbox does not encue the same logical send twice for the same chain and sequence. A failed sender result is recorded and retried with backoff. Read receipts and typing indicators do not start agent turns. There is one important outbound caveat. The deterministic did duplicates the convex outbox, but photon does not currently accept that caller supplied key asked provider requests ID impotency key. If a send reaches the provider and its acknowledgement is lost, a retry can still post twice. Closing that last good requires the key to pass through the SDK. That distinction matters. Inbound persistence, inbound deduplication, outbox deduplication, and provider level ID impotency are four different guarantees. Current limitations. The first release is intentionally narrow. The durable outbox currently reconstructs text and markdown. Attachments, polls, and other rich content need a JSON to builder mapping or a public SDK path for replaying resolved content. Replies, reactions, and red

6:17receipts require an extra message lookup because the public spectrum API addresses a, not only a message ID. The sender's external packages are not installed by convex's anonymous local backend. Use a cloud development deployment to test sends is an iMessage component. Photon can provide SMS, RCS fallback on the iMessage delivery path, but that is not the same as installing standalone RCS and SMS providers in this component. The repository's verification covers signed and forged webhooks, durable ingest, redelivery deduplication, collapsed bursts, handler dispatch, outbox queuing, retries, and a successful authenticated GRPC request to spectrum cloud. The published transport test used a reserved fictional target and stopped that Fodin's target policy validation, so that test does not claim physical phone delivery. These are not footnotes. They are the current contract. How we verified this release? This article describes NPM package version and source commit, verified on August 26, 2026.

7:20We cloned that commit into a clean temporary directory and RONTHAY repositories own install and validation commands with node and NPM. Check result completed. The packages prepare build past 45 of 45 tests passed across four test files passed for the package and TypeScript build past biome checked 28 files. No fixes applied the install also reported 13 moderate severity findings in the dependency audit summary. We did not treat a successful build as evidence that those transitive findings are resolved. You can reproduce the same source level checks. These checks verify the components tested behavior, types, build, and static analysis. They are not a comparative benchmark against another messaging provider and they do not prove delivery to a physical phone. The transport test boundary is described in the limitations above so the evidence does not overstate what was observed. What this means for convex developers? Before this component, using Spectrum's ordinary receive loop with convex mean toprating a separate long-running process

8:20or rebuilding the delivery pipeline around convex yourself. Now the durable state lives where the application state already lives. Webhook ingestion is a convex HTTP route. Messages and outbox rows are convex data. Turn handling runs through convexes scheduler. Your model call runs in a convex action. Photon delivery runs in a convex node action. You still own the agent. You still choose the model, tools, memory, and turn policy. The component owns the messaging state machine around it. Why we built this? Photon's goal is to give agents and native presence in the places people already talk, starting with a phone number. That only works if messaging fits the backend developers are already using. A channel integration should not force a convex team to deploy a second server, rebuild webhook durability, or write its own burst cancellation state machine before the agent can answer one message. Is what first-class messaging looks like inside convex? Durable inbound state, explicit turn semantics, an outbox, and a narrow provider boundary. Convex is already a

9:24backend developers love. Now we can receive a text, run an agent, and send the answer back. Get started, install on npm, then use the complete example in the source repository linked above. Build an agent people context. Related reading, give your master agent an i-message number, using Photon. Add hosted i-message to a master agent with Photon Spectrum. The i-message adapter for Versel chat SDK. Bring native i-message behavior into a chat SDK agent. How we rebuilt our shared i-message routing to handle 10M plus messages a day. The durable routing and event delivery architecture behind Photon. PS shout out to our good friend at Wayne Sutton at Convex for making this happen with us. About Photon, Photon is a unified API that brings agents to interfaces like i-message, WhatsApp, Telegram, Slack, and more. It is free to start, and it scales as your agent grows. Follow Photon, X, Twitter linked in GitHub Discord Instagram start building with Photon View pricing contact the Photon team thank you for listening

10:28to this Hackernoons story, read by artificial intelligence. Visit Hackernoons.com to read, write, learn, and publish.