@agent-native/core 0.0.0-beta-20260819181349 → 0.0.0-beta-20260819184657

package/corpus/README.md

@@ -31,4 +31,4 @@ rg -n "defineAction|useActionQuery" node_modules/@agent-native/core/corpus
 
 ## Generated Counts
 
-- template files: 8458
+- template files: 8459

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/mail/actions/view-screen.ts

@@ -70,7 +70,7 @@ async function fetchEmailList(
 
       const gmailQuery = buildGmailEmailSearchQuery({ view, q: search });
       const effectiveQuery =
-        view === "all" && !search ? "" : gmailQuery || "in:inbox -in:sent";
+        view === "all" && !search ? "" : gmailQuery || "in:inbox";
       const { messages } = await listGmailMessages(
         effectiveQuery,
         50,

package/corpus/templates/mail/server/handlers/google-auth.ts

@@ -69,17 +69,25 @@ function googleOAuthErrorPayload(
     error?.name === "OAuthAccountOwnedByOtherUserError"
   ) {
     const account = error.accountId || "This Google account";
+    const message = `${account} is connected to another login. Sign out, then sign in with ${account}.`;
     return {
-      message: `${account} is already connected to another login. Sign out, then sign in with the login that originally connected it.`,
+      message,
       code: "account_owner_mismatch",
       accountId: error.accountId,
     };
   }
 
   const msg = error?.message || "Unknown error";
+  const statusCode = Number(error?.statusCode || error?.status || 0);
   const isPermission =
+    error?.oauthErrorCode === "access_denied" ||
+    error?.oauthErrorCode === "forbidden" ||
+    error?.oauthErrorCode === "insufficient_scope" ||
     msg.includes("Insufficient Permission") ||
-    msg.includes("insufficient_scope");
+    msg.includes("insufficient_scope") ||
+    /insufficient authentication scopes/i.test(msg) ||
+    (statusCode === 403 &&
+      /\b(?:scope|permission|forbidden|access denied)\b/i.test(msg));
   return {
     message: isPermission
       ? "This account wasn't granted the required permissions. Make sure you check all the permission boxes on the consent screen. If the app is in testing mode, add this email as a test user in Google Cloud Console."
@@ -212,16 +220,11 @@ export const handleGoogleCallback = defineEventHandler(
       if (googleError) {
         const errorDesc =
           (query.error_description as string | undefined) || googleError;
-        const isPermission =
-          googleError === "access_denied" ||
-          errorDesc.includes("Insufficient Permission");
-        const userMessage = isPermission
-          ? "Access was denied. Make sure to check all the permission boxes on the consent screen. If the app is in testing mode, add this email as a test user in Google Cloud Console."
-          : `Connection failed: ${errorDesc}`;
-        return googleOAuthErrorResponse(event, new Error(userMessage), {
-          desktop,
-          flowId,
-        });
+        return googleOAuthErrorResponse(
+          event,
+          Object.assign(new Error(errorDesc), { oauthErrorCode: googleError }),
+          { desktop, flowId },
+        );
       }
 
       const code = query.code as string;
@@ -442,16 +445,11 @@ export const handleGoogleAddAccountCallback = defineEventHandler(
       if (googleError) {
         const errorDesc =
           (query.error_description as string | undefined) || googleError;
-        const isPermission =
-          googleError === "access_denied" ||
-          errorDesc.includes("Insufficient Permission");
-        const userMessage = isPermission
-          ? "Access was denied. Make sure to check all the permission boxes on the consent screen. If the app is in testing mode, add this email as a test user in Google Cloud Console."
-          : `Connection failed: ${errorDesc}`;
-        return googleOAuthErrorResponse(event, new Error(userMessage), {
-          desktop,
-          flowId,
-        });
+        return googleOAuthErrorResponse(
+          event,
+          Object.assign(new Error(errorDesc), { oauthErrorCode: googleError }),
+          { desktop, flowId },
+        );
       }
 
       const { redirectUri, owner: stateOwner } = state;

package/corpus/templates/mail/server/lib/gmail-query.ts

@@ -6,8 +6,11 @@ import { isSelfAddressedThread } from "@shared/self-notes.js";
 import type { EmailMessage } from "@shared/types.js";
 
 export const VIEW_QUERIES: Record<string, string> = {
-  inbox: "in:inbox -in:sent",
-  unread: "is:unread in:inbox -in:sent",
+  // Keep sent replies in a matching Gmail thread. The local thread filter
+  // below excludes sent-only threads while preserving received inbox threads
+  // whose latest message was sent by the user.
+  inbox: "in:inbox",
+  unread: "is:unread in:inbox",
   starred: "is:starred",
   sent: "in:sent",
   drafts: "in:drafts",

package/corpus/templates/plan/app/pages/PlansPage.tsx

@@ -1,6 +1,5 @@
 import {
   SIDEBAR_STATE_CHANGE_EVENT,
-  BuilderSetupCard,
   sendToAgentChat,
   setAgentChatContextItem,
   useAgentEngineConfigured,
@@ -8466,23 +8465,12 @@ function CreatePlanDialog({
           </DialogDescription>
         </DialogHeader>
         <div className="grid gap-3">
-          {canCreate && agentMissing ? (
-            <BuilderSetupCard
-              fullWidth
-              onConnected={() =>
-                window.dispatchEvent(
-                  new Event("agent-engine:configured-changed"),
-                )
-              }
-            />
-          ) : null}
           <div className="rounded-xl border border-border bg-background p-2 shadow-sm">
             <PromptComposer
               autoFocus
               disabled={composerLocked}
               attachmentsEnabled={false}
               showModelSelector={false}
-              modelStatusChecksEnabled={false}
               placeholder={t("plansPage.create.placeholder")}
               draftScope="plans:create-plan"
               initialText={promptSeed}

package/corpus/templates/plan/changelog/2026-08-19-plan-prompts-now-guide-you-to-connect-ai-before-sending-and-.md

@@ -0,0 +1,6 @@
+---
+type: improved
+date: 2026-08-19
+---
+
+Plan prompts now guide you to connect AI before sending and offer a clear retry after setup.

package/dist/a2a/task-store.d.ts

@@ -1,6 +1,7 @@
 import type { Task, Message, TaskState, Artifact } from "./types.js";
 export declare const MAX_A2A_IDEMPOTENCY_KEY_CHARS = 128;
 export declare const A2A_PERSONAL_OWNER_SCOPE = "__personal__";
+export declare function ensureTable(): Promise<void>;
 export interface A2AApprovalRecord {
     id: string;
     taskId: string;

package/dist/a2a/task-store.js

@@ -5,7 +5,7 @@ let _initPromise;
 export const MAX_A2A_IDEMPOTENCY_KEY_CHARS = 128;
 const A2A_IDEMPOTENCY_INDEX = "idx_a2a_tasks_owner_scope_idempotency";
 export const A2A_PERSONAL_OWNER_SCOPE = "__personal__";
-async function ensureTable() {
+export async function ensureTable() {
     if (!_initPromise) {
         _initPromise = (async () => {
             const client = getDbExec();

package/dist/agent/observational-memory/store.d.ts

@@ -12,6 +12,7 @@
  * runtime even before the migration plugin is registered.
  */
 import type { ObservationalMemoryEntry, ObservationalMemoryOwner, ObservationalMemoryTier } from "./types.js";
+export declare function ensureTable(): Promise<void>;
 /** Reset the cached ensureTable promise — test-only seam. */
 export declare function __resetObservationalMemoryTableCache(): void;
 export interface InsertObservationalMemoryInput extends ObservationalMemoryOwner {

package/dist/agent/observational-memory/store.js

@@ -14,7 +14,7 @@
 import { getDbExec, isPostgres } from "../../db/client.js";
 import { ensureTableExists, ensureIndexExists } from "../../db/ddl-guard.js";
 let tableReady = null;
-async function ensureTable() {
+export async function ensureTable() {
     if (tableReady)
         return tableReady;
     tableReady = (async () => {

package/dist/agent/run-store.d.ts

@@ -217,6 +217,7 @@ export declare const IN_FLIGHT_RUN_STALE_GRACE_MS: number;
  * is reaped like any other stale run.
  */
 export declare const IN_FLIGHT_GRACE_MAX_LIVENESS_GAP_MS = 120000;
+export declare function ensureRunTables(): Promise<void>;
 /**
  * Persist a zombie tool-call completion to the ledger. Called by the detached
  * promise continuation after `Promise.race` abandons it. Best-effort — never