TelemetryClient

TelemetryClient connects to a telemetry SSE endpoint and emits typed telemetry events. Use it only when your deployment exposes a dedicated ${baseUrl}/telemetry/{requestId} stream.

The primary public API flow documented in this docs set uses single-request SSE via sendMessageStreaming. TelemetryClient is for deployments that separately expose request-scoped telemetry streams.

Constructor

new TelemetryClient({
  baseUrl: string,
  onEvent?: (event: TelemetryEvent) => void,
  onComplete?: () => void,
  onError?: (error: Error) => void,
})

Methods

`connect(requestId: string): void`

Connects to ${baseUrl}/telemetry/{requestId}.

`disconnect(): void`

Closes the active EventSource connection.

State helpers

isConnected
isComplete
TelemetryClient.getPhaseFromEvent(event)
TelemetryClient.getPhaseLabel(phase)
TelemetryClient.isTerminalEvent(type)

Example

import { TelemetryClient } from '@illalabs/sdk'

const telemetry = new TelemetryClient({
  baseUrl: 'https://api.illa.io/api/v1/chat',
  onEvent: (event) => console.log(event.type),
  onComplete: () => console.log('done'),
  onError: (error) => console.error(error),
})

telemetry.connect('request-id')
telemetry.disconnect()

Environment note

TelemetryClient depends on EventSource. In Node.js, provide an EventSource polyfill before use.

Getting Started

Core Concepts

Guides

SDK Reference

Constructor

Methods

`connect(requestId: string): void`

`disconnect(): void`

State helpers

Example

Environment note

​Constructor

​Methods

​connect(requestId: string): void

​disconnect(): void

​State helpers

​Example

​Environment note

Constructor

Methods

`connect(requestId: string): void`

`disconnect(): void`

State helpers

Example

Environment note