@object-ui/plugin-chatbot 5.4.2 → 6.0.0

package/CHANGELOG.md

@@ -1,5 +1,33 @@
 # @object-ui/plugin-chatbot
 
+## 6.0.0
+
+### Minor Changes
+
+- 451bbee: **HITL conversation loop:** `useHitlInChat` now accepts a
+  `continueConversation(prompt, ctx)` callback. After the operator approves
+  or rejects a tool call from inline chat buttons, the hook synthesises a
+  short follow-up user prompt (tagged `[HITL pa_xxx]`, with the executed
+  result or rejection reason) and invokes the callback so the LLM
+  continues the conversation with full awareness of the outcome.
+
+  `ConsoleFloatingChatbot` wires this callback to `useObjectChat`'s
+  `sendMessage`, closing the loop end-to-end. Execution failures stay
+  visible in the inline status badge but do NOT continue automatically —
+  the operator decides next steps.
+
+  No framework changes required. Internal `idMap` now also tracks the
+  tool name so the synthesised prompt is human-readable. New test suite
+  `useHitlInChat.test.tsx` covers approve/reject/failed/no-callback
+  branches.
+
+### Patch Changes
+
+- @object-ui/types@6.0.0
+- @object-ui/core@6.0.0
+- @object-ui/react@6.0.0
+- @object-ui/components@6.0.0
+
 ## 5.4.2
 
 ### Patch Changes

package/README.md

@@ -255,6 +255,49 @@ import { AIElements } from '@object-ui/plugin-chatbot';
 </AIElements.Conversation>;
 ```
 
+### Message mapping helpers
+
+If you wire `@ai-sdk/react`'s `useChat()` directly and want to render its
+`UIMessage[]` with `<ChatbotEnhanced>`, use the exported mappers instead
+of writing your own — they handle `parts: [{ type: 'text' | 'reasoning'
+| 'tool-*' | 'source-*' }]`, the streaming-cursor flag, and the legacy
+`msg.toolInvocations` fallback:
+
+```tsx
+import { useChat } from '@ai-sdk/react';
+import {
+  ChatbotEnhanced,
+  uiMessagesToChatMessages,
+} from '@object-ui/plugin-chatbot';
+
+function MyChat() {
+  const { messages, status } = useChat({ api: '/api/chat' });
+  const isStreaming = status === 'streaming' || status === 'submitted';
+  return (
+    <ChatbotEnhanced
+      messages={uiMessagesToChatMessages(messages, { isStreaming })}
+      onSend={/* … */}
+    />
+  );
+}
+```
+
+`uiMessageToChatMessage(msg, { streaming })` is the single-message
+variant. Both are also used internally by `useObjectChat`, so the
+mapping logic stays consistent across direct and managed usage.
+
+## Bundle considerations
+
+This package depends on `streamdown`, `shiki`, `mermaid`, and `katex`
+for code/markdown rendering. Together they weigh ~20 MB minified.
+
+In host apps that don't always show the chat panel (e.g. Studio's
+opt-in AI sidebar), import this package via `React.lazy` so the heavy
+chunks only download when the panel actually opens. See
+`apps/studio/src/routes/__root.tsx` for the reference pattern, and
+`apps/studio/vite.config.ts` for the `manualChunks` rules that keep
+the chat-only deps in dedicated, lazy-loadable chunks.
+
 ## License
 
 MIT © ObjectStack Inc.