@agent-native/core 0.90.11 → 0.91.1

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

@@ -1942,6 +1942,25 @@ function shouldPreselectDetailField(
   return DETAIL_FIELD_NAME_HINTS.some((hint) => key.includes(hint));
 }
 
+function sourceFieldIconType(
+  sourceFieldType: string,
+): DocumentPropertyType | "name" {
+  const normalized = sourceFieldType.trim().toLowerCase();
+  if (normalized === "number") return "number";
+  if (normalized === "datetime" || normalized === "date") return "date";
+  if (normalized === "url") return "url";
+  if (normalized === "boolean" || normalized === "checkbox") return "checkbox";
+  if (
+    normalized === "list" ||
+    normalized === "array" ||
+    normalized === "tags" ||
+    normalized === "multi_select"
+  ) {
+    return "multi_select";
+  }
+  return "text";
+}
+
 function SourceDetailsFieldPicker({
   documentId,
   source,
@@ -2039,31 +2058,37 @@ function SourceDetailsFieldPicker({
         </div>
       ) : (
         <div className="grid min-w-0 gap-1">
-          {fields.map((field) => (
-            <button
-              key={field.id}
-              type="button"
-              className="flex min-w-0 items-center gap-2 rounded-md px-2 py-1.5 text-left text-sm transition-colors hover:bg-muted focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring"
-              onClick={() => toggleField(field.id)}
-            >
-              <span
-                className={cn(
-                  "flex size-4 shrink-0 items-center justify-center rounded border",
-                  selected.has(field.id)
-                    ? "border-[#2383e2] bg-[#2383e2] text-white"
-                    : "border-muted-foreground/40 text-transparent",
-                )}
+          {fields.map((field) => {
+            const iconType = sourceFieldIconType(field.sourceFieldType);
+            const Icon =
+              iconType === "name" ? IconFileText : TYPE_ICONS[iconType];
+            return (
+              <button
+                key={field.id}
+                type="button"
+                className="flex min-w-0 items-center gap-2 rounded-md px-2 py-1.5 text-left text-sm transition-colors hover:bg-muted focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring"
+                onClick={() => toggleField(field.id)}
               >
-                <IconCheck className="size-3" />
-              </span>
-              <span className="min-w-0 flex-1 truncate">
-                {field.sourceFieldLabel}
-              </span>
-              <span className="shrink-0 text-[11px] text-muted-foreground">
-                {field.sourceFieldType}
-              </span>
-            </button>
-          ))}
+                <span
+                  className={cn(
+                    "flex size-4 shrink-0 items-center justify-center rounded border",
+                    selected.has(field.id)
+                      ? "border-[#2383e2] bg-[#2383e2] text-white"
+                      : "border-muted-foreground/40 text-transparent",
+                  )}
+                >
+                  <IconCheck className="size-3" />
+                </span>
+                <Icon className="size-3.5 shrink-0 text-muted-foreground" />
+                <span className="min-w-0 flex-1 truncate">
+                  {field.sourceFieldLabel}
+                </span>
+                <span className="shrink-0 text-[11px] text-muted-foreground">
+                  {field.sourceFieldType}
+                </span>
+              </button>
+            );
+          })}
         </div>
       )}
       <div className="flex justify-end gap-2">

package/corpus/templates/content/app/routes/_app.settings.tsx

@@ -4,9 +4,11 @@ import {
   SettingsTabsPage,
   useAgentSettingsTabs,
   useT,
+  type SettingsSearchEntry,
 } from "@agent-native/core/client";
 import { TeamPage } from "@agent-native/core/client/org";
 import { useSetPageTitle } from "@agent-native/toolkit/app-shell";
+import { useMemo } from "react";
 
 import { Label } from "@/components/ui/label";
 import { messagesByLocale } from "@/i18n-data";
@@ -22,18 +24,34 @@ export default function SettingsRoute() {
   const agentSettingsTabs = useAgentSettingsTabs();
   useSetPageTitle(t("settings.title"));
 
+  const generalSearchEntries = useMemo<SettingsSearchEntry[]>(
+    () => [
+      {
+        id: "content-language",
+        label: t("settings.languageTitle"),
+        keywords: "language locale translation i18n",
+        hash: "language",
+      },
+    ],
+    [t],
+  );
+
   return (
     <div className="flex-1 overflow-auto">
       <SettingsTabsPage
         teamLabel={t("team.pageTitle")}
         extraTabs={agentSettingsTabs}
+        generalSearchEntries={generalSearchEntries}
         general={
           <main className="mx-auto w-full max-w-3xl space-y-6">
             <p className="text-sm leading-6 text-muted-foreground">
               {t("settings.description")}
             </p>
 
-            <section className="rounded-lg border border-border bg-card p-5">
+            <section
+              id="language"
+              className="scroll-mt-16 rounded-lg border border-border bg-card p-5"
+            >
               <div className="space-y-1">
                 <h2 className="text-base font-semibold">
                   {t("settings.languageTitle")}

package/corpus/templates/content/changelog/2026-07-07-builder-source-tag-fields-now-import-as-multi-select.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-07-07
+---
+
+Builder source tag fields now import as multi-select properties with their available choices.

package/corpus/templates/content/changelog/2026-07-08-settings-are-cleaner-and-searchable.md

@@ -0,0 +1,5 @@
+---
+type: improved
+---
+
+Settings are cleaner and searchable, with a consistent navigation that jumps straight to any setting.

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

@@ -617,6 +617,9 @@ export interface BuilderCmsModelFieldSummary {
   name: string;
   label?: string;
   type: string;
+  inputType?: string;
+  enum?: string[];
+  options?: string[];
   required: boolean;
 }
 

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

@@ -551,6 +551,48 @@ export function normalizePropertyValue(
   }
 }
 
+function optionMatchKey(value: string) {
+  return value.trim().toLowerCase();
+}
+
+export function normalizePropertyValueWithOptions(
+  type: DocumentPropertyType,
+  value: unknown,
+  options?: DocumentPropertyOptions,
+): DocumentPropertyValue {
+  const normalized = normalizePropertyValue(type, value);
+  const optionList = options?.options ?? [];
+  if (
+    normalized === null ||
+    optionList.length === 0 ||
+    (type !== "select" && type !== "status" && type !== "multi_select")
+  ) {
+    return normalized;
+  }
+
+  const optionIdByName = new Map(
+    optionList.map((option) => [optionMatchKey(option.name), option.id]),
+  );
+  const optionIds = new Set(optionList.map((option) => option.id));
+  const resolveOptionId = (candidate: string) =>
+    optionIds.has(candidate)
+      ? candidate
+      : (optionIdByName.get(optionMatchKey(candidate)) ?? candidate);
+
+  if (type === "multi_select") {
+    const resolved = new Set<string>();
+    for (const item of Array.isArray(normalized) ? normalized : []) {
+      const optionId = resolveOptionId(item);
+      if (optionId.trim()) resolved.add(optionId);
+    }
+    return Array.from(resolved);
+  }
+
+  return typeof normalized === "string"
+    ? resolveOptionId(normalized)
+    : normalized;
+}
+
 export function formulaValueText(value: DocumentPropertyValue): string {
   if (value === null || value === undefined) return "";
   if (Array.isArray(value)) return value.join(", ");

package/corpus/templates/design/AGENTS.md

@@ -246,6 +246,15 @@ patterns live in `.agents/skills/`.
   the latest localhost connection or a specific `connectionId`. Pass `routes`
   with `path`/`url` when visualizing a flow; pass `paths` for a concise route
   list. Then call `navigate --view editor --designId <id> --editorView overview`.
+- `write-local-file`: writes/patches a local file through the bridge, but only
+  when a user-approved write-consent grant exists. Granting is human-only
+  (`grant-localhost-write-consent` is hidden from agents), so you cannot approve
+  it yourself.
+- `request-localhost-write-consent`: call this when `write-local-file` fails
+  with "no write-consent grant". It opens the write-consent dialog in the
+  editor (or reports `alreadyGranted`). Tell the user to click "Allow writes",
+  then retry `write-local-file`. Do not keep retrying blindly — the write stays
+  blocked until the user approves.
 
 ## Review, Breakpoints, Screen States & Components
 

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

@@ -125,6 +125,9 @@ const generateDesignAction = defineAction({
     "Do not use this action to replace a selected variant screen after a " +
     "variant pick; call `get-design-snapshot` for the selected `fileId` and " +
     "`edit-design` that same `fileId` instead. " +
+    "When `designSystemId` is provided, first use `get-design-system` and apply " +
+    "its `agentContext` tokens/docs before writing the file content; do not " +
+    "treat the id alone as enough design-system context. " +
     "Do not report a design as ready until this action succeeds. " +
     "When adding multiple screens or states, pass canvasFrames with filenames " +
     "and x/y/width/height so the new screens appear placed on the overview canvas.",

package/corpus/templates/design/actions/get-design-system.ts

@@ -8,9 +8,146 @@ import { z } from "zod";
 
 import "../server/db/index.js"; // ensure registerShareableResource runs
 
+const MAX_AGENT_CONTEXT_CHARS = 14_000;
+const MAX_JSON_CONTEXT_CHARS = 2_500;
+const MAX_BUILDER_DOCS = 8;
+const MAX_BUILDER_DOC_CHARS = 1_200;
+const MAX_TOKEN_VALUES = 48;
+
+interface BuilderGenerationContext {
+  builderDesignSystemId: string;
+  builderJobId: string;
+  builderProjectId?: string;
+  builderUrl?: string;
+  builderStatus?: string;
+  docs: Array<{
+    name?: string;
+    type?: string;
+    description?: string;
+    content?: string;
+    tokenValues?: Record<string, string>;
+  }>;
+  tokenValues: Record<string, string>;
+  docCount: number;
+  warning?: string;
+}
+
+function truncate(value: string, maxChars: number): string {
+  if (value.length <= maxChars) return value;
+  return `${value.slice(0, maxChars).trimEnd()}\n[truncated]`;
+}
+
+function parseJson(value: string | null | undefined): unknown {
+  if (!value) return null;
+  try {
+    return JSON.parse(value);
+  } catch {
+    return null;
+  }
+}
+
+function formatJson(value: unknown, maxChars = MAX_JSON_CONTEXT_CHARS): string {
+  return truncate(JSON.stringify(value, null, 2), maxChars);
+}
+
+function formatTokenValues(tokenValues: Record<string, string>): string[] {
+  const entries = Object.entries(tokenValues)
+    .filter(([, value]) => typeof value === "string" && value.trim())
+    .slice(0, MAX_TOKEN_VALUES);
+  if (entries.length === 0) return [];
+  return [
+    "Builder DSI token values to apply first:",
+    ...entries.map(([name, value]) => `- ${name}: ${value}`),
+  ];
+}
+
+function buildDesignSystemAgentContext({
+  id,
+  title,
+  description,
+  data,
+  assets,
+  customInstructions,
+  builder,
+}: {
+  id: string;
+  title: string;
+  description?: string | null;
+  data?: string | null;
+  assets?: string | null;
+  customInstructions?: string | null;
+  builder: BuilderGenerationContext | null;
+}): string {
+  const lines: string[] = [
+    "## Selected Design System Context",
+    `Use "${title}" (id: ${id}) as the visual source of truth for this generation.`,
+    "Apply these tokens, assets, and usage notes before choosing colors, type, spacing, radius, imagery, or component language.",
+  ];
+
+  if (description?.trim()) {
+    lines.push("", "Description:", description.trim());
+  }
+
+  if (customInstructions?.trim()) {
+    lines.push("", "Custom instructions:", customInstructions.trim());
+  }
+
+  const parsedAssets = parseJson(assets);
+  if (Array.isArray(parsedAssets) && parsedAssets.length > 0) {
+    lines.push("", "Design system assets:", formatJson(parsedAssets));
+  }
+
+  if (builder) {
+    lines.push(
+      "",
+      "Builder DSI:",
+      `- Design system id: ${builder.builderDesignSystemId}`,
+      `- Job id: ${builder.builderJobId}`,
+      builder.builderProjectId
+        ? `- Project id: ${builder.builderProjectId}`
+        : "",
+      builder.builderUrl ? `- URL: ${builder.builderUrl}` : "",
+      builder.builderStatus ? `- Status: ${builder.builderStatus}` : "",
+      "- Builder DSI docs and token values override local proxy placeholders.",
+      "- Do not substitute a generic style if DSI docs or tokens are unavailable; call get-design-system again or tell the user Builder indexing is not ready.",
+    );
+
+    if (builder.warning) {
+      lines.push(`- Warning: ${builder.warning}`);
+    }
+
+    lines.push("", ...formatTokenValues(builder.tokenValues));
+
+    const docs = builder.docs.slice(0, MAX_BUILDER_DOCS);
+    if (docs.length > 0) {
+      lines.push("", "Builder DSI docs to follow:");
+      for (const doc of docs) {
+        const label = [doc.name, doc.type ? `(${doc.type})` : ""]
+          .filter(Boolean)
+          .join(" ");
+        lines.push(
+          "",
+          `### ${label || "Design system doc"}`,
+          doc.description?.trim() ? doc.description.trim() : "",
+          doc.content?.trim()
+            ? truncate(doc.content.trim(), MAX_BUILDER_DOC_CHARS)
+            : "",
+        );
+      }
+    }
+  } else {
+    const parsedData = parseJson(data);
+    if (parsedData) {
+      lines.push("", "Local design-system tokens:", formatJson(parsedData));
+    }
+  }
+
+  return truncate(lines.filter(Boolean).join("\n"), MAX_AGENT_CONTEXT_CHARS);
+}
+
 export default defineAction({
   description:
-    "Get a design system by ID. Returns full design system data including colors, typography, spacing, and assets.",
+    "Get a design system by ID. Returns full design system data including colors, typography, spacing, assets, and a compact agentContext for generation.",
   schema: z.object({
     id: z.string().describe("Design system ID"),
   }),
@@ -51,6 +188,15 @@ export default defineAction({
       createdAt: row.createdAt,
       updatedAt: row.updatedAt,
       builder,
+      agentContext: buildDesignSystemAgentContext({
+        id: row.id,
+        title: row.title,
+        description: row.description,
+        data: row.data,
+        assets: row.assets,
+        customInstructions: row.customInstructions,
+        builder,
+      }),
     };
   },
 });

package/corpus/templates/design/actions/request-localhost-write-consent.ts

@@ -0,0 +1,141 @@
+import { defineAction } from "@agent-native/core";
+import {
+  readAppStateForCurrentTab,
+  writeAppState,
+} from "@agent-native/core/application-state";
+import { getRequestUserEmail } from "@agent-native/core/server/request-context";
+import { assertAccess } from "@agent-native/core/sharing";
+import { and, eq } from "drizzle-orm";
+import { z } from "zod";
+
+import { getDb, schema } from "../server/db/index.js";
+
+/**
+ * Surface the LocalhostWriteConsentDialog so the user can approve local file
+ * writes. Granting is human-only (`grant-localhost-write-consent` is
+ * `agentTool: false`), so an agent writing from chat can only *request* the
+ * prompt: this writes an app-state key the editor observes and opens the dialog.
+ * If a valid grant already exists it reports that instead of prompting again.
+ */
+export default defineAction({
+  description:
+    "Prompt the user to allow local file writes for a design's localhost " +
+    "connection by opening the write-consent dialog in the editor. Write " +
+    "consent itself is human-only and cannot be granted by the agent. Call " +
+    "this when write-local-file fails because no write-consent grant exists, " +
+    "then retry write-local-file after the user approves. Requires editor " +
+    "access on the design.",
+  schema: z.object({
+    designId: z.string().describe("Design ID."),
+    connectionId: z
+      .string()
+      .describe("Localhost connection ID (from list-localhost-connections)."),
+    files: z
+      .array(z.string())
+      .optional()
+      .describe("File paths about to be written, shown in the dialog."),
+  }),
+  run: async ({ designId, connectionId, files }) => {
+    await assertAccess("design", designId, "editor");
+
+    const ownerEmail = getRequestUserEmail();
+    if (!ownerEmail) throw new Error("no authenticated user");
+
+    const db = getDb();
+    const [connection] = await db
+      .select({
+        rootPath: schema.designLocalhostConnections.rootPath,
+        bridgeToken: schema.designLocalhostConnections.bridgeToken,
+      })
+      .from(schema.designLocalhostConnections)
+      .where(
+        and(
+          eq(schema.designLocalhostConnections.id, connectionId),
+          eq(schema.designLocalhostConnections.ownerEmail, ownerEmail),
+        ),
+      )
+      .limit(1);
+
+    if (!connection) {
+      throw new Error(
+        `Localhost connection "${connectionId}" not found for the current user.`,
+      );
+    }
+
+    // Fail fast on the same preconditions grant-localhost-write-consent
+    // enforces, so we never show a dialog that would hard-fail on approval —
+    // or one labeled with the connection id instead of a real folder.
+    if (!connection.rootPath || !connection.bridgeToken) {
+      throw new Error(
+        `Connection "${connectionId}" is not ready for writes (missing root ` +
+          "path or bridge token). Re-run `npx @agent-native/core@latest design " +
+          "connect` so the CLI records both, then retry.",
+      );
+    }
+
+    // Skip the prompt when a non-expired grant already covers this connection —
+    // the agent can just retry write-local-file.
+    const [grant] = await db
+      .select({
+        grantedUntil: schema.designLocalhostWriteGrants.grantedUntil,
+      })
+      .from(schema.designLocalhostWriteGrants)
+      .where(
+        and(
+          eq(schema.designLocalhostWriteGrants.designId, designId),
+          eq(schema.designLocalhostWriteGrants.connectionId, connectionId),
+          eq(schema.designLocalhostWriteGrants.ownerEmail, ownerEmail),
+        ),
+      )
+      .limit(1);
+    if (grant && grant.grantedUntil > new Date().toISOString()) {
+      return {
+        designId,
+        connectionId,
+        alreadyGranted: true,
+        message:
+          "A valid write-consent grant already exists. Retry write-local-file.",
+      };
+    }
+
+    await writeAppState(`design-localhost-write-consent-request:${designId}`, {
+      designId,
+      connectionId,
+      rootPath: connection.rootPath,
+      files: files ?? [],
+      requestedAt: new Date().toISOString(),
+    });
+
+    // The dialog only renders from this design's editor, so only claim it
+    // surfaced when the user is actually there. Otherwise the request stays
+    // queued and fires when they open the design — report that honestly instead
+    // of implying a dialog is on screen.
+    const navigation = await readAppStateForCurrentTab("navigation").catch(
+      () => null,
+    );
+    const onThisEditor =
+      navigation?.["view"] === "editor" &&
+      navigation?.["designId"] === designId;
+
+    if (onThisEditor) {
+      return {
+        designId,
+        connectionId,
+        surfaced: true,
+        message:
+          "Opened the write-consent dialog. Ask the user to click 'Allow " +
+          "writes', then retry write-local-file.",
+      };
+    }
+
+    return {
+      designId,
+      connectionId,
+      surfaced: false,
+      message:
+        "Queued a write-consent request, but the user is not on this design's " +
+        "editor so no dialog is showing yet. Ask them to open the design; the " +
+        "prompt appears then, and you can retry write-local-file after they approve.",
+    };
+  },
+});

package/corpus/templates/design/app/components/design/DesignCanvas.tsx

@@ -1315,25 +1315,21 @@ export function DesignCanvas({
     (fetchedExternalSnapshot?.url === rawExternalPreviewUrl
       ? fetchedExternalSnapshot.html
       : undefined);
+  // Bake a neutral scale of 1 here (not the zoom-folded scale): this script is
+  // registered with the localhost bridge via a large POST, so folding live zoom
+  // in would re-fire the registration effect on every zoom tick. Live scale is
+  // pushed separately over the `set-editor-chrome-scale` postMessage below.
   const editorChromeBridgeForCurrentState = useMemo(
     () =>
       buildEditorChromeBridgeScript({
         readOnly,
         editMode,
-        editorChromeScaleX: effectiveEditorChromeScaleX,
-        editorChromeScaleY: effectiveEditorChromeScaleY,
+        editorChromeScaleX: 1,
+        editorChromeScaleY: 1,
         screenId: screenId ?? contentKey ?? "",
         boardSurface,
       }),
-    [
-      boardSurface,
-      contentKey,
-      editMode,
-      effectiveEditorChromeScaleX,
-      effectiveEditorChromeScaleY,
-      readOnly,
-      screenId,
-    ],
+    [boardSurface, contentKey, editMode, readOnly, screenId],
   );
   const embeddedWheelBridgeForCurrentState = useMemo(
     () =>
@@ -1400,6 +1396,9 @@ export function DesignCanvas({
     onExternalContentSnapshotRef.current = onExternalContentSnapshot;
   }, [onExternalContentSnapshot]);
 
+  // Register the editor bridge script with the localhost live-edit bridge so
+  // it gets injected into the proxied preview. Re-runs only when the script
+  // content (liveEditBridgeKey) or the bridge target changes.
   useEffect(() => {
     if (!usesLiveEditEditorBridge || !bridgeUrl) {
       setRegisteredLiveEditBridgeKey(null);
@@ -1410,8 +1409,8 @@ export function DesignCanvas({
       current === liveEditBridgeKey ? current : null,
     );
     void (async () => {
+      const endpoint = new URL("/live-edit-bridge", bridgeUrl).toString();
       try {
-        const endpoint = new URL("/live-edit-bridge", bridgeUrl).toString();
         const response = await fetch(endpoint, {
           method: "POST",
           headers: {
@@ -1423,15 +1422,10 @@ export function DesignCanvas({
         if (!response.ok) {
           throw new Error(`Bridge registration failed (${response.status})`);
         }
-        if (!cancelled) {
-          setRegisteredLiveEditBridgeKey(liveEditBridgeKey);
-        }
+        if (!cancelled) setRegisteredLiveEditBridgeKey(liveEditBridgeKey);
       } catch (error) {
         if (!cancelled) {
-          console.warn(
-            "[DesignCanvas] live edit bridge registration failed",
-            error,
-          );
+          console.warn("live-edit bridge registration failed", error);
           setRegisteredLiveEditBridgeKey(null);
         }
       }

package/corpus/templates/design/app/routes/settings.tsx

@@ -4,8 +4,10 @@ import {
   LanguagePicker,
   useAgentSettingsTabs,
   useT,
+  type SettingsSearchEntry,
 } from "@agent-native/core/client";
 import { TeamPage } from "@agent-native/core/client/org";
+import { useMemo } from "react";
 
 import {
   Card,
@@ -27,13 +29,26 @@ export default function SettingsRoute() {
   const agentSettingsTabs = useAgentSettingsTabs();
   const t = useT();
 
+  const generalSearchEntries = useMemo<SettingsSearchEntry[]>(
+    () => [
+      {
+        id: "design-language",
+        label: t("settings.languageTitle"),
+        keywords: "language locale translation i18n",
+        hash: "language",
+      },
+    ],
+    [t],
+  );
+
   return (
     <div className="flex h-full min-h-0 flex-col overflow-y-auto bg-background">
       <SettingsTabsPage
         extraTabs={agentSettingsTabs}
+        generalSearchEntries={generalSearchEntries}
         general={
           <div className="mx-auto w-full max-w-2xl space-y-6">
-            <Card>
+            <Card id="language" className="scroll-mt-16">
               <CardHeader>
                 <CardTitle className="text-base">
                   {t("settings.languageTitle")}

package/corpus/templates/design/changelog/2026-07-08-design-generation-now-follows-hydrated-builder-design-system.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-07-08
+---
+
+Design generation now follows hydrated Builder design-system guidance before creating screens.

package/corpus/templates/design/changelog/2026-07-08-settings-are-cleaner-and-searchable.md

@@ -0,0 +1,5 @@
+---
+type: improved
+---
+
+Settings are cleaner and searchable, with a consistent navigation that jumps straight to any setting.