Skip to main content

Responses

Response types returned by the Gateway methods.

CompleteChatHandlerResponseType

Returned by gateway.completeChat().
{
  response: MessageType,   // The assistant's response message
  usage: {
    promptTokens: number,
    completionTokens: number,
    totalTokens: number,
  },
  toolCalls?: ToolCallType[],  // If the model requested tool calls
}

Fields

response
MessageType
required
The assistant’s response message. See Message Types.
usage
object
required
Token usage statistics.
toolCalls
ToolCallType[]
Tool calls requested by the model. Pass these to gateway.getToolResponses() to execute them.

StreamChatHandlerResponseType

Yielded by the async generator from gateway.streamChat().
{
  response: string,    // The text chunk
  usage?: {            // Only present in the final chunk
    promptTokens: number,
    completionTokens: number,
    totalTokens: number,
  },
  toolCalls?: ToolCallType[],  // Only present in the final chunk
}

GetEmbeddingsHandlerResponseType

Returned by gateway.getEmbeddings().
{
  embeddings: number[][],  // Array of embedding vectors
  usage: {
    promptTokens: number,
    totalTokens: number,
  },
}

GatewayError

The error class thrown by all Gateway methods.
import { GatewayError } from "@adaline/gateway";

try {
  const response = await gateway.completeChat({ ... });
} catch (error) {
  if (error instanceof GatewayError) {
    console.error(error.message);
    console.error(error.cause);   // Original provider error
  }
}