@agent-native/core 0.97.0 → 0.98.0

package/corpus/templates/mail/app/components/layout/AppLayout.tsx

@@ -1571,7 +1571,7 @@ function AppLayoutInner({ children }: AppLayoutProps) {
                                   });
                                 }}
                                 className={cn(
-                                  "flex w-full items-center gap-3 rounded-lg px-2 py-1.5 text-start transition-all",
+                                  "flex w-full items-center gap-3 rounded-lg px-2 py-1.5 text-start transition-opacity",
                                   isActive ? "opacity-100" : "opacity-30",
                                 )}
                               >
@@ -2005,116 +2005,125 @@ function StandardLayout({ children }: AppLayoutProps) {
         </header>
       )}
 
-      {sidebarOpen && (
-        <>
-          <div
-            className="fixed inset-0 z-30 bg-[var(--mail-overlay-scrim)]"
-            onClick={() => setSidebarOpen(false)}
-          />
-          <div className="fixed start-0 top-0 bottom-0 z-40 flex w-64 flex-col overflow-hidden bg-[var(--mail-drawer-surface)] backdrop-blur-2xl">
-            <div className="min-h-0 flex-1 overflow-y-auto p-4">
-              <div className="space-y-0.5">
-                {[
-                  { id: "inbox", label: t("mail.views.inbox"), href: "/inbox" },
-                  {
-                    id: "unread",
-                    label: t("mail.views.unread"),
-                    href: "/unread",
-                  },
-                  {
-                    id: "starred",
-                    label: t("mail.views.starred"),
-                    href: "/starred",
-                  },
-                  {
-                    id: "snoozed",
-                    label: t("mail.views.snoozed"),
-                    href: "/snoozed",
-                  },
-                  { id: "sent", label: t("mail.views.sent"), href: "/sent" },
-                  {
-                    id: "draft-queue",
-                    label: t("mail.views.draftQueue"),
-                    href: "/draft-queue",
-                  },
-                  {
-                    id: "scheduled",
-                    label: t("mail.views.scheduled"),
-                    href: "/scheduled",
-                  },
-                  {
-                    id: "drafts",
-                    label: t("mail.views.drafts"),
-                    href: "/drafts",
-                  },
-                  {
-                    id: "archive",
-                    label: t("mail.views.archive"),
-                    href: "/archive",
-                  },
-                  { id: "trash", label: t("mail.views.trash"), href: "/trash" },
-                ].map((item) => (
-                  <Link
-                    key={item.id}
-                    to={item.href}
-                    onClick={() => setSidebarOpen(false)}
-                    className={cn(
-                      "flex items-center justify-between rounded-md px-3 py-2.5 text-[14px] transition-colors min-h-[44px]",
-                      view === item.id
-                        ? "bg-accent/60 text-foreground font-medium"
-                        : "text-foreground/70 hover:bg-accent/30",
-                    )}
-                  >
-                    <span>{item.label}</span>
-                    {item.id === "draft-queue" && queuedDrafts.count > 0 && (
-                      <span className="text-[12px] text-amber-300 tabular-nums">
-                        {queuedDrafts.count}
-                      </span>
-                    )}
-                  </Link>
-                ))}
-              </div>
+      <>
+        <div
+          aria-hidden="true"
+          className={cn(
+            "fixed inset-0 z-30 bg-[var(--mail-overlay-scrim)] transition-opacity duration-200 ease-out motion-reduce:transition-none",
+            sidebarOpen ? "opacity-100" : "pointer-events-none opacity-0",
+          )}
+          onClick={() => setSidebarOpen(false)}
+        />
+        <div
+          aria-hidden={!sidebarOpen}
+          inert={!sidebarOpen}
+          className={cn(
+            "fixed start-0 top-0 bottom-0 z-40 flex w-64 flex-col overflow-hidden bg-[var(--mail-drawer-surface)] backdrop-blur-2xl transition-transform duration-200 ease-out motion-reduce:transition-none",
+            sidebarOpen
+              ? "translate-x-0"
+              : "pointer-events-none -translate-x-full rtl:translate-x-full",
+          )}
+        >
+          <div className="min-h-0 flex-1 overflow-y-auto p-4">
+            <div className="space-y-0.5">
+              {[
+                { id: "inbox", label: t("mail.views.inbox"), href: "/inbox" },
+                {
+                  id: "unread",
+                  label: t("mail.views.unread"),
+                  href: "/unread",
+                },
+                {
+                  id: "starred",
+                  label: t("mail.views.starred"),
+                  href: "/starred",
+                },
+                {
+                  id: "snoozed",
+                  label: t("mail.views.snoozed"),
+                  href: "/snoozed",
+                },
+                { id: "sent", label: t("mail.views.sent"), href: "/sent" },
+                {
+                  id: "draft-queue",
+                  label: t("mail.views.draftQueue"),
+                  href: "/draft-queue",
+                },
+                {
+                  id: "scheduled",
+                  label: t("mail.views.scheduled"),
+                  href: "/scheduled",
+                },
+                {
+                  id: "drafts",
+                  label: t("mail.views.drafts"),
+                  href: "/drafts",
+                },
+                {
+                  id: "archive",
+                  label: t("mail.views.archive"),
+                  href: "/archive",
+                },
+                { id: "trash", label: t("mail.views.trash"), href: "/trash" },
+              ].map((item) => (
+                <Link
+                  key={item.id}
+                  to={item.href}
+                  onClick={() => setSidebarOpen(false)}
+                  className={cn(
+                    "flex items-center justify-between rounded-md px-3 py-2.5 text-[14px] transition-colors min-h-[44px]",
+                    view === item.id
+                      ? "bg-accent/60 text-foreground font-medium"
+                      : "text-foreground/70 hover:bg-accent/30",
+                  )}
+                >
+                  <span>{item.label}</span>
+                  {item.id === "draft-queue" && queuedDrafts.count > 0 && (
+                    <span className="text-[12px] text-amber-300 tabular-nums">
+                      {queuedDrafts.count}
+                    </span>
+                  )}
+                </Link>
+              ))}
             </div>
+          </div>
 
-            <div className="shrink-0">
-              <div className="px-2 py-1">
-                <ExtensionsSidebarSection />
-              </div>
+          <div className="shrink-0">
+            <div className="px-2 py-1">
+              <ExtensionsSidebarSection />
+            </div>
 
-              <div className="px-3 py-2">
-                <OrgSwitcher />
-              </div>
+            <div className="px-3 py-2">
+              <OrgSwitcher />
+            </div>
 
-              <div className="flex items-center gap-1 px-2 py-2">
-                <DevDatabaseLink />
-                <FeedbackButton className="min-w-0 flex-1" />
-                <div className="flex shrink-0 items-center gap-0.5">
-                  <Tooltip>
-                    <TooltipTrigger asChild>
-                      <Link
-                        to="/settings"
-                        onClick={() => setSidebarOpen(false)}
-                        aria-label={t("mail.toolbar.settings")}
-                        className={cn(
-                          "flex h-8 w-8 items-center justify-center rounded-md text-muted-foreground transition-colors hover:bg-accent/50 hover:text-foreground",
-                          location.pathname === "/settings" &&
-                            "bg-accent/60 text-foreground",
-                        )}
-                      >
-                        <IconSettings className="h-4 w-4" />
-                      </Link>
-                    </TooltipTrigger>
-                    <TooltipContent>
-                      {t("mail.toolbar.settings")}
-                    </TooltipContent>
-                  </Tooltip>
-                  <ThemeToggle className="h-8 w-8 shrink-0" />
-                </div>
+            <div className="flex items-center gap-1 px-2 py-2">
+              <DevDatabaseLink />
+              <FeedbackButton className="min-w-0 flex-1" />
+              <div className="flex shrink-0 items-center gap-0.5">
+                <Tooltip>
+                  <TooltipTrigger asChild>
+                    <Link
+                      to="/settings"
+                      onClick={() => setSidebarOpen(false)}
+                      aria-label={t("mail.toolbar.settings")}
+                      className={cn(
+                        "flex h-8 w-8 items-center justify-center rounded-md text-muted-foreground transition-colors hover:bg-accent/50 hover:text-foreground",
+                        location.pathname === "/settings" &&
+                          "bg-accent/60 text-foreground",
+                      )}
+                    >
+                      <IconSettings className="h-4 w-4" />
+                    </Link>
+                  </TooltipTrigger>
+                  <TooltipContent>{t("mail.toolbar.settings")}</TooltipContent>
+                </Tooltip>
+                <ThemeToggle className="h-8 w-8 shrink-0" />
               </div>
             </div>
           </div>
-        </>
-      )}
+        </div>
+      </>
 
       <InvitationBanner />
 

package/corpus/templates/mail/app/root.tsx

@@ -5,7 +5,6 @@ import {
   ErrorReportActions,
   LOCALE_HYDRATION_GLOBAL,
   LOCALE_STORAGE_KEY,
-  RequireSession,
   appPath,
   appApiPath,
   createAgentNativeQueryClient,
@@ -439,17 +438,16 @@ export default function Root() {
         themeAttribute={["class", "data-theme"]}
         tooltipDelayDuration={300}
         toaster={MAIL_TOASTER}
+        sessionBypass={isMcpEmbedSurface()}
         i18n={{ catalog: i18nCatalog }}
       >
-        <RequireSession bypass={isMcpEmbedSurface()}>
-          <AutoFocus />
-          <AutomationTrigger />
-          <VisibilityRefresh />
-          <DbSyncSetup />
-          <AppLayout>
-            <Outlet />
-          </AppLayout>
-        </RequireSession>
+        <AutoFocus />
+        <AutomationTrigger />
+        <VisibilityRefresh />
+        <DbSyncSetup />
+        <AppLayout>
+          <Outlet />
+        </AppLayout>
       </AppProviders>
     </AppToolkitProvider>
   );

package/corpus/templates/mail/changelog/2026-07-11-compose-and-navigation-motion-now-feel-faster-and-smoother.md

@@ -0,0 +1,6 @@
+---
+type: improved
+date: 2026-07-11
+---
+
+Compose resizing and secondary-page navigation now move smoothly without sluggish layout animation.

package/corpus/templates/mail/changelog/2026-07-11-swipe-to-archive-or-snooze-now-responds-to-quick-flicks-not-.md

@@ -0,0 +1,6 @@
+---
+type: improved
+date: 2026-07-11
+---
+
+Swipe to archive or snooze now responds to quick flicks, not just long drags

package/corpus/templates/mail/changelog/2026-07-11-the-assistant-now-sees-the-same-inbox-you-do-snoozed-mail-st.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-07-11
+---
+
+The assistant now sees the same inbox you do — snoozed mail stays hidden and rate limits are handled gracefully

package/corpus/templates/mail/server/handlers/emails.ts

@@ -37,10 +37,7 @@ import {
   persistTracking,
   type TrackingContext,
 } from "../lib/email-tracking.js";
-import {
-  buildGmailEmailSearchQuery,
-  filterInboxScopedThreadMessages,
-} from "../lib/gmail-query.js";
+import { filterInboxScopedThreadMessages } from "../lib/gmail-query.js";
 import {
   createOAuth2Client,
   gmailGetMessage,
@@ -57,7 +54,6 @@ import {
 } from "../lib/google-api.js";
 import {
   isConnected,
-  DEFAULT_THREAD_RECENT_MESSAGE_CANDIDATE_LIMIT,
   invalidateListCacheForOwner,
   listGmailMessages,
   gmailToEmailMessage,
@@ -66,6 +62,7 @@ import {
   setAccountDisplayName,
 } from "../lib/google-auth.js";
 import { getSyntheticEmailsForView, getSnoozedThreadIds } from "../lib/jobs.js";
+import { listInboxEmails } from "../lib/list-inbox-emails.js";
 import {
   bodyToHtml as outgoingBodyToHtml,
   buildRawEmail as buildOutgoingRawEmail,
@@ -404,25 +401,6 @@ function recomputeUnreadCounts(
   });
 }
 
-function isGmailQuotaError(message: string): boolean {
-  return /\b(?:429|quota|rate limit|rateLimitExceeded|userRateLimitExceeded)\b/i.test(
-    message,
-  );
-}
-
-function retryAfterSecondsFromErrors(errors: Array<{ error: string }>): number {
-  let retryAfter = 60;
-  for (const { error } of errors) {
-    const match = error.match(/retry in\s+(\d+)s/i);
-    if (!match) continue;
-    const seconds = Number(match[1]);
-    if (Number.isFinite(seconds) && seconds > retryAfter) {
-      retryAfter = seconds;
-    }
-  }
-  return Math.min(retryAfter, 5 * 60);
-}
-
 function parseEmailPageLimit(value: string | undefined): number {
   const n = Number(value);
   if (!Number.isFinite(n) || n <= 0) return 50;
@@ -476,61 +454,39 @@ export const listEmails = defineEventHandler(async (event: H3Event) => {
         }
       }
 
-      const searchQuery = buildGmailEmailSearchQuery({ view, q, label });
-
       // Fetch label name mapping from all accounts (cached)
       const accountTokens = await getAccountTokens(email);
-      const connectedEmails = new Set(
-        accountTokens.map((account) => account.email.toLowerCase()),
-      );
       const labelMap = await getCachedLabelMap(accountTokens);
-      const { messages, errors, nextPageTokens, resultSizeEstimate } =
-        await listGmailMessages(searchQuery, pageLimit, email, pageTokens, {
-          mode: "threads",
-          threadFormat: view === "drafts" ? "full" : "metadata",
-          threadCandidateLimit: q ? 80 : undefined,
-          threadRecentMessageCandidateLimit:
-            !q && (view === "inbox" || view === "unread")
-              ? DEFAULT_THREAD_RECENT_MESSAGE_CANDIDATE_LIMIT
-              : undefined,
-        });
-      if (messages.length === 0 && errors.length > 0) {
+
+      const listResult = await listInboxEmails({
+        ownerEmail: email,
+        view,
+        q,
+        label,
+        limit: pageLimit,
+        pageTokens,
+        threadFormat: view === "drafts" ? "full" : "metadata",
+        threadCandidateLimit: q ? 80 : undefined,
+        accountTokens,
+        labelMap,
+      });
+
+      if (!listResult.ok) {
         // All accounts failed — surface as error
-        if (errors.every((e) => isGmailQuotaError(e.error))) {
-          const retryAfter = retryAfterSecondsFromErrors(errors);
+        if (listResult.isQuotaError) {
           setResponseStatus(event, 429);
-          setResponseHeader(event, "Retry-After", String(retryAfter));
+          setResponseHeader(
+            event,
+            "Retry-After",
+            String(listResult.retryAfterSeconds),
+          );
         } else {
           setResponseStatus(event, 502);
         }
-        return {
-          error: errors.map((e) => `${e.email}: ${e.error}`).join("; "),
-        };
+        return { error: listResult.message };
       }
-      let emails = messages.map((m) =>
-        gmailToEmailMessage(m, undefined, labelMap),
-      );
-      emails = filterInboxScopedThreadMessages(
-        emails,
-        view,
-        label,
-        connectedEmails,
-      );
-      emails.sort(
-        (a: any, b: any) =>
-          new Date(b.date).getTime() - new Date(a.date).getTime(),
-      );
 
-      // Filter out snoozed emails (they may linger in Gmail due to eventual consistency).
-      // Skip when searching — the user wants to find snoozed emails too.
-      if (!q && (view === "inbox" || view === "unread")) {
-        const snoozedIds = await getSnoozedThreadIds(email);
-        if (snoozedIds.size > 0) {
-          emails = emails.filter(
-            (e) => !snoozedIds.has(e.threadId) && !snoozedIds.has(e.id),
-          );
-        }
-      }
+      const { emails, errors, nextPageTokens, resultSizeEstimate } = listResult;
 
       // If some accounts failed but others succeeded, add warning header.
       // HTTP headers must be ByteString (code points <= 255), so strip any

package/corpus/templates/mail/server/lib/list-inbox-emails.ts

@@ -0,0 +1,169 @@
+/**
+ * Shared Gmail inbox-listing core.
+ *
+ * This is the single source of truth for turning a view/query/label into a
+ * filtered, sorted list of emails from Gmail — called by both the actions
+ * surface (agent, `actions/list-emails.ts`) and the REST route handler
+ * (frontend, `handlers/emails.ts::listEmails`). Before this file existed the
+ * two call sites re-implemented the same query-build + pagination +
+ * thread-scoping pipeline independently, which let them drift: the REST
+ * handler filtered out snoozed threads and handled Gmail 429/quota errors
+ * gracefully, while the agent action did neither. Keeping this logic in one
+ * place means the agent's inbox always matches what the human sees.
+ *
+ * Callers remain responsible for resolving `accountTokens` / `labelMap`
+ * (the two call sites fetch these differently — the REST handler caches
+ * label names and account display names, the action does not — that's a
+ * legitimate perf difference, not part of the listing core) and for shaping
+ * their own response envelope (compact/counts for the action; pagination
+ * tokens, error headers, and HTTP status for the REST handler).
+ */
+import type { EmailMessage } from "@shared/types.js";
+
+import {
+  buildGmailEmailSearchQuery,
+  filterInboxScopedThreadMessages,
+} from "./gmail-query.js";
+import {
+  DEFAULT_THREAD_RECENT_MESSAGE_CANDIDATE_LIMIT,
+  gmailToEmailMessage,
+  listGmailMessages,
+} from "./google-auth.js";
+import { getSnoozedThreadIds } from "./jobs.js";
+
+export interface ListInboxEmailsAccountToken {
+  email: string;
+  accessToken: string;
+}
+
+export interface ListInboxEmailsParams {
+  ownerEmail: string;
+  view: string;
+  q?: string;
+  label?: string;
+  limit: number;
+  pageTokens?: Record<string, string>;
+  threadFormat?: "full" | "metadata" | "minimal";
+  threadCandidateLimit?: number;
+  accountTokens: ListInboxEmailsAccountToken[];
+  labelMap: Map<string, string>;
+}
+
+export interface ListInboxEmailsSuccess {
+  ok: true;
+  emails: EmailMessage[];
+  errors: Array<{ email: string; error: string }>;
+  nextPageTokens?: Record<string, string>;
+  resultSizeEstimate?: number;
+}
+
+export interface ListInboxEmailsFailure {
+  ok: false;
+  message: string;
+  isQuotaError: boolean;
+  retryAfterSeconds?: number;
+}
+
+export type ListInboxEmailsResult =
+  | ListInboxEmailsSuccess
+  | ListInboxEmailsFailure;
+
+export function isGmailQuotaError(message: string): boolean {
+  return /\b(?:429|quota|rate limit|rateLimitExceeded|userRateLimitExceeded)\b/i.test(
+    message,
+  );
+}
+
+export function retryAfterSecondsFromErrors(
+  errors: Array<{ error: string }>,
+): number {
+  let retryAfter = 60;
+  for (const { error } of errors) {
+    const match = error.match(/retry in\s+(\d+)s/i);
+    if (!match) continue;
+    const seconds = Number(match[1]);
+    if (Number.isFinite(seconds) && seconds > retryAfter) {
+      retryAfter = seconds;
+    }
+  }
+  return Math.min(retryAfter, 5 * 60);
+}
+
+/**
+ * Fetch, thread-scope, sort, and snooze-filter Gmail messages for a view.
+ * Returns a discriminated result instead of throwing on Gmail errors so both
+ * callers can decide how to surface a rate-limit/quota failure gracefully
+ * (HTTP status + Retry-After header for the REST handler, a structured JSON
+ * error payload for the agent action) rather than an unhandled exception.
+ */
+export async function listInboxEmails(
+  params: ListInboxEmailsParams,
+): Promise<ListInboxEmailsResult> {
+  const {
+    ownerEmail,
+    view,
+    q,
+    label,
+    limit,
+    pageTokens,
+    threadFormat,
+    threadCandidateLimit,
+    accountTokens,
+    labelMap,
+  } = params;
+
+  const connectedEmails = new Set(
+    accountTokens.map((account) => account.email.toLowerCase()),
+  );
+  const searchQuery = buildGmailEmailSearchQuery({ view, q, label });
+
+  const { messages, errors, nextPageTokens, resultSizeEstimate } =
+    await listGmailMessages(searchQuery, limit, ownerEmail, pageTokens, {
+      mode: "threads",
+      threadFormat,
+      threadCandidateLimit,
+      threadRecentMessageCandidateLimit:
+        !q && (view === "inbox" || view === "unread")
+          ? DEFAULT_THREAD_RECENT_MESSAGE_CANDIDATE_LIMIT
+          : undefined,
+    });
+
+  if (messages.length === 0 && errors.length > 0) {
+    const isQuotaError = errors.every((e) => isGmailQuotaError(e.error));
+    return {
+      ok: false,
+      message: errors.map((e) => `${e.email}: ${e.error}`).join("; "),
+      isQuotaError,
+      retryAfterSeconds: isQuotaError
+        ? retryAfterSecondsFromErrors(errors)
+        : undefined,
+    };
+  }
+
+  let emails = messages.map((m: any) =>
+    gmailToEmailMessage(m, m._accountEmail, labelMap),
+  ) as EmailMessage[];
+  emails = filterInboxScopedThreadMessages(
+    emails,
+    view,
+    label,
+    connectedEmails,
+  );
+  emails = [...emails].sort(
+    (a, b) => new Date(b.date).getTime() - new Date(a.date).getTime(),
+  );
+
+  // Filter out snoozed threads (they may linger in Gmail due to eventual
+  // consistency). Skip when searching — the user/agent wants to find snoozed
+  // emails too when explicitly searching for them.
+  if (!q && (view === "inbox" || view === "unread")) {
+    const snoozedIds = await getSnoozedThreadIds(ownerEmail);
+    if (snoozedIds.size > 0) {
+      emails = emails.filter(
+        (e) => !snoozedIds.has(e.threadId) && !snoozedIds.has(e.id),
+      );
+    }
+  }
+
+  return { ok: true, emails, errors, nextPageTokens, resultSizeEstimate };
+}

package/corpus/templates/plan/.agents/skills/frontend-design/SKILL.md

@@ -48,7 +48,7 @@ Default to Apple/Linear-level restraint: make the primary workflow obvious, then
 
 - **Typography**: Use the product's existing type system first. For net-new public pages, choose characterful but readable type and keep sizing appropriate to the surface.
 - **Color and theme**: Use semantic tokens and CSS variables. Avoid one-note palettes and default purple/blue gradients unless the brand demands them.
-- **Motion**: Prefer purposeful transitions and small state changes. Use CSS transitions/keyframes unless the app already uses a motion library.
+- **Motion**: Prefer purposeful transitions and small state changes. Use CSS transitions/keyframes unless the app already uses a motion library. Never `transition-all` — list the properties that actually change (e.g. `transition-[opacity,transform]`). Use the shared easing tokens defined in `packages/core/src/styles/agent-native.css` instead of hand-typing curves: `var(--ease-drawer)` (260ms, drawers/app chrome), `var(--ease-collapse)` (200ms, expand/collapse), `var(--ease-out-strong)` (snappy entrances) — in Tailwind, `ease-[var(--ease-collapse)]`. Enter/exit with ease-out, never `ease-in`. Overlays that zoom in must set the Radix origin var (e.g. `origin-[--radix-popover-content-transform-origin]`). Animate `transform`/`opacity`, not width/height/padding/box-shadow. Gate looping or large-movement animations with `motion-reduce:`. Command palettes and keyboard-triggered actions get no animation.
 - **Composition**: Match the workflow. Operational apps should be dense and scannable; marketing or portfolio pages can be more immersive.
 - **Visual assets**: Websites, games, and object-focused pages need real or generated media when images help users understand the subject.
 - **Responsive fit**: Text must not overflow buttons, cards, tabs, sidebars, or fixed-format tools. Use stable dimensions for boards, grids, toolbars, and counters.

package/corpus/templates/plan/.env.example

@@ -11,6 +11,10 @@
 # Google sign-in (optional)
 # Set these to show "Continue with Google" on the account screen.
 # For simple local plan generation, the dev auto-session is enough.
+# Preferred: low-scope, sign-in-only credentials.
+# GOOGLE_SIGN_IN_CLIENT_ID=
+# GOOGLE_SIGN_IN_CLIENT_SECRET=
+# Fallback: broader-scope legacy credentials, used if the pair above is unset.
 # GOOGLE_CLIENT_ID=
 # GOOGLE_CLIENT_SECRET=