@agent-native/core 0.108.0 → 0.109.1

package/corpus/templates/clips/shared/finalize-recovery.ts

@@ -18,8 +18,24 @@ export type RecoveredReadyRecording = {
   hasCamera?: boolean;
 };
 
+export type RecoveredProcessingRecording = {
+  ok: true;
+  finalized: false;
+  recoveredAfterFinalizeError: true;
+  id: string;
+  recordingId: string;
+  status: "processing";
+  verificationPending: true;
+  videoUrl?: string;
+};
+
+export type RecoveredFinalizeRecording =
+  | RecoveredReadyRecording
+  | RecoveredProcessingRecording;
+
 type ProbeResult =
   | { ready: true; result: RecoveredReadyRecording }
+  | { ready: false; accepted: true; result: RecoveredProcessingRecording }
   | { ready: false; terminal: boolean; status?: string };
 
 const DEFAULT_READY_RECOVERY_TIMEOUT_MS = 90_000;
@@ -114,6 +130,7 @@ function optionalBoolean(value: unknown): boolean | undefined {
 export function readyRecordingFromPublicPayload(
   payload: unknown,
   fallbackRecordingId: string,
+  options: { acceptPendingVerification?: boolean } = {},
 ): ProbeResult {
   const root =
     payload && typeof payload === "object"
@@ -129,6 +146,34 @@ export function readyRecordingFromPublicPayload(
   if (!recording) return { ready: false, terminal: false };
   if (status === "failed") return { ready: false, terminal: true, status };
 
+  if (
+    options.acceptPendingVerification &&
+    status === "processing" &&
+    recording.verificationPending === true
+  ) {
+    const id =
+      typeof recording.id === "string" && recording.id
+        ? recording.id
+        : fallbackRecordingId;
+    return {
+      ready: false,
+      accepted: true,
+      result: {
+        ok: true,
+        finalized: false,
+        recoveredAfterFinalizeError: true,
+        id,
+        recordingId: id,
+        status: "processing",
+        verificationPending: true,
+        videoUrl:
+          typeof recording.videoUrl === "string"
+            ? recording.videoUrl
+            : undefined,
+      },
+    };
+  }
+
   const videoUrl =
     typeof recording.videoUrl === "string" ? recording.videoUrl : "";
   if (status !== "ready" || !videoUrl) {
@@ -187,8 +232,9 @@ export async function waitForReadyRecordingAfterFinalizeError(args: {
   timeoutMs?: number;
   intervalMs?: number;
   fetchTimeoutMs?: number;
+  acceptPendingVerification?: boolean;
   signal?: AbortSignal;
-}): Promise<RecoveredReadyRecording | null> {
+}): Promise<RecoveredFinalizeRecording | null> {
   const fetchImpl = args.fetchImpl ?? fetch;
   const sleepImpl = args.sleepImpl ?? ((ms) => sleep(ms, args.signal));
   const timeoutMs = Math.max(
@@ -248,9 +294,13 @@ export async function waitForReadyRecordingAfterFinalizeError(args: {
           const probe = readyRecordingFromPublicPayload(
             payload,
             args.recordingId,
+            {
+              acceptPendingVerification: args.acceptPendingVerification,
+            },
           );
           if (probe.ready) return probe.result;
-          if (probe.terminal) return null;
+          if ("accepted" in probe && probe.accepted) return probe.result;
+          if ("terminal" in probe && probe.terminal) return null;
           break;
         }
 
@@ -272,3 +322,12 @@ export async function waitForReadyRecordingAfterFinalizeError(args: {
 
   return null;
 }
+
+export function waitForAcceptedRecordingAfterFinalizeError(
+  args: Parameters<typeof waitForReadyRecordingAfterFinalizeError>[0],
+): Promise<RecoveredFinalizeRecording | null> {
+  return waitForReadyRecordingAfterFinalizeError({
+    ...args,
+    acceptPendingVerification: true,
+  });
+}

package/corpus/templates/clips/shared/share-meta.ts

@@ -47,7 +47,7 @@ export function preferredSocialImage(
   recording: ClipsShareMetaRecording | null,
 ): string | undefined {
   return (
-    recording?.animatedThumbnailUrl || recording?.thumbnailUrl || undefined
+    recording?.thumbnailUrl || recording?.animatedThumbnailUrl || undefined
   );
 }
 

package/corpus/templates/content/app/entry.client.tsx

@@ -1,7 +1,12 @@
-import { appBasePath } from "@agent-native/core/client/api-path";
+import {
+  appBasePath,
+  installRouteChunkRecovery,
+} from "@agent-native/core/client";
 import { hydrateRoot } from "react-dom/client";
 import { HydratedRouter } from "react-router/dom";
 
+installRouteChunkRecovery();
+
 const basePath = appBasePath();
 const pathname = window.location.pathname;
 const routerBasePath =

package/corpus/templates/dispatch/AGENTS.md

@@ -31,6 +31,11 @@ specific essentials.
   setup item is unclear.
 - Keep approval and routing behavior explicit. Never silently widen access to
   secrets, apps, integrations, or workspace resources.
+- Curated workspace templates are private remix sources. Use
+  `list-curated-workspace-templates` to inspect the reviewed catalog and
+  `remix-workspace-template` to create an independent app. A remix may use
+  empty or synthetic data only; never copy source-app records, credentials,
+  secrets, or private configuration.
 - `/operations` is the focused operator console. Its Monitoring tab reuses the
   shared observability dashboard for traces, conversations, evaluations,
   experiments, and feedback; its Database tab reuses the Code-mode database

package/corpus/templates/dispatch/changelog/2026-07-17-apps-page-links-to-other-available-apps.md

@@ -0,0 +1,6 @@
+---
+type: improved
+date: 2026-07-17
+---
+
+Dispatch now links to other available apps from the Apps page.

package/corpus/templates/dispatch/changelog/2026-07-17-curated-template-remixes.md

@@ -0,0 +1,6 @@
+---
+type: added
+date: 2026-07-17
+---
+
+Dispatch now offers curated workspace templates that can be remixed into private apps.

package/corpus/templates/mail/app/entry.client.tsx

@@ -1,7 +1,12 @@
-import { appBasePath } from "@agent-native/core/client/api-path";
+import {
+  appBasePath,
+  installRouteChunkRecovery,
+} from "@agent-native/core/client";
 import { hydrateRoot } from "react-dom/client";
 import { HydratedRouter } from "react-router/dom";
 
+installRouteChunkRecovery();
+
 const basePath = appBasePath();
 const pathname = window.location.pathname;
 const routerBasePath =

package/corpus/templates/slides/.agents/skills/slide-images/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: slide-images
-description: Image generation workflow -- generate-image, image-search, logo-lookup scripts. Style reference patterns.
+description: Image generation workflow -- generate-image, search-images, and search-logos actions. Style reference patterns.
 ---
 
 # Slide Images
@@ -12,8 +12,8 @@ Images for slides are generated or sourced via three scripts. The agent delegate
 | Script | Purpose | Example |
 |--------|---------|---------|
 | `generate-image` | Generate images (Gemini/OpenAI/auto) | `pnpm action generate-image --prompt "hero image" --model auto --count 3` |
-| `image-search` | Search Google Images via Custom Search API | `pnpm action image-search --query "Acme logo transparent" --count 5` |
-| `logo-lookup` | Get company logo URL via Logo.dev API | `pnpm action logo-lookup --domain acme.com` |
+| `search-images` | Search Google Images via the configured provider | `pnpm action search-images --q "Acme logo transparent" --count 5` |
+| `search-logos` | Resolve company domains and canonical logo URLs | `pnpm action search-logos --q "Acme"` |
 | `image-gen-status` | Check configured image providers | `pnpm action image-gen-status` |
 
 ## Image Generation Flow
@@ -46,19 +46,23 @@ Default style reference images from `shared/api.ts` are always included.
 
 Two options for company logos:
 
-**Option 1: Logo.dev API** (best quality, requires `LOGO_DEV_TOKEN`):
+**Option 1: canonical logo search** (uses Logo.dev search when configured and a bounded domain fallback otherwise):
 ```bash
-pnpm action logo-lookup --domain acme.com
+pnpm action search-logos --q "Acme"
 ```
 
+Use a returned `logoUrl` directly. Do not call a second logo-provider action for
+each result.
+
 **Option 2: Google Image Search** (fallback):
 ```bash
-pnpm action image-search --query "Acme logo transparent" --count 5
+pnpm action search-images --q "Acme logo transparent" --count 5
 ```
 
 ## Important Rules
 
 - Always include style references for visual consistency
 - Use `.fmd-img-placeholder` divs in slides before real images are generated
-- Never use web_search or manual URL guessing for images
+- Use one canonical provider action per conceptual search; do not loop legacy
+  provider scripts or manually guess provider URLs
 - After inserting an image, update the deck via the API

package/corpus/templates/slides/.env.example

@@ -7,7 +7,6 @@
 # GEMINI_API_KEY=
 
 # Brandfetch — used for brand logo and color lookups
-# BRANDFETCH_API_KEY=
 # BRANDFETCH_CLIENT_ID=
 
 # Logo.dev — alternative logo provider

package/corpus/templates/slides/AGENTS.md

@@ -40,6 +40,10 @@ Detailed deck, slide-editing, image, design-system, and export workflows live in
 - Use image-generation and image-selection actions only when the deck genuinely
   needs imagery; keep citations/asset provenance when available.
 - Use framework sharing actions for deck visibility and grants.
+- For a known, read-only sibling-app operation, use `call-agent` with `action`
+  and `input` (or `invokeAgentAction`) instead of starting the sibling agent's
+  model loop. In Analytics, use `gong-native-insights` for provider-synthesized
+  briefs and `gong-calls` for quotes, counts, transcripts, and coverage claims.
 - Before generation, follow the creative-context reuse ladder in
   `.agents/skills/creative-context/SKILL.md`: explicit request and current deck
   first, then a pinned/current pack, then narrow library search. Respect

package/corpus/templates/slides/DEVELOPING.md

@@ -59,8 +59,8 @@ actions/                       # Shared app operations (defineAction; UI uses ac
 ├── run.ts                     # Script dispatcher
 ├── generate-image.ts          # Image generation with style references
 ├── image-gen-status.ts        # Check API key status
-├── image-search.ts            # Google Image search
-└── logo-lookup.ts             # Clearbit logo URL lookup
+├── search-images.ts           # Canonical Google image search
+└── search-logos.ts            # Canonical company/logo search
 ```
 
 ## Framework Basics (Nitro + @agent-native/core)

package/corpus/templates/slides/actions/index-design-system-with-builder.ts

@@ -35,7 +35,7 @@ const codeFileSchema = z.object({
 export default defineAction({
   description:
     "Start Builder DSI design-system indexing from connected code, a GitHub repository, code/design files, and optional design.md guidance. " +
-    "Use this instead of local import-code/import-github when the user wants a reusable brand kit or slide design system. " +
+    "Use this instead of legacy local code import when the user wants a reusable brand kit or slide design system. " +
     "Requires Builder.io to be connected; Builder owns the indexed design-system docs, generated guidance, token/component extraction, and job state.",
   schema: z.object({
     projectName: z

package/corpus/templates/slides/actions/logo-config.ts

@@ -1,14 +1,13 @@
 import { defineAction } from "@agent-native/core";
 import { z } from "zod";
 
+import { getLogoProviderConfig } from "../server/lib/media-search-providers.js";
+
 export default defineAction({
-  description: "Get logo search configuration (Brandfetch client ID status).",
+  description: "Get runtime-backed logo provider configuration for the UI.",
   schema: z.object({}),
   http: { method: "GET" },
-  run: async () => {
-    return {
-      brandfetchId: process.env.BRANDFETCH_CLIENT_ID || null,
-      hasLogoDevSecret: !!process.env.LOGO_DEV_SECRET_KEY?.startsWith("sk_"),
-    };
-  },
+  readOnly: true,
+  agentTool: false,
+  run: async () => getLogoProviderConfig(),
 });

package/corpus/templates/slides/actions/search-images.ts

@@ -1,55 +1,27 @@
 import { defineAction } from "@agent-native/core";
-import { resolveSecret } from "@agent-native/core/server";
 import { z } from "zod";
 
+import { searchProviderImages } from "../server/lib/media-search-providers.js";
+
 export default defineAction({
   description: "Search for images using Google Custom Search API.",
   schema: z.object({
     q: z.string().optional().describe("Search query (required)"),
+    count: z.coerce
+      .number()
+      .int()
+      .min(1)
+      .max(10)
+      .default(10)
+      .describe("Maximum number of image results to return."),
   }),
   http: { method: "GET" },
+  readOnly: true,
   run: async (args) => {
     const q = args.q;
     if (!q) {
       throw new Error("Missing query parameter 'q'");
     }
-
-    const [apiKey, cx] = await Promise.all([
-      resolveSecret("GOOGLE_API_KEY"),
-      resolveSecret("GOOGLE_SEARCH_CX"),
-    ]);
-
-    if (!apiKey || !cx) {
-      throw new Error(
-        "Google Search not configured. Save GOOGLE_API_KEY and GOOGLE_SEARCH_CX in settings.",
-      );
-    }
-
-    const params = new URLSearchParams({
-      key: apiKey,
-      cx,
-      q,
-      searchType: "image",
-      num: "10",
-      safe: "active",
-    });
-
-    const response = await fetch(
-      `https://www.googleapis.com/customsearch/v1?${params}`,
-    );
-    if (!response.ok) {
-      const text = await response.text();
-      console.error("Google API error:", response.status, text);
-      throw new Error("Google API error");
-    }
-
-    const data = await response.json();
-    return (data.items || []).map((item: any) => ({
-      url: item.link,
-      thumbnail: item.image?.thumbnailLink || item.link,
-      title: item.title,
-      width: item.image?.width,
-      height: item.image?.height,
-    }));
+    return searchProviderImages(q, args.count);
   },
 });

package/corpus/templates/slides/actions/search-logos.ts

@@ -1,67 +1,20 @@
 import { defineAction } from "@agent-native/core";
 import { z } from "zod";
 
+import { searchProviderLogos } from "../server/lib/media-search-providers.js";
+
 export default defineAction({
   description: "Search for company logos by name or domain.",
   schema: z.object({
     q: z.string().optional().describe("Company name or domain to search"),
   }),
   http: { method: "GET" },
+  readOnly: true,
   run: async (args) => {
-    const q = (args.q || "").trim().toLowerCase();
+    const q = (args.q || "").trim();
     if (!q) {
       throw new Error("Missing ?q= parameter");
     }
-
-    const secretKey = process.env.LOGO_DEV_SECRET_KEY;
-
-    // If we have a secret key that's actually an sk_ key, use the search API
-    if (secretKey && secretKey.startsWith("sk_")) {
-      try {
-        const response = await fetch(
-          `https://api.logo.dev/search?q=${encodeURIComponent(q)}`,
-          { headers: { Authorization: `Bearer ${secretKey}` } },
-        );
-
-        if (response.ok) {
-          const results: Array<{ name: string; domain: string }> =
-            await response.json();
-          return results.map((r) => ({ name: r.name, domain: r.domain }));
-        }
-      } catch {
-        // Fall through to domain guessing
-      }
-    }
-
-    // Domain guessing: generate candidate domains from the query
-    const candidates: Array<{ name: string; domain: string }> = [];
-
-    if (q.includes(".")) {
-      const clean = q
-        .replace(/^https?:\/\//, "")
-        .replace(/^www\./, "")
-        .split("/")[0];
-      candidates.push({ name: clean.split(".")[0], domain: clean });
-    } else {
-      const slug = q.replace(/[^a-z0-9]/g, "");
-      const slugDashed = q.replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "");
-
-      const tlds = [".com", ".io", ".co", ".dev", ".org", ".net"];
-      const seen = new Set<string>();
-
-      for (const tld of tlds) {
-        const domain = slug + tld;
-        if (!seen.has(domain)) {
-          seen.add(domain);
-          candidates.push({ name: q, domain });
-        }
-      }
-
-      if (slugDashed !== slug) {
-        candidates.push({ name: q, domain: slugDashed + ".com" });
-      }
-    }
-
-    return candidates;
+    return searchProviderLogos(q);
   },
 });

package/corpus/templates/slides/app/components/editor/ImageSearchPanel.tsx

@@ -61,7 +61,7 @@ export default function ImageSearchPanel({
     setLoading(true);
     setError(null);
     try {
-      const data = await callAction<SearchResult[]>(
+      const data = await callAction(
         "search-images",
         { q: query.trim() },
         { method: "GET" },

package/corpus/templates/slides/app/components/editor/LogoSearchPanel.tsx

@@ -1,17 +1,12 @@
-import {
-  agentNativePath,
-  useActionQuery,
-  useT,
-} from "@agent-native/core/client";
+import { callAction, useActionQuery, useT } from "@agent-native/core/client";
 import { IconX, IconSearch, IconLoader2 } from "@tabler/icons-react";
 import { useState, useEffect, useRef } from "react";
 import { createPortal } from "react-dom";
 
-const LOGO_DEV_PK = "pk_VwOyCAOgT0aBNpecT2qO-A";
-
 interface LogoResult {
   name: string;
   domain: string;
+  logoUrl?: string;
 }
 
 interface LogoSearchPanelProps {
@@ -32,6 +27,7 @@ export default function LogoSearchPanel({
   const [error, setError] = useState<string | null>(null);
   const [selectedDomain, setSelectedDomain] = useState<string | null>(null);
   const [brandfetchId, setBrandfetchId] = useState<string | null>(null);
+  const [logoDevToken, setLogoDevToken] = useState<string | null>(null);
   const panelRef = useRef<HTMLDivElement>(null);
   const inputRef = useRef<HTMLInputElement>(null);
 
@@ -41,6 +37,7 @@ export default function LogoSearchPanel({
     if (logoConfigData?.brandfetchId) {
       setBrandfetchId(logoConfigData.brandfetchId);
     }
+    setLogoDevToken(logoConfigData?.logoDevToken ?? null);
   }, [logoConfigData]);
 
   useEffect(() => {
@@ -84,17 +81,7 @@ export default function LogoSearchPanel({
     setResults([]);
     setSelectedDomain(null);
     try {
-      const res = await fetch(
-        agentNativePath(
-          `/_agent-native/actions/search-logos?q=${encodeURIComponent(q)}`,
-        ),
-      );
-      if (!res.ok) {
-        const data = await res.json();
-        setError(data.error || "Search failed");
-        return;
-      }
-      const data: LogoResult[] = await res.json();
+      const data = await callAction("search-logos", { q }, { method: "GET" });
       if (data.length === 0) {
         setError("No logos found");
       } else {
@@ -116,7 +103,7 @@ export default function LogoSearchPanel({
 
   // Build variations for the selected domain
   const variations = selectedDomain
-    ? buildVariations(selectedDomain, brandfetchId, t)
+    ? buildVariations(selectedDomain, brandfetchId, logoDevToken, t)
     : [];
 
   return createPortal(
@@ -323,14 +310,12 @@ interface VariationGroup {
 function buildVariations(
   domain: string,
   _brandfetchId: string | null,
+  logoDevToken: string | null,
   t: ReturnType<typeof useT>,
 ): VariationGroup[] {
   // Brandfetch CDN works without client ID for free tier
   const bf = (path: string) => `https://cdn.brandfetch.io/${domain}/${path}`;
-  const ld = (params: string) =>
-    `https://img.logo.dev/${domain}?token=${LOGO_DEV_PK}&${params}`;
-
-  return [
+  const groups: VariationGroup[] = [
     {
       label: "Logo",
       items: [
@@ -355,7 +340,11 @@ function buildVariations(
         { label: "Icon", url: bf("icon.png"), bg: "rgba(255,255,255,0.03)" },
       ],
     },
-    {
+  ];
+  if (logoDevToken) {
+    const ld = (params: string) =>
+      `https://img.logo.dev/${domain}?token=${encodeURIComponent(logoDevToken)}&${params}`;
+    groups.push({
       label: "Logo.dev",
       items: [
         {
@@ -374,6 +363,7 @@ function buildVariations(
           bg: "rgba(255,255,255,0.03)",
         },
       ],
-    },
-  ];
+    });
+  }
+  return groups;
 }

package/corpus/templates/slides/app/entry.client.tsx

@@ -1,7 +1,12 @@
-import { appBasePath } from "@agent-native/core/client/api-path";
+import {
+  appBasePath,
+  installRouteChunkRecovery,
+} from "@agent-native/core/client";
 import { hydrateRoot } from "react-dom/client";
 import { HydratedRouter } from "react-router/dom";
 
+installRouteChunkRecovery();
+
 const basePath = appBasePath();
 const pathname = window.location.pathname;
 const routerBasePath =