@agent-native/core 0.96.0 → 0.98.0

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-10-dashboard-edits-from-the-agent-and-the-ui-at-the-same-time-n.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-07-10
+---
+
+Dashboard edits from the agent and the UI at the same time no longer overwrite each other

package/corpus/templates/analytics/changelog/2026-07-10-timed-out-bigquery-jobs-are-now-cancelled-so-they-stop-consu.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-07-10
+---
+
+Timed-out BigQuery jobs are now cancelled so they stop consuming warehouse quota.

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.

package/corpus/templates/analytics/docs/schemas/first-party-analytics.md

@@ -106,10 +106,13 @@ Events are stored in `analytics_events`. Common query columns include:
 
 ## LLM observability events
 
-Core emits LLM usage as first-party events with:
+Core emits LLM usage, explicit user feedback, and optional inferred message
+sentiment as first-party events with:
 
 ```txt
 event_name = '$ai_generation'
+event_name = '$ai_feedback'
+event_name = '$ai_sentiment'
 ```
 
 Useful query fields live in `properties`:
@@ -129,8 +132,39 @@ Useful query fields live in `properties`:
 | `tool_calls`, `successful_tools`, `failed_tools` | Tool-call counts                          |
 | `$ai_is_error`, `status`, `$ai_error`            | Error status and message, when applicable |
 
-Install the `agent-observability-llm` dashboard template for canned panels over
-these events.
+Explicit thumbs feedback is content-free and uses these `$ai_feedback`
+properties:
+
+| Property              | Description                                    |
+| --------------------- | ---------------------------------------------- |
+| `sentiment`           | Explicit `positive` or `negative` user rating  |
+| `feedback_type`       | Feedback control/type that produced the rating |
+| `$ai_model`, `model`  | Model that generated the rated agent response  |
+| `run_id`, `thread_id` | Related agent run and thread identifiers       |
+
+These values describe user-provided thumbs feedback.
+
+When optional inferred sentiment is enabled, content-free `$ai_sentiment`
+events use these properties:
+
+| Property              | Description                                                  |
+| --------------------- | ------------------------------------------------------------ |
+| `sentiment`           | Inferred `positive`, `neutral`, or `negative` classification |
+| `method`              | Classification method; `llm` for model-inferred sentiment    |
+| `$ai_model`, `model`  | Main model attributed to the preceding agent response        |
+| `classifier_model`    | Small model used only to classify sentiment                  |
+| `run_id`, `thread_id` | Related agent run and thread identifiers                     |
+
+The inferred-sentiment event does not contain message text. Keep it separate
+from `$ai_feedback`: inferred sentiment is a model classification, while
+feedback sentiment is an explicit user rating. For by-model reporting, group
+on `$ai_model` or `model`; use `classifier_model` only to audit classifier usage.
+
+Agent Native observability panels belong in the canonical Agent Native dashboard
+(`agent-native-templates-first-party`), including generation metrics, explicit
+feedback sentiment, optional inferred message sentiment, and separate
+by-main-model breakdowns. Do not publish or install a separate observability
+dashboard template.
 
 Example dashboard panel:
 

package/corpus/templates/analytics/package.json

@@ -25,7 +25,7 @@
     "@sparticuz/chromium-min": "^149.0.0",
     "@tabler/icons-react": "catalog:",
     "drizzle-orm": "^0.45.2",
-    "h3": "^2.0.1-rc.20",
+    "h3": "catalog:",
     "isbot": "^5",
     "playwright-core": "^1.61.1",
     "postgres": "^3.4.9",
@@ -100,7 +100,6 @@
     "tailwindcss": "catalog:",
     "three": "^0.176.0",
     "tsx": "^4.20.3",
-    "typescript": "catalog:",
     "typescript-7": "catalog:",
     "vaul": "^1.1.2",
     "vite": "catalog:",