@agent-native/core 0.148.1 → 0.149.1

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

@@ -1353,6 +1353,9 @@ const enUS = {
     newDesign: "New Design",
     newDesignLower: "New design",
     createDesignProject: "Create a design project",
+    createdBy: "Created by",
+    allAuthors: "All authors",
+    me: "Me",
     openingDesign: "Opening design...",
     skipToEditor: "Skip to editor",
     failedToCreateDesign: "Failed to create design",
@@ -15375,6 +15378,72 @@ const designComponentSourceOverrides = {
   },
 } satisfies Record<Exclude<LocaleCode, "en-US" | "zh-TW">, PartialMessages>;
 
+const designAuthorFilterOverrides = {
+  "zh-CN": {
+    home: {
+      createdBy: "创建者",
+      allAuthors: "所有作者",
+      me: "我",
+    },
+  },
+  "es-ES": {
+    home: {
+      createdBy: "Creado por",
+      allAuthors: "Todos los autores",
+      me: "Yo",
+    },
+  },
+  "fr-FR": {
+    home: {
+      createdBy: "Créé par",
+      allAuthors: "Tous les auteurs",
+      me: "Moi",
+    },
+  },
+  "de-DE": {
+    home: {
+      createdBy: "Erstellt von",
+      allAuthors: "Alle Autoren",
+      me: "Ich",
+    },
+  },
+  "ja-JP": {
+    home: {
+      createdBy: "作成者",
+      allAuthors: "すべての作成者",
+      me: "自分",
+    },
+  },
+  "ko-KR": {
+    home: {
+      createdBy: "만든 사람",
+      allAuthors: "모든 작성자",
+      me: "나",
+    },
+  },
+  "pt-BR": {
+    home: {
+      createdBy: "Criado por",
+      allAuthors: "Todos os autores",
+      me: "Eu",
+    },
+  },
+  "hi-IN": {
+    home: {
+      createdBy: "द्वारा बनाया गया",
+      allAuthors: "सभी लेखक",
+      me: "मैं",
+    },
+  },
+  "ar-SA": {
+    home: {
+      createdBy: "أنشأه",
+      allAuthors: "جميع المؤلفين",
+      me: "أنا",
+    },
+  },
+} satisfies Record<Exclude<LocaleCode, "en-US" | "zh-TW">, PartialMessages>;
+
 export const messagesByLocale = {
   "en-US": enUS,
   "zh-TW": mergeLocalizedMessages(
@@ -15429,6 +15498,7 @@ export const messagesByLocale = {
       designRuntimeIdentityAndBridgeOverrides["zh-CN"],
       designComponentInstanceOverrides["zh-CN"],
       designComponentSourceOverrides["zh-CN"],
+      designAuthorFilterOverrides["zh-CN"],
       {
         root: {
           commandActions: "操作",
@@ -15508,6 +15578,7 @@ export const messagesByLocale = {
       designRuntimeIdentityAndBridgeOverrides["es-ES"],
       designComponentInstanceOverrides["es-ES"],
       designComponentSourceOverrides["es-ES"],
+      designAuthorFilterOverrides["es-ES"],
       {
         root: {
           commandActions: "Acciones",
@@ -15589,6 +15660,7 @@ export const messagesByLocale = {
       designRuntimeIdentityAndBridgeOverrides["fr-FR"],
       designComponentInstanceOverrides["fr-FR"],
       designComponentSourceOverrides["fr-FR"],
+      designAuthorFilterOverrides["fr-FR"],
       {
         root: {
           commandActions: "Actions",
@@ -15670,6 +15742,7 @@ export const messagesByLocale = {
       designRuntimeIdentityAndBridgeOverrides["de-DE"],
       designComponentInstanceOverrides["de-DE"],
       designComponentSourceOverrides["de-DE"],
+      designAuthorFilterOverrides["de-DE"],
       {
         root: {
           commandActions: "Aktionen",
@@ -15751,6 +15824,7 @@ export const messagesByLocale = {
       designRuntimeIdentityAndBridgeOverrides["ja-JP"],
       designComponentInstanceOverrides["ja-JP"],
       designComponentSourceOverrides["ja-JP"],
+      designAuthorFilterOverrides["ja-JP"],
       {
         root: {
           commandActions: "操作",
@@ -15833,6 +15907,7 @@ export const messagesByLocale = {
       designRuntimeIdentityAndBridgeOverrides["ko-KR"],
       designComponentInstanceOverrides["ko-KR"],
       designComponentSourceOverrides["ko-KR"],
+      designAuthorFilterOverrides["ko-KR"],
       {
         root: {
           commandActions: "작업",
@@ -15913,6 +15988,7 @@ export const messagesByLocale = {
       designRuntimeIdentityAndBridgeOverrides["pt-BR"],
       designComponentInstanceOverrides["pt-BR"],
       designComponentSourceOverrides["pt-BR"],
+      designAuthorFilterOverrides["pt-BR"],
       {
         root: {
           commandActions: "Ações",
@@ -15994,6 +16070,7 @@ export const messagesByLocale = {
       designRuntimeIdentityAndBridgeOverrides["hi-IN"],
       designComponentInstanceOverrides["hi-IN"],
       designComponentSourceOverrides["hi-IN"],
+      designAuthorFilterOverrides["hi-IN"],
       {
         root: {
           commandActions: "क्रियाएं",
@@ -16075,6 +16152,7 @@ export const messagesByLocale = {
       designRuntimeIdentityAndBridgeOverrides["ar-SA"],
       designComponentInstanceOverrides["ar-SA"],
       designComponentSourceOverrides["ar-SA"],
+      designAuthorFilterOverrides["ar-SA"],
       {
         root: {
           commandActions: "الإجراءات",

package/corpus/templates/design/app/lib/design-authors.ts

@@ -0,0 +1,64 @@
+import { emailToName } from "@agent-native/core/client/collab";
+
+/** Author-filter values that cannot collide with a real owner email. */
+export const ALL_AUTHORS = "all";
+export const MY_DESIGNS = "me";
+
+export interface AuthoredDesign {
+  ownerEmail?: string | null;
+}
+
+export function normalizeAuthorEmail(
+  email: string | null | undefined,
+): string | null {
+  const trimmed = email?.trim();
+  return trimmed ? trimmed.toLowerCase() : null;
+}
+
+/** Distinct owner emails across the whole library, ordered by display name. */
+export function collectAuthorEmails(designs: AuthoredDesign[]): string[] {
+  const byNormalized = new Map<string, string>();
+  for (const design of designs) {
+    const email = design.ownerEmail?.trim();
+    if (!email) continue;
+    const normalized = email.toLowerCase();
+    if (!byNormalized.has(normalized)) byNormalized.set(normalized, email);
+  }
+  return Array.from(byNormalized.values()).sort((a, b) =>
+    emailToName(a).localeCompare(emailToName(b)),
+  );
+}
+
+/**
+ * Whether author bylines are worth showing on cards. A solo workspace would
+ * only ever repeat the viewer's own name, so bylines stay hidden until a
+ * second person is involved — either as an org member or as the owner of a
+ * design the viewer can see.
+ */
+export function shouldShowAuthors(input: {
+  orgMemberCount: number | undefined;
+  authorEmails: string[];
+}): boolean {
+  return (input.orgMemberCount ?? 0) > 1 || input.authorEmails.length > 1;
+}
+
+export function filterDesignsByAuthor<T extends AuthoredDesign>(
+  designs: T[],
+  author: string,
+  viewerEmail: string | null | undefined,
+): T[] {
+  if (author === ALL_AUTHORS) return designs;
+  const normalizedViewer = normalizeAuthorEmail(viewerEmail);
+  // An unknown viewer cannot own anything, so "mine" is empty rather than
+  // silently falling back to every design.
+  if (author === MY_DESIGNS) {
+    if (!normalizedViewer) return [];
+    return designs.filter(
+      (design) => normalizeAuthorEmail(design.ownerEmail) === normalizedViewer,
+    );
+  }
+  const normalizedAuthor = normalizeAuthorEmail(author);
+  return designs.filter(
+    (design) => normalizeAuthorEmail(design.ownerEmail) === normalizedAuthor,
+  );
+}

package/corpus/templates/design/app/pages/Index.tsx

@@ -1,14 +1,18 @@
+import { emailToColor, emailToName } from "@agent-native/core/client/collab";
 import { type PromptComposerSubmitOptions } from "@agent-native/core/client/composer";
 import { useFeatureFlag } from "@agent-native/core/client/feature-flags";
 import {
   useActionQuery,
   useActionMutation,
+  useAvatarUrl,
+  useSession,
 } from "@agent-native/core/client/hooks";
 import {
   injectSessionReplayIframeBootstrap,
   SESSION_REPLAY_IFRAME_ATTRIBUTE,
 } from "@agent-native/core/client/host";
 import { useT } from "@agent-native/core/client/i18n";
+import { useOrgMembers } from "@agent-native/core/client/org";
 import { CreativeContextShareSheet } from "@agent-native/creative-context/client";
 import {
   useSetHeaderActions,
@@ -49,6 +53,7 @@ import {
   AlertDialogHeader,
   AlertDialogTitle,
 } from "@/components/ui/alert-dialog";
+import { Avatar, AvatarFallback, AvatarImage } from "@/components/ui/avatar";
 import { Button } from "@/components/ui/button";
 import { Checkbox } from "@/components/ui/checkbox";
 import {
@@ -58,6 +63,13 @@ import {
   DropdownMenuTrigger,
 } from "@/components/ui/dropdown-menu";
 import { Input } from "@/components/ui/input";
+import {
+  Select,
+  SelectContent,
+  SelectItem,
+  SelectTrigger,
+  SelectValue,
+} from "@/components/ui/select";
 import { Spinner } from "@/components/ui/spinner";
 import {
   Tooltip,
@@ -66,6 +78,14 @@ import {
 } from "@/components/ui/tooltip";
 import { useDesignSystems } from "@/hooks/use-design-systems";
 import { sendToDesignAgentChat } from "@/lib/agent-chat";
+import {
+  ALL_AUTHORS,
+  collectAuthorEmails,
+  filterDesignsByAuthor,
+  MY_DESIGNS,
+  normalizeAuthorEmail,
+  shouldShowAuthors,
+} from "@/lib/design-authors";
 import {
   clearPendingGeneration,
   writePendingGeneration,
@@ -80,6 +100,7 @@ interface Design {
   description?: string;
   projectType: ProjectType;
   designSystemId?: string | null;
+  ownerEmail?: string | null;
   createdAt?: string;
   updatedAt?: string;
   /** Preview HTML for the thumbnail. Only present when the list query asks
@@ -93,6 +114,7 @@ export default function Index() {
   const [searchParams, setSearchParams] = useSearchParams();
   const queryClient = useQueryClient();
   const [search, setSearch] = useState("");
+  const [author, setAuthor] = useState<string>(ALL_AUTHORS);
   const [deleteId, setDeleteId] = useState<string | null>(null);
   const [bulkDeleteOpen, setBulkDeleteOpen] = useState(false);
   const [selectedDesignIds, setSelectedDesignIds] = useState<Set<string>>(
@@ -134,6 +156,8 @@ export default function Index() {
     "list-design-templates",
     { includePreview: "true" },
   );
+  const { session } = useSession();
+  const { data: orgMembersPage } = useOrgMembers();
 
   const createMutation = useActionMutation("create-design");
   const createFromTemplateMutation = useActionMutation(
@@ -174,11 +198,27 @@ export default function Index() {
   const selectedTemplate =
     templateOptions.find((template) => template.id === newTemplateId) ?? null;
 
+  const viewerEmail = session?.email ?? null;
+  const authorEmails = useMemo(() => collectAuthorEmails(designs), [designs]);
+  const showAuthors = shouldShowAuthors({
+    orgMemberCount: orgMembersPage?.totalCount,
+    authorEmails,
+  });
+  const normalizedViewerEmail = normalizeAuthorEmail(viewerEmail);
+  const viewerHasDesigns = authorEmails.some(
+    (email) => normalizeAuthorEmail(email) === normalizedViewerEmail,
+  );
+  // One condition for both the control and the filtering it drives — a hidden
+  // control with a live filter leaves an empty grid the user cannot reset.
+  const canFilterByAuthor = authorEmails.length > 1;
+  const byAuthor = canFilterByAuthor
+    ? filterDesignsByAuthor(designs, author, viewerEmail)
+    : designs;
   const filtered = search
-    ? designs.filter((d) =>
+    ? byAuthor.filter((d) =>
         d.title.toLowerCase().includes(search.toLowerCase()),
       )
-    : designs;
+    : byAuthor;
   const selectedDesignCount = selectedDesignIds.size;
   const isSelectingDesigns = selectedDesignCount > 0;
   const allVisibleSelected =
@@ -313,6 +353,15 @@ export default function Index() {
     );
   }, []);
 
+  // Bulk actions operate on the visible set, so narrowing the visible set has
+  // to drop selections the user can no longer see.
+  const handleAuthorChange = useCallback((next: string) => {
+    setAuthor(next);
+    setSelectedDesignIds((current) =>
+      current.size === 0 ? current : new Set(),
+    );
+  }, []);
+
   const clearSelection = useCallback(() => {
     setSelectedDesignIds(new Set());
   }, []);
@@ -723,6 +772,37 @@ export default function Index() {
   useSetHeaderActions(
     designs.length > 0 ? (
       <div className="flex items-center gap-3">
+        {canFilterByAuthor ? (
+          <Select value={author} onValueChange={handleAuthorChange}>
+            <SelectTrigger
+              aria-label={t("home.createdBy")}
+              className="h-8 w-40 bg-accent/50 border-border text-sm text-foreground/90"
+            >
+              <SelectValue placeholder={t("home.createdBy")} />
+            </SelectTrigger>
+            <SelectContent>
+              <SelectItem value={ALL_AUTHORS}>
+                {t("home.allAuthors")}
+              </SelectItem>
+              {viewerHasDesigns ? (
+                <SelectItem value={MY_DESIGNS}>{t("home.me")}</SelectItem>
+              ) : null}
+              {authorEmails
+                .filter(
+                  (email) =>
+                    !(
+                      viewerHasDesigns &&
+                      normalizeAuthorEmail(email) === normalizedViewerEmail
+                    ),
+                )
+                .map((email) => (
+                  <SelectItem key={email} value={email}>
+                    {emailToName(email)}
+                  </SelectItem>
+                ))}
+            </SelectContent>
+          </Select>
+        ) : null}
         <div className="relative">
           <IconSearch className="absolute start-2.5 top-1/2 -translate-y-1/2 w-3.5 h-3.5 text-muted-foreground/70" />
           <Input
@@ -881,8 +961,16 @@ export default function Index() {
                           {design.title}
                         </h3>
                       </div>
-                      <div className="text-xs text-muted-foreground/70">
-                        {formatDate(design.updatedAt || design.createdAt)}
+                      <div className="flex items-center gap-1.5 text-xs text-muted-foreground/70">
+                        <span className="shrink-0">
+                          {formatDate(design.updatedAt || design.createdAt)}
+                        </span>
+                        {showAuthors && design.ownerEmail ? (
+                          <>
+                            <span aria-hidden>·</span>
+                            <DesignAuthorByline email={design.ownerEmail} />
+                          </>
+                        ) : null}
                       </div>
                     </div>
                   </>
@@ -1133,6 +1221,28 @@ export default function Index() {
   );
 }
 
+/** Who created a design, shown on its library card in shared workspaces. */
+function DesignAuthorByline({ email }: { email: string }) {
+  const name = emailToName(email);
+  const avatarUrl = useAvatarUrl(email);
+
+  return (
+    <span className="flex min-w-0 items-center gap-1.5" title={email}>
+      <Avatar className="size-4 shrink-0">
+        {avatarUrl ? <AvatarImage src={avatarUrl} alt="" /> : null}
+        <AvatarFallback
+          /* guard:allow-raw-color — emailToColor ignores the theme, so the initial stays white in both. */
+          className="text-[8px] font-semibold text-white"
+          style={{ backgroundColor: emailToColor(email) }}
+        >
+          {name.trim().charAt(0).toUpperCase() || "?"}
+        </AvatarFallback>
+      </Avatar>
+      <span className="truncate">{name}</span>
+    </span>
+  );
+}
+
 /**
  * Render the design's index.html as a non-interactive thumbnail. The iframe
  * renders at a fixed natural size (so designs that assume a desktop viewport

package/corpus/templates/design/app/pages/design-editor/generation-prompt-directives.ts

@@ -182,6 +182,7 @@ export function designTemplateRefinementDirectives(
     `This design was copied from template "${templateId}". Its files, canvas dimensions, defaults, and locked layers already exist.`,
     ...designSystemTemplateEditDirectives(designSystemId),
     `Call \`get-design-snapshot --designId="${designId}"\` exactly once before editing.`,
+    `The copied screens are edited in place, so they stop showing the template once this run saves. \`view-screen\` reports the template's authoritative dimensions and fonts as \`design.createdFromTemplate\` on every turn — keep them unchanged. Call \`get-design-template --designId="${designId}"\` when you need the template's original markup or locked layers.`,
     "Refine the existing template with `edit-design`; do not call `generate-design`, `delete-file`, or create a replacement screen.",
     'Layers marked `data-agent-native-locked="true"` and everything inside them must remain byte-for-byte unchanged. The server rejects changes to locked backgrounds, logos, and other fixed template layers.',
     "Preserve canvasFrames and the template's width and height. Change only the unlocked content needed for the user's request.",

package/corpus/templates/design/changelog/2026-08-07-alt-dragging-an-element-to-copy-it-now-keeps-the-copy-visibl.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-08-07
+---
+
+Alt-dragging an element to copy it now keeps the copy visible on the canvas instead of only adding it to the layer list.

package/corpus/templates/design/changelog/2026-08-07-design-cards-now-show-who-created-each-design-with-a-filter-.md

@@ -0,0 +1,6 @@
+---
+type: improved
+date: 2026-08-07
+---
+
+Design cards now show who created each design, with a filter by creator when your workspace has more than one person.

package/corpus/templates/design/changelog/2026-08-07-drawing-a-shape-on-the-overview-canvas-now-keeps-the-shape-s.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-08-07
+---
+
+Drawing a shape on the overview canvas now keeps the shape selected instead of its screen, so duplicating copies the shape rather than the whole screen.

package/corpus/templates/design/changelog/2026-08-07-hold-option-alt-while-dragging-a-frame-on-the-overview-canva.md

@@ -0,0 +1,6 @@
+---
+type: improved
+date: 2026-08-07
+---
+
+Hold Option/Alt while dragging a frame on the overview canvas to drop a copy of it, including a whole multi-frame selection.

package/corpus/templates/design/server/lib/design-template-data.ts

@@ -23,6 +23,128 @@ export function parseDesignTemplateData(
   }
 }
 
+export interface DesignTemplateSourceFile {
+  designFileId: string;
+  templateFileId: string;
+  filename: string | null;
+  width: number | null;
+  height: number | null;
+}
+
+export interface DesignTemplateSource {
+  templateId: string;
+  title: string | null;
+  category: string | null;
+  instantiatedAt: string | null;
+  appliedDesignSystemId: string | null;
+  /**
+   * Captured at copy time, not re-read from the template. Dimensions and fonts
+   * are small enough to restate on every turn, which is what stops a follow-up
+   * request from resizing the artboard or swapping the typeface. The full
+   * template markup stays behind `get-design-template`.
+   */
+  files: DesignTemplateSourceFile[];
+  fonts: string[];
+}
+
+const MAX_TRACKED_FONTS = 12;
+
+/**
+ * Font drift is invisible in a layout diff and is the most common way a
+ * refined template stops looking like its template. Capture the declared
+ * families once so later turns can restate them without re-parsing markup.
+ */
+export function extractTemplateFonts(html: string): string[] {
+  const fonts = new Set<string>();
+
+  for (const match of html.matchAll(/font-family\s*:\s*([^;}]+)/gi)) {
+    const family = match[1]
+      ?.split(",")[0]
+      ?.trim()
+      .replace(/^["']|["']$/g, "");
+    if (family && !/^(inherit|initial|unset|var\()/i.test(family)) {
+      fonts.add(family);
+    }
+  }
+  for (const link of html.matchAll(/fonts\.googleapis\.com\/[^"'\s>]+/gi)) {
+    for (const family of link[0].matchAll(/family=([^&:"']+)/gi)) {
+      let name: string;
+      try {
+        name = decodeURIComponent(family[1]!).replace(/\+/g, " ").trim();
+      } catch {
+        continue;
+      }
+      if (name) fonts.add(name);
+    }
+  }
+
+  return [...fonts].slice(0, MAX_TRACKED_FONTS);
+}
+
+function finiteNumber(value: unknown): number | null {
+  return typeof value === "number" && Number.isFinite(value)
+    ? Math.round(value)
+    : null;
+}
+
+/**
+ * Reads the template a design was created from. Returns null when the design
+ * was not created from a template; throws when the design claims a template
+ * but the record cannot be read, because silently treating that as "no
+ * template" would drop the template constraints the design is bound to.
+ */
+export function readDesignTemplateSource(
+  data: Record<string, unknown>,
+): DesignTemplateSource | null {
+  const raw = data.templateSource;
+  if (raw === undefined || raw === null) return null;
+
+  const source = record(raw);
+  const templateId = source.templateId;
+  if (typeof templateId !== "string" || !templateId.trim()) {
+    throw new Error(
+      "Design records a templateSource without a readable templateId",
+    );
+  }
+
+  return {
+    templateId,
+    title: typeof source.title === "string" ? source.title : null,
+    category: typeof source.category === "string" ? source.category : null,
+    instantiatedAt:
+      typeof source.instantiatedAt === "string" ? source.instantiatedAt : null,
+    appliedDesignSystemId:
+      typeof source.appliedDesignSystemId === "string"
+        ? source.appliedDesignSystemId
+        : null,
+    files: (Array.isArray(source.files) ? source.files : []).flatMap(
+      (entry) => {
+        const file = record(entry);
+        const designFileId = file.designFileId;
+        const templateFileId = file.templateFileId;
+        if (
+          typeof designFileId !== "string" ||
+          typeof templateFileId !== "string"
+        ) {
+          return [];
+        }
+        return [
+          {
+            designFileId,
+            templateFileId,
+            filename: typeof file.filename === "string" ? file.filename : null,
+            width: finiteNumber(file.width),
+            height: finiteNumber(file.height),
+          },
+        ];
+      },
+    ),
+    fonts: (Array.isArray(source.fonts) ? source.fonts : []).filter(
+      (font): font is string => typeof font === "string",
+    ),
+  };
+}
+
 /**
  * Templates are portable/shareable snapshots, so they must never retain
  * localhost bridge credentials. Reuse the same viewer-safe redaction applied
@@ -68,6 +190,27 @@ export function remapTemplateFileIds(
   return next;
 }
 
+/**
+ * Exact frame lookup for one file. Unlike `firstTemplateDimensions` this never
+ * falls back to another screen's frame: a screen with no recorded frame must
+ * report "unknown", not a neighbour's dimensions.
+ */
+export function templateFileDimensions(
+  data: Record<string, unknown>,
+  fileId: string,
+): { width: number | null; height: number | null } {
+  const frame = record(record(data.canvasFrames)[fileId]) as CanvasFrame;
+  const width =
+    typeof frame.width === "number" && Number.isFinite(frame.width)
+      ? Math.round(frame.width)
+      : null;
+  const height =
+    typeof frame.height === "number" && Number.isFinite(frame.height)
+      ? Math.round(frame.height)
+      : null;
+  return { width, height };
+}
+
 export function firstTemplateDimensions(
   data: Record<string, unknown>,
   preferredFileId?: string,

package/corpus/templates/design/server/plugins/agent-chat.ts

@@ -27,6 +27,7 @@ const INITIAL_TOOL_NAMES = [
   "get-design-snapshot",
   "create-design",
   "create-design-from-template",
+  "get-design-template",
   "save-design-as-template",
   "open-visual-edit",
   "add-localhost-screens",

package/corpus/templates/forms/AGENTS.md

@@ -35,8 +35,8 @@ ladder.
   native inline summary/table and an "Open editor" expansion path.
 - For an anonymous feedback form or survey, create all fields in one
   `create-form` call with `status: "published"`, verify the persisted form, and
-  return the action's exact public `/f/<slug>` response URL rather than only
-  the private editor link.
+  copy the returned `publicUrl` verbatim. Never derive the link from `slug` or
+  omit the public `/f/<slug>` route segment.
 - 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

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

@@ -39,7 +39,7 @@ function formDeepLink(formId: string): string {
 
 export default defineAction({
   description:
-    "Create a draft or published form. Set settings.anonymous=true to suppress submitter IP, identity, and source metadata, or settings.emailOnNewResponses=true to email the form owner when responses arrive. Published forms return a direct public response URL; drafts return an editor URL.",
+    "Create a draft or published form. Set settings.anonymous=true to suppress submitter IP, identity, and source metadata, or settings.emailOnNewResponses=true to email the form owner when responses arrive. Published results include a canonical publicUrl; copy it verbatim (it includes /f/<slug>) instead of deriving a URL from slug. Drafts return an editor URL.",
   schema: z.object({
     title: z.string().optional().describe("Form title"),
     description: z.string().optional().describe("Form description"),

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

@@ -142,11 +142,11 @@ export default defineAction({
       .set(updates)
       .where(eq(schema.forms.id, args.id));
 
-    const [row] = await db
-      .select()
-      .from(schema.forms)
-      .where(eq(schema.forms.id, args.id))
-      .limit(1);
+    // Do not re-read after the write. On pooled Postgres a follow-up SELECT
+    // can land on a lagging replica and return the pre-update field array,
+    // which makes the agent report stale state and can overwrite a later edit
+    // with that stale snapshot. The values written above are already validated.
+    const row = { ...existing, ...updates } as typeof existing;
 
     invalidatePublicFormCache(existing, row);
 

package/corpus/templates/forms/changelog/2026-08-10-forms-now-keep-agent-applied-field-changes-visible-after-an-.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-08-10
+---
+
+Forms now keep agent-applied field changes visible after an edit