@agent-native/core 0.121.1 → 0.122.0

package/corpus/templates/clips/actions/regenerate-summary.ts

@@ -101,7 +101,11 @@ export default defineAction({
       `Regenerate the description for recording ${args.recordingId}. ` +
       `Read the transcript in this request's context and call ` +
       `\`update-recording --id=${args.recordingId} --description="..."\` with a 2–4 ` +
-      `sentence summary of what the recording covers. Title: "${rec.title}".`;
+      `sentence summary of what the recording covers. Title: "${rec.title}". ` +
+      `Write the description the way the person who made this recording would ` +
+      `describe it themselves: lead with the subject matter, and never use ` +
+      `outside-narrator framing like "the speaker", "the presenter", "the video", ` +
+      `"this recording", or "this clip".`;
 
     const request = {
       kind: "regenerate-summary" as const,

package/corpus/templates/clips/actions/request-transcript.ts

@@ -437,6 +437,26 @@ function fullTextSegmentJson(
   return JSON.stringify(buildCaptionSegmentsFromText(text, durationMs));
 }
 
+/**
+ * Pick the segments to store after cleanup rewrites the transcript text.
+ *
+ * Measured timings from the capture engine always win.
+ * `buildCaptionSegmentsFromText` spaces cues in proportion to word count, so
+ * re-synthesizing over real timestamps spreads a short transcript evenly across
+ * the whole recording — which reads as minute-long gaps of dropped speech even
+ * when nothing was dropped there.
+ */
+export function resolveCleanupSegmentsJson(
+  priorSegmentsJson: string | null | undefined,
+  cleanedText: string,
+  durationMs: number | null | undefined,
+): string {
+  if (parseTranscriptSegments(priorSegmentsJson).length > 1) {
+    return priorSegmentsJson as string;
+  }
+  return fullTextSegmentJson(cleanedText, durationMs);
+}
+
 export function isSafeTranscriptCleanupReplacement(
   sourceText: string,
   cleanedText: string,
@@ -642,12 +662,14 @@ async function cleanupNativeTranscript({
   ownerEmail,
   fullText,
   durationMs,
+  segmentsJson,
 }: {
   db: ReturnType<typeof getDb>;
   recordingId: string;
   ownerEmail: string;
   fullText: string;
   durationMs: number | null | undefined;
+  segmentsJson?: string | null;
 }): Promise<{ cleaned: boolean; provider?: string }> {
   const sourceText = fullText.trim();
   if (!sourceText) return { cleaned: false };
@@ -704,7 +726,11 @@ async function cleanupNativeTranscript({
         status: "ready",
         failureReason: null,
         language,
-        segmentsJson: fullTextSegmentJson(cleanedText, durationMs),
+        segmentsJson: resolveCleanupSegmentsJson(
+          segmentsJson,
+          cleanedText,
+          durationMs,
+        ),
         fullText: cleanedText,
         retryCount: 0,
         updatedAt: now,
@@ -855,6 +881,7 @@ async function completeReadyTranscript({
     ownerEmail,
     fullText,
     durationMs: recForTitle?.durationMs,
+    segmentsJson,
   }).catch((err) => {
     console.warn(
       `[clips] native transcript cleanup failed for ${recordingId}:`,

package/corpus/templates/clips/app/components/editor/stitch-manager.tsx

@@ -23,6 +23,7 @@ import {
 } from "@/components/ui/dialog";
 import { ScrollArea } from "@/components/ui/scroll-area";
 import { exportConcat } from "@/lib/ffmpeg-export";
+import { copyRecordingShareLink } from "@/lib/recording-link";
 import { formatMs } from "@/lib/timestamp-mapping";
 import { uploadFileClient } from "@/lib/upload-file-client";
 import { cn } from "@/lib/utils";
@@ -142,7 +143,26 @@ export function StitchManager({
         videoUrl,
         durationMs: totalDuration,
       });
-      toast.success(t("stitchManager.created"));
+      const newRecordingId = (result as { id?: string } | null)?.id;
+      if (newRecordingId) {
+        const copied = await copyRecordingShareLink(newRecordingId);
+        if (copied) {
+          toast.success(t("stitchManager.created"), {
+            description: t("recordRoute.linkCopied"),
+          });
+        } else {
+          toast.success(t("stitchManager.created"), {
+            action: {
+              label: t("recordRoute.copyLinkAction"),
+              onClick: () => {
+                void copyRecordingShareLink(newRecordingId);
+              },
+            },
+          });
+        }
+      } else {
+        toast.success(t("stitchManager.created"));
+      }
       onOpenChange(false);
       return result;
     } catch (err: any) {

package/corpus/templates/clips/app/components/meetings/quick-ask-sidebar.tsx

@@ -78,6 +78,7 @@ export function QuickAskSidebar({
   const [open, setOpen] = useState(false);
   const [draft, setDraft] = useState("");
   const [history, setHistory] = useState<ChatTurn[]>([]);
+  const [pendingAsk, setPendingAsk] = useState<string | null>(null);
   const textareaRef = useRef<HTMLTextAreaElement>(null);
 
   // Single global keydown listener; toggles on Cmd/Ctrl+J. Esc is handled
@@ -94,11 +95,17 @@ export function QuickAskSidebar({
     return () => window.removeEventListener("keydown", onKeyDown);
   }, []);
 
+  // The desktop pill's "Ask anything" bar hands its question over as `?ask=`
+  // alongside `?chat=1`, so the question the user typed on the overlay lands
+  // in the agent chat here instead of being retyped.
   useEffect(() => {
     const params = new URLSearchParams(window.location.search);
-    if (params.get("chat") !== "1") return;
+    const askParam = params.get("ask")?.trim();
+    if (params.get("chat") !== "1" && !askParam) return;
     setOpen(true);
+    if (askParam) setPendingAsk(askParam);
     params.delete("chat");
+    params.delete("ask");
     const nextQuery = params.toString();
     window.history.replaceState(
       window.history.state,
@@ -155,6 +162,12 @@ export function QuickAskSidebar({
     [meetingId, meetingTitle, segments, t],
   );
 
+  useEffect(() => {
+    if (!pendingAsk) return;
+    setPendingAsk(null);
+    send(pendingAsk);
+  }, [pendingAsk, send]);
+
   return (
     <Sheet open={open} onOpenChange={setOpen}>
       <SheetContent

package/corpus/templates/clips/app/components/player/insights-panel.tsx

@@ -16,8 +16,11 @@ import {
   CartesianGrid,
 } from "recharts";
 
+import {
+  ViewerAvatar,
+  viewerLabel,
+} from "@/components/player/recording-views-badge";
 import { ViewedByPopover } from "@/components/sharing/viewed-by-popover";
-import { Avatar, AvatarFallback } from "@/components/ui/avatar";
 
 export interface InsightsPanelProps {
   recordingId: string;
@@ -152,20 +155,13 @@ export function InsightsPanel({ recordingId, durationMs }: InsightsPanelProps) {
             {viewers.slice(0, 12).map((v, i) => (
               <div
                 key={i}
-                className="flex items-center gap-2 rounded-full border border-border bg-card pr-3 pl-0.5 py-0.5"
+                className="flex items-center gap-2 rounded-full border border-border bg-card pe-3 ps-0.5 py-0.5"
                 title={v.viewerEmail ?? t("recordingInsights.anonymous")}
               >
-                <Avatar className="h-6 w-6">
-                  <AvatarFallback className="text-[10px] bg-primary text-primary-foreground">
-                    {initials(v.viewerName || v.viewerEmail || "?")}
-                  </AvatarFallback>
-                </Avatar>
+                <ViewerAvatar viewer={v} />
                 <span className="text-xs">
-                  {v.viewerName ||
-                    (v.viewerEmail
-                      ? v.viewerEmail.split("@")[0]
-                      : t("recordingInsights.anon"))}
-                  <span className="text-muted-foreground ml-1">
+                  {viewerLabel(v, t("recordingInsights.anonymous"))}
+                  <span className="text-muted-foreground ms-1">
                     {Math.round(v.completedPct)}%
                   </span>
                 </span>
@@ -207,14 +203,6 @@ function Stat({
   );
 }
 
-function initials(s: string): string {
-  return s
-    .split(/\s+|@/)
-    .slice(0, 2)
-    .map((p) => p[0]?.toUpperCase() ?? "")
-    .join("");
-}
-
 function msCompact(ms: number): string {
   const s = Math.floor(ms / 1000);
   const m = Math.floor(s / 60);

package/corpus/templates/clips/app/components/player/recording-views-badge.tsx

@@ -0,0 +1,335 @@
+import { useActionQuery } from "@agent-native/core/client/hooks";
+import { useT } from "@agent-native/core/client/i18n";
+import { IconTerminal2, IconUser } from "@tabler/icons-react";
+import { useState } from "react";
+
+import { Avatar, AvatarFallback } from "@/components/ui/avatar";
+import { Button } from "@/components/ui/button";
+import {
+  Popover,
+  PopoverContent,
+  PopoverTrigger,
+} from "@/components/ui/popover";
+import { Tabs, TabsContent, TabsList, TabsTrigger } from "@/components/ui/tabs";
+import { cn } from "@/lib/utils";
+
+interface ViewerRow {
+  id: string;
+  viewerEmail: string | null;
+  viewerName: string | null;
+  totalWatchMs: number;
+  completedPct: number;
+  countedView: boolean;
+  ctaClicked: boolean;
+  firstViewedAt: string | null;
+  lastViewedAt: string | null;
+}
+
+interface AgentViewerRow {
+  agentLabel: string;
+  views: number;
+  lastSeenAt: string;
+}
+
+interface Insights {
+  views: number;
+  agentViews: number;
+  agentViewers: AgentViewerRow[];
+  uniqueViewers: number;
+  completionRate: number;
+  ctaConversionRate: number;
+  dropOff: { bucket: number; watching: number }[];
+  topViewers: {
+    viewerEmail: string | null;
+    viewerName: string | null;
+    totalWatchMs: number;
+    completedPct: number;
+  }[];
+  durationMs: number;
+}
+
+export interface RecordingViewsBadgeProps {
+  recordingId: string;
+  /** Public counted-view total. Rendered as-is when details are unavailable. */
+  viewCount: number;
+  /** True only for owner/editor — gates avatars, the popover, and all viewer identities. */
+  canViewDetails: boolean;
+  /** Optional: called by the popover's "More insights" button. Omit to hide that button. */
+  onOpenInsights?: () => void;
+  className?: string;
+}
+
+/**
+ * Header-sized view counter. Viewer identities are owner/editor-only, so a
+ * visitor gets plain text and fires no viewer queries at all — `canViewDetails`
+ * is the client half of the server-side access check on `list-viewers`.
+ */
+export function RecordingViewsBadge({
+  recordingId,
+  viewCount,
+  canViewDetails,
+  onOpenInsights,
+  className,
+}: RecordingViewsBadgeProps): React.ReactElement | null {
+  const t = useT();
+  const [open, setOpen] = useState(false);
+
+  const viewersQuery = useActionQuery<{ viewers: ViewerRow[] }>(
+    "list-viewers",
+    { recordingId, limit: 12 },
+    { enabled: canViewDetails },
+  );
+  const insightsQuery = useActionQuery<Insights>(
+    "get-recording-insights",
+    { recordingId },
+    { enabled: canViewDetails && open },
+  );
+
+  const countLabel = t("recordingInsights.viewsCount", { count: viewCount });
+
+  if (viewCount <= 0 && !canViewDetails) return null;
+
+  if (!canViewDetails) {
+    return (
+      <span
+        className={cn("text-sm text-muted-foreground tabular-nums", className)}
+      >
+        {countLabel}
+      </span>
+    );
+  }
+
+  const viewers = viewersQuery.data?.viewers ?? [];
+  const insights = insightsQuery.data;
+  const agentViewers = insights?.agentViewers ?? [];
+  const summary = insights
+    ? t("recordingInsights.totalViewsSummary", {
+        total: insights.views,
+        unique: insights.uniqueViewers,
+      })
+    : countLabel;
+
+  return (
+    <Popover open={open} onOpenChange={setOpen}>
+      <PopoverTrigger asChild onClick={(e) => e.stopPropagation()}>
+        <button
+          type="button"
+          className={cn(
+            "inline-flex cursor-pointer items-center gap-2 rounded-full border border-border bg-card px-2 py-1 text-sm text-muted-foreground hover:bg-accent hover:text-accent-foreground",
+            className,
+          )}
+        >
+          {viewers.length > 0 ? (
+            <span className="hidden -space-x-1.5 sm:flex">
+              {viewers.slice(0, 3).map((v) => (
+                <ViewerAvatar
+                  key={v.id}
+                  viewer={v}
+                  className="h-6 w-6 ring-2 ring-card"
+                />
+              ))}
+            </span>
+          ) : null}
+          <span className="tabular-nums">{countLabel}</span>
+        </button>
+      </PopoverTrigger>
+      <PopoverContent
+        align="end"
+        className="w-80 p-0"
+        onClick={(e) => e.stopPropagation()}
+      >
+        <Tabs defaultValue="views">
+          <div className="p-2 pb-0">
+            <TabsList className="grid h-8 w-full grid-cols-2">
+              <TabsTrigger value="views" className="text-xs">
+                {t("recordingInsights.viewsTab")}
+              </TabsTrigger>
+              <TabsTrigger value="insights" className="text-xs">
+                {t("recordingInsights.insightsTab")}
+              </TabsTrigger>
+            </TabsList>
+          </div>
+
+          <TabsContent value="views" className="mt-2">
+            <div className="border-y border-border px-3 py-2 text-xs text-muted-foreground">
+              {summary}
+            </div>
+            <div className="max-h-80 overflow-y-auto p-1.5">
+              <p className="px-2 pt-1 pb-1.5 text-xs font-medium text-muted-foreground">
+                {t("recordingInsights.humanViews")}
+              </p>
+              {viewersQuery.isLoading ? (
+                <p className="px-2 py-3 text-sm text-muted-foreground">
+                  {t("recordingInsights.loading")}
+                </p>
+              ) : viewers.length === 0 ? (
+                <p className="px-2 py-3 text-sm text-muted-foreground">
+                  {t("recordingInsights.noViewsYet")}
+                </p>
+              ) : (
+                <ul className="space-y-0.5">
+                  {viewers.map((v) => (
+                    <li
+                      key={v.id}
+                      className="flex items-center gap-2 rounded-md px-2 py-1.5"
+                    >
+                      <ViewerAvatar viewer={v} />
+                      <span className="min-w-0 flex-1 truncate text-sm text-foreground">
+                        {viewerLabel(v, t("recordingInsights.anonymous"))}
+                      </span>
+                      <span className="shrink-0 text-xs text-muted-foreground tabular-nums">
+                        {Math.round(v.completedPct)}%
+                      </span>
+                    </li>
+                  ))}
+                </ul>
+              )}
+
+              <p className="mt-2 border-t border-border px-2 pt-2.5 pb-1.5 text-xs font-medium text-muted-foreground">
+                {t("recordingInsights.agentViews")}
+              </p>
+              {agentViewers.length === 0 ? (
+                <p className="px-2 py-1.5 text-sm text-muted-foreground">
+                  {t("recordingInsights.noAgentViewsYet")}
+                </p>
+              ) : (
+                <ul className="space-y-0.5">
+                  {agentViewers.map((a) => (
+                    <li
+                      key={a.agentLabel}
+                      className="flex items-center gap-2 rounded-md px-2 py-1.5"
+                    >
+                      <span className="flex h-6 w-6 shrink-0 items-center justify-center rounded-full bg-muted text-muted-foreground">
+                        <IconTerminal2 className="h-3.5 w-3.5" />
+                      </span>
+                      <span className="min-w-0 flex-1 truncate text-sm text-foreground">
+                        {a.agentLabel}
+                      </span>
+                      <span className="shrink-0 text-xs text-muted-foreground tabular-nums">
+                        {t("recordingInsights.viewsCount", { count: a.views })}
+                      </span>
+                    </li>
+                  ))}
+                </ul>
+              )}
+            </div>
+          </TabsContent>
+
+          <TabsContent value="insights" className="mt-2 space-y-3 p-3 pt-1">
+            {insightsQuery.isLoading ? (
+              <p className="py-3 text-sm text-muted-foreground">
+                {t("recordingInsights.loading")}
+              </p>
+            ) : (
+              <>
+                <div className="grid grid-cols-2 gap-2">
+                  <StatCard
+                    label={t("recordingInsights.humanViews")}
+                    value={insights?.views ?? viewCount}
+                  />
+                  <StatCard
+                    label={t("recordingInsights.agentViews")}
+                    value={insights?.agentViews ?? 0}
+                  />
+                </div>
+                <div className="grid grid-cols-3 gap-2 text-xs text-muted-foreground">
+                  <MiniStat
+                    label={t("recordingInsights.uniqueViewers")}
+                    value={insights?.uniqueViewers ?? 0}
+                  />
+                  <MiniStat
+                    label={t("recordingInsights.completion")}
+                    value={`${Math.round(insights?.completionRate ?? 0)}%`}
+                  />
+                  <MiniStat
+                    label={t("recordingInsights.ctaConversion")}
+                    value={`${Math.round(insights?.ctaConversionRate ?? 0)}%`}
+                  />
+                </div>
+              </>
+            )}
+            {onOpenInsights ? (
+              <Button
+                type="button"
+                variant="outline"
+                size="sm"
+                className="w-full cursor-pointer"
+                onClick={() => {
+                  setOpen(false);
+                  onOpenInsights();
+                }}
+              >
+                {t("recordingInsights.moreInsights")}
+              </Button>
+            ) : null}
+          </TabsContent>
+        </Tabs>
+      </PopoverContent>
+    </Popover>
+  );
+}
+
+/** Identity fields every viewer surface shares — `list-viewers` rows and the
+ * leaner `topViewers` rows from `get-recording-insights` alike. */
+export interface ViewerIdentity {
+  viewerEmail: string | null;
+  viewerName: string | null;
+}
+
+export function ViewerAvatar({
+  viewer,
+  className,
+}: {
+  viewer: ViewerIdentity;
+  className?: string;
+}) {
+  const anonymous = !viewer.viewerName && !viewer.viewerEmail;
+  return (
+    <Avatar className={cn("h-6 w-6 shrink-0", className)}>
+      <AvatarFallback className="bg-primary text-[10px] text-primary-foreground">
+        {anonymous ? (
+          <IconUser className="h-3 w-3" />
+        ) : (
+          initials(viewer.viewerName || viewer.viewerEmail || "?")
+        )}
+      </AvatarFallback>
+    </Avatar>
+  );
+}
+
+function MiniStat({ label, value }: { label: string; value: string | number }) {
+  return (
+    <div className="min-w-0">
+      <div className="truncate">{label}</div>
+      <div className="mt-0.5 text-foreground tabular-nums">{value}</div>
+    </div>
+  );
+}
+
+function StatCard({ label, value }: { label: string; value: string | number }) {
+  return (
+    <div className="rounded-lg border border-border bg-card p-2.5">
+      <div className="text-xs text-muted-foreground">{label}</div>
+      <div className="mt-0.5 text-xl font-semibold text-foreground tabular-nums">
+        {value}
+      </div>
+    </div>
+  );
+}
+
+export function viewerLabel(
+  viewer: ViewerIdentity,
+  anonymousLabel: string,
+): string {
+  if (viewer.viewerName) return viewer.viewerName;
+  if (viewer.viewerEmail) return viewer.viewerEmail.split("@")[0];
+  return anonymousLabel;
+}
+
+function initials(s: string): string {
+  return s
+    .split(/\s+|@/)
+    .slice(0, 2)
+    .map((p) => p[0]?.toUpperCase() ?? "")
+    .join("");
+}

package/corpus/templates/clips/app/components/player/video-player.tsx

@@ -1400,7 +1400,10 @@ export const VideoPlayer = forwardRef<VideoPlayerHandle, VideoPlayerProps>(
                 v,
                 resolvedDurationMs,
               );
-              if (visibleMs !== ms) {
+              // Only ever correct forward (skipping a trimmed range). Seeking
+              // backwards here flushes the decode pipeline and replays from the
+              // previous keyframe, which reads as a stutter with a buffering flash.
+              if (visibleMs > ms) {
                 v.currentTime = visibleMs / 1000;
                 setCurrentMs(visibleMs);
                 if (visibleMs > 0) {
@@ -1815,21 +1818,23 @@ function CenterPlaybackOverlay({
  * trustworthy finite number we have — preferring the resolved duration from
  * the player, then falling back to `video.duration`, then the seekable range.
  */
-function clampSeek(
+export function clampSeek(
   ms: number,
   v: HTMLVideoElement,
   resolvedDurationMs: number,
 ): number {
-  let maxSec = Number.POSITIVE_INFINITY;
+  // Clamp in integer milliseconds. Routing through seconds and back loses 1ms
+  // for ~1% of integer inputs (1001 -> 1000), which the timeupdate handler
+  // would then "correct" by seeking the player backwards.
+  let maxMs = Number.POSITIVE_INFINITY;
   if (resolvedDurationMs > 0) {
-    maxSec = resolvedDurationMs / 1000;
+    maxMs = resolvedDurationMs;
   } else if (Number.isFinite(v.duration) && v.duration > 0) {
-    maxSec = v.duration;
+    maxMs = v.duration * 1000;
   } else if (v.seekable && v.seekable.length > 0) {
-    maxSec = v.seekable.end(v.seekable.length - 1);
+    maxMs = v.seekable.end(v.seekable.length - 1) * 1000;
   }
-  const sec = Math.max(0, Math.min(maxSec, ms / 1000));
-  return Math.floor(sec * 1000);
+  return Math.floor(Math.max(0, Math.min(maxMs, ms)));
 }
 
 function skipExcludedRange(

package/corpus/templates/clips/app/components/sharing/share-ui.tsx

@@ -1,3 +1,4 @@
+import { writeClipboardText } from "@agent-native/core/client/clipboard";
 import {
   useActionMutation,
   useActionQuery,
@@ -70,7 +71,7 @@ export const ROLE_OPTIONS: Array<{ value: Role; label: string }> = [
 ];
 
 export function copyToClipboard(value: string): void {
-  navigator.clipboard.writeText(value).catch(() => {});
+  void writeClipboardText(value);
 }
 
 // ---------------------------------------------------------------------------

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

@@ -288,7 +288,6 @@ const messages = {
     storageConnectedChecking: "Storage connected. Checking this clip...",
     signInToFinish: "Sign in to finish",
     signInIfYours: "Sign in if this is yours",
-    openDashboard: "Open dashboard",
     checkAgain: "Check again",
     backToHome: "Back to home",
     generatingTitle: "Generating title",
@@ -807,11 +806,21 @@ All notable user-facing changes to Clips are documented here. Open it any time f
     recentViewers: "Recent viewers",
     noViewers: "No viewers yet.",
     anonymous: "Anonymous",
-    anon: "Anon",
     moreViewers: "+{{count}} more",
     viewedBy: "Viewed by",
     someone: "Someone",
     noViewsYet: "No views yet.",
+    viewsCount_one: "{{count}} view",
+    viewsCount_other: "{{count}} views",
+    totalViewsSummary: "{{total}} total views, {{unique}} unique viewers",
+    viewsTab: "Views",
+    insightsTab: "Insights",
+    humanViews: "Human views",
+    agentViews: "Agent views",
+    noAgentViewsYet: "No agent views yet.",
+    totalVideoViews: "Total video views",
+    averageCompletionRate: "Average completion rate",
+    moreInsights: "More insights",
   },
   libraryGrid: {
     spaceRoot: "Space root",
@@ -1291,6 +1300,8 @@ All notable user-facing changes to Clips are documented here. Open it any time f
     couldNotImportLoom: "Could not import that Loom.",
     recordingReadyToUpload: "Recording is ready to upload",
     recordingSaved: "Recording saved",
+    linkCopied: "Link copied",
+    copyLinkAction: "Copy link",
     noLocalRecordingData: "No local recording data is available to download.",
     recordingDownloadStarted: "Recording download started",
     backToLibrary: "Back to library",