@yourgpt/llm-sdk 2.6.0-beta.2 → 2.6.0

package/dist/audio-K-Z3-Bce.d.mts

@@ -0,0 +1,191 @@
+interface ImageFile {
+    data: Uint8Array | ArrayBuffer | Blob;
+    mediaType: "image/png" | "image/jpeg" | "image/webp";
+}
+interface ImageOptions {
+    prompt: string;
+    n?: number;
+    size?: "auto" | `${number}x${number}`;
+    /** Supplying images switches to image editing. URLs are never fetched implicitly. */
+    images?: ImageFile[];
+    mask?: ImageFile;
+    signal?: AbortSignal;
+    timeoutMs?: number;
+    providerOptions?: Record<string, Record<string, unknown>>;
+}
+interface GeneratedImage {
+    uint8Array: Uint8Array;
+    readonly base64: string;
+    mediaType: string;
+    revisedPrompt?: string;
+}
+interface ImageResult {
+    image: GeneratedImage;
+    images: GeneratedImage[];
+    usage?: Record<string, unknown>;
+    response: {
+        provider: string;
+        modelId: string;
+        requestId?: string;
+        status: number;
+    };
+    providerMetadata?: Record<string, unknown>;
+}
+interface ImageModel {
+    readonly provider: string;
+    readonly modelId: string;
+    doGenerate(options: ImageOptions): Promise<ImageResult>;
+}
+declare function generateImage({ model, ...options }: ImageOptions & {
+    model: ImageModel;
+}): Promise<ImageResult>;
+declare const marker: unique symbol;
+/** Errors from image and realtime setup requests. Provider bodies and credentials are not retained. */
+declare class MediaAPIError extends Error {
+    readonly code: "invalid_input" | "unsupported_option" | "invalid_response" | "http_error" | "network_error";
+    readonly status?: number | undefined;
+    readonly requestId?: string | undefined;
+    readonly [marker] = true;
+    readonly name = "MediaAPIError";
+    static [Symbol.hasInstance](value: unknown): boolean;
+    constructor(message: string, code: "invalid_input" | "unsupported_option" | "invalid_response" | "http_error" | "network_error", status?: number | undefined, requestId?: string | undefined);
+}
+
+interface RealtimeToolDefinition {
+    name: string;
+    description?: string;
+    parameters: Record<string, unknown>;
+}
+interface RealtimeSessionOptions {
+    instructions?: string;
+    voice?: string;
+    transcriptionModel?: string;
+    language?: string;
+    outputModality?: "audio" | "text";
+    turnDetection?: {
+        type: "server_vad";
+        threshold?: number;
+        silenceDurationMs?: number;
+        prefixPaddingMs?: number;
+    } | {
+        type: "semantic_vad";
+        eagerness?: "auto" | "low" | "medium" | "high";
+    } | null;
+    tools?: RealtimeToolDefinition[];
+    maxOutputTokens?: number | "inf";
+    safetyIdentifier?: string;
+    signal?: AbortSignal;
+    timeoutMs?: number;
+}
+/** Short-lived credential, not a persisted session or a server authorization policy. */
+interface RealtimeClientSecret {
+    value: string;
+    expiresAt: number;
+    modelId: string;
+}
+interface RealtimeModel {
+    readonly provider: string;
+    readonly modelId: string;
+    createClientSecret(options?: RealtimeSessionOptions & {
+        expiresAfterSeconds?: number;
+    }): Promise<RealtimeClientSecret>;
+    /** Exchange a browser SDP offer on your authenticated server. Returns no credentials. */
+    createCall(options: RealtimeSessionOptions & {
+        sdp: string;
+    }): Promise<{
+        sdp: string;
+    }>;
+}
+
+/** Audio models are independent of chat models and chat streaming events. */
+type SpeechFormat = "mp3" | "opus" | "aac" | "flac" | "wav" | "pcm";
+interface AudioResponseMetadata {
+    provider: string;
+    modelId: string;
+    requestId?: string;
+    status?: number;
+}
+interface AudioWarning {
+    code: string;
+    message: string;
+}
+interface SpeechOptions {
+    text: string;
+    voice?: string;
+    outputFormat?: SpeechFormat;
+    speed?: number;
+    instructions?: string;
+    signal?: AbortSignal;
+    providerOptions?: Record<string, Record<string, unknown>>;
+}
+interface GeneratedSpeech {
+    audio: {
+        uint8Array: Uint8Array;
+        readonly base64: string;
+        mediaType: string;
+        format: SpeechFormat;
+    };
+    response: AudioResponseMetadata;
+    warnings: AudioWarning[];
+    usage?: Record<string, unknown>;
+}
+interface SpeechModel {
+    readonly provider: string;
+    readonly modelId: string;
+    doGenerate(options: SpeechOptions): Promise<GeneratedSpeech>;
+}
+interface TranscriptionOptions {
+    /** Recorded file bytes, base64, or a Blob. URLs and raw PCM are not fetched/decoded. */
+    audio: Uint8Array | ArrayBuffer | Blob | string;
+    mediaType?: string;
+    filename?: string;
+    language?: string;
+    prompt?: string;
+    signal?: AbortSignal;
+    providerOptions?: Record<string, Record<string, unknown>>;
+}
+interface TranscriptSegment {
+    text: string;
+    start: number;
+    end: number;
+    speaker?: string;
+}
+interface TranscriptionResult {
+    text: string;
+    language?: string;
+    durationSeconds?: number;
+    segments?: TranscriptSegment[];
+    words?: Array<{
+        word: string;
+        start: number;
+        end: number;
+    }>;
+    response: AudioResponseMetadata;
+    warnings: AudioWarning[];
+    usage?: Record<string, unknown>;
+    /** Provider-supplied extras, including log probabilities when requested. */
+    providerMetadata?: Record<string, unknown>;
+}
+interface TranscriptionModel {
+    readonly provider: string;
+    readonly modelId: string;
+    doTranscribe(options: TranscriptionOptions): Promise<TranscriptionResult>;
+}
+declare const audioErrorMarker: unique symbol;
+declare class AudioAPIError extends Error {
+    readonly code: "invalid_input" | "unsupported_option" | "provider_error" | "invalid_response" | "network_error";
+    readonly status?: number | undefined;
+    readonly requestId?: string | undefined;
+    readonly [audioErrorMarker] = true;
+    static [Symbol.hasInstance](value: unknown): boolean;
+    readonly name = "AudioAPIError";
+    constructor(message: string, code: "invalid_input" | "unsupported_option" | "provider_error" | "invalid_response" | "network_error", status?: number | undefined, requestId?: string | undefined);
+}
+declare function generateSpeech({ model, ...options }: SpeechOptions & {
+    model: SpeechModel;
+}): Promise<GeneratedSpeech>;
+declare function transcribe({ model, ...options }: TranscriptionOptions & {
+    model: TranscriptionModel;
+}): Promise<TranscriptionResult>;
+
+export { AudioAPIError as A, type GeneratedImage as G, type ImageFile as I, MediaAPIError as M, type RealtimeToolDefinition as R, type SpeechModel as S, type TranscriptionModel as T, type ImageOptions as a, type ImageResult as b, type ImageModel as c, type RealtimeSessionOptions as d, type RealtimeClientSecret as e, type RealtimeModel as f, generateImage as g, generateSpeech as h, type SpeechOptions as i, type TranscriptionOptions as j, type GeneratedSpeech as k, type TranscriptionResult as l, type SpeechFormat as m, type TranscriptSegment as n, type AudioResponseMetadata as o, type AudioWarning as p, transcribe as t };

package/dist/audio-K-Z3-Bce.d.ts

@@ -0,0 +1,191 @@
+interface ImageFile {
+    data: Uint8Array | ArrayBuffer | Blob;
+    mediaType: "image/png" | "image/jpeg" | "image/webp";
+}
+interface ImageOptions {
+    prompt: string;
+    n?: number;
+    size?: "auto" | `${number}x${number}`;
+    /** Supplying images switches to image editing. URLs are never fetched implicitly. */
+    images?: ImageFile[];
+    mask?: ImageFile;
+    signal?: AbortSignal;
+    timeoutMs?: number;
+    providerOptions?: Record<string, Record<string, unknown>>;
+}
+interface GeneratedImage {
+    uint8Array: Uint8Array;
+    readonly base64: string;
+    mediaType: string;
+    revisedPrompt?: string;
+}
+interface ImageResult {
+    image: GeneratedImage;
+    images: GeneratedImage[];
+    usage?: Record<string, unknown>;
+    response: {
+        provider: string;
+        modelId: string;
+        requestId?: string;
+        status: number;
+    };
+    providerMetadata?: Record<string, unknown>;
+}
+interface ImageModel {
+    readonly provider: string;
+    readonly modelId: string;
+    doGenerate(options: ImageOptions): Promise<ImageResult>;
+}
+declare function generateImage({ model, ...options }: ImageOptions & {
+    model: ImageModel;
+}): Promise<ImageResult>;
+declare const marker: unique symbol;
+/** Errors from image and realtime setup requests. Provider bodies and credentials are not retained. */
+declare class MediaAPIError extends Error {
+    readonly code: "invalid_input" | "unsupported_option" | "invalid_response" | "http_error" | "network_error";
+    readonly status?: number | undefined;
+    readonly requestId?: string | undefined;
+    readonly [marker] = true;
+    readonly name = "MediaAPIError";
+    static [Symbol.hasInstance](value: unknown): boolean;
+    constructor(message: string, code: "invalid_input" | "unsupported_option" | "invalid_response" | "http_error" | "network_error", status?: number | undefined, requestId?: string | undefined);
+}
+
+interface RealtimeToolDefinition {
+    name: string;
+    description?: string;
+    parameters: Record<string, unknown>;
+}
+interface RealtimeSessionOptions {
+    instructions?: string;
+    voice?: string;
+    transcriptionModel?: string;
+    language?: string;
+    outputModality?: "audio" | "text";
+    turnDetection?: {
+        type: "server_vad";
+        threshold?: number;
+        silenceDurationMs?: number;
+        prefixPaddingMs?: number;
+    } | {
+        type: "semantic_vad";
+        eagerness?: "auto" | "low" | "medium" | "high";
+    } | null;
+    tools?: RealtimeToolDefinition[];
+    maxOutputTokens?: number | "inf";
+    safetyIdentifier?: string;
+    signal?: AbortSignal;
+    timeoutMs?: number;
+}
+/** Short-lived credential, not a persisted session or a server authorization policy. */
+interface RealtimeClientSecret {
+    value: string;
+    expiresAt: number;
+    modelId: string;
+}
+interface RealtimeModel {
+    readonly provider: string;
+    readonly modelId: string;
+    createClientSecret(options?: RealtimeSessionOptions & {
+        expiresAfterSeconds?: number;
+    }): Promise<RealtimeClientSecret>;
+    /** Exchange a browser SDP offer on your authenticated server. Returns no credentials. */
+    createCall(options: RealtimeSessionOptions & {
+        sdp: string;
+    }): Promise<{
+        sdp: string;
+    }>;
+}
+
+/** Audio models are independent of chat models and chat streaming events. */
+type SpeechFormat = "mp3" | "opus" | "aac" | "flac" | "wav" | "pcm";
+interface AudioResponseMetadata {
+    provider: string;
+    modelId: string;
+    requestId?: string;
+    status?: number;
+}
+interface AudioWarning {
+    code: string;
+    message: string;
+}
+interface SpeechOptions {
+    text: string;
+    voice?: string;
+    outputFormat?: SpeechFormat;
+    speed?: number;
+    instructions?: string;
+    signal?: AbortSignal;
+    providerOptions?: Record<string, Record<string, unknown>>;
+}
+interface GeneratedSpeech {
+    audio: {
+        uint8Array: Uint8Array;
+        readonly base64: string;
+        mediaType: string;
+        format: SpeechFormat;
+    };
+    response: AudioResponseMetadata;
+    warnings: AudioWarning[];
+    usage?: Record<string, unknown>;
+}
+interface SpeechModel {
+    readonly provider: string;
+    readonly modelId: string;
+    doGenerate(options: SpeechOptions): Promise<GeneratedSpeech>;
+}
+interface TranscriptionOptions {
+    /** Recorded file bytes, base64, or a Blob. URLs and raw PCM are not fetched/decoded. */
+    audio: Uint8Array | ArrayBuffer | Blob | string;
+    mediaType?: string;
+    filename?: string;
+    language?: string;
+    prompt?: string;
+    signal?: AbortSignal;
+    providerOptions?: Record<string, Record<string, unknown>>;
+}
+interface TranscriptSegment {
+    text: string;
+    start: number;
+    end: number;
+    speaker?: string;
+}
+interface TranscriptionResult {
+    text: string;
+    language?: string;
+    durationSeconds?: number;
+    segments?: TranscriptSegment[];
+    words?: Array<{
+        word: string;
+        start: number;
+        end: number;
+    }>;
+    response: AudioResponseMetadata;
+    warnings: AudioWarning[];
+    usage?: Record<string, unknown>;
+    /** Provider-supplied extras, including log probabilities when requested. */
+    providerMetadata?: Record<string, unknown>;
+}
+interface TranscriptionModel {
+    readonly provider: string;
+    readonly modelId: string;
+    doTranscribe(options: TranscriptionOptions): Promise<TranscriptionResult>;
+}
+declare const audioErrorMarker: unique symbol;
+declare class AudioAPIError extends Error {
+    readonly code: "invalid_input" | "unsupported_option" | "provider_error" | "invalid_response" | "network_error";
+    readonly status?: number | undefined;
+    readonly requestId?: string | undefined;
+    readonly [audioErrorMarker] = true;
+    static [Symbol.hasInstance](value: unknown): boolean;
+    readonly name = "AudioAPIError";
+    constructor(message: string, code: "invalid_input" | "unsupported_option" | "provider_error" | "invalid_response" | "network_error", status?: number | undefined, requestId?: string | undefined);
+}
+declare function generateSpeech({ model, ...options }: SpeechOptions & {
+    model: SpeechModel;
+}): Promise<GeneratedSpeech>;
+declare function transcribe({ model, ...options }: TranscriptionOptions & {
+    model: TranscriptionModel;
+}): Promise<TranscriptionResult>;
+
+export { AudioAPIError as A, type GeneratedImage as G, type ImageFile as I, MediaAPIError as M, type RealtimeToolDefinition as R, type SpeechModel as S, type TranscriptionModel as T, type ImageOptions as a, type ImageResult as b, type ImageModel as c, type RealtimeSessionOptions as d, type RealtimeClientSecret as e, type RealtimeModel as f, generateImage as g, generateSpeech as h, type SpeechOptions as i, type TranscriptionOptions as j, type GeneratedSpeech as k, type TranscriptionResult as l, type SpeechFormat as m, type TranscriptSegment as n, type AudioResponseMetadata as o, type AudioWarning as p, transcribe as t };

package/dist/{base-BICaQaRS.d.mts → base-6LzczuCg.d.ts}

@@ -1,4 +1,4 @@
-import { M as Message, A as ActionDefinition, e as ToolDefinition, O as OpenAITransportOptions, h as OpenAIReasoningEffort, R as ResponseFormat, W as WebSearchConfig, l as ProviderToolRuntimeOptions, i as StreamEvent, P as ProviderMetadata, V as TokenUsage, $ as LLMConfig, c as ToolModelOutput, af as MessageAttachment } from './types-Dg1Bcg1k.mjs';
+import { M as Message, A as ActionDefinition, e as ToolDefinition, O as OpenAITransportOptions, h as OpenAIReasoningEffort, R as ResponseFormat, W as WebSearchConfig, l as ProviderToolRuntimeOptions, i as StreamEvent, P as ProviderMetadata, V as TokenUsage, $ as LLMConfig, c as ToolModelOutput, af as MessageAttachment } from './types-D7lzMMLu.js';
 
 /**
  * Request-level LLM configuration overrides
@@ -110,6 +110,13 @@ declare function formatTools(actions: ActionDefinition[]): Array<{
 type AnthropicContentBlock = {
     type: "text";
     text: string;
+} | {
+    type: "thinking";
+    thinking: string;
+    signature: string;
+} | {
+    type: "redacted_thinking";
+    data: string;
 } | {
     type: "image";
     source: {

package/dist/{base-CpRPB8u8.d.ts → base-DySbTP8C.d.mts}

@@ -1,4 +1,4 @@
-import { M as Message, A as ActionDefinition, e as ToolDefinition, O as OpenAITransportOptions, h as OpenAIReasoningEffort, R as ResponseFormat, W as WebSearchConfig, l as ProviderToolRuntimeOptions, i as StreamEvent, P as ProviderMetadata, V as TokenUsage, $ as LLMConfig, c as ToolModelOutput, af as MessageAttachment } from './types-Dg1Bcg1k.js';
+import { M as Message, A as ActionDefinition, e as ToolDefinition, O as OpenAITransportOptions, h as OpenAIReasoningEffort, R as ResponseFormat, W as WebSearchConfig, l as ProviderToolRuntimeOptions, i as StreamEvent, P as ProviderMetadata, V as TokenUsage, $ as LLMConfig, c as ToolModelOutput, af as MessageAttachment } from './types-D7lzMMLu.mjs';
 
 /**
  * Request-level LLM configuration overrides
@@ -110,6 +110,13 @@ declare function formatTools(actions: ActionDefinition[]): Array<{
 type AnthropicContentBlock = {
     type: "text";
     text: string;
+} | {
+    type: "thinking";
+    thinking: string;
+    signature: string;
+} | {
+    type: "redacted_thinking";
+    data: string;
 } | {
     type: "image";
     source: {

package/dist/decisions-CJzOt87t.d.mts

@@ -0,0 +1,137 @@
+type DecisionJSON = null | boolean | number | string | readonly DecisionJSON[] | {
+    readonly [key: string]: DecisionJSON;
+};
+/** Native structured state, not a chat message list. JSON arrays remain JSON arrays. */
+type DecisionInput = string | readonly DecisionJSON[] | {
+    readonly [key: string]: DecisionJSON;
+};
+type DecisionQuestion = {
+    readonly type: "boolean";
+    readonly instructions: DecisionInput;
+    readonly criteria?: {
+        readonly true?: DecisionInput;
+        readonly false?: DecisionInput;
+    };
+} | {
+    readonly type: "choice";
+    readonly instructions: DecisionInput;
+    readonly criteria: Readonly<Record<string, DecisionInput | null>>;
+} | {
+    readonly type: "score";
+    readonly instructions: DecisionInput;
+    readonly criteria: readonly DecisionInput[];
+};
+type DecisionQuestions = Readonly<Record<string, DecisionQuestion>>;
+interface DecisionImage {
+    /** Encoded image bytes. This SDK interface does not accept hosted URLs. */
+    data: Uint8Array;
+    mediaType?: "image/png" | "image/jpeg" | "image/webp" | "image/gif";
+    /** OpenAI image detail. Other providers reject this setting. */
+    detail?: "auto" | "low" | "high" | "original";
+}
+interface DecisionOptions {
+    state: DecisionInput;
+    questions: DecisionQuestions;
+    /** Images are supplied alongside shared state; no remote downloads are performed. */
+    images?: readonly DecisionImage[];
+    signal?: AbortSignal;
+    /** Whole request, including reading its response. Defaults to 60 seconds. */
+    timeoutMs?: number;
+    providerOptions?: {
+        openai?: {
+            safetyIdentifier?: string;
+            promptCacheKey?: string;
+        };
+        typesafe?: {
+            longContext?: boolean;
+        };
+        openrouter?: {
+            sessionId?: string;
+            provider?: {
+                order?: readonly string[];
+                allowFallbacks?: boolean;
+            };
+        };
+    };
+}
+type DecisionAnswer = {
+    type: "boolean";
+    probability: number;
+} | {
+    type: "choice";
+    choice: string;
+    probabilities?: Record<string, number>;
+    confidence?: number;
+} | {
+    type: "score";
+    score: number;
+    probabilities?: Record<string, number>;
+    confidence?: number;
+} | {
+    type: "refusal";
+};
+type AnswerFor<Q extends DecisionQuestion> = Extract<DecisionAnswer, {
+    type: "refusal";
+}> | (Q extends {
+    type: "choice";
+    criteria: infer C;
+} ? {
+    type: "choice";
+    choice: Extract<keyof C, string>;
+    probabilities?: Record<Extract<keyof C, string>, number>;
+    confidence?: number;
+} : Extract<DecisionAnswer, {
+    type: Q["type"];
+}>);
+interface DecisionResult<Q extends DecisionQuestions = DecisionQuestions> {
+    answers: {
+        [K in keyof Q]: AnswerFor<Q[K]>;
+    };
+    usage?: {
+        inputTokens?: number;
+        outputTokens?: number;
+        totalTokens?: number;
+        cachedInputTokens?: number;
+        cacheWriteTokens?: number;
+        costUsd?: number;
+    };
+    response: {
+        provider: string;
+        modelId: string;
+        requestId?: string;
+        status?: number;
+        body?: unknown;
+    };
+    /** Only supplied by adapters whose upstream is known to round its values. */
+    rounding?: {
+        probabilityDecimals: number;
+        scoreDecimals: number;
+    };
+}
+/** Separate from LanguageModel: native decisions do not generate text or execute tools. */
+interface DecisionModel {
+    readonly provider: string;
+    readonly modelId: string;
+    doDecide(options: DecisionOptions): Promise<DecisionResult>;
+}
+type DecisionErrorCode = "invalid_input" | "unsupported_option" | "invalid_response" | "refusal" | "http_error" | "network_error";
+declare const decisionErrorMarker: unique symbol;
+declare class DecisionAPIError extends Error {
+    readonly code: DecisionErrorCode;
+    readonly status?: number | undefined;
+    readonly requestId?: string | undefined;
+    readonly name = "DecisionAPIError";
+    private readonly [decisionErrorMarker];
+    /** Works across CJS/ESM and separately bundled provider entry points. */
+    static isInstance(error: unknown): error is DecisionAPIError;
+    constructor(message: string, code: DecisionErrorCode, status?: number | undefined, requestId?: string | undefined);
+    /** Advisory only: this SDK does not retry Decisions automatically. */
+    get retryable(): boolean;
+}
+/** Experimental: native provider contracts can change during this beta. */
+declare function experimental_decide<const Q extends DecisionQuestions>(options: Omit<DecisionOptions, "questions"> & {
+    model: DecisionModel;
+    questions: Q;
+}): Promise<DecisionResult<Q>>;
+
+export { DecisionAPIError as D, type DecisionJSON as a, type DecisionInput as b, type DecisionQuestion as c, type DecisionQuestions as d, experimental_decide as e, type DecisionImage as f, type DecisionOptions as g, type DecisionAnswer as h, type DecisionResult as i, type DecisionModel as j, type DecisionErrorCode as k };

package/dist/decisions-CJzOt87t.d.ts

@@ -0,0 +1,137 @@
+type DecisionJSON = null | boolean | number | string | readonly DecisionJSON[] | {
+    readonly [key: string]: DecisionJSON;
+};
+/** Native structured state, not a chat message list. JSON arrays remain JSON arrays. */
+type DecisionInput = string | readonly DecisionJSON[] | {
+    readonly [key: string]: DecisionJSON;
+};
+type DecisionQuestion = {
+    readonly type: "boolean";
+    readonly instructions: DecisionInput;
+    readonly criteria?: {
+        readonly true?: DecisionInput;
+        readonly false?: DecisionInput;
+    };
+} | {
+    readonly type: "choice";
+    readonly instructions: DecisionInput;
+    readonly criteria: Readonly<Record<string, DecisionInput | null>>;
+} | {
+    readonly type: "score";
+    readonly instructions: DecisionInput;
+    readonly criteria: readonly DecisionInput[];
+};
+type DecisionQuestions = Readonly<Record<string, DecisionQuestion>>;
+interface DecisionImage {
+    /** Encoded image bytes. This SDK interface does not accept hosted URLs. */
+    data: Uint8Array;
+    mediaType?: "image/png" | "image/jpeg" | "image/webp" | "image/gif";
+    /** OpenAI image detail. Other providers reject this setting. */
+    detail?: "auto" | "low" | "high" | "original";
+}
+interface DecisionOptions {
+    state: DecisionInput;
+    questions: DecisionQuestions;
+    /** Images are supplied alongside shared state; no remote downloads are performed. */
+    images?: readonly DecisionImage[];
+    signal?: AbortSignal;
+    /** Whole request, including reading its response. Defaults to 60 seconds. */
+    timeoutMs?: number;
+    providerOptions?: {
+        openai?: {
+            safetyIdentifier?: string;
+            promptCacheKey?: string;
+        };
+        typesafe?: {
+            longContext?: boolean;
+        };
+        openrouter?: {
+            sessionId?: string;
+            provider?: {
+                order?: readonly string[];
+                allowFallbacks?: boolean;
+            };
+        };
+    };
+}
+type DecisionAnswer = {
+    type: "boolean";
+    probability: number;
+} | {
+    type: "choice";
+    choice: string;
+    probabilities?: Record<string, number>;
+    confidence?: number;
+} | {
+    type: "score";
+    score: number;
+    probabilities?: Record<string, number>;
+    confidence?: number;
+} | {
+    type: "refusal";
+};
+type AnswerFor<Q extends DecisionQuestion> = Extract<DecisionAnswer, {
+    type: "refusal";
+}> | (Q extends {
+    type: "choice";
+    criteria: infer C;
+} ? {
+    type: "choice";
+    choice: Extract<keyof C, string>;
+    probabilities?: Record<Extract<keyof C, string>, number>;
+    confidence?: number;
+} : Extract<DecisionAnswer, {
+    type: Q["type"];
+}>);
+interface DecisionResult<Q extends DecisionQuestions = DecisionQuestions> {
+    answers: {
+        [K in keyof Q]: AnswerFor<Q[K]>;
+    };
+    usage?: {
+        inputTokens?: number;
+        outputTokens?: number;
+        totalTokens?: number;
+        cachedInputTokens?: number;
+        cacheWriteTokens?: number;
+        costUsd?: number;
+    };
+    response: {
+        provider: string;
+        modelId: string;
+        requestId?: string;
+        status?: number;
+        body?: unknown;
+    };
+    /** Only supplied by adapters whose upstream is known to round its values. */
+    rounding?: {
+        probabilityDecimals: number;
+        scoreDecimals: number;
+    };
+}
+/** Separate from LanguageModel: native decisions do not generate text or execute tools. */
+interface DecisionModel {
+    readonly provider: string;
+    readonly modelId: string;
+    doDecide(options: DecisionOptions): Promise<DecisionResult>;
+}
+type DecisionErrorCode = "invalid_input" | "unsupported_option" | "invalid_response" | "refusal" | "http_error" | "network_error";
+declare const decisionErrorMarker: unique symbol;
+declare class DecisionAPIError extends Error {
+    readonly code: DecisionErrorCode;
+    readonly status?: number | undefined;
+    readonly requestId?: string | undefined;
+    readonly name = "DecisionAPIError";
+    private readonly [decisionErrorMarker];
+    /** Works across CJS/ESM and separately bundled provider entry points. */
+    static isInstance(error: unknown): error is DecisionAPIError;
+    constructor(message: string, code: DecisionErrorCode, status?: number | undefined, requestId?: string | undefined);
+    /** Advisory only: this SDK does not retry Decisions automatically. */
+    get retryable(): boolean;
+}
+/** Experimental: native provider contracts can change during this beta. */
+declare function experimental_decide<const Q extends DecisionQuestions>(options: Omit<DecisionOptions, "questions"> & {
+    model: DecisionModel;
+    questions: Q;
+}): Promise<DecisionResult<Q>>;
+
+export { DecisionAPIError as D, type DecisionJSON as a, type DecisionInput as b, type DecisionQuestion as c, type DecisionQuestions as d, experimental_decide as e, type DecisionImage as f, type DecisionOptions as g, type DecisionAnswer as h, type DecisionResult as i, type DecisionModel as j, type DecisionErrorCode as k };