feat(channels): add "Recent tasks" nav option

packages/shared/src/analytics-events.ts

@@ -789,6 +789,7 @@ export type ChannelsSurface =
   | "channel_history"
   | "channel_artifacts"
   | "channel_inbox"
+  | "recent_tasks"
   | "pinned"
   | "dashboards_grid"
   | "canvas"
@@ -814,6 +815,7 @@ export type ChannelActionType =
   | "view_history"
   | "view_artifacts"
   | "view_inbox"
+  | "view_recent_tasks"
   | "open_artifact"
   | "file_task"
   | "unfile_task"

packages/shared/src/browser-tabs-schemas.ts

@@ -25,6 +25,13 @@ export const browserTabSchema = z.object({
    * blank). Pairs with `channelId`: the two together identify a channel tab.
    */
   channelSection: z.string().nullable().default(null),
+  /**
+   * Standalone Channels-space route this tab fronts when it isn't a canvas,
+   * task, or channel — e.g. `/website/recent-tasks`. Null for every id-backed
+   * tab and for a blank tab. Lets a route-only view be a first-class tab
+   * (labelled, deduped, restored) without a channel/task/canvas reference.
+   */
+  routeId: z.string().nullable().default(null),
   /** Gap-spaced ordering key within a window. Reindexed on collision. */
   position: z.number(),
   /**

packages/shared/src/browser-tabs.test.ts

@@ -106,6 +106,31 @@ describe("openOrFocusTab", () => {
     expect(inboxAgain.tabId).toBe(inbox.tabId);
   });
 
+  it("dedups a route-only tab (e.g. recent tasks) within a window", () => {
+    const first = openOrFocusTab(snapshot(), {
+      windowId: "w1",
+      dashboardId: null,
+      taskId: null,
+      channelId: null,
+      routeId: "/website/recent-tasks",
+      makeId,
+      now,
+    });
+    expect(first.opened).toBe(true);
+    const again = openOrFocusTab(first.snapshot, {
+      windowId: "w1",
+      dashboardId: null,
+      taskId: null,
+      channelId: null,
+      routeId: "/website/recent-tasks",
+      makeId,
+      now,
+    });
+    expect(again.opened).toBe(false);
+    expect(again.tabId).toBe(first.tabId);
+    expect(again.snapshot.tabs).toHaveLength(1);
+  });
+
   it("appends new tabs after existing ones", () => {
     const a = open(snapshot(), "w1", "dash-a");
     const b = open(a.snapshot, "w1", "dash-b");
@@ -174,6 +199,7 @@ describe("reorderTab", () => {
         taskId: null,
         channelId: null,
         channelSection: null,
+        routeId: null,
         position: 1,
         scrollState: null,
         createdAt: 0,
@@ -186,6 +212,7 @@ describe("reorderTab", () => {
         taskId: null,
         channelId: null,
         channelSection: null,
+        routeId: null,
         position: 2,
         scrollState: null,
         createdAt: 0,
@@ -319,6 +346,7 @@ describe("decideTabNavigation", () => {
       taskId: null,
       channelId: "c1",
       channelSection: null,
+      routeId: null,
       stampTabId: "tab-a",
     });
   });
@@ -342,6 +370,7 @@ describe("decideTabNavigation", () => {
       taskId: null,
       channelId: "c1",
       channelSection: null,
+      routeId: null,
       stampTabId: "tab-a",
     });
   });
@@ -359,6 +388,7 @@ describe("decideTabNavigation", () => {
       taskId: null,
       channelId: "c1",
       channelSection: null,
+      routeId: null,
       stampTabId: null,
     });
   });
@@ -386,6 +416,7 @@ describe("decideTabNavigation", () => {
       taskId: null,
       channelId: "c1",
       channelSection: "artifacts",
+      routeId: null,
       stampTabId: "tab-a",
     });
   });
@@ -403,6 +434,7 @@ describe("decideTabNavigation", () => {
       taskId: null,
       channelId: "c1",
       channelSection: "inbox",
+      routeId: null,
       stampTabId: null,
     });
   });
@@ -446,6 +478,59 @@ describe("decideTabNavigation", () => {
       }),
     ).toEqual({ type: "noop" });
   });
+
+  it("opens a route-only tab (e.g. recent tasks) when there is no active tab", () => {
+    expect(
+      decideTabNavigation({
+        ...base,
+        routeRouteId: "/website/recent-tasks",
+      }),
+    ).toEqual({
+      type: "open",
+      dashboardId: null,
+      taskId: null,
+      channelId: null,
+      channelSection: null,
+      routeId: "/website/recent-tasks",
+      stampTabId: null,
+    });
+  });
+
+  it("replaces the active tab when navigating to a route-only view", () => {
+    expect(
+      decideTabNavigation({
+        ...base,
+        serverActiveTabId: "tab-a",
+        activeTab: { id: "tab-a", dashboardId: "d1", taskId: null },
+        routeRouteId: "/website/recent-tasks",
+      }),
+    ).toEqual({
+      type: "replace",
+      tabId: "tab-a",
+      dashboardId: null,
+      taskId: null,
+      channelId: null,
+      channelSection: null,
+      routeId: "/website/recent-tasks",
+      stampTabId: "tab-a",
+    });
+  });
+
+  it("only stamps when the active tab already shows the route-only view", () => {
+    expect(
+      decideTabNavigation({
+        ...base,
+        serverActiveTabId: "tab-a",
+        activeTab: {
+          id: "tab-a",
+          dashboardId: null,
+          taskId: null,
+          routeId: "/website/recent-tasks",
+        },
+        routeRouteId: "/website/recent-tasks",
+      }),
+    ).toEqual({ type: "stamp", stampTabId: "tab-a" });
+  });
 });
 
 function openChannel(s: TabsSnapshot, windowId: string, channelId: string) {
@@ -475,6 +560,19 @@ describe("activeTabIsBlank", () => {
     expect(activeTabIsBlank(t.snapshot)).toBe(false);
   });
 
+  it("is false when the active tab is a route-only tab (recent tasks)", () => {
+    const t = openOrFocusTab(snapshot(), {
+      windowId: "w1",
+      dashboardId: null,
+      taskId: null,
+      channelId: null,
+      routeId: "/website/recent-tasks",
+      makeId,
+      now,
+    });
+    expect(activeTabIsBlank(t.snapshot)).toBe(false);
+  });
+
   it("is false when there is no active tab", () => {
     expect(activeTabIsBlank(snapshot())).toBe(false);
   });

packages/shared/src/browser-tabs.ts

@@ -44,7 +44,11 @@ export function activeTabIsBlank(snapshot: TabsSnapshot): boolean {
   if (!w?.activeTabId) return false;
   const t = snapshot.tabs.find((x) => x.id === w.activeTabId);
   return (
-    !!t && t.dashboardId == null && t.taskId == null && t.channelId == null
+    !!t &&
+    t.dashboardId == null &&
+    t.taskId == null &&
+    t.channelId == null &&
+    t.routeId == null
   );
 }
 
@@ -89,14 +93,17 @@ export type TabIdentity = {
   taskId: string | null;
   channelId: string | null;
   channelSection: string | null;
+  /** A standalone route (e.g. recent tasks) when the tab has no id target. */
+  routeId: string | null;
 };
 
 function sameIdentity(a: TabIdentity, b: TabIdentity): boolean {
   return (
     a.dashboardId === b.dashboardId &&
     a.taskId === b.taskId &&
     a.channelId === b.channelId &&
-    a.channelSection === b.channelSection
+    a.channelSection === b.channelSection &&
+    a.routeId === b.routeId
   );
 }
 
@@ -111,16 +118,24 @@ export function openOrFocusTab(
     windowId: string;
     channelId: string | null;
     channelSection?: string | null;
+    routeId?: string | null;
     makeId: IdFactory;
     now: Clock;
   },
 ): OpenTabResult {
   const { windowId, dashboardId, taskId, channelId, makeId, now } = input;
   const channelSection = input.channelSection ?? null;
+  const routeId = input.routeId ?? null;
   const existing = snapshot.tabs.find(
     (t) =>
       t.windowId === windowId &&
-      sameIdentity(t, { dashboardId, taskId, channelId, channelSection }),
+      sameIdentity(t, {
+        dashboardId,
+        taskId,
+        channelId,
+        channelSection,
+        routeId,
+      }),
   );
   if (existing) {
     const ts = now();
@@ -143,6 +158,7 @@ export function openOrFocusTab(
     taskId,
     channelId,
     channelSection,
+    routeId,
     makeId,
     now,
   });
@@ -154,6 +170,7 @@ function appendTab(
     windowId: string;
     channelId: string | null;
     channelSection?: string | null;
+    routeId?: string | null;
     makeId: IdFactory;
     now: Clock;
   },
@@ -169,6 +186,7 @@ function appendTab(
     taskId,
     channelId,
     channelSection: input.channelSection ?? null,
+    routeId: input.routeId ?? null,
     position: lastPos + POSITION_GAP,
     scrollState: null,
     createdAt: ts,
@@ -212,6 +230,7 @@ export function setTabTarget(
     tabId: string;
     channelId: string | null;
     channelSection?: string | null;
+    routeId?: string | null;
     now: Clock;
   },
 ): TabsSnapshot {
@@ -228,6 +247,7 @@ export function setTabTarget(
             taskId: input.taskId,
             channelId: input.channelId,
             channelSection: input.channelSection ?? null,
+            routeId: input.routeId ?? null,
             lastActiveAt: ts,
           }
         : t,
@@ -348,6 +368,7 @@ export type TabNavDecision =
       taskId: string | null;
       channelId: string | null;
       channelSection: string | null;
+      routeId: string | null;
       stampTabId: string | null;
     }
   | {
@@ -356,6 +377,7 @@ export type TabNavDecision =
       taskId: string | null;
       channelId: string | null;
       channelSection: string | null;
+      routeId: string | null;
       stampTabId: string | null;
     }
   | { type: "stamp"; stampTabId: string }
@@ -373,6 +395,7 @@ export function decideTabNavigation(input: {
     taskId: string | null;
     channelId?: string | null;
     channelSection?: string | null;
+    routeId?: string | null;
   } | null;
   /** Canvas in the current route, if any. */
   routeDashboardId: string | null;
@@ -381,6 +404,8 @@ export function decideTabNavigation(input: {
   routeChannelId: string | null;
   /** Channel sub-section in the current route, if any. */
   routeChannelSection?: string | null;
+  /** Standalone Channels-space route (e.g. recent tasks) with no id target. */
+  routeRouteId?: string | null;
 }): TabNavDecision {
   const {
     historyTabId,
@@ -391,6 +416,7 @@ export function decideTabNavigation(input: {
     routeChannelId,
   } = input;
   const routeChannelSection = input.routeChannelSection ?? null;
+  const routeRouteId = input.routeRouteId ?? null;
 
   // Tagged entry for a DIFFERENT tab → a tab switch or a back/forward replay.
   // Focus it (this is how "back returns to the previous tab" resolves). When
@@ -409,8 +435,9 @@ export function decideTabNavigation(input: {
     taskId: routeTaskId,
     channelId: routeChannelId,
     channelSection: routeChannelSection,
+    routeId: routeRouteId,
   };
-  if (!routeDashboardId && !routeTaskId && !routeChannelId) {
+  if (!routeDashboardId && !routeTaskId && !routeChannelId && !routeRouteId) {
     return { type: "noop" };
   }
 
@@ -422,6 +449,7 @@ export function decideTabNavigation(input: {
         taskId: activeTab.taskId,
         channelId: activeTab.channelId ?? null,
         channelSection: activeTab.channelSection ?? null,
+        routeId: activeTab.routeId ?? null,
       },
       routeIdentity,
     )
@@ -433,6 +461,7 @@ export function decideTabNavigation(input: {
       taskId: routeTaskId,
       channelId: routeChannelId,
       channelSection: routeChannelSection,
+      routeId: routeRouteId,
       stampTabId: serverActiveTabId,
     };
   }
@@ -443,6 +472,7 @@ export function decideTabNavigation(input: {
       taskId: routeTaskId,
       channelId: routeChannelId,
       channelSection: routeChannelSection,
+      routeId: routeRouteId,
       stampTabId: serverActiveTabId,
     };
   }