@agent-native/core 0.81.3 → 0.83.0

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

@@ -151,6 +151,7 @@ import {
   useExecuteBuilderSourceExecution,
   useMoveDatabaseItem,
   usePrepareBuilderSourceReview,
+  useProcessBuilderBodyHydration,
   useRefreshContentDatabaseSource,
   useSetContentDatabaseSourceWriteMode,
   useSuggestSourceJoinKey,
@@ -479,6 +480,7 @@ function DatabaseTable({
   const changeSourceRole = useChangeContentDatabaseSourceRole(document.id);
   const refreshSource = useRefreshContentDatabaseSource(document.id);
   const disconnectSource = useDisconnectContentDatabaseSource(document.id);
+  const processBuilderBodies = useProcessBuilderBodyHydration(document.id);
   const prepareBuilderReview = usePrepareBuilderSourceReview(document.id);
   const executeBuilderExecution = useExecuteBuilderSourceExecution(document.id);
   const setSourceWriteMode = useSetContentDatabaseSourceWriteMode(document.id);
@@ -1570,6 +1572,9 @@ function DatabaseTable({
             sourceId,
           })
         }
+        onHydrateBuilderBodies={(sourceId) =>
+          processBuilderBodies.mutate({ sourceId })
+        }
         onDisconnectSource={(sourceId) =>
           disconnectSource.mutate(
             {
@@ -1635,6 +1640,7 @@ function DatabaseTable({
           attachSource.isPending ||
           changeSourceRole.isPending ||
           refreshSource.isPending ||
+          processBuilderBodies.isPending ||
           disconnectSource.isPending ||
           prepareBuilderReview.isPending ||
           executeBuilderExecution.isPending ||
@@ -3539,6 +3545,7 @@ function DatabaseSettingsPanelSheet({
   onChangeSourceRole,
   onDisconnectSecondary,
   onRefreshSource,
+  onHydrateBuilderBodies,
   onDisconnectSource,
   onReviewBuilderUpdate,
   onSetBuilderLiveWrites,
@@ -3580,6 +3587,7 @@ function DatabaseSettingsPanelSheet({
   ) => Promise<ContentDatabaseResponse>;
   onDisconnectSecondary: (sourceId: string) => void;
   onRefreshSource: (sourceId?: string) => void;
+  onHydrateBuilderBodies: (sourceId: string) => void;
   onDisconnectSource: (sourceId?: string) => void;
   onReviewBuilderUpdate: () => void;
   onSetBuilderLiveWrites: (enabled: boolean) => void;
@@ -3677,6 +3685,7 @@ function DatabaseSettingsPanelSheet({
               setSourceNavStack([]);
             }}
             onRefreshSource={onRefreshSource}
+            onHydrateBuilderBodies={onHydrateBuilderBodies}
             onDisconnectSource={onDisconnectSource}
             onReviewBuilderUpdate={onReviewBuilderUpdate}
             onSetBuilderLiveWrites={onSetBuilderLiveWrites}
@@ -3976,6 +3985,7 @@ function DatabaseSettingsSourcePanel({
   onChangeSourceRole,
   onDisconnectSecondary,
   onRefreshSource,
+  onHydrateBuilderBodies,
   onDisconnectSource,
   onReviewBuilderUpdate,
   onSetBuilderLiveWrites,
@@ -4004,6 +4014,7 @@ function DatabaseSettingsSourcePanel({
   ) => Promise<ContentDatabaseResponse>;
   onDisconnectSecondary: (sourceId: string) => void;
   onRefreshSource: (sourceId?: string) => void;
+  onHydrateBuilderBodies: (sourceId: string) => void;
   onDisconnectSource: (sourceId?: string) => void;
   onReviewBuilderUpdate: () => void;
   onSetBuilderLiveWrites: (enabled: boolean) => void;
@@ -4442,6 +4453,15 @@ function DatabaseSettingsSourcePanel({
           </div>
         ) : null}
 
+        {isBuilderSource && source.bodyHydration ? (
+          <BuilderBodyHydrationCard
+            source={source}
+            canEdit={canEdit}
+            pending={sourceActionPending}
+            onHydrate={() => onHydrateBuilderBodies(source.id)}
+          />
+        ) : null}
+
         {isCodeMode ? (
           <>
             <div className="grid min-w-0 gap-2 rounded-lg border border-border bg-background p-3 text-sm">
@@ -5173,6 +5193,78 @@ function SourceRoleCard({
   );
 }
 
+function BuilderBodyHydrationCard({
+  source,
+  canEdit,
+  pending,
+  onHydrate,
+}: {
+  source: ContentDatabaseSource;
+  canEdit: boolean;
+  pending: boolean;
+  onHydrate: () => void;
+}) {
+  const summary = source.bodyHydration;
+  if (!summary || summary.total === 0) return null;
+  const activeCount = summary.pending + summary.hydrating;
+  const needsWork = activeCount > 0 || summary.error > 0;
+  const hydratedLabel = dbText("builderBodiesHydrated", {
+    hydrated: summary.hydrated,
+    total: summary.total,
+  });
+  const detail = needsWork
+    ? [
+        activeCount > 0
+          ? dbText("builderBodiesQueued", { count: activeCount })
+          : null,
+        summary.error > 0
+          ? dbText("builderBodySyncFailed", { count: summary.error })
+          : null,
+      ]
+        .filter(Boolean)
+        .join(" · ")
+    : dbText("builderBodiesReadyLocally");
+
+  return (
+    <div className="grid min-w-0 gap-2 rounded-lg border border-border bg-background p-3">
+      <div className="flex min-w-0 items-start justify-between gap-3">
+        <div className="min-w-0">
+          <div className="text-xs font-medium">{dbText("builderBodySync")}</div>
+          <div className="mt-0.5 text-xs text-muted-foreground">
+            {hydratedLabel}
+          </div>
+        </div>
+        {needsWork ? (
+          <Button
+            type="button"
+            size="sm"
+            variant="outline"
+            className="h-7 shrink-0 px-2 text-xs"
+            disabled={!canEdit || pending}
+            onClick={onHydrate}
+          >
+            {pending ? (
+              <Spinner className="mr-1 size-3.5" />
+            ) : (
+              <IconRefresh className="mr-1 size-3.5" />
+            )}
+            {summary.error > 0 ? dbText("retry") : dbText("resume")}
+          </Button>
+        ) : null}
+      </div>
+      <div className="h-1.5 overflow-hidden rounded-full bg-muted">
+        <div
+          className="h-full rounded-full bg-foreground transition-[width]"
+          style={{
+            width: `${Math.round((summary.hydrated / summary.total) * 100)}%`,
+          }}
+        />
+      </div>
+      <div className="break-words text-xs text-muted-foreground">{detail}</div>
+    </div>
+  );
+}
+
 const DETAIL_FIELD_NAME_HINTS = [
   "name",
   "title",

package/corpus/templates/content/app/components/editor/database-sources/BuilderSourceReviewDialog.tsx

@@ -575,9 +575,11 @@ export function BuilderSourceReviewDialog({
                               <div className="font-medium">
                                 {row.bodyChange.summary}
                               </div>
-                              <div className="mt-1 text-muted-foreground">
-                                {t("database.builderBodyEditsNeedSaferPath")}
-                              </div>
+                              {row.bodyChange.warnings?.length ? (
+                                <div className="mt-1 text-muted-foreground">
+                                  {row.bodyChange.warnings.join(" ")}
+                                </div>
+                              ) : null}
                             </div>
                           ) : null}
                           {showConflict ? (

package/corpus/templates/content/app/components/editor/extensions/registryBlocks.ts

@@ -1,4 +1,6 @@
 import { createRegistryBlockNode } from "@agent-native/core/client";
+import { Extension } from "@tiptap/core";
+import { Plugin, PluginKey } from "@tiptap/pm/state";
 
 /* -------------------------------------------------------------------------- */
 /* Content's registry-block Tiptap node — a thin wrapper over the core node.   */
@@ -46,4 +48,43 @@ export const RegistryBlockNode = createRegistryBlockNode({
   mintId: createContentBlockId,
 });
 
+function sourceComponentIdCounts(doc: { descendants: (fn: any) => void }) {
+  const counts = new Map<string, number>();
+  doc.descendants((node: any) => {
+    if (
+      node.type?.name === "registryBlock" &&
+      node.attrs?.blockType === "source-component" &&
+      typeof node.attrs.blockId === "string" &&
+      node.attrs.blockId
+    ) {
+      counts.set(node.attrs.blockId, (counts.get(node.attrs.blockId) ?? 0) + 1);
+    }
+    return true;
+  });
+  return counts;
+}
+
+export const LockedSourceComponentBlocks = Extension.create({
+  name: "lockedSourceComponentBlocks",
+
+  addProseMirrorPlugins() {
+    return [
+      new Plugin({
+        key: new PluginKey("lockedSourceComponentBlocks"),
+        filterTransaction(transaction, state) {
+          if (!transaction.docChanged) return true;
+          const before = sourceComponentIdCounts(state.doc);
+          if (before.size === 0) return true;
+          const after = sourceComponentIdCounts(transaction.doc);
+          if (after.size !== before.size) return false;
+          for (const [id, count] of before) {
+            if (after.get(id) !== count) return false;
+          }
+          return true;
+        },
+      }),
+    ];
+  },
+});
+
 export default RegistryBlockNode;

package/corpus/templates/content/app/components/editor/registrySlashItems.ts

@@ -102,6 +102,9 @@ export function buildRegistrySlashItems(
       //     not a content-authoring block.
       //   - `inline-database` is registered in Phase 2 for render/round-trip
       //     compatibility; Phase 3 owns the `/database` insertion flow.
+      //   - `source-component` is emitted by provider hydration to preserve
+      //     source-native blocks; users should not author raw preservation
+      //     markers by hand.
       // The genuinely document-friendly rich blocks (callout, decision, diagram,
       // wireframe, and the dev-doc/structured set) ARE offered.
       includeSpec: (spec) =>
@@ -110,6 +113,7 @@ export function buildRegistrySlashItems(
           "question-form",
           "visual-questions",
           "inline-database",
+          "source-component",
         ].includes(spec.type),
       toItem: (spec, insert) => ({
         title: spec.label,

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

@@ -59,6 +59,10 @@ import {
 } from "@/hooks/use-documents";
 import { cn } from "@/lib/utils";
 
+import {
+  getDocumentSidebarSections,
+  isDirectLocalDocument,
+} from "./document-sidebar-sections";
 import { DocumentSidebarIcon, DocumentTreeItem } from "./DocumentTreeItem";
 import { NotionButton } from "./NotionButton";
 
@@ -114,22 +118,6 @@ function collectDocumentSubtreeIds(documents: Document[], rootId: string) {
   return deletedIds;
 }
 
-function isDirectLocalDocument(document: Pick<Document, "id" | "source">) {
-  return (
-    document.source?.mode === "local-files" &&
-    (document.id.startsWith("local-file:") ||
-      document.id.startsWith("local-folder:"))
-  );
-}
-
-function isImportedLocalSourceDocument(
-  document: Pick<Document, "id" | "source">,
-) {
-  return (
-    document.source?.mode === "local-files" && !isDirectLocalDocument(document)
-  );
-}
-
 type SidebarSectionId =
   | "local-files"
   | "shared-copies"
@@ -210,24 +198,23 @@ export function DocumentSidebar({
   );
 
   const treeDocuments = filterDocumentTreeDocuments(documents);
-  const localFileMode = documents.some(isDirectLocalDocument);
-  const localSourceDocuments = localFileMode
-    ? treeDocuments.filter(isDirectLocalDocument)
-    : treeDocuments.filter(isImportedLocalSourceDocument);
-  const databaseDocuments = localFileMode
-    ? treeDocuments.filter((document) => !isDirectLocalDocument(document))
-    : treeDocuments.filter(
-        (document) => !isImportedLocalSourceDocument(document),
-      );
+  const {
+    localFileMode,
+    localSourceDocuments,
+    databaseDocuments,
+    favorites,
+    showFavorites,
+  } = getDocumentSidebarSections(documents, treeDocuments);
   const localFileTree = buildDocumentTree(localSourceDocuments);
   const databaseTree = buildDocumentTree(databaseDocuments);
   const privateTree = databaseTree.filter((node) => node.visibility !== "org");
   const organizationTree = databaseTree.filter(
     (node) => node.visibility === "org",
   );
-  const favorites = documents.filter(
-    (d) => d.isFavorite && (localFileMode || !isImportedLocalSourceDocument(d)),
-  );
+  // Match the tree rows' right-side inset so favorite titles clip inside the
+  // visible sidebar instead of widening the scroll surface.
+  const favoriteRowWidth =
+    width === undefined ? undefined : Math.max(224, width - 8);
   const activeDocument = activeDocumentId
     ? documents.find((doc) => doc.id === activeDocumentId)
     : null;
@@ -878,21 +865,29 @@ export function DocumentSidebar({
           ) : (
             <>
               {/* Favorites */}
-              {!localFileMode && favorites.length > 0 && (
-                <div className="mb-2">
-                  <div className="px-3 py-1.5 text-[10px] font-semibold uppercase tracking-wider text-muted-foreground flex items-center gap-1">
+              {showFavorites && (
+                <div className="mb-2 min-w-0">
+                  <div className="flex min-w-0 items-center gap-1 px-3 py-1.5 text-[10px] font-semibold uppercase tracking-wider text-muted-foreground">
                     <IconStar size={10} />
-                    {t("sidebar.favorites")}
+                    <span className="min-w-0 flex-1 truncate">
+                      {t("sidebar.favorites")}
+                    </span>
                   </div>
                   {favorites.map((doc) => (
                     <button
                       key={doc.id}
                       className={cn(
-                        "w-full flex items-center gap-2 px-4 py-[5px] text-sm text-start rounded-md",
+                        "flex w-full min-w-0 items-center gap-2 rounded-md px-4 py-[5px] text-start text-sm",
                         doc.id === activeDocumentId
                           ? "bg-accent text-accent-foreground"
                           : "text-muted-foreground hover:bg-accent/50 hover:text-foreground",
                       )}
+                      style={{
+                        width:
+                          favoriteRowWidth === undefined
+                            ? undefined
+                            : `${favoriteRowWidth}px`,
+                      }}
                       onClick={() => {
                         navigateToDocument(doc.id);
                         onNavigate?.();

package/corpus/templates/content/app/components/sidebar/document-sidebar-sections.ts

@@ -0,0 +1,47 @@
+import type { Document } from "@shared/api";
+
+export function isDirectLocalDocument(
+  document: Pick<Document, "id" | "source">,
+) {
+  return (
+    document.source?.mode === "local-files" &&
+    (document.id.startsWith("local-file:") ||
+      document.id.startsWith("local-folder:"))
+  );
+}
+
+export function isImportedLocalSourceDocument(
+  document: Pick<Document, "id" | "source">,
+) {
+  return (
+    document.source?.mode === "local-files" && !isDirectLocalDocument(document)
+  );
+}
+
+export function getDocumentSidebarSections(
+  documents: Document[],
+  treeDocuments: Document[] = documents,
+) {
+  const localFileMode = documents.some(isDirectLocalDocument);
+  const localSourceDocuments = localFileMode
+    ? treeDocuments.filter(isDirectLocalDocument)
+    : treeDocuments.filter(isImportedLocalSourceDocument);
+  const databaseDocuments = localFileMode
+    ? treeDocuments.filter((document) => !isDirectLocalDocument(document))
+    : treeDocuments.filter(
+        (document) => !isImportedLocalSourceDocument(document),
+      );
+  const favorites = documents.filter(
+    (document) =>
+      document.isFavorite &&
+      (localFileMode || !isImportedLocalSourceDocument(document)),
+  );
+
+  return {
+    localFileMode,
+    localSourceDocuments,
+    databaseDocuments,
+    favorites,
+    showFavorites: favorites.length > 0,
+  };
+}

package/corpus/templates/content/app/global.css

@@ -2298,25 +2298,32 @@ audio.media-block__content {
 
 /* ===== Collaboration cursors ===== */
 .notion-editor .collaboration-cursor__selection {
-  background-color: hsl(210 100% 52% / 0.14) !important;
+  background-color: currentColor !important;
   border-radius: 2px;
   box-decoration-break: clone;
   -webkit-box-decoration-break: clone;
+  opacity: 0.16;
 }
 
-.collaboration-cursor__caret {
+.notion-editor .collaboration-cursor__caret {
   border-left: 2px solid;
   border-color: currentColor;
+  display: inline;
   margin-left: -1px;
   margin-right: -1px;
   position: relative;
   word-break: normal;
   pointer-events: none;
+  line-height: 1;
 }
-.collaboration-cursor__label {
+.notion-editor .collaboration-cursor__label {
   position: absolute;
   top: -1.4em;
   left: -1px;
+  display: inline-block;
+  max-width: min(180px, 50vw);
+  overflow: hidden;
+  text-overflow: ellipsis;
   font-size: 11px;
   font-weight: 600;
   line-height: 1;

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

@@ -22,6 +22,8 @@ import type {
   PrepareBuilderSourceExecutionRequest,
   PrepareBuilderSourceReviewRequest,
   PrepareBuilderSourceReviewResponse,
+  ProcessBuilderBodyHydrationRequest,
+  ProcessBuilderBodyHydrationResponse,
   RefreshContentDatabaseSourceRequest,
   ReviewContentDatabaseSourceChangeSetRequest,
   SetContentDatabaseSourceWriteModeRequest,
@@ -408,6 +410,28 @@ export function useRefreshContentDatabaseSource(documentId: string) {
   });
 }
 
+export function useProcessBuilderBodyHydration(documentId: string) {
+  const queryClient = useQueryClient();
+  return useActionMutation<
+    ProcessBuilderBodyHydrationResponse,
+    ProcessBuilderBodyHydrationRequest
+  >("process-builder-body-hydration", {
+    onSuccess: (_data, variables) => {
+      queryClient.invalidateQueries({
+        queryKey: contentDatabaseQueryKey(documentId),
+      });
+      queryClient.invalidateQueries({
+        queryKey: ["action", "get-content-database-source", { documentId }],
+      });
+      if (variables?.documentId) {
+        queryClient.invalidateQueries({
+          queryKey: ["action", "get-document", { id: variables.documentId }],
+        });
+      }
+    },
+  });
+}
+
 export function useDisconnectContentDatabaseSource(documentId: string) {
   const queryClient = useQueryClient();
   return useActionMutation<

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

@@ -12,6 +12,36 @@ import { toast } from "sonner";
 
 import { useRestoreContentDatabase } from "./use-content-database";
 
+const LIST_DOCUMENTS_QUERY_KEY = ["action", "list-documents", undefined];
+
+export function mergeDocumentIntoDocumentCache(
+  old: unknown,
+  document: Document,
+) {
+  return old && typeof old === "object" ? { ...old, ...document } : document;
+}
+
+export function mergeDocumentIntoListDocumentsCache(
+  old: unknown,
+  document: Document,
+) {
+  if (Array.isArray(old)) {
+    return old.map((item: Document) =>
+      item.id === document.id ? { ...item, ...document } : item,
+    );
+  }
+
+  if (!old || typeof old !== "object") return old;
+  const cached = old as { documents?: unknown };
+  if (!Array.isArray(cached.documents)) return old;
+
+  const nextDocuments = cached.documents.map((item: Document) =>
+    item.id === document.id ? { ...item, ...document } : item,
+  );
+
+  return { ...(old as object), documents: nextDocuments };
+}
+
 export function useDocuments() {
   return useActionQuery<Document[]>("list-documents", undefined, {
     select: (data: any) => {
@@ -42,6 +72,13 @@ export function useUpdateDocument() {
     DocumentUpdateRequest & { id: string }
   >("update-document", {
     onSuccess: (data, variables) => {
+      queryClient.setQueryData(
+        ["action", "get-document", { id: variables.id }],
+        (old: unknown) => mergeDocumentIntoDocumentCache(old, data),
+      );
+      queryClient.setQueryData(LIST_DOCUMENTS_QUERY_KEY, (old: unknown) =>
+        mergeDocumentIntoListDocumentsCache(old, data),
+      );
       queryClient.invalidateQueries({
         queryKey: ["action", "get-document", { id: variables.id }],
       });

package/corpus/templates/content/app/i18n/zh-TW.ts

@@ -2,6 +2,16 @@ const messages = {
   root: {
     commandContent: "內容",
     commandSearchDocuments: "搜尋檔案",
+    commandSearchHeading: "搜尋",
+    commandSearchPlaceholder: "搜尋文件和資料庫...",
+    commandSearchLoading: "搜尋中...",
+    commandSearchError: "搜尋目前無法使用。",
+    commandSearchPartialError: "部分結果無法載入。",
+    commandSearchEmpty: "沒有相符的文件或資料庫。",
+    commandDocumentsHeading: "文件",
+    commandDatabasesHeading: "資料庫",
+    commandLocalFilesHeading: "本機檔案",
+    commandDatabaseResultDescription: "開啟資料庫頁面",
     commandAppearance: "外觀",
     toggleTheme: "切換主題",
     metaTitle:
@@ -154,6 +164,14 @@ const messages = {
       pathMissing: "引用路徑缺失",
       selfReference: "此引用指向目前文件。",
     },
+    sourceComponent: {
+      defaultTitle: "來源元件",
+      noPreviewRows: "沒有預覽列",
+      previewAvailable: "可預覽",
+      previewTruncated: "預覽已截斷",
+      previewUnavailable: "無法預覽",
+      needsAttention: "需要注意",
+    },
     media: {
       addAltTextDescription: "新增替代文字來描述該圖片。",
       addAudio: "新增音訊",
@@ -585,6 +603,11 @@ const messages = {
     builderSpace: "Builder 空間",
     builderUpdateFailed: "Builder 更新失敗",
     builderWriteModeWasNotChanged: "Builder 寫入模式未更改",
+    builderBodiesReadyLocally: "Builder 文章正文已在本機準備好。",
+    builderBodiesQueued: "{{count}} 個排隊中",
+    builderBodySync: "正文同步",
+    builderBodySyncFailed: "{{count}} 個失敗",
+    builderBodiesHydrated: "已同步 {{hydrated}} / {{total}} 個正文",
     closeDatabaseSettings: "關閉資料庫設定",
     closeSearch: "關閉搜尋",
     databaseRowsAndLocalPropertiesWereKeptIntact: "資料庫行和本機屬性已保留。",
@@ -754,6 +777,7 @@ const messages = {
     readOnly: "唯讀",
     removeThisSource: "移除此來源",
     renameView: "重新命名檢視",
+    resume: "繼續",
     retry: "Retry",
     reviewBeforeTheyReachBuilder: "在傳送到 Builder 前審核。",
     reviewDiff: "審核差異",