@agent-native/core-corpus 0.202.0 → 0.202.1-nightly-20261007011022

package/corpus/README.md

@@ -32,4 +32,4 @@ rg -n "defineAction|useActionQuery" node_modules/@agent-native/core-corpus/corpu
 
 ## Generated Counts
 
-- template files: 11246
+- template files: 11263

package/corpus/templates/analytics/actions/list-sql-dashboards.ts

@@ -70,12 +70,14 @@ export default defineAction({
       kind: "sql",
       archived,
       hidden,
+      includeCatalogMetadata: true,
     });
     return rows.map((d) => ({
       id: d.id,
       name: d.name,
       ...(d.parentId ? { parentId: d.parentId } : {}),
       ...(d.folderId ? { folderId: d.folderId } : {}),
+      ...(d.demoId ? { demo: true } : {}),
       ownerEmail: d.ownerEmail,
       orgId: d.orgId,
       visibility: d.visibility,

package/corpus/templates/analytics/actions/query-dashboard-panel.ts

@@ -1,4 +1,4 @@
-import { defineAction } from "@agent-native/core/action";
+import { defineAction, type ActionRunContext } from "@agent-native/core/action";
 import { getCredentialContext } from "@agent-native/core/server/request-context";
 import { z } from "zod";
 
@@ -14,18 +14,27 @@ export default defineAction({
   schema: z.object({
     source: z.enum(DASHBOARD_PANEL_SOURCES),
     query: z.unknown(),
+    forceRefresh: z.boolean().optional(),
   }),
   http: { method: "POST" },
   readOnly: true,
   agentTool: false,
   grounding: true,
-  run: async (args) => {
+  run: async (args, actionContext?: ActionRunContext) => {
     const context = getCredentialContext();
     if (!context) {
       throw new Error("No authenticated context for query-dashboard-panel.");
     }
 
     const query = normalizeDashboardPanelQuery(args.source, args.query);
-    return resolveAnalyticsPanelSource({ source: args.source, query }, context);
+    return resolveAnalyticsPanelSource(
+      {
+        source: args.source,
+        query,
+        ...(args.forceRefresh ? { forceRefresh: true } : {}),
+        ...(actionContext?.signal ? { signal: actionContext.signal } : {}),
+      },
+      context,
+    );
   },
 });

package/corpus/templates/analytics/app/components/dashboard/SqlChart.tsx

@@ -1253,6 +1253,8 @@ interface SqlChartProps {
   showLoadingWhenDisabled?: boolean;
   timeRange?: number;
   reportScreenshot?: boolean;
+  refreshToken?: number;
+  onRefreshRequested?: () => void;
   onExportCsvChange?: (handler: (() => void) | null) => void;
   onCopyTableChange?: (handler: (() => Promise<void>) | null) => void;
   dashboardId?: string;
@@ -1267,6 +1269,8 @@ export function SqlChart({
   showLoadingWhenDisabled = true,
   timeRange,
   reportScreenshot = false,
+  refreshToken = 0,
+  onRefreshRequested,
   onExportCsvChange,
   onCopyTableChange,
   dashboardId,
@@ -1278,17 +1282,21 @@ export function SqlChart({
   const isExtension = panel.chartType === "extension";
   const shouldQuery = !isSection && !isExtension && loadData && !resultOverride;
   const sql = serializePanelSql(resolvedSql ?? panel.sql);
+  const [localRefreshToken, setLocalRefreshToken] = useState(0);
   const {
     data: queryResult,
     isLoading: queryIsLoading,
     isFetching: queryIsFetching,
     error: queryError,
-    refetch,
   } = useSqlQuery(
     ["sql-chart", dashboardId || panel.id, sql, panel.source],
     sql,
     panel.source,
-    { enabled: shouldQuery, reportScreenshot },
+    {
+      enabled: shouldQuery,
+      reportScreenshot,
+      refreshToken: refreshToken + localRefreshToken,
+    },
   );
 
   const result = resultOverride ?? queryResult;
@@ -1300,6 +1308,14 @@ export function SqlChart({
       ? (result?.error ??
         (queryError ? formatSqlChartError(queryError) : undefined))
       : undefined;
+  const refreshError =
+    shouldQuery && rawRows.length > 0 && queryError
+      ? formatSqlChartError(queryError)
+      : undefined;
+  const requestRefresh = () => {
+    if (onRefreshRequested) onRefreshRequested();
+    else setLocalRefreshToken((token) => token + 1);
+  };
 
   const { rows: queryRows, forcedYKeys } = useMemo(() => {
     if (panel.config?.pivot && rawRows.length) {
@@ -1402,7 +1418,7 @@ export function SqlChart({
             type="button"
             variant="secondary"
             size="sm"
-            onClick={() => void refetch()}
+            onClick={requestRefresh}
           >
             <IconRefresh className="mr-2 h-3.5 w-3.5" />
             {t("sqlDashboard.refresh")}
@@ -1425,8 +1441,35 @@ export function SqlChart({
   }
 
   const missingConfigKeys = configuredKeysMissingFromRows(rows, panel);
-  const withConfigWarning = (node: ReactNode) =>
-    missingConfigKeys.length > 0 ? (
+  const withConfigWarning = (node: ReactNode) => {
+    if (refreshError) {
+      return (
+        <div className="flex h-full min-h-0 flex-col gap-2">
+          <div
+            className="flex items-center justify-between gap-3 rounded-md border border-destructive/30 bg-destructive/5 px-3 py-2"
+            role="alert"
+          >
+            <p className="min-w-0 break-words text-xs text-destructive">
+              {refreshError}
+            </p>
+            <Button
+              type="button"
+              variant="secondary"
+              size="sm"
+              onClick={requestRefresh}
+            >
+              <IconRefresh className="mr-2 h-3.5 w-3.5" />
+              {t("sqlDashboard.refresh")}
+            </Button>
+          </div>
+          {missingConfigKeys.length > 0 && (
+            <ConfigWarning keys={missingConfigKeys} />
+          )}
+          <div className="min-h-0 flex-1">{node}</div>
+        </div>
+      );
+    }
+    return missingConfigKeys.length > 0 ? (
       <div className="space-y-2">
         <ConfigWarning keys={missingConfigKeys} />
         {node}
@@ -1434,6 +1477,7 @@ export function SqlChart({
     ) : (
       node
     );
+  };
 
   if (chartType === "metric") {
     return withConfigWarning(<MetricRenderer rows={rows} panel={panel} />);

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

@@ -71,6 +71,9 @@ type SidebarDashboard = {
   resourceId?: string;
   visibility?: Visibility;
   ownerEmail?: string | null;
+  demo?: boolean;
+  /** Owner label, set only when another dashboard shares this title. */
+  ownerHint?: string;
   parentId?: string;
 };
 
@@ -486,6 +489,7 @@ function SortableRow({
   id,
   favoriteKey,
   name,
+  hint,
   href,
   isActive,
   favoriteIds,
@@ -504,6 +508,7 @@ function SortableRow({
   id: string;
   favoriteKey: string;
   name: string;
+  hint?: string;
   href: string;
   isActive: boolean;
   favoriteIds: Set<string>;
@@ -725,10 +730,17 @@ function SortableRow({
                 onTouchStart={onPrefetch}
                 className="min-w-0 flex-1 px-2 py-1.5 pe-12 text-xs transition-[padding] md:pe-2 md:group-hover/item:pe-12 md:group-focus-within/item:pe-12"
               >
-                <span className="block truncate">{name}</span>
+                <span className="block truncate">
+                  {name}
+                  {hint ? (
+                    <span className="text-muted-foreground"> · {hint}</span>
+                  ) : null}
+                </span>
               </Link>
             </TooltipTrigger>
-            <TooltipContent side="right">{name}</TooltipContent>
+            <TooltipContent side="right">
+              {hint ? `${name} · ${hint}` : name}
+            </TooltipContent>
           </Tooltip>
         )}
         <div className="pointer-events-none absolute end-1 top-1/2 flex -translate-y-1/2 items-center gap-0.5 opacity-100 transition-opacity md:opacity-0 md:group-hover/item:opacity-100 md:group-focus-within/item:opacity-100">
@@ -981,6 +993,7 @@ function SortableDashboardItem({
       id={d.id}
       favoriteKey={favoriteKey}
       name={d.name}
+      hint={d.ownerHint}
       href={href}
       isActive={isActive}
       favoriteIds={favoriteIds}
@@ -1182,6 +1195,7 @@ type SqlDashboardListItem = {
   name: string;
   visibility?: Visibility;
   ownerEmail?: string | null;
+  demo?: boolean;
   parentId?: string;
 };
 
@@ -1211,6 +1225,7 @@ async function fetchSqlDashboards(
             ? d.name
             : t("sidebar.untitledDashboard"),
         visibility: d.visibility as Visibility,
+        ...(d.demo === true ? { demo: true } : {}),
         ...(ownerEmail ? { ownerEmail } : {}),
         parentId:
           typeof d.parentId === "string" && d.parentId.trim().length > 0
@@ -1225,6 +1240,7 @@ async function fetchSidebarAnalyses(t: (key: string) => string): Promise<
     id: string;
     name: string;
     visibility: Visibility;
+    ownerEmail?: string;
     hiddenAt: string | null;
   }[]
 > {
@@ -1241,6 +1257,9 @@ async function fetchSidebarAnalyses(t: (key: string) => string): Promise<
         a.visibility === "org" || a.visibility === "public"
           ? a.visibility
           : ("private" as Visibility),
+      ...(typeof a.ownerEmail === "string" && a.ownerEmail
+        ? { ownerEmail: a.ownerEmail }
+        : {}),
       hiddenAt: typeof a.hiddenAt === "string" ? a.hiddenAt : null,
     }));
 }
@@ -1801,6 +1820,7 @@ export function Sidebar({ mobile }: { mobile?: boolean } = {}) {
       source: "sql",
       visibility: d.visibility,
       ownerEmail: d.ownerEmail,
+      demo: d.demo,
       parentId: d.parentId,
     }));
     const analysisItems: SidebarDashboard[] = analysesList.map((a) => ({
@@ -1809,6 +1829,7 @@ export function Sidebar({ mobile }: { mobile?: boolean } = {}) {
       name: a.name,
       source: "analysis",
       visibility: a.visibility,
+      ...(a.ownerEmail ? { ownerEmail: a.ownerEmail } : {}),
     }));
     const all = [...staticItems, ...sqlItems, ...analysisItems];
     if (dashboardSortMode === "alphabetical") {
@@ -1851,13 +1872,22 @@ export function Sidebar({ mobile }: { mobile?: boolean } = {}) {
     popularity,
   ]);
 
-  const filteredDashboards = useMemo(
-    () =>
-      visibleDashboards.filter((dashboard) =>
+  const filteredDashboards = useMemo(() => {
+    const titleCounts = new Map<string, number>();
+    for (const d of visibleDashboards) {
+      const key = d.name.trim().toLowerCase();
+      titleCounts.set(key, (titleCounts.get(key) ?? 0) + 1);
+    }
+    return visibleDashboards
+      .filter((dashboard) =>
         matchesVisibilityFilter(dashboard, dashFilter, auth?.email),
-      ),
-    [auth?.email, visibleDashboards, dashFilter],
-  );
+      )
+      .map((d) =>
+        d.ownerEmail && (titleCounts.get(d.name.trim().toLowerCase()) ?? 0) > 1
+          ? { ...d, ownerHint: d.ownerEmail.split("@")[0] }
+          : d,
+      );
+  }, [auth?.email, visibleDashboards, dashFilter]);
 
   const dashboardChildren = useMemo<Map<string, SidebarDashboard[]>>(() => {
     const byId = new Map(filteredDashboards.map((d) => [d.id, d]));

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

@@ -254,7 +254,7 @@ export default {
     visibilityPrivateOnly: "Mine",
     visibilitySharedOnly: "Shared",
     visibilityAllDescription: "Show all items",
-    visibilityPrivateOnlyDescription: "Show items visible only to you",
+    visibilityPrivateOnlyDescription: "Show items you created",
     visibilitySharedOnlyDescription: "Show org-shared and public items",
     hiddenAnalyses: "Hidden analyses",
     shareWithOrg: "Share with org",

package/corpus/templates/analytics/app/lib/dashboard-visibility.ts

@@ -4,6 +4,8 @@ export type DashboardVisibilityFilter = "all" | "private" | "shared";
 export type DashboardVisibilityItem = {
   visibility?: DashboardVisibility;
   ownerEmail?: string | null;
+  /** Sample content installed for the user; never theirs, never someone else's. */
+  demo?: boolean;
 };
 
 function normalizeEmail(email: string | null | undefined): string | null {
@@ -28,13 +30,26 @@ export function isDashboardMine(
   return true;
 }
 
+// Sidebar "Mine" means "I own it", whether or not I have shared it. The
+// Overview's personal/shared scope keeps `isDashboardMine`: it picks folders.
+function isOwnedByViewer(
+  item: DashboardVisibilityItem,
+  currentUserEmail?: string | null,
+): boolean {
+  if (!("ownerEmail" in item)) return item.visibility === "private";
+  const ownerEmail = normalizeEmail(item.ownerEmail);
+  const viewerEmail = normalizeEmail(currentUserEmail);
+  return Boolean(ownerEmail && viewerEmail && ownerEmail === viewerEmail);
+}
+
 export function matchesDashboardVisibilityFilter(
   item: DashboardVisibilityItem,
   filter: DashboardVisibilityFilter,
   currentUserEmail?: string | null,
 ): boolean {
   if (filter === "all") return true;
+  if (item.demo) return false;
   return filter === "private"
-    ? isDashboardMine(item, currentUserEmail)
-    : !isDashboardMine(item, currentUserEmail);
+    ? isOwnedByViewer(item, currentUserEmail)
+    : !isOwnedByViewer(item, currentUserEmail);
 }

package/corpus/templates/analytics/app/lib/sql-query.ts

@@ -4,7 +4,8 @@ import {
   MAX_CONCURRENT_FIRST_PARTY_SQL_QUERIES,
   MAX_CONCURRENT_SQL_QUERIES,
 } from "@shared/sql-query-limits";
-import { useQuery } from "@tanstack/react-query";
+import { useQuery, useQueryClient } from "@tanstack/react-query";
+import { useEffect, useRef } from "react";
 
 import type { DataSourceType } from "@/pages/adhoc/sql-dashboard/types";
 
@@ -138,7 +139,7 @@ export async function executeSqlQuery(
   sql: string,
   source: DataSourceType,
   signal?: AbortSignal,
-  options?: { reportScreenshot?: boolean },
+  options?: { reportScreenshot?: boolean; forceRefresh?: boolean },
 ): Promise<SqlQueryResult> {
   const deadline = createDeadlineSignal(
     signal,
@@ -150,7 +151,13 @@ export async function executeSqlQuery(
     release = await acquireSqlQuerySlot(source, deadline.signal);
     data = await callAction<DashboardPanelQueryResponse>(
       "query-dashboard-panel",
-      { query: sql, source },
+      {
+        query: sql,
+        source,
+        ...(options?.forceRefresh && source === "bigquery"
+          ? { forceRefresh: true }
+          : {}),
+      },
       {
         signal: deadline.signal,
         timeoutMs: DASHBOARD_REPORT_ACTION_TIMEOUT_MS,
@@ -191,16 +198,36 @@ export function useSqlQuery(
     refetchOnWindowFocus?: boolean | "always";
     retry?: boolean | number;
     reportScreenshot?: boolean;
+    refreshToken?: number;
     staleTime?: number;
   },
 ) {
-  return useQuery<SqlQueryResult>({
+  const successfulRefreshToken = useRef(0);
+  const refreshToken = options?.refreshToken ?? 0;
+  const enabled = options?.enabled ?? true;
+  const latestRefreshToken = useRef(refreshToken);
+  const latestStartedRefreshToken = useRef(refreshToken);
+  latestRefreshToken.current = refreshToken;
+  const previousRefreshToken = useRef(refreshToken);
+  const previousEnabled = useRef(enabled);
+  const queryClient = useQueryClient();
+  const query = useQuery<SqlQueryResult>({
     queryKey,
-    queryFn: ({ signal }) =>
-      executeSqlQuery(sql, source, signal, {
+    queryFn: async ({ signal }) => {
+      const currentRefreshToken = latestRefreshToken.current;
+      latestStartedRefreshToken.current = currentRefreshToken;
+      const forceRefresh = currentRefreshToken > successfulRefreshToken.current;
+      const result = await executeSqlQuery(sql, source, signal, {
         reportScreenshot: options?.reportScreenshot,
-      }),
-    enabled: options?.enabled ?? true,
+        forceRefresh,
+      });
+      successfulRefreshToken.current = Math.max(
+        successfulRefreshToken.current,
+        currentRefreshToken,
+      );
+      return result;
+    },
+    enabled,
     refetchInterval: options?.refetchInterval,
     refetchOnMount: options?.refetchOnMount ?? false,
     refetchOnReconnect: options?.refetchOnReconnect ?? false,
@@ -208,4 +235,29 @@ export function useSqlQuery(
     retry: options?.retry ?? false,
     staleTime: options?.staleTime ?? 5 * 60 * 1000,
   });
+  const refetch = query.refetch;
+
+  useEffect(() => {
+    const wasEnabled = previousEnabled.current;
+    previousEnabled.current = enabled;
+    const refreshTokenChanged = refreshToken > previousRefreshToken.current;
+    previousRefreshToken.current = refreshToken;
+    if (!enabled) return;
+    const enablingPendingRefresh =
+      !wasEnabled && refreshToken > successfulRefreshToken.current;
+    if (
+      (!refreshTokenChanged && !enablingPendingRefresh) ||
+      refreshToken <= successfulRefreshToken.current
+    ) {
+      return;
+    }
+    if (query.isFetching && latestStartedRefreshToken.current >= refreshToken) {
+      return;
+    }
+    void queryClient
+      .cancelQueries({ queryKey, exact: true })
+      .then(() => refetch());
+  }, [enabled, query.isFetching, queryClient, queryKey, refetch, refreshToken]);
+
+  return query;
 }

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

@@ -16,8 +16,7 @@ import {
   IconBrandGoogle,
   IconArrowUpRight,
 } from "@tabler/icons-react";
-import { useQueryClient } from "@tanstack/react-query";
-import { memo, useCallback, useEffect, useMemo, useRef, useState } from "react";
+import { memo, useCallback, useEffect, useRef, useState } from "react";
 import { toast } from "sonner";
 
 import { ChartFillHeight, SqlChart } from "@/components/dashboard/SqlChart";
@@ -62,7 +61,6 @@ import type { SelectDashboardPanelOptions } from "@/hooks/use-dashboard-chat-con
 import { buildCustomBlockPromotionRequest } from "@/lib/custom-block-promotion";
 import { cn } from "@/lib/utils";
 
-import { serializePanelSql } from "./panel-sql";
 import { timeRangeDays } from "./pivot";
 import type { DashboardFilter, SqlPanel } from "./types";
 import { ViewSqlPopover } from "./ViewSqlPopover";
@@ -152,7 +150,6 @@ export function SqlChartCard({
 }: SqlChartCardProps) {
   const t = useT();
   const timeRange = timeRangeDays(filters?.timeRange);
-  const queryClient = useQueryClient();
   const exportToGoogleSheets = useActionMutation(
     "export-dashboard-panel-to-google-sheet",
   );
@@ -172,17 +169,8 @@ export function SqlChartCard({
       panel.chartType === "section" ||
       panel.chartType === "extension",
   );
+  const [refreshToken, setRefreshToken] = useState(0);
   const cardRef = useRef<HTMLDivElement | null>(null);
-  const chartQueryKey = useMemo(
-    () =>
-      [
-        "sql-chart",
-        dashboardId || panel.id,
-        serializePanelSql(resolvedSql ?? panel.sql),
-        panel.source,
-      ] as const,
-    [dashboardId, panel.id, panel.source, panel.sql, resolvedSql],
-  );
   const setCardNodeRef = useCallback((node: HTMLDivElement | null) => {
     cardRef.current = node;
   }, []);
@@ -210,10 +198,8 @@ export function SqlChartCard({
 
   const handleRefresh = useCallback(() => {
     setShouldLoadData(true);
-    void queryClient.invalidateQueries({
-      queryKey: chartQueryKey,
-    });
-  }, [chartQueryKey, queryClient]);
+    setRefreshToken((token) => token + 1);
+  }, []);
 
   const handleExportToGoogleSheets = useCallback(async () => {
     if (!dashboardId || panel.chartType !== "table") return;
@@ -784,6 +770,8 @@ export function SqlChartCard({
             loadData={shouldLoadData}
             timeRange={timeRange}
             reportScreenshot={reportScreenshot}
+            refreshToken={refreshToken}
+            onRefreshRequested={handleRefresh}
             dashboardId={dashboardId}
             onExportCsvChange={handleExportCsvChange}
             onCopyTableChange={handleCopyTableChange}
@@ -805,6 +793,8 @@ export function SqlChartCard({
                 loadData
                 timeRange={timeRange}
                 reportScreenshot={reportScreenshot}
+                refreshToken={refreshToken}
+                onRefreshRequested={handleRefresh}
                 dashboardId={dashboardId}
                 extensionContext={extensionContext}
               />

package/corpus/templates/analytics/changelog/2026-10-06-dashboard-filter-mine-now-lists-every-dashboard-you-own-incl.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-10-06
+---
+
+Dashboard filter "Mine" now lists every dashboard you own (including ones you've shared) and no longer includes installed demos or items shared with you

package/corpus/templates/analytics/changelog/2026-10-06-refreshing-a-bigquery-dashboard-panel-fetches-current-data.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-10-06
+---
+
+Refreshing a BigQuery dashboard panel now fetches current data.

package/corpus/templates/analytics/server/db/schema.ts

@@ -182,6 +182,11 @@ export const bigqueryCache = table("bigquery_cache", {
   bytesProcessed: integer("bytes_processed").notNull().default(0),
   createdAt: text("created_at").notNull(),
   expiresAt: text("expires_at").notNull(),
+  generation: integer("generation").notNull().default(0),
+  fenceToken: text("fence_token"),
+  refreshInProgress: boolean("refresh_in_progress").notNull().default(false),
+  refreshForced: boolean("refresh_forced").notNull().default(false),
+  refreshStartedAt: text("refresh_started_at"),
 });
 
 export const firstPartyAnalyticsCache = table("first_party_analytics_cache", {