@personaai/reactv0.10.0
react v0.10.0

@personaai/react 0.10.0

React hooks + Provider for building chat UIs

@personaai/react 0.10.0

React hooks + PersonaProvider for building chat UIs against any Persona backend (runtime or adapters).

Client-side only — never holds a credential. baseUrl points to your own mounted runtime (e.g. /api/persona).

Install

bash
npm install @personaai/react

Quickstart

tsx
import { PersonaProvider, useChat } from '@personaai/react';
function App() {  return (    <PersonaProvider baseUrl="/api/persona" defaultAgentId="...">      <Chat />    </PersonaProvider>  );}
function Chat() {  const { messages, input, setInput, handleSubmit, isStreaming } = useChat({ agentId: '...' });  return (    <div>      {messages.map(m => <div key={m.id}>{m.content}</div>)}      <form onSubmit={handleSubmit}>        <input value={input} onChange={e => setInput(e.target.value)} />        <button disabled={isStreaming}>Send</button>      </form>    </div>  );}

See .

Hooks

HookPurpose
useChatStreaming chat — messages, send, interrupts, ephemeral new chat
useArchitectChatArchitect co-pilot — same as useChat, no agentId
useThreadsThread CRUD — list/create/delete/rename/reset/archive
useVoiceReal-time voice (Gemini Live) — start/stop/mute, live transcript
useFilesUpload management — list/upload/delete
useMemoryPersistent memory — read/write/delete
useAgentsAgent discovery
useConnectionHealth check — backend connectivity
useWorkflow*Workflows discovery/execution

See .