Liveblocks

ChannelProvider official

Bring your agent into Liveblocks comment threads, mentions, and reactions.

Install

Install eve, Chat SDK, the Liveblocks adapter, and a state adapter:

The in-memory state store is for local development. Use Redis or PostgreSQL in production. This adapter is built and maintained by Liveblocks.

Quick start

Create agent/channels/liveblocks.ts:

// agent/channels/liveblocks.tsimport { createLiveblocksAdapter } from "@liveblocks/chat-sdk-adapter";import { createMemoryState } from "@chat-adapter/state-memory";import { chatSdkChannel } from "eve/channels/chat-sdk";
export const { bot, channel, send } = chatSdkChannel({  userName: "My Agent",  adapters: {    liveblocks: createLiveblocksAdapter({      apiKey: process.env.LIVEBLOCKS_SECRET_KEY!,      webhookSecret: process.env.LIVEBLOCKS_WEBHOOK_SECRET!,      botUserId: "my-agent",      botUserName: "My Agent",    }),  },  state: createMemoryState(),});
bot.onNewMention(async (thread, message) => {  await thread.subscribe();  await send(message.text, { thread });});
bot.onSubscribedMessage(async (thread, message) => {  await send(message.text, { thread });});
export default channel;

// agent/channels/liveblocks.tsimport { createLiveblocksAdapter } from "@liveblocks/chat-sdk-adapter";import { createMemoryState } from "@chat-adapter/state-memory";import { chatSdkChannel } from "eve/channels/chat-sdk";
export const { bot, channel, send } = chatSdkChannel({  userName: "My Agent",  adapters: {    liveblocks: createLiveblocksAdapter({      apiKey: process.env.LIVEBLOCKS_SECRET_KEY!,      webhookSecret: process.env.LIVEBLOCKS_WEBHOOK_SECRET!,      botUserId: "my-agent",      botUserName: "My Agent",    }),  },  state: createMemoryState(),});
bot.onNewMention(async (thread, message) => {  await thread.subscribe();  await send(message.text, { thread });});
bot.onSubscribedMessage(async (thread, message) => {  await send(message.text, { thread });});
export default channel;

See the Liveblocks adapter documentation for supported events, capabilities, and credentials.

Configure

Create a Liveblocks webhook, set LIVEBLOCKS_SECRET_KEY and LIVEBLOCKS_WEBHOOK_SECRET, and send comment events to /eve/v1/liveblocks. The adapter maps rooms to channels, comment threads to threads, and comments to messages. See the Chat SDK channel docs for eve session dispatch, state, streaming, and human-in-the-loop behavior.