@elytracms/studio 0.0.44 → 0.0.46

package/convex/cms.ts

@@ -1,4 +1,6 @@
 import { v } from 'convex/values'
+import { foldDocument, unfoldDocument } from '@elytracms/core/cms-core'
+import type { CmsDocument } from '@elytracms/core/cms-core'
 import { mutation, query } from './functions'
 import { requireCapability } from './guard'
 
@@ -9,8 +11,29 @@ import { requireCapability } from './guard'
  * table and no schema read/write function here. Collection-membership
  * validation lives in `@elytracms/core/cms-core` `validateDocument` (the studio runs it
  * pre-dispatch); this layer is a pure document store.
+ *
+ * ## EC-260 depth-budget codec (the storage boundary)
+ *
+ * Convex caps STORED documents at 16 nesting levels but allows 64 in function
+ * args/returns. Ordinary content (deep rich text, nested compositions) trips 16 at
+ * rest, so every write here FOLDS over-budget field values into self-describing
+ * leaf envelopes immediately before `ctx.db`, and every read UNFOLDS before the
+ * value leaves the function. Mutations receive the UNFOLDED value over the wire, so
+ * the AD-15 reference walker (in the write-chokepoint trigger, which unfolds first)
+ * always sees structured content. The wire never carries an envelope; only raw
+ * `ctx.db` reads / the dashboard see the folded storage form.
  */
 
+/** Unfold the `document` blob of a stored row before it leaves the function. */
+function withUnfoldedDocument<R extends { document: unknown }>(row: R): R {
+  return { ...row, document: unfoldDocument(row.document as CmsDocument) }
+}
+
+/** Unfold the `snapshot` blob of a version row before it leaves the function. */
+function withUnfoldedSnapshot<R extends { snapshot: unknown }>(row: R): R {
+  return { ...row, snapshot: unfoldDocument(row.snapshot as CmsDocument) }
+}
+
 export const upsertDocument = mutation({
   args: {
     collection: v.string(),
@@ -21,6 +44,10 @@ export const upsertDocument = mutation({
   },
   handler: async (ctx, args) => {
     await requireCapability(ctx, 'content.write') // EC-150
+    // EC-260: fold for storage. `args.document` arrives UNFOLDED over the 64-level
+    // arg wire; the trigger unfolds before extracting references, so folding here
+    // (strictly before the `ctx.db` write) never hides a reference from the walker.
+    const stored = { ...args, document: foldDocument(args.document as CmsDocument) }
     const existing = await ctx.db
       .query('cmsDocuments')
       .withIndex('by_doc', (q) => q.eq('collection', args.collection).eq('docId', args.docId))
@@ -28,17 +55,19 @@ export const upsertDocument = mutation({
     if (existing) {
       // EC-153 parity: updates preserve `createdAt`, exactly like in-memory.
       // EC-286: the write-chokepoint trigger reindexes references in-transaction.
-      const patch = { ...args, createdAt: existing.createdAt }
+      const patch = { ...stored, createdAt: existing.createdAt }
       await ctx.db.patch(existing._id, patch)
       // EC-322: return the merged row directly instead of re-reading the full
       // (up-to-~20 KB) document body via `ctx.db.get`. `patch` only overwrites the
       // supplied fields, so `{ ...existing, ...patch }` is byte-identical to the
       // stored row (system fields + untouched `publishedVersion` carried from
       // `existing`) — cutting one full-document read off the hottest write path.
-      return { ...existing, ...patch }
+      // EC-260: unfold the folded body back to structured form for the return.
+      return withUnfoldedDocument({ ...existing, ...patch })
     }
-    const id = await ctx.db.insert('cmsDocuments', args)
-    return ctx.db.get(id)
+    const id = await ctx.db.insert('cmsDocuments', stored)
+    const row = await ctx.db.get(id)
+    return row ? withUnfoldedDocument(row) : row
   },
 })
 
@@ -46,10 +75,11 @@ export const getDocument = query({
   args: { collection: v.string(), docId: v.string() },
   handler: async (ctx, args) => {
     await requireCapability(ctx, 'content.read') // EC-150
-    return ctx.db
+    const row = await ctx.db
       .query('cmsDocuments')
       .withIndex('by_doc', (q) => q.eq('collection', args.collection).eq('docId', args.docId))
       .first()
+    return row ? withUnfoldedDocument(row) : row // EC-260: unfold before returning
   },
 })
 
@@ -57,14 +87,13 @@ export const listDocuments = query({
   args: { collection: v.optional(v.string()) },
   handler: async (ctx, args) => {
     await requireCapability(ctx, 'content.read') // EC-150
-    if (args.collection) {
-      const collection = args.collection
-      return ctx.db
-        .query('cmsDocuments')
-        .withIndex('by_collection', (q) => q.eq('collection', collection))
-        .collect()
-    }
-    return ctx.db.query('cmsDocuments').collect()
+    const rows = args.collection
+      ? await ctx.db
+          .query('cmsDocuments')
+          .withIndex('by_collection', (q) => q.eq('collection', args.collection as string))
+          .collect()
+      : await ctx.db.query('cmsDocuments').collect()
+    return rows.map(withUnfoldedDocument) // EC-260: unfold before returning
   },
 })
 
@@ -100,6 +129,7 @@ export const saveDocumentVersion = mutation({
     docId: v.string(),
     snapshot: v.any(),
     label: v.optional(v.string()),
+    origin: v.optional(v.string()), // EC-199 provenance ('assistant' for AI-authored)
     createdAt: v.string(),
   },
   handler: async (ctx, args) => {
@@ -113,8 +143,12 @@ export const saveDocumentVersion = mutation({
       .order('desc')
       .first()
     const version = (latest?.version ?? 0) + 1
-    const id = await ctx.db.insert('documentVersions', { ...args, version })
-    return ctx.db.get(id)
+    // EC-260: the snapshot embeds the CmsDocument at draft depth, so it folds at rest
+    // identically. `documentVersions` has no trigger — no walker to keep structured.
+    const stored = { ...args, snapshot: foldDocument(args.snapshot as CmsDocument), version }
+    const id = await ctx.db.insert('documentVersions', stored)
+    const row = await ctx.db.get(id)
+    return row ? withUnfoldedSnapshot(row) : row
   },
 })
 
@@ -127,7 +161,7 @@ export const listDocumentVersions = query({
       .withIndex('by_doc', (q) => q.eq('collection', args.collection).eq('docId', args.docId))
       .collect()
     // Newest first (parity with the in-memory `listDocumentVersions`).
-    return rows.sort((a, b) => b.version - a.version)
+    return rows.sort((a, b) => b.version - a.version).map(withUnfoldedSnapshot) // EC-260
   },
 })
 
@@ -138,12 +172,13 @@ export const getDocumentVersion = query({
     // EC-307: address the row directly via `by_doc_version` instead of collecting
     // the whole — unbounded — per-document history and finding in JS. `version` is
     // unique per (collection, docId), so `.unique()` both fetches and asserts that.
-    return ctx.db
+    const row = await ctx.db
       .query('documentVersions')
       .withIndex('by_doc_version', (q) =>
         q.eq('collection', args.collection).eq('docId', args.docId).eq('version', args.version),
       )
       .unique()
+    return row ? withUnfoldedSnapshot(row) : row // EC-260: unfold before returning
   },
 })
 
@@ -175,7 +210,8 @@ export const listPublishedDocuments = query({
           q.eq('collection', doc.collection).eq('docId', doc.docId).eq('version', version),
         )
         .unique()
-      if (pinned) snapshots.push(pinned.snapshot)
+      // EC-260: unfold the pinned snapshot before it leaves the function.
+      if (pinned) snapshots.push(unfoldDocument(pinned.snapshot as CmsDocument))
     }
     return snapshots
   },
@@ -186,7 +222,8 @@ export const listAllDocumentVersions = query({
   args: {},
   handler: async (ctx) => {
     await requireCapability(ctx, 'content.read') // EC-150
-    return ctx.db.query('documentVersions').collect()
+    const rows = await ctx.db.query('documentVersions').collect()
+    return rows.map(withUnfoldedSnapshot) // EC-260: unfold before returning
   },
 })
 
@@ -208,7 +245,8 @@ export const publishDocumentVersion = mutation({
     // write-chokepoint trigger sees — it reindexes the published reference rows
     // and fires host revalidation (EC-146 instant publish). No manual calls here.
     await ctx.db.patch(doc._id, { publishedVersion: args.version, updatedAt: args.updatedAt })
-    return ctx.db.get(doc._id)
+    const row = await ctx.db.get(doc._id)
+    return row ? withUnfoldedDocument(row) : row // EC-260: unfold before returning
   },
 })
 
@@ -225,6 +263,7 @@ export const unpublishDocument = mutation({
     // EC-286: clearing the pin is a change the write-chokepoint trigger sees — it
     // drops the published index rows and revalidates the host. No manual calls.
     await ctx.db.patch(doc._id, { publishedVersion: undefined, updatedAt: args.updatedAt })
-    return ctx.db.get(doc._id)
+    const row = await ctx.db.get(doc._id)
+    return row ? withUnfoldedDocument(row) : row // EC-260: unfold before returning
   },
 })

package/convex/content.ts

@@ -1,4 +1,4 @@
-import { documentKey, documentSchema } from '@elytracms/core/cms-core'
+import { documentKey, documentSchema, unfoldValue } from '@elytracms/core/cms-core'
 import type {
   CmsDocument,
   CmsValidationIssue,
@@ -157,7 +157,9 @@ export async function createContent(
   // a published read can serve the *pinned* version rather than the live draft.
   const versionsByKey = new Map<string, Map<number, CmsDocument>>()
   for (const row of await ctx.db.query('documentVersions').collect()) {
-    const parsed = documentSchema.safeParse(row.snapshot)
+    // EC-260: unfold the folded storage form before parsing — the kit resolves over
+    // STRUCTURED values, exactly like the Next-side snapshot (byte-equivalence).
+    const parsed = documentSchema.safeParse(unfoldValue(row.snapshot))
     if (!parsed.success) continue
     const key = `${row.collection}:${row.docId}`
     let byVersion = versionsByKey.get(key)
@@ -176,7 +178,8 @@ export async function createContent(
   // resolves exactly as before.
   const parsedSources: { key: string; source: ContentDocumentSource }[] = []
   for (const row of documentRows) {
-    const parsed = documentSchema.safeParse(row.document)
+    // EC-260: unfold the folded storage form before parsing (see the versions loop).
+    const parsed = documentSchema.safeParse(unfoldValue(row.document))
     if (!parsed.success) {
       loadIssues.push({
         code: 'invalid-stored-document',

package/convex/delivery.ts

@@ -1,4 +1,5 @@
 import { v } from 'convex/values'
+import { unfoldValue } from '@elytracms/core/cms-core'
 import { dataSourceSchema } from '@elytracms/core/data-binding'
 import { query } from './functions'
 import type { QueryCtx } from './functions'
@@ -134,6 +135,10 @@ export async function loadSnapshot(
   const { projectId } = args
 
   const documentRows = await ctx.db.query('cmsDocuments').collect()
+  // EC-260: the stored `document`/`snapshot` blobs are folded; unfold every one
+  // before it enters the delivery snapshot so the host receives STRUCTURED content
+  // (no client ever sees an envelope). `unfoldValue` is identity on legacy data.
+  const unfoldDraft = (row: { document: unknown }): unknown => unfoldValue(row.document)
   // THE published-content invariant (the trust boundary): the public snapshot
   // ships ONLY published content — never a draft. Under the EC-224 pointer model
   // a published row is served as its *pinned version snapshot* (decoupled from
@@ -142,7 +147,7 @@ export async function loadSnapshot(
   // fallback (the `state` field is gone).
   let documents: unknown[]
   if (perspective === 'draft') {
-    documents = documentRows.map((row) => row.document as unknown)
+    documents = documentRows.map(unfoldDraft)
   } else {
     documents = []
     for (const row of documentRows) {
@@ -160,7 +165,7 @@ export async function loadSnapshot(
           q.eq('collection', row.collection).eq('docId', row.docId).eq('version', version),
         )
         .unique()
-      if (pinned) documents.push(pinned.snapshot as unknown)
+      if (pinned) documents.push(unfoldValue(pinned.snapshot))
     }
   }
 
@@ -202,9 +207,7 @@ export async function loadSnapshot(
   // extracted from every stored row (independent of publish state) — published
   // bindings must always resolve their definitions, even when the defining
   // `cms-data-sources` row is not itself "published".
-  const sources = dataSourcesFromSystemCollection(
-    documentRows.map((row) => row.document as unknown),
-  )
+  const sources = dataSourcesFromSystemCollection(documentRows.map(unfoldDraft))
 
   // Editorial redirects (EC-303): only ENABLED entries serve — a disabled redirect
   // is stored but never live, in either perspective. Projected to the routing

package/convex/schema.ts

@@ -120,6 +120,9 @@ export default defineSchema({
     version: v.number(),
     snapshot: v.any(),
     label: v.optional(v.string()),
+    // EC-199 provenance: authoring origin ('assistant' for AI-authored content).
+    // Additive scalar, outside the folded snapshot — invisible when unset.
+    origin: v.optional(v.string()),
     createdAt: v.string(),
   })
     .index('by_doc', ['collection', 'docId'])

package/convex/triggers.ts

@@ -1,3 +1,4 @@
+import { unfoldDocument } from '@elytracms/core/cms-core'
 import type { CmsDocument } from '@elytracms/core/cms-core'
 import { Triggers } from 'convex-helpers/server/triggers'
 import type { DataModel } from './functions'
@@ -42,11 +43,17 @@ triggers.register('cmsDocuments', async (ctx, change) => {
     return
   }
   const doc = change.newDoc
+  // EC-260: the stored `document` is FOLDED (deep field values collapsed to leaf
+  // envelopes). Unfold it here so `extractReferences` walks the STRUCTURED value and
+  // still finds references buried inside a folded field — this is the write chokepoint
+  // (EC-286), so every writer's references are derived from structured content by
+  // construction, regardless of the folded storage form. `unfoldDocument` is identity
+  // on already-structural data, so a legacy unfolded row costs nothing.
   await maintainDocumentReferences(
     ctx,
     doc.collection,
     doc.docId,
-    doc.document as CmsDocument,
+    unfoldDocument(doc.document as CmsDocument),
     doc.publishedVersion !== undefined,
   )
   const before = change.oldDoc?.publishedVersion

package/dist/components/ai/ai-chat-panel-lazy.d.ts

@@ -0,0 +1 @@
+export declare function AiChatPanel(): import("react").JSX.Element;

package/dist/components/ai/ai-chat-panel-lazy.js

@@ -0,0 +1,21 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { Suspense, lazy } from 'react';
+import { Text } from '@elytracms/studio/ui';
+import { translate } from '@elytracms/studio/lib/i18n';
+/**
+ * Lazy boundary for the AI chat panel (EC-199, EC-331 bundle discipline). The panel
+ * and everything it imports — the creation orchestrator, `applyContentWithShape`, the
+ * provider adapters (and the AI SDK behind the Anthropic one via dynamic import) — load
+ * ONLY when a configured studio actually opens the panel. An unconfigured studio never
+ * renders the toggle, never mounts this, and so pulls none of the AI chunk onto the CMS
+ * critical path (pinned by the `lib/ai` bundle test). Same pattern as
+ * `version-compare-lazy` / `rich-text/lazy`.
+ */
+const AiChatPanelImpl = lazy(() => import('./ai-chat-panel').then((module) => ({ default: module.AiChatPanel })));
+function AiPanelFallback() {
+    return (_jsx("aside", { className: "flex h-full min-h-0 w-[360px] shrink-0 flex-col border-l border-border bg-card", children: _jsx("div", { className: "grid min-h-0 flex-1 place-items-center p-6", children: _jsx(Text, { size: "sm", tone: "muted", children: translate('ai.panel.loading') }) }) }));
+}
+export function AiChatPanel() {
+    return (_jsx(Suspense, { fallback: _jsx(AiPanelFallback, {}), children: _jsx(AiChatPanelImpl, {}) }));
+}
+//# sourceMappingURL=ai-chat-panel-lazy.js.map

package/dist/components/ai/ai-chat-panel-lazy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-chat-panel-lazy.js","sourceRoot":"","sources":["../../../src/components/ai/ai-chat-panel-lazy.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,OAAO,CAAA;AACtC,OAAO,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAA;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAA;AAEtD;;;;;;;;GAQG;AACH,MAAM,eAAe,GAAG,IAAI,CAAC,GAAG,EAAE,CAChC,MAAM,CAAC,iBAAiB,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC,CAC9E,CAAA;AAED,SAAS,eAAe;IACtB,OAAO,CACL,gBAAO,SAAS,EAAC,gFAAgF,YAC/F,cAAK,SAAS,EAAC,4CAA4C,YACzD,KAAC,IAAI,IAAC,IAAI,EAAC,IAAI,EAAC,IAAI,EAAC,OAAO,YACzB,SAAS,CAAC,kBAAkB,CAAC,GACzB,GACH,GACA,CACT,CAAA;AACH,CAAC;AAED,MAAM,UAAU,WAAW;IACzB,OAAO,CACL,KAAC,QAAQ,IAAC,QAAQ,EAAE,KAAC,eAAe,KAAG,YACrC,KAAC,eAAe,KAAG,GACV,CACZ,CAAA;AACH,CAAC","sourcesContent":["import { Suspense, lazy } from 'react'\nimport { Text } from '@elytracms/studio/ui'\nimport { translate } from '@elytracms/studio/lib/i18n'\n\n/**\n * Lazy boundary for the AI chat panel (EC-199, EC-331 bundle discipline). The panel\n * and everything it imports — the creation orchestrator, `applyContentWithShape`, the\n * provider adapters (and the AI SDK behind the Anthropic one via dynamic import) — load\n * ONLY when a configured studio actually opens the panel. An unconfigured studio never\n * renders the toggle, never mounts this, and so pulls none of the AI chunk onto the CMS\n * critical path (pinned by the `lib/ai` bundle test). Same pattern as\n * `version-compare-lazy` / `rich-text/lazy`.\n */\nconst AiChatPanelImpl = lazy(() =>\n  import('./ai-chat-panel').then((module) => ({ default: module.AiChatPanel })),\n)\n\nfunction AiPanelFallback() {\n  return (\n    <aside className=\"flex h-full min-h-0 w-[360px] shrink-0 flex-col border-l border-border bg-card\">\n      <div className=\"grid min-h-0 flex-1 place-items-center p-6\">\n        <Text size=\"sm\" tone=\"muted\">\n          {translate('ai.panel.loading')}\n        </Text>\n      </div>\n    </aside>\n  )\n}\n\nexport function AiChatPanel() {\n  return (\n    <Suspense fallback={<AiPanelFallback />}>\n      <AiChatPanelImpl />\n    </Suspense>\n  )\n}\n"]}

package/dist/components/ai/ai-chat-panel.d.ts

@@ -0,0 +1,10 @@
+/**
+ * The AI assistant chat panel (EC-199) — the right-hand collapsible surface in the CMS
+ * area. It owns the chat state (the pure `chatReducer`), resolves the EC-331 provider
+ * from `defineStudio({ ai })`, binds the narrow tools (search/list) to the operations
+ * layer with the user's session, runs the creation orchestrator, and applies a
+ * reviewed proposal as a DRAFT (operations upsert + a provenance-tagged version
+ * snapshot). NEVER a modal (house rule). The whole module sits behind a lazy boundary
+ * (`ai-chat-panel-lazy`), so an unconfigured studio pulls none of it — and no AI SDK.
+ */
+export declare function AiChatPanel(): import("react").JSX.Element;

package/dist/components/ai/ai-chat-panel.js

@@ -0,0 +1,202 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useCallback, useMemo, useReducer, useState } from 'react';
+import { X } from 'lucide-react';
+import { createCollectionRegistry, resolveDocumentTitle, } from '@elytracms/core/cms-core';
+import { Button, Heading, Row, Spacer, Text } from '@elytracms/studio/ui';
+import { translate } from '@elytracms/studio/lib/i18n';
+import { STUDIO_PROJECT_ROUTE, studioPath, useNavigate } from '@elytracms/studio/router';
+import { resolveDeploymentAi } from '@elytracms/studio/lib/workspace';
+import { getStudioOperations } from '@elytracms/studio/lib/operations';
+import { AiRouteError, chatReducer, initialChatState, resolveAiConfig, resolveKnowledge, runCreateFlow, } from '@elytracms/studio/lib/ai';
+import { useCms } from '../cms/cms-store';
+import { validateComposition, validateRichTextEmbeds } from '../cms/cms-composition-validators';
+import { AssistantTurn, Conversation, ConversationEmpty, PromptInput, ToolStatus, UserTurn, } from './chat-ui';
+import { ProposalCard } from './proposal-card';
+import { setAiPanelOpen } from '@elytracms/studio/lib/ai-panel';
+/**
+ * The AI assistant chat panel (EC-199) — the right-hand collapsible surface in the CMS
+ * area. It owns the chat state (the pure `chatReducer`), resolves the EC-331 provider
+ * from `defineStudio({ ai })`, binds the narrow tools (search/list) to the operations
+ * layer with the user's session, runs the creation orchestrator, and applies a
+ * reviewed proposal as a DRAFT (operations upsert + a provenance-tagged version
+ * snapshot). NEVER a modal (house rule). The whole module sits behind a lazy boundary
+ * (`ai-chat-panel-lazy`), so an unconfigured studio pulls none of it — and no AI SDK.
+ */
+export function AiChatPanel() {
+    const cms = useCms();
+    const navigate = useNavigate();
+    const [state, dispatch] = useReducer(chatReducer, initialChatState);
+    const [input, setInput] = useState('');
+    const projectId = cms.projectId;
+    const activeLocale = cms.activeLocale;
+    // Resolve the AI platform config once (presence + capability gate). The panel only
+    // mounts when configured, but a misconfigured provider still fails loud here.
+    const resolved = useMemo(() => resolveAiConfig(resolveDeploymentAi()), []);
+    const provider = resolved.resolved?.provider ?? null;
+    const knowledgeSources = resolved.resolved?.knowledge ?? [];
+    const maxRepairAttempts = resolved.resolved?.limits?.maxRepairAttempts;
+    const ready = provider !== null && resolved.ok && projectId !== undefined;
+    const registry = useMemo(() => createCollectionRegistry(cms.collections), [cms.collections]);
+    /** Merge a document's non-localized + active-locale values for title/prose reads. */
+    const localeValues = useCallback((doc) => ({
+        ...doc.values,
+        ...(doc.localized?.[activeLocale] ?? {}),
+    }), [activeLocale]);
+    /** Operations-backed tool readers — client-side, with the user's own session. */
+    const tools = useMemo(() => {
+        const matches = (query, ...fields) => !query || fields.some((f) => f?.toLowerCase().includes(query.toLowerCase()));
+        return {
+            async searchDocuments({ collection, query }) {
+                if (projectId === undefined)
+                    return [];
+                const { operations } = await getStudioOperations();
+                const result = await operations.documents.list({ projectId, collection });
+                if (!result.ok)
+                    return [];
+                const target = cms.getCollection(collection);
+                return result.value
+                    .map((rec) => ({
+                    id: rec.document.id,
+                    title: target
+                        ? resolveDocumentTitle(target, localeValues(rec.document), rec.document.id)
+                        : rec.document.id,
+                }))
+                    .filter((r) => matches(query, r.title, r.id));
+            },
+            async listAssets({ query }) {
+                if (projectId === undefined)
+                    return [];
+                const { operations } = await getStudioOperations();
+                const result = await operations.assets.list({ projectId });
+                if (!result.ok)
+                    return [];
+                return result.value
+                    .map((asset) => ({ id: asset.id, title: asset.title ?? asset.filename }))
+                    .filter((r) => matches(query, r.title, r.id));
+            },
+        };
+    }, [projectId, cms, localeValues]);
+    /** A fresh, collision-free draft id for the target collection. */
+    const mintDocumentId = useCallback((collectionId) => {
+        const existing = new Set(cms.documentsOf(collectionId).map((d) => d.id));
+        let n = 1;
+        while (existing.has(`new-${collectionId}-${n}`))
+            n += 1;
+        return `new-${collectionId}-${n}`;
+    }, [cms]);
+    /** Read `fromCollection(...)` knowledge prose through the operations layer. */
+    const readCollection = useCallback(async (source) => {
+        if (projectId === undefined)
+            return [];
+        const { operations } = await getStudioOperations();
+        const result = await operations.documents.list({ projectId, collection: source.collectionId });
+        if (!result.ok)
+            return [];
+        const target = cms.getCollection(source.collectionId);
+        const field = source.field ?? target?.fields.find((f) => f.type === 'text' || f.type === 'richText')?.name;
+        return result.value
+            .map((rec) => {
+            const values = localeValues(rec.document);
+            const content = field ? String(values[field] ?? '') : '';
+            return { content };
+        })
+            .filter((item) => item.content.trim().length > 0);
+    }, [projectId, cms, localeValues]);
+    const runTurn = useCallback(async (text) => {
+        if (!provider)
+            return;
+        try {
+            const knowledge = await resolveKnowledge(knowledgeSources, { readCollection });
+            const result = await runCreateFlow({
+                provider,
+                tools,
+                registry,
+                collections: cms.collections,
+                instruction: text,
+                knowledge,
+                locale: activeLocale,
+                mintDocumentId,
+                validateRichTextEmbeds,
+                validateComposition,
+                ...(maxRepairAttempts !== undefined ? { maxRepairAttempts } : {}),
+                onStep: (step) => dispatch({ type: 'step', step }),
+            });
+            dispatch({ type: 'result', result });
+        }
+        catch (error) {
+            const message = error instanceof AiRouteError
+                ? translate('ai.error.route')
+                : translate('ai.error.generic');
+            dispatch({ type: 'fail', message });
+        }
+    }, [
+        provider,
+        knowledgeSources,
+        readCollection,
+        tools,
+        registry,
+        cms.collections,
+        activeLocale,
+        mintDocumentId,
+        maxRepairAttempts,
+    ]);
+    const submit = useCallback(() => {
+        const text = input.trim();
+        if (text.length === 0 || state.status === 'busy' || !ready)
+            return;
+        setInput('');
+        dispatch({ type: 'submit', text });
+        void runTurn(text);
+    }, [input, state.status, ready, runTurn]);
+    const applyProposal = useCallback(async (proposal) => {
+        if (projectId === undefined)
+            return;
+        const doc = {
+            collection: proposal.collection,
+            id: proposal.documentId,
+            values: proposal.patch.values,
+            ...(proposal.patch.localized ? { localized: proposal.patch.localized } : {}),
+        };
+        const { operations } = await getStudioOperations();
+        const upserted = await operations.documents.upsert({ projectId, document: doc });
+        if (!upserted.ok) {
+            dispatch({ type: 'fail', message: translate('ai.error.applyFailed') });
+            return;
+        }
+        // Provenance: record an AI-tagged version snapshot (a restore point + the
+        // 'assistant' origin surfaced in the versions pane). Best-effort — the draft
+        // already landed above; a snapshot failure must not lose the applied content.
+        try {
+            await operations.documents.snapshot({
+                projectId,
+                ref: { collection: proposal.collection, id: proposal.documentId },
+                label: translate('cms.version.aiAuthoredTitle'),
+                origin: 'assistant',
+            });
+        }
+        catch {
+            // ignore — provenance is additive
+        }
+        // Reflect in the session so the new draft shows in the list + is navigable.
+        cms.saveDocument(doc);
+        dispatch({ type: 'apply', proposalId: proposal.id });
+    }, [projectId, cms]);
+    const openProposal = useCallback((proposal) => {
+        if (projectId === undefined)
+            return;
+        void navigate({
+            to: STUDIO_PROJECT_ROUTE,
+            params: { projectId, _splat: studioPath.cmsDocument(proposal.collection, proposal.documentId) },
+        });
+    }, [navigate, projectId]);
+    return (_jsxs("aside", { className: "flex h-full min-h-0 w-[360px] shrink-0 flex-col border-l border-border bg-card", children: [_jsxs(Row, { gap: "2", align: "center", className: "h-12 shrink-0 border-b border-border px-3", children: [_jsx(Heading, { level: 2, size: "h4", children: translate('ai.panel.title') }), _jsx(Spacer, {}), _jsx(Button, { size: "icon-sm", variant: "ghost", onClick: () => setAiPanelOpen(false), title: translate('ai.panel.close'), "aria-label": translate('ai.panel.close'), children: _jsx(X, {}) })] }), _jsxs(Conversation, { atBottomKey: state.messages, children: [state.messages.length === 0 ? _jsx(ConversationEmpty, {}) : null, state.messages.map((message) => {
+                        if (message.role === 'user')
+                            return _jsx(UserTurn, { text: message.text }, message.id);
+                        if (message.kind === 'text')
+                            return (_jsx(AssistantTurn, { children: _jsx(Text, { size: "sm", className: "whitespace-pre-wrap break-words", children: message.text }) }, message.id));
+                        if (message.kind === 'activity')
+                            return (_jsx(AssistantTurn, { children: _jsx(ToolStatus, { steps: message.steps, active: state.status === 'busy' && state.activityId === message.id }) }, message.id));
+                        return (_jsx(ProposalCard, { proposal: message.proposal, onApply: () => void applyProposal(message.proposal), onDiscard: () => dispatch({ type: 'reject', proposalId: message.proposal.id }), onOpen: () => openProposal(message.proposal) }, message.id));
+                    })] }), ready ? (_jsx(PromptInput, { value: input, onChange: setInput, onSubmit: submit, disabled: state.status === 'busy' })) : (_jsx("div", { className: "border-t border-border p-3", children: _jsx(Text, { size: "xs", tone: "muted", children: translate('ai.panel.unavailable') }) }))] }));
+}
+//# sourceMappingURL=ai-chat-panel.js.map

package/dist/components/ai/ai-chat-panel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-chat-panel.js","sourceRoot":"","sources":["../../../src/components/ai/ai-chat-panel.tsx"],"names":[],"mappings":"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","sourcesContent":["import { useCallback, useMemo, useReducer, useState } from 'react'\nimport { X } from 'lucide-react'\nimport {\n  createCollectionRegistry,\n  resolveDocumentTitle,\n} from '@elytracms/core/cms-core'\nimport type { CmsDocument, FieldValues } from '@elytracms/core/cms-core'\nimport { Button, Heading, Row, Spacer, Text } from '@elytracms/studio/ui'\nimport { translate } from '@elytracms/studio/lib/i18n'\nimport { STUDIO_PROJECT_ROUTE, studioPath, useNavigate } from '@elytracms/studio/router'\nimport { resolveDeploymentAi } from '@elytracms/studio/lib/workspace'\nimport { getStudioOperations } from '@elytracms/studio/lib/operations'\nimport {\n  AiRouteError,\n  chatReducer,\n  initialChatState,\n  resolveAiConfig,\n  resolveKnowledge,\n  runCreateFlow,\n} from '@elytracms/studio/lib/ai'\nimport type {\n  CreateFlowStep,\n  CreateFlowTools,\n  KnowledgeCollectionReader,\n  ProposalReview,\n} from '@elytracms/studio/lib/ai'\nimport { useCms } from '../cms/cms-store'\nimport { validateComposition, validateRichTextEmbeds } from '../cms/cms-composition-validators'\nimport {\n  AssistantTurn,\n  Conversation,\n  ConversationEmpty,\n  PromptInput,\n  ToolStatus,\n  UserTurn,\n} from './chat-ui'\nimport { ProposalCard } from './proposal-card'\nimport { setAiPanelOpen } from '@elytracms/studio/lib/ai-panel'\n\n/**\n * The AI assistant chat panel (EC-199) — the right-hand collapsible surface in the CMS\n * area. It owns the chat state (the pure `chatReducer`), resolves the EC-331 provider\n * from `defineStudio({ ai })`, binds the narrow tools (search/list) to the operations\n * layer with the user's session, runs the creation orchestrator, and applies a\n * reviewed proposal as a DRAFT (operations upsert + a provenance-tagged version\n * snapshot). NEVER a modal (house rule). The whole module sits behind a lazy boundary\n * (`ai-chat-panel-lazy`), so an unconfigured studio pulls none of it — and no AI SDK.\n */\nexport function AiChatPanel() {\n  const cms = useCms()\n  const navigate = useNavigate()\n  const [state, dispatch] = useReducer(chatReducer, initialChatState)\n  const [input, setInput] = useState('')\n\n  const projectId = cms.projectId\n  const activeLocale = cms.activeLocale\n\n  // Resolve the AI platform config once (presence + capability gate). The panel only\n  // mounts when configured, but a misconfigured provider still fails loud here.\n  const resolved = useMemo(() => resolveAiConfig(resolveDeploymentAi()), [])\n  const provider = resolved.resolved?.provider ?? null\n  const knowledgeSources = resolved.resolved?.knowledge ?? []\n  const maxRepairAttempts = resolved.resolved?.limits?.maxRepairAttempts\n  const ready = provider !== null && resolved.ok && projectId !== undefined\n\n  const registry = useMemo(() => createCollectionRegistry(cms.collections), [cms.collections])\n\n  /** Merge a document's non-localized + active-locale values for title/prose reads. */\n  const localeValues = useCallback(\n    (doc: CmsDocument): FieldValues => ({\n      ...doc.values,\n      ...(doc.localized?.[activeLocale] ?? {}),\n    }),\n    [activeLocale],\n  )\n\n  /** Operations-backed tool readers — client-side, with the user's own session. */\n  const tools = useMemo<CreateFlowTools>(() => {\n    const matches = (query: string | undefined, ...fields: (string | undefined)[]) =>\n      !query || fields.some((f) => f?.toLowerCase().includes(query.toLowerCase()))\n    return {\n      async searchDocuments({ collection, query }) {\n        if (projectId === undefined) return []\n        const { operations } = await getStudioOperations()\n        const result = await operations.documents.list({ projectId, collection })\n        if (!result.ok) return []\n        const target = cms.getCollection(collection)\n        return result.value\n          .map((rec) => ({\n            id: rec.document.id,\n            title: target\n              ? resolveDocumentTitle(target, localeValues(rec.document), rec.document.id)\n              : rec.document.id,\n          }))\n          .filter((r) => matches(query, r.title, r.id))\n      },\n      async listAssets({ query }) {\n        if (projectId === undefined) return []\n        const { operations } = await getStudioOperations()\n        const result = await operations.assets.list({ projectId })\n        if (!result.ok) return []\n        return result.value\n          .map((asset) => ({ id: asset.id, title: asset.title ?? asset.filename }))\n          .filter((r) => matches(query, r.title, r.id))\n      },\n    }\n  }, [projectId, cms, localeValues])\n\n  /** A fresh, collision-free draft id for the target collection. */\n  const mintDocumentId = useCallback(\n    (collectionId: string): string => {\n      const existing = new Set(cms.documentsOf(collectionId).map((d) => d.id))\n      let n = 1\n      while (existing.has(`new-${collectionId}-${n}`)) n += 1\n      return `new-${collectionId}-${n}`\n    },\n    [cms],\n  )\n\n  /** Read `fromCollection(...)` knowledge prose through the operations layer. */\n  const readCollection = useCallback<KnowledgeCollectionReader>(\n    async (source) => {\n      if (projectId === undefined) return []\n      const { operations } = await getStudioOperations()\n      const result = await operations.documents.list({ projectId, collection: source.collectionId })\n      if (!result.ok) return []\n      const target = cms.getCollection(source.collectionId)\n      const field =\n        source.field ?? target?.fields.find((f) => f.type === 'text' || f.type === 'richText')?.name\n      return result.value\n        .map((rec) => {\n          const values = localeValues(rec.document)\n          const content = field ? String(values[field] ?? '') : ''\n          return { content }\n        })\n        .filter((item) => item.content.trim().length > 0)\n    },\n    [projectId, cms, localeValues],\n  )\n\n  const runTurn = useCallback(\n    async (text: string) => {\n      if (!provider) return\n      try {\n        const knowledge = await resolveKnowledge(knowledgeSources, { readCollection })\n        const result = await runCreateFlow({\n          provider,\n          tools,\n          registry,\n          collections: cms.collections,\n          instruction: text,\n          knowledge,\n          locale: activeLocale,\n          mintDocumentId,\n          validateRichTextEmbeds,\n          validateComposition,\n          ...(maxRepairAttempts !== undefined ? { maxRepairAttempts } : {}),\n          onStep: (step: CreateFlowStep) => dispatch({ type: 'step', step }),\n        })\n        dispatch({ type: 'result', result })\n      } catch (error) {\n        const message =\n          error instanceof AiRouteError\n            ? translate('ai.error.route')\n            : translate('ai.error.generic')\n        dispatch({ type: 'fail', message })\n      }\n    },\n    [\n      provider,\n      knowledgeSources,\n      readCollection,\n      tools,\n      registry,\n      cms.collections,\n      activeLocale,\n      mintDocumentId,\n      maxRepairAttempts,\n    ],\n  )\n\n  const submit = useCallback(() => {\n    const text = input.trim()\n    if (text.length === 0 || state.status === 'busy' || !ready) return\n    setInput('')\n    dispatch({ type: 'submit', text })\n    void runTurn(text)\n  }, [input, state.status, ready, runTurn])\n\n  const applyProposal = useCallback(\n    async (proposal: ProposalReview) => {\n      if (projectId === undefined) return\n      const doc: CmsDocument = {\n        collection: proposal.collection,\n        id: proposal.documentId,\n        values: proposal.patch.values,\n        ...(proposal.patch.localized ? { localized: proposal.patch.localized } : {}),\n      }\n      const { operations } = await getStudioOperations()\n      const upserted = await operations.documents.upsert({ projectId, document: doc })\n      if (!upserted.ok) {\n        dispatch({ type: 'fail', message: translate('ai.error.applyFailed') })\n        return\n      }\n      // Provenance: record an AI-tagged version snapshot (a restore point + the\n      // 'assistant' origin surfaced in the versions pane). Best-effort — the draft\n      // already landed above; a snapshot failure must not lose the applied content.\n      try {\n        await operations.documents.snapshot({\n          projectId,\n          ref: { collection: proposal.collection, id: proposal.documentId },\n          label: translate('cms.version.aiAuthoredTitle'),\n          origin: 'assistant',\n        })\n      } catch {\n        // ignore — provenance is additive\n      }\n      // Reflect in the session so the new draft shows in the list + is navigable.\n      cms.saveDocument(doc)\n      dispatch({ type: 'apply', proposalId: proposal.id })\n    },\n    [projectId, cms],\n  )\n\n  const openProposal = useCallback(\n    (proposal: ProposalReview) => {\n      if (projectId === undefined) return\n      void navigate({\n        to: STUDIO_PROJECT_ROUTE,\n        params: { projectId, _splat: studioPath.cmsDocument(proposal.collection, proposal.documentId) },\n      })\n    },\n    [navigate, projectId],\n  )\n\n  return (\n    <aside className=\"flex h-full min-h-0 w-[360px] shrink-0 flex-col border-l border-border bg-card\">\n      <Row gap=\"2\" align=\"center\" className=\"h-12 shrink-0 border-b border-border px-3\">\n        <Heading level={2} size=\"h4\">\n          {translate('ai.panel.title')}\n        </Heading>\n        <Spacer />\n        <Button\n          size=\"icon-sm\"\n          variant=\"ghost\"\n          onClick={() => setAiPanelOpen(false)}\n          title={translate('ai.panel.close')}\n          aria-label={translate('ai.panel.close')}\n        >\n          <X />\n        </Button>\n      </Row>\n\n      <Conversation atBottomKey={state.messages}>\n        {state.messages.length === 0 ? <ConversationEmpty /> : null}\n        {state.messages.map((message) => {\n          if (message.role === 'user') return <UserTurn key={message.id} text={message.text} />\n          if (message.kind === 'text')\n            return (\n              <AssistantTurn key={message.id}>\n                <Text size=\"sm\" className=\"whitespace-pre-wrap break-words\">\n                  {message.text}\n                </Text>\n              </AssistantTurn>\n            )\n          if (message.kind === 'activity')\n            return (\n              <AssistantTurn key={message.id}>\n                <ToolStatus\n                  steps={message.steps}\n                  active={state.status === 'busy' && state.activityId === message.id}\n                />\n              </AssistantTurn>\n            )\n          return (\n            <ProposalCard\n              key={message.id}\n              proposal={message.proposal}\n              onApply={() => void applyProposal(message.proposal)}\n              onDiscard={() => dispatch({ type: 'reject', proposalId: message.proposal.id })}\n              onOpen={() => openProposal(message.proposal)}\n            />\n          )\n        })}\n      </Conversation>\n\n      {ready ? (\n        <PromptInput value={input} onChange={setInput} onSubmit={submit} disabled={state.status === 'busy'} />\n      ) : (\n        <div className=\"border-t border-border p-3\">\n          <Text size=\"xs\" tone=\"muted\">\n            {translate('ai.panel.unavailable')}\n          </Text>\n        </div>\n      )}\n    </aside>\n  )\n}\n"]}

package/dist/components/ai/ai-cms-panel.d.ts

@@ -0,0 +1,9 @@
+/**
+ * The CMS-area mount of the AI assistant (EC-199): a right-hand sibling of the CMS
+ * content, shown on BOTH the collection list and the document editor. Gated twice —
+ * the studio must be `ai`-configured (EC-331 presence-enable) AND the panel open — so
+ * the lazy `AiChatPanel` chunk is requested only when a configured studio actually
+ * opens it. Sits inside `CmsProvider`, so the panel reads the live CMS store
+ * (collections, active locale) for its tools and applies drafts through it.
+ */
+export declare function AiCmsPanel(): import("react").JSX.Element | null;

package/dist/components/ai/ai-cms-panel.js

@@ -0,0 +1,24 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useMemo } from 'react';
+import { resolveDeploymentAi } from '@elytracms/studio/lib/workspace';
+import { useAiPanelOpen } from '@elytracms/studio/lib/ai-panel';
+import { AiChatPanel } from './ai-chat-panel-lazy';
+/**
+ * The CMS-area mount of the AI assistant (EC-199): a right-hand sibling of the CMS
+ * content, shown on BOTH the collection list and the document editor. Gated twice —
+ * the studio must be `ai`-configured (EC-331 presence-enable) AND the panel open — so
+ * the lazy `AiChatPanel` chunk is requested only when a configured studio actually
+ * opens it. Sits inside `CmsProvider`, so the panel reads the live CMS store
+ * (collections, active locale) for its tools and applies drafts through it.
+ */
+export function AiCmsPanel() {
+    const open = useAiPanelOpen();
+    const configured = useMemo(() => {
+        const ai = resolveDeploymentAi();
+        return !!ai && ai.enabled !== false;
+    }, []);
+    if (!configured || !open)
+        return null;
+    return _jsx(AiChatPanel, {});
+}
+//# sourceMappingURL=ai-cms-panel.js.map

package/dist/components/ai/ai-cms-panel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-cms-panel.js","sourceRoot":"","sources":["../../../src/components/ai/ai-cms-panel.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAA;AAC/B,OAAO,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAA;AACrE,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAA;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAElD;;;;;;;GAOG;AACH,MAAM,UAAU,UAAU;IACxB,MAAM,IAAI,GAAG,cAAc,EAAE,CAAA;IAC7B,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,EAAE;QAC9B,MAAM,EAAE,GAAG,mBAAmB,EAAE,CAAA;QAChC,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,OAAO,KAAK,KAAK,CAAA;IACrC,CAAC,EAAE,EAAE,CAAC,CAAA;IACN,IAAI,CAAC,UAAU,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAA;IACrC,OAAO,KAAC,WAAW,KAAG,CAAA;AACxB,CAAC","sourcesContent":["import { useMemo } from 'react'\nimport { resolveDeploymentAi } from '@elytracms/studio/lib/workspace'\nimport { useAiPanelOpen } from '@elytracms/studio/lib/ai-panel'\nimport { AiChatPanel } from './ai-chat-panel-lazy'\n\n/**\n * The CMS-area mount of the AI assistant (EC-199): a right-hand sibling of the CMS\n * content, shown on BOTH the collection list and the document editor. Gated twice —\n * the studio must be `ai`-configured (EC-331 presence-enable) AND the panel open — so\n * the lazy `AiChatPanel` chunk is requested only when a configured studio actually\n * opens it. Sits inside `CmsProvider`, so the panel reads the live CMS store\n * (collections, active locale) for its tools and applies drafts through it.\n */\nexport function AiCmsPanel() {\n  const open = useAiPanelOpen()\n  const configured = useMemo(() => {\n    const ai = resolveDeploymentAi()\n    return !!ai && ai.enabled !== false\n  }, [])\n  if (!configured || !open) return null\n  return <AiChatPanel />\n}\n"]}