@opencode-ai/ai 0.0.0-bootstrap.0 → 0.0.0-next-15618

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

@@ -0,0 +1,613 @@
+import { Schema } from "effect";
+import { Route } from "../route/client";
+import { HttpTransport } from "../route/transport";
+import { Protocol } from "../route/protocol";
+import { Lifecycle } from "./utils/lifecycle";
+import { ToolStream } from "./utils/tool-stream";
+export declare const DEFAULT_BASE_URL = "https://api.openai.com/v1";
+export declare const PATH = "/responses";
+declare const OpenAIResponsesBody: 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.Struct<{
+            readonly type: Schema.tag<"input_image">;
+            readonly image_url: 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;
+        }>>;
+    }>, 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;
+        }>]>>]>;
+    }>]>>;
+    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.Literal<"auto">>;
+    }>>;
+    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 OpenAIResponsesBody = Schema.Schema.Type<typeof OpenAIResponsesBody>;
+/**
+ * The OpenAI Responses protocol — request body construction, body schema, and
+ * the streaming-event state machine. Used by native OpenAI and (once
+ * registered) Azure OpenAI Responses.
+ */
+export declare const protocol: Protocol<{
+    readonly stream: true;
+    readonly model: string;
+    readonly input: readonly ({
+        readonly role: "system";
+        readonly content: string;
+    } | {
+        readonly role: "user";
+        readonly content: readonly ({
+            readonly type: "input_text";
+            readonly text: string;
+        } | {
+            readonly type: "input_image";
+            readonly image_url: string;
+        })[];
+    } | {
+        readonly role: "assistant";
+        readonly content: readonly {
+            readonly type: "output_text";
+            readonly text: string;
+        }[];
+    } | {
+        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 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_text";
+            readonly text: string;
+        } | {
+            readonly type: "input_image";
+            readonly image_url: string;
+        })[];
+    })[];
+    readonly instructions?: string | undefined;
+    readonly tools?: readonly {
+        readonly type: "function";
+        readonly name: string;
+        readonly description: string;
+        readonly parameters: {
+            readonly [x: string]: unknown;
+        };
+        readonly strict?: boolean | undefined;
+    }[] | undefined;
+    readonly tool_choice?: "required" | "none" | "auto" | {
+        readonly type: "function";
+        readonly name: string;
+    } | undefined;
+    readonly store?: boolean | undefined;
+    readonly service_tier?: "auto" | "default" | "flex" | "priority" | undefined;
+    readonly prompt_cache_key?: string | 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 reasoning?: {
+        readonly effort?: string | undefined;
+        readonly summary?: "auto" | undefined;
+    } | undefined;
+    readonly text?: {
+        readonly verbosity?: "low" | "medium" | "high" | undefined;
+    } | undefined;
+    readonly max_output_tokens?: number | undefined;
+    readonly temperature?: number | undefined;
+    readonly top_p?: number | undefined;
+}, string, {
+    readonly type: string;
+    readonly delta?: string | undefined;
+    readonly item_id?: string | undefined;
+    readonly summary_index?: number | undefined;
+    readonly item?: {
+        readonly type: string;
+        readonly id?: string | undefined;
+        readonly call_id?: string | undefined;
+        readonly name?: string | undefined;
+        readonly arguments?: string | undefined;
+        readonly status?: string | undefined;
+        readonly action?: unknown;
+        readonly queries?: unknown;
+        readonly results?: unknown;
+        readonly code?: string | undefined;
+        readonly container_id?: string | undefined;
+        readonly outputs?: unknown;
+        readonly server_label?: string | undefined;
+        readonly output?: unknown;
+        readonly error?: unknown;
+        readonly encrypted_content?: string | null | undefined;
+    } | undefined;
+    readonly response?: {
+        readonly [x: string]: unknown;
+        readonly id?: string | undefined;
+        readonly service_tier?: string | null | undefined;
+        readonly incomplete_details?: {
+            readonly reason: string;
+        } | null | undefined;
+        readonly usage?: {
+            readonly input_tokens?: number | undefined;
+            readonly input_tokens_details?: {
+                readonly cached_tokens?: number | undefined;
+            } | null | undefined;
+            readonly output_tokens?: number | undefined;
+            readonly output_tokens_details?: {
+                readonly reasoning_tokens?: number | undefined;
+            } | null | undefined;
+            readonly total_tokens?: number | undefined;
+        } | null | undefined;
+        readonly error?: {
+            readonly code?: string | null | undefined;
+            readonly message?: string | null | undefined;
+            readonly param?: string | null | undefined;
+        } | null | undefined;
+    } | undefined;
+    readonly code?: string | null | undefined;
+    readonly message?: string | undefined;
+    readonly param?: string | null | undefined;
+    readonly error?: {
+        readonly code?: string | null | undefined;
+        readonly message?: string | null | undefined;
+        readonly param?: string | null | undefined;
+    } | null | undefined;
+}, {
+    hasFunctionCall: boolean;
+    tools: Partial<Record<string, ToolStream.PendingTool>>;
+    lifecycle: Lifecycle.State;
+    reasoningItems: {};
+    store: boolean | undefined;
+}>;
+export declare const httpTransport: HttpTransport.HttpJsonTransport<{
+    readonly stream: true;
+    readonly model: string;
+    readonly input: readonly ({
+        readonly role: "system";
+        readonly content: string;
+    } | {
+        readonly role: "user";
+        readonly content: readonly ({
+            readonly type: "input_text";
+            readonly text: string;
+        } | {
+            readonly type: "input_image";
+            readonly image_url: string;
+        })[];
+    } | {
+        readonly role: "assistant";
+        readonly content: readonly {
+            readonly type: "output_text";
+            readonly text: string;
+        }[];
+    } | {
+        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 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_text";
+            readonly text: string;
+        } | {
+            readonly type: "input_image";
+            readonly image_url: string;
+        })[];
+    })[];
+    readonly instructions?: string | undefined;
+    readonly tools?: readonly {
+        readonly type: "function";
+        readonly name: string;
+        readonly description: string;
+        readonly parameters: {
+            readonly [x: string]: unknown;
+        };
+        readonly strict?: boolean | undefined;
+    }[] | undefined;
+    readonly tool_choice?: "required" | "none" | "auto" | {
+        readonly type: "function";
+        readonly name: string;
+    } | undefined;
+    readonly store?: boolean | undefined;
+    readonly service_tier?: "auto" | "default" | "flex" | "priority" | undefined;
+    readonly prompt_cache_key?: string | 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 reasoning?: {
+        readonly effort?: string | undefined;
+        readonly summary?: "auto" | undefined;
+    } | undefined;
+    readonly text?: {
+        readonly verbosity?: "low" | "medium" | "high" | undefined;
+    } | undefined;
+    readonly max_output_tokens?: number | undefined;
+    readonly temperature?: number | undefined;
+    readonly top_p?: number | undefined;
+}, string>;
+export declare const route: Route<{
+    readonly stream: true;
+    readonly model: string;
+    readonly input: readonly ({
+        readonly role: "system";
+        readonly content: string;
+    } | {
+        readonly role: "user";
+        readonly content: readonly ({
+            readonly type: "input_text";
+            readonly text: string;
+        } | {
+            readonly type: "input_image";
+            readonly image_url: string;
+        })[];
+    } | {
+        readonly role: "assistant";
+        readonly content: readonly {
+            readonly type: "output_text";
+            readonly text: string;
+        }[];
+    } | {
+        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 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_text";
+            readonly text: string;
+        } | {
+            readonly type: "input_image";
+            readonly image_url: string;
+        })[];
+    })[];
+    readonly instructions?: string | undefined;
+    readonly tools?: readonly {
+        readonly type: "function";
+        readonly name: string;
+        readonly description: string;
+        readonly parameters: {
+            readonly [x: string]: unknown;
+        };
+        readonly strict?: boolean | undefined;
+    }[] | undefined;
+    readonly tool_choice?: "required" | "none" | "auto" | {
+        readonly type: "function";
+        readonly name: string;
+    } | undefined;
+    readonly store?: boolean | undefined;
+    readonly service_tier?: "auto" | "default" | "flex" | "priority" | undefined;
+    readonly prompt_cache_key?: string | 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 reasoning?: {
+        readonly effort?: string | undefined;
+        readonly summary?: "auto" | undefined;
+    } | undefined;
+    readonly text?: {
+        readonly verbosity?: "low" | "medium" | "high" | undefined;
+    } | undefined;
+    readonly max_output_tokens?: number | undefined;
+    readonly temperature?: number | undefined;
+    readonly top_p?: number | undefined;
+}, HttpTransport.HttpPrepared<string>>;
+export declare const webSocketTransport: import("../route/transport/websocket").JsonTransport<{
+    readonly stream: true;
+    readonly model: string;
+    readonly input: readonly ({
+        readonly role: "system";
+        readonly content: string;
+    } | {
+        readonly role: "user";
+        readonly content: readonly ({
+            readonly type: "input_text";
+            readonly text: string;
+        } | {
+            readonly type: "input_image";
+            readonly image_url: string;
+        })[];
+    } | {
+        readonly role: "assistant";
+        readonly content: readonly {
+            readonly type: "output_text";
+            readonly text: string;
+        }[];
+    } | {
+        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 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_text";
+            readonly text: string;
+        } | {
+            readonly type: "input_image";
+            readonly image_url: string;
+        })[];
+    })[];
+    readonly instructions?: string | undefined;
+    readonly tools?: readonly {
+        readonly type: "function";
+        readonly name: string;
+        readonly description: string;
+        readonly parameters: {
+            readonly [x: string]: unknown;
+        };
+        readonly strict?: boolean | undefined;
+    }[] | undefined;
+    readonly tool_choice?: "required" | "none" | "auto" | {
+        readonly type: "function";
+        readonly name: string;
+    } | undefined;
+    readonly store?: boolean | undefined;
+    readonly service_tier?: "auto" | "default" | "flex" | "priority" | undefined;
+    readonly prompt_cache_key?: string | 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 reasoning?: {
+        readonly effort?: string | undefined;
+        readonly summary?: "auto" | undefined;
+    } | undefined;
+    readonly text?: {
+        readonly verbosity?: "low" | "medium" | "high" | undefined;
+    } | undefined;
+    readonly max_output_tokens?: number | undefined;
+    readonly temperature?: number | undefined;
+    readonly top_p?: number | undefined;
+}, {
+    readonly [x: string]: unknown;
+    readonly model: string;
+    readonly input: readonly ({
+        readonly role: "system";
+        readonly content: string;
+    } | {
+        readonly role: "user";
+        readonly content: readonly ({
+            readonly type: "input_text";
+            readonly text: string;
+        } | {
+            readonly type: "input_image";
+            readonly image_url: string;
+        })[];
+    } | {
+        readonly role: "assistant";
+        readonly content: readonly {
+            readonly type: "output_text";
+            readonly text: string;
+        }[];
+    } | {
+        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 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_text";
+            readonly text: string;
+        } | {
+            readonly type: "input_image";
+            readonly image_url: string;
+        })[];
+    })[];
+    readonly type: "response.create";
+    readonly instructions?: string | undefined;
+    readonly tools?: readonly {
+        readonly type: "function";
+        readonly name: string;
+        readonly description: string;
+        readonly parameters: {
+            readonly [x: string]: unknown;
+        };
+        readonly strict?: boolean | undefined;
+    }[] | undefined;
+    readonly tool_choice?: "required" | "none" | "auto" | {
+        readonly type: "function";
+        readonly name: string;
+    } | undefined;
+    readonly store?: boolean | undefined;
+    readonly service_tier?: "auto" | "default" | "flex" | "priority" | undefined;
+    readonly prompt_cache_key?: string | 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 reasoning?: {
+        readonly effort?: string | undefined;
+        readonly summary?: "auto" | undefined;
+    } | undefined;
+    readonly text?: {
+        readonly verbosity?: "low" | "medium" | "high" | undefined;
+    } | undefined;
+    readonly max_output_tokens?: number | undefined;
+    readonly temperature?: number | undefined;
+    readonly top_p?: number | undefined;
+}>;
+export declare const webSocketRoute: Route<{
+    readonly stream: true;
+    readonly model: string;
+    readonly input: readonly ({
+        readonly role: "system";
+        readonly content: string;
+    } | {
+        readonly role: "user";
+        readonly content: readonly ({
+            readonly type: "input_text";
+            readonly text: string;
+        } | {
+            readonly type: "input_image";
+            readonly image_url: string;
+        })[];
+    } | {
+        readonly role: "assistant";
+        readonly content: readonly {
+            readonly type: "output_text";
+            readonly text: string;
+        }[];
+    } | {
+        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 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_text";
+            readonly text: string;
+        } | {
+            readonly type: "input_image";
+            readonly image_url: string;
+        })[];
+    })[];
+    readonly instructions?: string | undefined;
+    readonly tools?: readonly {
+        readonly type: "function";
+        readonly name: string;
+        readonly description: string;
+        readonly parameters: {
+            readonly [x: string]: unknown;
+        };
+        readonly strict?: boolean | undefined;
+    }[] | undefined;
+    readonly tool_choice?: "required" | "none" | "auto" | {
+        readonly type: "function";
+        readonly name: string;
+    } | undefined;
+    readonly store?: boolean | undefined;
+    readonly service_tier?: "auto" | "default" | "flex" | "priority" | undefined;
+    readonly prompt_cache_key?: string | 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 reasoning?: {
+        readonly effort?: string | undefined;
+        readonly summary?: "auto" | undefined;
+    } | undefined;
+    readonly text?: {
+        readonly verbosity?: "low" | "medium" | "high" | undefined;
+    } | undefined;
+    readonly max_output_tokens?: number | undefined;
+    readonly temperature?: number | undefined;
+    readonly top_p?: number | undefined;
+}, import("../route/transport/websocket").JsonPrepared>;
+export * as OpenAIResponses from "./openai-responses";