@object-ui/app-shell 6.2.0 → 6.2.2

package/CHANGELOG.md

@@ -1,5 +1,66 @@
 # @object-ui/app-shell — Changelog
 
+## 6.2.2
+
+### Patch Changes
+
+- c5821ce: `AiChatPage` no longer PATCHes a client-side title-from-first-message
+  on the freshly-created conversation. The server (`@objectstack/service-ai`
+  ≥ next minor) now generates a concise LLM-summarised title fire-and-forget
+  after the first assistant turn lands, and a client-side truncated title
+  would race that and win — pinning every conversation row to a 40-char
+  substring of the first user message instead of a real summary.
+
+  Drop the PATCH; bump the sidebar list a couple of times (2.5 s + 6 s)
+  to pick up the LLM title whenever the model finally responds.
+
+- 3b35084: Fix: floating chatbot now replays persisted conversation history on mount.
+
+  The right-corner floating chatbot (`ConsoleFloatingChatbot`) was passing only
+  `conversationId` to its inner `useObjectChat`, dropping the `initialMessages`
+  returned by `useChatConversation`. Backend persistence already worked — the
+  server-side `ai_conversation` + `ai_message` rows were created and survived a
+  page refresh — but the UI started each session with just the static "welcome"
+  bubble, making users believe their history had been lost.
+
+  Now matches the `/ai/:conversationId` full-page chat: history is hydrated
+  into the chat surface, and the welcome bubble is suppressed when prior turns
+  exist (showing it above real user/assistant turns is confusing).
+
+- Updated dependencies [a66f788]
+  - @object-ui/react@6.2.2
+  - @object-ui/components@6.2.2
+  - @object-ui/fields@6.2.2
+  - @object-ui/layout@6.2.2
+  - @object-ui/plugin-editor@6.2.2
+  - @object-ui/types@6.2.2
+  - @object-ui/core@6.2.2
+  - @object-ui/i18n@6.2.2
+  - @object-ui/data-objectstack@6.2.2
+  - @object-ui/auth@6.2.2
+  - @object-ui/permissions@6.2.2
+  - @object-ui/collaboration@6.2.2
+  - @object-ui/providers@6.2.2
+
+## 6.2.1
+
+### Patch Changes
+
+- bc269b0: fix
+  - @object-ui/types@6.2.1
+  - @object-ui/core@6.2.1
+  - @object-ui/i18n@6.2.1
+  - @object-ui/react@6.2.1
+  - @object-ui/components@6.2.1
+  - @object-ui/fields@6.2.1
+  - @object-ui/layout@6.2.1
+  - @object-ui/data-objectstack@6.2.1
+  - @object-ui/auth@6.2.1
+  - @object-ui/permissions@6.2.1
+  - @object-ui/plugin-editor@6.2.1
+  - @object-ui/collaboration@6.2.1
+  - @object-ui/providers@6.2.1
+
 ## 6.2.0
 
 ### Minor Changes

package/dist/console/AppContent.js

@@ -40,6 +40,13 @@ const ReportView = lazy(() => import('../views/ReportView').then(m => ({ default
 const SearchResultsPage = lazy(() => import('../views/SearchResultsPage').then(m => ({ default: m.SearchResultsPage })));
 const RecordFormPage = lazy(() => import('../views/RecordFormPage').then(m => ({ default: m.RecordFormPage })));
 const ComponentNavView = lazy(() => import('../views/ComponentNavView').then(m => ({ default: m.ComponentNavView })));
+// Metadata admin — mounted under /apps/:app/metadata. Lives at the top
+// level so URLs read like a normal nested resource (RFC-style) instead of
+// piggy-backing on the legacy ComponentRegistry fan-out.
+const MetadataDirectoryPage = lazy(() => import('../views/metadata-admin').then(m => ({ default: m.MetadataDirectoryPage })));
+const MetadataResourceListPage = lazy(() => import('../views/metadata-admin').then(m => ({ default: m.MetadataResourceListPage })));
+const MetadataResourceEditPage = lazy(() => import('../views/metadata-admin').then(m => ({ default: m.MetadataResourceEditPage })));
+const MetadataResourceHistoryPage = lazy(() => import('../views/metadata-admin').then(m => ({ default: m.MetadataResourceHistoryPage })));
 // Designer pages — sourced from @object-ui/plugin-designer so third-party hosts
 // can opt out by not registering these routes.
 const CreateAppPage = lazy(() => import('@object-ui/plugin-designer').then(m => ({ default: m.CreateAppPage })));
@@ -259,7 +266,7 @@ export function AppContent({ extraRoutes, extraRoutesNoApp } = {}) {
     const expressionUser = user
         ? { name: user.name, email: user.email, role: user.role ?? 'user' }
         : { name: 'Anonymous', email: '', role: 'guest' };
-    return (_jsxs(ExpressionProvider, { user: expressionUser, app: activeApp, data: {}, features: features, children: [_jsx(NavigationSyncEffect, {}), _jsxs(ConsoleLayout, { activeAppName: activeApp.name, activeApp: activeApp, onAppChange: handleAppChange, objects: allObjects, connectionState: connectionState, userId: user?.id, children: [_jsx(CommandPalette, { apps: apps, activeApp: activeApp, objects: allObjects, onAppChange: handleAppChange, dataSource: dataSource }), _jsx(KeyboardShortcutsDialog, {}), _jsx(OnboardingWalkthrough, {}), _jsx(ErrorBoundary, { children: _jsx(Suspense, { fallback: _jsx(LoadingScreen, {}), children: _jsx(RouteFader, { children: _jsxs(Routes, { children: [_jsx(Route, { path: "/", element: _jsx(Navigate, { to: resolveLandingRoute(activeApp), replace: true }) }), _jsx(Route, { path: ":objectName", element: _jsx(ObjectView, { dataSource: dataSource, objects: allObjects, onEdit: handleEdit, externalRefreshKey: refreshKey }) }), _jsx(Route, { path: ":objectName/new", element: _jsx(RecordFormPage, { mode: "create" }) }), _jsx(Route, { path: ":objectName/view/:viewId", element: _jsx(ObjectView, { dataSource: dataSource, objects: allObjects, onEdit: handleEdit, externalRefreshKey: refreshKey }) }), _jsx(Route, { path: ":objectName/record/:recordId", element: _jsx(RecordDetailView, { dataSource: dataSource, objects: allObjects, onEdit: handleEdit }, refreshKey) }), _jsx(Route, { path: ":objectName/record/:recordId/edit", element: _jsx(RecordFormPage, { mode: "edit" }) }), _jsx(Route, { path: "dashboard/:dashboardName", element: _jsx(DashboardView, { dataSource: dataSource }) }), _jsx(Route, { path: "report/:reportName", element: _jsx(ReportView, { dataSource: dataSource }) }), _jsx(Route, { path: "page/:pageName", element: _jsx(PageView, {}) }), _jsx(Route, { path: "component/:ns/:name/*", element: _jsx(ComponentNavView, {}) }), _jsx(Route, { path: "design/page/:pageName", element: _jsx(PageDesignPage, {}) }), _jsx(Route, { path: "design/dashboard/:dashboardName", element: _jsx(DashboardDesignPage, {}) }), _jsx(Route, { path: "search", element: _jsx(SearchResultsPage, {}) }), _jsx(Route, { path: "create-app", element: _jsx(CreateAppPage, {}) }), _jsx(Route, { path: "edit-app/:editAppName", element: _jsx(EditAppPage, {}) }), _jsx(Route, { path: "system/marketplace", element: _jsx(MarketplacePage, {}) }), _jsx(Route, { path: "system/marketplace/installed", element: _jsx(MarketplaceInstalledPage, {}) }), _jsx(Route, { path: "system/marketplace/:packageId", element: _jsx(MarketplacePackagePage, {}) }), extraRoutes, _jsx(Route, { path: ":objectName/:maybeRecordId", element: _jsx(ShorthandRecordRedirect, {}) }), _jsx(Route, { path: "*", element: _jsx(RouteNotFound, {}) })] }) }) }) }), currentObjectDef && (_jsx(ModalForm, { schema: {
+    return (_jsxs(ExpressionProvider, { user: expressionUser, app: activeApp, data: {}, features: features, children: [_jsx(NavigationSyncEffect, {}), _jsxs(ConsoleLayout, { activeAppName: activeApp.name, activeApp: activeApp, onAppChange: handleAppChange, objects: allObjects, connectionState: connectionState, userId: user?.id, children: [_jsx(CommandPalette, { apps: apps, activeApp: activeApp, objects: allObjects, onAppChange: handleAppChange, dataSource: dataSource }), _jsx(KeyboardShortcutsDialog, {}), _jsx(OnboardingWalkthrough, {}), _jsx(ErrorBoundary, { children: _jsx(Suspense, { fallback: _jsx(LoadingScreen, {}), children: _jsx(RouteFader, { children: _jsxs(Routes, { children: [_jsx(Route, { path: "/", element: _jsx(Navigate, { to: resolveLandingRoute(activeApp), replace: true }) }), _jsxs(Route, { path: "metadata", children: [_jsx(Route, { index: true, element: _jsx(MetadataDirectoryPage, {}) }), _jsx(Route, { path: ":type", element: _jsx(MetadataResourceListPage, {}) }), _jsx(Route, { path: ":type/new", element: _jsx(MetadataResourceEditPage, { createMode: true }) }), _jsx(Route, { path: ":type/:name", element: _jsx(MetadataResourceEditPage, {}) }), _jsx(Route, { path: ":type/:name/history", element: _jsx(MetadataResourceHistoryPage, {}) })] }), _jsx(Route, { path: ":objectName", element: _jsx(ObjectView, { dataSource: dataSource, objects: allObjects, onEdit: handleEdit, externalRefreshKey: refreshKey }) }), _jsx(Route, { path: ":objectName/new", element: _jsx(RecordFormPage, { mode: "create" }) }), _jsx(Route, { path: ":objectName/view/:viewId", element: _jsx(ObjectView, { dataSource: dataSource, objects: allObjects, onEdit: handleEdit, externalRefreshKey: refreshKey }) }), _jsx(Route, { path: ":objectName/record/:recordId", element: _jsx(RecordDetailView, { dataSource: dataSource, objects: allObjects, onEdit: handleEdit }, refreshKey) }), _jsx(Route, { path: ":objectName/record/:recordId/edit", element: _jsx(RecordFormPage, { mode: "edit" }) }), _jsx(Route, { path: "dashboard/:dashboardName", element: _jsx(DashboardView, { dataSource: dataSource }) }), _jsx(Route, { path: "report/:reportName", element: _jsx(ReportView, { dataSource: dataSource }) }), _jsx(Route, { path: "page/:pageName", element: _jsx(PageView, {}) }), _jsx(Route, { path: "component/:ns/:name/*", element: _jsx(ComponentNavView, {}) }), _jsx(Route, { path: "component/metadata/directory", element: _jsx(LegacyMetadataRedirect, { mode: "directory" }) }), _jsx(Route, { path: "component/metadata/resource/*", element: _jsx(LegacyMetadataRedirect, { mode: "resource" }) }), _jsx(Route, { path: "design/page/:pageName", element: _jsx(PageDesignPage, {}) }), _jsx(Route, { path: "design/dashboard/:dashboardName", element: _jsx(DashboardDesignPage, {}) }), _jsx(Route, { path: "search", element: _jsx(SearchResultsPage, {}) }), _jsx(Route, { path: "create-app", element: _jsx(CreateAppPage, {}) }), _jsx(Route, { path: "edit-app/:editAppName", element: _jsx(EditAppPage, {}) }), _jsx(Route, { path: "system/marketplace", element: _jsx(MarketplacePage, {}) }), _jsx(Route, { path: "system/marketplace/installed", element: _jsx(MarketplaceInstalledPage, {}) }), _jsx(Route, { path: "system/marketplace/:packageId", element: _jsx(MarketplacePackagePage, {}) }), extraRoutes, _jsx(Route, { path: ":objectName/:maybeRecordId", element: _jsx(ShorthandRecordRedirect, {}) }), _jsx(Route, { path: "*", element: _jsx(RouteNotFound, {}) })] }) }) }) }), currentObjectDef && (_jsx(ModalForm, { schema: {
                             type: 'object-form',
                             formType: 'modal',
                             objectName: currentObjectDef.name,
@@ -378,6 +385,7 @@ const RESERVED_SECOND_SEGMENTS = new Set([
     'new', 'view', 'record', 'edit',
     'dashboard', 'report', 'page',
     'design', 'search', 'create-app', 'edit-app',
+    'metadata',
 ]);
 function looksLikeRecordId(segment) {
     if (!segment)
@@ -390,6 +398,27 @@ function looksLikeRecordId(segment) {
     // Most record ids are at least 6 chars (UUID, ULID, nanoid all >=8).
     return segment.length >= 6;
 }
+/**
+ * Translates pre-refactor metadata admin URLs
+ * (`/apps/:app/component/metadata/resource/:name?type=:type`,
+ *  `/apps/:app/component/metadata/directory`) into the new REST-style
+ * shape (`/apps/:app/metadata/:type/:name`). Keeps bookmarks and any
+ * still-unmigrated link producers working.
+ */
+function LegacyMetadataRedirect({ mode }) {
+    const location = useLocation();
+    const appBase = location.pathname.replace(/\/component\/metadata\/.*$/, '');
+    if (mode === 'directory') {
+        return _jsx(Navigate, { to: `${appBase}/metadata${location.search}${location.hash}`, replace: true });
+    }
+    const sp = new URLSearchParams(location.search);
+    const type = sp.get('type') ?? '';
+    const tail = location.pathname.match(/\/component\/metadata\/resource(\/.*)?$/)?.[1] ?? '';
+    const target = type
+        ? `${appBase}/metadata/${encodeURIComponent(type)}${tail}${location.hash}`
+        : `${appBase}/metadata${location.hash}`;
+    return _jsx(Navigate, { to: target, replace: true });
+}
 /**
  * Redirects `/apps/:appName/:objectName/:recordId` shorthand to the
  * canonical `/apps/:appName/:objectName/record/:recordId` so externally

package/dist/console/ai/AiChatPage.js

@@ -15,7 +15,8 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { useCallback, useEffect, useMemo, useRef, useState } from 'react';
 import { useNavigate, useParams } from 'react-router-dom';
 import { useAuth } from '@object-ui/auth';
-import { Select, SelectContent, SelectItem, SelectTrigger, SelectValue, } from '@object-ui/components';
+import { Select, SelectContent, SelectItem, SelectTrigger, SelectValue, Button, ShareDialog, } from '@object-ui/components';
+import { Share2 } from 'lucide-react';
 import { ChatbotEnhanced, useAgents, useObjectChat, useHitlInChat, } from '@object-ui/plugin-chatbot';
 import { AppHeader } from '../../layout/AppHeader';
 import { useNavigationContext } from '../../context/NavigationContext';
@@ -63,6 +64,8 @@ export function AiChatPage({ apiBase: apiBaseProp, defaultAgent: defaultAgentPro
         activeId: urlConversationId,
     });
     const [refreshKey, setRefreshKey] = useState(0);
+    const [shareOpen, setShareOpen] = useState(false);
+    const restApiBase = useMemo(() => apiBase.replace(/\/v1\/ai$/, '').replace(/\/ai$/, '') || '/api', [apiBase]);
     // After the hook resolves a real id for a fresh `/ai` visit, mirror it into
     // the URL so the sidebar's active-row + share/refresh both work.
     useEffect(() => {
@@ -81,32 +84,26 @@ export function AiChatPage({ apiBase: apiBaseProp, defaultAgent: defaultAgentPro
     const handleSent = useCallback((firstUserMessage) => {
         // New user turn → bump sidebar list so the row's preview/timestamp refreshes.
         setRefreshKey((k) => k + 1);
-        // Auto-title the conversation from the first user message. Server only
-        // tracks `title` when we PATCH it; without this every row shows the same
-        // "New conversation" placeholder. We mark `conversationId` as titled in a
-        // ref so subsequent turns don't re-rename and clobber a manual rename.
+        // Server now generates a concise LLM-summarised title fire-and-forget
+        // after the first assistant turn lands (see service-ai
+        // `summarizeConversation`). We don't PATCH a truncated preview from the
+        // client anymore — that races the LLM and wins, which would block the
+        // real title. Instead, bump the sidebar a couple of times so the new
+        // title is picked up whenever the model finally responds.
         if (!firstUserMessage || !conversationId)
             return;
         if (titledRef.current.has(conversationId))
             return;
         titledRef.current.add(conversationId);
-        const text = firstUserMessage.trim();
-        if (!text)
-            return;
-        const truncated = text.length > 40 ? `${text.slice(0, 40)}…` : text;
-        fetch(`${apiBase}/conversations/${encodeURIComponent(conversationId)}`, {
-            method: 'PATCH',
-            credentials: 'include',
-            headers: { 'Content-Type': 'application/json' },
-            body: JSON.stringify({ title: truncated }),
-        })
-            .then(() => setRefreshKey((k) => k + 1))
-            .catch(() => {
-            // Leave it untitled; user can rename manually.
-            titledRef.current.delete(conversationId);
-        });
-    }, [apiBase, conversationId]);
-    return (_jsxs("div", { className: "flex h-svh w-full flex-col bg-background", "data-testid": "ai-chat-page", children: [_jsx("header", { className: "sticky top-0 z-30 flex h-14 w-full shrink-0 items-center gap-2 border-b bg-background px-2 sm:px-4", children: _jsx(AppHeader, { variant: "home" }) }), _jsxs("div", { className: "flex flex-1 min-h-0 w-full", children: [_jsx(ConversationsSidebar, { userId: userId, apiBase: apiBase, refreshKey: refreshKey, className: "hidden w-72 shrink-0 border-r md:flex" }), _jsx("main", { className: "flex flex-1 min-w-0 flex-col", children: _jsx(ChatPane, { agents: agents, agentsLoading: agentsLoading, agentsError: agentsError, activeAgent: activeAgent, onAgentChange: setActiveAgent, chatApi: chatApi, apiBase: apiBase, conversationId: conversationId, initialMessages: initialMessages, hydrating: convoLoading, onSent: handleSent }, `${chatApi ?? 'local'}:${conversationId ?? 'pending'}`) })] })] }));
+        const bump = () => setRefreshKey((k) => k + 1);
+        const t1 = setTimeout(bump, 2500);
+        const t2 = setTimeout(bump, 6000);
+        // Best-effort: if the component unmounts before the bumps fire, the
+        // setRefreshKey call is a no-op so we don't bother tracking the timers.
+        void t1;
+        void t2;
+    }, [conversationId]);
+    return (_jsxs("div", { className: "flex h-svh w-full flex-col bg-background", "data-testid": "ai-chat-page", children: [_jsxs("header", { className: "sticky top-0 z-30 flex h-14 w-full shrink-0 items-center gap-2 border-b bg-background px-2 sm:px-4", children: [_jsx(AppHeader, { variant: "home" }), _jsx("div", { className: "ml-auto flex items-center gap-2", children: _jsxs(Button, { variant: "outline", size: "sm", className: "h-8 gap-1.5", onClick: () => setShareOpen(true), disabled: !conversationId, "data-testid": "ai-chat-share-button", title: conversationId ? 'Share this conversation' : 'Start chatting to enable sharing', children: [_jsx(Share2, { className: "h-3.5 w-3.5" }), "Share"] }) })] }), conversationId && (_jsx(ShareDialog, { open: shareOpen, onOpenChange: setShareOpen, objectName: "ai_conversations", recordId: conversationId, recordLabel: "this conversation", apiBase: restApiBase })), _jsxs("div", { className: "flex flex-1 min-h-0 w-full", children: [_jsx(ConversationsSidebar, { userId: userId, apiBase: apiBase, refreshKey: refreshKey, className: "hidden w-72 shrink-0 border-r md:flex" }), _jsx("main", { className: "flex flex-1 min-w-0 flex-col", children: _jsx(ChatPane, { agents: agents, agentsLoading: agentsLoading, agentsError: agentsError, activeAgent: activeAgent, onAgentChange: setActiveAgent, chatApi: chatApi, apiBase: apiBase, conversationId: conversationId, initialMessages: initialMessages, hydrating: convoLoading, onSent: handleSent }, `${chatApi ?? 'local'}:${conversationId ?? 'pending'}`) })] })] }));
 }
 function ChatPane({ agents, agentsLoading, agentsError, activeAgent, onAgentChange, chatApi, apiBase, conversationId, initialMessages, hydrating, onSent, }) {
     const activeAgentLabel = useMemo(() => {

package/dist/layout/ConsoleFloatingChatbot.js

@@ -1,4 +1,4 @@
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 /**
  * ConsoleFloatingChatbot
  *
@@ -13,7 +13,8 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
  */
 import React from 'react';
 import { FloatingChatbot, useObjectChat, useAgents, useHitlInChat, } from '@object-ui/plugin-chatbot';
-import { Select, SelectContent, SelectItem, SelectTrigger, SelectValue, } from '@object-ui/components';
+import { Select, SelectContent, SelectItem, SelectTrigger, SelectValue, Button, ShareDialog, } from '@object-ui/components';
+import { Share2 } from 'lucide-react';
 import { useChatConversation } from '../hooks';
 const DEFAULT_AI_PATH = '/api/v1/ai';
 function resolveApiBase(explicit) {
@@ -26,8 +27,19 @@ function resolveApiBase(explicit) {
     const serverUrl = env.VITE_SERVER_URL ?? '';
     return `${serverUrl.replace(/\/$/, '')}${DEFAULT_AI_PATH}`;
 }
-function ChatbotInner({ appLabel, objects, agents, agentsLoading, agentsError, activeAgent, onAgentChange, chatApi, apiBase, defaultOpen = false, conversationId, }) {
+function ChatbotInner({ appLabel, objects, agents, agentsLoading, agentsError, activeAgent, onAgentChange, chatApi, apiBase, defaultOpen = false, conversationId, initialMessages: persistedMessages, }) {
     const objectNames = objects.map((o) => o.label || o.name).join(', ');
+    // Replay persisted history when present. Suppress the static "welcome"
+    // bubble in that case — showing it above real prior turns is confusing.
+    const hydratedHistory = React.useMemo(() => {
+        if (!persistedMessages || persistedMessages.length === 0)
+            return [];
+        return persistedMessages.map((m) => ({
+            id: m.id,
+            role: m.role,
+            content: m.parts.map((p) => p.text).join(''),
+        }));
+    }, [persistedMessages]);
     const activeAgentLabel = React.useMemo(() => {
         const found = agents.find((a) => a.name === activeAgent);
         return found?.label ?? activeAgent ?? appLabel;
@@ -45,13 +57,15 @@ function ChatbotInner({ appLabel, objects, agents, agentsLoading, agentsError, a
                 agentName: activeAgent,
             },
         },
-        initialMessages: [
-            {
-                id: 'welcome',
-                role: 'assistant',
-                content: welcomeContent,
-            },
-        ],
+        initialMessages: hydratedHistory.length > 0
+            ? hydratedHistory
+            : [
+                {
+                    id: 'welcome',
+                    role: 'assistant',
+                    content: welcomeContent,
+                },
+            ],
         // Local-mode fallback: only used when `chatApi` is undefined (no agent
         // resolved yet, or no backend available). Keeps the UI usable.
         autoResponse: !chatApi,
@@ -73,18 +87,24 @@ function ChatbotInner({ appLabel, objects, agents, agentsLoading, agentsError, a
         },
     });
     const headerExtra = agents.length > 0 ? (_jsxs(Select, { value: activeAgent, onValueChange: onAgentChange, disabled: agentsLoading, children: [_jsx(SelectTrigger, { className: "h-7 w-[180px] text-xs", "data-testid": "floating-chatbot-agent-picker", children: _jsx(SelectValue, { placeholder: "Choose agent..." }) }), _jsx(SelectContent, { align: "end", children: agents.map((agent) => (_jsxs(SelectItem, { value: agent.name, className: "text-xs", children: [_jsx("span", { className: "font-medium", children: agent.label }), agent.description ? (_jsx("span", { className: "block text-muted-foreground text-[10px] truncate max-w-[220px]", children: agent.description })) : null] }, agent.name))) })] })) : null;
-    return (_jsx(FloatingChatbot, { floatingConfig: {
-            position: 'bottom-right',
-            defaultOpen,
-            panelWidth: 420,
-            panelHeight: 560,
-            title: `${appLabel} Assistant`,
-            triggerSize: 56,
-        }, headerExtra: headerExtra, messages: messages, placeholder: activeAgent
-            ? `Ask ${activeAgentLabel}...`
-            : agentsLoading
-                ? 'Loading agents...'
-                : 'Ask anything...', onSendMessage: (content) => sendMessage(content), onClear: clear, onStop: isLoading ? stop : undefined, onReload: reload, isLoading: isLoading, error: error, enableMarkdown: true, onToolApprove: hitl.decide, toolDecisions: hitl.decisions, toolApproveLabel: "Approve & run", toolDenyLabel: "Reject", toolDenyReason: "Operator rejected from chat" }));
+    // Share-link control. Sits to the left of the panel's built-in
+    // fullscreen / close buttons so users can mint a public link without
+    // jumping out to the full `/ai/:id` page.
+    const [shareOpen, setShareOpen] = React.useState(false);
+    const restApiBase = React.useMemo(() => apiBase.replace(/\/v1\/ai$/, '').replace(/\/ai$/, '') || '/api', [apiBase]);
+    const headerActions = conversationId ? (_jsx(Button, { variant: "ghost", size: "icon", className: "h-7 w-7", "aria-label": "Share conversation", "data-testid": "floating-chatbot-share", onClick: () => setShareOpen(true), children: _jsx(Share2, { className: "h-4 w-4" }) })) : null;
+    return (_jsxs(_Fragment, { children: [_jsx(FloatingChatbot, { floatingConfig: {
+                    position: 'bottom-right',
+                    defaultOpen,
+                    panelWidth: 420,
+                    panelHeight: 560,
+                    title: `${appLabel} Assistant`,
+                    triggerSize: 56,
+                }, headerExtra: headerExtra, headerActions: headerActions, messages: messages, placeholder: activeAgent
+                    ? `Ask ${activeAgentLabel}...`
+                    : agentsLoading
+                        ? 'Loading agents...'
+                        : 'Ask anything...', onSendMessage: (content) => sendMessage(content), onClear: clear, onStop: isLoading ? stop : undefined, onReload: reload, isLoading: isLoading, error: error, enableMarkdown: true, onToolApprove: hitl.decide, toolDecisions: hitl.decisions, toolApproveLabel: "Approve & run", toolDenyLabel: "Reject", toolDenyReason: "Operator rejected from chat" }), conversationId && (_jsx(ShareDialog, { open: shareOpen, onOpenChange: setShareOpen, objectName: "ai_conversations", recordId: conversationId, recordLabel: "this conversation", apiBase: restApiBase }))] }));
 }
 export default function ConsoleFloatingChatbot({ appLabel, objects, apiBase: apiBaseProp, defaultAgent: defaultAgentProp, defaultOpen = false, userId, }) {
     const apiBase = React.useMemo(() => resolveApiBase(apiBaseProp), [apiBaseProp]);
@@ -105,7 +125,7 @@ export default function ConsoleFloatingChatbot({ appLabel, objects, apiBase: api
     // Server-backed conversation. Scoped by agent so each agent gets its own
     // persistent history. Hook is inert until `userId` is provided; without it
     // the FAB continues to work in local-only mode (no persistence).
-    const { conversationId } = useChatConversation({
+    const { conversationId, initialMessages } = useChatConversation({
         userId,
         scope: activeAgent,
         apiBase,
@@ -113,5 +133,5 @@ export default function ConsoleFloatingChatbot({ appLabel, objects, apiBase: api
     // `key` forces a clean remount whenever the chat endpoint OR the resolved
     // conversation id changes — required because `useObjectChat` locks its mode
     // (api vs local) and its `conversationId` on first render.
-    return (_jsx(ChatbotInner, { appLabel: appLabel, objects: objects, agents: agents, agentsLoading: agentsLoading, agentsError: agentsError, activeAgent: activeAgent, onAgentChange: setActiveAgent, chatApi: chatApi, apiBase: apiBase, defaultOpen: defaultOpen, conversationId: conversationId }, `${chatApi ?? 'local'}:${conversationId ?? 'pending'}`));
+    return (_jsx(ChatbotInner, { appLabel: appLabel, objects: objects, agents: agents, agentsLoading: agentsLoading, agentsError: agentsError, activeAgent: activeAgent, onAgentChange: setActiveAgent, chatApi: chatApi, apiBase: apiBase, defaultOpen: defaultOpen, conversationId: conversationId, initialMessages: initialMessages }, `${chatApi ?? 'local'}:${conversationId ?? 'pending'}`));
 }

package/dist/services/builtinComponents.js

@@ -21,7 +21,7 @@ import { lazy, Suspense } from 'react';
 import { registerAppComponent } from './componentRegistry';
 import { MetadataDirectoryPage, MetadataResourceRouter, registerMetadataResource, } from '../views/metadata-admin';
 import { PermissionMatrixEditPage } from '../views/metadata-admin/PermissionMatrixEditor';
-import { DesignerEditorWrapper } from '../views/metadata-admin/DesignerEditorWrapper';
+import { DesignerEditorBody } from '../views/metadata-admin/DesignerEditorWrapper';
 /* -------------------------------------------------------------------------- */
 /* 1) Top-level admin pages — bound to `metadata:directory` + `metadata:resource` */
 /* -------------------------------------------------------------------------- */
@@ -104,7 +104,7 @@ const ObjectViewConfigurator = lazy(() => import('@object-ui/plugin-designer').t
 const DashboardEditor = lazy(() => import('@object-ui/plugin-designer').then((m) => ({ default: m.DashboardEditor })));
 const PageCanvasEditor = lazy(() => import('@object-ui/plugin-designer').then((m) => ({ default: m.PageCanvasEditor })));
 function ViewEditPage(props) {
-    return (_jsx(DesignerEditorWrapper, { ...props, fromMetadata: (raw) => {
+    return (_jsx(DesignerEditorBody, { ...props, fromMetadata: (raw) => {
             // Normalize backend view metadata into the shape ObjectViewConfigurator expects.
             // Built-in views may omit `columns` or use legacy field names.
             const base = raw && typeof raw === 'object' ? raw : {};
@@ -119,10 +119,10 @@ function ViewEditPage(props) {
         }, renderDesigner: (value, onChange, readOnly) => (_jsx(Suspense, { fallback: _jsx(DesignerFallback, { label: "view designer" }), children: _jsx(ObjectViewConfigurator, { config: value, onChange: (next) => onChange(next), readOnly: readOnly }) })) }));
 }
 function DashboardEditPage(props) {
-    return (_jsx(DesignerEditorWrapper, { ...props, renderDesigner: (value, onChange, readOnly) => (_jsx(Suspense, { fallback: _jsx(DesignerFallback, { label: "dashboard editor" }), children: _jsx(DashboardEditor, { schema: value, onChange: (next) => onChange(next), readOnly: readOnly }) })) }));
+    return (_jsx(DesignerEditorBody, { ...props, renderDesigner: (value, onChange, readOnly) => (_jsx(Suspense, { fallback: _jsx(DesignerFallback, { label: "dashboard editor" }), children: _jsx(DashboardEditor, { schema: value, onChange: (next) => onChange(next), readOnly: readOnly }) })) }));
 }
 function PageEditPage(props) {
-    return (_jsx(DesignerEditorWrapper, { ...props, renderDesigner: (value, onChange, readOnly) => (_jsx(Suspense, { fallback: _jsx(DesignerFallback, { label: "page canvas" }), children: _jsx(PageCanvasEditor, { schema: value, onChange: (next) => onChange(next), readOnly: readOnly }) })) }));
+    return (_jsx(DesignerEditorBody, { ...props, renderDesigner: (value, onChange, readOnly) => (_jsx(Suspense, { fallback: _jsx(DesignerFallback, { label: "page canvas" }), children: _jsx(PageCanvasEditor, { schema: value, onChange: (next) => onChange(next), readOnly: readOnly }) })) }));
 }
 function DesignerFallback({ label }) {
     return (_jsxs("div", { className: "p-6 text-sm text-muted-foreground", children: ["Loading ", label, "\u2026"] }));
@@ -132,7 +132,8 @@ registerMetadataResource({
     label: 'Views',
     description: 'Saved list / kanban / calendar / gantt configurations on top of an object.',
     domain: 'ui',
-    EditPage: ViewEditPage,
+    DesignerTab: ViewEditPage,
+    designerTabLabel: 'View designer',
     listColumns: [
         { key: 'name', label: 'Name', width: '30%' },
         { key: 'object', label: 'Object', width: '20%' },
@@ -145,7 +146,8 @@ registerMetadataResource({
     label: 'Dashboards',
     description: 'Composed dashboards with charts, KPIs, and tables.',
     domain: 'ui',
-    EditPage: DashboardEditPage,
+    DesignerTab: DashboardEditPage,
+    designerTabLabel: 'Dashboard designer',
     listColumns: [
         { key: 'name', label: 'Name', width: '30%' },
         { key: 'label', label: 'Label', width: '30%' },
@@ -157,7 +159,8 @@ registerMetadataResource({
     label: 'Pages',
     description: 'Visual page layouts authored in the Page Canvas editor.',
     domain: 'ui',
-    EditPage: PageEditPage,
+    DesignerTab: PageEditPage,
+    designerTabLabel: 'Page canvas',
     listColumns: [
         { key: 'name', label: 'Name', width: '30%' },
         { key: 'label', label: 'Label', width: '30%' },

package/dist/views/metadata-admin/DesignerEditorWrapper.d.ts

@@ -55,4 +55,14 @@ export interface DesignerEditorWrapperProps<TValue = any> {
      */
     toMetadata?: (value: TValue) => unknown;
 }
-export declare function DesignerEditorWrapper<TValue = any>({ type, name, renderDesigner, fromMetadata, toMetadata, }: DesignerEditorWrapperProps<TValue>): import("react/jsx-runtime").JSX.Element;
+export declare function DesignerEditorWrapper<TValue = any>(props: DesignerEditorWrapperProps<TValue>): import("react/jsx-runtime").JSX.Element;
+/**
+ * Embedded variant — same state machine, but no surrounding `PageShell`.
+ * Used by `ResourceEditPage` to host the designer inside a tab alongside
+ * the generic Form / Layers / References tabs. The action toolbar (Save /
+ * Reset / Refresh) is rendered inline at the top of the panel so the tab
+ * remains self-sufficient.
+ */
+export declare function DesignerEditorBody<TValue = any>({ type, name, renderDesigner, fromMetadata, toMetadata, withChrome, }: DesignerEditorWrapperProps<TValue> & {
+    withChrome?: boolean;
+}): import("react/jsx-runtime").JSX.Element;

package/dist/views/metadata-admin/DesignerEditorWrapper.js

@@ -47,7 +47,17 @@ import { PageShell } from './PageShell';
 import { useMetadataClient, useMetadataTypes } from './useMetadata';
 import { resolveResourceConfig } from './registry';
 import { t, detectLocale } from './i18n';
-export function DesignerEditorWrapper({ type, name, renderDesigner, fromMetadata, toMetadata, }) {
+export function DesignerEditorWrapper(props) {
+    return _jsx(DesignerEditorBody, { ...props, withChrome: true });
+}
+/**
+ * Embedded variant — same state machine, but no surrounding `PageShell`.
+ * Used by `ResourceEditPage` to host the designer inside a tab alongside
+ * the generic Form / Layers / References tabs. The action toolbar (Save /
+ * Reset / Refresh) is rendered inline at the top of the panel so the tab
+ * remains self-sufficient.
+ */
+export function DesignerEditorBody({ type, name, renderDesigner, fromMetadata, toMetadata, withChrome = false, }) {
     const navigate = useNavigate();
     const client = useMetadataClient();
     const { entries } = useMetadataTypes(client);
@@ -134,7 +144,15 @@ export function DesignerEditorWrapper({ type, name, renderDesigner, fromMetadata
         }
     }
     if (loading || value == null) {
-        return (_jsx(PageShell, { entry: entry, itemName: name, children: _jsxs("div", { className: "p-6 text-sm text-muted-foreground flex items-center gap-2", children: [_jsx(Loader2, { className: "h-4 w-4 animate-spin" }), " ", t('engine.edit.loading', locale), " ", type, "/", name, "\u2026"] }) }));
+        const loadingBody = (_jsxs("div", { className: "p-6 text-sm text-muted-foreground flex items-center gap-2", children: [_jsx(Loader2, { className: "h-4 w-4 animate-spin" }), " ", t('engine.edit.loading', locale), " ", type, "/", name, "\u2026"] }));
+        return withChrome ? (_jsx(PageShell, { entry: entry, itemName: name, children: loadingBody })) : (loadingBody);
+    }
+    const toolbarButtons = (_jsxs(_Fragment, { children: [_jsxs(Button, { variant: "ghost", size: "sm", onClick: load, disabled: saving, children: [_jsx(RefreshCw, { className: "h-4 w-4 mr-1" }), " ", t('engine.list.refresh', locale)] }), withChrome && (_jsxs(Button, { variant: "ghost", size: "sm", onClick: () => navigate(`./history`), children: [_jsx(HistoryIcon, { className: "h-4 w-4 mr-1" }), " ", t('engine.edit.history', locale)] })), writable && (_jsxs(Button, { variant: "ghost", size: "sm", onClick: doReset, disabled: saving, children: [_jsx(RotateCcw, { className: "h-4 w-4 mr-1" }), " ", t('engine.edit.reset', locale)] })), writable && (_jsxs(Button, { size: "sm", onClick: () => doSave(false), disabled: saving || !dirty, children: [saving ? (_jsx(Loader2, { className: "h-4 w-4 mr-1 animate-spin" })) : (_jsx(Save, { className: "h-4 w-4 mr-1" })), t('engine.edit.save', locale)] }))] }));
+    const banners = (_jsxs(_Fragment, { children: [!writable && (_jsx("div", { className: "mx-6 mt-4 rounded-md border bg-muted/40 px-3 py-2 text-xs text-muted-foreground", children: t('engine.edit.readOnlyHint', locale) })), error && (_jsxs("div", { className: "mx-6 mt-4 rounded-md border border-destructive/40 bg-destructive/5 p-3 text-sm text-destructive flex items-start gap-2", children: [_jsx(AlertTriangle, { className: "h-4 w-4 mt-0.5 shrink-0" }), _jsx("span", { children: error })] })), dirty && writable && (_jsxs("div", { className: "mx-6 mt-3 flex items-center gap-2 rounded-md border border-amber-300/50 bg-amber-50 dark:bg-amber-950/30 px-3 py-1.5 text-xs", children: [_jsx(Badge, { variant: "outline", children: t('engine.edit.unsaved', locale) }), _jsx("span", { children: t('engine.edit.unsavedHint', locale) })] }))] }));
+    const designerArea = (_jsx("div", { className: "flex-1 min-h-0 overflow-auto", children: renderDesigner(value, (next) => setValue(next), !writable) }));
+    const destructiveDialog = (_jsx(Dialog, { open: !!destructive, onOpenChange: (open) => !open && setDestructive(null), children: _jsxs(DialogContent, { children: [_jsxs(DialogHeader, { children: [_jsxs(DialogTitle, { className: "flex items-center gap-2", children: [_jsx(AlertTriangle, { className: "h-4 w-4 text-amber-500" }), " ", t('engine.edit.destructive', locale)] }), _jsx(DialogDescription, { children: t('engine.edit.destructiveHint', locale) })] }), _jsx("ul", { className: "text-sm space-y-1 max-h-64 overflow-auto", children: destructive?.issues.map((i, idx) => (_jsxs("li", { className: "border-l-2 border-amber-500 pl-2", children: [i.kind && _jsx(Badge, { variant: "outline", className: "mr-2", children: i.kind }), i.message ?? JSON.stringify(i)] }, idx))) }), _jsxs(DialogFooter, { children: [_jsx(Button, { variant: "ghost", onClick: () => setDestructive(null), children: t('engine.cancel', locale) }), _jsxs(Button, { variant: "destructive", onClick: () => destructive && doSave(true, destructive.pending), disabled: saving, children: [saving && _jsx(Loader2, { className: "h-4 w-4 mr-1 animate-spin" }), t('engine.edit.forceSave', locale)] })] })] }) }));
+    if (!withChrome) {
+        return (_jsxs("div", { className: "flex flex-col h-full overflow-hidden", children: [_jsx("div", { className: "flex items-center justify-end gap-1 px-6 pt-3", children: toolbarButtons }), banners, designerArea, destructiveDialog] }));
     }
-    return (_jsxs(PageShell, { entry: entry ?? { type, label: type }, itemName: name, subtitle: t('engine.edit.bespokeDesigner', locale), actions: _jsxs(_Fragment, { children: [_jsxs(Button, { variant: "ghost", size: "sm", onClick: load, disabled: saving, children: [_jsx(RefreshCw, { className: "h-4 w-4 mr-1" }), " ", t('engine.list.refresh', locale)] }), _jsxs(Button, { variant: "ghost", size: "sm", onClick: () => navigate(`./history?type=${encodeURIComponent(type)}`), children: [_jsx(HistoryIcon, { className: "h-4 w-4 mr-1" }), " ", t('engine.edit.history', locale)] }), writable && (_jsxs(Button, { variant: "ghost", size: "sm", onClick: doReset, disabled: saving, children: [_jsx(RotateCcw, { className: "h-4 w-4 mr-1" }), " ", t('engine.edit.reset', locale)] })), writable && (_jsxs(Button, { size: "sm", onClick: () => doSave(false), disabled: saving || !dirty, children: [saving ? (_jsx(Loader2, { className: "h-4 w-4 mr-1 animate-spin" })) : (_jsx(Save, { className: "h-4 w-4 mr-1" })), t('engine.edit.save', locale)] }))] }), children: [_jsxs("div", { className: "flex flex-col h-full overflow-hidden", children: [!writable && (_jsx("div", { className: "mx-6 mt-4 rounded-md border bg-muted/40 px-3 py-2 text-xs text-muted-foreground", children: t('engine.edit.readOnlyHint', locale) })), error && (_jsxs("div", { className: "mx-6 mt-4 rounded-md border border-destructive/40 bg-destructive/5 p-3 text-sm text-destructive flex items-start gap-2", children: [_jsx(AlertTriangle, { className: "h-4 w-4 mt-0.5 shrink-0" }), _jsx("span", { children: error })] })), dirty && writable && (_jsxs("div", { className: "mx-6 mt-3 flex items-center gap-2 rounded-md border border-amber-300/50 bg-amber-50 dark:bg-amber-950/30 px-3 py-1.5 text-xs", children: [_jsx(Badge, { variant: "outline", children: t('engine.edit.unsaved', locale) }), _jsx("span", { children: t('engine.edit.unsavedHint', locale) })] })), _jsx("div", { className: "flex-1 min-h-0 overflow-auto", children: renderDesigner(value, (next) => setValue(next), !writable) })] }), _jsx(Dialog, { open: !!destructive, onOpenChange: (open) => !open && setDestructive(null), children: _jsxs(DialogContent, { children: [_jsxs(DialogHeader, { children: [_jsxs(DialogTitle, { className: "flex items-center gap-2", children: [_jsx(AlertTriangle, { className: "h-4 w-4 text-amber-500" }), " ", t('engine.edit.destructive', locale)] }), _jsx(DialogDescription, { children: t('engine.edit.destructiveHint', locale) })] }), _jsx("ul", { className: "text-sm space-y-1 max-h-64 overflow-auto", children: destructive?.issues.map((i, idx) => (_jsxs("li", { className: "border-l-2 border-amber-500 pl-2", children: [i.kind && _jsx(Badge, { variant: "outline", className: "mr-2", children: i.kind }), i.message ?? JSON.stringify(i)] }, idx))) }), _jsxs(DialogFooter, { children: [_jsx(Button, { variant: "ghost", onClick: () => setDestructive(null), children: t('engine.cancel', locale) }), _jsxs(Button, { variant: "destructive", onClick: () => destructive && doSave(true, destructive.pending), disabled: saving, children: [saving && _jsx(Loader2, { className: "h-4 w-4 mr-1 animate-spin" }), t('engine.edit.forceSave', locale)] })] })] }) })] }));
+    return (_jsxs(PageShell, { entry: entry ?? { type, label: type }, itemName: name, subtitle: t('engine.edit.bespokeDesigner', locale), actions: toolbarButtons, children: [_jsxs("div", { className: "flex flex-col h-full overflow-hidden", children: [banners, designerArea] }), destructiveDialog] }));
 }

package/dist/views/metadata-admin/DirectoryPage.js

@@ -126,7 +126,7 @@ function DomainChip({ domain, label, active, count, onClick, }) {
 function TypeTile({ entry, locale }) {
     // Prefer the locale-table translation; fall back to server's `label` (typically English).
     const label = translateMetadataType(entry.type, locale, entry.label);
-    return (_jsxs(Link, { to: `../component/metadata/resource?type=${encodeURIComponent(entry.type)}`, className: "block p-4 border rounded-lg hover:border-primary hover:bg-accent transition-colors", children: [_jsxs("div", { className: "flex items-start justify-between gap-2", children: [_jsxs("div", { className: "min-w-0 flex-1", children: [_jsx("div", { className: "font-medium truncate", children: label }), _jsx("code", { className: "text-xs text-muted-foreground font-mono", children: entry.type })] }), entry.allowOrgOverride ? (_jsx(Badge, { className: 'text-[10px] shrink-0 ' +
+    return (_jsxs(Link, { to: `./${encodeURIComponent(entry.type)}`, className: "block p-4 border rounded-lg hover:border-primary hover:bg-accent transition-colors", children: [_jsxs("div", { className: "flex items-start justify-between gap-2", children: [_jsxs("div", { className: "min-w-0 flex-1", children: [_jsx("div", { className: "font-medium truncate", children: label }), _jsx("code", { className: "text-xs text-muted-foreground font-mono", children: entry.type })] }), entry.allowOrgOverride ? (_jsx(Badge, { className: 'text-[10px] shrink-0 ' +
                             (entry.overrideSource === 'env'
                                 ? 'bg-amber-100 text-amber-800 hover:bg-amber-100'
                                 : 'bg-emerald-100 text-emerald-800 hover:bg-emerald-100'), title: entry.overrideSource === 'env'

package/dist/views/metadata-admin/EmbeddedItemEditor.d.ts

@@ -0,0 +1,15 @@
+export interface EmbeddedItemEditorProps {
+    parentType: string;
+    parentName: string;
+    /** Dotted path inside parent body where the collection lives. */
+    embeddedPath?: string;
+    /** Key of the item within the collection (e.g. field name). */
+    itemName: string;
+    /** Metadata type whose schema/form drives the form. */
+    editAs?: string;
+    /** Snapshot of the item at the moment of opening (initial draft). */
+    initialRaw: Record<string, unknown>;
+    /** Called after a successful save with the freshly-saved item. */
+    onSaved?: (item: Record<string, unknown>) => void;
+}
+export declare function EmbeddedItemEditor({ parentType, parentName, embeddedPath, itemName, editAs, initialRaw, onSaved, }: EmbeddedItemEditorProps): import("react/jsx-runtime").JSX.Element;