The open-source app everyone uses to manage agents at work
TypeScript acpxagent-orchestrationagent-skillsagentic-aiai-agentsai-engineeringai-governanceai-toolsautonomous-agentsclaudeclaude-codeclaude-skillscodexhermesllmmcpmulti-agentopenclawproject-managementworkflow-automation
import { useContext } from "react";
import type { InstanceExperimentalSettings } from "@paperclipai/shared";
import { QueryClient, QueryClientContext, useQuery } from "@tanstack/react-query";
import { instanceSettingsApi } from "@/api/instanceSettings";
import { queryKeys } from "@/lib/queryKeys";
import { resolveStreamlinedUiEnabled } from "./useStreamlinedUiEnabled";
/** On only when opted in and the streamlined shell (which hosts it) is on. */
export function resolveCombinedInboxTasksEnabled(
settings: Partial<Pick<InstanceExperimentalSettings, "enableCombinedInboxTasks" | "enableStreamlinedUi">> | null | undefined,
): boolean {
return settings?.enableCombinedInboxTasks === true
&& resolveStreamlinedUiEnabled({ enableStreamlinedUi: settings.enableStreamlinedUi ?? true });
}
let detachedClient: QueryClient | null = null;
function getDetachedClient(): QueryClient {
detachedClient ??= new QueryClient();
return detachedClient;
}
/**
* Combined Inbox + Task List (Settings > Experimental): Inbox becomes views
* inside Tasks — no Inbox nav row, the unread badge on Tasks, a Views menu on
* /issues and /inbox/* redirects. Off by default — and off when rendered outside a query
* client, as the app root is in some harnesses — so every surface renders as
* before until an instance opts in. The merged Tasks page only exists in the
* streamlined shell, so the legacy shell always reports it off.
*/
export function useCombinedInboxTasksEnabled(): { enabled: boolean; loaded: boolean } {
const contextClient = useContext(QueryClientContext);
const query = useQuery(
{
queryKey: queryKeys.instance.experimentalSettings,
queryFn: () => instanceSettingsApi.getExperimental(),
enabled: contextClient != null,
},
contextClient ?? getDetachedClient(),
);
if (!contextClient) return { enabled: false, loaded: true };
return {
enabled: resolveCombinedInboxTasksEnabled(query.data),
loaded: query.isFetched,
};
}