@agent-native/core 0.191.0 → 0.192.0-nightly-20260926053942

package/corpus/README.md

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

package/corpus/templates/analytics/CHANGELOG.md

@@ -16,6 +16,10 @@ time from the command menu (Cmd+K → "What's new") or from Settings.
 - Human review previews Analytics dashboards as real charts
 - Relevant metric definitions and saved dashboard examples are available with the first response so Analytics queries can reuse proven definitions and query shapes.
 
+### Fixed
+
+- Opening Settings no longer opens the chat sidebar.
+
 ## 2026-09-24
 
 ### Improved

package/corpus/templates/analytics/app/components/layout/Layout.tsx

@@ -18,13 +18,19 @@ import {
   CreativeContextComposerChip,
   useCreativeContextLab,
 } from "@agent-native/creative-context/client";
-import { useEffect, useMemo } from "react";
+import { useEffect, useMemo, useRef } from "react";
 import { useLocation, useNavigate } from "react-router";
 
 import { useNavigationState } from "@/hooks/use-navigation-state";
 import {
   ANALYTICS_CHAT_STORAGE_KEY,
+  ANALYTICS_RECENT_CHAT_HANDOFF_TTL_MS,
+  discardAnalyticsChatHandoffOnSettings,
+  hasTrackedAnalyticsChatRun,
+  isAnalyticsSettingsPath,
   markAnalyticsChatActivity,
+  updateAnalyticsChatHandoffForRun,
+  type AnalyticsChatRunningRuns,
 } from "@/lib/chat-handoff";
 import { TAB_ID } from "@/lib/tab-id";
 
@@ -164,35 +170,58 @@ function InteractiveLayout({ children }: LayoutProps) {
     location.pathname === "/monitoring" ||
     location.pathname.startsWith("/monitoring/");
   const isAskRoute = location.pathname === "/ask";
+  const isSettingsRoute = isAnalyticsSettingsPath(location.pathname);
+  const runningRuns = useRef<AnalyticsChatRunningRuns>(new Map());
   const chatHomeHandoffActive = useAgentChatHomeHandoff({
     storageKey: ANALYTICS_CHAT_STORAGE_KEY,
     activePath: location.pathname,
-    enabled: !isAskRoute,
+    ttlMs: ANALYTICS_RECENT_CHAT_HANDOFF_TTL_MS,
+    enabled: !isAskRoute && !isSettingsRoute,
   });
-  const chatHomeHandoffPending = isAgentChatHomeHandoffActive(
-    ANALYTICS_CHAT_STORAGE_KEY,
-  );
+  const chatHomeHandoffPending =
+    !isSettingsRoute &&
+    isAgentChatHomeHandoffActive(ANALYTICS_CHAT_STORAGE_KEY, {
+      ttlMs: ANALYTICS_RECENT_CHAT_HANDOFF_TTL_MS,
+    });
   useAgentChatHomeHandoffLinks({
     storageKey: ANALYTICS_CHAT_STORAGE_KEY,
     chatPath: "/ask",
+    ttlMs: ANALYTICS_RECENT_CHAT_HANDOFF_TTL_MS,
     enabled: true,
     requireActiveHandoff: true,
   });
+  useEffect(() => {
+    discardAnalyticsChatHandoffOnSettings(location.pathname);
+  }, [location.pathname]);
+  useEffect(() => {
+    if (!isAskRoute) return;
+    const refreshHandoff = () => {
+      if (!hasTrackedAnalyticsChatRun(runningRuns.current)) return;
+      markAgentChatHomeHandoff(ANALYTICS_CHAT_STORAGE_KEY);
+    };
+    refreshHandoff();
+    const interval = window.setInterval(
+      refreshHandoff,
+      ANALYTICS_RECENT_CHAT_HANDOFF_TTL_MS / 2,
+    );
+    return () => window.clearInterval(interval);
+  }, [isAskRoute]);
   useEffect(() => {
     function handleChatRunning(event: Event) {
       const detail = (event as CustomEvent).detail;
-      if (isAskRoute && typeof detail?.isRunning === "boolean") {
-        markAnalyticsChatActivity();
-        if (detail.isRunning === true) {
-          markAgentChatHomeHandoff(ANALYTICS_CHAT_STORAGE_KEY);
-        }
-      }
+      if (typeof detail?.isRunning !== "boolean") return;
+      if (location.pathname === "/ask") markAnalyticsChatActivity();
+      updateAnalyticsChatHandoffForRun(
+        runningRuns.current,
+        detail,
+        location.pathname,
+      );
     }
 
     window.addEventListener("agentNative.chatRunning", handleChatRunning);
     return () =>
       window.removeEventListener("agentNative.chatRunning", handleChatRunning);
-  }, [isAskRoute]);
+  }, [location.pathname]);
 
   function openAskAgentFullscreen() {
     focusAgentChat();

package/corpus/templates/analytics/app/lib/chat-handoff.ts

@@ -1,10 +1,72 @@
+import {
+  consumeAgentChatHomeHandoff,
+  markAgentChatHomeHandoff,
+  resolveAgentChatRunningThreadId,
+  type AgentChatRunningEventDetail,
+} from "@agent-native/core/client/agent-chat";
+
 export const ANALYTICS_CHAT_STORAGE_KEY = "analytics";
 
 export const ANALYTICS_RECENT_CHAT_HANDOFF_TTL_MS = 5 * 60 * 1000;
 
+export type AnalyticsChatRunningRuns = Map<string, Set<string>>;
+
 const ANALYTICS_LAST_CHAT_ACTIVITY_KEY =
   "agent-native.analytics.last-chat-activity-at";
 
+export function isAnalyticsSettingsPath(pathname: string): boolean {
+  return pathname === "/settings" || pathname.startsWith("/settings/");
+}
+
+export function discardAnalyticsChatHandoffOnSettings(pathname: string): void {
+  if (!isAnalyticsSettingsPath(pathname)) return;
+  consumeAgentChatHomeHandoff(ANALYTICS_CHAT_STORAGE_KEY, {
+    ttlMs: ANALYTICS_RECENT_CHAT_HANDOFF_TTL_MS,
+  });
+}
+
+export function hasTrackedAnalyticsChatRun(
+  runningRuns: AnalyticsChatRunningRuns,
+): boolean {
+  return Array.from(runningRuns.values()).some((runIds) => runIds.size > 0);
+}
+
+export function updateAnalyticsChatHandoffForRun(
+  runningRuns: AnalyticsChatRunningRuns,
+  detail: unknown,
+  pathname: string,
+): void {
+  if (!detail || typeof detail !== "object") return;
+  const run = detail as Partial<AgentChatRunningEventDetail>;
+  if (typeof run.isRunning !== "boolean") return;
+  const tabId = resolveAgentChatRunningThreadId(run);
+  if (!tabId) return;
+  const runId =
+    (typeof run.runId === "string" && run.runId) ||
+    (typeof run.turnId === "string" && run.turnId) ||
+    null;
+  const state = runningRuns.get(tabId);
+
+  if (run.isRunning) {
+    if (pathname !== "/ask") return;
+    if (runId) {
+      const next = state ?? new Set<string>();
+      next.add(runId);
+      runningRuns.set(tabId, next);
+    }
+    markAgentChatHomeHandoff(ANALYTICS_CHAT_STORAGE_KEY);
+    return;
+  }
+
+  if (!runId || !state) return;
+  const hadActiveRun = state.delete(runId);
+
+  if (state.size === 0) runningRuns.delete(tabId);
+  if (hadActiveRun && pathname === "/ask") {
+    markAgentChatHomeHandoff(ANALYTICS_CHAT_STORAGE_KEY);
+  }
+}
+
 function readAnalyticsLastChatActivityAt(): number {
   if (typeof window === "undefined") return 0;
   try {

package/corpus/templates/analytics/changelog/2026-09-25-chat-sidebar-stays-closed-in-settings.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-09-25
+---
+
+Opening Settings no longer opens the chat sidebar.

package/corpus/templates/analytics/changelog/2026-09-25-show-one-recent-prompt-per-chat-turn.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-09-25
+---
+
+Show one recent prompt per chat turn.

package/corpus/templates/clips/app/components/recorder/storage-setup-card.tsx

@@ -1,7 +1,7 @@
 import { agentNativePath, appPath } from "@agent-native/core/client/api-path";
 import { useT } from "@agent-native/core/client/i18n";
 import {
-  BuilderConnectPopover,
+  hasBuilderOAuthCredential,
   useBuilderConnectFlow,
 } from "@agent-native/core/client/settings";
 import {
@@ -12,6 +12,7 @@ import {
 } from "@tabler/icons-react";
 import { useCallback, useEffect, useRef, useState } from "react";
 
+import { Button } from "@/components/ui/button";
 import {
   Tooltip,
   TooltipContent,
@@ -168,6 +169,18 @@ export function StorageSetupCard({
     },
     [builderConnect.start],
   );
+  const handleBuilderCancel = useCallback(() => {
+    connectRequestedRef.current = false;
+    builderConnect.cancel();
+  }, [builderConnect.cancel]);
+  const hasBuilderAccount =
+    builderConnect.accountExists || hasBuilderOAuthCredential(builderConnect);
+  const provisionAccount =
+    !hasBuilderAccount &&
+    builderConnect.statusResolved &&
+    builderConnect.agentNativeProvisioningEnabled;
+  const builderConnecting = builderConnect.connecting;
+  const actionConnecting = connecting || builderConnecting;
 
   useEffect(() => {
     mountedRef.current = true;
@@ -191,14 +204,13 @@ export function StorageSetupCard({
         <p className="text-sm text-muted-foreground">{description}</p>
       </div>
 
-      {/* Builder.io — primary option, one-click Connect flow. */}
-      <BuilderConnectPopover
-        flow={builderConnect}
-        onConnect={handleBuilderConnect}
-      >
+      {/* Builder.io — primary option. */}
+      <div className="space-y-2">
         <button
           type="button"
-          disabled={connecting || connected}
+          disabled={actionConnecting || connected}
+          data-testid="storage-setup-builder-primary"
+          onClick={() => handleBuilderConnect(provisionAccount)}
           className={
             "flex items-start gap-3 rounded-xl border px-4 py-3.5 text-start transition-colors " +
             (connected
@@ -216,7 +228,7 @@ export function StorageSetupCard({
           >
             {connected ? (
               <IconCheck className="h-5 w-5" />
-            ) : connecting ? (
+            ) : actionConnecting ? (
               <IconLoader2 className="h-5 w-5 animate-spin" />
             ) : (
               <BuilderBMark className="h-5 w-5" />
@@ -227,9 +239,13 @@ export function StorageSetupCard({
               <span className="text-sm font-medium">
                 {connected
                   ? t("storageSetup.builderConnected")
-                  : connecting
+                  : actionConnecting
                     ? t("storageSetup.waitingForBuilder")
-                    : t("storageSetup.connectBuilder")}
+                    : provisionAccount
+                      ? t("storageSetup.createBuilderAccount")
+                      : hasBuilderAccount
+                        ? t("storageSetup.signInWithBuilderAccount")
+                        : t("storageSetup.connectBuilder")}
               </span>
             </div>
             <span
@@ -244,7 +260,54 @@ export function StorageSetupCard({
             </span>
           </div>
         </button>
-      </BuilderConnectPopover>
+        {provisionAccount && (
+          <button
+            type="button"
+            disabled={actionConnecting || connected}
+            data-testid="storage-setup-builder-sign-in"
+            onClick={() => handleBuilderConnect(false)}
+            className="w-full text-center text-xs text-muted-foreground underline underline-offset-4 transition-colors hover:text-foreground disabled:cursor-not-allowed disabled:opacity-60"
+          >
+            {t("storageSetup.signInWithBuilderAccount")}
+          </button>
+        )}
+      </div>
+      {builderConnecting && (
+        <Button
+          type="button"
+          variant="ghost"
+          size="sm"
+          data-testid="storage-setup-builder-cancel"
+          className="self-end text-xs font-normal text-muted-foreground"
+          onClick={handleBuilderCancel}
+        >
+          {t("common.cancel")}
+        </Button>
+      )}
+
+      {provisionAccount && (
+        <p className="text-center text-xs leading-5 text-muted-foreground">
+          {t("storageSetup.builderConsentPrefix")}{" "}
+          <a
+            href="https://www.builder.io/legal/terms"
+            target="_blank"
+            rel="noreferrer"
+            className="text-foreground underline decoration-border underline-offset-2 hover:decoration-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring"
+          >
+            {t("storageSetup.builderTerms")}
+          </a>{" "}
+          {t("storageSetup.builderConsentAnd")}{" "}
+          <a
+            href="https://www.builder.io/legal/privacy"
+            target="_blank"
+            rel="noreferrer"
+            className="text-foreground underline decoration-border underline-offset-2 hover:decoration-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring"
+          >
+            {t("storageSetup.builderPrivacy")}
+          </a>
+          .
+        </p>
+      )}
 
       {err && <p className="text-xs text-muted-foreground">{err}</p>}
 

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

@@ -1357,6 +1357,12 @@ const messages = {
     builderConnected: "Builder.io connected",
     waitingForBuilder: "Waiting for Builder...",
     connectBuilder: "Use Builder.io",
+    createBuilderAccount: "Create Builder.io account",
+    signInWithBuilderAccount: "Sign in with Builder.io account",
+    builderConsentPrefix: "By creating a Builder.io account, you agree to our",
+    builderTerms: "Terms of Service",
+    builderConsentAnd: "and",
+    builderPrivacy: "Privacy Policy",
     free: "Free",
     configureS3: "configure S3-compatible storage",
     whyPrompt: "Why am I seeing this?",

package/corpus/templates/clips/changelog/2026-09-25-one-click-builder-storage.md

@@ -0,0 +1,6 @@
+---
+type: improved
+date: 2026-09-25
+---
+
+Connect Builder storage by creating an account in one click.

package/corpus/templates/design/actions/get-design.schema.ts

@@ -0,0 +1,19 @@
+import { z } from "zod";
+
+const queryBoolean = z.union([
+  z.boolean(),
+  z.enum(["true", "false", "1", "0"]),
+]);
+
+export const getDesignSchema = z.object({
+  id: z.string().describe("Design ID"),
+  fileId: z.string().min(1).optional().describe("Read one design file by ID"),
+  includeFileContent: queryBoolean
+    .optional()
+    .transform((value) =>
+      value === undefined
+        ? undefined
+        : value === true || value === "true" || value === "1",
+    )
+    .describe("Set false to return file metadata without HTML contents"),
+});

package/corpus/templates/design/actions/get-design.ts

@@ -3,12 +3,12 @@ import { loadAgentDesignSystemContext } from "@agent-native/core/shared";
 import { resolveAccess } from "@agent-native/core/sharing";
 import { track } from "@agent-native/core/tracking";
 import { and, asc, eq } from "drizzle-orm";
-import { z } from "zod";
 
 import { getDb, schema } from "../server/db/index.js";
 import { designDataForAccessRole } from "../server/lib/design-data-access.js";
 import "../server/db/index.js"; // ensure registerShareableResource runs
 import getDesignSystem from "./get-design-system.js";
+import { getDesignSchema } from "./get-design.schema.js";
 
 // The editor re-reads get-design after saves, on sync events, and every second
 // while a generation runs. Count a signed-in viewer's view once per window,
@@ -40,14 +40,7 @@ function shouldTrackDesignView(
 export default defineAction({
   description:
     "Get a design project by ID. Returns the full design data and linked `designSystem.agentContext` when readable. By default, returns all associated files; pass `includeFileContent=false` for file metadata only, then pass a `fileId` to read just one file. Treat design-system context as authoritative before authoring or restyling.",
-  schema: z.object({
-    id: z.string().describe("Design ID"),
-    fileId: z.string().min(1).optional().describe("Read one design file by ID"),
-    includeFileContent: z
-      .boolean()
-      .optional()
-      .describe("Set false to return file metadata without HTML contents"),
-  }),
+  schema: getDesignSchema,
   readOnly: true,
   requiresAuth: false,
   publicAgent: { expose: true, readOnly: true, requiresAuth: false },
@@ -134,16 +127,20 @@ export default defineAction({
       createdAt: row.createdAt,
       updatedAt: row.updatedAt,
       accessRole: access.role,
-      files: files.map((f) => ({
-        id: f.id,
-        filename: f.filename,
-        fileType: f.fileType,
-        ...(includeFileContent === false || !("content" in f)
-          ? {}
-          : { content: f.content }),
-        createdAt: f.createdAt,
-        updatedAt: f.updatedAt,
-      })),
+      files: files.map((f) => {
+        const metadata = {
+          id: f.id,
+          filename: f.filename,
+          fileType: f.fileType,
+          createdAt: f.createdAt,
+          updatedAt: f.updatedAt,
+        };
+        if (includeFileContent === false) return metadata;
+        if (!("content" in f)) {
+          throw new Error("File content was requested but not selected");
+        }
+        return { ...metadata, content: f.content };
+      }),
     };
   },
 });

package/corpus/templates/mail/actions/apply-ai-filter.ts

@@ -22,6 +22,7 @@ import {
   ensureGmailLabel,
 } from "../server/lib/automation-actions.js";
 import {
+  assertMailJevEnabled,
   createAutomationRule,
   listAutomationRules,
 } from "../server/lib/automations.js";
@@ -144,6 +145,12 @@ export default defineAction({
     if (!ownerEmail) throw new Error("no authenticated user");
 
     if (args.mode === "settings") {
+      const settingKeys = Object.keys(args.settings ?? {});
+      const disableOnly =
+        settingKeys.length === 1 && args.settings?.enabled === false;
+      if (settingKeys.length > 0 && !disableOnly) {
+        await assertMailJevEnabled(ownerEmail);
+      }
       const state = await getAiFilterState(ownerEmail);
       const next = {
         ...state,
@@ -154,6 +161,7 @@ export default defineAction({
       return { changed: 0, failures: [], state: next };
     }
 
+    await assertMailJevEnabled(ownerEmail);
     const targets = args.targets ?? [];
     if (targets.length === 0) throw new Error("targets are required");
 

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

@@ -3,7 +3,10 @@ import { getRequestUserEmail } from "@agent-native/core/server";
 import { track } from "@agent-native/core/tracking";
 import { z } from "zod";
 
-import { createAutomationRule } from "../server/lib/automations.js";
+import {
+  assertMailJevEnabled,
+  createAutomationRule,
+} from "../server/lib/automations.js";
 import { automationActionSchema } from "../shared/automation-schema.js";
 
 export default defineAction({
@@ -25,6 +28,9 @@ export default defineAction({
     if (!args.name || !args.condition || !args.actions) {
       throw new Error("name, condition, and actions are required");
     }
+    if ((args.domain ?? "mail") === "mail" && args.kind === "ai-filter") {
+      await assertMailJevEnabled(ownerEmail);
+    }
     const result = await createAutomationRule(ownerEmail, args);
     track(
       "automation_created",

package/corpus/templates/mail/actions/manage-ai-filter-rule-undo.ts

@@ -0,0 +1,34 @@
+import { defineAction } from "@agent-native/core/action";
+import { getRequestUserEmail } from "@agent-native/core/server";
+import { z } from "zod";
+
+import {
+  clearMailAiFilterRules,
+  restoreMailAiFilterRules,
+} from "../server/lib/ai-filter-rule-undo.js";
+
+export default defineAction({
+  description:
+    "Clear active Mail AI-filter rules or restore them from a short-lived undo token.",
+  schema: z.discriminatedUnion("operation", [
+    z.object({
+      operation: z.literal("clear"),
+      ids: z.array(z.string().min(1)).min(1).max(32),
+    }),
+    z.object({
+      operation: z.literal("undo"),
+      undoId: z.string().min(1),
+    }),
+  ]),
+  agentTool: false,
+  run: async (args) => {
+    const ownerEmail = getRequestUserEmail();
+    if (!ownerEmail) throw new Error("Unauthenticated");
+    if (args.operation === "clear") {
+      const undoId = await clearMailAiFilterRules(ownerEmail, args.ids);
+      return { undoId };
+    }
+    await restoreMailAiFilterRules(ownerEmail, args.undoId);
+    return { restored: true };
+  },
+});

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

@@ -4,6 +4,8 @@ import { eq, and } from "drizzle-orm";
 import { nanoid } from "nanoid";
 import { z } from "zod";
 
+import type { AutomationAction } from "../shared/types.js";
+
 export const createManageEmailRulesAction = (agentTool: boolean) =>
   defineAction({
     description:
@@ -103,31 +105,26 @@ export const createManageEmailRulesAction = (agentTool: boolean) =>
         case "update": {
           if (!args.id) throw new Error("--id is required for update");
 
-          const updates: Record<string, any> = {
-            updatedAt: Math.floor(Date.now() / 1_000),
-          };
-          if (args.name !== undefined) updates.name = args.name;
-          if (args.condition !== undefined) updates.condition = args.condition;
+          const patch: {
+            name?: string;
+            condition?: string;
+            actions?: AutomationAction[];
+            enabled?: boolean;
+          } = {};
+          if (args.name !== undefined) patch.name = args.name;
+          if (args.condition !== undefined) patch.condition = args.condition;
           if (args.actions !== undefined) {
             try {
-              JSON.parse(args.actions);
-              updates.actions = args.actions;
+              patch.actions = JSON.parse(args.actions);
             } catch {
               throw new Error("--actions must be valid JSON array");
             }
           }
-          if (args.enabled !== undefined)
-            updates.enabled = args.enabled ? 1 : 0;
+          if (args.enabled !== undefined) patch.enabled = args.enabled;
 
-          await db
-            .update(schema.automationRules)
-            .set(updates)
-            .where(
-              and(
-                eq(schema.automationRules.id, args.id),
-                eq(schema.automationRules.ownerEmail, ownerEmail),
-              ),
-            );
+          const { updateAutomationRule } =
+            await import("../server/lib/automations.js");
+          await updateAutomationRule(ownerEmail, args.id, patch);
 
           return `Updated automation rule ${args.id}`;
         }
@@ -149,38 +146,18 @@ export const createManageEmailRulesAction = (agentTool: boolean) =>
 
         case "enable": {
           if (!args.id) throw new Error("--id is required for enable");
-
-          await db
-            .update(schema.automationRules)
-            .set({
-              enabled: 1,
-              updatedAt: Math.floor(Date.now() / 1_000),
-            } as any)
-            .where(
-              and(
-                eq(schema.automationRules.id, args.id),
-                eq(schema.automationRules.ownerEmail, ownerEmail),
-              ),
-            );
+          const { updateAutomationRule } =
+            await import("../server/lib/automations.js");
+          await updateAutomationRule(ownerEmail, args.id, { enabled: true });
 
           return `Enabled 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: Math.floor(Date.now() / 1_000),
-            } as any)
-            .where(
-              and(
-                eq(schema.automationRules.id, args.id),
-                eq(schema.automationRules.ownerEmail, ownerEmail),
-              ),
-            );
+          const { updateAutomationRule } =
+            await import("../server/lib/automations.js");
+          await updateAutomationRule(ownerEmail, args.id, { enabled: false });
 
           return `Disabled automation rule ${args.id}`;
         }