Class ChatApiClient

Typed client for the Claudius Worker chat API. Handles debouncing, per-attempt timeouts, and automatic retries with backoff for transient failures (HTTP 429/503, network errors, timeouts).

Example

const client = new ChatApiClient("https://api.example.com");
const { reply } = await client.sendMessage([
  { id: "1", role: "user", content: "Hello" },
]);

Index

Constructors

constructor

Methods

sendMessage

Constructors

constructor

new ChatApiClient(
baseUrl: string,
options?: ChatApiClientOptions,
): ChatApiClient
Create a chat client for the given Worker base URL.
Parameters
- baseUrl: string
  Base URL of the Worker. Requests post to ${baseUrl}/api/chat.
- Optionaloptions: ChatApiClientOptions
  Optional retry, debounce, and timeout settings.
Returns ChatApiClient
- Defined in api/client.ts:57

Methods

sendMessage

sendMessage(messages: ChatMessage[]): Promise<ChatResponse>
Send the conversation to the chat endpoint and return the assistant's reply, retrying transient failures with backoff up to ChatApiClientOptions.maxRetries times.
Parameters
- messages: ChatMessage[]
  The full conversation so far, oldest message first.
Returns Promise<ChatResponse>
The assistant's reply and any cited sources.

Throws
DebounceError when called within the debounce window.

Throws
ChatApiError when the request fails after all retries.
- Defined in api/client.ts:74

Class ChatApiClient

Example

Index

Constructors

Methods

Constructors

constructor

Parameters

Returns ChatApiClient

Methods

sendMessage

Parameters

Returns Promise<ChatResponse>

Throws

Throws

Settings

On This Page