@agent-native/core 0.82.0 → 0.84.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/global.css

@@ -1537,10 +1537,10 @@ audio.media-block__content {
   flex-direction: column;
   gap: 0.18rem;
   max-width: 22rem;
-  border: 0;
+  border: 1px solid hsl(var(--border));
   border-radius: 8px;
-  background: hsl(0 0% 15%);
-  color: white;
+  background: hsl(var(--popover));
+  color: hsl(var(--popover-foreground));
   padding: 0.6rem 0.75rem;
   box-shadow: 0 10px 24px hsl(0 0% 0% / 0.22);
 }
@@ -2218,12 +2218,13 @@ audio.media-block__content {
 .bubble-toolbar {
   display: flex;
   align-items: center;
-  background: hsl(0 0% 15%);
+  background: hsl(var(--popover));
+  color: hsl(var(--popover-foreground));
   border-radius: 8px;
   padding: 4px;
   box-shadow:
     0 4px 20px rgb(0 0 0 / 0.25),
-    0 0 0 1px rgb(255 255 255 / 0.06);
+    0 0 0 1px hsl(var(--border));
 }
 
 /* ===== Inline comment highlights ===== */
@@ -2298,25 +2299,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/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: "審核差異",