@llmnative/react 1.45.0 → 1.46.0

package/dist/types/src/index.d.ts

@@ -80,7 +80,7 @@ export { loadGoogleMaps } from './providers/googleMaps/loadGoogleMaps';
 export type { GoogleMapsConfig } from './providers/googleMaps/loadGoogleMaps';
 export { useEmailProvider, EmailProvider } from './providers/email/EmailProviderContext';
 export { GmailEmailProvider } from './providers/email/google/GmailEmailProvider';
-export type { AIRequestOptions, AIAttachment, AIProviderAdapter, AIKeyValidationResult, AIModelDescriptor, AIModelPricing, DiscoveredAIModel, AIProviderCapabilities, AIModelCatalog, AIProviderDefinition, AICompleteRequest, AICompleteResult, AIConversationTurn, AIToolDefinition, AIToolCall, AIToolResult, CloudflareProviderOptions, ServerAIProviderConnection, ServerAIConnection, ModelIdentity, ModelIdentityEntry, ModelIdentityIndex, ResolvedModel, ModelOffer, ModelCost, } from './providers/ai';
+export type { AIRequestOptions, AIReasoningLevel, AIAttachment, AIProviderAdapter, AIKeyValidationResult, AIModelDescriptor, AIModelPricing, DiscoveredAIModel, AIProviderCapabilities, AIModelCatalog, AIProviderDefinition, AICompleteRequest, AICompleteResult, AIConversationTurn, AIToolDefinition, AIToolCall, AIToolResult, CloudflareProviderOptions, ServerAIProviderConnection, ServerAIConnection, ModelIdentity, ModelIdentityEntry, ModelIdentityIndex, ResolvedModel, ModelOffer, ModelCost, } from './providers/ai';
 export { createAIProviderRegistry, getAIModelCatalog, formatAIModelRef, parseAIModelRef, isFreeAIModel, AI_PROVIDER_DEFINITIONS, AI_PROVIDER_DESCRIPTORS, OPENAI_COMPATIBLE_PROVIDER_DESCRIPTOR, CLOUDFLARE_PROVIDER_DESCRIPTOR, createCloudflareProviderDefinition, toProviderDescriptor, createServerCredentialAIRegistry, serverCredential, SERVER_CREDENTIAL_PREFIX, AI_PROVIDER_HOSTS, isAIProviderTarget, canonicalModelName, buildModelIdentityIndex, resolveModel, modelOffers, loadModelIdentityIndex } from './providers/ai';
 export type { ProviderDescriptor, ProviderCredentialField } from './providers/ProviderDescriptor';
 export { useAIProvider, useAIProviderRegistry, AIProvider } from './providers/ai/AIProviderContext';

package/dist/types/src/providers/ai/AIProvider.d.ts

@@ -32,6 +32,8 @@ export interface AIAttachment {
     base64: string;
     name?: string;
 }
+/** How much a model reasons before it answers (CR-122). */
+export type AIReasoningLevel = 'low' | 'medium' | 'high' | 'max';
 export interface AIRequestOptions {
     language?: string;
     voice?: string;
@@ -40,6 +42,12 @@ export interface AIRequestOptions {
     model?: string;
     temperature?: number;
     attachments?: AIAttachment[];
+    /**
+     * How much the model reasons (CR-122), on the models that take it: Anthropic `output_config.effort`
+     * (Claude 4.6 and later), OpenAI `reasoning_effort` (o-series, GPT-5; `max` as `high`), OpenRouter
+     * `reasoning.effort`. Elsewhere (older models, Gemini) nothing is sent. Absent: the default of the model.
+     */
+    reasoning?: AIReasoningLevel;
 }
 /** Definizione di un tool che il modello può scegliere di invocare — la SDK del provider
  * riceve solo questa forma (JSON-serializzabile); l'implementazione vera resta lato

package/dist/types/src/providers/ai/anthropic.d.ts

@@ -1,2 +1,2 @@
-import type { AIProviderDefinition } from './shared';
+import { type AIProviderDefinition } from './shared';
 export declare const ANTHROPIC_PROVIDER_DEFINITION: AIProviderDefinition;

package/dist/types/src/providers/ai/index.d.ts

@@ -2,7 +2,7 @@ import type { AIConfig } from '../../Config';
 import type { ProviderDescriptor } from '../ProviderDescriptor';
 import type { AIProviderAdapter } from './AIProvider';
 import { type AIProviderDefinition, type BuiltInAIProviderId } from './shared';
-export type { AIProviderAdapter, AIKeyValidationResult, AIModelDescriptor, AIModelPricing, AIProviderCapabilities, AIRequestOptions, AIAttachment, AICompleteRequest, AICompleteResult, AIConversationTurn, AIToolDefinition, AIToolCall, AIToolResult, } from './AIProvider';
+export type { AIProviderAdapter, AIKeyValidationResult, AIModelDescriptor, AIModelPricing, AIProviderCapabilities, AIRequestOptions, AIReasoningLevel, AIAttachment, AICompleteRequest, AICompleteResult, AIConversationTurn, AIToolDefinition, AIToolCall, AIToolResult, } from './AIProvider';
 export { formatAIModelRef, parseAIModelRef, isFreeAIModel } from './AIProvider';
 export type { DiscoveredAIModel } from './shared';
 export type { AIModelCatalog, AIProviderDefinition } from './shared';

package/dist/types/src/providers/ai/openaiCompatible.d.ts

@@ -17,6 +17,8 @@ type OpenAICompatibleDefinitionOptions = {
     validateApiKey?: AIProviderDefinition['validateApiKey'];
     /** Maps one `/models` entry — for providers whose listing also reports prices (OpenRouter). */
     mapModelEntry?: (entry: Record<string, unknown>) => string | DiscoveredAIModel | undefined;
+    /** How a reasoning level is sent (CR-122): `reasoning_effort` on the reasoning models of OpenAI, or OpenRouter's `reasoning.effort`. */
+    reasoningStyle?: 'openai' | 'openrouter';
 };
 /** Esportate per riuso da provider "chat completions"-simili ma non costruiti tramite
  * createOpenAICompatibleProviderDefinition (vedi opencode.ts) — stesso wire format OpenAI,
@@ -39,5 +41,5 @@ export declare function parseOpenAIResponse(response: {
         message?: Record<string, unknown>;
     }>;
 } | null): AICompleteResult | null;
-export declare const createOpenAICompatibleProviderDefinition: ({ id, label, description, configKey, requiredConfigKeys, defaultModel, fallbackModels, baseUrl, modelsUrl, chatCompletionsUrl, dashboardUrl, credentialsHint, validateApiKey: validateApiKeyOverride, mapModelEntry, }: OpenAICompatibleDefinitionOptions) => AIProviderDefinition;
+export declare const createOpenAICompatibleProviderDefinition: ({ id, label, description, configKey, requiredConfigKeys, defaultModel, fallbackModels, baseUrl, modelsUrl, chatCompletionsUrl, dashboardUrl, credentialsHint, validateApiKey: validateApiKeyOverride, mapModelEntry, reasoningStyle, }: OpenAICompatibleDefinitionOptions) => AIProviderDefinition;
 export {};

package/dist/types/src/providers/ai/shared.d.ts

@@ -1,6 +1,6 @@
 import { type ProviderConfigurationState } from '../ProviderConfiguration';
 import type { ProviderCredentialField } from '../ProviderDescriptor';
-import type { AICompleteRequest, AICompleteResult, AIKeyValidationResult, AIModelDescriptor, AIModelPricing, AIProviderAdapter, AIProviderCapabilities, AIRequestOptions } from './AIProvider';
+import type { AICompleteRequest, AICompleteResult, AIKeyValidationResult, AIModelDescriptor, AIModelPricing, AIProviderAdapter, AIProviderCapabilities, AIReasoningLevel, AIRequestOptions } from './AIProvider';
 export type BuiltInAIProviderId = 'openai' | 'openrouter' | 'opencode' | 'opencode-go' | 'openai-compatible' | 'deepseek' | 'gemini' | 'anthropic' | 'mistral' | 'glm' | 'cloudflare' | 'groq';
 /** A discovered model carrying the price its provider listing already reports (OpenRouter,
  * Cloudflare). Models discovered as a bare id get their price from models.dev instead. */
@@ -41,6 +41,14 @@ export type AIModelCatalog = {
     modelsByProvider: Record<string, AIModelDescriptor[]>;
     capabilitiesByProvider: Record<string, AIProviderCapabilities>;
 };
+/** What an Anthropic Messages request carries for a reasoning level (CR-122); nothing for a model that does not take it. */
+export declare function anthropicReasoning(model: string | undefined, level: AIReasoningLevel | undefined): Record<string, unknown>;
+/**
+ * What an OpenAI Chat Completions request carries for a reasoning level (CR-122): `reasoning_effort` on the
+ * reasoning models of OpenAI (`max` as `high`, their top); OpenRouter `reasoning.effort` on any model, which
+ * it maps itself. Nothing otherwise.
+ */
+export declare function openAIReasoning(model: string | undefined, level: AIReasoningLevel | undefined, style?: 'openai' | 'openrouter'): Record<string, unknown>;
 export declare const extractProviderError: (err: unknown) => string;
 export declare const createBrowserTransportError: (label: string) => Error;
 export declare const parseTextResponse: (value: unknown) => string | null;

package/llms-full.txt

@@ -1165,6 +1165,13 @@ class MyAIProvider implements AIProviderAdapter {
   async array(prompt: string, options?: AIRequestOptions): Promise<string[]> { ... }
 }
 
+// Quanto ragiona il modello (CR-122): `reasoning: 'low' | 'medium' | 'high' | 'max'` (AIReasoningLevel) su
+// una richiesta. Anthropic: `output_config.effort` sui Claude 4.6 e successivi (+ thinking adaptive su Opus
+// 4.6-4.8 e Sonnet 4.6); OpenAI e compatibili (OpenCode, DeepSeek, Groq…): `reasoning_effort` solo sui modelli
+// di ragionamento di OpenAI (serie o, GPT-5; max = high); OpenRouter: `reasoning.effort` su ogni modello.
+// Altrove (modelli più vecchi, Gemini) non si manda nulla: il default del modello.
+await ai.complete({ prompt: 'Rivedi questo piano', model: 'claude-opus-5-5', reasoning: 'high' })
+
 // Factory per registri esterni
 const registry = createAIProviderRegistry(definitions)
 // Azioni di Chatbot (CR-107): con `content` aprono un menu; senza, sono pulsanti con `onClick`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@llmnative/react",
-  "version": "1.45.0",
+  "version": "1.46.0",
   "description": "LLM-native React framework for deterministic UI generation. Data-driven by default, schema-driven optional. Ultra-low token consumption — built for AI agents, not just humans.",
   "main": "dist/index.js",
   "module": "dist/index.mjs",