@promptbook/cli 0.113.0-9 → 0.114.0-0

package/apps/agents-server/src/components/Homepage/DefaultAgentsStatusNotice.tsx

@@ -0,0 +1,121 @@
+import Link from 'next/link';
+import { ReinstateBundledAgentsButton } from '../DefaultAgents/ReinstateBundledAgentsButton';
+
+/**
+ * Admin page tracking the presence of the core agents.
+ *
+ * @private constant of <DefaultAgentsStatusNotice/>
+ */
+const CORE_AGENTS_ADMIN_HREF = '/admin/core-agents';
+
+/**
+ * Props for the admin-only home page notice about missing bundled agents.
+ *
+ * @private props of <DefaultAgentsStatusNotice/>
+ */
+type DefaultAgentsStatusNoticeProps = {
+    /**
+     * Whether at least one core agent is missing.
+     */
+    readonly isAnyCoreAgentMissing: boolean;
+
+    /**
+     * Whether at least one normal default agent is missing.
+     */
+    readonly isAnyDefaultAgentMissing: boolean;
+
+    /**
+     * Titles of the core agents that are currently missing.
+     */
+    readonly missingCoreAgentTitles: ReadonlyArray<string>;
+
+    /**
+     * Titles of the normal default agents that are currently missing.
+     */
+    readonly missingDefaultAgentTitles: ReadonlyArray<string>;
+};
+
+/**
+ * Admin-only home page notice that warns when core agents are missing and informs when normal default agents are
+ * missing, each with a single button to reinstate them.
+ *
+ * @param props - Missing-agent status resolved on the server.
+ * @returns Notice banners, or `null` when nothing is missing.
+ *
+ * @private internal component of the Agents Server home page
+ */
+export function DefaultAgentsStatusNotice({
+    isAnyCoreAgentMissing,
+    isAnyDefaultAgentMissing,
+    missingCoreAgentTitles,
+    missingDefaultAgentTitles,
+}: DefaultAgentsStatusNoticeProps) {
+    if (!isAnyCoreAgentMissing && !isAnyDefaultAgentMissing) {
+        return null;
+    }
+
+    return (
+        <div className="mb-8 space-y-4">
+            {isAnyCoreAgentMissing && (
+                <section className="rounded-2xl border border-amber-300 bg-amber-50 p-5 text-amber-900 dark:border-amber-500/40 dark:bg-amber-500/10 dark:text-amber-100">
+                    <h2 className="text-lg font-semibold">Core agents are missing</h2>
+                    <p className="mt-1 text-sm">
+                        The core agents are used as a base for every other agent on this server. The following core
+                        agents are missing: {formatAgentTitles(missingCoreAgentTitles)}. You can reinstate them with a
+                        single click; existing agents are left untouched.
+                    </p>
+                    <div className="mt-4 flex flex-wrap items-center gap-3">
+                        <ReinstateBundledAgentsButton
+                            scope="core"
+                            label="Reinstate core agents"
+                            pendingLabel="Reinstating…"
+                            confirmMessage="Recreate the missing core agents from the bundled repository books?"
+                            className="inline-flex items-center rounded-lg bg-amber-600 px-4 py-2 text-sm font-semibold text-white shadow-sm transition hover:bg-amber-700 disabled:cursor-not-allowed disabled:opacity-60"
+                        />
+                        <Link
+                            href={CORE_AGENTS_ADMIN_HREF}
+                            className="text-sm font-medium text-amber-800 underline underline-offset-2 hover:text-amber-900 dark:text-amber-200"
+                        >
+                            Open Core Agents page
+                        </Link>
+                    </div>
+                </section>
+            )}
+
+            {isAnyDefaultAgentMissing && (
+                <section className="rounded-2xl border border-blue-300 bg-blue-50 p-5 text-blue-900 dark:border-blue-500/40 dark:bg-blue-500/10 dark:text-blue-100">
+                    <h2 className="text-lg font-semibold">Default agents are missing</h2>
+                    <p className="mt-1 text-sm">
+                        The default agents showcase what Promptbook agents can do. The following default agents are
+                        missing: {formatAgentTitles(missingDefaultAgentTitles)}. You can reinstate them with a single
+                        click; existing agents are left untouched.
+                    </p>
+                    <div className="mt-4">
+                        <ReinstateBundledAgentsButton
+                            scope="default"
+                            label="Reinstate default agents"
+                            pendingLabel="Reinstating…"
+                            confirmMessage="Recreate the missing default agents from the bundled repository books?"
+                            className="inline-flex items-center rounded-lg bg-blue-600 px-4 py-2 text-sm font-semibold text-white shadow-sm transition hover:bg-blue-700 disabled:cursor-not-allowed disabled:opacity-60"
+                        />
+                    </div>
+                </section>
+            )}
+        </div>
+    );
+}
+
+/**
+ * Formats a list of agent titles for inline display.
+ *
+ * @param agentTitles - Titles of the missing agents.
+ * @returns Comma-separated titles, or a fallback when the list is empty.
+ *
+ * @private utility of <DefaultAgentsStatusNotice/>
+ */
+function formatAgentTitles(agentTitles: ReadonlyArray<string>): string {
+    if (agentTitles.length === 0) {
+        return 'none';
+    }
+    return agentTitles.join(', ');
+}

package/apps/agents-server/src/components/Homepage/ExternalAgentsSectionClient.tsx

@@ -111,17 +111,7 @@ export function ExternalAgentsSectionClient(props: ExternalAgentsSectionClientPr
     }, []);
 
     if (initialLoading) {
-        return (
-            <div className="mt-8" role="status" aria-live="polite" aria-busy="true" aria-label="Loading federated agents">
-                <AgentCardsSection
-                    title={formatText('Federated agents')}
-                    publicUrl={publicUrl}
-                    agents={[]}
-                    isLoading={true}
-                    loadingCardCount={4}
-                />
-            </div>
-        );
+        return null;
     }
 
     const serverUrls = Object.keys(servers);
@@ -136,6 +126,10 @@ export function ExternalAgentsSectionClient(props: ExternalAgentsSectionClientPr
                 const state = servers[serverUrl];
                 const hostname = getServerHeadingLabel(serverUrl);
 
+                if (!state) {
+                    return null;
+                }
+
                 if (state.status === 'loading') {
                     return (
                         <AgentCardsSection

package/apps/agents-server/src/components/Homepage/HomepagePrimarySections.tsx

@@ -7,7 +7,6 @@ import { getIsSubfolderView } from '../../utils/getIsSubfolderView';
 import { AgentsList } from './AgentsList';
 import { ExternalAgentsSectionClient } from './ExternalAgentsSectionClient';
 import { HomepageMessage } from './HomepageMessage';
-import { isHomeListViewMode, resolveHomeViewMode } from './homeViewMode';
 
 /**
  * Props for the shared homepage/dashboard agents section.
@@ -52,8 +51,6 @@ export function HomepagePrimarySections({
 }: HomepagePrimarySectionsProps) {
     const searchParams = useSearchParams();
     const isSubfolderView = getIsSubfolderView(searchParams || undefined);
-    const viewMode = resolveHomeViewMode(searchParams?.get('view'));
-    const isListView = isHomeListViewMode(viewMode);
 
     return (
         <>
@@ -64,11 +61,9 @@ export function HomepagePrimarySections({
                 isAdmin={isAdmin}
                 canOrganize={canOrganize}
                 publicUrl={publicUrl}
-                showFederatedAgents={!isSubfolderView}
-                isSubfolderView={isSubfolderView}
             />
 
-            {isListView && !isSubfolderView && <ExternalAgentsSectionClient publicUrl={publicUrl} />}
+            {!isSubfolderView && <ExternalAgentsSectionClient publicUrl={publicUrl} />}
         </>
     );
 }

package/apps/agents-server/src/components/Homepage/agentOrganizationUtils.ts

@@ -306,66 +306,6 @@ export function getVisibleAgents(
     );
 }
 
-/**
- * Resolves the folder set used by office-style views.
- *
- * @param currentFolderId - Current folder scope.
- * @param childrenByParentId - Folder child lookup.
- * @returns Folder id set for the office scope or null at the root.
- *
- * @private function of AgentsList
- */
-export function createOfficeVisibleFolderIdSet(
-    currentFolderId: number | null,
-    childrenByParentId: ReadonlyMap<number | null, number[]>,
-): Set<number> | null {
-    if (currentFolderId === null) {
-        return null;
-    }
-
-    return new Set(collectDescendantFolderIds(currentFolderId, childrenByParentId));
-}
-
-/**
- * Filters agents for office-style subtree rendering.
- *
- * @param agents - All local agents.
- * @param officeVisibleFolderIds - Folder scope for office views.
- * @returns Agents visible in the office scope.
- *
- * @private function of AgentsList
- */
-export function getOfficeAgents(
-    agents: ReadonlyArray<AgentOrganizationAgent>,
-    officeVisibleFolderIds: ReadonlySet<number> | null,
-): AgentOrganizationAgent[] {
-    if (officeVisibleFolderIds === null) {
-        return Array.from(agents);
-    }
-
-    return agents.filter((agent) => agent.folderId !== null && officeVisibleFolderIds.has(agent.folderId));
-}
-
-/**
- * Filters folders for office-style subtree rendering.
- *
- * @param folders - All folders in the organization.
- * @param officeVisibleFolderIds - Folder scope for office views.
- * @returns Folders visible in the office scope.
- *
- * @private function of AgentsList
- */
-export function getOfficeFolders(
-    folders: ReadonlyArray<AgentOrganizationFolder>,
-    officeVisibleFolderIds: ReadonlySet<number> | null,
-): AgentOrganizationFolder[] {
-    if (officeVisibleFolderIds === null) {
-        return Array.from(folders);
-    }
-
-    return folders.filter((folder) => officeVisibleFolderIds.has(folder.id));
-}
-
 /**
  * Creates the POST payload used to persist folder organization changes.
  *

package/apps/agents-server/src/components/Homepage/normalizeServerUrl.ts

@@ -1,6 +1,6 @@
 /**
- * Normalize a server URL by removing any trailing slash.
+ * Normalize a server URL by removing its trailing slash.
  *
- * @private function of buildGraphData
+ * @private function of the Agents Server homepage federation helpers
  */
 export const normalizeServerUrl = (url: string): string => url.replace(/\/$/, '');

package/apps/agents-server/src/components/Homepage/useAgentsListDerivedState.ts

@@ -1,15 +1,11 @@
 'use client';
 
-import type { string_url } from '@promptbook-local/types';
 import type { AgentBasicInformation } from '../../../../../src/book-2.0/agent-source/AgentBasicInformation';
 import { useCallback, useMemo } from 'react';
 import type { AgentOrganizationAgent, AgentOrganizationFolder } from '../../utils/agentOrganization/types';
 import {
     buildFolderMaps,
     createFolderDescendantContext,
-    createOfficeVisibleFolderIdSet,
-    getOfficeAgents,
-    getOfficeFolders,
     getVisibleAgents,
     getVisibleFolders,
     getFolderPathSegments,
@@ -18,8 +14,6 @@ import {
     resolveFolderIdFromPath,
     sortBySortOrder,
 } from './agentOrganizationUtils';
-import type { HomeViewMode } from './homeViewMode';
-import { filterMazeRenderableAgents } from './mazeOfficeAgentSupport';
 
 /**
  * Summary of the parent folder breadcrumb shortcut.
@@ -41,8 +35,6 @@ type UseAgentsListDerivedStateProps = {
     readonly folderQuery: string | null;
     readonly folders: AgentOrganizationFolder[];
     readonly formatText: (text: string) => string;
-    readonly publicUrl: string_url;
-    readonly viewMode: HomeViewMode;
 };
 
 /**
@@ -72,57 +64,22 @@ function resolveParentFolderInfo(
     return { id: parentFolderId, label: parentFolderName };
 }
 
-/**
- * Resolves the agent counter shown in the list header.
- *
- * @param viewMode - Current homepage view mode.
- * @param visibleAgentCount - Number of agents visible in list view.
- * @param officeAgentCount - Number of agents visible in office views.
- * @param totalAgentCount - Total number of local agents.
- * @returns Count matching the current view.
- *
- * @private function of AgentsList
- */
-function resolveAgentCount(
-    viewMode: HomeViewMode,
-    visibleAgentCount: number,
-    officeAgentCount: number,
-    mazeAgentCount: number,
-    totalAgentCount: number,
-): number {
-    if (viewMode === 'LIST') {
-        return visibleAgentCount;
-    }
-
-    if (viewMode === 'OFFICE' || viewMode === 'PIXEL_OFFICE') {
-        return officeAgentCount;
-    }
-
-    if (viewMode === 'MAZE') {
-        return mazeAgentCount;
-    }
-
-    return totalAgentCount;
-}
-
 /**
  * Resolves the main heading shown above the list content.
  *
- * @param viewMode - Current homepage view mode.
  * @param currentFolderId - Current folder scope.
  * @param folderById - Folder lookup indexed by id.
  * @param localAgentsLabel - Localized fallback title.
- * @returns Heading title for the current view.
+ * @returns Heading title for the current list scope.
  *
  * @private function of AgentsList
  */
 function resolveHeadingTitle(
-    viewMode: HomeViewMode,
     currentFolderId: number | null,
     folderById: ReadonlyMap<number, AgentOrganizationFolder>,
     localAgentsLabel: string,
 ): string {
-    if (viewMode === 'GRAPH' || currentFolderId === null) {
+    if (currentFolderId === null) {
         return localAgentsLabel;
     }
 
@@ -142,8 +99,6 @@ export function useAgentsListDerivedState({
     folderQuery,
     folders,
     formatText,
-    publicUrl,
-    viewMode,
 }: UseAgentsListDerivedStateProps) {
     const folderPathSegments = useMemo(() => parseFolderPath(folderQuery), [folderQuery]);
     const currentFolderId = useMemo(
@@ -163,21 +118,8 @@ export function useAgentsListDerivedState({
     );
     const visibleFolders = useMemo(() => getVisibleFolders(folders, currentFolderId), [folders, currentFolderId]);
     const visibleAgents = useMemo(() => getVisibleAgents(agents, currentFolderId), [agents, currentFolderId]);
-    const officeVisibleFolderIds = useMemo(
-        () => createOfficeVisibleFolderIdSet(currentFolderId, folderMaps.childrenByParentId),
-        [currentFolderId, folderMaps.childrenByParentId],
-    );
-    const officeAgents = useMemo(() => getOfficeAgents(agents, officeVisibleFolderIds), [agents, officeVisibleFolderIds]);
-    const mazeAgents = useMemo(() => filterMazeRenderableAgents(officeAgents, publicUrl), [officeAgents, publicUrl]);
-    const officeFolders = useMemo(() => getOfficeFolders(folders, officeVisibleFolderIds), [folders, officeVisibleFolderIds]);
-    const agentCount = resolveAgentCount(
-        viewMode,
-        visibleAgents.length,
-        officeAgents.length,
-        mazeAgents.length,
-        agents.length,
-    );
-    const headingTitle = resolveHeadingTitle(viewMode, currentFolderId, folderMaps.folderById, localAgentsLabel);
+    const agentCount = visibleAgents.length;
+    const headingTitle = resolveHeadingTitle(currentFolderId, folderMaps.folderById, localAgentsLabel);
 
     const getFolderPreviewAgents = useCallback(
         (folderId: number): AgentBasicInformation[] => {
@@ -197,10 +139,6 @@ export function useAgentsListDerivedState({
         folderPathSegments,
         getFolderPreviewAgents,
         headingTitle,
-        localAgentsLabel,
-        mazeAgents,
-        officeAgents,
-        officeFolders,
         parentFolderInfo,
         visibleAgents,
         visibleFolders,

package/apps/agents-server/src/components/Homepage/useAgentsListNavigationState.ts

@@ -2,11 +2,10 @@
 
 import type { string_url } from '@promptbook-local/types';
 import { useCallback, useMemo } from 'react';
-import type { AgentOrganizationFolder } from '../../utils/agentOrganization/types';
+import type { AgentOrganizationAgent, AgentOrganizationFolder } from '../../utils/agentOrganization/types';
+import { createAgentEmailAddress } from '../../utils/email/agentEmailAddress';
 import type { CurrentPathQueryNavigationMode } from '../_utils/useCurrentPathQueryNavigation';
 import { buildFolderMaps, buildFolderPath, getFolderPathSegments } from './agentOrganizationUtils';
-import type { HomeViewMode } from './homeViewMode';
-import { useFederatedAgents, type AgentWithVisibility } from './useFederatedAgents';
 
 /**
  * Minimal current-path query navigation interface required by the private navigation hook.
@@ -22,48 +21,37 @@ type AgentsListNavigationHandler = (nextQuery: URLSearchParams, mode?: CurrentPa
  */
 type UseAgentsListNavigationStateProps = {
     readonly folders: AgentOrganizationFolder[];
-    readonly initialExternalAgents?: AgentWithVisibility[];
     readonly publicUrl: string_url;
     readonly searchParamsSnapshot: string;
-    readonly showFederatedAgents: boolean;
     readonly updateCurrentPathQuery: AgentsListNavigationHandler;
-    readonly viewMode: HomeViewMode;
 };
 
 /**
- * Navigation, federated-agent, and agent-address helpers returned to `useAgentsListState`.
+ * Navigation and agent-address helpers returned to `useAgentsListState`.
  *
  * @private function of AgentsList
  */
 type UseAgentsListNavigationStateResult = {
-    readonly buildAgentEmail: (identifier: string) => string;
+    readonly buildAgentEmail: (agent: AgentOrganizationAgent) => string;
     readonly buildAgentUrl: (identifier: string) => string;
-    readonly federatedAgents: AgentWithVisibility[];
-    readonly federatedServersStatus: ReturnType<typeof useFederatedAgents>['federatedServersStatus'];
     readonly navigateToFolder: (folderId: number | null, overrideFolders?: AgentOrganizationFolder[]) => void;
 };
 
 /**
  * Keeps homepage navigation and agent-address helpers focused outside the main `useAgentsListState` composition.
  *
- * @param props - Folder snapshot, route helpers, and federated-agent inputs.
- * @returns Folder navigation, federated-agent state, and agent URL/email builders.
+ * @param props - Folder snapshot, route helpers, and public URL.
+ * @returns Folder navigation and agent URL/email builders.
  *
  * @private function of AgentsList
  */
 export function useAgentsListNavigationState({
     folders,
-    initialExternalAgents,
     publicUrl,
     searchParamsSnapshot,
-    showFederatedAgents,
     updateCurrentPathQuery,
-    viewMode,
 }: UseAgentsListNavigationStateProps): UseAgentsListNavigationStateResult {
-    const normalizedPublicUrl = useMemo(
-        () => (publicUrl.endsWith('/') ? publicUrl : `${publicUrl}/`),
-        [publicUrl],
-    );
+    const normalizedPublicUrl = useMemo(() => (publicUrl.endsWith('/') ? publicUrl : `${publicUrl}/`), [publicUrl]);
     const publicUrlHost = useMemo(() => {
         try {
             return new URL(normalizedPublicUrl).hostname;
@@ -71,13 +59,6 @@ export function useAgentsListNavigationState({
             return '';
         }
     }, [normalizedPublicUrl]);
-    const shouldRefreshFederatedAgents = showFederatedAgents && viewMode !== 'LIST';
-    const { federatedAgents, federatedServersStatus } = useFederatedAgents(
-        showFederatedAgents,
-        initialExternalAgents,
-        shouldRefreshFederatedAgents,
-    );
-
     const navigateToFolder = useCallback(
         (folderId: number | null, overrideFolders?: AgentOrganizationFolder[]) => {
             const targetFolders = overrideFolders || folders;
@@ -101,15 +82,23 @@ export function useAgentsListNavigationState({
         [normalizedPublicUrl],
     );
     const buildAgentEmail = useCallback(
-        (identifier: string) => (publicUrlHost ? `${identifier}@${publicUrlHost}` : ''),
+        (agent: AgentOrganizationAgent) =>
+            publicUrlHost
+                ? createAgentEmailAddress(
+                      {
+                          agentName: agent.agentName,
+                          permanentId: agent.permanentId || agent.agentName,
+                          fullname: agent.meta.fullname,
+                      },
+                      publicUrlHost,
+                  )
+                : '',
         [publicUrlHost],
     );
 
     return {
         buildAgentEmail,
         buildAgentUrl,
-        federatedAgents,
-        federatedServersStatus,
         navigateToFolder,
     };
 }

package/apps/agents-server/src/components/Homepage/useAgentsListOverlayDetailsState.ts

@@ -12,7 +12,7 @@ import { useAgentsListOverlayState } from './useAgentsListOverlayState';
  * @private function of AgentsList
  */
 type UseAgentsListOverlayDetailsStateProps = {
-    readonly buildAgentEmail: (identifier: string) => string;
+    readonly buildAgentEmail: (agent: AgentOrganizationAgent) => string;
     readonly buildAgentUrl: (identifier: string) => string;
     readonly folderById: Map<number, AgentOrganizationFolder>;
     readonly folders: AgentOrganizationFolder[];
@@ -64,11 +64,11 @@ export function useAgentsListOverlayDetailsState({
             ? null
             : buildAgentFolderContext(contextMenuAgent.folderId ?? null, folderById);
     const contextMenuAgentUrl = contextMenuAgent ? buildAgentUrl(contextMenuIdentifier) : '';
-    const contextMenuAgentEmail = contextMenuAgent ? buildAgentEmail(contextMenuIdentifier) : '';
+    const contextMenuAgentEmail = contextMenuAgent ? buildAgentEmail(contextMenuAgent) : '';
     const qrCodeAgent = overlayState.qrCodeAgent;
     const qrCodeIdentifier = qrCodeAgent ? getAgentIdentifier(qrCodeAgent) : '';
     const qrCodeAgentUrl = qrCodeAgent ? buildAgentUrl(qrCodeIdentifier) : '';
-    const qrCodeAgentEmail = qrCodeAgent ? buildAgentEmail(qrCodeIdentifier) : '';
+    const qrCodeAgentEmail = qrCodeAgent ? buildAgentEmail(qrCodeAgent) : '';
 
     return {
         contextMenuAgent,

package/apps/agents-server/src/components/Homepage/useAgentsListQueryState.ts

@@ -3,8 +3,6 @@
 import { useSearchParams } from 'next/navigation';
 import { useCallback } from 'react';
 import { useCurrentPathQueryNavigation } from '../_utils/useCurrentPathQueryNavigation';
-import type { HomeViewMode } from './homeViewMode';
-import { getHomeViewQueryValue, resolveHomeViewMode } from './homeViewMode';
 
 /**
  * Query parameter name used to opt into showing hidden folders.
@@ -31,13 +29,11 @@ type UseAgentsListQueryStateResult = {
     readonly routeSyncKey: string;
     readonly searchParamsSnapshot: string;
     readonly setHiddenFoldersVisible: (isVisible: boolean) => void;
-    readonly setViewMode: (mode: HomeViewMode) => void;
-    readonly viewMode: HomeViewMode;
     readonly updateCurrentPathQuery: ReturnType<typeof useCurrentPathQueryNavigation>;
 };
 
 /**
- * Reads the homepage route query and keeps view-mode updates localized in one place.
+ * Reads the homepage route query and keeps folder and visibility updates localized in one place.
  *
  * @returns Route snapshot, query-derived state, and route mutation helpers.
  *
@@ -49,25 +45,7 @@ export function useAgentsListQueryState(): UseAgentsListQueryStateResult {
     const searchParamsSnapshot = searchParams?.toString() || '';
     const routeSyncKey = `?${searchParamsSnapshot}`;
     const folderQuery = searchParams?.get('folder') || null;
-    const viewMode = resolveHomeViewMode(searchParams?.get('view'));
-    const isHiddenFoldersVisible =
-        searchParams?.get(HIDDEN_FOLDERS_QUERY_PARAM) === HIDDEN_FOLDERS_VISIBLE_QUERY_VALUE;
-
-    const setViewMode = useCallback(
-        (mode: HomeViewMode) => {
-            const nextSearchParams = new URLSearchParams(searchParams?.toString() || '');
-            const viewQueryValue = getHomeViewQueryValue(mode);
-
-            if (viewQueryValue === null) {
-                nextSearchParams.delete('view');
-            } else {
-                nextSearchParams.set('view', viewQueryValue);
-            }
-
-            updateCurrentPathQuery(nextSearchParams, 'replace');
-        },
-        [searchParams, updateCurrentPathQuery],
-    );
+    const isHiddenFoldersVisible = searchParams?.get(HIDDEN_FOLDERS_QUERY_PARAM) === HIDDEN_FOLDERS_VISIBLE_QUERY_VALUE;
 
     const setHiddenFoldersVisible = useCallback(
         (isVisible: boolean) => {
@@ -90,8 +68,6 @@ export function useAgentsListQueryState(): UseAgentsListQueryStateResult {
         routeSyncKey,
         searchParamsSnapshot,
         setHiddenFoldersVisible,
-        setViewMode,
-        viewMode,
         updateCurrentPathQuery,
     };
 }