@absolutejs/ai 0.2.3 → 0.2.4

package/dist/src/ai/models/index.d.ts

@@ -29,3 +29,4 @@ export type ModelCapability = keyof typeof MODEL_CAPABILITY_DESCRIPTIONS;
 /** Derive badges from explicit evidence; do not infer support from model names. */
 export declare const modelCapabilities: (metadata?: ModelMetadata) => ModelCapability[];
 export { MODEL_METADATA, getModelMetadata } from "./catalog";
+export { MODEL_REASONING, REASONING_EFFORTS, getModelReasoning, isReasoningSelection, supportsReasoningSelection, reasoningSelectionLabel, type ModelReasoning, type ReasoningSelection, } from "./reasoning";

package/dist/src/ai/models/reasoning.d.ts

@@ -0,0 +1,15 @@
+import type { ReasoningEffort } from "../../../types/ai";
+export declare const REASONING_EFFORTS: readonly ["none", "minimal", "low", "medium", "high", "xhigh", "max"];
+export type ReasoningSelection = "auto" | ReasoningEffort;
+export type ModelReasoning = {
+    kind: "effort" | "budget" | "fixed";
+    efforts: readonly ReasoningEffort[];
+    description: string;
+    source: string;
+};
+export declare const isReasoningSelection: (value: unknown) => value is ReasoningSelection;
+/** Exact reviewed IDs; unknown models expose only the provider default. Reviewed 2026-09-20. */
+export declare const MODEL_REASONING: Readonly<Record<string, ModelReasoning>>;
+export declare const getModelReasoning: (provider: string, model: string) => ModelReasoning | undefined;
+export declare const supportsReasoningSelection: (provider: string, model: string, selection: ReasoningSelection) => boolean;
+export declare const reasoningSelectionLabel: (selection: ReasoningSelection, provider?: string) => string;

package/dist/src/ai/providers/reasoning.d.ts

@@ -12,3 +12,6 @@ export declare const resolveBudgetTokens: (reasoning: ReasoningConfig) => number
 export declare const anthropicEffortValue: (model: string, reasoning: ReasoningConfig) => ReasoningEffort | null;
 /** OpenAI `reasoning.effort` value for a reasoning model, or null. */
 export declare const openaiEffortValue: (model: string, reasoning: ReasoningConfig) => ReasoningEffort | null;
+/** Provider-specific Chat Completions controls. Never send a guessed parameter. */
+export declare const compatibleReasoningBody: (provider: string, model: string, reasoning?: ReasoningConfig) => Record<string, unknown>;
+export declare const geminiThinkingConfig: (model: string, reasoning?: ReasoningConfig) => Record<string, unknown> | undefined;

package/dist/types/ai.d.ts

@@ -191,7 +191,7 @@ export type AIProviderResponseFormat = {
  * ignore it. `"minimal"` is clamped up to the nearest supported level where a
  * provider lacks it.
  */
-export type ReasoningEffort = "minimal" | "low" | "medium" | "high" | "max";
+export type ReasoningEffort = "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max";
 /**
  * Provider-agnostic reasoning request. Set `effort` (the portable primitive) and
  * the active provider translates it to the right wire shape for the named model.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@absolutejs/ai",
-  "version": "0.2.3",
+  "version": "0.2.4",
   "homepage": "https://github.com/absolutejs/ai",
   "bugs": {
     "url": "https://github.com/absolutejs/ai/issues"