@absolutejs/ai 0.2.3 → 0.2.4

package/CHANGELOG.md

@@ -6,6 +6,12 @@ This file is generated by `absolute-changelog` from the entries in
 `changelog/`. Edit an entry, not this file — and add new ones under
 `changelog/unreleased/`.
 
+## 0.2.4 — 2026-09-20
+
+### Added
+
+- **Add reviewed per-model reasoning controls, provider translations, and compatible thinking stream replay.** (`MODEL_REASONING`, `REASONING_EFFORTS`, `getModelReasoning`, `isReasoningSelection`, `supportsReasoningSelection`, `reasoningSelectionLabel`, `ModelReasoning`, `ReasoningSelection`, `ReasoningEffort`)
+
 ## 0.2.3 — 2026-09-20
 
 ### Internal

package/changelog.json

@@ -2,6 +2,27 @@
 	"contract": 1,
 	"name": "@absolutejs/ai",
 	"releases": [
+		{
+			"changes": [
+				{
+					"kind": "added",
+					"summary": "Add reviewed per-model reasoning controls, provider translations, and compatible thinking stream replay.",
+					"symbols": [
+						"MODEL_REASONING",
+						"REASONING_EFFORTS",
+						"getModelReasoning",
+						"isReasoningSelection",
+						"supportsReasoningSelection",
+						"reasoningSelectionLabel",
+						"ModelReasoning",
+						"ReasoningSelection",
+						"ReasoningEffort"
+					]
+				}
+			],
+			"date": "2026-09-20",
+			"version": "0.2.4"
+		},
 		{
 			"changes": [
 				{

package/dist/ai/index.js

@@ -582,17 +582,70 @@ async function* tapStream(source, params, providerName) {
   }
 }
 
+// src/ai/models/reasoning.ts
+var profile = (kind, efforts, description, source) => ({ kind, efforts, description, source });
+var claude = profile("effort", ["low", "medium", "high", "xhigh", "max"], "More thinking for harder problems; higher settings can take longer and use more credits.", "https://platform.claude.com/docs/en/build-with-claude/effort");
+var claude46 = {
+  ...claude,
+  efforts: ["low", "medium", "high", "max"]
+};
+var haiku = profile("budget", ["none", "low", "medium", "high"], "Thinking-token budget: Low 2,048; Medium 8,192; High 16,384. Actual usage can be lower.", "https://platform.claude.com/docs/en/build-with-claude/extended-thinking");
+var gpt = profile("effort", ["none", "low", "medium", "high", "xhigh", "max"], claude.description, "https://developers.openai.com/api/docs/models/gpt-5.6-sol");
+var gemini = profile("effort", ["low", "medium", "high"], claude.description, "https://ai.google.dev/gemini-api/docs/openai");
+var deepseek = profile("effort", ["none", "low", "high", "max"], claude.description, "https://api-docs.deepseek.com/guides/thinking_mode/");
+var mistral = profile("effort", ["none", "high"], "Minimal thinking or full reasoning. This model does not offer intermediate effort levels.", "https://docs.mistral.ai/studio/conversations/reasoning");
+var qwen = profile("budget", ["none", "low", "medium", "high"], haiku.description, "https://help.aliyun.com/en/model-studio/deep-thinking");
+var MODEL_REASONING = {
+  "anthropic:claude-fable-5-1": claude,
+  "anthropic:claude-opus-5": claude,
+  "anthropic:claude-sonnet-5": claude,
+  "anthropic:claude-sonnet-4-6": claude46,
+  "anthropic:claude-opus-4-6": claude46,
+  "anthropic:claude-haiku-4-5": haiku,
+  "openai:gpt-6-astra": {
+    ...gpt,
+    efforts: ["low", "medium", "high", "xhigh", "max"],
+    source: "https://developers.openai.com/api/docs/models/gpt-6-astra"
+  },
+  "openai:gpt-5.6-sol": gpt,
+  "openai:gpt-5.6-terra": gpt,
+  "openai:gpt-5.6-luna": gpt,
+  "google:gemini-3.8-flash": gemini,
+  "google:gemini-3.1-pro-preview": gemini,
+  "google:gemini-2.5-flash": profile("budget", ["none", "low", "medium", "high"], "Thinking-token budget: Low 1,024; Medium 8,192; High 24,576.", gemini.source),
+  "xai:grok-4.6": profile("effort", ["low", "medium", "high", "xhigh"], "Always reasons. Choose how much thinking it should do.", "https://docs.x.ai/developers/model-capabilities/text/reasoning"),
+  "deepseek:deepseek-flash": deepseek,
+  "deepseek:deepseek-v4-pro": deepseek,
+  "mistral:mistral-medium-3-5": mistral,
+  "mistral:mistral-small-latest": mistral,
+  "alibaba:qwen3.8-max": qwen,
+  "alibaba:qwen3.7-plus": qwen,
+  "moonshot:kimi-k3": profile("effort", ["low", "high", "max"], "Always reasons. Choose how much thinking it should do.", "https://platform.kimi.ai/docs/guide/kimi-k3-quickstart"),
+  "moonshot:kimi-k2.7-code": profile("fixed", [], "Thinking is always enabled; this model has no documented adjustable effort control.", "https://www.kimi.ai/resources/kimi-k2-7-code")
+};
+var getModelReasoning = (provider, model) => MODEL_REASONING[`${provider}:${model}`];
+
 // src/ai/providers/reasoning.ts
 var EFFORT_ORDER = [
+  "none",
   "minimal",
   "low",
   "medium",
   "high",
+  "xhigh",
   "max"
 ];
-var ANTHROPIC_EFFORT = [/opus-4-[5-8]/, /sonnet-4-6/, /fable-5/, /mythos-5/];
+var ANTHROPIC_EFFORT = [
+  /opus-4-[5-8]/,
+  /sonnet-4-6/,
+  /fable-5/,
+  /mythos-5/,
+  /opus-5/,
+  /sonnet-5/
+];
 var ANTHROPIC_ADAPTIVE_ONLY = [];
 var ANTHROPIC_LEGACY_THINKING = [
+  /haiku-4-5/,
   /sonnet-4-5/,
   /sonnet-4-0/,
   /sonnet-4-2025/,
@@ -601,14 +654,20 @@ var ANTHROPIC_LEGACY_THINKING = [
   /opus-4-2025/,
   /3-7-sonnet/
 ];
-var ANTHROPIC_NO_SAMPLING = [/opus-4-[78]/, /fable-5/, /mythos-5/];
+var ANTHROPIC_NO_SAMPLING = [
+  /opus-4-[78]/,
+  /fable-5/,
+  /mythos-5/,
+  /opus-5/,
+  /sonnet-5/
+];
 var ANTHROPIC_MAX_EFFORT = [
   /opus-4-[678]/,
   /sonnet-4-6/,
   /fable-5/,
   /mythos-5/
 ];
-var OPENAI_REASONING = [/(^|[^a-z])o[1345](-|$)/, /gpt-5/];
+var OPENAI_REASONING = [/(^|[^a-z])o[1345](-|$)/, /gpt-[56]/];
 var OPENAI_MINIMAL_EFFORT = [/gpt-5/];
 var matches = (model, patterns) => patterns.some((pattern) => pattern.test(model));
 var anthropicReasoningMode = (model) => {
@@ -623,6 +682,8 @@ var anthropicReasoningMode = (model) => {
 var anthropicSupportsSampling = (model) => !matches(model, ANTHROPIC_NO_SAMPLING);
 var isOpenAIReasoningModel = (model) => matches(model, OPENAI_REASONING);
 var EFFORT_BUDGET = {
+  none: 0,
+  xhigh: 24576,
   high: 16384,
   low: 2048,
   max: 32768,
@@ -668,6 +729,9 @@ var anthropicEffortValue = (model, reasoning) => {
   const effort = resolveEffort(reasoning);
   if (!effort)
     return null;
+  const known = getModelReasoning("anthropic", model);
+  if (known?.kind === "effort")
+    return clampEffort(effort, [...known.efforts]);
   const allowed = matches(model, ANTHROPIC_MAX_EFFORT) ? ["low", "medium", "high", "max"] : ["low", "medium", "high"];
   return clampEffort(effort, allowed);
 };
@@ -677,10 +741,50 @@ var openaiEffortValue = (model, reasoning) => {
   const effort = resolveEffort(reasoning);
   if (!effort)
     return null;
+  const known = getModelReasoning("openai", model);
+  if (known)
+    return clampEffort(effort, [...known.efforts]);
   const allowed = matches(model, OPENAI_MINIMAL_EFFORT) ? ["minimal", "low", "medium", "high"] : ["low", "medium", "high"];
   const requested = effort === "max" ? "high" : effort;
   return clampEffort(requested, allowed);
 };
+var compatibleReasoningBody = (provider, model, reasoning) => {
+  if (!reasoning)
+    return {};
+  const known = getModelReasoning(provider, model);
+  const effort = resolveEffort(reasoning);
+  if (!known || !effort)
+    return {};
+  if (!known.efforts.includes(effort))
+    throw new Error(`Unsupported reasoning effort ${effort} for ${provider}:${model}`);
+  if (provider === "alibaba")
+    return effort === "none" ? { enable_thinking: false } : {
+      enable_thinking: true,
+      thinking_budget: resolveBudgetTokens(reasoning)
+    };
+  if (provider === "deepseek")
+    return effort === "none" ? { thinking: { type: "disabled" } } : { thinking: { type: "enabled" }, reasoning_effort: effort };
+  return { reasoning_effort: effort };
+};
+var geminiThinkingConfig = (model, reasoning) => {
+  if (!reasoning)
+    return;
+  const profile2 = getModelReasoning("google", model);
+  const effort = resolveEffort(reasoning);
+  if (!profile2 || !effort)
+    return;
+  if (!profile2.efforts.includes(effort))
+    throw new Error(`Unsupported reasoning effort ${effort} for ${model}`);
+  if (profile2.kind === "effort")
+    return { thinkingLevel: effort };
+  const budgets = {
+    none: 0,
+    low: 1024,
+    medium: 8192,
+    high: 24576
+  };
+  return { thinkingBudget: reasoning.budgetTokens ?? budgets[effort] };
+};
 
 // src/ai/providers/openaiResponses.ts
 var h2IfHttps = (url) => url.startsWith("https://") ? { protocol: "http2" } : {};
@@ -1314,15 +1418,28 @@ var mapOpenAIContent = (msg) => {
   }
   const hasMedia = msg.content.some((block) => block.type === "image" || block.type === "document" || block.type === "audio" || block.type === "video");
   if (!hasMedia) {
-    return null;
+    return msg.content.filter((block) => block.type === "text").map((block) => block.content).join("") || null;
   }
   return msg.content.map(mapContentBlockToOpenAI).filter((mapped) => mapped !== null);
 };
-var buildRequestBody = (params, capabilityModel = params.model) => {
+var buildRequestBody = (params, capabilityModel = params.model, providerName = "openai") => {
   const messages = params.messages.flatMap((msg) => {
-    if (hasArrayContent(msg) && msg.content.some((block) => block.type === "tool_use" || block.type === "tool_result"))
-      return buildToolMessages(msg.content);
-    return [{ content: mapOpenAIContent(msg), role: msg.role }];
+    const mapped = hasArrayContent(msg) && msg.content.some((block) => block.type === "tool_use" || block.type === "tool_result") ? buildToolMessages(msg.content) : [{ content: mapOpenAIContent(msg), role: msg.role }];
+    if (hasArrayContent(msg) && msg.role === "assistant") {
+      const assistant = mapped.find((message) => message.role === "assistant");
+      if (assistant) {
+        assistant.content = mapOpenAIContent(msg);
+        const thinking = msg.content.filter((block) => block.type === "thinking").map((block) => block.thinking).join("");
+        if (thinking && ["deepseek", "moonshot", "alibaba"].includes(providerName))
+          assistant.reasoning_content = thinking;
+        if (thinking && providerName === "mistral")
+          assistant.content = [
+            { type: "thinking", thinking: [{ type: "text", text: thinking }] },
+            ...typeof assistant.content === "string" && assistant.content ? [{ type: "text", text: assistant.content }] : []
+          ];
+      }
+    }
+    return mapped;
   });
   if (params.systemPrompt) {
     messages.unshift({ content: params.systemPrompt, role: "system" });
@@ -1365,6 +1482,8 @@ var buildRequestBody = (params, capabilityModel = params.model) => {
     if (typeof params.maxTokens === "number")
       body.max_tokens = params.maxTokens;
   }
+  if (providerName !== "openai")
+    Object.assign(body, compatibleReasoningBody(providerName, params.model, params.reasoning));
   if (params.stopSequences && params.stopSequences.length > 0)
     body.stop = params.stopSequences;
   if (typeof params.seed === "number")
@@ -1468,6 +1587,21 @@ var processToolCallDeltas = (toolCalls, pendingToolCalls) => {
   }
 };
 var processDelta = function* (delta, pendingToolCalls) {
+  if (typeof delta.reasoning_content === "string")
+    yield { type: "thinking", content: delta.reasoning_content };
+  if (Array.isArray(delta.content)) {
+    for (const part of delta.content) {
+      if (!isRecord2(part))
+        continue;
+      if (part.type === "text" && typeof part.text === "string")
+        yield { type: "text", content: part.text };
+      if (part.type === "thinking" && Array.isArray(part.thinking)) {
+        for (const thought of part.thinking)
+          if (isRecord2(thought) && typeof thought.text === "string")
+            yield { type: "thinking", content: thought.text };
+      }
+    }
+  }
   if (typeof delta.content === "string") {
     yield { content: delta.content, type: "text" };
   }
@@ -1730,7 +1864,7 @@ var openai = (config2) => {
       body: (params) => buildResponsesRequestBody(params, false, config2.modelForCapabilities?.(params.model) ?? params.model)
     }),
     stream: (params) => {
-      const openaiBody = buildRequestBody(params, config2.modelForCapabilities?.(params.model) ?? params.model);
+      const openaiBody = buildRequestBody(params, config2.modelForCapabilities?.(params.model) ?? params.model, providerName);
       const body = config2.transformRequestBody ? config2.transformRequestBody(openaiBody, params) : openaiBody;
       return async function* () {
         const [apiKey, headers] = await Promise.all([
@@ -1748,7 +1882,7 @@ var alibaba = (config2) => openaiCompatible({
   apiKey: config2.apiKey,
   baseUrl: "https://dashscope-intl.aliyuncs.com/compatible-mode"
 });
-var deepseek = (config2) => openaiCompatible({
+var deepseek2 = (config2) => openaiCompatible({
   apiKey: config2.apiKey,
   baseUrl: "https://api.deepseek.com"
 });
@@ -1881,6 +2015,9 @@ var buildRequestBody2 = (params, isImageModel) => {
     contents: convertMessages(params.messages)
   };
   const generationConfig = {};
+  const thinkingConfig = geminiThinkingConfig(params.model, params.reasoning);
+  if (thinkingConfig)
+    generationConfig.thinkingConfig = thinkingConfig;
   if (isImageModel) {
     generationConfig.responseModalities = ["TEXT", "IMAGE"];
   }
@@ -2087,7 +2224,7 @@ var resolveImageModels2 = (raw) => {
   }
   return new Set(raw);
 };
-var gemini = (config2) => {
+var gemini2 = (config2) => {
   const baseUrl = config2.baseUrl ?? DEFAULT_BASE_URL3;
   const imageModels = resolveImageModels2(config2.imageModels);
   const requestCapacity = async (params, suffix, body) => capacityJson(await (config2.fetch ?? fetch)(`${baseUrl}/v1beta/models/${encodeURIComponent(params.model.replace(/^models\//, ""))}${suffix}`, {
@@ -2314,7 +2451,9 @@ var buildRequestBody3 = (params, configuredMax, configCaching) => {
   if (params.stopSequences && params.stopSequences.length > 0) {
     body.stop_sequences = params.stopSequences;
   }
-  const mode = params.reasoning ? anthropicReasoningMode(params.model) : "none";
+  const mode = params.reasoning && params.reasoning.effort !== "none" ? anthropicReasoningMode(params.model) : "none";
+  if (params.reasoning?.effort === "none")
+    body.thinking = { type: "disabled" };
   const thinkingActive = mode !== "none";
   if (!thinkingActive && anthropicSupportsSampling(params.model)) {
     if (typeof params.temperature === "number") {
@@ -8686,14 +8825,14 @@ export {
   createSyncConversationStore,
   createUiCards,
   credentialCard,
-  deepseek,
+  deepseek2 as deepseek,
   diffCard,
   estimateOpenRouterCost,
   estimateOpenRouterModelCost,
   exchangeOpenRouterAuthCode,
   fetchProviderApiStatus,
   formCard,
-  gemini,
+  gemini2 as gemini,
   generateAI,
   generateAIWithTools,
   generateId,
@@ -8749,5 +8888,5 @@ export {
   xai
 };
 
-//# debugId=165C398044F23C2764756E2164756E21
+//# debugId=C24827A491DCDA4A64756E2164756E21
 //# sourceMappingURL=index.js.map