DocsCommontransportAgentConfig
Package: @hexos/common

Frontend configuration for connecting to an Hexos backend endpoint.

Passed to useAgent hook or AgentProvider to establish the client-server connection. The headers field supports both static objects and async functions for dynamic authentication (e.g., refreshing JWT tokens before each request).

The enableReasoning flag requests extended thinking content from the LLM, which arrives as reasoning-delta RuntimeEvents.

Related: SSETransport uses this to connect, useAgent accepts this as input, AgentProvider can initialize with this config.

interface AgentConfig {
    endpoint: string;
    agents?: string[];
    transport?: 'sse' | 'websocket';
    headers?: Record<string, string> | (() => Promise<Record<string, string>>);
    conversationId?: string;
    enableReasoning?: boolean;
}

endpoint

string

agents

string[]

transport

'sse' | 'websocket'

headers

Record | (() => Promise>)

conversationId

string

enableReasoning

boolean