@opencode/ai 0.0.0-dev-19465 → 0.0.0-dev-19467

package/dist/providers/alibaba.js

@@ -5,7 +5,7 @@ import { AuthOptions } from "../route/auth-options.js";
 import { Route } from "../route/client.js";
 import { Endpoint } from "../route/endpoint.js";
 import { Framing } from "../route/framing.js";
-import { ProviderID, ToolDefinition } from "../schema/index.js";
+import { ProviderConfigurationError, ProviderID, ToolDefinition } from "../schema/index.js";
 export const id = ProviderID.make("alibaba");
 const hosts = new Map([
     ["ap-southeast-1", "dashscope-intl.aliyuncs.com"],
@@ -48,9 +48,12 @@ export const configure = (input) => {
             : `${workspaceID}.${region}.maas.aliyuncs.com`;
     if (baseURL === undefined) {
         if (region === undefined)
-            throw new Error("Alibaba requires region or baseURL");
+            throw new ProviderConfigurationError({ provider: id, message: "Alibaba requires region or baseURL" });
         if (host === undefined)
-            throw new Error(`Alibaba region ${region} requires workspaceID or baseURL`);
+            throw new ProviderConfigurationError({
+                provider: id,
+                message: `Alibaba region ${region} requires workspaceID or baseURL`,
+            });
     }
     const opts = { ...rest, auth: AuthOptions.bearer(input, ["DASHSCOPE_API_KEY", "ALIBABA_API_KEY"]) };
     const common = { ...opts, endpoint: { baseURL: baseURL ?? `https://${host}/compatible-mode/v1` } };

package/dist/providers/amazon-bedrock-mantle.js

@@ -3,7 +3,7 @@ import { Endpoint } from "../route/endpoint.js";
 import { OpenAIChat } from "../protocols/openai-chat.js";
 import { OpenResponses } from "../protocols/open-responses.js";
 import { BedrockAuth } from "../protocols/utils/bedrock-auth.js";
-import { ProviderID } from "../schema/index.js";
+import { ProviderConfigurationError, ProviderID } from "../schema/index.js";
 import { withOpenAIOptions } from "./openai-options.js";
 export const id = ProviderID.make("amazon-bedrock");
 const responsesRoute = Route.make({
@@ -38,9 +38,12 @@ const defaults = (input) => {
 };
 export const configure = (input = {}) => {
     if (input.auth === "bearer" && input.apiKey === undefined && process.env.AWS_BEARER_TOKEN_BEDROCK === undefined)
-        throw new Error("Amazon Bedrock Mantle bearer auth requires apiKey");
+        throw new ProviderConfigurationError({ provider: id, message: "Amazon Bedrock Mantle bearer auth requires apiKey" });
     if (input.auth === "sigv4" && input.apiKey !== undefined)
-        throw new Error("Amazon Bedrock Mantle SigV4 auth does not accept apiKey");
+        throw new ProviderConfigurationError({
+            provider: id,
+            message: "Amazon Bedrock Mantle SigV4 auth does not accept apiKey",
+        });
     const configuredResponsesRoute = configuredRoute(responsesRoute, input);
     const configuredChatRoute = configuredRoute(chatRoute, input);
     const modelDefaults = defaults(input);

package/dist/providers/amazon-bedrock.js

@@ -1,4 +1,4 @@
-import { ProviderID } from "../schema/index.js";
+import { ProviderConfigurationError, ProviderID } from "../schema/index.js";
 import * as BedrockConverse from "../protocols/bedrock-converse.js";
 import { BedrockAuth } from "../protocols/utils/bedrock-auth.js";
 export const id = ProviderID.make("amazon-bedrock");
@@ -7,9 +7,9 @@ const bedrockBaseURL = (region) => `https://bedrock-runtime.${region}.amazonaws.
 const configuredRoute = (input) => {
     const { apiKey, auth, credentials, profile, region, baseURL, ...rest } = input;
     if (auth === "bearer" && apiKey === undefined && process.env.AWS_BEARER_TOKEN_BEDROCK === undefined)
-        throw new Error("Amazon Bedrock bearer auth requires apiKey");
+        throw new ProviderConfigurationError({ provider: id, message: "Amazon Bedrock bearer auth requires apiKey" });
     if (auth === "sigv4" && apiKey !== undefined)
-        throw new Error("Amazon Bedrock SigV4 auth does not accept apiKey");
+        throw new ProviderConfigurationError({ provider: id, message: "Amazon Bedrock SigV4 auth does not accept apiKey" });
     const resolvedRegion = BedrockAuth.resolveRegion(input);
     return BedrockConverse.route.with({
         ...rest,

package/dist/providers/anthropic-compatible.js

@@ -1,6 +1,6 @@
 import { AnthropicMessages } from "../protocols/anthropic-messages.js";
 import { Auth } from "../route/auth.js";
-import { ProviderID } from "../schema/index.js";
+import { ProviderConfigurationError, ProviderID } from "../schema/index.js";
 export const id = ProviderID.make("anthropic-compatible");
 export const routes = [AnthropicMessages.route];
 const auth = (input) => {
@@ -9,9 +9,12 @@ const auth = (input) => {
     return Auth.optional("apiKey" in input ? input.apiKey : undefined, "apiKey").pipe(Auth.header("x-api-key"));
 };
 export const configure = (input) => {
-    if (!input.baseURL)
-        throw new Error("Anthropic-compatible providers require a baseURL");
     const provider = input.provider ?? "anthropic-compatible";
+    if (!input.baseURL)
+        throw new ProviderConfigurationError({
+            provider: ProviderID.make(provider),
+            message: "Anthropic-compatible providers require a baseURL",
+        });
     const { provider: _, baseURL, apiKey: _apiKey, auth: _auth, ...rest } = input;
     const route = AnthropicMessages.route.with({
         ...rest,
@@ -30,8 +33,13 @@ export const provider = {
     configure,
 };
 export const model = (modelID, settings) => {
+    // Read before the exclusivity check narrows a conflicting settings object to `never`.
+    const provider = ProviderID.make(settings.provider ?? id);
     if (settings.apiKey !== undefined && settings.authToken !== undefined)
-        throw new Error("Anthropic-compatible apiKey cannot be combined with authToken");
+        throw new ProviderConfigurationError({
+            provider,
+            message: "Anthropic-compatible apiKey cannot be combined with authToken",
+        });
     return configure({
         ...(settings.authToken === undefined ? { apiKey: settings.apiKey } : { auth: Auth.bearer(settings.authToken) }),
         baseURL: settings.baseURL,

package/dist/providers/anthropic.js

@@ -1,5 +1,5 @@
 import { Auth } from "../route/auth.js";
-import { ProviderID } from "../schema/index.js";
+import { ProviderConfigurationError, ProviderID } from "../schema/index.js";
 import { AnthropicMessages } from "../protocols/anthropic-messages.js";
 import { AnthropicCompatible } from "./anthropic-compatible.js";
 export const id = ProviderID.make("anthropic");
@@ -28,7 +28,10 @@ export const configure = (input = {}) => {
 export const provider = configure();
 export const model = (modelID, settings) => {
     if (settings.apiKey !== undefined && settings.authToken !== undefined)
-        throw new Error("Anthropic apiKey cannot be combined with authToken");
+        throw new ProviderConfigurationError({
+            provider: id,
+            message: "Anthropic apiKey cannot be combined with authToken",
+        });
     return configure({
         ...(settings.authToken === undefined ? { apiKey: settings.apiKey } : { auth: Auth.bearer(settings.authToken) }),
         baseURL: settings.baseURL,

package/dist/providers/azure.js

@@ -1,7 +1,7 @@
 import { Headers } from "effect/unstable/http";
 import { Auth } from "../route/auth.js";
 import {} from "../route/auth-options.js";
-import { ProviderID } from "../schema/index.js";
+import { ProviderConfigurationError, ProviderID } from "../schema/index.js";
 import * as OpenAIChat from "../protocols/openai-chat.js";
 import * as OpenAIResponses from "../protocols/openai-responses.js";
 import { ProviderShared } from "../protocols/shared.js";
@@ -108,7 +108,7 @@ const config = (settings) => {
         return { ...common, baseURL: settings.baseURL };
     if (settings.resourceName !== undefined)
         return { ...common, resourceName: settings.resourceName };
-    throw new Error("Azure requires resourceName or baseURL");
+    throw new ProviderConfigurationError({ provider: id, message: "Azure requires resourceName or baseURL" });
 };
 export const responsesModel = (modelID, settings) => configure(config(settings)).responses(modelID);
 export const chatModel = (modelID, settings) => configure(config(settings)).chat(modelID);

package/dist/providers/cloudflare-ai-gateway.js

@@ -2,14 +2,17 @@ import { OpenAIChat } from "../protocols/openai-chat.js";
 import { Auth } from "../route/auth.js";
 import { Route } from "../route/client.js";
 import { Endpoint } from "../route/endpoint.js";
-import { ProviderID } from "../schema/index.js";
+import { ProviderConfigurationError, ProviderID } from "../schema/index.js";
 export const id = ProviderID.make("cloudflare-ai-gateway");
 export const authEnvVars = ["CLOUDFLARE_API_TOKEN", "CF_AIG_TOKEN"];
 export const baseURL = (input) => {
     if (input.baseURL)
         return input.baseURL;
     if (!input.accountId)
-        throw new Error("CloudflareAIGateway.configure requires accountId unless baseURL is supplied");
+        throw new ProviderConfigurationError({
+            provider: id,
+            message: "CloudflareAIGateway.configure requires accountId unless baseURL is supplied",
+        });
     return `https://gateway.ai.cloudflare.com/v1/${encodeURIComponent(input.accountId)}/${encodeURIComponent(input.gatewayId?.trim() || "default")}/compat`;
 };
 const auth = (input) => {

package/dist/providers/cloudflare-workers-ai.js

@@ -2,14 +2,17 @@ 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 { ProviderID } from "../schema/index.js";
+import { ProviderConfigurationError, ProviderID } from "../schema/index.js";
 export const id = ProviderID.make("cloudflare-workers-ai");
 export const authEnvVars = ["CLOUDFLARE_API_KEY", "CLOUDFLARE_WORKERS_AI_TOKEN"];
 export const baseURL = (input) => {
     if (input.baseURL)
         return input.baseURL;
     if (!input.accountId)
-        throw new Error("CloudflareWorkersAI.configure requires accountId unless baseURL is supplied");
+        throw new ProviderConfigurationError({
+            provider: id,
+            message: "CloudflareWorkersAI.configure requires accountId unless baseURL is supplied",
+        });
     return `https://api.cloudflare.com/client/v4/accounts/${encodeURIComponent(input.accountId)}/ai/v1`;
 };
 export const route = Route.make({

package/dist/providers/google-vertex-chat.js

@@ -1,7 +1,7 @@
 import { OpenAIChat } from "../protocols/openai-chat.js";
 import { Route } from "../route/client.js";
 import { Endpoint } from "../route/endpoint.js";
-import { ProviderID } from "../schema/index.js";
+import { ProviderConfigurationError, ProviderID } from "../schema/index.js";
 import { GoogleVertexShared } from "./google-vertex-shared.js";
 export const id = ProviderID.make("google-vertex");
 const route = Route.make({
@@ -15,7 +15,7 @@ const route = Route.make({
 export const routes = [route];
 const configuredRoute = (input) => {
     if ("apiKey" in input && input.apiKey !== undefined)
-        throw new Error("Google Vertex Chat does not support API keys");
+        throw new ProviderConfigurationError({ provider: id, message: "Google Vertex Chat does not support API keys" });
     const { accessToken: _accessToken, auth: _auth, baseURL, location: inputLocation, project: inputProject, ...rest } = input;
     const location = GoogleVertexShared.location(inputLocation, "global");
     const project = GoogleVertexShared.project(inputProject);
@@ -42,7 +42,7 @@ export const provider = {
 };
 export const model = (modelID, settings) => {
     if (settings.apiKey !== undefined)
-        throw new Error("Google Vertex Chat does not support API keys");
+        throw new ProviderConfigurationError({ provider: id, message: "Google Vertex Chat does not support API keys" });
     return configure({
         accessToken: settings.accessToken,
         baseURL: settings.baseURL,

package/dist/providers/google-vertex-messages.js

@@ -4,7 +4,7 @@ import { Auth } from "../route/auth.js";
 import { Route } from "../route/client.js";
 import { Endpoint } from "../route/endpoint.js";
 import { Protocol } from "../route/protocol.js";
-import { ProviderID } from "../schema/index.js";
+import { ProviderConfigurationError, ProviderID } from "../schema/index.js";
 import { GoogleVertexShared } from "./google-vertex-shared.js";
 const VERSION = "vertex-2023-10-16";
 const HEADER_VERSION = "2023-06-01";
@@ -35,7 +35,7 @@ const route = Route.make({
 export const routes = [route];
 const configuredRoute = (input) => {
     if ("apiKey" in input && input.apiKey !== undefined)
-        throw new Error("Google Vertex Messages does not support API keys");
+        throw new ProviderConfigurationError({ provider: id, message: "Google Vertex Messages does not support API keys" });
     const { accessToken: _accessToken, auth: _auth, baseURL, location: inputLocation, project: inputProject, ...rest } = input;
     const location = GoogleVertexShared.location(inputLocation, "global");
     const project = GoogleVertexShared.project(inputProject);
@@ -62,7 +62,7 @@ export const provider = {
 };
 export const model = (modelID, settings) => {
     if (settings.apiKey !== undefined)
-        throw new Error("Google Vertex Messages does not support API keys");
+        throw new ProviderConfigurationError({ provider: id, message: "Google Vertex Messages does not support API keys" });
     return configure({
         accessToken: settings.accessToken,
         baseURL: settings.baseURL,

package/dist/providers/google-vertex-responses.js

@@ -1,7 +1,7 @@
 import { OpenResponses } from "../protocols/open-responses.js";
 import { Route } from "../route/client.js";
 import { Endpoint } from "../route/endpoint.js";
-import { ProviderID } from "../schema/index.js";
+import { ProviderConfigurationError, ProviderID } from "../schema/index.js";
 import { GoogleVertexShared } from "./google-vertex-shared.js";
 export const id = ProviderID.make("google-vertex");
 const route = Route.make({
@@ -16,7 +16,7 @@ const route = Route.make({
 export const routes = [route];
 const configuredRoute = (input) => {
     if ("apiKey" in input && input.apiKey !== undefined)
-        throw new Error("Google Vertex Responses does not support API keys");
+        throw new ProviderConfigurationError({ provider: id, message: "Google Vertex Responses does not support API keys" });
     const { accessToken: _accessToken, auth: _auth, baseURL, location: inputLocation, project: inputProject, ...rest } = input;
     const location = GoogleVertexShared.location(inputLocation, "global");
     const project = GoogleVertexShared.project(inputProject);
@@ -43,7 +43,7 @@ export const provider = {
 };
 export const model = (modelID, settings) => {
     if (settings.apiKey !== undefined)
-        throw new Error("Google Vertex Responses does not support API keys");
+        throw new ProviderConfigurationError({ provider: id, message: "Google Vertex Responses does not support API keys" });
     return configure({
         accessToken: settings.accessToken,
         baseURL: settings.baseURL,

package/dist/providers/google-vertex-shared.js

@@ -1,6 +1,8 @@
 import { Effect, Redacted } from "effect";
 import { Auth, MissingCredentialError } from "../route/auth.js";
+import { ProviderConfigurationError, ProviderID } from "../schema/index.js";
 const SCOPE = "https://www.googleapis.com/auth/cloud-platform";
+const id = ProviderID.make("google-vertex");
 export const project = (value) => value ??
     process.env.GOOGLE_VERTEX_PROJECT ??
     process.env.GOOGLE_CLOUD_PROJECT ??
@@ -22,11 +24,17 @@ export const host = (location) => {
 export const requireProject = (value) => {
     if (value)
         return value;
-    throw new Error("Google Vertex requires a project when baseURL is not configured");
+    throw new ProviderConfigurationError({
+        provider: id,
+        message: "Google Vertex requires a project when baseURL is not configured",
+    });
 };
 export const apiKey = (input) => {
     if (input.apiKey !== undefined && (input.accessToken !== undefined || input.auth !== undefined))
-        throw new Error("Google Vertex apiKey cannot be combined with accessToken or auth");
+        throw new ProviderConfigurationError({
+            provider: id,
+            message: "Google Vertex apiKey cannot be combined with accessToken or auth",
+        });
     if (input.accessToken !== undefined || input.auth !== undefined)
         return undefined;
     return input.apiKey ?? process.env.GOOGLE_VERTEX_API_KEY;
@@ -51,7 +59,10 @@ const adc = (project) => {
 };
 export const oauth = (input, project) => {
     if (input.accessToken !== undefined && input.auth !== undefined)
-        throw new Error("Google Vertex accessToken cannot be combined with auth");
+        throw new ProviderConfigurationError({
+            provider: id,
+            message: "Google Vertex accessToken cannot be combined with auth",
+        });
     if (input.auth)
         return input.auth;
     if (input.accessToken !== undefined)

package/dist/providers/google-vertex.js

@@ -5,7 +5,7 @@ import { Auth } from "../route/auth.js";
 import { Route } from "../route/client.js";
 import { Endpoint } from "../route/endpoint.js";
 import { Framing } from "../route/framing.js";
-import { ProviderID } from "../schema/index.js";
+import { ProviderConfigurationError, ProviderID } from "../schema/index.js";
 import { GoogleVertexShared } from "./google-vertex-shared.js";
 export const id = ProviderID.make("google-vertex");
 const fromRequest = Effect.fn("GoogleVertex.fromRequest")(function* (request) {
@@ -53,7 +53,10 @@ const configuredRoute = (input, modelID) => {
     const apiKey = GoogleVertexShared.apiKey(input);
     const endpointModel = String(modelID).startsWith("endpoints/");
     if (apiKey !== undefined && endpointModel)
-        throw new Error("Google Vertex tuned models do not support Express Mode API keys");
+        throw new ProviderConfigurationError({
+            provider: id,
+            message: "Google Vertex tuned models do not support Express Mode API keys",
+        });
     const location = GoogleVertexShared.location(inputLocation, "us-central1");
     const project = GoogleVertexShared.project(inputProject);
     const endpoint = baseURL ??
@@ -79,7 +82,10 @@ export const provider = {
 };
 export const model = (modelID, settings) => {
     if (settings.apiKey !== undefined && settings.accessToken !== undefined)
-        throw new Error("Google Vertex apiKey cannot be combined with accessToken or auth");
+        throw new ProviderConfigurationError({
+            provider: id,
+            message: "Google Vertex apiKey cannot be combined with accessToken or auth",
+        });
     return configure({
         ...(settings.apiKey === undefined ? { accessToken: settings.accessToken } : { apiKey: settings.apiKey }),
         baseURL: settings.baseURL,

package/dist/route/client.js

@@ -8,13 +8,16 @@ import { applyCachePolicy } from "../cache-policy.js";
 import { normalizeToolHistory } from "../tool-history.js";
 import { sanitizeSurrogates } from "../utils/sanitize.js";
 import * as ProviderShared from "../protocols/shared.js";
-import { AIError, CompactionResponse, CompactionCheckpointResponse, AIErrorReason, GenerationOptions, HttpOptions, LLMRequest, LLMResponse, LanguageModel, LLMEvent, InvalidProviderOutputError, ProviderID, mergeGenerationOptions, mergeHttpOptions, mergeProviderOptions, } from "../schema/index.js";
+import { AIError, CompactionResponse, CompactionCheckpointResponse, AIErrorReason, GenerationOptions, HttpOptions, LLMRequest, LLMResponse, LanguageModel, LLMEvent, InvalidProviderOutputError, ProviderConfigurationError, ProviderID, mergeGenerationOptions, mergeHttpOptions, mergeProviderOptions, } from "../schema/index.js";
 const makeRouteLanguageModel = (route, mapped) => {
     const provider = route.provider ?? ("provider" in mapped ? mapped.provider : undefined);
     if (!provider)
         throw new Error(`Route.model(${route.id}) requires a provider`);
     if (!endpointBaseURL(route.endpoint))
-        throw new Error(`Route.model(${route.id}) requires an endpoint baseURL — configure it on the route first`);
+        throw new ProviderConfigurationError({
+            provider: ProviderID.make(provider),
+            message: `Route.model(${route.id}) requires an endpoint baseURL — configure it on the route first`,
+        });
     return LanguageModel.make({
         ...mapped,
         provider,

package/dist/schema/errors.d.ts

@@ -44,6 +44,18 @@ declare const UnsupportedOperationError_base: Schema.Class<UnsupportedOperationE
  */
 export declare class UnsupportedOperationError extends UnsupportedOperationError_base {
 }
+declare const ProviderConfigurationError_base: Schema.Class<ProviderConfigurationError, Schema.TaggedStruct<"ProviderConfiguration", {
+    readonly provider: Schema.brand<Schema.String, "AI.ProviderID">;
+    readonly message: Schema.String;
+}>, import("effect/Cause").YieldableError>;
+/**
+ * Provider settings that are missing, conflicting, or unsupported, such as
+ * Azure without `resourceName` or `baseURL`. Thrown synchronously while a
+ * provider facade or package entrypoint configures a model, before any
+ * request exists, so it is not an `AIError` reason.
+ */
+export declare class ProviderConfigurationError extends ProviderConfigurationError_base {
+}
 declare const NoRouteError_base: Schema.Class<NoRouteError, Schema.TaggedStruct<"NoRoute", {
     readonly route: Schema.String;
     readonly provider: Schema.brand<Schema.String, "AI.ProviderID">;

package/dist/schema/errors.js

@@ -41,6 +41,17 @@ export class UnsupportedOperationError extends Schema.TaggedError("AI.Error.Unsu
     route: Schema.optional(RouteID),
 }) {
 }
+/**
+ * Provider settings that are missing, conflicting, or unsupported, such as
+ * Azure without `resourceName` or `baseURL`. Thrown synchronously while a
+ * provider facade or package entrypoint configures a model, before any
+ * request exists, so it is not an `AIError` reason.
+ */
+export class ProviderConfigurationError extends Schema.TaggedError("AI.Error.ProviderConfiguration")("ProviderConfiguration", {
+    provider: ProviderID,
+    message: Schema.String,
+}) {
+}
 export class NoRouteError extends Schema.TaggedError("AI.Error.NoRoute")("NoRoute", {
     ...ReasonFields,
     route: RouteID,

package/package.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
-  "version": "0.0.0-dev-19465",
+  "version": "0.0.0-dev-19467",
   "name": "@opencode/ai",
   "type": "module",
   "license": "MIT",
@@ -30,7 +30,7 @@
   "devDependencies": {
     "@clack/prompts": "1.0.0-alpha.1",
     "@effect/platform-node": "4.0.0-rc.112",
-    "@opencode/http-recorder": "0.0.0-dev-19465",
+    "@opencode/http-recorder": "0.0.0-dev-19467",
     "@tsconfig/bun": "1.0.9",
     "@types/bun": "1.4.0",
     "@typescript/native-preview": "7.0.0-dev.20251207.1",
@@ -40,7 +40,7 @@
     "@aws-sdk/credential-providers": "3.1057.0",
     "@smithy/eventstream-codec": "4.2.14",
     "@smithy/util-utf8": "4.2.2",
-    "@opencode/schema": "0.0.0-dev-19465",
+    "@opencode/schema": "0.0.0-dev-19467",
     "aws4fetch": "1.0.20",
     "effect": "4.0.0-rc.112",
     "google-auth-library": "10.5.0"