@agent-native/core 0.176.1 → 0.176.2-nightly-20260831185956

package/corpus/templates/content/app/components/editor/DocumentEditor.tsx

@@ -41,6 +41,7 @@ import {
   contentBlockRegistry,
   createContentBlockRenderContext,
 } from "@/blocks/contentBlockRegistry";
+import { QueryErrorState } from "@/components/QueryErrorState";
 import {
   createContentSpaceSelectionQueue,
   SELECTED_CONTENT_SPACE_STORAGE_KEY,
@@ -282,7 +283,7 @@ export function DocumentEditor({
     queriedDocument?.id === documentId ? queriedDocument : undefined;
 
   if (isError && !document) {
-    return <DocumentUnavailable onOpenHome={() => navigate("/")} />;
+    return <DocumentUnavailable onOpenHome={() => navigate("/home")} />;
   }
 
   // If we have a doc (real or optimistic from create) render the editor —
@@ -465,6 +466,7 @@ export function documentEditorBreadcrumbItems(
   const membership = document.databaseMembership;
   if (
     !membership ||
+    !membership.databaseDocumentId ||
     pageItems.some((item) => item.id === membership.databaseDocumentId)
   ) {
     return pageItems;
@@ -733,7 +735,7 @@ function DocumentEditorBody({
       } else {
         await deleteDocument.mutateAsync({ id: documentId });
       }
-      void navigate("/", { replace: true, flushSync: true });
+      void navigate("/home", { replace: true, flushSync: true });
     } catch (error) {
       toast.error(t("sidebar.failedDeletePage"), {
         description:
@@ -893,6 +895,7 @@ function DocumentEditorBody({
     ydoc,
     awareness,
     isSynced: collabSynced,
+    initialization: collabInitialization,
     activeUsers,
     agentActive,
     agentPresent,
@@ -902,18 +905,24 @@ function DocumentEditorBody({
     user: currentUser,
   });
   const bodyHydrationPending = documentBodyHydrationIsPending(document);
+  const collabInitializationFailed =
+    collabEnabled && collabInitialization.status === "error";
   const editorCanEdit =
     canEdit &&
     !bodyHydrationPending &&
     !localSourceMissing &&
     (!isLocalFileDocument || localSourceAccess === "available") &&
-    (isLocalFileDocument || collabSynced);
-  // Bind an editor's stable Y.Doc on its first mount, even while the initial
-  // state is loading. Editability and the reconcile hook share the exact
-  // `collabSynced` boundary; "not loading" can precede persisted Y.Doc
-  // projection and briefly expose duplicated blocks. Keeping the Y.Doc binding
-  // stable avoids a snapshot -> collab remount while the read-only editor waits.
-  const collabEditorEnabled = collabEnabled && canEdit && !bodyHydrationPending;
+    (isLocalFileDocument || collabSynced) &&
+    !collabInitializationFailed;
+  // Yjs only becomes a body source after the authoritative initial state is
+  // ready. Until then the canonical SQL body stays visible and read-only.
+  const collabEditorEnabled =
+    collabEnabled &&
+    canEdit &&
+    !bodyHydrationPending &&
+    collabSynced &&
+    collabInitialization.status === "ready" &&
+    !collabInitializationFailed;
   canEditRef.current = editorCanEdit;
 
   // Viewers intentionally join awareness so they receive live cursors, but
@@ -1591,9 +1600,23 @@ function DocumentEditorBody({
           updates.content !== undefined
             ? (lastSavedContentRef.current.updatedAt ?? undefined)
             : undefined;
+        const loadedContentWasEmpty =
+          updates.content !== undefined
+            ? isEffectivelyEmptyDocumentContent(
+                lastSavedContentRef.current.content,
+              )
+            : undefined;
+        const loadedUpdatedAt =
+          updates.content !== undefined
+            ? (lastSavedContentRef.current.updatedAt ?? undefined)
+            : undefined;
         const body = JSON.stringify({
           id: documentId,
           ...updates,
+          ...(loadedContentWasEmpty !== undefined
+            ? { loadedContentWasEmpty }
+            : {}),
+          ...(loadedUpdatedAt !== undefined ? { loadedUpdatedAt } : {}),
           ...(baseUpdatedAt !== undefined ? { baseUpdatedAt } : {}),
         });
         const ok = fetch(url, {
@@ -2431,58 +2454,68 @@ function DocumentEditorBody({
                       // header/collapsible shell when the row has multiple Blocks
                       // fields.
                       const primaryEditor = (
-                        <VisualEditor
-                          key={visualEditorInstanceKey({
-                            documentId,
-                            documentUpdatedAt: document.updatedAt,
-                            isLocalFileDocument,
-                            canEdit,
-                            collabEditorEnabled,
-                            hasYDoc: Boolean(ydoc),
-                            localFileSyncRevision,
-                          })}
-                          documentId={documentId}
-                          content={
-                            isLocalFileDocument
-                              ? localContent
-                              : document.content
-                          }
-                          contentUpdatedAt={
-                            isLocalFileDocument
-                              ? (localContentUpdatedAt ?? document.updatedAt)
-                              : document.updatedAt
-                          }
-                          onChange={handleContentChange}
-                          onSaveContent={handleContentSaveNow}
-                          ydoc={collabEditorEnabled ? ydoc : null}
-                          collabSynced={
-                            collabEditorEnabled ? collabSynced : true
-                          }
-                          awareness={collabEditorEnabled ? awareness : null}
-                          user={currentUser}
-                          editable={editorCanEdit}
-                          localFileMode={isLocalFileDocument}
-                          localFilePath={
-                            isLocalFileDocument ? document.source?.path : null
-                          }
-                          onComment={canComment ? handleComment : undefined}
-                          commentThreads={threads ?? []}
-                          activeThreadId={activeThreadId}
-                          pendingHighlight={pendingComment?.range ?? null}
-                          onActivateThread={
-                            !isLocalFileDocument
-                              ? activateCommentThread
-                              : undefined
-                          }
-                          onJoinTitle={joinFirstBodyBlockToTitle}
-                          notionPageLinks={notionPageLinks}
-                          onOpenNotionPageLink={handleOpenNotionPageLink}
-                          notionPageId={document.notionPageId}
-                          onHistoryControllerChange={
-                            handleHistoryControllerChange
-                          }
-                          onHistoryStateChange={handleHistoryStateChange}
-                        />
+                        <>
+                          {canEdit && collabInitializationFailed ? (
+                            <div data-collab-initialization-error role="alert">
+                              <QueryErrorState
+                                compact
+                                onRetry={() => globalThis.location.reload()}
+                              />
+                            </div>
+                          ) : null}
+                          <VisualEditor
+                            key={visualEditorInstanceKey({
+                              documentId,
+                              documentUpdatedAt: document.updatedAt,
+                              isLocalFileDocument,
+                              canEdit,
+                              collabEditorEnabled,
+                              hasYDoc: Boolean(ydoc),
+                              localFileSyncRevision,
+                            })}
+                            documentId={documentId}
+                            content={
+                              isLocalFileDocument
+                                ? localContent
+                                : document.content
+                            }
+                            contentUpdatedAt={
+                              isLocalFileDocument
+                                ? (localContentUpdatedAt ?? document.updatedAt)
+                                : document.updatedAt
+                            }
+                            onChange={handleContentChange}
+                            onSaveContent={handleContentSaveNow}
+                            ydoc={collabEditorEnabled ? ydoc : null}
+                            collabSynced={
+                              collabEditorEnabled ? collabSynced : true
+                            }
+                            awareness={collabEditorEnabled ? awareness : null}
+                            user={currentUser}
+                            editable={editorCanEdit}
+                            localFileMode={isLocalFileDocument}
+                            localFilePath={
+                              isLocalFileDocument ? document.source?.path : null
+                            }
+                            onComment={canComment ? handleComment : undefined}
+                            commentThreads={threads ?? []}
+                            activeThreadId={activeThreadId}
+                            pendingHighlight={pendingComment?.range ?? null}
+                            onActivateThread={
+                              !isLocalFileDocument
+                                ? activateCommentThread
+                                : undefined
+                            }
+                            onJoinTitle={joinFirstBodyBlockToTitle}
+                            notionPageLinks={notionPageLinks}
+                            onOpenNotionPageLink={handleOpenNotionPageLink}
+                            notionPageId={document.notionPageId}
+                            onHistoryControllerChange={
+                              handleHistoryControllerChange
+                            }
+                            onHistoryStateChange={handleHistoryStateChange}
+                          />
+                        </>
                       );
 
                       // Only database rows have Blocks fields. Standalone pages

package/corpus/templates/content/app/components/editor/DocumentProperties.tsx

@@ -162,8 +162,8 @@ function tWithFallback(
 
 interface DocumentPropertiesProps {
   documentId: string;
-  databaseId: string;
-  databaseDocumentId: string;
+  databaseId: string | null;
+  databaseDocumentId: string | null;
   canEdit: boolean;
   popoversPortalled?: boolean;
 }
@@ -811,6 +811,17 @@ export function DocumentProperties({
     databaseId,
     data,
   );
+  const canEditValues =
+    canEdit &&
+    loaded &&
+    databaseDocumentId !== null &&
+    data.canEditValues === true;
+  const canManageSchema =
+    canEdit &&
+    loaded &&
+    databaseId !== null &&
+    databaseDocumentId !== null &&
+    data.canManageSchema === true;
   // Blocks fields are rendered as body content (below the database/title), not
   // as scalar property rows in this panel — exclude them here.
   const properties = (loaded ? data.properties : []).filter(
@@ -835,8 +846,9 @@ export function DocumentProperties({
               key={property.definition.id}
               property={property}
               documentId={documentId}
-              databaseDocumentId={databaseDocumentId}
-              canEdit={canEdit}
+              databaseDocumentId={databaseDocumentId ?? documentId}
+              canEditValues={canEditValues}
+              canManageSchema={canManageSchema}
               popoversPortalled={popoversPortalled}
               t={t}
             />
@@ -844,7 +856,7 @@ export function DocumentProperties({
         </div>
       ) : null}
 
-      {loaded && canEdit && hiddenProperties.length > 0 ? (
+      {loaded && canManageSchema && hiddenProperties.length > 0 ? (
         <HiddenPropertiesMenu
           documentId={documentId}
           databaseId={databaseId}
@@ -853,7 +865,7 @@ export function DocumentProperties({
         />
       ) : null}
 
-      {loaded && canEdit && databaseId ? (
+      {loaded && canManageSchema && databaseId ? (
         <AddProperty
           documentId={documentId}
           databaseId={databaseId}
@@ -942,14 +954,16 @@ function PropertyRow({
   property,
   documentId,
   databaseDocumentId,
-  canEdit,
+  canEditValues,
+  canManageSchema,
   popoversPortalled,
   t,
 }: {
   property: DocumentProperty;
   documentId: string;
   databaseDocumentId: string;
-  canEdit: boolean;
+  canEditValues: boolean;
+  canManageSchema: boolean;
   popoversPortalled: boolean;
   t: TFunction;
 }) {
@@ -962,7 +976,7 @@ function PropertyRow({
 
   return (
     <div className="grid min-h-8 grid-cols-[160px_minmax(0,1fr)] items-start gap-3 rounded px-1 py-1 text-sm hover:bg-muted/40">
-      {canEdit && !property.definition.systemRole ? (
+      {canManageSchema && !property.definition.systemRole ? (
         <PropertyManagementPopover
           property={property}
           documentId={documentId}
@@ -991,7 +1005,7 @@ function PropertyRow({
           )}
         </div>
       )}
-      {canEdit && property.editable ? (
+      {canEditValues && property.editable ? (
         <PropertyValuePopover
           property={property}
           documentId={documentId}

package/corpus/templates/content/app/components/editor/database/DatabaseView.tsx

@@ -7,6 +7,7 @@ import {
 } from "@agent-native/core/client/hooks";
 import { useT } from "@agent-native/core/client/i18n";
 import {
+  BuilderConnectPopover,
   useBuilderConnectFlow,
   useBuilderStatus,
 } from "@agent-native/core/client/settings";
@@ -8366,6 +8367,7 @@ function DatabaseSettingsSourcePanel({
         : [{ id: "builder-space", name: dbText("builderSpace") }];
   const builderSpaceLabel = builderSpaces[0]?.name ?? builderOrgName;
   const connect = useBuilderConnectFlow({
+    provisionAccount: true,
     trackingSource: "database_source_panel",
     onConnected: () => {
       void builderStatus.refetch();
@@ -8571,19 +8573,20 @@ function DatabaseSettingsSourcePanel({
             {dbText("connectYourBuilderAccountToBrowseItsSpaces")}
           </div>
           <div>
-            <Button
-              type="button"
-              size="sm"
-              disabled={!canEdit || connect.connecting}
-              onClick={() => connect.start()}
-            >
-              {connect.connecting ? (
-                <Spinner className="mr-1.5 size-3.5" />
-              ) : (
-                <IconExternalLink className="mr-1.5 size-3.5" />
-              )}
-              Connect Builder
-            </Button>
+            <BuilderConnectPopover flow={connect}>
+              <Button
+                type="button"
+                size="sm"
+                disabled={!canEdit || connect.connecting}
+              >
+                {connect.connecting ? (
+                  <Spinner className="mr-1.5 size-3.5" />
+                ) : (
+                  <IconExternalLink className="mr-1.5 size-3.5" />
+                )}
+                Connect Builder
+              </Button>
+            </BuilderConnectPopover>
           </div>
         </div>
       );

package/corpus/templates/content/app/components/editor/database/settings.tsx

@@ -1,5 +1,6 @@
 import { useCodeMode } from "@agent-native/core/client/agent-chat";
 import {
+  BuilderConnectPopover,
   useBuilderConnectFlow,
   useBuilderStatus,
 } from "@agent-native/core/client/settings";
@@ -702,6 +703,7 @@ function DatabaseSettingsSourcePanel({
         : [{ id: "builder-space", name: dbText("builderSpace") }];
   const builderSpaceLabel = builderSpaces[0]?.name ?? builderOrgName;
   const connect = useBuilderConnectFlow({
+    provisionAccount: true,
     trackingSource: "database_source_panel",
     onConnected: () => {
       void builderStatus.refetch();
@@ -869,19 +871,20 @@ function DatabaseSettingsSourcePanel({
             {dbText("connectYourBuilderAccountToBrowseItsSpaces")}
           </div>
           <div>
-            <Button
-              type="button"
-              size="sm"
-              disabled={!canEdit || connect.connecting}
-              onClick={() => connect.start()}
-            >
-              {connect.connecting ? (
-                <Spinner className="mr-1.5 size-3.5" />
-              ) : (
-                <IconExternalLink className="mr-1.5 size-3.5" />
-              )}
-              Connect Builder
-            </Button>
+            <BuilderConnectPopover flow={connect}>
+              <Button
+                type="button"
+                size="sm"
+                disabled={!canEdit || connect.connecting}
+              >
+                {connect.connecting ? (
+                  <Spinner className="mr-1.5 size-3.5" />
+                ) : (
+                  <IconExternalLink className="mr-1.5 size-3.5" />
+                )}
+                Connect Builder
+              </Button>
+            </BuilderConnectPopover>
           </div>
         </div>
       );

package/corpus/templates/content/app/components/layout/Layout.tsx

@@ -1,4 +1,9 @@
-import { AgentSidebar } from "@agent-native/core/client/agent-chat";
+import {
+  AgentSidebar,
+  isAssistantChatHistoryVersion,
+  type AssistantChatHistoryConfig,
+  type AssistantChatHistoryVersion,
+} from "@agent-native/core/client/agent-chat";
 import { getBrowserTabId } from "@agent-native/core/client/hooks";
 import { useT } from "@agent-native/core/client/i18n";
 import { InvitationBanner } from "@agent-native/core/client/org";
@@ -91,6 +96,34 @@ export function Layout({ children }: LayoutProps) {
         : null,
     [activeDocumentId],
   );
+  const documentChatHistory = useMemo<
+    AssistantChatHistoryConfig | undefined
+  >(() => {
+    if (!documentScope) return undefined;
+    const documentId = documentScope.id;
+    return {
+      list: {
+        action: "list-document-versions",
+        args: { documentId, includeContent: false, limit: 100 },
+        getVersions: (result: unknown) => {
+          const versions =
+            result && typeof result === "object"
+              ? (result as { versions?: unknown }).versions
+              : undefined;
+          return Array.isArray(versions)
+            ? versions.filter(isAssistantChatHistoryVersion)
+            : [];
+        },
+      },
+      restore: {
+        action: "restore-document-version",
+        args: (version: AssistantChatHistoryVersion) => ({
+          documentId,
+          versionId: version.id,
+        }),
+      },
+    };
+  }, [documentScope]);
   const isMobile = useIsMobile();
   const isNarrowDesktop = useIsNarrowDesktop();
   const [sidebarCollapsed, setSidebarCollapsed] = useState(false);
@@ -200,6 +233,7 @@ export function Layout({ children }: LayoutProps) {
             t("chat.suggestionNotion"),
           ]}
           scope={documentScope}
+          chatHistory={documentChatHistory}
           browserTabId={getBrowserTabId()}
           composerSlot={<CreativeContextComposerChip />}
         >

package/corpus/templates/content/app/components/sidebar/DocumentSidebar.tsx

@@ -1,5 +1,4 @@
 import { useCodeMode } from "@agent-native/core/client/agent-chat";
-import { appPath } from "@agent-native/core/client/api-path";
 import { DevDatabaseLink } from "@agent-native/core/client/db-admin";
 import { ExtensionSlot } from "@agent-native/core/client/extensions";
 import {
@@ -9,7 +8,7 @@ import {
 } from "@agent-native/core/client/hooks";
 import { useT } from "@agent-native/core/client/i18n";
 import { OrgSwitcher } from "@agent-native/core/client/org";
-import { FeedbackButton } from "@agent-native/core/client/ui";
+import { AgentNativeIcon, FeedbackButton } from "@agent-native/core/client/ui";
 import { SidebarFooterActions } from "@agent-native/toolkit/app-shell";
 import type {
   ContentDatabaseItem,
@@ -1463,7 +1462,7 @@ export function DocumentSidebar({
       }
 
       if (activeDeleted) {
-        void navigate(nextDocument ? `/page/${nextDocument.id}` : "/", {
+        void navigate(nextDocument ? `/page/${nextDocument.id}` : "/home", {
           replace: true,
           flushSync: true,
         });
@@ -1782,21 +1781,9 @@ export function DocumentSidebar({
       )}
       data-sidebar-brand-toggle
     >
-      <img
-        src={appPath("/agent-native-icon-light.svg")}
-        alt=""
+      <AgentNativeIcon
         aria-hidden="true"
-        width={28}
-        height={16}
-        className="block h-4 w-7 shrink-0 object-contain object-center dark:hidden"
-      />
-      <img
-        src={appPath("/agent-native-icon-dark.svg")}
-        alt=""
-        aria-hidden="true"
-        width={28}
-        height={16}
-        className="hidden h-4 w-7 shrink-0 object-contain object-center dark:block"
+        className="h-3.5 w-6 shrink-0 text-foreground"
       />
       {!isCollapsed && (
         <span className="text-base font-semibold tracking-tight">Content</span>
@@ -2437,7 +2424,7 @@ export function DocumentSidebar({
         />
       </div>
 
-      <div className="shrink-0 px-3 py-2">
+      <div className="shrink-0 px-3 py-2 empty:hidden">
         <OrgSwitcher reserveSpace />
       </div>
 

package/corpus/templates/content/app/hooks/use-document-properties.ts

@@ -31,7 +31,7 @@ type DatabaseScopedRequest = { databaseId: string };
 
 export function documentPropertiesResponseMatchesScope(
   documentId: string,
-  databaseId: string,
+  databaseId: string | null,
   data: DocumentPropertiesResponse | undefined,
 ): data is DocumentPropertiesResponse {
   return data?.documentId === documentId && data.databaseId === databaseId;
@@ -67,9 +67,11 @@ export function useDocumentProperties(
 ) {
   return useActionQuery<DocumentPropertiesResponse>(
     "list-document-properties",
-    documentId && databaseId ? { documentId, databaseId } : undefined,
+    documentId
+      ? { documentId, ...(databaseId ? { databaseId } : {}) }
+      : undefined,
     {
-      enabled: !!documentId && !!databaseId,
+      enabled: !!documentId,
       placeholderData: (prev) => prev,
     },
   );

package/corpus/templates/content/app/hooks/use-documents.ts

@@ -218,7 +218,7 @@ export async function fetchCompleteDocumentList(
 
 export function documentPropertiesQueryKey(
   documentId: string,
-  databaseId: string,
+  databaseId: string | null,
 ) {
   return [
     "action",
@@ -464,6 +464,8 @@ export function seedDatabaseItemDocumentCaches(
       {
         documentId: item.document.id,
         databaseId: item.databaseId,
+        canEditValues: false,
+        canManageSchema: false,
         properties: item.properties,
       },
     );

package/corpus/templates/content/app/hooks/use-navigation-state.ts

@@ -17,13 +17,13 @@ interface NavigationState {
  *  - `{ path }` — the `navigate` action's explicit path form.
  *  - `{ view, documentId }` — the deep-link / `/_agent-native/open` form
  *    (the open route writes the non-reserved params + view, never a `path`).
- * `view: "editor"` + `documentId` maps to `/page/<id>`, `view: "list"` to `/`.
+ * `view: "editor"` + `documentId` maps to `/page/<id>`, `view: "list"` to `/home`.
  */
 export function useNavigationState() {
   useAgentRouteState<NavigationState>({
     browserTabId: getBrowserTabId(),
     getNavigationState: ({ pathname }) => {
-      if (pathname === "/" || pathname === "") return { view: "list" };
+      if (pathname === "/home" || pathname === "") return { view: "list" };
       if (pathname.startsWith("/local-files")) return { view: "local-files" };
 
       // Document editor: /:id or /page/:id
@@ -38,7 +38,7 @@ export function useNavigationState() {
       if (cmd.path) return cmd.path;
       if (cmd.documentId) return `/page/${cmd.documentId}`;
       if (cmd.view === "local-files") return "/local-files";
-      if (cmd.view === "list") return "/";
+      if (cmd.view === "list") return "/home";
       return null;
     },
   });

package/corpus/templates/content/app/root.tsx

@@ -571,6 +571,7 @@ export default function Root() {
   // Public document paths (/p/*) SSR real content without the ClientOnly gate
   // so crawlers and unauthenticated visitors receive full markup on first visit.
   const isPublicPath = location.pathname.startsWith("/p/");
+  const isMarketingHome = location.pathname === "/";
 
   // Content's 3-way theme cycle (system/light/dark) animates the transition;
   // pass disableThemeTransitions={false} to restore that behaviour.
@@ -579,12 +580,12 @@ export default function Root() {
   // a different toasting system.
   const contentToaster = <Sonner closeButton position="bottom-left" />;
 
-  if (isPublicPath) {
+  if (isPublicPath || isMarketingHome) {
     return (
       <AppToolkitProvider>
         <AppProviders
           queryClient={queryClient}
-          isPublicPath
+          isPublicPath={isPublicPath || isMarketingHome}
           disableThemeTransitions={false}
           toaster={contentToaster}
           i18n={{
@@ -596,9 +597,13 @@ export default function Root() {
           }}
         >
           <Toaster />
-          <PublicAgentShell>
+          {isPublicPath ? (
+            <PublicAgentShell>
+              <Outlet />
+            </PublicAgentShell>
+          ) : (
             <Outlet />
-          </PublicAgentShell>
+          )}
         </AppProviders>
       </AppToolkitProvider>
     );