@agent-native/core 0.164.4 → 0.164.12

package/corpus/templates/calendar/server/lib/event-weekday.ts

@@ -0,0 +1,112 @@
+const DATE_ONLY_RE = /^\d{4}-\d{2}-\d{2}$/;
+
+export const WEEKDAY_NAMES = [
+  "sunday",
+  "monday",
+  "tuesday",
+  "wednesday",
+  "thursday",
+  "friday",
+  "saturday",
+] as const;
+
+export type WeekdayName = (typeof WEEKDAY_NAMES)[number];
+
+const WEEKDAY_ALIASES = new Map<string, WeekdayName>([
+  ...WEEKDAY_NAMES.map((day) => [day, day] as const),
+  ...WEEKDAY_NAMES.map((day) => [day.slice(0, 3), day] as const),
+  ["tues", "tuesday"],
+  ["thur", "thursday"],
+  ["thurs", "thursday"],
+  ["weekend", "saturday"],
+]);
+
+/**
+ * Accepts the shapes a natural-language request arrives in — "Saturday",
+ * "sat", "SUN", or an array/comma string mixing them — and rejects anything
+ * else loudly. A silently dropped day name would delete a different set of
+ * events than the user asked about.
+ */
+export function normalizeWeekdays(
+  input: string | readonly string[] | undefined,
+): WeekdayName[] {
+  if (input === undefined) return [];
+  const raw = (Array.isArray(input) ? input : String(input).split(","))
+    .map((value) => value.trim().toLowerCase())
+    .filter(Boolean);
+  const resolved = new Set<WeekdayName>();
+  for (const value of raw) {
+    if (value === "weekend" || value === "weekends") {
+      resolved.add("saturday");
+      resolved.add("sunday");
+      continue;
+    }
+    if (value === "weekday" || value === "weekdays") {
+      for (const day of WEEKDAY_NAMES) {
+        if (day !== "saturday" && day !== "sunday") resolved.add(day);
+      }
+      continue;
+    }
+    const match = WEEKDAY_ALIASES.get(value.replace(/s$/, ""));
+    if (!match) {
+      throw new Error(
+        `Unrecognized day of week: ${value}. Use full or 3-letter English day names.`,
+      );
+    }
+    resolved.add(match);
+  }
+  return WEEKDAY_NAMES.filter((day) => resolved.has(day));
+}
+
+/**
+ * The weekday the user sees for an event, which is the weekday in the calendar
+ * view's timezone — not UTC. A Sunday 5pm America/Los_Angeles meeting is Monday
+ * in UTC, so filtering on the raw ISO string silently misses it and instead
+ * deletes a Monday meeting the user never mentioned.
+ *
+ * All-day starts carry no instant, so their `YYYY-MM-DD` date IS the local day
+ * and must not be re-projected through a timezone.
+ */
+export function eventWeekday(start: string, timezone: string): WeekdayName {
+  if (DATE_ONLY_RE.test(start)) {
+    const [year, month, day] = start.split("-").map(Number);
+    return WEEKDAY_NAMES[new Date(Date.UTC(year, month - 1, day)).getUTCDay()];
+  }
+  const parsed = new Date(start);
+  if (Number.isNaN(parsed.getTime())) {
+    throw new Error(`Invalid event start: ${start}`);
+  }
+  const label = new Intl.DateTimeFormat("en-US", {
+    timeZone: timezone,
+    weekday: "long",
+  })
+    .format(parsed)
+    .toLowerCase();
+  const match = WEEKDAY_NAMES.find((day) => day === label);
+  if (!match) throw new Error(`Unable to resolve weekday for ${start}`);
+  return match;
+}
+
+export function matchesWeekdays(
+  start: string,
+  timezone: string,
+  weekdays: readonly WeekdayName[],
+): boolean {
+  if (weekdays.length === 0) return true;
+  return weekdays.includes(eventWeekday(start, timezone));
+}
+
+/**
+ * Validate a caller-supplied IANA timezone instead of falling back to UTC.
+ * `normalizeTimezone` silently returns UTC for an unparseable zone, which on a
+ * destructive weekday filter would quietly reclassify every event and delete a
+ * different set of days than the caller named.
+ */
+export function requireValidTimezone(timezone: string): string {
+  try {
+    new Intl.DateTimeFormat("en-US", { timeZone: timezone }).format();
+  } catch {
+    throw new Error(`Invalid IANA timezone: ${timezone}`);
+  }
+  return timezone;
+}

package/corpus/templates/calendar/server/routes/[base]/_agent-native/google/add-account/auth-url.post.ts

@@ -0,0 +1 @@
+export { default } from "../../../../_agent-native/google/add-account/auth-url.post.js";

package/corpus/templates/calendar/server/routes/[base]/_agent-native/google/auth-url.post.ts

@@ -0,0 +1 @@
+export { default } from "../../../_agent-native/google/auth-url.post.js";

package/corpus/templates/calendar/server/routes/_agent-native/google/add-account/auth-url.post.ts

@@ -0,0 +1 @@
+export { getGoogleAddAccountUrl as default } from "../../../../handlers/google-auth";

package/corpus/templates/calendar/server/routes/_agent-native/google/auth-url.post.ts

@@ -0,0 +1 @@
+export { getGoogleAuthUrl as default } from "../../../handlers/google-auth";

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

@@ -168,6 +168,7 @@ export interface VideoPlayerHandle {
   play: () => Promise<void> | void;
   pause: () => void;
   seek: (ms: number) => void;
+  getCurrentOriginalMs: () => number;
   setSpeed: (rate: number) => void;
   toggleMute: () => void;
   toggleCaptions: () => void;
@@ -1159,6 +1160,17 @@ export const VideoPlayer = forwardRef<VideoPlayerHandle, VideoPlayerProps>(
         play: requestPlay,
         pause: pauseVideo,
         seek: seekToVisibleMs,
+        getCurrentOriginalMs: () => {
+          const v = videoRef.current;
+          const liveOriginalMs =
+            v &&
+            Number.isFinite(v.currentTime) &&
+            v.currentTime >= 0 &&
+            v.currentTime < 1e7
+              ? Math.floor(v.currentTime * 1000)
+              : currentMsRef.current;
+          return liveOriginalMs;
+        },
         setSpeed: applySpeed,
         toggleMute: () => {
           if (videoRef.current) {

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

@@ -159,6 +159,10 @@ function dayBucket(iso: string): string {
   }
 }
 
+export function dictationsRefetchInterval(isActive: boolean): number | false {
+  return isActive ? 2_000 : false;
+}
+
 function sourceMeta(
   source: string | undefined,
   t: ReturnType<typeof useT>,
@@ -694,10 +698,6 @@ function DownloadDesktopAppCard() {
 
 export default function DictateRoute() {
   const t = useT();
-  const { data, isLoading, isError } = useActionQuery<
-    { dictations: Dictation[] } | Dictation[] | undefined
-  >("list-dictations", {}, { retry: false });
-
   const { isDesktopApp } = useDesktopPromo();
   const [filter, setFilter] = useState<SourceFilter>("all");
   const [listening, setListening] = useState(false);
@@ -706,6 +706,20 @@ export default function DictateRoute() {
   const [speechSupported, setSpeechSupported] = useState(false);
   const qc = useQueryClient();
   const createDictation = useActionMutation("create-dictation");
+  const { data, isLoading, isError } = useActionQuery<
+    { dictations: Dictation[] } | Dictation[] | undefined
+  >(
+    "list-dictations",
+    {},
+    {
+      retry: false,
+      // Action-backed mutations invalidate this query when a desktop-created
+      // dictation lands. Poll only while browser work is active or saving,
+      // rather than running a permanent interval over idle history.
+      refetchInterval: () =>
+        dictationsRefetchInterval(listening || createDictation.isPending),
+    },
+  );
 
   const recognitionRef = useRef<SpeechRecognitionLike | null>(null);
   const transcriptRef = useRef("");

package/corpus/templates/clips/app/routes/r.$recordingId.tsx

@@ -45,7 +45,7 @@ import {
   IconSparkles,
   IconExternalLink,
 } from "@tabler/icons-react";
-import { useQuery } from "@tanstack/react-query";
+import { useQuery, useQueryClient } from "@tanstack/react-query";
 import { useCallback, useEffect, useMemo, useRef, useState } from "react";
 import { createPortal } from "react-dom";
 import {
@@ -110,6 +110,64 @@ const PROCESSING_STUCK_TIMEOUT_MS = 12 * 60 * 1000;
 const READY_MEDIA_SETTLE_POLL_MS = 20 * 1000;
 const READY_MEDIA_SETTLE_POLL_INTERVAL_MS = 1000;
 
+type RecordingReaction = {
+  id: string;
+  emoji: string;
+  videoTimestampMs: number;
+};
+
+type PendingRecordingReaction = RecordingReaction & {
+  recordingId: string;
+};
+
+export function mergeRecordingReactions(
+  serverReactions: RecordingReaction[] | undefined,
+  pendingReactions: PendingRecordingReaction[],
+  recordingId: string | undefined,
+) {
+  const seen = new Set<string>();
+  const merged: RecordingReaction[] = [];
+  const visiblePendingReactions = recordingId
+    ? pendingReactions.filter(
+        (reaction) => reaction.recordingId === recordingId,
+      )
+    : [];
+
+  for (const reaction of [
+    ...(serverReactions ?? []),
+    ...visiblePendingReactions,
+  ]) {
+    const key = `${reaction.id}:${reaction.emoji}:${reaction.videoTimestampMs}`;
+    if (seen.has(key)) continue;
+    seen.add(key);
+    merged.push(reaction);
+  }
+
+  return merged;
+}
+
+export function removePendingReaction(
+  pendingReactions: PendingRecordingReaction[],
+  pendingId: string,
+) {
+  return pendingReactions.filter((reaction) => reaction.id !== pendingId);
+}
+
+export function handleReactionWrite(
+  response: { ok: boolean; status: number },
+  refresh: () => Promise<unknown>,
+) {
+  if (!response.ok) throw new Error(`react failed: ${response.status}`);
+  // The write is authoritative. A transient read failure must not tell the
+  // player that the reaction failed.
+  void Promise.resolve()
+    .then(refresh)
+    .catch((refreshError) => {
+      console.warn("[clips] reaction refresh failed", refreshError);
+    });
+  return true;
+}
+
 export function meta() {
   return [{ title: enMessages.recordingRoute.pageTitle }];
 }
@@ -263,16 +321,7 @@ export default function RecordingPage() {
   // live time bridge, so we fall back to the last position the player reported
   // via onTimeUpdate (seek/initial start).
   const resolvePlaybackMs = useCallback(() => {
-    const liveCt = playerRef.current?.video?.currentTime;
-    if (
-      typeof liveCt === "number" &&
-      Number.isFinite(liveCt) &&
-      liveCt >= 0 &&
-      liveCt < 1e7
-    ) {
-      return Math.floor(liveCt * 1000);
-    }
-    return currentMs;
+    return playerRef.current?.getCurrentOriginalMs() ?? currentMs;
   }, [currentMs]);
   // The compact layout stacks the panel below the video, so switching tabs
   // alone leaves the user looking at the player. Desktop always renders the
@@ -310,9 +359,13 @@ export default function RecordingPage() {
       recordingId ? { type: "recording" as const, id: recordingId } : null,
     [recordingId],
   );
+  const queryClient = useQueryClient();
   const lastPlayerStateWriteRef = useRef(0);
   const readyMediaPollRef = useRef<{ key: string; until: number } | null>(null);
   const [metadataRefreshUntil, setMetadataRefreshUntil] = useState(0);
+  const [pendingReactions, setPendingReactions] = useState<
+    PendingRecordingReaction[]
+  >([]);
 
   const playerDataQ = useActionQuery<any>(
     "get-recording-player-data",
@@ -414,7 +467,15 @@ export default function RecordingPage() {
     | "viewer"
     | undefined;
   const comments = playerDataQ.data?.comments ?? [];
-  const reactions = playerDataQ.data?.reactions ?? [];
+  const reactions = useMemo(
+    () =>
+      mergeRecordingReactions(
+        playerDataQ.data?.reactions,
+        pendingReactions,
+        recordingId,
+      ),
+    [pendingReactions, playerDataQ.data?.reactions, recordingId],
+  );
   const chapters = playerDataQ.data?.chapters ?? [];
   const transcriptSegments = playerDataQ.data?.transcript?.segments ?? [];
   const transcriptFullText = playerDataQ.data?.transcript?.fullText ?? null;
@@ -1643,11 +1704,10 @@ export default function RecordingPage() {
                       },
                     )
                       .then((res) => {
-                        if (!res.ok)
-                          throw new Error(`react failed: ${res.status}`);
-                        return playerDataQ.refetch();
+                        return handleReactionWrite(res, () =>
+                          playerDataQ.refetch(),
+                        );
                       })
-                      .then(() => true)
                       .catch((err) => {
                         console.warn("[clips] react failed", err);
                         return false;
@@ -1743,6 +1803,18 @@ export default function RecordingPage() {
                         onReact={(emoji) => {
                           tracking.reportReaction(emoji);
                           const liveMs = resolvePlaybackMs();
+                          const pendingReaction: PendingRecordingReaction = {
+                            id: `pending-${Date.now()}-${Math.random()
+                              .toString(36)
+                              .slice(2)}`,
+                            emoji,
+                            videoTimestampMs: liveMs,
+                            recordingId: recording.id,
+                          };
+                          setPendingReactions((current) => [
+                            ...current,
+                            pendingReaction,
+                          ]);
                           return fetch(
                             agentNativePath(
                               "/_agent-native/actions/react-to-recording",
@@ -1758,12 +1830,34 @@ export default function RecordingPage() {
                             },
                           )
                             .then((res) => {
-                              if (!res.ok)
-                                throw new Error(`react failed: ${res.status}`);
-                              return playerDataQ.refetch();
+                              const writeSucceeded = handleReactionWrite(
+                                res,
+                                () =>
+                                  Promise.all([
+                                    queryClient.invalidateQueries({
+                                      queryKey: [
+                                        "action",
+                                        "get-recording-player-data",
+                                      ],
+                                    }),
+                                    playerDataQ.refetch(),
+                                  ]),
+                              );
+                              setPendingReactions((current) =>
+                                removePendingReaction(
+                                  current,
+                                  pendingReaction.id,
+                                ),
+                              );
+                              return writeSucceeded;
                             })
-                            .then(() => true)
                             .catch((err) => {
+                              setPendingReactions((current) =>
+                                removePendingReaction(
+                                  current,
+                                  pendingReaction.id,
+                                ),
+                              );
                               console.warn("[clips] react failed", err);
                               return false;
                             });

package/corpus/templates/clips/app/routes/share.$shareId.tsx

@@ -679,6 +679,7 @@ export default function ShareRoute() {
   // an anonymous viewer sees the same controls but triggers the sign-in
   // prompt instead (see `requireSignIn` below).
   const viewerCanComment = Boolean(session) && viewerRole != null;
+  const viewerCanUseFullscreenInteractions = !session || viewerCanComment;
   const viewerIsOwner = Boolean(dataQ.data?.data?.viewer?.isOwner);
   const canReshareLink =
     (viewerRole === "viewer" || viewerRole === "commenter") &&
@@ -1252,66 +1253,85 @@ export default function ShareRoute() {
               cta={firstCta}
               onCtaClick={() => tracking.reportCtaClick()}
               onTimeUpdate={(ms) => setCurrentMs(ms)}
-              onCommentClick={() => setPanel("comments")}
+              onCommentClick={
+                viewerCanUseFullscreenInteractions
+                  ? () => setPanel("comments")
+                  : undefined
+              }
               onFullscreenChange={setIsPlayerFullscreen}
-              enableComments={recording.enableComments}
-              onAddComment={() => {
-                if (!session) {
-                  requireSignIn("comment");
-                  return;
-                }
-                const liveCt = isLoomEmbedBacked
-                  ? null
-                  : playerRef.current?.video?.currentTime;
-                const liveMs =
-                  typeof liveCt === "number" &&
-                  Number.isFinite(liveCt) &&
-                  liveCt >= 0 &&
-                  liveCt < 1e7
-                    ? Math.floor(liveCt * 1000)
-                    : currentMs;
-                setCommentAtMs(liveMs);
-                setCommentOpen(true);
-              }}
-              enableReactions={recording.enableReactions}
-              onReact={(emoji) => {
-                if (!session) {
-                  requireSignIn("react");
-                  return false;
-                }
-                tracking.reportReaction(emoji);
-                const liveCt = isLoomEmbedBacked
-                  ? null
-                  : playerRef.current?.video?.currentTime;
-                const liveMs =
-                  typeof liveCt === "number" &&
-                  Number.isFinite(liveCt) &&
-                  liveCt >= 0 &&
-                  liveCt < 1e7
-                    ? Math.floor(liveCt * 1000)
-                    : currentMs;
-                return fetch(
-                  agentNativePath("/_agent-native/actions/react-to-recording"),
-                  {
-                    method: "POST",
-                    headers: { "Content-Type": "application/json" },
-                    body: JSON.stringify({
-                      recordingId: recording.id,
-                      emoji,
-                      videoTimestampMs: liveMs,
-                    }),
-                  },
-                )
-                  .then((res) => {
-                    if (!res.ok) throw new Error(`react failed: ${res.status}`);
-                    return dataQ.refetch();
-                  })
-                  .then(() => true)
-                  .catch((err) => {
-                    console.warn("[clips] react failed", err);
-                    return false;
-                  });
-              }}
+              enableComments={
+                recording.enableComments && viewerCanUseFullscreenInteractions
+              }
+              onAddComment={
+                viewerCanUseFullscreenInteractions
+                  ? () => {
+                      if (!session) {
+                        requireSignIn("comment");
+                        return;
+                      }
+                      const liveCt = isLoomEmbedBacked
+                        ? null
+                        : playerRef.current?.video?.currentTime;
+                      const liveMs =
+                        typeof liveCt === "number" &&
+                        Number.isFinite(liveCt) &&
+                        liveCt >= 0 &&
+                        liveCt < 1e7
+                          ? Math.floor(liveCt * 1000)
+                          : currentMs;
+                      setCommentAtMs(liveMs);
+                      setCommentOpen(true);
+                    }
+                  : undefined
+              }
+              enableReactions={
+                recording.enableReactions && viewerCanUseFullscreenInteractions
+              }
+              onReact={
+                viewerCanUseFullscreenInteractions
+                  ? (emoji) => {
+                      if (!session) {
+                        requireSignIn("react");
+                        return false;
+                      }
+                      tracking.reportReaction(emoji);
+                      const liveCt = isLoomEmbedBacked
+                        ? null
+                        : playerRef.current?.video?.currentTime;
+                      const liveMs =
+                        typeof liveCt === "number" &&
+                        Number.isFinite(liveCt) &&
+                        liveCt >= 0 &&
+                        liveCt < 1e7
+                          ? Math.floor(liveCt * 1000)
+                          : currentMs;
+                      return fetch(
+                        agentNativePath(
+                          "/_agent-native/actions/react-to-recording",
+                        ),
+                        {
+                          method: "POST",
+                          headers: { "Content-Type": "application/json" },
+                          body: JSON.stringify({
+                            recordingId: recording.id,
+                            emoji,
+                            videoTimestampMs: liveMs,
+                          }),
+                        },
+                      )
+                        .then((res) => {
+                          if (!res.ok)
+                            throw new Error(`react failed: ${res.status}`);
+                          return dataQ.refetch();
+                        })
+                        .then(() => true)
+                        .catch((err) => {
+                          console.warn("[clips] react failed", err);
+                          return false;
+                        });
+                    }
+                  : undefined
+              }
               className="h-full w-full rounded-none sm:rounded-xl"
             />
             {commentOpen && viewerCanComment
@@ -1354,23 +1374,15 @@ export default function ShareRoute() {
                 {recording.enableComments ? (
                   <TimestampedCommentButton
                     enableComments={recording.enableComments}
-                    canComment
+                    canComment={!session || viewerCanComment}
                     className="shrink-0"
                     onOpen={() => {
                       if (!session) {
                         requireSignIn("comment");
                         return;
                       }
-                      const liveCt = isLoomEmbedBacked
-                        ? null
-                        : playerRef.current?.video?.currentTime;
                       const liveMs =
-                        typeof liveCt === "number" &&
-                        Number.isFinite(liveCt) &&
-                        liveCt >= 0 &&
-                        liveCt < 1e7
-                          ? Math.floor(liveCt * 1000)
-                          : currentMs;
+                        playerRef.current?.getCurrentOriginalMs() ?? currentMs;
                       setCommentAtMs(liveMs);
                       setCommentOpen(true);
                     }}
@@ -1379,22 +1391,15 @@ export default function ShareRoute() {
                 {recording.enableReactions ? (
                   <ReactionsTray
                     reactions={reactions}
+                    disabled={Boolean(session) && !viewerCanComment}
                     onReact={(emoji) => {
                       if (!session) {
                         requireSignIn("react");
                         return false;
                       }
                       tracking.reportReaction(emoji);
-                      const liveCt = isLoomEmbedBacked
-                        ? null
-                        : playerRef.current?.video?.currentTime;
                       const liveMs =
-                        typeof liveCt === "number" &&
-                        Number.isFinite(liveCt) &&
-                        liveCt >= 0 &&
-                        liveCt < 1e7
-                          ? Math.floor(liveCt * 1000)
-                          : currentMs;
+                        playerRef.current?.getCurrentOriginalMs() ?? currentMs;
                       return fetch(
                         agentNativePath(
                           "/_agent-native/actions/react-to-recording",

package/corpus/templates/clips/changelog/2026-08-19-clips-nightly-builds-are-available-for-trying-the-latest-upd.md

@@ -0,0 +1,6 @@
+---
+type: added
+date: 2026-08-19
+---
+
+Clips Nightly builds are available for trying the latest updates.

package/corpus/templates/clips/changelog/2026-08-19-social-preview-video-frames.md

@@ -2,4 +2,5 @@
 type: fixed
 date: 2026-08-19
 ---
+
 Shared clips now show a video frame in social previews when no thumbnail is stored.

package/corpus/templates/clips/desktop/README.md

@@ -79,13 +79,28 @@ Clips registers itself to open at login by default, then runs quietly in the men
 
 ## Releases + auto-update
 
-Clips Desktop ships on its own release channel — tag prefix `clips-v*`, separate from the main `v*` tags used by `packages/desktop-app` (Electron). The in-app updater pulls its manifest from the hosted Clips endpoint (`/api/clips-updater.json`), which proxies the stable pointer release (`clips-latest`) when a signed manifest exists and otherwise returns a no-update manifest so end users do not see release-channel setup errors.
+Clips Desktop has separate stable and Nightly lanes. The stable app keeps the
+`Clips` name, `Clips` binary, `clips://` scheme, and `com.clips.tray` identifier;
+its releases use `clips-v*` tags, the `clips-latest` updater pointer, and
+`/api/clips-updater.json`. Nightly builds are named `Clips Nightly`, use the
+`Clips-Nightly` binary, the `clips-nightly://` scheme, and
+`com.clips.tray.nightly`. They use the `clips-nightly-v*` tags,
+`clips-nightly-latest` pointer, and `/api/clips-updater.json?channel=nightly`.
+The in-app updater only sees the pointer for the channel that produced the
+installed app, and the separate native binary/desktop entry keeps both lanes
+installable at once.
 
 ### Shipping a release
 
-1. Bump `templates/clips/desktop/package.json` version (or pass it via workflow input).
-2. Trigger **Clips Desktop Release** in GitHub Actions (`.github/workflows/clips-desktop-release.yml`). It builds macOS (universal), Windows, and Linux x86_64 installers, signs updater artifacts, and uploads them to `clips-v{version}`.
-3. After all three platforms finish, the `publish-release` job flips the versioned release out of draft and refreshes the `clips-latest` pointer release with the new manifest. Installed macOS, Windows, and Linux AppImage copies auto-download it in the background on their next hourly or app-focus update check.
+1. For a stable release, dispatch **Clips Desktop Release** in GitHub Actions
+   with `channel: production` and an explicit version. Stable releases are
+   deliberate workflow runs; pushes to `main` never replace the stable lane.
+2. Pushes to `main` automatically build the Nightly lane. A Nightly run can
+   also be dispatched explicitly with `channel: nightly`.
+3. The workflow builds macOS (universal), Windows, and Linux x86_64 installers,
+   signs updater artifacts, and publishes the versioned release plus that
+   channel's pointer manifest. Installed copies auto-download only updates
+   from their own lane on the next hourly or app-focus check.
 
 ### Auto-update flow (inside the app)