@aphexcms/cms-core 9.7.0 → 9.8.0

package/dist/components/layout/Sidebar.svelte

@@ -2,9 +2,10 @@
 	import { SidebarProvider, SidebarInset, SidebarTrigger } from '@aphexcms/ui/shadcn/sidebar';
 	import { Separator } from '@aphexcms/ui/shadcn/separator';
 	import { Button } from '@aphexcms/ui/shadcn/button';
+	import * as Sheet from '@aphexcms/ui/shadcn/sheet';
 	import { ModeWatcher } from 'mode-watcher';
 	import { Toaster } from '@aphexcms/ui/shadcn/sonner';
-	import { Sun, Moon } from '@lucide/svelte';
+	import { Sun, Moon, Sparkles } from '@lucide/svelte';
 	import { toggleMode } from 'mode-watcher';
 	import { page } from '$app/state';
 	import type { SidebarData } from '../../types/sidebar';
@@ -13,6 +14,7 @@
 	import { setAdminSlots } from '../../admin/slots.svelte';
 	import type { AdminArea } from '../../admin/types';
 	import type { CMSPlugin, AdminToolPart } from '../../plugins/types';
+	import AgentChat from '../admin/AgentChat.svelte';
 
 	// Admin extension-slot registry, published to the whole admin subtree. The
 	// navbar renders `navbar-start` / `navbar-end` outlets; the document editor (and
@@ -24,6 +26,7 @@
 		onSignOut?: () => void | Promise<void>;
 		children: any;
 		enableGraphiQL?: boolean;
+		enableAssistant?: boolean;
 		activeTab?: { value: AdminArea };
 		onTabChange?: (value: string) => void;
 		/** Plugin registry — used to render sidebar-placed admin tools as persistent nav. */
@@ -35,10 +38,12 @@
 		onSignOut,
 		children,
 		enableGraphiQL = false,
+		enableAssistant = false,
 		activeTab,
 		onTabChange,
 		plugins = []
 	}: Props = $props();
+	let assistantOpen = $state(false);
 
 	function switchTab(value: AdminArea) {
 		if (onTabChange) {
@@ -151,8 +156,27 @@
 				</div>
 			</div>
 		</header>
-		<main class="flex flex-1 flex-col overflow-hidden pt-0">
+		<main class="flex flex-1 flex-col overflow-x-hidden overflow-y-auto pt-0">
 			{@render children()}
 		</main>
 	</SidebarInset>
+	{#if enableAssistant && !assistantOpen}
+		<Button
+			size="icon-lg"
+			class="fixed right-5 bottom-20 z-50 size-12 rounded-full shadow-lg sm:right-6"
+			onclick={() => (assistantOpen = true)}
+			aria-label="Open Aphex Assistant"
+		>
+			<Sparkles class="size-5" />
+		</Button>
+	{/if}
+	<Sheet.Root bind:open={assistantOpen}>
+		<Sheet.Content class="w-full gap-0 p-0 sm:max-w-xl">
+			<Sheet.Header class="sr-only">
+				<Sheet.Title>Aphex Assistant</Sheet.Title>
+				<Sheet.Description>CMS-aware answers and content tools</Sheet.Description>
+			</Sheet.Header>
+			<AgentChat embedded />
+		</Sheet.Content>
+	</Sheet.Root>
 </SidebarProvider>

package/dist/components/layout/Sidebar.svelte.d.ts

@@ -6,6 +6,7 @@ type Props = {
     onSignOut?: () => void | Promise<void>;
     children: any;
     enableGraphiQL?: boolean;
+    enableAssistant?: boolean;
     activeTab?: {
         value: AdminArea;
     };

package/dist/components/layout/Sidebar.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Sidebar.svelte.d.ts","sourceRoot":"","sources":["../../../src/lib/components/layout/Sidebar.svelte.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAIvD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,KAAK,EAAE,SAAS,EAAiB,MAAM,qBAAqB,CAAC;AAGnE,KAAK,KAAK,GAAG;IACZ,IAAI,EAAE,WAAW,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,QAAQ,EAAE,GAAG,CAAC;IACd,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,SAAS,CAAC,EAAE;QAAE,KAAK,EAAE,SAAS,CAAA;KAAE,CAAC;IACjC,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,qFAAqF;IACrF,OAAO,CAAC,EAAE,SAAS,EAAE,CAAC;CACtB,CAAC;AAuIH,QAAA,MAAM,OAAO,2CAAwC,CAAC;AACtD,KAAK,OAAO,GAAG,UAAU,CAAC,OAAO,OAAO,CAAC,CAAC;AAC1C,eAAe,OAAO,CAAC"}
+{"version":3,"file":"Sidebar.svelte.d.ts","sourceRoot":"","sources":["../../../src/lib/components/layout/Sidebar.svelte.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAIvD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,KAAK,EAAE,SAAS,EAAiB,MAAM,qBAAqB,CAAC;AAInE,KAAK,KAAK,GAAG;IACZ,IAAI,EAAE,WAAW,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,QAAQ,EAAE,GAAG,CAAC;IACd,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,SAAS,CAAC,EAAE;QAAE,KAAK,EAAE,SAAS,CAAA;KAAE,CAAC;IACjC,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,qFAAqF;IACrF,OAAO,CAAC,EAAE,SAAS,EAAE,CAAC;CACtB,CAAC;AAyJH,QAAA,MAAM,OAAO,2CAAwC,CAAC;AACtD,KAAK,OAAO,GAAG,UAAU,CAAC,OAAO,OAAO,CAAC,CAAC;AAC1C,eAAe,OAAO,CAAC"}

package/dist/db/interfaces/agent-change-sets.d.ts

@@ -0,0 +1,17 @@
+import type { AgentChangeSet, AgentChangeSetWithOperations, AgentOperation, CreateAgentChangeSetInput, CompleteAgentChangeSetInput, RecordAgentOperationInput, ListAgentChangeSetsOptions } from '../../types/agent-change-sets.js';
+import type { Page } from '../../types/events.js';
+export interface AgentChangeSetAdapter {
+    /** One row per agent turn, created eagerly before the model is called. */
+    createChangeSet(input: CreateAgentChangeSetInput): Promise<AgentChangeSet>;
+    /** Record one mutating tool call's outcome against an existing change-set. */
+    recordOperation(input: RecordAgentOperationInput): Promise<AgentOperation>;
+    /** Finalize a change-set once the turn ends, with its accumulated token totals. */
+    completeChangeSet(organizationId: string, id: string, input: CompleteAgentChangeSetInput): Promise<void>;
+    /** Read one change-set with its operations (org-scoped) — what the undo endpoint acts on. */
+    getChangeSet(organizationId: string, id: string): Promise<AgentChangeSetWithOperations | null>;
+    /** List change-sets for the org, newest first (the activity view's "Agent Changes" tab).
+     * Includes each change-set's operations so the list can show what a turn did (e.g.
+     * "create_document") without a per-row detail fetch. */
+    listChangeSets(options: ListAgentChangeSetsOptions): Promise<Page<AgentChangeSetWithOperations>>;
+}
+//# sourceMappingURL=agent-change-sets.d.ts.map

package/dist/db/interfaces/agent-change-sets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-change-sets.d.ts","sourceRoot":"","sources":["../../../src/lib/db/interfaces/agent-change-sets.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACX,cAAc,EACd,4BAA4B,EAC5B,cAAc,EACd,yBAAyB,EACzB,2BAA2B,EAC3B,yBAAyB,EACzB,0BAA0B,EAC1B,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAE/C,MAAM,WAAW,qBAAqB;IACrC,0EAA0E;IAC1E,eAAe,CAAC,KAAK,EAAE,yBAAyB,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAC3E,8EAA8E;IAC9E,eAAe,CAAC,KAAK,EAAE,yBAAyB,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAC3E,mFAAmF;IACnF,iBAAiB,CAChB,cAAc,EAAE,MAAM,EACtB,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,2BAA2B,GAChC,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB,6FAA6F;IAC7F,YAAY,CAAC,cAAc,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,4BAA4B,GAAG,IAAI,CAAC,CAAC;IAC/F;;4DAEwD;IACxD,cAAc,CAAC,OAAO,EAAE,0BAA0B,GAAG,OAAO,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC,CAAC;CACjG"}

package/dist/db/interfaces/agent-change-sets.js

@@ -0,0 +1 @@
+export {};

package/dist/db/interfaces/document.d.ts

@@ -22,16 +22,38 @@ export interface UpdateDocumentData {
     draftData?: any;
     status?: string;
     updatedBy?: string;
+    /** Compare-and-swap guard: the revision the caller last read. Omit to skip
+     *  the check (existing unconditional-write behavior). */
+    expectedRevision?: number;
+}
+/**
+ * Thrown when a write's `expectedRevision` no longer matches the document's
+ * current revision — another writer (a second tab, an AI agent, a concurrent
+ * request) saved in between the caller's read and this write. Callers should
+ * surface this distinctly from a validation error: re-fetch and let the user
+ * decide, never silently retry with an overwrite.
+ */
+export declare class RevisionConflictError extends Error {
+    readonly documentId: string;
+    readonly expectedRevision: number;
+    readonly currentRevision: number;
+    constructor(message: string, documentId: string, expectedRevision: number, currentRevision: number);
 }
 /**
  * Document adapter interface for document-specific operations
  */
 export interface DocumentAdapter {
     createDocument(data: CreateDocumentData): Promise<Document>;
-    updateDocDraft(organizationId: string, id: string, data: any, updatedBy?: string): Promise<Document | null>;
+    /**
+     * @param expectedRevision - Compare-and-swap guard. When provided, the
+     *   update only applies if the document's current revision matches;
+     *   otherwise implementations throw {@link RevisionConflictError}. Omit to
+     *   write unconditionally (last-write-wins, the pre-CAS behavior).
+     */
+    updateDocDraft(organizationId: string, id: string, data: any, updatedBy?: string, expectedRevision?: number): Promise<Document | null>;
     deleteDocById(organizationId: string, id: string): Promise<boolean>;
-    publishDoc(organizationId: string, id: string): Promise<Document | null>;
-    unpublishDoc(organizationId: string, id: string): Promise<Document | null>;
+    publishDoc(organizationId: string, id: string, expectedRevision?: number): Promise<Document | null>;
+    unpublishDoc(organizationId: string, id: string, expectedRevision?: number): Promise<Document | null>;
     countDocsByType(organizationId: string, type: string): Promise<number>;
     getDocCountsByType(organizationId: string): Promise<Record<string, number>>;
     /**

package/dist/db/interfaces/document.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"document.d.ts","sourceRoot":"","sources":["../../../src/lib/db/interfaces/document.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"document.d.ts","sourceRoot":"","sources":["../../../src/lib/db/interfaces/document.ts"],"names":[],"mappings":"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"}

package/dist/db/interfaces/document.js

@@ -1 +1,19 @@
-export {};
+/**
+ * Thrown when a write's `expectedRevision` no longer matches the document's
+ * current revision — another writer (a second tab, an AI agent, a concurrent
+ * request) saved in between the caller's read and this write. Callers should
+ * surface this distinctly from a validation error: re-fetch and let the user
+ * decide, never silently retry with an overwrite.
+ */
+export class RevisionConflictError extends Error {
+    documentId;
+    expectedRevision;
+    currentRevision;
+    constructor(message, documentId, expectedRevision, currentRevision) {
+        super(message);
+        this.documentId = documentId;
+        this.expectedRevision = expectedRevision;
+        this.currentRevision = currentRevision;
+        this.name = 'RevisionConflictError';
+    }
+}

package/dist/db/interfaces/index.d.ts

@@ -9,7 +9,9 @@ import type { ReferenceAdapter } from './reference.js';
 import type { PluginSettingsAdapter } from './plugin-settings.js';
 import type { EventJobAdapter } from './events.js';
 import type { PluginStorageAdapter } from './plugin-storage.js';
+import type { AgentChangeSetAdapter } from './agent-change-sets.js';
 export type { DocumentAdapter, DocumentFilters, CreateDocumentData, UpdateDocumentData } from './document.js';
+export { RevisionConflictError } from './document.js';
 export type { AssetAdapter, CreateAssetData, UpdateAssetData } from './asset.js';
 export type { UserProfileAdapter, NewUserProfileData } from './user.js';
 export type { SchemaAdapter } from './schema.js';
@@ -20,11 +22,12 @@ export type { ReferenceAdapter, BackReferenceRow, BackReferenceLookup } from './
 export type { PluginSettingsAdapter, PluginSettingsRow } from './plugin-settings.js';
 export type { EventJobAdapter } from './events.js';
 export type { PluginStorageAdapter, PluginStorageRecord, CreatePluginRecordInput, ListPluginRecordsOptions } from './plugin-storage.js';
+export type { AgentChangeSetAdapter } from './agent-change-sets.js';
 /**
  * Combined database adapter interface
  * Extends all entity-specific adapters for full database functionality
  */
-export interface DatabaseAdapter extends DocumentAdapter, AssetAdapter, UserProfileAdapter, SchemaAdapter, OrganizationAdapter, InstanceAdapter, RolesAdapter, ReferenceAdapter, PluginSettingsAdapter, EventJobAdapter, PluginStorageAdapter {
+export interface DatabaseAdapter extends DocumentAdapter, AssetAdapter, UserProfileAdapter, SchemaAdapter, OrganizationAdapter, InstanceAdapter, RolesAdapter, ReferenceAdapter, PluginSettingsAdapter, EventJobAdapter, PluginStorageAdapter, AgentChangeSetAdapter {
     connect?(): Promise<void>;
     disconnect?(): Promise<void>;
     isHealthy(): Promise<boolean>;

package/dist/db/interfaces/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/db/interfaces/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/db/interfaces/index.ts"],"names":[],"mappings":"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"}

package/dist/db/interfaces/index.js

@@ -1 +1 @@
-export {};
+export { RevisionConflictError } from './document.js';

package/dist/document-refresh.svelte.d.ts

@@ -1,3 +1,5 @@
 export declare function getDocumentVersion(documentId: string | null | undefined): number;
 export declare function notifyDocumentChanged(documentId: string): void;
+export declare function getCollectionVersion(docType: string | null | undefined): number;
+export declare function notifyCollectionChanged(docType: string): void;
 //# sourceMappingURL=document-refresh.svelte.d.ts.map

package/dist/document-refresh.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"document-refresh.svelte.d.ts","sourceRoot":"","sources":["../src/lib/document-refresh.svelte.ts"],"names":[],"mappings":"AAcA,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAGhF;AAED,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAG9D"}
+{"version":3,"file":"document-refresh.svelte.d.ts","sourceRoot":"","sources":["../src/lib/document-refresh.svelte.ts"],"names":[],"mappings":"AAcA,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAGhF;AAED,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAG9D;AAQD,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAG/E;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAG7D"}

package/dist/document-refresh.svelte.js

@@ -19,3 +19,18 @@ export function notifyDocumentChanged(documentId) {
         return;
     versions.set(documentId, (versions.get(documentId) ?? 0) + 1);
 }
+// Same pattern, keyed by document *type* instead of id — so a collection's list view can
+// refetch when a document of that type is created/deleted/updated elsewhere in the session
+// (typically the agent chat, which mutates documents server-side with no UI of its own to
+// keep a list view in sync).
+const collectionVersions = new SvelteMap();
+export function getCollectionVersion(docType) {
+    if (!docType)
+        return 0;
+    return collectionVersions.get(docType) ?? 0;
+}
+export function notifyCollectionChanged(docType) {
+    if (!docType)
+        return;
+    collectionVersions.set(docType, (collectionVersions.get(docType) ?? 0) + 1);
+}

package/dist/document-workspace-registry.svelte.d.ts

@@ -0,0 +1,15 @@
+import type { DocumentWorkspace } from './types/document-workspace.js';
+export interface RegisteredDocumentWorkspace {
+    documentId: string;
+    collection: string;
+    workspace: DocumentWorkspace;
+}
+export declare const documentWorkspaceRegistry: {
+    readonly current: RegisteredDocumentWorkspace | null;
+    register(entry: RegisteredDocumentWorkspace): void;
+    /** Id-checked: an editor that already unmounted (and cleared with its own id) can't
+     * clobber a newer registration from a different document that mounted in its place
+     * during fast navigation. */
+    clear(documentId: string): void;
+};
+//# sourceMappingURL=document-workspace-registry.svelte.d.ts.map

package/dist/document-workspace-registry.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-workspace-registry.svelte.d.ts","sourceRoot":"","sources":["../src/lib/document-workspace-registry.svelte.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAEpE,MAAM,WAAW,2BAA2B;IAC3C,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,iBAAiB,CAAC;CAC7B;AAqBD,eAAO,MAAM,yBAAyB;;oBAZpB,2BAA2B;IAG3C;;iCAE6B;sBACX,MAAM;CAMgD,CAAC"}

package/dist/document-workspace-registry.svelte.js

@@ -0,0 +1,30 @@
+// document-workspace-registry.svelte.ts — module-level singleton, same pattern as
+// agent-chat-state.svelte.ts.
+//
+// Answers "which live document session is open in this tab, and here's a handle to it" —
+// deliberately named/scoped that way rather than as an AI-specific registry, since it's the
+// same lookup a future multiplayer presence feature would need (see
+// types/document-workspace.ts). `DocumentEditor.svelte` registers its `DocumentWorkspace`
+// here while mounted and clears it on unmount; `AgentChat.svelte` reads it to decide whether
+// to bridge a chat request into the currently open document.
+//
+// Not persisted to localStorage — a live object reference is meaningless across a reload.
+function createDocumentWorkspaceRegistry() {
+    let current = $state(null);
+    return {
+        get current() {
+            return current;
+        },
+        register(entry) {
+            current = entry;
+        },
+        /** Id-checked: an editor that already unmounted (and cleared with its own id) can't
+         * clobber a newer registration from a different document that mounted in its place
+         * during fast navigation. */
+        clear(documentId) {
+            if (current?.documentId === documentId)
+                current = null;
+        }
+    };
+}
+export const documentWorkspaceRegistry = createDocumentWorkspaceRegistry();

package/dist/field-validation/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/lib/field-validation/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAKxD,MAAM,WAAW,eAAe;IAC/B,KAAK,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;IACpC,OAAO,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,wBAAwB;IACxC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;IACnD,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAUrD;AAYD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAmC9E;AAED;;GAEG;AACH,wBAAsB,aAAa,CAClC,KAAK,EAAE,KAAK,EACZ,KAAK,EAAE,GAAG,EACV,OAAO,GAAE,GAAQ,GACf,OAAO,CAAC;IACV,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,eAAe,EAAE,CAAC;CAC1B,CAAC,CA6ID;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,OAAO,GAAG,MAAM,CAO/D;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,oBAAoB,CACzC,MAAM,EAAE,UAAU,EAClB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACzB,OAAO,GAAE,GAAQ,GACf,OAAO,CAAC,wBAAwB,CAAC,CA2DnC"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/lib/field-validation/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAc,KAAK,EAAE,UAAU,EAAiB,MAAM,gBAAgB,CAAC;AAKnF,MAAM,WAAW,eAAe;IAC/B,KAAK,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;IACpC,OAAO,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,wBAAwB;IACxC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;IACnD,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAUrD;AAYD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAmC9E;AAwMD;;GAEG;AACH,wBAAsB,aAAa,CAClC,KAAK,EAAE,KAAK,EACZ,KAAK,EAAE,GAAG,EACV,OAAO,GAAE,GAAQ,GACf,OAAO,CAAC;IACV,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,eAAe,EAAE,CAAC;CAC1B,CAAC,CAsJD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,OAAO,GAAG,MAAM,CAO/D;AAwCD;;;;;;;;;;;;GAYG;AACH,wBAAsB,oBAAoB,CACzC,MAAM,EAAE,UAAU,EAClB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACzB,OAAO,GAAE,GAAQ,GACf,OAAO,CAAC,wBAAwB,CAAC,CA0BnC"}

package/dist/field-validation/utils.js

@@ -81,6 +81,180 @@ export function validateValueShape(field, value) {
             return null;
     }
 }
+/**
+ * Find which `of` entry an array item belongs to. Mirrors ArrayField.svelte's own
+ * resolution (`ref.name === item._type || ref.type === item._type`). An item
+ * carrying an explicit `_type` must match one of the declared entries — an
+ * unrecognized `_type` is an error, never silently coerced to some other entry,
+ * even when only one type is declared. The single-entry fallback only applies
+ * when the item has no `_type` tag at all (untagged items in a single-type array).
+ */
+function resolveArrayItemTypeRef(of, item) {
+    if (isPlainObject(item) && typeof item._type === 'string') {
+        return of.find((ref) => ref.name === item._type || ref.type === item._type);
+    }
+    if (of.length === 1)
+        return of[0];
+    return undefined;
+}
+/**
+ * A leaf field error message is always formatted as `Field "<path>" <reason>`
+ * (see the bottom of `validateField`). When that message becomes an input to a
+ * shallower level of array-item recursion, re-wrapping it verbatim would nest
+ * "Field ..." text once per level. Instead, pull the deeper path back out so the
+ * caller can extend it into one clean breadcrumb and keep only the reason.
+ */
+function splitFieldMessage(message) {
+    const match = message.match(/^Field "([^"]+)"\s*(.*)$/s);
+    return match
+        ? { path: match[1] ?? null, reason: match[2] ?? message }
+        : { path: null, reason: message };
+}
+/**
+ * Shape-check a single Portable Text text block (`_type: 'block'`) — `_key`, `children`
+ * (spans and/or inline objects), and `markDefs` all need to be the shape
+ * portable-text-serializer.ts produces, since nothing else in this write path checks it.
+ * A source that isn't the TipTap editor (an agent's `content_patch_fields` call, an
+ * imported document) has no other gate before this reaches storage.
+ */
+function validatePortableTextBlock(item, itemPath) {
+    if (!isPlainObject(item)) {
+        return [
+            {
+                field: itemPath,
+                errors: [`expected a Portable Text block object, got ${describeValue(item)}`]
+            }
+        ];
+    }
+    const errors = [];
+    if (typeof item._key !== 'string' || item._key.length === 0) {
+        errors.push('is missing a non-empty "_key"');
+    }
+    if (item.style !== undefined && typeof item.style !== 'string') {
+        errors.push(`"style" must be a string, got ${describeValue(item.style)}`);
+    }
+    if (item.listItem !== undefined && typeof item.listItem !== 'string') {
+        errors.push(`"listItem" must be a string, got ${describeValue(item.listItem)}`);
+    }
+    if (item.level !== undefined && typeof item.level !== 'number') {
+        errors.push(`"level" must be a number, got ${describeValue(item.level)}`);
+    }
+    if (!Array.isArray(item.children)) {
+        errors.push(`"children" must be an array, got ${describeValue(item.children)}`);
+    }
+    else {
+        item.children.forEach((child, childIndex) => {
+            const childLabel = `child[${childIndex}]`;
+            if (!isPlainObject(child)) {
+                errors.push(`${childLabel} expected an object, got ${describeValue(child)}`);
+                return;
+            }
+            if (typeof child._type !== 'string' || child._type.length === 0) {
+                errors.push(`${childLabel} is missing a "_type"`);
+            }
+            if (typeof child._key !== 'string' || child._key.length === 0) {
+                errors.push(`${childLabel} is missing a non-empty "_key"`);
+            }
+            if (child._type === 'span') {
+                if (typeof child.text !== 'string') {
+                    errors.push(`${childLabel} (span) "text" must be a string, got ${describeValue(child.text)}`);
+                }
+                if (child.marks !== undefined && !Array.isArray(child.marks)) {
+                    errors.push(`${childLabel} (span) "marks" must be an array, got ${describeValue(child.marks)}`);
+                }
+            }
+        });
+    }
+    if (item.markDefs !== undefined) {
+        if (!Array.isArray(item.markDefs)) {
+            errors.push(`"markDefs" must be an array, got ${describeValue(item.markDefs)}`);
+        }
+        else {
+            item.markDefs.forEach((def, defIndex) => {
+                if (!isPlainObject(def)) {
+                    errors.push(`markDefs[${defIndex}] expected an object, got ${describeValue(def)}`);
+                    return;
+                }
+                if (typeof def._type !== 'string' || def._type.length === 0) {
+                    errors.push(`markDefs[${defIndex}] is missing a "_type"`);
+                }
+                if (typeof def._key !== 'string' || def._key.length === 0) {
+                    errors.push(`markDefs[${defIndex}] is missing a non-empty "_key"`);
+                }
+            });
+        }
+    }
+    return errors.length > 0 ? [{ field: itemPath, errors }] : [];
+}
+/**
+ * Recursively validate each array item against the type it resolves to in `of`.
+ * This is the check that was previously entirely missing: `validateValueShape`
+ * only confirmed the field's value IS an array, never that its items match `of` —
+ * so a mistyped or malformed array item (wrong `_type`, missing required nested
+ * fields) passed validation silently regardless of whether `of` was well-formed.
+ *
+ * Named types in `of` that aren't inline objects (`fields` absent) — i.e. a
+ * reference to another registered schema by name — aren't resolvable here: this
+ * module has no schema registry. Those items are left unvalidated, same as
+ * before this fix, rather than guessed at.
+ */
+async function validateArrayItems(field, items, context) {
+    const of = field.of ?? [];
+    const results = [];
+    for (let index = 0; index < items.length; index++) {
+        const item = items[index];
+        const itemPath = `${field.name}[${index}]`;
+        const typeRef = resolveArrayItemTypeRef(of, item);
+        if (!typeRef) {
+            const gotType = isPlainObject(item) && typeof item._type === 'string' ? item._type : describeValue(item);
+            const declared = of.map((t) => t.name ?? t.type).join(', ') || '(none declared)';
+            results.push({
+                field: itemPath,
+                errors: [
+                    `has type "${gotType}", which is not one of the declared array item types: ${declared}`
+                ]
+            });
+            continue;
+        }
+        // Portable Text text blocks (`_type: 'block'`) — the shape the TipTap editor always
+        // produces (portable-text-serializer.ts), but nothing an agent-authored patch is bound
+        // to. Custom block types (any other `_type` in `of`) fall through to the `typeRef.fields`
+        // branch below and get full field validation already; this is the one shape the rest of
+        // this function never checked.
+        if (typeRef.type === 'block') {
+            results.push(...validatePortableTextBlock(item, itemPath));
+            continue;
+        }
+        if (typeRef.type === 'reference') {
+            if (!isPlainObject(item) || typeof item._ref !== 'string') {
+                results.push({
+                    field: itemPath,
+                    errors: [
+                        `expected a reference object { _type: 'reference', _ref: '<documentId>' }, got ${describeValue(item)}`
+                    ]
+                });
+            }
+            continue;
+        }
+        if (typeRef.fields) {
+            if (!isPlainObject(item)) {
+                results.push({
+                    field: itemPath,
+                    errors: [`expected an object, got ${describeValue(item)}`]
+                });
+                continue;
+            }
+            const nested = await validateFieldSet(typeRef.fields, item, context);
+            for (const err of nested) {
+                for (const rawMessage of err.errors) {
+                    const { path, reason } = splitFieldMessage(rawMessage);
+                    results.push({ field: `${itemPath}.${path ?? err.field}`, errors: [reason] });
+                }
+            }
+        }
+    }
+    return results;
+}
 /**
  * Validate a field value against its validation rules
  */
@@ -102,6 +276,14 @@ export async function validateField(field, value, context = {}) {
             errors: [{ level: 'error', message: `Field "${field.name}" ${shapeError}` }]
         };
     }
+    // Array items are never validated by the shape check above (it only confirms
+    // the value IS an array) — recurse into each item against `field.of` here.
+    if (field.type === 'array' && Array.isArray(value)) {
+        const itemErrors = await validateArrayItems(field, value, context);
+        for (const err of itemErrors) {
+            allErrors.push({ level: 'error', message: `Field "${err.field}" ${err.errors.join('; ')}` });
+        }
+    }
     // Add automatic validation for date/datetime/url fields based on type
     if (field.type === 'date') {
         const dateField = field;
@@ -207,6 +389,34 @@ export function getValidationClasses(hasErrors) {
     // No green styling for success - only show red for errors
     return '';
 }
+/**
+ * Validate a flat set of fields against their values in `data`. Shared by
+ * top-level document validation and, recursively, by array-item/nested-object
+ * validation — `context.document` carries the full top-level document through
+ * either way, since it's set once by the top-level caller and left untouched on
+ * recursive calls (so cross-field `Rule.custom((v, { document }) => ...)`
+ * validators still see the whole document, not just the nested item).
+ */
+async function validateFieldSet(fields, data, context) {
+    const validationErrors = [];
+    for (const field of fields) {
+        const value = data[field.name];
+        const result = await validateField(field, value, {
+            ...context,
+            document: context.document !== undefined ? context.document : data
+        });
+        if (!result.isValid) {
+            const errorMessages = result.errors.filter((e) => e.level === 'error').map((e) => e.message);
+            if (errorMessages.length > 0) {
+                validationErrors.push({
+                    field: field.name,
+                    errors: errorMessages
+                });
+            }
+        }
+    }
+    return validationErrors;
+}
 /**
  * Validate an entire document's data against a schema
  * This function:
@@ -225,41 +435,13 @@ export async function validateDocumentData(schema, data, context = {}) {
         schemaName: schema.name,
         data
     });
-    const validationErrors = [];
     // Normalize date fields: convert to ISO for storage, user format for validation
     const { normalizedData, dataForValidation } = normalizeDateFields(data, schema);
     cmsLogger.debug('[validateDocumentData]', 'After normalization', {
         normalizedData,
         dataForValidation
     });
-    // Validate each field using the user-formatted data
-    for (const field of schema.fields) {
-        const value = dataForValidation[field.name];
-        cmsLogger.debug('[validateDocumentData]', `Validating field "${field.name}"`, {
-            type: field.type,
-            value
-        });
-        // Build the document context here from the data we're already validating —
-        // no need for callers to pass it. Cross-field validators read it via
-        // `Rule.custom((v, { document }) => ...)`, matching ValidationContext.
-        const result = await validateField(field, value, {
-            ...context,
-            document: dataForValidation
-        });
-        cmsLogger.debug('[validateDocumentData]', `Field "${field.name}" validation result`, {
-            isValid: result.isValid,
-            errors: result.errors
-        });
-        if (!result.isValid) {
-            const errorMessages = result.errors.filter((e) => e.level === 'error').map((e) => e.message);
-            if (errorMessages.length > 0) {
-                validationErrors.push({
-                    field: field.name,
-                    errors: errorMessages
-                });
-            }
-        }
-    }
+    const validationErrors = await validateFieldSet(schema.fields, dataForValidation, context);
     cmsLogger.debug('[validateDocumentData]', 'Final result', {
         isValid: validationErrors.length === 0,
         errors: validationErrors

package/dist/hooks.d.ts

@@ -5,6 +5,7 @@ import type { DatabaseAdapter } from './db/index.js';
 import type { AssetService } from './services/asset-service.js';
 import type { StorageAdapter } from './storage/interfaces/storage.js';
 import type { EmailAdapter } from './email/index.js';
+import type { AIProviderAdapter } from './ai/index.js';
 import type { AuthProvider } from './auth/provider.js';
 import type { GraphQLSettings } from './graphql/index.js';
 import type { Logger } from './utils/logger.js';
@@ -20,6 +21,7 @@ export interface CMSInstances {
     storageAdapter: StorageAdapter;
     databaseAdapter: DatabaseAdapter;
     emailAdapter?: EmailAdapter | null;
+    aiProvider?: AIProviderAdapter | null;
     cmsEngine: CMSEngine;
     localAPI: LocalAPI;
     rolesService: RolesService;

package/dist/hooks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../src/lib/hooks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,KAAK,EAAW,IAAI,EAAE,MAAM,MAAM,CAAC;AAC1C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAO7C,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAC3E,OAAO,EAAa,SAAS,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,EAAkB,KAAK,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,EAAsB,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAE3E,OAAO,EAIN,KAAK,QAAQ,EACb,MAAM,oBAAoB,CAAC;AAG5B,MAAM,WAAW,YAAY;IAC5B,MAAM,EAAE,SAAS,CAAC;IAClB,YAAY,EAAE,YAAY,CAAC;IAC3B,cAAc,EAAE,cAAc,CAAC;IAC/B,eAAe,EAAE,eAAe,CAAC;IACjC,YAAY,CAAC,EAAE,YAAY,GAAG,IAAI,CAAC;IACnC,SAAS,EAAE,SAAS,CAAC;IACrB,QAAQ,EAAE,QAAQ,CAAC;IACnB,YAAY,EAAE,YAAY,CAAC;IAC3B,uEAAuE;IACvE,qBAAqB,EAAE,qBAAqB,CAAC;IAC7C,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,eAAe,CAAC,EAAE,eAAe,GAAG,IAAI,CAAC;IACzC,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;IACvB,sFAAsF;IACtF,YAAY,EAAE,YAAY,CAAC;CAC3B;AAsCD;;;;;;;;;GASG;AACH,wBAAgB,0BAA0B,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI,CAGrE;AAgBD,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,CA+MvD"}
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../src/lib/hooks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,KAAK,EAAW,IAAI,EAAE,MAAM,MAAM,CAAC;AAC1C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAO7C,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAC3E,OAAO,EAAa,SAAS,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,EAAkB,KAAK,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,EAAsB,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAE3E,OAAO,EAIN,KAAK,QAAQ,EACb,MAAM,oBAAoB,CAAC;AAG5B,MAAM,WAAW,YAAY;IAC5B,MAAM,EAAE,SAAS,CAAC;IAClB,YAAY,EAAE,YAAY,CAAC;IAC3B,cAAc,EAAE,cAAc,CAAC;IAC/B,eAAe,EAAE,eAAe,CAAC;IACjC,YAAY,CAAC,EAAE,YAAY,GAAG,IAAI,CAAC;IACnC,UAAU,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACtC,SAAS,EAAE,SAAS,CAAC;IACrB,QAAQ,EAAE,QAAQ,CAAC;IACnB,YAAY,EAAE,YAAY,CAAC;IAC3B,uEAAuE;IACvE,qBAAqB,EAAE,qBAAqB,CAAC;IAC7C,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,eAAe,CAAC,EAAE,eAAe,GAAG,IAAI,CAAC;IACzC,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;IACvB,sFAAsF;IACtF,YAAY,EAAE,YAAY,CAAC;CAC3B;AAsCD;;;;;;;;;GASG;AACH,wBAAgB,0BAA0B,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI,CAGrE;AAgBD,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,CAiNvD"}