@kortix/ui 0.14.14 → 0.14.15

package/dist/workspace/sidebar/project-nav-items.d.ts

@@ -1,14 +1,3 @@
-/**
- * The customizable nav rows under New session, in the order and with the
- * visibility chosen in "Customize sidebar" (`customize-sidebar-modal.tsx`).
- * Each row still applies its own flag and permission gate. More (rows set to
- * "Show in More", plus Customize sidebar) is last. Spaces are the channel
- * sidebar under the `project_channels` flag (project-spaces-nav.tsx).
- *
- * The layout lives in localStorage, which the server cannot read. The first
- * client render therefore uses the defaults, the same as the server HTML, and
- * the saved layout applies right after hydration.
- */
 export declare function ProjectNavItems({ projectId }: {
     projectId: string;
 }): import("react").JSX.Element;

package/dist/workspace/sidebar/project-nav-items.js

@@ -14,86 +14,21 @@ import { Button } from '../../primitives/button.js';
 import { ButtonGroup } from '../../primitives/button-group.js';
 import Hint from '../../primitives/hint.js';
 import { cn } from '../../lib/utils.js';
-import { DropdownMenu, DropdownMenuContent, DropdownMenuItem, DropdownMenuSeparator, DropdownMenuTrigger, } from '../../primitives/dropdown-menu.js';
 import { SidebarMenuButton, SidebarMenuItem, useSidebar } from '../../primitives/sidebar.js';
-import { SidebarGlyph } from '../../icons/sidebar-toggle.js';
-import { useNavRowMeta } from './nav-row-meta.js';
 import { useIsMobile } from '../../internal/hooks/index.js';
 import { useTranslations } from '../../i18n/index.js';
-import { SIDEBAR_NAV_DEFAULTS, openCustomizeSidebar, useSidebarNavStore, } from '../../internal/stores/sidebar-nav-store.js';
-import { CaretRightIcon, DotsThreeOutlineIcon, ListIcon, PlusIcon } from '@phosphor-icons/react';
+import { CaretRightIcon, ListIcon, PlusIcon } from '@phosphor-icons/react';
 import { UiLink as Link, useUiPathname } from '../../providers/ui-provider.js';
-import { useEffect, useRef, useState, useSyncExternalStore } from 'react';
-const subscribeNoop = () => () => { };
-/** Time to cross the gap between the More row and its menu before it closes. */
-const HOVER_CLOSE_DELAY_MS = 150;
+import { useEffect, useState } from 'react';
 /**
- * The customizable nav rows under New session, in the order and with the
- * visibility chosen in "Customize sidebar" (`customize-sidebar-modal.tsx`).
- * Each row still applies its own flag and permission gate. More (rows set to
- * "Show in More", plus Customize sidebar) is last. Spaces are the channel
- * sidebar under the `project_channels` flag (project-spaces-nav.tsx).
- *
- * The layout lives in localStorage, which the server cannot read. The first
- * client render therefore uses the defaults, the same as the server HTML, and
- * the saved layout applies right after hydration.
+ * The nav rows under New session, in one fixed order. Each row applies its
+ * own flag and permission gate and renders nothing when the project does not
+ * offer it. Spaces are the channel sidebar under the `project_channels` flag
+ * (project-spaces-nav.tsx).
  */
+const NAV_ROWS = ['customize', 'files', 'apps', 'rooms', 'goals', 'artifacts'];
 export function ProjectNavItems({ projectId }) {
-    const saved = useSidebarNavStore((s) => s.items);
-    const hydrated = useSyncExternalStore(subscribeNoop, () => true, () => false);
-    const items = hydrated ? saved : SIDEBAR_NAV_DEFAULTS;
-    return (_jsxs(_Fragment, { children: [items.map((entry) => (_jsx(NavItem, { entry: entry, projectId: projectId }, entry.id))), _jsx(MoreNavItem, { projectId: projectId, items: items })] }));
-}
-/**
- * The last nav row. Its menu holds every row set to "Show in More", so hiding
- * a row never makes its page unreachable, and then the one pointer path into
- * "Customize sidebar". Absent when the project offers the caller no row.
- */
-function MoreNavItem({ projectId, items, }) {
-    const t = useTranslations('sidebar');
-    const meta = useNavRowMeta(projectId);
-    const isMobile = useIsMobile();
-    const { setOpenMobile } = useSidebar();
-    const [open, setOpen] = useState(false);
-    const closeTimer = useRef(undefined);
-    const hidden = items.filter((e) => e.visibility === 'never' && meta[e.id]);
-    const closeSheet = () => {
-        if (isMobile)
-            setOpenMobile(false);
-    };
-    // A mouse opens the menu on hover. Touch and keyboard keep the click and
-    // Enter/Space toggle from Radix.
-    const cancelClose = () => clearTimeout(closeTimer.current);
-    const hoverOpen = (e) => {
-        if (e.pointerType !== 'mouse')
-            return;
-        cancelClose();
-        setOpen(true);
-    };
-    const hoverClose = (e) => {
-        if (e.pointerType !== 'mouse')
-            return;
-        cancelClose();
-        closeTimer.current = setTimeout(() => setOpen(false), HOVER_CLOSE_DELAY_MS);
-    };
-    useEffect(() => cancelClose, []);
-    // No row this project offers the caller: nothing to arrange and nothing
-    // hidden to reach, so the row would open a menu with nothing in it.
-    if (Object.keys(meta).length === 0)
-        return null;
-    return (_jsx(SidebarMenuItem, { children: _jsxs(DropdownMenu, { open: open, onOpenChange: setOpen, modal: false, children: [_jsx(DropdownMenuTrigger, { asChild: true, children: _jsxs(SidebarMenuButton, { tooltip: t('more'), className: "group/menu-button text-sidebar-foreground relative", onPointerEnter: hoverOpen, onPointerLeave: hoverClose, 
-                        // Hover already opened it: stop the Radix pointerdown toggle from
-                        // closing the menu when the mouse then clicks the row.
-                        onPointerDown: (e) => {
-                            if (e.pointerType === 'mouse' && open)
-                                e.preventDefault();
-                        }, children: [_jsx("span", { className: "shrink-0", children: _jsx(DotsThreeOutlineIcon, { weight: "fill" }) }), _jsx("span", { className: "truncate", children: t('more') })] }) }), _jsxs(DropdownMenuContent, { align: "start", side: "right", sideOffset: 8, className: "w-[15rem]", onPointerEnter: hoverOpen, onPointerLeave: hoverClose, children: [hidden.map((entry) => {
-                            const row = meta[entry.id];
-                            return (_jsx(DropdownMenuItem, { asChild: true, size: "sm", children: _jsxs(Link, { href: row.href, prefetch: false, onClick: closeSheet, children: [row.icon, row.label] }) }, entry.id));
-                        }), hidden.length > 0 ? _jsx(DropdownMenuSeparator, {}) : null, _jsxs(DropdownMenuItem, { size: "sm", onSelect: () => {
-                                setOpen(false);
-                                requestAnimationFrame(openCustomizeSidebar);
-                            }, children: [_jsx(SidebarGlyph, {}), t('customizeSidebar')] })] })] }) }));
+    return (_jsx(_Fragment, { children: NAV_ROWS.map((id) => (_jsx(NavItem, { id: id, projectId: projectId }, id))) }));
 }
 /**
  * Customize, for the people who may configure the project. Most configuring
@@ -133,10 +68,8 @@ function CustomizeNavEntry({ projectId }) {
                                         openNewAgent();
                                     }, children: _jsx(PlusIcon, { className: "size-4" }) }) })) : null, _jsx(Hint, { side: "top", label: tTabs('allAgents'), children: _jsx(Button, { variant: "secondary", size: "icon-xs", asChild: true, children: _jsx(Link, { href: capabilityTabHref(projectId, 'agent'), prefetch: false, "aria-label": tTabs('allAgents'), onClick: close, children: _jsx(ListIcon, { className: "size-4" }) }) }) })] })) : null] }), open ? _jsx(ProjectCapabilityNav, { projectId: projectId }) : null] }));
 }
-function NavItem({ entry, projectId }) {
-    if (entry.visibility === 'never')
-        return null;
-    switch (entry.id) {
+function NavItem({ id, projectId }) {
+    switch (id) {
         case 'customize':
             return _jsx(CustomizeNavEntry, { projectId: projectId });
         case 'apps':

package/dist/workspace/sidebar/project-sidebar.js

@@ -13,7 +13,6 @@ import { ProjectComputerNavItem } from './footer/project-computer-nav.js';
 import { ProjectManifestIssuesAlert } from './footer/project-manifest-issues-alert.js';
 import { ProjectSandboxAlert } from './footer/project-sandbox-alert.js';
 import { ProjectRepositoryDisconnectedAlert } from '../repository-disconnected.js';
-import { CustomizeSidebarModal } from './customize-sidebar-modal.js';
 import { NewAgentModalProvider } from './new-agent-modal-provider.js';
 import { ProjectMemoryNavItem } from './footer/project-memory-nav.js';
 import { ProjectNavItems } from './project-nav-items.js';
@@ -29,6 +28,7 @@ import { useFeatureFlag } from '@kortix/sdk/react';
 import { AppsModal } from '../../internal/apps-and-extensions/apps-modal.js';
 import { useAppsModalStore } from '../../internal/stores/apps-modal-store.js';
 import { ProjectChromeNavItem } from './footer/project-chrome-nav.js';
+import { CHROME_UI_ENABLED } from '../../internal/chrome/use-chrome-offered.js';
 import { MagnifyingGlassIcon, NavigationArrowIcon, } from '@phosphor-icons/react';
 import { UiLink as Link } from '../../providers/ui-provider.js';
 import { useCallback, useEffect, useRef, useState } from 'react';
@@ -52,7 +52,8 @@ export function ProjectSidebar({ projectId, menu, onOpenSearch, }) {
     const accountId = useBillingAccountId();
     // Channels replace New session and the session list (fail-closed: off until the project answers).
     const channels = useFeatureFlag(projectId, 'project_channels').enabled;
-    const chrome = useFeatureFlag(projectId, 'chrome').enabled;
+    // The project flag and the web app's master switch (`CHROME_UI_ENABLED`) must both be on.
+    const chrome = useFeatureFlag(projectId, 'chrome').enabled && CHROME_UI_ENABLED;
     // Open the project composer without creating a durable session.
     const newSession = useNewProjectSession(projectId);
     const creatingSession = useIsCreatingProjectSession(projectId);
@@ -111,5 +112,5 @@ export function ProjectSidebar({ projectId, menu, onOpenSearch, }) {
                                                 // box clears the 44px floor with the vertical-only extension —
                                                 // vertical-only because this titlebar row packs several
                                                 // controls side by side (KRTX-2004).
-                                                className: "shrink-0 hit-area-y-3", children: _jsx(MagnifyingGlassIcon, { className: "size-4" }) }) })), isMobile && (_jsx(Button, { type: "button", "aria-label": tCommon('close'), variant: "ghost", size: "icon", onClick: () => setOpenMobile(false), className: "shrink-0 hit-area-y-3", children: _jsx(Close, {}) })), !isMobile && !peek && (_jsx(Hint, { side: "bottom", label: _jsxs("span", { className: "flex items-center gap-1.5", children: [isExpanded ? t('collapse') : t('pin'), _jsxs(KbdGroup, { children: [_jsx(Kbd, { className: "font-mono", children: modSymbol }), _jsx(Kbd, { className: "font-mono", children: "B" })] })] }), children: _jsx(Button, { type: "button", "aria-label": isExpanded ? t('collapse') : t('pin'), variant: "ghost", size: "icon", onClick: toggleSidebar, className: "shrink-0", children: _jsx(PanelLeft, { className: "cn-rtl-flip" }) }) }))] })] }) }), _jsx(SidebarContent, { className: "relative min-h-0 flex-1 [scrollbar-width:'none'] overflow-hidden [-ms-overflow-style:'none'] [&::-webkit-scrollbar]:hidden [&_[data-sidebar=menu-button]]:pl-2", children: _jsxs("div", { className: "flex h-full min-h-0 flex-col space-y-2", children: [_jsx(SidebarGroup, { className: "py-0", children: _jsxs(SidebarMenu, { children: [channels ? null : (_jsx(SidebarMenuItem, { children: creatingSession ? (_jsx(SidebarMenuButton, { disabled: true, "aria-busy": true, className: "group/menu-button text-sidebar-foreground relative", children: newSessionRowBody })) : (_jsx(SidebarMenuButton, { asChild: true, className: "group/menu-button text-sidebar-foreground relative", children: _jsx(Link, { href: uiRoutes().project(projectId), prefetch: true, onClick: handleNewSessionClick, children: newSessionRowBody }) })) })), channels ? _jsx(ProjectMemoryNavItem, { projectId: projectId }) : null, _jsx(ProjectNavItems, { projectId: projectId })] }) }), _jsx(SidebarGroup, { className: "min-h-0 flex-1 flex-col py-0", ref: sessionsGroupRef, children: channels ? (_jsx(ProjectSpacesNav, { projectId: projectId })) : (_jsx(ProjectSessionList, { projectId: projectId })) }), _jsx(SidebarGroup, { className: "mt-auto", children: _jsxs(SidebarMenu, { className: "gap-1", children: [_jsx(ProjectRepositoryDisconnectedAlert, { projectId: projectId }), _jsx(ProjectSandboxAlert, { projectId: projectId }), _jsx(ProjectManifestIssuesAlert, { projectId: projectId }), _jsx(SidebarBalanceWarning, { accountId: accountId }), _jsx("li", { className: "not-has-[li]:hidden", children: _jsxs(SidebarMenu, { className: "gap-px [&>li:not(:first-child)>[data-sidebar=menu-button]]:rounded-t-sm [&>li:not(:last-child)>[data-sidebar=menu-button]]:rounded-b-sm", children: [_jsx(ProjectMcpNavItem, { onOpenConnect: () => setConnectMcpOpen(true) }), _jsx(ProjectComputerNavItem, { projectId: projectId, onOpenConnect: () => setComputerConnectOpen(true) }), chrome ? (_jsx(ProjectChromeNavItem, { onOpenConnect: () => useAppsModalStore.getState().setOpen(true) })) : null] }) }), _jsx(SidebarUpgradeButton, { accountId: accountId })] }) })] }) }), _jsx(SidebarRail, { "aria-label": t('resize'), title: t('resizeHelp') })] }), _jsx(ComputerConnectModal, { projectId: projectId, open: computerConnectOpen, onOpenChange: setComputerConnectOpen }), _jsx(AppsModal, { chrome: chrome, onOpenComputer: () => setComputerConnectOpen(true), onOpenMcp: () => setConnectMcpOpen(true) }), _jsx(ConnectMcpModal, { open: connectMcpOpen, onOpenChange: setConnectMcpOpen }), _jsx(CustomizeSidebarModal, { projectId: projectId })] }));
+                                                className: "shrink-0 hit-area-y-3", children: _jsx(MagnifyingGlassIcon, { className: "size-4" }) }) })), isMobile && (_jsx(Button, { type: "button", "aria-label": tCommon('close'), variant: "ghost", size: "icon", onClick: () => setOpenMobile(false), className: "shrink-0 hit-area-y-3", children: _jsx(Close, {}) })), !isMobile && !peek && (_jsx(Hint, { side: "bottom", label: _jsxs("span", { className: "flex items-center gap-1.5", children: [isExpanded ? t('collapse') : t('pin'), _jsxs(KbdGroup, { children: [_jsx(Kbd, { className: "font-mono", children: modSymbol }), _jsx(Kbd, { className: "font-mono", children: "B" })] })] }), children: _jsx(Button, { type: "button", "aria-label": isExpanded ? t('collapse') : t('pin'), variant: "ghost", size: "icon", onClick: toggleSidebar, className: "shrink-0", children: _jsx(PanelLeft, { className: "cn-rtl-flip" }) }) }))] })] }) }), _jsx(SidebarContent, { className: "relative min-h-0 flex-1 [scrollbar-width:'none'] overflow-hidden [-ms-overflow-style:'none'] [&::-webkit-scrollbar]:hidden [&_[data-sidebar=menu-button]]:pl-2", children: _jsxs("div", { className: "flex h-full min-h-0 flex-col space-y-2", children: [_jsx(SidebarGroup, { className: "py-0", children: _jsxs(SidebarMenu, { children: [channels ? null : (_jsx(SidebarMenuItem, { children: creatingSession ? (_jsx(SidebarMenuButton, { disabled: true, "aria-busy": true, className: "group/menu-button text-sidebar-foreground relative", children: newSessionRowBody })) : (_jsx(SidebarMenuButton, { asChild: true, className: "group/menu-button text-sidebar-foreground relative", children: _jsx(Link, { href: uiRoutes().project(projectId), prefetch: true, onClick: handleNewSessionClick, children: newSessionRowBody }) })) })), channels ? _jsx(ProjectMemoryNavItem, { projectId: projectId }) : null, _jsx(ProjectNavItems, { projectId: projectId })] }) }), _jsx(SidebarGroup, { className: "min-h-0 flex-1 flex-col py-0", ref: sessionsGroupRef, children: channels ? (_jsx(ProjectSpacesNav, { projectId: projectId })) : (_jsx(ProjectSessionList, { projectId: projectId })) }), _jsx(SidebarGroup, { className: "mt-auto", children: _jsxs(SidebarMenu, { className: "gap-1", children: [_jsx(ProjectRepositoryDisconnectedAlert, { projectId: projectId }), _jsx(ProjectSandboxAlert, { projectId: projectId }), _jsx(ProjectManifestIssuesAlert, { projectId: projectId }), _jsx(SidebarBalanceWarning, { accountId: accountId }), _jsx("li", { className: "not-has-[li]:hidden", children: _jsxs(SidebarMenu, { className: "gap-px [&>li:not(:first-child)>[data-sidebar=menu-button]]:rounded-t-sm [&>li:not(:last-child)>[data-sidebar=menu-button]]:rounded-b-sm", children: [_jsx(ProjectMcpNavItem, { onOpenConnect: () => setConnectMcpOpen(true) }), _jsx(ProjectComputerNavItem, { projectId: projectId, onOpenConnect: () => setComputerConnectOpen(true) }), chrome ? (_jsx(ProjectChromeNavItem, { onOpenConnect: () => useAppsModalStore.getState().setOpen(true) })) : null] }) }), _jsx(SidebarUpgradeButton, { accountId: accountId })] }) })] }) }), _jsx(SidebarRail, { "aria-label": t('resize'), title: t('resizeHelp') })] }), _jsx(ComputerConnectModal, { projectId: projectId, open: computerConnectOpen, onOpenChange: setComputerConnectOpen }), _jsx(AppsModal, { chrome: chrome, onOpenComputer: () => setComputerConnectOpen(true), onOpenMcp: () => setConnectMcpOpen(true) }), _jsx(ConnectMcpModal, { open: connectMcpOpen, onOpenChange: setConnectMcpOpen })] }));
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kortix/ui",
-  "version": "0.14.14",
+  "version": "0.14.15",
   "description": "Kortix UI: the shared React component library for apps/web, Kortix Apps and SDK hosts. Tailwind v4 classes, themed by CSS variables.",
   "type": "module",
   "license": "Elastic-2.0",
@@ -1367,10 +1367,6 @@
       "types": "./dist/internal/stores/settings-panel-store.d.ts",
       "import": "./dist/internal/stores/settings-panel-store.js"
     },
-    "./internal/stores/sidebar-nav-store": {
-      "types": "./dist/internal/stores/sidebar-nav-store.d.ts",
-      "import": "./dist/internal/stores/sidebar-nav-store.js"
-    },
     "./internal/stores/sound-store": {
       "types": "./dist/internal/stores/sound-store.d.ts",
       "import": "./dist/internal/stores/sound-store.js"
@@ -2189,7 +2185,7 @@
     "@extend-ai/react-docx": "^0.7.5",
     "@extend-ai/react-xlsx": "0.13.4",
     "@glideapps/glide-data-grid": "6.0.4-alpha24",
-    "@kortix/llm-catalog": "0.14.14",
+    "@kortix/llm-catalog": "0.14.15",
     "@lezer/highlight": "1.2.3",
     "@paper-design/shaders-react": "^0.0.76",
     "@phosphor-icons/react": "2.1.10",
@@ -2288,7 +2284,7 @@
     "yaml": "^2.8.2"
   },
   "peerDependencies": {
-    "@kortix/sdk": "^0.14.14",
+    "@kortix/sdk": "^0.14.15",
     "@tanstack/react-query": "^5.75.2",
     "@types/react": ">=18",
     "react": ">=19",

package/skills/kortix-ui/references/modules.md

@@ -179,7 +179,7 @@ export function PreviewHost() {
 }
 ```
 
-Names: `saveDriveFile`, `useDismissDriveConflict`, `useDriveAvailability`, `useDriveConflicts`, `useDriveFolder`, `useFolderAccess`, `useFolderPrincipals`, `useInvalidateDrives`, `useProjectDrive`, `useShareFolder`, `useUnshareFolder`, `FilesStoreProvider`, `getFileIcon`, `FilePreviewHost`, `ChangeRequestDetailDialog`, `DiffRenderer`, `DriveExplorer`, `DriveUploadTray`, `FileExplorerPage`, `FileThumbnail`, `ProjectFilesProvider`, `useProjectContext`, `FileExplorerSourceProvider`, `ExplorerQueryResult`, `FileExplorerSource`, `gitRefExplorerSource`, `useChangeRequestRecovery`, `changeRequestKeys`, `openChangeRequestListQuery`, `useChangeRequestDiff`, `useChangeRequestMergePreview`, `useCloseChangeRequest`, `useMergeChangeRequest`, `useRequestChangesOnChangeRequest`, `useSelectedVersion`, `workspaceFileSource`, `useWorkspaceSearch`, `SandboxFileExplorer`, `CodeEditor` (the CodeMirror editor, loaded as its own chunk on first render)
+Names: `saveDriveFile`, `useDismissDriveConflict`, `useDriveAvailability`, `useDriveConflicts`, `useDriveFolder`, `useFolderAccess`, `useFolderPrincipals`, `useInvalidateDrives`, `useProjectDrive`, `useShareFolder`, `useUnshareFolder`, `FilesStoreProvider`, `getFileIcon`, `FilePreviewHost`, `ChangeRequestDetailDialog`, `DiffRenderer`, `DriveExplorer`, `DriveUploadTray`, `FileExplorerPage`, `FileThumbnail`, `ProjectFilesProvider`, `useProjectContext`, `FileExplorerSourceProvider`, `ExplorerQueryResult`, `FileExplorerSource`, `gitRefExplorerSource`, `useChangeRequestRecovery`, `changeRequestKeys`, `openChangeRequestListQuery`, `useChangeRequestDiff`, `useChangeRequestMergePreview`, `useCloseChangeRequest`, `useMergeChangeRequest`, `useRequestChangesOnChangeRequest`, `useSelectedVersion`, `workspaceFileSource`, `useWorkspaceSearch`, `SandboxFileExplorer`, `CodeEditor` (the CodeMirror editor, loaded as its own chunk on first render). Files storage: `DriveStorageSummary` (a project's storage against its limit, with folder-mount warnings), `StorageMeter`, `StorageNotice`, `StorageTone`, `storageTone`, `formatStorageBytes`, `useDriveUsage`, `useDriveLimitMessage` (the readable message of a storage refusal), `useFolderMountNotice`
 
 ## `@kortix/ui/file-viewer`
 

package/dist/internal/stores/sidebar-nav-store.d.ts

@@ -1,78 +0,0 @@
-/** @internal Kortix apps only. No semver: it may change in any release. */
-/**
- * The project sidebar's navigation rows, in the order and with the visibility
- * the person chose in "Customize sidebar". Per account, across projects: the
- * sidebar is the same panel in every project, so one layout serves all of
- * them. localStorage is the instant first paint; the account's
- * `user_metadata.sidebar_nav` is the source of truth
- * (`customize-sidebar-modal.tsx` syncs it). A row a project does not offer (a flag is off, a permission is denied)
- * keeps its place here and simply does not render.
- */
-export declare const SIDEBAR_NAV_ITEM_IDS: readonly ["customize", "apps", "files", "rooms", "goals", "artifacts"];
-export type SidebarNavItemId = (typeof SIDEBAR_NAV_ITEM_IDS)[number];
-/**
- * `never` moves the row into the More menu (`project-nav-items.tsx`), so its
- * page stays one click away.
- */
-export type SidebarNavVisibility = 'always' | 'never';
-export interface SidebarNavEntry {
-    id: SidebarNavItemId;
-    visibility: SidebarNavVisibility;
-}
-/** The layout before anyone customizes it. */
-export declare const SIDEBAR_NAV_DEFAULTS: readonly SidebarNavEntry[];
-/**
- * Saved layout → a complete, valid one. Unknown ids and duplicates drop, a bad
- * visibility falls back to the default, and a row added after the layout was
- * saved appears at its default position.
- */
-export declare function normalizeSidebarNav(saved: unknown): SidebarNavEntry[];
-/**
- * v1 → v2 (2026-10-20): Rooms moved into the More menu by default. A v1
- * layout persisted the old default (`always`) on first load, before anyone
- * chose it, so the migration moves Rooms into More. A layout the account saved
- * remotely is a deliberate choice and is not migrated.
- */
-export declare function migrateSidebarNav(persisted: unknown, version: number): {
-    items: SidebarNavEntry[];
-};
-/** The `user_metadata` key that carries the layout to every device the
- *  account signs in on (web and desktop). */
-export declare const SIDEBAR_NAV_METADATA_KEY = "sidebar_nav";
-export declare const sidebarNavKey: (items: readonly SidebarNavEntry[]) => string;
-/**
- * The account's saved layout wins. With none saved, keep the local one and
- * push it once if the person customized it before the layout synced.
- */
-export declare function resolveSidebarNav(remote: unknown, local: readonly SidebarNavEntry[]): {
-    items: SidebarNavEntry[];
-    push: boolean;
-};
-/** Moves one row up (`-1`) or down (`+1`); the keyboard path of the drag. */
-export declare function moveSidebarNavItem(items: readonly SidebarNavEntry[], id: SidebarNavItemId, delta: -1 | 1): SidebarNavEntry[];
-interface SidebarNavState {
-    items: SidebarNavEntry[];
-    /** The Customize sidebar modal. Not persisted. */
-    customizeOpen: boolean;
-    /** Replaces the whole layout; normalized, so a partial or bad list is safe. */
-    setItems: (items: SidebarNavEntry[]) => void;
-    move: (id: SidebarNavItemId, delta: -1 | 1) => void;
-    setVisibility: (id: SidebarNavItemId, visibility: SidebarNavVisibility) => void;
-    reset: () => void;
-    setCustomizeOpen: (open: boolean) => void;
-}
-export declare const useSidebarNavStore: import("zustand").UseBoundStore<Omit<import("zustand").StoreApi<SidebarNavState>, "setState" | "persist"> & {
-    setState(partial: SidebarNavState | Partial<SidebarNavState> | ((state: SidebarNavState) => SidebarNavState | Partial<SidebarNavState>), replace?: false | undefined): unknown;
-    setState(state: SidebarNavState | ((state: SidebarNavState) => SidebarNavState), replace: true): unknown;
-    persist: {
-        setOptions: (options: Partial<import("zustand/middleware").PersistOptions<SidebarNavState, unknown, unknown>>) => void;
-        clearStorage: () => void;
-        rehydrate: () => Promise<void> | void;
-        hasHydrated: () => boolean;
-        onHydrate: (fn: (state: SidebarNavState) => void) => () => void;
-        onFinishHydration: (fn: (state: SidebarNavState) => void) => () => void;
-        getOptions: () => Partial<import("zustand/middleware").PersistOptions<SidebarNavState, unknown, unknown>>;
-    };
-}>;
-export declare function openCustomizeSidebar(): void;
-export {};

package/dist/internal/stores/sidebar-nav-store.js

@@ -1,125 +0,0 @@
-import { create } from 'zustand';
-import { persist } from 'zustand/middleware';
-import { createSafeJSONStorage } from '../lib/storage/managed-storage.js';
-import { registerPersistedStore, resetPersistedStore } from './persisted-store-registry.js';
-/**
- * The project sidebar's navigation rows, in the order and with the visibility
- * the person chose in "Customize sidebar". Per account, across projects: the
- * sidebar is the same panel in every project, so one layout serves all of
- * them. localStorage is the instant first paint; the account's
- * `user_metadata.sidebar_nav` is the source of truth
- * (`customize-sidebar-modal.tsx` syncs it). A row a project does not offer (a flag is off, a permission is denied)
- * keeps its place here and simply does not render.
- */
-// Review (2026-10-17) and Reminders (2026-10-19) left the sidebar for Customize
-// tabs. A saved layout that still names one drops the id in `normalizeSidebarNav`.
-export const SIDEBAR_NAV_ITEM_IDS = ['customize', 'apps', 'files', 'rooms', 'goals', 'artifacts'];
-/** The layout before anyone customizes it. */
-export const SIDEBAR_NAV_DEFAULTS = [
-    { id: 'customize', visibility: 'always' },
-    { id: 'files', visibility: 'always' },
-    { id: 'apps', visibility: 'always' },
-    // Rooms (2026-10-19, flag `agent_rooms`): chat rooms for sessions and people.
-    // In the More menu until the person pins it (2026-10-20).
-    { id: 'rooms', visibility: 'never' },
-    // Goals (2026-10-21, flag `goals`): objectives agents own until verified done.
-    { id: 'goals', visibility: 'always' },
-    // Artifacts (2026-10-23, flag `artifacts`): published docs, slides, boards, dashboards.
-    { id: 'artifacts', visibility: 'always' },
-];
-function isItemId(value) {
-    return SIDEBAR_NAV_ITEM_IDS.includes(value);
-}
-function isVisibility(value) {
-    return value === 'always' || value === 'never';
-}
-/**
- * Saved layout → a complete, valid one. Unknown ids and duplicates drop, a bad
- * visibility falls back to the default, and a row added after the layout was
- * saved appears at its default position.
- */
-export function normalizeSidebarNav(saved) {
-    const out = [];
-    if (Array.isArray(saved)) {
-        for (const entry of saved) {
-            const id = entry?.id;
-            if (!isItemId(id) || out.some((e) => e.id === id))
-                continue;
-            const fallback = SIDEBAR_NAV_DEFAULTS.find((d) => d.id === id).visibility;
-            const visibility = entry.visibility;
-            out.push({ id, visibility: isVisibility(visibility) ? visibility : fallback });
-        }
-    }
-    SIDEBAR_NAV_DEFAULTS.forEach((entry, index) => {
-        if (!out.some((e) => e.id === entry.id))
-            out.splice(Math.min(index, out.length), 0, { ...entry });
-    });
-    return out;
-}
-/**
- * v1 → v2 (2026-10-20): Rooms moved into the More menu by default. A v1
- * layout persisted the old default (`always`) on first load, before anyone
- * chose it, so the migration moves Rooms into More. A layout the account saved
- * remotely is a deliberate choice and is not migrated.
- */
-export function migrateSidebarNav(persisted, version) {
-    const items = normalizeSidebarNav(persisted?.items);
-    if (version >= 2)
-        return { items };
-    return { items: items.map((e) => (e.id === 'rooms' ? { id: 'rooms', visibility: 'never' } : e)) };
-}
-/** The `user_metadata` key that carries the layout to every device the
- *  account signs in on (web and desktop). */
-export const SIDEBAR_NAV_METADATA_KEY = 'sidebar_nav';
-export const sidebarNavKey = (items) => JSON.stringify(items);
-/**
- * The account's saved layout wins. With none saved, keep the local one and
- * push it once if the person customized it before the layout synced.
- */
-export function resolveSidebarNav(remote, local) {
-    if (Array.isArray(remote))
-        return { items: normalizeSidebarNav(remote), push: false };
-    return {
-        items: [...local],
-        push: sidebarNavKey(local) !== sidebarNavKey(SIDEBAR_NAV_DEFAULTS),
-    };
-}
-/** Moves one row up (`-1`) or down (`+1`); the keyboard path of the drag. */
-export function moveSidebarNavItem(items, id, delta) {
-    const from = items.findIndex((e) => e.id === id);
-    const to = from + delta;
-    if (from === -1 || to < 0 || to >= items.length)
-        return [...items];
-    const next = [...items];
-    const [moved] = next.splice(from, 1);
-    next.splice(to, 0, moved);
-    return next;
-}
-/** `kortix.` is an app prefix, so sign-out sweeps it
- *  (`persisted-store-coverage.test.ts`). */
-const STORAGE_KEY = 'kortix.sidebarNav';
-export const useSidebarNavStore = create()(persist((set) => ({
-    items: normalizeSidebarNav(null),
-    customizeOpen: false,
-    setItems: (items) => set({ items: normalizeSidebarNav(items) }),
-    move: (id, delta) => set((state) => ({ items: moveSidebarNavItem(state.items, id, delta) })),
-    setVisibility: (id, visibility) => set((state) => ({
-        items: state.items.map((e) => e.id === id && isVisibility(visibility) ? { id, visibility } : e),
-    })),
-    reset: () => set({ items: normalizeSidebarNav(null) }),
-    setCustomizeOpen: (customizeOpen) => set({ customizeOpen }),
-}), {
-    name: STORAGE_KEY,
-    storage: createSafeJSONStorage(),
-    version: 2,
-    migrate: (persisted, version) => migrateSidebarNav(persisted, version),
-    partialize: (state) => ({ items: state.items }),
-    merge: (persisted, current) => ({
-        ...current,
-        items: normalizeSidebarNav(persisted?.items),
-    }),
-}));
-registerPersistedStore(STORAGE_KEY, () => resetPersistedStore(useSidebarNavStore));
-export function openCustomizeSidebar() {
-    useSidebarNavStore.getState().setCustomizeOpen(true);
-}

package/dist/workspace/sidebar/customize-sidebar-modal.d.ts

@@ -1,9 +0,0 @@
-/**
- * "Customize sidebar": the nav rows in two groups, "Sidebar" and "More". Where a row sits is the setting: drag it across the line to
- * move it under More, drag it back to show it. Changes apply as they are
- * made; there is no save step. Opened from the sidebar's More menu and
- * the command palette through `openCustomizeSidebar()`.
- */
-export declare function CustomizeSidebarModal({ projectId }: {
-    projectId: string;
-}): import("react").JSX.Element;

package/dist/workspace/sidebar/customize-sidebar-modal.js

@@ -1,198 +0,0 @@
-'use client';
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { Button } from '../../primitives/button.js';
-import { Modal, ModalBody, ModalContent, ModalDescription, ModalFooter, ModalHeader, ModalTitle, } from '../../primitives/modal.js';
-import { useUiUpdateViewerMetadata, useUiViewer, } from '../../providers/ui-provider.js';
-import { useNavRowMeta } from './nav-row-meta.js';
-import { useDebounce } from '../../hooks/use-debounce.js';
-import { useTranslations } from '../../i18n/index.js';
-import { spring } from '../../lib/springs.js';
-import { cn } from '../../internal/lib/utils.js';
-import { SIDEBAR_NAV_METADATA_KEY, resolveSidebarNav, sidebarNavKey, useSidebarNavStore, } from '../../internal/stores/sidebar-nav-store.js';
-import { DotsSixVerticalIcon } from '@phosphor-icons/react';
-import { Reorder } from 'motion/react';
-import { memo, useCallback, useEffect, useId, useLayoutEffect, useMemo, useRef, useState, } from 'react';
-/**
- * "Customize sidebar": the nav rows in two groups, "Sidebar" and "More". Where a row sits is the setting: drag it across the line to
- * move it under More, drag it back to show it. Changes apply as they are
- * made; there is no save step. Opened from the sidebar's More menu and
- * the command palette through `openCustomizeSidebar()`.
- */
-export function CustomizeSidebarModal({ projectId }) {
-    const t = useTranslations('sidebar');
-    const open = useSidebarNavStore((s) => s.customizeOpen);
-    const setOpen = useSidebarNavStore((s) => s.setCustomizeOpen);
-    const reset = useSidebarNavStore((s) => s.reset);
-    const onOpenChange = useSidebarNavAccountSync(open, setOpen);
-    return (_jsx(Modal, { open: open, onOpenChange: onOpenChange, children: _jsxs(ModalContent, { className: "sm:max-w-md", children: [_jsxs(ModalHeader, { children: [_jsx(ModalTitle, { children: t('customizeSidebar') }), _jsx(ModalDescription, { children: t('customizeSidebarDescription') })] }), _jsx(ModalBody, { children: _jsx(NavRowGroups, { projectId: projectId }) }), _jsx(ModalFooter, { children: _jsx(Button, { type: "button", variant: "ghost", size: "sm", onClick: reset, children: t('resetSidebar') }) })] }) }));
-}
-function saveSidebarNav(save, items) {
-    save?.({ [SIDEBAR_NAV_METADATA_KEY]: items }).catch((error) => {
-        console.warn('[sidebar] Could not save the sidebar layout to the account:', error);
-    });
-}
-/**
- * Keeps the layout on the account, so it survives sign-out (which sweeps
- * localStorage) and follows the person to the desktop app. The account copy
- * is applied when the user loads; an edit is saved once, when the modal
- * closes. Only an explicit close writes: the sign-out sweep also resets the
- * store, and a store subscription would save that reset over the layout.
- */
-function useSidebarNavAccountSync(open, setOpen) {
-    const user = useUiViewer();
-    const save = useUiUpdateViewerMetadata();
-    const userId = user?.id;
-    const remote = user?.metadata?.[SIDEBAR_NAV_METADATA_KEY];
-    const remoteKey = JSON.stringify(remote ?? null);
-    const openedWith = useRef(null);
-    useEffect(() => {
-        // An open modal holds edits the account does not have yet.
-        if (!userId || useSidebarNavStore.getState().customizeOpen)
-            return;
-        const { items, push } = resolveSidebarNav(JSON.parse(remoteKey), useSidebarNavStore.getState().items);
-        useSidebarNavStore.getState().setItems(items);
-        if (push)
-            saveSidebarNav(save, items);
-    }, [userId, remoteKey, save]);
-    // The modal opens through the store (`openCustomizeSidebar`), so the
-    // snapshot follows `open`, not `onOpenChange`.
-    useEffect(() => {
-        if (open)
-            openedWith.current = sidebarNavKey(useSidebarNavStore.getState().items);
-    }, [open]);
-    return useCallback((next) => {
-        const { items } = useSidebarNavStore.getState();
-        if (!next && openedWith.current !== null && openedWith.current !== sidebarNavKey(items)) {
-            saveSidebarNav(save, items);
-        }
-        if (!next)
-            openedWith.current = null;
-        setOpen(next);
-    }, [setOpen, save]);
-}
-/** The line between the two groups. A list value like any row, so a drag
- *  across it is an ordinary reorder; it is never dragged itself. */
-const DIVIDER = '__more__';
-const { exit: _exit, ...reorderTransition } = spring.moderate;
-function NavRowGroups({ projectId }) {
-    const t = useTranslations('sidebar');
-    const meta = useNavRowMeta(projectId);
-    const items = useSidebarNavStore((s) => s.items);
-    const setItems = useSidebarNavStore((s) => s.setItems);
-    const listRef = useRef(null);
-    const [announcement, setAnnouncement] = useState('');
-    const [dragging, setDragging] = useState(false);
-    const hintId = useId();
-    // Only the rows this project offers are listed; the rest keep their slot.
-    const saved = useMemo(() => {
-        const listed = items.filter((e) => meta[e.id]);
-        return [
-            ...listed.filter((e) => e.visibility !== 'never').map((e) => e.id),
-            DIVIDER,
-            ...listed.filter((e) => e.visibility === 'never').map((e) => e.id),
-        ];
-    }, [items, meta]);
-    const savedKey = saved.join('|');
-    // The drag edits a local draft, never the store. Every reorder frame used
-    // to write the persisted store (a localStorage write) and re-render the
-    // whole sidebar behind the modal; now a frame re-renders this list only.
-    const [draft, setDraft] = useState(saved);
-    const draftKey = draft.join('|');
-    // Follow the store when it changes from outside (Reset). Adjusted during
-    // render, React's pattern for state derived from a changed input.
-    const [syncedKey, setSyncedKey] = useState(savedKey);
-    if (syncedKey !== savedKey) {
-        setSyncedKey(savedKey);
-        if (draftKey !== savedKey)
-            setDraft(saved);
-    }
-    const save = (list) => {
-        const split = list.indexOf(DIVIDER);
-        const placed = list
-            .filter((v) => v !== DIVIDER)
-            .map((id) => {
-            if (list.indexOf(id) > split)
-                return { id, visibility: 'never' };
-            const was = items.find((e) => e.id === id).visibility;
-            return { id, visibility: was === 'never' ? 'always' : was };
-        });
-        let i = 0;
-        setItems(items.map((e) => (meta[e.id] ? placed[i++] : e)));
-    };
-    // Save once the order settles: after the drag ends and 200ms pass without
-    // a change. `settledKey === draftKey` keeps a stale debounced value from
-    // writing over a draft the store just reset.
-    const { debouncedValue: settled } = useDebounce(draft, 200);
-    const settledKey = settled.join('|');
-    useEffect(() => {
-        if (dragging || settledKey !== draftKey || draftKey === savedKey)
-            return;
-        save(settled);
-    });
-    // Closing the modal inside the 200ms window must not drop the last move.
-    const flushRef = useRef(() => { });
-    useLayoutEffect(() => {
-        flushRef.current = () => {
-            if (draftKey !== savedKey)
-                save(draft);
-        };
-    });
-    useEffect(() => () => flushRef.current(), []);
-    // Stable across renders so memoized rows skip re-rendering on every frame.
-    const draftRef = useRef(draft);
-    useLayoutEffect(() => {
-        draftRef.current = draft;
-    });
-    const moveByKey = useCallback((id, delta) => {
-        const current = draftRef.current;
-        const from = current.indexOf(id);
-        const to = from + delta;
-        if (to < 0 || to >= current.length)
-            return;
-        const next = [...current];
-        [next[from], next[to]] = [next[to], next[from]];
-        setDraft(next);
-        const split = next.indexOf(DIVIDER);
-        const at = next.indexOf(id);
-        const inSidebar = at < split;
-        setAnnouncement(t('reorderAnnouncement', {
-            name: meta[id].label,
-            group: inSidebar ? t('inSidebar') : t('underMore'),
-            position: inSidebar ? at + 1 : at - split,
-            total: inSidebar ? split : next.length - split - 1,
-        }));
-        // Reordering moves the DOM node, which can drop focus from the handle.
-        requestAnimationFrame(() => listRef.current?.querySelector(`[data-grip="${id}"]`)?.focus());
-    }, [t, meta]);
-    const dividerAt = draft.indexOf(DIVIDER);
-    const hiddenCount = draft.length - dividerAt - 1;
-    return (_jsxs("section", { className: "space-y-2", children: [_jsx(GroupHeading, { label: t('inSidebar'), count: dividerAt }), _jsx("p", { id: hintId, className: "sr-only", children: t('reorderHint') }), _jsx(Reorder.Group, { ref: listRef, as: "ul", axis: "y", values: draft, onReorder: setDraft, className: "flex flex-col gap-px", children: draft.map((value, index) => value === DIVIDER ? (_jsxs(Reorder.Item, { as: "li", value: DIVIDER, dragListener: false, transition: reorderTransition, className: "list-none", children: [dividerAt === 0 ? _jsx(EmptyDrop, { label: t('sidebarEmpty') }) : null, _jsx("div", { className: "pt-4 pb-2", children: _jsx(GroupHeading, { label: t('underMore'), count: hiddenCount }) }), hiddenCount === 0 ? _jsx(EmptyDrop, { label: t('moreEmpty') }) : null] }, DIVIDER)) : (_jsx(NavRow, { id: value, meta: meta[value], inMore: index > dividerAt, first: index === 0 || draft[index - 1] === DIVIDER, last: index === draft.length - 1 || draft[index + 1] === DIVIDER, hintId: hintId, onMove: moveByKey, onDragChange: setDragging }, value))) }), _jsx("p", { className: "text-muted-foreground pt-1 text-xs", children: t('moreCaption') }), _jsx("p", { role: "status", "aria-live": "polite", className: "sr-only", children: announcement })] }));
-}
-function GroupHeading({ label, count }) {
-    return (_jsxs("div", { className: "flex items-center gap-1.5", children: [_jsx("h3", { className: "text-foreground flex-1 text-xs font-medium", children: label }), _jsx("span", { className: "text-muted-foreground text-xs tabular-nums", children: count })] }));
-}
-function EmptyDrop({ label }) {
-    return (_jsx("p", { className: "text-muted-foreground border-muted-foreground/40 rounded-md border border-dashed px-3 py-2.5 text-xs", children: label }));
-}
-/**
- * One row. Same recipe as the sidebar's Connect MCP / Connect your computer
- * block: `bg-hover` rows on a 1px seam, `rounded-sm` inside, `rounded-md` on
- * the outer corners of each group's first and last row.
- */
-const NavRow = memo(function NavRow({ id, meta, inMore, first, last, hintId, onMove, onDragChange, }) {
-    const t = useTranslations('sidebar');
-    const [dragging, setDragging] = useState(false);
-    const onHandleKeyDown = (event) => {
-        if (event.key === 'ArrowUp' || event.key === 'ArrowDown') {
-            event.preventDefault();
-            onMove(id, event.key === 'ArrowUp' ? -1 : 1);
-        }
-    };
-    return (_jsxs(Reorder.Item, { as: "li", value: id, transition: reorderTransition, onDragStart: () => {
-            setDragging(true);
-            onDragChange(true);
-        }, onDragEnd: () => {
-            setDragging(false);
-            onDragChange(false);
-        }, className: cn('bg-hover relative flex h-9 cursor-move touch-none list-none items-center gap-2.5 rounded-sm px-1.5 select-none', first && 'rounded-t-md', last && 'rounded-b-md', dragging && 'bg-popover ring-border z-10 rounded-md shadow-sm ring-1'), children: [_jsx("button", { "data-grip": id, type: "button", "aria-label": t('reorderItem', { name: meta.label }), "aria-describedby": hintId, onKeyDown: onHandleKeyDown, className: "text-muted-foreground hover:text-foreground focus-visible:ring-ring/15 flex size-6 shrink-0 cursor-move items-center justify-center rounded-sm transition-colors focus-visible:ring-3 focus-visible:outline-none", children: _jsx(DotsSixVerticalIcon, { className: "size-4", weight: "bold" }) }), _jsx("span", { className: cn('flex size-4 shrink-0 items-center justify-center [&>svg]:size-4', inMore ? 'text-muted-foreground' : 'text-foreground'), children: meta.icon }), _jsx("span", { className: cn('min-w-0 flex-1 truncate text-sm', inMore ? 'text-muted-foreground' : 'text-foreground'), children: meta.label })] }));
-});