npm install @hexos/react-core

import { AgentProvider, useAgent } from '@hexos/react-core';
 
function App() {
  return (
    <AgentProvider config={{ endpoint: '/api/agent/chat' }}>
      <Chat />
    </AgentProvider>
  );
}
 
function Chat() {
  const { messages, sendMessage, isStreaming } = useAgent({
    endpoint: '/api/agent/chat',
  });
 
  return (
    <div>
      {messages.map((msg) => (
        <div key={msg.id}>{msg.content}</div>
      ))}
      <button onClick={() => sendMessage('Hello!')} disabled={isStreaming}>
        Send
      </button>
    </div>
  );
}

const {
  messages,          // AgentMessage[] — conversation history
  sendMessage,       // (text: string, attachments?: Attachment[]) => void
  isStreaming,       // boolean — whether a response is being streamed
  activeAgent,       // string — current agent ID
  error,             // string | null
  clearError,        // () => void
  reset,             // () => void — clear all state
  stop,              // () => void — stop current stream
  regenerate,        // () => void — regenerate last response
  editMessage,       // (id: string, content: string) => void
  conversationId,    // string
  pendingApprovals,  // ToolApprovalRequest[]
  handoffHistory,    // HandoffRecord[]
  lastHandoff,       // HandoffRecord | null
} = useAgent(config);

useAgentContext({
  key: 'currentPage',
  description: 'The page the user is currently viewing',
  value: '/dashboard',
});

import { z } from 'zod';
 
useAgentTool({
  name: 'show_notification',
  description: 'Show a notification to the user',
  inputSchema: z.object({ message: z.string() }),
  execute: async ({ message }) => {
    toast(message);
    return { shown: true };
  },
});

const { isExecuting, lastResult } = useAgentAction({
  name: 'delete_item',
  description: 'Delete an item from the list',
  inputSchema: z.object({ itemId: z.string() }),
  handler: async ({ itemId }) => { /* ... */ },
  confirmationMessage: 'Are you sure you want to delete this item?',
});

const {
  pending,     // ToolApprovalRequest[]
  approve,     // (id: string) => void
  reject,      // (id: string, reason?: string) => void
  approveAll,  // () => void
  rejectAll,   // (reason?: string) => void
} = useToolApproval();

<AgentProvider config={{ endpoint: '/api/agent/chat', conversationId: 'abc' }}>
  {children}
</AgentProvider>

import { messagesAtom, isStreamingAtom, activeAgentAtom } from '@hexos/react-core';

import { SSETransport } from '@hexos/react-core';
 
const transport = new SSETransport();
await transport.connect({ endpoint: '/api/agent/chat' });
transport.send({ type: 'send-message', message: 'Hello', conversationId: '123' });
transport.onMessage((event) => console.log(event));