@agent-native/core 0.122.4 → 0.123.1

package/corpus/templates/mail/actions/get-automation-settings.ts

@@ -0,0 +1,32 @@
+import { defineAction } from "@agent-native/core";
+import { getRequestUserEmail } from "@agent-native/core/server";
+import { getSetting, getUserSetting } from "@agent-native/core/settings";
+import { z } from "zod";
+
+export default defineAction({
+  description:
+    "Read the engine and model used to evaluate inbox automation rules, falling back to the app's configured agent engine.",
+  schema: z.object({}),
+  http: { method: "GET" },
+  agentTool: false,
+  run: async () => {
+    const ownerEmail = getRequestUserEmail();
+    if (!ownerEmail) throw new Error("Unauthenticated");
+
+    const data = (await getUserSetting(ownerEmail, "automation-settings")) as {
+      engine?: string;
+      model?: string;
+    } | null;
+    const agentEngine = (await getSetting("agent-engine").catch(
+      () => null,
+    )) as {
+      engine?: string;
+      model?: string;
+    } | null;
+
+    return {
+      engine: data?.engine || agentEngine?.engine || "anthropic",
+      model: data?.model || agentEngine?.model || "claude-haiku-4-5-20251001",
+    };
+  },
+});

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

@@ -0,0 +1,18 @@
+import { defineAction } from "@agent-native/core";
+import { getRequestUserEmail } from "@agent-native/core/server";
+import { z } from "zod";
+
+import { readSettings } from "../server/lib/mail-settings.js";
+
+export default defineAction({
+  description:
+    "Read the full mail preferences object backing the Settings UI (appearance, reading, tracking, and drafting fields). Agents should use get-mail-settings for signature and writing style.",
+  schema: z.object({}),
+  http: { method: "GET" },
+  agentTool: false,
+  run: async () => {
+    const ownerEmail = getRequestUserEmail();
+    if (!ownerEmail) throw new Error("Unauthorized");
+    return readSettings(ownerEmail);
+  },
+});

package/corpus/templates/mail/actions/list-aliases.ts

@@ -0,0 +1,17 @@
+import { defineAction } from "@agent-native/core";
+import { getRequestUserEmail } from "@agent-native/core/server";
+import { z } from "zod";
+
+import { readAliases } from "../server/lib/aliases.js";
+
+export default defineAction({
+  description: "List the user's saved recipient aliases (Settings → Aliases).",
+  schema: z.object({}),
+  http: { method: "GET" },
+  agentTool: false,
+  run: async () => {
+    const ownerEmail = getRequestUserEmail();
+    if (!ownerEmail) throw new Error("Unauthenticated");
+    return readAliases(ownerEmail);
+  },
+});

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

@@ -0,0 +1,18 @@
+import { defineAction } from "@agent-native/core";
+import { getRequestUserEmail } from "@agent-native/core/server";
+import { z } from "zod";
+
+import { listAutomationRules } from "../server/lib/automations.js";
+
+export default defineAction({
+  description:
+    "List the user's inbox automation rules as structured rows for the Settings UI.",
+  schema: z.object({}),
+  http: { method: "GET" },
+  agentTool: false,
+  run: async () => {
+    const ownerEmail = getRequestUserEmail();
+    if (!ownerEmail) throw new Error("Unauthenticated");
+    return listAutomationRules(ownerEmail);
+  },
+});

package/corpus/templates/mail/actions/list-scheduled-jobs.ts

@@ -0,0 +1,18 @@
+import { defineAction } from "@agent-native/core";
+import { getRequestUserEmail } from "@agent-native/core/server";
+import { z } from "zod";
+
+import { listPendingJobs } from "../server/lib/jobs.js";
+
+export default defineAction({
+  description:
+    "List the user's pending and processing scheduled jobs (snoozes and scheduled sends).",
+  schema: z.object({}),
+  http: { method: "GET" },
+  agentTool: false,
+  run: async () => {
+    const ownerEmail = getRequestUserEmail();
+    if (!ownerEmail) throw new Error("Unauthenticated");
+    return listPendingJobs(ownerEmail);
+  },
+});

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

@@ -0,0 +1,37 @@
+import { defineAction } from "@agent-native/core";
+import { getRequestUserEmail } from "@agent-native/core/server";
+import { z } from "zod";
+
+import { readAliases, writeAliases } from "../server/lib/aliases.js";
+
+export default defineAction({
+  description:
+    "Rename a recipient alias or replace the addresses it expands to.",
+  schema: z.object({
+    id: z.string().describe("Alias id"),
+    name: z.string().optional().describe("New alias display name"),
+    emails: z
+      .array(z.string())
+      .optional()
+      .describe("Replacement list of email addresses"),
+  }),
+  http: { method: "PUT" },
+  agentTool: false,
+  run: async (args) => {
+    const ownerEmail = getRequestUserEmail();
+    if (!ownerEmail) throw new Error("Unauthenticated");
+
+    const aliases = await readAliases(ownerEmail);
+    const idx = aliases.findIndex((a) => a.id === args.id);
+    if (idx === -1) throw new Error("Alias not found");
+
+    aliases[idx] = {
+      ...aliases[idx],
+      ...(args.name !== undefined ? { name: args.name.trim() } : {}),
+      ...(args.emails !== undefined ? { emails: args.emails } : {}),
+      updatedAt: new Date().toISOString(),
+    };
+    await writeAliases(ownerEmail, aliases);
+    return aliases[idx];
+  },
+});

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

@@ -0,0 +1,33 @@
+import { defineAction } from "@agent-native/core";
+import { getRequestUserEmail } from "@agent-native/core/server";
+import { getUserSetting, putUserSetting } from "@agent-native/core/settings";
+import { z } from "zod";
+
+export default defineAction({
+  description:
+    "Set the engine and model used to evaluate inbox automation rules.",
+  schema: z.object({
+    engine: z.string().optional().describe("Agent engine id"),
+    model: z.string().optional().describe("Model id for that engine"),
+  }),
+  http: { method: "PUT" },
+  agentTool: false,
+  run: async (args) => {
+    const ownerEmail = getRequestUserEmail();
+    if (!ownerEmail) throw new Error("Unauthenticated");
+
+    const existing =
+      ((await getUserSetting(ownerEmail, "automation-settings")) as {
+        engine?: string;
+        model?: string;
+      } | null) || {};
+    const updated = {
+      ...existing,
+      ...(args.engine ? { engine: args.engine } : {}),
+      ...(args.model ? { model: args.model } : {}),
+    };
+    await putUserSetting(ownerEmail, "automation-settings", updated);
+
+    return { success: true, engine: updated.engine, model: updated.model };
+  },
+});

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

@@ -0,0 +1,33 @@
+import { defineAction } from "@agent-native/core";
+import { getRequestUserEmail } from "@agent-native/core/server";
+import { z } from "zod";
+
+import { updateAutomationRule } from "../server/lib/automations.js";
+import { automationActionSchema } from "../shared/automation-schema.js";
+
+export default defineAction({
+  description:
+    "Update an inbox automation rule from the Settings UI. Only the supplied fields change.",
+  schema: z.object({
+    id: z.string().describe("Rule id"),
+    name: z.string().optional().describe("Rule name"),
+    condition: z
+      .string()
+      .optional()
+      .describe("Natural-language match condition"),
+    actions: z
+      .array(automationActionSchema)
+      .optional()
+      .describe("Replacement action list"),
+    enabled: z.boolean().optional().describe("Whether the rule is enabled"),
+    domain: z.enum(["mail", "calendar"]).optional().describe("Rule domain"),
+  }),
+  http: { method: "PUT" },
+  agentTool: false,
+  run: async ({ id, ...patch }) => {
+    const ownerEmail = getRequestUserEmail();
+    if (!ownerEmail) throw new Error("Unauthenticated");
+    if (!id) throw new Error("id is required");
+    return updateAutomationRule(ownerEmail, id, patch);
+  },
+});

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

@@ -0,0 +1,68 @@
+import { defineAction } from "@agent-native/core";
+import { getRequestUserEmail } from "@agent-native/core/server";
+import { putUserSetting } from "@agent-native/core/settings";
+import { z } from "zod";
+
+import { mergeSettings, readSettings } from "../server/lib/mail-settings.js";
+import type { UserSettings } from "../shared/types.js";
+
+const mobileActionId = z.enum([
+  "archive",
+  "trash",
+  "star",
+  "reply",
+  "replyAll",
+  "forward",
+  "markUnread",
+  "prev",
+  "next",
+]);
+
+const patchSchema = z.object({
+  name: z.string().optional(),
+  email: z.string().optional(),
+  avatar: z.string().optional(),
+  signature: z.string().optional(),
+  writingStyle: z.string().optional(),
+  theme: z.enum(["light", "dark", "system"]).optional(),
+  density: z.enum(["compact", "comfortable", "spacious"]).optional(),
+  previewPane: z.enum(["right", "bottom", "off"]).optional(),
+  sendAndArchive: z.boolean().optional(),
+  undoSendDelay: z.coerce.number().optional(),
+  pinnedLabels: z.array(z.string()).optional(),
+  labelAliases: z.record(z.string(), z.string()).optional(),
+  imagePolicy: z.enum(["show", "block-trackers", "block-all"]).optional(),
+  trustedSenders: z.array(z.string()).optional(),
+  mobileActions: z.array(mobileActionId).optional(),
+  tracking: z.object({ opens: z.boolean(), clicks: z.boolean() }).optional(),
+  requestSource: z
+    .string()
+    .min(1)
+    .max(256)
+    .optional()
+    .describe("Stable browser tab id used to suppress the caller's own echo"),
+});
+
+export default defineAction({
+  description:
+    "Update the mail preferences backing the Settings UI. Only the supplied fields change. Agents should use update-mail-settings for signature and writing style.",
+  schema: patchSchema,
+  http: { method: "PUT" },
+  agentTool: false,
+  run: async (args) => {
+    const ownerEmail = getRequestUserEmail();
+    if (!ownerEmail) throw new Error("Unauthorized");
+
+    const { requestSource, ...patch } = args;
+    const current = await readSettings(ownerEmail);
+    const updated = mergeSettings(current, patch as Partial<UserSettings>);
+
+    await putUserSetting(
+      ownerEmail,
+      "mail-settings",
+      updated as unknown as Record<string, unknown>,
+      { requestSource },
+    );
+    return updated;
+  },
+});

package/corpus/templates/mail/actions/update-scheduled-job.ts

@@ -0,0 +1,25 @@
+import { defineAction } from "@agent-native/core";
+import { getRequestUserEmail } from "@agent-native/core/server";
+import { z } from "zod";
+
+import { updateScheduledJobForOwner } from "../server/lib/jobs.js";
+
+export default defineAction({
+  description:
+    "Reschedule a pending scheduled job by updating its future run timestamp.",
+  schema: z.object({
+    id: z.string().describe("Scheduled job ID"),
+    runAt: z.coerce.number().describe("New future epoch-millisecond run time"),
+  }),
+  agentTool: false,
+  run: async ({ id, runAt }) => {
+    const ownerEmail = getRequestUserEmail();
+    if (!ownerEmail) throw new Error("Unauthenticated");
+    if (!Number.isFinite(runAt) || runAt <= Date.now()) {
+      throw new Error("runAt must be a future timestamp");
+    }
+    const job = await updateScheduledJobForOwner(ownerEmail, id, runAt);
+    if (!job) throw new Error("Scheduled job not found");
+    return job;
+  },
+});

package/corpus/templates/mail/app/entry.client.tsx

@@ -1,7 +1,10 @@
 import { appBasePath } from "@agent-native/core/client/api-path";
+import { installRouteChunkRecovery } from "@agent-native/core/client/route-chunk-recovery";
 import { hydrateRoot } from "react-dom/client";
 import { HydratedRouter } from "react-router/dom";
 
+installRouteChunkRecovery();
+
 const basePath = appBasePath();
 const pathname = window.location.pathname;
 const routerBasePath =

package/corpus/templates/mail/app/hooks/use-aliases.ts

@@ -1,28 +1,11 @@
-import { appApiPath } from "@agent-native/core/client/api-path";
+import { callAction } from "@agent-native/core/client/hooks";
 import type { Alias } from "@shared/types";
 import { useQuery, useMutation, useQueryClient } from "@tanstack/react-query";
 
-import { TAB_ID } from "@/lib/tab-id";
-
-async function apiFetch<T>(url: string, options?: RequestInit): Promise<T> {
-  const res = await fetch(appApiPath(url), {
-    headers: {
-      "Content-Type": "application/json",
-      "X-Request-Source": TAB_ID,
-    },
-    ...options,
-  });
-  if (!res.ok) {
-    const body = await res.json().catch(() => null);
-    throw new Error(body?.error || `Request failed (${res.status})`);
-  }
-  return res.json();
-}
-
 export function useAliases() {
   return useQuery<Alias[]>({
     queryKey: ["aliases"],
-    queryFn: () => apiFetch("/api/aliases"),
+    queryFn: () => callAction("list-aliases", {}, { method: "GET" }),
     staleTime: 60_000,
   });
 }
@@ -31,10 +14,7 @@ export function useCreateAlias() {
   const qc = useQueryClient();
   return useMutation({
     mutationFn: (data: { name: string; emails: string[] }) =>
-      apiFetch<Alias>("/api/aliases", {
-        method: "POST",
-        body: JSON.stringify(data),
-      }),
+      callAction("create-alias", data),
     onSuccess: () => qc.invalidateQueries({ queryKey: ["aliases"] }),
   });
 }
@@ -42,18 +22,8 @@ export function useCreateAlias() {
 export function useUpdateAlias() {
   const qc = useQueryClient();
   return useMutation({
-    mutationFn: ({
-      id,
-      ...data
-    }: {
-      id: string;
-      name?: string;
-      emails?: string[];
-    }) =>
-      apiFetch<Alias>(`/api/aliases/${id}`, {
-        method: "PATCH",
-        body: JSON.stringify(data),
-      }),
+    mutationFn: (data: { id: string; name?: string; emails?: string[] }) =>
+      callAction("update-alias", data, { method: "PUT" }),
     onSuccess: () => qc.invalidateQueries({ queryKey: ["aliases"] }),
   });
 }
@@ -62,7 +32,7 @@ export function useDeleteAlias() {
   const qc = useQueryClient();
   return useMutation({
     mutationFn: (id: string) =>
-      apiFetch<void>(`/api/aliases/${id}`, { method: "DELETE" }),
+      callAction("delete-alias", { id }, { method: "DELETE" }),
     onSuccess: () => qc.invalidateQueries({ queryKey: ["aliases"] }),
   });
 }

package/corpus/templates/mail/app/hooks/use-automations.ts

@@ -1,4 +1,5 @@
 import { appApiPath } from "@agent-native/core/client/api-path";
+import { callAction } from "@agent-native/core/client/hooks";
 import type { AutomationRule, AutomationAction } from "@shared/types";
 import { useQuery, useMutation, useQueryClient } from "@tanstack/react-query";
 
@@ -22,7 +23,7 @@ async function apiFetch<T>(url: string, options?: RequestInit): Promise<T> {
 export function useAutomations() {
   return useQuery<AutomationRule[]>({
     queryKey: ["automations"],
-    queryFn: () => apiFetch("/api/automations"),
+    queryFn: () => callAction("list-automations", {}, { method: "GET" }),
     staleTime: 60_000,
   });
 }
@@ -34,12 +35,8 @@ export function useCreateAutomation() {
       name: string;
       condition: string;
       actions: AutomationAction[];
-      domain?: string;
-    }) =>
-      apiFetch<AutomationRule>("/api/automations", {
-        method: "POST",
-        body: JSON.stringify(data),
-      }),
+      domain?: AutomationRule["domain"];
+    }) => callAction("create-automation", data) as Promise<AutomationRule>,
     onSuccess: () => qc.invalidateQueries({ queryKey: ["automations"] }),
   });
 }
@@ -47,20 +44,16 @@ export function useCreateAutomation() {
 export function useUpdateAutomation() {
   const qc = useQueryClient();
   return useMutation({
-    mutationFn: ({
-      id,
-      ...data
-    }: {
+    mutationFn: (data: {
       id: string;
       name?: string;
       condition?: string;
       actions?: AutomationAction[];
       enabled?: boolean;
     }) =>
-      apiFetch<AutomationRule>(`/api/automations/${id}`, {
-        method: "PATCH",
-        body: JSON.stringify(data),
-      }),
+      callAction("update-automation", data, {
+        method: "PUT",
+      }) as Promise<AutomationRule>,
     onMutate: async ({ id, ...data }) => {
       await qc.cancelQueries({ queryKey: ["automations"] });
       const previous = qc.getQueryData<AutomationRule[]>(["automations"]);
@@ -89,7 +82,7 @@ export function useDeleteAutomation() {
   const qc = useQueryClient();
   return useMutation({
     mutationFn: (id: string) =>
-      apiFetch<void>(`/api/automations/${id}`, { method: "DELETE" }),
+      callAction("delete-automation", { id }, { method: "DELETE" }),
     onSuccess: () => qc.invalidateQueries({ queryKey: ["automations"] }),
   });
 }

package/corpus/templates/mail/app/hooks/use-emails.ts

@@ -1465,7 +1465,7 @@ export function useLabels() {
 export function useSettings() {
   return useQuery<UserSettings>({
     queryKey: ["settings"],
-    queryFn: () => apiFetch("/api/settings"),
+    queryFn: () => callAction("get-mail-preferences", {}, { method: "GET" }),
     staleTime: 60_000,
   });
 }
@@ -1474,10 +1474,11 @@ export function useUpdateSettings() {
   const qc = useQueryClient();
   return useMutation({
     mutationFn: (data: Partial<UserSettings>) =>
-      apiFetch("/api/settings", {
-        method: "PATCH",
-        body: JSON.stringify(data),
-      }),
+      callAction(
+        "update-mail-preferences",
+        { ...data, requestSource: TAB_ID },
+        { method: "PUT" },
+      ),
     onMutate: async (data) => {
       // Optimistic update: immediately merge into cached settings
       await qc.cancelQueries({ queryKey: ["settings"] });

package/corpus/templates/mail/app/hooks/use-scheduled-jobs.ts

@@ -37,11 +37,7 @@ function assertActionSuccess<T>(result: T): T {
 export function useScheduledJobs() {
   return useQuery<ScheduledJob[]>({
     queryKey: ["scheduled-jobs"],
-    queryFn: async () => {
-      const res = await fetch(appApiPath("/api/scheduled-jobs"));
-      if (!res.ok) throw new Error("Failed to fetch scheduled jobs");
-      return res.json();
-    },
+    queryFn: () => callAction("list-scheduled-jobs", {}, { method: "GET" }),
     refetchInterval: 30_000, // Refresh every 30s
   });
 }
@@ -49,20 +45,21 @@ export function useScheduledJobs() {
 export function useCreateScheduledJob() {
   const qc = useQueryClient();
   return useMutation({
-    mutationFn: async (data: {
+    mutationFn: (data: {
       type: "snooze" | "send_later";
       emailId?: string;
       payload?: Record<string, unknown>;
       runAt: number;
-    }) => {
-      const res = await fetch(appApiPath("/api/scheduled-jobs"), {
-        method: "POST",
-        headers: { "Content-Type": "application/json" },
-        body: JSON.stringify(data),
-      });
-      if (!res.ok) throw new Error("Failed to create job");
-      return res.json() as Promise<ScheduledJob>;
-    },
+    }) => callAction("create-scheduled-job", data) as Promise<ScheduledJob>,
+    onSuccess: () => qc.invalidateQueries({ queryKey: ["scheduled-jobs"] }),
+  });
+}
+
+export function useUpdateScheduledJob() {
+  const qc = useQueryClient();
+  return useMutation({
+    mutationFn: (data: { id: string; runAt: number }) =>
+      callAction("update-scheduled-job", data) as Promise<ScheduledJob>,
     onSuccess: () => qc.invalidateQueries({ queryKey: ["scheduled-jobs"] }),
   });
 }

package/corpus/templates/mail/app/pages/SettingsPage.tsx

@@ -1,8 +1,8 @@
 import { useChatModels } from "@agent-native/core/client/agent-chat";
 import { agentNativePath } from "@agent-native/core/client/api-path";
-import { appApiPath } from "@agent-native/core/client/api-path";
 import { ChangelogSettingsCard } from "@agent-native/core/client/changelog";
 import {
+  callAction,
   useActionMutation,
   useChangeVersions,
 } from "@agent-native/core/client/hooks";
@@ -897,9 +897,15 @@ function AutomationsSection() {
   const { data: autoSettings } = useQuery({
     queryKey: ["automation-settings", settingsSync],
     queryFn: async () => {
-      const res = await fetch(appApiPath("/api/automations/settings"));
-      if (!res.ok) return { engine: "anthropic", model: defaultModel };
-      return res.json();
+      try {
+        return await callAction(
+          "get-automation-settings",
+          {},
+          { method: "GET" },
+        );
+      } catch {
+        return { engine: "anthropic", model: defaultModel };
+      }
     },
     staleTime: 30_000,
     placeholderData: (prev) => prev,
@@ -923,11 +929,11 @@ function AutomationsSection() {
     const [engine, model] = value.split("::");
     if (!engine || !model) return;
     queryClient.setQueryData(["automation-settings"], { engine, model });
-    await fetch(appApiPath("/api/automations/settings"), {
-      method: "PUT",
-      headers: { "Content-Type": "application/json" },
-      body: JSON.stringify({ engine, model }),
-    });
+    await callAction(
+      "update-automation-settings",
+      { engine, model },
+      { method: "PUT" },
+    );
   };
 
   const handleCreate = (data: {