@llmnative/react 1.45.0 → 1.47.0

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

@@ -355,6 +355,16 @@ export interface I18nDict {
         submit: string;
         noAnswer: string;
         answered: string;
+        /** CR-123 — ChatActivity: the work of an agent (`{count}` in activityCount, activityFailed, activityFiles). */
+        activityCount: string;
+        activityFailed: string;
+        activityCommands: string;
+        activityHide: string;
+        activityLog: string;
+        activitySteps: string;
+        activityFiles: string;
+        activityChanges: string;
+        activityEmpty: string;
     };
     /** CR-112 — the charts: empty state, totals, the scale of the heatmaps, the data table. */
     charts: {

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

@@ -83,6 +83,8 @@ export { default as ChatReasoning } from './widgets/chat/ChatReasoning';
 export type { ChatReasoningProps, ChatReasoningClassNames } from './widgets/chat/ChatReasoning';
 export { default as ChatQuestions } from './widgets/chat/ChatQuestions';
 export type { ChatQuestion, ChatQuestionOption, ChatQuestionAnswer, ChatQuestionsNumbering, ChatQuestionsProps, ChatQuestionsClassNames } from './widgets/chat/ChatQuestions';
+export { default as ChatActivity } from './widgets/chat/ChatActivity';
+export type { ChatActivityItem, ChatActivitySteps, ChatActivityProps, ChatActivityClassNames } from './widgets/chat/ChatActivity';
 export { repairStreamingMarkdown } from '../libs/streamingMarkdown';
 export { default as TabDynamic } from './widgets/TabDynamic';
 export { default as Component } from './Component';

package/dist/types/src/components/widgets/chat/ChatActivity.d.ts

@@ -0,0 +1,51 @@
+import React from 'react';
+/** One group of steps of an agent: what it did, how many times, what it touched; the lines under it on request. */
+export interface ChatActivitySteps {
+    type: 'steps';
+    /** Icon name of the icon provider. Default `terminal`. */
+    icon?: string;
+    /** What the agent did, in a few words ("Reads files", "Runs the tests"). */
+    label: string;
+    /** How many steps the group has: shown from 2 on. */
+    count?: number;
+    /** Short details next to the label: the queries, the files, the commands. The first four, the rest on hover. */
+    detail?: readonly string[];
+    /** How many steps of the group failed: a warning badge. */
+    failed?: number;
+    /** The lines under the group (its commands, their errors), shown in a block opened by its button. */
+    lines?: readonly string[];
+}
+/** An item of the work of an agent: a group of steps, its own words (Markdown), or how it ended. */
+export type ChatActivityItem = ChatActivitySteps | {
+    type: 'text';
+    text: string;
+} | {
+    type: 'end';
+    ok: boolean;
+    text: string;
+};
+/** Classes for the parts of a `ChatActivity`, added to the defaults. */
+export interface ChatActivityClassNames {
+    root?: string;
+    step?: string;
+    text?: string;
+    files?: string;
+    log?: string;
+}
+export interface ChatActivityProps {
+    items: readonly ChatActivityItem[];
+    /** The files the agent changed: listed at the end. */
+    files?: readonly string[];
+    /** Opens the changes of the files (a diff, a page of the repository): its button next to the list. */
+    onShowChanges?: () => void;
+    /** The whole raw log: with it, a switch to read it and back. */
+    log?: readonly string[];
+    className?: string;
+    classNames?: ChatActivityClassNames;
+}
+/**
+ * CR-123 — The work of an agent in a chat, as AI assistants show it: what it did, grouped (an icon, a label, how many
+ * steps, the queries or the files), its commands on request, its own words in between, how it ended, the files it
+ * changed with their changes on request; the whole raw log one click away. The consumer maps its own log to the items.
+ */
+export default function ChatActivity({ items, files, onShowChanges, log, className, classNames }: ChatActivityProps): React.JSX.Element;

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

@@ -1078,7 +1078,7 @@ moveItem(['a', 'b', 'c'], 0, 2)   // ['b', 'c', 'a']
 />
 ```
 
-### Messaggi di chat: ChatMarkdown, ChatReasoning, ChatQuestions (CR-109)
+### Messaggi di chat: ChatMarkdown, ChatReasoning, ChatQuestions (CR-109), ChatActivity (CR-123)
 
 Parti di un messaggio di un modello, da comporre nel proprio thread (anche accanto a `Chatbot`).
 
@@ -1122,6 +1122,20 @@ Parti di un messaggio di un modello, da comporre nel proprio thread (anche accan
 // Scelta singola: il click sceglie e passa alla domanda dopo. onSubmit che rifiuta lascia il form.
 // answers={[…]} mostra un insieme già risposto (sola lettura); disabled, autoFocus, submitLabel,
 // classNames={{ root, tabs, tab, panel, question, option, optionSelected, footer, summary }}
+
+// Il lavoro di un agente (CR-123), come negli assistenti AI: gruppi di passi (icona, label, quanti,
+// dettagli brevi: query, file, comandi; quanti falliti) con le righe sotto aperte da "Comandi";
+// le parole dell'agente in Markdown; come è finito; i file cambiati con "Vedi le modifiche";
+// il registro grezzo a un clic. Il consumer traduce il suo log negli item.
+<ChatActivity
+  items={[
+    { type: 'steps', icon: 'search', label: 'Esplora il repository', count: 3, detail: ['git status'], lines: ['git status --short'] },
+    { type: 'text', text: 'Aggiungo il comando e il suo test.' },
+    { type: 'end', ok: true, text: 'success · 9 steps' },
+  ]}
+  files={['functions/src/catalog/index.js']} onShowChanges={() => openDiff()} log={rawLines}
+/>
+// className, classNames={{ root, step, text, files, log }}
 ```
 
 ### ImageEditor
@@ -1165,6 +1179,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/llms.txt

@@ -66,7 +66,7 @@ import '@llmnative/react/dist/index.css'  // necessario una volta sola
 ui/        → primitivi stateless: Alert, Badge, Button, Card, DescriptionList, Image, Modal, Table, Gallery, Tab, Repeat, Icon, LocaleSwitcher, ThemeSwitcher, ProviderSwitcher, LayoutBuilder, ContextMenu
 ui/fields/ → campi form: Input, Select, UploadImage, UploadDocument, UploadCSV, CodeEditor, ImageField, RichText, Prompt, Crop, ContextMenu
 blocks/    → composizioni: Menu, Breadcrumbs, Notifications, Search, Carousel, Dropdown, Toolbar, SideNav, ListCard, AuthButton
-widgets/   → smart (hanno stato e provider): Grid, Form, MarkdownReader, ImageEditor, TabDynamic, Chatbot, ChatMarkdown, ChatReasoning, ChatQuestions
+widgets/   → smart (hanno stato e provider): Grid, Form, MarkdownReader, ImageEditor, TabDynamic, Chatbot, ChatMarkdown, ChatReasoning, ChatQuestions, ChatActivity
 ```
 
 Tutti gli import da `'@llmnative/react'` — mai da sottodirectory.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@llmnative/react",
-  "version": "1.45.0",
+  "version": "1.47.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",