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

package/corpus/templates/mail/actions/manage-automations.ts

@@ -4,180 +4,185 @@ import { eq, and } from "drizzle-orm";
 import { nanoid } from "nanoid";
 import { z } from "zod";
 
-export default defineAction({
-  description:
-    "Create, list, update, or delete email automation rules. Rules are processed automatically against new inbox emails using AI.",
-  schema: z.object({
-    action: z
-      .enum(["list", "create", "update", "delete", "enable", "disable"])
-      .optional()
-      .describe("Action to perform"),
-    id: z
-      .string()
-      .optional()
-      .describe("Rule ID (for update/delete/enable/disable)"),
-    name: z.string().optional().describe("Human-readable rule name"),
-    condition: z
-      .string()
-      .optional()
-      .describe(
-        'Natural language condition, e.g. "from a newsletter" or "subject contains invoice"',
-      ),
-    actions: z
-      .string()
-      .optional()
-      .describe(
-        'JSON array of actions, e.g. [{"type":"label","labelName":"newsletters"}]. Action types: label, archive, mark_read, star, trash',
-      ),
-    enabled: z.coerce
-      .boolean()
-      .optional()
-      .describe("Whether the rule is enabled"),
-  }),
-  run: async (args) => {
-    const { action } = args;
-
-    // Lazy-import DB to avoid issues when running outside server context
-    const { db, schema } = await import("../server/db/index.js");
-
-    const ownerEmail = getRequestUserEmail();
-    if (!ownerEmail) throw new Error("no authenticated user");
-
-    switch (action) {
-      case "list": {
-        const rules = await db
-          .select()
-          .from(schema.automationRules)
-          .where(eq(schema.automationRules.ownerEmail, ownerEmail));
-
-        if (rules.length === 0) {
-          return "No automation rules configured. Create one with --action=create.";
+export const createManageEmailRulesAction = (agentTool: boolean) =>
+  defineAction({
+    description:
+      "Create, list, update, or delete email automation rules. Rules are processed automatically against new inbox emails using AI.",
+    agentTool,
+    schema: z.object({
+      action: z
+        .enum(["list", "create", "update", "delete", "enable", "disable"])
+        .optional()
+        .describe("Action to perform"),
+      id: z
+        .string()
+        .optional()
+        .describe("Rule ID (for update/delete/enable/disable)"),
+      name: z.string().optional().describe("Human-readable rule name"),
+      condition: z
+        .string()
+        .optional()
+        .describe(
+          'Natural language condition, e.g. "from a newsletter" or "subject contains invoice"',
+        ),
+      actions: z
+        .string()
+        .optional()
+        .describe(
+          'JSON array of actions, e.g. [{"type":"label","labelName":"newsletters"}]. Action types: label, archive, mark_read, star, trash',
+        ),
+      enabled: z.coerce
+        .boolean()
+        .optional()
+        .describe("Whether the rule is enabled"),
+    }),
+    run: async (args) => {
+      const { action } = args;
+
+      // Lazy-import DB to avoid issues when running outside server context
+      const { db, schema } = await import("../server/db/index.js");
+
+      const ownerEmail = getRequestUserEmail();
+      if (!ownerEmail) throw new Error("no authenticated user");
+
+      switch (action) {
+        case "list": {
+          const rules = await db
+            .select()
+            .from(schema.automationRules)
+            .where(eq(schema.automationRules.ownerEmail, ownerEmail));
+
+          if (rules.length === 0) {
+            return "No automation rules configured. Create one with --action=create.";
+          }
+
+          return rules
+            .map((r: any) => {
+              const actions = JSON.parse(r.actions);
+              const actionStr = actions
+                .map((a: any) =>
+                  a.type === "label" ? `label:"${a.labelName}"` : a.type,
+                )
+                .join(", ");
+              return `[${r.id}] ${r.enabled ? "✓" : "✗"} "${r.name}" — ${r.condition} → ${actionStr}`;
+            })
+            .join("\n");
         }
 
-        return rules
-          .map((r: any) => {
-            const actions = JSON.parse(r.actions);
-            const actionStr = actions
-              .map((a: any) =>
-                a.type === "label" ? `label:"${a.labelName}"` : a.type,
-              )
-              .join(", ");
-            return `[${r.id}] ${r.enabled ? "✓" : "✗"} "${r.name}" — ${r.condition} → ${actionStr}`;
-          })
-          .join("\n");
-      }
+        case "create": {
+          if (!args.name || !args.condition || !args.actions) {
+            throw new Error(
+              "--name, --condition, and --actions are required for create",
+            );
+          }
 
-      case "create": {
-        if (!args.name || !args.condition || !args.actions) {
-          throw new Error(
-            "--name, --condition, and --actions are required for create",
-          );
+          let actions;
+          try {
+            actions = JSON.parse(args.actions);
+          } catch {
+            throw new Error("--actions must be valid JSON array");
+          }
+
+          const now = Date.now();
+          const rule = {
+            id: nanoid(12),
+            ownerEmail,
+            domain: "mail",
+            name: args.name,
+            condition: args.condition,
+            actions: JSON.stringify(actions),
+            enabled: 1,
+            createdAt: now,
+            updatedAt: now,
+          };
+
+          await db.insert(schema.automationRules).values(rule as any);
+          return `Created automation rule "${args.name}" (${rule.id})`;
         }
 
-        let actions;
-        try {
-          actions = JSON.parse(args.actions);
-        } catch {
-          throw new Error("--actions must be valid JSON array");
+        case "update": {
+          if (!args.id) throw new Error("--id is required for update");
+
+          const updates: Record<string, any> = { updatedAt: Date.now() };
+          if (args.name !== undefined) updates.name = args.name;
+          if (args.condition !== undefined) updates.condition = args.condition;
+          if (args.actions !== undefined) {
+            try {
+              JSON.parse(args.actions);
+              updates.actions = args.actions;
+            } catch {
+              throw new Error("--actions must be valid JSON array");
+            }
+          }
+          if (args.enabled !== undefined)
+            updates.enabled = args.enabled ? 1 : 0;
+
+          await db
+            .update(schema.automationRules)
+            .set(updates)
+            .where(
+              and(
+                eq(schema.automationRules.id, args.id),
+                eq(schema.automationRules.ownerEmail, ownerEmail),
+              ),
+            );
+
+          return `Updated automation rule ${args.id}`;
         }
 
-        const now = Date.now();
-        const rule = {
-          id: nanoid(12),
-          ownerEmail,
-          domain: "mail",
-          name: args.name,
-          condition: args.condition,
-          actions: JSON.stringify(actions),
-          enabled: 1,
-          createdAt: now,
-          updatedAt: now,
-        };
-
-        await db.insert(schema.automationRules).values(rule as any);
-        return `Created automation rule "${args.name}" (${rule.id})`;
-      }
+        case "delete": {
+          if (!args.id) throw new Error("--id is required for delete");
 
-      case "update": {
-        if (!args.id) throw new Error("--id is required for update");
+          await db
+            .delete(schema.automationRules)
+            .where(
+              and(
+                eq(schema.automationRules.id, args.id),
+                eq(schema.automationRules.ownerEmail, ownerEmail),
+              ),
+            );
 
-        const updates: Record<string, any> = { updatedAt: Date.now() };
-        if (args.name !== undefined) updates.name = args.name;
-        if (args.condition !== undefined) updates.condition = args.condition;
-        if (args.actions !== undefined) {
-          try {
-            JSON.parse(args.actions);
-            updates.actions = args.actions;
-          } catch {
-            throw new Error("--actions must be valid JSON array");
-          }
+          return `Deleted automation rule ${args.id}`;
         }
-        if (args.enabled !== undefined) updates.enabled = args.enabled ? 1 : 0;
-
-        await db
-          .update(schema.automationRules)
-          .set(updates)
-          .where(
-            and(
-              eq(schema.automationRules.id, args.id),
-              eq(schema.automationRules.ownerEmail, ownerEmail),
-            ),
-          );
 
-        return `Updated automation rule ${args.id}`;
-      }
+        case "enable": {
+          if (!args.id) throw new Error("--id is required for enable");
 
-      case "delete": {
-        if (!args.id) throw new Error("--id is required for delete");
+          await db
+            .update(schema.automationRules)
+            .set({ enabled: 1, updatedAt: Date.now() } as any)
+            .where(
+              and(
+                eq(schema.automationRules.id, args.id),
+                eq(schema.automationRules.ownerEmail, ownerEmail),
+              ),
+            );
 
-        await db
-          .delete(schema.automationRules)
-          .where(
-            and(
-              eq(schema.automationRules.id, args.id),
-              eq(schema.automationRules.ownerEmail, ownerEmail),
-            ),
-          );
+          return `Enabled automation rule ${args.id}`;
+        }
 
-        return `Deleted automation rule ${args.id}`;
-      }
+        case "disable": {
+          if (!args.id) throw new Error("--id is required for disable");
 
-      case "enable": {
-        if (!args.id) throw new Error("--id is required for enable");
-
-        await db
-          .update(schema.automationRules)
-          .set({ enabled: 1, updatedAt: Date.now() } as any)
-          .where(
-            and(
-              eq(schema.automationRules.id, args.id),
-              eq(schema.automationRules.ownerEmail, ownerEmail),
-            ),
-          );
+          await db
+            .update(schema.automationRules)
+            .set({ enabled: 0, updatedAt: Date.now() } as any)
+            .where(
+              and(
+                eq(schema.automationRules.id, args.id),
+                eq(schema.automationRules.ownerEmail, ownerEmail),
+              ),
+            );
 
-        return `Enabled automation rule ${args.id}`;
-      }
+          return `Disabled automation rule ${args.id}`;
+        }
 
-      case "disable": {
-        if (!args.id) throw new Error("--id is required for disable");
-
-        await db
-          .update(schema.automationRules)
-          .set({ enabled: 0, updatedAt: Date.now() } as any)
-          .where(
-            and(
-              eq(schema.automationRules.id, args.id),
-              eq(schema.automationRules.ownerEmail, ownerEmail),
-            ),
+        default:
+          throw new Error(
+            `Unknown action "${action}". Use: list, create, update, delete, enable, disable`,
           );
-
-        return `Disabled automation rule ${args.id}`;
       }
+    },
+  });
 
-      default:
-        throw new Error(
-          `Unknown action "${action}". Use: list, create, update, delete, enable, disable`,
-        );
-    }
-  },
-});
+export default createManageEmailRulesAction(false);

package/corpus/templates/mail/actions/manage-email-rules.ts

@@ -0,0 +1,3 @@
+import { createManageEmailRulesAction } from "./manage-automations.js";
+
+export default createManageEmailRulesAction(true);

package/corpus/templates/mail/actions/navigate.ts

@@ -17,7 +17,7 @@ export default defineAction({
       .string()
       .optional()
       .describe(
-        "Settings section to open, such as drafting, automations, gmail-filters, aliases, tracking, slack, or team",
+        "Settings section to open, such as drafting, automations, ai-filter, gmail-filters, aliases, tracking, slack, or team",
       ),
     queuedDraftId: z
       .string()

package/corpus/templates/mail/actions/update-automation.ts

@@ -21,6 +21,7 @@ export default defineAction({
       .describe("Replacement action list"),
     enabled: z.boolean().optional().describe("Whether the rule is enabled"),
     domain: z.enum(["mail", "calendar"]).optional().describe("Rule domain"),
+    kind: z.enum(["automation", "ai-filter"]).optional().describe("Rule kind"),
   }),
   http: { method: "PUT" },
   agentTool: false,

package/corpus/templates/mail/actions/update-mail-preferences.ts

@@ -12,6 +12,7 @@ import type { UserSettings } from "../shared/types.js";
 
 const mobileActionId = z.enum([
   "archive",
+  "aiFilter",
   "trash",
   "star",
   "reply",

package/corpus/templates/mail/app/components/email/AiFilterDialog.tsx

@@ -0,0 +1,127 @@
+import { useT } from "@agent-native/core/client/i18n";
+import type { AiFilterTarget } from "@shared/ai-filter";
+import { IconFilter, IconInbox, IconLoader2 } from "@tabler/icons-react";
+import { useEffect, useState } from "react";
+import { toast } from "sonner";
+
+import { Button } from "@/components/ui/button";
+import {
+  Dialog,
+  DialogContent,
+  DialogFooter,
+  DialogHeader,
+  DialogTitle,
+} from "@/components/ui/dialog";
+import { Textarea } from "@/components/ui/textarea";
+import { useManageAiFilter } from "@/hooks/use-ai-filter";
+
+export function AiFilterDialog({
+  open,
+  onOpenChange,
+  action,
+  targets,
+  onComplete,
+}: {
+  open: boolean;
+  onOpenChange: (open: boolean) => void;
+  action: "filter" | "keep";
+  targets: AiFilterTarget[];
+  onComplete?: () => void;
+}) {
+  const t = useT();
+  const manageAiFilter = useManageAiFilter();
+  const [comment, setComment] = useState("");
+  const isFilter = action === "filter";
+
+  useEffect(() => {
+    if (open) setComment("");
+  }, [open, action]);
+
+  const handleSubmit = () => {
+    if (targets.length === 0 || manageAiFilter.isPending) return;
+    manageAiFilter.mutate(
+      {
+        mode: action,
+        targets,
+        ...(comment.trim() ? { comment: comment.trim() } : {}),
+      },
+      {
+        onSuccess: () => {
+          toast(
+            isFilter
+              ? t("mail.aiFilter.filteredToast", { count: targets.length })
+              : t("mail.aiFilter.keptToast", { count: targets.length }),
+          );
+          onComplete?.();
+          onOpenChange(false);
+        },
+        onError: (error) =>
+          toast.error(
+            error instanceof Error
+              ? error.message
+              : t("mail.aiFilter.actionFailed"),
+          ),
+      },
+    );
+  };
+
+  return (
+    <Dialog open={open} onOpenChange={onOpenChange}>
+      <DialogContent className="sm:max-w-[480px]">
+        <DialogHeader>
+          <DialogTitle className="flex items-center gap-2">
+            {isFilter ? (
+              <IconFilter className="size-4 text-primary" />
+            ) : (
+              <IconInbox className="size-4 text-primary" />
+            )}
+            {isFilter
+              ? t("mail.aiFilter.filterTitle")
+              : t("mail.aiFilter.keepTitle")}
+          </DialogTitle>
+        </DialogHeader>
+
+        <div className="py-2">
+          <div>
+            <label htmlFor="ai-filter-comment" className="sr-only">
+              {isFilter
+                ? t("mail.aiFilter.rememberLabel")
+                : t("mail.aiFilter.correctLabel")}
+            </label>
+            <Textarea
+              id="ai-filter-comment"
+              value={comment}
+              onChange={(event) => setComment(event.target.value)}
+              placeholder={
+                isFilter
+                  ? t("mail.aiFilter.rememberPlaceholder")
+                  : t("mail.aiFilter.correctPlaceholder")
+              }
+              rows={2}
+              className="resize-none text-sm"
+              maxLength={500}
+            />
+          </div>
+        </div>
+
+        <DialogFooter>
+          <Button
+            variant="ghost"
+            onClick={() => onOpenChange(false)}
+            disabled={manageAiFilter.isPending}
+          >
+            {t("settings.cancel")}
+          </Button>
+          <Button onClick={handleSubmit} disabled={targets.length === 0}>
+            {manageAiFilter.isPending && (
+              <IconLoader2 className="size-4 animate-spin" />
+            )}
+            {isFilter
+              ? t("mail.aiFilter.filterButton")
+              : t("mail.aiFilter.keepButton")}
+          </Button>
+        </DialogFooter>
+      </DialogContent>
+    </Dialog>
+  );
+}

package/corpus/templates/mail/app/components/email/EmailList.tsx

@@ -1,10 +1,13 @@
 import { useT } from "@agent-native/core/client/i18n";
+import { AI_FILTER_LABEL, type AiFilterTarget } from "@shared/ai-filter";
 import type { EmailMessage } from "@shared/types";
 import {
   IconAlertCircle,
   IconArchive,
   IconDots,
+  IconFilter,
   IconFolder,
+  IconInbox,
   IconMail,
   IconMailOpened,
   IconTrash,
@@ -15,6 +18,7 @@ import { useVirtualizer } from "@tanstack/react-virtual";
 import { useState, useEffect, useRef, useCallback, useMemo } from "react";
 import { useNavigate, useParams, useSearchParams } from "react-router";
 
+import { AiFilterDialog } from "@/components/email/AiFilterDialog";
 import { GoogleConnectBanner } from "@/components/GoogleConnectBanner";
 import { useSetHeaderActions } from "@/components/layout/HeaderActions";
 import {
@@ -394,6 +398,10 @@ export function EmailList({
   const routeSearchSuffix = searchParams.toString()
     ? `?${searchParams.toString()}`
     : "";
+  const [aiFilterDialog, setAiFilterDialog] = useState<{
+    action: "filter" | "keep";
+    targets: AiFilterTarget[];
+  } | null>(null);
 
   const {
     data: fetchedEmails = [],
@@ -842,6 +850,33 @@ export function EmailList({
     [threads],
   );
 
+  const openAiFilterDialog = useCallback(
+    (action: "filter" | "keep") => {
+      const targets = resolveTargets(getActionThreadKeys()).map(
+        (thread): AiFilterTarget => {
+          const email = thread.latestMessage;
+          return {
+            id: email.id,
+            threadId: email.threadId || email.id,
+            ...(email.accountEmail && email.accountEmail !== "local"
+              ? { accountEmail: email.accountEmail }
+              : {}),
+            sender: email.from.name
+              ? `${email.from.name} <${email.from.email}>`
+              : email.from.email,
+            subject: email.subject,
+          };
+        },
+      );
+      if (targets.length === 0) {
+        toast.error(t("mail.toasts.noEmailSelected"));
+        return;
+      }
+      setAiFilterDialog({ action, targets });
+    },
+    [getActionThreadKeys, resolveTargets, t],
+  );
+
   useEffect(() => {
     const handler = (event: Event) => {
       if (threadId) return;
@@ -1464,6 +1499,26 @@ export function EmailList({
               <TooltipContent>{t("mail.selection.actions")}</TooltipContent>
             </Tooltip>
             <DropdownMenuContent align="end" className="w-56">
+              <DropdownMenuItem
+                onClick={() =>
+                  openAiFilterDialog(
+                    labelParam?.toLowerCase() === AI_FILTER_LABEL
+                      ? "keep"
+                      : "filter",
+                  )
+                }
+                className="gap-2 text-xs"
+              >
+                {labelParam?.toLowerCase() === AI_FILTER_LABEL ? (
+                  <IconInbox className="h-3.5 w-3.5" />
+                ) : (
+                  <IconFilter className="h-3.5 w-3.5" />
+                )}
+                {labelParam?.toLowerCase() === AI_FILTER_LABEL
+                  ? t("mail.aiFilter.keepButton")
+                  : t("mail.aiFilter.filterButton")}
+              </DropdownMenuItem>
+              <DropdownMenuSeparator />
               <DropdownMenuItem
                 onClick={archiveFocused}
                 className="gap-2 text-xs"
@@ -1552,6 +1607,7 @@ export function EmailList({
       selectedIds.size,
       t,
       clearSelection,
+      openAiFilterDialog,
       archiveFocused,
       markFocusedRead,
       markFocusedUnread,
@@ -1709,6 +1765,13 @@ export function EmailList({
   return (
     <div className="flex h-full flex-col" ref={containerRef}>
       <div className="flex-1 overflow-y-auto" ref={scrollParentRef}>
+        <AiFilterDialog
+          open={!!aiFilterDialog}
+          onOpenChange={(open) => !open && setAiFilterDialog(null)}
+          action={aiFilterDialog?.action ?? "filter"}
+          targets={aiFilterDialog?.targets ?? []}
+          onComplete={() => setSelectedIds(new Set())}
+        />
         <div
           style={{
             height: rowVirtualizer.getTotalSize(),