@agent-native/core 0.115.4 → 0.116.0

package/corpus/templates/brain/scripts/configure-prod-clips-source.ts

@@ -0,0 +1,50 @@
+import { createHash, randomBytes } from "node:crypto";
+import { writeFile } from "node:fs/promises";
+
+import { getDbExec } from "@agent-native/core/db";
+
+const tokenFile = process.env.BRAIN_CLIPS_TOKEN_FILE;
+if (!tokenFile) throw new Error("BRAIN_CLIPS_TOKEN_FILE is required");
+
+const db = getDbExec();
+const { rows } = await db.execute({
+  sql: "SELECT id, source_key, config_json FROM brain_sources WHERE provider = ? AND title = ?",
+  args: ["clips", "Clips exports"],
+});
+if (rows.length !== 1) {
+  throw new Error(`Expected one Clips exports source, found ${rows.length}`);
+}
+
+const source = rows[0] as {
+  id: string;
+  source_key?: string | null;
+  config_json?: string | null;
+};
+const sourceKey = source.source_key?.trim() || "clips";
+const token = `brain_${randomBytes(32).toString("base64url")}`;
+const tokenHash = createHash("sha256").update(token).digest("hex");
+const config = JSON.parse(source.config_json || "{}") as Record<
+  string,
+  unknown
+>;
+config.sourceKey = sourceKey;
+config.ingestTokenHash = tokenHash;
+
+await db.execute({
+  sql: "UPDATE brain_sources SET source_key = ?, ingest_token_hash = ?, config_json = ?, updated_at = ? WHERE id = ?",
+  args: [
+    sourceKey,
+    tokenHash,
+    JSON.stringify(config),
+    new Date().toISOString(),
+    source.id,
+  ],
+});
+await writeFile(tokenFile, token, {
+  encoding: "utf8",
+  flag: "wx",
+  mode: 0o600,
+});
+console.log(
+  JSON.stringify({ configured: true, sourceId: source.id, sourceKey }),
+);

package/corpus/templates/brain/server/lib/capture-sanitization.ts

@@ -168,6 +168,10 @@ function preferredDeterministicSection(content: string): string {
   return content;
 }
 
+function hasSummarySection(content: string): boolean {
+  return /(?:^|\n)\s*Summary\s*\n/i.test(content);
+}
+
 function looksLikeRawTranscriptLine(line: string): boolean {
   return (
     /^\[[^\]\n]{1,80}\]\s*/.test(line) ||
@@ -208,6 +212,35 @@ function deterministicSanitizeContent(
   return retained.join("\n").slice(0, 80_000).trim();
 }
 
+function deterministicMeetingOutageFallback(
+  input: CaptureSanitizationInput,
+  decision: BrainSensitivityDecision,
+  capturedAt: string,
+): string | null {
+  if (
+    decision.disposition !== "allowed" ||
+    input.kind !== "transcript" ||
+    !["granola", "clips"].includes(input.source.provider) ||
+    !shouldSanitizeCaptureBeforeStorage(input) ||
+    !hasSummarySection(decision.safeContent) ||
+    PERSONAL_SIGNAL.test(decision.safeContent) ||
+    RECRUITING_SIGNAL.test(decision.safeContent)
+  ) {
+    return null;
+  }
+
+  const content = deterministicSanitizeContent(
+    sanitizeSensitiveText(decision.safeContent),
+    { dropTranscriptLines: true },
+  );
+  if (content === DEFAULT_SANITIZATION_OUTPUT) return null;
+
+  return fallbackSensitivityDecision(content, capturedAt).disposition ===
+    "allowed"
+    ? content
+    : null;
+}
+
 function safeTranscriptTitle(input: CaptureSanitizationInput): string {
   const date = input.capturedAt?.slice(0, 10);
   const providerLabel =
@@ -506,7 +539,9 @@ export async function sanitizeCaptureForStorage(
     deterministicQuarantineDecision(input.title, capturedAt) ??
     (titleDecision.disposition === "allowed" ? null : titleDecision) ??
     deterministicQuarantineDecision(input.content, capturedAt);
+  const sanitizationRequested = shouldSanitizeCaptureBeforeStorage(input);
   let fallbackReason: string | undefined;
+  let classifierOutageFallback = false;
   const classifierConfigured = Boolean(
     stringSetting(input.settings.privacyClassifierModel) &&
     stringSetting(input.settings.privacyClassifierEngine),
@@ -526,13 +561,35 @@ export async function sanitizeCaptureForStorage(
   }
   decision ??= fallbackSensitivityDecision(input.content, capturedAt);
   if (classifierFailed) {
-    decision = {
-      ...decision,
-      disposition: "quarantined",
-      confidenceBand: "uncertain",
-    };
+    const deterministicMeetingContent = deterministicMeetingOutageFallback(
+      input,
+      decision,
+      capturedAt,
+    );
+    if (deterministicMeetingContent) {
+      classifierOutageFallback = true;
+      decision = {
+        ...decision,
+        safeContent: deterministicMeetingContent,
+        safeSegments: [
+          {
+            id: "deterministic-meeting-summary",
+            capturedAt,
+            text: deterministicMeetingContent,
+            reactionCount: 0,
+          },
+        ],
+        confidenceBand: "deterministic",
+        classifier: "deterministic",
+      };
+    } else {
+      decision = {
+        ...decision,
+        disposition: "quarantined",
+        confidenceBand: "uncertain",
+      };
+    }
   }
-  const sanitizationRequested = shouldSanitizeCaptureBeforeStorage(input);
 
   const sanitizedContent =
     decision.disposition === "allowed"
@@ -575,6 +632,7 @@ export async function sanitizeCaptureForStorage(
             ? input.settings.privacyClassifierModel
             : undefined,
         fallbackReason,
+        classifierOutageFallback: classifierOutageFallback || undefined,
         disposition: decision.disposition,
         categories: decision.categories,
         confidenceBand: decision.confidenceBand,

package/corpus/templates/brain/server/plugins/agent-chat.ts

@@ -10,6 +10,8 @@ import { and, desc, like, or } from "drizzle-orm";
 import actionsRegistry from "../../.generated/actions-registry.js";
 import { tryAnswerBrainA2AQuestion } from "../lib/a2a-fallback.js";
 
+const BRAIN_BACKGROUND_RUN_SOFT_TIMEOUT_MS = 13 * 60_000;
+
 const INITIAL_TOOL_NAMES = [
   "get-brain-settings",
   "ask-brain",
@@ -39,6 +41,8 @@ export default createAgentChatPlugin({
   appId: "brain",
   actions: loadActionsFromStaticRegistry(actionsRegistry),
   initialToolNames: INITIAL_TOOL_NAMES,
+  durableBackgroundRuns: true,
+  runSoftTimeoutMs: BRAIN_BACKGROUND_RUN_SOFT_TIMEOUT_MS,
   resolveOrgId: async (event) => (await getOrgContext(event)).orgId,
   codeExecution: { production: "sandboxed" },
   systemPrompt: `You are the Brain institutional-knowledge agent.

package/corpus/templates/brain/server/plugins/brain-jobs.ts

@@ -2,6 +2,7 @@ import registerBrainDistillationQueueJob from "../jobs/distillation-queue.js";
 import registerBrainSourceSyncJob from "../jobs/sync-sources.js";
 
 export default () => {
+  if (process.env.NETLIFY === "true") return;
   registerBrainSourceSyncJob();
   registerBrainDistillationQueueJob();
 };

package/corpus/templates/brain/server/routes/api/brain/queue/run.post.ts

@@ -0,0 +1,55 @@
+import { timingSafeEqual } from "node:crypto";
+
+import { createError, defineEventHandler, getHeader } from "h3";
+
+import { processBrainIngestQueueOnce } from "../../../../../jobs/process-ingest-queue.js";
+import { syncDueBrainSourcesOnce } from "../../../../jobs/sync-sources.js";
+import { expireSensitivityQuarantines } from "../../../../lib/brain.js";
+
+declare global {
+  var __AGENT_NATIVE_BRAIN_SCHEDULED_RUNTIME__: boolean | undefined;
+}
+
+function productionLike() {
+  return (
+    process.env.NODE_ENV === "production" || process.env.NETLIFY === "true"
+  );
+}
+
+function scheduledFunctionRuntime() {
+  return globalThis.__AGENT_NATIVE_BRAIN_SCHEDULED_RUNTIME__ === true;
+}
+
+function headerMatchesSecret(header: string | undefined, secret: string) {
+  const expected = `Bearer ${secret}`;
+  const value = header?.trim() ?? "";
+  return (
+    value.length === expected.length &&
+    timingSafeEqual(Buffer.from(value), Buffer.from(expected))
+  );
+}
+
+export default defineEventHandler(async (event) => {
+  const secret = process.env.BRAIN_JOBS_SECRET?.trim(); // guard:allow-env-credential — deployment-level scheduler route secret
+  const scheduled = scheduledFunctionRuntime();
+  if (!secret && productionLike() && !scheduled) {
+    throw createError({
+      statusCode: 503,
+      statusMessage: "BRAIN_JOBS_SECRET is required",
+    });
+  }
+  if (
+    secret &&
+    !scheduled &&
+    !headerMatchesSecret(getHeader(event, "authorization"), secret)
+  ) {
+    throw createError({ statusCode: 401, statusMessage: "Unauthorized" });
+  }
+
+  const [sync, queue, expiredSensitivityQuarantines] = await Promise.all([
+    syncDueBrainSourcesOnce({ system: true, limit: 5 }),
+    processBrainIngestQueueOnce({ limit: 1, runDistillation: true }),
+    expireSensitivityQuarantines(),
+  ]);
+  return { ok: true, sync, queue, expiredSensitivityQuarantines };
+});

package/corpus/templates/calendar/.agents/skills/agent-native-toolkit/SKILL.md

@@ -85,7 +85,10 @@ in the moment of agent use.
   approval, generative UI, progress, and screen-state exposure.
 - **Chat history kit**: presentational chat lists and recent-chat rails belong
   in Toolkit; Core keeps thread persistence, agent execution, transport, and
-  page-to-sidebar handoff. Apps inject routing, labels, and domain actions.
+  page-to-sidebar handoff. Use Toolkit's `ChatHistoryRail` for the standard
+  five-item sidebar preview and a footer row with New chat followed by an
+  ellipsis disclosure up to fifteen. Apps inject routing, labels, and domain
+  actions.
 - **Agent page kit**: the full-page `/agent` surface (`AgentTabsPage` from
   `@agent-native/core/client`) with Context, Files, Connections, Jobs, and
   Access tabs plus a Personal/Organization scope toggle. The canonical home

package/corpus/templates/calendar/.agents/skills/real-time-sync/SKILL.md

@@ -72,7 +72,7 @@ The agent modifies data in SQL, but the UI runs in the browser. SSE bridges same
   });
   ```
 
-  `useDbSync` and every `subscribeSyncEvents` subscriber share one `EventSource` and one fallback poll loop per tab — this is how collaborative documents receive doc updates and cursor/awareness events.
+  `useDbSync` and every `subscribeSyncEvents` subscriber share one `EventSource` and one fallback poll loop per tab — this is how collaborative documents receive doc updates and cursor/awareness events. Hidden tabs keep that shared transport alive by default: SSE stays connected and active fallback polling relaxes to a 10-second floor (idle polling remains once per minute). Pass `pauseWhenHidden: true` only for a consumer that explicitly must stop all hidden-tab sync.
 
 ## Which sources to depend on
 

package/corpus/templates/chat/.agents/skills/agent-native-toolkit/SKILL.md

@@ -85,7 +85,10 @@ in the moment of agent use.
   approval, generative UI, progress, and screen-state exposure.
 - **Chat history kit**: presentational chat lists and recent-chat rails belong
   in Toolkit; Core keeps thread persistence, agent execution, transport, and
-  page-to-sidebar handoff. Apps inject routing, labels, and domain actions.
+  page-to-sidebar handoff. Use Toolkit's `ChatHistoryRail` for the standard
+  five-item sidebar preview and a footer row with New chat followed by an
+  ellipsis disclosure up to fifteen. Apps inject routing, labels, and domain
+  actions.
 - **Agent page kit**: the full-page `/agent` surface (`AgentTabsPage` from
   `@agent-native/core/client`) with Context, Files, Connections, Jobs, and
   Access tabs plus a Personal/Organization scope toggle. The canonical home

package/corpus/templates/chat/.agents/skills/real-time-sync/SKILL.md

@@ -72,7 +72,7 @@ The agent modifies data in SQL, but the UI runs in the browser. SSE bridges same
   });
   ```
 
-  `useDbSync` and every `subscribeSyncEvents` subscriber share one `EventSource` and one fallback poll loop per tab — this is how collaborative documents receive doc updates and cursor/awareness events.
+  `useDbSync` and every `subscribeSyncEvents` subscriber share one `EventSource` and one fallback poll loop per tab — this is how collaborative documents receive doc updates and cursor/awareness events. Hidden tabs keep that shared transport alive by default: SSE stays connected and active fallback polling relaxes to a 10-second floor (idle polling remains once per minute). Pass `pauseWhenHidden: true` only for a consumer that explicitly must stop all hidden-tab sync.
 
 ## Which sources to depend on
 

package/corpus/templates/chat/app/components/layout/Layout.tsx

@@ -60,6 +60,7 @@ export function Layout({ children }: LayoutProps) {
   useAgentChatHomeHandoffLinks({
     storageKey: "chat",
     isChatPath: (pathname) => pathname === "/" || pathname.startsWith("/chat/"),
+    requireActiveHandoff: false,
   });
 
   useEffect(() => {

package/corpus/templates/chat/app/components/layout/Sidebar.tsx

@@ -9,7 +9,7 @@ import { useT } from "@agent-native/core/client/i18n";
 import { OrgSwitcher } from "@agent-native/core/client/org";
 import { FeedbackButton } from "@agent-native/core/client/ui";
 import {
-  ChatHistoryList,
+  ChatHistoryRail,
   type ChatHistoryItem,
 } from "@agent-native/toolkit/chat-history";
 import {
@@ -17,7 +17,6 @@ import {
   IconLayoutSidebarLeftCollapse,
   IconLayoutSidebarLeftExpand,
   IconMessageCircle,
-  IconPlus,
   IconSettings,
 } from "@tabler/icons-react";
 import { useEffect, useMemo } from "react";
@@ -104,6 +103,12 @@ function persistedActiveThreadId() {
   }
 }
 
+function persistActiveThreadId(threadId: string) {
+  try {
+    localStorage.setItem(CHAT_ACTIVE_THREAD_KEY, threadId);
+  } catch {}
+}
+
 function threadIdFromPath(pathname: string) {
   const match = pathname.match(/^\/chat\/([^/]+)/);
   if (!match) return null;
@@ -142,7 +147,7 @@ function ChatThreadsSection() {
       threads
         .filter((thread) => thread.messageCount > 0 && !thread.archivedAt)
         .sort(compareThreads)
-        .slice(0, 12),
+        .slice(0, 15),
     [threads],
   );
   const displayedActiveThreadId =
@@ -184,6 +189,7 @@ function ChatThreadsSection() {
 
   function openThread(threadId: string, options?: { isNew?: boolean }) {
     switchThread(threadId);
+    persistActiveThreadId(threadId);
     navigateWithAgentChatViewTransition(
       navigate,
       options?.isNew ? "/" : chatThreadPath(threadId),
@@ -223,50 +229,35 @@ function ChatThreadsSection() {
 
   return (
     <div className="mt-2 border-s border-sidebar-border/70 ps-3">
-      <div className="mb-1 flex h-7 items-center gap-2 pe-1">
-        <div className="min-w-0 flex-1 text-xs font-medium text-sidebar-foreground/70">
-          {t("chat.chats")}
-        </div>
-        <Tooltip>
-          <TooltipTrigger asChild>
-            <button
-              type="button"
-              onClick={handleNewChat}
-              className="flex size-6 shrink-0 items-center justify-center rounded-md text-sidebar-foreground/65 transition-colors hover:bg-sidebar-accent hover:text-sidebar-accent-foreground"
-              aria-label={t("chat.newChat")}
-            >
-              <IconPlus className="size-3.5" />
-            </button>
-          </TooltipTrigger>
-          <TooltipContent>{t("chat.newChat")}</TooltipContent>
-        </Tooltip>
-      </div>
-      {visibleThreads.length > 0 && (
-        <ChatHistoryList
-          items={chatItems}
-          activeId={displayedActiveThreadId}
-          onSelect={(threadId) => openThread(threadId)}
-          renameMaxLength={160}
-          onTogglePin={(threadId) => {
-            const thread = visibleThreads.find((item) => item.id === threadId);
-            if (thread) void pinThread(threadId, !thread.pinnedAt);
-          }}
-          onRename={handleRenameThread}
-          onDelete={(threadId) => void handleArchiveThread(threadId)}
-          labels={{
-            options: (item) =>
-              t("chat.optionsFor", { title: item.titleText ?? "" }),
-            renameInput: (item) =>
-              t("chat.renameThread", { title: item.titleText ?? "" }),
-            rename: t("chat.renameChat"),
-            pin: t("chat.pinChat"),
-            unpin: t("chat.unpinChat"),
-            delete: t("chat.archiveChat"),
-          }}
-          variant="rail"
-          className="min-w-0"
-        />
-      )}
+      <ChatHistoryRail
+        items={chatItems}
+        activeId={displayedActiveThreadId}
+        onSelect={(threadId) => openThread(threadId)}
+        onNewChat={() => void handleNewChat()}
+        railLabels={{
+          newChat: t("chat.newChat"),
+          showMore: t("chat.chats"),
+          showLess: t("chat.chats"),
+        }}
+        renameMaxLength={160}
+        onTogglePin={(threadId) => {
+          const thread = visibleThreads.find((item) => item.id === threadId);
+          if (thread) void pinThread(threadId, !thread.pinnedAt);
+        }}
+        onRename={handleRenameThread}
+        onDelete={(threadId) => void handleArchiveThread(threadId)}
+        labels={{
+          options: (item) =>
+            t("chat.optionsFor", { title: item.titleText ?? "" }),
+          renameInput: (item) =>
+            t("chat.renameThread", { title: item.titleText ?? "" }),
+          rename: t("chat.renameChat"),
+          pin: t("chat.pinChat"),
+          unpin: t("chat.unpinChat"),
+          delete: t("chat.archiveChat"),
+        }}
+        className="min-w-0"
+      />
     </div>
   );
 }
@@ -445,28 +436,13 @@ export function Sidebar({
           />
         </div>
 
-        <div
-          className={cn(
-            collapsed ? "flex justify-center px-1 py-1" : "px-3 py-2",
-          )}
-        >
-          <FeedbackButton
-            variant={collapsed ? "icon" : "sidebar"}
-            side="right"
-            align={collapsed ? "center" : "end"}
-          />
-        </div>
-
-        {collapseButton ? (
-          <div
-            className={cn(
-              collapsed
-                ? "flex justify-center px-1 py-1"
-                : "flex justify-end px-3 py-2",
-            )}
-          >
+        {!collapsed ? (
+          <div className="flex items-center justify-end gap-1 px-3 py-2">
+            <FeedbackButton className="min-w-0 flex-1" side="right" />
             {collapseButton}
           </div>
+        ) : collapseButton ? (
+          <div className="flex justify-center px-1 py-1">{collapseButton}</div>
         ) : null}
       </div>
     </aside>

package/corpus/templates/chat/app/hooks/use-navigation-state.ts

@@ -1,7 +1,4 @@
-import {
-  isAgentChatHomeHandoffActive,
-  markAgentChatHomeHandoff,
-} from "@agent-native/core/client/agent-chat";
+import { markAgentChatHomeHandoff } from "@agent-native/core/client/agent-chat";
 import { appBasePath, appPath } from "@agent-native/core/client/api-path";
 import { useAgentRouteState } from "@agent-native/core/client/navigation";
 import { useLocation } from "react-router";
@@ -34,9 +31,7 @@ export function useNavigationState() {
         isChatPath(location.pathname) &&
         !isChatPath(pathnameFromPath(path))
       ) {
-        if (isAgentChatHomeHandoffActive("chat")) {
-          markAgentChatHomeHandoff("chat");
-        }
+        markAgentChatHomeHandoff("chat");
       }
     },
   });

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

@@ -36,6 +36,13 @@ export default function ChatRoute() {
   const { threadId } = useParams();
   const navigate = useNavigate();
   const t = useT();
+  const threadUrlSync = threadId
+    ? {
+        routeThreadId: threadId,
+        getPath: chatThreadPath,
+        navigate,
+      }
+    : undefined;
 
   useEffect(() => {
     function handleChatRunning(event: Event) {
@@ -56,11 +63,7 @@ export default function ChatRoute() {
         className="h-full"
         defaultMode="chat"
         storageKey="chat"
-        threadUrlSync={{
-          routeThreadId: threadId ?? null,
-          getPath: chatThreadPath,
-          navigate,
-        }}
+        threadUrlSync={threadUrlSync}
         browserTabId={TAB_ID}
         showHeader={false}
         showTabBar={false}

package/corpus/templates/chat/changelog/2026-07-22-compact-sidebar-footer.md

@@ -0,0 +1,6 @@
+---
+type: improved
+date: 2026-07-22
+---
+
+The sidebar footer now keeps Feedback and the collapse control on one compact row.

package/corpus/templates/chat/changelog/2026-07-22-full-page-chat-keeps-the-active-conversation-when-moving-to-.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-07-22
+---
+
+Full-page chat keeps the active conversation when moving to and from the sidebar.

package/corpus/templates/chat/changelog/2026-07-22-recent-chats-are-easier-to-scan-and-expand.md

@@ -0,0 +1,6 @@
+---
+type: improved
+date: 2026-07-22
+---
+
+Recent chats now expand from a compact five-item list with New chat anchored at the bottom.

package/corpus/templates/clips/.agents/skills/agent-native-toolkit/SKILL.md

@@ -85,7 +85,10 @@ in the moment of agent use.
   approval, generative UI, progress, and screen-state exposure.
 - **Chat history kit**: presentational chat lists and recent-chat rails belong
   in Toolkit; Core keeps thread persistence, agent execution, transport, and
-  page-to-sidebar handoff. Apps inject routing, labels, and domain actions.
+  page-to-sidebar handoff. Use Toolkit's `ChatHistoryRail` for the standard
+  five-item sidebar preview and a footer row with New chat followed by an
+  ellipsis disclosure up to fifteen. Apps inject routing, labels, and domain
+  actions.
 - **Agent page kit**: the full-page `/agent` surface (`AgentTabsPage` from
   `@agent-native/core/client`) with Context, Files, Connections, Jobs, and
   Access tabs plus a Personal/Organization scope toggle. The canonical home

package/corpus/templates/clips/AGENTS.md

@@ -69,7 +69,15 @@ ladder.
   current-user recordings with ready transcripts in the active organization
   and reports exported, quarantined, skipped, and failed counts. Both
   `BRAIN_INGEST_URL` and `BRAIN_INGEST_TOKEN` must be available as scoped Clips
-  secrets.
+  secrets. Transcript completion persists a pending export before handing it to
+  the durable post-finalize worker; delivery receipts include the Brain capture
+  or sensitivity receipt id, while transient failures are swept and retried.
+  The sweep also discovers ready transcripts from the last seven days that
+  predate export-state tracking, in bounded batches, so recent recordings are
+  backfilled after the connection is configured.
+  Netlify builds emit a protected per-minute scheduled sweep because in-process
+  intervals are not durable there. Other serverless hosts must invoke
+  `runBrainExportSweepOnce` from their own scheduler.
 - The transcript embedded by `view-screen` is a bounded preview. If
   `previewTruncated` is true, it may end mid-sentence and does not show where
   transcription ended. Call `get-recording-player-data` before judging