@object-ui/plugin-chatbot 5.3.1 → 5.4.0

package/CHANGELOG.md

@@ -1,5 +1,76 @@
 # @object-ui/plugin-chatbot
 
+## 5.4.0
+
+### Minor Changes
+
+- 3a8c754: Rebuilt the chatbot UI on top of **Vercel AI Elements** (MIT) and wired in
+  the v1 capabilities exposed by `@objectstack/service-ai` (tracing,
+  `generateObject`, `query_data` tool, `ModelRegistry`).
+  - **What's new**
+    - `ChatbotEnhanced` is now composed from `Conversation`, `Message`,
+      `PromptInput`, `Suggestion`, `Tool`, `Reasoning`, `Sources`, and friends.
+      Sticky-to-bottom scrolling, keyboard-aware textarea, file pill chips,
+      copy/retry actions, and the streaming/error banners now match the
+      shadcn-style AI surface used across the ecosystem.
+    - **Tool / reasoning / sources rendering**: assistant messages with
+      `toolInvocations`, `reasoning`, or `sources` automatically render the
+      collapsible tool panels, the chain-of-thought block, and the citation
+      pill. `useObjectChat` parses these directly from `vercel/ai`'s
+      `UIMessage.parts` stream — no extra wiring needed at the call site.
+    - **Model picker**: optional `models` + `selectedModelId` + `onModelChange`
+      props render an inline `<select>` in the prompt-input toolbar. Designed
+      to be fed straight from `GET /api/v1/ai/models` (new in service-ai
+      v1).
+    - **Trace links**: new optional `traceId` on `ChatMessage` surfaces a
+      small "trace" link on assistant messages — pair with the `ai_traces`
+      object exposed by service-ai's auto-tracing.
+    - New optional `suggestions?: string[]` prop renders a chip row in the
+      empty state and forwards the picked suggestion to `onSendMessage`.
+    - All vendored AI Elements (10 components) plus two missing shadcn
+      primitives (`button-group`, `input-group`) are exported as a namespace —
+      `import { AIElements } from '@object-ui/plugin-chatbot'` — so apps can
+      compose bespoke chat surfaces without dropping back to the legacy
+      primitives.
+  - **Type-level changes**
+    - `@object-ui/types` `ChatMessage` gains optional `reasoning`, `sources`,
+      `traceId` fields, and a new `ChatMessageSource` interface.
+    - `ChatToolInvocation` accepts the AI SDK v6 lifecycle states
+      (`input-streaming`/`input-available`/`output-available`/`output-error`/
+      …) in addition to the legacy `partial-call`/`call`/`result`. `args`
+      is now optional and accepts arbitrary shapes; new optional `errorText`
+      field.
+  - **What hasn't changed**
+    - Public prop signature on `FloatingChatbot`, `FloatingChatbotPanel`, and
+      the SDUI `"chatbot"` renderer.
+    - Hook contracts: `useObjectChat`, `useAgents`,
+      `useFloatingChatbot`.
+    - SSR / Tailwind 4 / React 18+19 support.
+  - **Under the hood**
+    - New deps: `streamdown`, `use-stick-to-bottom`, `shiki`, `motion`,
+      `nanoid`, `@radix-ui/react-use-controllable-state`,
+      `@radix-ui/react-slot`, `class-variance-authority`.
+    - Vendored sources live under `src/elements/` with header comments pointing
+      back to `registry.ai-sdk.dev`. Rule #7 No-Touch Zones are respected —
+      `packages/components/src/ui/**` was not modified.
+
+### Patch Changes
+
+- Updated dependencies [3a8c754]
+  - @object-ui/types@5.4.0
+  - @object-ui/components@5.4.0
+  - @object-ui/core@5.4.0
+  - @object-ui/react@5.4.0
+
+## 5.3.2
+
+### Patch Changes
+
+- @object-ui/types@5.3.2
+- @object-ui/core@5.3.2
+- @object-ui/react@5.3.2
+- @object-ui/components@5.3.2
+
 ## 5.3.1
 
 ### Patch Changes

package/README.md

@@ -1,6 +1,15 @@
 # @object-ui/plugin-chatbot
 
-Chatbot interface plugin for Object UI with full AI SDUI support.
+Chatbot interface plugin for Object UI with full AI SDUI support, built on
+[Vercel AI Elements](https://elements.ai-sdk.dev) (MIT) and
+[shadcn/ui](https://ui.shadcn.com) (MIT).
+
+> Why AI Elements? They give us a production-grade, shadcn-style chat
+> surface — conversation, message bubbles, streaming reasoning, tool calls,
+> sources, code blocks, suggestions — that already matches our Tailwind 4
+> design tokens. We vendor them into `src/elements/` so we can ship without a
+> network dep, and we wrap them inside `ChatbotEnhanced` to keep the public
+> ObjectUI prop API stable. See [Architecture](#architecture) below.
 
 ## Installation
 
@@ -210,6 +219,46 @@ const aiSchema = {
 - 🤝 [Contributing Guide](https://github.com/objectstack-ai/objectui/blob/main/CONTRIBUTING.md)
 - 🗺️ [Roadmap](https://github.com/objectstack-ai/objectui/blob/main/ROADMAP.md)
 
+## Architecture
+
+Internally the chatbot is composed from three layers:
+
+```
+┌─────────────────────────────────────────────────────┐
+│  ChatbotEnhanced (public surface, stable props)     │
+│  ├─ Conversation / Message  (AI Elements)           │
+│  ├─ PromptInput  (AI Elements)                      │
+│  └─ Suggestion / Reasoning / Tool  (AI Elements)    │
+├─────────────────────────────────────────────────────┤
+│  src/elements/                                      │
+│  Vendored Vercel AI Elements + missing shadcn       │
+│  primitives (button-group, input-group). Rewritten  │
+│  to import from `@object-ui/components`. Do NOT     │
+│  edit — re-sync from registry.ai-sdk.dev.           │
+├─────────────────────────────────────────────────────┤
+│  @object-ui/components (shadcn + Tailwind 4)        │
+└─────────────────────────────────────────────────────┘
+```
+
+The vendored components are also re-exported under a namespace for advanced
+users who want to compose their own chat surface:
+
+```tsx
+import { AIElements } from '@object-ui/plugin-chatbot';
+
+<AIElements.Conversation>
+  <AIElements.ConversationContent>
+    <AIElements.Message from="assistant">
+      <AIElements.MessageContent>Hello.</AIElements.MessageContent>
+    </AIElements.Message>
+  </AIElements.ConversationContent>
+</AIElements.Conversation>;
+```
+
 ## License
 
 MIT © ObjectStack Inc.
+
+Third-party code shipped under `src/elements/`:
+- **Vercel AI Elements** — MIT © Vercel, Inc.
+- **shadcn/ui** primitives (`button-group`, `input-group`) — MIT © shadcn.