@axlsdk/axl 0.22.1 → 0.22.2

package/README.md

@@ -67,7 +67,7 @@ agent({ model: 'deepseek:deepseek-reasoner' });           // DEEPSEEK_API_KEY
 agent({ model: 'ollama:llama3' });                        // local — no key, $0
 ```
 
-Presets: `openrouter`, `azure`, `xai`, `deepseek`, `mistral`, `groq`, `bedrock`, and self-hosted `ollama` / `vllm` / `lmstudio` / `llamacpp` / `sglang`. The unified `effort` knob and per-call cost tracking work across them. OpenRouter passes image input through to the selected model/route, but Axl does not claim every catalog model supports images, tools, or transcription. Build your own by cloning a `ProviderProfile`; see [provider details](../../docs/providers.md#openai-compatible-providers--presets) and [multimodal input](../../docs/multimodal-input.md).
+Presets: `openrouter`, `azure`, `xai`, `deepseek`, `mistral`, `groq`, `bedrock`, and self-hosted `ollama` / `vllm` / `lmstudio` / `llamacpp` / `sglang`. The unified `effort` knob and per-call cost tracking work across them. OpenAI Responses, Anthropic, Google, and OpenRouter accept image input without hard-coding a model catalog; the selected upstream model remains authoritative. Completed-file transcription is a separate, narrower contract. Build your own compatible provider by cloning a `ProviderProfile`; see [provider details](../../docs/providers.md) and [multimodal input](../../docs/multimodal-input.md).
 
 Each provider also accepts an opt-in `rateLimit` (`{ maxConcurrent?, minIntervalMs?, acquireTimeoutMs? }`) for proactive client-side pacing on top of the automatic 429/503/529 backoff — useful when a large fan-out (e.g. an eval) shares one API key. It caps in-flight request concurrency (not token throughput) for that provider's chat calls. See [Providers → Rate limiting](../../docs/providers.md#rate-limiting-opt-in).
 

package/dist/index.cjs

@@ -1427,7 +1427,8 @@ var OpenAICompatibleProvider = class {
     return this.name === "openrouter" && model.trim().length > 0 ? { image: { sources: ["url", "bytes", "base64"] } } : {};
   }
   validateInput(request) {
-    const effectiveModel = typeof request.providerOptions?.model === "string" ? request.providerOptions.model : request.model;
+    const modelOverride = request.providerOptions?.model;
+    const effectiveModel = typeof modelOverride === "string" ? modelOverride : request.model;
     const fail = (source, feature) => {
       throw new UnsupportedModelInputError({
         provider: this.name,
@@ -1437,6 +1438,9 @@ var OpenAICompatibleProvider = class {
         ...feature ? { feature } : {}
       });
     };
+    if (request.providerOptions && "model" in request.providerOptions && (typeof modelOverride !== "string" || modelOverride.trim().length === 0)) {
+      fail(void 0, "invalid model providerOptions");
+    }
     if (this.name !== "openrouter" || effectiveModel.trim().length === 0) {
       fail(void 0, "image input for this model");
     }
@@ -2377,13 +2381,6 @@ var OpenAIProvider = class extends OpenAICompatibleProvider {
 };
 
 // src/providers/openai-responses.ts
-var OPENAI_RESPONSES_IMAGE_MODELS = /* @__PURE__ */ new Set([
-  "gpt-4o",
-  "gpt-4o-2024-08-06",
-  "gpt-4o-2024-11-20",
-  "gpt-4o-mini",
-  "gpt-4o-mini-2024-07-18"
-]);
 function base64FromSource(source) {
   return source.type === "base64" ? source.data : Buffer.from(source.data.buffer, source.data.byteOffset, source.data.byteLength).toString(
     "base64"
@@ -2422,10 +2419,11 @@ function responseImageParts(parts) {
 var OpenAIResponsesProvider = class {
   name = "openai-responses";
   inputCapabilities(model) {
-    return OPENAI_RESPONSES_IMAGE_MODELS.has(model) ? { image: { sources: ["url", "bytes", "base64", "provider-file"] } } : {};
+    return model.trim().length > 0 ? { image: { sources: ["url", "bytes", "base64", "provider-file"] } } : {};
   }
   validateInput(request) {
-    const effectiveModel = typeof request.providerOptions?.model === "string" ? request.providerOptions.model : request.model;
+    const modelOverride = request.providerOptions?.model;
+    const effectiveModel = typeof modelOverride === "string" ? modelOverride : request.model;
     const fail = (source, feature) => {
       throw new UnsupportedModelInputError({
         provider: this.name,
@@ -2435,7 +2433,10 @@ var OpenAIResponsesProvider = class {
         ...feature ? { feature } : {}
       });
     };
-    if (!OPENAI_RESPONSES_IMAGE_MODELS.has(effectiveModel)) {
+    if (request.providerOptions && "model" in request.providerOptions && (typeof modelOverride !== "string" || modelOverride.trim().length === 0)) {
+      fail(void 0, "invalid model providerOptions");
+    }
+    if (effectiveModel.trim().length === 0) {
       fail(void 0, "image input for this model");
     }
     if (request.providerOptions && "input" in request.providerOptions) {
@@ -2563,7 +2564,7 @@ var OpenAIResponsesProvider = class {
     const resolved = resolveThinkingOptions(options);
     const { includeThoughts } = resolved;
     const wireEffort = resolveOpenAIReasoningEffort(effectiveModel, resolved);
-    const stripTemp = oSeries || reasoningCapable && wireEffort !== void 0;
+    const stripTemp = oSeries || supportsMaxReasoningEffort(effectiveModel) || reasoningCapable && wireEffort !== void 0;
     const systemMessages = messages.filter((m) => m.role === "system");
     const nonSystemMessages = messages.filter((m) => m.role !== "system");
     const body = {
@@ -2911,7 +2912,6 @@ function anthropicImageBlocks(parts) {
 }
 var ANTHROPIC_API_VERSION = "2023-06-01";
 var ANTHROPIC_FILES_BETA = "files-api-2025-04-14";
-var ANTHROPIC_IMAGE_MODELS = /* @__PURE__ */ new Set(["claude-sonnet-4-5", "claude-opus-4-8"]);
 function hasAnthropicProviderFileImage(messages) {
   return messages.some(
     (message) => Array.isArray(message.content) && message.content.some(
@@ -3030,6 +3030,28 @@ var ANTHROPIC_RATES = {
 function isValidTokenCount(value) {
   return value !== void 0 && Number.isSafeInteger(value) && value >= 0;
 }
+function anthropicStreamErrorStatus(type) {
+  switch (type) {
+    case "invalid_request_error":
+      return 400;
+    case "authentication_error":
+      return 401;
+    case "permission_error":
+      return 403;
+    case "not_found_error":
+      return 404;
+    case "request_too_large":
+      return 413;
+    case "rate_limit_error":
+      return 429;
+    case "api_error":
+      return 500;
+    case "overloaded_error":
+      return 529;
+    default:
+      return 0;
+  }
+}
 function estimateAnthropicCost(model, usage, now = /* @__PURE__ */ new Date()) {
   if (!model || !isValidTokenCount(usage.inputTokens) || !isValidTokenCount(usage.outputTokens)) {
     return void 0;
@@ -3279,10 +3301,11 @@ function mergeAnthropicUsage(initial, update) {
 var AnthropicProvider = class {
   name = "anthropic";
   inputCapabilities(model) {
-    return ANTHROPIC_IMAGE_MODELS.has(model) ? { image: { sources: ["url", "bytes", "base64", "provider-file"] } } : {};
+    return model.trim().length > 0 ? { image: { sources: ["url", "bytes", "base64", "provider-file"] } } : {};
   }
   validateInput(request) {
-    const effectiveModel = typeof request.providerOptions?.model === "string" ? request.providerOptions.model : request.model;
+    const modelOverride = request.providerOptions?.model;
+    const effectiveModel = typeof modelOverride === "string" ? modelOverride : request.model;
     const fail = (source, feature) => {
       throw new UnsupportedModelInputError({
         provider: this.name,
@@ -3292,7 +3315,10 @@ var AnthropicProvider = class {
         ...feature ? { feature } : {}
       });
     };
-    if (!ANTHROPIC_IMAGE_MODELS.has(effectiveModel)) {
+    if (request.providerOptions && "model" in request.providerOptions && (typeof modelOverride !== "string" || modelOverride.trim().length === 0)) {
+      fail(void 0, "invalid model providerOptions");
+    }
+    if (effectiveModel.trim().length === 0) {
       fail(void 0, "image input for this model");
     }
     if (request.providerOptions && "messages" in request.providerOptions) {
@@ -3417,7 +3443,7 @@ var AnthropicProvider = class {
     if (!res.body) {
       throw new Error("Anthropic stream response has no body");
     }
-    yield* this.parseSSEStream(res.body, pricingContext);
+    yield* this.parseSSEStream(res.body, pricingContext, res.headers);
   }
   // ---------------------------------------------------------------------------
   // Internal: request building
@@ -3660,7 +3686,7 @@ ${jsonInstruction}` : jsonInstruction;
   // ---------------------------------------------------------------------------
   // Internal: SSE stream parsing
   // ---------------------------------------------------------------------------
-  async *parseSSEStream(body, pricingContext) {
+  async *parseSSEStream(body, pricingContext, responseHeaders) {
     const reader = body.getReader();
     const decoder = new TextDecoder();
     let buffer = "";
@@ -3706,6 +3732,15 @@ ${jsonInstruction}` : jsonInstruction;
             continue;
           }
           switch (event.type) {
+            case "error": {
+              const status = anthropicStreamErrorStatus(event.error?.type);
+              throw buildProviderError({
+                provider: this.name,
+                status,
+                headers: responseHeaders,
+                message: event.error?.message ?? "Anthropic stream failed"
+              });
+            }
             case "content_block_start": {
               const block = event.content_block;
               if (block?.type === "tool_use") {
@@ -3957,7 +3992,6 @@ var GEMINI_PRICING = {
   "gemini-3.5-flash-lite": { input: 3e-7, cached: 3e-8, output: 25e-7 },
   "gemini-3.6-flash": { input: 15e-7, cached: 15e-8, output: 75e-7 }
 };
-var GEMINI_INTERACTIONS_IMAGE_MODELS = /* @__PURE__ */ new Set(["gemini-3.7-flash"]);
 function isValidTokenCount2(value) {
   return typeof value === "number" && Number.isSafeInteger(value) && value >= 0;
 }
@@ -3967,6 +4001,55 @@ function isStandardGeminiRequestTier(value) {
 function isDefinitiveStandardGeminiResponseTier(value) {
   return value === "SERVICE_TIER_UNSPECIFIED" || value === "SERVICE_TIER_STANDARD" || value === "standard";
 }
+function geminiInteractionErrorStatus(code) {
+  if (typeof code === "number" && Number.isInteger(code) && code >= 100 && code <= 599) {
+    return code;
+  }
+  switch (code) {
+    case "invalid_request":
+    case "invalid_argument":
+    case "parameter_unknown":
+    case "failed_precondition":
+      return 400;
+    case "authentication":
+    case "unauthenticated":
+      return 401;
+    case "permission_denied":
+      return 403;
+    case "not_found":
+    case "model_not_found":
+      return 404;
+    case "request_timeout":
+      return 408;
+    case "conflict":
+    case "already_exists":
+      return 409;
+    case "request_too_large":
+      return 413;
+    case "out_of_range":
+      return 416;
+    case "quota_exceeded":
+    case "resource_exhausted":
+    case "rate_limit_exceeded":
+      return 429;
+    case "cancelled":
+      return 499;
+    case "api_error":
+    case "internal":
+    case "internal_server_error":
+      return 500;
+    case "bad_gateway":
+      return 502;
+    case "unavailable":
+    case "service_unavailable":
+      return 503;
+    case "deadline_exceeded":
+    case "gateway_timeout":
+      return 504;
+    default:
+      return void 0;
+  }
+}
 function isEligibleGeminiPricing(context, hasDefinitiveStandardResponseTier, hasInvalidResponseTier) {
   return context.eligibleRequest && isStandardGeminiRequestTier(context.serviceTier) && hasDefinitiveStandardResponseTier && !hasInvalidResponseTier;
 }
@@ -4048,7 +4131,9 @@ var GEMINI_3X_MIN_THINKING_LEVEL = /* @__PURE__ */ new Map([
   ["gemini-3.6-flash", "minimal"],
   // L4 live evidence: Interactions gemini-3.7-flash accepts low/medium/high,
   // but rejects minimal. Keep this exact entry isolated from legacy aliases.
-  ["gemini-3.7-flash", "low"]
+  ["gemini-3.7-flash", "low"],
+  // Current-model live evidence: gemini-3.8-flash has the same low floor.
+  ["gemini-3.8-flash", "low"]
 ]);
 var GEMINI_MODELS_WITHOUT_PORTABLE_TEMPERATURE = /* @__PURE__ */ new Set([
   "gemini-3.5-flash-lite",
@@ -4076,10 +4161,11 @@ function warnGemini3xEffortNone(model) {
 var GeminiProvider = class {
   name = "google";
   inputCapabilities(model) {
-    return GEMINI_INTERACTIONS_IMAGE_MODELS.has(model) ? { image: { sources: ["bytes", "base64", "provider-file"] } } : {};
+    return model.trim().length > 0 ? { image: { sources: ["bytes", "base64", "provider-file"] } } : {};
   }
   validateInput(request) {
-    const effectiveModel = typeof request.providerOptions?.model === "string" ? request.providerOptions.model : request.model;
+    const modelOverride = request.providerOptions?.model;
+    const effectiveModel = typeof modelOverride === "string" ? modelOverride : request.model;
     const fail = (source, feature) => {
       throw new UnsupportedModelInputError({
         provider: this.name,
@@ -4089,7 +4175,10 @@ var GeminiProvider = class {
         ...feature ? { feature } : {}
       });
     };
-    if (!GEMINI_INTERACTIONS_IMAGE_MODELS.has(effectiveModel)) {
+    if (request.providerOptions && "model" in request.providerOptions && (typeof modelOverride !== "string" || modelOverride.trim().length === 0)) {
+      fail(void 0, "invalid model providerOptions");
+    }
+    if (effectiveModel.trim().length === 0) {
       fail(void 0, "image input for this model");
     }
     if (request.providerOptions) {
@@ -4281,7 +4370,7 @@ var GeminiProvider = class {
       });
     }
     if (!res.body) throw new Error("Gemini Interactions stream has no body");
-    yield* this.parseInteractionSSEStream(res.body);
+    yield* this.parseInteractionSSEStream(res.body, res.headers);
   }
   buildInteractionRequestBody(messages, options, stream) {
     const model = this.requestModel(options);
@@ -4351,6 +4440,7 @@ var GeminiProvider = class {
     return body;
   }
   assertSafeInteractionOptions(options) {
+    const modelOverride = options.providerOptions?.model;
     const model = this.requestModel(options);
     const fail = (feature) => {
       throw new UnsupportedModelInputError({
@@ -4360,7 +4450,10 @@ var GeminiProvider = class {
         feature
       });
     };
-    if (!GEMINI_INTERACTIONS_IMAGE_MODELS.has(model)) fail("image input for this model");
+    if (options.providerOptions && "model" in options.providerOptions && (typeof modelOverride !== "string" || modelOverride.trim().length === 0)) {
+      fail("invalid model providerOptions");
+    }
+    if (model.trim().length === 0) fail("image input for this model");
     const forbidden = [
       "input",
       "contents",
@@ -4436,7 +4529,7 @@ var GeminiProvider = class {
       providerMetadata: json.steps?.length ? { geminiInteractionSteps: json.steps.filter(isGeminiInteractionStep) } : void 0
     };
   }
-  async *parseInteractionSSEStream(body) {
+  async *parseInteractionSSEStream(body, responseHeaders) {
     const reader = body.getReader();
     const decoder = new TextDecoder();
     let buffer = "";
@@ -4462,7 +4555,22 @@ var GeminiProvider = class {
             continue;
           }
           if (event.event_type === "error") {
-            throw new Error(event.error?.message ?? "Gemini Interactions stream failed");
+            const status = geminiInteractionErrorStatus(event.error?.code);
+            const message = event.error?.message ?? "Gemini Interactions stream failed";
+            if (status !== void 0) {
+              throw buildProviderError({
+                provider: this.name,
+                status,
+                headers: responseHeaders,
+                message
+              });
+            }
+            throw new ProviderError({
+              provider: this.name,
+              status: 0,
+              retryable: false,
+              message
+            });
           }
           if (event.event_type === "step.start" && event.step) {
             const index = event.index;