@agent-native/core 0.97.0 → 0.98.1

package/corpus/templates/clips/app/components/workspace/insights-hub.tsx

@@ -1,5 +1,10 @@
 import { appBasePath, useActionQuery, useT } from "@agent-native/core/client";
-import { IconChartLine, IconDownload, IconUsers } from "@tabler/icons-react";
+import {
+  IconAlertTriangle,
+  IconChartLine,
+  IconDownload,
+  IconUsers,
+} from "@tabler/icons-react";
 import { useMemo, useState } from "react";
 
 import { PageHeader } from "@/components/library/page-header";
@@ -50,10 +55,10 @@ interface InsightsResponse {
 export function InsightsHub() {
   const t = useT();
   const [days, setDays] = useState("30");
-  const { data, isLoading } = useActionQuery<InsightsResponse>(
-    "get-organization-insights",
-    { days: Number(days) } as any,
-  );
+  const { data, isLoading, isError, isFetching, refetch } =
+    useActionQuery<InsightsResponse>("get-organization-insights", {
+      days: Number(days),
+    } as any);
 
   const totals = data?.totals ?? {
     views: 0,
@@ -99,99 +104,118 @@ export function InsightsHub() {
           {t("insightsHub.description", { days })}
         </p>
 
-        <div className="grid grid-cols-2 md:grid-cols-4 gap-3">
-          <StatCard
-            label={t("insightsHub.views")}
-            value={totals.views}
-            loading={isLoading}
-          />
-          <StatCard
-            label={t("insightsHub.reactions")}
-            value={totals.reactions}
-            loading={isLoading}
-          />
-          <StatCard
-            label={t("insightsHub.comments")}
-            value={totals.comments}
-            loading={isLoading}
-          />
-          <StatCard
-            label={t("insightsHub.recordings")}
-            value={totals.recordings}
-            loading={isLoading}
-          />
-        </div>
+        {isError ? (
+          <div className="flex flex-col items-center gap-3 rounded-lg border border-destructive/30 px-6 py-16 text-center">
+            <IconAlertTriangle className="size-9 text-destructive" />
+            <p className="text-sm font-medium">
+              {t("libraryGrid.loadFailedTitle")}
+            </p>
+            <Button
+              size="sm"
+              variant="outline"
+              onClick={() => void refetch()}
+              disabled={isFetching}
+            >
+              {t("libraryGrid.retry")}
+            </Button>
+          </div>
+        ) : (
+          <>
+            <div className="grid grid-cols-2 md:grid-cols-4 gap-3">
+              <StatCard
+                label={t("insightsHub.views")}
+                value={totals.views}
+                loading={isLoading}
+              />
+              <StatCard
+                label={t("insightsHub.reactions")}
+                value={totals.reactions}
+                loading={isLoading}
+              />
+              <StatCard
+                label={t("insightsHub.comments")}
+                value={totals.comments}
+                loading={isLoading}
+              />
+              <StatCard
+                label={t("insightsHub.recordings")}
+                value={totals.recordings}
+                loading={isLoading}
+              />
+            </div>
 
-        <Card>
-          <CardHeader className="pb-3">
-            <CardTitle className="text-base flex items-center gap-2">
-              <IconChartLine className="size-4 text-primary" />
-              {t("insightsHub.engagementTrend")}
-            </CardTitle>
-          </CardHeader>
-          <CardContent>
-            {isLoading ? (
-              <Skeleton className="h-64 w-full" />
-            ) : (
-              <EngagementChart data={data?.trend ?? []} />
-            )}
-          </CardContent>
-        </Card>
+            <Card>
+              <CardHeader className="pb-3">
+                <CardTitle className="text-base flex items-center gap-2">
+                  <IconChartLine className="size-4 text-primary" />
+                  {t("insightsHub.engagementTrend")}
+                </CardTitle>
+              </CardHeader>
+              <CardContent>
+                {isLoading ? (
+                  <Skeleton className="h-64 w-full" />
+                ) : (
+                  <EngagementChart data={data?.trend ?? []} />
+                )}
+              </CardContent>
+            </Card>
 
-        <div className="grid grid-cols-1 md:grid-cols-2 gap-6">
-          <Card>
-            <CardHeader className="pb-3">
-              <CardTitle className="text-base">
-                {t("insightsHub.topVideos")}
-              </CardTitle>
-            </CardHeader>
-            <CardContent>
-              <Tabs defaultValue="views">
-                <TabsList>
-                  <TabsTrigger value="views">
-                    {t("insightsHub.views")}
-                  </TabsTrigger>
-                  <TabsTrigger value="reactions">
-                    {t("insightsHub.reactions")}
-                  </TabsTrigger>
-                  <TabsTrigger value="comments">
-                    {t("insightsHub.comments")}
-                  </TabsTrigger>
-                </TabsList>
-                <TabsContent value="views" className="pt-3">
-                  <TopVideosTable
-                    rows={data?.topVideos.byViews ?? []}
-                    metricLabel={t("insightsHub.views")}
-                  />
-                </TabsContent>
-                <TabsContent value="reactions" className="pt-3">
-                  <TopVideosTable
-                    rows={data?.topVideos.byReactions ?? []}
-                    metricLabel={t("insightsHub.reactions")}
-                  />
-                </TabsContent>
-                <TabsContent value="comments" className="pt-3">
-                  <TopVideosTable
-                    rows={data?.topVideos.byComments ?? []}
-                    metricLabel={t("insightsHub.comments")}
-                  />
-                </TabsContent>
-              </Tabs>
-            </CardContent>
-          </Card>
+            <div className="grid grid-cols-1 md:grid-cols-2 gap-6">
+              <Card>
+                <CardHeader className="pb-3">
+                  <CardTitle className="text-base">
+                    {t("insightsHub.topVideos")}
+                  </CardTitle>
+                </CardHeader>
+                <CardContent>
+                  <Tabs defaultValue="views">
+                    <TabsList>
+                      <TabsTrigger value="views">
+                        {t("insightsHub.views")}
+                      </TabsTrigger>
+                      <TabsTrigger value="reactions">
+                        {t("insightsHub.reactions")}
+                      </TabsTrigger>
+                      <TabsTrigger value="comments">
+                        {t("insightsHub.comments")}
+                      </TabsTrigger>
+                    </TabsList>
+                    <TabsContent value="views" className="pt-3">
+                      <TopVideosTable
+                        rows={data?.topVideos.byViews ?? []}
+                        metricLabel={t("insightsHub.views")}
+                      />
+                    </TabsContent>
+                    <TabsContent value="reactions" className="pt-3">
+                      <TopVideosTable
+                        rows={data?.topVideos.byReactions ?? []}
+                        metricLabel={t("insightsHub.reactions")}
+                      />
+                    </TabsContent>
+                    <TabsContent value="comments" className="pt-3">
+                      <TopVideosTable
+                        rows={data?.topVideos.byComments ?? []}
+                        metricLabel={t("insightsHub.comments")}
+                      />
+                    </TabsContent>
+                  </Tabs>
+                </CardContent>
+              </Card>
 
-          <Card>
-            <CardHeader className="pb-3">
-              <CardTitle className="text-base flex items-center gap-2">
-                <IconUsers className="size-4 text-primary" />
-                {t("insightsHub.topCreators")}
-              </CardTitle>
-            </CardHeader>
-            <CardContent>
-              <TopCreatorsTable rows={data?.topCreators ?? []} />
-            </CardContent>
-          </Card>
-        </div>
+              <Card>
+                <CardHeader className="pb-3">
+                  <CardTitle className="text-base flex items-center gap-2">
+                    <IconUsers className="size-4 text-primary" />
+                    {t("insightsHub.topCreators")}
+                  </CardTitle>
+                </CardHeader>
+                <CardContent>
+                  <TopCreatorsTable rows={data?.topCreators ?? []} />
+                </CardContent>
+              </Card>
+            </div>
+          </>
+        )}
       </div>
     </>
   );

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

@@ -77,6 +77,51 @@
   }
 }
 
+@keyframes clips-collapsible-down {
+  from {
+    height: 0;
+    opacity: 0;
+    transform: translateY(-2px);
+  }
+  to {
+    height: var(--radix-collapsible-content-height);
+    opacity: 1;
+    transform: translateY(0);
+  }
+}
+
+@keyframes clips-collapsible-up {
+  from {
+    height: var(--radix-collapsible-content-height);
+    opacity: 1;
+    transform: translateY(0);
+  }
+  to {
+    height: 0;
+    opacity: 0;
+    transform: translateY(-2px);
+  }
+}
+
+.clips-collapsible-content {
+  overflow: hidden;
+  transform-origin: top;
+}
+
+.clips-collapsible-content[data-state="open"] {
+  animation: clips-collapsible-down 160ms ease-out;
+}
+
+.clips-collapsible-content[data-state="closed"] {
+  animation: clips-collapsible-up 120ms ease-out;
+}
+
+@media (prefers-reduced-motion: reduce) {
+  .clips-collapsible-content[data-state] {
+    animation-duration: 1ms;
+  }
+}
+
 @container agent-native-main (min-width: 980px) {
   .clips-meeting-detail-skeleton-grid,
   .clips-meeting-detail-grid {

package/corpus/templates/clips/app/hooks/use-auto-title.ts

@@ -16,6 +16,7 @@ import {
   callAction,
   sendToAgentChat,
   type AgentChatMessage,
+  useChangeVersions,
 } from "@agent-native/core/client";
 import { fullVideoAiModelSelection } from "@shared/clips-ai-prefs";
 import { useEffect, useRef } from "react";
@@ -23,7 +24,6 @@ import { useEffect, useRef } from "react";
 import { useRecordings, type RecordingSummary } from "./use-library";
 
 const DEFAULT_TITLE = "Untitled recording";
-const POLL_INTERVAL_MS = 3000;
 const TWO_MINUTES_MS = 2 * 60 * 1000;
 
 /** True when `title` is blank or equal to the server-seeded default. */
@@ -99,8 +99,9 @@ async function clearRequest(recordingId: string): Promise<void> {
 }
 
 /**
- * Mount this once in the app shell. It polls the recording list and fires
- * `sendToAgentChat` for every pending request queued by a clips action.
+ * Mount this once in the app shell. It watches the exact application-state
+ * keys used for queued Clips AI work and fires `sendToAgentChat` for every
+ * pending request queued by a clips action.
  * Idempotent — a given (recordingId, kind, requestedAt) is only dispatched
  * once per tab session.
  */
@@ -119,13 +120,26 @@ export function useAutoTitleBridge(): void {
         `${r.id}:${r.titleSource ?? ""}:${r.title}:${r.updatedAt}:${r.transcriptStatus ?? ""}:${r.transcriptHasText ? "1" : "0"}`,
     )
     .join("|");
+  const aiRequestVersion = useChangeVersions(
+    readyRecordings.map(
+      (recording) => `app-state:clips-ai-request-${recording.id}`,
+    ),
+  );
 
   useEffect(() => {
     if (readyRecordings.length === 0) return;
     let cancelled = false;
+    let fallbackTimer: ReturnType<typeof setTimeout> | null = null;
 
     async function tick() {
-      if (cancelled || inflight.current) return;
+      if (cancelled) return;
+      if (inflight.current) {
+        // A new request-state version can arrive while the previous list read
+        // is in flight. Recheck after it settles so that event is not the last
+        // chance to dispatch the queued work.
+        fallbackTimer = setTimeout(() => void tick(), 50);
+        return;
+      }
       inflight.current = true;
       try {
         const requestsById = await listRequests();
@@ -192,14 +206,66 @@ export function useAutoTitleBridge(): void {
       }
     }
 
-    tick();
-    const handle = setInterval(tick, POLL_INTERVAL_MS);
+    function scheduleNextFallback() {
+      if (cancelled) return;
+      const delay = nextAutoTitleFallbackDelay(
+        readyRecordings,
+        dispatched.current,
+      );
+      if (delay === null) return;
+      // Keep the timeout non-zero so a failed request cannot spin a tight loop.
+      fallbackTimer = setTimeout(
+        () => {
+          fallbackTimer = null;
+          void tick().finally(scheduleNextFallback);
+        },
+        Math.max(delay, 50),
+      );
+    }
+
+    // One initial read catches requests queued before this component mounted.
+    // Later reads are driven by the exact clips-ai-request application-state
+    // counters above. The only timer left is a one-shot wake-up when an old
+    // transcript-backed recording becomes eligible for the legacy fallback.
+    void tick().finally(scheduleNextFallback);
     return () => {
       cancelled = true;
-      clearInterval(handle);
+      if (fallbackTimer) clearTimeout(fallbackTimer);
     };
+    // readyRecordingsKey is the stable snapshot consumed by tick; depending on
+    // the array itself would restart the effect on every query result object.
     // eslint-disable-next-line react-hooks/exhaustive-deps
-  }, [readyRecordingsKey]);
+  }, [aiRequestVersion, readyRecordingsKey]);
+}
+
+export function nextAutoTitleFallbackDelay(
+  recordings: readonly RecordingSummary[],
+  dispatched: ReadonlySet<string>,
+  now = Date.now(),
+): number | null {
+  let nextDelay: number | null = null;
+
+  for (const recording of recordings) {
+    if (recording.status !== "ready") continue;
+    if (!isAutoTitleReplaceable(recording.title, recording.titleSource)) {
+      continue;
+    }
+    if (
+      recording.transcriptStatus !== "ready" ||
+      recording.transcriptHasText !== true ||
+      dispatched.has(`${recording.id}:fallback`)
+    ) {
+      continue;
+    }
+
+    const createdAt = new Date(recording.createdAt).getTime();
+    const delay = Number.isFinite(createdAt)
+      ? Math.max(0, TWO_MINUTES_MS - (now - createdAt))
+      : 0;
+    nextDelay = nextDelay === null ? delay : Math.min(nextDelay, delay);
+  }
+
+  return nextDelay;
 }
 
 function buildRequestContext(rec: RecordingSummary, request: AiRequest) {

package/corpus/templates/clips/app/hooks/use-library.ts

@@ -44,24 +44,13 @@ export interface ListRecordingsArgs {
   offset?: number;
 }
 
-function isAwaitingAutoTitle(recording: RecordingSummary): boolean {
-  const title = (recording.title ?? "").trim();
-  const titleIsReplaceable =
-    title === "" ||
-    title === "Untitled recording" ||
-    recording.titleSource === "default" ||
-    recording.titleSource === "context";
-  if (!titleIsReplaceable) return false;
-
-  if (recording.transcriptStatus === "failed") return false;
-  if (recording.transcriptStatus === "ready") {
-    return recording.transcriptHasText === true;
-  }
-
-  return (
-    recording.transcriptStatus === "pending" ||
-    recording.transcriptStatus === "streaming"
-  );
+export function recordingsRefetchInterval(
+  recordings: readonly RecordingSummary[] | undefined,
+): number | false {
+  if (!recordings || recordings.length === 0) return false;
+  return recordings.some((recording) => isLiveRecordingUpload(recording))
+    ? 3000
+    : false;
 }
 
 export function useRecordings(args: ListRecordingsArgs = {}) {
@@ -74,17 +63,15 @@ export function useRecordings(args: ListRecordingsArgs = {}) {
           recordings: Array.isArray(data?.recordings) ? data.recordings : [],
         };
       },
-      // Keep a short poll while uploads/processors are active so the library
-      // card does not get stuck if the global refresh signal is missed.
-      // Also poll for replaceable seed titles so the card upgrades promptly.
+      // Keep a short poll only while uploads/processors are active so the
+      // library card does not get stuck if the global refresh signal is
+      // missed. Generated titles arrive through the shared DB sync transport;
+      // polling completed recordings forever is both redundant and expensive.
       refetchInterval: (q) => {
         const recs = (q.state.data as any)?.recordings as
           | RecordingSummary[]
           | undefined;
-        if (!recs || recs.length === 0) return false;
-        const pendingUpload = recs.some((rec) => isLiveRecordingUpload(rec));
-        const pendingTitle = recs.some(isAwaitingAutoTitle);
-        return pendingUpload || pendingTitle ? 3000 : false;
+        return recordingsRefetchInterval(recs);
       },
     },
   );

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

@@ -324,6 +324,10 @@ function isStandalonePublicPath(pathname: string): boolean {
   const path = pathname.replace(/\/+$/, "") || "/";
   return (
     path === "/download" ||
+    path === "/bug-report" ||
+    path.startsWith("/bug-report/") ||
+    path === "/r" ||
+    path.startsWith("/r/") ||
     path.startsWith("/share/") ||
     path.startsWith("/embed/") ||
     path.startsWith("/invite/")

package/corpus/templates/clips/app/routes/_app.notifications.tsx

@@ -3,7 +3,7 @@ import {
   useActionMutation,
   useT,
 } from "@agent-native/core/client";
-import { IconSend } from "@tabler/icons-react";
+import { IconAlertTriangle, IconSend } from "@tabler/icons-react";
 import { useQueryClient } from "@tanstack/react-query";
 import { useMemo, useState } from "react";
 import { toast } from "sonner";
@@ -39,7 +39,13 @@ export default function NotificationsRoute() {
   const [replyText, setReplyText] = useState("");
 
   const qc = useQueryClient();
-  const { data: aggregated, isLoading } = useActionQuery<{
+  const {
+    data: aggregated,
+    isLoading,
+    isError,
+    isFetching,
+    refetch,
+  } = useActionQuery<{
     items: NotificationItem[];
   }>("list-notifications", { days: 30 } as any, { retry: false });
 
@@ -120,6 +126,21 @@ export default function NotificationsRoute() {
             <div className="py-16 text-center text-sm text-muted-foreground">
               {t("notificationsRoute.loading")}
             </div>
+          ) : isError ? (
+            <div className="flex flex-col items-center gap-3 py-16 text-center">
+              <IconAlertTriangle className="size-9 text-destructive" />
+              <p className="text-sm font-medium">
+                {t("libraryGrid.loadFailedTitle")}
+              </p>
+              <Button
+                size="sm"
+                variant="outline"
+                onClick={() => void refetch()}
+                disabled={isFetching}
+              >
+                {t("libraryGrid.retry")}
+              </Button>
+            </div>
           ) : (
             <NotificationsList items={filtered} onReply={setReplyFor} />
           )}

package/corpus/templates/clips/app/routes/_app.settings._index.tsx

@@ -734,7 +734,7 @@ export default function SettingsIndexRoute() {
     builderStatus.loading ||
     !builderConnect.hasFetchedStatus;
   const s3Configured = activeProviderId === "s3";
-  const s3Collapsed = builderConnected && !s3Expanded;
+  const s3Collapsed = !s3Expanded;
   const configuredApiKeyCount = AI_PROVIDER_FIELDS.filter(
     (field) => apiKeyStatus[field.key],
   ).length;
@@ -908,7 +908,7 @@ export default function SettingsIndexRoute() {
                   </div>
 
                   <Collapsible
-                    open={builderConnected ? !s3Collapsed : true}
+                    open={!s3Collapsed}
                     onOpenChange={(open) => setS3Expanded(open)}
                   >
                     <div className="rounded-md border border-border">
@@ -939,26 +939,24 @@ export default function SettingsIndexRoute() {
                                 : t("settings.s3OwnBucketDescription")}
                           </p>
                         </div>
-                        {builderConnected ? (
-                          <CollapsibleTrigger asChild>
-                            <Button
-                              type="button"
-                              variant="ghost"
-                              size="sm"
-                              className="shrink-0"
-                            >
-                              {s3Collapsed
-                                ? t("settings.configureS3")
-                                : t("settings.hideS3")}
-                              <IconChevronDown
-                                className={cn(
-                                  "h-4 w-4 transition-transform",
-                                  !s3Collapsed && "rotate-180",
-                                )}
-                              />
-                            </Button>
-                          </CollapsibleTrigger>
-                        ) : null}
+                        <CollapsibleTrigger asChild>
+                          <Button
+                            type="button"
+                            variant="ghost"
+                            size="sm"
+                            className="shrink-0"
+                          >
+                            {s3Collapsed
+                              ? t("settings.configureS3")
+                              : t("settings.hideS3")}
+                            <IconChevronDown
+                              className={cn(
+                                "h-4 w-4 transition-transform",
+                                !s3Collapsed && "rotate-180",
+                              )}
+                            />
+                          </Button>
+                        </CollapsibleTrigger>
                       </div>
 
                       <CollapsibleContent>

package/corpus/templates/clips/app/routes/_app.trash.tsx

@@ -1,5 +1,9 @@
 import { useActionMutation, useT } from "@agent-native/core/client";
-import { IconArrowBackUp, IconTrash } from "@tabler/icons-react";
+import {
+  IconAlertTriangle,
+  IconArrowBackUp,
+  IconTrash,
+} from "@tabler/icons-react";
 import { useMemo, useState } from "react";
 import { toast } from "sonner";
 
@@ -46,7 +50,7 @@ export default function TrashRoute() {
   const [isBulkPending, setIsBulkPending] = useState(false);
 
   const args = useMemo(() => ({ view: "trash" as const, sort }), [sort]);
-  const { data, isLoading } = useRecordings(args);
+  const { data, isLoading, isError, isFetching, refetch } = useRecordings(args);
   const recordings = (data?.recordings ?? []) as RecordingSummary[];
 
   // These actions are owned by other teams and ship with the template.
@@ -222,6 +226,24 @@ export default function TrashRoute() {
               <Skeleton key={i} />
             ))}
           </div>
+        ) : isError ? (
+          <div className="flex flex-col items-center justify-center gap-3 px-8 py-20 text-center">
+            <IconAlertTriangle className="size-10 text-destructive" />
+            <h2 className="text-base font-semibold">
+              {t("libraryGrid.loadFailedTitle")}
+            </h2>
+            <p className="max-w-sm text-sm text-muted-foreground">
+              {t("libraryGrid.loadFailedBody")}
+            </p>
+            <Button
+              size="sm"
+              variant="outline"
+              onClick={() => void refetch()}
+              disabled={isFetching}
+            >
+              {t("libraryGrid.retry")}
+            </Button>
+          </div>
         ) : recordings.length === 0 ? (
           <EmptyState kind="trash" />
         ) : (

package/corpus/templates/clips/changelog/2026-07-11-controls-and-folders-now-move-more-smoothly.md

@@ -0,0 +1,6 @@
+---
+type: improved
+date: 2026-07-11
+---
+
+Playback controls, recording setup, reactions, and folders now move more smoothly and respect reduced-motion preferences.

package/corpus/templates/clips/changelog/2026-07-11-declining-an-invitation-now-requires-being-its-recipient.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-07-11
+---
+
+Declining an invitation now requires being its recipient

package/corpus/templates/clips/changelog/2026-07-11-generated-titles-no-longer-cause-continuous-background-refreshes.md

@@ -0,0 +1,6 @@
+---
+type: improved
+date: 2026-07-11
+---
+
+Generated titles no longer cause continuous background refreshes after a recording is ready.