@agent-native/core 0.90.11 → 0.91.1

package/corpus/templates/brain/app/routes/settings.tsx

@@ -6,6 +6,7 @@ import {
   useActionMutation,
   useActionQuery,
   useT,
+  type SettingsSearchEntry,
 } from "@agent-native/core/client";
 import { TeamPage } from "@agent-native/core/client/org";
 import {
@@ -120,6 +121,42 @@ export default function SettingsRoute() {
     setSettings((current) => ({ ...current, [key]: value }));
   }
 
+  const generalSearchEntries = useMemo<SettingsSearchEntry[]>(
+    () => [
+      {
+        id: "brain-identity",
+        label: t("settings.identityTitle"),
+        keywords: "identity company name assistant name",
+        hash: "identity",
+      },
+      {
+        id: "brain-behavior",
+        label: t("settings.assistantBehaviorTitle"),
+        keywords: "assistant behavior tone source policy instructions",
+        hash: "assistant-behavior",
+      },
+      {
+        id: "brain-publishing",
+        label: t("settings.publishingReviewTitle"),
+        keywords: "publishing review publish tier approval connector poll",
+        hash: "publishing-review",
+      },
+      {
+        id: "brain-safety",
+        label: t("settings.safetyEvidenceTitle"),
+        keywords: "safety evidence sanitize redact citations sources",
+        hash: "safety-evidence",
+      },
+      {
+        id: "brain-language",
+        label: t("settings.languageTitle"),
+        keywords: "language locale translation i18n",
+        hash: "language",
+      },
+    ],
+    [t],
+  );
+
   return (
     <div className="min-h-full bg-background">
       <PageHeader
@@ -146,10 +183,11 @@ export default function SettingsRoute() {
       <SettingsTabsPage
         teamLabel={t("team.title")}
         extraTabs={agentSettingsTabs}
+        generalSearchEntries={generalSearchEntries}
         general={
           <div className="brain-settings-general-grid grid gap-5">
             <main className="grid gap-5">
-              <Card>
+              <Card id="identity" className="scroll-mt-4">
                 <CardHeader>
                   <CardTitle className="flex items-center gap-2 text-base">
                     <IconUsersGroup className="size-4 text-primary" />
@@ -177,7 +215,7 @@ export default function SettingsRoute() {
                 </CardContent>
               </Card>
 
-              <Card>
+              <Card id="assistant-behavior" className="scroll-mt-4">
                 <CardHeader>
                   <CardTitle className="flex items-center gap-2 text-base">
                     <IconMessageCircle className="size-4 text-primary" />
@@ -235,7 +273,7 @@ export default function SettingsRoute() {
                 </CardContent>
               </Card>
 
-              <Card>
+              <Card id="publishing-review" className="scroll-mt-4">
                 <CardHeader>
                   <CardTitle className="flex items-center gap-2 text-base">
                     <IconAdjustments className="size-4 text-primary" />
@@ -321,7 +359,7 @@ export default function SettingsRoute() {
                 </CardContent>
               </Card>
 
-              <Card>
+              <Card id="safety-evidence" className="scroll-mt-4">
                 <CardHeader>
                   <CardTitle className="flex items-center gap-2 text-base">
                     <IconShieldCheck className="size-4 text-primary" />
@@ -406,7 +444,7 @@ export default function SettingsRoute() {
             </main>
 
             <aside className="grid content-start gap-5">
-              <Card>
+              <Card id="language" className="scroll-mt-4">
                 <CardHeader>
                   <CardTitle className="flex items-center gap-2 text-base">
                     <IconAdjustments className="size-4 text-primary" />

package/corpus/templates/brain/changelog/2026-07-08-settings-are-cleaner-and-searchable.md

@@ -0,0 +1,5 @@
+---
+type: improved
+---
+
+Settings are cleaner and searchable, with a consistent navigation that jumps straight to any setting.

package/corpus/templates/calendar/app/pages/Settings.tsx

@@ -6,6 +6,7 @@ import {
   SettingsTabsPage,
   useAgentSettingsTabs,
   type AppearancePresetId,
+  type SettingsSearchEntry,
   useT,
 } from "@agent-native/core/client";
 import { TeamPage } from "@agent-native/core/client/org";
@@ -17,7 +18,7 @@ import {
   IconCircleCheck,
   IconCircleX,
 } from "@tabler/icons-react";
-import { useState, useEffect } from "react";
+import { useState, useEffect, useMemo } from "react";
 import { Link } from "react-router";
 import { toast } from "sonner";
 
@@ -157,18 +158,55 @@ export default function Settings() {
     });
   }
 
+  const generalSearchEntries = useMemo<SettingsSearchEntry[]>(
+    () => [
+      {
+        id: "calendar-language",
+        label: t("settings.languageTitle"),
+        keywords: "language locale translation i18n",
+        hash: "language",
+      },
+      {
+        id: "calendar-google",
+        label: t("settings.googleCalendar"),
+        keywords: "google calendar connect oauth sync account",
+        hash: "google-calendar",
+      },
+      {
+        id: "calendar-zoom",
+        label: "Zoom",
+        keywords: "zoom meeting video conferencing connect",
+        hash: "zoom",
+      },
+      {
+        id: "calendar-general",
+        label: t("settings.general"),
+        keywords: "timezone booking duration defaults general",
+        hash: "general-settings",
+      },
+      {
+        id: "calendar-appearance",
+        label: t("settings.appearance"),
+        keywords: "appearance theme color mode dark light",
+        hash: "appearance",
+      },
+    ],
+    [t],
+  );
+
   return (
     <SettingsTabsPage
       generalLabel={t("settings.general")}
       teamLabel={t("navigation.team")}
       extraTabs={agentSettingsTabs}
+      generalSearchEntries={generalSearchEntries}
       general={
         <div className="mx-auto max-w-2xl space-y-6 pb-12">
           <p className="text-sm text-muted-foreground">
             {t("settings.description")}
           </p>
 
-          <Card>
+          <Card id="language" className="scroll-mt-16">
             <CardHeader>
               <CardTitle className="text-lg">
                 {t("settings.languageTitle")}
@@ -184,7 +222,7 @@ export default function Settings() {
           </Card>
 
           {/* Google Calendar Connection */}
-          <Card>
+          <Card id="google-calendar" className="scroll-mt-16">
             <CardHeader>
               <CardTitle className="text-lg">
                 {t("settings.googleCalendar")}
@@ -250,7 +288,7 @@ export default function Settings() {
             </CardContent>
           </Card>
 
-          <Card>
+          <Card id="zoom" className="scroll-mt-16">
             <CardHeader>
               <CardTitle className="text-lg">Zoom</CardTitle>
               <CardDescription>{t("settings.zoomDescription")}</CardDescription>
@@ -340,7 +378,7 @@ export default function Settings() {
           <Separator />
 
           {/* General Settings */}
-          <Card>
+          <Card id="general-settings" className="scroll-mt-16">
             <CardHeader>
               <CardTitle className="text-lg">{t("settings.general")}</CardTitle>
               <CardDescription>
@@ -421,7 +459,7 @@ export default function Settings() {
           </Card>
 
           {/* Appearance */}
-          <Card>
+          <Card id="appearance" className="scroll-mt-16">
             <CardHeader>
               <CardTitle className="text-lg">
                 {t("settings.appearance")}

package/corpus/templates/calendar/changelog/2026-07-08-settings-are-cleaner-and-searchable.md

@@ -0,0 +1,5 @@
+---
+type: improved
+---
+
+Settings are cleaner and searchable, with a consistent navigation that jumps straight to any setting.

package/corpus/templates/chat/app/routes/settings.tsx

@@ -4,9 +4,11 @@ import {
   SettingsTabsPage,
   useAgentSettingsTabs,
   useT,
+  type SettingsSearchEntry,
 } from "@agent-native/core/client";
 import { TeamPage } from "@agent-native/core/client/org";
 import { useSetPageTitle } from "@agent-native/toolkit/app-shell";
+import { useMemo } from "react";
 
 import {
   Card,
@@ -29,17 +31,30 @@ export default function SettingsRoute() {
   const agentSettingsTabs = useAgentSettingsTabs();
   useSetPageTitle(t("settings.title"));
 
+  const generalSearchEntries = useMemo<SettingsSearchEntry[]>(
+    () => [
+      {
+        id: "chat-language",
+        label: t("settings.languageTitle"),
+        keywords: "language locale translation i18n",
+        hash: "language",
+      },
+    ],
+    [t],
+  );
+
   return (
     <SettingsTabsPage
       teamLabel={t("navigation.team")}
       extraTabs={agentSettingsTabs}
+      generalSearchEntries={generalSearchEntries}
       general={
         <div className="mx-auto w-full max-w-3xl space-y-6">
           <p className="text-sm leading-6 text-muted-foreground">
             {t("settings.description")}
           </p>
 
-          <Card>
+          <Card id="language" className="scroll-mt-16">
             <CardHeader>
               <CardTitle className="text-base">
                 {t("settings.languageTitle")}

package/corpus/templates/chat/changelog/2026-07-08-settings-are-cleaner-and-searchable.md

@@ -0,0 +1,5 @@
+---
+type: improved
+---
+
+Settings are cleaner and searchable, with a consistent navigation that jumps straight to any setting.

package/corpus/templates/clips/actions/lib/audio-only-transcription.ts

@@ -5,7 +5,10 @@ import { createRequire } from "node:module";
 import { tmpdir } from "node:os";
 import { join } from "node:path";
 
-const AUDIO_EXTRACTION_TIMEOUT_MS = 30_000;
+const AUDIO_EXTRACTION_MIN_TIMEOUT_MS = 30_000;
+const AUDIO_EXTRACTION_MAX_TIMEOUT_MS = 90_000;
+const AUDIO_EXTRACTION_BASE_TIMEOUT_MS = 25_000;
+const AUDIO_EXTRACTION_PER_50MB_MS = 10_000;
 const SILENCE_MAX_VOLUME_DB = -60;
 const STDERR_LIMIT = 16 * 1024;
 const requireFromThisFile = createRequire(import.meta.url);
@@ -115,6 +118,36 @@ export function audioExtensionForMimeType(
   }
 }
 
+function clampAudioExtractionTimeoutMs(value: number): number {
+  return Math.max(
+    AUDIO_EXTRACTION_MIN_TIMEOUT_MS,
+    Math.min(AUDIO_EXTRACTION_MAX_TIMEOUT_MS, Math.floor(value)),
+  );
+}
+
+export function audioExtractionTimeoutMs(
+  mediaByteLength: number | null | undefined,
+): number {
+  const override = Number(process.env.CLIPS_AUDIO_EXTRACTION_TIMEOUT_MS);
+  if (Number.isFinite(override) && override > 0) {
+    return clampAudioExtractionTimeoutMs(override);
+  }
+
+  if (
+    typeof mediaByteLength !== "number" ||
+    !Number.isFinite(mediaByteLength) ||
+    mediaByteLength <= 0
+  ) {
+    return AUDIO_EXTRACTION_MIN_TIMEOUT_MS;
+  }
+
+  const fiftyMbUnits = Math.ceil(mediaByteLength / (50 * 1024 * 1024));
+  return clampAudioExtractionTimeoutMs(
+    AUDIO_EXTRACTION_BASE_TIMEOUT_MS +
+      fiftyMbUnits * AUDIO_EXTRACTION_PER_50MB_MS,
+  );
+}
+
 function mediaExtensionForMimeType(mimeType: string): string {
   switch (baseMimeType(mimeType)) {
     case "video/mp4":
@@ -249,7 +282,7 @@ function mapFfmpegError(err: unknown): AudioOnlyExtractionError {
   );
 }
 
-async function runFfmpeg(args: string[]): Promise<void> {
+async function runFfmpeg(args: string[], timeoutMs: number): Promise<void> {
   await new Promise<void>((resolve, reject) => {
     const child = spawn(ffmpegCommand(), args, {
       stdio: ["ignore", "ignore", "pipe"],
@@ -258,7 +291,7 @@ async function runFfmpeg(args: string[]): Promise<void> {
     const timeout = setTimeout(() => {
       child.kill("SIGKILL");
       reject(new FfmpegRunError("ffmpeg timed out", stderr));
-    }, AUDIO_EXTRACTION_TIMEOUT_MS);
+    }, timeoutMs);
 
     child.stderr?.on("data", (chunk: Buffer) => {
       stderr = (stderr + chunk.toString("utf8")).slice(-STDERR_LIMIT);
@@ -278,7 +311,10 @@ async function runFfmpeg(args: string[]): Promise<void> {
   });
 }
 
-async function runFfmpegForStderr(args: string[]): Promise<string> {
+async function runFfmpegForStderr(
+  args: string[],
+  timeoutMs: number,
+): Promise<string> {
   return await new Promise<string>((resolve, reject) => {
     const child = spawn(ffmpegCommand(), args, {
       stdio: ["ignore", "ignore", "pipe"],
@@ -287,7 +323,7 @@ async function runFfmpegForStderr(args: string[]): Promise<string> {
     const timeout = setTimeout(() => {
       child.kill("SIGKILL");
       reject(new FfmpegRunError("ffmpeg timed out", stderr));
-    }, AUDIO_EXTRACTION_TIMEOUT_MS);
+    }, timeoutMs);
 
     child.stderr?.on("data", (chunk: Buffer) => {
       stderr = (stderr + chunk.toString("utf8")).slice(-STDERR_LIMIT);
@@ -331,21 +367,25 @@ export async function analyzeAudioSignal({
 
   const dir = await mkdtemp(join(tmpdir(), "clips-transcription-"));
   const inputPath = join(dir, `input.${audioExtensionForMimeType(mimeType)}`);
+  const timeoutMs = audioExtractionTimeoutMs(audioBytes.byteLength);
 
   try {
     await writeFile(inputPath, audioBytes);
-    const stderr = await runFfmpegForStderr([
-      "-hide_banner",
-      "-nostdin",
-      "-i",
-      inputPath,
-      "-vn",
-      "-af",
-      "volumedetect",
-      "-f",
-      "null",
-      "-",
-    ]).catch((err) => {
+    const stderr = await runFfmpegForStderr(
+      [
+        "-hide_banner",
+        "-nostdin",
+        "-i",
+        inputPath,
+        "-vn",
+        "-af",
+        "volumedetect",
+        "-f",
+        "null",
+        "-",
+      ],
+      timeoutMs,
+    ).catch((err) => {
       throw mapFfmpegError(err);
     });
 
@@ -361,6 +401,10 @@ export async function analyzeAudioSignal({
 export async function assertAudioHasAudibleSignal(
   media: AudioOnlyTranscriptionMedia,
 ): Promise<void> {
+  if (media.source === "raw-media-fallback") {
+    return;
+  }
+
   let signal: { meanVolumeDb: number | null; maxVolumeDb: number | null };
   try {
     signal = await analyzeAudioSignal(media);
@@ -402,17 +446,15 @@ export async function extractAudioOnlyWithFfmpeg({
   const output = outputForSourceMimeType(mimeType);
   const outputPath = join(dir, `audio.${output.extension}`);
   const baseArgs = ["-hide_banner", "-loglevel", "error", "-nostdin", "-y"];
+  const timeoutMs = audioExtractionTimeoutMs(mediaBytes.byteLength);
 
   try {
     await writeFile(inputPath, mediaBytes);
     try {
-      await runFfmpeg([
-        ...baseArgs,
-        "-i",
-        inputPath,
-        ...output.copyArgs,
-        outputPath,
-      ]);
+      await runFfmpeg(
+        [...baseArgs, "-i", inputPath, ...output.copyArgs, outputPath],
+        timeoutMs,
+      );
     } catch (copyErr) {
       if (
         copyErr instanceof FfmpegRunError &&
@@ -420,13 +462,10 @@ export async function extractAudioOnlyWithFfmpeg({
       ) {
         throw copyErr;
       }
-      await runFfmpeg([
-        ...baseArgs,
-        "-i",
-        inputPath,
-        ...output.transcodeArgs,
-        outputPath,
-      ]).catch((transcodeErr) => {
+      await runFfmpeg(
+        [...baseArgs, "-i", inputPath, ...output.transcodeArgs, outputPath],
+        timeoutMs,
+      ).catch((transcodeErr) => {
         throw mapFfmpegError(transcodeErr);
       });
     }
@@ -491,13 +530,16 @@ export async function prepareAudioOnlyTranscriptionMedia({
       recordingId,
     });
   } catch (err) {
-    // No ffmpeg to strip the audio track. Rather than fail outright, hand the
-    // original media to the transcription provider — Gemini/Builder accepts
-    // video containers directly. (Whisper-style providers may reject it, in
-    // which case the normal provider error path takes over.)
-    if (isFfmpegUnavailableError(err)) {
+    // If ffmpeg is unavailable or too slow for this clip, hand the original
+    // media to the transcription provider. Gemini/Builder accepts video
+    // containers directly; Whisper-style providers may reject them, in which
+    // case the normal provider error path takes over.
+    if (
+      isFfmpegUnavailableError(err) ||
+      (err instanceof AudioOnlyExtractionError && err.code === "TIMEOUT")
+    ) {
       console.warn(
-        "[clips] ffmpeg unavailable; sending original media to the transcription provider without audio extraction.",
+        "[clips] ffmpeg could not prepare audio-only media; sending original media to the transcription provider.",
       );
       return {
         audioBytes: mediaBytes,

package/corpus/templates/clips/app/components/player/player-controls.tsx

@@ -2,6 +2,7 @@ import { useT } from "@agent-native/core/client";
 import {
   IconPlayerPlay,
   IconPlayerPause,
+  IconPlayerSkipForward,
   IconVolume,
   IconVolumeOff,
   IconMaximize,
@@ -35,6 +36,7 @@ import { cn } from "@/lib/utils";
 import { Scrubber, msToClock } from "./scrubber";
 
 export const SPEED_OPTIONS = PLAYBACK_SPEED_OPTIONS;
+export const PLAYER_SEEK_STEP_MS = 15_000;
 
 export interface PlayerControlsProps {
   isPlaying: boolean;
@@ -54,6 +56,7 @@ export interface PlayerControlsProps {
   excludedRanges?: { startMs: number; endMs: number }[];
   onPlayPause: () => void;
   onSeek: (ms: number) => void;
+  onSeekRelative: (deltaMs: number) => void;
   onVolumeChange: (volume: number) => void;
   onToggleMute: () => void;
   onSpeedChange: (rate: number) => void;
@@ -84,6 +87,7 @@ export function PlayerControls(props: PlayerControlsProps) {
     excludedRanges,
     onPlayPause,
     onSeek,
+    onSeekRelative,
     onVolumeChange,
     onToggleMute,
     onSpeedChange,
@@ -116,9 +120,18 @@ export function PlayerControls(props: PlayerControlsProps) {
       />
 
       <div className="flex min-w-0 items-center gap-1.5 text-white">
+        <IconBtn
+          onClick={() => onSeekRelative(-PLAYER_SEEK_STEP_MS)}
+          tooltip="Back 15 seconds"
+          ariaLabel="Back 15 seconds"
+        >
+          <SkipIcon direction="back" />
+        </IconBtn>
+
         <IconBtn
           onClick={onPlayPause}
           tooltip={isPlaying ? "Pause (K)" : "Play (K)"}
+          ariaLabel={isPlaying ? "Pause" : "Play"}
         >
           {isPlaying ? (
             <IconPlayerPause className="h-5 w-5" />
@@ -127,6 +140,14 @@ export function PlayerControls(props: PlayerControlsProps) {
           )}
         </IconBtn>
 
+        <IconBtn
+          onClick={() => onSeekRelative(PLAYER_SEEK_STEP_MS)}
+          tooltip="Forward 15 seconds"
+          ariaLabel="Forward 15 seconds"
+        >
+          <SkipIcon direction="forward" />
+        </IconBtn>
+
         <div
           className="relative flex shrink-0 items-center"
           onMouseEnter={() => setVolumePopoverOpen(true)}
@@ -264,11 +285,13 @@ function IconBtn({
   children,
   onClick,
   tooltip,
+  ariaLabel,
   active,
 }: {
   children: React.ReactNode;
   onClick?: () => void;
   tooltip?: string;
+  ariaLabel?: string;
   active?: boolean;
 }) {
   return (
@@ -276,6 +299,7 @@ function IconBtn({
       <TooltipTrigger asChild>
         <button
           onClick={onClick}
+          aria-label={ariaLabel ?? tooltip}
           className={cn(
             "flex h-8 w-8 shrink-0 items-center justify-center rounded-md",
             active ? "bg-white/20 text-white" : "text-white hover:bg-white/10",
@@ -288,3 +312,14 @@ function IconBtn({
     </Tooltip>
   );
 }
+
+function SkipIcon({ direction }: { direction: "back" | "forward" }) {
+  return (
+    <span className="relative flex h-5 w-5 items-center justify-center">
+      <IconPlayerSkipForward
+        className={cn("h-5 w-5", direction === "back" && "rotate-180")}
+      />
+      <span className="absolute text-[7px] font-bold leading-none">15</span>
+    </span>
+  );
+}