feat: show tiny.place only to users with an identity

app/src/agentworld/AgentWorldShell.test.tsx

@@ -0,0 +1,64 @@
+import { render, screen } from '@testing-library/react';
+import { MemoryRouter, Route, Routes } from 'react-router-dom';
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+
+import type { TinyPlaceIdentityState } from '../hooks/useTinyPlaceIdentity';
+import AgentWorldShell from './AgentWorldShell';
+
+let identity: TinyPlaceIdentityState = { status: 'ready', hasIdentity: true };
+vi.mock('../hooks/useTinyPlaceIdentity', () => ({ useTinyPlaceIdentity: () => identity }));
+vi.mock('./TinyPlaceSunsetNotice', () => ({
+  default: () => <div data-testid="tinyplace-sunset-notice" />,
+}));
+vi.mock('../lib/agentworld/invokeApiClient', () => ({ createInvokeApiClient: () => ({}) }));
+
+function renderShell() {
+  return render(
+    <MemoryRouter initialEntries={['/agent-world']}>
+      <Routes>
+        <Route
+          path="/agent-world"
+          element={
+            <AgentWorldShell>
+              <div data-testid="agent-world-content" />
+            </AgentWorldShell>
+          }
+        />
+        <Route path="/chat" element={<div data-testid="chat-page" />} />
+      </Routes>
+    </MemoryRouter>
+  );
+}
+
+describe('AgentWorldShell tiny.place gate (#5424)', () => {
+  beforeEach(() => {
+    identity = { status: 'ready', hasIdentity: true };
+  });
+
+  it('renders the agent-world surface and the notice for an identity holder', () => {
+    identity = { status: 'ready', hasIdentity: true };
+    renderShell();
+
+    expect(screen.getByTestId('agent-world-content')).toBeInTheDocument();
+    expect(screen.getByTestId('tinyplace-sunset-notice')).toBeInTheDocument();
+    expect(screen.queryByTestId('chat-page')).toBeNull();
+  });
+
+  it('redirects a confirmed non-holder away to chat', () => {
+    identity = { status: 'ready', hasIdentity: false };
+    renderShell();
+
+    expect(screen.getByTestId('chat-page')).toBeInTheDocument();
+    expect(screen.queryByTestId('agent-world-content')).toBeNull();
+  });
+
+  it('renders optimistically while the identity check is still loading', () => {
+    identity = { status: 'loading', hasIdentity: false };
+    renderShell();
+
+    // A holder must not see a flash-then-redirect, so nothing redirects until
+    // the check confirms the user has no identity.
+    expect(screen.getByTestId('agent-world-content')).toBeInTheDocument();
+    expect(screen.queryByTestId('chat-page')).toBeNull();
+  });
+});

app/src/agentworld/AgentWorldShell.tsx

@@ -11,8 +11,11 @@
  * not needed in the embedded context.
  */
 import type { ReactNode } from 'react';
+import { Navigate } from 'react-router-dom';
 
+import { useTinyPlaceIdentity } from '../hooks/useTinyPlaceIdentity';
 import { createInvokeApiClient } from '../lib/agentworld/invokeApiClient';
+import TinyPlaceSunsetNotice from './TinyPlaceSunsetNotice';
 
 interface AgentWorldShellProps {
   children: ReactNode;
@@ -23,12 +26,27 @@ interface AgentWorldShellProps {
 const apiClient = createInvokeApiClient();
 
 export default function AgentWorldShell({ children }: AgentWorldShellProps) {
+  // #5424 — tiny.place is being removed from the app after 31 August 2026. A
+  // user without an identity has no entry point to it, so a direct link here is
+  // sent back to chat once we confirm they have none. Identity-holders keep full
+  // access (direct links included) plus the removal notice. While the check is
+  // in flight the surface renders optimistically so a holder never sees a flash.
+  const { status, hasIdentity } = useTinyPlaceIdentity();
+  if (status === 'ready' && !hasIdentity) {
+    return <Navigate to="/chat" replace />;
+  }
+
   // NOTE: When the vendored ApiProvider is available (from synced website/src),
   // wrap children with <ApiProvider client={apiClient}>.  For Wave 0 we expose
   // the client via a context (see AgentWorldContext) so the Explore placeholder
   // can demonstrate the end-to-end wiring without requiring the full vendor sync.
   void apiClient; // referenced here to ensure the module is evaluated
-  return <>{children}</>;
+  return (
+    <>
+      <TinyPlaceSunsetNotice />
+      {children}
+    </>
+  );
 }
 
 export { apiClient };

app/src/agentworld/TinyPlaceSunsetNotice.test.tsx

@@ -0,0 +1,31 @@
+import { fireEvent, render, screen } from '@testing-library/react';
+import { describe, expect, it, vi } from 'vitest';
+
+import TinyPlaceSunsetNotice from './TinyPlaceSunsetNotice';
+
+const openUrl = vi.fn();
+vi.mock('../lib/i18n/I18nContext', () => ({ useT: () => ({ t: (k: string) => k }) }));
+vi.mock('../utils/openUrl', () => ({ openUrl: (url: string) => openUrl(url) }));
+
+describe('TinyPlaceSunsetNotice (#5424)', () => {
+  it('renders the removal notice with a call to action', () => {
+    render(<TinyPlaceSunsetNotice />);
+
+    expect(screen.getByTestId('tinyplace-sunset-notice')).toBeInTheDocument();
+    expect(screen.getByText('tinyplaceSunset.title')).toBeInTheDocument();
+    expect(screen.getByRole('button', { name: 'tinyplaceSunset.cta' })).toBeInTheDocument();
+  });
+
+  it('opens tiny.place in the system browser when the CTA is clicked', () => {
+    render(<TinyPlaceSunsetNotice />);
+
+    fireEvent.click(screen.getByRole('button', { name: 'tinyplaceSunset.cta' }));
+    expect(openUrl).toHaveBeenCalledWith('https://tiny.place');
+  });
+
+  it('is not dismissible — no dismiss control is rendered', () => {
+    render(<TinyPlaceSunsetNotice />);
+
+    expect(screen.queryByRole('button', { name: 'common.dismiss' })).toBeNull();
+  });
+});

app/src/agentworld/TinyPlaceSunsetNotice.tsx

@@ -0,0 +1,33 @@
+/**
+ * tiny.place removal notice (#5424).
+ *
+ * Shown on the tiny.place surfaces (Agent World + the Brain orchestration
+ * sub-tab) to users who have an identity — the only people who still see the
+ * feature. It tells them to keep using tiny.place at tiny.place, names the
+ * 31 August 2026 in-app removal date, and links out. Non-dismissible: the
+ * deadline is fixed, so the notice stays until then.
+ */
+import UpsellBanner from '../components/upsell/UpsellBanner';
+import { useT } from '../lib/i18n/I18nContext';
+import { TINYPLACE_URL } from '../utils/links';
+import { openUrl } from '../utils/openUrl';
+
+export default function TinyPlaceSunsetNotice() {
+  const { t } = useT();
+
+  return (
+    <div className="relative z-20" data-testid="tinyplace-sunset-notice">
+      <UpsellBanner
+        variant="info"
+        title={t('tinyplaceSunset.title')}
+        message={t('tinyplaceSunset.message')}
+        ctaLabel={t('tinyplaceSunset.cta')}
+        rounded={false}
+        dismissible={false}
+        onCtaClick={() => {
+          void openUrl(TINYPLACE_URL);
+        }}
+      />
+    </div>
+  );
+}

app/src/components/layout/shell/CollapsedNavRail.test.tsx

@@ -16,6 +16,12 @@ vi.mock('./useHomeNav', () => ({ useHomeNav: () => mockHome }));
 // Deterministic labels: render the i18n key so queries don't depend on locale.
 vi.mock('../../../lib/i18n/I18nContext', () => ({ useT: () => ({ t: (k: string) => k }) }));
 vi.mock('../../../services/analytics', () => ({ trackEvent: vi.fn() }));
+// The agent-world tab is gated on a tiny.place identity (#5424). These tests
+// exercise the full rail, so pin identity present; the gate is covered by
+// useNavTabs.test.ts.
+vi.mock('../../../hooks/useTinyPlaceIdentity', () => ({
+  useTinyPlaceIdentity: () => ({ status: 'ready', hasIdentity: true }),
+}));
 
 describe('CollapsedNavRail', () => {
   beforeEach(() => vi.clearAllMocks());

app/src/components/layout/shell/CollapsedNavRail.tsx

@@ -1,7 +1,8 @@
 import { useMemo } from 'react';
 import { useLocation, useNavigate } from 'react-router-dom';
 
-import { NAV_TABS, type NavTab } from '../../../config/navConfig';
+import { type NavTab } from '../../../config/navConfig';
+import { useNavTabs } from '../../../hooks/useNavTabs';
 import { registry } from '../../../lib/commands/registry';
 import { useT } from '../../../lib/i18n/I18nContext';
 import { trackEvent } from '../../../services/analytics';
@@ -36,7 +37,11 @@ export default function CollapsedNavRail() {
   const handleHome = useHomeNav();
   const unreadCount = useAppSelector(state => selectUnreadCount(state.notifications.items));
 
-  const tabs = useMemo(() => NAV_TABS.map(tab => ({ ...tab, label: t(tab.labelKey) })), [t]);
+  const navTabs = useNavTabs();
+  const tabs = useMemo(
+    () => navTabs.map(tab => ({ ...tab, label: t(tab.labelKey) })),
+    [navTabs, t]
+  );
   const activeTab = tabs.find(tab => matchActive(tab.path, location.pathname));
 
   const handleClick = (tab: NavTab, active: boolean) => {

app/src/components/layout/shell/SidebarNav.test.tsx

@@ -8,6 +8,13 @@ import SidebarNav from './SidebarNav';
 // Analytics is fire-and-forget; stub it so the nav renders without a transport.
 vi.mock('../../../services/analytics', () => ({ trackEvent: vi.fn() }));
 
+// The Tiny.Place (agent-world) tab is gated on a tiny.place identity (#5424).
+// These tests exercise active-route matching with the full nav, so pin identity
+// present; the gate itself is covered by useNavTabs.test.ts.
+vi.mock('../../../hooks/useTinyPlaceIdentity', () => ({
+  useTinyPlaceIdentity: () => ({ status: 'ready', hasIdentity: true }),
+}));
+
 /** The rendered button for a nav label (label text lives in a child span). */
 function tabButton(label: string): HTMLButtonElement {
   return screen.getByRole('button', { name: new RegExp(label) }) as HTMLButtonElement;

app/src/components/layout/shell/SidebarNav.tsx

@@ -1,7 +1,8 @@
 import { useMemo } from 'react';
 import { useLocation, useNavigate } from 'react-router-dom';
 
-import { NAV_TABS, type NavTab } from '../../../config/navConfig';
+import { type NavTab } from '../../../config/navConfig';
+import { useNavTabs } from '../../../hooks/useNavTabs';
 import { useT } from '../../../lib/i18n/I18nContext';
 import { trackEvent } from '../../../services/analytics';
 import { setActiveAccount } from '../../../store/accountsSlice';
@@ -46,7 +47,11 @@ export default function SidebarNav() {
   const unreadCount = useAppSelector(state => selectUnreadCount(state.notifications.items));
   const companionActive = useAppSelector(selectCompanionSessionActive);
 
-  const tabs = useMemo(() => NAV_TABS.map(tab => ({ ...tab, label: t(tab.labelKey) })), [t]);
+  const navTabs = useNavTabs();
+  const tabs = useMemo(
+    () => navTabs.map(tab => ({ ...tab, label: t(tab.labelKey) })),
+    [navTabs, t]
+  );
   const activeTab = tabs.find(tab => matchActive(tab.path, location.pathname));
 
   const handleClick = (tab: NavTab, active: boolean) => {

app/src/hooks/useNavTabs.test.ts

@@ -0,0 +1,41 @@
+import { renderHook } from '@testing-library/react';
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+
+import { useNavTabs } from './useNavTabs';
+import type { TinyPlaceIdentityState } from './useTinyPlaceIdentity';
+
+// Hoisted so the vi.mock factory can legally reference it (the repo convention
+// for controllable mock state — see Brain.test.tsx).
+const identityRef = vi.hoisted(() => ({
+  current: { status: 'ready', hasIdentity: false } as TinyPlaceIdentityState,
+}));
+vi.mock('./useTinyPlaceIdentity', () => ({ useTinyPlaceIdentity: () => identityRef.current }));
+
+describe('useNavTabs (#5424)', () => {
+  beforeEach(() => {
+    identityRef.current = { status: 'ready', hasIdentity: false };
+  });
+
+  it('hides the agent-world (tiny.place) tab when the user has no identity', () => {
+    identityRef.current = { status: 'ready', hasIdentity: false };
+    const { result } = renderHook(() => useNavTabs());
+
+    expect(result.current.some(tab => tab.id === 'agent-world')).toBe(false);
+    // The other primary tabs are untouched.
+    expect(result.current.some(tab => tab.id === 'chat')).toBe(true);
+  });
+
+  it('shows the agent-world tab for a user with a tiny.place identity', () => {
+    identityRef.current = { status: 'ready', hasIdentity: true };
+    const { result } = renderHook(() => useNavTabs());
+
+    expect(result.current.some(tab => tab.id === 'agent-world')).toBe(true);
+  });
+
+  it('keeps the tab hidden while the identity check is still loading', () => {
+    identityRef.current = { status: 'loading', hasIdentity: false };
+    const { result } = renderHook(() => useNavTabs());
+
+    expect(result.current.some(tab => tab.id === 'agent-world')).toBe(false);
+  });
+});

app/src/hooks/useNavTabs.ts

@@ -0,0 +1,21 @@
+/**
+ * The visible primary nav tabs (#5424).
+ *
+ * Identical to {@link NAV_TABS} except the `agent-world` (tiny.place) tab is
+ * hidden from users without a tiny.place identity — the feature is being removed
+ * after 31 August 2026 and its entry points must only appear for people who
+ * already have one. Both nav renderers (expanded {@link SidebarNav} and the
+ * collapsed rail) consume this so the rule lives in one place.
+ */
+import { useMemo } from 'react';
+
+import { NAV_TABS, type NavTab } from '../config/navConfig';
+import { useTinyPlaceIdentity } from './useTinyPlaceIdentity';
+
+export function useNavTabs(): NavTab[] {
+  const { hasIdentity } = useTinyPlaceIdentity();
+  return useMemo(
+    () => NAV_TABS.filter(tab => tab.id !== 'agent-world' || hasIdentity),
+    [hasIdentity]
+  );
+}