@opencode-ai/ai 0.0.0-beta-17492

package/dist/protocols/open-responses.d.ts

@@ -0,0 +1,951 @@
+import { Effect, Schema } from "effect";
+import { HttpTransport } from "../route/transport/index.js";
+import { Protocol } from "../route/protocol.js";
+import { AIError, LLMEvent, Usage, type LLMRequest, type MediaPart, type ProviderMetadata, type ToolDefinition } from "../schema/index.js";
+import { ProviderShared } from "./shared.js";
+import { Lifecycle } from "./utils/lifecycle.js";
+import { ToolStream } from "./utils/tool-stream.js";
+export declare const PATH = "/responses";
+declare const MediaInput: Schema.Union<readonly [Schema.Struct<{
+    readonly type: Schema.tag<"input_image">;
+    readonly image_url: Schema.String;
+}>, Schema.Struct<{
+    readonly type: Schema.tag<"input_file">;
+    readonly filename: Schema.String;
+    readonly file_data: Schema.String;
+    readonly mime_type: Schema.optional<Schema.String>;
+}>]>;
+export type MediaInput = Schema.Schema.Type<typeof MediaInput>;
+export declare const MessagePhase: Schema.Literals<readonly ["commentary", "final_answer"]>;
+type MessagePhase = Schema.Schema.Type<typeof MessagePhase>;
+export declare const InputItem: Schema.Union<readonly [Schema.Struct<{
+    readonly role: Schema.tag<"system">;
+    readonly content: Schema.String;
+}>, Schema.Struct<{
+    readonly role: Schema.tag<"user">;
+    readonly content: Schema.$Array<Schema.Union<readonly [Schema.Struct<{
+        readonly type: Schema.tag<"input_text">;
+        readonly text: Schema.String;
+    }>, Schema.Union<readonly [Schema.Struct<{
+        readonly type: Schema.tag<"input_image">;
+        readonly image_url: Schema.String;
+    }>, Schema.Struct<{
+        readonly type: Schema.tag<"input_file">;
+        readonly filename: Schema.String;
+        readonly file_data: Schema.String;
+        readonly mime_type: Schema.optional<Schema.String>;
+    }>]>]>>;
+}>, Schema.Struct<{
+    readonly role: Schema.tag<"assistant">;
+    readonly content: Schema.$Array<Schema.Struct<{
+        readonly type: Schema.tag<"output_text">;
+        readonly text: Schema.String;
+    }>>;
+    readonly phase: Schema.optionalKey<Schema.Literals<readonly ["commentary", "final_answer"]>>;
+}>, Schema.Struct<{
+    readonly type: Schema.tag<"reasoning">;
+    readonly id: Schema.optionalKey<Schema.String>;
+    readonly summary: Schema.$Array<Schema.Struct<{
+        readonly type: Schema.tag<"summary_text">;
+        readonly text: Schema.String;
+    }>>;
+    readonly encrypted_content: Schema.optional<Schema.NullOr<Schema.String>>;
+}>, Schema.Struct<{
+    readonly type: Schema.tag<"item_reference">;
+    readonly id: Schema.String;
+}>, Schema.Struct<{
+    readonly type: Schema.tag<"function_call">;
+    readonly call_id: Schema.String;
+    readonly name: Schema.String;
+    readonly arguments: Schema.String;
+}>, Schema.Struct<{
+    readonly type: Schema.tag<"function_call_output">;
+    readonly call_id: Schema.String;
+    readonly output: Schema.Union<readonly [Schema.String, Schema.$Array<Schema.Union<readonly [Schema.Struct<{
+        readonly type: Schema.tag<"input_text">;
+        readonly text: Schema.String;
+    }>, Schema.Struct<{
+        readonly type: Schema.tag<"input_image">;
+        readonly image_url: Schema.String;
+    }>, Schema.Struct<{
+        readonly type: Schema.tag<"input_file">;
+        readonly filename: Schema.String;
+        readonly file_data: Schema.String;
+        readonly mime_type: Schema.optional<Schema.String>;
+    }>]>>]>;
+}>]>;
+type OpenResponsesInputItem = Schema.Schema.Type<typeof InputItem>;
+type LoweredInputItem = OpenResponsesInputItem | {
+    readonly role: "assistant";
+    readonly content: ReadonlyArray<{
+        readonly type: "output_text";
+        readonly text: string;
+    }>;
+    readonly phase?: MessagePhase | null;
+};
+export declare const Tool: Schema.Struct<{
+    readonly type: Schema.tag<"function">;
+    readonly name: Schema.String;
+    readonly description: Schema.String;
+    readonly parameters: Schema.$Record<Schema.String, Schema.Unknown>;
+    readonly strict: Schema.optional<Schema.Boolean>;
+}>;
+export declare const ToolChoice: Schema.Union<readonly [Schema.Literals<readonly ["auto", "none", "required"]>, Schema.Struct<{
+    readonly type: Schema.tag<"function">;
+    readonly name: Schema.String;
+}>]>;
+export declare const coreFields: {
+    model: Schema.String;
+    input: Schema.$Array<Schema.Union<readonly [Schema.Struct<{
+        readonly role: Schema.tag<"system">;
+        readonly content: Schema.String;
+    }>, Schema.Struct<{
+        readonly role: Schema.tag<"user">;
+        readonly content: Schema.$Array<Schema.Union<readonly [Schema.Struct<{
+            readonly type: Schema.tag<"input_text">;
+            readonly text: Schema.String;
+        }>, Schema.Union<readonly [Schema.Struct<{
+            readonly type: Schema.tag<"input_image">;
+            readonly image_url: Schema.String;
+        }>, Schema.Struct<{
+            readonly type: Schema.tag<"input_file">;
+            readonly filename: Schema.String;
+            readonly file_data: Schema.String;
+            readonly mime_type: Schema.optional<Schema.String>;
+        }>]>]>>;
+    }>, Schema.Struct<{
+        readonly role: Schema.tag<"assistant">;
+        readonly content: Schema.$Array<Schema.Struct<{
+            readonly type: Schema.tag<"output_text">;
+            readonly text: Schema.String;
+        }>>;
+        readonly phase: Schema.optionalKey<Schema.Literals<readonly ["commentary", "final_answer"]>>;
+    }>, Schema.Struct<{
+        readonly type: Schema.tag<"reasoning">;
+        readonly id: Schema.optionalKey<Schema.String>;
+        readonly summary: Schema.$Array<Schema.Struct<{
+            readonly type: Schema.tag<"summary_text">;
+            readonly text: Schema.String;
+        }>>;
+        readonly encrypted_content: Schema.optional<Schema.NullOr<Schema.String>>;
+    }>, Schema.Struct<{
+        readonly type: Schema.tag<"item_reference">;
+        readonly id: Schema.String;
+    }>, Schema.Struct<{
+        readonly type: Schema.tag<"function_call">;
+        readonly call_id: Schema.String;
+        readonly name: Schema.String;
+        readonly arguments: Schema.String;
+    }>, Schema.Struct<{
+        readonly type: Schema.tag<"function_call_output">;
+        readonly call_id: Schema.String;
+        readonly output: Schema.Union<readonly [Schema.String, Schema.$Array<Schema.Union<readonly [Schema.Struct<{
+            readonly type: Schema.tag<"input_text">;
+            readonly text: Schema.String;
+        }>, Schema.Struct<{
+            readonly type: Schema.tag<"input_image">;
+            readonly image_url: Schema.String;
+        }>, Schema.Struct<{
+            readonly type: Schema.tag<"input_file">;
+            readonly filename: Schema.String;
+            readonly file_data: Schema.String;
+            readonly mime_type: Schema.optional<Schema.String>;
+        }>]>>]>;
+    }>]>>;
+    instructions: Schema.optional<Schema.String>;
+    tools: Schema.optional<Schema.$Array<Schema.Struct<{
+        readonly type: Schema.tag<"function">;
+        readonly name: Schema.String;
+        readonly description: Schema.String;
+        readonly parameters: Schema.$Record<Schema.String, Schema.Unknown>;
+        readonly strict: Schema.optional<Schema.Boolean>;
+    }>>>;
+    tool_choice: Schema.optional<Schema.Union<readonly [Schema.Literals<readonly ["auto", "none", "required"]>, Schema.Struct<{
+        readonly type: Schema.tag<"function">;
+        readonly name: Schema.String;
+    }>]>>;
+    store: Schema.optional<Schema.Boolean>;
+    service_tier: Schema.optional<Schema.Literals<readonly ["auto", "default", "flex", "priority"]>>;
+    prompt_cache_key: Schema.optional<Schema.String>;
+    include: Schema.optional<Schema.$Array<Schema.Literals<readonly ["file_search_call.results", "web_search_call.results", "web_search_call.action.sources", "message.input_image.image_url", "computer_call_output.output.image_url", "code_interpreter_call.outputs", "reasoning.encrypted_content", "message.output_text.logprobs"]>>>;
+    reasoning: Schema.optional<Schema.Struct<{
+        readonly effort: Schema.optional<Schema.String>;
+        readonly summary: Schema.optional<Schema.Literals<readonly ["auto", "concise", "detailed"]>>;
+    }>>;
+    text: Schema.optional<Schema.Struct<{
+        readonly verbosity: Schema.optional<Schema.Literals<readonly ["low", "medium", "high"]>>;
+    }>>;
+    max_output_tokens: Schema.optional<Schema.Number>;
+    temperature: Schema.optional<Schema.Number>;
+    top_p: Schema.optional<Schema.Number>;
+};
+declare const OpenResponsesBody: Schema.Struct<{
+    readonly stream: Schema.Literal<true>;
+    readonly model: Schema.String;
+    readonly input: Schema.$Array<Schema.Union<readonly [Schema.Struct<{
+        readonly role: Schema.tag<"system">;
+        readonly content: Schema.String;
+    }>, Schema.Struct<{
+        readonly role: Schema.tag<"user">;
+        readonly content: Schema.$Array<Schema.Union<readonly [Schema.Struct<{
+            readonly type: Schema.tag<"input_text">;
+            readonly text: Schema.String;
+        }>, Schema.Union<readonly [Schema.Struct<{
+            readonly type: Schema.tag<"input_image">;
+            readonly image_url: Schema.String;
+        }>, Schema.Struct<{
+            readonly type: Schema.tag<"input_file">;
+            readonly filename: Schema.String;
+            readonly file_data: Schema.String;
+            readonly mime_type: Schema.optional<Schema.String>;
+        }>]>]>>;
+    }>, Schema.Struct<{
+        readonly role: Schema.tag<"assistant">;
+        readonly content: Schema.$Array<Schema.Struct<{
+            readonly type: Schema.tag<"output_text">;
+            readonly text: Schema.String;
+        }>>;
+        readonly phase: Schema.optionalKey<Schema.Literals<readonly ["commentary", "final_answer"]>>;
+    }>, Schema.Struct<{
+        readonly type: Schema.tag<"reasoning">;
+        readonly id: Schema.optionalKey<Schema.String>;
+        readonly summary: Schema.$Array<Schema.Struct<{
+            readonly type: Schema.tag<"summary_text">;
+            readonly text: Schema.String;
+        }>>;
+        readonly encrypted_content: Schema.optional<Schema.NullOr<Schema.String>>;
+    }>, Schema.Struct<{
+        readonly type: Schema.tag<"item_reference">;
+        readonly id: Schema.String;
+    }>, Schema.Struct<{
+        readonly type: Schema.tag<"function_call">;
+        readonly call_id: Schema.String;
+        readonly name: Schema.String;
+        readonly arguments: Schema.String;
+    }>, Schema.Struct<{
+        readonly type: Schema.tag<"function_call_output">;
+        readonly call_id: Schema.String;
+        readonly output: Schema.Union<readonly [Schema.String, Schema.$Array<Schema.Union<readonly [Schema.Struct<{
+            readonly type: Schema.tag<"input_text">;
+            readonly text: Schema.String;
+        }>, Schema.Struct<{
+            readonly type: Schema.tag<"input_image">;
+            readonly image_url: Schema.String;
+        }>, Schema.Struct<{
+            readonly type: Schema.tag<"input_file">;
+            readonly filename: Schema.String;
+            readonly file_data: Schema.String;
+            readonly mime_type: Schema.optional<Schema.String>;
+        }>]>>]>;
+    }>]>>;
+    readonly instructions: Schema.optional<Schema.String>;
+    readonly tools: Schema.optional<Schema.$Array<Schema.Struct<{
+        readonly type: Schema.tag<"function">;
+        readonly name: Schema.String;
+        readonly description: Schema.String;
+        readonly parameters: Schema.$Record<Schema.String, Schema.Unknown>;
+        readonly strict: Schema.optional<Schema.Boolean>;
+    }>>>;
+    readonly tool_choice: Schema.optional<Schema.Union<readonly [Schema.Literals<readonly ["auto", "none", "required"]>, Schema.Struct<{
+        readonly type: Schema.tag<"function">;
+        readonly name: Schema.String;
+    }>]>>;
+    readonly store: Schema.optional<Schema.Boolean>;
+    readonly service_tier: Schema.optional<Schema.Literals<readonly ["auto", "default", "flex", "priority"]>>;
+    readonly prompt_cache_key: Schema.optional<Schema.String>;
+    readonly include: Schema.optional<Schema.$Array<Schema.Literals<readonly ["file_search_call.results", "web_search_call.results", "web_search_call.action.sources", "message.input_image.image_url", "computer_call_output.output.image_url", "code_interpreter_call.outputs", "reasoning.encrypted_content", "message.output_text.logprobs"]>>>;
+    readonly reasoning: Schema.optional<Schema.Struct<{
+        readonly effort: Schema.optional<Schema.String>;
+        readonly summary: Schema.optional<Schema.Literals<readonly ["auto", "concise", "detailed"]>>;
+    }>>;
+    readonly text: Schema.optional<Schema.Struct<{
+        readonly verbosity: Schema.optional<Schema.Literals<readonly ["low", "medium", "high"]>>;
+    }>>;
+    readonly max_output_tokens: Schema.optional<Schema.Number>;
+    readonly temperature: Schema.optional<Schema.Number>;
+    readonly top_p: Schema.optional<Schema.Number>;
+}>;
+export type OpenResponsesBody = Schema.Schema.Type<typeof OpenResponsesBody>;
+export declare const StreamItem: Schema.StructWithRest<Schema.Struct<{
+    readonly type: Schema.String;
+    readonly id: Schema.optional<Schema.String>;
+    readonly call_id: Schema.optional<Schema.String>;
+    readonly name: Schema.optional<Schema.String>;
+    readonly arguments: Schema.optional<Schema.String>;
+    readonly encrypted_content: Schema.optional<Schema.NullOr<Schema.String>>;
+}>, readonly [Schema.$Record<Schema.String, Schema.Unknown>]>;
+export type StreamItem = Schema.Schema.Type<typeof StreamItem>;
+export declare const WebSocketErrorEvent: Schema.StructWithRest<Schema.Struct<{
+    readonly type: Schema.tag<"error">;
+    readonly status: Schema.optional<Schema.Number>;
+    readonly status_code: Schema.optional<Schema.Number>;
+    readonly code: Schema.optional<Schema.NullOr<Schema.String>>;
+    readonly message: Schema.optional<Schema.String>;
+    readonly param: Schema.optional<Schema.NullOr<Schema.String>>;
+    readonly error: Schema.optional<Schema.NullOr<Schema.Struct<{
+        readonly type: Schema.optional<Schema.NullOr<Schema.String>>;
+        readonly code: Schema.optional<Schema.NullOr<Schema.String>>;
+        readonly message: Schema.optional<Schema.NullOr<Schema.String>>;
+        readonly param: Schema.optional<Schema.NullOr<Schema.String>>;
+    }>>>;
+    readonly headers: Schema.optional<Schema.$Record<Schema.String, Schema.Union<readonly [Schema.String, Schema.Number, Schema.Boolean]>>>;
+}>, readonly [Schema.$Record<Schema.String, Schema.Unknown>]>;
+export declare const decodeKnownErrorEvent: (event: Event) => Effect.Effect<{
+    readonly [x: string]: unknown;
+    readonly type: "error";
+    readonly error?: {
+        readonly type?: string | null | undefined;
+        readonly code?: string | null | undefined;
+        readonly message?: string | null | undefined;
+        readonly param?: string | null | undefined;
+    } | null | undefined;
+    readonly status?: number | undefined;
+    readonly code?: string | null | undefined;
+    readonly message?: string | undefined;
+    readonly headers?: {
+        readonly [x: string]: string | number | boolean;
+    } | undefined;
+    readonly param?: string | null | undefined;
+    readonly status_code?: number | undefined;
+}, Schema.SchemaError, never>;
+export declare const Event: Schema.StructWithRest<Schema.Struct<{
+    readonly type: Schema.String;
+    readonly delta: Schema.optional<Schema.String>;
+    readonly text: Schema.optional<Schema.String>;
+    readonly item_id: Schema.optional<Schema.String>;
+    readonly summary_index: Schema.optional<Schema.Number>;
+    readonly item: Schema.optional<Schema.StructWithRest<Schema.Struct<{
+        readonly type: Schema.String;
+        readonly id: Schema.optional<Schema.String>;
+        readonly call_id: Schema.optional<Schema.String>;
+        readonly name: Schema.optional<Schema.String>;
+        readonly arguments: Schema.optional<Schema.String>;
+        readonly encrypted_content: Schema.optional<Schema.NullOr<Schema.String>>;
+    }>, readonly [Schema.$Record<Schema.String, Schema.Unknown>]>>;
+    readonly response: Schema.optional<Schema.StructWithRest<Schema.Struct<{
+        readonly id: Schema.optional<Schema.String>;
+        readonly service_tier: Schema.optional<Schema.NullOr<Schema.String>>;
+        readonly incomplete_details: Schema.optional<Schema.NullOr<Schema.Struct<{
+            readonly reason: Schema.optional<Schema.String>;
+        }>>>;
+        readonly usage: Schema.optional<Schema.NullOr<Schema.Struct<{
+            readonly input_tokens: Schema.optional<Schema.Number>;
+            readonly input_tokens_details: Schema.optional<Schema.NullOr<Schema.Struct<{
+                readonly cached_tokens: Schema.optional<Schema.Number>;
+                readonly cache_write_tokens: Schema.optional<Schema.Number>;
+            }>>>;
+            readonly output_tokens: Schema.optional<Schema.Number>;
+            readonly output_tokens_details: Schema.optional<Schema.NullOr<Schema.Struct<{
+                readonly reasoning_tokens: Schema.optional<Schema.Number>;
+            }>>>;
+            readonly total_tokens: Schema.optional<Schema.Number>;
+        }>>>;
+        readonly error: Schema.optional<Schema.NullOr<Schema.Struct<{
+            readonly type: Schema.optional<Schema.NullOr<Schema.String>>;
+            readonly code: Schema.optional<Schema.NullOr<Schema.String>>;
+            readonly message: Schema.optional<Schema.NullOr<Schema.String>>;
+            readonly param: Schema.optional<Schema.NullOr<Schema.String>>;
+        }>>>;
+    }>, readonly [Schema.$Record<Schema.String, Schema.Unknown>]>>;
+    readonly code: Schema.optional<Schema.NullOr<Schema.String>>;
+    readonly message: Schema.optional<Schema.String>;
+    readonly param: Schema.optional<Schema.NullOr<Schema.String>>;
+    readonly error: Schema.optional<Schema.NullOr<Schema.Struct<{
+        readonly type: Schema.optional<Schema.NullOr<Schema.String>>;
+        readonly code: Schema.optional<Schema.NullOr<Schema.String>>;
+        readonly message: Schema.optional<Schema.NullOr<Schema.String>>;
+        readonly param: Schema.optional<Schema.NullOr<Schema.String>>;
+    }>>>;
+    readonly status: Schema.optional<Schema.Unknown>;
+    readonly status_code: Schema.optional<Schema.Unknown>;
+    readonly headers: Schema.optional<Schema.Unknown>;
+}>, readonly [Schema.$Record<Schema.String, Schema.Unknown>]>;
+export type Event = Schema.Schema.Type<typeof Event>;
+export interface Extension {
+    readonly id: string;
+    readonly name: string;
+    readonly lowerMedia?: (input: {
+        readonly part: MediaPart;
+        readonly media: ProviderShared.ValidatedMedia;
+        readonly request: LLMRequest;
+    }) => MediaInput | undefined;
+    readonly messagePhase?: (value: unknown) => MessagePhase | null | undefined;
+}
+export interface ParserState {
+    readonly id: string;
+    readonly name: string;
+    readonly providerMetadataKey: string;
+    readonly tools: ToolStream.State<string>;
+    readonly hasFunctionCall: boolean;
+    readonly lifecycle: Lifecycle.State;
+    readonly messageItems: ReadonlySet<string>;
+    readonly messagePhase: (value: unknown) => MessagePhase | null | undefined;
+    readonly messagePhases: Readonly<Record<string, MessagePhase | null>>;
+    readonly reasoningItems: Readonly<Record<string, ReasoningStreamItem>>;
+    readonly store: boolean | undefined;
+}
+type ReasoningSummaryStatus = "active" | "can-conclude" | "concluded";
+interface ReasoningStreamItem {
+    readonly encryptedContent: string | null | undefined;
+    readonly summaryParts: Readonly<Record<number, ReasoningSummaryStatus>>;
+}
+export declare const lowerTool: (protocolName: string, tool: ToolDefinition, inputSchema: {
+    readonly [x: string]: unknown;
+}) => Effect.Effect<{
+    type: "function";
+    name: string;
+    description: string;
+    parameters: {
+        readonly [x: string]: unknown;
+    };
+    strict: boolean;
+}, AIError, never>;
+export declare const lowerToolChoice: (protocolName: string, toolChoice: NonNullable<LLMRequest["toolChoice"]>) => Effect.Effect<"required" | "none" | "auto" | {
+    type: "function";
+    name: string;
+}, AIError, never>;
+export declare const fromRequestWithExtension: (request: LLMRequest, extension: Extension) => Effect.Effect<{
+    service_tier?: "default" | "auto" | "flex" | "priority" | undefined;
+    text?: {
+        verbosity: "low" | "medium" | "high";
+    } | undefined;
+    reasoning?: {
+        effort: string | undefined;
+        summary: "auto" | "concise" | "detailed" | undefined;
+    } | undefined;
+    include?: readonly ("file_search_call.results" | "web_search_call.results" | "web_search_call.action.sources" | "message.input_image.image_url" | "computer_call_output.output.image_url" | "code_interpreter_call.outputs" | "reasoning.encrypted_content" | "message.output_text.logprobs")[] | undefined;
+    prompt_cache_key?: string | undefined;
+    store?: boolean | undefined;
+    instructions?: string | undefined;
+    model: string & import("effect/Brand").Brand<"AI.ModelID">;
+    input: LoweredInputItem[];
+    tools: {
+        type: "function";
+        name: string;
+        description: string;
+        parameters: {
+            readonly [x: string]: unknown;
+        };
+        strict: boolean;
+    }[] | undefined;
+    tool_choice: "required" | "none" | "auto" | {
+        type: "function";
+        name: string;
+    } | undefined;
+    stream: true;
+    max_output_tokens: number | undefined;
+    temperature: number | undefined;
+    top_p: number | undefined;
+}, AIError, never>;
+export declare const fromRequest: (request: LLMRequest) => Effect.Effect<{
+    readonly input: readonly ({
+        readonly type: "reasoning";
+        readonly summary: readonly {
+            readonly type: "summary_text";
+            readonly text: string;
+        }[];
+        readonly id?: string | undefined;
+        readonly encrypted_content?: string | null | undefined;
+    } | {
+        readonly type: "item_reference";
+        readonly id: string;
+    } | {
+        readonly role: "system";
+        readonly content: string;
+    } | {
+        readonly role: "user";
+        readonly content: readonly ({
+            readonly type: "input_image";
+            readonly image_url: string;
+        } | {
+            readonly type: "input_file";
+            readonly filename: string;
+            readonly file_data: string;
+            readonly mime_type?: string | undefined;
+        } | {
+            readonly type: "input_text";
+            readonly text: string;
+        })[];
+    } | {
+        readonly content: readonly {
+            readonly type: "output_text";
+            readonly text: string;
+        }[];
+        readonly role: "assistant";
+        readonly phase?: "commentary" | "final_answer" | undefined;
+    } | {
+        readonly type: "function_call";
+        readonly call_id: string;
+        readonly name: string;
+        readonly arguments: string;
+    } | {
+        readonly type: "function_call_output";
+        readonly call_id: string;
+        readonly output: string | readonly ({
+            readonly type: "input_image";
+            readonly image_url: string;
+        } | {
+            readonly type: "input_file";
+            readonly filename: string;
+            readonly file_data: string;
+            readonly mime_type?: string | undefined;
+        } | {
+            readonly type: "input_text";
+            readonly text: string;
+        })[];
+    })[];
+    readonly model: string;
+    readonly stream: true;
+    readonly instructions?: string | undefined;
+    readonly reasoning?: {
+        readonly summary?: "auto" | "concise" | "detailed" | undefined;
+        readonly effort?: string | undefined;
+    } | undefined;
+    readonly tools?: readonly {
+        readonly type: "function";
+        readonly description: string;
+        readonly name: string;
+        readonly parameters: {
+            readonly [x: string]: unknown;
+        };
+        readonly strict?: boolean | undefined;
+    }[] | undefined;
+    readonly text?: {
+        readonly verbosity?: "low" | "medium" | "high" | undefined;
+    } | undefined;
+    readonly temperature?: number | undefined;
+    readonly tool_choice?: "required" | "none" | "auto" | {
+        readonly type: "function";
+        readonly name: string;
+    } | undefined;
+    readonly top_p?: number | undefined;
+    readonly include?: readonly ("file_search_call.results" | "web_search_call.results" | "web_search_call.action.sources" | "message.input_image.image_url" | "computer_call_output.output.image_url" | "code_interpreter_call.outputs" | "reasoning.encrypted_content" | "message.output_text.logprobs")[] | undefined;
+    readonly store?: boolean | undefined;
+    readonly prompt_cache_key?: string | undefined;
+    readonly service_tier?: "default" | "auto" | "flex" | "priority" | undefined;
+    readonly max_output_tokens?: number | undefined;
+}, AIError, never>;
+export declare const providerMetadata: (state: ParserState, metadata: Record<string, unknown>) => ProviderMetadata;
+export type StepResult = readonly [ParserState, ReadonlyArray<LLMEvent>];
+export declare const terminal: (event: Event) => boolean;
+export declare const onReasoningDelta: (state: ParserState, event: Event, itemID: string) => StepResult;
+export declare const onReasoningDone: (state: ParserState, _event: Event) => StepResult;
+export declare const providerFailure: (id: string, event: Event, fallback: string) => AIError;
+export declare const step: (state: ParserState, event: Event) => AIError | Effect.Effect<StepResult, never, never> | Effect.Effect<[ParserState, readonly ({
+    readonly type: "step-start";
+    readonly index: number;
+} | {
+    readonly id: string;
+    readonly type: "text-start";
+    readonly providerMetadata?: {
+        readonly [x: string]: {
+            readonly [x: string]: unknown;
+        };
+    } | undefined;
+} | {
+    readonly id: string;
+    readonly type: "text-delta";
+    readonly text: string;
+    readonly providerMetadata?: {
+        readonly [x: string]: {
+            readonly [x: string]: unknown;
+        };
+    } | undefined;
+} | {
+    readonly id: string;
+    readonly type: "text-end";
+    readonly providerMetadata?: {
+        readonly [x: string]: {
+            readonly [x: string]: unknown;
+        };
+    } | undefined;
+} | {
+    readonly id: string;
+    readonly type: "reasoning-start";
+    readonly providerMetadata?: {
+        readonly [x: string]: {
+            readonly [x: string]: unknown;
+        };
+    } | undefined;
+} | {
+    readonly id: string;
+    readonly type: "reasoning-delta";
+    readonly text: string;
+    readonly providerMetadata?: {
+        readonly [x: string]: {
+            readonly [x: string]: unknown;
+        };
+    } | undefined;
+} | {
+    readonly id: string;
+    readonly type: "reasoning-end";
+    readonly providerMetadata?: {
+        readonly [x: string]: {
+            readonly [x: string]: unknown;
+        };
+    } | undefined;
+} | {
+    readonly id: string;
+    readonly type: "tool-input-start";
+    readonly name: string;
+    readonly providerMetadata?: {
+        readonly [x: string]: {
+            readonly [x: string]: unknown;
+        };
+    } | undefined;
+    readonly providerExecuted?: boolean | undefined;
+} | {
+    readonly type: "tool-input-delta";
+    readonly id: string;
+    readonly name: string;
+    readonly text: string;
+} | {
+    readonly id: string;
+    readonly type: "tool-input-end";
+    readonly name: string;
+    readonly providerMetadata?: {
+        readonly [x: string]: {
+            readonly [x: string]: unknown;
+        };
+    } | undefined;
+} | {
+    readonly type: "tool-input-error";
+    readonly id: string;
+    readonly name: string;
+    readonly raw: string;
+} | {
+    readonly id: string;
+    readonly type: "tool-call";
+    readonly name: string;
+    readonly input: unknown;
+    readonly providerMetadata?: {
+        readonly [x: string]: {
+            readonly [x: string]: unknown;
+        };
+    } | undefined;
+    readonly providerExecuted?: boolean | undefined;
+} | {
+    readonly id: string;
+    readonly type: "tool-result";
+    readonly name: string;
+    readonly result: {
+        readonly type: "json";
+        readonly value: unknown;
+    } | {
+        readonly type: "text";
+        readonly value: unknown;
+    } | {
+        readonly type: "error";
+        readonly value: unknown;
+    } | {
+        readonly type: "content";
+        readonly value: readonly ({
+            readonly type: "text";
+            readonly text: string;
+        } | {
+            readonly type: "file";
+            readonly uri: string;
+            readonly mime: string;
+            readonly name?: string | undefined;
+        })[];
+    };
+    readonly output?: {
+        readonly structured: unknown;
+        readonly content: readonly ({
+            readonly type: "text";
+            readonly text: string;
+        } | {
+            readonly type: "file";
+            readonly uri: string;
+            readonly mime: string;
+            readonly name?: string | undefined;
+        })[];
+    } | undefined;
+    readonly providerMetadata?: {
+        readonly [x: string]: {
+            readonly [x: string]: unknown;
+        };
+    } | undefined;
+    readonly providerExecuted?: boolean | undefined;
+} | {
+    readonly id: string;
+    readonly type: "tool-error";
+    readonly name: string;
+    readonly message: string;
+    readonly error?: unknown;
+    readonly providerMetadata?: {
+        readonly [x: string]: {
+            readonly [x: string]: unknown;
+        };
+    } | undefined;
+} | {
+    readonly type: "step-finish";
+    readonly reason: {
+        readonly normalized: "length" | "stop" | "tool-calls" | "content-filter" | "error" | "unknown";
+        readonly raw?: string | undefined;
+    };
+    readonly index: number;
+    readonly providerMetadata?: {
+        readonly [x: string]: {
+            readonly [x: string]: unknown;
+        };
+    } | undefined;
+    readonly usage?: Usage | undefined;
+} | {
+    readonly type: "finish";
+    readonly reason: {
+        readonly normalized: "length" | "stop" | "tool-calls" | "content-filter" | "error" | "unknown";
+        readonly raw?: string | undefined;
+    };
+    readonly providerMetadata?: {
+        readonly [x: string]: {
+            readonly [x: string]: unknown;
+        };
+    } | undefined;
+    readonly usage?: Usage | undefined;
+} | {
+    readonly type: "provider-error";
+    readonly message: string;
+    readonly providerMetadata?: {
+        readonly [x: string]: {
+            readonly [x: string]: unknown;
+        };
+    } | undefined;
+    readonly classification?: "context-overflow" | "payload-too-large" | undefined;
+})[]], AIError, never>;
+/**
+ * The provider-neutral Open Responses protocol. Provider-specific Responses
+ * implementations compose this baseline with their own tools and event variants.
+ */
+export declare const initial: (request: LLMRequest, extension?: Extension) => ParserState;
+export declare const protocol: Protocol<{
+    readonly input: readonly ({
+        readonly type: "reasoning";
+        readonly summary: readonly {
+            readonly type: "summary_text";
+            readonly text: string;
+        }[];
+        readonly id?: string | undefined;
+        readonly encrypted_content?: string | null | undefined;
+    } | {
+        readonly type: "item_reference";
+        readonly id: string;
+    } | {
+        readonly role: "system";
+        readonly content: string;
+    } | {
+        readonly role: "user";
+        readonly content: readonly ({
+            readonly type: "input_image";
+            readonly image_url: string;
+        } | {
+            readonly type: "input_file";
+            readonly filename: string;
+            readonly file_data: string;
+            readonly mime_type?: string | undefined;
+        } | {
+            readonly type: "input_text";
+            readonly text: string;
+        })[];
+    } | {
+        readonly content: readonly {
+            readonly type: "output_text";
+            readonly text: string;
+        }[];
+        readonly role: "assistant";
+        readonly phase?: "commentary" | "final_answer" | undefined;
+    } | {
+        readonly type: "function_call";
+        readonly call_id: string;
+        readonly name: string;
+        readonly arguments: string;
+    } | {
+        readonly type: "function_call_output";
+        readonly call_id: string;
+        readonly output: string | readonly ({
+            readonly type: "input_image";
+            readonly image_url: string;
+        } | {
+            readonly type: "input_file";
+            readonly filename: string;
+            readonly file_data: string;
+            readonly mime_type?: string | undefined;
+        } | {
+            readonly type: "input_text";
+            readonly text: string;
+        })[];
+    })[];
+    readonly model: string;
+    readonly stream: true;
+    readonly instructions?: string | undefined;
+    readonly reasoning?: {
+        readonly summary?: "auto" | "concise" | "detailed" | undefined;
+        readonly effort?: string | undefined;
+    } | undefined;
+    readonly tools?: readonly {
+        readonly type: "function";
+        readonly description: string;
+        readonly name: string;
+        readonly parameters: {
+            readonly [x: string]: unknown;
+        };
+        readonly strict?: boolean | undefined;
+    }[] | undefined;
+    readonly text?: {
+        readonly verbosity?: "low" | "medium" | "high" | undefined;
+    } | undefined;
+    readonly temperature?: number | undefined;
+    readonly tool_choice?: "required" | "none" | "auto" | {
+        readonly type: "function";
+        readonly name: string;
+    } | undefined;
+    readonly top_p?: number | undefined;
+    readonly include?: readonly ("file_search_call.results" | "web_search_call.results" | "web_search_call.action.sources" | "message.input_image.image_url" | "computer_call_output.output.image_url" | "code_interpreter_call.outputs" | "reasoning.encrypted_content" | "message.output_text.logprobs")[] | undefined;
+    readonly store?: boolean | undefined;
+    readonly prompt_cache_key?: string | undefined;
+    readonly service_tier?: "default" | "auto" | "flex" | "priority" | undefined;
+    readonly max_output_tokens?: number | undefined;
+}, string, {
+    readonly [x: string]: unknown;
+    readonly type: string;
+    readonly error?: {
+        readonly type?: string | null | undefined;
+        readonly code?: string | null | undefined;
+        readonly message?: string | null | undefined;
+        readonly param?: string | null | undefined;
+    } | null | undefined;
+    readonly status?: unknown;
+    readonly code?: string | null | undefined;
+    readonly message?: string | undefined;
+    readonly headers?: unknown;
+    readonly text?: string | undefined;
+    readonly item?: {
+        readonly [x: string]: unknown;
+        readonly type: string;
+        readonly id?: string | undefined;
+        readonly name?: string | undefined;
+        readonly arguments?: string | undefined;
+        readonly encrypted_content?: string | null | undefined;
+        readonly call_id?: string | undefined;
+    } | undefined;
+    readonly delta?: string | undefined;
+    readonly response?: {
+        readonly [x: string]: unknown;
+        readonly error?: {
+            readonly type?: string | null | undefined;
+            readonly code?: string | null | undefined;
+            readonly message?: string | null | undefined;
+            readonly param?: string | null | undefined;
+        } | null | undefined;
+        readonly id?: string | undefined;
+        readonly usage?: {
+            readonly input_tokens?: number | undefined;
+            readonly output_tokens?: number | undefined;
+            readonly output_tokens_details?: {
+                readonly reasoning_tokens?: number | undefined;
+            } | null | undefined;
+            readonly total_tokens?: number | undefined;
+            readonly input_tokens_details?: {
+                readonly cached_tokens?: number | undefined;
+                readonly cache_write_tokens?: number | undefined;
+            } | null | undefined;
+        } | null | undefined;
+        readonly service_tier?: string | null | undefined;
+        readonly incomplete_details?: {
+            readonly reason?: string | undefined;
+        } | null | undefined;
+    } | undefined;
+    readonly param?: string | null | undefined;
+    readonly status_code?: unknown;
+    readonly item_id?: string | undefined;
+    readonly summary_index?: number | undefined;
+}, ParserState>;
+export declare const httpTransport: HttpTransport.HttpJsonTransport<{
+    readonly input: readonly ({
+        readonly type: "reasoning";
+        readonly summary: readonly {
+            readonly type: "summary_text";
+            readonly text: string;
+        }[];
+        readonly id?: string | undefined;
+        readonly encrypted_content?: string | null | undefined;
+    } | {
+        readonly type: "item_reference";
+        readonly id: string;
+    } | {
+        readonly role: "system";
+        readonly content: string;
+    } | {
+        readonly role: "user";
+        readonly content: readonly ({
+            readonly type: "input_image";
+            readonly image_url: string;
+        } | {
+            readonly type: "input_file";
+            readonly filename: string;
+            readonly file_data: string;
+            readonly mime_type?: string | undefined;
+        } | {
+            readonly type: "input_text";
+            readonly text: string;
+        })[];
+    } | {
+        readonly content: readonly {
+            readonly type: "output_text";
+            readonly text: string;
+        }[];
+        readonly role: "assistant";
+        readonly phase?: "commentary" | "final_answer" | undefined;
+    } | {
+        readonly type: "function_call";
+        readonly call_id: string;
+        readonly name: string;
+        readonly arguments: string;
+    } | {
+        readonly type: "function_call_output";
+        readonly call_id: string;
+        readonly output: string | readonly ({
+            readonly type: "input_image";
+            readonly image_url: string;
+        } | {
+            readonly type: "input_file";
+            readonly filename: string;
+            readonly file_data: string;
+            readonly mime_type?: string | undefined;
+        } | {
+            readonly type: "input_text";
+            readonly text: string;
+        })[];
+    })[];
+    readonly model: string;
+    readonly stream: true;
+    readonly instructions?: string | undefined;
+    readonly reasoning?: {
+        readonly summary?: "auto" | "concise" | "detailed" | undefined;
+        readonly effort?: string | undefined;
+    } | undefined;
+    readonly tools?: readonly {
+        readonly type: "function";
+        readonly description: string;
+        readonly name: string;
+        readonly parameters: {
+            readonly [x: string]: unknown;
+        };
+        readonly strict?: boolean | undefined;
+    }[] | undefined;
+    readonly text?: {
+        readonly verbosity?: "low" | "medium" | "high" | undefined;
+    } | undefined;
+    readonly temperature?: number | undefined;
+    readonly tool_choice?: "required" | "none" | "auto" | {
+        readonly type: "function";
+        readonly name: string;
+    } | undefined;
+    readonly top_p?: number | undefined;
+    readonly include?: readonly ("file_search_call.results" | "web_search_call.results" | "web_search_call.action.sources" | "message.input_image.image_url" | "computer_call_output.output.image_url" | "code_interpreter_call.outputs" | "reasoning.encrypted_content" | "message.output_text.logprobs")[] | undefined;
+    readonly store?: boolean | undefined;
+    readonly prompt_cache_key?: string | undefined;
+    readonly service_tier?: "default" | "auto" | "flex" | "priority" | undefined;
+    readonly max_output_tokens?: number | undefined;
+}, string>;
+export * as OpenResponses from "./open-responses.js";