@agent-native/core 0.96.0 → 0.98.0

package/corpus/templates/analytics/app/hooks/use-dashboard-views.ts

@@ -27,31 +27,33 @@ export function useDashboardViews(dashboardId: string | undefined) {
   const queryClient = useQueryClient();
   const queryKey = ["dashboard-views", dashboardId];
 
-  const { data: views = [], isLoading } = useQuery({
+  const viewsQuery = useQuery({
     queryKey,
     queryFn: async (): Promise<DashboardView[]> => {
       if (!dashboardId) return [];
       const res = await fetchWithAuth(
         `/api/dashboard-views/${encodeURIComponent(dashboardId)}`,
       );
-      if (!res.ok) return [];
+      if (!res.ok) throw new Error(`Load failed: ${res.status}`);
       const data = await res.json();
       return data.views ?? [];
     },
     enabled: !!dashboardId,
     staleTime: 30_000,
   });
+  const views = viewsQuery.data ?? [];
 
   const { mutateAsync: saveView } = useMutation({
     mutationFn: async (view: DashboardView) => {
       if (!dashboardId) return;
-      await fetchWithAuth(
+      const res = await fetchWithAuth(
         `/api/dashboard-views/${encodeURIComponent(dashboardId)}`,
         {
           method: "POST",
           body: JSON.stringify(view),
         },
       );
+      if (!res.ok) throw new Error(`Save failed: ${res.status}`);
     },
     onSettled: () => {
       queryClient.invalidateQueries({ queryKey });
@@ -63,10 +65,11 @@ export function useDashboardViews(dashboardId: string | undefined) {
   const { mutateAsync: deleteView } = useMutation({
     mutationFn: async (viewId: string) => {
       if (!dashboardId) return;
-      await fetchWithAuth(
+      const res = await fetchWithAuth(
         `/api/dashboard-views/${encodeURIComponent(dashboardId)}/${encodeURIComponent(viewId)}`,
         { method: "DELETE" },
       );
+      if (!res.ok) throw new Error(`Delete failed: ${res.status}`);
     },
     onSettled: () => {
       queryClient.invalidateQueries({ queryKey });
@@ -74,7 +77,14 @@ export function useDashboardViews(dashboardId: string | undefined) {
     },
   });
 
-  return { views, isLoading, saveView, deleteView };
+  return {
+    views,
+    isLoading: viewsQuery.isLoading,
+    error: viewsQuery.error,
+    refetch: viewsQuery.refetch,
+    saveView,
+    deleteView,
+  };
 }
 
 /**

package/corpus/templates/analytics/app/i18n/zh-TW.ts

@@ -41,6 +41,9 @@ const messages = {
     showLess: "顯示更少",
     showMore: "再顯示 {{count}} 個",
     noAnalysesYet: "還沒有分析",
+    dashboardsLoadFailed: "無法載入儀表板。",
+    analysesLoadFailed: "無法載入分析。",
+    retry: "重試",
     search: "搜尋",
     searchShortcut: "搜尋（{{shortcut}}）",
     sectionSettings: "{{label}} 設定",
@@ -301,6 +304,7 @@ const messages = {
     groupAppearance: "外觀",
     groupHelp: "幫助",
     groupSavedCharts: "已儲存圖表",
+    loadFailed: "部分結果無法載入。",
     hidden: "已隱藏",
     toggleLightMode: "切換到淺色模式",
     toggleDarkMode: "切換到深色模式",

package/corpus/templates/analytics/app/i18n-data.ts

@@ -62,6 +62,9 @@ const enUS = {
     showLess: "Show less",
     showMore: "Show {{count}} more",
     noAnalysesYet: "No analyses yet",
+    dashboardsLoadFailed: "Couldn't load dashboards.",
+    analysesLoadFailed: "Couldn't load analyses.",
+    retry: "Retry",
     search: "Search",
     searchShortcut: "Search ({{shortcut}})",
     sectionSettings: "{{label}} settings",
@@ -156,6 +159,7 @@ const enUS = {
     groupAppearance: "Appearance",
     groupHelp: "Help",
     groupSavedCharts: "Saved Charts",
+    loadFailed: "Some results couldn't be loaded.",
     hidden: "Hidden",
     toggleLightMode: "Toggle light mode",
     toggleDarkMode: "Toggle dark mode",
@@ -3792,6 +3796,9 @@ export const messagesByLocale = {
       showLess: "显示更少",
       showMore: "再显示 {{count}} 个",
       noAnalysesYet: "还没有分析",
+      dashboardsLoadFailed: "无法加载仪表板。",
+      analysesLoadFailed: "无法加载分析。",
+      retry: "重试",
       search: "搜索",
       searchShortcut: "搜索（{{shortcut}}）",
       sectionSettings: "{{label}} 设置",
@@ -3881,6 +3888,7 @@ export const messagesByLocale = {
       groupAppearance: "外观",
       groupHelp: "帮助",
       groupSavedCharts: "已保存图表",
+      loadFailed: "部分结果无法加载。",
       hidden: "已隐藏",
       toggleLightMode: "切换到浅色模式",
       toggleDarkMode: "切换到深色模式",
@@ -3996,6 +4004,9 @@ export const messagesByLocale = {
       showLess: "Mostrar menos",
       showMore: "Mostrar {{count}} más",
       noAnalysesYet: "Aún no hay análisis",
+      dashboardsLoadFailed: "No se pudieron cargar los paneles.",
+      analysesLoadFailed: "No se pudieron cargar los análisis.",
+      retry: "Reintentar",
       search: "Buscar",
       searchShortcut: "Buscar ({{shortcut}})",
       sectionSettings: "Ajustes de {{label}}",
@@ -4092,6 +4103,7 @@ export const messagesByLocale = {
       groupAppearance: "Apariencia",
       groupHelp: "Ayuda",
       groupSavedCharts: "Gráficos guardados",
+      loadFailed: "No se pudieron cargar algunos resultados.",
       hidden: "Oculto",
       toggleLightMode: "Cambiar a modo claro",
       toggleDarkMode: "Cambiar a modo oscuro",
@@ -4211,6 +4223,9 @@ export const messagesByLocale = {
       showLess: "Afficher moins",
       showMore: "Afficher {{count}} de plus",
       noAnalysesYet: "Aucune analyse pour le moment",
+      dashboardsLoadFailed: "Impossible de charger les tableaux de bord.",
+      analysesLoadFailed: "Impossible de charger les analyses.",
+      retry: "Réessayer",
       search: "Rechercher",
       searchShortcut: "Rechercher ({{shortcut}})",
       sectionSettings: "Paramètres de {{label}}",
@@ -4309,6 +4324,7 @@ export const messagesByLocale = {
       groupAppearance: "Apparence",
       groupHelp: "Aide",
       groupSavedCharts: "Graphiques enregistrés",
+      loadFailed: "Certains résultats n'ont pas pu être chargés.",
       hidden: "Masqué",
       toggleLightMode: "Passer en mode clair",
       toggleDarkMode: "Passer en mode sombre",
@@ -4432,6 +4448,9 @@ export const messagesByLocale = {
       showLess: "Weniger anzeigen",
       showMore: "{{count}} weitere anzeigen",
       noAnalysesYet: "Noch keine Analysen",
+      dashboardsLoadFailed: "Dashboards konnten nicht geladen werden.",
+      analysesLoadFailed: "Analysen konnten nicht geladen werden.",
+      retry: "Erneut versuchen",
       search: "Suchen",
       searchShortcut: "Suchen ({{shortcut}})",
       sectionSettings: "{{label}}-Einstellungen",
@@ -4533,6 +4552,7 @@ export const messagesByLocale = {
       groupAppearance: "Darstellung",
       groupHelp: "Hilfe",
       groupSavedCharts: "Gespeicherte Diagramme",
+      loadFailed: "Einige Ergebnisse konnten nicht geladen werden.",
       hidden: "Ausgeblendet",
       toggleLightMode: "Hellen Modus einschalten",
       toggleDarkMode: "Dunklen Modus einschalten",
@@ -4653,6 +4673,9 @@ export const messagesByLocale = {
       showLess: "少なく表示",
       showMore: "さらに {{count}} 件表示",
       noAnalysesYet: "分析はまだありません",
+      dashboardsLoadFailed: "ダッシュボードを読み込めませんでした。",
+      analysesLoadFailed: "分析を読み込めませんでした。",
+      retry: "再試行",
       search: "検索",
       searchShortcut: "検索（{{shortcut}}）",
       sectionSettings: "{{label}} の設定",
@@ -4748,6 +4771,7 @@ export const messagesByLocale = {
       groupAppearance: "表示",
       groupHelp: "ヘルプ",
       groupSavedCharts: "保存済みグラフ",
+      loadFailed: "一部の結果を読み込めませんでした。",
       hidden: "非表示",
       toggleLightMode: "ライトモードに切り替え",
       toggleDarkMode: "ダークモードに切り替え",
@@ -4867,6 +4891,9 @@ export const messagesByLocale = {
       showLess: "간단히 보기",
       showMore: "{{count}}개 더 보기",
       noAnalysesYet: "아직 분석이 없습니다",
+      dashboardsLoadFailed: "대시보드를 불러오지 못했습니다.",
+      analysesLoadFailed: "분석을 불러오지 못했습니다.",
+      retry: "다시 시도",
       search: "검색",
       searchShortcut: "검색({{shortcut}})",
       sectionSettings: "{{label}} 설정",
@@ -4962,6 +4989,7 @@ export const messagesByLocale = {
       groupAppearance: "모양",
       groupHelp: "도움말",
       groupSavedCharts: "저장된 차트",
+      loadFailed: "일부 결과를 불러오지 못했습니다.",
       hidden: "숨김",
       toggleLightMode: "라이트 모드로 전환",
       toggleDarkMode: "다크 모드로 전환",
@@ -5081,6 +5109,9 @@ export const messagesByLocale = {
       showLess: "Mostrar menos",
       showMore: "Mostrar mais {{count}}",
       noAnalysesYet: "Ainda não há análises",
+      dashboardsLoadFailed: "Não foi possível carregar os painéis.",
+      analysesLoadFailed: "Não foi possível carregar as análises.",
+      retry: "Tentar novamente",
       search: "Pesquisar",
       searchShortcut: "Pesquisar ({{shortcut}})",
       sectionSettings: "Configurações de {{label}}",
@@ -5180,6 +5211,7 @@ export const messagesByLocale = {
       groupAppearance: "Aparência",
       groupHelp: "Ajuda",
       groupSavedCharts: "Gráficos salvos",
+      loadFailed: "Não foi possível carregar alguns resultados.",
       hidden: "Oculto",
       toggleLightMode: "Alternar para modo claro",
       toggleDarkMode: "Alternar para modo escuro",
@@ -5302,6 +5334,9 @@ export const messagesByLocale = {
       showLess: "कम दिखाएं",
       showMore: "{{count}} और दिखाएं",
       noAnalysesYet: "अभी कोई विश्लेषण नहीं",
+      dashboardsLoadFailed: "डैशबोर्ड लोड नहीं हो सके।",
+      analysesLoadFailed: "विश्लेषण लोड नहीं हो सके।",
+      retry: "फिर से कोशिश करें",
       search: "खोजें",
       searchShortcut: "खोजें ({{shortcut}})",
       sectionSettings: "{{label}} सेटिंग्स",
@@ -5393,6 +5428,7 @@ export const messagesByLocale = {
       groupAppearance: "दिखावट",
       groupHelp: "सहायता",
       groupSavedCharts: "सहेजे गए चार्ट",
+      loadFailed: "कुछ परिणाम लोड नहीं किए जा सके।",
       hidden: "छिपा हुआ",
       toggleLightMode: "लाइट मोड पर जाएं",
       toggleDarkMode: "डार्क मोड पर जाएं",
@@ -5513,6 +5549,9 @@ export const messagesByLocale = {
       showLess: "عرض أقل",
       showMore: "عرض {{count}} إضافية",
       noAnalysesYet: "لا توجد تحليلات بعد",
+      dashboardsLoadFailed: "تعذر تحميل لوحات المعلومات.",
+      analysesLoadFailed: "تعذر تحميل التحليلات.",
+      retry: "إعادة المحاولة",
       search: "بحث",
       searchShortcut: "بحث ({{shortcut}})",
       sectionSettings: "إعدادات {{label}}",
@@ -5605,6 +5644,7 @@ export const messagesByLocale = {
       groupAppearance: "المظهر",
       groupHelp: "المساعدة",
       groupSavedCharts: "المخططات المحفوظة",
+      loadFailed: "تعذر تحميل بعض النتائج.",
       hidden: "مخفي",
       toggleLightMode: "التبديل إلى الوضع الفاتح",
       toggleDarkMode: "التبديل إلى الوضع الداكن",

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,