@agent-native/core 0.97.0 → 0.98.0

package/corpus/templates/analytics/app/pages/Settings.tsx

@@ -6,6 +6,7 @@ import {
   useAgentSettingsTabs,
   useBuilderConnectFlow,
   useBuilderStatus,
+  useSession,
   useT,
   type SettingsSearchEntry,
   type SettingsTabItem,
@@ -25,7 +26,6 @@ import { useMemo, useState } from "react";
 import { Link } from "react-router";
 import { toast } from "sonner";
 
-import { useAuth } from "@/components/auth/AuthProvider";
 import { Badge } from "@/components/ui/badge";
 import { Button } from "@/components/ui/button";
 import {
@@ -120,7 +120,11 @@ async function saveS3StorageSettings(
 }
 
 export default function Settings() {
-  const { auth } = useAuth();
+  // Settings is also reachable directly from the full-page agent surface.
+  // Read the session from the framework's owning AppProviders boundary rather
+  // than the template-local compatibility context, which may be remounted
+  // independently during that route transition.
+  const { session: auth } = useSession();
   const t = useT();
   const agentSettingsTabs = useAgentSettingsTabs();
 

package/corpus/templates/analytics/app/pages/adhoc/explorer/components/SqlPreview.tsx

@@ -1,6 +1,6 @@
 import { useT } from "@agent-native/core/client";
 import { IconChevronRight, IconCopy, IconCheck } from "@tabler/icons-react";
-import { useState } from "react";
+import { useId, useState } from "react";
 
 import { SqlHighlight } from "@/components/SqlHighlight";
 import { Button } from "@/components/ui/button";
@@ -12,6 +12,7 @@ interface SqlPreviewProps {
 
 export function SqlPreview({ sql }: SqlPreviewProps) {
   const t = useT();
+  const contentId = useId();
   const [expanded, setExpanded] = useState(false);
   const [copied, setCopied] = useState(false);
 
@@ -25,7 +26,10 @@ export function SqlPreview({ sql }: SqlPreviewProps) {
     <div className="border rounded-lg">
       <button
         className="flex items-center gap-2 w-full px-3 py-2 text-sm text-muted-foreground hover:text-foreground transition-colors"
+        type="button"
         onClick={() => setExpanded(!expanded)}
+        aria-expanded={expanded}
+        aria-controls={contentId}
       >
         <IconChevronRight
           className={cn(
@@ -35,26 +39,38 @@ export function SqlPreview({ sql }: SqlPreviewProps) {
         />
         {t("explorer.sqlQuery")}
       </button>
-      {expanded && (
-        <div className="relative border-t">
-          <SqlHighlight
-            sql={sql}
-            preClassName="p-3 overflow-auto max-h-[300px] bg-muted/50 rounded-b-lg"
-          />
-          <Button
-            variant="ghost"
-            size="icon"
-            className="absolute top-2 right-2 h-6 w-6"
-            onClick={handleCopy}
-          >
-            {copied ? (
-              <IconCheck className="h-3 w-3" />
-            ) : (
-              <IconCopy className="h-3 w-3" />
-            )}
-          </Button>
+      <div
+        id={contentId}
+        aria-hidden={!expanded}
+        inert={!expanded}
+        className={cn(
+          "grid transition-[grid-template-rows,opacity] duration-150 ease-out motion-reduce:transition-none",
+          expanded
+            ? "grid-rows-[1fr] opacity-100"
+            : "pointer-events-none grid-rows-[0fr] opacity-0",
+        )}
+      >
+        <div className="min-h-0 overflow-hidden">
+          <div className="relative border-t">
+            <SqlHighlight
+              sql={sql}
+              preClassName="p-3 overflow-auto max-h-[300px] bg-muted/50 rounded-b-lg"
+            />
+            <Button
+              variant="ghost"
+              size="icon"
+              className="absolute top-2 right-2 h-6 w-6"
+              onClick={handleCopy}
+            >
+              {copied ? (
+                <IconCheck className="h-3 w-3" />
+              ) : (
+                <IconCopy className="h-3 w-3" />
+              )}
+            </Button>
+          </div>
         </div>
-      )}
+      </div>
     </div>
   );
 }

package/corpus/templates/analytics/app/pages/adhoc/explorer/index.tsx

@@ -9,6 +9,7 @@ import {
 import { useMemo, useState, useEffect } from "react";
 import { useSearchParams } from "react-router";
 
+import { ResourceLoadError } from "@/components/ResourceLoadError";
 import {
   AlertDialog,
   AlertDialogAction,
@@ -54,6 +55,8 @@ export default function ExplorerPage() {
     setConfig,
     currentId,
     savedConfigs,
+    savedConfigsError,
+    retrySavedConfigs,
     loadConfig,
     saveConfig,
     deleteConfig,
@@ -158,27 +161,38 @@ export default function ExplorerPage() {
                   {t("explorer.saveAs")}
                 </DropdownMenuItem>
               )}
-              {savedConfigs.length > 0 && <DropdownMenuSeparator />}
-              {savedConfigs.map((sc) => (
-                <DropdownMenuItem
-                  key={sc.id}
-                  className="flex items-center justify-between"
-                  onClick={() => loadConfig(sc.id)}
-                >
-                  <span className="truncate">{sc.name}</span>
-                  <Button
-                    variant="ghost"
-                    size="icon"
-                    className="h-5 w-5 shrink-0 ml-2"
-                    onClick={(e) => {
-                      e.stopPropagation();
-                      setDeleteConfirm({ id: sc.id, name: sc.name });
-                    }}
+              {(savedConfigsError || savedConfigs.length > 0) && (
+                <DropdownMenuSeparator />
+              )}
+              {savedConfigsError ? (
+                <ResourceLoadError
+                  inline
+                  message={t("commandPalette.loadFailed")}
+                  retryLabel={t("sidebar.retry")}
+                  onRetry={() => void retrySavedConfigs()}
+                />
+              ) : (
+                savedConfigs.map((sc) => (
+                  <DropdownMenuItem
+                    key={sc.id}
+                    className="flex items-center justify-between"
+                    onClick={() => loadConfig(sc.id)}
                   >
-                    <IconTrash className="h-3 w-3 text-destructive" />
-                  </Button>
-                </DropdownMenuItem>
-              ))}
+                    <span className="truncate">{sc.name}</span>
+                    <Button
+                      variant="ghost"
+                      size="icon"
+                      className="h-5 w-5 shrink-0 ml-2"
+                      onClick={(e) => {
+                        e.stopPropagation();
+                        setDeleteConfirm({ id: sc.id, name: sc.name });
+                      }}
+                    >
+                      <IconTrash className="h-3 w-3 text-destructive" />
+                    </Button>
+                  </DropdownMenuItem>
+                ))
+              )}
             </DropdownMenuContent>
           </DropdownMenu>
 

package/corpus/templates/analytics/app/pages/adhoc/explorer/use-explorer-config.ts

@@ -1,6 +1,7 @@
 import { callAction, useT } from "@agent-native/core/client";
 import { useQuery } from "@tanstack/react-query";
 import { useState, useCallback, useEffect, useRef } from "react";
+import { toast } from "sonner";
 
 import type { ExplorerConfig } from "./types";
 import { createDefaultConfig } from "./types";
@@ -14,32 +15,20 @@ interface SavedConfigEntry {
 }
 
 async function fetchSavedConfigs(): Promise<SavedConfigEntry[]> {
-  try {
-    const rows = await callAction(
-      "list-explorer-configs",
-      {},
-      { method: "GET" },
-    );
-    return (Array.isArray(rows) ? rows : []) as SavedConfigEntry[];
-  } catch {
-    return [];
-  }
+  const rows = await callAction("list-explorer-configs", {}, { method: "GET" });
+  return (Array.isArray(rows) ? rows : []) as SavedConfigEntry[];
 }
 
 async function fetchConfig(id: string): Promise<ExplorerConfig | null> {
-  try {
-    const data = await callAction(
-      "get-explorer-config",
-      { id },
-      { method: "GET" },
-    );
-    if (!data || typeof data !== "object") return null;
-    // Strip server-added id field
-    const { id: _id, ...rest } = data as Record<string, unknown>;
-    return rest as unknown as ExplorerConfig;
-  } catch {
-    return null;
-  }
+  const data = await callAction(
+    "get-explorer-config",
+    { id },
+    { method: "GET" },
+  );
+  if (!data || typeof data !== "object") return null;
+  // Strip server-added id field
+  const { id: _id, ...rest } = data as Record<string, unknown>;
+  return rest as unknown as ExplorerConfig;
 }
 
 function persistConfig(id: string, config: ExplorerConfig) {
@@ -62,12 +51,14 @@ export function useExplorerConfig() {
 
   // On mount, try to restore from autosave
   useEffect(() => {
-    fetchConfig(AUTOSAVE_ID).then((saved) => {
-      if (saved) {
-        setConfig(saved);
-      }
-      setInitialized(true);
-    });
+    fetchConfig(AUTOSAVE_ID)
+      .catch(() => null)
+      .then((saved) => {
+        if (saved) {
+          setConfig(saved);
+        }
+        setInitialized(true);
+      });
   }, []);
 
   // Auto-save on every config change (debounced)
@@ -84,19 +75,27 @@ export function useExplorerConfig() {
     return () => clearTimeout(autosaveTimer.current);
   }, [config, currentId, initialized]);
 
-  const { data: savedConfigs = [], refetch: refetchList } = useQuery({
+  const savedConfigsQuery = useQuery({
     queryKey: ["explorer-configs"],
     queryFn: fetchSavedConfigs,
     staleTime: 30_000,
   });
+  const savedConfigs = savedConfigsQuery.data ?? [];
 
-  const loadConfig = useCallback(async (id: string) => {
-    const loaded = await fetchConfig(id);
-    if (loaded) {
-      setConfig(loaded);
-      setCurrentId(id);
-    }
-  }, []);
+  const loadConfig = useCallback(
+    async (id: string) => {
+      try {
+        const loaded = await fetchConfig(id);
+        if (loaded) {
+          setConfig(loaded);
+          setCurrentId(id);
+        }
+      } catch {
+        toast.error(t("commandPalette.loadFailed"));
+      }
+    },
+    [t],
+  );
 
   const saveConfig = useCallback(
     async (name?: string) => {
@@ -110,12 +109,12 @@ export function useExplorerConfig() {
         });
         setCurrentId(id);
         setConfig(toSave);
-        refetchList();
+        savedConfigsQuery.refetch();
       } finally {
         setIsSaving(false);
       }
     },
-    [config, currentId, refetchList],
+    [config, currentId, savedConfigsQuery],
   );
 
   const deleteConfig = useCallback(
@@ -125,9 +124,9 @@ export function useExplorerConfig() {
         setConfig(createDefaultConfig(defaultConfigName));
         setCurrentId(null);
       }
-      refetchList();
+      savedConfigsQuery.refetch();
     },
-    [currentId, defaultConfigName, refetchList],
+    [currentId, defaultConfigName, savedConfigsQuery],
   );
 
   const newConfig = useCallback(() => {
@@ -140,6 +139,8 @@ export function useExplorerConfig() {
     setConfig,
     currentId,
     savedConfigs,
+    savedConfigsError: savedConfigsQuery.error,
+    retrySavedConfigs: savedConfigsQuery.refetch,
     loadConfig,
     saveConfig,
     deleteConfig,

package/corpus/templates/analytics/app/pages/adhoc/explorer-dashboard/index.tsx

@@ -50,6 +50,7 @@ import {
   DashboardTitleSkeleton,
   useSetPageTitle,
 } from "@/components/layout/HeaderActions";
+import { ResourceLoadError } from "@/components/ResourceLoadError";
 import {
   AlertDialog,
   AlertDialogAction,
@@ -131,28 +132,24 @@ function ExplorerDashboardDragPreview({ title }: { title: string | null }) {
 async function fetchDashboard(
   id: string,
 ): Promise<FetchedExplorerDashboard | null> {
-  try {
-    const raw: any = await callAction(
-      "get-explorer-dashboard",
-      { id },
-      { method: "GET" },
-    );
-    if (!raw) return null;
-    return {
-      data: {
-        name: raw.name ?? "Untitled Dashboard",
-        charts: raw.charts ?? [],
-      },
-      archivedAt: typeof raw.archivedAt === "string" ? raw.archivedAt : null,
-      hiddenAt: typeof raw.hiddenAt === "string" ? raw.hiddenAt : null,
-      hiddenBy: typeof raw.hiddenBy === "string" ? raw.hiddenBy : null,
-      role: typeof raw.role === "string" ? raw.role : undefined,
-      canEdit: typeof raw.canEdit === "boolean" ? raw.canEdit : undefined,
-      canManage: typeof raw.canManage === "boolean" ? raw.canManage : undefined,
-    };
-  } catch {
-    return null;
-  }
+  const raw: any = await callAction(
+    "get-explorer-dashboard",
+    { id },
+    { method: "GET" },
+  );
+  if (!raw) return null;
+  return {
+    data: {
+      name: raw.name ?? "Untitled Dashboard",
+      charts: raw.charts ?? [],
+    },
+    archivedAt: typeof raw.archivedAt === "string" ? raw.archivedAt : null,
+    hiddenAt: typeof raw.hiddenAt === "string" ? raw.hiddenAt : null,
+    hiddenBy: typeof raw.hiddenBy === "string" ? raw.hiddenBy : null,
+    role: typeof raw.role === "string" ? raw.role : undefined,
+    canEdit: typeof raw.canEdit === "boolean" ? raw.canEdit : undefined,
+    canManage: typeof raw.canManage === "boolean" ? raw.canManage : undefined,
+  };
 }
 
 async function saveDashboard(id: string, data: ExplorerDashboardData) {
@@ -163,18 +160,10 @@ async function saveDashboard(id: string, data: ExplorerDashboardData) {
 }
 
 async function fetchSavedConfigs(): Promise<SavedConfig[]> {
-  try {
-    const rows = await callAction(
-      "list-explorer-configs",
-      {},
-      { method: "GET" },
-    );
-    return (Array.isArray(rows) ? rows : [])
-      .filter((c: any) => c.id !== "_autosave")
-      .map((c: any) => ({ id: c.id, name: c.name }));
-  } catch {
-    return [];
-  }
+  const rows = await callAction("list-explorer-configs", {}, { method: "GET" });
+  return (Array.isArray(rows) ? rows : [])
+    .filter((c: any) => c.id !== "_autosave")
+    .map((c: any) => ({ id: c.id, name: c.name }));
 }
 
 export default function ExplorerDashboardPage() {
@@ -277,11 +266,12 @@ export default function ExplorerDashboardPage() {
     [collabDocId],
   );
 
-  const { data: savedConfigs = [] } = useQuery({
+  const savedConfigsQuery = useQuery({
     queryKey: ["explorer-configs"],
     queryFn: fetchSavedConfigs,
     staleTime: 30_000,
   });
+  const savedConfigs = savedConfigsQuery.data ?? [];
 
   // Refetch the dashboard whenever the `dashboards` source bumps OR any agent
   // action runs — the same "agent writes show up without a manual refresh"
@@ -539,6 +529,16 @@ export default function ExplorerDashboardPage() {
     );
   }
 
+  if (dashboardQuery.isError) {
+    return (
+      <ResourceLoadError
+        message={t("sidebar.dashboardsLoadFailed")}
+        retryLabel={t("sidebar.retry")}
+        onRetry={() => void dashboardQuery.refetch()}
+      />
+    );
+  }
+
   if (!loaded) {
     return <DashboardSkeleton />;
   }
@@ -817,7 +817,14 @@ export default function ExplorerDashboardPage() {
               <DialogTitle>{t("explorerDashboard.addChart")}</DialogTitle>
             </DialogHeader>
             <div className="max-h-[400px] overflow-auto space-y-1">
-              {savedConfigs.length === 0 ? (
+              {savedConfigsQuery.isError ? (
+                <ResourceLoadError
+                  inline
+                  message={t("commandPalette.loadFailed")}
+                  retryLabel={t("sidebar.retry")}
+                  onRetry={() => void savedConfigsQuery.refetch()}
+                />
+              ) : savedConfigs.length === 0 ? (
                 <p className="text-sm text-muted-foreground py-4 text-center">
                   {t("explorerDashboard.noSavedExplorerCharts")}
                 </p>

package/corpus/templates/analytics/app/pages/adhoc/sql-dashboard/ViewsMenu.tsx

@@ -8,6 +8,7 @@ import {
 import { useMemo, useState } from "react";
 import { useSearchParams } from "react-router";
 
+import { ResourceLoadError } from "@/components/ResourceLoadError";
 import {
   AlertDialog,
   AlertDialogAction,
@@ -92,7 +93,8 @@ function filtersMatch(
 export function ViewsMenu({ dashboardId, canEdit = true }: ViewsMenuProps) {
   const t = useT();
   const [searchParams, setSearchParams] = useSearchParams();
-  const { views, saveView, deleteView } = useDashboardViews(dashboardId);
+  const { views, error, refetch, saveView, deleteView } =
+    useDashboardViews(dashboardId);
 
   const [menuOpen, setMenuOpen] = useState(false);
   const [saveDialogOpen, setSaveDialogOpen] = useState(false);
@@ -177,7 +179,14 @@ export function ViewsMenu({ dashboardId, canEdit = true }: ViewsMenuProps) {
           <DropdownMenuLabel className="text-xs text-muted-foreground">
             {t("sqlDashboard.savedViews")}
           </DropdownMenuLabel>
-          {views.length === 0 ? (
+          {error ? (
+            <ResourceLoadError
+              inline
+              message={t("commandPalette.loadFailed")}
+              retryLabel={t("sidebar.retry")}
+              onRetry={() => void refetch()}
+            />
+          ) : views.length === 0 ? (
             <div className="px-2 py-2 text-xs text-muted-foreground">
               {t("sqlDashboard.noSavedViews")}
             </div>

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

@@ -1,6 +1,7 @@
 import {
   AppProviders,
   appPath,
+  callAction,
   createAgentNativeQueryClient,
   getLocaleInitScript,
   getThemeInitScript,
@@ -8,7 +9,7 @@ import {
 } from "@agent-native/core/client";
 import { configureTracking } from "@agent-native/core/client";
 import { useQueryClient } from "@tanstack/react-query";
-import { useCallback, useState } from "react";
+import { useCallback, useEffect, useState } from "react";
 import {
   Links,
   Meta,
@@ -105,6 +106,16 @@ function DbSyncBridge() {
   return null;
 }
 
+function DemoDashboardInstaller() {
+  useEffect(() => {
+    void callAction("ensure-demo-dashboards", {}).catch((err) => {
+      console.warn("[analytics] demo dashboard install failed", err);
+    });
+  }, []);
+
+  return null;
+}
+
 export default function Root() {
   const [queryClient] = useState(() => createAgentNativeQueryClient());
   const location = useLocation();
@@ -147,6 +158,7 @@ export default function Root() {
         <Toaster />
         <Sonner position="bottom-left" />
         <AuthProvider>
+          <DemoDashboardInstaller />
           <ProviderCorpusJobNotifier />
           <CommandPalette />
           <AppLayout>

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

@@ -1,4 +1,4 @@
-import Index from "@/pages/Index";
+import { redirect, type LoaderFunctionArgs } from "react-router";
 
 const SEO_TITLE =
   "Agent-Native Analytics - Open Source, agent-friendly Amplitude alternative";
@@ -20,6 +20,18 @@ export function meta() {
   ];
 }
 
+function target(url: URL): string {
+  return `/ask${url.search}${url.hash}`;
+}
+
+export function loader({ url }: LoaderFunctionArgs) {
+  throw redirect(target(url));
+}
+
+export function clientLoader({ url }: LoaderFunctionArgs) {
+  throw redirect(target(url));
+}
+
 export default function IndexRoute() {
-  return <Index />;
+  return null;
 }

package/corpus/templates/analytics/changelog/2026-07-03-agent-llm-observability-dashboard.md

@@ -3,4 +3,4 @@ type: added
 date: 2026-07-03
 ---
 
-Added an Agent LLM Observability dashboard template for model cost, token, latency, and error tracking.
+The Agent Native dashboard now shows model cost, token usage, latency, and error tracking.

package/corpus/templates/analytics/changelog/2026-07-11-agent-feedback-sentiment-dashboard.md

@@ -0,0 +1,6 @@
+---
+type: added
+date: 2026-07-11
+---
+
+The Agent Native dashboard now shows explicit thumbs feedback trends and sentiment by model.

package/corpus/templates/analytics/changelog/2026-07-11-analytics-chats-now-start-faster-by-loading-metric-definitio.md

@@ -0,0 +1,6 @@
+---
+type: improved
+date: 2026-07-11
+---
+
+Analytics chats now start faster by loading metric definitions only when they are needed

package/corpus/templates/analytics/changelog/2026-07-11-command-and-sql-previews-now-respond-without-lag.md

@@ -0,0 +1,6 @@
+---
+type: improved
+date: 2026-07-11
+---
+
+The command palette now responds instantly, and SQL previews expand and collapse smoothly.

package/corpus/templates/analytics/changelog/2026-07-11-command-search-now-reports-loading-failures-and-lets-you-ret.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-07-11
+---
+
+Command search now reports loading failures and lets you retry instead of hiding unavailable results.

package/corpus/templates/analytics/changelog/2026-07-11-dashboard-navigation-now-loads-faster-and-reports-request-fa.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-07-11
+---
+
+Dashboard navigation now loads faster and reports request failures instead of appearing empty.

package/corpus/templates/analytics/changelog/2026-07-11-inferred-message-sentiment-dashboard.md

@@ -0,0 +1,6 @@
+---
+type: added
+date: 2026-07-11
+---
+
+The Agent Native dashboard now shows optional inferred message sentiment overall, over time, and by main model.

package/corpus/templates/analytics/changelog/2026-07-11-microphone-settings-from-realtime-voice-mode-now-open-the-vo.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-07-11
+---
+
+Microphone settings from realtime voice mode now open the Voice Transcription settings reliably.

package/corpus/templates/analytics/changelog/2026-07-11-more-dashboard-edit-paths-are-now-safe-against-simultaneous-.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-07-11
+---
+
+More dashboard edit paths are now safe against simultaneous agent and UI edits

package/corpus/templates/analytics/changelog/2026-07-11-renaming-a-dashboard-is-now-safe-against-simultaneous-agent-.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-07-11
+---
+
+Renaming a dashboard is now safe against simultaneous agent and UI edits

package/corpus/templates/analytics/changelog/2026-07-11-renaming-an-analysis-is-now-safe-against-simultaneous-edits.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-07-11
+---
+
+Renaming an analysis is now safe against simultaneous edits

package/corpus/templates/analytics/changelog/2026-07-11-workspace-mounted-analytics-now-opens-ask-reliably-and-route.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-07-11
+---
+
+Workspace-mounted Analytics now opens Ask reliably and routes between pages correctly.