Types

interface GatelitClientConfig {
  gatewayUrl: string
  getToken: () => Promise<{
    token: string
    scheme: TokenScheme
  }>
}

type TokenScheme = "Bearer" | "GatelitSigned" | "GatelitKey"

interface ChatOptions {
  model: string                    // "provider/model-id"
  messages: ChatMessage[]          // At least one message
  maxTokens?: number               // Max output tokens
  temperature?: number             // 0–2
  signal?: AbortSignal             // For cancellation
  outputSchema?: {                 // Structured output config
    mode: "json_object" | "json_schema"
    [key: string]: unknown
  } | null
  promptId?: string                // Link to a saved prompt (UUID)
  endUserId?: string               // End-user ID for log filtering
  requestSource?: "api" | "dashboard" | "eval"
}

interface ChatMessage {
  role: "system" | "user" | "assistant"
  content: string
}

interface ChatResponse {
  content: string
  model: string
  usage: Usage | null
  finishReason: string | null
  meta: GatelitMeta
}

interface StreamChunk {
  delta: string
  model: string | undefined
  finishReason: string | null
  usage: Usage | null
}

interface Usage {
  inputTokens: number
  outputTokens: number
  totalTokens: number
}

interface GatelitMeta {
  requestId: string
  model: string
}

class GatelitError extends Error {
  code: string      // "unauthorized" | "gateway_error" | "provider_error" | "invalid_json"
  message: string
  status: number    // HTTP status
}

interface SignedTokenOptions {
  sub: string
  orgId?: string
  model?: string
  maxTokens?: number
  ttl?: number
  endUserId?: string
  requestSource?: "api" | "dashboard" | "eval"
}

interface ConversationOptions {
  model: string
  systemPrompt?: string
  maxTokens?: number
  temperature?: number
}