@agent-native/core 0.115.4 → 0.117.0

package/corpus/core/src/templates/workspace-core/.agents/skills/real-time-sync/SKILL.md

@@ -72,7 +72,7 @@ The agent modifies data in SQL, but the UI runs in the browser. SSE bridges same
   });
   ```
 
-  `useDbSync` and every `subscribeSyncEvents` subscriber share one `EventSource` and one fallback poll loop per tab — this is how collaborative documents receive doc updates and cursor/awareness events.
+  `useDbSync` and every `subscribeSyncEvents` subscriber share one `EventSource` and one fallback poll loop per tab — this is how collaborative documents receive doc updates and cursor/awareness events. Hidden tabs keep that shared transport alive by default: SSE stays connected and active fallback polling relaxes to a 10-second floor (idle polling remains once per minute). Pass `pauseWhenHidden: true` only for a consumer that explicitly must stop all hidden-tab sync.
 
 ## Which sources to depend on
 

package/corpus/core/src/templates/workspace-core/.agents/skills/voice-transcription/SKILL.md

@@ -24,9 +24,10 @@ shared agent sidebar.
 - **Always show the mic alongside the send button.** Cursor replaces send
   with mic when the composer is empty; their users complain. We keep both
   visible — Lovable does the same.
-- **Ask before switching modes.** The mic opens a shadcn popover offering
-  **Start voice mode** and **Keep dictating**; never silently replace the
-  established dictation behavior.
+- **Ask before switching modes.** The mic opens a compact shadcn popover with
+  **Real-time voice** as the primary action and **Dictate** as the secondary;
+  never silently replace the established dictation behavior. Users can choose
+  **Remember my preference** to skip the chooser on later clicks.
 - **Dictation is click-to-toggle, not push-to-talk.** More forgiving in a sidebar, avoids
   host-app hotkey clashes. Keyboard shortcut is `Cmd/Ctrl+Shift+M` and
   `Escape` cancels mid-recording.
@@ -100,6 +101,9 @@ action before requesting microphone permission.
   `application_state["realtime-voice-prefs"]`. Keep this separate from
   `voice-transcription-prefs`, which configures editable dictation rather than
   the speech-to-speech session.
+- Store the optional remembered chooser selection at
+  `application_state["voice-input-preference"]`. Keep it separate from both
+  mode-specific preference objects.
 - Missing-key failures should open Settings focused on the user-scoped
   `OPENAI_API_KEY` field. Never send, log, or echo the key to the browser.
 
@@ -147,11 +151,11 @@ Default behavior:
 
 | File                                                                  | Purpose                                             |
 | --------------------------------------------------------------------- | --------------------------------------------------- |
-| `packages/core/src/client/composer/useVoiceDictation.ts`              | Provider-routing hook (MediaRecorder / Web Speech)  |
-| `packages/core/src/client/composer/VoiceButton.tsx`                   | Mic button + live amplitude + cancel overlay        |
-| `packages/core/src/client/composer/RealtimeVoiceMode.tsx`            | Opt-in popover + persistent speech orb              |
-| `packages/core/src/client/composer/useRealtimeVoiceMode.tsx`         | WebRTC lifecycle, provider events, and tool bridge  |
-| `packages/core/src/client/composer/TiptapComposer.tsx`                | Wires the hook, insertion, and keyboard shortcut    |
+| `packages/toolkit/src/composer/useVoiceDictation.ts`                  | Provider-routing hook (MediaRecorder / Web Speech)  |
+| `packages/toolkit/src/composer/VoiceButton.tsx`                       | Mic button + live amplitude + cancel overlay        |
+| `packages/toolkit/src/composer/RealtimeVoiceMode.tsx`                | Opt-in popover + persistent speech orb              |
+| `packages/toolkit/src/composer/useRealtimeVoiceMode.tsx`             | WebRTC lifecycle, provider events, and tool bridge  |
+| `packages/toolkit/src/composer/TiptapComposer.tsx`                    | Wires the hook, insertion, and keyboard shortcut    |
 | `packages/core/src/client/settings/VoiceTranscriptionSection.tsx`     | Live source + cleanup controls in sidebar settings  |
 | `packages/core/src/client/transcription/BuilderTranscriptionCta.tsx`  | CTA shown when Builder account isn't connected      |
 | `packages/core/src/client/transcription/use-live-transcription.ts`    | Web Speech live-transcription hook for recordings   |

package/corpus/templates/analytics/.agents/skills/agent-native-toolkit/SKILL.md

@@ -85,7 +85,10 @@ in the moment of agent use.
   approval, generative UI, progress, and screen-state exposure.
 - **Chat history kit**: presentational chat lists and recent-chat rails belong
   in Toolkit; Core keeps thread persistence, agent execution, transport, and
-  page-to-sidebar handoff. Apps inject routing, labels, and domain actions.
+  page-to-sidebar handoff. Use Toolkit's `ChatHistoryRail` for the standard
+  five-item sidebar preview and a footer row with New chat followed by an
+  ellipsis disclosure up to fifteen. Apps inject routing, labels, and domain
+  actions.
 - **Agent page kit**: the full-page `/agent` surface (`AgentTabsPage` from
   `@agent-native/core/client`) with Context, Files, Connections, Jobs, and
   Access tabs plus a Personal/Organization scope toggle. The canonical home

package/corpus/templates/analytics/.agents/skills/real-time-sync/SKILL.md

@@ -72,7 +72,7 @@ The agent modifies data in SQL, but the UI runs in the browser. SSE bridges same
   });
   ```
 
-  `useDbSync` and every `subscribeSyncEvents` subscriber share one `EventSource` and one fallback poll loop per tab — this is how collaborative documents receive doc updates and cursor/awareness events.
+  `useDbSync` and every `subscribeSyncEvents` subscriber share one `EventSource` and one fallback poll loop per tab — this is how collaborative documents receive doc updates and cursor/awareness events. Hidden tabs keep that shared transport alive by default: SSE stays connected and active fallback polling relaxes to a 10-second floor (idle polling remains once per minute). Pass `pauseWhenHidden: true` only for a consumer that explicitly must stop all hidden-tab sync.
 
 ## Which sources to depend on
 

package/corpus/templates/analytics/AGENTS.md

@@ -228,11 +228,16 @@ membership id when its native update status reports `update-available`.
   `dashboard-report-subscriptions` actions. They send daily snapshots scoped to
   the exact user/org context that created the subscription with saved URL
   filters; do not hand-wire custom email routes around that action surface.
+- Table panels can be exported with `export-dashboard-panel-to-google-sheet`.
+  The action re-runs the accessible panel query with the dashboard's current
+  filter variables, creates a new Sheet through the connected Google Drive
+  workspace connection, and returns its URL plus bounded export metadata.
   Report PNGs are Playwright captures of the real dashboard route in
   `reportScreenshot=1` mode, authenticated by a short-lived embed-session token
   and embedded inline in email as ordered CID images. Complete dashboards are
-  captured sequentially in bounded panel windows; every window must match the
-  panel ids snapshotted at the start, and a failed or mismatched window
+  captured sequentially in four-panel windows matching the browser's four-query
+  concurrency limit; every window must match the panel ids snapshotted at the
+  start, and a failed or mismatched window
   invalidates the entire image set so the scheduler can retry instead of
   sending a partial report. Capture is capped at 10 windows and 14 MiB of raw
   PNG data, and subscriptions are capped at five distinct recipients; use a

package/corpus/templates/analytics/actions/export-dashboard-panel-to-google-sheet.ts

@@ -0,0 +1,144 @@
+import { defineAction } from "@agent-native/core/action";
+import { getCredentialContext } from "@agent-native/core/server/request-context";
+import { z } from "zod";
+
+import { interpolate } from "../app/pages/adhoc/sql-dashboard/interpolate";
+import {
+  isDashboardPanelSource,
+  normalizeDashboardPanelQuery,
+} from "../server/lib/dashboard-panel-query";
+import { resolveAnalyticsPanelSource } from "../server/lib/dashboard-panel-source-resolver";
+import { getDashboard } from "../server/lib/dashboards-store";
+import { exportDashboardPanelToGoogleSheet } from "../server/lib/google-sheets-export";
+
+type DashboardPanel = {
+  id?: unknown;
+  title?: unknown;
+  sql?: unknown;
+  source?: unknown;
+  chartType?: unknown;
+};
+
+const MAX_EXPORT_ROWS = 10_000;
+const MAX_EXPORT_CELLS = 500_000;
+
+function asPanels(config: Record<string, unknown>): DashboardPanel[] {
+  return Array.isArray(config.panels)
+    ? config.panels.filter(
+        (panel): panel is DashboardPanel =>
+          Boolean(panel) && typeof panel === "object" && !Array.isArray(panel),
+      )
+    : [];
+}
+
+function missingKeyMessage(result: unknown): string | null {
+  if (!result || typeof result !== "object" || Array.isArray(result)) {
+    return null;
+  }
+  const value = result as { error?: unknown; message?: unknown };
+  return value.error === "missing_api_key" && typeof value.message === "string"
+    ? value.message
+    : null;
+}
+
+export default defineAction({
+  description:
+    "Export one accessible Analytics SQL dashboard table panel's underlying query results to a newly created Google Sheet using the connected Google Drive account. Returns the Sheet URL, spreadsheet id, row count, and export metadata. Only chartType=table panels are supported.",
+  schema: z.object({
+    dashboardId: z.string().trim().min(1).describe("The SQL dashboard ID"),
+    panelId: z.string().trim().min(1).describe("The table panel ID"),
+    filters: z.record(z.string(), z.string()).optional().default({}),
+  }),
+  http: { method: "POST" },
+  needsApproval: true,
+  toolCallable: false,
+  run: async ({ dashboardId, panelId, filters }) => {
+    const context = getCredentialContext();
+    if (!context) {
+      throw new Error(
+        "No authenticated context for export-dashboard-panel-to-google-sheet.",
+      );
+    }
+
+    const dashboard = await getDashboard(dashboardId, {
+      email: context.userEmail,
+      orgId: context.orgId ?? null,
+    });
+    if (!dashboard || dashboard.kind !== "sql") {
+      throw Object.assign(new Error("Dashboard not found"), {
+        statusCode: 404,
+      });
+    }
+
+    const panel = asPanels(dashboard.config).find(
+      (candidate) => candidate.id === panelId,
+    );
+    if (!panel) {
+      throw Object.assign(new Error("Dashboard panel not found"), {
+        statusCode: 404,
+      });
+    }
+    if (panel.chartType !== "table") {
+      throw new Error("Only table dashboard panels can be exported.");
+    }
+    if (!isDashboardPanelSource(panel.source)) {
+      throw new Error("Dashboard panel has an unsupported data source.");
+    }
+    if (typeof panel.sql !== "string" && typeof panel.sql !== "object") {
+      throw new Error("Dashboard panel has no query to export.");
+    }
+
+    const rawQuery =
+      typeof panel.sql === "string"
+        ? interpolate(panel.sql, filters, { failClosedTimeVariables: true })
+        : panel.sql;
+    const query = normalizeDashboardPanelQuery(panel.source, rawQuery);
+    const result = await resolveAnalyticsPanelSource(
+      { source: panel.source, query },
+      context,
+    );
+    const missing = missingKeyMessage(result);
+    if (missing) throw new Error(missing);
+    if (
+      !result ||
+      typeof result !== "object" ||
+      Array.isArray(result) ||
+      !("rows" in result) ||
+      !Array.isArray(result.rows)
+    ) {
+      throw new Error("Dashboard panel query returned an invalid result.");
+    }
+    const queryResult = result;
+    const columnCount = Array.isArray(queryResult.schema)
+      ? queryResult.schema.length
+      : Object.keys(queryResult.rows[0] ?? {}).length;
+    if (queryResult.rows.length > MAX_EXPORT_ROWS) {
+      throw new Error(
+        `This panel returned more than ${MAX_EXPORT_ROWS.toLocaleString()} rows. Narrow the dashboard filters before exporting.`,
+      );
+    }
+    if (queryResult.rows.length * columnCount > MAX_EXPORT_CELLS) {
+      throw new Error(
+        "This panel result is too wide to export safely. Narrow the query or reduce its columns.",
+      );
+    }
+
+    return exportDashboardPanelToGoogleSheet({
+      dashboardId,
+      dashboardTitle:
+        typeof dashboard.title === "string" && dashboard.title.trim()
+          ? dashboard.title
+          : "Analytics dashboard",
+      panelId,
+      panelTitle:
+        typeof panel.title === "string" && panel.title.trim()
+          ? panel.title
+          : panelId,
+      source: panel.source,
+      rows: queryResult.rows,
+      schema: Array.isArray(queryResult.schema) ? queryResult.schema : [],
+      truncated: queryResult.truncated,
+      bytesProcessed: queryResult.bytesProcessed,
+    });
+  },
+});

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

@@ -2,12 +2,11 @@ import {
   AgentSidebar,
   GuidedQuestionFlow,
   focusAgentChat,
-  markAgentChatHomeHandoff,
   navigateWithAgentChatViewTransition,
   useAgentChatHomeHandoff,
+  useAgentChatHomeHandoffLinks,
   useGuidedQuestionFlow,
 } from "@agent-native/core/client/agent-chat";
-import { appBasePath } from "@agent-native/core/client/api-path";
 import { useT } from "@agent-native/core/client/i18n";
 import { InvitationBanner } from "@agent-native/core/client/org";
 import { CreativeContextComposerChip } from "@agent-native/creative-context/client";
@@ -17,7 +16,6 @@ import { useLocation, useNavigate } from "react-router";
 import { useNavigationState } from "@/hooks/use-navigation-state";
 import {
   ANALYTICS_CHAT_STORAGE_KEY,
-  hasRecentAnalyticsChat,
   markAnalyticsChatActivity,
 } from "@/lib/chat-handoff";
 import { TAB_ID } from "@/lib/tab-id";
@@ -37,59 +35,6 @@ interface LayoutProps {
 
 const BARE_ROUTES = new Set(["/chart"]);
 
-function stripBasePath(path: string): string {
-  const basePath = appBasePath();
-  if (!basePath) return path;
-  if (path === basePath) return "/";
-  if (path.startsWith(`${basePath}/`)) return path.slice(basePath.length);
-  if (path.startsWith(`${basePath}?`) || path.startsWith(`${basePath}#`)) {
-    return `/${path.slice(basePath.length)}`;
-  }
-  return path;
-}
-
-function pathnameFromLocalPath(path: string): string {
-  return path.split(/[?#]/, 1)[0] || "/";
-}
-
-function isFrameworkOrApiPath(pathname: string): boolean {
-  return (
-    pathname === "/_agent-native" ||
-    pathname.startsWith("/_agent-native/") ||
-    pathname === "/api" ||
-    pathname.startsWith("/api/")
-  );
-}
-
-function isStaticAssetPath(pathname: string): boolean {
-  const lastSegment = pathname.split("/").pop() ?? "";
-  return /\.[A-Za-z0-9]{1,12}$/.test(lastSegment);
-}
-
-function localPathFromAnchor(anchor: HTMLAnchorElement): string | null {
-  if (!anchor.href) return null;
-  try {
-    const url = new URL(anchor.href);
-    if (url.origin !== window.location.origin) return null;
-    return stripBasePath(`${url.pathname}${url.search}${url.hash}`);
-  } catch {
-    return null;
-  }
-}
-
-function shouldHandleAnchorClick(
-  event: MouseEvent,
-  anchor: HTMLAnchorElement,
-): boolean {
-  if (event.defaultPrevented || event.button !== 0) return false;
-  if (event.metaKey || event.ctrlKey || event.shiftKey || event.altKey) {
-    return false;
-  }
-  if (anchor.target && anchor.target !== "_self") return false;
-  if (anchor.hasAttribute("download")) return false;
-  return true;
-}
-
 export function Layout({ children }: LayoutProps) {
   useNavigationState();
   const location = useLocation();
@@ -163,6 +108,12 @@ export function Layout({ children }: LayoutProps) {
     activePath: location.pathname,
     enabled: !isAskRoute && !reportScreenshot,
   });
+  useAgentChatHomeHandoffLinks({
+    storageKey: ANALYTICS_CHAT_STORAGE_KEY,
+    chatPath: "/ask",
+    enabled: !reportScreenshot,
+    requireActiveHandoff: false,
+  });
   useEffect(() => {
     function handleChatRunning(event: Event) {
       const detail = (event as CustomEvent).detail;
@@ -176,38 +127,6 @@ export function Layout({ children }: LayoutProps) {
       window.removeEventListener("agentNative.chatRunning", handleChatRunning);
   }, []);
 
-  useEffect(() => {
-    if (!isAskRoute) return;
-
-    function handleClick(event: MouseEvent) {
-      const target = event.target;
-      if (!(target instanceof Element)) return;
-      const anchor = target.closest("a[href]");
-      if (!(anchor instanceof HTMLAnchorElement)) return;
-      if (!shouldHandleAnchorClick(event, anchor)) return;
-      if (anchor.closest(".agent-panel-root")) return;
-
-      const path = localPathFromAnchor(anchor);
-      const pathname = path ? pathnameFromLocalPath(path) : "";
-      if (
-        !path ||
-        pathname === "/ask" ||
-        isFrameworkOrApiPath(pathname) ||
-        isStaticAssetPath(pathname) ||
-        !hasRecentAnalyticsChat()
-      ) {
-        return;
-      }
-
-      event.preventDefault();
-      markAgentChatHomeHandoff(ANALYTICS_CHAT_STORAGE_KEY);
-      navigateWithAgentChatViewTransition(navigate, path);
-    }
-
-    document.addEventListener("click", handleClick, true);
-    return () => document.removeEventListener("click", handleClick, true);
-  }, [isAskRoute, navigate]);
-
   function openAskAgentFullscreen() {
     focusAgentChat();
     navigateWithAgentChatViewTransition(navigate, "/ask");

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

@@ -98,7 +98,7 @@ import { LanguagePicker, useT } from "@agent-native/core/client/i18n";
 import { OrgSwitcher } from "@agent-native/core/client/org";
 import { FeedbackButton } from "@agent-native/core/client/ui";
 import {
-  ChatHistoryList,
+  ChatHistoryRail,
   type ChatHistoryItem,
 } from "@agent-native/toolkit/chat-history";
 
@@ -1334,7 +1334,7 @@ function AnalyticsChatsSection({ isAskRoute }: { isAskRoute: boolean }) {
       threads
         .filter((thread) => thread.messageCount > 0 && !thread.archivedAt)
         .sort(compareThreads)
-        .slice(0, SIDEBAR_PREVIEW_COUNT),
+        .slice(0, 15),
     [threads],
   );
   const chatItems = useMemo<ChatHistoryItem[]>(
@@ -1433,40 +1433,37 @@ function AnalyticsChatsSection({ isAskRoute }: { isAskRoute: boolean }) {
             />
           </div>
         ))}
-      {visibleThreads.length > 0 && (
-        <ChatHistoryList
-          items={chatItems}
-          activeId={displayedActiveThreadId}
-          onSelect={(threadId) => openThread(threadId)}
-          renameMaxLength={160}
-          onTogglePin={(threadId) => {
-            const thread = visibleThreads.find((item) => item.id === threadId);
-            if (thread) void pinThread(threadId, !thread.pinnedAt);
-          }}
-          onRename={handleRenameThread}
-          onDelete={(threadId) => void handleArchiveThread(threadId)}
-          labels={{
-            options: (item) =>
-              t("chat.optionsFor", { title: item.titleText ?? "" }),
-            renameInput: (item) =>
-              t("chat.renameThread", { title: item.titleText ?? "" }),
-            rename: t("chat.renameChat"),
-            pin: t("chat.pinChat"),
-            unpin: t("chat.unpinChat"),
-            delete: t("chat.archiveChat"),
-          }}
-          variant="rail"
-          className="min-w-0"
-        />
-      )}
-      <button
-        type="button"
-        onClick={() => void handleNewChat()}
-        className="flex w-full cursor-pointer items-center gap-2 rounded-lg px-3 py-1.5 text-xs text-muted-foreground/60 hover:bg-sidebar-accent/50 hover:text-primary"
-      >
-        <IconPlus className="h-3 w-3" />
-        {t("chat.newChat")}
-      </button>
+      <ChatHistoryRail
+        items={chatItems}
+        activeId={displayedActiveThreadId}
+        onSelect={(threadId) => openThread(threadId)}
+        onNewChat={() => void handleNewChat()}
+        railLabels={{
+          newChat: t("chat.newChat"),
+          showMore: t("sidebar.showMore", {
+            count: Math.max(0, visibleThreads.length - SIDEBAR_PREVIEW_COUNT),
+          }),
+          showLess: t("sidebar.showLess"),
+        }}
+        renameMaxLength={160}
+        onTogglePin={(threadId) => {
+          const thread = visibleThreads.find((item) => item.id === threadId);
+          if (thread) void pinThread(threadId, !thread.pinnedAt);
+        }}
+        onRename={handleRenameThread}
+        onDelete={(threadId) => void handleArchiveThread(threadId)}
+        labels={{
+          options: (item) =>
+            t("chat.optionsFor", { title: item.titleText ?? "" }),
+          renameInput: (item) =>
+            t("chat.renameThread", { title: item.titleText ?? "" }),
+          rename: t("chat.renameChat"),
+          pin: t("chat.pinChat"),
+          unpin: t("chat.unpinChat"),
+          delete: t("chat.archiveChat"),
+        }}
+        className="min-w-0"
+      />
     </div>
   );
 }
@@ -2936,7 +2933,7 @@ export function Sidebar({ mobile }: { mobile?: boolean } = {}) {
               <div className="space-y-2 pt-2">
                 <OrgSwitcher />
                 <TooltipProvider delayDuration={200}>
-                  <div className="flex items-center gap-1">
+                  <div className="flex items-center justify-end gap-1">
                     <DevDatabaseLink />
                     <FeedbackButton className="min-w-0 flex-1" />
                     <div className="flex shrink-0 items-center gap-0.5">

package/corpus/templates/analytics/app/global.css

@@ -149,10 +149,6 @@
   background-color: hsl(var(--background)) !important;
 }
 
-.analytics-chat-panel .agent-thread-content {
-  padding-top: 4.5rem;
-}
-
 .analytics-chat-panel
   [data-agent-page-chat-scrolled]
   [data-agent-page-chat-fade] {

package/corpus/templates/analytics/app/hooks/use-navigation-state.ts

@@ -2,10 +2,7 @@ import { markAgentChatHomeHandoff } from "@agent-native/core/client/agent-chat";
 import { useAgentRouteState } from "@agent-native/core/client/navigation";
 import { useLocation } from "react-router";
 
-import {
-  ANALYTICS_CHAT_STORAGE_KEY,
-  hasRecentAnalyticsChat,
-} from "@/lib/chat-handoff";
+import { ANALYTICS_CHAT_STORAGE_KEY } from "@/lib/chat-handoff";
 import { rememberLastOpened } from "@/lib/last-opened";
 import { TAB_ID } from "@/lib/tab-id";
 
@@ -161,9 +158,7 @@ export function useNavigationState() {
     },
     onNavigate: (_command, path) => {
       if (location.pathname === "/ask" && pathnameFromPath(path) !== "/ask") {
-        if (hasRecentAnalyticsChat()) {
-          markAgentChatHomeHandoff(ANALYTICS_CHAT_STORAGE_KEY);
-        }
+        markAgentChatHomeHandoff(ANALYTICS_CHAT_STORAGE_KEY);
       }
     },
   });