@agent-native/core 0.119.6 → 0.120.1

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

@@ -197,6 +197,7 @@ import {
 } from "@/hooks/use-document-properties";
 import {
   isDocumentUpdateConflict,
+  type DocumentUpdateResult,
   useDeleteDocument,
   useDocument,
   seedDatabaseItemDocumentCaches,
@@ -254,7 +255,10 @@ import { EmojiPicker } from "../EmojiPicker";
 import {
   createPreviewDocumentSaveController,
   deferredPreviewDocumentSave,
+  type PreviewDocumentPayload,
   type PreviewDocumentSaveAdapter,
+  type PreviewDocumentSaveDeferred,
+  type PreviewDocumentSaveSuccess,
 } from "../previewDocumentSaveController";
 import {
   acquirePreviewDocumentSaveController,
@@ -436,7 +440,8 @@ export function databaseCreatedItemForImmediatePreview(
   if (returnedItem) return returnedItem;
   if (!response.createdItemId || !response.createdDocumentId) return null;
 
-  const now = args.now ?? new Date().toISOString();
+  const now =
+    response.createdDocumentUpdatedAt ?? args.now ?? new Date().toISOString();
   const position = Math.max(
     0,
     (response.pagination?.totalItems ?? response.items.length + 1) - 1,
@@ -473,6 +478,42 @@ export function databaseCreatedItemForImmediatePreview(
   };
 }
 
+export function previewDocumentSaveResult(args: {
+  result: DocumentUpdateResult;
+  payload: PreviewDocumentPayload;
+  baseline?: PreviewDocumentPayload;
+  contentChanged: boolean;
+}): PreviewDocumentSaveDeferred | PreviewDocumentSaveSuccess {
+  const serverDocument = isDocumentUpdateConflict(args.result)
+    ? args.result.document
+    : args.result;
+  const titleSaveObservedExternalBody =
+    !args.contentChanged && serverDocument.content !== args.payload.content;
+
+  if (isDocumentUpdateConflict(args.result) || titleSaveObservedExternalBody) {
+    return deferredPreviewDocumentSave("conflict", {
+      lastSaved: args.baseline ?? args.payload,
+      pending: {
+        title: serverDocument.title,
+        content: serverDocument.content,
+        loadedUpdatedAt: serverDocument.updatedAt,
+        loadedContentWasEmpty: isEffectivelyEmptyDocumentContent(
+          serverDocument.content,
+        ),
+      },
+      deferredReason: "conflict",
+    });
+  }
+
+  return {
+    outcome: "saved",
+    loadedUpdatedAt: args.result.updatedAt,
+    loadedContentWasEmpty: isEffectivelyEmptyDocumentContent(
+      args.result.content,
+    ),
+  };
+}
+
 export function databaseBuilderHydrationSourceForItem(
   item: ContentDatabaseItem,
   sources: ContentDatabaseSource[],
@@ -4098,8 +4139,6 @@ function DatabaseItemPreview({
   // ever touch its own row's state. See previewDocumentSaveRegistry.
   const updateDocumentRef = useRef(updateDocument);
   updateDocumentRef.current = updateDocument;
-  const queryClientRef = useRef(queryClient);
-  queryClientRef.current = queryClient;
   const bodyHydrationPendingRef = useRef(bodyHydrationPending);
   bodyHydrationPendingRef.current = bodyHydrationPending;
   const draftVersionsRef = useRef<Map<string, number | null>>(new Map());
@@ -4244,30 +4283,14 @@ function DatabaseItemPreview({
           },
           {
             onSuccess: (result) => {
-              if (isDocumentUpdateConflict(result)) {
-                resolve(
-                  deferredPreviewDocumentSave("conflict", {
-                    lastSaved: baseline ?? payload,
-                    pending: {
-                      title: result.document.title,
-                      content: result.document.content,
-                      loadedUpdatedAt: result.document.updatedAt,
-                      loadedContentWasEmpty: isEffectivelyEmptyDocumentContent(
-                        result.document.content,
-                      ),
-                    },
-                    deferredReason: "conflict",
-                  }),
-                );
-                return;
-              }
-              resolve({
-                outcome: "saved" as const,
-                loadedUpdatedAt: result.updatedAt,
-                loadedContentWasEmpty: isEffectivelyEmptyDocumentContent(
-                  result.content,
-                ),
-              });
+              resolve(
+                previewDocumentSaveResult({
+                  result,
+                  payload,
+                  baseline,
+                  contentChanged,
+                }),
+              );
             },
             onError: reject,
           },
@@ -4276,12 +4299,6 @@ function DatabaseItemPreview({
     onSaved: (persistedPayload) => {
       const controller = peekPreviewDocumentSaveController(documentId);
       if (controller) enqueueDraftWrite(controller, "delete", persistedPayload);
-      void queryClientRef.current.invalidateQueries({
-        queryKey: contentDatabaseQueryKey(databaseDocumentId),
-      });
-      void queryClientRef.current.invalidateQueries({
-        queryKey: ["action", "list-documents"],
-      });
     },
     onError: (err) => {
       toast.error(dbText("failedToSavePagePreview"), {
@@ -4876,6 +4893,7 @@ function DatabaseItemPreview({
             {previewDocument.databaseMembership ? (
               <DocumentProperties
                 documentId={previewDocument.id}
+                databaseDocumentId={databaseDocumentId}
                 canEdit={previewCanEdit}
                 popoversPortalled={false}
               />
@@ -4913,6 +4931,7 @@ function DatabaseItemPreview({
                 const editor = previewDocument.databaseMembership ? (
                   <DocumentBlockFields
                     documentId={previewDocument.id}
+                    databaseDocumentId={databaseDocumentId}
                     canEdit={previewCanEdit}
                     primaryEditor={primaryEditor}
                   />

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

@@ -130,8 +130,8 @@ export interface PreviewDocumentSaveController {
   /** Adopt `payload` as the confirmed-saved baseline (no save scheduled). */
   mark(payload: PreviewDocumentPayload): void;
   /**
-   * Adopt a fresher server baseline while retaining the user's pending title
-   * and content. Used only after an explicit "keep local draft" choice.
+   * Adopt a fresher server baseline while retaining only fields the user
+   * changed locally. Used only after an explicit "keep local draft" choice.
    */
   rebasePending(payload: PreviewDocumentPayload): void;
   /** Replace callbacks captured by an older preview mount. */
@@ -261,8 +261,7 @@ export function createPreviewDocumentSaveController(
         // the controller was created/last marked — e.g. "empty" for a
         // brand-new page — forever, even after real content has been saved.
         const success = asSaveSuccess(result);
-        lastSaved = {
-          ...attempted,
+        const savedMetadata = {
           ...(success?.loadedUpdatedAt !== undefined
             ? { loadedUpdatedAt: success.loadedUpdatedAt }
             : {}),
@@ -270,6 +269,15 @@ export function createPreviewDocumentSaveController(
             ? { loadedContentWasEmpty: success.loadedContentWasEmpty }
             : {}),
         };
+        lastSaved = {
+          ...attempted,
+          ...savedMetadata,
+        };
+        // A later keystroke starts from `pending`, including while this save is
+        // in flight. Rebase that trailing payload onto our own successful write
+        // so its next CAS does not mistake the preceding save for an external
+        // change.
+        pending = { ...pending, ...savedMetadata };
         hasSavedLocally = true;
         deferredReason = null;
         inFlight = null;
@@ -336,9 +344,13 @@ export function createPreviewDocumentSaveController(
     },
     rebasePending(payload: PreviewDocumentPayload) {
       clearTimer();
+      const titleChangedLocally = pending.title !== lastSaved.title;
+      const contentChangedLocally = pending.content !== lastSaved.content;
       lastSaved = { ...payload };
       pending = {
         ...pending,
+        title: titleChangedLocally ? pending.title : payload.title,
+        content: contentChangedLocally ? pending.content : payload.content,
         loadedUpdatedAt: payload.loadedUpdatedAt,
         loadedContentWasEmpty: payload.loadedContentWasEmpty,
       };

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

@@ -121,6 +121,10 @@ import {
   filterDocumentTreeDocuments,
 } from "@/hooks/use-documents";
 import { useLocalStorage } from "@/hooks/use-local-storage";
+import {
+  markDocumentCreationPending,
+  shouldCreateDocumentOptimistically,
+} from "@/lib/optimistic-document";
 import { cn } from "@/lib/utils";
 
 import {
@@ -747,7 +751,12 @@ export function DocumentSidebar({
       optimisticId?: string,
       rootFilesDatabaseId?: string,
     ) => {
-      if (localFileMode) {
+      if (
+        !shouldCreateDocumentOptimistically({
+          localFileMode,
+          filesDatabaseId: rootFilesDatabaseId,
+        })
+      ) {
         try {
           const created = await createDocument.mutateAsync({
             title: "",
@@ -774,7 +783,7 @@ export function DocumentSidebar({
 
       const id = optimisticId ?? nanoid();
       const now = new Date().toISOString();
-      const tempDoc: Document = {
+      const tempDoc = markDocumentCreationPending({
         id,
         parentId: parentId ?? null,
         title: "",
@@ -789,7 +798,7 @@ export function DocumentSidebar({
         canManage: true,
         createdAt: now,
         updatedAt: now,
-      };
+      });
 
       // Optimistically inject into caches so UI updates immediately
       queryClient.setQueryData(LIST_DOCUMENTS_QUERY_KEY, (old: any) => {
@@ -824,14 +833,14 @@ export function DocumentSidebar({
           spaceId: parentId ? undefined : rootSpaceId,
         });
         const nextId = created?.id || id;
+        queryClient.setQueryData(
+          ["action", "get-document", { id: nextId }],
+          created,
+        );
         if (nextId !== id) {
           queryClient.removeQueries({
             queryKey: ["action", "get-document", { id }],
           });
-          queryClient.setQueryData(
-            ["action", "get-document", { id: nextId }],
-            created,
-          );
           navigateToDocument(nextId);
         }
         // Replace optimistic doc with real server doc + clear any 404 error

package/corpus/templates/content/app/hooks/use-create-page.ts

@@ -12,6 +12,7 @@ import {
 import { useContentSpaces } from "@/hooks/use-content-spaces";
 import { useCreateDocument } from "@/hooks/use-documents";
 import { useLocalStorage } from "@/hooks/use-local-storage";
+import { markDocumentCreationPending } from "@/lib/optimistic-document";
 
 const LIST_DOCUMENTS_QUERY_KEY = [
   "action",
@@ -63,7 +64,7 @@ export function useCreatePage(opts?: {
       }
       const id = nanoid();
       const now = new Date().toISOString();
-      const tempDoc: Document = {
+      const tempDoc = markDocumentCreationPending({
         id,
         parentId: parentId ?? null,
         title: "",
@@ -75,7 +76,7 @@ export function useCreatePage(opts?: {
         visibility: "private",
         createdAt: now,
         updatedAt: now,
-      };
+      });
 
       queryClient.setQueryData(LIST_DOCUMENTS_QUERY_KEY, (old: any) => {
         const docs: Document[] =
@@ -90,12 +91,16 @@ export function useCreatePage(opts?: {
       }
 
       const persist = async () => {
-        await createDocument.mutateAsync({
+        const created = await createDocument.mutateAsync({
           id,
           title: "",
           parentId: parentId ?? undefined,
           spaceId,
         });
+        queryClient.setQueryData(
+          ["action", "get-document", { id: created.id }],
+          created,
+        );
         // Replace optimistic doc with real server doc + clear any 404 error
         // state from the in-flight fetch that ran before create completed.
         queryClient.invalidateQueries({

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

@@ -70,6 +70,7 @@ export function useSetDocumentProperty(
     DocumentPropertiesResponse,
     SetDocumentPropertyRequest
   >("set-document-property", {
+    skipActionQueryInvalidation: true,
     onMutate: async (variables) => {
       await queryClient.cancelQueries(
         contentDatabaseQueryFilter(databaseDocumentId),

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

@@ -342,7 +342,9 @@ export function useUpdatePreviewDocumentDraft() {
         expectedTitle: string;
         expectedContent: string;
       }
-  >("update-preview-document-draft");
+  >("update-preview-document-draft", {
+    skipActionQueryInvalidation: true,
+  });
 }
 
 export function useCreateDocument() {

package/corpus/templates/content/app/lib/optimistic-document.ts

@@ -0,0 +1,29 @@
+import type { Document } from "@shared/api";
+
+const pendingDocumentCreation = Symbol("pendingDocumentCreation");
+
+type PendingDocument = Document & {
+  [pendingDocumentCreation]?: true;
+};
+
+export function markDocumentCreationPending(document: Document): Document {
+  return Object.assign(document, { [pendingDocumentCreation]: true as const });
+}
+
+export function isDocumentCreationPending(document: Document): boolean {
+  return (document as PendingDocument)[pendingDocumentCreation] === true;
+}
+
+export function isDatabaseChoicePending(
+  document: Document,
+  databaseCreationPending: boolean,
+): boolean {
+  return databaseCreationPending || isDocumentCreationPending(document);
+}
+
+export function shouldCreateDocumentOptimistically(args: {
+  localFileMode: boolean;
+  filesDatabaseId?: string;
+}): boolean {
+  return !args.localFileMode || Boolean(args.filesDatabaseId);
+}

package/corpus/templates/content/changelog/2026-07-21-editing-a-database-property-no-longer-refreshes-unrelated-co.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-07-21
+---
+
+Editing a database page no longer refreshes unrelated Content workspace data or interrupts typing in the originating tab.

package/corpus/templates/content/changelog/2026-07-23-new-database-ready.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-07-23
+---
+
+New pages wait until they are ready before offering database conversion.

package/corpus/templates/content/package.json

@@ -4,7 +4,7 @@
   "private": true,
   "type": "module",
   "scripts": {
-    "dev": "agent-native dev",
+    "dev": "agent-native dev --inspect",
     "dev:database": "node scripts/check-native-deps.mjs && node scripts/dev-database.mjs",
     "build": "agent-native build",
     "start": "agent-native start",

package/corpus/templates/content/shared/api.ts

@@ -749,6 +749,7 @@ export interface ContentDatabaseResponse {
   };
   createdItemId?: string;
   createdDocumentId?: string;
+  createdDocumentUpdatedAt?: string;
   duplicatedItemId?: string;
   duplicatedDocumentId?: string;
   duplicatedItemIds?: string[];

package/corpus/templates/design/package.json

@@ -4,7 +4,7 @@
   "private": true,
   "type": "module",
   "scripts": {
-    "dev": "agent-native dev",
+    "dev": "agent-native dev --inspect",
     "build": "agent-native build",
     "start": "agent-native start",
     "test": "vitest --run",

package/corpus/templates/dispatch/package.json

@@ -4,7 +4,7 @@
   "private": true,
   "type": "module",
   "scripts": {
-    "dev": "agent-native dev",
+    "dev": "agent-native dev --inspect",
     "build": "agent-native build",
     "start": "agent-native start",
     "typecheck": "agent-native typecheck",

package/corpus/templates/forms/.agents/skills/form-publishing/SKILL.md

@@ -77,7 +77,7 @@ Each form has a `settings` JSON object:
 | `showProgressBar`  | boolean | Show progress bar for multi-section forms  |
 | `emailOnNewResponses` | boolean | Email the form owner's account when someone submits a response |
 | `anonymous`        | boolean | Suppress IP, submitter identity, chat/run ids, page URL, and client-surface metadata for every response |
-| `integrations`     | array   | Webhook/Slack/Discord notification configs |
+| `integrations`     | array   | Webhook/Slack/Discord/Google Sheets notification configs |
 
 For a genuinely anonymous form, set `anonymous: true` when creating the form.
 Do not describe an ordinary published form as anonymous: published forms accept
@@ -91,9 +91,15 @@ Forms can notify external services on submission:
 | Type            | Description                     |
 | --------------- | ------------------------------- |
 | `webhook`       | POST JSON to any URL            |
-| `slack`         | Send to a Slack channel         |
+| `slack`         | Send to a Slack channel through an Incoming Webhook URL |
 | `discord`       | Send to a Discord webhook       |
-| `google-sheets` | Append row to a Google Sheet    |
+| `google-sheets` | Send response JSON to a deployed Apps Script `/exec` URL |
+
+These are outbound form destinations configured in the form builder's
+**Integrations** tab. They are separate from the managed Slack/Messaging
+connection. Google Sheets Apps Script handlers should parse
+`JSON.parse(e.postData.contents)`; a spreadsheet URL or `/dev` URL will not
+receive submissions.
 
 ## Related Skills
 

package/corpus/templates/forms/AGENTS.md

@@ -40,7 +40,17 @@ ladder.
 - To email the form owner when someone submits a response, set
   `settings.emailOnNewResponses: true` through `create-form` or `update-form`.
   Delivery uses the configured framework email provider (`RESEND_API_KEY` or
-  `SENDGRID_API_KEY`) and sends to the form owner's account email.
+  `SENDGRID_API_KEY`) in the form owner's request context and sends to the form
+  owner's account email. A public submission can succeed even when delivery
+  fails, so check the server logs and provider configuration when debugging.
+- Conditional fields use `conditional: { fieldId, operator, value }`. The
+  `fieldId` must reference an earlier field; supported operators are `equals`,
+  `not_equals`, and `contains`. Hidden fields and their stale values are not
+  persisted or delivered to integrations.
+- Form integrations are outbound webhooks. Slack requires an Incoming Webhook
+  URL, and Google Sheets requires a deployed Google Apps Script `/exec` URL that
+  parses `JSON.parse(e.postData.contents)` and appends the received values.
+  They are separate from the managed Slack/Messaging connection.
 - Form UX should stay focused: clear labels, sensible validation, minimal
   required fields, and progressive disclosure for advanced settings.
 - Public form submission endpoints must be intentionally public; keep management

package/corpus/templates/forms/README.md

@@ -17,7 +17,8 @@ them.
 - Shipped field types: text, email, number, long text, select, multi-select,
   checkbox, radio, date, rating, and scale.
 - Submissions stored in SQL with a per-response detail view and dashboard.
-- Route submissions to webhooks, Slack, Discord, or Google Sheets.
+- Route submissions to webhooks, Slack, Discord, or Google Sheets via Apps
+  Script.
 - Publish public form URLs with a thank-you message.
 
 ## Develop locally
@@ -32,3 +33,25 @@ pnpm dev
 ```
 
 Full docs: [agent-native.com/docs/template-forms](https://agent-native.com/docs/template-forms).
+
+## Submission destinations
+
+Open a form's **Integrations** tab and save a destination before publishing.
+Slack uses an Incoming Webhook URL. Google Sheets uses a deployed Apps Script
+web app URL ending in `/exec` (not a spreadsheet URL or `/dev` URL). The script
+should parse the JSON body and append the values, for example:
+
+```ts
+function doPost(e) {
+  const payload = JSON.parse(e.postData.contents);
+  SpreadsheetApp.getActiveSpreadsheet()
+    .getSheets()[0]
+    .appendRow([payload.submittedAt, payload.formTitle, payload.responseId]);
+  return ContentService.createTextOutput(JSON.stringify({ ok: true }));
+}
+```
+
+Deploy it as a web app that executes as you and allows anyone with the URL to
+access it, then paste the deployed `/exec` URL into Forms. The destination
+receives the form metadata plus one property per field label; duplicate labels
+are disambiguated with the field ID.

package/corpus/templates/forms/actions/update-form.ts

@@ -85,22 +85,29 @@ export default defineAction({
       updates.fields = JSON.stringify(parsedFields);
     }
     if (args.settings !== undefined) {
-      let parsedSettings: FormSettings;
+      let incomingSettings: FormSettings;
       if (typeof args.settings === "string") {
         try {
-          parsedSettings = JSON.parse(args.settings) as FormSettings;
-          updates.settings = args.settings;
+          incomingSettings = JSON.parse(args.settings) as FormSettings;
         } catch {
           throw new Error("--settings must be valid JSON");
         }
       } else {
-        parsedSettings = args.settings as unknown as FormSettings;
-        updates.settings = JSON.stringify(args.settings);
+        incomingSettings = args.settings as unknown as FormSettings;
       }
+      let existingSettings: FormSettings = {};
+      try {
+        existingSettings = JSON.parse(existing.settings) as FormSettings;
+      } catch {
+        // Keep malformed legacy settings recoverable by replacing them with
+        // the valid settings supplied by this update.
+      }
+      const parsedSettings = { ...existingSettings, ...incomingSettings };
       // Reject blocked integration URLs at save time (private IPs,
       // cloud-metadata, non-http(s) schemes). fireIntegrations also
       // re-checks at runtime as defense-in-depth.
       assertIntegrationUrlsAllowed(parsedSettings);
+      updates.settings = JSON.stringify(parsedSettings);
     }
     if (args.status !== undefined) updates.status = args.status;