Hooks & State

All headless hooks must run inside ChatProvider.

useThread()

Handles active conversation state:

• messages
• isRunning
• processMessage()
• cancelMessage()
• message mutation helpers

const { messages, isRunning, processMessage, cancelMessage } = useThread();

useThreadList()

Handles thread sidebar state:

• threads
• selectedThreadId
• loadThreads()
• selectThread()
• createThread() / deleteThread()

const { threads, selectedThreadId, selectThread, switchToNewThread } = useThreadList();

Use selectors when needed to minimize re-renders, for example useThread((s) => s.messages).