@agent-native/core 0.79.26 → 0.79.27

package/corpus/core/src/server/core-routes-plugin.ts

@@ -167,6 +167,39 @@ export const FRAMEWORK_ROUTE_PREFIX = "/_agent-native";
 export const FRAMEWORK_EVENTS_ROUTE = `${FRAMEWORK_ROUTE_PREFIX}/events`;
 export const LEGACY_FRAMEWORK_EVENTS_ROUTE = `${FRAMEWORK_ROUTE_PREFIX}/poll-events`;
 
+export function getFrameworkEnvKeys(): EnvKeyConfig[] {
+  return [
+    { key: "ENABLE_BUILDER", label: "Enable Builder.io features" },
+    {
+      key: "AGENT_ENGINE_PREFER_BYO_KEY",
+      label:
+        "Prefer BYO LLM key over Builder gateway (default: false — gateway wins)",
+    },
+    {
+      key: "RESEND_API_KEY",
+      label: "Resend API key",
+      helpText:
+        "Enables transactional email, including password resets, invitations, share notifications, and dashboard reports.",
+    },
+    {
+      key: "SENDGRID_API_KEY",
+      label: "SendGrid API key",
+      helpText:
+        "Enables transactional email, including password resets, invitations, share notifications, and dashboard reports.",
+    },
+    {
+      key: "EMAIL_FROM",
+      label: "Email from address",
+      helpText:
+        "Sender address for transactional email. Required when using SendGrid.",
+    },
+    ...Object.values(PROVIDER_ENV_META).map(({ envVar, label }) => ({
+      key: envVar,
+      label,
+    })),
+  ];
+}
+
 /** Result of the `/_agent-native/health` liveness + DB-warmup probe. */
 export interface DbHealthProbeResult {
   /** The serverless function is live and served the request. */
@@ -2199,18 +2232,7 @@ export function createCoreRoutesPlugin(
       );
 
       // Env key management — framework keys are always included
-      const frameworkEnvKeys: EnvKeyConfig[] = [
-        { key: "ENABLE_BUILDER", label: "Enable Builder.io features" },
-        {
-          key: "AGENT_ENGINE_PREFER_BYO_KEY",
-          label:
-            "Prefer BYO LLM key over Builder gateway (default: false — gateway wins)",
-        },
-        ...Object.values(PROVIDER_ENV_META).map(({ envVar, label }) => ({
-          key: envVar,
-          label,
-        })),
-      ];
+      const frameworkEnvKeys = getFrameworkEnvKeys();
       {
         const envKeys = [...frameworkEnvKeys, ...(options.envKeys ?? [])];
         const allowedEnvKeyNames = envKeys.map(({ key }) => key);

package/corpus/core/src/shared/mcp-integration-config.ts

@@ -0,0 +1,101 @@
+export interface McpIntegrationDefaultsFilterConfig {
+  include?: string[];
+  exclude?: string[];
+}
+
+export type McpIntegrationDefaultsConfig =
+  | boolean
+  | McpIntegrationDefaultsFilterConfig;
+
+export type McpIntegrationsConfigInput =
+  | boolean
+  | {
+      /**
+       * Built-in remote MCP presets shown in the integration catalog.
+       *
+       * Set to `false` to hide all defaults while keeping custom server setup.
+       * Use `include` or `exclude` to allow/block individual preset ids.
+       */
+      defaults?: McpIntegrationDefaultsConfig;
+      /** Whether users can add an arbitrary remote MCP endpoint. Defaults to true. */
+      custom?: boolean;
+    };
+
+export interface NormalizedMcpIntegrationsConfig {
+  enabled: boolean;
+  custom: boolean;
+  defaults: {
+    enabled: boolean;
+    include?: string[];
+    exclude: string[];
+  };
+}
+
+function cleanIds(value: unknown): string[] {
+  if (!Array.isArray(value)) return [];
+  const ids = new Set<string>();
+  for (const item of value) {
+    if (typeof item !== "string") continue;
+    const id = item.trim().toLowerCase();
+    if (id) ids.add(id);
+  }
+  return [...ids];
+}
+
+export function normalizeMcpIntegrationsConfig(
+  input:
+    | McpIntegrationsConfigInput
+    | NormalizedMcpIntegrationsConfig
+    | undefined = true,
+): NormalizedMcpIntegrationsConfig {
+  if (
+    input === false ||
+    (input &&
+      typeof input === "object" &&
+      (input as { enabled?: unknown }).enabled === false)
+  ) {
+    return {
+      enabled: false,
+      custom: false,
+      defaults: { enabled: false, exclude: [] },
+    };
+  }
+
+  if (input === true || input === undefined) {
+    return {
+      enabled: true,
+      custom: true,
+      defaults: { enabled: true, exclude: [] },
+    };
+  }
+
+  const defaults = input.defaults;
+  const custom = input.custom !== false;
+  const defaultsEnabled =
+    defaults && typeof defaults === "object"
+      ? (defaults as { enabled?: unknown }).enabled !== false
+      : defaults !== false;
+
+  if (!defaultsEnabled) {
+    return {
+      enabled: custom,
+      custom,
+      defaults: { enabled: false, exclude: [] },
+    };
+  }
+
+  const include =
+    defaults && typeof defaults === "object" ? cleanIds(defaults.include) : [];
+  const exclude =
+    defaults && typeof defaults === "object" ? cleanIds(defaults.exclude) : [];
+
+  return {
+    enabled: true,
+    custom,
+    defaults: {
+      enabled: defaultsEnabled,
+      ...(include.length > 0 ? { include } : {}),
+      exclude,
+    },
+  };
+}

package/corpus/core/src/styles/agent-native.css

@@ -549,112 +549,14 @@
   display: inline-flex;
   align-items: center;
   min-height: 1.125rem;
+  color: hsl(var(--muted-foreground));
+  font-size: 0.8125rem;
+  font-weight: 500;
+  line-height: 1.125rem;
 }
 
-.agent-thinking-indicator__glyph {
-  display: block;
-  width: var(--agent-thinking-width);
-  height: 1.125rem;
-  overflow: visible;
-}
-
-.agent-thinking-indicator__base {
-  fill: hsl(var(--muted-foreground) / 0.48);
-}
-
-.agent-thinking-indicator__shimmer {
-  transform-box: fill-box;
-  transform-origin: left center;
-  will-change: transform, opacity;
-  animation: agent-thinking-shimmer 1.7s cubic-bezier(0.42, 0, 0.18, 1) infinite;
-}
-
-.agent-thinking-indicator__sheen-edge {
-  stop-color: hsl(var(--foreground));
-  stop-opacity: 0;
-}
-
-.agent-thinking-indicator__sheen-mid {
-  stop-color: hsl(var(--foreground));
-  stop-opacity: 0.92;
-}
-
-.agent-thinking-indicator__ellipsis-dot {
-  opacity: 0;
-}
-
-.agent-thinking-indicator__ellipsis-dot--1 {
-  animation: agent-thinking-ellipsis-one 1.35s steps(1, end) infinite;
-}
-
-.agent-thinking-indicator__ellipsis-dot--2 {
-  animation: agent-thinking-ellipsis-two 1.35s steps(1, end) infinite;
-}
-
-.agent-thinking-indicator__ellipsis-dot--3 {
-  animation: agent-thinking-ellipsis-three 1.35s steps(1, end) infinite;
-}
-
-@keyframes agent-thinking-shimmer {
-  0% {
-    opacity: 0;
-    transform: translateX(-118%);
-  }
-  22% {
-    opacity: 0.9;
-  }
-  62% {
-    opacity: 0.9;
-  }
-  100% {
-    opacity: 0;
-    transform: translateX(245%);
-  }
-}
-
-@keyframes agent-thinking-ellipsis-one {
-  0%,
-  24% {
-    opacity: 0;
-  }
-  25%,
-  100% {
-    opacity: 1;
-  }
-}
-
-@keyframes agent-thinking-ellipsis-two {
-  0%,
-  49% {
-    opacity: 0;
-  }
-  50%,
-  100% {
-    opacity: 1;
-  }
-}
-
-@keyframes agent-thinking-ellipsis-three {
-  0%,
-  74% {
-    opacity: 0;
-  }
-  75%,
-  100% {
-    opacity: 1;
-  }
-}
-
-@media (prefers-reduced-motion: reduce) {
-  .agent-thinking-indicator__shimmer {
-    animation: none;
-    opacity: 0;
-  }
-
-  .agent-thinking-indicator__ellipsis-dot {
-    animation: none;
-    opacity: 1;
-  }
+.agent-thinking-indicator__text {
+  display: inline-block;
 }
 
 @media (prefers-reduced-motion: no-preference) {

package/corpus/core/src/styles/blocks.css

@@ -1177,6 +1177,10 @@
   border-radius: var(--wf-radius);
   padding: 12px;
 }
+.plan-html-frame[data-style="sketchy"]:not([data-render-mode="design"])
+  :is(.wf-card, .wf-box) {
+  border-color: color-mix(in srgb, var(--wf-line) 72%, transparent);
+}
 .plan-html-frame:not([data-render-mode="design"]) .wf-pill,
 .plan-html-frame:not([data-render-mode="design"]) .wf-chip {
   display: inline-flex;
@@ -1193,10 +1197,18 @@
   background: var(--wf-accent-soft);
 }
 
-/* Once rough has drawn, hide the crisp borders so there's no doubling. Pills
-   keep their rounded crisp border (the rough overlay rounds them too). */
+/* Once rough has drawn, hide crisp borders only on elements rough.js actually
+   redraws. Broad helper containers keep theme-safe filled backgrounds and soft
+   borders so nested cards do not become a pile of overlapping sketch strokes. */
 .plan-html-frame[data-rough-ready]
-  :is(button, input, textarea, select, .wf-card, .wf-box, hr, [data-rough]) {
+  :is(
+    button,
+    input,
+    textarea,
+    select,
+    hr,
+    [data-rough]:not([data-rough="none"])
+  ) {
   border-color: transparent !important;
 }
 

package/corpus/core/src/vite/client.ts

@@ -21,6 +21,10 @@ import {
   mcpEmbedStaticAssetRouteRules,
   shouldAllowMcpEmbedCredentials,
 } from "../shared/mcp-embed-headers.js";
+import {
+  normalizeMcpIntegrationsConfig,
+  type McpIntegrationsConfigInput,
+} from "../shared/mcp-integration-config.js";
 import {
   normalizeAgentNativeRouteWarmupConfig,
   type AgentNativeRouteWarmupConfigInput,
@@ -881,6 +885,16 @@ export interface ClientConfigOptions {
    * ordinary fetches for `.data` and `modulepreload` for route JS by default.
    */
   routeWarmup?: AgentNativeRouteWarmupConfigInput;
+  /**
+   * Controls the MCP integrations catalog exposed from the composer + menu.
+   *
+   * - `false` hides the whole MCP integrations entry.
+   * - `{ defaults: false }` hides all bundled provider presets but still
+   *   allows custom MCP servers.
+   * - `{ defaults: { include: ["context7"] } }` allows only those preset ids.
+   * - `{ defaults: { exclude: ["stripe"] } }` hides specific preset ids.
+   */
+  mcpIntegrations?: McpIntegrationsConfigInput;
   /**
    * Whether to auto-inject the Tailwind v4 Vite plugin (`@tailwindcss/vite`).
    * Defaults to true — set to `false` if a template wants to manage Tailwind
@@ -2063,6 +2077,9 @@ function createAgentNativeConfig(
       __AGENT_NATIVE_ROUTE_WARMUP_CONFIG__: JSON.stringify(
         normalizeAgentNativeRouteWarmupConfig(options.routeWarmup),
       ),
+      __AGENT_NATIVE_MCP_INTEGRATIONS_CONFIG__: JSON.stringify(
+        normalizeMcpIntegrationsConfig(options.mcpIntegrations),
+      ),
     },
     server: {
       ...(userConfig.server ?? {}),

package/corpus/templates/analytics/app/global.css

@@ -215,6 +215,28 @@
   transform-origin: top left;
 }
 
+.analytics-session-snippet .plan-code-surface {
+  border: 0;
+  border-radius: 0;
+  background: transparent;
+}
+
+.analytics-session-snippet .plan-code-surface-scroll {
+  background: hsl(225 31% 7%);
+}
+
+.analytics-session-snippet .plan-code-surface .plan-shiki,
+.analytics-session-snippet .plan-code-surface pre,
+.analytics-session-snippet .plan-code-surface .plan-shiki pre,
+.analytics-session-snippet .plan-code-surface .plan-shiki code,
+.analytics-session-snippet .plan-code-surface .plan-shiki pre span {
+  background: transparent !important;
+}
+
+.light .analytics-session-snippet .plan-code-surface-scroll {
+  background: hsl(240 6% 96%);
+}
+
 .an-replay-scrub {
   height: 0.25rem;
   appearance: none;

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

@@ -161,6 +161,7 @@ const messages = {
     untitledDashboard: "未命名儀表板",
   },
   common: {
+    docs: "檔案",
     noData: "無資料",
     noDataAvailable: "無可用資料",
     rowsPerPage: "每頁行數：",

package/corpus/templates/analytics/app/i18n-data.ts

@@ -179,6 +179,7 @@ const enUS = {
     newAnalysisPlaceholder: "Describe the question you want to investigate...",
   },
   common: {
+    docs: "Docs",
     noData: "No data",
     noDataAvailable: "No data available",
     rowsPerPage: "Rows per page:",

package/corpus/templates/analytics/app/pages/sessions/SessionsPage.tsx

@@ -3,6 +3,7 @@ import { useActionQuery, useT } from "@agent-native/core/client";
 import {
   IconChevronDown,
   IconCode,
+  IconExternalLink,
   IconFilter,
   IconPlayerPlay,
   IconRefresh,
@@ -27,6 +28,9 @@ import { cn } from "@/lib/utils";
 
 type ReplayRange = "24h" | "7d" | "30d" | "90d" | "all";
 
+const SESSION_REPLAY_DOCS_URL =
+  "https://www.agent-native.com/docs/tracking#session-replay";
+
 type SessionRecordingSummary = {
   id: string;
   clientRecordingId: string;
@@ -302,22 +306,33 @@ function EmptySessionsState() {
             {t("sessions.noSessionsDescription")}
           </p>
         </div>
-        <div className="flex flex-wrap gap-2 text-xs text-muted-foreground">
-          <Badge variant="outline">{t("sessions.emptyStepKey")}</Badge>
-          <Badge variant="outline">{t("sessions.emptyStepEnv")}</Badge>
-          <Badge variant="outline">{t("sessions.emptyStepVisit")}</Badge>
-        </div>
       </div>
-      <div className="overflow-hidden rounded-md border bg-muted/30">
-        <div className="flex items-center gap-2 border-b px-4 py-3 text-sm font-medium">
-          <IconCode className="h-4 w-4" />
-          {t("sessions.installSnippetTitle")}
+      <div className="analytics-session-snippet overflow-hidden rounded-md border bg-muted/30">
+        <div className="flex items-center justify-between gap-3 border-b px-4 py-3">
+          <div className="flex min-w-0 items-center gap-2 text-sm font-medium">
+            <IconCode className="h-4 w-4 text-muted-foreground" />
+            <span className="truncate">
+              {t("sessions.installSnippetTitle")}
+            </span>
+          </div>
+          <Button
+            asChild
+            variant="ghost"
+            size="sm"
+            className="h-7 px-2 text-xs"
+          >
+            <a href={SESSION_REPLAY_DOCS_URL} target="_blank" rel="noreferrer">
+              {t("common.docs")}
+              <IconExternalLink className="h-3.5 w-3.5" />
+            </a>
+          </Button>
         </div>
         <CodeSurface
           code={SESSION_REPLAY_SNIPPET}
           language="typescript"
           maxLines={null}
-          className="mt-0 rounded-none border-0 bg-transparent"
+          showLanguageLabel={false}
+          className="mt-0"
         />
       </div>
     </div>

package/corpus/templates/analytics/changelog/2026-06-28-sessions-shows-scoped-recordings-even-when-replay-events-are.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-06-28
+---
+
+The Sessions page shows scoped recordings even when replay events are unavailable, with a cleaner setup snippet.

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

@@ -992,11 +992,7 @@ function hasVisibleSessionRecordingIdentity(row: any): boolean {
 }
 
 function isVisibleSessionRecording(row: any): boolean {
-  return (
-    hasVisibleSessionRecordingIdentity(row) &&
-    Number(row.chunkCount ?? 0) > 0 &&
-    Number(row.eventCount ?? 0) > 0
-  );
+  return hasVisibleSessionRecordingIdentity(row);
 }
 
 function mergeReplayMetadata(
@@ -1357,8 +1353,6 @@ export async function listSessionRecordings(
       orgId: scope.orgId ?? undefined,
     }),
     replayVisibleIdentityCondition(),
-    gte(schema.sessionRecordings.chunkCount, 1),
-    gte(schema.sessionRecordings.eventCount, 1),
   ];
   if (filters.app)
     conditions.push(eq(schema.sessionRecordings.app, filters.app));

package/corpus/templates/clips/AGENTS.md

@@ -60,6 +60,10 @@ Detailed media, meeting, dictation, editing, and sharing rules live in
   tell the user that clearly and point them to Builder.io credits/upgrade or a
   Groq key for backup speech-to-text. Generic OpenAI or Anthropic chat keys do
   not transcribe Clips recordings.
+- Use `get-builder-credit-status` when the user asks whether Builder.io credit
+  limits are pausing backup transcription, transcript cleanup, summaries, or AI
+  title generation. Treat an exhausted status as an FYI/upgrade path, not an app
+  error.
 - Slack unfurls use `/api/slack/unfurl` for `link_shared` events and only
   return playable `chat.unfurl` video blocks for ready public clips with no
   password, no expiry hit, and no archive/trash marker. Private, org-only,

package/corpus/templates/clips/actions/cleanup-transcript.ts

@@ -33,6 +33,12 @@ import {
 } from "@agent-native/core/server";
 import { z } from "zod";
 
+import { isBuilderCreditsExhaustedMessage } from "../shared/builder-credits.js";
+import {
+  clearBuilderCreditsExhausted,
+  noteBuilderCreditsExhausted,
+} from "./lib/builder-credits-state.js";
+
 // Builder gateway maps this to Gemini 3.1 Flash-Lite (see transcribe-voice.ts:52).
 const BUILDER_MODEL = "gemini-3-1-flash-lite";
 
@@ -117,6 +123,7 @@ export default defineAction({
           wantJson,
         });
         if (text.trim()) {
+          await clearBuilderCreditsExhausted();
           return shapeResult(args.task, text, "builder");
         }
         builderReturnedEmpty = true;
@@ -126,7 +133,18 @@ export default defineAction({
         // Hard errors (e.g. credits exhausted) still surface to the caller.
         const message = (err as Error)?.message ?? String(err);
         builderFailureMessage = message;
-        if (message.includes("credits exhausted")) throw err;
+        if (isBuilderCreditsExhaustedMessage(message)) {
+          await noteBuilderCreditsExhausted({
+            source:
+              args.task === "title"
+                ? "title"
+                : args.task === "summary"
+                  ? "summary"
+                  : "cleanup",
+            message,
+          });
+          throw err;
+        }
         console.warn("[cleanup-transcript] Builder path failed:", message);
       }
     }

package/corpus/templates/clips/actions/get-builder-credit-status.ts

@@ -0,0 +1,22 @@
+import { defineAction } from "@agent-native/core";
+import { readAppState } from "@agent-native/core/application-state";
+import { z } from "zod";
+
+import {
+  CLIPS_BUILDER_CREDITS_STATE_KEY,
+  normalizeBuilderCreditsStatus,
+} from "../shared/builder-credits.js";
+
+export default defineAction({
+  description:
+    "Return the last known Builder.io AI credit limit state for Clips. Use this before explaining paused backup transcription, transcript cleanup, summaries, or AI title generation.",
+  schema: z.object({}),
+  http: { method: "GET" },
+  readOnly: true,
+  run: async () => {
+    const raw = await readAppState(CLIPS_BUILDER_CREDITS_STATE_KEY).catch(
+      () => null,
+    );
+    return normalizeBuilderCreditsStatus(raw);
+  },
+});

package/corpus/templates/clips/actions/get-recording-player-data.ts

@@ -28,6 +28,10 @@ import { getDb, schema } from "../server/db/index.js";
 import { resolvePlayerVideoUrl } from "../server/lib/player-video-url.js";
 import { parseSpaceIds } from "../server/lib/recordings.js";
 import { parseBrowserDiagnosticsRow } from "../shared/browser-diagnostics.js";
+import {
+  CLIPS_BUILDER_CREDITS_STATE_KEY,
+  normalizeBuilderCreditsStatus,
+} from "../shared/builder-credits.js";
 import {
   normalizeTranscriptSegments,
   parseTranscriptSegments,
@@ -106,13 +110,23 @@ export default defineAction({
       .from(schema.recordingTranscripts)
       .where(eq(schema.recordingTranscripts.recordingId, args.recordingId))
       .limit(1);
-    const cleanupStateRaw = await readAppState(
-      `transcript-cleanup-${args.recordingId}`,
-    ).catch(() => null);
+    const canEditRecording =
+      access.role === "owner" ||
+      access.role === "admin" ||
+      access.role === "editor";
+    const [cleanupStateRaw, builderCreditsRaw] = await Promise.all([
+      readAppState(`transcript-cleanup-${args.recordingId}`).catch(() => null),
+      canEditRecording
+        ? readAppState(CLIPS_BUILDER_CREDITS_STATE_KEY).catch(() => null)
+        : Promise.resolve(null),
+    ]);
     const cleanupState =
       cleanupStateRaw && typeof cleanupStateRaw === "object"
         ? (cleanupStateRaw as Record<string, unknown>)
         : null;
+    const builderCredits = canEditRecording
+      ? normalizeBuilderCreditsStatus(builderCreditsRaw)
+      : null;
 
     const comments = await db
       .select()
@@ -296,6 +310,7 @@ export default defineAction({
               : null,
           }
         : null,
+      builderCredits,
       comments: comments.map((c) => ({
         id: c.id,
         recordingId: c.recordingId,

package/corpus/templates/clips/actions/lib/builder-credits-state.ts

@@ -0,0 +1,46 @@
+import {
+  deleteAppState,
+  writeAppState,
+} from "@agent-native/core/application-state";
+
+import {
+  CLIPS_BUILDER_CREDITS_STATE_KEY,
+  createBuilderCreditsExhaustedStatus,
+  type BuilderCreditsSource,
+} from "../../shared/builder-credits.js";
+
+export async function noteBuilderCreditsExhausted({
+  source,
+  message,
+}: {
+  source: BuilderCreditsSource;
+  message: string;
+}): Promise<void> {
+  try {
+    await writeAppState(
+      CLIPS_BUILDER_CREDITS_STATE_KEY,
+      createBuilderCreditsExhaustedStatus({
+        source,
+        message,
+      }) as unknown as Record<string, unknown>,
+    );
+    await writeAppState("refresh-signal", { ts: Date.now() });
+  } catch (err) {
+    console.warn(
+      "[clips] failed to record Builder credit state:",
+      (err as Error)?.message ?? String(err),
+    );
+  }
+}
+
+export async function clearBuilderCreditsExhausted(): Promise<void> {
+  try {
+    const removed = await deleteAppState(CLIPS_BUILDER_CREDITS_STATE_KEY);
+    if (removed) await writeAppState("refresh-signal", { ts: Date.now() });
+  } catch (err) {
+    console.warn(
+      "[clips] failed to clear Builder credit state:",
+      (err as Error)?.message ?? String(err),
+    );
+  }
+}