@agent-native/core 0.79.7 → 0.79.9

package/corpus/core/src/server/agent-run-context.ts

@@ -0,0 +1,204 @@
+import { createError, getHeader, type H3Event } from "h3";
+
+import { resolveOrgIdForEmail, getOrgContext } from "../org/context.js";
+import { getSession } from "./auth.js";
+import {
+  runWithRequestContext,
+  type RequestContext,
+} from "./request-context.js";
+
+export type AgentRunOwnerContext = {
+  owner: string;
+  anonymous: boolean;
+  name?: string;
+};
+
+export const AGENT_RUN_OWNER_CONTEXT_KEY = "__agentNativeOwnerContext";
+
+type EventWithAgentRunContext = H3Event & {
+  context?: Record<string, unknown>;
+};
+
+type AnonymousOwnerResolver = (
+  event: H3Event,
+) => string | null | Promise<string | null>;
+
+type OrgIdResolver = (
+  event: H3Event,
+) => string | null | undefined | Promise<string | null | undefined>;
+
+function eventContext(
+  event: EventWithAgentRunContext,
+): Record<string, unknown> {
+  event.context = event.context ?? {};
+  return event.context;
+}
+
+function normalizeId(value: string | null | undefined): string | undefined {
+  return typeof value === "string" && value.trim().length > 0
+    ? value.trim()
+    : undefined;
+}
+
+function readHeaderValue(event: any, name: string): unknown {
+  try {
+    const value = getHeader(event, name);
+    if (value !== undefined && value !== null) return value;
+  } catch {
+    // Unit tests and a few framework internals pass lightweight event shims.
+  }
+
+  const headers = event?.headers;
+  if (headers && typeof headers.get === "function") {
+    return headers.get(name) ?? headers.get(name.toLowerCase()) ?? undefined;
+  }
+
+  const reqHeaders = event?.node?.req?.headers ?? event?.req?.headers;
+  if (reqHeaders && typeof reqHeaders === "object") {
+    return reqHeaders[name] ?? reqHeaders[name.toLowerCase()];
+  }
+
+  return undefined;
+}
+
+export function readAgentRunTimezone(event: H3Event): string | undefined {
+  const raw = readHeaderValue(event, "x-user-timezone");
+  const value = Array.isArray(raw) ? raw[0] : raw;
+  return typeof value === "string" &&
+    value.trim().length > 0 &&
+    value.trim().length < 64
+    ? value.trim()
+    : undefined;
+}
+
+export function seedAgentRunOwnerContext(
+  event: H3Event,
+  ownerContext: AgentRunOwnerContext,
+): AgentRunOwnerContext {
+  eventContext(event as EventWithAgentRunContext)[AGENT_RUN_OWNER_CONTEXT_KEY] =
+    ownerContext;
+  return ownerContext;
+}
+
+export async function seedBackgroundAgentRunOwnerContext(
+  event: H3Event,
+  runId: string,
+): Promise<AgentRunOwnerContext | null> {
+  try {
+    const { getRunOwnerEmail } = await import("../agent/run-store.js");
+    const owner = await getRunOwnerEmail(runId);
+    if (!owner) return null;
+    return seedAgentRunOwnerContext(event, { owner, anonymous: false });
+  } catch {
+    return null;
+  }
+}
+
+export async function resolveAgentRunOwnerContext(
+  event: H3Event,
+  options: { anonymousOwner?: AnonymousOwnerResolver } = {},
+): Promise<AgentRunOwnerContext> {
+  const ctx = eventContext(event as EventWithAgentRunContext);
+  const seeded = ctx[AGENT_RUN_OWNER_CONTEXT_KEY] as
+    | AgentRunOwnerContext
+    | undefined;
+  if (seeded) return seeded;
+
+  const session = await getSession(event);
+  if (session?.email) {
+    return seedAgentRunOwnerContext(event, {
+      owner: session.email,
+      anonymous: false,
+      name: session.name,
+    });
+  }
+
+  const anonymousOwner = await options.anonymousOwner?.(event);
+  if (anonymousOwner) {
+    return seedAgentRunOwnerContext(event, {
+      owner: anonymousOwner,
+      anonymous: true,
+    });
+  }
+
+  throw createError({
+    statusCode: 401,
+    statusMessage: "Unauthenticated",
+  });
+}
+
+export async function resolveAgentRunOrgId(options: {
+  event: H3Event;
+  ownerContext: AgentRunOwnerContext;
+  resolveOrgId?: OrgIdResolver;
+}): Promise<string | undefined> {
+  let resolvedOrgId: string | undefined;
+
+  if (options.resolveOrgId) {
+    resolvedOrgId = normalizeId(await options.resolveOrgId(options.event));
+  } else {
+    try {
+      const session = await getSession(options.event);
+      resolvedOrgId = normalizeId(session?.orgId);
+    } catch {
+      // Session not available.
+    }
+
+    if (!resolvedOrgId) {
+      try {
+        const orgContext = await getOrgContext(options.event);
+        resolvedOrgId = normalizeId(orgContext.orgId);
+      } catch {
+        // Org tables may not exist yet on first boot.
+      }
+    }
+  }
+
+  if (
+    !resolvedOrgId &&
+    options.ownerContext.owner &&
+    !options.ownerContext.anonymous
+  ) {
+    try {
+      resolvedOrgId = normalizeId(
+        await resolveOrgIdForEmail(options.ownerContext.owner),
+      );
+    } catch {
+      // Org tables may not exist yet on first boot.
+    }
+  }
+
+  return resolvedOrgId;
+}
+
+export async function resolveAgentRunRequestContext(options: {
+  event: H3Event;
+  ownerContext: AgentRunOwnerContext;
+  resolveOrgId?: OrgIdResolver;
+  isBackgroundWorker?: boolean;
+}): Promise<RequestContext> {
+  const orgId = await resolveAgentRunOrgId(options);
+  const timezone = readAgentRunTimezone(options.event);
+  return {
+    userEmail: options.ownerContext.owner,
+    userName: options.ownerContext.name,
+    orgId,
+    timezone,
+    ...(options.isBackgroundWorker
+      ? { run: { isBackgroundWorker: true } }
+      : {}),
+  };
+}
+
+export async function runWithAgentRunContext<T>(
+  options: {
+    event: H3Event;
+    ownerContext: AgentRunOwnerContext;
+    resolveOrgId?: OrgIdResolver;
+    isBackgroundWorker?: boolean;
+  },
+  fn: () => T | Promise<T>,
+): Promise<T> {
+  const requestContext = await resolveAgentRunRequestContext(options);
+  return await runWithRequestContext(requestContext, fn);
+}

package/corpus/core/src/server/credential-provider.ts

@@ -80,7 +80,7 @@ export function readDeployCredentialEnv(key: string): string | undefined {
  * key does not silently power another tenant's chat.
  */
 export function isDeployCredentialFallbackAllowed(): boolean {
-  if (process.env.NODE_ENV !== "production") return true;
+  if (!isProductionLikeRuntime()) return true;
   return isLocalDatabase();
 }
 
@@ -121,6 +121,22 @@ function isHostedWorkspaceRuntime(): boolean {
   );
 }
 
+function isProductionLikeRuntime(): boolean {
+  return (
+    process.env.NODE_ENV === "production" ||
+    /^(1|true)$/i.test(process.env.NETLIFY ?? "") ||
+    /^(1|true)$/i.test(process.env.VERCEL ?? "") ||
+    /^(1|true)$/i.test(process.env.CF_PAGES ?? "") ||
+    Boolean(
+      process.env.AWS_LAMBDA_FUNCTION_NAME ||
+      process.env.AWS_EXECUTION_ENV ||
+      process.env.FUNCTIONS_WORKER_RUNTIME ||
+      process.env.K_SERVICE ||
+      process.env.RENDER,
+    )
+  );
+}
+
 /**
  * Whether deployment-level Builder env keys may back the current request.
  *
@@ -143,18 +159,18 @@ function canUseBuilderDeployCredentialFallbackForRequest(): boolean {
   const email = getRequestUserEmail();
   if (!email) return true;
 
-  const isProduction = process.env.NODE_ENV === "production";
+  const isProductionRuntime = isProductionLikeRuntime();
   // Local dogfooding escape hatch: lets the env / root-`.env` Builder key back
   // a signed-in user so running the app locally doesn't require completing the
   // Builder connect flow first. Non-prod only.
   const localDevOptIn =
-    !isProduction &&
+    !isProductionRuntime &&
     /^(1|true)$/i.test(process.env.AGENT_NATIVE_LOCAL_BUILDER_ENV ?? "");
 
   if (isHostedWorkspaceRuntime() && !localDevOptIn) return false;
 
   // Deploy fallback is safe in non-prod or on a local/single-tenant database.
-  return !isProduction || isLocalDatabase();
+  return !isProductionRuntime || isLocalDatabase();
 }
 
 function shouldTraceCredentialResolve(): boolean {

package/corpus/templates/analytics/app/components/dashboard/SqlChart.tsx

@@ -593,8 +593,18 @@ function ChartTooltip({
     left: number;
     top: number;
   } | null>(null);
-  const items = sortTooltipPayloadItems(
-    payload?.filter((item) => item.value != null && item.value !== "") ?? [],
+  const items = useMemo(
+    () =>
+      sortTooltipPayloadItems(
+        payload?.filter((item) => item.value != null && item.value !== "") ??
+          [],
+      ),
+    [payload],
+  );
+  const portalVisible = portalPosition !== null;
+  const clearPortalPosition = useCallback(
+    () => setPortalPosition((prev) => (prev === null ? prev : null)),
+    [],
   );
 
   const labelText =
@@ -606,7 +616,7 @@ function ChartTooltip({
 
   useBrowserLayoutEffect(() => {
     if (!active || items.length === 0 || typeof window === "undefined") {
-      setPortalPosition(null);
+      clearPortalPosition();
       return;
     }
 
@@ -688,7 +698,7 @@ function ChartTooltip({
       window.removeEventListener("resize", schedule);
       window.removeEventListener("scroll", schedule, true);
     };
-  });
+  }, [active, clearPortalPosition, items.length, portalVisible]);
 
   if (!active || items.length === 0) return null;
 

package/corpus/templates/analytics/changelog/2026-06-26-session-replay-uploads-now-accept-compressed-payloads-so-lar.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-06-26
+---
+
+Session replay uploads now accept compressed payloads so larger recordings ingest more reliably.

package/corpus/templates/analytics/changelog/2026-06-26-sql-chart-tooltips-now-stay-stable-while-moving-across-dense.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-06-26
+---
+
+SQL chart tooltips now stay stable while moving across dense charts.

package/corpus/templates/analytics/server/handlers/session-replay.ts

@@ -1,9 +1,11 @@
-import { readBody } from "@agent-native/core/server";
+import { gunzipSync } from "node:zlib";
+
 import {
   defineEventHandler,
   getHeader,
   getQuery,
   getRouterParam,
+  readRawBody,
   setResponseHeader,
   setResponseStatus,
 } from "h3";
@@ -48,7 +50,7 @@ function setCors(event: any): void {
   setResponseHeader(
     event,
     "Access-Control-Allow-Headers",
-    "content-type, x-agent-native-analytics-key",
+    "content-type, content-encoding, x-agent-native-analytics-key",
   );
   setResponseHeader(event, "Access-Control-Max-Age", "86400");
 }
@@ -76,15 +78,60 @@ function injectHeaderKey(body: unknown, headerKey?: string): unknown {
   return { publicKey: headerKey };
 }
 
-function requestByteLength(body: unknown): number {
-  if (typeof body === "string") return Buffer.byteLength(body, "utf8");
+function statusError(message: string, statusCode: number): Error {
+  return Object.assign(new Error(message), { statusCode });
+}
+
+export function decodeSessionReplayRequestBody(
+  rawBody: Buffer | Uint8Array | string | undefined,
+  contentEncoding?: string | null,
+): { body: unknown; requestBytes: number } {
+  const requestBytes =
+    typeof rawBody === "string"
+      ? Buffer.byteLength(rawBody, "utf8")
+      : (rawBody?.byteLength ?? 0);
+  const bytes = Buffer.isBuffer(rawBody)
+    ? rawBody
+    : rawBody instanceof Uint8Array
+      ? Buffer.from(rawBody)
+      : Buffer.from(rawBody ?? "", "utf8");
+  const encoding = (contentEncoding ?? "").split(";")[0]?.trim().toLowerCase();
+  let decoded = bytes;
+
+  if (encoding === "gzip" || encoding === "x-gzip") {
+    try {
+      decoded = gunzipSync(bytes);
+    } catch {
+      throw statusError("Invalid gzip-compressed replay body", 400);
+    }
+  } else if (encoding && encoding !== "identity") {
+    throw statusError(
+      `Unsupported replay request content-encoding: ${encoding}`,
+      415,
+    );
+  }
+
+  const text = decoded.toString("utf8");
+  if (!text.trim()) {
+    return { body: undefined, requestBytes };
+  }
   try {
-    return Buffer.byteLength(JSON.stringify(body), "utf8");
+    return { body: JSON.parse(text), requestBytes };
   } catch {
-    return 0;
+    return { body: text, requestBytes };
   }
 }
 
+async function readSessionReplayRequestBody(
+  event: any,
+): Promise<{ body: unknown; requestBytes: number }> {
+  const rawBody = await readRawBody(event, false);
+  return decodeSessionReplayRequestBody(
+    rawBody,
+    getHeader(event, "content-encoding"),
+  );
+}
+
 function asString(value: unknown): string | undefined {
   if (typeof value === "string" && value.trim()) return value.trim();
   if (Array.isArray(value) && typeof value[0] === "string" && value[0].trim()) {
@@ -153,12 +200,13 @@ export const handleSessionReplayIngest = defineEventHandler(async (event) => {
     }
 
     const headerKey = getHeader(event, "x-agent-native-analytics-key");
-    const rawBody = await readBody(event);
+    const { body: rawBody, requestBytes } =
+      await readSessionReplayRequestBody(event);
     const body = injectHeaderKey(rawBody, headerKey);
     const parsed = parseSessionReplayIngestPayload(body);
     const result = await recordSessionReplayChunks(parsed, {
       origin: readOrigin(event),
-      requestBytes: requestByteLength(rawBody),
+      requestBytes,
     });
     setResponseStatus(event, 202);
     return { success: true, ...result };

package/corpus/templates/clips/app/components/player/transcript-panel.tsx

@@ -585,7 +585,7 @@ function TranscriptSetupCard({
                   <p className="text-xs font-semibold">
                     {builderConfigured
                       ? "Builder.io connected"
-                      : "Connect Builder.io"}
+                      : "Use Builder.io (free)"}
                   </p>
                   {!builderConfigured && (
                     <span className="rounded-sm bg-primary/10 px-1.5 py-0.5 text-[10px] font-semibold uppercase tracking-wide text-primary">

package/corpus/templates/clips/app/components/recorder/storage-setup-card.tsx

@@ -13,6 +13,13 @@ import {
 } from "@tabler/icons-react";
 import { useCallback, useEffect, useRef, useState } from "react";
 
+import {
+  Tooltip,
+  TooltipContent,
+  TooltipProvider,
+  TooltipTrigger,
+} from "@/components/ui/tooltip";
+
 function BuilderBMark({ className }: { className?: string }) {
   return (
     <svg
@@ -173,23 +180,44 @@ export function StorageSetupCard({
 
       {/* S3 — secondary option */}
       {!connected && (
-        <div className="flex items-center gap-3 border-t border-border pt-4">
-          <IconServer className="h-4 w-4 text-muted-foreground" />
-          <div className="flex-1">
-            <span className="text-sm text-muted-foreground">
-              Or{" "}
-              <a
-                href={appPath("/settings#video-storage")}
-                className="font-medium text-foreground underline underline-offset-2 hover:text-foreground/80"
-              >
-                {t("storageSetup.configureS3")}
-              </a>
-            </span>
-            <span className="mt-0.5 block text-[11px] text-muted-foreground">
-              AWS S3, Cloudflare R2, DigitalOcean Spaces, MinIO
-            </span>
+        <>
+          <div className="flex items-center gap-3 border-t border-border pt-4">
+            <IconServer className="h-4 w-4 text-muted-foreground" />
+            <div className="flex-1">
+              <span className="text-sm text-muted-foreground">
+                Or{" "}
+                <a
+                  href={appPath("/settings#video-storage")}
+                  className="font-medium text-foreground underline underline-offset-2 hover:text-foreground/80"
+                >
+                  {t("storageSetup.configureS3")}
+                </a>
+              </span>
+              <span className="mt-0.5 block text-[11px] text-muted-foreground">
+                AWS S3, Cloudflare R2, DigitalOcean Spaces, MinIO
+              </span>
+            </div>
           </div>
-        </div>
+          <TooltipProvider delayDuration={150}>
+            <Tooltip>
+              <TooltipTrigger asChild>
+                <button
+                  type="button"
+                  className="self-start text-xs text-muted-foreground underline decoration-muted-foreground/50 decoration-dotted underline-offset-4 transition-colors hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2"
+                >
+                  {t("storageSetup.whyPrompt")}
+                </button>
+              </TooltipTrigger>
+              <TooltipContent
+                side="bottom"
+                align="start"
+                className="max-w-80 whitespace-normal text-xs leading-relaxed"
+              >
+                {t("storageSetup.whyDescription")}
+              </TooltipContent>
+            </Tooltip>
+          </TooltipProvider>
+        </>
       )}
     </div>
   );

package/corpus/templates/clips/app/i18n/ar-SA.ts

@@ -344,7 +344,7 @@ const messages = {
     cleanupBuilderFailed:
       "تعذر إنهاء عملية التنظيف على الرغم من اتصال Builder.io. تم الاحتفاظ بالنص الأصلي.",
     cleanupPaused:
-      "تم إيقاف عملية التنظيف مؤقتًا. قم بتوصيل Builder.io في الإعدادات لتمكينه.",
+      "التنظيف متوقف مؤقتًا. صِل الذكاء الاصطناعي من الإعدادات: Builder.io (أرصدة مجانية) أو مفتاح LLM الخاص بك.",
     builderNoResponse:
       "لم أتلق ردًا من Builder. اسمح بالنوافذ المنبثقة وحاول مرة أخرى.",
     saveFailed: "فشل الحفظ ({{status}})",
@@ -584,7 +584,7 @@ const messages = {
       "Builder.io هو مسار التخزين الأساسي لعمليات رفع Clips. يتوفر S3 عندما تحتاج إلى استخدام حاويتك الخاصة.",
     checkingBuilder: "جار فحص Builder.io",
     builderConnected: "Builder.io متصل",
-    connectBuilder: "اتصال Builder.io",
+    connectBuilder: "استخدام Builder.io (مجاني)",
     builderConnectedFor: "يتم استخدام Builder.io لـ {{orgName}}.",
     builderConnectedGeneric: "تستخدم المقاطع الجديدة مزود Builder.io المتصل.",
     builderIncludes:
@@ -610,12 +610,12 @@ const messages = {
     s3PublicBaseUrlLabel: "عنوان URL الأساسي العام",
     apiSetup: "إعداد الذكاء الاصطناعي",
     apiSetupDescription:
-      "Builder.io هو المسار الافتراضي لاعتمادات الذكاء الاصطناعي المُدارة. مفاتيح المزود اختيارية ويمكن إضافتها هنا.",
-    builderEasySetup: "Builder.io هو أسهل إعداد",
+      "صِل الذكاء الاصطناعي باستخدام أرصدة Builder.io المجانية أو مفاتيح LLM الخاصة بك.",
+    builderEasySetup: "أرصدة Builder.io مجانية",
     builderAiAvailable:
       "تتوفر اعتمادات الذكاء الاصطناعي المضمنة والنسخ المُدار لـ Clips.",
     builderAiDescription:
-      "اتصل بـ Builder أولًا لاستخدام اعتمادات الذكاء الاصطناعي المضمنة وتخزين الكائنات والرفع والنسخ المُدار.",
+      "استخدم Builder.io أولًا لاعتمادات الذكاء الاصطناعي المضمنة وتخزين الكائنات والرفع والنسخ المُدار.",
     providerKeyTitle: "استخدام مفتاح مزود خاص بك",
     providerKeyDescription:
       "أضف مفاتيح Anthropic أو OpenAI أو Gemini أو Groq أو OpenRouter للاستخدام المفوتر من المزود.",
@@ -762,7 +762,7 @@ const messages = {
     pickAtLeastTwo: "اختر تسجيلين على الأقل لدمجهما",
     videoUrlMissing: "واحد أو أكثر من التسجيلات لا يحتوي بعد على رابط فيديو جاهز",
     connectStorage:
-      "قم بتوصيل Builder.io أو تخزين متوافق مع S3 قبل دمج التسجيلات.",
+      "صِل التخزين قبل دمج التسجيلات: Builder.io (تخزين + ذكاء اصطناعي في الخطة المجانية) أو تخزين متوافق مع S3.",
     created: "تم إنشاء التسجيل المدمج",
     failed: "فشل دمج التسجيلات",
     noOtherRecordings: "لا توجد تسجيلات أخرى متاحة.",
@@ -988,9 +988,12 @@ const messages = {
       "لم يصل رد من Builder خلال 5 دقائق. تحقق من النافذة المنبثقة وحاول مرة أخرى.",
     builderConnected: "Builder.io متصل",
     waitingForBuilder: "بانتظار Builder...",
-    connectBuilder: "اتصال بـ Builder.io",
+    connectBuilder: "استخدام Builder.io (مجاني)",
     free: "مجاني",
     configureS3: "تكوين تخزين متوافق مع S3",
+    whyPrompt: "لماذا أرى هذا؟",
+    whyDescription:
+      "Clips تطبيق مجاني ومفتوح المصدر 100%، لذلك تحتاج إلى توصيل طريقة لتخزين المقاطع. صِل التخزين عبر Builder.io لتخزين وذكاء اصطناعي ضمن الخطة المجانية، أو استخدم تخزين كائنات متوافقًا مع S3 ومفاتيح LLM الخاصة بك.",
   },
   captureInstall: {
     title: "Choose your recorder (مترجم)",
@@ -1193,9 +1196,9 @@ const messages = {
     downloadRecording: "Download recording (مترجم)",
     openRecorderInTab: "Open recorder in tab (مترجم)",
     connectStorageToFinish:
-      "Connect Builder.io or S3 storage on the next screen and Clips will finish saving it. (مترجم)",
+      "صِل التخزين في الشاشة التالية: Builder.io (تخزين + ذكاء اصطناعي في الخطة المجانية) أو تخزين متوافق مع S3. سيكمل Clips الحفظ.",
     connectStorageToRetryLoom:
-      "Connect Builder.io or S3 storage on the next screen and Clips will retry the import. (مترجم)",
+      "صِل التخزين في الشاشة التالية: Builder.io (تخزين + ذكاء اصطناعي في الخطة المجانية) أو تخزين متوافق مع S3. سيعيد Clips محاولة الاستيراد.",
   },
   dictateRoute: {
     pageTitle: "Dictate · Clips (مترجم)",

package/corpus/templates/clips/app/i18n/de-DE.ts

@@ -359,7 +359,7 @@ const messages = {
     cleanupBuilderFailed:
       "Die Bereinigung konnte nicht abgeschlossen werden, obwohl Builder.io verbunden ist. Das native Transkript wurde aufbewahrt.",
     cleanupPaused:
-      "Die Bereinigung ist pausiert. Verbinden Sie Builder.io in den Einstellungen, um es zu aktivieren.",
+      "Die Bereinigung ist pausiert. Verbinde KI in den Einstellungen: Builder.io (kostenlose Credits) oder deinen eigenen LLM-Schlüssel.",
     builderNoResponse:
       "Ich habe keine Antwort von Builder erhalten. Lassen Sie Popups zu und versuchen Sie es erneut.",
     saveFailed: "Speichern fehlgeschlagen ({{status}})",
@@ -607,7 +607,7 @@ Alle sichtbaren Änderungen für Clips-Nutzer werden hier dokumentiert. Du kanns
       "Builder.io ist der primäre Speicherpfad für Clips-Uploads. S3 ist verfügbar, wenn du deinen eigenen Bucket verwenden musst.",
     checkingBuilder: "Builder.io wird geprüft",
     builderConnected: "Builder.io verbunden",
-    connectBuilder: "Builder.io verbinden",
+    connectBuilder: "Builder.io nutzen (kostenlos)",
     builderConnectedFor: "Builder.io wird für {{orgName}} verwendet.",
     builderConnectedGeneric:
       "Neue Clips verwenden den verbundenen Builder.io-Anbieter.",
@@ -635,12 +635,12 @@ Alle sichtbaren Änderungen für Clips-Nutzer werden hier dokumentiert. Du kanns
     s3PublicBaseUrlLabel: "Öffentliche Basis-URL",
     apiSetup: "KI-Einrichtung",
     apiSetupDescription:
-      "Builder.io ist der Standardpfad für verwaltete KI-Guthaben. Anbieter-Schlüssel sind optional und können hier hinzugefügt werden.",
-    builderEasySetup: "Builder.io ist die einfachste Einrichtung",
+      "Verbinde KI mit kostenlosen Builder.io-Credits oder deinen eigenen LLM-Schlüsseln.",
+    builderEasySetup: "Kostenlose Builder.io-Credits",
     builderAiAvailable:
       "Enthaltene KI-Guthaben und verwaltete Transkription sind für Clips verfügbar.",
     builderAiDescription:
-      "Verbinde zuerst Builder, um enthaltene KI-Guthaben, Objektspeicher, Uploads und verwaltete Transkription zu nutzen.",
+      "Nutze Builder.io zuerst für enthaltene KI-Guthaben, Objektspeicher, Uploads und verwaltete Transkription.",
     providerKeyTitle: "Eigenen Anbieter-Schlüssel verwenden",
     providerKeyDescription:
       "Füge Anthropic-, OpenAI-, Gemini-, Groq- oder OpenRouter-Schlüssel für anbieterseitig abgerechnete Nutzung hinzu.",
@@ -787,7 +787,7 @@ Alle sichtbaren Änderungen für Clips-Nutzer werden hier dokumentiert. Du kanns
     videoUrlMissing:
       "Eine oder mehrere Aufzeichnungen haben noch keine fertige Video-URL",
     connectStorage:
-      "Verbinde Builder.io oder S3-kompatiblen Speicher, bevor du Aufzeichnungen zusammenfügst.",
+      "Verbinde Speicher vor dem Zusammenfügen von Aufzeichnungen: Builder.io (Speicher + KI im kostenlosen Tarif) oder S3-kompatibler Speicher.",
     created: "Zusammengefügte Aufzeichnung erstellt",
     failed: "Aufzeichnungen konnten nicht zusammengefügt werden",
     noOtherRecordings: "Keine anderen Aufzeichnungen verfügbar.",
@@ -1018,9 +1018,12 @@ Alle sichtbaren Änderungen für Clips-Nutzer werden hier dokumentiert. Du kanns
       "Nach 5 Minuten kam keine Antwort von Builder. Prüfe das Popup und versuche es erneut.",
     builderConnected: "Builder.io verbunden",
     waitingForBuilder: "Warten auf Builder...",
-    connectBuilder: "Builder.io verbinden",
+    connectBuilder: "Builder.io nutzen (kostenlos)",
     free: "Kostenlos",
     configureS3: "S3-kompatiblen Speicher konfigurieren",
+    whyPrompt: "Warum sehe ich das?",
+    whyDescription:
+      "Clips ist 100 % kostenlos und Open Source, deshalb musst du eine Möglichkeit zum Speichern deiner Clips verbinden. Verbinde Speicher mit Builder.io für Speicher und KI im kostenlosen Tarif, oder nutze S3-kompatiblen Objektspeicher und deine eigenen LLM-Schlüssel.",
   },
   captureInstall: {
     title: "Choose your recorder (Lokalisiert)",
@@ -1223,9 +1226,9 @@ Alle sichtbaren Änderungen für Clips-Nutzer werden hier dokumentiert. Du kanns
     downloadRecording: "Download recording (Lokalisiert)",
     openRecorderInTab: "Open recorder in tab (Lokalisiert)",
     connectStorageToFinish:
-      "Connect Builder.io or S3 storage on the next screen and Clips will finish saving it. (Lokalisiert)",
+      "Verbinde Speicher im nächsten Bildschirm: Builder.io (Speicher + KI im kostenlosen Tarif) oder S3-kompatibler Speicher. Clips schließt das Speichern ab.",
     connectStorageToRetryLoom:
-      "Connect Builder.io or S3 storage on the next screen and Clips will retry the import. (Lokalisiert)",
+      "Verbinde Speicher im nächsten Bildschirm: Builder.io (Speicher + KI im kostenlosen Tarif) oder S3-kompatibler Speicher. Clips versucht den Import erneut.",
   },
   dictateRoute: {
     pageTitle: "Dictate · Clips (Lokalisiert)",