@agent-native/core 0.176.1 → 0.176.2-nightly-20260831184159

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

@@ -31,6 +31,7 @@ import {
   Outlet,
   Scripts,
   ScrollRestoration,
+  useLocation,
   useRouteError,
 } from "react-router";
 import type { LinksFunction } from "react-router";
@@ -437,25 +438,36 @@ function DbSyncSetup() {
 // AppProviders built-in toaster is suppressed via toaster={null}.
 const MAIL_TOASTER = <Toaster richColors position="bottom-left" />;
 
+function AppContent() {
+  return (
+    <>
+      <AutoFocus />
+      <AutomationTrigger />
+      <VisibilityRefresh />
+      <DbSyncSetup />
+      <AppLayout>
+        <Outlet />
+      </AppLayout>
+    </>
+  );
+}
+
 export default function Root() {
   const [queryClient] = useState(() => createAgentNativeQueryClient());
+  const location = useLocation();
+  const isMarketingPath = location.pathname === "/";
   return (
     <AppToolkitProvider>
       <AppProviders
         queryClient={queryClient}
         themeAttribute={["class", "data-theme"]}
         tooltipDelayDuration={300}
-        toaster={MAIL_TOASTER}
+        isPublicPath={isMarketingPath}
+        toaster={isMarketingPath ? null : MAIL_TOASTER}
         sessionBypass={isMcpEmbedSurface()}
         i18n={{ catalog: i18nCatalog }}
       >
-        <AutoFocus />
-        <AutomationTrigger />
-        <VisibilityRefresh />
-        <DbSyncSetup />
-        <AppLayout>
-          <Outlet />
-        </AppLayout>
+        {isMarketingPath ? <Outlet /> : <AppContent />}
       </AppProviders>
     </AppToolkitProvider>
   );

package/corpus/templates/mail/app/routes/_index.tsx

@@ -1,8 +1,5 @@
-import { agentNativePath } from "@agent-native/core/client/api-path";
-import { withSsrHtmlContentType } from "@agent-native/core/shared";
-import { redirect, type LoaderFunctionArgs } from "react-router";
-
-import { Spinner } from "@/components/ui/spinner";
+import { appPath } from "@agent-native/core/client/api-path";
+import { MarketingHome } from "@agent-native/toolkit/marketing";
 
 const SEO_TITLE =
   "Mail - Open Source AI email client and Superhuman alternative";
@@ -12,10 +9,7 @@ const SEO_DESCRIPTION =
 export function meta() {
   return [
     { title: SEO_TITLE },
-    {
-      name: "description",
-      content: SEO_DESCRIPTION,
-    },
+    { name: "description", content: SEO_DESCRIPTION },
     { property: "og:title", content: SEO_TITLE },
     { property: "og:description", content: SEO_DESCRIPTION },
     { name: "twitter:card", content: "summary" },
@@ -24,52 +18,19 @@ export function meta() {
   ];
 }
 
-/**
- * Run the redirect on both the server and the client. Doing it client-only
- * via `clientLoader` previously caused React Router to occasionally log
- * `No routes matched location "/inbox"` because the navigation fired during
- * hydration, before the route tree was fully attached. A `loader` runs as
- * part of the server response and the navigation completes before the app
- * hydrates. The server redirect stays preference-free for the public SSR
- * shell; client navigations can choose the saved preference only after a
- * successful settings read confirms there is no explicit pin list.
- */
-type MailPreferences = {
-  pinnedLabels?: string[];
-};
-
-async function resolveRootInboxHref(): Promise<string> {
-  try {
-    const response = await fetch(
-      agentNativePath("/_agent-native/actions/get-mail-preferences"),
-    );
-    if (!response.ok) return "/inbox";
-    const settings = (await response.json()) as MailPreferences;
-    return settings.pinnedLabels === undefined
-      ? "/inbox?label=important"
-      : "/inbox";
-  } catch {
-    return "/inbox";
-  }
-}
-
-export function loader(_args: LoaderFunctionArgs) {
-  throw withSsrHtmlContentType(redirect("/inbox"));
-}
-
-export async function clientLoader(_args: LoaderFunctionArgs) {
-  throw withSsrHtmlContentType(redirect(await resolveRootInboxHref()));
-}
-
-export function HydrateFallback() {
+export default function MarketingHomeRoute() {
   return (
-    <div className="flex items-center justify-center h-screen w-full">
-      <Spinner className="size-8" />
-    </div>
+    <MarketingHome
+      appName="Mail"
+      tagline="Your AI agent reads, drafts, and organizes email alongside you."
+      description={SEO_DESCRIPTION}
+      valueProps={[
+        "Draft replies that match your tone and style",
+        "Manage multiple Gmail accounts in one unified inbox",
+        "Automate triage, archiving, and follow-ups",
+      ]}
+      primaryActionHref={appPath("/home")}
+      secondaryActionHref={appPath("/sign-in")}
+    />
   );
 }
-
-export default function IndexRoute() {
-  // Should never render — both loaders redirect to the inbox.
-  return null;
-}

package/corpus/templates/mail/app/routes/home.tsx

@@ -0,0 +1,71 @@
+import { agentNativePath } from "@agent-native/core/client/api-path";
+import { DefaultSpinner } from "@agent-native/core/client/ui";
+import { withSsrHtmlContentType } from "@agent-native/core/shared";
+import { redirect, type LoaderFunctionArgs } from "react-router";
+
+const SEO_TITLE =
+  "Mail - Open Source AI email client and Superhuman alternative";
+const SEO_DESCRIPTION =
+  "Open Source AI email client for Gmail triage, drafting, organization, follow-ups, and inbox workflows built around shared actions.";
+
+export function meta() {
+  return [
+    { title: SEO_TITLE },
+    {
+      name: "description",
+      content: SEO_DESCRIPTION,
+    },
+    { property: "og:title", content: SEO_TITLE },
+    { property: "og:description", content: SEO_DESCRIPTION },
+    { name: "twitter:card", content: "summary" },
+    { name: "twitter:title", content: SEO_TITLE },
+    { name: "twitter:description", content: SEO_DESCRIPTION },
+  ];
+}
+
+/**
+ * Run the redirect on both the server and the client. Doing it client-only
+ * via `clientLoader` previously caused React Router to occasionally log
+ * `No routes matched location "/inbox"` because the navigation fired during
+ * hydration, before the route tree was fully attached. A `loader` runs as
+ * part of the server response and the navigation completes before the app
+ * hydrates. The server redirect stays preference-free for the public SSR
+ * shell; client navigations can choose the saved preference only after a
+ * successful settings read confirms there is no explicit pin list.
+ */
+type MailPreferences = {
+  pinnedLabels?: string[];
+};
+
+async function resolveRootInboxHref(): Promise<string> {
+  try {
+    const response = await fetch(
+      agentNativePath("/_agent-native/actions/get-mail-preferences"),
+    );
+    if (!response.ok) return "/inbox";
+    const settings = (await response.json()) as MailPreferences;
+    return settings.pinnedLabels === undefined
+      ? "/inbox?label=important"
+      : "/inbox";
+  } catch {
+    return "/inbox";
+  }
+}
+
+export function loader(_args: LoaderFunctionArgs) {
+  throw withSsrHtmlContentType(redirect("/inbox"));
+}
+
+export async function clientLoader(_args: LoaderFunctionArgs) {
+  throw withSsrHtmlContentType(redirect(await resolveRootInboxHref()));
+}
+
+export function HydrateFallback() {
+  return <DefaultSpinner />;
+}
+
+// Private app entry retained at /home; / serves the public marketing page.
+export default function IndexRoute() {
+  // Should never render — both loaders redirect to the inbox.
+  return null;
+}

package/corpus/templates/mail/changelog/2026-08-28-mail-settings-show-chat-created-automations.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-08-28
+---
+
+Mail Settings now shows scheduled automations created from Mail chat.

package/corpus/templates/mail/public/manifest.json

@@ -2,7 +2,7 @@
   "name": "Mail",
   "short_name": "Mail",
   "description": "Email client",
-  "start_url": ".",
+  "start_url": "./home",
   "background_color": "#111111",
   "theme_color": "#3B82F6",
   "icons": [

package/corpus/templates/mail/server/db/schema.ts

@@ -48,6 +48,9 @@ export const automationRules = table("automation_rules", {
   id: text("id").primaryKey(),
   ownerEmail: text("owner_email").notNull(),
   domain: text("domain").notNull(), // "mail" | "calendar"
+  kind: text("kind", { enum: ["automation", "ai-filter"] })
+    .notNull()
+    .default("automation"),
   name: text("name").notNull(),
   condition: text("condition").notNull(), // natural language condition
   actions: text("actions").notNull(), // JSON array of AutomationAction

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

@@ -9,7 +9,10 @@ import {
 import { readBody, getSession } from "@agent-native/core/server";
 import { getAppProductionUrl } from "@agent-native/core/server";
 import { getUserSetting, putUserSetting } from "@agent-native/core/settings";
-import { mailLabelMatches } from "@shared/gmail-labels.js";
+import {
+  isInboxScopedAppLabel,
+  mailLabelMatches,
+} from "@shared/gmail-labels.js";
 import { markdownPreviewSnippet } from "@shared/markdown.js";
 import { emailMessageMatchesSearch } from "@shared/search.js";
 import type { EmailMessage, Label, UserSettings } from "@shared/types.js";
@@ -36,7 +39,10 @@ import {
   persistTracking,
   type TrackingContext,
 } from "../lib/email-tracking.js";
-import { filterInboxScopedThreadMessages } from "../lib/gmail-query.js";
+import {
+  filterInboxScopedThreadMessages,
+  filterLabelMessages,
+} from "../lib/gmail-query.js";
 import {
   createOAuth2Client,
   gmailGetMessage,
@@ -182,11 +188,7 @@ async function getAccessToken(accountEmail: string): Promise<string | null> {
     try {
       const { clientId, clientSecret } =
         await getOAuth2Credentials(accountEmail);
-      const oauth = createOAuth2Client(
-        clientId,
-        clientSecret,
-        "http://localhost:8080/_agent-native/google/callback",
-      );
+      const oauth = createOAuth2Client(clientId, clientSecret, "");
       const refreshed = await oauth.refreshToken(tokens.refresh_token);
       const updated = {
         ...tokens,
@@ -217,8 +219,14 @@ async function getAccessToken(accountEmail: string): Promise<string | null> {
  */
 async function getAccountTokens(
   forEmail: string,
+  requestedAccountEmails?: readonly string[],
 ): Promise<Array<{ email: string; accessToken: string }>> {
-  const accounts = await listOAuthAccountsByOwner("google", forEmail);
+  const requested = requestedAccountEmails
+    ? new Set(requestedAccountEmails.map((account) => account.toLowerCase()))
+    : undefined;
+  const accounts = (await listOAuthAccountsByOwner("google", forEmail)).filter(
+    (account) => !requested || requested.has(account.accountId.toLowerCase()),
+  );
 
   const results: Array<{ email: string; accessToken: string }> = [];
 
@@ -354,8 +362,12 @@ function recomputeUnreadCounts(
   labels: Label[],
 ): Label[] {
   return labels.map((label) => {
+    const inboxScoped = label.id === "inbox" || isInboxScopedAppLabel(label.id);
     const active = emails.filter(
-      (e) => !e.isArchived && !e.isTrashed && e.labelIds.includes(label.id),
+      (e) =>
+        !e.isTrashed &&
+        (!inboxScoped || !e.isArchived) &&
+        e.labelIds.includes(label.id),
     );
     const unread = active.filter((e) => !e.isRead).length;
     return { ...label, unreadCount: unread, totalCount: active.length };
@@ -522,6 +534,7 @@ export const listEmails = defineEventHandler(async (event: H3Event) => {
         emails = emails.filter((e) => e.isTrashed);
         break;
       case "all":
+        if (label) emails = filterLabelMessages(emails, label);
         break;
       default:
         // label: prefixed or raw label id
@@ -1731,7 +1744,14 @@ export const listLabels = defineEventHandler(async (_event: H3Event) => {
   const email = await userEmail(_event);
   if (await isConnected(email)) {
     try {
-      const accountTokens = await getAccountTokens(email);
+      const { accountEmails: accountEmailsQuery } = getQuery(_event) as {
+        accountEmails?: string;
+      };
+      const accountEmails = accountEmailsQuery
+        ?.split(",")
+        .map((account) => account.trim())
+        .filter(Boolean);
+      const accountTokens = await getAccountTokens(email, accountEmails);
       // Deduplicate by derived short-name id (not Gmail label ID)
       const labelMap = new Map<
         string,
@@ -1848,7 +1868,10 @@ export const listLabels = defineEventHandler(async (_event: H3Event) => {
       return { error: "Unable to load Gmail labels. Please retry." };
     }
   }
-  return readLabels(email);
+  return recomputeUnreadCounts(
+    await readEmails(email),
+    await readLabels(email),
+  );
 });
 
 // ─── Calendar RSVP ───────────────────────────────────────────────────────────

package/corpus/templates/mail/server/handlers/google-auth.ts

@@ -188,7 +188,7 @@ export const getGoogleAuthUrl = defineEventHandler(async (event: H3Event) => {
       }
     }
     const requestedReturn =
-      typeof q.return === "string" ? safeReturnPath(q.return) : "/";
+      typeof q.return === "string" ? safeReturnPath(q.return) : "/home";
     const returnUrl = requestedReturn !== "/" ? requestedReturn : undefined;
     // Use the named-arg overload — the positional form smuggled `flowId`
     // into the `returnUrl` slot in earlier revisions, which broke desktop

package/corpus/templates/mail/server/lib/ai-filter.ts

@@ -0,0 +1,103 @@
+import { getUserSetting, putUserSetting } from "@agent-native/core/settings";
+import { nanoid } from "nanoid";
+
+import {
+  aiFilterStateSchema,
+  createDefaultAiFilterState,
+  type AiFilterDecision,
+  type AiFilterFeedback,
+  type AiFilterState,
+  type AiFilterTarget,
+} from "../../shared/ai-filter.js";
+
+const AI_FILTER_SETTING_KEY = "ai-filter-state";
+const MAX_FEEDBACK = 100;
+const MAX_DECISIONS = 200;
+
+export async function getAiFilterState(
+  ownerEmail: string,
+): Promise<AiFilterState> {
+  const stored = await getUserSetting(ownerEmail, AI_FILTER_SETTING_KEY);
+  if (stored === undefined || stored === null) {
+    return createDefaultAiFilterState();
+  }
+
+  const parsed = aiFilterStateSchema.safeParse(stored);
+  if (!parsed.success) {
+    throw new Error(
+      "AI filter settings are unreadable; reset them in Mail settings.",
+    );
+  }
+  return parsed.data;
+}
+
+export async function saveAiFilterState(
+  ownerEmail: string,
+  state: AiFilterState,
+): Promise<AiFilterState> {
+  const parsed = aiFilterStateSchema.safeParse(state);
+  if (!parsed.success) {
+    throw new Error("Invalid AI filter settings.");
+  }
+  await putUserSetting(ownerEmail, AI_FILTER_SETTING_KEY, parsed.data);
+  return parsed.data;
+}
+
+function bounded(value: string | undefined, max: number): string {
+  return (value ?? "").slice(0, max);
+}
+
+export async function recordAiFilterFeedback(
+  ownerEmail: string,
+  input: {
+    targets: AiFilterTarget[];
+    disposition: "spam" | "not_spam";
+    comment?: string;
+  },
+): Promise<AiFilterState> {
+  const state = await getAiFilterState(ownerEmail);
+  const now = Date.now();
+  const comment = input.comment?.trim()
+    ? bounded(input.comment.trim(), 500)
+    : undefined;
+  const feedback: AiFilterFeedback[] = input.targets.map((target) => ({
+    id: nanoid(12),
+    disposition: input.disposition,
+    sender: bounded(target.sender, 320),
+    subject: bounded(target.subject, 500),
+    ...(comment ? { comment } : {}),
+    createdAt: now,
+  }));
+  const decisions: AiFilterDecision[] = input.targets.map((target) => ({
+    id: nanoid(12),
+    messageId: target.id,
+    ...(target.threadId ? { threadId: target.threadId } : {}),
+    ...(target.accountEmail ? { accountEmail: target.accountEmail } : {}),
+    sender: bounded(target.sender, 320),
+    subject: bounded(target.subject, 500),
+    disposition: input.disposition === "spam" ? "filtered" : "kept",
+    source: "manual",
+    ...(comment ? { reason: comment } : {}),
+    createdAt: now,
+  }));
+
+  // ponytail: a capped settings ledger keeps this MVP small; move to a table
+  // when review history needs search, pagination, or concurrent writers.
+  return saveAiFilterState(ownerEmail, {
+    ...state,
+    feedback: [...state.feedback, ...feedback].slice(-MAX_FEEDBACK),
+    decisions: [...state.decisions, ...decisions].slice(-MAX_DECISIONS),
+  });
+}
+
+export async function recordAiFilterDecisions(
+  ownerEmail: string,
+  decisions: AiFilterDecision[],
+): Promise<AiFilterState> {
+  if (decisions.length === 0) return getAiFilterState(ownerEmail);
+  const state = await getAiFilterState(ownerEmail);
+  return saveAiFilterState(ownerEmail, {
+    ...state,
+    decisions: [...state.decisions, ...decisions].slice(-MAX_DECISIONS),
+  });
+}

package/corpus/templates/mail/server/lib/automation-actions.ts

@@ -38,26 +38,27 @@ export async function buildLabelCache(
 /**
  * Resolve a label name to a Gmail label ID, creating the label if needed.
  */
-async function resolveLabelId(
+export async function ensureGmailLabel(
+  accessToken: string,
   labelName: string,
-  ctx: ActionContext,
+  labelCache: Map<string, string>,
 ): Promise<string> {
   const key = labelName.toLowerCase();
-  const existing = ctx.labelCache.get(key);
+  const existing = labelCache.get(key);
   if (existing) return existing;
 
   // Create the label
   try {
-    const created = await gmailCreateLabel(ctx.accessToken, labelName);
+    const created = await gmailCreateLabel(accessToken, labelName);
     if (created.id) {
-      ctx.labelCache.set(key, created.id);
+      labelCache.set(key, created.id);
       return created.id;
     }
   } catch (err: any) {
     // Label might already exist (race condition) — try to find it
-    const refreshed = await buildLabelCache(ctx.accessToken);
-    for (const [k, v] of refreshed) ctx.labelCache.set(k, v);
-    const retryId = ctx.labelCache.get(key);
+    const refreshed = await buildLabelCache(accessToken);
+    for (const [k, v] of refreshed) labelCache.set(k, v);
+    const retryId = labelCache.get(key);
     if (retryId) return retryId;
     throw err;
   }
@@ -75,7 +76,11 @@ export async function executeAction(
   try {
     switch (action.type) {
       case "label": {
-        const labelId = await resolveLabelId(action.labelName, ctx);
+        const labelId = await ensureGmailLabel(
+          ctx.accessToken,
+          action.labelName,
+          ctx.labelCache,
+        );
         await gmailModifyMessage(ctx.accessToken, ctx.messageId, [labelId]);
         return { success: true };
       }