@opencode/ai 0.0.0-reserved → 2.0.0

package/dist/providers/zai.d.ts

@@ -0,0 +1,149 @@
+import type { ProviderPackage } from "../provider-package.js";
+import { ZAIChat } from "../protocols/zai-chat.js";
+import { type ProviderAuthOption } from "../route/auth-options.js";
+import { Route, type RouteDefaultsInput } from "../route/client.js";
+import { type ModelID } from "../schema/index.js";
+export declare const id: string & import("effect/Brand").Brand<"AI.ProviderID">;
+export type ChatOptionsInput = ZAIChat.OptionsInput;
+export type Config = Omit<RouteDefaultsInput, "providerOptions"> & ProviderAuthOption<"optional"> & {
+    readonly baseURL?: string;
+    readonly providerOptions?: ChatOptionsInput;
+};
+export type Settings = ProviderPackage.Settings & ChatOptionsInput & {
+    readonly apiKey?: string;
+    readonly baseURL?: string;
+};
+export type { ZAIImageOptions } from "../protocols/zai-images.js";
+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 thinking?: {
+        readonly type?: string | undefined;
+        readonly clear_thinking?: boolean | undefined;
+    } | undefined;
+    readonly user_id?: string | 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;
+    readonly response_format?: {
+        readonly type: string;
+    } | undefined;
+    readonly do_sample?: boolean | undefined;
+    readonly request_id?: string | undefined;
+}, import("../route/transport/http.js").HttpPrepared<string>, import("../route/client.js").CompactionOperations | undefined>[];
+export declare const configure: (input?: Config) => {
+    id: string & import("effect/Brand").Brand<"AI.ProviderID">;
+    model: (modelID: string | ModelID) => import("../schema/options.js").LanguageModel<ZAIChat.OptionsInput, import("../route/client.js").CompactionOperations | undefined>;
+    chat: (modelID: string | ModelID) => import("../schema/options.js").LanguageModel<ZAIChat.OptionsInput, import("../route/client.js").CompactionOperations | undefined>;
+    image: (modelID: string | ModelID) => import("../image.js").ImageModel<import("./zai.js").ZAIImageOptions>;
+    configure: (input?: Config) => /*elided*/ any;
+};
+export declare const provider: {
+    id: string & import("effect/Brand").Brand<"AI.ProviderID">;
+    model: (modelID: string | ModelID) => import("../schema/options.js").LanguageModel<ZAIChat.OptionsInput, import("../route/client.js").CompactionOperations | undefined>;
+    chat: (modelID: string | ModelID) => import("../schema/options.js").LanguageModel<ZAIChat.OptionsInput, import("../route/client.js").CompactionOperations | undefined>;
+    image: (modelID: string | ModelID) => import("../image.js").ImageModel<import("./zai.js").ZAIImageOptions>;
+    configure: (input?: Config) => {
+        id: string & import("effect/Brand").Brand<"AI.ProviderID">;
+        model: (modelID: string | ModelID) => import("../schema/options.js").LanguageModel<ZAIChat.OptionsInput, import("../route/client.js").CompactionOperations | undefined>;
+        chat: (modelID: string | ModelID) => import("../schema/options.js").LanguageModel<ZAIChat.OptionsInput, import("../route/client.js").CompactionOperations | undefined>;
+        image: (modelID: string | ModelID) => import("../image.js").ImageModel<import("./zai.js").ZAIImageOptions>;
+        configure: /*elided*/ any;
+    };
+};
+export declare const image: (modelID: string | ModelID) => import("../image.js").ImageModel<import("./zai.js").ZAIImageOptions>;
+export declare const chat: (modelID: string | ModelID) => import("../schema/options.js").LanguageModel<ZAIChat.OptionsInput, import("../route/client.js").CompactionOperations | undefined>;
+export declare const model: ProviderPackage.Definition<Settings, ChatOptionsInput>["model"];
+export * as ZAI from "./zai.js";

package/dist/providers/zai.js

@@ -0,0 +1,53 @@
+import { ZAIChat } from "../protocols/zai-chat.js";
+import { ZAIImages } from "../protocols/zai-images.js";
+import { OpenAIChat } from "../protocols/openai-chat.js";
+import { AuthOptions } from "../route/auth-options.js";
+import { Route } from "../route/client.js";
+import { Endpoint } from "../route/endpoint.js";
+import { HttpOptions, ProviderID } from "../schema/index.js";
+export const id = ProviderID.make("zai");
+const auth = (options) => AuthOptions.bearer(options, "ZAI_API_KEY");
+const chatRoute = Route.make({
+    id: "zai-chat",
+    provider: id,
+    providerMetadataKey: "zai",
+    protocol: ZAIChat.protocol,
+    endpoint: Endpoint.path("/chat/completions", { baseURL: "https://api.z.ai/api/paas/v4" }),
+    framing: OpenAIChat.framing,
+});
+export const routes = [chatRoute];
+export const configure = (input = {}) => {
+    const { apiKey: _apiKey, auth: _auth, baseURL, ...rest } = input;
+    const chat = (modelID) => chatRoute
+        .with({
+        ...rest,
+        endpoint: baseURL === undefined ? undefined : { baseURL },
+        auth: auth(input),
+    })
+        .model({ id: modelID, compatibility: ZAIChat.compatibility });
+    const image = (modelID) => ZAIImages.model({
+        id: modelID,
+        auth: auth(input),
+        baseURL: input.baseURL,
+        headers: input.headers,
+        http: input.http === undefined ? undefined : HttpOptions.make(input.http),
+    });
+    return {
+        id,
+        model: chat,
+        chat,
+        image,
+        configure,
+    };
+};
+export const provider = configure();
+export const image = provider.image;
+export const chat = provider.chat;
+export const model = (modelID, { apiKey, baseURL, body, headers, ...providerOptions }) => configure({
+    apiKey,
+    baseURL,
+    headers,
+    http: body === undefined ? undefined : { body: { ...body } },
+    providerOptions,
+}).model(modelID);
+export * as ZAI from "./zai.js";

package/dist/providers.d.ts

@@ -0,0 +1 @@
+export * from "./providers/index.js";

package/dist/providers.js

@@ -0,0 +1 @@
+export * from "./providers/index.js";

package/dist/route/auth-options.d.ts

@@ -0,0 +1,34 @@
+import type { Config, Redacted } from "effect";
+import { Auth } from "./auth.js";
+export type ApiKeyMode = "optional" | "required";
+export type AuthOverride = {
+    readonly auth: Auth.Definition;
+    readonly apiKey?: never;
+};
+export type OptionalApiKeyAuth = {
+    readonly apiKey?: string | Redacted.Redacted<string> | Config.Config<string | Redacted.Redacted<string>>;
+    readonly auth?: never;
+};
+export type RequiredApiKeyAuth = {
+    readonly apiKey: string | Redacted.Redacted<string> | Config.Config<string | Redacted.Redacted<string>>;
+    readonly auth?: never;
+};
+export type ProviderAuthOption<Mode extends ApiKeyMode> = AuthOverride | (Mode extends "optional" ? OptionalApiKeyAuth : RequiredApiKeyAuth);
+export type LanguageModelOptions<Base, Mode extends ApiKeyMode> = Omit<Base, "apiKey" | "auth"> & ProviderAuthOption<Mode>;
+export type LanguageModelArgs<Base, Mode extends ApiKeyMode> = Mode extends "optional" ? readonly [options?: LanguageModelOptions<Base, Mode>] : readonly [options: LanguageModelOptions<Base, Mode>];
+export type LanguageModelFactory<Base, Mode extends ApiKeyMode, LanguageModel> = (id: string, ...args: LanguageModelArgs<Base, Mode>) => LanguageModel;
+/**
+ * Require at least one of the keys in `T`. Use for option shapes where any
+ * subset of fields is acceptable but at least one must be present (e.g. Azure
+ * accepts `resourceName` or `baseURL`).
+ */
+export type AtLeastOne<T> = {
+    [K in keyof T]: Required<Pick<T, K>> & Partial<Omit<T, K>>;
+}[keyof T];
+/**
+ * Standard bearer-auth resolution for providers: honor an explicit `auth`
+ * override, otherwise resolve `apiKey` (option > config var) and apply it as
+ * a bearer token.
+ */
+export declare const bearer: (options: ProviderAuthOption<"optional">, envVar: string | ReadonlyArray<string>) => Auth.Definition;
+export * as AuthOptions from "./auth-options.js";

package/dist/route/auth-options.js

@@ -0,0 +1,14 @@
+import { Auth } from "./auth.js";
+/**
+ * Standard bearer-auth resolution for providers: honor an explicit `auth`
+ * override, otherwise resolve `apiKey` (option > config var) and apply it as
+ * a bearer token.
+ */
+export const bearer = (options, envVar) => {
+    if ("auth" in options && options.auth)
+        return options.auth;
+    return (Array.isArray(envVar) ? envVar : [envVar])
+        .reduce((auth, name) => auth.orElse(Auth.config(name)), Auth.optional("apiKey" in options ? options.apiKey : undefined, "apiKey"))
+        .bearer();
+};
+export * as AuthOptions from "./auth-options.js";

package/dist/route/auth.d.ts

@@ -0,0 +1,51 @@
+import { Config, Effect, Redacted } from "effect";
+import { Headers } from "effect/unstable/http";
+import { AIError, type HttpOptions } from "../schema/index.js";
+export declare class MissingCredentialError extends Error {
+    readonly source: string;
+    readonly _tag = "MissingCredentialError";
+    constructor(source: string);
+}
+export type CredentialError = MissingCredentialError | Config.ConfigError;
+export type AuthError = CredentialError | AIError;
+type Secret = string | Redacted.Redacted | Config.Config<string | Redacted.Redacted>;
+export interface AuthInput {
+    readonly request: {
+        readonly http?: HttpOptions;
+    };
+    readonly method: "POST" | "GET";
+    readonly url: string;
+    readonly body: string;
+    readonly headers: Headers.Headers;
+}
+export interface Credential {
+    readonly load: Effect.Effect<Redacted.Redacted, CredentialError>;
+    readonly orElse: (that: Credential) => Credential;
+    readonly bearer: () => Definition;
+    readonly header: (name: string) => Definition;
+    readonly pipe: <A>(f: (self: Credential) => A) => A;
+}
+export interface Definition {
+    readonly apply: (input: AuthInput) => Effect.Effect<Headers.Headers, AuthError>;
+    readonly andThen: (that: Definition) => Definition;
+    readonly orElse: (that: Definition) => Definition;
+    readonly pipe: <A>(f: (self: Definition) => A) => A;
+}
+export declare const isAuth: (input: unknown) => input is Definition;
+export declare const value: (secret: string, source?: string) => Credential;
+export declare const optional: (secret: Secret | undefined, source?: string) => Credential;
+export declare const config: (name: string) => Credential;
+export declare const effect: (load: Effect.Effect<Redacted.Redacted, CredentialError>) => Credential;
+export declare const none: Definition;
+export declare const headers: (input: Headers.Input) => Definition;
+export declare const remove: (name: string) => Definition;
+export declare const custom: (apply: (input: AuthInput) => Effect.Effect<Headers.Headers, AIError>) => Definition;
+export declare const passthrough: Definition;
+export declare function bearer(source: Secret | Credential): Definition;
+export declare const apiKey: typeof bearer;
+export declare function header(name: string): (source: Secret | Credential) => Definition;
+export declare function header(name: string, source: Secret | Credential): Definition;
+export declare function bearerHeader(name: string): (source: Secret | Credential) => Definition;
+export declare function bearerHeader(name: string, source: Secret | Credential): Definition;
+export declare const toEffect: (input: Definition) => (authInput: AuthInput) => Effect.Effect<Headers.Headers, AIError>;
+export * as Auth from "./auth.js";

package/dist/route/auth.js

@@ -0,0 +1,87 @@
+import { Config, Effect, Redacted } from "effect";
+import { Headers } from "effect/unstable/http";
+import { AuthenticationError, InvalidRequestError, AIError } from "../schema/index.js";
+export class MissingCredentialError extends Error {
+    source;
+    _tag = "MissingCredentialError";
+    constructor(source) {
+        super(`Missing auth credential: ${source}`);
+        this.source = source;
+    }
+}
+export const isAuth = (input) => typeof input === "object" && input !== null && "apply" in input && typeof input.apply === "function";
+const credential = (load) => {
+    const self = {
+        load,
+        orElse: (that) => credential(load.pipe(Effect.catch(() => that.load))),
+        bearer: () => fromCredential(self, (secret) => ({ authorization: `Bearer ${secret}` })),
+        header: (name) => fromCredential(self, (secret) => ({ [name]: secret })),
+        pipe: (f) => f(self),
+    };
+    return self;
+};
+const auth = (apply) => {
+    const self = {
+        apply,
+        andThen: (that) => auth((input) => apply(input).pipe(Effect.flatMap((headers) => that.apply({ ...input, headers })))),
+        orElse: (that) => auth((input) => apply(input).pipe(Effect.catch(() => that.apply(input)))),
+        pipe: (f) => f(self),
+    };
+    return self;
+};
+const fromCredential = (source, render) => auth((input) => source.load.pipe(Effect.map((secret) => Headers.setAll(input.headers, render(Redacted.value(secret))))));
+const secretEffect = (secret, source) => {
+    const redacted = typeof secret === "string" ? Redacted.make(secret) : secret;
+    if (Redacted.value(redacted) === "")
+        return Effect.fail(new MissingCredentialError(source));
+    return Effect.succeed(redacted);
+};
+const credentialFromSecret = (secret, source) => {
+    if (typeof secret === "string" || Redacted.isRedacted(secret))
+        return credential(secretEffect(secret, source));
+    return credential(Effect.gen(function* () {
+        return yield* secretEffect(yield* secret, source);
+    }));
+};
+export const value = (secret, source = "value") => credentialFromSecret(secret, source);
+export const optional = (secret, source = "optional value") => secret === undefined
+    ? credential(Effect.fail(new MissingCredentialError(source)))
+    : credentialFromSecret(secret, source);
+export const config = (name) => credentialFromSecret(Config.redacted(name), name);
+export const effect = (load) => credential(load);
+export const none = auth((input) => Effect.succeed(input.headers));
+export const headers = (input) => auth((inputAuth) => Effect.succeed(Headers.setAll(inputAuth.headers, input)));
+export const remove = (name) => auth((input) => Effect.succeed(Headers.remove(input.headers, name)));
+export const custom = (apply) => auth(apply);
+export const passthrough = none;
+const credentialInput = (source) => typeof source === "string" || Redacted.isRedacted(source) || Config.isConfig(source)
+    ? credentialFromSecret(source, "value")
+    : source;
+export function bearer(source) {
+    return credentialInput(source).bearer();
+}
+export const apiKey = bearer;
+export function header(name, source) {
+    if (source === undefined) {
+        return (next) => credentialInput(next).header(name);
+    }
+    return credentialInput(source).header(name);
+}
+export function bearerHeader(name, source) {
+    const render = (input) => fromCredential(credentialInput(input), (secret) => ({ [name]: `Bearer ${secret}` }));
+    if (source === undefined)
+        return render;
+    return render(source);
+}
+const toAIError = (error) => {
+    if (error instanceof MissingCredentialError || error instanceof Config.ConfigError) {
+        return new AIError({
+            reason: error instanceof MissingCredentialError
+                ? new AuthenticationError({ message: error.message, cause: error })
+                : new InvalidRequestError({ message: `Failed to resolve auth config: ${error.message}`, cause: error }),
+        });
+    }
+    return error;
+};
+export const toEffect = (input) => (authInput) => input.apply(authInput).pipe(Effect.mapError(toAIError));
+export * as Auth from "./auth.js";