@object-ui/app-shell 6.2.1 → 6.2.2

package/CHANGELOG.md

@@ -1,5 +1,47 @@
 # @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

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/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;

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

@@ -0,0 +1,194 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.
+/**
+ * EmbeddedItemEditor — full-form editor for items that live INSIDE a
+ * parent metadata body (e.g. `object.fields.email`).
+ *
+ * Embedded items don't have their own HTTP endpoint (`PUT /meta/field/email`
+ * does NOT exist for object-scoped fields) — so we:
+ *   1. Re-fetch the parent's effective body.
+ *   2. Render a SchemaForm using the registered sub-type's schema / form
+ *      (e.g. `field` for `object.fields`).
+ *   3. On save: deep-clone the parent, splice the modified item back
+ *      under `parent.<embeddedPath>.<itemName>`, and PUT the parent.
+ *
+ * If the sub-type isn't registered (e.g. `index` has no `editAs`), we
+ * fall back to a raw-JSON editor so users can still hand-edit and save.
+ */
+import * as React from 'react';
+import { Loader2, Save, AlertTriangle } from 'lucide-react';
+import { Button } from '@object-ui/components';
+import { SchemaForm } from './SchemaForm';
+import { useMetadataClient, useMetadataTypes } from './useMetadata';
+export function EmbeddedItemEditor({ parentType, parentName, embeddedPath, itemName, editAs, initialRaw, onSaved, }) {
+    const client = useMetadataClient();
+    const { entries } = useMetadataTypes(client);
+    const subEntry = editAs ? entries.find((e) => e.type === editAs) : undefined;
+    // Fallback inline schemas for sub-types the framework registers without
+    // a JSON-Schema (validation / index live in object.body but the
+    // registry only exposes their metadata, not their shape). The
+    // schemas below mirror the framework's Zod definitions and the
+    // shapes we see on disk under packages/data-objectstack fixtures.
+    const fallback = !subEntry?.schema && editAs ? FALLBACK_SCHEMAS[editAs] : undefined;
+    const schema = subEntry?.schema ?? fallback?.schema;
+    const form = subEntry?.form ?? fallback?.form;
+    const [draft, setDraft] = React.useState(initialRaw);
+    const [saving, setSaving] = React.useState(false);
+    const [error, setError] = React.useState(null);
+    const [issues, setIssues] = React.useState([]);
+    const [savedAt, setSavedAt] = React.useState(null);
+    // Resync if a different item is opened in the drawer.
+    React.useEffect(() => {
+        setDraft(initialRaw);
+        setError(null);
+        setIssues([]);
+        setSavedAt(null);
+    }, [initialRaw, itemName, parentType, parentName]);
+    const readOnly = subEntry != null && !subEntry.allowOrgOverride;
+    async function doSave() {
+        if (!embeddedPath) {
+            setError('Cannot save: this item has no embeddedPath registered.');
+            return;
+        }
+        setSaving(true);
+        setError(null);
+        setIssues([]);
+        try {
+            // 1. Re-fetch parent to avoid clobbering concurrent edits.
+            const layered = await client.layered(parentType, parentName);
+            const parent = (layered.effective ?? layered.code ?? {});
+            // 2. Splice modified item back into the parent collection.
+            const updated = spliceEmbedded(parent, embeddedPath, itemName, draft);
+            // 3. PUT the parent.
+            await client.save(parentType, parentName, updated);
+            setSavedAt(Date.now());
+            onSaved?.(draft);
+        }
+        catch (err) {
+            // Validation issues from the parent save apply to the embedded
+            // path. Try to scope them back to this item.
+            if (err?.status === 422 || err?.code === 'invalid_metadata' || err?.code === 'invalid_payload') {
+                const raw = err?.body?.issues ?? [];
+                const mapped = (Array.isArray(raw) ? raw : []).map((x) => {
+                    const fullPath = Array.isArray(x.path) ? x.path.join('.') : String(x.path ?? '');
+                    // Trim the `<embeddedPath>.<itemName>.` prefix so issues
+                    // align with the field they reference inside the sub-form.
+                    const prefix = `${embeddedPath}.${itemName}.`;
+                    const trimmed = fullPath.startsWith(prefix)
+                        ? fullPath.slice(prefix.length)
+                        : fullPath;
+                    return { path: trimmed, message: String(x.message ?? 'Invalid') };
+                });
+                setIssues(mapped);
+                setError(`Validation failed (${mapped.length} issue${mapped.length === 1 ? '' : 's'}).`);
+            }
+            else {
+                setError(err?.message ?? String(err));
+            }
+        }
+        finally {
+            setSaving(false);
+        }
+    }
+    // No schema registered for this sub-type: fall back to JSON editing.
+    if (!schema) {
+        return (_jsxs("div", { className: "p-4 space-y-3", children: [_jsxs("div", { className: "text-xs text-muted-foreground", children: ["No form schema is registered for", ' ', _jsx("code", { className: "font-mono", children: editAs ?? 'this item' }), ". Edit the raw JSON below; saving will splice it back into", ' ', _jsxs("span", { className: "font-mono", children: [parentType, "/", parentName, ".", embeddedPath, ".", itemName] }), "."] }), _jsx("textarea", { className: "w-full h-[60vh] font-mono text-xs border rounded p-3 bg-muted/30", value: JSON.stringify(draft, null, 2), onChange: (e) => {
+                        try {
+                            setDraft(JSON.parse(e.target.value));
+                            setError(null);
+                        }
+                        catch (err) {
+                            setError(`Invalid JSON: ${err.message}`);
+                        }
+                    } }), error && (_jsxs("div", { className: "text-sm text-destructive border border-destructive/30 rounded p-2 bg-destructive/5", children: [_jsx(AlertTriangle, { className: "h-4 w-4 inline mr-1" }), " ", error] })), _jsx("div", { className: "flex justify-end", children: _jsxs(Button, { onClick: doSave, disabled: saving || !embeddedPath, children: [saving ? (_jsx(Loader2, { className: "h-4 w-4 mr-1 animate-spin" })) : (_jsx(Save, { className: "h-4 w-4 mr-1" })), "Save into parent"] }) })] }));
+    }
+    return (_jsxs("div", { className: "p-4 space-y-4", children: [error && (_jsx("div", { className: "text-sm text-destructive border border-destructive/30 rounded p-3 bg-destructive/5", children: error })), savedAt != null && !error && (_jsx("div", { className: "text-sm text-emerald-700 border border-emerald-300 bg-emerald-50 rounded p-2", children: "Saved." })), readOnly && (_jsx("div", { className: "text-xs text-amber-800 border border-amber-300 bg-amber-50 rounded p-2", children: "The parent type is read-only \u2014 saving will still attempt a PUT and may be refused by the server." })), _jsx(SchemaForm, { schema: schema, form: form, value: draft, onChange: setDraft, issues: issues }), _jsx("div", { className: "flex justify-end gap-2 pt-2 border-t", children: _jsxs(Button, { onClick: doSave, disabled: saving || !embeddedPath, children: [saving ? (_jsx(Loader2, { className: "h-4 w-4 mr-1 animate-spin" })) : (_jsx(Save, { className: "h-4 w-4 mr-1" })), "Save into ", parentType] }) }), !embeddedPath && (_jsxs("div", { className: "text-xs text-muted-foreground border rounded p-3", children: [_jsx("div", { className: "font-medium", children: "Read-only" }), _jsx("div", { children: "No embedded path registered \u2014 cannot determine where to write this item back." })] }))] }));
+}
+/**
+ * Return a NEW parent object with the embedded item replaced. The
+ * collection at `path` may be either a name-keyed map (`object.fields`)
+ * or an array of `{ name, … }` entries (`object.indexes`); we keep the
+ * existing shape.
+ */
+function spliceEmbedded(parent, path, itemName, item) {
+    const segs = path.split('.');
+    const next = structuredClone(parent);
+    let cur = next;
+    for (let i = 0; i < segs.length - 1; i++) {
+        if (cur[segs[i]] == null)
+            cur[segs[i]] = {};
+        cur = cur[segs[i]];
+    }
+    const leaf = segs[segs.length - 1];
+    const existing = cur[leaf];
+    if (Array.isArray(existing)) {
+        const idx = existing.findIndex((x) => x && typeof x === 'object' && x.name === itemName);
+        if (idx >= 0) {
+            existing[idx] = item;
+        }
+        else {
+            existing.push(item);
+        }
+    }
+    else if (existing && typeof existing === 'object') {
+        // Strip the synthetic `name` we injected when extracting the map.
+        const { name: _n, ...rest } = item;
+        existing[itemName] = rest;
+    }
+    else {
+        // Path didn't exist — initialise as a map keyed by item name.
+        const { name: _n, ...rest } = item;
+        cur[leaf] = { [itemName]: rest };
+    }
+    return next;
+}
+/**
+ * Inline JSONSchema + form-spec fallbacks for sub-types that the
+ * framework's `/meta` registry doesn't expose a `schema`/`form` for.
+ *
+ * `index` is the only one we still need to ship here: it's an
+ * embedded-only sub-type (lives inside `object.indexes[]`) and is not
+ * registered as a standalone metadata type, so the server has no slot
+ * to publish a schema for it. Once / if the framework grows an
+ * embedded-sub-type registry, this can move server-side too.
+ *
+ * `validation` used to be here but is now published by the server via
+ * `HAND_CRAFTED_SCHEMAS.validation` in `objectql/protocol.ts`.
+ */
+const FALLBACK_SCHEMAS = {
+    index: {
+        schema: {
+            type: 'object',
+            required: ['fields'],
+            properties: {
+                name: {
+                    type: 'string',
+                    title: 'Name',
+                    description: 'Synthesised from columns if omitted (e.g. idx_email).',
+                },
+                fields: {
+                    type: 'array',
+                    title: 'Fields',
+                    description: 'Columns to index, in order.',
+                    items: { type: 'string' },
+                },
+                type: {
+                    type: 'string',
+                    title: 'Algorithm',
+                    enum: ['btree', 'hash', 'gin', 'gist', 'brin'],
+                    default: 'btree',
+                },
+                unique: {
+                    type: 'boolean',
+                    title: 'Unique',
+                    description: 'Enforce uniqueness across the indexed columns.',
+                },
+                where: {
+                    type: 'string',
+                    title: 'Partial-index predicate',
+                    description: 'Optional WHERE clause for a partial index.',
+                },
+            },
+        },
+    },
+};

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

@@ -1,23 +1,9 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.
-/**
- * MetadataDetailDrawer — slide-over editor for a related metadata item.
- *
- * Opens from the parent's Related tab without taking the user away
- * from the parent's context. Internally we mount the same
- * `MetadataResourceEditPage` used by the full-page route, so all the
- * Save / Reset / Validate behaviour is shared. The drawer just frames
- * it and adds a "Open full page ↗" affordance.
- *
- * Width is wide enough for forms (max 1100px) but capped at 92vw to
- * leave a thin strip of the parent visible behind, reinforcing the
- * "still in the same object" feel.
- */
-import * as React from 'react';
 import { useNavigate } from 'react-router-dom';
 import { ExternalLink } from 'lucide-react';
 import { Sheet, SheetContent, SheetHeader, SheetTitle, SheetDescription, Button, Badge, cn, } from '@object-ui/components';
 import { MetadataResourceEditPage } from './ResourceEditPage';
+import { EmbeddedItemEditor } from './EmbeddedItemEditor';
 export function MetadataDetailDrawer({ target, onClose, parentContext, }) {
     const navigate = useNavigate();
     const isMetadata = target?.kind === 'metadata';
@@ -38,15 +24,5 @@ export function MetadataDetailDrawer({ target, onClose, parentContext, }) {
         }, children: _jsxs(SheetContent, { side: "right", className: cn('w-[92vw] sm:max-w-[1100px] p-0 flex flex-col gap-0'), children: [_jsxs(SheetHeader, { className: "px-4 py-3 border-b space-y-1", children: [_jsxs("div", { className: "flex items-center gap-2", children: [_jsx(Badge, { variant: "outline", className: "font-mono text-[10px]", children: headerType }), _jsx(SheetTitle, { className: "font-mono text-base truncate", children: headerName }), _jsx("div", { className: "ml-auto flex items-center gap-1", children: isMetadata && (_jsxs(Button, { variant: "ghost", size: "sm", onClick: () => {
                                             navigate(`../../${encodeURIComponent(target.type)}/${encodeURIComponent(target.name)}`);
                                             onClose();
-                                        }, title: "Open in full page", children: [_jsx(ExternalLink, { className: "h-3.5 w-3.5 mr-1" }), "Open full page"] })) })] }), parentContext && (_jsxs(SheetDescription, { className: "text-xs", children: [isEmbedded ? 'Embedded in ' : 'Related to ', _jsxs("span", { className: "font-mono", children: [parentContext.type, "/", parentContext.name] })] }))] }), _jsxs("div", { className: "flex-1 min-h-0 overflow-auto", children: [isMetadata && (_jsx(MetadataResourceEditPage, { type: target.type, name: target.name, embedded: true }, `${target.type}/${target.name}`)), isEmbedded && _jsx(EmbeddedItemView, { raw: target.raw })] })] }) }));
-}
-/**
- * Read-only JSON preview for embedded items (fields, indexes, embedded
- * validations). Editing happens via the parent's Form tab; jumping
- * straight to that field is a future enhancement — for now the user
- * can inspect the spec here and click "Edit in Form tab" in the panel.
- */
-function EmbeddedItemView({ raw }) {
-    const json = React.useMemo(() => JSON.stringify(raw, null, 2), [raw]);
-    return (_jsxs("div", { className: "p-4 space-y-3", children: [_jsxs("div", { className: "text-xs text-muted-foreground", children: ["This item lives inside its parent's body. Edit it in the parent's", ' ', _jsx("span", { className: "font-medium", children: "Form" }), " tab."] }), _jsx("pre", { className: "text-xs font-mono bg-muted/40 border rounded p-3 overflow-auto whitespace-pre-wrap break-all", children: json })] }));
+                                        }, title: "Open in full page", children: [_jsx(ExternalLink, { className: "h-3.5 w-3.5 mr-1" }), "Open full page"] })) })] }), parentContext && (_jsxs(SheetDescription, { className: "text-xs", children: [isEmbedded ? 'Embedded in ' : 'Related to ', _jsxs("span", { className: "font-mono", children: [parentContext.type, "/", parentContext.name] })] }))] }), _jsxs("div", { className: "flex-1 min-h-0 overflow-auto", children: [isMetadata && (_jsx(MetadataResourceEditPage, { type: target.type, name: target.name, embedded: true }, `${target.type}/${target.name}`)), isEmbedded && (_jsx(EmbeddedItemEditor, { parentType: target.parentType, parentName: target.parentName, embeddedPath: target.embeddedPath, itemName: target.itemName, editAs: target.editAs, initialRaw: target.raw }, `${target.parentType}/${target.parentName}/${target.embeddedPath}/${target.itemName}`))] })] }) }));
 }

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

@@ -29,5 +29,9 @@ export type RelatedTarget = {
     groupLabel: string;
     itemName: string;
     raw: Record<string, unknown>;
+    /** Metadata type whose schema drives the editor (e.g. 'field'). */
+    editAs?: string;
+    /** Dotted path inside parent where this collection lives (e.g. 'fields'). */
+    embeddedPath?: string;
 };
 export declare function RelatedPanel({ type, name, parentItem, onOpen, }: RelatedPanelProps): import("react/jsx-runtime").JSX.Element;

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

@@ -142,6 +142,8 @@ export function RelatedPanel({ type, name, parentItem, onOpen, }) {
                                                 groupLabel: g.anchor.groupLabel ?? g.childType,
                                                 itemName: it.name,
                                                 raw: it.raw,
+                                                editAs: g.anchor.editAs,
+                                                embeddedPath: g.anchor.embeddedPath,
                                             }
                                             : {
                                                 kind: 'metadata',