@llmnative/react 1.46.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/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

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.46.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",