@xberg-io/liter-llm 2.0.1 → 2.0.3

package/index.d.ts

@@ -1,5 +1,5 @@
 // This file is auto-generated by alef — DO NOT EDIT.
-// alef:hash:dcf86ef638e55c8ff83fc5348d3b0956f1df8e68e355d7ff816ee026e432cee1
+// alef:hash:cc9a913abbd03a30283354585d62e51b3c0f62f9b464836dcc01d70a519f1bfc
 // To regenerate: alef generate
 // To verify freshness: alef verify
 /* eslint-disable */
@@ -89,7 +89,12 @@ export declare function completionCost(model: string, promptTokens: number, comp
  * when `prompt_tokens` is below every tier threshold) use the base rates
  * unchanged, matching the original flat-rate behaviour.
  */
-export declare function completionCostWithCache(model: string, promptTokens: number, cachedTokens: number, completionTokens: number): number | null;
+export declare function completionCostWithCache(
+  model: string,
+  promptTokens: number,
+  cachedTokens: number,
+  completionTokens: number,
+): number | null;
 
 /**
  * Return the set of complex provider names.
@@ -133,7 +138,13 @@ export declare function countTokens(model: string, text: string): number;
  * @throws Returns `LiterLlmError` if the underlying HTTP client cannot be
  * constructed, or if the resolved provider configuration is invalid.
  */
-export declare function createClient(apiKey: string, baseUrl?: string | undefined | null, timeoutSecs?: number | undefined | null, maxRetries?: number | undefined | null, modelHint?: string | undefined | null): DefaultClient;
+export declare function createClient(
+  apiKey: string,
+  baseUrl?: string | undefined | null,
+  timeoutSecs?: number | undefined | null,
+  maxRetries?: number | undefined | null,
+  modelHint?: string | undefined | null,
+): DefaultClient;
 
 /**
  * Create a new LLM client from a JSON string.
@@ -209,9 +220,7 @@ export declare function installCatalogOverlayFromStr(catalogJson: string): void;
  * Providers returning an array of typed parts (e.g. after an image-generation
  * or audio-synthesis request) deserialise into `AssistantContent.Parts(_)`.
  */
-export type AssistantContent =
-  | string
-  | Array<__AlefWireAssistantPart>
+export type AssistantContent = string | Array<__AlefWireAssistantPart>;
 
 /** Assistant's response to a user message. */
 export interface AssistantMessage {
@@ -220,25 +229,25 @@ export interface AssistantMessage {
    *
    * `None` is valid when the model replies with tool calls only.
    */
-  readonly content?: AssistantContent
+  readonly content?: AssistantContent;
   /** Optional name for the assistant. */
-  readonly name?: string
+  readonly name?: string;
   /** Tool calls the model wants to execute, if any. */
-  readonly toolCalls?: Array<ToolCall>
+  readonly toolCalls?: Array<ToolCall>;
   /**
    * Refusal reason, if the model declined to respond per safety policies.
    *
    * OpenAI's response schema requires this key to be present even when null,
    * so it is deliberately not `skip_serializing_if`.
    */
-  readonly refusal?: string
+  readonly refusal?: string;
   /** Deprecated legacy function_call field; retained for API compatibility. */
-  readonly functionCall?: FunctionCall
+  readonly functionCall?: FunctionCall;
   /**
    * Reasoning/thinking tokens returned by the provider, if any (e.g. DeepSeek R1, Qwen
    * `reasoning_content`, or Anthropic extended thinking).
    */
-  readonly reasoningContent?: string
+  readonly reasoningContent?: string;
 }
 
 /**
@@ -248,10 +257,10 @@ export interface AssistantMessage {
  * parts-spec discriminator (`"type": "text"`, `"type": "output_image"`, …).
  */
 export type AssistantPart =
-  | { type: 'text'; text: string }
-  | { type: 'refusal'; refusal: string }
-  | { type: 'output_image'; imageUrl: ImageUrl }
-  | { type: 'output_audio'; audio: AudioContent }
+  | { type: "text"; text: string }
+  | { type: "refusal"; refusal: string }
+  | { type: "output_image"; imageUrl: ImageUrl }
+  | { type: "output_audio"; audio: AudioContent };
 
 /**
  * Audio content part for speech-capable models.
@@ -261,27 +270,24 @@ export type AssistantPart =
  */
 export interface AudioContent {
   /** Base64-encoded audio data. */
-  readonly data?: string
+  readonly data?: string;
   /** Audio format (e.g., "wav", "mp3", "ogg"). */
-  readonly format?: string
+  readonly format?: string;
 }
 
 /** Auth configuration block. */
 export interface AuthConfig {
   /** Auth scheme classification. */
-  readonly authType: AuthType
+  readonly authType: AuthType;
   /**
    * Name of the environment variable that holds the API key (e.g. `"OPENAI_API_KEY"`).
    * Holds the variable name, never the secret value.
    */
-  readonly envVar?: string
+  readonly envVar?: string;
 }
 
 /** How the API key is sent in the HTTP request. */
-export type AuthHeaderFormat =
-  | { type: 'Bearer' }
-  | { type: 'ApiKey'; apiKey: string }
-  | { type: 'None' }
+export type AuthHeaderFormat = { type: "Bearer" } | { type: "ApiKey"; apiKey: string } | { type: "None" };
 
 /** Auth scheme used by a provider. */
 export declare enum AuthType {
@@ -298,65 +304,65 @@ export declare enum AuthType {
 /** Query parameters for listing batches. */
 export interface BatchListQuery {
   /** Maximum number of results to return. Defaults to 20. */
-  readonly limit?: number
+  readonly limit?: number;
   /** Pagination cursor: return results after this batch ID. */
-  readonly after?: string
+  readonly after?: string;
 }
 
 /** Response from listing batches. */
 export interface BatchListResponse {
   /** Object type (always `"list"`). */
-  readonly object?: string
+  readonly object?: string;
   /** List of batch objects. */
-  readonly data?: Array<BatchObject>
+  readonly data?: Array<BatchObject>;
   /** Whether more results are available. */
-  readonly hasMore?: boolean
+  readonly hasMore?: boolean;
   /** First batch ID in the result set (for pagination). */
-  readonly firstId?: string
+  readonly firstId?: string;
   /** Last batch ID in the result set (for pagination). */
-  readonly lastId?: string
+  readonly lastId?: string;
 }
 
 /** A batch job object. */
 export interface BatchObject {
   /** Unique batch ID. */
-  readonly id?: string
+  readonly id?: string;
   /** Object type (always `"batch"`). */
-  readonly object?: string
+  readonly object?: string;
   /** API endpoint (e.g., `"/v1/chat/completions"`). */
-  readonly endpoint?: string
+  readonly endpoint?: string;
   /** ID of the input file. */
-  readonly inputFileId?: string
+  readonly inputFileId?: string;
   /** Completion window (e.g., `"24h"`). */
-  readonly completionWindow?: string
+  readonly completionWindow?: string;
   /** Current job status. */
-  readonly status?: BatchStatus
+  readonly status?: BatchStatus;
   /** ID of the output file (present when completed). */
-  readonly outputFileId?: string
+  readonly outputFileId?: string;
   /** ID of the error file (present if some requests failed). */
-  readonly errorFileId?: string
+  readonly errorFileId?: string;
   /** Unix timestamp of batch creation. */
-  readonly createdAt?: number
+  readonly createdAt?: number;
   /** Unix timestamp of completion (if completed). */
-  readonly completedAt?: number
+  readonly completedAt?: number;
   /** Unix timestamp of failure (if failed). */
-  readonly failedAt?: number
+  readonly failedAt?: number;
   /** Unix timestamp of expiration (if expired). */
-  readonly expiredAt?: number
+  readonly expiredAt?: number;
   /** Request processing counts. */
-  readonly requestCounts?: BatchRequestCounts
+  readonly requestCounts?: BatchRequestCounts;
   /** Metadata attached to the batch. */
-  readonly metadata?: JsonValue
+  readonly metadata?: JsonValue;
 }
 
 /** Request processing counts for a batch. */
 export interface BatchRequestCounts {
   /** Total requests in the batch. */
-  readonly total?: number
+  readonly total?: number;
   /** Completed requests. */
-  readonly completed?: number
+  readonly completed?: number;
   /** Failed requests. */
-  readonly failed?: number
+  readonly failed?: number;
 }
 
 /** Status of a batch job. */
@@ -392,43 +398,41 @@ export declare enum BatchStatus {
  */
 export interface BedrockConfig {
   /** AWS region (e.g. `"us-east-1"`). */
-  readonly region?: string
+  readonly region?: string;
   /** Cross-region inference profile prefix (e.g. `"us"`). */
-  readonly crossRegionPrefix?: string
+  readonly crossRegionPrefix?: string;
   /** Explicit AWS access key ID. */
-  readonly accessKeyId?: string
+  readonly accessKeyId?: string;
   /** Explicit AWS secret access key. */
-  readonly secretAccessKey?: string
+  readonly secretAccessKey?: string;
   /** Explicit AWS session token (temporary credentials). */
-  readonly sessionToken?: string
+  readonly sessionToken?: string;
 }
 
 /** Configuration for budget enforcement. */
 export interface BudgetConfig {
   /** Maximum total spend across all models, in USD.  `None` means unlimited. */
-  readonly globalLimit?: number
+  readonly globalLimit?: number;
   /**
    * Per-model spending limits in USD.  Models not listed here are only
    * constrained by `global_limit`.
    */
-  readonly modelLimits?: Record<string, number>
+  readonly modelLimits?: Record<string, number>;
   /** Whether to reject requests or merely warn when a limit is exceeded. */
-  readonly enforcement?: Enforcement
+  readonly enforcement?: Enforcement;
 }
 
 /** Storage backend for the response cache. */
-export type CacheBackend =
-  | { type: 'memory' }
-  | { type: 'open_dal'; scheme: string; config: Record<string, string> }
+export type CacheBackend = { type: "memory" } | { type: "open_dal"; scheme: string; config: Record<string, string> };
 
 /** Configuration for the response cache. */
 export interface CacheConfig {
   /** Maximum number of cached entries. */
-  readonly maxEntries?: number
+  readonly maxEntries?: number;
   /** Time-to-live for each cached entry. */
-  readonly ttl?: number
+  readonly ttl?: number;
   /** Storage backend to use. */
-  readonly backend?: CacheBackend
+  readonly backend?: CacheBackend;
 }
 
 /**
@@ -444,53 +448,53 @@ export interface CatalogRefreshConfig {
    * `Ok(``RefreshOutcome.Disabled``)` without touching the network,
    * the filesystem, or the overlay registry.
    */
-  readonly enabled?: boolean
+  readonly enabled?: boolean;
   /**
    * Source URL to fetch `catalog.json` from. Must be `https`. Defaults to
    * `DEFAULT_CATALOG_URL`; configurable so self-hosted mirrors work.
    */
-  readonly sourceUrl?: string
+  readonly sourceUrl?: string;
   /**
    * How long a cached `catalog.json` remains valid before a network
    * refetch is attempted, in seconds.
    */
-  readonly ttlSeconds?: number
+  readonly ttlSeconds?: number;
   /**
    * Filesystem path for the on-disk cache. `None` uses a default path
    * under `std.env.temp_dir()`.
    */
-  readonly cachePath?: string
+  readonly cachePath?: string;
 }
 
 /** A streamed chunk of a chat completion response. */
 export interface ChatCompletionChunk {
   /** Unique identifier for this stream. */
-  readonly id?: string
+  readonly id?: string;
   /**
    * Always `"chat.completion.chunk"` from OpenAI-compatible APIs.  Stored
    * as a plain `String` so non-standard provider values do not fail parsing.
    */
-  readonly object?: string
+  readonly object?: string;
   /** Unix timestamp of chunk creation. */
-  readonly created?: number
+  readonly created?: number;
   /** Model used to generate the chunk. */
-  readonly model?: string
+  readonly model?: string;
   /** Streaming choices (delta updates). */
-  readonly choices?: Array<StreamChoice>
+  readonly choices?: Array<StreamChoice>;
   /** Token usage (typically only in the final chunk). */
-  readonly usage?: Usage
+  readonly usage?: Usage;
   /** Fingerprint of the system configuration (OpenAI-specific). */
-  readonly systemFingerprint?: string
+  readonly systemFingerprint?: string;
   /** Service tier used (OpenAI-specific). */
-  readonly serviceTier?: string
+  readonly serviceTier?: string;
 }
 
 /** Chat completion request (compatible with OpenAI and similar APIs). */
 export interface ChatCompletionRequest {
   /** Model ID (e.g., `"gpt-4o-mini"`, `"claude-3-5-sonnet"`). */
-  readonly model?: string
+  readonly model?: string;
   /** Conversation history from oldest to newest. */
-  readonly messages?: Array<Message>
+  readonly messages?: Array<Message>;
   /**
    * Sampling temperature. Higher increases randomness, lower is more deterministic.
    * Defaults to 1.0.
@@ -504,81 +508,81 @@ export interface ChatCompletionRequest {
    * value is forwarded and the provider decides. Consult the target provider's reference
    * rather than assuming `[0.0, 2.0]` is portable.
    */
-  readonly temperature?: number
+  readonly temperature?: number;
   /**
    * Nucleus sampling parameter. Lower is more focused.
    *
    * Accepted ranges vary by provider (most document `[0.0, 1.0]`, but this is not
    * universal — check the target provider's own documentation for its exact bounds).
    */
-  readonly topP?: number
+  readonly topP?: number;
   /** Number of chat completions to generate. Defaults to 1. */
-  readonly n?: number
+  readonly n?: number;
   /**
    * Whether to stream the response.
    *
    * Managed by the client layer — do not set directly.
    */
-  readonly stream?: boolean
+  readonly stream?: boolean;
   /** Stop sequence(s) that halt token generation. */
-  readonly stop?: StopSequence
+  readonly stop?: StopSequence;
   /** Max output tokens. Different from max_completion_tokens in some providers. */
-  readonly maxTokens?: number
+  readonly maxTokens?: number;
   /** Presence penalty in `[-2.0, 2.0]`. Positive discourages repeated topics. */
-  readonly presencePenalty?: number
+  readonly presencePenalty?: number;
   /** Frequency penalty in `[-2.0, 2.0]`. Positive discourages repeated tokens. */
-  readonly frequencyPenalty?: number
+  readonly frequencyPenalty?: number;
   /**
    * Token bias map.  Uses `BTreeMap` (sorted keys) for deterministic
    * serialization order — important when hashing or signing requests.
    */
-  readonly logitBias?: Record<string, number>
+  readonly logitBias?: Record<string, number>;
   /** User identifier for request tracking and abuse detection. */
-  readonly user?: string
+  readonly user?: string;
   /** Tools the model can invoke. */
-  readonly tools?: Array<ChatCompletionTool>
+  readonly tools?: Array<ChatCompletionTool>;
   /** Tool usage mode (auto, required, none, or specific tool). */
-  readonly toolChoice?: ToolChoice
+  readonly toolChoice?: ToolChoice;
   /** Whether the model can call multiple tools in parallel. Defaults to true. */
-  readonly parallelToolCalls?: boolean
+  readonly parallelToolCalls?: boolean;
   /** Output format constraint (text, JSON, JSON schema). */
-  readonly responseFormat?: ResponseFormat
+  readonly responseFormat?: ResponseFormat;
   /** Streaming options (e.g., include_usage). */
-  readonly streamOptions?: StreamOptions
+  readonly streamOptions?: StreamOptions;
   /** Random seed for reproducible outputs. Provider support varies. */
-  readonly seed?: number
+  readonly seed?: number;
   /** Reasoning effort level (minimal, low, medium, high, max) for extended-thinking models. */
-  readonly reasoningEffort?: ReasoningEffort
+  readonly reasoningEffort?: ReasoningEffort;
   /**
    * Output modalities to request from the model.
    *
    * For OpenAI audio models, pass `["text", "audio"]`. Vertex AI / Gemini
    * translates these to `generationConfig.responseModalities` (uppercase).
    */
-  readonly modalities?: Array<Modality>
+  readonly modalities?: Array<Modality>;
   /** Whether to return log probabilities of the output tokens. */
-  readonly logprobs?: boolean
+  readonly logprobs?: boolean;
   /**
    * Number of most-likely tokens to return log probabilities for, `0..=20`.
    * Requires `logprobs` to be `true`.
    */
-  readonly topLogprobs?: number
+  readonly topLogprobs?: number;
   /**
    * Upper bound on generated tokens, including reasoning tokens.
    *
    * Supersedes `max_tokens` on OpenAI reasoning models, which reject
    * `max_tokens` outright.
    */
-  readonly maxCompletionTokens?: number
+  readonly maxCompletionTokens?: number;
   /**
    * Latency tier to process the request under (e.g. `"auto"`, `"default"`,
    * `"flex"`).
    */
-  readonly serviceTier?: string
+  readonly serviceTier?: string;
   /** Whether to store the completion for later retrieval by the provider. */
-  readonly store?: boolean
+  readonly store?: boolean;
   /** Developer-defined tags attached to the completion. */
-  readonly metadata?: Record<string, string>
+  readonly metadata?: Record<string, string>;
   /**
    * Predicted output, for latency reduction when much of the response is
    * known ahead of time.
@@ -586,61 +590,61 @@ export interface ChatCompletionRequest {
    * Untyped: the shape is provider-defined and still evolving, and the
    * value is forwarded verbatim.
    */
-  readonly prediction?: JsonValue
+  readonly prediction?: JsonValue;
   /**
    * Audio output parameters, required when `modalities` includes `audio`.
    *
    * Untyped for the same reason as `prediction`.
    */
-  readonly audio?: JsonValue
+  readonly audio?: JsonValue;
   /**
    * Web-search tool configuration for search-enabled models.
    *
    * Untyped for the same reason as `prediction`.
    */
-  readonly webSearchOptions?: JsonValue
+  readonly webSearchOptions?: JsonValue;
   /**
    * Provider-specific extra parameters merged into the request body.
    * Use for guardrails, safety settings, grounding config, etc.
    */
-  readonly extraBody?: JsonValue
+  readonly extraBody?: JsonValue;
 }
 
 /** Chat completion response from the API. */
 export interface ChatCompletionResponse {
   /** Unique identifier for this response. */
-  readonly id?: string
+  readonly id?: string;
   /**
    * Always `"chat.completion"` from OpenAI-compatible APIs.  Stored as a
    * plain `String` so non-standard provider values do not break deserialization.
    */
-  readonly object?: string
+  readonly object?: string;
   /** Unix timestamp of response creation. */
-  readonly created?: number
+  readonly created?: number;
   /** Model used to generate the response. */
-  readonly model?: string
+  readonly model?: string;
   /** List of completion choices. */
-  readonly choices?: Array<Choice>
+  readonly choices?: Array<Choice>;
   /** Token usage statistics. */
-  readonly usage?: Usage
+  readonly usage?: Usage;
   /** Fingerprint of the system configuration (OpenAI-specific). */
-  readonly systemFingerprint?: string
+  readonly systemFingerprint?: string;
   /** Service tier used (OpenAI-specific). */
-  readonly serviceTier?: string
+  readonly serviceTier?: string;
 }
 
 /** A tool the model can invoke (currently, all tools are functions). */
 export interface ChatCompletionTool {
   /** Tool type (always "function" in OpenAI spec). */
-  readonly toolType: ToolType
+  readonly toolType: ToolType;
   /** Function definition with name, description, and JSON schema parameters. */
-  readonly function: FunctionDefinition
+  readonly function: FunctionDefinition;
 }
 
 /** A single completion choice. */
 export interface Choice {
   /** Index of this choice in the choices array. */
-  readonly index?: number
+  readonly index?: number;
   /**
    * The assistant's message response.
    *
@@ -649,16 +653,16 @@ export interface Choice {
    * keyed on `role`, so a stored field would emit the key twice inside a
    * request. OpenAI's response schema requires it here.
    */
-  readonly message?: AssistantMessage
+  readonly message?: AssistantMessage;
   /** Why the model stopped generating (stop, length, tool_calls, content_filter, etc.). */
-  readonly finishReason?: FinishReason
+  readonly finishReason?: FinishReason;
   /**
    * Per-token log probabilities, when the request asked for them.
    *
    * Required by OpenAI's response schema as an always-present, nullable key,
    * so this is deliberately not `skip_serializing_if`.
    */
-  readonly logprobs?: JsonValue
+  readonly logprobs?: JsonValue;
 }
 
 /**
@@ -679,7 +683,7 @@ export interface ChunkMiddleware {
    * - `Ok(None)` — drop this chunk silently.
    * - `Err(e)` — propagate as a stream error.
    */
-  process(chunk?: ChatCompletionChunk | undefined | null): ChatCompletionChunk | null
+  process(chunk?: ChatCompletionChunk | undefined | null): ChatCompletionChunk | null;
 }
 
 /** Observable state of a circuit breaker. */
@@ -694,51 +698,51 @@ export declare enum CircuitState {
 
 /** A single content part in a user message — text, image, document, or audio. */
 export type ContentPart =
-  | { type: 'text'; text: string }
-  | { type: 'image_url'; imageUrl: ImageUrl }
-  | { type: 'document'; document: DocumentContent }
-  | { type: 'input_audio'; inputAudio: AudioContent }
+  | { type: "text"; text: string }
+  | { type: "image_url"; imageUrl: ImageUrl }
+  | { type: "document"; document: DocumentContent }
+  | { type: "input_audio"; inputAudio: AudioContent };
 
 /** Request to create a batch job. */
 export interface CreateBatchRequest {
   /** ID of the uploaded input file (JSONL format). */
-  readonly inputFileId?: string
+  readonly inputFileId?: string;
   /** API endpoint (e.g., `"/v1/chat/completions"`). */
-  readonly endpoint?: string
+  readonly endpoint?: string;
   /** Completion window (e.g., `"24h"`). */
-  readonly completionWindow?: string
+  readonly completionWindow?: string;
   /** Optional metadata to attach to the batch. */
-  readonly metadata?: JsonValue
+  readonly metadata?: JsonValue;
 }
 
 /** Request to upload a file. */
 export interface CreateFileRequest {
   /** Base64-encoded file data. */
-  readonly file?: string
+  readonly file?: string;
   /** Purpose for the file. */
-  readonly purpose?: FilePurpose
+  readonly purpose?: FilePurpose;
   /** Optional filename to associate with the upload. */
-  readonly filename?: string
+  readonly filename?: string;
 }
 
 /** Request to create images from a text prompt. */
 export interface CreateImageRequest {
   /** Text description of the image to generate. */
-  readonly prompt?: string
+  readonly prompt?: string;
   /** Model ID (e.g., `"dall-e-3"`). Optional; API may use default if unset. */
-  readonly model?: string
+  readonly model?: string;
   /** Number of images to generate. Defaults to 1. */
-  readonly n?: number
+  readonly n?: number;
   /** Image size (e.g., `"1024x1024"`, `"1792x1024"`). */
-  readonly size?: string
+  readonly size?: string;
   /** Image quality: `"standard"` or `"hd"`. */
-  readonly quality?: string
+  readonly quality?: string;
   /** Style: `"natural"` or `"vivid"` (DALL-E 3 only). */
-  readonly style?: string
+  readonly style?: string;
   /** Response format: `"url"` or `"b64_json"`. */
-  readonly responseFormat?: string
+  readonly responseFormat?: string;
   /** User identifier for request tracking. */
-  readonly user?: string
+  readonly user?: string;
 }
 
 /**
@@ -770,19 +774,19 @@ export interface CreateResponseRequest {
    * stripped and does **not** re-route the request, which stays pinned to the
    * provider the client was constructed with.
    */
-  readonly model?: string
+  readonly model?: string;
   /** Input data to process (e.g., a document to extract from). */
-  readonly input?: JsonValue
+  readonly input?: JsonValue;
   /** Instructions for processing the input. */
-  readonly instructions?: string
+  readonly instructions?: string;
   /** Available tools the model can use. */
-  readonly tools?: Array<ResponseTool>
+  readonly tools?: Array<ResponseTool>;
   /** Sampling temperature in `[0.0, 2.0]`. Defaults to 1.0. */
-  readonly temperature?: number
+  readonly temperature?: number;
   /** Maximum output tokens. */
-  readonly maxOutputTokens?: number
+  readonly maxOutputTokens?: number;
   /** Optional metadata. */
-  readonly metadata?: JsonValue
+  readonly metadata?: JsonValue;
   /**
    * Extra top-level parameters shallow-merged into the request body, OpenAI-Python
    * style (`{**body, **extra_body}`) — keys here override identically named fields
@@ -797,55 +801,55 @@ export interface CreateResponseRequest {
    * A non-object value cannot be merged into the body root and is dropped with a
    * warning rather than sent.
    */
-  readonly extraBody?: JsonValue
+  readonly extraBody?: JsonValue;
   /**
    * Whether to stream the response.
    *
    * Managed by the client layer — do not set directly.
    */
-  readonly stream?: boolean
+  readonly stream?: boolean;
 }
 
 /** Request to generate speech audio from text. */
 export interface CreateSpeechRequest {
   /** Model ID (e.g., `"tts-1"`, `"tts-1-hd"`). */
-  readonly model?: string
+  readonly model?: string;
   /** Text to synthesize into speech. */
-  readonly input?: string
+  readonly input?: string;
   /** Voice name (e.g., `"alloy"`, `"echo"`, `"fable"`, `"onyx"`, `"nova"`, `"shimmer"`). */
-  readonly voice?: string
+  readonly voice?: string;
   /** Audio format (e.g., `"mp3"`, `"opus"`, `"aac"`, `"flac"`, `"wav"`, `"pcm"`). */
-  readonly responseFormat?: string
+  readonly responseFormat?: string;
   /** Playback speed in `[0.25, 4.0]`. Defaults to 1.0. */
-  readonly speed?: number
+  readonly speed?: number;
 }
 
 /** Request to transcribe audio into text. */
 export interface CreateTranscriptionRequest {
   /** Model ID (e.g., `"whisper-1"`). */
-  readonly model?: string
+  readonly model?: string;
   /** Base64-encoded audio file data. */
-  readonly file?: string
+  readonly file?: string;
   /** Language ISO-639-1 code (e.g., `"en"`, `"fr"`, `"de"`). Optional; model auto-detects. */
-  readonly language?: string
+  readonly language?: string;
   /** Optional text to guide the model (improves accuracy for domain-specific terms). */
-  readonly prompt?: string
+  readonly prompt?: string;
   /** Output format (e.g., `"json"`, `"text"`, `"vtt"`, `"srt"`, `"verbose_json"`). */
-  readonly responseFormat?: string
+  readonly responseFormat?: string;
   /** Sampling temperature in `[0.0, 1.0]`. Higher increases variability. Defaults to 0. */
-  readonly temperature?: number
+  readonly temperature?: number;
 }
 
 /** Configuration for registering a custom LLM provider at runtime. */
 export interface CustomProviderConfig {
   /** Unique name for this provider (e.g., "my-provider"). */
-  readonly name: string
+  readonly name: string;
   /** Base URL for the provider's API (e.g., `<https://api.my-provider.com/v1>`). */
-  readonly baseUrl: string
+  readonly baseUrl: string;
   /** Authentication header format. */
-  readonly authHeader: AuthHeaderFormat
+  readonly authHeader: AuthHeaderFormat;
   /** Model name prefixes that route to this provider (e.g., `["my-"]`). */
-  readonly modelPrefixes: Array<string>
+  readonly modelPrefixes: Array<string>;
 }
 
 /**
@@ -856,9 +860,9 @@ export interface CustomProviderConfig {
  */
 export interface DecodedDataUrl {
   /** MIME type extracted from the URL prefix (verbatim, not normalised). */
-  readonly mime?: string
+  readonly mime?: string;
   /** Decoded base64 payload. */
-  readonly data?: Uint8Array
+  readonly data?: Uint8Array;
 }
 
 /**
@@ -879,27 +883,29 @@ export interface DecodedDataUrl {
  * headers are cached at construction to avoid redundant encoding on every request.
  */
 export declare class DefaultClient {
-  chat(req?: ChatCompletionRequest | undefined | null): Promise<ChatCompletionResponse>
-  chatStream(req?: ChatCompletionRequest | undefined | null): Promise<AsyncGenerator<ChatCompletionChunk, void, undefined>>
-  embed(req?: EmbeddingRequest | undefined | null): Promise<EmbeddingResponse>
-  listModels(): Promise<ModelsListResponse>
-  imageGenerate(req?: CreateImageRequest | undefined | null): Promise<ImagesResponse>
-  speech(req?: CreateSpeechRequest | undefined | null): Promise<Uint8Array>
-  transcribe(req?: CreateTranscriptionRequest | undefined | null): Promise<TranscriptionResponse>
-  moderate(req?: ModerationRequest | undefined | null): Promise<ModerationResponse>
-  rerank(req?: RerankRequest | undefined | null): Promise<RerankResponse>
-  search(req?: SearchRequest | undefined | null): Promise<SearchResponse>
-  ocr(req?: OcrRequest | undefined | null): Promise<OcrResponse>
-  createFile(req?: CreateFileRequest | undefined | null): Promise<FileObject>
-  retrieveFile(fileId: string): Promise<FileObject>
-  deleteFile(fileId: string): Promise<DeleteResponse>
-  listFiles(query?: FileListQuery | undefined | null): Promise<FileListResponse>
-  fileContent(fileId: string): Promise<Uint8Array>
-  createBatch(req?: CreateBatchRequest | undefined | null): Promise<BatchObject>
-  retrieveBatch(batchId: string): Promise<BatchObject>
-  listBatches(query?: BatchListQuery | undefined | null): Promise<BatchListResponse>
-  cancelBatch(batchId: string): Promise<BatchObject>
-  fetchBatchForPolling(batchId: string): Promise<BatchObject>
+  chat(req?: ChatCompletionRequest | undefined | null): Promise<ChatCompletionResponse>;
+  chatStream(
+    req?: ChatCompletionRequest | undefined | null,
+  ): Promise<AsyncGenerator<ChatCompletionChunk, void, undefined>>;
+  embed(req?: EmbeddingRequest | undefined | null): Promise<EmbeddingResponse>;
+  listModels(): Promise<ModelsListResponse>;
+  imageGenerate(req?: CreateImageRequest | undefined | null): Promise<ImagesResponse>;
+  speech(req?: CreateSpeechRequest | undefined | null): Promise<Uint8Array>;
+  transcribe(req?: CreateTranscriptionRequest | undefined | null): Promise<TranscriptionResponse>;
+  moderate(req?: ModerationRequest | undefined | null): Promise<ModerationResponse>;
+  rerank(req?: RerankRequest | undefined | null): Promise<RerankResponse>;
+  search(req?: SearchRequest | undefined | null): Promise<SearchResponse>;
+  ocr(req?: OcrRequest | undefined | null): Promise<OcrResponse>;
+  createFile(req?: CreateFileRequest | undefined | null): Promise<FileObject>;
+  retrieveFile(fileId: string): Promise<FileObject>;
+  deleteFile(fileId: string): Promise<DeleteResponse>;
+  listFiles(query?: FileListQuery | undefined | null): Promise<FileListResponse>;
+  fileContent(fileId: string): Promise<Uint8Array>;
+  createBatch(req?: CreateBatchRequest | undefined | null): Promise<BatchObject>;
+  retrieveBatch(batchId: string): Promise<BatchObject>;
+  listBatches(query?: BatchListQuery | undefined | null): Promise<BatchListResponse>;
+  cancelBatch(batchId: string): Promise<BatchObject>;
+  fetchBatchForPolling(batchId: string): Promise<BatchObject>;
   /**
    * Poll a batch until it reaches a terminal status (Completed, Failed, Expired, Cancelled).
    *
@@ -909,43 +915,43 @@ export declare class DefaultClient {
    * Returns `BatchWaitError.Timeout` if the configured timeout is exceeded.
    * Returns `BatchWaitError.Client` for underlying client errors.
    */
-  waitForBatch(batchId: string, config?: WaitForBatchConfig | undefined | null): Promise<BatchObject>
-  createResponse(req?: CreateResponseRequest | undefined | null): Promise<ResponseObject>
-  retrieveResponse(responseId: string): Promise<ResponseObject>
-  cancelResponse(responseId: string): Promise<ResponseObject>
+  waitForBatch(batchId: string, config?: WaitForBatchConfig | undefined | null): Promise<BatchObject>;
+  createResponse(req?: CreateResponseRequest | undefined | null): Promise<ResponseObject>;
+  retrieveResponse(responseId: string): Promise<ResponseObject>;
+  cancelResponse(responseId: string): Promise<ResponseObject>;
 }
 
 /** Response from a delete operation. */
 export interface DeleteResponse {
   /** ID of the deleted resource. */
-  readonly id?: string
+  readonly id?: string;
   /** Object type. */
-  readonly object?: string
+  readonly object?: string;
   /** Confirmation that the resource was deleted. */
-  readonly deleted?: boolean
+  readonly deleted?: boolean;
 }
 
 /** Developer message (system-like message for Claude models). */
 export interface DeveloperMessage {
   /** Developer-specific instructions or context. */
-  readonly content?: string
+  readonly content?: string;
   /** Optional name for the developer message source. */
-  readonly name?: string
+  readonly name?: string;
 }
 
 /** PDF/document content part for vision-capable models. */
 export interface DocumentContent {
   /** Base64-encoded document data or URL. */
-  readonly data?: string
+  readonly data?: string;
   /** MIME type (e.g., "application/pdf", "text/csv"). */
-  readonly mediaType?: string
+  readonly mediaType?: string;
 }
 
 /** A content part in a multimodal embedding input. */
 export type EmbeddingContentPart =
-  | { type: 'text'; text: string }
-  | { type: 'image_url'; imageUrl: ImageUrl }
-  | { type: 'image_base64'; imageBase64: string }
+  | { type: "text"; text: string }
+  | { type: "image_url"; imageUrl: ImageUrl }
+  | { type: "image_base64"; imageBase64: string };
 
 /** The format in which the embedding vectors are returned. */
 export declare enum EmbeddingFormat {
@@ -956,10 +962,7 @@ export declare enum EmbeddingFormat {
 }
 
 /** Text, texts, or multimodal content to embed. */
-export type EmbeddingInput =
-  | string
-  | Array<string>
-  | Array<__AlefWireEmbeddingContentPart>
+export type EmbeddingInput = string | Array<string> | Array<__AlefWireEmbeddingContentPart>;
 
 /** A single embedding vector. */
 export interface EmbeddingObject {
@@ -967,7 +970,7 @@ export interface EmbeddingObject {
    * Always `"embedding"` from OpenAI-compatible APIs.  Stored as a plain
    * `String` so non-standard provider values do not break deserialization.
    */
-  readonly object: string
+  readonly object: string;
   /**
    * The embedding vector.
    *
@@ -976,23 +979,23 @@ export interface EmbeddingObject {
    * little-endian `f32` bytes. Base64 responses are decoded on read; this
    * field always serializes back out as a JSON float array.
    */
-  readonly embedding: Array<number>
+  readonly embedding: Array<number>;
   /** Index in the batch (corresponds to input order). */
-  readonly index: number
+  readonly index: number;
 }
 
 /** Embedding request. */
 export interface EmbeddingRequest {
   /** Model ID (e.g., `"text-embedding-3-small"`). */
-  readonly model?: string
+  readonly model?: string;
   /** Text, texts, or multimodal content to embed. */
-  readonly input?: EmbeddingInput
+  readonly input?: EmbeddingInput;
   /** Output format: float (native) or base64. */
-  readonly encodingFormat?: EmbeddingFormat
+  readonly encodingFormat?: EmbeddingFormat;
   /** Requested embedding dimensions (if supported by the model). */
-  readonly dimensions?: number
+  readonly dimensions?: number;
   /** User identifier for request tracking. */
-  readonly user?: string
+  readonly user?: string;
 }
 
 /** Embedding response. */
@@ -1001,13 +1004,13 @@ export interface EmbeddingResponse {
    * Always `"list"` from OpenAI-compatible APIs.  Stored as a plain
    * `String` so non-standard provider values do not break deserialization.
    */
-  readonly object: string
+  readonly object: string;
   /** List of embeddings. */
-  readonly data: Array<EmbeddingObject>
+  readonly data: Array<EmbeddingObject>;
   /** Model used to generate embeddings. */
-  readonly model: string
+  readonly model: string;
   /** Token usage (input tokens only; embeddings have zero output tokens). */
-  readonly usage?: Usage
+  readonly usage?: Usage;
 }
 
 /** How budget limits are enforced. */
@@ -1027,39 +1030,39 @@ export declare enum Enforcement {
 /** Query parameters for listing files. */
 export interface FileListQuery {
   /** Filter by file purpose (e.g., `"batch"`, `"fine-tune"`). */
-  readonly purpose?: string
+  readonly purpose?: string;
   /** Maximum number of results to return. Defaults to 20. */
-  readonly limit?: number
+  readonly limit?: number;
   /** Pagination cursor: return results after this file ID. */
-  readonly after?: string
+  readonly after?: string;
 }
 
 /** Response from listing files. */
 export interface FileListResponse {
   /** Object type (always `"list"`). */
-  readonly object?: string
+  readonly object?: string;
   /** List of file objects. */
-  readonly data?: Array<FileObject>
+  readonly data?: Array<FileObject>;
   /** Whether more results are available. */
-  readonly hasMore?: boolean
+  readonly hasMore?: boolean;
 }
 
 /** An uploaded file object. */
 export interface FileObject {
   /** Unique file ID. */
-  readonly id?: string
+  readonly id?: string;
   /** Object type (always `"file"`). */
-  readonly object?: string
+  readonly object?: string;
   /** File size in bytes. */
-  readonly bytes?: number
+  readonly bytes?: number;
   /** Unix timestamp of file creation. */
-  readonly createdAt?: number
+  readonly createdAt?: number;
   /** Filename. */
-  readonly filename?: string
+  readonly filename?: string;
   /** File purpose. */
-  readonly purpose?: string
+  readonly purpose?: string;
   /** Processing status (e.g., `"uploaded"`, `"processed"`). */
-  readonly status?: string
+  readonly status?: string;
 }
 
 /** Purpose of an uploaded file. */
@@ -1097,27 +1100,27 @@ export declare enum FinishReason {
 /** Function call details. */
 export interface FunctionCall {
   /** Function name. */
-  readonly name: string
+  readonly name: string;
   /** Arguments as a JSON string (parse with serde_json.from_str). */
-  readonly arguments: string
+  readonly arguments: string;
 }
 
 /** Function definition exposed to the model. */
 export interface FunctionDefinition {
   /** Name of the function. Required and must be alphanumeric + underscores. */
-  readonly name: string
+  readonly name: string;
   /** Human-readable description explaining what the function does. */
-  readonly description?: string
+  readonly description?: string;
   /** JSON Schema defining the function's parameters. */
-  readonly parameters?: JsonValue
+  readonly parameters?: JsonValue;
   /** If true, enforce strict JSON schema validation for arguments. */
-  readonly strict?: boolean
+  readonly strict?: boolean;
 }
 
 /** Deprecated legacy function-role message body. */
 export interface FunctionMessage {
-  readonly content?: string
-  readonly name?: string
+  readonly content?: string;
+  readonly name?: string;
 }
 
 /**
@@ -1134,7 +1137,7 @@ export interface HealthChecker {
    * move it into the returned future without a clone, making the
    * `'static + Send` bound on the future trivially satisfiable.
    */
-  check(upstream: string): Promise<HealthStatus>
+  check(upstream: string): Promise<HealthStatus>;
 }
 
 /** The result of a single health probe. */
@@ -1148,11 +1151,11 @@ export declare enum HealthStatus {
 /** A single generated image, returned as either a URL or base64 data. */
 export interface Image {
   /** Image URL (if response_format was "url"). */
-  readonly url?: string
+  readonly url?: string;
   /** Base64-encoded image data (if response_format was "b64_json"). */
-  readonly b64Json?: string
+  readonly b64Json?: string;
   /** The final prompt used to generate the image (DALL-E 3). */
-  readonly revisedPrompt?: string
+  readonly revisedPrompt?: string;
 }
 
 /** Image detail level controlling token cost and processing. */
@@ -1168,9 +1171,9 @@ export declare enum ImageDetail {
 /** Response containing generated images. */
 export interface ImagesResponse {
   /** Unix timestamp of image creation. */
-  readonly created?: number
+  readonly created?: number;
   /** List of generated images. */
-  readonly data?: Array<Image>
+  readonly data?: Array<Image>;
 }
 
 /**
@@ -1184,59 +1187,59 @@ export interface ImagesResponse {
  */
 export interface ImageUrl {
   /** URL of the image (data URI or HTTP/HTTPS URL). */
-  readonly url?: string
+  readonly url?: string;
   /** Detail level: low (512x512), high (2x2 tiles), or auto (model-selected). */
-  readonly detail?: ImageDetail
+  readonly detail?: ImageDetail;
 }
 
 /** Configuration for the global per-client in-flight request limit. */
 export interface InFlightLimitConfig {
   /** Maximum simultaneously outstanding provider requests. `None` means unlimited. */
-  readonly maxInFlight?: number
+  readonly maxInFlight?: number;
 }
 
 /** An intent prototype: `(intent_name, prototype_embedding, target_model_id)`. */
 export interface IntentPrototype {
   /** Human-readable name for the intent (used in logs/metrics). */
-  readonly name: string
+  readonly name: string;
   /** Pre-computed embedding vector for this intent. */
-  readonly embedding: Array<number>
+  readonly embedding: Array<number>;
   /** Model to route to when this intent is detected. */
-  readonly model: string
+  readonly model: string;
 }
 
 /** JSON Schema specification for constrained output. */
 export interface JsonSchemaFormat {
   /** Name of the schema (must be unique in the request). */
-  readonly name?: string
+  readonly name?: string;
   /** Description of what the schema represents. */
-  readonly description?: string
+  readonly description?: string;
   /** JSON Schema object defining the output structure. */
-  readonly schema?: JsonValue
+  readonly schema?: JsonValue;
   /** If true, enforce strict schema validation. */
-  readonly strict?: boolean
+  readonly strict?: boolean;
 }
 
 /** Budget enforcement configuration. */
 export interface LlmBudgetConfig {
   /** Global spend limit in USD. */
-  readonly globalLimit?: number
+  readonly globalLimit?: number;
   /** Per-model spend limits in USD, keyed by model name. */
-  readonly modelLimits?: Record<string, number>
+  readonly modelLimits?: Record<string, number>;
   /** Enforcement mode: `"hard"` (reject over-budget requests) or `"soft"` (log only). */
-  readonly enforcement?: string
+  readonly enforcement?: string;
 }
 
 /** Response cache configuration. */
 export interface LlmCacheConfig {
   /** Maximum number of cached entries. */
-  readonly maxEntries?: number
+  readonly maxEntries?: number;
   /** Cache entry time-to-live, in seconds. */
-  readonly ttlSeconds?: number
+  readonly ttlSeconds?: number;
   /** Cache backend name (e.g. `"memory"`, or an `opendal` scheme). */
-  readonly backend?: string
+  readonly backend?: string;
   /** Backend-specific configuration key/value pairs. */
-  readonly backendConfig?: Record<string, string>
+  readonly backendConfig?: Record<string, string>;
 }
 
 /**
@@ -1257,87 +1260,87 @@ export interface LlmCacheConfig {
  */
 export interface LlmConfig {
   /** Model identifier (e.g. `"gpt-4o"`, `"bedrock/anthropic.claude-3-sonnet-20240229-v1:0"`). */
-  readonly model?: string
+  readonly model?: string;
   /** API key for authentication. */
-  readonly apiKey?: string
+  readonly apiKey?: string;
   /**
    * Override base URL. When set, all requests go here and provider
    * auto-detection is skipped.
    */
-  readonly baseUrl?: string
+  readonly baseUrl?: string;
   /** Request timeout, in seconds. */
-  readonly timeoutSecs?: number
+  readonly timeoutSecs?: number;
   /** Maximum number of retries on 429 / 5xx responses. */
-  readonly maxRetries?: number
+  readonly maxRetries?: number;
   /** Sampling temperature for requests built from this config. */
-  readonly temperature?: number
+  readonly temperature?: number;
   /** Maximum number of tokens to generate for requests built from this config. */
-  readonly maxTokens?: number
+  readonly maxTokens?: number;
   /**
    * Automatically load the API key from the provider's environment variable
    * when no explicit key is provided (default: `true`).
    */
-  readonly loadEnv?: boolean
+  readonly loadEnv?: boolean;
   /** Extra headers sent on every request. */
-  readonly headers?: Record<string, string>
+  readonly headers?: Record<string, string>;
   /** Custom provider configurations, in addition to the built-in providers. */
-  readonly providers?: Array<LlmProviderConfig>
+  readonly providers?: Array<LlmProviderConfig>;
   /** Response cache configuration. */
-  readonly cache?: LlmCacheConfig
+  readonly cache?: LlmCacheConfig;
   /** Budget enforcement configuration. */
-  readonly budget?: LlmBudgetConfig
+  readonly budget?: LlmBudgetConfig;
   /** Per-model rate limiting configuration. */
-  readonly rateLimit?: LlmRateLimitConfig
+  readonly rateLimit?: LlmRateLimitConfig;
   /** Global per-client in-flight provider request limit. */
-  readonly inFlightLimit?: LlmInFlightLimitConfig
+  readonly inFlightLimit?: LlmInFlightLimitConfig;
   /** Enable per-request cost tracking. */
-  readonly costTracking?: boolean
+  readonly costTracking?: boolean;
   /** Enable OpenTelemetry-compatible tracing spans. */
-  readonly tracing?: boolean
+  readonly tracing?: boolean;
   /** Cooldown duration after transient errors, in seconds. */
-  readonly cooldownSecs?: number
+  readonly cooldownSecs?: number;
   /** Background health check interval, in seconds. */
-  readonly healthCheckSecs?: number
+  readonly healthCheckSecs?: number;
   /** AWS Bedrock configuration (region, credentials, cross-region routing). */
-  readonly bedrock?: BedrockConfig
+  readonly bedrock?: BedrockConfig;
 }
 
 /** Global per-client in-flight provider request limit. */
 export interface LlmInFlightLimitConfig {
   /** Maximum simultaneously outstanding provider requests. `None` means unlimited. */
-  readonly maxInFlight?: number
+  readonly maxInFlight?: number;
 }
 
 /** A custom provider configuration entry. */
 export interface LlmProviderConfig {
   /** Provider name, used to key model prefix matching. */
-  readonly name?: string
+  readonly name?: string;
   /** Base URL for the provider's OpenAI-compatible API. */
-  readonly baseUrl?: string
+  readonly baseUrl?: string;
   /** Header name used to carry the API key (defaults to `Authorization` when unset). */
-  readonly authHeader?: string
+  readonly authHeader?: string;
   /** Model name prefixes routed to this provider (e.g. `["my-provider/"]`). */
-  readonly modelPrefixes?: Array<string>
+  readonly modelPrefixes?: Array<string>;
 }
 
 /** Per-model rate limiting configuration. */
 export interface LlmRateLimitConfig {
   /** Requests per minute limit. */
-  readonly rpm?: number
+  readonly rpm?: number;
   /** Tokens per minute limit. */
-  readonly tpm?: number
+  readonly tpm?: number;
   /** Rate limit window, in seconds. */
-  readonly windowSeconds?: number
+  readonly windowSeconds?: number;
 }
 
 /** A chat message in a conversation. */
 export type Message =
-  | { role: 'system'; system: SystemMessage }
-  | { role: 'user'; user: UserMessage }
-  | { role: 'assistant'; assistant: AssistantMessage }
-  | { role: 'tool'; tool: ToolMessage }
-  | { role: 'developer'; developer: DeveloperMessage }
-  | { role: 'function'; function: FunctionMessage }
+  | { role: "system"; system: SystemMessage }
+  | { role: "user"; user: UserMessage }
+  | { role: "assistant"; assistant: AssistantMessage }
+  | { role: "tool"; tool: ToolMessage }
+  | { role: "developer"; developer: DeveloperMessage }
+  | { role: "function"; function: FunctionMessage };
 
 /**
  * Output modality requested from the model.
@@ -1364,70 +1367,70 @@ export declare enum Modality {
  */
 export interface ModelInfo {
   /** Cost in USD per input (prompt) token. */
-  readonly inputCostPerToken?: number
+  readonly inputCostPerToken?: number;
   /** Cost in USD per output (completion) token. */
-  readonly outputCostPerToken?: number
+  readonly outputCostPerToken?: number;
   /** Cost in USD per cached input token (cache hit / read). */
-  readonly cacheReadInputTokenCost?: number
+  readonly cacheReadInputTokenCost?: number;
   /** Cost in USD per token written to the prompt cache. */
-  readonly cacheCreationInputTokenCost?: number
+  readonly cacheCreationInputTokenCost?: number;
   /** Cost in USD per input audio token. */
-  readonly inputCostPerAudioToken?: number
+  readonly inputCostPerAudioToken?: number;
   /** Cost in USD per output audio token. */
-  readonly outputCostPerAudioToken?: number
+  readonly outputCostPerAudioToken?: number;
   /** Cost in USD per reasoning (extended-thinking) output token. */
-  readonly outputCostPerReasoningToken?: number
+  readonly outputCostPerReasoningToken?: number;
   /** Total context window size in tokens (input + output). */
-  readonly maxTokens?: number
+  readonly maxTokens?: number;
   /** Maximum input (prompt) tokens accepted. */
-  readonly maxInputTokens?: number
+  readonly maxInputTokens?: number;
   /** Maximum output (completion) tokens the model can generate. */
-  readonly maxOutputTokens?: number
+  readonly maxOutputTokens?: number;
   /** Best-effort operating mode, e.g. `"chat"`, `"embedding"`. */
-  readonly mode?: string
+  readonly mode?: string;
   /** The model accepts image input. */
-  readonly supportsVision?: boolean
+  readonly supportsVision?: boolean;
   /** The model supports tool / function calling. */
-  readonly supportsFunctionCalling?: boolean
+  readonly supportsFunctionCalling?: boolean;
   /** The model supports extended-thinking / reasoning tokens. */
-  readonly supportsReasoning?: boolean
+  readonly supportsReasoning?: boolean;
   /** The model supports JSON-mode or `response_format` structured output. */
-  readonly supportsStructuredOutput?: boolean
+  readonly supportsStructuredOutput?: boolean;
   /** The model accepts audio input. */
-  readonly supportsAudioInput?: boolean
+  readonly supportsAudioInput?: boolean;
   /** The model can generate audio output. */
-  readonly supportsAudioOutput?: boolean
+  readonly supportsAudioOutput?: boolean;
   /** The model supports prompt caching. */
-  readonly supportsPromptCaching?: boolean
+  readonly supportsPromptCaching?: boolean;
   /**
    * Context-tiered pricing overrides, sorted by ascending
    * `min_context_tokens`. Empty when the model has flat pricing.
    */
-  readonly tiers?: Array<ModelTier>
+  readonly tiers?: Array<ModelTier>;
 }
 
 /** A model available from the API. */
 export interface ModelObject {
   /** Model ID (e.g., `"gpt-4o"`, `"claude-3-5-sonnet"`). */
-  readonly id?: string
+  readonly id?: string;
   /**
    * Always `"model"` from OpenAI-compatible APIs.  Stored as a plain
    * `String` so non-standard provider values do not break deserialization.
    * Defaults to empty when a provider omits the field.
    */
-  readonly object?: string
+  readonly object?: string;
   /**
    * Unix timestamp of model creation (or release date).
    *
    * Defaults to `0` when a provider omits it — DeepSeek and some other
    * OpenAI-compatible providers do not return `created` from `/v1/models`.
    */
-  readonly created?: number
+  readonly created?: number;
   /**
    * Organization or entity that owns the model.
    * Defaults to empty when a provider omits the field.
    */
-  readonly ownedBy?: string
+  readonly ownedBy?: string;
 }
 
 /** Response listing available models. */
@@ -1437,9 +1440,9 @@ export interface ModelsListResponse {
    * `String` so non-standard provider values do not break deserialization.
    * Defaults to empty when a provider omits the field.
    */
-  readonly object?: string
+  readonly object?: string;
   /** List of available models. */
-  readonly data?: Array<ModelObject>
+  readonly data?: Array<ModelObject>;
 }
 
 /**
@@ -1451,161 +1454,157 @@ export interface ModelTier {
    * The tier applies when the prompt/context token count is at least
    * this value.
    */
-  readonly minContextTokens?: number
+  readonly minContextTokens?: number;
   /** Cost in USD per input (prompt) token within this tier. */
-  readonly inputCostPerToken?: number
+  readonly inputCostPerToken?: number;
   /** Cost in USD per output (completion) token within this tier. */
-  readonly outputCostPerToken?: number
+  readonly outputCostPerToken?: number;
   /** Cost in USD per cached input token within this tier. */
-  readonly cacheReadInputTokenCost?: number
+  readonly cacheReadInputTokenCost?: number;
   /** Cost in USD per cache-write token within this tier. */
-  readonly cacheCreationInputTokenCost?: number
+  readonly cacheCreationInputTokenCost?: number;
   /** Cost in USD per input audio token within this tier. */
-  readonly inputCostPerAudioToken?: number
+  readonly inputCostPerAudioToken?: number;
   /** Cost in USD per output audio token within this tier. */
-  readonly outputCostPerAudioToken?: number
+  readonly outputCostPerAudioToken?: number;
   /** Cost in USD per reasoning output token within this tier. */
-  readonly outputCostPerReasoningToken?: number
+  readonly outputCostPerReasoningToken?: number;
 }
 
 /** Boolean flags for each moderation category. */
 export interface ModerationCategories {
   /** Sexual content. */
-  readonly sexual?: boolean
+  readonly sexual?: boolean;
   /** Hate speech. */
-  readonly hate?: boolean
+  readonly hate?: boolean;
   /** Harassment. */
-  readonly harassment?: boolean
+  readonly harassment?: boolean;
   /** Self-harm content. */
-  readonly selfHarm?: boolean
+  readonly selfHarm?: boolean;
   /** Sexual content involving minors. */
-  readonly sexualMinors?: boolean
+  readonly sexualMinors?: boolean;
   /** Hate speech that threatens violence. */
-  readonly hateThreatening?: boolean
+  readonly hateThreatening?: boolean;
   /** Graphic violence. */
-  readonly violenceGraphic?: boolean
+  readonly violenceGraphic?: boolean;
   /** Intent to self-harm. */
-  readonly selfHarmIntent?: boolean
+  readonly selfHarmIntent?: boolean;
   /** Instructions for self-harm. */
-  readonly selfHarmInstructions?: boolean
+  readonly selfHarmInstructions?: boolean;
   /** Harassment that threatens violence. */
-  readonly harassmentThreatening?: boolean
+  readonly harassmentThreatening?: boolean;
   /** Non-graphic violence. */
-  readonly violence?: boolean
+  readonly violence?: boolean;
 }
 
 /** Confidence scores for each moderation category. */
 export interface ModerationCategoryScores {
   /** Sexual content score. */
-  readonly sexual?: number
+  readonly sexual?: number;
   /** Hate speech score. */
-  readonly hate?: number
+  readonly hate?: number;
   /** Harassment score. */
-  readonly harassment?: number
+  readonly harassment?: number;
   /** Self-harm content score. */
-  readonly selfHarm?: number
+  readonly selfHarm?: number;
   /** Sexual content involving minors score. */
-  readonly sexualMinors?: number
+  readonly sexualMinors?: number;
   /** Hate speech that threatens violence score. */
-  readonly hateThreatening?: number
+  readonly hateThreatening?: number;
   /** Graphic violence score. */
-  readonly violenceGraphic?: number
+  readonly violenceGraphic?: number;
   /** Intent to self-harm score. */
-  readonly selfHarmIntent?: number
+  readonly selfHarmIntent?: number;
   /** Instructions for self-harm score. */
-  readonly selfHarmInstructions?: number
+  readonly selfHarmInstructions?: number;
   /** Harassment that threatens violence score. */
-  readonly harassmentThreatening?: number
+  readonly harassmentThreatening?: number;
   /** Non-graphic violence score. */
-  readonly violence?: number
+  readonly violence?: number;
 }
 
 /** Input to the moderation endpoint — a single string or multiple strings. */
-export type ModerationInput =
-  | string
-  | Array<string>
+export type ModerationInput = string | Array<string>;
 
 /** Request to classify content for policy violations. */
 export interface ModerationRequest {
   /** Text or texts to check. */
-  readonly input?: ModerationInput
+  readonly input?: ModerationInput;
   /** Model ID (e.g., `"text-moderation-latest"`). Optional; API uses default if unset. */
-  readonly model?: string
+  readonly model?: string;
 }
 
 /** Response from the moderation endpoint. */
 export interface ModerationResponse {
   /** Unique identifier for this moderation request. */
-  readonly id: string
+  readonly id: string;
   /** Model used for classification. */
-  readonly model: string
+  readonly model: string;
   /** Results for each input string. */
-  readonly results: Array<ModerationResult>
+  readonly results: Array<ModerationResult>;
 }
 
 /** A single moderation classification result. */
 export interface ModerationResult {
   /** True if any category was flagged. */
-  readonly flagged: boolean
+  readonly flagged: boolean;
   /** Boolean flags for each moderation category. */
-  readonly categories: ModerationCategories
+  readonly categories: ModerationCategories;
   /** Confidence scores for each category. */
-  readonly categoryScores: ModerationCategoryScores
+  readonly categoryScores: ModerationCategoryScores;
 }
 
 /** Document input for OCR — either a URL or inline base64 data. */
-export type OcrDocument =
-  | { type: 'document_url'; url: string }
-  | { type: 'base64'; data: string; mediaType: string }
+export type OcrDocument = { type: "document_url"; url: string } | { type: "base64"; data: string; mediaType: string };
 
 /** An image extracted from an OCR page. */
 export interface OcrImage {
   /** Unique image identifier within the document. */
-  readonly id: string
+  readonly id: string;
   /** Base64-encoded image data (if `include_image_base64` was true). */
-  readonly imageBase64?: string
+  readonly imageBase64?: string;
 }
 
 /** A single page of OCR output. */
 export interface OcrPage {
   /** Page index (0-based). */
-  readonly index: number
+  readonly index: number;
   /** Extracted page content as Markdown. */
-  readonly markdown: string
+  readonly markdown: string;
   /** Embedded images extracted from the page (if `include_image_base64` was true). */
-  readonly images?: Array<OcrImage>
+  readonly images?: Array<OcrImage>;
   /** Page dimensions in pixels, if available. */
-  readonly dimensions?: PageDimensions
+  readonly dimensions?: PageDimensions;
 }
 
 /** An OCR request. */
 export interface OcrRequest {
   /** The model/provider to use (e.g. `"mistral/mistral-ocr-latest"`). */
-  readonly model?: string
+  readonly model?: string;
   /** The document to process (URL or base64). */
-  readonly document?: OcrDocument
+  readonly document?: OcrDocument;
   /** Specific pages to process (1-indexed). `None` means all pages. */
-  readonly pages?: Array<number>
+  readonly pages?: Array<number>;
   /** Whether to include base64-encoded images of each processed page. */
-  readonly includeImageBase64?: boolean
+  readonly includeImageBase64?: boolean;
 }
 
 /** An OCR response. */
 export interface OcrResponse {
   /** Extracted pages in order. */
-  readonly pages: Array<OcrPage>
+  readonly pages: Array<OcrPage>;
   /** Model/provider used for OCR. */
-  readonly model: string
+  readonly model: string;
   /** Token usage, if reported by the provider. */
-  readonly usage?: Usage
+  readonly usage?: Usage;
 }
 
 /** Page dimensions in pixels. */
 export interface PageDimensions {
   /** Width in pixels. */
-  readonly width: number
+  readonly width: number;
   /** Height in pixels. */
-  readonly height: number
+  readonly height: number;
 }
 
 /**
@@ -1618,9 +1617,9 @@ export interface PageDimensions {
  */
 export interface PromptTokensDetails {
   /** Cached tokens present in the prompt. Defaults to 0 when absent. */
-  readonly cachedTokens?: number
+  readonly cachedTokens?: number;
   /** Audio input tokens present in the prompt. Defaults to 0 when absent. */
-  readonly audioTokens?: number
+  readonly audioTokens?: number;
 }
 
 /**
@@ -1638,19 +1637,19 @@ export interface PromptTokensDetails {
  */
 export interface ProviderCapabilities {
   /** The provider accepts image input in chat messages. */
-  readonly vision?: boolean
+  readonly vision?: boolean;
   /** The provider supports extended-thinking / reasoning tokens. */
-  readonly reasoning?: boolean
+  readonly reasoning?: boolean;
   /** The provider supports JSON-mode or `response_format` structured output. */
-  readonly structuredOutput?: boolean
+  readonly structuredOutput?: boolean;
   /** The provider supports tool / function calling. */
-  readonly functionCalling?: boolean
+  readonly functionCalling?: boolean;
   /** The provider accepts audio as input. */
-  readonly audioIn?: boolean
+  readonly audioIn?: boolean;
   /** The provider can generate audio / TTS output. */
-  readonly audioOut?: boolean
+  readonly audioOut?: boolean;
   /** The provider accepts video as input. */
-  readonly videoIn?: boolean
+  readonly videoIn?: boolean;
 }
 
 /**
@@ -1661,17 +1660,17 @@ export interface ProviderCapabilities {
  */
 export interface ProviderConfig {
   /** Provider identifier (matches the entry key in providers.json). */
-  readonly name: string
+  readonly name: string;
   /** Human-readable provider name shown in UIs. */
-  readonly displayName?: string
+  readonly displayName?: string;
   /** Base URL used as the default for this provider's HTTP client. */
-  readonly baseUrl?: string
+  readonly baseUrl?: string;
   /** Authentication scheme metadata (auth type + env var holding the key). */
-  readonly auth?: AuthConfig
+  readonly auth?: AuthConfig;
   /** Supported endpoint kinds (e.g. `chat`, `embeddings`). */
-  readonly endpoints?: Array<string>
+  readonly endpoints?: Array<string>;
   /** Model-name prefixes claimed by this provider (e.g. `["gpt-", "o1-"]`). */
-  readonly modelPrefixes?: Array<string>
+  readonly modelPrefixes?: Array<string>;
   /**
    * Parameter key renaming for this provider.
    *
@@ -1679,17 +1678,17 @@ export interface ProviderConfig {
    * to the name this provider expects (e.g. `"max_tokens"`).  Applied
    * automatically by `ConfigDrivenProvider.transform_request`.
    */
-  readonly paramMappings?: Record<string, string>
+  readonly paramMappings?: Record<string, string>;
 }
 
 /** Configuration for per-model rate limits. */
 export interface RateLimitConfig {
   /** Maximum requests per window.  `None` means unlimited. */
-  readonly rpm?: number
+  readonly rpm?: number;
   /** Maximum tokens per window.  `None` means unlimited. */
-  readonly tpm?: number
+  readonly tpm?: number;
   /** Fixed window duration (defaults to 60 s). */
-  readonly window?: number
+  readonly window?: number;
 }
 
 /** Controls how much reasoning effort the model should use. */
@@ -1722,48 +1721,46 @@ export declare enum RefreshOutcome {
 }
 
 /** A document to be reranked — either a plain string or an object with a text field. */
-export type RerankDocument =
-  | string
-  | { text: string }
+export type RerankDocument = string | { text: string };
 
 /** Request to rerank documents by relevance to a query. */
 export interface RerankRequest {
   /** Model ID (e.g., `"cohere/rerank-english-v3.0"`). */
-  readonly model?: string
+  readonly model?: string;
   /** The search query. */
-  readonly query?: string
+  readonly query?: string;
   /** Documents to rerank. */
-  readonly documents?: Array<RerankDocument>
+  readonly documents?: Array<RerankDocument>;
   /** Return only the top N results. Optional. */
-  readonly topN?: number
+  readonly topN?: number;
   /** Include the document content in results. Defaults to false. */
-  readonly returnDocuments?: boolean
+  readonly returnDocuments?: boolean;
 }
 
 /** Response from the rerank endpoint. */
 export interface RerankResponse {
   /** Unique identifier for this rerank request. */
-  readonly id?: string
+  readonly id?: string;
   /** Reranked documents in order of relevance. */
-  readonly results: Array<RerankResult>
+  readonly results: Array<RerankResult>;
   /** Optional metadata about the reranking operation. */
-  readonly meta?: JsonValue
+  readonly meta?: JsonValue;
 }
 
 /** A single reranked document with its relevance score. */
 export interface RerankResult {
   /** Original document index in the input list. */
-  readonly index: number
+  readonly index: number;
   /** Relevance score in `[0, 1]`. Higher indicates more relevant. */
-  readonly relevanceScore: number
+  readonly relevanceScore: number;
   /** Original document content (if `return_documents` was true). */
-  readonly document?: RerankResultDocument
+  readonly document?: RerankResultDocument;
 }
 
 /** The text content of a reranked document, returned when `return_documents` is true. */
 export interface RerankResultDocument {
   /** Document text. */
-  readonly text: string
+  readonly text: string;
 }
 
 /**
@@ -1785,88 +1782,88 @@ export interface RerankResultDocument {
  *   returned JSON if the schema is load-bearing.
  */
 export type ResponseFormat =
-  | { type: 'text' }
-  | { type: 'json_object' }
-  | { type: 'json_schema'; jsonSchema: JsonSchemaFormat }
+  | { type: "text" }
+  | { type: "json_object" }
+  | { type: "json_schema"; jsonSchema: JsonSchemaFormat };
 
 /** Response from a structured response request. */
 export interface ResponseObject {
   /** Unique response ID. */
-  readonly id?: string
+  readonly id?: string;
   /** Object type (e.g., `"response"`). */
-  readonly object?: string
+  readonly object?: string;
   /** Unix timestamp of response creation. */
-  readonly createdAt?: number
+  readonly createdAt?: number;
   /** Model used to generate the response. */
-  readonly model?: string
+  readonly model?: string;
   /** Status (e.g., `"succeeded"`, `"failed"`). */
-  readonly status?: string
+  readonly status?: string;
   /** Output items from the response. */
-  readonly output?: Array<ResponseOutputItem>
+  readonly output?: Array<ResponseOutputItem>;
   /** Token usage. */
-  readonly usage?: ResponseUsage
+  readonly usage?: ResponseUsage;
   /** Error details (if status is "failed"). */
-  readonly error?: JsonValue
+  readonly error?: JsonValue;
 }
 
 /** A single output item from the response. */
 export interface ResponseOutputItem {
   /** Output type (e.g., `"text"`, `"object"`, `"error"`). */
-  readonly itemType?: string
+  readonly itemType?: string;
   /** Output content (flattened into the object). */
-  readonly content?: JsonValue
+  readonly content?: JsonValue;
 }
 
 /** A tool available for the response request. */
 export interface ResponseTool {
   /** Tool type (e.g., "extractor", "search"). */
-  readonly toolType?: string
+  readonly toolType?: string;
   /** Tool configuration (flattened into the object). */
-  readonly config?: JsonValue
+  readonly config?: JsonValue;
 }
 
 /** Token usage for a response. */
 export interface ResponseUsage {
   /** Input tokens used. */
-  readonly inputTokens?: number
+  readonly inputTokens?: number;
   /** Output tokens used. */
-  readonly outputTokens?: number
+  readonly outputTokens?: number;
   /** Total tokens used. */
-  readonly totalTokens?: number
+  readonly totalTokens?: number;
 }
 
 /** A search request. */
 export interface SearchRequest {
   /** The model/provider to use (e.g. `"brave/web-search"`, `"tavily/search"`). */
-  readonly model?: string
+  readonly model?: string;
   /** The search query string. */
-  readonly query?: string
+  readonly query?: string;
   /** Maximum number of results to return. */
-  readonly maxResults?: number
+  readonly maxResults?: number;
   /** Domain filter — restrict results to specific domains. */
-  readonly searchDomainFilter?: Array<string>
+  readonly searchDomainFilter?: Array<string>;
   /** Country code for localized results (ISO 3166-1 alpha-2, e.g., `"US"`, `"FR"`). */
-  readonly country?: string
+  readonly country?: string;
 }
 
 /** A search response. */
 export interface SearchResponse {
   /** List of search results. */
-  readonly results: Array<SearchResult>
+  readonly results: Array<SearchResult>;
   /** Model/provider that performed the search. */
-  readonly model: string
+  readonly model: string;
 }
 
 /** An individual search result. */
 export interface SearchResult {
   /** Result title. */
-  readonly title: string
+  readonly title: string;
   /** Result URL. */
-  readonly url: string
+  readonly url: string;
   /** Text snippet or excerpt from the page. */
-  readonly snippet: string
+  readonly snippet: string;
   /** Publication or last-updated date, if available. */
-  readonly date?: string
+  readonly date?: string;
 }
 
 /**
@@ -1875,52 +1872,49 @@ export interface SearchResult {
  * The error value is shared so every follower receives the same upstream
  * failure without cloning the underlying error.
  */
-export declare class SingleflightResult {
-}
+export declare class SingleflightResult {}
 
 /** Name of the specific function to invoke. */
 export interface SpecificFunction {
   /** Function name. */
-  readonly name?: string
+  readonly name?: string;
 }
 
 /** Directive to call a specific tool. */
 export interface SpecificToolChoice {
   /** Tool type (always "function"). */
-  readonly choiceType?: ToolType
+  readonly choiceType?: ToolType;
   /** The specific function to invoke. */
-  readonly function?: SpecificFunction
+  readonly function?: SpecificFunction;
 }
 
 /** Stop sequence(s) that cause the model to stop generating. */
-export type StopSequence =
-  | string
-  | Array<string>
+export type StopSequence = string | Array<string>;
 
 /** A streaming choice with incremental delta. */
 export interface StreamChoice {
   /** Index of this choice in the choices array. */
-  readonly index?: number
+  readonly index?: number;
   /** Incremental update to the message (content, tool calls, etc.). */
-  readonly delta?: StreamDelta
+  readonly delta?: StreamDelta;
   /** Why the stream ended (present only in final chunk). */
-  readonly finishReason?: FinishReason
+  readonly finishReason?: FinishReason;
 }
 
 /** Incremental delta in a stream chunk. */
 export interface StreamDelta {
   /** Role (typically present only in the first chunk). */
-  readonly role?: string
+  readonly role?: string;
   /** Partial content chunk (e.g., a few words of the response). */
-  readonly content?: string
+  readonly content?: string;
   /** Partial tool calls being streamed. */
-  readonly toolCalls?: Array<StreamToolCall>
+  readonly toolCalls?: Array<StreamToolCall>;
   /** Deprecated legacy function_call delta; retained for API compatibility. */
-  readonly functionCall?: StreamFunctionCall
+  readonly functionCall?: StreamFunctionCall;
   /** Partial refusal message. */
-  readonly refusal?: string
+  readonly refusal?: string;
   /** Partial reasoning/thinking tokens (OpenAI-compatible extension used by DeepSeek R1, Qwen, etc.). */
-  readonly reasoningContent?: string
+  readonly reasoningContent?: string;
 }
 
 /**
@@ -1941,27 +1935,27 @@ export declare enum StreamFormat {
 /** Partial function call details in a stream. */
 export interface StreamFunctionCall {
   /** Function name (typically in the first chunk). */
-  readonly name?: string
+  readonly name?: string;
   /** Partial JSON arguments chunk. */
-  readonly arguments?: string
+  readonly arguments?: string;
 }
 
 /** Options for streaming responses. */
 export interface StreamOptions {
   /** If true, include token usage in the final stream chunk. */
-  readonly includeUsage?: boolean
+  readonly includeUsage?: boolean;
 }
 
 /** A streaming tool call being built incrementally. */
 export interface StreamToolCall {
   /** Index of this tool call in the tool_calls array. */
-  readonly index?: number
+  readonly index?: number;
   /** Tool call ID (typically in the first chunk for this call). */
-  readonly id?: string
+  readonly id?: string;
   /** Tool type (typically "function"). */
-  readonly callType?: ToolType
+  readonly callType?: ToolType;
   /** Partial function name and arguments. */
-  readonly function?: StreamFunctionCall
+  readonly function?: StreamFunctionCall;
 }
 
 /** System message guiding model behavior for the entire conversation. */
@@ -1972,25 +1966,23 @@ export interface SystemMessage {
    * Accepts either a plain text string or an array of content parts,
    * mirroring `UserContent` so that `Message.system_with_parts` works.
    */
-  readonly content?: UserContent
+  readonly content?: UserContent;
   /** Optional name for the system message source. */
-  readonly name?: string
+  readonly name?: string;
 }
 
 /** A tool call the model wants to execute. */
 export interface ToolCall {
   /** Unique ID for this call, used to reference in tool result messages. */
-  readonly id: string
+  readonly id: string;
   /** Tool type (always "function"). */
-  readonly callType: ToolType
+  readonly callType: ToolType;
   /** Function name and arguments. */
-  readonly function: FunctionCall
+  readonly function: FunctionCall;
 }
 
 /** Tool usage mode or a specific tool to call. */
-export type ToolChoice =
-  | __AlefWireToolChoiceMode
-  | __AlefWireSpecificToolChoice
+export type ToolChoice = __AlefWireToolChoiceMode | __AlefWireSpecificToolChoice;
 
 /** Tool choice mode. */
 export declare enum ToolChoiceMode {
@@ -2012,11 +2004,11 @@ export interface ToolMessage {
    * deserialises into `Text`, so tool results persisted before this field
    * carried structured content continue to round-trip.
    */
-  readonly content?: UserContent
+  readonly content?: UserContent;
   /** ID of the tool call this result responds to. */
-  readonly toolCallId?: string
+  readonly toolCallId?: string;
   /** Optional tool/function name. */
-  readonly name?: string
+  readonly name?: string;
 }
 
 /**
@@ -2033,54 +2025,52 @@ export declare enum ToolType {
 /** Response from a transcription request. */
 export interface TranscriptionResponse {
   /** The transcribed text. */
-  readonly text?: string
+  readonly text?: string;
   /** Detected language (ISO-639-1 code). */
-  readonly language?: string
+  readonly language?: string;
   /** Total audio duration in seconds. */
-  readonly duration?: number
+  readonly duration?: number;
   /** Detailed segment-level transcription (if response_format is "verbose_json"). */
-  readonly segments?: Array<TranscriptionSegment>
+  readonly segments?: Array<TranscriptionSegment>;
 }
 
 /** A segment of transcribed audio with timing information. */
 export interface TranscriptionSegment {
   /** Segment index (0-based). */
-  readonly id?: number
+  readonly id?: number;
   /** Start time in seconds. */
-  readonly start?: number
+  readonly start?: number;
   /** End time in seconds. */
-  readonly end?: number
+  readonly end?: number;
   /** Transcribed text for this segment. */
-  readonly text?: string
+  readonly text?: string;
 }
 
 /** Token-usage accounting returned by the provider on each completion / embedding call. */
 export interface Usage {
   /** Prompt tokens used. Defaults to 0 when absent (some providers omit this). */
-  readonly promptTokens?: number
+  readonly promptTokens?: number;
   /** Completion tokens used. Defaults to 0 when absent (e.g. embedding responses). */
-  readonly completionTokens?: number
+  readonly completionTokens?: number;
   /** Total tokens used. Defaults to 0 when absent (some providers omit this). */
-  readonly totalTokens?: number
+  readonly totalTokens?: number;
   /**
    * Breakdown of tokens used in the prompt, including cached tokens served
    * at the provider's discounted cache-read rate. Absent when the provider
    * does not return prompt-token details.
    */
-  readonly promptTokensDetails?: PromptTokensDetails
+  readonly promptTokensDetails?: PromptTokensDetails;
 }
 
 /** User message content as either plain text or a list of multimodal parts. */
-export type UserContent =
-  | string
-  | Array<__AlefWireContentPart>
+export type UserContent = string | Array<__AlefWireContentPart>;
 
 /** User message in the conversation. */
 export interface UserMessage {
   /** Message content as plain text or array of content parts (text, images, documents, audio). */
-  readonly content?: UserContent
+  readonly content?: UserContent;
   /** Optional name for the user. */
-  readonly name?: string
+  readonly name?: string;
 }
 
 /**
@@ -2091,13 +2081,13 @@ export interface UserMessage {
  */
 export interface WaitForBatchConfig {
   /** Initial interval between polls, in seconds. */
-  readonly initialIntervalSecs?: number
+  readonly initialIntervalSecs?: number;
   /** Maximum interval between polls (backoff plateau), in seconds. */
-  readonly maxIntervalSecs?: number
+  readonly maxIntervalSecs?: number;
   /** Exponential backoff multiplier (e.g., 1.5 increases delay by 50% each poll). */
-  readonly backoffMultiplier?: number
+  readonly backoffMultiplier?: number;
   /** Optional timeout in seconds — polling fails if this duration is exceeded. */
-  readonly timeoutSecs?: number
+  readonly timeoutSecs?: number;
 }
 
 /**
@@ -2167,25 +2157,36 @@ export declare function registerCustomProvider(config: CustomProviderConfig): vo
  */
 export declare function unregisterCustomProvider(name: string): boolean;
 export type __AlefWireImageDetail = "low" | "high" | "auto";
-export type __AlefWireImageUrl = { url: string; detail?: (__AlefWireImageDetail | null) };
+export type __AlefWireImageUrl = { url: string; detail?: __AlefWireImageDetail | null };
 export type __AlefWireAudioContent = { data: string; format: string };
-export type __AlefWireAssistantPart = ({ type: "text" } & { text: string }) | ({ type: "refusal" } & { refusal: string }) | ({ type: "output_image" } & { image_url: __AlefWireImageUrl }) | ({ type: "output_audio" } & { audio: __AlefWireAudioContent });
-export type __AlefWireEmbeddingContentPart = ({ type: "text" } & { text: string }) | ({ type: "image_url" } & { image_url: __AlefWireImageUrl }) | ({ type: "image_base64" } & { image_base64: string });
+export type __AlefWireAssistantPart =
+  | ({ type: "text" } & { text: string })
+  | ({ type: "refusal" } & { refusal: string })
+  | ({ type: "output_image" } & { image_url: __AlefWireImageUrl })
+  | ({ type: "output_audio" } & { audio: __AlefWireAudioContent });
+export type __AlefWireEmbeddingContentPart =
+  | ({ type: "text" } & { text: string })
+  | ({ type: "image_url" } & { image_url: __AlefWireImageUrl })
+  | ({ type: "image_base64" } & { image_base64: string });
 export type __AlefWireToolChoiceMode = "auto" | "required" | "none";
 export type __AlefWireToolType = "function";
 export type __AlefWireSpecificFunction = { name: string };
-export type __AlefWireSpecificToolChoice = { type: __AlefWireToolType; "function": __AlefWireSpecificFunction };
+export type __AlefWireSpecificToolChoice = { type: __AlefWireToolType; function: __AlefWireSpecificFunction };
 export type __AlefWireDocumentContent = { data: string; media_type: string };
-export type __AlefWireContentPart = ({ type: "text" } & { text: string }) | ({ type: "image_url" } & { image_url: __AlefWireImageUrl }) | ({ type: "document" } & { document: __AlefWireDocumentContent }) | ({ type: "input_audio" } & { input_audio: __AlefWireAudioContent });
+export type __AlefWireContentPart =
+  | ({ type: "text" } & { text: string })
+  | ({ type: "image_url" } & { image_url: __AlefWireImageUrl })
+  | ({ type: "document" } & { document: __AlefWireDocumentContent })
+  | ({ type: "input_audio" } & { input_audio: __AlefWireAudioContent });
 
 export declare class ChatStreamIterator {
-  next(value?: undefined): Promise<IteratorResult<ChatCompletionChunk, void>>
-  [Symbol.asyncIterator](): AsyncGenerator<ChatCompletionChunk, void, undefined>
+  next(value?: undefined): Promise<IteratorResult<ChatCompletionChunk, void>>;
+  [Symbol.asyncIterator](): AsyncGenerator<ChatCompletionChunk, void, undefined>;
 }
 
 export declare class LiterLlmErrorInfo {
-  code(): number
-  statusCode(): number
-  isTransient(): boolean
-  errorType(): string
+  code(): number;
+  statusCode(): number;
+  isTransient(): boolean;
+  errorType(): string;
 }