@agent-native/core 0.90.10 → 0.91.0

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/actions/regenerate-chapters.ts

@@ -23,6 +23,12 @@ export default defineAction({
     "Ask the agent to generate chapters for this recording based on its transcript (and the full video when Include full video is enabled). The agent identifies topic transitions and calls set-chapters.",
   schema: z.object({
     recordingId: z.string().describe("Recording ID"),
+    openInChat: z
+      .boolean()
+      .optional()
+      .describe(
+        "When true, focus the queued generation request in the agent chat instead of keeping it hidden.",
+      ),
   }),
   run: async (args) => {
     await assertAccess("recording", args.recordingId, "editor");
@@ -57,6 +63,7 @@ export default defineAction({
       segmentsJson: transcript?.segmentsJson ?? "[]",
       transcriptText: transcript?.fullText ?? "",
       includeFullVideoInAi,
+      openInChat: args.openInChat === true,
       message: withFullVideoAiInstructions(
         baseMessage,
         args.recordingId,

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>
+  );
+}