@optilogic/chat 1.0.0-beta.9 → 1.0.0

package/README.md

@@ -141,6 +141,42 @@ function ChatView() {
 }
 ```
 
+### AgentResponse with Status Content
+
+Display ephemeral status messages in the metadata row during agent processing:
+
+```tsx
+import { AgentResponse, TruncatedMessage } from '@optilogic/chat';
+
+function ChatView() {
+  const [statusMessage, setStatusMessage] = useState<string>();
+
+  // Parent controls when to show/clear status content
+  // e.g., set during processing, clear on completion
+
+  return (
+    <AgentResponse
+      state={state}
+      statusContent={
+        statusMessage
+          ? <TruncatedMessage message={statusMessage} />
+          : undefined
+      }
+    />
+  );
+}
+```
+
+### TruncatedMessage
+
+Standalone component that renders a single-line string with CSS-based truncation:
+
+```tsx
+import { TruncatedMessage } from '@optilogic/chat';
+
+<TruncatedMessage message="Searching the knowledge base for relevant documents..." />
+```
+
 ## Components
 
 ### AgentResponse
@@ -150,6 +186,7 @@ Main component for displaying AI agent responses with:
 - Tool call visualization
 - Copy and feedback actions
 - Metadata display (tokens, timing)
+- Ephemeral status content slot in metadata row
 - Optional collapsible HITL interaction history
 
 ### UserPrompt
@@ -174,6 +211,12 @@ Read-only display of a completed HITL Q&A interaction with:
 ### HITLSection
 Collapsible sub-component for rendering HITL interactions within AgentResponse. Follows the same expand/collapse pattern as ThinkingSection.
 
+### TruncatedMessage
+Standalone utility component for single-line text truncation with:
+- CSS-based ellipsis truncation
+- Native title tooltip for full text on hover
+- Designed for use in MetadataRow status slot or anywhere else
+
 ## Hooks
 
 ### useAgentResponseAccumulator