Errors

• Returned API errors (response.isError === true)
• Thrown exceptions (configuration/runtime issues)

​

Returned API errors

{ response: { isError: true, error: CoreApiChatErrorResponse } }

• IllaSDK.sendMessage
• IllaSDK.sendToolResult
• IllaSDK.sendToolResults
• Chat.sendMessage

​

Common thrown errors

• ChatNotFound
• UserContextMissing
• TelemetryStreamFailed
• SSEParse
• StreamingHttpError
• StreamingResponseBodyNull
• StreamingServerError

• CoreApiAuthenticationMissing (when constructing CoreApiProvider without x-api-key)
• ChatAsyncToolCheckerUnavailable (calling Chat.awaitAction without checker)
• SdkEmptyToolsResultsError (calling sendToolResults with empty array)

​

Practical handling pattern

try {
  const result = await sdk.sendMessage('What can I do?', {
    userContext: { address: '0x1234...' },
  })

  if (result.response.isError) {
    console.error(result.response.error.name, result.response.error.message)
    return
  }

  console.log(result.response.data.text)
} catch (error) {
  console.error('SDK/runtime failure:', error)
}

​

Streaming handling pattern