@object-ui/plugin-chatbot 6.2.3 → 7.0.0

package/CHANGELOG.md

@@ -1,5 +1,99 @@
 # @object-ui/plugin-chatbot
 
+## 7.0.0
+
+### Minor Changes
+
+- 81c0777: feat(studio): ADR-0033 Phase B — draft review surface (chat → designer → generic diff)
+
+  Closes the AI metadata-authoring loop in Studio. The framework (ADR-0033 Phases A + C) makes the assistant stage every change as a DRAFT; this lets a human see and review those drafts.
+
+  **`@object-ui/plugin-chatbot`**
+
+  - `mapMessages` now detects the framework's draft envelopes — `{ status:'drafted', type, name, … }` (single) and `{ status:'drafted', drafted:[{type,name}] }` (apply_blueprint batch) — and lifts the reviewable targets onto `ChatToolInvocation.draftReview` (mirrors the existing HITL `pendingActionId` path; the Vercel `{type:'text',value}` wrapper is peeled). `blueprint_proposed` is intentionally not surfaced (no draft yet).
+  - `ChatbotEnhanced` renders a **"Review N change(s)"** button on drafted tool results, driven by a new `onReviewDraft` callback prop.
+
+  **`@object-ui/app-shell`**
+
+  - `assistantBus` gains a review channel (`requestReview` / `requestAssistantReview`); `ConsoleFloatingChatbot` wires the chat button to it; a small navigator inside `AppContent` (which knows the app base) routes to `/apps/:appName/metadata/:type/:name?review=1`.
+  - `ResourceEditPage` honours `?review=1`: it force-reloads the pending draft (covers the case where the AI drafted the item after the page mounted) and opens the review/diff.
+  - New **`DraftReviewPanel`** — a generic, type-agnostic draft↔published structural diff (added / changed / removed by key), reusing `LayeredDiff`'s `computeDiffRows`. It gives **every** metadata type (view, dashboard, flow, …) a real "what will publishing change" review, surfaced as a toolbar affordance + sheet whenever a draft exists. The object designer keeps its richer per-field review.
+
+  Nothing is published by any of this — the human still clicks Publish.
+
+- 9049bbe: Add end-user friendly agent process summaries for chatbot tool calls, with a debug mode for raw reasoning and tool details. Console chat surfaces now keep a sanitized browser-side display cache so refreshes can restore user/assistant text plus grouped tool states when the backend returns no message rows.
+- 053c948: feat(plugin-chatbot): render AI data-query charts inline (`data-chart`)
+
+  Companion to the framework `visualize_data` tool: the data-query assistant can
+  now answer with a CHART rendered right in the assistant bubble.
+
+  - `mapMessages.ts` — `extractCharts()` lifts every `data-chart` custom stream
+    part onto `ChatMessage.charts` (defensive narrowing; preserves multiple charts
+    in order), mirroring the existing `data-build-progress` → `buildProgress` path.
+  - `ChatbotEnhanced.tsx` — renders each chart via `<SchemaRenderer schema={{
+type:'chart', … }}/>` (decoupled — no hard dep on `plugin-charts`), giving the
+    chart a definite `width: min(520px, 80vw)` so recharts' `ResponsiveContainer`
+    measures a stable non-zero width inside the `w-fit` bubble (otherwise the
+    circular width dependency leaves bars unpainted).
+
+- 053c948: feat(plugin-chatbot): honest liveness indicator on running AI turns
+
+  AI app builds run 1–3 min with long quiet gaps (LLM thinking, sample-data
+  generation) where a static spinner is indistinguishable from a dropped
+  connection. The chat now shows a Claude-Code-style liveness indicator driven by
+  REAL observed stream activity, not a free-running clock:
+
+  - `useTurnLiveness(active, activityKey)` stamps the moment real data arrives (a
+    streamed token / tool delta / `data-build-progress` update) and measures
+    seconds-since-last-byte.
+  - `LivenessIndicator` renders three honest states — _receiving_ (emerald pulse +
+    m:ss, bytes arrived recently), _waiting_ (request in flight, nothing back yet),
+    and _stalled_ (amber + "no response for Ns", genuinely silent past 6s).
+  - The build panel prefers the server's monotonic `seq` keep-alive heartbeat as
+    its activity key (falling back to the content signature on older runtimes), so
+    a long quiet seed-generation window reads as honestly _receiving_ rather than
+    flipping to amber.
+
+### Patch Changes
+
+- 40c79df: Improve the floating chatbot flow with responsive panel bounds, safer FAB placement, inline responding and stop states, and clearer retryable error feedback.
+- Updated dependencies [5976ba3]
+- Updated dependencies [a00e16d]
+- Updated dependencies [eaccefd]
+- Updated dependencies [f7f325d]
+- Updated dependencies [c12986e]
+- Updated dependencies [71d7ce0]
+- Updated dependencies [053c948]
+- Updated dependencies [ddbe4a2]
+- Updated dependencies [2d47e94]
+- Updated dependencies [9049bbe]
+- Updated dependencies [6c0c92c]
+- Updated dependencies [cb2fdb1]
+- Updated dependencies [c3749eb]
+- Updated dependencies [6cfa330]
+- Updated dependencies [ad8ade6]
+- Updated dependencies [d54346c]
+- Updated dependencies [3870c20]
+- Updated dependencies [2eb3096]
+- Updated dependencies [b88c560]
+- Updated dependencies [d16566f]
+- Updated dependencies [90acb7f]
+- Updated dependencies [7913390]
+- Updated dependencies [1394e34]
+- Updated dependencies [e95cc25]
+- Updated dependencies [abe8ebc]
+- Updated dependencies [300d755]
+- Updated dependencies [bd8b054]
+- Updated dependencies [4eb9cb6]
+- Updated dependencies [7c239fd]
+- Updated dependencies [858ad94]
+- Updated dependencies [2270239]
+- Updated dependencies [8d1195d]
+  - @object-ui/core@7.0.0
+  - @object-ui/components@7.0.0
+  - @object-ui/react@7.0.0
+  - @object-ui/types@7.0.0
+
 ## 6.2.3
 
 ### Patch Changes

package/README.md

@@ -161,6 +161,18 @@ VITE_AI_DEFAULT_AGENT=sales_copilot
 The picker lets the user switch agents at runtime; switching transparently
 remounts the chat hook against the new agent's `/chat` endpoint.
 
+The floating panel is responsive by default. On desktop it uses the configured
+`panelWidth` / `panelHeight`; on narrow browser viewports it expands between
+safe side gutters, stays above the mobile bottom navigation area, and hides the
+FAB while open so the close button in the panel header is the only active
+dismiss control.
+
+During a conversation, the chat surface renders an inline assistant responding
+indicator while the backend is streaming, keeps message actions quiet until
+hover/focus, and summarizes backend failures into a compact retryable notice
+with optional technical details. The prompt submit control also becomes a
+dedicated stop button while a response is in progress.
+
 This plugin automatically registers with ObjectUI's component registry when imported:
 
 ```tsx
@@ -286,17 +298,61 @@ function MyChat() {
 variant. Both are also used internally by `useObjectChat`, so the
 mapping logic stays consistent across direct and managed usage.
 
+### Surface chrome
+
+`ChatbotEnhanced` defaults to `surface="card"`, which keeps the bordered panel
+chrome suitable for dashboards, sidebars, and floating chat windows. Full-page
+chat routes can use `surface="plain"` to remove the outer panel border and let
+messages, controls, and the prompt input sit in a continuous workspace:
+
+```tsx
+<ChatbotEnhanced
+  messages={messages}
+  surface="plain"
+  hideClearBar
+/>
+```
+
+### Agent process visibility
+
+`ChatbotEnhanced` defaults to an end-user friendly agent process view. Tool
+calls are grouped into a compact activity summary, repeated calls collapse into
+one row, raw tool names are hidden, and reasoning text is not rendered. This
+keeps the final answer as the primary reading target while still showing that
+the assistant is doing work.
+
+Use `processVisibility="debug"` for developer or admin trace surfaces that need
+the full reasoning panel, raw tool names, tool parameters, and tool results:
+
+```tsx
+<ChatbotEnhanced
+  messages={messages}
+  processVisibility="debug"
+/>
+```
+
+Use `processVisibility="hidden"` when a host wants to suppress non-interactive
+agent activity entirely. Human-in-the-loop approvals and draft review actions
+remain visible so users can still complete required decisions.
+
+Console hosts also keep a sanitized browser-side display cache for the active
+conversation. If the backend conversation record is available but returns no
+message rows on refresh, the UI can restore user/assistant text plus grouped
+tool names and states. The cache intentionally omits reasoning, tool
+parameters, and raw tool results.
+
 ## 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
+In host apps that don't always show the chat panel (e.g. Console'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.
+`packages/app-shell/src/layout/ConsoleFloatingChatbot.tsx` for the
+reference lazy-load pattern, and `apps/console/vite.config.ts` for the
+`manualChunks` rules that keep the chat-only deps in dedicated,
+lazy-loadable chunks.
 
 ## License
 

package/dist/{packages/plugin-chatbot/src/AiPendingActionsInbox.d.ts → AiPendingActionsInbox.d.ts}

@@ -5,6 +5,22 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
+/**
+ * AiPendingActionsInbox — workspace UI for the AI HITL approval queue.
+ *
+ * Wires `usePendingActions` to a Card/Table layout with an in-place
+ * detail drawer and approve / reject buttons. Designed to drop into both
+ * Console (`system/ai/pending-actions`) and Studio (assistant builder
+ * traces panel) without further glue — pass `apiBase` + `headers` and you
+ * get the whole flow.
+ *
+ * Stays inside `@object-ui/plugin-chatbot` so the AI bundle (already
+ * loaded when a chatbot mounts) holds the inbox too. No extra route-
+ * level code-split needed.
+ *
+ * @module
+ */
+import * as React from 'react';
 export interface AiPendingActionsInboxProps {
     /**
      * AI service base URL, e.g. `http://localhost:3004/api/v1/ai`.
@@ -34,5 +50,5 @@ export interface AiPendingActionsInboxProps {
  * renders rows in a table, and exposes Approve / Reject buttons plus a
  * detail drawer with raw `tool_input` / result / error.
  */
-export declare function AiPendingActionsInbox({ apiBase, headers, pollInterval, conversationId, variant, title, description, className, }: AiPendingActionsInboxProps): import("react/jsx-runtime").JSX.Element;
+export declare function AiPendingActionsInbox({ apiBase, headers, pollInterval, conversationId, variant, title, description, className, }: AiPendingActionsInboxProps): React.JSX.Element;
 //# sourceMappingURL=AiPendingActionsInbox.d.ts.map

package/dist/AiPendingActionsInbox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AiPendingActionsInbox.d.ts","sourceRoot":"","sources":["../src/AiPendingActionsInbox.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAoD/B,MAAM,WAAW,0BAA0B;IACzC;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gEAAgE;IAChE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,+DAA+D;IAC/D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,8EAA8E;IAC9E,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC1B,+CAA+C;IAC/C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qDAAqD;IACrD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+CAA+C;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAyDD;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,EACpC,OAAO,EACP,OAAO,EACP,YAAmB,EACnB,cAAc,EACd,OAAgB,EAChB,KAAsB,EACtB,WAAuF,EACvF,SAAS,GACV,EAAE,0BAA0B,qBAmW5B"}