@agent-native/core 0.108.0 → 0.109.0

package/corpus/templates/clips/app/i18n/zh-TW.ts

@@ -598,6 +598,15 @@ const messages = {
     languageDescription:
       "選取此帳號的介面語言。Clips 會在不同設備上記住你的選取。",
     languageLabel: "介面語言",
+    uploadWorkspaceTitle: "目前工作區",
+    uploadWorkspaceDescription:
+      "選擇 Clips 用於新錄製內容（包括桌面上傳）的工作區。",
+    uploadWorkspaceLabel: "目前工作區",
+    uploadWorkspacePlaceholder: "選擇工作區",
+    uploadWorkspaceHint: "切換後，Clips 中與工作區相關的檢視也會更新。",
+    uploadWorkspaceSaving: "正在儲存工作區…",
+    uploadWorkspaceSaved: "目前工作區已更新",
+    uploadWorkspaceSaveFailed: "無法更新目前工作區",
     whatsNew: "最新變化",
     changelogEmpty: "暫無更新。",
     viewAllUpdates: "檢視所有更新",
@@ -1302,7 +1311,8 @@ const messages = {
     savedLocally: "已儲存到本機",
     uploadFailed: "上傳失敗",
     connectStorageToFinish: "開啟以連線儲存並完成儲存。",
-    retryFromClipsMenu: "從 Clips 選單重試；不需要重新錄製。",
+    retryFromClipsMenu:
+      "從選單列開啟 Clips 以重試這個已儲存的上傳；不需要重新錄製。",
     removeFailedClip: "移除此失敗剪輯。",
     remove: "移除",
     viewsCount: "{{count}} 次觀看",

package/corpus/templates/clips/app/routes/_app.settings._index.tsx

@@ -12,7 +12,7 @@ import {
   useT,
   type SettingsSearchEntry,
 } from "@agent-native/core/client";
-import { TeamPage } from "@agent-native/core/client/org";
+import { TeamPage, useOrg, useSwitchOrg } from "@agent-native/core/client/org";
 import {
   BUILDER_CREDITS_UPGRADE_URL,
   type BuilderCreditsStatus,
@@ -30,6 +30,7 @@ import {
   IconServer,
   IconTrash,
   IconUser,
+  IconUsersGroup,
 } from "@tabler/icons-react";
 import { useCallback, useEffect, useMemo, useState } from "react";
 import { toast } from "sonner";
@@ -394,6 +395,8 @@ export default function SettingsIndexRoute() {
   const { session } = useSession();
   const t = useT();
   const agentSettingsTabs = useAgentSettingsTabs();
+  const { data: org } = useOrg();
+  const switchOrg = useSwitchOrg();
   const email = session?.email ?? "";
   const storageStatus = useVideoStorageStatus();
   const builderStatus = useBuilderStatus();
@@ -505,6 +508,22 @@ export default function SettingsIndexRoute() {
     void refreshApiKeyStatus();
   }, [refreshApiKeyStatus]);
 
+  const orgs = org?.orgs ?? [];
+
+  async function handleUploadWorkspaceChange(organizationId: string) {
+    if (!organizationId || organizationId === org?.orgId) return;
+    try {
+      await switchOrg.mutateAsync(organizationId);
+      toast.success(t("settings.uploadWorkspaceSaved"));
+    } catch (err) {
+      toast.error(
+        err instanceof Error
+          ? err.message
+          : t("settings.uploadWorkspaceSaveFailed"),
+      );
+    }
+  }
+
   async function handleSave() {
     setSaving(true);
     try {
@@ -761,6 +780,13 @@ export default function SettingsIndexRoute() {
         keywords: "storage s3 builder bucket cloud video",
         hash: "video-storage",
       },
+      {
+        id: "clips-upload-workspace",
+        label: t("settings.uploadWorkspaceTitle"),
+        keywords:
+          "upload recordings desktop destination organization workspace",
+        hash: "upload-workspace",
+      },
       {
         id: "clips-slack",
         label: t("settings.slackTitle"),
@@ -835,6 +861,51 @@ export default function SettingsIndexRoute() {
                 </CardContent>
               </Card>
 
+              {orgs.length > 0 ? (
+                <Card id="upload-workspace" className="scroll-mt-16">
+                  <CardHeader>
+                    <CardTitle className="flex items-center gap-2 text-base">
+                      <IconUsersGroup className="size-4 text-primary" />
+                      {t("settings.uploadWorkspaceTitle")}
+                    </CardTitle>
+                    <CardDescription>
+                      {t("settings.uploadWorkspaceDescription")}
+                    </CardDescription>
+                  </CardHeader>
+                  <CardContent className="max-w-md space-y-1.5">
+                    <Label htmlFor="upload-workspace-select">
+                      {t("settings.uploadWorkspaceLabel")}
+                    </Label>
+                    <Select
+                      value={org?.orgId ?? undefined}
+                      onValueChange={handleUploadWorkspaceChange}
+                      disabled={switchOrg.isPending || orgs.length < 2}
+                    >
+                      <SelectTrigger id="upload-workspace-select">
+                        <SelectValue
+                          placeholder={t("settings.uploadWorkspacePlaceholder")}
+                        />
+                      </SelectTrigger>
+                      <SelectContent>
+                        {orgs.map((workspace) => (
+                          <SelectItem
+                            key={workspace.orgId}
+                            value={workspace.orgId}
+                          >
+                            {workspace.orgName}
+                          </SelectItem>
+                        ))}
+                      </SelectContent>
+                    </Select>
+                    <p className="text-xs text-muted-foreground">
+                      {switchOrg.isPending
+                        ? t("settings.uploadWorkspaceSaving")
+                        : t("settings.uploadWorkspaceHint")}
+                    </p>
+                  </CardContent>
+                </Card>
+              ) : null}
+
               <Card id="video-storage" className="scroll-mt-16">
                 <CardHeader>
                   <CardTitle className="text-base flex items-center gap-2">

package/corpus/templates/clips/changelog/2026-07-17-choose-which-workspace-receives-new-clips-recordings-and-des.md

@@ -0,0 +1,6 @@
+---
+type: added
+date: 2026-07-17
+---
+
+Choose which workspace receives new Clips recordings and desktop uploads

package/corpus/templates/clips/changelog/2026-07-17-create-folders-directly-from-the-move-menu.md

@@ -0,0 +1,6 @@
+---
+type: added
+date: 2026-07-17
+---
+
+Create folders directly from the move menu

package/corpus/templates/clips/changelog/2026-07-17-failed-desktop-uploads-now-offer-a-direct-way-to-reopen-clip.md

@@ -0,0 +1,6 @@
+---
+type: improved
+date: 2026-07-17
+---
+
+Failed desktop uploads now offer a direct way to reopen Clips and retry without re-recording.

package/corpus/templates/clips/desktop/src/app.tsx

@@ -4569,7 +4569,7 @@ function Setup({
       <div className="setup-section">
         <SettingLabel
           label="Clip Drafts"
-          hint="Clips dismissed after an upload problem stay in Movies/Clips/Drafts until you remove them in Finder."
+          hint="Only clips you dismiss from the saved-upload card appear in Movies/Clips/Drafts. To retry a failed upload, return to the Clips popover and use Retry."
         />
         <button
           type="button"

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 =