@agent-native/core 0.80.10 → 0.80.11

package/corpus/templates/assets/app/routes/_index.tsx

@@ -9,6 +9,7 @@ import { IconPhoto, IconSparkles, IconVideo } from "@tabler/icons-react";
 import { useEffect } from "react";
 import { useNavigate, useParams } from "react-router";
 
+import { RecentDraftsSection } from "@/components/create/RecentDraftsSection";
 import { GenerationResults } from "@/components/generation/GenerationResults";
 import { useImageModelMenu } from "@/hooks/use-image-model-menu";
 import { ASSETS_CHAT_STORAGE_KEY } from "@/lib/chat";
@@ -122,6 +123,9 @@ export default function CreatePage() {
                 </button>
               ))}
             </div>
+            <div className="mt-8 w-full text-left">
+              <RecentDraftsSection />
+            </div>
           </div>
         }
       />

package/corpus/templates/assets/app/routes/library.tsx

@@ -102,16 +102,22 @@ import {
   type VariantSlot,
 } from "./brand-kits.$id";
 
-type AssetTab = "all" | "generated" | "references";
+type AssetTab = "all" | "generated" | "drafts" | "references";
 
 function isGeneratedAsset(asset: Asset) {
   const role = asset.role ?? "";
   return role === "generated" || role === "active" || role === "candidate";
 }
 
+function isDraftAsset(asset: Asset) {
+  return asset.role === "generated" && asset.status === "candidate";
+}
+
 function assetMatchesTab(asset: Asset, tab: AssetTab) {
   if (tab === "all") return true;
-  if (tab === "generated") return isGeneratedAsset(asset);
+  if (tab === "drafts") return isDraftAsset(asset);
+  if (tab === "generated")
+    return isGeneratedAsset(asset) && !isDraftAsset(asset);
   return !isGeneratedAsset(asset);
 }
 
@@ -1957,12 +1963,29 @@ export function LibraryWorkspace({
 
 export function AssetPickerSurface() {
   const t = useT();
-  const [searchParams] = useSearchParams();
+  const [searchParams, setSearchParams] = useSearchParams();
   const searchParamsKey = searchParams.toString();
+  const urlAssetTab = useMemo<AssetTab | null>(() => {
+    const tab = new URLSearchParams(searchParamsKey).get("tab");
+    return tab === "all" ||
+      tab === "generated" ||
+      tab === "drafts" ||
+      tab === "references"
+      ? tab
+      : null;
+  }, [searchParamsKey]);
+  // The active tab is the only host-irrelevant search param. Exclude it from the
+  // host-config key so toggling tabs (which writes `?tab=`) doesn't retrigger the
+  // effect that resets media type / query / library from the URL.
+  const hostParamsKey = useMemo(() => {
+    const params = new URLSearchParams(searchParamsKey);
+    params.delete("tab");
+    return params.toString();
+  }, [searchParamsKey]);
   const mcpChatBridgeActive =
     searchParamsRequestPicker(searchParams) || isEmbedMcpChatBridgeActive();
   const urlHostConfig = useMemo(() => {
-    const params = new URLSearchParams(searchParamsKey);
+    const params = new URLSearchParams(hostParamsKey);
     return {
       mediaType: normalizeMediaType(params.get("mediaType")),
       prompt: params.get("prompt") ?? undefined,
@@ -1983,7 +2006,7 @@ export function AssetPickerSurface() {
       ),
       autoGenerate: normalizeBoolean(params.get("autoGenerate")) ?? false,
     } satisfies HostConfig;
-  }, [searchParamsKey]);
+  }, [hostParamsKey]);
   const bridgeRef = useRef<EmbeddedAppBridge | null>(null);
   const embedded = useMemo(
     () =>
@@ -2008,7 +2031,7 @@ export function AssetPickerSurface() {
   );
   const [presetId, setPresetId] = useState(() => hostConfig.presetId ?? "none");
   const [count, setCount] = useState(() => hostConfig.count ?? 3);
-  const [assetTab, setAssetTab] = useState<AssetTab>("all");
+  const [assetTab, setAssetTab] = useState<AssetTab>(urlAssetTab ?? "all");
   const [selectedLibraryId, setSelectedLibraryId] = useState(
     () => hostConfig.libraryId ?? "",
   );
@@ -2032,6 +2055,30 @@ export function AssetPickerSurface() {
     setVisibleCandidateRunIds(urlHostConfig.candidateRunIds ?? []);
   }, [urlHostConfig]);
 
+  useEffect(() => {
+    // Reset to "all" when the tab param is removed (e.g. back/forward nav)
+    // since the component stays mounted across search-param changes.
+    setAssetTab(urlAssetTab ?? "all");
+  }, [urlAssetTab]);
+
+  const handleAssetTabChange = useCallback(
+    (value: AssetTab) => {
+      setAssetTab(value);
+      // Keep the tab reflected in the URL so it survives refresh/share and
+      // stays consistent with the `?tab=` deep link from the home page.
+      setSearchParams(
+        (prev) => {
+          const next = new URLSearchParams(prev);
+          if (value === "all") next.delete("tab");
+          else next.set("tab", value);
+          return next;
+        },
+        { replace: true },
+      );
+    },
+    [setSearchParams],
+  );
+
   const librariesQuery = useActionQuery("list-libraries", {
     compact: true,
   } as any) as {
@@ -2116,23 +2163,54 @@ export function AssetPickerSurface() {
     !selectedPreset &&
     Boolean(waitingForPresetData);
   const mediaLabel = mediaType === "video" ? "video" : "image";
+  const viewingDrafts = assetTab === "drafts";
+  // The standalone Library "Drafts" tab mirrors the home Recent Drafts section:
+  // every unsaved draft across all accessible libraries, regardless of media
+  // type. The embedded picker keeps its library + media-type scope so an
+  // image-only picker never surfaces video drafts.
+  const draftsGlobalView = viewingDrafts && !embedded;
   const assetsParams = useMemo(
     () => ({
       libraryId: selectedLibraryId,
       mediaType,
+      // Drafts are exactly generated candidates — filter them server-side
+      // instead of fetching the whole library and filtering on the client.
+      role: viewingDrafts ? "generated" : undefined,
+      status: viewingDrafts ? "candidate" : undefined,
       query: query.trim() || undefined,
       includeCandidates:
-        mediaType === "image" && visibleCandidateRunIds.length > 0,
+        viewingDrafts ||
+        (mediaType === "image" && visibleCandidateRunIds.length > 0),
+      // The Drafts tab shows every unsaved draft, not just the latest run batch.
       candidateRunIds:
-        visibleCandidateRunIds.length > 0 ? visibleCandidateRunIds : undefined,
+        !viewingDrafts && visibleCandidateRunIds.length > 0
+          ? visibleCandidateRunIds
+          : undefined,
     }),
-    [mediaType, query, selectedLibraryId, visibleCandidateRunIds],
+    [
+      viewingDrafts,
+      mediaType,
+      query,
+      selectedLibraryId,
+      visibleCandidateRunIds,
+    ],
   );
   const { data: assetData, isLoading: assetsLoading } = useActionQuery(
     "list-assets",
     assetsParams as any,
-    { enabled: Boolean(selectedLibraryId) && !usingStarterLibrary } as any,
+    {
+      enabled:
+        Boolean(selectedLibraryId) && !usingStarterLibrary && !draftsGlobalView,
+    } as any,
   ) as { data?: { assets?: Asset[] }; isLoading: boolean };
+  const { data: globalDraftsData, isLoading: globalDraftsLoading } =
+    useActionQuery(
+      "list-draft-assets",
+      { limit: 500 } as any,
+      {
+        enabled: draftsGlobalView,
+      } as any,
+    ) as { data?: { assets?: Asset[] }; isLoading: boolean };
   const starterAssets: Asset[] = useMemo(
     () =>
       STARTER_PRESET.referenceImages.map((reference) => ({
@@ -2159,11 +2237,23 @@ export function AssetPickerSurface() {
         .some((value) => String(value).toLowerCase().includes(needle)),
     );
   }, [query, starterAssets]);
-  const allAssets = usingStarterLibrary
-    ? mediaType === "image"
-      ? visibleStarterAssets
-      : []
-    : (assetData?.assets ?? []);
+  const globalDrafts = useMemo(() => {
+    const drafts = globalDraftsData?.assets ?? [];
+    const needle = query.trim().toLowerCase();
+    if (!needle) return drafts;
+    return drafts.filter((asset) =>
+      [asset.title, asset.description, asset.prompt]
+        .filter(Boolean)
+        .some((value) => String(value).toLowerCase().includes(needle)),
+    );
+  }, [globalDraftsData, query]);
+  const allAssets = draftsGlobalView
+    ? globalDrafts
+    : usingStarterLibrary
+      ? mediaType === "image"
+        ? visibleStarterAssets
+        : []
+      : (assetData?.assets ?? []);
   const currentLibrary = useMemo(
     () =>
       displayLibraries.find((library) => library.id === selectedLibraryId) ??
@@ -2174,6 +2264,7 @@ export function AssetPickerSurface() {
     () => allAssets.filter((asset) => assetMatchesTab(asset, assetTab)),
     [allAssets, assetTab],
   );
+  const listLoading = draftsGlobalView ? globalDraftsLoading : assetsLoading;
   const [previewAsset, setPreviewAsset] = useState<Asset | null>(null);
   const [standaloneSelection, setStandaloneSelection] = useState<ReturnType<
     typeof assetPayload
@@ -2845,27 +2936,35 @@ export function AssetPickerSurface() {
         {displayLibraries.length > 0 && (
           <div className="mb-3 flex flex-col gap-2 sm:flex-row sm:items-center sm:justify-between">
             <div className="flex flex-col gap-2 sm:flex-row sm:items-center">
-              <Select
-                value={selectedLibraryId}
-                onValueChange={setSelectedLibraryId}
-              >
-                <SelectTrigger className="h-9 w-full border-border/70 bg-background sm:w-48">
-                  <SelectValue placeholder={t("library.library")} />
-                </SelectTrigger>
-                <SelectContent>
-                  <SelectGroup>
-                    {displayLibraries.map((library) => (
-                      <SelectItem key={library.id} value={library.id}>
-                        {library.title}
-                      </SelectItem>
-                    ))}
-                  </SelectGroup>
-                </SelectContent>
-              </Select>
+              {draftsGlobalView ? (
+                <div className="flex h-9 items-center rounded-md border border-border/70 bg-background px-3 text-sm text-muted-foreground sm:w-48">
+                  {t("library.allLibraries")}
+                </div>
+              ) : (
+                <Select
+                  value={selectedLibraryId}
+                  onValueChange={setSelectedLibraryId}
+                >
+                  <SelectTrigger className="h-9 w-full border-border/70 bg-background sm:w-48">
+                    <SelectValue placeholder={t("library.library")} />
+                  </SelectTrigger>
+                  <SelectContent>
+                    <SelectGroup>
+                      {displayLibraries.map((library) => (
+                        <SelectItem key={library.id} value={library.id}>
+                          {library.title}
+                        </SelectItem>
+                      ))}
+                    </SelectGroup>
+                  </SelectContent>
+                </Select>
+              )}
               {selectedLibraryId && (
                 <Tabs
                   value={assetTab}
-                  onValueChange={(value) => setAssetTab(value as AssetTab)}
+                  onValueChange={(value) =>
+                    handleAssetTabChange(value as AssetTab)
+                  }
                 >
                   <TabsList>
                     <TabsTrigger value="all">
@@ -2874,6 +2973,9 @@ export function AssetPickerSurface() {
                     <TabsTrigger value="generated">
                       {t("library.generated")}
                     </TabsTrigger>
+                    <TabsTrigger value="drafts">
+                      {t("library.drafts")}
+                    </TabsTrigger>
                     <TabsTrigger value="references">
                       {t("library.references")}
                     </TabsTrigger>
@@ -2897,6 +2999,7 @@ export function AssetPickerSurface() {
         {mediaType === "image" &&
           selectedLibraryId &&
           !usingStarterLibrary &&
+          !viewingDrafts &&
           pickerVariantScopeId && (
             <LibraryCandidateStage
               activeLibraryId={selectedLibraryId}
@@ -2914,7 +3017,7 @@ export function AssetPickerSurface() {
           </div>
         )}
 
-        {selectedLibraryId && assetsLoading && (
+        {selectedLibraryId && listLoading && (
           <div className="assets-library-dense-grid grid grid-cols-2 gap-3">
             {Array.from({ length: 8 }).map((_, index) => (
               <Skeleton key={index} className="aspect-square rounded-md" />
@@ -2922,12 +3025,16 @@ export function AssetPickerSurface() {
           </div>
         )}
 
-        {selectedLibraryId && !assetsLoading && assets.length === 0 && (
+        {selectedLibraryId && !listLoading && assets.length === 0 && (
           <div className="flex h-full items-center justify-center text-center">
             <div className="max-w-sm text-sm text-muted-foreground">
-              {query
-                ? t("library.noMatchingLibraryAssets", { mediaLabel })
-                : t("library.noAssetsInLibrary", { mediaLabel })}
+              {draftsGlobalView
+                ? query
+                  ? t("library.noMatchingDrafts")
+                  : t("library.noDrafts")
+                : query
+                  ? t("library.noMatchingLibraryAssets", { mediaLabel })
+                  : t("library.noAssetsInLibrary", { mediaLabel })}
             </div>
           </div>
         )}

package/corpus/templates/assets/changelog/2026-06-29-image-generation-can-now-render-requested-text-and-respect-b.md

@@ -0,0 +1,6 @@
+---
+type: improved
+date: 2026-06-29
+---
+
+Image generation can now render requested text and respect brand fonts

package/corpus/templates/assets/changelog/2026-06-30-image-generation-no-longer-looks-stuck-while-the-provider-is-still-working.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-06-30
+---
+
+Image generation no longer looks stuck while the provider is still creating and saving the asset.

package/corpus/templates/assets/changelog/2026-06-30-tagged-presets-now-control-the-image-aspect-ratio.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-06-30
+---
+
+Tagging a @preset now reliably uses its aspect ratio and other saved settings instead of a guessed one

package/corpus/templates/assets/server/lib/generation.ts

@@ -11,6 +11,7 @@ import type {
   GenerationIntent,
   ImageCategory,
   ImageModel,
+  ImageQualityTier,
   ImageSize,
   StyleStrength,
   StyleBrief,
@@ -564,7 +565,8 @@ export async function analyzeStyleWithGemini(input: {
       {
         text: [
           "Analyze these brand/style reference images for a reusable image generation style brief.",
-          "Return only compact JSON with keys: description, medium, mood, subjectMatter, texture, composition, lighting, typographyPolicy, doNot.",
+          "Return only compact JSON with keys: description, medium, mood, subjectMatter, texture, composition, lighting, fontFamilies, fontWeights, letterforms, caseStyle, typographyPolicy, doNot.",
+          "For typography, describe specific letterforms and font traits, not just broad sans/serif categories; omit any typography field you cannot determine confidently.",
           "Use specific trait-locking phrases that can be reused across future image prompts.",
           "Do not name brands, artists, studios, franchises, or copyrighted works unless they appear as user-provided brand identity.",
           "Keep doNot as an array of short constraints. Omit uncertain fields instead of guessing.",
@@ -608,16 +610,24 @@ function extractJsonObject(text: string): string {
   return "{}";
 }
 
-function sanitizeStyleBrief(value: Record<string, unknown>): StyleBrief {
+export function sanitizeStyleBrief(value: Record<string, unknown>): StyleBrief {
   const stringField = (key: string) => {
     const raw = value[key];
     return typeof raw === "string" && raw.trim() ? raw.trim() : undefined;
   };
-  const doNot = Array.isArray(value.doNot)
-    ? value.doNot.filter(
-        (item): item is string => typeof item === "string" && !!item.trim(),
-      )
-    : undefined;
+  const stringArrayField = (key: string) => {
+    const raw = value[key];
+    return Array.isArray(raw)
+      ? raw
+          .filter(
+            (item): item is string => typeof item === "string" && !!item.trim(),
+          )
+          .map((item) => item.trim())
+      : undefined;
+  };
+  const fontFamilies = stringArrayField("fontFamilies");
+  const fontWeights = stringArrayField("fontWeights");
+  const doNot = stringArrayField("doNot");
   return {
     description: stringField("description"),
     medium: stringField("medium"),
@@ -626,8 +636,12 @@ function sanitizeStyleBrief(value: Record<string, unknown>): StyleBrief {
     texture: stringField("texture"),
     composition: stringField("composition"),
     lighting: stringField("lighting"),
+    fontFamilies: fontFamilies?.length ? fontFamilies : undefined,
+    fontWeights: fontWeights?.length ? fontWeights : undefined,
+    letterforms: stringField("letterforms"),
+    caseStyle: stringField("caseStyle"),
     typographyPolicy: stringField("typographyPolicy"),
-    doNot: doNot?.length ? doNot.map((item) => item.trim()) : undefined,
+    doNot: doNot?.length ? doNot : undefined,
   };
 }
 
@@ -774,6 +788,66 @@ function toBuilderImageModel(model: ImageModel) {
   return model;
 }
 
+function resolveModelForTier(
+  tier: ImageQualityTier | undefined,
+  category: ImageCategory | undefined,
+): ImageModel | undefined {
+  if (!tier) return undefined;
+  if (tier === "fast") return "gemini-3.1-flash-image";
+  if (tier === "best") return "gemini-3-pro-image";
+  return ["hero", "landing", "logo", "campaign"].includes(category ?? "")
+    ? "gemini-3-pro-image"
+    : "gemini-3.1-flash-image";
+}
+
+export function resolveImageModelForRequest(input: {
+  explicitModel?: ImageModel;
+  imageModelDefault?: ImageModel;
+  explicitTier?: ImageQualityTier;
+  resolvedTier?: ImageQualityTier;
+  category?: ImageCategory;
+  presetModel?: ImageModel | null;
+  embeddedText?: string | null;
+}): ImageModel {
+  if (input.explicitModel) return input.explicitModel;
+
+  // Exact embedded text is materially better on Gemini Pro, so upgrade to it by
+  // default for text requests — but never override a model or tier the caller
+  // or a tagged preset already chose (presets "own" model/tier per the action
+  // docs). Only auto-upgrade when there is no tier (explicit or preset-derived)
+  // and no preset model in play; this still upgrades a bare text request over
+  // the composer default.
+  const textAccurateModel: ImageModel | undefined =
+    input.embeddedText?.trim() &&
+    !input.explicitTier &&
+    !input.resolvedTier &&
+    !input.presetModel
+      ? "gemini-3-pro-image"
+      : undefined;
+
+  // Precedence: explicit per-request model (handled above) > embedded-text
+  // upgrade > an EXPLICIT per-request tier > the preset's saved model > the
+  // preset-DERIVED tier mapping > the sticky composer default > the floor.
+  //
+  // Two subtleties:
+  //   - An explicit per-request tier outranks the preset's saved model (the
+  //     caller is deliberately overriding the preset this turn).
+  //   - The preset's explicit saved model outranks its OWN derived tier: a
+  //     preset's `model` column and `settings.tier` can drift out of sync
+  //     (update-generation-preset can change one without the other), and the
+  //     explicitly saved model is the authoritative choice.
+  //   - The composer default ranks LAST of the real signals: it is a global
+  //     stored preference and must not defeat a tagged preset or a tier request.
+  return (
+    textAccurateModel ??
+    resolveModelForTier(input.explicitTier, input.category) ??
+    input.presetModel ??
+    resolveModelForTier(input.resolvedTier, input.category) ??
+    input.imageModelDefault ??
+    "gemini-3.1-flash-image"
+  );
+}
+
 function toBuilderReferenceRole(role: string) {
   switch (role) {
     case "style_reference":
@@ -799,6 +873,8 @@ export function compilePrompt(input: {
   styleBrief: StyleBrief;
   customInstructions?: string | null;
   prompt: string;
+  embeddedText?: string | null;
+  textPlacement?: string | null;
   referenceCount: number;
   includeLogo: boolean;
   aspectRatio?: AspectRatio;
@@ -815,6 +891,11 @@ export function compilePrompt(input: {
   const doNot = style.doNot?.length
     ? `\nAvoid: ${style.doNot.join("; ")}.`
     : "";
+  const typographyBlock = formatBrandTypography(style);
+  const requestedEmbeddedText = hasEmbeddedText(input.embeddedText);
+  const textInstruction = requestedEmbeddedText
+    ? formatEmbeddedTextInstruction(input.embeddedText, input.textPlacement)
+    : "Do not render headlines, body text, UI labels, or prompt wording inside the image unless the user explicitly asks for exact visible text.";
   const logoInstruction = input.includeLogo
     ? "\nLeave a clean uncluttered area in the upper-right for the real brand logo; do not draw or approximate the logo yourself."
     : "";
@@ -839,14 +920,24 @@ export function compilePrompt(input: {
           : "No reference images are attached for this run. Use the style brief and custom instructions as the source of truth.";
 
   if (intent === "edit") {
+    const editTypographyInstruction =
+      requestedEmbeddedText && typographyBlock ? `\n\n${typographyBlock}` : "";
+    const editTextInstruction = requestedEmbeddedText
+      ? `\n\n${formatEmbeddedTextInstruction(input.embeddedText, input.textPlacement)}`
+      : "";
+    const editConstraint = requestedEmbeddedText
+      ? "Do not reimagine the image, change its aspect ratio, or alter unrelated subjects. Do not add any other new text. Return the full image."
+      : "Do not reimagine the image, change its aspect ratio, add new text, or alter unrelated subjects. Return the full image.";
     return `Edit the attached image for the "${input.libraryTitle}" asset library.
 
 ${referenceInstruction}
+${editTypographyInstruction}
 
 Make only this change:
 ${input.prompt}
+${editTextInstruction}
 
-Do not reimagine the image, change its aspect ratio, add new text, or alter unrelated subjects. Return the full image.`;
+${editConstraint}`;
   }
 
   return `Create a brand-consistent image for the "${input.libraryTitle}" asset library.
@@ -861,15 +952,48 @@ ${style.subjectMatter ? `\nSubject matter: ${style.subjectMatter}.` : ""}
 ${style.texture ? `\nTexture/material treatment: ${style.texture}.` : ""}
 ${style.composition ? `\nComposition: ${style.composition}.` : ""}
 ${style.lighting ? `\nLighting: ${style.lighting}.` : ""}
-${style.typographyPolicy ? `\nTypography policy: ${style.typographyPolicy}.` : ""}${frameInstruction}
+${typographyBlock ? `\n${typographyBlock}` : ""}${frameInstruction}
 ${doNot}${logoInstruction}${diagramInstruction}${customInstructions}
 
-Do not render headlines, body text, UI labels, or prompt wording inside the image unless the user explicitly asks for exact visible text.
+${textInstruction}
 
 User request:
 ${input.prompt}`;
 }
 
+function hasEmbeddedText(value?: string | null): boolean {
+  return typeof value === "string" && !!value.trim();
+}
+
+function formatEmbeddedTextInstruction(
+  embeddedText?: string | null,
+  textPlacement?: string | null,
+): string {
+  const placement = textPlacement?.trim();
+  return [
+    `Render this text exactly, spelled correctly, inside the image: ${JSON.stringify(embeddedText ?? "")}.`,
+    placement ? `Placement: ${placement}.` : "",
+    "Match the brand typography described above where specified; keep it legible and well-kerned.",
+  ]
+    .filter(Boolean)
+    .join(" ");
+}
+
+function formatBrandTypography(style: StyleBrief): string {
+  const parts = [
+    style.fontFamilies?.length
+      ? `families ${style.fontFamilies.join(", ")}`
+      : "",
+    style.fontWeights?.length ? `weights ${style.fontWeights.join(", ")}` : "",
+    style.letterforms ? `letterforms: ${style.letterforms}` : "",
+    style.caseStyle ? `case: ${style.caseStyle}` : "",
+    style.typographyPolicy,
+  ].filter((part): part is string => typeof part === "string" && !!part.trim());
+
+  if (!parts.length) return "";
+  return `Brand typography: ${parts.join("; ")}. Match these for any rendered text.`;
+}
+
 // A content-only reference is an image the user attached as subject/content for
 // a single request (not a reusable brand/style reference). It should never count
 // as a brand-kit style reference.

package/corpus/templates/assets/shared/api.ts

@@ -112,6 +112,10 @@ export interface StyleBrief {
   texture?: string;
   composition?: string;
   lighting?: string;
+  fontFamilies?: string[];
+  fontWeights?: string[];
+  letterforms?: string;
+  caseStyle?: string;
   typographyPolicy?: string;
   doNot?: string[];
 }

package/corpus/templates/clips/actions/list-ai-requests.ts

@@ -0,0 +1,60 @@
+/**
+ * List pending clips AI requests for the current user.
+ *
+ * Collapses the per-recording `clips-ai-request-<id>` polling done by the
+ * auto-title bridge into a single call. Application state is already
+ * session-scoped, and we additionally filter the referenced recordings through
+ * `accessFilter` so we never return a request for a recording the user can't
+ * access. Only requests for `status = "ready"` recordings are returned — the
+ * bridge ignores non-ready recordings, so excluding them avoids sending large
+ * transcript blobs for recordings the hook will skip this tick.
+ */
+
+import { defineAction } from "@agent-native/core";
+import { listAppState } from "@agent-native/core/application-state";
+import { accessFilter } from "@agent-native/core/sharing";
+import { and, eq, inArray } from "drizzle-orm";
+import { z } from "zod";
+
+import { getDb, schema } from "../server/db/index.js";
+
+const REQUEST_PREFIX = "clips-ai-request-";
+
+export default defineAction({
+  description:
+    "List pending clips AI requests (regenerate-title, summary, chapters, etc.) for recordings the current user can access.",
+  schema: z.object({}),
+  http: { method: "GET" },
+  run: async () => {
+    const entries = await listAppState(REQUEST_PREFIX);
+
+    const requests = entries
+      .map((e) => e.value as Record<string, unknown>)
+      .filter(
+        (v): v is Record<string, unknown> & { recordingId: string } =>
+          !!v && typeof v.recordingId === "string" && v.recordingId.length > 0,
+      );
+
+    if (requests.length === 0) return { requests: [] };
+
+    const recordingIds = [...new Set(requests.map((r) => r.recordingId))];
+
+    const db = getDb();
+    const accessible = await db
+      .select({ id: schema.recordings.id })
+      .from(schema.recordings)
+      .where(
+        and(
+          accessFilter(schema.recordings, schema.recordingShares),
+          inArray(schema.recordings.id, recordingIds),
+          eq(schema.recordings.status, "ready"),
+        ),
+      );
+
+    const accessibleIds = new Set(accessible.map((r) => r.id));
+
+    return {
+      requests: requests.filter((r) => accessibleIds.has(r.recordingId)),
+    };
+  },
+});