@object-ui/app-shell 6.2.3 → 7.1.0

package/dist/layout/ConsoleFloatingChatbot.js

@@ -12,10 +12,167 @@ import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-run
  * @module
  */
 import React from 'react';
-import { FloatingChatbot, useObjectChat, useAgents, useHitlInChat, } from '@object-ui/plugin-chatbot';
+import { useReconcileOnError } from '../hooks/useReconcileOnError';
+import { FloatingChatbot, useObjectChat, useAgents, useHitlInChat, resolveDefaultAgentName, uiMessagesToChatMessages, publishHealthFromResponse, agentRouteName, } from '@object-ui/plugin-chatbot';
 import { Select, SelectContent, SelectItem, SelectTrigger, SelectValue, Button, ShareDialog, } from '@object-ui/components';
-import { Share2 } from 'lucide-react';
-import { useChatConversation } from '../hooks';
+import { Share2, SquarePen } from 'lucide-react';
+import { useObjectTranslation } from '@object-ui/i18n';
+import { toast } from 'sonner';
+import { useNavigate, useLocation } from 'react-router-dom';
+import { sanitizeChatMessagesForCache, useChatConversation, writeConversationMessagesCache, } from '../hooks';
+import { useAssistant, requestAssistantReview, emitCanvasInvalidate } from '../assistant/assistantBus';
+import { fetchPendingDraftCount } from '../preview/draftStatus';
+import { getRuntimeConfig } from '../runtime-config';
+import { cloudPricingDeepLink } from '../console/marketplace/marketplaceApi';
+import { shouldShowAgentPicker } from './agentPicker';
+/**
+ * Display names for the two built-in platform agents (ADR-0063: `ask` / `build`,
+ * bound by surface). The backend ships English labels ("Assistant" / "Builder");
+ * we localize the known ones here so the whole surface reads natively. Custom
+ * app agents fall back to whatever label the backend provides.
+ *
+ * Keyed by the FRIENDLY name (alias-group head) so the canonical id
+ * (`ask`/`build`) and the legacy alias (`data_chat`/`metadata_assistant`) both
+ * resolve — independent of whatever label the backend record carries.
+ */
+const PLATFORM_AGENT_LABELS = {
+    ask: { zh: '智能助手', en: 'Assistant' },
+    build: { zh: '构建助手', en: 'Build assistant' },
+};
+function localizeAgentLabel(isZh, agentName, fallbackLabel) {
+    const known = agentName ? PLATFORM_AGENT_LABELS[agentRouteName(agentName)] : undefined;
+    if (known)
+        return isZh ? known.zh : known.en;
+    return fallbackLabel;
+}
+/**
+ * Localized UI strings + starter prompts for the floating assistant.
+ * Keeps the chat surface in the user's language and gives non-expert users
+ * concrete things to click instead of a blank input — the modern AI pattern.
+ */
+function buildChatLocale(language, appLabel, agentName, fallbackAgentLabel, objects) {
+    const isZh = (language ?? '').toLowerCase().startsWith('zh');
+    const agentLabel = localizeAgentLabel(isZh, agentName, fallbackAgentLabel);
+    const sampleObjects = objects.slice(0, 2).map((o) => o.label || o.name);
+    if (isZh) {
+        const suggestions = [
+            sampleObjects[0] ? `查询最近创建的${sampleObjects[0]}` : '帮我查询最近的数据',
+            sampleObjects[0] ? `统计${sampleObjects[0]}的总数量` : '统计各对象的记录数量',
+            sampleObjects[1]
+                ? `${sampleObjects[1]}有哪些字段？`
+                : '当前应用里有哪些数据对象？',
+        ].filter(Boolean);
+        return {
+            agentLabel,
+            labels: {
+                emptyTitle: `你好，我是${agentLabel}`,
+                emptyDescription: `随时帮你查询和分析「${appLabel}」中的数据。试试下面的问题，或直接输入你的需求。`,
+                clear: '清空对话',
+                sendHint: '发送',
+                agentActivity: '执行过程',
+                toolCompleted: '已完成',
+                toolRunning: '运行中',
+                toolAwaitingApproval: '等待确认',
+                toolFailed: '失败',
+                connectionWaiting: '正在等待服务器响应…',
+                connectionStalledLabel: '仍在处理中…',
+                connectionOfflineLabel: '网络已断开，正在重连…',
+                toolDetailsHidden: '已隐藏工具参数和原始结果，仅保留过程摘要。',
+                copy: '复制',
+                copied: '已复制',
+                regenerate: '重新生成',
+                model: '模型',
+                submit: '发送',
+                uploadFiles: '上传文件',
+                stopResponse: '停止生成',
+                trace: '调试 trace',
+                viewTrace: '查看调试 trace',
+            },
+            placeholder: `向${agentLabel}提问…`,
+            loadingPlaceholder: '正在加载助手…',
+            title: `${appLabel} 智能助手`,
+            newChat: '开启新对话',
+            share: '分享对话',
+            reviewDraft: (n) => `查看 ${n} 项变更`,
+            publishDrafts: '发布',
+            published: '已发布',
+            nextSteps: '下一步',
+            planTitle: '方案预览',
+            planQuestions: '搭建前请确认',
+            planAssumptions: '假设',
+            planApproveHint: '回复以确认或调整该方案。',
+            planApprove: '开始搭建',
+            planAdjust: '调整方案',
+            planBuilt: '已搭建',
+            planApproveMessage: '就按这个方案搭建吧。',
+            planApproveDefaultsMessage: '就按你的合理假设直接搭建，未决问题用默认即可。',
+            planAnswer: (question, option) => `关于「${question}」，我选择「${option}」。`,
+            publishOk: '已发布，对象已生效。',
+            publishFailed: '发布失败',
+            seedWarn: '已发布，但部分示例数据未能载入。',
+            openBuiltApp: '打开应用',
+            suggestions,
+        };
+    }
+    const suggestions = [
+        sampleObjects[0] ? `Show the latest ${sampleObjects[0]}` : 'Show my most recent records',
+        sampleObjects[0] ? `How many ${sampleObjects[0]} are there?` : 'Count records by status',
+        sampleObjects[1]
+            ? `What fields does ${sampleObjects[1]} have?`
+            : 'What data can I work with here?',
+    ].filter(Boolean);
+    return {
+        agentLabel,
+        labels: {
+            emptyTitle: `Hi, I'm ${agentLabel}`,
+            emptyDescription: `I can help you query and analyze your ${appLabel} data. Try a prompt below, or just type your question.`,
+            clear: 'Clear',
+            sendHint: 'to send',
+            agentActivity: 'Agent activity',
+            toolCompleted: 'Completed',
+            toolRunning: 'Running',
+            toolAwaitingApproval: 'Awaiting approval',
+            toolFailed: 'Failed',
+            connectionWaiting: 'Waiting for server…',
+            connectionStalledLabel: 'Still working…',
+            connectionOfflineLabel: 'Connection lost — reconnecting…',
+            toolDetailsHidden: 'Tool inputs and raw results are hidden in this view.',
+            copy: 'Copy',
+            copied: 'Copied',
+            regenerate: 'Regenerate',
+            model: 'Model',
+            submit: 'Submit',
+            uploadFiles: 'Upload files',
+            stopResponse: 'Stop response',
+            trace: 'trace',
+            viewTrace: 'View trace',
+        },
+        placeholder: `Ask ${agentLabel}...`,
+        loadingPlaceholder: 'Loading assistant...',
+        title: `${appLabel} Assistant`,
+        newChat: 'New chat',
+        share: 'Share conversation',
+        reviewDraft: (n) => `Review ${n} change${n === 1 ? '' : 's'}`,
+        publishDrafts: 'Publish',
+        published: 'Published',
+        nextSteps: "What's next",
+        planTitle: 'Proposed plan',
+        planQuestions: 'Confirm before building',
+        planAssumptions: 'Assumptions',
+        planApproveHint: 'Reply to approve or adjust this plan.',
+        planApprove: 'Build it',
+        planAdjust: 'Adjust',
+        planBuilt: 'Built',
+        planApproveMessage: 'Looks good — build it as proposed.',
+        planApproveDefaultsMessage: 'Build it with your best assumptions; use sensible defaults for the open questions.',
+        planAnswer: (question, option) => `For "${question}", go with: ${option}.`,
+        publishOk: 'Published — objects are now live.',
+        publishFailed: 'Publish failed',
+        seedWarn: 'Published, but some sample data failed to load.',
+        openBuiltApp: 'Open app',
+        suggestions,
+    };
+}
 const DEFAULT_AI_PATH = '/api/v1/ai';
 function resolveApiBase(explicit) {
     if (explicit)
@@ -27,53 +184,139 @@ 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, 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.
+/**
+ * Inner component that owns the chat hook. Re-mounted (via `key`) whenever
+ * the active agent changes so `useObjectChat`'s first-render mode lock
+ * (api vs local) picks up the new endpoint.
+ */
+/**
+ * Starter prompts tailored to the metadata item currently open in a
+ * designer. Returns null when nothing relevant is being edited, so the
+ * caller falls back to the generic agent suggestions.
+ */
+function buildEditorSuggestions(editor, language) {
+    if (!editor || editor.type !== 'object')
+        return null;
+    const subject = editor.label || editor.name || 'this object';
+    const zh = (language ?? '').toLowerCase().startsWith('zh');
+    return zh
+        ? [`为「${subject}」补充字段`, `为「${subject}」建议校验规则`, '添加一个状态选项字段']
+        : [`Add fields to ${subject}`, `Suggest validations for ${subject}`, 'Add a status picklist field'];
+}
+/** Segments after `:appName` that are route prefixes, not object names. */
+const NON_OBJECT_ROUTE_SEGMENTS = new Set([
+    'view', 'record', 'page', 'dashboard', 'design', 'report', 'metadata',
+]);
+/** Decode a URL segment, falling back to the raw value on malformed input. */
+function safeDecodeSegment(value) {
+    try {
+        return decodeURIComponent(value);
+    }
+    catch {
+        return value;
+    }
+}
+/**
+ * Derive the object (and record) the user is currently viewing from the
+ * console URL, so the agent can act on "this object" without the user
+ * restating it. Mirrors the URL layout parsed by `useTrackRouteAsRecent`:
+ *
+ *   /apps/:appName/:objectName
+ *   /apps/:appName/:objectName/:recordId
+ *   /apps/:appName/:objectName/new
+ *
+ * Tolerates an optional shell prefix (e.g. `/_console`) by locating the
+ * `apps` segment dynamically. Returns an empty object when the path isn't an
+ * object route (dashboard/page/report/metadata) or the segment doesn't match
+ * a known object in the current app.
+ */
+function resolveCurrentRouteObject(pathname, objects) {
+    const parts = pathname.split('/').filter(Boolean);
+    const appsIdx = parts.indexOf('apps');
+    // Need at least [apps, appName, objectName].
+    if (appsIdx === -1 || parts.length < appsIdx + 3)
+        return {};
+    const objectSeg = safeDecodeSegment(parts[appsIdx + 2]);
+    if (NON_OBJECT_ROUTE_SEGMENTS.has(objectSeg))
+        return {};
+    if (!objects.some((o) => o.name === objectSeg))
+        return {};
+    const recordSeg = parts[appsIdx + 3] ? safeDecodeSegment(parts[appsIdx + 3]) : undefined;
+    const recordId = recordSeg && recordSeg !== 'new' ? recordSeg : undefined;
+    return { objectName: objectSeg, ...(recordId ? { recordId } : {}) };
+}
+function ChatbotInner({ appLabel, appName, objects, agents, agentsLoading, activeAgent, onAgentChange, showAgentPicker, chatApi, apiBase, defaultOpen = false, conversationId, initialMessages: persistedMessages, }) {
+    const { language } = useObjectTranslation();
+    const navigate = useNavigate();
+    const location = useLocation();
+    // The object/record the user is currently viewing in the runtime console,
+    // derived from the route. Lets the agent answer "analyse this object" and
+    // scope data queries to the open page without the user naming it.
+    const currentRouteObject = React.useMemo(() => resolveCurrentRouteObject(location.pathname, objects), [location.pathname, objects]);
+    // What the user is currently editing in a designer (if any). Merged into
+    // the agent context so "add a priority field" acts on the open object,
+    // and drives context-aware starter suggestions.
+    const { editor } = useAssistant();
+    // Replay persisted history when present.
     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(''),
-        }));
+        return uiMessagesToChatMessages(persistedMessages);
     }, [persistedMessages]);
     const activeAgentLabel = React.useMemo(() => {
         const found = agents.find((a) => a.name === activeAgent);
         return found?.label ?? activeAgent ?? appLabel;
     }, [agents, activeAgent, appLabel]);
-    const welcomeContent = activeAgent
-        ? `Hello! I'm **${activeAgentLabel}**, your ${appLabel} assistant. How can I help you today?`
-        : `Hello! I'm your **${appLabel}** assistant. ${agentsError ? '(Backend unreachable — running in offline demo mode.)' : ''}`;
-    const { messages, isLoading, error, sendMessage, stop, reload, clear, } = useObjectChat({
+    // Localized labels, placeholder, title and contextual starter prompts.
+    const locale = React.useMemo(() => buildChatLocale(language, appLabel, activeAgent, activeAgentLabel, objects), [language, appLabel, activeAgent, activeAgentLabel, objects]);
+    // When a designer is open, prefer starter prompts about that item.
+    const editorSuggestions = React.useMemo(() => buildEditorSuggestions(editor, language), [editor, language]);
+    // ADR-0013 D2: reconcile a stream-transport failure instead of blindly
+    // retrying. Shared across chat surfaces — see useReconcileOnError.
+    const { errorSuppressed, handleChatError, setMessagesRef, resetSuppression } = useReconcileOnError({ chatApi, conversationId });
+    const { messages, isLoading, error, sendMessage, stop, reload, clear, setMessages, } = useObjectChat({
         api: chatApi,
         conversationId,
+        onError: handleChatError,
         body: {
             context: {
                 activeApp: appLabel,
+                appName,
                 objects: objects.map((o) => ({ name: o.name, label: o.label })),
                 agentName: activeAgent,
+                // Publish posture, so the agent's narration matches reality (an
+                // auto-published build is live, not "to publish").
+                autoPublishAiBuilds: getRuntimeConfig().features.autoPublishAiBuilds,
+                // The object/record currently open in the runtime console — the
+                // backend injects its schema and scopes data queries to it, so
+                // "analyse this object" works without the user naming it.
+                ...(currentRouteObject.objectName ? { objectName: currentRouteObject.objectName } : {}),
+                ...(currentRouteObject.recordId ? { recordId: currentRouteObject.recordId } : {}),
+                // The metadata item currently open in a designer, so the agent
+                // can act on "this object/view/…" without the user restating it.
+                ...(editor ? { editing: editor } : {}),
             },
         },
-        initialMessages: hydratedHistory.length > 0
-            ? hydratedHistory
-            : [
-                {
-                    id: 'welcome',
-                    role: 'assistant',
-                    content: welcomeContent,
-                },
-            ],
+        // Start empty so the modern empty-state + starter prompts render. We no
+        // longer inject a synthetic "welcome" bubble — the agent identity now
+        // lives in the empty-state title, matching mainstream AI tools.
+        initialMessages: hydratedHistory,
         // Local-mode fallback: only used when `chatApi` is undefined (no agent
         // resolved yet, or no backend available). Keeps the UI usable.
         autoResponse: !chatApi,
-        autoResponseText: objectNames
-            ? `I can help you work with ${objectNames}. What would you like to do?`
+        autoResponseText: objects.length > 0
+            ? `I can help you work with ${objects
+                .map((o) => o.label || o.name)
+                .join(', ')}. What would you like to do?`
             : "Thanks for your message! I'm here to help you navigate and manage your data.",
         autoResponseDelay: 600,
     });
+    React.useEffect(() => {
+        setMessagesRef.current = setMessages;
+    }, [setMessages]);
+    React.useEffect(() => {
+        writeConversationMessagesCache(conversationId, sanitizeChatMessagesForCache(messages));
+    }, [conversationId, messages]);
     // HITL bridge — turns the pending-approval tool result envelope from the
     // framework's action-tools.ts into inline approve/reject buttons that talk
     // directly to /api/v1/ai/pending-actions/:id/{approve,reject}. After a
@@ -83,40 +326,145 @@ function ChatbotInner({ appLabel, objects, agents, agentsLoading, agentsError, a
         messages: messages,
         apiBase,
         continueConversation: (prompt) => {
+            resetSuppression();
             sendMessage(prompt);
         },
     });
-    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;
+    // Agent switcher — Ask ↔ Build (plus any custom agents). Restrained by
+    // design: end users bound to a single agent never see it. `showAgentPicker`
+    // is true when AI development is unlocked (catalog serves both ask & build)
+    // or forced on; it still needs more than one agent to be a real choice.
+    const headerExtra = showAgentPicker && agents.length > 1 ? (_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;
     // 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: {
+    const headerActions = (_jsxs(_Fragment, { children: [messages.length > 0 ? (_jsx(Button, { variant: "ghost", size: "icon", className: "h-7 w-7", "aria-label": locale.newChat, title: locale.newChat, "data-testid": "floating-chatbot-new", onClick: clear, children: _jsx(SquarePen, { className: "h-4 w-4" }) })) : null, conversationId ? (_jsx(Button, { variant: "ghost", size: "icon", className: "h-7 w-7", "aria-label": locale.share, title: locale.share, "data-testid": "floating-chatbot-share", onClick: () => setShareOpen(true), children: _jsx(Share2, { className: "h-4 w-4" }) })) : null] }));
+    return (_jsxs(_Fragment, { children: [_jsx(FloatingChatbot, { onUpgrade: () => window.open(cloudPricingDeepLink(), '_blank', 'noopener,noreferrer'), floatingConfig: {
                     position: 'bottom-right',
                     defaultOpen,
                     panelWidth: 420,
                     panelHeight: 560,
-                    title: `${appLabel} Assistant`,
+                    title: locale.title,
                     triggerSize: 56,
-                }, headerExtra: headerExtra, headerActions: headerActions, messages: messages, placeholder: activeAgent
-                    ? `Ask ${activeAgentLabel}...`
+                }, headerExtra: headerExtra, headerActions: headerActions, messages: messages, labels: locale.labels, showAvatars: true, hideClearBar: true, assistantAvatarFallback: locale.agentLabel, suggestions: messages.length === 0 ? (editorSuggestions ?? locale.suggestions) : undefined, placeholder: activeAgent
+                    ? locale.placeholder
                     : 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 }))] }));
+                        ? locale.loadingPlaceholder
+                        : locale.placeholder, onSendMessage: (content) => { resetSuppression(); sendMessage(content); }, onClear: clear, onStop: isLoading ? stop : undefined, onReload: reload, isLoading: isLoading, error: errorSuppressed ? undefined : error, enableMarkdown: true, onToolApprove: hitl.decide, toolDecisions: hitl.decisions, toolApproveLabel: "Approve & run", toolDenyLabel: "Reject", toolDenyReason: "Operator rejected from chat", onReviewDraft: (items) => {
+                    // ADR-0033 Phase B: open the first drafted item in the designer's
+                    // review/diff. The remaining items stay drafted and surface their
+                    // own review when opened. The host navigator (AppContent) knows the
+                    // app base and performs the routing.
+                    if (items[0])
+                        requestAssistantReview(items[0]);
+                }, toolReviewLabel: locale.reviewDraft, 
+                // Build-tree "Open app": jump straight into the app the agent just
+                // built (the panel only shows this once the build reports done).
+                onOpenBuiltApp: (appName) => navigate(`/apps/${encodeURIComponent(appName)}`), openBuiltAppLabel: locale.openBuiltApp, 
+                // ADR-0037: see the drafted app as-if-published before Publish — same
+                // route, draft overlay, watermark bar on top.
+                onPreviewDraftApp: (appName, opts) => navigate(
+                // ADR-0045: a materialized build is a REAL (unlisted) app — open it
+                // directly; the UnpublishedAppBar narrates. Drafts keep the overlay.
+                opts?.materialized
+                    ? `/apps/${encodeURIComponent(appName)}`
+                    : `/apps/${encodeURIComponent(appName)}?preview=draft`), 
+                // ADR-0037 P2.5: announce drafted artifacts so an open ?preview=draft
+                // page (same document) drops its cache and refetches the new draft.
+                onDraftArtifacts: (artifacts) => {
+                    for (const a of artifacts)
+                        emitCanvasInvalidate(a);
+                }, 
+                // Live lifecycle truth for draft cards: the server's pending count per
+                // package, so reloaded conversations show Published/Publish honestly.
+                fetchPendingDraftCount: fetchPendingDraftCount, onPublishDrafts: async (packageId) => {
+                    // ADR-0033 — promote the conversation's staged drafts to live in one
+                    // click (the human still confirms here). Mirrors PackagesPage's
+                    // publish-drafts call; cookie-authenticated like the rest of the SPA.
+                    try {
+                        const res = await fetch(`/api/v1/packages/${encodeURIComponent(packageId)}/publish-drafts`, {
+                            method: 'POST',
+                            credentials: 'include',
+                            headers: { 'Content-Type': 'application/json', Accept: 'application/json' },
+                            body: '{}',
+                        });
+                        const payload = await res.json().catch(() => null);
+                        if (!res.ok || payload?.success === false) {
+                            throw new Error(payload?.error?.message || `HTTP ${res.status}`);
+                        }
+                        const failed = payload?.data?.failedCount ?? payload?.failedCount ?? 0;
+                        if (failed)
+                            throw new Error(String(failed));
+                        // The protocol materializes published `seed` rows and reports under
+                        // `seedApplied` — a data problem never fails the publish, so it
+                        // must be surfaced HERE or the user lands on an app with silently
+                        // empty tables (the staging "No rows" incident).
+                        const seedApplied = payload?.data?.seedApplied ?? payload?.seedApplied;
+                        if (seedApplied && seedApplied.success === false) {
+                            toast.warning(locale.seedWarn, {
+                                description: seedApplied.error ??
+                                    (Array.isArray(seedApplied.errors) && seedApplied.errors.length
+                                        ? String(seedApplied.errors[0])
+                                        : undefined),
+                            });
+                        }
+                        else {
+                            toast.success(locale.publishOk);
+                        }
+                        // Publish & Open: land the user ON the thing they just built rather
+                        // than leaving them on an empty home with only a toast. Prefer the
+                        // published App (a full navigable surface); the bare-object case has
+                        // no app to open yet, so the toast is the only feedback there.
+                        const published = payload?.data?.published ?? payload?.published ?? [];
+                        const app = published.find((p) => p?.type === 'app' && p?.name);
+                        if (app?.name)
+                            navigate(`/apps/${encodeURIComponent(app.name)}`);
+                        // ADR-0038 L3 — hand the runtime verification (seedApplied +
+                        // probes) back to the chat so the Published card grows a
+                        // build-health line instead of claiming bare success.
+                        return { ok: true, health: publishHealthFromResponse(payload) };
+                    }
+                    catch (e) {
+                        toast.error(locale.publishFailed, {
+                            description: e instanceof Error ? e.message : undefined,
+                        });
+                        return false;
+                    }
+                }, publishDraftsLabel: locale.publishDrafts, nextStepsLabel: locale.nextSteps, planTitleLabel: locale.planTitle, planQuestionsLabel: locale.planQuestions, planAssumptionsLabel: locale.planAssumptions, planApproveHintLabel: locale.planApproveHint, planApproveLabel: locale.planApprove, planAdjustLabel: locale.planAdjust, planBuiltLabel: locale.planBuilt, planApproveMessage: locale.planApproveMessage, planApproveDefaultsMessage: locale.planApproveDefaultsMessage, planAnswerMessage: locale.planAnswer, publishedLabel: locale.published, 
+                // Self-use "magic moment": when the plan enables it, auto-publish the
+                // drafted app the instant the agent finishes — the success path above
+                // then navigates straight to the live app, so "build" lands the user on
+                // a populated, running app with no manual Publish click.
+                autoPublishDrafts: getRuntimeConfig().features.autoPublishAiBuilds }), 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, }) {
+export default function ConsoleFloatingChatbot({ appLabel, appName, objects, apiBase: apiBaseProp, defaultAgent: defaultAgentProp, showAgentPicker: showAgentPickerProp, defaultOpen = false, userId, }) {
     const apiBase = React.useMemo(() => resolveApiBase(apiBaseProp), [apiBaseProp]);
     const env = import.meta.env ?? {};
     const envDefaultAgent = env.VITE_AI_DEFAULT_AGENT;
     const { agents, isLoading: agentsLoading, error: agentsError } = useAgents({ apiBase });
+    // Reveal the Build/Ask switcher only when AI development is unlocked for this
+    // viewer — the live catalog serves BOTH an `ask` and a `build` agent and
+    // authoring isn't deployment-disabled. Pure end-user apps (only `ask`) stay
+    // clean; builders can flip "ask about my data" ↔ "extend my app" inline. An
+    // explicit prop or `VITE_AI_SHOW_AGENT_PICKER` still forces it. See agentPicker.
+    const showAgentPicker = shouldShowAgentPicker({
+        agents,
+        showAgentPickerProp,
+        envOptIn: env.VITE_AI_SHOW_AGENT_PICKER === 'true',
+        aiStudioEnabled: getRuntimeConfig().features.aiStudio !== false,
+    });
     const [activeAgent, setActiveAgent] = React.useState(undefined);
     React.useEffect(() => {
         if (!activeAgent && agents.length > 0) {
+            // Mirror the backend's resolution: app.defaultAgent → data_chat →
+            // first agent. This binds the right copilot per app instead of
+            // landing on whichever agent happens to be first in the catalog.
             const preferred = defaultAgentProp ?? envDefaultAgent;
-            const match = preferred ? agents.find((a) => a.name === preferred) : undefined;
-            setActiveAgent((match ?? agents[0]).name);
+            const resolved = resolveDefaultAgentName(agents, preferred);
+            if (resolved)
+                setActiveAgent(resolved);
         }
     }, [agents, activeAgent, defaultAgentProp, envDefaultAgent]);
     const chatApi = activeAgent
@@ -124,14 +472,16 @@ export default function ConsoleFloatingChatbot({ appLabel, objects, apiBase: api
         : undefined;
     // 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).
+    // the FAB continues to work in local-only mode (no persistence). Gate `userId`
+    // on the agent being resolved so the conversation binds to the right scope
+    // from the first resolve (not a scopeless one during the catalog load).
     const { conversationId, initialMessages } = useChatConversation({
-        userId,
+        userId: activeAgent ? userId : undefined,
         scope: activeAgent,
         apiBase,
     });
     // `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, initialMessages: initialMessages }, `${chatApi ?? 'local'}:${conversationId ?? 'pending'}`));
+    return (_jsx(ChatbotInner, { appLabel: appLabel, appName: appName, objects: objects, agents: agents, agentsLoading: agentsLoading, agentsError: agentsError, activeAgent: activeAgent, onAgentChange: setActiveAgent, showAgentPicker: showAgentPicker, chatApi: chatApi, apiBase: apiBase, defaultOpen: defaultOpen, conversationId: conversationId, initialMessages: initialMessages }, `${chatApi ?? 'local'}:${conversationId ?? 'pending'}`));
 }

package/dist/layout/ConsoleLayout.d.ts

@@ -23,5 +23,5 @@ interface ConsoleLayoutProps {
     userId?: string;
 }
 /** Floating chatbot wired with useObjectChat for demo auto-response */
-export declare function ConsoleLayout({ children, activeAppName, activeApp, onAppChange, objects, connectionState, userId, }: ConsoleLayoutProps): import("react/jsx-runtime").JSX.Element;
+export declare function ConsoleLayout({ children, activeAppName, activeApp, onAppChange, objects, connectionState, userId, }: ConsoleLayoutProps): React.JSX.Element;
 export {};

package/dist/layout/ConsoleLayout.js

@@ -11,16 +11,21 @@ import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-run
 import { useEffect } from 'react';
 import { AppShell } from '@object-ui/layout';
 import { useDiscovery } from '@object-ui/react';
+import { isBuildAgent } from '@object-ui/plugin-chatbot';
 // Lightweight FAB stub — the heavy chat chunk graph (plugin-chatbot,
 // shiki, streamdown, mermaid, @ai-sdk, ~20MB) only downloads on first
 // hover/click. See ConsoleChatbotFab.tsx.
 import { ConsoleChatbotFab } from './ConsoleChatbotFab';
+import { DraftPreviewBar } from '../preview/DraftPreviewBar';
+import { UnpublishedAppBar } from '../preview/UnpublishedAppBar';
 import { UnifiedSidebar } from './UnifiedSidebar';
 import { AppHeader } from './AppHeader';
 import { MobileViewSwitcherProvider } from './MobileViewSwitcherContext';
 import { useResponsiveSidebar } from '../hooks/useResponsiveSidebar';
 import { useNavigationContext } from '../context/NavigationContext';
+import { CommandPaletteProvider } from '../context/CommandPaletteProvider';
 import { resolveI18nLabel } from '../utils';
+import { getProductName, getRuntimeConfig } from '../runtime-config';
 /** Inner component that can access SidebarProvider context */
 function ConsoleLayoutInner({ children }) {
     useResponsiveSidebar();
@@ -35,21 +40,32 @@ export function ConsoleLayout({ children, activeAppName, activeApp, onAppChange,
     // AI as disabled (e.g. framework started without `--preset full`).
     const aiBaseUrlConfigured = Boolean(import.meta.env?.VITE_AI_BASE_URL);
     const showChatbot = isAiEnabled || aiBaseUrlConfigured;
+    // AI Studio (AI-driven metadata authoring / "online development") can be
+    // turned off per deployment. When off, suppress the metadata-authoring
+    // assistant so the chatbot falls back to the generic data assistant — the
+    // generic data-chat experience stays available.
+    const aiStudioEnabled = getRuntimeConfig().features.aiStudio !== false;
+    // Alias-aware: the build/authoring agent is `build` (new) or
+    // `metadata_assistant` (legacy). When AI Studio is off, drop it so the FAB
+    // falls back to the generic data assistant.
+    const effectiveDefaultAgent = !aiStudioEnabled && isBuildAgent(activeApp?.defaultAgent)
+        ? undefined
+        : activeApp?.defaultAgent;
     const { setContext, setCurrentAppName } = useNavigationContext();
     // Set navigation context to 'app' when this layout mounts
     useEffect(() => {
         setContext('app');
         setCurrentAppName(activeAppName);
     }, [setContext, setCurrentAppName, activeAppName]);
-    return (_jsx(MobileViewSwitcherProvider, { children: _jsxs(AppShell, { sidebar: _jsx(UnifiedSidebar, { activeAppName: activeAppName, onAppChange: onAppChange }), navbar: _jsx(AppHeader, { variant: "app", appName: appLabel, objects: objects, connectionState: connectionState, activeAppName: activeAppName, onAppChange: onAppChange }), className: "!p-0 overflow-y-auto overflow-x-hidden bg-muted/5", branding: activeApp?.branding
-                ? {
-                    primaryColor: activeApp.branding.primaryColor,
-                    accentColor: activeApp.branding.accentColor,
-                    favicon: activeApp.branding.favicon,
-                    logo: activeApp.branding.logo,
-                    title: activeApp.label
-                        ? `${resolveI18nLabel(activeApp.label)} — ObjectStack Console`
-                        : undefined,
-                }
-                : undefined, children: [_jsx(ConsoleLayoutInner, { children: children }), showChatbot && (_jsx(ConsoleChatbotFab, { appLabel: appLabel, objects: objects, userId: userId }))] }) }));
+    return (_jsx(CommandPaletteProvider, { children: _jsx(MobileViewSwitcherProvider, { children: _jsxs(AppShell, { sidebar: _jsx(UnifiedSidebar, { activeAppName: activeAppName, onAppChange: onAppChange }), navbar: _jsx(AppHeader, { variant: "app", appName: appLabel, objects: objects, connectionState: connectionState, activeAppName: activeAppName, onAppChange: onAppChange }), className: "!p-0 overflow-y-auto overflow-x-hidden bg-muted/5", branding: activeApp?.branding
+                    ? {
+                        primaryColor: activeApp.branding.primaryColor,
+                        accentColor: activeApp.branding.accentColor,
+                        favicon: activeApp.branding.favicon,
+                        logo: activeApp.branding.logo,
+                        title: activeApp.label
+                            ? `${resolveI18nLabel(activeApp.label)} — ${getProductName()}`
+                            : undefined,
+                    }
+                    : undefined, children: [_jsxs(ConsoleLayoutInner, { children: [_jsx(DraftPreviewBar, {}), _jsx(UnpublishedAppBar, {}), children] }), showChatbot && (_jsx(ConsoleChatbotFab, { appLabel: appLabel, appName: activeAppName, defaultAgent: effectiveDefaultAgent, objects: objects, userId: userId }))] }) }) }));
 }

package/dist/layout/ContextSelectors.d.ts

@@ -0,0 +1,44 @@
+/**
+ * AppContextSelectors — renders the app-level "scope" dropdowns declared
+ * in `App.contextSelectors` (e.g. the Studio package filter) and exposes
+ * their current values so the sidebar can feed them into
+ * `NavigationRenderer`'s `templateContext.contextValues`.
+ *
+ * Each selector's value is published under its `id` and referenced by
+ * nav items as `{<id>}` (e.g. `{active_package}`), exactly like the
+ * built-in `{current_user_id}` / `{current_org_id}` template vars.
+ * Selecting an option therefore transparently scopes every child nav
+ * item — no per-item wiring required.
+ *
+ * @module
+ */
+import * as React from 'react';
+export interface ContextSelectorFilter {
+    key: string;
+    op?: 'eq' | 'ne' | 'in' | 'nin';
+    value: string | string[];
+}
+export interface ContextSelectorDef {
+    id: string;
+    label?: unknown;
+    icon?: string;
+    optionsSource: {
+        endpoint: string;
+        valueKey?: string;
+        labelKey?: string;
+        filter?: ContextSelectorFilter[];
+    };
+    includeAll?: boolean;
+    allValue?: string;
+    persist?: 'query' | 'session' | 'none';
+    placement?: 'sidebar_header' | 'topbar';
+}
+/**
+ * Hook: resolves the active values for an app's context selectors and
+ * returns a ready-to-render UI element plus the `contextValues` map for
+ * `NavigationRenderer`.
+ */
+export declare function useAppContextSelectors(appName: string, selectors: ContextSelectorDef[] | undefined, t?: (key: string, options?: any) => string): {
+    contextValues: Record<string, string>;
+    element: React.ReactNode;
+};