@agent-native/core 0.102.2 → 0.103.1

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

@@ -36,6 +36,7 @@ import {
   AlertDialogHeader,
   AlertDialogTitle,
 } from "@/components/ui/alert-dialog";
+import { Badge } from "@/components/ui/badge";
 import { Button } from "@/components/ui/button";
 import {
   DropdownMenu,
@@ -45,6 +46,7 @@ import {
 } from "@/components/ui/dropdown-menu";
 import { Input } from "@/components/ui/input";
 import { Spinner } from "@/components/ui/spinner";
+import { useDesignSystems } from "@/hooks/use-design-systems";
 import { writePendingGeneration } from "@/lib/pending-generation";
 
 type TemplateCategory =
@@ -63,28 +65,26 @@ interface DesignTemplateSummary {
   width?: number | null;
   height?: number | null;
   lockedLayerCount: number;
+  designSystemId?: string | null;
   visibility: "private" | "org" | "public";
   isOwner: boolean;
+  isBuiltIn: boolean;
   source: "starter" | "saved";
   previewHtml?: string | null;
 }
 
-interface TemplatesResult {
-  count: number;
-  starterCount: number;
-  savedCount: number;
-  templates: DesignTemplateSummary[];
-}
-
 export default function Templates() {
   const t = useT();
   const navigate = useNavigate();
-  const [searchParams] = useSearchParams();
+  const [searchParams, setSearchParams] = useSearchParams();
   const queryClient = useQueryClient();
   const [search, setSearch] = useState("");
   const [selected, setSelected] = useState<DesignTemplateSummary | null>(null);
   const [promptOpen, setPromptOpen] = useState(false);
   const [creating, setCreating] = useState(false);
+  const [selectedDesignSystemId, setSelectedDesignSystemId] = useState<
+    string | null | undefined
+  >(undefined);
   const [deleteTemplate, setDeleteTemplate] =
     useState<DesignTemplateSummary | null>(null);
   const anchorElRef = useRef<HTMLElement | null>(null);
@@ -92,12 +92,19 @@ export default function Templates() {
   const anchorRef = useRef<HTMLElement | null>(null);
   anchorRef.current = anchorElRef.current;
 
-  const { data, isLoading, isError, isFetching, refetch } =
-    useActionQuery<TemplatesResult>("list-design-templates", {
+  const { data, isLoading, isError, isFetching, refetch } = useActionQuery(
+    "list-design-templates",
+    {
       includePreview: "true",
-    });
+    },
+  );
   const createMutation = useActionMutation("create-design-from-template");
   const deleteMutation = useActionMutation("delete-design-template");
+  const {
+    designSystems,
+    defaultSystem,
+    isLoading: designSystemsLoading,
+  } = useDesignSystems();
 
   const templates = data?.templates ?? [];
   const linkedTemplateId = searchParams.get("templateId");
@@ -112,8 +119,27 @@ export default function Templates() {
         )
       : templates;
   }, [search, templates]);
-  const starters = filtered.filter((template) => template.source === "starter");
-  const saved = filtered.filter((template) => template.source === "saved");
+  const builtIns = filtered.filter((template) => template.isBuiltIn);
+  const userTemplates = filtered.filter((template) => !template.isBuiltIn);
+
+  const resolveTemplateDesignSystemId = (
+    template: DesignTemplateSummary,
+  ): string | null => {
+    if (
+      template.designSystemId &&
+      designSystems.some((system) => system.id === template.designSystemId)
+    ) {
+      return template.designSystemId;
+    }
+    return defaultSystem?.id ?? designSystems[0]?.id ?? null;
+  };
+
+  const setSelectedTemplateParam = (templateId: string | null) => {
+    const next = new URLSearchParams(searchParams);
+    if (templateId) next.set("templateId", templateId);
+    else next.delete("templateId");
+    setSearchParams(next, { replace: true });
+  };
 
   useEffect(() => {
     if (
@@ -125,7 +151,7 @@ export default function Templates() {
     const template = templates.find(
       (candidate) => candidate.id === linkedTemplateId,
     );
-    if (!template) return;
+    if (!template || designSystemsLoading) return;
 
     const card = document.getElementById(`design-template-${linkedTemplateId}`);
     const useButton = card?.querySelector<HTMLElement>(
@@ -135,17 +161,21 @@ export default function Templates() {
     handledTemplateIdRef.current = linkedTemplateId;
     setSearch("");
     setSelected(template);
+    setSelectedDesignSystemId(resolveTemplateDesignSystemId(template));
     setPromptOpen(true);
     card?.scrollIntoView({ block: "center", behavior: "smooth" });
     useButton?.focus();
-  }, [linkedTemplateId, templates]);
+  }, [designSystemsLoading, linkedTemplateId, templates]);
 
   const openTemplatePrompt = (
     template: DesignTemplateSummary,
     element: HTMLElement,
   ) => {
     anchorElRef.current = element;
+    handledTemplateIdRef.current = template.id;
+    setSelectedTemplateParam(template.id);
     setSelected(template);
+    setSelectedDesignSystemId(resolveTemplateDesignSystemId(template));
     setPromptOpen(true);
   };
 
@@ -156,40 +186,58 @@ export default function Templates() {
   ) => {
     setCreating(true);
     try {
-      const title = prompt?.trim() ? derivePromptTitle(prompt) : template.title;
+      const trimmedPrompt = prompt?.trim() ?? "";
+      const title = trimmedPrompt
+        ? derivePromptTitle(trimmedPrompt)
+        : template.title;
+      const designSystemId =
+        selectedDesignSystemId === undefined
+          ? resolveTemplateDesignSystemId(template)
+          : selectedDesignSystemId;
       const result = (await createMutation.mutateAsync({
         templateId: template.id,
         title,
-        ...(prompt?.trim() ? { prompt: prompt.trim() } : {}),
+        designSystemId,
+        ...(trimmedPrompt ? { prompt: trimmedPrompt } : {}),
       })) as {
-        id?: string;
+        id: string;
         title?: string;
+        designSystemId?: string | null;
+        adaptationPending?: boolean;
         templateBaselineFiles?: Array<{ id: string; contentHash: string }>;
       };
       if (!result.id)
         throw new Error("Template copy did not return a design ID");
-      if (prompt?.trim()) {
+      if (result.adaptationPending) {
+        const effectiveDesignSystemId = result.designSystemId ?? null;
+        const effectiveSystemTitle =
+          designSystems.find((system) => system.id === effectiveDesignSystemId)
+            ?.title ?? t("promptDialog.designSystem");
         writePendingGeneration(result.id, {
-          prompt: prompt.trim(),
+          prompt:
+            trimmedPrompt ||
+            t("promptDialog.reskinTemplatePrompt", {
+              title: template.title,
+              system: effectiveSystemTitle,
+            }),
           title: result.title ?? title,
           source: template.title,
           templateId: template.id,
           templateBaselineFiles: result.templateBaselineFiles,
+          designSystemId: effectiveDesignSystemId,
           skipQuestions: true,
           ...options,
         });
       }
-      await queryClient.invalidateQueries({
-        queryKey: ["action", "list-designs"],
-      });
+      void queryClient
+        .invalidateQueries({
+          queryKey: ["action", "list-designs"],
+        })
+        .catch(() => {});
       navigate(`/design/${result.id}`);
     } catch (error) {
       setCreating(false);
-      toast.error(
-        error instanceof Error
-          ? error.message
-          : t("templatesPage.createFailed"),
-      );
+      throw error;
     }
   };
 
@@ -199,7 +247,7 @@ export default function Templates() {
     options: PromptComposerSubmitOptions,
   ) => {
     if (!selected) return;
-    void createFromTemplate(selected, prompt, options);
+    return createFromTemplate(selected, prompt, options);
   };
 
   const handleDelete = async () => {
@@ -254,6 +302,16 @@ export default function Templates() {
           </p>
         </div>
 
+        <div className="relative mb-6 md:hidden">
+          <IconSearch className="absolute start-2.5 top-1/2 size-3.5 -translate-y-1/2 text-muted-foreground/70" />
+          <Input
+            value={search}
+            onChange={(event) => setSearch(event.target.value)}
+            placeholder={t("templatesPage.searchPlaceholder")}
+            className="h-9 w-full bg-accent/50 ps-8 text-sm"
+          />
+        </div>
+
         {isLoading ? (
           <TemplateGridSkeleton />
         ) : isError ? (
@@ -264,19 +322,19 @@ export default function Templates() {
         ) : (
           <div className="flex flex-col gap-10">
             <TemplateSection
-              title={t("templatesPage.starterTemplates")}
-              templates={starters}
+              title={t("templatesPage.yourTemplates")}
+              description={t("templatesPage.yourTemplatesDescription")}
+              templates={userTemplates}
               linkedTemplateId={linkedTemplateId}
+              empty={t("templatesPage.yourTemplatesEmpty")}
               onUse={openTemplatePrompt}
+              onDelete={setDeleteTemplate}
             />
             <TemplateSection
-              title={t("templatesPage.savedTemplates")}
-              description={t("templatesPage.savedTemplatesDescription")}
-              templates={saved}
+              title={t("templatesPage.builtInTemplates")}
+              templates={builtIns}
               linkedTemplateId={linkedTemplateId}
-              empty={t("templatesPage.savedEmpty")}
               onUse={openTemplatePrompt}
-              onDelete={setDeleteTemplate}
             />
           </div>
         )}
@@ -286,17 +344,40 @@ export default function Templates() {
         open={promptOpen}
         onOpenChange={(open) => {
           setPromptOpen(open);
-          if (!open) setSelected(null);
+          if (!open) {
+            setSelected(null);
+            setSelectedDesignSystemId(undefined);
+            setSelectedTemplateParam(null);
+          }
         }}
         title={selected?.title ?? t("templatesPage.useTemplate")}
         placeholder={t("templatesPage.promptPlaceholder")}
-        onSkip={() => {
-          if (selected) void createFromTemplate(selected);
+        onSkip={async () => {
+          if (!selected) return;
+          try {
+            await createFromTemplate(selected);
+            return false;
+          } catch (error) {
+            toast.error(
+              error instanceof Error
+                ? error.message
+                : t("templatesPage.createFailed"),
+            );
+            throw error;
+          }
         }}
         skipLabel={t("templatesPage.useAsIs")}
         onSubmit={handleSubmit}
         anchorRef={anchorRef}
         loading={creating}
+        designSystems={designSystems}
+        designSystemsLoading={designSystemsLoading}
+        selectedDesignSystemId={selectedDesignSystemId ?? null}
+        onDesignSystemChange={setSelectedDesignSystemId}
+        onCreateDesignSystem={() => {
+          setPromptOpen(false);
+          navigate("/design-systems/setup");
+        }}
       />
 
       <AlertDialog
@@ -407,14 +488,24 @@ function TemplateCard({
       <div className="flex min-h-40 flex-col p-4">
         <div className="flex items-start gap-2">
           <div className="min-w-0 flex-1">
-            <h3 className="truncate text-sm font-medium text-foreground/90">
-              {template.title}
-            </h3>
+            <div className="flex min-w-0 items-center gap-2">
+              <h3 className="truncate text-sm font-medium text-foreground/90">
+                {template.title}
+              </h3>
+              {template.isBuiltIn ? (
+                <Badge
+                  variant="secondary"
+                  className="h-5 shrink-0 px-1.5 text-[10px] font-medium"
+                >
+                  {t("templatesPage.builtIn")}
+                </Badge>
+              ) : null}
+            </div>
             <p className="mt-1 line-clamp-2 text-xs leading-relaxed text-muted-foreground">
               {template.description}
             </p>
           </div>
-          {template.source === "saved" ? (
+          {!template.isBuiltIn && template.isOwner ? (
             <DropdownMenu>
               <DropdownMenuTrigger asChild>
                 <Button
@@ -429,18 +520,16 @@ function TemplateCard({
                 </Button>
               </DropdownMenuTrigger>
               <DropdownMenuContent align="end">
-                {template.isOwner ? (
-                  <div className="p-1">
-                    <ShareButton
-                      resourceType="design-template"
-                      resourceId={template.id}
-                      resourceTitle={template.title}
-                      trigger="label"
-                      triggerClassName="w-full justify-start"
-                    />
-                  </div>
-                ) : null}
-                {template.isOwner && onDelete ? (
+                <div className="p-1">
+                  <ShareButton
+                    resourceType="design-template"
+                    resourceId={template.id}
+                    resourceTitle={template.title}
+                    trigger="label"
+                    triggerClassName="w-full justify-start"
+                  />
+                </div>
+                {onDelete ? (
                   <DropdownMenuItem
                     onClick={() => onDelete(template)}
                     className="text-destructive focus:text-destructive"

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

@@ -66,6 +66,17 @@ export function designSystemGenerationDirectives(
   ];
 }
 
+export function designSystemTemplateEditDirectives(
+  designSystemId?: string | null,
+): string[] {
+  if (!designSystemId) return [];
+  return [
+    `Use design system id "${designSystemId}" while adapting the copied template.`,
+    "Use the selected design system context in this message as mandatory edit input. If details are missing or conflict, call `get-design-system` for that id before editing.",
+    "Apply the system through `edit-design` while preserving the copied structure and every locked subtree. Do not call `generate-design`.",
+  ];
+}
+
 interface DesignSystemGenerationContextResult {
   title?: string;
   agentContext?: string;
@@ -169,7 +180,7 @@ export function designTemplateRefinementDirectives(
 ): string[] {
   return [
     `This design was copied from template "${templateId}". Its files, canvas dimensions, defaults, and locked layers already exist.`,
-    ...designSystemGenerationDirectives(designSystemId),
+    ...designSystemTemplateEditDirectives(designSystemId),
     `Call \`get-design-snapshot --designId="${designId}"\` exactly once before editing.`,
     "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.',

package/corpus/templates/design/changelog/2026-07-14-templates-now-appear-in-the-new-design-picker-with-previews-.md

@@ -0,0 +1,6 @@
+---
+type: improved
+date: 2026-07-14
+---
+
+Templates now appear in the New Design picker with previews, linked design systems, and clear built-in labels.

package/corpus/templates/design/changelog/2026-07-15-templates-now-open-immediately-after-copying-even-while-the-.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-07-15
+---
+
+Templates now open immediately after copying, even while the designs list refreshes.

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

@@ -64,7 +64,7 @@ When the user asks for a new design and the current navigation view is list, set
 
 Every web design must be responsive. Use mobile-first CSS, a viewport meta tag, and responsive layout changes for narrow widths; never ship a fixed-width desktop shell. Desktop is the default primary artboard: use a 1440×1024 canvas frame (or primaryViewport "desktop") unless the user explicitly asks for a mobile- or tablet-primary design. After generation, inspect desktop and mobile screenshots and correct overflow or broken reflow before reporting completion.
 
-When the user asks to start from a template, call list-design-templates and then create-design-from-template. The copied files and canvas dimensions are already the starting point. If the user also supplied a prompt, call get-design-snapshot once and refine unlocked content with edit-design; do not call generate-design or replace the template with a fresh screen. Layers marked data-agent-native-locked="true" and their descendants must remain byte-for-byte unchanged. Ask the user to unlock one explicitly if they want it changed.
+When the user asks to start from a template or references a prior design/past work as the starting point, call both list-design-templates and list-designs before generating so you resolve the existing resource instead of recreating it. For a template, call create-design-from-template. The copied files and canvas dimensions are already the starting point. If the user also supplied a prompt or selected a different linked design system, call get-design-snapshot once and refine unlocked content with edit-design; do not call generate-design or replace the template with a fresh screen. Layers marked data-agent-native-locked="true" and their descendants must remain byte-for-byte unchanged. Ask the user to unlock one explicitly if they want it changed.
 
 When the user asks you to refine an existing design, call view-screen if the open design is unclear, then read the live current file with get-design-snapshot before editing. For small localized changes, call edit-design with exact search/replace edits. For broad copy-only changes such as translating all visible text, call edit-design in replace-file mode with the complete updated file content from the snapshot so the HTML structure, scripts, styles, and tweaks are preserved without dozens of fragile search blocks. Do not claim the design is updated until the mutating action succeeds.
 

package/corpus/templates/mail/AGENTS.md

@@ -84,6 +84,11 @@ needed.
   call `refresh-list` so the UI refetches. Actions that already write
   `refresh-signal` internally (e.g. `mark-thread-read`, `move-email`,
   `respond-calendar-invite`) don't need a second call.
+- For broad unread cleanup in one account, call `mark-read` once with
+  `scope: "all-unread"`, the exact `accountEmail`, and any protected
+  conversation IDs in `excludeThreadIds`. Do not loop `mark-thread-read` over
+  many conversations. The bulk result's matched, excluded, changed, failure,
+  and remaining-unread counts are the proof of completion.
 - Use `view-screen` when the active thread, selected message, draft, or queue
   item is unclear.
 - Aliases (Settings → Aliases) and provider API-key connections (Gong, Pylon,
@@ -94,24 +99,24 @@ needed.
 
 ## Action Map
 
-| Action                                                                                                                                 | Purpose                                                                                                       |
-| -------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------- |
-| `search-emails` / `list-emails`                                                                                                        | Query across Gmail or local-fallback data by view/query.                                                      |
-| `get-email` / `get-thread`                                                                                                             | Full body/metadata for one message or thread.                                                                 |
-| `find-contact`                                                                                                                         | Resolve a name/partial address to a real email.                                                               |
-| `get-hubspot-contact`                                                                                                                  | CRM contact + deals + tickets by email (HubSpot only).                                                        |
-| `create-attachment-upload`                                                                                                             | Mint a five-minute, owner-bound raw-byte upload URL for one local attachment.                                 |
-| `manage-draft`                                                                                                                         | Create/update/delete a `compose-{id}` draft (signature-aware).                                                |
-| `send-email`                                                                                                                           | Real send. `needsApproval: true`; exact authenticated chat grants run once, otherwise it pauses for approval. |
-| `queue-email-draft` / `list-queued-drafts` / `update-queued-draft` / `open-queued-draft` / `send-queued-drafts`                        | Teammate/Slack draft-review workflow — see `draft-queue`.                                                     |
-| `mark-read` / `mark-thread-read` / `star-email` / `archive-email` / `unarchive-email` / `trash-email` / `untrash-email` / `move-email` | Per-message or per-thread state changes; most call `refresh-list` internally.                                 |
-| `manage-gmail-filters`                                                                                                                 | Provider-native Gmail filters (create/replace/delete).                                                        |
-| `manage-automations` / `trigger-automations`                                                                                           | Natural-language inbox automation rules.                                                                      |
-| `respond-calendar-invite`                                                                                                              | Accept/decline/tentative an invite found in Mail.                                                             |
-| `get-mail-settings` / `update-mail-settings` / `import-gmail-signature`                                                                | Signature and writing-style settings.                                                                         |
-| `manage-snippets`                                                                                                                      | List/create/update/delete saved reply snippets insertable from the compose slash menu.                        |
-| `get-tracking`                                                                                                                         | Open/click stats for a previously sent, tracked message.                                                      |
-| `provider-api-catalog` / `provider-api-docs` / `provider-api-request`                                                                  | Raw Gmail, Calendar, or HubSpot API calls beyond the canned actions.                                          |
+| Action                                                                                                                                 | Purpose                                                                                                                                                                            |
+| -------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `search-emails` / `list-emails`                                                                                                        | Query across Gmail or local-fallback data by view/query.                                                                                                                           |
+| `get-email` / `get-thread`                                                                                                             | Full body/metadata for one message or thread.                                                                                                                                      |
+| `find-contact`                                                                                                                         | Resolve a name/partial address to a real email.                                                                                                                                    |
+| `get-hubspot-contact`                                                                                                                  | CRM contact + deals + tickets by email (HubSpot only).                                                                                                                             |
+| `create-attachment-upload`                                                                                                             | Mint a five-minute, owner-bound raw-byte upload URL for one local attachment.                                                                                                      |
+| `manage-draft`                                                                                                                         | Create/update/delete a `compose-{id}` draft (signature-aware).                                                                                                                     |
+| `send-email`                                                                                                                           | Real send. `needsApproval: true`; exact authenticated chat grants run once, otherwise it pauses for approval.                                                                      |
+| `queue-email-draft` / `list-queued-drafts` / `update-queued-draft` / `open-queued-draft` / `send-queued-drafts`                        | Teammate/Slack draft-review workflow — see `draft-queue`.                                                                                                                          |
+| `mark-read` / `mark-thread-read` / `star-email` / `archive-email` / `unarchive-email` / `trash-email` / `untrash-email` / `move-email` | Per-message or per-thread state changes. `mark-read` also supports one-account verified bulk unread cleanup with protected-thread exclusions; most call `refresh-list` internally. |
+| `manage-gmail-filters`                                                                                                                 | Provider-native Gmail filters (create/replace/delete).                                                                                                                             |
+| `manage-automations` / `trigger-automations`                                                                                           | Natural-language inbox automation rules.                                                                                                                                           |
+| `respond-calendar-invite`                                                                                                              | Accept/decline/tentative an invite found in Mail.                                                                                                                                  |
+| `get-mail-settings` / `update-mail-settings` / `import-gmail-signature`                                                                | Signature and writing-style settings.                                                                                                                                              |
+| `manage-snippets`                                                                                                                      | List/create/update/delete saved reply snippets insertable from the compose slash menu.                                                                                             |
+| `get-tracking`                                                                                                                         | Open/click stats for a previously sent, tracked message.                                                                                                                           |
+| `provider-api-catalog` / `provider-api-docs` / `provider-api-request`                                                                  | Raw Gmail, Calendar, or HubSpot API calls beyond the canned actions.                                                                                                               |
 
 ## Application State
 

package/corpus/templates/mail/actions/bulk-archive.ts

@@ -1,7 +1,13 @@
 import { defineAction } from "@agent-native/core";
-import { getSetting, putSetting } from "@agent-native/core/settings";
+import { getRequestUserEmail } from "@agent-native/core/server";
 import { z } from "zod";
 
+import {
+  readLocalEmails,
+  withLocalEmailMutationLock,
+  writeLocalEmails,
+} from "../server/lib/local-email-store.js";
+
 export default defineAction({
   description:
     "Archive emails older than N days from inbox (local data only — use archive-email for Gmail-connected accounts).",
@@ -19,34 +25,32 @@ export default defineAction({
     if (isNaN(days) || days < 1)
       throw new Error("--older-than must be a positive integer (days)");
 
-    const data = await getSetting("local-emails");
-    if (!data || !Array.isArray((data as any).emails)) {
-      throw new Error(
-        "No local emails data found. This tool only works with local data.",
-      );
-    }
+    const ownerEmail = getRequestUserEmail();
+    if (!ownerEmail) throw new Error("no authenticated user");
 
-    const emails: any[] = (data as any).emails;
-    const cutoff = Date.now() - days * 24 * 60 * 60 * 1000;
-    let archived = 0;
-    const updated = emails.map((email) => {
-      if (
-        !email.isArchived &&
-        !email.isTrashed &&
-        !email.isDraft &&
-        new Date(email.date).getTime() < cutoff
-      ) {
-        archived++;
-        return {
-          ...email,
-          isArchived: true,
-          labelIds: email.labelIds.filter((l: string) => l !== "inbox"),
-        };
-      }
-      return email;
-    });
+    return withLocalEmailMutationLock(ownerEmail, async () => {
+      const emails = await readLocalEmails(ownerEmail);
+      const cutoff = Date.now() - days * 24 * 60 * 60 * 1000;
+      let archived = 0;
+      const updated = emails.map((email) => {
+        if (
+          !email.isArchived &&
+          !email.isTrashed &&
+          !email.isDraft &&
+          new Date(email.date).getTime() < cutoff
+        ) {
+          archived++;
+          return {
+            ...email,
+            isArchived: true,
+            labelIds: email.labelIds.filter((label) => label !== "inbox"),
+          };
+        }
+        return email;
+      });
 
-    await putSetting("local-emails", { emails: updated });
-    return `Archived ${archived} email(s) older than ${days} days (${emails.length} total)`;
+      await writeLocalEmails(ownerEmail, updated);
+      return `Archived ${archived} email(s) older than ${days} days (${emails.length} total)`;
+    });
   },
 });