@agent-native/core 0.197.0-nightly-20260929180759 → 0.197.0

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

@@ -4152,7 +4152,10 @@ export function databaseSelectionCapabilities(args: {
 export function databaseBulkEditableProperties(properties: DocumentProperty[]) {
   return properties.filter(
     (property) =>
-      property.editable && !isComputedPropertyType(property.definition.type),
+      property.editable &&
+      !isComputedPropertyType(property.definition.type) &&
+      // Row mutations do not accept relation values yet.
+      property.definition.type !== "relation",
   );
 }
 
@@ -14190,7 +14193,9 @@ function databaseTableCellDisplayValue(
     );
   }
 
-  return displayValue(property, undefined, wrapCells ? "wrapped" : "compact");
+  return displayValue(property, undefined, wrapCells ? "wrapped" : "compact", {
+    interactiveRelations: true,
+  });
 }
 
 export function isDatabasePropertyVisibleInView(

package/corpus/templates/content/app/components/editor/database/navigation-state.ts

@@ -263,7 +263,10 @@ export function databaseSelectedItems(
 export function databaseBulkEditableProperties(properties: DocumentProperty[]) {
   return properties.filter(
     (property) =>
-      property.editable && !isComputedPropertyType(property.definition.type),
+      property.editable &&
+      !isComputedPropertyType(property.definition.type) &&
+      // Row mutations do not accept relation values yet.
+      property.definition.type !== "relation",
   );
 }
 

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

@@ -55,6 +55,7 @@ import type {
   SuggestSourceJoinKeyResponse,
   UpdateContentDatabasePersonalViewRequest,
   ValidateBuilderSourceExecutionRequest,
+  DocumentPropertyRelationTarget,
 } from "@shared/api";
 import type { Query, QueryClient } from "@tanstack/react-query";
 import { useQuery, useQueryClient } from "@tanstack/react-query";
@@ -384,6 +385,7 @@ export function applyDocumentPropertyValueToDatabaseResponse<
     documentId: string;
     propertyId: string;
     value: ContentDatabaseResponse["properties"][number]["value"];
+    relationTargets?: DocumentPropertyRelationTarget[];
   },
 ): T | undefined {
   if (!current) return current;
@@ -404,7 +406,13 @@ export function applyDocumentPropertyValueToDatabaseResponse<
     if (existingIndex >= 0) {
       const properties = item.properties.map((property, index) =>
         index === existingIndex
-          ? { ...property, value: patch.value }
+          ? {
+              ...property,
+              value: patch.value,
+              ...(patch.relationTargets
+                ? { relationTargets: patch.relationTargets }
+                : {}),
+            }
           : property,
       );
       changed = true;
@@ -418,7 +426,13 @@ export function applyDocumentPropertyValueToDatabaseResponse<
       ...item,
       properties: [
         ...item.properties,
-        { ...databaseProperty, value: patch.value },
+        {
+          ...databaseProperty,
+          value: patch.value,
+          ...(patch.relationTargets
+            ? { relationTargets: patch.relationTargets }
+            : {}),
+        },
       ]
         .slice()
         .sort((a, b) => a.definition.position - b.definition.position),

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

@@ -1,11 +1,14 @@
 import {
+  callActionWithRetry,
   useActionMutation,
   useActionQuery,
 } from "@agent-native/core/client/hooks";
 import type {
   ConfigureDocumentPropertyRequest,
+  ContentDatabaseMutationTarget,
   ContentDatabaseItemsPageResponse,
   ContentDatabaseResponse,
+  DocumentDiscoveryPagination,
   DeleteDocumentPropertyRequest,
   DocumentPropertyDefinition,
   DocumentPropertyOption,
@@ -17,7 +20,11 @@ import type {
   UpdateDatabaseItemsRequest,
   UpdateDatabaseItemsResponse,
 } from "@shared/api";
-import { useQueryClient, type UseMutationResult } from "@tanstack/react-query";
+import {
+  useInfiniteQuery,
+  useQueryClient,
+  type UseMutationResult,
+} from "@tanstack/react-query";
 import { toast } from "sonner";
 
 import { dbText } from "../components/editor/database/text";
@@ -285,6 +292,54 @@ function withDatabaseScope<
   } as UseMutationResult<TData, Error, ScopedVariables, TContext>;
 }
 
+export interface ContentDatabaseRowSearchResponse {
+  databaseId: string;
+  databaseDocumentId: string;
+  rows: Array<{ documentId: string; title: string; icon: string | null }>;
+  pagination: DocumentDiscoveryPagination;
+  /** Present when the viewer may add rows to the related database. */
+  rowCreation: {
+    target: ContentDatabaseMutationTarget;
+    schemaRevision: string;
+  } | null;
+}
+
+/** Search a collection's rows by title, for picking relation values. */
+export function useContentDatabaseRowSearch(
+  databaseId: string | null | undefined,
+  query: string,
+  enabled: boolean,
+) {
+  return useInfiniteQuery({
+    queryKey: [
+      "action",
+      "search-content-database-rows",
+      { databaseId, query: query.trim() ? query : undefined },
+    ],
+    initialPageParam: 0,
+    queryFn: ({ pageParam, signal }) => {
+      if (!databaseId) throw new Error("databaseId is required");
+      return callActionWithRetry<ContentDatabaseRowSearchResponse>(
+        "search-content-database-rows",
+        {
+          databaseId,
+          limit: 25,
+          offset: pageParam,
+          ...(query.trim() ? { query } : {}),
+        },
+        { signal },
+      );
+    },
+    getNextPageParam: (page) =>
+      page.pagination.hasMore
+        ? (page.pagination.nextOffset ?? undefined)
+        : undefined,
+    enabled: enabled && !!databaseId,
+    placeholderData: (prev) => prev,
+    staleTime: 10_000,
+  });
+}
+
 export function useDocumentProperties(
   documentId: string | null,
   databaseId: string | null,
@@ -450,6 +505,7 @@ export function useSetDocumentProperty(
             documentId: variables.documentId,
             propertyId: variables.propertyId,
             value: variables.value,
+            relationTargets: variables.relationTargets,
           }),
       );
       queryClient.setQueriesData<ContentDatabaseItemsPageResponse>(
@@ -459,6 +515,7 @@ export function useSetDocumentProperty(
             documentId: variables.documentId,
             propertyId: variables.propertyId,
             value: variables.value,
+            relationTargets: variables.relationTargets,
           }),
       );
       return { previous, ...sequence };
@@ -491,10 +548,11 @@ export function useSetDocumentProperty(
       if (!isLatestDocumentPropertyMutation(queryClient, mutationContext)) {
         return;
       }
-      const savedValue =
-        data.properties.find(
-          (property) => property.definition.id === variables.propertyId,
-        )?.value ?? variables.value;
+      const savedProperty = data.properties.find(
+        (property) => property.definition.id === variables.propertyId,
+      );
+      const savedValue = savedProperty?.value ?? variables.value;
+      const savedRelationTargets = savedProperty?.relationTargets;
       queryClient.setQueriesData<ContentDatabaseResponse>(
         contentDatabaseQueryFilter(databaseDocumentId),
         (current) =>
@@ -502,6 +560,7 @@ export function useSetDocumentProperty(
             documentId: variables.documentId,
             propertyId: variables.propertyId,
             value: savedValue as DocumentPropertyValue,
+            relationTargets: savedRelationTargets,
           }),
       );
       queryClient.setQueriesData<ContentDatabaseItemsPageResponse>(
@@ -511,6 +570,7 @@ export function useSetDocumentProperty(
             documentId: variables.documentId,
             propertyId: variables.propertyId,
             value: savedValue as DocumentPropertyValue,
+            relationTargets: savedRelationTargets,
           }),
       );
       void queryClient.invalidateQueries({

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

@@ -572,6 +572,34 @@ const editorPropertiesMessages = {
   pageCount_many: "{{count}} pages",
   pageCount_other: "{{count}} pages",
   pasteFileOrMediaLink: "Paste file or media link",
+  back: "Back",
+  relatedDatabase: "Related database",
+  searchDatabases: "Search databases",
+  thisDatabase: "This database",
+  noDatabases: "No databases found",
+  searchPages: "Search pages",
+  noMatchingPages: "No matching pages",
+  removeRelation: "Remove {{name}}",
+  openPage: "Open {{name}}",
+  unavailablePage: "Unavailable page",
+  unavailablePageCount_zero: "{{count}} unavailable",
+  unavailablePageCount_one: "{{count}} unavailable",
+  unavailablePageCount_two: "{{count}} unavailable",
+  unavailablePageCount_few: "{{count}} unavailable",
+  unavailablePageCount_many: "{{count}} unavailable",
+  unavailablePageCount_other: "{{count}} unavailable",
+  noRelatedDatabase: "No related database configured",
+  linkAPage: "Link or create a page…",
+  createPage: "Create “{{name}}”",
+  reorderRelation: "Reorder {{name}}",
+  selectMore: "Select more",
+  selectAPage: "Select a page",
+  selectedCount_zero: "{{count}} selected",
+  selectedCount_one: "{{count}} selected",
+  selectedCount_two: "{{count}} selected",
+  selectedCount_few: "{{count}} selected",
+  selectedCount_many: "{{count}} selected",
+  selectedCount_other: "{{count}} selected",
   personOrEmail: "Person or email",
   propertyMenuFor: "Property menu for {{name}}",
   description: "Description",

package/corpus/templates/content/changelog/2026-09-28-link-rows-across-collections-with-relation-properties.md

@@ -0,0 +1,6 @@
+---
+type: added
+date: 2026-09-28
+---
+
+Link rows across collections with relation properties

package/corpus/templates/content/changelog/2026-09-29-related-pages-can-be-loaded-past-the-first-25-results.md

@@ -0,0 +1,6 @@
+---
+type: improved
+date: 2026-09-29
+---
+
+Related pages can be loaded past the first 25 results

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

@@ -11,7 +11,7 @@ This generated matrix tracks whether high-value Content UI operations use the sa
 | database.form-submissions                          | database    | Submit public database forms as new rows                                                                                                   | action-backed         | `submit-content-database-form`                                                                                                                                                                                                                                                                                                                                                                              | `app/components/editor/database/FormView.tsx`                                                                                                                                                                                                                                      | A validated form submission atomically creates a database row document and its editable property values.                                                                                                                                                                                                                                                                   | -                                                                                                                                                                                                                                          | -                | P0             | covered       | `actions/submit-content-database-form.db.test.ts`                                                                                                                                                                                                                     | -                                | -                                  |
 | database.lifecycle-and-trash                       | database    | Create, soft-delete, restore, list, and inspect content databases                                                                          | action-backed         | `create-content-database`, `create-inline-content-database`, `delete-content-database`, `describe-content-database`, `get-content-database`, `list-content-databases`, `list-trashed-content-databases`, `restore-content-database`                                                                                                                                                                         | `app/components/editor/SlashCommandMenu.tsx`, `app/hooks/use-content-database.ts`, `app/hooks/use-documents.ts`                                                                                                                                                                    | Database pages and database records are created, read, soft-deleted, restored, and listed.                                                                                                                                                                                                                                                                                 | -                                                                                                                                                                                                                                          | -                | P0             | covered       | `actions/content-database-lifecycle.db.test.ts`, `actions/list-content-databases.db.test.ts`, `server/plugins/agent-chat.spec.ts`, `../../packages/core/src/server/agent-chat/content-a2a-capabilities.spec.ts`                                                       | `database-source-scope`          | -                                  |
 | database.private-preview-drafts                    | database    | Persist and reconcile a user's private database-page preview draft                                                                         | action-backed         | `get-preview-document-draft`, `resolve-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/database-setup-mcp.db.test.ts`, `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.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`, `search-content-database-rows`, `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/database-setup-mcp.db.test.ts`, `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, edit, and remove database rows                                                                                 | action-backed         | `add-database-item`, `update-database-item`, `upsert-database-item-by-key`, `list-content-database-blocks`, `mutate-content-database-block`, `remove-database-items`, `duplicate-database-items`, `duplicate-database-item`, `update-database-items`, `migrate-content-database-rows`, `manage-content-database-migration`, `move-database-item`, `set-document-property`                                   | `app/components/editor/DocumentDatabase.tsx`, `app/components/editor/database/DatabaseView.tsx`                                                                                                                                                                                    | Database row memberships and ordering are created, duplicated, moved, edited, and removed without deleting the backing page; bounded migrations atomically update row bodies and properties through the same canonical data model.                                                                                                                                         | -                                                                                                                                                                                                                                          | -                | P0             | covered       | `actions/database-row-batch-actions.db.test.ts`, `actions/upsert-database-item-by-key.db.test.ts`, `actions/migrate-content-database-rows.db.test.ts`, `actions/content-database-block-actions.db.test.ts`, `parity/__tests__/database-row-batch-reliability.test.ts` | `database-bulk-row-reliability`  | -                                  |
 | database.table-query-page                          | database    | Query one constrained table 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 database reads and list-documents, get-document, search-documents, and navigate for workspace navigation.               | -                | 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          | -                                                                                                                                                                                                                                                                     | -                                | -                                  |

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

@@ -610,6 +610,7 @@ export const parityMatrix: ParityRow[] = [
       "get-content-database-personal-view",
       "list-document-properties",
       "reorder-document-property",
+      "search-content-database-rows",
       "set-document-property",
       "update-content-database-personal-view",
       "update-content-database-view",

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

@@ -269,11 +269,27 @@ export type DocumentPropertySystemRole =
   | "files_parent"
   | "files_source";
 
+/** A linked row of a relation property, resolved for the current viewer. */
+export interface DocumentPropertyRelationTarget {
+  documentId: string;
+  title: string;
+  icon: string | null;
+  /** Set only when the viewer can read the target database. */
+  databaseId: string | null;
+  databaseDocumentId: string | null;
+}
+
 export interface DocumentProperty {
   definition: DocumentPropertyDefinition;
   value: DocumentPropertyValue;
   editable: boolean;
   blocksField?: BlocksFieldIdentity;
+  /**
+   * Relation properties only: the linked rows this viewer may see, in value
+   * order. IDs in `value` without a target here are unavailable (restricted or
+   * trashed — deliberately indistinguishable).
+   */
+  relationTargets?: DocumentPropertyRelationTarget[];
 }
 
 export interface DocumentPropertiesResponse {
@@ -303,6 +319,11 @@ export interface SetDocumentPropertyRequest {
   propertyId: string;
   value: DocumentPropertyValue;
   expectedBlocksFieldRevision?: number;
+  /**
+   * Client-only hint: titles for relation IDs, shown until the server's
+   * resolved targets arrive. The action ignores it.
+   */
+  relationTargets?: DocumentPropertyRelationTarget[];
 }
 
 export interface DuplicateDocumentPropertyRequest {

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

@@ -31,6 +31,24 @@ export const DOCUMENT_PROPERTY_TYPES = [
   ...COMPUTED_DOCUMENT_PROPERTY_TYPES,
 ] as const;
 
+/** Most rows one relation value may link to. */
+export const MAX_RELATION_TARGETS = 100;
+
+/** Trim, drop empties and non-strings, and dedupe relation IDs, keeping order. */
+export function normalizeRelationIds(value: unknown): string[] {
+  const items = Array.isArray(value) ? value : value == null ? [] : [value];
+  const seen = new Set<string>();
+  const ids: string[] = [];
+  for (const item of items) {
+    if (typeof item !== "string") continue;
+    const id = item.trim();
+    if (!id || seen.has(id)) continue;
+    seen.add(id);
+    ids.push(id);
+  }
+  return ids;
+}
+
 export const CREATABLE_DOCUMENT_PROPERTY_TYPES = [
   "text",
   "number",
@@ -45,6 +63,7 @@ export const CREATABLE_DOCUMENT_PROPERTY_TYPES = [
   "url",
   "email",
   "phone",
+  "relation",
   "blocks",
   "id",
   "created_time",

package/corpus/templates/crm/CHANGELOG.md

@@ -1,9 +1,17 @@
 # CRM changelog
 
+## 2026-09-29
+
+### Improved
+
+- Settings pages now share the account layout, with dated updates that load in batches.
+
 ## 2026-09-28
 
 ### Improved
 
+- The app canvas now meets the right chat sidebar without a dark seam or rounded corner.
+- Settings now opens in the new layout, with Account, Connections, Agent, Organization, and app sections.
 - Ask CRM now starts with a focused title.
 
 ## 2026-09-27

package/corpus/templates/design/CHANGELOG.md

@@ -3,15 +3,48 @@
 All notable user-facing changes to Design are documented here. Open it any time
 from the command menu (Cmd+K → "What's new") or from Settings.
 
+## 2026-09-29
+
+### Improved
+
+- The browser permission guide points to Allow and the Connection is secure step.
+- The Chrome fallback guide shows the Local network Allow option.
+
+### Fixed
+
+- Clearing a prompt removes its final character
+- Design tweak controls stay intact when an edit contains invalid definitions
+- Live previews no longer stay stuck when the running app reloads.
+- Live previews stay ready when a delayed connection check completes.
+- Local visual edits use the copy prompt handoff for signed-in editors too.
+- Duplicated screens keep the same spacing as other screens on the board.
+
 ## 2026-09-28
 
 ### Improved
 
+- The app canvas now meets the right chat sidebar without a dark seam or rounded corner.
+- Center the home search field and keep prompt submission responsive while AI readiness is checked.
+- Corner radius handles stay with the drag and appear only on supported shapes
+- Corner radius is now disabled for plain text layers, matching Figma, and stays available when text has a fill, border, shadow, or background blur
+- Layer rows select from anywhere, with consistent blue highlights and tighter nesting
+- Local screen setup is clearer, failed connections stop showing a loading state, and signed-out sharing stays compact.
+- Settings now opens in the new layout, with Account, Connections, Agent, Organization, and app sections.
+- Design settings pages now share a consistent width and layout, while What's new displays date-grouped updates in batches of ten.
+- The Appearance panel now shows a Blend mode row with the active mode and a remove button whenever a layer uses a blend mode
 - Starter prompts now sit below the chat composer
 - The design list search and import controls stay legible on narrow screens.
 
 ### Fixed
 
+- Corner-radius handles appear as soon as a shape is selected under the pointer.
+- Design editor prompts stay visible while the composer loads
+- Existing designs open to Recent, and the home prompt stays interactive while AI readiness is checked.
+- PNG, JPG, WebP, and PDF exports and the export preview now keep layers flipped or rotated with the scale, rotate, and translate properties
+- Selecting a layer now keeps its name visible in the Layers panel.
+- Shader previews now appear on the selected screen in Design overview
+- The home Figma import control no longer clips its label
+- The Layers panel has a cleaner divider, and responsive preview controls share one continuous toolbar border.
 - Canvas navigation and undo keep working when connected apps focus controls automatically
 - The model picker shows available models when AI is configured.
 - Template menus stay available when you hover over a card.

package/corpus/templates/design/actions/clone-creative-context-design-native.ts

@@ -10,6 +10,7 @@ import { z } from "zod";
 
 import { mutateDesignData } from "../server/lib/design-data-mutation.js";
 import { saveImportedDesignFiles } from "../server/lib/import-design-files.js";
+import { tweakDefinitionsSchema } from "../shared/tweak-definition-schema.js";
 import createDesign from "./create-design.js";
 
 const payloadSchema = z.object({
@@ -62,6 +63,17 @@ export default defineAction({
         "Governed design clone payload failed integrity verification.",
       );
     const payload = payloadSchema.parse(JSON.parse(body));
+    const capturedData = z
+      .record(z.string(), z.unknown())
+      .parse(JSON.parse(payload.designData));
+    if (
+      capturedData.tweaks !== undefined &&
+      !tweakDefinitionsSchema.safeParse(capturedData.tweaks).success
+    ) {
+      throw new Error(
+        "Governed design clone payload has invalid tweak definitions.",
+      );
+    }
     const created = await createDesign.run({
       title: args.title?.trim() || "Context design",
       projectType: "prototype",
@@ -79,9 +91,6 @@ export default defineAction({
     });
     if (saved.files.length !== payload.files.length)
       throw new Error("Design clone did not persist every saved file.");
-    const capturedData = z
-      .record(z.string(), z.unknown())
-      .parse(JSON.parse(payload.designData));
     const {
       canvasFrames: _capturedFrames,
       screenMetadata: _capturedMetadata,

package/corpus/templates/design/actions/generate-design.ts

@@ -68,6 +68,7 @@ import {
   visibleBreakpointWidths,
 } from "../shared/responsive-frame-layout.js";
 import { annotateScreenHtmlForPersist } from "../shared/screen-annotation.js";
+import { tweakDefinitionsSchema } from "../shared/tweak-definition-schema.js";
 
 function designDeepLink(designId: string, screenId?: string): string {
   return buildDeepLink({
@@ -536,35 +537,7 @@ const generateDesignAction = defineAction({
     tweaks: z
       .preprocess(
         (v) => (typeof v === "string" ? JSON.parse(v) : v),
-        z
-          .array(
-            z.object({
-              id: z.string(),
-              label: z.string(),
-              type: z.enum([
-                "color-swatch",
-                "color-swatches",
-                "segment",
-                "slider",
-                "toggle",
-              ]),
-              options: z
-                .array(
-                  z.object({
-                    label: z.string(),
-                    value: z.string(),
-                    color: z.string().optional(),
-                  }),
-                )
-                .optional(),
-              min: z.number().optional(),
-              max: z.number().optional(),
-              step: z.number().optional(),
-              defaultValue: z.union([z.string(), z.number(), z.boolean()]),
-              cssVar: z.string().optional(),
-            }),
-          )
-          .optional(),
+        tweakDefinitionsSchema.optional(),
       )
       .optional()
       .describe(

package/corpus/templates/design/actions/update-design.ts

@@ -6,6 +6,7 @@ import { z } from "zod";
 import { getDb, schema } from "../server/db/index.js";
 import { snapshotDesignBeforeAgentEdit } from "../server/lib/design-versions.js";
 import { numericDesignDataWriteError } from "../shared/canvas-frames.js";
+import { tweakDefinitionsSchema } from "../shared/tweak-definition-schema.js";
 
 const MAX_DATA_CAS_ATTEMPTS = 5;
 const MAX_DATA_OPERATION_SOURCES = 128;
@@ -20,6 +21,21 @@ const FORBIDDEN_DATA_PATH_SEGMENTS = new Set([
   "prototype",
 ]);
 
+function tweakDefinitionsWriteError(value: unknown): string | null {
+  return tweakDefinitionsSchema.safeParse(value).success
+    ? null
+    : "tweaks must be an array of valid definitions";
+}
+
+function designDataWriteError(path: string[], value: unknown): string | null {
+  const geometryError = numericDesignDataWriteError(path, value);
+  if (geometryError) return geometryError;
+  if (path.length === 1 && path[0] === "tweaks") {
+    return tweakDefinitionsWriteError(value);
+  }
+  return null;
+}
+
 const dataPathSchema = z
   .array(
     z
@@ -47,10 +63,7 @@ const dataOperationSchema = z
   ])
   .superRefine((operation, context) => {
     if (operation.op !== "set") return;
-    const message = numericDesignDataWriteError(
-      operation.path,
-      operation.value,
-    );
+    const message = designDataWriteError(operation.path, operation.value);
     if (message) {
       context.addIssue({ code: "custom", path: ["value"], message });
     }
@@ -82,10 +95,7 @@ const agentDataOperationSchema = z
   ])
   .superRefine((operation, context) => {
     if (operation.op !== "set") return;
-    const message = numericDesignDataWriteError(
-      operation.path,
-      operation.value,
-    );
+    const message = designDataWriteError(operation.path, operation.value);
     if (message) {
       context.addIssue({ code: "custom", path: ["value"], message });
     }
@@ -228,12 +238,22 @@ function applyDataOperations(
 
 function validatePersistedDataSnapshot(
   raw: string,
+  designId: string,
   touchedMaps?: ReadonlySet<string>,
   touchedCanvasFrameIds?: ReadonlySet<string>,
 ): void {
   const parsed = JSON.parse(raw);
   if (!isRecord(parsed)) return;
   for (const [key, value] of Object.entries(parsed)) {
+    if (key === "tweaks") {
+      if (touchedMaps && !touchedMaps.has(key)) continue;
+      if (tweakDefinitionsWriteError(value)) {
+        throw new Error(
+          `Design ${designId} has invalid tweak definitions. Refusing to save them.`,
+        );
+      }
+      continue;
+    }
     if (
       touchedMaps &&
       NUMERIC_DESIGN_DATA_MAPS.has(key) &&
@@ -393,6 +413,10 @@ export default defineAction({
       }
       if (isRecord(parsedSnapshot)) {
         for (const [key, value] of Object.entries(parsedSnapshot)) {
+          if (key === "tweaks") {
+            const tweakError = tweakDefinitionsWriteError(value);
+            if (tweakError) throw new Error(tweakError);
+          }
           const message = numericDesignDataWriteError([key], value);
           if (message) throw new Error(message);
         }
@@ -500,6 +524,7 @@ export default defineAction({
         : undefined;
       validatePersistedDataSnapshot(
         nextData,
+        id,
         touchedMaps,
         touchedCanvasFrameIds,
       );

package/corpus/templates/design/app/components/design/design-canvas/LocalNetworkAccessPrompt.tsx

@@ -80,8 +80,8 @@ export function LocalNetworkAccessPrompt({
         src="/local-network-access-settings.png"
         alt={permissionSettingsInstructions}
         className="mt-3 block w-full rounded-md border border-border"
-        width={1686}
-        height={933}
+        width={1660}
+        height={948}
         loading="lazy"
       />
     </details>

package/corpus/templates/design/changelog/2026-09-29-design-tweak-controls-stay-intact-when-an-edit-contains-inva.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-09-29
+---
+
+Design tweak controls stay intact when an edit contains invalid definitions

package/corpus/templates/design/changelog/2026-09-29-the-chrome-fallback-guide-shows-the-local-network-allow-opti.md

@@ -0,0 +1,6 @@
+---
+type: improved
+date: 2026-09-29
+---
+
+The Chrome fallback guide shows the Local network Allow option.