@agent-native/core 0.186.0 → 0.187.0-nightly-20260923203303

package/corpus/README.md

@@ -31,4 +31,4 @@ rg -n "defineAction|useActionQuery" node_modules/@agent-native/core/corpus
 
 ## Generated Counts
 
-- template files: 9796
+- template files: 9799

package/corpus/templates/clips/app/components/library/page-header.tsx

@@ -1,5 +1,3 @@
-import { useT } from "@agent-native/core/client/i18n";
-import { IconArrowLeft } from "@tabler/icons-react";
 import {
   type ComponentProps,
   createContext,
@@ -108,9 +106,8 @@ export interface PageBreadcrumbItem {
 /**
  * Collapses breadcrumb segments only as far as the available header width
  * actually requires. Segments closest to the root are hidden first, so the
- * current page and the ancestors nearest it — including the parent the back
- * button returns to — stay visible: a long path degrades to
- * "Root / … / Parent / Current" rather than hiding where "back" leads.
+ * current page and its immediate parent stay visible: a long path degrades
+ * to "Root / … / Parent / Current" rather than hiding the nearest ancestor.
  * Re-measures on resize so widening the window (or collapsing the sidebar)
  * brings hidden segments back.
  */
@@ -118,7 +115,7 @@ function useBreadcrumbOverflow(itemCount: number) {
   const listRef = useRef<HTMLOListElement>(null);
   const [hiddenCount, setHiddenCount] = useState(0);
   // Middle segments are everything strictly between the root and the
-  // current page; the parent (the one right before current) is never hidden.
+  // current page; the immediate parent is never hidden.
   const maxHidden = Math.max(0, itemCount - 2 - 1);
 
   // The path changed — start fully expanded and let the measurement below
@@ -152,18 +149,14 @@ export function PageBreadcrumb({
 }: {
   items: readonly PageBreadcrumbItem[];
 }) {
-  const t = useT();
   const { listRef, hiddenCount } = useBreadcrumbOverflow(items.length);
 
   if (items.length === 0) return null;
 
-  // The item right before the current one is one step back in the path; it
-  // only exists on a nested path, so root-level trails render no back button.
-  const parent = items[items.length - 2];
   const fullPath = items.map((item) => item.label).join(" / ");
   const collapsed = hiddenCount > 0;
   // Keep the root as an anchor, drop the segments right after it, and keep the
-  // whole tail (parent + current) so the back target stays on screen.
+  // whole tail (parent + current) visible.
   const visibleItems = collapsed
     ? [items[0], ...items.slice(1 + hiddenCount)]
     : items;
@@ -211,7 +204,7 @@ export function PageBreadcrumb({
   );
 
   // The tooltip only adds value once ancestors are actually hidden.
-  const trail = collapsed ? (
+  return collapsed ? (
     <Tooltip>
       <TooltipTrigger asChild>{breadcrumb}</TooltipTrigger>
       <TooltipContent>{fullPath}</TooltipContent>
@@ -219,29 +212,4 @@ export function PageBreadcrumb({
   ) : (
     breadcrumb
   );
-
-  if (!parent?.to) return trail;
-
-  const backLabel = t("navigation.breadcrumbBack", { label: parent.label });
-
-  return (
-    <div className="flex min-w-0 items-center gap-1">
-      <Tooltip>
-        <TooltipTrigger asChild>
-          <Button
-            asChild
-            variant="ghost"
-            size="icon"
-            className="size-7 shrink-0 text-muted-foreground"
-          >
-            <NavLink to={parent.to} aria-label={backLabel}>
-              <IconArrowLeft className="size-4" />
-            </NavLink>
-          </Button>
-        </TooltipTrigger>
-        <TooltipContent>{backLabel}</TooltipContent>
-      </Tooltip>
-      {trail}
-    </div>
-  );
 }

package/corpus/templates/clips/app/i18n/en-US.ts

@@ -80,7 +80,6 @@ const messages = {
     createFolderError: "Create failed",
     folderCreated: "Folder created",
     folderNamePlaceholder: "Folder name",
-    breadcrumbBack: "Back to {{label}}",
   },
   empty: {
     library: {

package/corpus/templates/mail/AGENTS.md

@@ -76,7 +76,7 @@ Read the relevant skill before deeper work:
 | `manage-automations` | Recurring and event-triggered automations shown in Settings. |
 | `manage-email-rules` / `trigger-automations` | Inbox automation rules. |
 | `get-ai-filter` / `apply-ai-filter` | Reversible AI filtering, feedback, and learned instructions. |
-| `get-ai-priority` | Cache Jev/Luna scores for up to 500 Inbox emails. |
+| `get-ai-priority` | Optional Jev Priority sort; requires Jev access. |
 | `respond-calendar-invite` | Accept/decline/tentative an invite. |
 | `get-mail-settings` / `update-mail-settings` / `import-gmail-signature` | Drafting preferences, including Send + Mark Done. |
 | `manage-snippets` | Saved reply snippets. |

package/corpus/templates/mail/actions/get-ai-priority.ts

@@ -1,7 +1,11 @@
 import { createHash } from "node:crypto";
 
-import { defineAction } from "@agent-native/core/action";
-import { getRequestUserEmail } from "@agent-native/core/server";
+import { defineAction, fail } from "@agent-native/core/action";
+import {
+  getJevContextCredentials,
+  getRequestUserEmail,
+  isJevEnabled,
+} from "@agent-native/core/server";
 import { z } from "zod";
 
 import {
@@ -11,10 +15,12 @@ import {
   saveAiPriorityCache,
   type AiPriorityCacheEntry,
 } from "../server/lib/ai-priority.js";
+import { previewAutomationPriority } from "../server/lib/automation-engine.js";
 import {
-  getAutomationModelSettings,
-  previewAutomationPriority,
-} from "../server/lib/automation-engine.js";
+  TYPESAFE_AUTOMATION_ENGINE,
+  TYPESAFE_AUTOMATION_MODEL,
+  type AutomationModelSettings,
+} from "../server/lib/automation-model.js";
 import { listAutomationRules } from "../server/lib/automations.js";
 import {
   AI_IMPORTANT_LABEL,
@@ -64,20 +70,30 @@ function importantRules(
 
 export default defineAction({
   description:
-    "Score up to 500 newest, non-archived Inbox emails for a cached Priority sort using the Mail Important rules. Archived, auto-archived, trashed, and non-Inbox emails are never evaluated.",
+    "Score up to 500 newest, non-archived Inbox emails with Jev for a cached Priority sort using Mail Important rules. Requires Builder Jev access or a direct Jev API key.",
   schema: z.object({
     emails: z.array(aiPriorityEmailSchema).max(AI_PRIORITY_MAX_EMAILS),
   }),
   agentTool: false,
   run: async ({ emails }) => {
     const ownerEmail = getRequestUserEmail();
-    if (!ownerEmail) throw new Error("Unauthenticated");
+    if (!ownerEmail) fail("Unauthenticated", { errorCode: "unauthenticated" });
+    const jevCredentials = await getJevContextCredentials(ownerEmail);
+    if (!(await isJevEnabled(jevCredentials))) {
+      fail("Jev is not enabled for this account.", {
+        errorCode: "jev_not_enabled",
+        statusCode: 403,
+      });
+    }
 
     const rules = importantRules(await listAutomationRules(ownerEmail));
     const instruction = rules.length
       ? rules.map((rule) => rule.condition.trim()).join("\n")
       : AI_PRIORITY_DEFAULT_INSTRUCTION;
-    const modelSettings = await getAutomationModelSettings(ownerEmail);
+    const modelSettings = {
+      engine: TYPESAFE_AUTOMATION_ENGINE,
+      model: TYPESAFE_AUTOMATION_MODEL,
+    };
     const instructionKey = hash(
       JSON.stringify({
         model: modelSettings,
@@ -108,13 +124,14 @@ export default defineAction({
     }));
     const scores = getCachedPriorityScores(cache, fingerprints, instructionKey);
     const pending = eligibleEmails.filter((email) => !scores.has(email.id));
-    let model = modelSettings;
+    let model: AutomationModelSettings = modelSettings;
 
     if (pending.length > 0) {
       const result = await previewAutomationPriority(
         pending,
         ownerEmail,
         instruction,
+        jevCredentials,
         AbortSignal.timeout(25_000),
       );
       model = result.model;

package/corpus/templates/mail/actions/get-jev-availability.ts

@@ -0,0 +1,23 @@
+import { defineAction } from "@agent-native/core/action";
+import {
+  getJevContextCredentials,
+  getRequestUserEmail,
+  isJevEnabled,
+} from "@agent-native/core/server";
+import { z } from "zod";
+
+export default defineAction({
+  description:
+    "Check whether Jev is configured for this account through Builder or a direct Jev API key.",
+  schema: z.object({}),
+  outputSchema: z.object({ configured: z.boolean() }),
+  http: { method: "GET" },
+  readOnly: true,
+  agentTool: false,
+  run: async () => {
+    const ownerEmail = getRequestUserEmail();
+    if (!ownerEmail) return { configured: false };
+    const credentials = await getJevContextCredentials(ownerEmail);
+    return { configured: await isJevEnabled(credentials) };
+  },
+});

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

@@ -1,10 +1,15 @@
-import { defineAction } from "@agent-native/core/action";
+import { defineAction, fail } from "@agent-native/core/action";
 import { writeAppStateForCurrentTab } from "@agent-native/core/application-state";
+import {
+  getJevContextCredentials,
+  getRequestUserEmail,
+  isJevEnabled,
+} from "@agent-native/core/server";
 import { z } from "zod";
 
 export default defineAction({
   description:
-    "Navigate the UI to a specific view or email thread. Writes a navigate command to application state which the UI reads and auto-deletes.",
+    "Navigate the UI to a specific view, inbox sort, or email thread. Priority sort requires Jev access. Writes a navigate command to application state which the UI reads and auto-deletes.",
   schema: z.object({
     view: z
       .string()
@@ -59,6 +64,18 @@ export default defineAction({
   }),
   http: false,
   run: async (args) => {
+    if (args.sort === "priority") {
+      const ownerEmail = getRequestUserEmail();
+      const credentials = ownerEmail
+        ? await getJevContextCredentials(ownerEmail)
+        : null;
+      if (!credentials || !(await isJevEnabled(credentials))) {
+        fail("Priority sort requires Jev to be enabled for this account.", {
+          errorCode: "jev_not_enabled",
+          statusCode: 403,
+        });
+      }
+    }
     const tab = args.tab || args.label || args.filter;
     if (
       !args.view &&

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

@@ -146,6 +146,7 @@ interface EmailListProps {
   onArchived?: (id: string) => void;
   onDraftOpen?: (email: EmailMessage) => void;
   onNavigateThread?: (threadId: string) => void;
+  showPrioritySort?: boolean;
   sortMode?: MailSortMode;
   onSortModeChange?: (mode: MailSortMode) => void;
 }
@@ -467,6 +468,7 @@ export function EmailList({
   onArchived,
   onDraftOpen,
   onNavigateThread,
+  showPrioritySort = false,
   sortMode = "newest",
   onSortModeChange,
 }: EmailListProps) {
@@ -484,7 +486,9 @@ export function EmailList({
   const searchQuery = searchParams.get("q") ?? undefined;
   const labelParam = searchParams.get("label");
   const currentSortMode: MailSortMode =
-    view === "inbox" && !searchQuery && !labelParam ? sortMode : "newest";
+    showPrioritySort && view === "inbox" && !searchQuery && !labelParam
+      ? sortMode
+      : "newest";
   const routeSearchSuffix = searchParams.toString()
     ? `?${searchParams.toString()}`
     : "";
@@ -1916,7 +1920,7 @@ export function EmailList({
     () =>
       view === "inbox" && !searchQuery && !labelParam && threads.length > 0 ? (
         <Select
-          value={sortMode}
+          value={currentSortMode}
           onValueChange={(value) => onSortModeChange?.(value as MailSortMode)}
         >
           <SelectTrigger
@@ -1929,16 +1933,21 @@ export function EmailList({
           </SelectTrigger>
           <SelectContent align="end">
             <SelectItem value="newest">{t("mail.sort.newest")}</SelectItem>
-            <SelectItem value="priority">{t("mail.sort.priority")}</SelectItem>
+            {showPrioritySort && (
+              <SelectItem value="priority">
+                {t("mail.sort.priority")}
+              </SelectItem>
+            )}
           </SelectContent>
         </Select>
       ) : null,
     [
       isPriorityPending,
       labelParam,
+      showPrioritySort,
+      currentSortMode,
       onSortModeChange,
       searchQuery,
-      sortMode,
       t,
       threads.length,
       view,

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

@@ -1,3 +1,4 @@
+import { useActionQuery } from "@agent-native/core/client/hooks";
 import { useT } from "@agent-native/core/client/i18n";
 import { normalizeDocumentTitle } from "@agent-native/core/shared";
 import { AI_PRIORITY_MAX_EMAILS, type MailSortMode } from "@shared/ai-priority";
@@ -10,6 +11,7 @@ import { inboxTabHref } from "@shared/inbox-threads";
 import type { EmailMessage } from "@shared/types";
 import { useState, useCallback, useMemo, useEffect, useRef } from "react";
 import { useParams, useNavigate, useSearchParams } from "react-router";
+import { toast } from "sonner";
 
 import { EmailList, InboxZero } from "@/components/email/EmailList";
 import { EmailThread } from "@/components/email/EmailThread";
@@ -350,6 +352,18 @@ export function InboxPage() {
     isLoading: settingsLoading,
     isError: settingsError,
   } = useSettings();
+  const jevAvailability = useActionQuery(
+    "get-jev-availability",
+    {},
+    {
+      enabled: view === "inbox" || navState.command.data?.sort === "priority",
+      staleTime: 60_000,
+      retry: 2,
+    },
+  );
+  const jevConfigured = jevAvailability.data?.configured === true;
+  const showPrioritySort =
+    jevConfigured || (jevAvailability.isError && sortMode === "priority");
   const [searchParams] = useSearchParams();
   const activeLabel = searchParams.get("label");
   const activeInboxTab = searchParams.get("tab");
@@ -442,6 +456,15 @@ export function InboxPage() {
   // `useEmails` search path non-inbox views use — the store path is only
   // for a plain /inbox with no `q`.
   const isInboxView = view === "inbox" && !searchParams.get("q");
+  useEffect(() => {
+    if (!jevAvailability.isSuccess) return;
+    if (!jevConfigured && sortMode === "priority") setSortMode("newest");
+  }, [jevAvailability.isSuccess, jevConfigured, sortMode]);
+  useEffect(() => {
+    if (jevAvailability.isError && sortMode === "priority") {
+      toast.error(t("mail.sort.priorityFailed"));
+    }
+  }, [jevAvailability.isError, sortMode, t]);
   useEffect(() => {
     if (!isInboxView || activeLabel || searchQuery) setSortMode("newest");
   }, [activeLabel, isInboxView, searchQuery]);
@@ -470,9 +493,17 @@ export function InboxPage() {
       Math.ceil(AI_PRIORITY_MAX_EMAILS / INBOX_PAGE_SIZE) - 1,
     );
     setInboxExtraPageCount(
-      isInboxView && sortMode === "priority" ? priorityExtraPages : 0,
+      showPrioritySort && isInboxView && sortMode === "priority"
+        ? priorityExtraPages
+        : 0,
     );
-  }, [activeAccounts, isInboxView, resolvedInboxTab, sortMode]);
+  }, [
+    activeAccounts,
+    isInboxView,
+    showPrioritySort,
+    resolvedInboxTab,
+    sortMode,
+  ]);
   const inboxExtraOffsets = useMemo(
     () =>
       Array.from(
@@ -828,7 +859,7 @@ export function InboxPage() {
         activeAccounts.size > 0 ? Array.from(activeAccounts) : undefined,
       selectedThreadIds:
         selectedThreadIds.length > 0 ? selectedThreadIds : undefined,
-      sort: sortMode === "priority" ? sortMode : undefined,
+      sort: sortMode === "priority" && showPrioritySort ? sortMode : undefined,
     });
   }, [
     view,
@@ -843,6 +874,8 @@ export function InboxPage() {
     activeInboxTab,
     activeAccounts,
     selectedThreadIds,
+    showPrioritySort,
+    jevAvailability.isError,
     sortMode,
   ]); // eslint-disable-line react-hooks/exhaustive-deps
 
@@ -851,6 +884,9 @@ export function InboxPage() {
   const lastCommandRef = useRef<string>("");
   useEffect(() => {
     if (!navCommand) return;
+    if (navCommand.sort === "priority" && jevAvailability.isLoading) {
+      return;
+    }
     const key = JSON.stringify(navCommand);
     if (key === lastCommandRef.current) return;
     lastCommandRef.current = key;
@@ -859,8 +895,12 @@ export function InboxPage() {
     const targetFilter = navCommand.filter;
     const targetThread = navCommand.threadId;
 
-    if (navCommand.sort === "priority" || navCommand.sort === "newest") {
-      setSortMode(navCommand.sort);
+    if (navCommand.sort === "newest") {
+      setSortMode("newest");
+    } else if (navCommand.sort === "priority") {
+      setSortMode(
+        jevAvailability.isError || jevConfigured ? "priority" : "newest",
+      );
     }
 
     if (navCommand.composeDraftId && !targetThread) {
@@ -898,7 +938,7 @@ export function InboxPage() {
 
     // Delete the command file so it doesn't re-trigger
     void navState.clearCommand();
-  }, [navCommand, view, navigate]); // eslint-disable-line react-hooks/exhaustive-deps
+  }, [navCommand, view, navigate, jevAvailability.isLoading, jevConfigured]); // eslint-disable-line react-hooks/exhaustive-deps
   // Stable-identity pattern: keep the previous array reference when the
   // content hasn't meaningfully changed. Without this, markThreadRead's
   // optimistic update (which rebuilds the emails array for a single isRead
@@ -1117,6 +1157,7 @@ export function InboxPage() {
             isFetchingNextPage={isFetchingNextPage}
             isFetchNextPageError={isFetchNextPageError}
             sortMode={sortMode}
+            showPrioritySort={showPrioritySort}
             onSortModeChange={setSortMode}
           />
         )}

package/corpus/templates/mail/changelog/2026-09-22-jev-powered-mail-rules-and-priority-sort-work-with-an-enable.md

@@ -0,0 +1,6 @@
+---
+type: improved
+date: 2026-09-22
+---
+
+Jev-powered Mail rules and Priority sort work with an enabled Builder space or your personal Jev key.

package/corpus/templates/mail/changelog/2026-09-23-preserve-priority-sort-on-availability-error.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-09-23
+---
+
+Mail keeps Priority sort selected when Jev availability is temporarily unavailable.