@agent-native/core 0.115.4 → 0.117.0

package/corpus/templates/forms/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 } from "@agent-native/core/client/api-path";
 import { useAgentRouteState } from "@agent-native/core/client/navigation";
 import { useLocation } from "react-router";
@@ -132,11 +129,7 @@ export function useNavigationState() {
     navigateOptions: { flushSync: true, replace: true },
     onNavigate: (_command, path) => {
       void prewarmFormsRoutePath(path);
-      if (
-        location.pathname === "/ask" &&
-        path !== "/ask" &&
-        isAgentChatHomeHandoffActive("forms")
-      ) {
+      if (location.pathname === "/ask" && path !== "/ask") {
         markAgentChatHomeHandoff("forms");
       }
     },

package/corpus/templates/forms/app/root.tsx

@@ -1,5 +1,4 @@
 import {
-  isAgentChatHomeHandoffActive,
   markAgentChatHomeHandoff,
   navigateWithAgentChatViewTransition,
 } from "@agent-native/core/client/agent-chat";
@@ -203,11 +202,7 @@ function OpenLinkInterceptor() {
       if (!path) return;
 
       event.preventDefault();
-      if (
-        location.pathname === "/ask" &&
-        path !== "/ask" &&
-        isAgentChatHomeHandoffActive("forms")
-      ) {
+      if (location.pathname === "/ask" && path !== "/ask") {
         markAgentChatHomeHandoff("forms");
       }
       navigateWithAgentChatViewTransition(navigate, path);

package/corpus/templates/forms/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/macros/.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/mail/.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/mail/.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/mail/app/components/layout/AppLayout.tsx

@@ -1748,7 +1748,7 @@ function AppLayoutInner({ children }: AppLayoutProps) {
                       <OrgSwitcher />
                     </div>
 
-                    <div className="flex items-center gap-1 px-2 py-2">
+                    <div className="flex items-center justify-end gap-1 px-2 py-2">
                       <DevDatabaseLink />
                       <FeedbackButton className="min-w-0 flex-1" />
                       <Tooltip>
@@ -2120,7 +2120,7 @@ function StandardLayout({ children }: AppLayoutProps) {
               <OrgSwitcher />
             </div>
 
-            <div className="flex items-center gap-1 px-2 py-2">
+            <div className="flex items-center justify-end gap-1 px-2 py-2">
               <DevDatabaseLink />
               <FeedbackButton className="min-w-0 flex-1" />
               <div className="flex shrink-0 items-center gap-0.5">

package/corpus/templates/plan/.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/plan/.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/plan/app/components/layout/Layout.tsx

@@ -92,7 +92,11 @@ export function Layout({ children }: LayoutProps) {
     activePath: location.pathname,
     enabled: !chatRoute,
   });
-  useAgentChatHomeHandoffLinks({ storageKey: "plans", chatPath: "/" });
+  useAgentChatHomeHandoffLinks({
+    storageKey: "plans",
+    chatPath: "/",
+    requireActiveHandoff: false,
+  });
   const hideAppNavigation = planDetailRoute && planReaderImmersive;
   const effectiveSidebarCollapsed = chatRoute
     ? chatSidebarCollapsed

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

@@ -1,5 +1,4 @@
 import {
-  isAgentChatHomeHandoffActive,
   markAgentChatHomeHandoff,
   navigateWithAgentChatViewTransition,
   sendToAgentChat,
@@ -17,7 +16,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 {
@@ -168,7 +167,7 @@ function PlanChatsSection({ collapsed }: { collapsed: boolean }) {
       threads
         .filter((thread) => thread.messageCount > 0 && !thread.archivedAt)
         .sort(compareThreads)
-        .slice(0, 8),
+        .slice(0, 15),
     [threads],
   );
   const chatItems = useMemo<ChatHistoryItem[]>(
@@ -245,50 +244,34 @@ function PlanChatsSection({ collapsed }: { collapsed: boolean }) {
 
   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("sidebar.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("sidebar.newPlanChat")}
-            >
-              <IconPlus className="size-3.5" />
-            </button>
-          </TooltipTrigger>
-          <TooltipContent>{t("sidebar.newChat")}</TooltipContent>
-        </Tooltip>
-      </div>
-
-      {visibleThreads.length > 0 && (
-        <ChatHistoryList
-          items={chatItems}
-          activeId={activeThreadId}
-          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("sidebar.chats")}: ${item.titleText ?? ""}`,
-            renameInput: (item) =>
-              `${t("sidebar.renameChat")}: ${item.titleText ?? ""}`,
-            rename: t("sidebar.renameChat"),
-            pin: t("sidebar.pinChat"),
-            unpin: t("sidebar.unpinChat"),
-            delete: t("sidebar.archiveChat"),
-          }}
-          variant="rail"
-          className="min-w-0"
-        />
-      )}
+      <ChatHistoryRail
+        items={chatItems}
+        activeId={activeThreadId}
+        onSelect={(threadId) => openThread(threadId)}
+        onNewChat={() => void handleNewChat()}
+        railLabels={{
+          newChat: t("sidebar.newChat"),
+          showMore: t("sidebar.chats"),
+          showLess: t("sidebar.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("sidebar.chats")}: ${item.titleText ?? ""}`,
+          renameInput: (item) =>
+            `${t("sidebar.renameChat")}: ${item.titleText ?? ""}`,
+          rename: t("sidebar.renameChat"),
+          pin: t("sidebar.pinChat"),
+          unpin: t("sidebar.unpinChat"),
+          delete: t("sidebar.archiveChat"),
+        }}
+        className="min-w-0"
+      />
     </div>
   );
 }
@@ -333,7 +316,7 @@ function PlansSidebarSection({ collapsed }: { collapsed: boolean }) {
       signInForPlanCreate();
       return;
     }
-    if (location.pathname === "/" && isAgentChatHomeHandoffActive("plans")) {
+    if (location.pathname === "/") {
       markAgentChatHomeHandoff("plans");
     }
     navigateWithAgentChatViewTransition(navigate, "/plans?create=1");
@@ -341,7 +324,7 @@ function PlansSidebarSection({ collapsed }: { collapsed: boolean }) {
 
   const openPlanPath = (event: MouseEvent<HTMLAnchorElement>, path: string) => {
     event.preventDefault();
-    if (location.pathname === "/" && isAgentChatHomeHandoffActive("plans")) {
+    if (location.pathname === "/") {
       markAgentChatHomeHandoff("plans");
     }
     navigateWithAgentChatViewTransition(navigate, path);
@@ -633,11 +616,7 @@ export function Sidebar({
             <Link
               to={item.href}
               onClick={() => {
-                if (
-                  item.href !== "/" &&
-                  location.pathname === "/" &&
-                  isAgentChatHomeHandoffActive("plans")
-                ) {
+                if (item.href !== "/" && location.pathname === "/") {
                   markAgentChatHomeHandoff("plans");
                 }
               }}
@@ -671,7 +650,7 @@ export function Sidebar({
         })}
       </nav>
 
-      {!collapsed && session && (
+      {!collapsed && session ? (
         <>
           <div className="px-2 py-2">
             <ExtensionsSidebarSection />
@@ -679,30 +658,33 @@ export function Sidebar({
 
           <div className="space-y-2 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>
             <OrgSwitcher />
           </div>
         </>
-      )}
+      ) : null}
 
-      {!collapsed && !sessionLoading && !session && (
+      {!collapsed && !sessionLoading && !session ? (
         <div className="space-y-2 px-3 py-2">
           <DevDatabaseLink />
-          <FeedbackButton />
-          <div className="flex items-center justify-between gap-2">
-            <Button
-              type="button"
-              size="sm"
-              variant="outline"
-              className="h-8 px-3 text-xs"
-              onClick={() => signInWithReturnPath(returnPath)}
-            >
-              {t("sidebar.signIn")}
-            </Button>
+          <div className="flex items-center justify-end gap-1">
+            <FeedbackButton className="min-w-0 flex-1" side="right" />
             {collapseButton}
           </div>
+          <Button
+            type="button"
+            size="sm"
+            variant="outline"
+            className="h-8 px-3 text-xs"
+            onClick={() => signInWithReturnPath(returnPath)}
+          >
+            {t("sidebar.signIn")}
+          </Button>
         </div>
-      )}
+      ) : null}
 
       {collapsed && collapsible ? (
         <div
@@ -715,8 +697,11 @@ export function Sidebar({
         </div>
       ) : null}
 
-      {!collapsed && (session || sessionLoading) && collapsible ? (
-        <div className="flex justify-end px-2 py-2">{collapseButton}</div>
+      {!collapsed && sessionLoading && collapsible ? (
+        <div className="flex items-center justify-end gap-1 px-3 py-2">
+          <FeedbackButton className="min-w-0 flex-1" side="right" />
+          {collapseButton}
+        </div>
       ) : null}
     </aside>
   );

package/corpus/templates/plan/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 {
   agentNativePath,
   appBasePath,
@@ -111,11 +108,7 @@ export function useNavigationState() {
     deleteCommand();
     const path = planNavigateCommandPath(cmd);
     void prewarmPlanRoutePath(path);
-    if (
-      location.pathname === "/" &&
-      path !== "/" &&
-      isAgentChatHomeHandoffActive("plans")
-    ) {
+    if (location.pathname === "/" && path !== "/") {
       markAgentChatHomeHandoff("plans");
     }
     const commitNavigation = () =>

package/corpus/templates/plan/app/lib/create-plan-routing.ts

@@ -26,13 +26,13 @@ export function isProbablyImportedPlan(prompt: string) {
 
 export function assessPlanPrompt(prompt: string): { kind: AutoPlanKind } {
   const highFidelity =
-    /\b(high(?:er)?[- ]fidelity|full[- ]fidelity|hi[- ]fi|polished(?: mockups?)?|production[- ](?:like|ready)|pixel[- ](?:perfect|accurate)|brand(?:ed|[- ]aware)|real design|not (?:a )?(?:sketch(?:y)?|wireframe)|beyond (?:the )?(?:sketch|wireframe))\b/i.test(
+    /\b(high(?:er)?[- ]fidelity|full[- ]fidelity|hi[- ]fi|polished mockups?|production[- ](?:like|ready)|pixel[- ](?:perfect|accurate)|brand(?:ed|[- ]aware)|real design|not (?:a )?(?:sketch(?:y)?|wireframe)|beyond (?:the )?(?:sketch|wireframe))\b/i.test(
       prompt,
     );
   if (highFidelity) return { kind: "design" };
 
   const uiDirection =
-    /\b(ui|screen|screens|layout|wireframe|mockup|form factor|mobile|desktop|responsive|nav|sidebar|flow|redesign|empty state|loading state|error state)\b/i.test(
+    /\b(ui|screen|screens|layout|wireframes?|mockups?|form factor|mobile|desktop|responsive|nav|sidebar|flow|redesign|empty state|loading state|error state)\b/i.test(
       prompt,
     );
   return { kind: uiDirection ? "ui" : "visual" };

package/corpus/templates/plan/app/pages/PlanChatPage.tsx

@@ -30,7 +30,6 @@ export function PlanChatPage() {
       contentClassName="max-w-5xl"
       surfaceClassName="border-0 bg-transparent shadow-none"
       storageKey="plans"
-      restoreActiveThread={false}
       showHeader={false}
       showTabBar={false}
       dynamicSuggestions={false}

package/corpus/templates/plan/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/plan/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/plan/changelog/2026-07-22-recent-chats-and-sidebar-controls-are-more-compact.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/plan/server/plugins/collab.ts

@@ -20,8 +20,11 @@ export default createCollabPlugin({
   // Per-block collab has no single content column to sync; the block markdown is
   // persisted via the `update-rich-text` patch path, not by the collab plugin.
   autoSeed: false,
-  resourceType: "plan",
-  resolveResourceId: (docId) => resolvePlanIdFromCollabDocId(docId),
+  access: {
+    mode: "resource",
+    resourceType: "plan",
+    resolveResourceId: (docId) => resolvePlanIdFromCollabDocId(docId),
+  },
 });
 
 /**

package/corpus/templates/slides/.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/slides/app/components/layout/Sidebar.tsx

@@ -164,7 +164,7 @@ export function Sidebar({ collapsed, onToggleCollapsed }: SidebarProps) {
             <OrgSwitcher />
           </div>
 
-          <div className="px-3 py-2">
+          <div className="px-3 py-2 empty:hidden">
             <DevDatabaseLink />
             <FeedbackButton />
           </div>

package/corpus/templates/slides/server/plugins/collab.ts

@@ -4,13 +4,16 @@ export default createCollabPlugin({
   table: "decks",
   contentColumn: "data",
   idColumn: "id",
-  resourceType: "deck",
-  resolveResourceId: (docId) => {
-    if (!docId.startsWith("deck-")) return docId;
-    const withoutPrefix = docId.slice("deck-".length);
-    const slideMarker = withoutPrefix.lastIndexOf("-slide-");
-    return slideMarker >= 0
-      ? withoutPrefix.slice(0, slideMarker)
-      : withoutPrefix;
+  access: {
+    mode: "resource",
+    resourceType: "deck",
+    resolveResourceId: (docId) => {
+      if (!docId.startsWith("deck-")) return docId;
+      const withoutPrefix = docId.slice("deck-".length);
+      const slideMarker = withoutPrefix.lastIndexOf("-slide-");
+      return slideMarker >= 0
+        ? withoutPrefix.slice(0, slideMarker)
+        : withoutPrefix;
+    },
   },
 });

package/corpus/templates/tasks/.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/tasks/.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/tasks/app/components/layout/Sidebar.tsx

@@ -188,30 +188,13 @@ export function Sidebar({
           />
         </div>
 
-        <div
-          className={cn(
-            collapsed
-              ? "flex justify-center px-1 py-1"
-              : "border-t border-sidebar-border 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 border-t border-sidebar-border px-3 py-2",
-            )}
-          >
+        {!collapsed ? (
+          <div className="flex items-center justify-end gap-1 border-t border-sidebar-border 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/tasks/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/toolkit/CHANGELOG.md

@@ -1,5 +1,12 @@
 # @agent-native/toolkit
 
+## 0.9.1
+
+### Patch Changes
+
+- 03a043e: Make realtime voice the clear primary microphone action, remember the selected input mode, improve speech waveform responsiveness, and show a shine while the voice agent is working.
+- 03a043e: Prevent reasoning messages from losing their assistant UI provider, and add a progressively disclosed recent-chat rail for app sidebars.
+
 ## 0.9.0
 
 ### Minor Changes

package/corpus/toolkit/README.md

@@ -25,7 +25,10 @@ and docs. Dispatch is a separate product rather than a Toolkit module.
 
 ```tsx
 import { ToolkitProvider } from "@agent-native/toolkit/provider";
-import { ChatHistoryList } from "@agent-native/toolkit/chat-history";
+import {
+  ChatHistoryList,
+  ChatHistoryRail,
+} from "@agent-native/toolkit/chat-history";
 import { PresenceBar } from "@agent-native/toolkit/collab-ui";
 import { ContextMeterView } from "@agent-native/toolkit/context-ui";
 import {
@@ -47,8 +50,14 @@ import { useSetHeaderActions } from "@agent-native/toolkit/app-shell";
 
 Import `@agent-native/toolkit/styles.css` after Tailwind to include Toolkit's
 source scanning. If an app renders `SharedRichEditor`, also import
-`@agent-native/toolkit/editor.css`. If an app renders `ChatHistoryList`, also
-import `@agent-native/toolkit/chat-history.css`.
+`@agent-native/toolkit/editor.css`. If an app renders `ChatHistoryList` or
+`ChatHistoryRail`, also import `@agent-native/toolkit/chat-history.css`.
+
+Use `ChatHistoryRail` for app sidebars. It shows five recent chats by default,
+progressively discloses up to fifteen, and keeps the app-provided New chat
+action in a footer row with the ellipsis disclosure on its right. The app
+continues to own thread persistence, sorting, routing, and mutations through
+Core.
 
 Inside template apps, prefer local adapters such as `@/components/ui/button` so
 apps can replace their primitives without changing every callsite.

package/corpus/toolkit/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-native/toolkit",
-  "version": "0.9.0",
+  "version": "0.9.1",
   "description": "Reusable app-building UI and helpers for Agent-Native apps.",
   "homepage": "https://github.com/BuilderIO/agent-native#readme",
   "bugs": {