@agent-native/core 0.115.4 → 0.116.0

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

@@ -12,7 +12,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 {
@@ -22,7 +22,6 @@ import {
   IconLayoutSidebarLeftExpand,
   IconLayoutGrid,
   IconPhotoPlus,
-  IconPlus,
   IconSettings,
   IconShare3,
 } from "@tabler/icons-react";
@@ -96,6 +95,12 @@ function persistedActiveThreadId() {
   }
 }
 
+function persistActiveThreadId(threadId: string) {
+  try {
+    localStorage.setItem(ASSETS_ACTIVE_THREAD_KEY, threadId);
+  } catch {}
+}
+
 function threadIdFromPath(pathname: string) {
   const match = pathname.match(/^\/chat\/([^/]+)/);
   if (!match) return null;
@@ -134,8 +139,7 @@ function AssetsChatsSection() {
     () =>
       threads
         .filter((thread) => thread.messageCount > 0 && !thread.archivedAt)
-        .sort(compareThreads)
-        .slice(0, 10),
+        .sort(compareThreads),
     [threads],
   );
   const displayedActiveThreadId =
@@ -177,6 +181,7 @@ function AssetsChatsSection() {
 
   function openThread(threadId: string, options?: { isNew?: boolean }) {
     switchThread(threadId);
+    persistActiveThreadId(threadId);
     navigateWithAgentChatViewTransition(
       navigate,
       options?.isNew ? "/" : chatThreadPath(threadId),
@@ -236,63 +241,50 @@ function AssetsChatsSection() {
 
   return (
     <div className="mt-2 border-s border-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-muted-foreground">
-          {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-muted-foreground transition-colors hover:bg-sidebar-accent hover:text-sidebar-accent-foreground"
-              aria-label={t("chat.newAssetsChat")}
-            >
-              <IconPlus className="size-3.5" />
-            </button>
-          </TooltipTrigger>
-          <TooltipContent side="right">{t("chat.newChat")}</TooltipContent>
-        </Tooltip>
-      </div>
-      {visibleThreads.length > 0 && (
-        <ChatHistoryList
-          items={chatItems}
-          activeId={displayedActiveThreadId}
-          onSelect={openThread}
-          onTogglePin={(threadId) => {
-            const thread = visibleThreads.find((item) => item.id === threadId);
-            if (thread) void pinThread(threadId, !thread.pinnedAt);
-          }}
-          onRename={handleRenameThread}
-          renameMaxLength={160}
-          onDelete={(threadId) => void handleArchiveThread(threadId)}
-          renderAdditionalRowActions={(item, closeMenu) => (
-            <button
-              type="button"
-              role="menuitem"
-              className="an-chat-history-row__menu-item"
-              onClick={() => {
-                closeMenu();
-                void handleCopyShareLink(item.id);
-              }}
-            >
-              <IconShare3 size={13} strokeWidth={1.8} />
-              <span>{t("chat.copyShareLink")}</span>
-            </button>
-          )}
-          labels={{
-            options: (item) =>
-              t("chat.optionsFor", { title: item.titleText ?? "" }),
-            renameInput: (item) => `Rename ${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={openThread}
+        onNewChat={() => void handleNewChat()}
+        railLabels={{
+          newChat: t("chat.newChat"),
+          showMore: t("chat.chats"),
+          showLess: t("chat.chats"),
+        }}
+        previewCount={5}
+        expandedCount={15}
+        onTogglePin={(threadId) => {
+          const thread = visibleThreads.find((item) => item.id === threadId);
+          if (thread) void pinThread(threadId, !thread.pinnedAt);
+        }}
+        onRename={handleRenameThread}
+        renameMaxLength={160}
+        onDelete={(threadId) => void handleArchiveThread(threadId)}
+        renderAdditionalRowActions={(item, closeMenu) => (
+          <button
+            type="button"
+            role="menuitem"
+            className="an-chat-history-row__menu-item"
+            onClick={() => {
+              closeMenu();
+              void handleCopyShareLink(item.id);
+            }}
+          >
+            <IconShare3 size={13} strokeWidth={1.8} />
+            <span>{t("chat.copyShareLink")}</span>
+          </button>
+        )}
+        labels={{
+          options: (item) =>
+            t("chat.optionsFor", { title: item.titleText ?? "" }),
+          renameInput: (item) => `Rename ${item.titleText ?? ""}`,
+          rename: t("chat.renameChat"),
+          pin: t("chat.pinChat"),
+          unpin: t("chat.unpinChat"),
+          delete: t("chat.archiveChat"),
+        }}
+        className="min-w-0"
+      />
     </div>
   );
 }
@@ -466,7 +458,7 @@ export function Sidebar() {
               <OrgSwitcher />
             </div>
 
-            <div className="px-3 py-2">
+            <div className="px-3 py-2 empty:hidden">
               <DevDatabaseLink />
               <FeedbackButton />
             </div>

package/corpus/templates/assets/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 { getBrowserTabId } from "@agent-native/core/client/hooks";
 import { useAgentRouteState } from "@agent-native/core/client/navigation";
 import { useLocation } from "react-router";
@@ -204,8 +201,7 @@ export function useNavigationState() {
     onNavigate: (_command, path) => {
       if (
         isCreatePath(location.pathname) &&
-        !isCreatePath(pathnameFromPath(path)) &&
-        isAgentChatHomeHandoffActive(ASSETS_CHAT_STORAGE_KEY)
+        !isCreatePath(pathnameFromPath(path))
       ) {
         markAgentChatHomeHandoff(ASSETS_CHAT_STORAGE_KEY);
       }

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

@@ -59,6 +59,13 @@ export default function CreatePage() {
   const { threadId } = useParams();
   const navigate = useNavigate();
   const t = useT();
+  const threadUrlSync = threadId
+    ? {
+        routeThreadId: threadId,
+        getPath: chatThreadPath,
+        navigate,
+      }
+    : undefined;
   const imageModelMenu = useImageModelMenu();
 
   useEffect(() => {
@@ -82,11 +89,7 @@ export default function CreatePage() {
         className="assets-create-chat-panel"
         defaultMode="chat"
         storageKey={ASSETS_CHAT_STORAGE_KEY}
-        threadUrlSync={{
-          routeThreadId: threadId ?? null,
-          getPath: chatThreadPath,
-          navigate,
-        }}
+        threadUrlSync={threadUrlSync}
         browserTabId={getBrowserTabId()}
         threadFooterSlot={({ threadId }) => (
           <GenerationResults threadId={threadId} />

package/corpus/templates/assets/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/assets/changelog/2026-07-22-recent-chats-expand-from-a-compact-list.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/brain/.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/brain/.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/brain/actions/rotate-source-ingest-token.ts

@@ -0,0 +1,77 @@
+import { defineAction } from "@agent-native/core";
+import { assertAccess } from "@agent-native/core/sharing";
+import { eq } from "drizzle-orm";
+import { z } from "zod";
+
+import { getDb, schema } from "../server/db/index.js";
+import {
+  nanoid,
+  nowIso,
+  parseJson,
+  serializeSource,
+  sha256Hex,
+  stableJson,
+} from "../server/lib/brain.js";
+
+function sourceKeyFor(source: {
+  sourceKey?: string | null;
+  configJson?: string | null;
+}) {
+  const columnValue = source.sourceKey?.trim();
+  if (columnValue) return columnValue;
+  const config = parseJson<Record<string, unknown>>(source.configJson, {});
+  const configValue = config.sourceKey;
+  return typeof configValue === "string" && configValue.trim()
+    ? configValue.trim()
+    : null;
+}
+
+export default defineAction({
+  description:
+    "Rotate the signed ingest token for a configured Clips or generic Brain source. The new token is returned once so it can be saved in the sending app.",
+  agentTool: false,
+  toolCallable: false,
+  schema: z.object({
+    sourceId: z.string().min(1),
+  }),
+  run: async ({ sourceId }) => {
+    const access = await assertAccess("brain-source", sourceId, "admin");
+    const existing = access.resource;
+    if (existing.provider !== "clips" && existing.provider !== "generic") {
+      throw new Error(
+        "Only configured Clips or generic sources can rotate an ingest token.",
+      );
+    }
+
+    const sourceKey = sourceKeyFor(existing);
+    if (!sourceKey) {
+      throw new Error("This source is missing a signed-ingest source key.");
+    }
+
+    const ingestToken = `brain_${nanoid(32)}`;
+    const ingestTokenHash = await sha256Hex(ingestToken);
+    const config = {
+      ...parseJson<Record<string, unknown>>(existing.configJson, {}),
+      sourceKey,
+      ingestTokenHash,
+    };
+    const db = getDb();
+    await db
+      .update(schema.brainSources)
+      .set({
+        sourceKey,
+        ingestTokenHash,
+        configJson: stableJson(config),
+        updatedAt: nowIso(),
+      })
+      .where(eq(schema.brainSources.id, sourceId));
+    const [source] = await db
+      .select()
+      .from(schema.brainSources)
+      .where(eq(schema.brainSources.id, sourceId))
+      .limit(1);
+    if (!source) throw new Error(`Brain source ${sourceId} was not found`);
+
+    return { source: serializeSource(source), ingestToken };
+  },
+});

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

@@ -44,7 +44,11 @@ export function Layout({ children }: { children: React.ReactNode }) {
     activePath: location.pathname,
     enabled: !isAskRoute,
   });
-  useAgentChatHomeHandoffLinks({ storageKey: "brain", chatPath: "/" });
+  useAgentChatHomeHandoffLinks({
+    storageKey: "brain",
+    chatPath: "/",
+    requireActiveHandoff: false,
+  });
 
   useEffect(() => {
     setMobileSidebarOpen(false);

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

@@ -10,13 +10,12 @@ 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 {
   IconLayoutSidebarLeftCollapse,
   IconLayoutSidebarLeftExpand,
-  IconPlus,
 } from "@tabler/icons-react";
 import { useEffect, useMemo } from "react";
 import { Link, NavLink, useLocation, useNavigate } from "react-router";
@@ -102,8 +101,7 @@ function BrainChatsSection() {
     () =>
       threads
         .filter((thread) => thread.messageCount > 0 && !thread.archivedAt)
-        .sort(compareThreads)
-        .slice(0, 8),
+        .sort(compareThreads),
     [threads],
   );
   const chatItems = useMemo<ChatHistoryItem[]>(
@@ -178,50 +176,37 @@ function BrainChatsSection() {
 
   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.newBrainChat")}
-            >
-              <IconPlus className="size-3.5" />
-            </button>
-          </TooltipTrigger>
-          <TooltipContent>{t("chat.newChat")}</TooltipContent>
-        </Tooltip>
-      </div>
-      {visibleThreads.length > 0 && (
-        <ChatHistoryList
-          items={chatItems}
-          activeId={activeThreadId}
-          onSelect={openThread}
-          onTogglePin={(threadId) => {
-            const thread = visibleThreads.find((item) => item.id === threadId);
-            if (thread) void pinThread(threadId, !thread.pinnedAt);
-          }}
-          onRename={handleRenameThread}
-          renameMaxLength={160}
-          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={activeThreadId}
+        onSelect={openThread}
+        onNewChat={() => void handleNewChat()}
+        railLabels={{
+          newChat: t("chat.newChat"),
+          showMore: t("chat.chats"),
+          showLess: t("chat.chats"),
+        }}
+        previewCount={5}
+        expandedCount={15}
+        onTogglePin={(threadId) => {
+          const thread = visibleThreads.find((item) => item.id === threadId);
+          if (thread) void pinThread(threadId, !thread.pinnedAt);
+        }}
+        onRename={handleRenameThread}
+        renameMaxLength={160}
+        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>
   );
 }
@@ -312,7 +297,6 @@ export function Sidebar({
             </p>
           </div>
         </Link>
-        {!collapsed ? collapseButton : null}
       </div>
 
       <nav
@@ -394,11 +378,14 @@ export function Sidebar({
         {!collapsed ? (
           <div className="px-3 py-2">
             <DevDatabaseLink />
-            <FeedbackButton />
+            <div className="flex items-center justify-end gap-1">
+              <FeedbackButton className="min-w-0 flex-1" side="right" />
+              {collapseButton}
+            </div>
           </div>
         ) : null}
 
-        {collapseButton ? (
+        {collapsed && collapseButton ? (
           <div className="flex justify-center px-2 py-2">{collapseButton}</div>
         ) : null}
       </div>

package/corpus/templates/brain/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";
@@ -109,11 +106,7 @@ export function useNavigationState() {
       return `${path}${params.size ? `?${params.toString()}` : ""}`;
     },
     onNavigate: (_command, path) => {
-      if (
-        location.pathname === "/" &&
-        pathnameFromPath(path) !== "/" &&
-        isAgentChatHomeHandoffActive("brain")
-      ) {
+      if (location.pathname === "/" && pathnameFromPath(path) !== "/") {
         markAgentChatHomeHandoff("brain");
       }
     },