@object-ui/plugin-chatbot 4.0.1 → 4.0.4

package/CHANGELOG.md

@@ -1,5 +1,42 @@
 # @object-ui/plugin-chatbot
 
+## 4.0.4
+
+### Patch Changes
+
+- d2b6ece: fix: externalize all bare imports in library builds
+
+  Library builds (vite lib mode) now externalize every non-relative import instead of bundling third-party CJS dependencies into the published dist. This avoids inlined `require("react")` / `require("react-dom")` calls that cause `Calling \`require\` for "react" in an environment that doesn't expose the \`require\` function` runtime errors when consumer apps re-bundle the published dist.
+
+  Specifically fixes:
+  - `@object-ui/plugin-dashboard` no longer inlines `react-grid-layout` (and its transitive `react-draggable` / `react-resizable` CJS bundles). `react-grid-layout` is now declared as a peer dependency so consumers install a single ESM-friendly copy.
+  - `@object-ui/components`, `@object-ui/plugin-calendar`, `@object-ui/plugin-charts`, `@object-ui/plugin-designer` no longer inline `react-i18next` / `i18next` / `use-sync-external-store` CJS shims.
+  - All plugin packages now use a unified `external: (id) => !/^[./]/.test(id) && !id.startsWith(__dirname)` rule, ensuring future additions of CJS deps are automatically externalized.
+
+- Updated dependencies [d2b6ece]
+  - @object-ui/components@4.0.4
+  - @object-ui/types@4.0.4
+  - @object-ui/core@4.0.4
+  - @object-ui/react@4.0.4
+
+## 4.0.3
+
+### Patch Changes
+
+- 4be43e2: **Page-mode record forms (`editMode: 'page'`).** New per-object metadata flag that opts a record's create/edit form into a dedicated full-screen route (`/apps/:appName/:objectName/new`, `/apps/:appName/:objectName/record/:recordId/edit`). Two new declarative actions `navigate_create` and `navigate_edit` open these routes from JSON action buttons. Default modal behavior is preserved for objects that do not set `editMode`.
+
+  **`@object-ui/plugin-list` & `@object-ui/plugin-detail`: `ComponentRegistry` singleton fix.** Both plugins' Vite configs now mark all `@object-ui/*` packages as external so each plugin no longer bundles its own private copy of `@object-ui/core`. Cross-plugin component lookups now resolve correctly from the same singleton registry. `plugin-list` dist shrank from multi-MB to 67 kB (gzip 16 kB); `plugin-detail` to 124 kB (gzip 28 kB).
+
+  **`@object-ui/app-shell` `CreateViewDialog` churn fix.** `existingSet` is now memoised on the joined string key of `existingLabels` rather than the raw array reference, preventing the name-suggest `useEffect` from re-firing on every parent render.
+
+  **CI fixes.** `ReportViewer` conditional-formatting test now accepts both `rgb(...)` and hex color representations. `ObjectView` i18n mocks rewritten to mirror the real hook shapes (`useObjectTranslation`, `useObjectLabel`).
+
+- Updated dependencies [4be43e2]
+  - @object-ui/types@4.0.3
+  - @object-ui/core@4.0.3
+  - @object-ui/react@4.0.3
+  - @object-ui/components@4.0.3
+
 ## 4.0.1
 
 ### Patch Changes

package/README.md

@@ -46,7 +46,8 @@ function App() {
 ### AI Streaming Mode (service-ai)
 
 When `api` is set in the schema, the chatbot connects to a backend SSE endpoint
-using `@ai-sdk/react` for streaming, tool-calling, and production-grade chat:
+using `@ai-sdk/react` v3 (Vercel UI Message Stream protocol) for streaming,
+tool-calling, and production-grade chat:
 
 ```tsx
 import '@object-ui/plugin-chatbot';
@@ -102,6 +103,55 @@ function MyChat() {
 
 ## Schema-Driven Usage
 
+### Discovering Backend Agents
+
+Use `useAgents` to fetch the list of agents exposed by `@objectstack/service-ai`
+at `GET {apiBase}/agents`. This is what the global console FAB uses to populate
+its in-header agent picker:
+
+```tsx
+import { useAgents } from '@object-ui/plugin-chatbot';
+
+function AgentPicker() {
+  const { agents, isLoading, error } = useAgents({
+    apiBase: 'http://localhost:3000/api/v1/ai',
+    // Optional fallback list shown when the backend is unreachable
+    fallback: [{ name: 'data_chat', label: 'Data Chat' }],
+  });
+
+  if (isLoading) return <span>Loading agents…</span>;
+  if (error) return <span>Backend unreachable</span>;
+
+  return (
+    <select>
+      {agents.map(a => (
+        <option key={a.name} value={a.name}>{a.label}</option>
+      ))}
+    </select>
+  );
+}
+```
+
+Each agent's chat endpoint is `POST {apiBase}/agents/{name}/chat` — pass that
+URL as the `api` option to `useObjectChat` to talk to it.
+
+### Console Integration
+
+The console (`@object-ui/app-shell`) auto-mounts a global floating chatbot
+when `useDiscovery().isAiEnabled` is true. Configure the backend in your
+console `.env`:
+
+```bash
+# AI service endpoint (defaults to ${VITE_SERVER_URL}/api/v1/ai when unset)
+VITE_AI_BASE_URL=http://localhost:3000/api/v1/ai
+# Default agent to select on first open (must match an agent name returned
+# by GET ${VITE_AI_BASE_URL}/agents)
+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.
+
 This plugin automatically registers with ObjectUI's component registry when imported:
 
 ```tsx