feat(home): hold Needs your attention and Workspaces behind platform-preview

Needs your attention was hidden by a code constant, HOME_HIDDEN_SECTIONS,
and the Workspaces widget had been deleted. Both now wait for the design
pass behind the platform-preview flag instead: HomeView carries `attention`
and `workspaces` only while Home offers them, so the dashboard renders a
section, and Customize Home lists Workspaces, only when it is present.
useLiveHome reads neither section's data while the flag is off.

The widget is restored from 5b97c03^ with its activity read and key,
moved to the shared FailureNotice, and without the "…" detail it showed
while its activity loaded. Example data always shows both sections.

Author: emir-karabeg

apps/sim/app/(product)/_components/model.ts

@@ -5,7 +5,7 @@ import type { SettingsSearchEntry } from '@/platform/shared/settings-search'
 import type { ShellDestination, ShellItem, ShellQueryStatus } from '@/platform/shared/shell'
 
 export type HomeMode = 'Build' | 'Search'
-export type HomeWidget = 'Activity' | 'Email' | 'Calendar'
+export type HomeWidget = 'Activity' | 'Workspaces' | 'Email' | 'Calendar'
 
 export interface InboxItem extends ShellItem {
   description: string

apps/sim/app/(product)/o/[organizationId]/home/_components/fixture-home/fixture-home.tsx

@@ -3,6 +3,7 @@
 import { useState } from 'react'
 import type { RecentItem } from '@sim/emcn-platform/recent-items'
 import { useRouter, useSearchParams } from 'next/navigation'
+import type { ShellWorkspace } from '@/app/(product)/_components/model'
 import {
   useInterfacePreferences,
   useRecentHistory,
@@ -17,6 +18,7 @@ import type {
 import { surfaceHref } from '@/platform/lib/data/organization-model'
 import { platformHref } from '@/platform/lib/navigation'
 import { useSurfaceScope } from '@/platform/lib/surface-scope'
+import { workspaceHomePath } from '@/platform/lib/workspace-navigation'
 import type {
   HomeCalendarDay,
   HomeConnectOption,
@@ -71,10 +73,12 @@ function metricPoints(data: HomeData | null, field: 'tasks' | 'searches') {
 interface FixtureHomeProps {
   data: HomeData | null
   recentLinks: readonly RecentItem[]
+  /** The sidebar's example workspaces, which Home's Workspaces lists without claiming any activity. */
+  workspaces: readonly ShellWorkspace[]
 }
 
 /** The session implementation of Home's view: edits last as long as the product session. */
-export function FixtureHome({ data, recentLinks }: FixtureHomeProps) {
+export function FixtureHome({ data, recentLinks, workspaces }: FixtureHomeProps) {
   const router = useRouter()
   const search = useSearchParams()
   const scope = useSurfaceScope()
@@ -115,6 +119,14 @@ export function FixtureHome({ data, recentLinks }: FixtureHomeProps) {
           calendarForOffset(data, dayOffset)
         )
       : { status: 'not_connected', options: CONNECT_OPTIONS.Calendar },
+    workspaces: {
+      status: 'ready',
+      items: workspaces.map(({ id, name }) => ({
+        id,
+        name,
+        href: platformHref(workspaceHomePath(id, 'fixture'), search),
+      })),
+    },
     recents: { status: 'ready', items: recents },
     getStarted: [],
     composerInventory: data?.composerInventory,
@@ -127,6 +139,7 @@ export function FixtureHome({ data, recentLinks }: FixtureHomeProps) {
     returnToToday: () => setDayOffset(0),
     retryAttention: () => {},
     retryActivity: () => {},
+    retryWorkspaces: () => {},
     retryRecents: () => {},
     removeRecent,
   }

apps/sim/app/(product)/o/[organizationId]/home/_components/home-dashboard/home-dashboard.tsx

@@ -18,13 +18,13 @@ import {
 import { CalendarDay } from '@/app/(product)/o/[organizationId]/home/_components/calendar/calendar-day'
 import { ConnectedWidget } from '@/app/(product)/o/[organizationId]/home/_components/connected-widget/connected-widget'
 import styles from '@/app/(product)/o/[organizationId]/home/_components/home-dashboard/home-dashboard.module.css'
-import {
-  HOME_HIDDEN_SECTIONS,
-  type HomeActions,
-  type HomeView,
+import { HomeWorkspaces } from '@/app/(product)/o/[organizationId]/home/_components/home-workspaces/home-workspaces'
+import type {
+  HomeActions,
+  HomeView,
 } from '@/app/(product)/o/[organizationId]/home/_components/model'
 
-const WIDGETS: readonly HomeWidget[] = ['Activity', 'Email', 'Calendar']
+const WIDGETS: readonly HomeWidget[] = ['Activity', 'Workspaces', 'Email', 'Calendar']
 const ACTIVITY_METRIC_TITLES: Record<HomeMode, string> = { Build: 'Tasks run', Search: 'Searches' }
 
 interface HomeDashboardProps {
@@ -58,8 +58,12 @@ export function HomeDashboard({
   const metricTitle = ACTIVITY_METRIC_TITLES[mode]
   const activity = view.activity[mode]
   const widgetLabel = (widget: HomeWidget) => (widget === 'Activity' ? metricTitle : widget)
-  const customizable = WIDGETS.filter(
-    (widget) => widget !== 'Activity' || activity.status !== 'hidden'
+  const workspaces = view.workspaces
+  const noWorkspaces = workspaces?.status === 'ready' && workspaces.items.length === 0
+  const customizable = WIDGETS.filter((widget) =>
+    widget === 'Activity'
+      ? activity.status !== 'hidden'
+      : widget !== 'Workspaces' || (workspaces !== undefined && !noWorkspaces)
   )
   function setVisible(widget: HomeWidget, visible: boolean) {
     const id = `hide-${widget}`
@@ -143,6 +147,13 @@ export function HomeDashboard({
                     onRetry={actions.retryActivity}
                     hidden={hiddenWidgets.includes('Activity')}
                   />
+                  {workspaces && !hiddenWidgets.includes('Workspaces') && (
+                    <HomeWorkspaces
+                      state={workspaces}
+                      asOf={view.asOf}
+                      onRetry={actions.retryWorkspaces}
+                    />
+                  )}
                   {!hiddenWidgets.includes('Email') && (
                     <ConnectedWidget
                       title='Email'
@@ -157,7 +168,7 @@ export function HomeDashboard({
                   )}
                 </div>
                 <div className={styles.column}>
-                  {!HOME_HIDDEN_SECTIONS.has('Needs your attention') && (
+                  {view.attention && (
                     <AttentionList
                       state={view.attention}
                       asOf={view.asOf}

apps/sim/app/(product)/o/[organizationId]/home/_components/home-workspaces/home-workspaces.module.css

@@ -0,0 +1,18 @@
+.viewport {
+  display: grid;
+  grid-template-columns: minmax(0, 1fr);
+  grid-template-rows: minmax(0, 1fr) auto;
+  gap: var(--ui-list-gap);
+  min-block-size: 0;
+  margin-inline: calc(-1 * var(--ui-row-inset));
+}
+.entries {
+  display: grid;
+  gap: var(--ui-list-gap);
+  min-inline-size: 0;
+}
+/* The button's hit area sits on the rows' outer edge, so its label shares their text edge. */
+.more {
+  display: flex;
+  justify-self: start;
+}

apps/sim/app/(product)/o/[organizationId]/home/_components/home-workspaces/home-workspaces.tsx

@@ -0,0 +1,86 @@
+'use client'
+
+import { useState } from 'react'
+import { ActivityRow } from '@sim/emcn/activity-row'
+import { Button } from '@sim/emcn/button'
+import { ScrollArea } from '@sim/emcn/scroll-area'
+import { FailureNotice, Spinner } from '@sim/emcn/status'
+import { HomeSection } from '@/app/(product)/_components/home-section/home-section'
+import styles from '@/app/(product)/o/[organizationId]/home/_components/home-workspaces/home-workspaces.module.css'
+import type { HomeListState, HomeWorkspaceItem } from '@/platform/shared/home'
+import { formatRelativeTime } from '@/platform/shared/time'
+
+/** The sidebar's own page size, so See more advances the same way in both places. */
+const PAGE_SIZE = 5
+
+const STATUS_LABEL = { review: 'Review', running: 'Running' } as const
+
+function metadataOf(item: HomeWorkspaceItem, asOf: number) {
+  if (item.status) return STATUS_LABEL[item.status]
+  return item.lastRunAt === undefined ? undefined : formatRelativeTime(item.lastRunAt, asOf)
+}
+
+interface HomeWorkspacesProps {
+  state: HomeListState<HomeWorkspaceItem>
+  asOf: number
+  onRetry: () => void
+}
+
+/** The viewer's workspaces with what their runs are doing. Renders nothing for a viewer with none. */
+export function HomeWorkspaces({ state, asOf, onRetry }: HomeWorkspacesProps) {
+  const [visibleCount, setVisibleCount] = useState(PAGE_SIZE)
+  if (state.status === 'ready' && state.items.length === 0) return null
+  return (
+    <HomeSection title='Workspaces'>
+      {state.status === 'error' && (
+        <FailureNotice
+          message='Workspaces could not load.'
+          retrying={state.retrying}
+          onRetry={onRetry}
+        />
+      )}
+      {state.status === 'ready' && (
+        <>
+          {state.partial && (
+            <FailureNotice
+              intent='warning'
+              message='What these workspaces are doing could not load.'
+              onRetry={onRetry}
+            />
+          )}
+          <div className={styles.viewport} aria-busy={state.settling || undefined}>
+            <ScrollArea label='Workspace list'>
+              <ul className={styles.entries}>
+                {state.items.slice(0, visibleCount).map((item) => (
+                  <ActivityRow
+                    key={item.id}
+                    title={item.name}
+                    detail={state.settling ? undefined : item.detail}
+                    textMetadata={state.settling ? undefined : metadataOf(item, asOf)}
+                    metadataLeading={item.status === 'running' ? <Spinner /> : undefined}
+                    href={item.href}
+                  />
+                ))}
+              </ul>
+            </ScrollArea>
+            {state.items.length > PAGE_SIZE && (
+              <span className={styles.more}>
+                <Button
+                  variant='quiet'
+                  size='compact'
+                  onClick={() =>
+                    setVisibleCount(
+                      state.items.length > visibleCount ? visibleCount + PAGE_SIZE : PAGE_SIZE
+                    )
+                  }
+                >
+                  {state.items.length > visibleCount ? 'See more' : 'See less'}
+                </Button>
+              </span>
+            )}
+          </div>
+        </>
+      )}
+    </HomeSection>
+  )
+}

apps/sim/app/(product)/o/[organizationId]/home/_components/live-home/live-home.tsx

@@ -4,11 +4,10 @@ import type { HomeWidget } from '@/app/(product)/_components/model'
 import { SavedAccountModal } from '@/app/(product)/_components/service-account-modal/saved-account-modal'
 import { useInterfacePreferences } from '@/app/(product)/_components/session/interface-preferences'
 import { ZoneHomeDashboard } from '@/app/(product)/o/[organizationId]/home/_components/home-dashboard/zone-home-dashboard'
-import { HOME_HIDDEN_SECTIONS } from '@/app/(product)/o/[organizationId]/home/_components/model'
 import { useHiddenHomeWidgets, useLiveHome } from '@/platform/lib/data/home'
 
 /** Until the viewer's Customize Home choices are known, every widget they could hide stays unread. */
-const UNKNOWN_CHOICES: readonly HomeWidget[] = ['Activity', 'Email', 'Calendar']
+const UNKNOWN_CHOICES: readonly HomeWidget[] = ['Activity', 'Workspaces', 'Email', 'Calendar']
 
 function keepChoices() {}
 
@@ -24,8 +23,7 @@ export function LiveHome() {
   const hiddenWidgets = widgets?.hiddenWidgets ?? UNKNOWN_CHOICES
   const { view, actions, savedConnection } = useLiveHome(
     preferences?.homeMode === 'Search',
-    hiddenWidgets,
-    HOME_HIDDEN_SECTIONS.has('Needs your attention')
+    hiddenWidgets
   )
   return (
     <>

apps/sim/app/(product)/o/[organizationId]/home/_components/model.ts

@@ -10,16 +10,9 @@ import type {
   HomeListState,
   HomeWidgetActions,
   HomeWidgetState,
+  HomeWorkspaceItem,
 } from '@/platform/shared/home'
 
-/**
- * Home sections held back by design until the designer's pass. Their views stay; Home renders none
- * of them and the live Home skips their reads.
- */
-export const HOME_HIDDEN_SECTIONS: ReadonlySet<'Needs your attention'> = new Set([
-  'Needs your attention',
-])
-
 export interface AttentionItem {
   id: string
   title: string
@@ -64,10 +57,16 @@ export interface HomeView {
   asOf: number
   greeting: string
   firstName?: string
-  attention: HomeListState<AttentionItem>
+  /**
+   * Needs your attention and Workspaces wait for their design pass: absent while Home does not offer
+   * them, so nothing renders or reads for either.
+   */
+  attention?: HomeListState<AttentionItem>
   activity: Record<HomeMode, HomeActivityState>
   email: HomeWidgetState<readonly EmailItem[]>
   calendar: HomeWidgetState<HomeCalendarDay>
+  /** The viewer's workspaces, the sidebar's rows. Nothing renders for a viewer with none. */
+  workspaces?: HomeListState<HomeWorkspaceItem>
   recents: HomeListState<RecentItem>
   getStarted: readonly HomeGetStartedStep[]
   composerInventory?: ComposerInventory
@@ -81,6 +80,7 @@ export interface HomeActions {
   returnToToday: () => void
   retryAttention: () => void
   retryActivity: () => void
+  retryWorkspaces: () => void
   retryRecents: () => void
   removeRecent: (id: string) => void
 }

apps/sim/app/(product)/o/[organizationId]/home/page.tsx

@@ -17,7 +17,13 @@ export default async function Page({ searchParams }: ProductPageProps<{ organiza
       loadConversationData(scenario),
       loadHomeRecentLinks(scenario),
     ])
-    return <FixtureHome data={data?.home ?? null} recentLinks={recentLinks ?? []} />
+    return (
+      <FixtureHome
+        data={data?.home ?? null}
+        recentLinks={recentLinks ?? []}
+        workspaces={data?.workspaces ?? []}
+      />
+    )
   }
   // Loaded only here, so a fixture build never evaluates the data seam.
   const { LiveHomeRoute } = await import(

apps/sim/hooks/queries/organization-home.ts

@@ -3,13 +3,17 @@ import { requestJson } from '@/lib/api/client/request'
 import {
   getOrganizationHomeCalendarContract,
   getOrganizationHomeEmailContract,
+  getOrganizationHomeWorkspaceActivityContract,
+  type OrganizationHomeWorkspaceActivity,
 } from '@/lib/api/contracts/organization-home'
 import { organizationAccountsKeys } from '@/hooks/queries/utils/organization-accounts-keys'
 
 /** Each read costs a request per thread at the member's mail provider, so focus re-reads are spaced. */
 const EMAIL_STALE_TIME = 5 * 60 * 1000
 /** A day's meetings change less often than a mailbox, and every day browsed is its own read. */
 const CALENDAR_STALE_TIME = 5 * 60 * 1000
+/** A run's state moves quickly, but no one is waiting on it to the second. */
+const WORKSPACE_ACTIVITY_STALE_TIME = 30 * 1000
 
 /** Nested under the organization's accounts, so anything that changes a connection refreshes Home. */
 const organizationHomeKeys = {
@@ -20,6 +24,8 @@ const organizationHomeKeys = {
     [...organizationHomeKeys.organization(organizationId), 'email'] as const,
   calendar: (organizationId: string, date: string, timeZone: string) =>
     [...organizationHomeKeys.organization(organizationId), 'calendar', date, timeZone] as const,
+  workspaceActivity: (organizationId: string) =>
+    [...organizationHomeKeys.organization(organizationId), 'workspace-activity'] as const,
 }
 
 interface HomeWidgetQueryOptions {
@@ -60,3 +66,30 @@ export function useOrganizationHomeCalendar(
     refetchOnWindowFocus: true,
   })
 }
+
+function hasRunningWorkspace(data: OrganizationHomeWorkspaceActivity | undefined) {
+  return data?.workspaces.some((workspace) => workspace.status === 'running') ?? false
+}
+
+/**
+ * Polls only while a run is on screen, so a finished one does not keep saying Running. Everything
+ * else refreshes on focus, and a hidden tab polls nothing.
+ */
+export function useOrganizationHomeWorkspaceActivity(
+  organizationId: string,
+  { enabled }: HomeWidgetQueryOptions
+) {
+  return useQuery({
+    queryKey: organizationHomeKeys.workspaceActivity(organizationId),
+    queryFn: ({ signal }) =>
+      requestJson(getOrganizationHomeWorkspaceActivityContract, {
+        params: { id: organizationId },
+        signal,
+      }),
+    enabled,
+    staleTime: WORKSPACE_ACTIVITY_STALE_TIME,
+    refetchOnWindowFocus: true,
+    refetchInterval: (query) =>
+      hasRunningWorkspace(query.state.data) ? WORKSPACE_ACTIVITY_STALE_TIME : false,
+  })
+}

apps/sim/platform/fixtures/index.ts

@@ -97,6 +97,7 @@ export const loadConversationData = fixture(async (scenario) => {
   return {
     home: { ...home, composerInventory: inventory },
     chat: { ...chat, composerInventory: inventory },
+    workspaces: shellScenarios[scenario].workspaces,
   }
 })
 export const loadIntegrationsData = fixture(