@agent-native/core 0.176.1 → 0.177.0-nightly-20260828155142

package/corpus/templates/calendar/changelog/2026-08-28-event-creators-can-choose-whether-a-meeting-shows-as-free-or.md

@@ -0,0 +1,6 @@
+---
+type: improved
+date: 2026-08-28
+---
+
+Event creators can choose whether a meeting shows as Free or Busy.

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

@@ -155,33 +155,6 @@
   animation: clips-collapsible-up 120ms ease-out;
 }
 
-.clips-share-content {
-  container: clips-share-content / inline-size;
-}
-
-.clips-share-metadata-description {
-  order: 2;
-}
-
-.clips-share-metadata-actions {
-  order: 1;
-}
-
-@container clips-share-content (min-width: 860px) {
-  .clips-share-metadata {
-    align-items: flex-start;
-    flex-direction: row;
-  }
-
-  .clips-share-metadata-description {
-    order: 1;
-  }
-
-  .clips-share-metadata-actions {
-    order: 2;
-  }
-}
-
 @media (prefers-reduced-motion: reduce) {
   .clips-collapsible-content[data-state] {
     animation-duration: 1ms;

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

@@ -631,6 +631,8 @@ const messages = {
     macSublabel: "Universal (Apple Silicon + Intel)",
     windowsSublabel: "64-bit MSI installer",
     downloadFor: "Download for {{platform}}",
+    downloadStarted: "Download started",
+    downloadAgain: "Didn't work? Try downloading again",
     alsoFor: "Also available for {{platform}}",
     backToLibrary: "Back to library",
     clipsDesktop: "Clips Desktop",

package/corpus/templates/clips/app/routes/download.tsx

@@ -4,6 +4,7 @@ import {
   IconBrandChrome,
   IconBrandApple,
   IconBrandWindows,
+  IconCheck,
   IconExternalLink,
   IconTerminal2,
 } from "@tabler/icons-react";
@@ -50,6 +51,7 @@ interface PlatformVariant {
 }
 
 const LATEST_JSON_URL = `${appBasePath()}/api/clips-latest.json`;
+const MANIFEST_STORAGE_KEY = "clips-download-manifest-v1";
 
 const VARIANTS: PlatformVariant[] = [
   {
@@ -85,6 +87,65 @@ interface Manifest {
   }[];
 }
 
+interface ConfirmedDownload {
+  asset: Manifest["assets"][number];
+  label: string;
+}
+
+function manifestStorageKey(channel: DownloadReleaseChannel): string {
+  return `${MANIFEST_STORAGE_KEY}-${channel}`;
+}
+
+function isManifest(value: unknown): value is Manifest {
+  if (!value || typeof value !== "object") return false;
+  const manifest = value as Partial<Manifest>;
+  return (
+    typeof manifest.version === "string" &&
+    typeof manifest.tag === "string" &&
+    (typeof manifest.pub_date === "string" || manifest.pub_date === null) &&
+    Array.isArray(manifest.assets) &&
+    manifest.assets.every((asset) => {
+      if (!asset || typeof asset !== "object") return false;
+      const candidate = asset as Partial<Manifest["assets"][number]>;
+      return (
+        typeof candidate.name === "string" &&
+        typeof candidate.url === "string" &&
+        typeof candidate.size === "number" &&
+        typeof candidate.kind === "string"
+      );
+    })
+  );
+}
+
+function readCachedManifest(channel: DownloadReleaseChannel): Manifest | null {
+  if (typeof window === "undefined") return null;
+  try {
+    const raw = window.localStorage.getItem(manifestStorageKey(channel));
+    if (!raw) return null;
+    const parsed: unknown = JSON.parse(raw);
+    return isManifest(parsed) ? parsed : null;
+    // coercion-ok: an unreadable browser cache is absent; the network fetch remains authoritative.
+  } catch {
+    return null;
+  }
+}
+
+function writeCachedManifest(
+  channel: DownloadReleaseChannel,
+  manifest: Manifest,
+): void {
+  if (typeof window === "undefined") return;
+  try {
+    window.localStorage.setItem(
+      manifestStorageKey(channel),
+      JSON.stringify(manifest),
+    );
+    // coercion-ok: browser storage is optional and must not block the download action.
+  } catch {
+    // Storage can be unavailable in private browsing or locked-down contexts.
+  }
+}
+
 function detectPlatform(): PlatformId | null {
   if (typeof navigator === "undefined") return null;
   const ua = navigator.userAgent;
@@ -97,11 +158,11 @@ function detectPlatform(): PlatformId | null {
 function pickAsset(
   manifest: Manifest | null,
   variant: PlatformVariant,
-): { url: string; name: string } | null {
+): Manifest["assets"][number] | null {
   if (!manifest) return null;
   for (const kind of variant.assetKinds) {
     const asset = manifest.assets.find((a) => a.kind === kind);
-    if (asset) return { url: asset.url, name: asset.name };
+    if (asset) return asset;
   }
   return null;
 }
@@ -113,6 +174,9 @@ function primaryDownloadButton(
   downloadLabel: string,
   retryLabel: string,
   onRetry: () => void,
+  downloadStarted: boolean,
+  downloadStartedLabel: string,
+  onDownload: (asset: Manifest["assets"][number]) => void,
 ) {
   const asset = pickAsset(manifest, variant);
   const Icon = variant.icon;
@@ -123,9 +187,13 @@ function primaryDownloadButton(
         size="lg"
         className="h-12 min-w-[252px] gap-2 px-6 text-base"
       >
-        <a href={asset.url} download onClick={markDesktopAppDownloaded}>
-          <Icon className="h-5 w-5" />
-          {downloadLabel}
+        <a href={asset.url} download onClick={() => onDownload(asset)}>
+          {downloadStarted ? (
+            <IconCheck className="h-5 w-5" />
+          ) : (
+            <Icon className="h-5 w-5" />
+          )}
+          {downloadStarted ? downloadStartedLabel : downloadLabel}
         </a>
       </Button>
     );
@@ -168,6 +236,8 @@ export default function DownloadPage() {
   const [manifestError, setManifestError] = useState(false);
   const [detected, setDetected] = useState<PlatformId | null>(null);
   const [manifestRequest, setManifestRequest] = useState(0);
+  const [confirmedDownload, setConfirmedDownload] =
+    useState<ConfirmedDownload | null>(null);
 
   useEffect(() => {
     setDetected(detectPlatform());
@@ -182,7 +252,8 @@ export default function DownloadPage() {
     if (!hostResolved) return;
 
     let cancelled = false;
-    setManifest(null);
+    const cachedManifest = readCachedManifest(channel);
+    setManifest(cachedManifest);
     setManifestError(false);
     const manifestUrl =
       channel === "nightly"
@@ -191,10 +262,15 @@ export default function DownloadPage() {
     fetch(manifestUrl)
       .then((r) => (r.ok ? r.json() : Promise.reject(new Error(`${r.status}`))))
       .then((json) => {
-        if (!cancelled) setManifest(json as Manifest);
+        if (!isManifest(json)) throw new Error("Invalid manifest");
+        if (!cancelled) {
+          setManifest(json);
+          setManifestError(false);
+          writeCachedManifest(channel, json);
+        }
       })
       .catch(() => {
-        if (!cancelled) setManifestError(true);
+        if (!cancelled && !cachedManifest) setManifestError(true);
       });
     return () => {
       cancelled = true;
@@ -202,6 +278,7 @@ export default function DownloadPage() {
   }, [channel, hostResolved, manifestRequest]);
 
   const retryManifest = () => {
+    setConfirmedDownload(null);
     setManifestRequest((request) => request + 1);
   };
 
@@ -210,13 +287,27 @@ export default function DownloadPage() {
 
     setManifest(null);
     setManifestError(false);
+    setConfirmedDownload(null);
     setChannel(nextChannel);
   };
 
   const primary = VARIANTS.find((v) => v.id === detected) ?? VARIANTS[0];
+  const primaryAsset = pickAsset(manifest, primary);
+  const downloadLabel = t("downloadRoute.downloadFor", {
+    platform: primary.label,
+  });
+  const downloadStartedLabel = t("downloadRoute.downloadStarted");
+  const primaryDownloadStarted =
+    confirmedDownload?.asset.url === primaryAsset?.url;
+
+  const handleDownload = (asset: Manifest["assets"][number], label: string) => {
+    markDesktopAppDownloaded();
+    setConfirmedDownload({ asset, label });
+  };
 
   const handlePlatformChange = (nextPlatform: PlatformId) => {
     if (nextPlatform === detected) return;
+    setConfirmedDownload(null);
     setDetected(nextPlatform);
   };
 
@@ -297,9 +388,35 @@ export default function DownloadPage() {
                 primary,
                 manifest,
                 manifestError,
-                t("downloadRoute.downloadFor", { platform: primary.label }),
+                downloadLabel,
                 t("downloadRoute.retry"),
                 retryManifest,
+                primaryDownloadStarted,
+                downloadStartedLabel,
+                (asset) => handleDownload(asset, downloadLabel),
+              )}
+
+              {primaryDownloadStarted && confirmedDownload && (
+                <p
+                  aria-live="polite"
+                  className="mt-3 text-xs text-muted-foreground"
+                >
+                  <span className="sr-only">{downloadStartedLabel}</span>
+                  <a
+                    href={confirmedDownload.asset.url}
+                    target="_blank"
+                    rel="noreferrer"
+                    onClick={() =>
+                      handleDownload(
+                        confirmedDownload.asset,
+                        confirmedDownload.label,
+                      )
+                    }
+                    className="text-muted-foreground underline underline-offset-2 hover:text-foreground"
+                  >
+                    {t("downloadRoute.downloadAgain")}
+                  </a>
+                </p>
               )}
 
               <div className="mt-5 flex justify-center">
@@ -349,25 +466,23 @@ export default function DownloadPage() {
           </div>
 
           {chromeExtensionEnabled && (
-            <section className="mt-10 w-full max-w-xl rounded-2xl border border-border bg-card p-4 text-start shadow-sm">
-              <div className="flex items-start gap-3">
-                <div className="flex h-9 w-9 shrink-0 items-center justify-center rounded-xl bg-primary/10 text-primary">
+            <section className="mt-16 w-full max-w-md text-start">
+              <div className="flex items-center gap-2">
+                <div className="flex size-7 shrink-0 items-center justify-center rounded-lg bg-muted text-muted-foreground">
                   <IconBrandChrome className="h-4 w-4" />
                 </div>
                 <div className="min-w-0 flex-1">
                   <h2 className="text-sm font-semibold text-foreground">
                     {t("downloadRoute.chromeTitle")}
                   </h2>
-                  <p className="mt-1 text-sm leading-relaxed text-muted-foreground">
-                    {t("downloadRoute.chromeDescription")}
-                  </p>
                 </div>
               </div>
               <Button
                 asChild={Boolean(clipsChromeExtensionUrl)}
                 disabled={!clipsChromeExtensionUrl}
                 variant="outline"
-                className="mt-4 w-full gap-2"
+                size="sm"
+                className="mt-3 w-full gap-2"
               >
                 {clipsChromeExtensionUrl ? (
                   <a

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

@@ -1122,10 +1122,10 @@ export default function ShareRoute() {
     canDownloadRecording || isLoomEmbedBacked ? recording.videoUrl : null;
 
   return (
-    <div className="flex min-h-screen max-w-full flex-col overflow-x-hidden bg-background text-foreground lg:h-screen lg:flex-row lg:overflow-hidden">
+    <div className="clips-recording-view flex min-h-screen w-full max-w-full flex-col overflow-x-hidden bg-background xl:h-screen xl:flex-row xl:overflow-hidden [&_.agent-composer-root]:!bg-background [&_.agent-composer-root]:!border-0">
       {agentDiscovery}
-      <div className="clips-share-content flex w-full min-w-0 flex-col lg:flex-1">
-        <header className="flex min-w-0 shrink-0 flex-wrap items-center gap-2 border-b border-border px-3 py-2 sm:px-4 sm:py-3 lg:flex-nowrap">
+      <div className="flex w-full min-w-0 flex-col xl:flex-1">
+        <header className="flex min-w-0 shrink-0 flex-wrap items-center gap-2 px-3 py-2 sm:px-4 sm:py-3 xl:flex-nowrap">
           {session ? (
             <Button
               asChild
@@ -1138,7 +1138,7 @@ export default function ShareRoute() {
               </Link>
             </Button>
           ) : null}
-          <div className="flex min-w-0 flex-1 items-center gap-2">
+          <div className="hidden min-w-0 flex-1 items-center gap-2 sm:flex">
             {recording.visibility === "private" ? (
               <span
                 className="inline-flex shrink-0 text-muted-foreground"
@@ -1168,6 +1168,7 @@ export default function ShareRoute() {
               agentViewCount={agentViewCount}
               canViewDetails={viewerCanEdit}
               onOpenInsights={() => setPanel("insights")}
+              className="shrink-0 border-0 shadow-none"
             />
             {session ? null : (
               <SignedOutShareActions
@@ -1189,7 +1190,10 @@ export default function ShareRoute() {
                 hasPassword={Boolean(recording.hasPassword)}
                 viewerReshareOnly={viewerReshareOnly}
               >
-                <ClipsShareTrigger label={t("sharePage.share")} />
+                <ClipsShareTrigger
+                  label={t("sharePage.share")}
+                  className="border-0 shadow-none"
+                />
               </ShareRecordingPopover>
             ) : null}
             {!viewerCanEdit && canDownloadRecording ? (
@@ -1240,8 +1244,8 @@ export default function ShareRoute() {
           </div>
         </header>
 
-        <div className="flex flex-col gap-4 overflow-hidden p-0 sm:p-4 lg:min-h-0 lg:flex-1">
-          <div className="relative aspect-video w-full lg:min-h-0 lg:flex-1 lg:aspect-auto">
+        <div className="flex flex-col gap-0 overflow-hidden p-0 sm:gap-4 sm:p-4 xl:min-h-0 xl:flex-1 xl:overflow-hidden">
+          <div className="relative aspect-video w-full xl:min-h-0 xl:flex-1 xl:aspect-auto">
             <VideoPlayer
               ref={playerRef}
               onVideoElementChange={setTrackedVideoEl}
@@ -1374,21 +1378,26 @@ export default function ShareRoute() {
               : null}
           </div>
 
-          <div className="clips-share-metadata flex shrink-0 flex-col gap-3 px-4 pb-4 sm:px-0 sm:pb-0">
-            <div className="clips-share-metadata-description min-w-0 flex-1">
-              {recording.description ? (
-                <p className="whitespace-pre-wrap break-words text-sm text-muted-foreground">
-                  {recording.description}
-                </p>
-              ) : null}
-            </div>
-            <div className="clips-share-metadata-actions flex max-w-full flex-col items-stretch gap-2 sm:items-end">
-              <div className="flex flex-wrap items-center gap-2 sm:justify-end">
+          <div className="flex shrink-0 flex-col gap-3 px-4 py-4 sm:flex-row sm:items-start sm:px-0 sm:py-0">
+            <div className="min-w-0 flex-1">
+              <div className="mb-3 sm:hidden">
+                {showTitleSkeleton ? (
+                  <Skeleton
+                    aria-label={t("sharePage.generatingTitle")}
+                    className="h-7 w-72 max-w-full"
+                  />
+                ) : (
+                  <h1 className="truncate text-2xl font-semibold leading-tight">
+                    {visibleTitle}
+                  </h1>
+                )}
+              </div>
+              <div className="flex flex-wrap items-center gap-2">
                 {recording.enableComments ? (
                   <TimestampedCommentButton
                     enableComments={recording.enableComments}
                     canComment={!session || viewerCanComment}
-                    className="shrink-0"
+                    className="shrink-0 border-0 shadow-none"
                     onOpen={() => {
                       if (!session) {
                         requireSignIn("comment");
@@ -1405,6 +1414,7 @@ export default function ShareRoute() {
                   <ReactionsTray
                     reactions={reactions}
                     disabled={Boolean(session) && !viewerCanComment}
+                    className="border-0 shadow-none"
                     onReact={(emoji) => {
                       if (!session) {
                         requireSignIn("react");
@@ -1441,13 +1451,18 @@ export default function ShareRoute() {
                   />
                 ) : null}
               </div>
+              {recording.description ? (
+                <p className="mt-3 whitespace-pre-wrap break-words text-sm text-muted-foreground">
+                  {recording.description}
+                </p>
+              ) : null}
               {viewerCanEdit && canDownloadRecording ? (
                 <Button
                   variant="outline"
                   size="sm"
                   onClick={downloadRecording}
                   disabled={downloading}
-                  className="gap-1.5"
+                  className="mt-3 gap-1.5 border-0 shadow-none"
                 >
                   <IconDownload className="h-4 w-4" />
                   {downloading
@@ -1460,7 +1475,7 @@ export default function ShareRoute() {
         </div>
       </div>
 
-      <aside className="flex min-h-[420px] w-full min-w-0 shrink-0 flex-col border-t border-border bg-background lg:min-h-0 lg:w-[380px] lg:border-s lg:border-t-0">
+      <aside className="flex min-h-[420px] w-full min-w-0 shrink-0 flex-col bg-muted xl:min-h-0 xl:w-[380px] xl:flex">
         <Tabs
           value={panel}
           onValueChange={setPanel}

package/corpus/templates/clips/server/routes/api/clips-latest.json.get.ts

@@ -32,12 +32,12 @@ import {
  *
  *   - A 5-minute process-wide memoization (`cached`) — every request
  *     for 5 min shares one upstream fetch.
- *   - A stale-while-error fallback — if GitHub ever errors out AND we
- *     have a previously-successful payload (even expired), we return
- *     it. Avoids a download outage during a transient GitHub hiccup or
- *     a rate-limit burst.
- *   - HTTP `cache-control: max-age=60` on the response so downstream
- *     CDNs + the browser cache this aggressively.
+ *   - A stale-while-revalidate refresh — once the cache expires, we return the
+ *     previous payload immediately and refresh it in the background.
+ *   - A stale-while-error fallback — if GitHub ever errors out AND we have a
+ *     previously-successful payload (even expired), we keep serving it.
+ *   - Durable HTTP cache headers with short freshness and a long stale window
+ *     for downstream CDNs + the browser.
  */
 
 const RELEASES_URL_BASE =
@@ -47,6 +47,16 @@ const PER_PAGE = 100;
 // by then, something else is wrong and the 404 is correct.
 const MAX_PAGES = 10;
 const CACHE_TTL_MS = 5 * 60_000;
+const CACHE_RETRY_BACKOFF_MS = 60_000;
+
+export const CLIPS_RELEASE_CACHE_HEADERS = {
+  "cache-control":
+    "public, max-age=300, stale-while-revalidate=86400, stale-if-error=86400",
+  "cdn-cache-control":
+    "public, max-age=300, stale-while-revalidate=86400, stale-if-error=86400",
+  "netlify-cdn-cache-control":
+    "public, durable, s-maxage=300, stale-while-revalidate=86400, stale-if-error=86400",
+} as const;
 
 export type ClipsReleaseChannel = "production" | "nightly";
 
@@ -201,6 +211,9 @@ const cache = new Map<
   { data: DownloadManifest; ts: number }
 >();
 const inFlight = new Map<ClipsReleaseChannel, Promise<DownloadManifest>>();
+const retryAfter = new Map<ClipsReleaseChannel, number>();
+
+type WaitUntil = (promise: Promise<unknown>) => void;
 
 class UpstreamError extends Error {
   statusCode: number;
@@ -347,32 +360,70 @@ async function buildManifest(
   };
 }
 
-async function getManifest(
-  channel: ClipsReleaseChannel = "production",
+function refreshManifest(
+  channel: ClipsReleaseChannel,
 ): Promise<DownloadManifest> {
-  const now = Date.now();
-  const cached = cache.get(channel);
-  if (cached && now - cached.ts < CACHE_TTL_MS) return cached.data;
   const pending = inFlight.get(channel);
   if (pending) return pending;
   const request = (async () => {
     try {
       const data = await buildManifest(channel);
       cache.set(channel, { data, ts: Date.now() });
+      retryAfter.delete(channel);
       return data;
-    } catch (err) {
-      // Stale-while-error: if we have an older payload, serve it. Only
-      // bubble the error if the cache is empty.
-      if (cached) return cached.data;
-      throw err;
-    } finally {
-      inFlight.delete(channel);
+    } catch (error) {
+      retryAfter.set(channel, Date.now() + CACHE_RETRY_BACKOFF_MS);
+      throw error;
     }
   })();
-  inFlight.set(channel, request);
-  return request;
+  inFlight.set(
+    channel,
+    request.finally(() => {
+      inFlight.delete(channel);
+    }),
+  );
+  return inFlight.get(channel)!;
+}
+
+function refreshInBackground(
+  channel: ClipsReleaseChannel,
+  waitUntil?: WaitUntil,
+): void {
+  const refresh = refreshManifest(channel).catch(() => undefined);
+  if (waitUntil) {
+    waitUntil(refresh);
+  } else {
+    void refresh;
+  }
 }
 
+async function getManifest(
+  channel: ClipsReleaseChannel = "production",
+  waitUntil?: WaitUntil,
+): Promise<DownloadManifest> {
+  const now = Date.now();
+  const cached = cache.get(channel);
+  if (cached) {
+    if (
+      now - cached.ts >= CACHE_TTL_MS &&
+      now >= (retryAfter.get(channel) ?? 0)
+    ) {
+      refreshInBackground(channel, waitUntil);
+    }
+    return cached.data;
+  }
+  return refreshManifest(channel);
+}
+
+export const __clipsLatestTest = {
+  getManifest,
+  reset() {
+    cache.clear();
+    inFlight.clear();
+    retryAfter.clear();
+  },
+};
+
 export function normalizeClipsReleaseChannel(
   value: unknown,
 ): ClipsReleaseChannel {
@@ -383,7 +434,11 @@ export default defineEventHandler(async (event) => {
   const channel = normalizeClipsReleaseChannel(getQuery(event).channel);
   let manifest: DownloadManifest;
   try {
-    manifest = await getManifest(channel);
+    const waitUntil =
+      typeof event.waitUntil === "function"
+        ? (promise: Promise<unknown>) => event.waitUntil(promise)
+        : undefined;
+    manifest = await getManifest(channel, waitUntil);
   } catch (err) {
     const e = err as {
       statusCode?: number;
@@ -397,7 +452,7 @@ export default defineEventHandler(async (event) => {
   }
   setResponseHeaders(event, {
     "content-type": "application/json; charset=utf-8",
-    "cache-control": "public, max-age=60",
+    ...CLIPS_RELEASE_CACHE_HEADERS,
   });
   return manifest;
 });

package/corpus/templates/forms/actions/response-insights.ts

@@ -77,7 +77,10 @@ const responseInsightsSchema = z.object({
 type ResponseInsightsArgs = z.infer<typeof responseInsightsSchema>;
 
 type FormRow = typeof schema.forms.$inferSelect;
-type ResponseRow = typeof schema.responses.$inferSelect;
+type ResponseRow = Pick<
+  typeof schema.responses.$inferSelect,
+  "id" | "formId" | "data" | "submittedAt" | "submitterEmail"
+>;
 
 function safeJson<T>(value: string, fallback: T): T {
   try {
@@ -331,10 +334,7 @@ export default defineAction({
             formId: schema.responses.formId,
             data: schema.responses.data,
             submittedAt: schema.responses.submittedAt,
-            ip: schema.responses.ip,
             submitterEmail: schema.responses.submitterEmail,
-            pageUrl: schema.responses.pageUrl,
-            clientSurface: schema.responses.clientSurface,
           })
           .from(schema.responses)
           .where(responseFilter)

package/corpus/templates/forms/actions/retry-response-deliveries.ts

@@ -0,0 +1,26 @@
+import { defineAction } from "@agent-native/core/action";
+import { assertAccess } from "@agent-native/core/sharing";
+import { eq } from "drizzle-orm";
+import { z } from "zod";
+
+import { getDb, schema } from "../server/db/index.js";
+import { reconcileResponseDeliveries } from "../server/handlers/submissions.js";
+
+export default defineAction({
+  description:
+    "Retry failed or pending deliveries for a saved response using its immutable delivery snapshot. The form may be unpublished or archived; pass the response ID.",
+  schema: z.object({
+    responseId: z.string().describe("Saved response ID to reconcile"),
+  }),
+  run: async ({ responseId }) => {
+    const db = getDb();
+    const [response] = await db
+      .select({ formId: schema.responses.formId })
+      .from(schema.responses)
+      .where(eq(schema.responses.id, responseId));
+    if (!response) throw new Error(`Response ${responseId} not found`);
+
+    await assertAccess("form", response.formId, "editor");
+    return reconcileResponseDeliveries(responseId);
+  },
+});