@opencode/ai 0.0.0-reserved → 2.0.1

package/dist/providers/openai.d.ts

@@ -0,0 +1,404 @@
+import { type ProviderAuthOption } from "../route/auth-options.js";
+import type { Route, RouteDefaultsInput, CompactionOperations } from "../route/client.js";
+import type { ProviderPackage } from "../provider-package.js";
+import { ToolDefinition, type ModelID } from "../schema/index.js";
+import * as OpenAIResponses from "../protocols/openai-responses.js";
+import { type OpenAIProviderOptionsInput } from "./openai-options.js";
+import { type OpenAIImageString } from "../protocols/openai-images.js";
+export type { OpenAIOptionsInput, OpenAIResponseIncludable } from "./openai-options.js";
+export type { OpenAIImageOptions } from "../protocols/openai-images.js";
+export declare const id: string & import("effect/Brand").Brand<"AI.ProviderID">;
+export declare const routes: (Route<{
+    readonly model: string;
+    readonly messages: readonly ({
+        readonly role: "system";
+        readonly content: string | readonly ({
+            readonly type: "text";
+            readonly text: string;
+            readonly cache_control?: {
+                readonly type: "ephemeral";
+                readonly ttl?: string | undefined;
+            } | undefined;
+        } | {
+            readonly type: "image_url";
+            readonly image_url: {
+                readonly url: string;
+            };
+        })[];
+    } | {
+        readonly role: "user";
+        readonly content: string | readonly ({
+            readonly type: "text";
+            readonly text: string;
+            readonly cache_control?: {
+                readonly type: "ephemeral";
+                readonly ttl?: string | undefined;
+            } | undefined;
+        } | {
+            readonly type: "image_url";
+            readonly image_url: {
+                readonly url: string;
+            };
+        })[];
+    } | {
+        readonly [x: string]: unknown;
+        readonly content: string | null;
+        readonly role: "assistant";
+        readonly reasoning?: string | undefined;
+        readonly reasoning_content?: string | undefined;
+        readonly reasoning_text?: string | undefined;
+        readonly cache_control?: {
+            readonly type: "ephemeral";
+            readonly ttl?: string | undefined;
+        } | undefined;
+        readonly tool_calls?: readonly {
+            readonly id: string;
+            readonly type: "function";
+            readonly function: {
+                readonly name: string;
+                readonly arguments: string;
+            };
+        }[] | undefined;
+        readonly reasoning_details?: unknown;
+    } | {
+        readonly content: string;
+        readonly role: "tool";
+        readonly tool_call_id: string;
+        readonly cache_control?: {
+            readonly type: "ephemeral";
+            readonly ttl?: string | undefined;
+        } | undefined;
+    })[];
+    readonly stream: true;
+    readonly max_completion_tokens?: number | undefined;
+    readonly max_tokens?: number | undefined;
+    readonly tools?: readonly {
+        readonly function: {
+            readonly description: string;
+            readonly name: string;
+            readonly parameters: {
+                readonly [x: string]: unknown;
+            };
+            readonly strict?: boolean | undefined;
+        };
+        readonly type: "function";
+        readonly cache_control?: {
+            readonly type: "ephemeral";
+            readonly ttl?: string | undefined;
+        } | undefined;
+    }[] | undefined;
+    readonly stop?: readonly string[] | undefined;
+    readonly temperature?: number | undefined;
+    readonly seed?: number | undefined;
+    readonly tool_choice?: "required" | "auto" | "none" | {
+        readonly type: "function";
+        readonly function: {
+            readonly name: string;
+        };
+    } | undefined;
+    readonly top_p?: number | undefined;
+    readonly frequency_penalty?: number | undefined;
+    readonly presence_penalty?: number | undefined;
+    readonly prompt_cache_key?: string | undefined;
+    readonly reasoning_effort?: import("../protocols/utils/open-responses-options.js").ReasoningEffort | undefined;
+    readonly store?: boolean | undefined;
+    readonly stream_options?: {
+        readonly include_usage: boolean;
+    } | undefined;
+    readonly tool_stream?: boolean | undefined;
+}, import("../route/transport/http.js").HttpPrepared<string>, CompactionOperations | undefined> | Route<{
+    readonly input: readonly ({
+        readonly [x: string]: unknown;
+        readonly id: string;
+        readonly type: "web_search_call";
+        readonly status?: string | undefined;
+        readonly action?: {
+            readonly [x: string]: unknown;
+        } | null | undefined;
+    } | {
+        readonly [x: string]: unknown;
+        readonly id: string;
+        readonly type: "file_search_call";
+        readonly status?: string | undefined;
+        readonly queries?: readonly string[] | undefined;
+        readonly results?: readonly {
+            readonly [x: string]: unknown;
+        }[] | null | undefined;
+    } | {
+        readonly [x: string]: unknown;
+        readonly id: string;
+        readonly type: "code_interpreter_call";
+        readonly status?: string | undefined;
+        readonly code?: string | null | undefined;
+        readonly container_id?: string | null | undefined;
+        readonly outputs?: readonly {
+            readonly [x: string]: unknown;
+        }[] | null | undefined;
+    } | {
+        readonly [x: string]: unknown;
+        readonly id: string;
+        readonly type: "mcp_call";
+        readonly status?: string | undefined;
+        readonly name?: string | undefined;
+        readonly output?: string | null | undefined;
+        readonly error?: unknown;
+        readonly arguments?: string | undefined;
+        readonly server_label?: string | undefined;
+    } | {
+        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: "compaction";
+        readonly encrypted_content: string;
+        readonly id?: string | null | undefined;
+    } | {
+        readonly role: "system";
+        readonly content: string;
+    } | {
+        readonly role: "developer";
+        readonly content: string;
+    } | {
+        readonly content: readonly ({
+            readonly type: "input_image";
+            readonly image_url: string;
+            readonly detail?: string | undefined;
+        } | {
+            readonly type: "input_file";
+            readonly filename: string;
+            readonly detail?: string | undefined;
+            readonly file_data?: string | undefined;
+            readonly file_url?: string | undefined;
+        } | {
+            readonly type: "input_text";
+            readonly text: string;
+        })[];
+        readonly role: "user";
+        readonly id?: string | undefined;
+        readonly type?: "message" | undefined;
+        readonly status?: string | undefined;
+    } | {
+        readonly type: "message";
+        readonly content: readonly {
+            readonly type: "output_text";
+            readonly text: string;
+        }[];
+        readonly role: "assistant";
+        readonly id?: string | undefined;
+        readonly status?: string | undefined;
+        readonly phase?: "commentary" | "final_answer" | null | undefined;
+    } | {
+        readonly type: "function_call";
+        readonly name: string;
+        readonly arguments: string;
+        readonly call_id: string;
+        readonly id?: string | undefined;
+        readonly namespace?: string | undefined;
+    } | {
+        readonly type: "function_call_output";
+        readonly call_id: string;
+        readonly output: string | readonly ({
+            readonly type: "input_image";
+            readonly image_url: string;
+            readonly detail?: string | undefined;
+        } | {
+            readonly type: "input_file";
+            readonly filename: string;
+            readonly detail?: string | undefined;
+            readonly file_data?: string | undefined;
+            readonly file_url?: string | undefined;
+        } | {
+            readonly type: "input_text";
+            readonly text: string;
+        } | {
+            readonly type: "input_video";
+            readonly video_url: string;
+        })[];
+    } | {
+        readonly [x: string]: unknown;
+        readonly id: string;
+        readonly type: "computer_call";
+        readonly status?: string | undefined;
+        readonly action?: {
+            readonly [x: string]: unknown;
+        } | null | undefined;
+        readonly call_id?: string | undefined;
+        readonly pending_safety_checks?: readonly {
+            readonly [x: string]: unknown;
+        }[] | undefined;
+    } | {
+        readonly [x: string]: unknown;
+        readonly id: string;
+        readonly type: "web_search_preview_call";
+        readonly status?: string | undefined;
+        readonly action?: {
+            readonly [x: string]: unknown;
+        } | null | undefined;
+    } | {
+        readonly [x: string]: unknown;
+        readonly id: string;
+        readonly type: "image_generation_call";
+        readonly status?: string | undefined;
+        readonly result?: string | null | undefined;
+        readonly revised_prompt?: string | null | undefined;
+        readonly output_format?: "png" | "jpeg" | "webp" | undefined;
+    })[];
+    readonly model: string;
+    readonly stream: true;
+    readonly metadata?: {
+        readonly [x: string]: string;
+    } | undefined;
+    readonly instructions?: string | undefined;
+    readonly reasoning?: {
+        readonly summary?: "auto" | "concise" | "detailed" | undefined;
+        readonly effort?: import("../protocols/utils/open-responses-options.js").ReasoningEffort | undefined;
+    } | undefined;
+    readonly tools?: readonly ({
+        readonly type: "function";
+        readonly description: string;
+        readonly name: string;
+        readonly parameters: {
+            readonly [x: string]: unknown;
+        };
+        readonly strict?: boolean | undefined;
+    } | {
+        readonly type: "image_generation";
+        readonly size?: string | undefined;
+        readonly action?: "generate" | "auto" | "edit" | undefined;
+        readonly output_format?: "png" | "jpeg" | "webp" | undefined;
+        readonly quality?: "auto" | "low" | "medium" | "high" | undefined;
+        readonly background?: "auto" | "opaque" | "transparent" | undefined;
+        readonly output_compression?: number | undefined;
+        readonly input_fidelity?: "low" | "high" | undefined;
+        readonly partial_images?: number | undefined;
+    } | {
+        readonly type: "namespace";
+        readonly name: string;
+        readonly description: string;
+        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?: import("../protocols/utils/open-responses-options.js").TextVerbosity | undefined;
+    } | undefined;
+    readonly temperature?: number | undefined;
+    readonly service_tier?: import("../protocols/utils/open-responses-options.js").ServiceTier | undefined;
+    readonly context_management?: readonly {
+        readonly type: "compaction";
+        readonly compact_threshold?: number | undefined;
+    }[] | undefined;
+    readonly tool_choice?: "required" | "auto" | "none" | {
+        readonly type: "function";
+        readonly name: string;
+    } | {
+        readonly type: "allowed_tools";
+        readonly mode: "required" | "auto" | "none";
+        readonly tools: readonly {
+            readonly type: "function";
+            readonly name: string;
+        }[];
+    } | {
+        readonly type: "image_generation";
+    } | undefined;
+    readonly top_p?: number | undefined;
+    readonly frequency_penalty?: number | undefined;
+    readonly presence_penalty?: number | undefined;
+    readonly prompt_cache_key?: string | undefined;
+    readonly parallel_tool_calls?: boolean | undefined;
+    readonly store?: boolean | undefined;
+    readonly include?: readonly import("../protocols/utils/open-responses-options.js").ResponseIncludable[] | undefined;
+    readonly truncation?: "auto" | "disabled" | undefined;
+    readonly stream_options?: {
+        readonly include_obfuscation?: boolean | undefined;
+    } | undefined;
+    readonly safety_identifier?: string | undefined;
+    readonly top_logprobs?: number | undefined;
+    readonly max_output_tokens?: number | undefined;
+    readonly max_tool_calls?: number | undefined;
+}, import("../protocols/open-responses-channel.js").Prepared, {
+    endpoint: import("../route/client.js").CompactOperation;
+    trigger: import("../route/client.js").TriggerCompactOperation;
+}>)[];
+export type Config = RouteDefaultsInput & ProviderAuthOption<"optional"> & {
+    readonly baseURL?: string;
+    readonly queryParams?: Record<string, string>;
+    readonly providerOptions?: OpenAIProviderOptionsInput;
+};
+export interface ImageGenerationOptions {
+    readonly action?: OpenAIImageString<"auto" | "generate" | "edit">;
+    readonly background?: OpenAIImageString<"auto" | "opaque" | "transparent">;
+    readonly inputFidelity?: OpenAIImageString<"low" | "high">;
+    readonly outputCompression?: number;
+    readonly outputFormat?: OpenAIImageString<"png" | "jpeg" | "webp">;
+    readonly partialImages?: number;
+    readonly quality?: OpenAIImageString<"auto" | "low" | "medium" | "high" | "standard" | "hd">;
+    readonly size?: OpenAIImageString<"auto" | "256x256" | "512x512" | "1024x1024" | "1536x1024" | "1024x1536" | "1792x1024" | "1024x1792">;
+}
+export declare const imageGeneration: (options?: ImageGenerationOptions) => ToolDefinition;
+export type Settings = ProviderPackage.Settings & OpenAIProviderOptionsInput & {
+    readonly apiKey?: string;
+    readonly baseURL?: string;
+    readonly organization?: string;
+    readonly project?: string;
+    readonly queryParams?: Readonly<Record<string, string>>;
+};
+export declare const configure: (input?: Config) => {
+    id: string & import("effect/Brand").Brand<"AI.ProviderID">;
+    model: (id: string | ModelID) => import("../schema/options.js").LanguageModel<import("./openai-options.js").OpenAIOptionsInput, {
+        endpoint: import("../route/client.js").CompactOperation;
+        trigger: import("../route/client.js").TriggerCompactOperation;
+    }>;
+    responses: (id: string | ModelID) => import("../schema/options.js").LanguageModel<import("./openai-options.js").OpenAIOptionsInput, {
+        endpoint: import("../route/client.js").CompactOperation;
+        trigger: import("../route/client.js").TriggerCompactOperation;
+    }>;
+    chat: (id: string | ModelID) => import("../schema/options.js").LanguageModel<import("./openai-options.js").OpenAIOptionsInput, CompactionOperations | undefined>;
+    image: (modelID: string | ModelID) => import("../image.js").ImageModel<import("../protocols/openai-images.js").OpenAIImageOptions>;
+    configure: (input?: Config) => /*elided*/ any;
+};
+export declare const provider: {
+    id: string & import("effect/Brand").Brand<"AI.ProviderID">;
+    model: (id: string | ModelID) => import("../schema/options.js").LanguageModel<import("./openai-options.js").OpenAIOptionsInput, {
+        endpoint: import("../route/client.js").CompactOperation;
+        trigger: import("../route/client.js").TriggerCompactOperation;
+    }>;
+    responses: (id: string | ModelID) => import("../schema/options.js").LanguageModel<import("./openai-options.js").OpenAIOptionsInput, {
+        endpoint: import("../route/client.js").CompactOperation;
+        trigger: import("../route/client.js").TriggerCompactOperation;
+    }>;
+    chat: (id: string | ModelID) => import("../schema/options.js").LanguageModel<import("./openai-options.js").OpenAIOptionsInput, CompactionOperations | undefined>;
+    image: (modelID: string | ModelID) => import("../image.js").ImageModel<import("../protocols/openai-images.js").OpenAIImageOptions>;
+    configure: (input?: Config) => {
+        id: string & import("effect/Brand").Brand<"AI.ProviderID">;
+        model: (id: string | ModelID) => import("../schema/options.js").LanguageModel<import("./openai-options.js").OpenAIOptionsInput, {
+            endpoint: import("../route/client.js").CompactOperation;
+            trigger: import("../route/client.js").TriggerCompactOperation;
+        }>;
+        responses: (id: string | ModelID) => import("../schema/options.js").LanguageModel<import("./openai-options.js").OpenAIOptionsInput, {
+            endpoint: import("../route/client.js").CompactOperation;
+            trigger: import("../route/client.js").TriggerCompactOperation;
+        }>;
+        chat: (id: string | ModelID) => import("../schema/options.js").LanguageModel<import("./openai-options.js").OpenAIOptionsInput, CompactionOperations | undefined>;
+        image: (modelID: string | ModelID) => import("../image.js").ImageModel<import("../protocols/openai-images.js").OpenAIImageOptions>;
+        configure: /*elided*/ any;
+    };
+};
+export declare const model: ProviderPackage.Definition<Settings, OpenAIProviderOptionsInput, typeof OpenAIResponses.route.compact>["model"];
+export declare const chatModel: ProviderPackage.Definition<Settings, OpenAIProviderOptionsInput>["model"];
+export declare const responses: (id: string | ModelID) => import("../schema/options.js").LanguageModel<import("./openai-options.js").OpenAIOptionsInput, {
+    endpoint: import("../route/client.js").CompactOperation;
+    trigger: import("../route/client.js").TriggerCompactOperation;
+}>;
+export declare const chat: (id: string | ModelID) => import("../schema/options.js").LanguageModel<import("./openai-options.js").OpenAIOptionsInput, CompactionOperations | undefined>;
+export declare const image: (modelID: string | ModelID) => import("../image.js").ImageModel<import("../protocols/openai-images.js").OpenAIImageOptions>;

package/dist/providers/openai.js

@@ -0,0 +1,82 @@
+import { AuthOptions } from "../route/auth-options.js";
+import { HttpOptions, ProviderID, ToolDefinition, mergeHttpOptions } from "../schema/index.js";
+import * as OpenAIChat from "../protocols/openai-chat.js";
+import * as OpenAIResponses from "../protocols/openai-responses.js";
+import { withOpenAIOptions } from "./openai-options.js";
+import { OpenAIImages } from "../protocols/openai-images.js";
+export const id = ProviderID.make("openai");
+export const routes = [OpenAIResponses.route, OpenAIChat.route];
+export const imageGeneration = (options = {}) => ToolDefinition.make({
+    name: "image_generation",
+    description: "Generate or edit an image using OpenAI's hosted image generation tool.",
+    inputSchema: { type: "object", properties: {}, additionalProperties: false },
+    native: {
+        openai: {
+            type: "image_generation",
+            action: options.action,
+            background: options.background,
+            input_fidelity: options.inputFidelity,
+            output_compression: options.outputCompression,
+            output_format: options.outputFormat,
+            partial_images: options.partialImages,
+            quality: options.quality,
+            size: options.size,
+        },
+    },
+});
+const auth = (options) => AuthOptions.bearer(options, "OPENAI_API_KEY");
+const defaults = (input) => {
+    const { apiKey: _, auth: _auth, baseURL: _baseURL, queryParams: _queryParams, ...rest } = input;
+    return rest;
+};
+const configuredRoute = (route, input) => route.with({
+    auth: auth(input),
+    endpoint: { baseURL: input.baseURL, query: input.queryParams },
+});
+export const configure = (input = {}) => {
+    const responsesRoute = configuredRoute(OpenAIResponses.route, input);
+    const chatRoute = configuredRoute(OpenAIChat.route, input);
+    const modelDefaults = defaults(input);
+    const responses = (id) => responsesRoute
+        .with(withOpenAIOptions(id, modelDefaults, { textVerbosity: true }))
+        .model({ id });
+    const chat = (id) => chatRoute.with(withOpenAIOptions(id, modelDefaults)).model({ id });
+    const image = (modelID) => OpenAIImages.model({
+        id: modelID,
+        auth: auth(input),
+        baseURL: input.baseURL,
+        headers: input.headers,
+        http: mergeHttpOptions(input.http === undefined ? undefined : HttpOptions.make(input.http), input.queryParams === undefined ? undefined : new HttpOptions({ query: input.queryParams })),
+    });
+    return {
+        id,
+        model: responses,
+        responses,
+        chat,
+        image,
+        configure,
+    };
+};
+export const provider = configure();
+const config = ({ apiKey, baseURL, body, headers: given, organization, project, queryParams, ...providerOptions }) => {
+    const headers = {
+        ...(organization === undefined ? {} : { "OpenAI-Organization": organization }),
+        ...(project === undefined ? {} : { "OpenAI-Project": project }),
+        ...given,
+    };
+    return {
+        apiKey,
+        baseURL,
+        headers: Object.keys(headers).length === 0 ? undefined : headers,
+        http: body === undefined ? undefined : { body: { ...body } },
+        providerOptions,
+        queryParams: queryParams === undefined ? undefined : { ...queryParams },
+    };
+};
+export const model = (modelID, settings) => {
+    return configure(config(settings)).responses(modelID);
+};
+export const chatModel = (modelID, settings) => configure(config(settings)).chat(modelID);
+export const responses = provider.responses;
+export const chat = provider.chat;
+export const image = provider.image;