@agent-native/core 0.133.1 → 0.133.3

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

@@ -6,11 +6,16 @@ import type {
   AddContentDatabaseSourceFieldPropertyRequest,
   AddDatabaseItemRequest,
   AttachContentDatabaseSourceRequest,
+  BuilderCmsAttachPreviewResponse,
   BuilderCmsModelsResponse,
   CancelPreparedBuilderSourceUpdateRequest,
   CancelPreparedBuilderSourceUpdateResponse,
   ChangeContentDatabaseSourceRoleRequest,
   ContentDatabaseResponse,
+  ContentDatabaseSourceAttachmentAck,
+  ContentDatabaseSourceAttachmentResult,
+  ContentDatabaseItemsPageResponse,
+  ContentDatabaseTableQuery,
   ContentDatabaseItem,
   ContentDatabasePersonalViewResponse,
   ContentDatabaseSourceFieldMapping,
@@ -60,6 +65,11 @@ export function contentDatabaseByIdQueryKey(databaseId: string) {
   return ["action", "get-content-database", { databaseId }] as const;
 }
 
+export const contentDatabaseItemsPageQueryKey = [
+  "action",
+  "query-content-database-items",
+] as const;
+
 export function applyOptimisticItemToContentDatabase(
   current: ContentDatabaseResponse | undefined,
   item: ContentDatabaseItem,
@@ -174,21 +184,59 @@ export function contentDatabaseQueryFilter(documentId: string) {
   };
 }
 
+export function contentDatabaseConstrainedQueryFilter(documentId: string) {
+  return {
+    queryKey: ["action", "get-content-database"],
+    predicate: (query: Query) => {
+      if (!isContentDatabaseQueryForDocument(query.queryKey, documentId)) {
+        return false;
+      }
+      const params = query.queryKey[2] as { tableQuery?: unknown };
+      return params.tableQuery !== undefined;
+    },
+  };
+}
+
 export function writeContentDatabaseResponseToCache(
   queryClient: Pick<QueryClient, "setQueryData" | "setQueriesData">,
   documentId: string,
   data: ContentDatabaseResponse,
 ) {
-  queryClient.setQueryData<ContentDatabaseResponse>(
-    contentDatabaseQueryKey(documentId),
-    data,
-  );
+  if (!data.pagination) {
+    queryClient.setQueryData<ContentDatabaseResponse>(
+      contentDatabaseQueryKey(documentId),
+      data,
+    );
+  }
   queryClient.setQueriesData<ContentDatabaseResponse>(
-    contentDatabaseQueryFilter(documentId),
+    {
+      queryKey: ["action", "get-content-database"],
+      predicate: (query) =>
+        contentDatabaseResponseCanSeedQuery(query.queryKey, documentId, data),
+    },
     data,
   );
 }
 
+export function contentDatabaseResponseCanSeedQuery(
+  queryKey: readonly unknown[],
+  documentId: string,
+  data: ContentDatabaseResponse,
+) {
+  if (!isContentDatabaseQueryForDocument(queryKey, documentId)) return false;
+  const params = queryKey[2] as {
+    limit?: unknown;
+    offset?: unknown;
+    tableQuery?: unknown;
+  };
+  if (params.tableQuery !== undefined) return false;
+  if (!data.pagination) return params.limit === undefined;
+  return (
+    params.limit === data.pagination.limit &&
+    (params.offset ?? 0) === data.pagination.offset
+  );
+}
+
 export function applyOptimisticBuilderWriteMode(
   current: ContentDatabaseResponse | undefined,
   request: SetContentDatabaseSourceWriteModeRequest,
@@ -583,9 +631,13 @@ function removeOptimisticSourceFieldProperty(
   };
 }
 
-export function useContentDatabase(documentId: string | null, limit?: number) {
+export function useContentDatabase(
+  documentId: string | null,
+  limit?: number,
+  tableQuery?: ContentDatabaseTableQuery,
+) {
   const queryClient = useQueryClient();
-  return useActionQuery<ContentDatabaseResponse>(
+  const baseQuery = useActionQuery<ContentDatabaseResponse>(
     "get-content-database",
     documentId ? { documentId, limit } : undefined,
     {
@@ -604,6 +656,39 @@ export function useContentDatabase(documentId: string | null, limit?: number) {
       initialDataUpdatedAt: 0,
     },
   );
+  const pageQuery = useActionQuery<ContentDatabaseItemsPageResponse>(
+    "query-content-database-items",
+    documentId && tableQuery ? { documentId, limit, tableQuery } : undefined,
+    {
+      enabled: Boolean(documentId && tableQuery),
+      retry: false,
+      placeholderData: (previous) => previous,
+    },
+  );
+  const page = tableQuery ? pageQuery.data : undefined;
+  const data =
+    page &&
+    baseQuery.data &&
+    !baseQuery.data.attachPreview &&
+    !isContentDatabaseUnavailable(baseQuery.data)
+      ? {
+          ...baseQuery.data,
+          items: page.items,
+          source: page.source,
+          sources: page.sources,
+          pagination: page.pagination,
+          tableQueryMode: page.tableQueryMode,
+        }
+      : baseQuery.data;
+  return {
+    ...baseQuery,
+    data,
+    isLoading: tableQuery ? pageQuery.isLoading && !data : baseQuery.isLoading,
+    isFetching: tableQuery ? pageQuery.isFetching : baseQuery.isFetching,
+    isError: tableQuery ? pageQuery.isError : baseQuery.isError,
+    error: tableQuery ? pageQuery.error : baseQuery.error,
+    refetch: tableQuery ? pageQuery.refetch : baseQuery.refetch,
+  };
 }
 
 export function useContentDatabaseById(databaseId: string | null) {
@@ -749,12 +834,28 @@ export function useAddDatabaseItem(documentId: string) {
   return useActionMutation<ContentDatabaseResponse, AddDatabaseItemRequest>(
     "add-database-item",
     {
+      skipActionQueryInvalidation: true,
       onSuccess: (data) => {
-        // The action returns the committed row and full database snapshot.
-        // Seed every active pagination key before invalidating so navigating
-        // away from the creation side-peek cannot briefly lose an appended row
-        // behind an older 100/200-row response.
-        writeContentDatabaseResponseToCache(queryClient, documentId, data);
+        if (data.createdItem) {
+          queryClient.setQueriesData<ContentDatabaseResponse>(
+            {
+              queryKey: ["action", "get-content-database"],
+              predicate: (query) => {
+                if (
+                  !isContentDatabaseQueryForDocument(query.queryKey, documentId)
+                ) {
+                  return false;
+                }
+                const params = query.queryKey[2] as {
+                  tableQuery?: unknown;
+                };
+                return params.tableQuery === undefined;
+              },
+            },
+            (current) =>
+              applyOptimisticItemToContentDatabase(current, data.createdItem!),
+          );
+        }
         queryClient.invalidateQueries({
           queryKey: contentDatabaseQueryKey(documentId),
         });
@@ -779,6 +880,9 @@ export function useSubmitContentDatabaseForm(documentId: string) {
       queryClient.invalidateQueries({
         queryKey: contentDatabaseQueryKey(documentId),
       });
+      queryClient.invalidateQueries({
+        queryKey: contentDatabaseItemsPageQueryKey,
+      });
       queryClient.invalidateQueries({
         queryKey: ["action", "list-documents"],
       });
@@ -796,6 +900,9 @@ export function useDuplicateDatabaseItem(documentId: string) {
       queryClient.invalidateQueries({
         queryKey: contentDatabaseQueryKey(documentId),
       });
+      queryClient.invalidateQueries({
+        queryKey: contentDatabaseItemsPageQueryKey,
+      });
       queryClient.invalidateQueries({
         queryKey: ["action", "list-documents"],
       });
@@ -912,13 +1019,18 @@ export function useUpdateContentDatabaseView(documentId: string) {
     ContentDatabaseResponse,
     UpdateContentDatabaseViewRequest
   >("update-content-database-view", {
-    onSuccess: () => {
-      queryClient.invalidateQueries({
-        queryKey: contentDatabaseQueryKey(documentId),
-      });
-      queryClient.invalidateQueries({
-        queryKey: ["action", "get-content-database-source", { documentId }],
-      });
+    skipActionQueryInvalidation: true,
+    onSuccess: (data) => {
+      queryClient.setQueriesData<ContentDatabaseResponse>(
+        contentDatabaseQueryFilter(documentId),
+        (current) =>
+          current
+            ? {
+                ...current,
+                database: data.database,
+              }
+            : current,
+      );
     },
   });
 }
@@ -991,17 +1103,76 @@ export function useUpdateContentDatabasePersonalView(
   });
 }
 
-export function useAttachContentDatabaseSource(documentId: string) {
+export function useAttachContentDatabaseSource(
+  documentId: string,
+  fallbackData?: ContentDatabaseResponse,
+) {
   const queryClient = useQueryClient();
   return useActionMutation<
-    ContentDatabaseResponse,
+    ContentDatabaseSourceAttachmentResult,
     AttachContentDatabaseSourceRequest
   >("attach-content-database-source", {
+    skipActionQueryInvalidation: true,
+    onMutate: async (variables) => {
+      const previous = queryClient.getQueriesData<ContentDatabaseResponse>(
+        contentDatabaseQueryFilter(documentId),
+      );
+      const cancelPending = queryClient.cancelQueries(
+        contentDatabaseQueryFilter(documentId),
+        { revert: false },
+      );
+      if (variables.sourceType === "builder-cms" && variables.sourceTable) {
+        const preview =
+          queryClient.getQueryData<BuilderCmsAttachPreviewResponse>([
+            "action",
+            "preview-content-database-source-attach",
+            {
+              documentId,
+              sourceTable: variables.sourceTable,
+              fieldPaths: variables.builderFieldPaths,
+            },
+          ]);
+        if (preview) {
+          writeBuilderAttachPreviewToCache(
+            queryClient,
+            documentId,
+            preview,
+            fallbackData,
+          );
+        }
+      }
+      await cancelPending;
+      return { previous };
+    },
+    onError: (_error, _variables, context) => {
+      const previous = (
+        context as
+          | {
+              previous?: Array<
+                [readonly unknown[], ContentDatabaseResponse | undefined]
+              >;
+            }
+          | undefined
+      )?.previous;
+      for (const [queryKey, data] of previous ?? []) {
+        queryClient.setQueryData(queryKey, data);
+      }
+    },
     onSuccess: (data) => {
-      writeContentDatabaseResponseToCache(queryClient, documentId, data);
+      if (!("responseProjection" in data)) {
+        writeContentDatabaseResponseToCache(queryClient, documentId, data);
+      } else {
+        queryClient.setQueriesData<ContentDatabaseResponse>(
+          contentDatabaseQueryFilter(documentId),
+          (current) => applyBuilderAttachCompletion(current, data),
+        );
+      }
       queryClient.invalidateQueries({
         queryKey: contentDatabaseQueryKey(documentId),
       });
+      queryClient.invalidateQueries({
+        queryKey: contentDatabaseItemsPageQueryKey,
+      });
       queryClient.invalidateQueries({
         queryKey: ["action", "get-content-database-source", { documentId }],
       });
@@ -1009,6 +1180,84 @@ export function useAttachContentDatabaseSource(documentId: string) {
   });
 }
 
+export function applyBuilderAttachCompletion(
+  current: ContentDatabaseResponse | undefined,
+  completion: ContentDatabaseSourceAttachmentAck,
+) {
+  if (!current) return current;
+  return {
+    ...current,
+    pagination: current.pagination
+      ? {
+          ...current.pagination,
+          totalItems: completion.importedItemCount,
+          hasMore:
+            current.pagination.returnedItems < completion.importedItemCount,
+        }
+      : current.pagination,
+    attachPreview: {
+      sourceTable: completion.sourceTable,
+      fetchedAt: completion.fetchedAt,
+      importedItemCount: completion.importedItemCount,
+      complete: true,
+    },
+  };
+}
+
+export function useBuilderCmsAttachPreview(args: {
+  documentId: string;
+  sourceTable: string | null;
+  fieldPaths?: string[];
+  enabled?: boolean;
+}) {
+  return useActionQuery<BuilderCmsAttachPreviewResponse>(
+    "preview-content-database-source-attach",
+    args.sourceTable
+      ? {
+          documentId: args.documentId,
+          sourceTable: args.sourceTable,
+          fieldPaths: args.fieldPaths,
+        }
+      : undefined,
+    {
+      enabled: args.enabled !== false && Boolean(args.sourceTable),
+      retry: false,
+      staleTime: 30_000,
+    },
+  );
+}
+
+export function writeBuilderAttachPreviewToCache(
+  queryClient: Pick<QueryClient, "setQueriesData">,
+  documentId: string,
+  preview: BuilderCmsAttachPreviewResponse,
+  fallbackData?: ContentDatabaseResponse,
+) {
+  queryClient.setQueriesData<ContentDatabaseResponse>(
+    contentDatabaseQueryFilter(documentId),
+    (current) => {
+      const base = current ?? fallbackData ?? preview.base;
+      return base
+        ? {
+            ...base,
+            items: preview.items,
+            pagination: {
+              offset: 0,
+              limit: preview.items.length || 1,
+              totalItems: preview.items.length,
+              returnedItems: preview.items.length,
+              hasMore: preview.hasMore,
+            },
+            attachPreview: {
+              sourceTable: preview.sourceTable,
+              fetchedAt: preview.fetchedAt,
+            },
+          }
+        : current;
+    },
+  );
+}
+
 export function useChangeContentDatabaseSourceRole(documentId: string) {
   const queryClient = useQueryClient();
   return useActionMutation<
@@ -1032,6 +1281,7 @@ export function useAddContentDatabaseSourceFieldProperty(documentId: string) {
     ContentDatabaseSourceFieldPropertyResponse,
     AddContentDatabaseSourceFieldPropertyRequest
   >("add-content-database-source-field-property", {
+    skipActionQueryInvalidation: true,
     onMutate: async (variables) => {
       await queryClient.cancelQueries({
         queryKey: contentDatabaseQueryKey(documentId),
@@ -1076,6 +1326,9 @@ export function useAddContentDatabaseSourceFieldProperty(documentId: string) {
       queryClient.invalidateQueries({
         queryKey: contentDatabaseQueryKey(documentId),
       });
+      queryClient.invalidateQueries({
+        queryKey: contentDatabaseItemsPageQueryKey,
+      });
       queryClient.invalidateQueries({
         queryKey: ["action", "get-content-database-source", { documentId }],
       });
@@ -1208,6 +1461,7 @@ export function invalidateContentDatabaseSourceRefreshQueries(
   queryClient.invalidateQueries({
     queryKey: contentDatabaseQueryKey(documentId),
   });
+  queryClient.invalidateQueries({ queryKey: contentDatabaseItemsPageQueryKey });
   queryClient.invalidateQueries({
     queryKey: ["action", "get-content-database-source", { documentId }],
   });
@@ -1220,8 +1474,14 @@ export function useProcessBuilderBodyHydration(documentId: string) {
     ProcessBuilderBodyHydrationRequest
   >("process-builder-body-hydration", {
     skipActionQueryInvalidation: true,
-    onSuccess: (_data, variables) => {
-      invalidateBuilderBodyHydrationQueries(queryClient, documentId, variables);
+    onSuccess: (data, variables) => {
+      if (data.remaining === 0 || variables.documentId) {
+        invalidateBuilderBodyHydrationQueries(
+          queryClient,
+          documentId,
+          variables,
+        );
+      }
     },
   });
 }
@@ -1236,6 +1496,7 @@ export function invalidateBuilderBodyHydrationQueries(
   queryClient.invalidateQueries({
     queryKey: contentDatabaseQueryKey(documentId),
   });
+  queryClient.invalidateQueries({ queryKey: contentDatabaseItemsPageQueryKey });
   queryClient.invalidateQueries({
     queryKey: ["action", "get-content-database-source", { documentId }],
   });

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

@@ -18,6 +18,7 @@ import {
   applyDocumentPropertiesToDatabaseResponse,
   applyDocumentPropertyValueToDatabaseResponse,
   contentDatabaseQueryFilter,
+  contentDatabaseConstrainedQueryFilter,
   contentDatabaseQueryKey,
   removeDocumentPropertyFromDatabaseResponse,
 } from "./use-content-database";
@@ -93,9 +94,9 @@ export function useConfigureDocumentProperty(
       queryClient.invalidateQueries({
         queryKey: ["action", "get-document", { id: documentId }],
       });
-      queryClient.invalidateQueries({
-        ...contentDatabaseQueryFilter(databaseDocumentId),
-      });
+      queryClient.invalidateQueries(
+        contentDatabaseConstrainedQueryFilter(databaseDocumentId),
+      );
     },
   });
   return withDatabaseScope(mutation, databaseId);
@@ -160,9 +161,9 @@ export function useSetDocumentProperty(
       queryClient.invalidateQueries({
         queryKey: ["action", "get-document", { id: variables.documentId }],
       });
-      queryClient.invalidateQueries({
-        ...contentDatabaseQueryFilter(databaseDocumentId),
-      });
+      queryClient.invalidateQueries(
+        contentDatabaseConstrainedQueryFilter(databaseDocumentId),
+      );
       queryClient.invalidateQueries({
         queryKey: [
           "action",

package/corpus/templates/content/app/i18n-data.ts

@@ -26,6 +26,7 @@ const databaseMessages = {
   addingDetailsMatchedOn: "Adding details matched on {{field}}.",
   addingItems: "Adding items",
   addingItemsAsRows: "Adding items as their own rows in this database.",
+  attachingReadOnly: "Attaching · read-only",
   addMoreItemsToThisList: "Add more items to this list",
   addProperty: "Add property",
   allAvailableDetailFieldsAlreadyVisible:
@@ -8962,6 +8963,7 @@ export const messagesByLocale = {
       builderRowsFetchedSoFar: "目前已获取 {{count}} 行。",
       builderRowsFinishingUp: "Builder 行即将完成加载。",
       builderRowsLoadingBackground: "Builder 仍在后台加载行。",
+      attachingReadOnly: "正在附加 · 只读",
       builderRowsLoadingHitSnag: "Builder 行加载遇到问题。",
       opening: "正在打开...",
     },
@@ -9147,6 +9149,7 @@ export const messagesByLocale = {
         "Las filas de Builder están terminando de cargarse.",
       builderRowsLoadingBackground:
         "Builder sigue cargando filas en segundo plano.",
+      attachingReadOnly: "Adjuntando · solo lectura",
       builderRowsLoadingHitSnag:
         "La carga de filas de Builder tuvo un problema.",
       opening: "Abriendo...",
@@ -9344,6 +9347,7 @@ export const messagesByLocale = {
       builderRowsFinishingUp: "Les lignes Builder terminent leur chargement.",
       builderRowsLoadingBackground:
         "Builder charge encore des lignes en arrière-plan.",
+      attachingReadOnly: "Ajout en cours · lecture seule",
       builderRowsLoadingHitSnag:
         "Le chargement des lignes Builder a rencontré un problème.",
       opening: "Ouverture...",
@@ -9540,6 +9544,7 @@ export const messagesByLocale = {
       builderRowsFinishingUp: "Builder-Zeilen werden fertig geladen.",
       builderRowsLoadingBackground:
         "Builder lädt weiterhin Zeilen im Hintergrund.",
+      attachingReadOnly: "Wird angehängt · schreibgeschützt",
       builderRowsLoadingHitSnag:
         "Beim Laden der Builder-Zeilen ist ein Problem aufgetreten.",
       opening: "Wird geöffnet...",
@@ -9736,6 +9741,7 @@ export const messagesByLocale = {
       builderRowsFinishingUp: "Builder 行の読み込みを完了しています。",
       builderRowsLoadingBackground:
         "Builder はバックグラウンドで行を読み込み続けています。",
+      attachingReadOnly: "接続中 · 読み取り専用",
       builderRowsLoadingHitSnag: "Builder 行の読み込みで問題が発生しました。",
       opening: "開いています...",
     },
@@ -9928,6 +9934,7 @@ export const messagesByLocale = {
       builderRowsFinishingUp: "Builder 행 로드를 마무리하는 중입니다.",
       builderRowsLoadingBackground:
         "Builder가 백그라운드에서 행을 계속 로드하고 있습니다.",
+      attachingReadOnly: "연결 중 · 읽기 전용",
       builderRowsLoadingHitSnag: "Builder 행 로드 중 문제가 발생했습니다.",
       opening: "여는 중...",
     },
@@ -10115,6 +10122,7 @@ export const messagesByLocale = {
         "As linhas do Builder estão terminando de carregar.",
       builderRowsLoadingBackground:
         "O Builder ainda está carregando linhas em segundo plano.",
+      attachingReadOnly: "Anexando · somente leitura",
       builderRowsLoadingHitSnag:
         "O carregamento de linhas do Builder encontrou um problema.",
       opening: "Abrindo...",
@@ -10307,6 +10315,7 @@ export const messagesByLocale = {
       builderRowsFinishingUp: "Builder पंक्तियां लोड होना पूरा कर रही हैं।",
       builderRowsLoadingBackground:
         "Builder अभी भी पृष्ठभूमि में पंक्तियां लोड कर रहा है।",
+      attachingReadOnly: "संलग्न किया जा रहा है · केवल पढ़ने के लिए",
       builderRowsLoadingHitSnag: "Builder पंक्तियां लोड करने में समस्या आई।",
       opening: "खोला जा रहा है...",
     },
@@ -10488,6 +10497,7 @@ export const messagesByLocale = {
       builderRowsFetchedSoFar: "تم جلب {{count}} صفًا حتى الآن.",
       builderRowsFinishingUp: "صفوف Builder توشك على إكمال التحميل.",
       builderRowsLoadingBackground: "لا يزال Builder يحمّل الصفوف في الخلفية.",
+      attachingReadOnly: "جارٍ الإرفاق · للقراءة فقط",
       builderRowsLoadingHitSnag: "واجه تحميل صفوف Builder مشكلة.",
       opening: "جارٍ الفتح...",
     },

package/corpus/templates/content/changelog/2026-07-29-large-databases-keep-useful-rows-visible.md

@@ -0,0 +1,6 @@
+---
+type: improved
+date: 2026-07-29
+---
+
+Large databases keep useful rows visible while table sorting and Builder review details load.

package/corpus/templates/content/changelog/2026-07-30-builder-source-columns-now-appear-immediately-when-connected.md

@@ -0,0 +1,6 @@
+---
+type: improved
+date: 2026-07-30
+---
+
+Builder source columns now appear immediately when connected entries already contain the selected field, including empty values.

package/corpus/templates/content/changelog/2026-07-30-deleting-a-page-no-longer-leaves-the-content-sidebar-unrespo.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-07-30
+---
+
+Deleting a page no longer leaves the Content sidebar unresponsive.

package/corpus/templates/content/changelog/2026-07-30-large-builder-backed-tables-show-useful-rows-sooner-and-fini.md

@@ -0,0 +1,6 @@
+---
+type: improved
+date: 2026-07-30
+---
+
+Large Builder-backed tables show useful rows sooner and finish loading in the background.

package/corpus/templates/content/changelog/2026-08-01-large-builder-databases-now-show-rows-immediately-and-finish.md

@@ -0,0 +1,6 @@
+---
+type: improved
+date: 2026-08-01
+---
+
+Large Builder databases now show rows immediately and finish syncing much faster.

package/corpus/templates/content/e2e/playwright.config.ts

@@ -14,7 +14,8 @@ import { defineConfig, devices } from "@playwright/test";
  */
 export default defineConfig({
   testDir: ".",
-  testMatch: /(registry-blocks|local-files|database-preview-menu)\.spec\.ts/,
+  testMatch:
+    /(registry-blocks|local-files|database-preview-menu|sidebar-delete)\.spec\.ts/,
   fullyParallel: true,
   workers: process.env.CI ? 2 : 3,
   retries: 2,

package/corpus/templates/content/parity/matrix.md

@@ -10,6 +10,7 @@ This generated matrix tracks whether high-value Content UI operations use the sa
 | database.private-preview-drafts                    | database    | Persist and reconcile a user's private database-page preview draft                                        | action-backed         | `get-preview-document-draft`, `update-preview-document-draft`                                                                                                                                                                                                                                                                                                                                               | `app/components/editor/database/DatabaseView.tsx`, `app/hooks/use-documents.ts`                                                                                                           | A user's private preview draft is read, saved, conflict-checked, or deleted without changing the shared database page until the normal save flow applies it.                                                                                                                              | These per-user editor-state actions are intentionally hidden from agent tools because preview drafts are a private UI recovery mechanism.                                                                                                  | -                | P1             | covered       | `actions/preview-document-draft.db.test.ts`                                                                                                                                                                             | -                                | -                              |
 | database.properties-and-view-config                | database    | Configure properties, values, ordering, and saved views                                                   | action-backed         | `configure-document-property`, `delete-document-property`, `duplicate-document-property`, `get-content-database-personal-view`, `list-document-properties`, `reorder-document-property`, `set-document-property`, `update-content-database-personal-view`, `update-content-database-view`                                                                                                                   | `app/components/editor/DocumentProperties.tsx`, `app/components/editor/DocumentDatabase.tsx`, `app/components/editor/database/DatabaseView.tsx`, `app/hooks/use-document-properties.ts`   | Property schemas, property values, property order, filters, sorts, grouping, hidden columns, view type, and view settings are stored.                                                                                                                                                     | -                                                                                                                                                                                                                                          | -                | P0             | covered       | `actions/bind-content-database-source-field.db.test.ts`, `actions/content-database-source-actions.test.ts`, `actions/resync-content-database-source.db.test.ts`                                                         | `database-source-scope`          | -                              |
 | database.rows                                      | database    | Add, duplicate, move, open, and delete database rows                                                      | action-backed         | `add-database-item`, `delete-database-items`, `delete-document`, `duplicate-database-items`, `duplicate-database-item`, `move-database-item`, `set-document-property`                                                                                                                                                                                                                                       | `app/components/editor/DocumentDatabase.tsx`, `app/components/editor/database/DatabaseView.tsx`                                                                                           | Database row backing documents and row ordering are created, duplicated, moved, edited, and deleted.                                                                                                                                                                                      | -                                                                                                                                                                                                                                          | -                | P0             | covered       | `actions/database-row-batch-actions.db.test.ts`, `parity/__tests__/database-row-batch-reliability.test.ts`                                                                                                              | `database-bulk-row-reliability`  | -                              |
+| database.table-query-page                          | database    | Query one constrained page while retaining database metadata                                              | action-backed         | `query-content-database-items`                                                                                                                                                                                                                                                                                                                                                                              | `app/components/editor/database/DatabaseView.tsx`, `app/hooks/use-content-database.ts`                                                                                                    | -                                                                                                                                                                                                                                                                                         | This UI-only bounded projection is intentionally hidden with agentTool: false; agents use get-content-database for the complete database contract.                                                                                         | -                | P0             | covered       | `actions/content-database-lifecycle.db.test.ts`, `app/hooks/use-content-database.test.ts`                                                                                                                               | -                                | -                              |
 | editor.agent-assist-prompts                        | editor      | Ask AI from slash generation or comment context                                                           | client-assist         | -                                                                                                                                                                                                                                                                                                                                                                                                           | `app/components/editor/SlashCommandMenu.tsx`, `app/components/editor/CommentsSidebar.tsx`                                                                                                 | No direct durable mutation; the prompt asks the agent to use document actions when it decides to write.                                                                                                                                                                                   | -                                                                                                                                                                                                                                          | -                | P1             | none          | -                                                                                                                                                                                                                       | -                                | -                              |
 | editor.client-formatting-and-insertions            | editor      | Rich text formatting, selection state, slash block insertion, and copy actions                            | client-only-ephemeral | -                                                                                                                                                                                                                                                                                                                                                                                                           | `app/components/editor/BubbleToolbar.tsx`, `app/components/editor/SlashCommandMenu.tsx`, `app/components/editor/DocumentToolbar.tsx`                                                      | -                                                                                                                                                                                                                                                                                         | -                                                                                                                                                                                                                                          | -                | P1             | none          | -                                                                                                                                                                                                                       | -                                | -                              |
 | editor.document-body-and-title                     | editor      | Edit document title, body, icon, image alt text, and precise text                                         | action-backed         | `edit-document`, `pull-document`, `set-image-alt-text`, `transcribe-media`, `update-document`                                                                                                                                                                                                                                                                                                               | `app/components/editor/DocumentEditor.tsx`, `app/components/editor/DocumentDatabase.tsx`, `app/components/editor/extensions/ImageBlock.tsx`, `app/components/editor/SlashCommandMenu.tsx` | Document content, title, icon, image metadata, and text replacements are saved to the same document source.                                                                                                                                                                               | -                                                                                                                                                                                                                                          | -                | P0             | covered       | `actions/content-database-lifecycle.db.test.ts`, `actions/_local-file-documents.test.ts`                                                                                                                                | `document-search-edit`           | -                              |
@@ -26,7 +27,7 @@ This generated matrix tracks whether high-value Content UI operations use the sa
 | source-sync.builder-cms-review-and-write-gates     | source-sync | Review, stage, validate, cancel, and execute Builder CMS source writes                                    | action-backed         | `cancel-prepared-builder-source-update`, `execute-builder-source-batch`, `execute-builder-source-execution`, `prepare-builder-source-execution`, `prepare-builder-source-review`, `preview-builder-source-review`, `review-content-database-source-change-set`, `set-content-database-source-write-mode`, `stage-builder-source-bulk-update`, `stage-builder-revision`, `validate-builder-source-execution` | `app/components/editor/DocumentDatabase.tsx`, `app/components/editor/database/DatabaseView.tsx`, `app/components/editor/database-sources/BuilderSourceReviewDialog.tsx`                   | Builder source write mode, staged reviews, pre-dispatch cancellations, validation records, and bounded execution records are created through guarded actions.                                                                                                                             | -                                                                                                                                                                                                                                          | -                | P0             | covered       | `actions/builder-source-review-gates.db.test.ts`, `actions/cancel-prepared-builder-source-update.db.test.ts`, `actions/execute-builder-source-execution.test.ts`, `actions/stage-builder-source-bulk-update.db.test.ts` | `builder-source-review-readonly` | -                              |
 | source-sync.builder-documents                      | source-sync | List, pull, check, and push Builder docs/blog MDX documents                                               | action-backed         | `check-builder-doc`, `list-builder-docs`, `pull-builder-doc`, `push-builder-doc`                                                                                                                                                                                                                                                                                                                            | `actions/list-builder-docs.ts`, `actions/pull-builder-doc.ts`, `actions/check-builder-doc.ts`, `actions/push-builder-doc.ts`                                                              | Builder docs/blog entries can be read into Content, checked locally, and pushed through guarded Builder document actions.                                                                                                                                                                 | -                                                                                                                                                                                                                                          | -                | P1             | seeded        | -                                                                                                                                                                                                                       | -                                | -                              |
 | source-sync.builder-required-field-materialization | source-sync | Add required Builder publishing fields to a connected collection                                          | action-backed         | `materialize-builder-required-fields`                                                                                                                                                                                                                                                                                                                                                                       | `app/components/editor/database/DatabaseView.tsx`, `app/hooks/use-content-database.ts`                                                                                                    | Required Builder fields are materialized as editable Content properties in one local mutation.                                                                                                                                                                                            | This bounded safe-model setup action is intentionally hidden from the agent tool list; the visible source settings surface invokes it.                                                                                                     | -                | P1             | covered       | `actions/materialize-builder-required-fields.test.ts`                                                                                                                                                                   | -                                | -                              |
-| source-sync.database-source-bindings               | source-sync | Attach, inspect, refresh, disconnect, join, and bind database sources                                     | action-backed         | `add-content-database-source-field-property`, `attach-content-database-source`, `bind-content-database-source-field`, `change-content-database-source-role`, `disconnect-content-database-source`, `get-content-database-source`, `list-builder-cms-models`, `list-notion-database-sources`, `refresh-content-database-source`, `suggest-source-join-key`                                                   | `app/components/editor/DocumentDatabase.tsx`, `app/components/editor/DocumentProperties.tsx`, `app/components/editor/database/DatabaseView.tsx`, `app/hooks/use-content-database.ts`      | Mounted database source metadata, fields, source role, join keys, and source-field/property bindings are stored and refreshed.                                                                                                                                                            | -                                                                                                                                                                                                                                          | -                | P0             | covered       | `actions/bind-content-database-source-field.db.test.ts`, `actions/content-database-source-actions.test.ts`, `actions/resync-content-database-source.db.test.ts`                                                         | `database-source-scope`          | -                              |
+| source-sync.database-source-bindings               | source-sync | Attach, inspect, refresh, disconnect, join, and bind database sources                                     | action-backed         | `add-content-database-source-field-property`, `attach-content-database-source`, `bind-content-database-source-field`, `change-content-database-source-role`, `disconnect-content-database-source`, `get-content-database-source`, `list-builder-cms-models`, `list-notion-database-sources`, `preview-content-database-source-attach`, `refresh-content-database-source`, `suggest-source-join-key`         | `app/components/editor/DocumentDatabase.tsx`, `app/components/editor/DocumentProperties.tsx`, `app/components/editor/database/DatabaseView.tsx`, `app/hooks/use-content-database.ts`      | Mounted database source metadata, fields, source role, join keys, and source-field/property bindings are stored and refreshed.                                                                                                                                                            | -                                                                                                                                                                                                                                          | -                | P0             | covered       | `actions/bind-content-database-source-field.db.test.ts`, `actions/content-database-source-actions.test.ts`, `actions/resync-content-database-source.db.test.ts`                                                         | `database-source-scope`          | -                              |
 | source-sync.provider-api-and-staged-datasets       | source-sync | Inspect provider APIs and stage/query/delete large provider datasets                                      | action-backed         | `delete-staged-dataset`, `list-staged-datasets`, `provider-api-catalog`, `provider-api-docs`, `provider-api-request`, `query-staged-dataset`                                                                                                                                                                                                                                                                | `actions/provider-api-catalog.ts`, `actions/provider-api-docs.ts`, `actions/provider-api-request.ts`, `actions/query-staged-dataset.ts`                                                   | Provider API metadata and staged dataset scratch storage support scoped agent/source analysis.                                                                                                                                                                                            | -                                                                                                                                                                                                                                          | -                | P1             | seeded        | -                                                                                                                                                                                                                       | -                                | -                              |
 | versions.history-and-restore                       | versions    | Open version history and restore a previous document version                                              | action-backed         | `list-document-versions`, `restore-document-version`                                                                                                                                                                                                                                                                                                                                                        | `app/components/editor/VersionHistoryPanel.tsx`, `app/hooks/use-document-versions.ts`                                                                                                     | Document versions are listed and selected versions can restore the document while snapshotting current state.                                                                                                                                                                             | -                                                                                                                                                                                                                                          | -                | P0             | seeded        | -                                                                                                                                                                                                                       | -                                | -                              |
 | workspace.spaces-and-files-catalog                 | workspace   | Provision, navigate, and delete Content spaces through Files and Workspaces with personal expansion state | action-backed         | `backfill-content-files`, `create-content-space`, `delete-content-space`, `ensure-content-spaces`, `get-content-sidebar-state`, `list-content-spaces`, `update-content-sidebar-state`                                                                                                                                                                                                                       | `app/components/sidebar/DocumentSidebar.tsx`, `app/hooks/use-content-spaces.ts`                                                                                                           | Personal and organization spaces, user-created workspaces, their canonical Files databases, the personal Workspaces catalog, and each user's sidebar expansion state are stored and reconciled in SQL; deleting a user-created workspace atomically removes its catalog row and contents. | -                                                                                                                                                                                                                                          | -                | P0             | covered       | `actions/content-spaces.db.test.ts`, `actions/content-files.db.test.ts`, `actions/content-sidebar-state.test.ts`                                                                                                        | -                                | -                              |