@axlsdk/axl 0.25.1 → 0.25.2

package/README.md

@@ -105,7 +105,7 @@ import { lookupOrder } from '../tools/db.js';
 
 export const supportAgent = agent({
   name: 'support',
-  model: 'openai-responses:gpt-5.5',
+  model: 'openai-responses:gpt-6-sol',
   system: 'You are a customer support agent. Use tools to look up order information.',
   tools: [lookupOrder],
 });
@@ -206,13 +206,12 @@ import { agent } from '@axlsdk/axl';
 
 const researcher = agent({
   name: 'researcher',
-  model: 'openai-responses:gpt-5.5',
+  model: 'openai-responses:gpt-6-sol',
   system: 'You are a research assistant.',
   tools: [calculator],
   effort: 'high',
   maxTurns: 10,
   timeout: '30s',
-  temperature: 0.7,
   version: 'v1.2',
 });
 ```
@@ -223,8 +222,8 @@ Dynamic model and system prompt selection:
 const dynamicAgent = agent({
   model: (ctx) =>
     ctx.metadata?.tier === 'premium'
-      ? 'openai-responses:gpt-5.5'
-      : 'openai-responses:gpt-5-nano',
+      ? 'openai-responses:gpt-6-sol'
+      : 'openai-responses:gpt-6-luna',
   system: (ctx) => `You are a ${ctx.metadata?.role ?? 'general'} assistant.`,
 });
 ```
@@ -263,7 +262,7 @@ for precedence, nested asks, and provider timing details.
 
 ```typescript
 const router = agent({
-  model: 'openai-responses:gpt-5-mini',
+  model: 'openai-responses:gpt-6-luna',
   system: 'Route to the right specialist.',
   handoffs: (ctx) => {
     const base = [
@@ -298,7 +297,7 @@ The `effort` parameter provides a unified way to control reasoning depth across
 ```typescript
 // Simple levels — works on any provider
 const reasoner = agent({
-  model: 'anthropic:claude-opus-4-7',
+  model: 'anthropic:claude-opus-5-5',
   system: 'You are a careful analyst.',
   effort: 'high', // 'none' | 'low' | 'medium' | 'high' | 'xhigh' | 'max'
 });
@@ -402,8 +401,8 @@ To observe events between `ctx.ask()` calls — e.g., streaming `partial_object`
 // compiles standalone.
 const outlineSchema = z.object({ outline: z.array(z.string()) });
 const draftSchema = z.object({ draft: z.string() });
-const planner = agent({ model: 'openai:gpt-4o', system: 'Plan an outline.' });
-const writer = agent({ model: 'openai:gpt-4o', system: 'Write a draft.' });
+const planner = agent({ model: 'openai-responses:gpt-6-sol', system: 'Plan an outline.' });
+const writer = agent({ model: 'openai-responses:gpt-6-sol', system: 'Write a draft.' });
 
 const wf = workflow({
   name: 'two-step',
@@ -631,7 +630,7 @@ const containsPII = (text: string) => /\b\d{3}-\d{2}-\d{4}\b/.test(text);
 const isOffTopic = (text: string) => !text.toLowerCase().includes('support');
 
 const safe = agent({
-  model: 'openai-responses:gpt-5.5',
+  model: 'openai-responses:gpt-6-sol',
   system: 'You are a helpful assistant.',
   guardrails: {
     input: async (prompt, ctx) => {
@@ -786,7 +785,7 @@ const session = runtime.session('user-123', {
   history: {
     maxMessages: 100,
     summarize: true,
-    summaryModel: 'openai-responses:gpt-5-mini',
+    summaryModel: 'openai-responses:gpt-6-luna',
   },
   persist: true,
 });
@@ -826,10 +825,10 @@ import {
 Four native adapters using the `provider:model` URI scheme (plus the OpenAI-compatible presets above):
 
 ```
-openai-responses:gpt-5.5               # OpenAI Responses API (preferred over Chat Completions)
-openai:gpt-5.4                         # OpenAI Chat Completions
-anthropic:claude-opus-4-8              # Anthropic (supports effort: 'xhigh' and 'max')
-google:gemini-3.1-pro-preview          # Google Gemini
+openai-responses:gpt-6-sol             # OpenAI Responses API (preferred over Chat Completions)
+openai:gpt-6-sol                       # OpenAI Chat Completions (text; use Responses for tools)
+anthropic:claude-sonnet-5-5            # Anthropic (also claude-haiku-5-5, claude-opus-5-5)
+google:gemini-3.8-flash                # Google Gemini
 ```
 
 See [docs/providers.md](../../docs/providers.md) for the full model list including reasoning models.

package/dist/index.cjs

@@ -581,7 +581,7 @@ var sharedGuard = typeof installedGuard === "object" && installedGuard !== null
 var buildPath = typeof __AXL_BUILD_PATH__ === "string" ? __AXL_BUILD_PATH__ : "<source>";
 var thisCopy = {
   path: buildPath.startsWith("file:") ? (0, import_node_url.fileURLToPath)(buildPath) : buildPath,
-  version: true ? "0.25.1" : "unknown"
+  version: true ? "0.25.2" : "unknown"
 };
 function warnCrossCopy(other, joined) {
   if (other === thisCopy) return;
@@ -5146,6 +5146,17 @@ var ANTHROPIC_THINKING_BINDING_BETA = "thinking-binding-controls-2026-08-01";
 function isRecord(value) {
   return value !== null && typeof value === "object" && !Array.isArray(value);
 }
+function isFinalThinkingAdaptive(capability, body) {
+  const thinking = body.thinking;
+  if (thinking === void 0) {
+    return capability.thinking === "adaptive-default-on" || capability.thinking === "adaptive-always-on";
+  }
+  return isRecord(thinking) && thinking.type === "adaptive";
+}
+var NATIVE_CLAUDE_EFFORTS = ["low", "medium", "high", "xhigh", "max"];
+function isNativeClaudeEffort(value) {
+  return NATIVE_CLAUDE_EFFORTS.includes(value);
+}
 function hasReplayedThinking(body) {
   return Array.isArray(body.messages) && body.messages.some(
     (message) => isRecord(message) && Array.isArray(message.content) && message.content.some(
@@ -5180,11 +5191,40 @@ function hasAnthropicProviderFileImage(messages) {
   );
 }
 var CLAUDE_CAPABILITIES = {
+  // Thinking off is `between_tools` (progress updates between tool calls);
+  // `disabled` is a provider 400. Forced tool choice is a 400.
+  "claude-sonnet-5-5": {
+    thinking: "adaptive-default-on",
+    effortLevels: ["low", "medium", "high", "xhigh", "max"],
+    manualBudget: false,
+    stripTemperature: true,
+    disableAt: "high",
+    offShape: "between_tools",
+    forcedToolChoice: "rejected",
+    defaultOnlySampling: true,
+    strictThinking: true,
+    thinkingBinding: true
+  },
+  // Thinking off is `disabled`, only at effort high or below. Forced tool
+  // choice is accepted (the provider skips thinking for that turn).
+  "claude-haiku-5-5": {
+    thinking: "adaptive-default-on",
+    effortLevels: ["low", "medium", "high", "xhigh", "max"],
+    manualBudget: false,
+    stripTemperature: true,
+    disableAt: "high",
+    defaultOnlySampling: true,
+    strictThinking: true,
+    thinkingBinding: true
+  },
   "claude-opus-5-5": {
     thinking: "adaptive-always-on",
     effortLevels: ["low", "medium", "high", "xhigh", "max"],
     manualBudget: false,
     stripTemperature: true,
+    forcedToolChoice: "rejected",
+    defaultOnlySampling: true,
+    strictThinking: true,
     thinkingBinding: true
   },
   "claude-fable-5-1": {
@@ -5192,6 +5232,9 @@ var CLAUDE_CAPABILITIES = {
     effortLevels: ["low", "medium", "high", "xhigh", "max"],
     manualBudget: false,
     stripTemperature: true,
+    forcedToolChoice: "rejected",
+    defaultOnlySampling: true,
+    strictThinking: true,
     thinkingBinding: true
   },
   "claude-fable-5": {
@@ -5286,6 +5329,15 @@ function resolveClaudeCapability(model) {
 }
 var DEFAULT_CACHE_READ_MULTIPLIER = 0.1;
 var ANTHROPIC_RATES = {
+  // Sonnet 5.5 cache reads are 0.05x ($0.10/MTok): the pricing table, its
+  // footnote, the models overview, and the prompt-caching guide agree
+  // (re-checked 2026-10-07).
+  "claude-sonnet-5-5": { input: 2e-6, output: 1e-5, cacheReadMultiplier: 0.05 },
+  "claude-haiku-5-5": {
+    input: 1e-7,
+    output: 5e-7,
+    longPrompt: { aboveTokens: 1e5, card: { input: 5e-7, output: 25e-7 } }
+  },
   "claude-opus-5-5": { input: 4e-6, output: 2e-5, cacheReadMultiplier: 0.05 },
   "claude-fable-5-1": { input: 1e-5, output: 5e-5, cacheReadMultiplier: 0.025 },
   "claude-fable-5": { input: 1e-5, output: 5e-5 },
@@ -5348,14 +5400,16 @@ function estimateAnthropicCost(model, usage) {
     return void 0;
   }
   const cacheWriteTotal = safeTokenSum(cacheWrite5m, cacheWrite1h);
-  if (cacheWriteTotal === void 0 || safeTokenSum(usage.inputTokens, cacheRead, cacheWriteTotal) === void 0) {
+  const promptTokens = cacheWriteTotal === void 0 ? void 0 : safeTokenSum(usage.inputTokens, cacheRead, cacheWriteTotal);
+  if (cacheWriteTotal === void 0 || promptTokens === void 0) {
     return void 0;
   }
   if (usage.aggregateCacheWriteTokens !== void 0 && (!isValidTokenCount(usage.aggregateCacheWriteTokens) || usage.aggregateCacheWriteTokens !== cacheWriteTotal)) {
     return void 0;
   }
-  const { input, output } = rate;
-  const cacheReadRate = input * (rate.cacheReadMultiplier ?? DEFAULT_CACHE_READ_MULTIPLIER);
+  const card = rate.longPrompt && promptTokens > rate.longPrompt.aboveTokens ? rate.longPrompt.card : rate;
+  const { input, output } = card;
+  const cacheReadRate = input * (card.cacheReadMultiplier ?? DEFAULT_CACHE_READ_MULTIPLIER);
   return usage.inputTokens * input + cacheRead * cacheReadRate + cacheWrite5m * input * 1.25 + cacheWrite1h * input * 2 + usage.outputTokens * output;
 }
 var THINKING_BUDGETS = {
@@ -5417,7 +5471,7 @@ function resolveClaudeThinking(model, resolved) {
         };
       }
       return {
-        thinking: { type: "disabled" },
+        thinking: { type: capability.offShape ?? "disabled" },
         outputConfig: activeEffort ? { effort: activeEffort } : void 0,
         stripTemperature: true
       };
@@ -5823,50 +5877,106 @@ var AnthropicProvider = class {
       ...betas.length > 0 ? { "anthropic-beta": betas.join(",") } : {}
     };
   }
+  /**
+   * Whether the final body needs the binding beta header. Runs after
+   * `validateAndBindFinalBody`, which has already injected `block_binding`
+   * wherever it applies, so the header follows the final body rather than
+   * re-deriving the injection rule.
+   */
   requiresBindingBeta(body) {
+    const capability = resolveClaudeCapability(String(body.model));
     const thinking = body.thinking;
-    return resolveClaudeCapability(String(body.model))?.thinkingBinding === true && (hasReplayedThinking(body) || isRecord(thinking) && thinking.block_binding !== void 0);
+    return capability?.thinkingBinding === true && isRecord(thinking) && thinking.type === "adaptive" && thinking.block_binding !== void 0;
   }
+  /**
+   * Validate the final body (after `providerOptions`) against the effective
+   * model's capability, then inject `block_binding` where it applies. Every
+   * rule is gated on its own capability field and is a no-op when unset, so a
+   * model only gets the guards its provider contract calls for.
+   */
   validateAndBindFinalBody(body) {
     const model = typeof body.model === "string" ? body.model : "";
-    if (resolveClaudeCapability(model)?.thinkingBinding !== true) return;
+    const capability = resolveClaudeCapability(model);
+    if (!capability) return;
     const reject = (option, remediation) => {
       throw new UnsupportedModelOptionError({ provider: this.name, model, option, remediation });
     };
-    const toolChoice = body.tool_choice;
-    if (isRecord(toolChoice) && (toolChoice.type === "any" || toolChoice.type === "tool")) {
-      reject("forced tool choice", "Use toolChoice: 'auto' or 'none' on this model.");
-    }
-    if (body.thinking !== void 0 && (!isRecord(body.thinking) || body.thinking.type !== "adaptive" || body.thinking.budget_tokens !== void 0)) {
-      reject(
-        "manual or disabled thinking",
-        "Use thinking: { type: 'adaptive' } and output_config.effort."
-      );
-    }
-    const outputConfig = body.output_config;
-    if (outputConfig !== void 0 && (!isRecord(outputConfig) || outputConfig.effort !== void 0 && !["low", "medium", "high", "xhigh", "max"].includes(String(outputConfig.effort)))) {
-      reject("output_config.effort", "Use low, medium, high, xhigh, or max effort.");
-    }
-    if (body.temperature !== void 0 && body.temperature !== 1) {
-      reject("temperature", "Omit temperature or use the default value 1.");
-    }
-    if (body.top_p !== void 0 && (typeof body.top_p !== "number" || body.top_p < 0.99 || body.top_p > 1)) {
-      reject("top_p", "Omit top_p or use a value from 0.99 to 1.");
+    if (capability.forcedToolChoice === "rejected") {
+      const toolChoice = body.tool_choice;
+      if (isRecord(toolChoice) && (toolChoice.type === "any" || toolChoice.type === "tool")) {
+        reject("forced tool choice", "Use toolChoice: 'auto' or 'none' on this model.");
+      }
+    }
+    if (capability.strictThinking) {
+      const offShape = capability.thinking === "adaptive-always-on" ? void 0 : capability.offShape ?? "disabled";
+      const thinking = body.thinking;
+      const outputConfig = body.output_config;
+      const effort = isRecord(outputConfig) ? outputConfig.effort : void 0;
+      if (thinking !== void 0 && offShape === void 0) {
+        if (!isRecord(thinking) || thinking.type !== "adaptive" || thinking.budget_tokens !== void 0) {
+          reject(
+            "manual or disabled thinking",
+            "Use thinking: { type: 'adaptive' } and output_config.effort."
+          );
+        }
+      } else if (thinking !== void 0) {
+        if (!isRecord(thinking) || thinking.type !== "adaptive" && thinking.type !== offShape) {
+          reject(
+            "thinking.type",
+            `Use thinking: { type: 'adaptive' }, or { type: '${offShape}' } to turn thinking off.`
+          );
+        }
+        const record = thinking;
+        if (record.type === "adaptive" && record.budget_tokens !== void 0) {
+          reject("thinking.budget_tokens", "Use output_config.effort instead of budget_tokens.");
+        }
+        if (record.type === offShape) {
+          const extra = Object.keys(record).filter((key) => key !== "type");
+          if (extra.length > 0) {
+            reject(
+              `thinking.${offShape}.${extra[0]}`,
+              `Send thinking: { type: '${offShape}' } with no other fields.`
+            );
+          }
+        }
+      }
+      if (outputConfig !== void 0 && (!isRecord(outputConfig) || effort !== void 0 && !isNativeClaudeEffort(effort))) {
+        reject("output_config.effort", "Use low, medium, high, xhigh, or max effort.");
+      }
+      if (offShape !== void 0 && isRecord(thinking) && thinking.type === offShape && effort !== void 0 && capability.disableAt && !isEffortAtOrBelow(effort, capability.disableAt)) {
+        reject(
+          "output_config.effort",
+          `Thinking can be turned off only at effort '${capability.disableAt}' or below; lower the effort or use adaptive thinking.`
+        );
+      }
     }
-    if (body.top_k !== void 0) {
-      reject("top_k", "Omit top_k on this model.");
+    if (capability.defaultOnlySampling) {
+      if (body.temperature !== void 0 && body.temperature !== 1) {
+        reject("temperature", "Omit temperature or use the default value 1.");
+      }
+      if (body.top_p !== void 0 && body.top_p !== 0.99) {
+        reject("top_p", "Omit top_p or use the default value 0.99.");
+      }
+      if (body.temperature !== void 0 && body.top_p !== void 0) {
+        reject("temperature and top_p", "Send at most one of temperature and top_p.");
+      }
+      if (body.top_k !== void 0) {
+        reject("top_k", "Omit top_k on this model.");
+      }
     }
-    const replayed = hasReplayedThinking(body);
-    if (!replayed) return;
-    const thinking = isRecord(body.thinking) ? body.thinking : { type: "adaptive" };
-    const binding = thinking.block_binding;
-    if (binding !== void 0 && (!isRecord(binding) || binding.prefix_mismatch_behavior !== "error" && binding.prefix_mismatch_behavior !== "drop_block")) {
-      reject("thinking.block_binding", "Use prefix_mismatch_behavior: 'error' or 'drop_block'.");
+    if (capability.thinkingBinding === true && isFinalThinkingAdaptive(capability, body)) {
+      const thinking = isRecord(body.thinking) ? body.thinking : { type: "adaptive" };
+      const binding = thinking.block_binding;
+      if (binding !== void 0 && (!isRecord(binding) || binding.prefix_mismatch_behavior !== "error" && binding.prefix_mismatch_behavior !== "drop_block")) {
+        reject("thinking.block_binding", "Use prefix_mismatch_behavior: 'error' or 'drop_block'.");
+      }
+      if (hasReplayedThinking(body)) {
+        body.thinking = {
+          ...thinking,
+          block_binding: binding ?? { prefix_mismatch_behavior: "drop_block" }
+        };
+      }
     }
-    body.thinking = {
-      ...thinking,
-      block_binding: binding ?? { prefix_mismatch_behavior: "drop_block" }
-    };
   }
   /** Extract a human-readable message from an API error response body. */
   extractErrorMessage(body, status) {