@agent-native/core 0.128.1 → 0.128.2

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

@@ -12,7 +12,7 @@ import type {
   ReorderDocumentPropertyRequest,
   SetDocumentPropertyRequest,
 } from "@shared/api";
-import { useQueryClient } from "@tanstack/react-query";
+import { useQueryClient, type UseMutationResult } from "@tanstack/react-query";
 
 import {
   applyDocumentPropertiesToDatabaseResponse,
@@ -21,13 +21,51 @@ import {
   contentDatabaseQueryKey,
   removeDocumentPropertyFromDatabaseResponse,
 } from "./use-content-database";
+import { documentPropertiesQueryKey } from "./use-documents";
 
-export function useDocumentProperties(documentId: string | null) {
+type DatabaseScopedRequest = { databaseId: string };
+
+export function documentPropertiesResponseMatchesScope(
+  documentId: string,
+  databaseId: string,
+  data: DocumentPropertiesResponse | undefined,
+): data is DocumentPropertiesResponse {
+  return data?.documentId === documentId && data.databaseId === databaseId;
+}
+
+function withDatabaseScope<
+  TData,
+  TVariables extends DatabaseScopedRequest,
+  TContext,
+>(
+  mutation: UseMutationResult<TData, Error, TVariables, TContext>,
+  databaseId: string,
+) {
+  type ScopedVariables = Omit<TVariables, "databaseId">;
+  return {
+    ...mutation,
+    mutate: (variables: ScopedVariables, options?: unknown) =>
+      mutation.mutate(
+        { ...variables, databaseId } as TVariables,
+        options as never,
+      ),
+    mutateAsync: (variables: ScopedVariables, options?: unknown) =>
+      mutation.mutateAsync(
+        { ...variables, databaseId } as TVariables,
+        options as never,
+      ),
+  } as UseMutationResult<TData, Error, ScopedVariables, TContext>;
+}
+
+export function useDocumentProperties(
+  documentId: string | null,
+  databaseId: string | null,
+) {
   return useActionQuery<DocumentPropertiesResponse>(
     "list-document-properties",
-    documentId ? { documentId } : undefined,
+    documentId && databaseId ? { documentId, databaseId } : undefined,
     {
-      enabled: !!documentId,
+      enabled: !!documentId && !!databaseId,
       placeholderData: (prev) => prev,
     },
   );
@@ -35,10 +73,11 @@ export function useDocumentProperties(documentId: string | null) {
 
 export function useConfigureDocumentProperty(
   documentId: string,
+  databaseId: string,
   databaseDocumentId = documentId,
 ) {
   const queryClient = useQueryClient();
-  return useActionMutation<
+  const mutation = useActionMutation<
     DocumentPropertiesResponse,
     ConfigureDocumentPropertyRequest
   >("configure-document-property", {
@@ -49,7 +88,7 @@ export function useConfigureDocumentProperty(
         (current) => applyDocumentPropertiesToDatabaseResponse(current, data),
       );
       queryClient.invalidateQueries({
-        queryKey: ["action", "list-document-properties", { documentId }],
+        queryKey: documentPropertiesQueryKey(documentId, databaseId),
       });
       queryClient.invalidateQueries({
         queryKey: ["action", "get-document", { id: documentId }],
@@ -59,14 +98,16 @@ export function useConfigureDocumentProperty(
       });
     },
   });
+  return withDatabaseScope(mutation, databaseId);
 }
 
 export function useSetDocumentProperty(
   documentId: string,
+  databaseId: string,
   databaseDocumentId = documentId,
 ) {
   const queryClient = useQueryClient();
-  return useActionMutation<
+  const mutation = useActionMutation<
     DocumentPropertiesResponse,
     SetDocumentPropertyRequest
   >("set-document-property", {
@@ -114,11 +155,7 @@ export function useSetDocumentProperty(
           }),
       );
       queryClient.invalidateQueries({
-        queryKey: [
-          "action",
-          "list-document-properties",
-          { documentId: variables.documentId },
-        ],
+        queryKey: documentPropertiesQueryKey(variables.documentId, databaseId),
       });
       queryClient.invalidateQueries({
         queryKey: ["action", "get-document", { id: variables.documentId }],
@@ -135,14 +172,16 @@ export function useSetDocumentProperty(
       });
     },
   });
+  return withDatabaseScope(mutation, databaseId);
 }
 
 export function useDuplicateDocumentProperty(
   documentId: string,
+  databaseId: string,
   databaseDocumentId = documentId,
 ) {
   const queryClient = useQueryClient();
-  return useActionMutation<
+  const mutation = useActionMutation<
     DocumentPropertiesResponse,
     DuplicateDocumentPropertyRequest
   >("duplicate-document-property", {
@@ -153,7 +192,7 @@ export function useDuplicateDocumentProperty(
         (current) => applyDocumentPropertiesToDatabaseResponse(current, data),
       );
       queryClient.invalidateQueries({
-        queryKey: ["action", "list-document-properties", { documentId }],
+        queryKey: documentPropertiesQueryKey(documentId, databaseId),
       });
       queryClient.invalidateQueries({
         queryKey: ["action", "get-document", { id: documentId }],
@@ -163,20 +202,22 @@ export function useDuplicateDocumentProperty(
       });
     },
   });
+  return withDatabaseScope(mutation, databaseId);
 }
 
 export function useReorderDocumentProperty(
   documentId: string,
+  databaseId: string,
   databaseDocumentId = documentId,
 ) {
   const queryClient = useQueryClient();
-  return useActionMutation<
+  const mutation = useActionMutation<
     DocumentPropertiesResponse,
     ReorderDocumentPropertyRequest
   >("reorder-document-property", {
     onSuccess: () => {
       queryClient.invalidateQueries({
-        queryKey: ["action", "list-document-properties", { documentId }],
+        queryKey: documentPropertiesQueryKey(documentId, databaseId),
       });
       queryClient.invalidateQueries({
         queryKey: ["action", "get-document", { id: documentId }],
@@ -186,14 +227,16 @@ export function useReorderDocumentProperty(
       });
     },
   });
+  return withDatabaseScope(mutation, databaseId);
 }
 
 export function useDeleteDocumentProperty(
   documentId: string,
+  databaseId: string,
   databaseDocumentId = documentId,
 ) {
   const queryClient = useQueryClient();
-  return useActionMutation<
+  const mutation = useActionMutation<
     DocumentPropertiesResponse,
     DeleteDocumentPropertyRequest
   >("delete-document-property", {
@@ -231,7 +274,7 @@ export function useDeleteDocumentProperty(
         (current) => applyDocumentPropertiesToDatabaseResponse(current, data),
       );
       queryClient.invalidateQueries({
-        queryKey: ["action", "list-document-properties", { documentId }],
+        queryKey: documentPropertiesQueryKey(documentId, databaseId),
       });
       queryClient.invalidateQueries({
         queryKey: ["action", "get-document", { id: documentId }],
@@ -241,4 +284,5 @@ export function useDeleteDocumentProperty(
       });
     },
   });
+  return withDatabaseScope(mutation, databaseId);
 }

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

@@ -36,8 +36,15 @@ export function documentQueryKey(documentId: string) {
   return ["action", "get-document", { id: documentId }] as const;
 }
 
-export function documentPropertiesQueryKey(documentId: string) {
-  return ["action", "list-document-properties", { documentId }] as const;
+export function documentPropertiesQueryKey(
+  documentId: string,
+  databaseId: string,
+) {
+  return [
+    "action",
+    "list-document-properties",
+    { documentId, databaseId },
+  ] as const;
 }
 
 // Extends the shared request/response shapes with the optional
@@ -247,11 +254,12 @@ export function seedDatabaseItemDocumentCaches(
   // owned by get-document; the table may still warm the separately scoped
   // property cache below.
   if (
-    queryClient.getQueryData(documentPropertiesQueryKey(item.document.id)) ===
-    undefined
+    queryClient.getQueryData(
+      documentPropertiesQueryKey(item.document.id, item.databaseId),
+    ) === undefined
   ) {
     queryClient.setQueryData<DocumentPropertiesResponse>(
-      documentPropertiesQueryKey(item.document.id),
+      documentPropertiesQueryKey(item.document.id, item.databaseId),
       {
         documentId: item.document.id,
         databaseId: item.databaseId,

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

@@ -3103,6 +3103,24 @@ const enUS = {
   localFiles: localFilesMessages,
   sidebar: {
     cannotReorderPages: "Cannot reorder pages",
+    pinned: "Pinned",
+    loadingPinned: "Loading pinned items…",
+    dragToReorder: "Drag to reorder {{label}}",
+    moveUp: "Move up",
+    moveDown: "Move down",
+    moveToPosition: "Move to position",
+    positionNumber: "Position {{position}}",
+    failedSaveOrder: "Could not save order",
+    moreActionsFor: "More actions for {{label}}",
+    orderButton: "Order: {{order}}",
+    orderMode: {
+      custom: "Custom",
+      last_edited: "Last edited",
+      name: "Name",
+      created: "Created",
+    },
+    pinToSidebar: "Pin to sidebar",
+    unpinFromSidebar: "Unpin from sidebar",
     addWorkspace: "Add workspace",
     addChild: "Add child",
     addChildTo: "Add child to {{title}}",
@@ -3137,8 +3155,8 @@ const enUS = {
     failedPermanentDeleteDatabase: "Failed to permanently delete database",
     failedPermanentDeletePage: "Failed to permanently delete page",
     failedMovePage: "Failed to move page",
-    failedUpdateFavorite: "Could not update favorite",
-    removeFromFavorites: "Remove from favorites",
+    failedUpdateFavorite: "Could not update pinned items",
+    removeFromFavorites: "Unpin from sidebar",
     failedRemoveLocalFiles: "Failed to remove local files",
     failedRestoreDatabase: "Failed to restore database",
     failedRestorePage: "Failed to restore page",
@@ -3219,7 +3237,7 @@ const enUS = {
     synced: "Synced",
     trash: "Trash",
     trashEmpty: "Trash is empty",
-    favorites: "Favorites",
+    favorites: "Pinned",
     untitled: "Untitled",
     workspaces: "Workspaces",
   },
@@ -10622,6 +10640,242 @@ export const messagesByLocale = {
   }),
 } satisfies Record<LocaleCode, Messages>;
 
+const sidebarPinnedMessagesByLocale: Partial<
+  Record<LocaleCode, Partial<Messages["sidebar"]>>
+> = {
+  "zh-TW": {
+    pinned: "已釘選",
+    loadingPinned: "正在載入已釘選項目…",
+    dragToReorder: "拖曳以重新排序 {{label}}",
+    moveUp: "上移",
+    moveDown: "下移",
+    moveToPosition: "移至位置",
+    positionNumber: "第 {{position}} 個位置",
+    failedSaveOrder: "無法儲存排序",
+    moreActionsFor: "{{label}} 的更多操作",
+    orderButton: "排序：{{order}}",
+    orderMode: {
+      custom: "自訂",
+      last_edited: "最近編輯",
+      name: "名稱",
+      created: "建立時間",
+    },
+    pinToSidebar: "釘選到側邊欄",
+    unpinFromSidebar: "從側邊欄取消釘選",
+    failedUpdateFavorite: "無法更新已釘選項目",
+    removeFromFavorites: "從側邊欄取消釘選",
+    favorites: "已釘選",
+  },
+  "zh-CN": {
+    pinned: "已固定",
+    loadingPinned: "正在加载已固定项目…",
+    dragToReorder: "拖动以重新排序 {{label}}",
+    moveUp: "上移",
+    moveDown: "下移",
+    moveToPosition: "移至位置",
+    positionNumber: "位置 {{position}}",
+    failedSaveOrder: "无法保存排序",
+    moreActionsFor: "{{label}} 的更多操作",
+    orderButton: "排序：{{order}}",
+    orderMode: {
+      custom: "自定义",
+      last_edited: "最近编辑",
+      name: "名称",
+      created: "创建时间",
+    },
+    pinToSidebar: "固定到侧边栏",
+    unpinFromSidebar: "从侧边栏取消固定",
+    failedUpdateFavorite: "无法更新已固定项目",
+    removeFromFavorites: "从侧边栏取消固定",
+    favorites: "已固定",
+  },
+  "es-ES": {
+    pinned: "Fijados",
+    loadingPinned: "Cargando elementos fijados…",
+    dragToReorder: "Arrastra para reordenar {{label}}",
+    moveUp: "Mover hacia arriba",
+    moveDown: "Mover hacia abajo",
+    moveToPosition: "Mover a la posición",
+    positionNumber: "Posición {{position}}",
+    failedSaveOrder: "No se pudo guardar el orden",
+    moreActionsFor: "Más acciones para {{label}}",
+    orderButton: "Orden: {{order}}",
+    orderMode: {
+      custom: "Personalizado",
+      last_edited: "Última edición",
+      name: "Nombre",
+      created: "Creado",
+    },
+    pinToSidebar: "Fijar a la barra lateral",
+    unpinFromSidebar: "Desfijar de la barra lateral",
+    failedUpdateFavorite: "No se pudieron actualizar los elementos fijados",
+    removeFromFavorites: "Desfijar de la barra lateral",
+    favorites: "Fijados",
+  },
+  "fr-FR": {
+    pinned: "Épinglés",
+    loadingPinned: "Chargement des éléments épinglés…",
+    dragToReorder: "Faites glisser {{label}} pour le réorganiser",
+    moveUp: "Monter",
+    moveDown: "Descendre",
+    moveToPosition: "Déplacer à la position",
+    positionNumber: "Position {{position}}",
+    failedSaveOrder: "Impossible d’enregistrer l’ordre",
+    moreActionsFor: "Autres actions pour {{label}}",
+    orderButton: "Ordre : {{order}}",
+    orderMode: {
+      custom: "Personnalisé",
+      last_edited: "Dernière modification",
+      name: "Nom",
+      created: "Créé",
+    },
+    pinToSidebar: "Épingler à la barre latérale",
+    unpinFromSidebar: "Désépingler de la barre latérale",
+    failedUpdateFavorite: "Impossible de mettre à jour les éléments épinglés",
+    removeFromFavorites: "Désépingler de la barre latérale",
+    favorites: "Épinglés",
+  },
+  "de-DE": {
+    pinned: "Angeheftet",
+    loadingPinned: "Angeheftete Elemente werden geladen…",
+    dragToReorder: "{{label}} zum Neuordnen ziehen",
+    moveUp: "Nach oben verschieben",
+    moveDown: "Nach unten verschieben",
+    moveToPosition: "An Position verschieben",
+    positionNumber: "Position {{position}}",
+    failedSaveOrder: "Reihenfolge konnte nicht gespeichert werden",
+    moreActionsFor: "Weitere Aktionen für {{label}}",
+    orderButton: "Reihenfolge: {{order}}",
+    orderMode: {
+      custom: "Benutzerdefiniert",
+      last_edited: "Zuletzt bearbeitet",
+      name: "Name",
+      created: "Erstellt",
+    },
+    pinToSidebar: "In Seitenleiste anheften",
+    unpinFromSidebar: "Aus Seitenleiste lösen",
+    failedUpdateFavorite:
+      "Angeheftete Elemente konnten nicht aktualisiert werden",
+    removeFromFavorites: "Aus Seitenleiste lösen",
+    favorites: "Angeheftet",
+  },
+  "ja-JP": {
+    pinned: "固定済み",
+    loadingPinned: "固定済みの項目を読み込み中…",
+    dragToReorder: "{{label}} をドラッグして並べ替え",
+    moveUp: "上に移動",
+    moveDown: "下に移動",
+    moveToPosition: "指定位置に移動",
+    positionNumber: "位置 {{position}}",
+    failedSaveOrder: "並び順を保存できませんでした",
+    moreActionsFor: "{{label}} のその他の操作",
+    orderButton: "並び順: {{order}}",
+    orderMode: {
+      custom: "カスタム",
+      last_edited: "最終編集",
+      name: "名前",
+      created: "作成日",
+    },
+    pinToSidebar: "サイドバーに固定",
+    unpinFromSidebar: "サイドバーから固定解除",
+    failedUpdateFavorite: "固定済みの項目を更新できませんでした",
+    removeFromFavorites: "サイドバーから固定解除",
+    favorites: "固定済み",
+  },
+  "ko-KR": {
+    pinned: "고정됨",
+    loadingPinned: "고정된 항목 불러오는 중…",
+    dragToReorder: "{{label}} 드래그하여 순서 변경",
+    moveUp: "위로 이동",
+    moveDown: "아래로 이동",
+    moveToPosition: "위치로 이동",
+    positionNumber: "{{position}}번째 위치",
+    failedSaveOrder: "순서를 저장하지 못했습니다",
+    moreActionsFor: "{{label}}의 추가 작업",
+    orderButton: "정렬: {{order}}",
+    orderMode: {
+      custom: "사용자 지정",
+      last_edited: "최근 수정",
+      name: "이름",
+      created: "생성일",
+    },
+    pinToSidebar: "사이드바에 고정",
+    unpinFromSidebar: "사이드바에서 고정 해제",
+    failedUpdateFavorite: "고정된 항목을 업데이트하지 못했습니다",
+    removeFromFavorites: "사이드바에서 고정 해제",
+    favorites: "고정됨",
+  },
+  "pt-BR": {
+    pinned: "Fixados",
+    loadingPinned: "Carregando itens fixados…",
+    dragToReorder: "Arraste para reordenar {{label}}",
+    moveUp: "Mover para cima",
+    moveDown: "Mover para baixo",
+    moveToPosition: "Mover para a posição",
+    positionNumber: "Posição {{position}}",
+    failedSaveOrder: "Não foi possível salvar a ordem",
+    moreActionsFor: "Mais ações para {{label}}",
+    orderButton: "Ordem: {{order}}",
+    orderMode: {
+      custom: "Personalizado",
+      last_edited: "Última edição",
+      name: "Nome",
+      created: "Criado",
+    },
+    pinToSidebar: "Fixar na barra lateral",
+    unpinFromSidebar: "Desafixar da barra lateral",
+    failedUpdateFavorite: "Não foi possível atualizar os itens fixados",
+    removeFromFavorites: "Desafixar da barra lateral",
+    favorites: "Fixados",
+  },
+  "hi-IN": {
+    pinned: "पिन किए गए",
+    loadingPinned: "पिन किए गए आइटम लोड हो रहे हैं…",
+    dragToReorder: "{{label}} को फिर से क्रमबद्ध करने के लिए खींचें",
+    moveUp: "ऊपर ले जाएँ",
+    moveDown: "नीचे ले जाएँ",
+    moveToPosition: "स्थान पर ले जाएँ",
+    positionNumber: "स्थान {{position}}",
+    failedSaveOrder: "क्रम सहेजा नहीं जा सका",
+    moreActionsFor: "{{label}} के लिए और कार्रवाइयाँ",
+    orderButton: "क्रम: {{order}}",
+    orderMode: {
+      custom: "कस्टम",
+      last_edited: "अंतिम संपादन",
+      name: "नाम",
+      created: "बनाया गया",
+    },
+    pinToSidebar: "साइडबार में पिन करें",
+    unpinFromSidebar: "साइडबार से अनपिन करें",
+    failedUpdateFavorite: "पिन किए गए आइटम अपडेट नहीं किए जा सके",
+    removeFromFavorites: "साइडबार से अनपिन करें",
+    favorites: "पिन किए गए",
+  },
+  "ar-SA": {
+    pinned: "مثبتة",
+    loadingPinned: "جارٍ تحميل العناصر المثبتة…",
+    dragToReorder: "اسحب لإعادة ترتيب {{label}}",
+    moveUp: "نقل لأعلى",
+    moveDown: "نقل لأسفل",
+    moveToPosition: "نقل إلى موضع",
+    positionNumber: "الموضع {{position}}",
+    failedSaveOrder: "تعذر حفظ الترتيب",
+    moreActionsFor: "مزيد من الإجراءات لـ {{label}}",
+    orderButton: "الترتيب: {{order}}",
+    orderMode: {
+      custom: "مخصص",
+      last_edited: "آخر تعديل",
+      name: "الاسم",
+      created: "تاريخ الإنشاء",
+    },
+    pinToSidebar: "تثبيت في الشريط الجانبي",
+    unpinFromSidebar: "إلغاء التثبيت من الشريط الجانبي",
+    failedUpdateFavorite: "تعذر تحديث العناصر المثبتة",
+    removeFromFavorites: "إلغاء التثبيت من الشريط الجانبي",
+    favorites: "مثبتة",
+  },
+};
+
 const contentExactEnglishTranslations = {
   "zh-TW": {
     editor: {
@@ -11106,4 +11360,8 @@ for (const [locale, overrides] of Object.entries(
       }
     }
   }
+  const sidebarPinnedMessages = sidebarPinnedMessagesByLocale[locale];
+  if (sidebarPinnedMessages) {
+    Object.assign(messages.sidebar, sidebarPinnedMessages);
+  }
 }

package/corpus/templates/content/app/routes/_app.page.$id.tsx

@@ -1,5 +1,5 @@
 import { useT } from "@agent-native/core/client/i18n";
-import { useParams } from "react-router";
+import { useParams, useSearchParams } from "react-router";
 
 import { DocumentEditor } from "@/components/editor/DocumentEditor";
 import { messagesByLocale } from "@/i18n-data";
@@ -19,9 +19,16 @@ export function meta() {
 export default function DocumentPage() {
   const t = useT();
   const { id } = useParams<{ id: string }>();
+  const [searchParams] = useSearchParams();
+  const databaseId = searchParams.get("databaseId");
+  const databaseDocumentId = searchParams.get("databaseDocumentId");
 
   return id ? (
-    <DocumentEditor documentId={id} />
+    <DocumentEditor
+      documentId={id}
+      databaseId={databaseId}
+      databaseDocumentId={databaseDocumentId}
+    />
   ) : (
     <div className="flex-1 flex items-center justify-center text-muted-foreground">
       {t("empty.documentNotFound")}

package/corpus/templates/content/changelog/2026-07-24-database-page-properties-keep-their-context.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-07-24
+---
+
+Database pages now keep the correct properties when opened from a database or moved to the full-page editor.

package/corpus/templates/content/changelog/2026-07-26-sidebar-references-can-now-be-personally-reordered.md

@@ -0,0 +1,6 @@
+---
+type: added
+date: 2026-07-26
+---
+
+Sidebar references can now be personally reordered, with Custom, Name, Last edited, and Created options for workspace Files.