@automattic/data-stores 3.2.0 → 3.2.1

package/dist/types/wpcom-plans-ui/actions.d.ts

@@ -13,7 +13,7 @@ export declare const setSelectedStorageOptionForPlan: ({ addOnSlug, planSlug, si
     siteId?: number | null;
 }) => {
     readonly type: "WPCOM_PLANS_UI_SET_SELECTED_STORAGE_OPTION_FOR_PLAN";
-    readonly addOnSlug: "50gb-storage-add-on" | "100gb-storage-add-on" | "150gb-storage-add-on" | "200gb-storage-add-on" | "250gb-storage-add-on" | "300gb-storage-add-on" | "350gb-storage-add-on" | "1gb-storage" | "3gb-storage" | "6gb-storage" | "13gb-storage" | "50gb-storage" | "200gb-storage" | "p2-13gb-storage" | "p2-3gb-storage";
+    readonly addOnSlug: "50gb-storage-add-on" | "100gb-storage-add-on" | "150gb-storage-add-on" | "200gb-storage-add-on" | "250gb-storage-add-on" | "300gb-storage-add-on" | "350gb-storage-add-on" | WPComPlanStorageFeatureSlug;
     readonly planSlug: PlanSlug;
     readonly siteId: number | null | undefined;
 };

package/dist/types/wpcom-plans-ui/index.d.ts

@@ -2,5 +2,5 @@ import * as actions from './actions';
 import { State } from './reducer';
 import * as selectors from './selectors';
 export type { State };
-export declare const store: import("@wordpress/data/build-types/types").StoreDescriptor<import("@wordpress/data/build-types/types").ReduxStoreConfig<unknown, typeof actions, typeof selectors>>;
+export declare const store: import("@wordpress/data").StoreDescriptor<import("@wordpress/data").ReduxStoreConfig<unknown, typeof actions, typeof selectors>>;
 //# sourceMappingURL=index.d.ts.map

package/dist/types/wpcom-plans-ui/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/wpcom-plans-ui/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,OAAO,MAAM,WAAW,CAAC;AAErC,OAAgB,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,KAAK,SAAS,MAAM,aAAa,CAAC;AAIzC,YAAY,EAAE,KAAK,EAAE,CAAC;AAEtB,eAAO,MAAM,KAAK,sKAKf,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/wpcom-plans-ui/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,OAAO,MAAM,WAAW,CAAC;AAErC,OAAgB,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,KAAK,SAAS,MAAM,aAAa,CAAC;AAIzC,YAAY,EAAE,KAAK,EAAE,CAAC;AAEtB,eAAO,MAAM,KAAK,kIAKf,CAAC"}

package/dist/types/wpcom-request-controls/index.d.ts

@@ -1,4 +1,4 @@
-import wpcomProxyRequest from 'wpcom-proxy-request';
+import wpcomProxyRequest from '../wpcom-request';
 type WpcomProxyRequestOptions = Parameters<typeof wpcomProxyRequest>[0];
 export declare const wpcomRequest: (request: WpcomProxyRequestOptions) => {
     type: "WPCOM_REQUEST";

package/dist/types/wpcom-request-controls/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/wpcom-request-controls/index.ts"],"names":[],"mappings":"AAAA,OAAO,iBAGN,MAAM,qBAAqB,CAAC;AAE7B,KAAK,wBAAwB,GAAG,UAAU,CAAE,OAAO,iBAAiB,CAAE,CAAE,CAAC,CAAE,CAAC;AAE5E,eAAO,MAAM,YAAY,GACxB,SAAS,wBAAwB,KAC/B;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,OAAO,EAAE,wBAAwB,CAAA;CACb,CAAC;AAEjD;;;;;;GAMG;AACH,eAAO,MAAM,aAAa,GACzB,UAAU,UAAU,CAAE,MAAM,CAAE,OAAO,CAAE,CAAE,CAAE,CAAC,CAAE,EAC9C,UAAU,UAAU,CAAE,MAAM,CAAE,OAAO,CAAE,CAAE,CAAE,CAAC,CAAE;;;;CAMlC,CAAC;AAEd,eAAO,MAAM,WAAW;;CAGX,CAAC;AAEd,eAAO,MAAM,qBAAqB;;CAGrB,CAAC;AAEd,eAAO,MAAM,IAAI,GAAK,IAAI,MAAM;;;CAAuC,CAAC;AAExE,eAAO,MAAM,QAAQ;0CACU,UAAU,CAAE,OAAO,YAAY,CAAE;sDACf,UAAU,CAAE,OAAO,aAAa,CAAE;;;;;;4BAYlE,UAAU,CAAE,OAAO,IAAI,CAAE;CAEhC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/wpcom-request-controls/index.ts"],"names":[],"mappings":"AAIA,OAAO,iBAAiB,MAAM,kBAAkB,CAAC;AAEjD,KAAK,wBAAwB,GAAG,UAAU,CAAE,OAAO,iBAAiB,CAAE,CAAE,CAAC,CAAE,CAAC;AAE5E,eAAO,MAAM,YAAY,GACxB,SAAS,wBAAwB,KAC/B;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,OAAO,EAAE,wBAAwB,CAAA;CACb,CAAC;AAEjD;;;;;;GAMG;AACH,eAAO,MAAM,aAAa,GACzB,UAAU,UAAU,CAAE,MAAM,CAAE,OAAO,CAAE,CAAE,CAAE,CAAC,CAAE,EAC9C,UAAU,UAAU,CAAE,MAAM,CAAE,OAAO,CAAE,CAAE,CAAE,CAAC,CAAE;;;;CAMlC,CAAC;AAEd,eAAO,MAAM,WAAW;;CAGX,CAAC;AAEd,eAAO,MAAM,qBAAqB;;CAGrB,CAAC;AAEd,eAAO,MAAM,IAAI,GAAK,IAAI,MAAM;;;CAAuC,CAAC;AAExE,eAAO,MAAM,QAAQ;0CACU,UAAU,CAAE,OAAO,YAAY,CAAE;sDACf,UAAU,CAAE,OAAO,aAAa,CAAE;;;;;;4BAYlE,UAAU,CAAE,OAAO,IAAI,CAAE;CAEhC,CAAC"}

package/dist/types/wpcom-request.d.ts

@@ -0,0 +1,7 @@
+import { type WpcomRequestParams } from 'wpcom-proxy-request';
+type WpcomRequester = <T>(params: WpcomRequestParams) => Promise<T>;
+export declare function setRequester(requester: WpcomRequester): void;
+export default function wpcomRequest<T>(params: WpcomRequestParams): Promise<T>;
+export declare function canAccessWpcomApis(): boolean;
+export {};
+//# sourceMappingURL=wpcom-request.d.ts.map

package/dist/types/wpcom-request.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wpcom-request.d.ts","sourceRoot":"","sources":["../../src/wpcom-request.ts"],"names":[],"mappings":"AAAA,OAA0B,EACzB,KAAK,kBAAkB,EAEvB,MAAM,qBAAqB,CAAC;AAE7B,KAAK,cAAc,GAAG,CAAE,CAAC,EAAI,MAAM,EAAE,kBAAkB,KAAM,OAAO,CAAE,CAAC,CAAE,CAAC;AAI1E,wBAAgB,YAAY,CAAE,SAAS,EAAE,cAAc,GAAI,IAAI,CAE9D;AAED,MAAM,CAAC,OAAO,UAAU,YAAY,CAAE,CAAC,EAAI,MAAM,EAAE,kBAAkB,GAAI,OAAO,CAAE,CAAC,CAAE,CAKpF;AAED,wBAAgB,kBAAkB,IAAI,OAAO,CAK5C"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@automattic/data-stores",
-  "version": "3.2.0",
+  "version": "3.2.1",
   "description": "Calypso Data Stores.",
   "homepage": "https://github.com/Automattic/wp-calypso",
   "license": "GPL-2.0-or-later",
@@ -44,44 +44,45 @@
   },
   "dependencies": {
     "@automattic/api-core": "^1.0.0",
-    "@automattic/calypso-analytics": "^1.1.3",
+    "@automattic/api-queries": "^1.0.0",
+    "@automattic/calypso-analytics": "^1.1.5",
     "@automattic/calypso-config": "^1.0.0-alpha.0",
-    "@automattic/calypso-products": "^1.2.2",
-    "@automattic/i18n-utils": "^1.2.3",
+    "@automattic/calypso-products": "^1.2.3",
+    "@automattic/design-types": "^1.0.0",
+    "@automattic/i18n-utils": "^1.2.4",
     "@automattic/js-utils": "^0.1.0",
-    "@automattic/number-formatters": "^1.0.1",
+    "@automattic/number-formatters": "^1.2.0",
     "@automattic/oauth-token": "^1.0.1",
-    "@automattic/shopping-cart": "^2.0.1",
+    "@automattic/shopping-cart": "^2.0.2",
     "@tanstack/react-query": "^5.83.0",
-    "@wordpress/api-fetch": "^7.23.0",
-    "@wordpress/data-controls": "^4.23.0",
-    "@wordpress/deprecated": "^4.23.0",
-    "@wordpress/element": "^6.23.0",
-    "@wordpress/i18n": "^5.23.0",
-    "@wordpress/primitives": "^4.23.0",
-    "@wordpress/url": "^4.23.0",
+    "@wordpress/api-fetch": "^7.48.0",
+    "@wordpress/data-controls": "^4.48.0",
+    "@wordpress/deprecated": "^4.48.0",
+    "@wordpress/element": "^8.0.0",
+    "@wordpress/i18n": "^6.21.0",
+    "@wordpress/primitives": "^4.48.0",
+    "@wordpress/url": "^4.48.0",
     "debug": "^4.4.1",
-    "i18n-calypso": "^7.4.0",
-    "qs": "^6.9.1",
-    "react": "^18.3.1",
-    "react-dom": "^18.3.1",
+    "i18n-calypso": "^7.4.1",
+    "qs": "^6.15.2",
     "redux": "^5.0.1",
     "tslib": "^2.8.1",
     "utility-types": "^3.10.0",
     "wpcom-proxy-request": "^7.0.7"
   },
   "peerDependencies": {
-    "@wordpress/data": "^10.23.0",
-    "react": "^18.3.1",
-    "react-dom": "^18.3.1"
+    "@wordpress/data": "^10.48.0",
+    "react": "^18.3.1 || ^19.0.0",
+    "react-dom": "^18.3.1 || ^19.0.0"
   },
   "devDependencies": {
     "@automattic/calypso-typescript-config": "^1.0.0",
-    "@automattic/design-picker": "^1.0.0",
     "@remix-run/router": "^1.5.0",
     "jest-fetch-mock": "^3.0.3",
     "nock": "^13.5.6",
-    "typescript": "^5.8.3",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1",
+    "typescript": "^6.0.3",
     "wait-for-expect": "^3.0.2"
   }
 }

package/src/add-ons/types.ts

@@ -1,6 +1,7 @@
 import { TranslateResult } from 'i18n-calypso';
 import { STORAGE_ADD_ONS, ADD_ONS } from './constants';
 import type { StoreProductSlug } from '../products-list';
+import type { JSX } from 'react';
 
 export interface AddOnMeta {
 	addOnSlug: AddOnSlug;

package/src/agents-manager/actions.ts

@@ -0,0 +1,151 @@
+import { GeneratorReturnType } from '../mapped-types';
+import { persistAgentsManagerState } from './persist-state';
+import { PerSiteLastActivity, PerSiteRouterHistory } from './types';
+
+/**
+ * Partial state object for saving agents manager preferences
+ */
+type AgentsManagerState = {
+	isOpen?: boolean;
+	isDocked?: boolean;
+	isMinimized?: boolean;
+	floatingPosition?: 'left' | 'right';
+	routerHistory?: null; // Only used to clear history
+};
+
+/**
+ * Save the agents manager state to the remote user preferences.
+ * @param state - Partial state object with the properties to save
+ * @yields {Object} Action to set router history if closing
+ */
+export function* saveAgentsManagerState( state: AgentsManagerState ) {
+	const saveState: Record< string, boolean | string | null > = {};
+
+	if ( typeof state.isOpen === 'boolean' ) {
+		saveState.agents_manager_open = state.isOpen;
+
+		//TODO: Figure out the trigger to reset the chat on agents manager
+		// Help center resets when closing. But the agents manager might be different.
+		if ( ! state.isOpen ) {
+			saveState.agents_manager_router_history = null;
+			yield setRouterHistory( undefined );
+		}
+	}
+
+	if ( typeof state.isDocked === 'boolean' ) {
+		saveState.agents_manager_docked = state.isDocked;
+	}
+
+	if ( typeof state.isMinimized === 'boolean' ) {
+		saveState.agents_manager_minimized = state.isMinimized;
+	}
+
+	if ( state.floatingPosition === 'left' || state.floatingPosition === 'right' ) {
+		saveState.agents_manager_floating_position = state.floatingPosition;
+	}
+
+	// Only make API call if there's something to save
+	if ( Object.keys( saveState ).length === 0 ) {
+		return;
+	}
+
+	persistAgentsManagerState( saveState );
+}
+
+export function setRouterHistory( history: PerSiteRouterHistory | undefined ) {
+	return {
+		type: 'AGENTS_MANAGER_SET_ROUTER_HISTORY',
+		history,
+	} as const;
+}
+
+export function* setIsOpen( isOpen: boolean, shouldSave: boolean = true ) {
+	if ( shouldSave ) {
+		yield saveAgentsManagerState( { isOpen } );
+	}
+
+	return {
+		type: 'AGENTS_MANAGER_SET_OPEN',
+		isOpen,
+	} as const;
+}
+
+export function* setIsDocked( isDocked: boolean, shouldSave: boolean = true ) {
+	if ( shouldSave ) {
+		yield saveAgentsManagerState( { isDocked } );
+	}
+
+	return {
+		type: 'AGENTS_MANAGER_SET_DOCKED',
+		isDocked,
+	} as const;
+}
+
+export function* setIsMinimized( isMinimized: boolean, shouldSave: boolean = true ) {
+	if ( shouldSave ) {
+		yield saveAgentsManagerState( { isMinimized } );
+	}
+
+	return {
+		type: 'AGENTS_MANAGER_SET_MINIMIZED',
+		isMinimized,
+	} as const;
+}
+
+export function* setFloatingPosition(
+	floatingPosition: 'left' | 'right',
+	shouldSave: boolean = true
+) {
+	if ( shouldSave ) {
+		yield saveAgentsManagerState( { floatingPosition } );
+	}
+
+	return {
+		type: 'AGENTS_MANAGER_SET_FLOATING_POSITION',
+		floatingPosition,
+	} as const;
+}
+
+export function setLastActivity( lastActivity: PerSiteLastActivity | undefined ) {
+	return {
+		type: 'AGENTS_MANAGER_SET_LAST_ACTIVITY',
+		lastActivity,
+	} as const;
+}
+
+export function setIsLoading( isLoading: boolean ) {
+	return {
+		type: 'AGENTS_MANAGER_SET_LOADING',
+		isLoading,
+	} as const;
+}
+
+/**
+ * Toggle split-screen mode (docked sidebar grows to cover ~50% of the
+ * viewport). Session-scoped — intentionally not persisted to user prefs so
+ * the expanded layout doesn't follow the user into unrelated contexts.
+ */
+export function setIsSplitScreen( isSplitScreen: boolean ) {
+	return {
+		type: 'AGENTS_MANAGER_SET_SPLIT_SCREEN',
+		isSplitScreen,
+	} as const;
+}
+
+export function setHasLoaded( hasLoaded: boolean ) {
+	return {
+		type: 'AGENTS_MANAGER_SET_HAS_LOADED',
+		hasLoaded,
+	} as const;
+}
+
+export type AgentsManagerAction =
+	| ReturnType< typeof setRouterHistory >
+	| ReturnType< typeof setLastActivity >
+	| ReturnType< typeof setIsLoading >
+	| ReturnType< typeof setHasLoaded >
+	| ReturnType< typeof setIsSplitScreen >
+	| GeneratorReturnType< typeof setIsOpen >
+	| GeneratorReturnType< typeof setIsDocked >
+	| GeneratorReturnType< typeof setIsMinimized >
+	| GeneratorReturnType< typeof setFloatingPosition >;

package/src/agents-manager/constants.ts

@@ -0,0 +1 @@
+export const STORE_KEY = 'automattic/agents-manager';

package/src/agents-manager/index.ts

@@ -0,0 +1,38 @@
+import { registerStore } from '@wordpress/data';
+import { controls } from '@wordpress/data-controls';
+import { registerPlugins } from '../plugins';
+import { isE2ETest, isInSupportSession } from '../utils';
+import { controls as wpcomRequestControls } from '../wpcom-request-controls';
+import * as actions from './actions';
+import { STORE_KEY } from './constants';
+import reducer, { State } from './reducer';
+import { getAgentsManagerState } from './resolvers';
+import * as selectors from './selectors';
+export type { State };
+export { persistAgentsManagerState } from './persist-state';
+
+let isRegistered = false;
+
+export function register(): typeof STORE_KEY {
+	if ( isRegistered ) {
+		return STORE_KEY;
+	}
+
+	const enabledPersistedOpenState = ! isE2ETest() && ! isInSupportSession();
+
+	registerPlugins();
+
+	registerStore( STORE_KEY, {
+		actions,
+		reducer,
+		controls: { ...controls, ...wpcomRequestControls },
+		selectors,
+		persist: [],
+		// Don't persist the open state for e2e users, because parallel tests will start interfering with each other.
+		resolvers: enabledPersistedOpenState ? { getAgentsManagerState } : undefined,
+	} );
+
+	isRegistered = true;
+
+	return STORE_KEY;
+}

package/src/agents-manager/persist-state.ts

@@ -0,0 +1,60 @@
+import { default as apiFetchPromise } from '@wordpress/api-fetch';
+import { default as wpcomRequestPromise, canAccessWpcomApis } from '../wpcom-request';
+import type { APIFetchOptions } from '../shared-types';
+
+/**
+ * The Agents Manager stores all its preferences in a single blob that the
+ * server read-modify-writes on every save. Two concurrent requests race on that
+ * blob (last writer wins), so one partial save can revert another — e.g. a
+ * trailing `router_history` write reverting `minimized`.
+ *
+ * To prevent that, we keep at most one request in flight and merge any saves
+ * that arrive meanwhile into a single follow-up request. Saves are
+ * fire-and-forget; callers don't await the result.
+ */
+let pending: Record< string, unknown > = {};
+let inFlight = false;
+
+function send( state: Record< string, unknown > ): Promise< unknown > {
+	if ( canAccessWpcomApis() ) {
+		return wpcomRequestPromise( {
+			path: '/agents-manager/state',
+			apiNamespace: 'wpcom/v2',
+			method: 'POST',
+			body: { state },
+		} );
+	}
+	return apiFetchPromise( {
+		global: true,
+		path: '/agents-manager/open-state',
+		method: 'PUT',
+		data: state,
+	} as APIFetchOptions );
+}
+
+function flush(): void {
+	if ( inFlight || Object.keys( pending ).length === 0 ) {
+		return;
+	}
+
+	const state = pending;
+	pending = {};
+	inFlight = true;
+
+	// Whatever the outcome, free the slot and send anything that accumulated
+	// while this request was in flight.
+	const done = () => {
+		inFlight = false;
+		flush();
+	};
+	send( state ).then( done, done );
+}
+
+/**
+ * Persist a partial Agents Manager state to the user's preferences.
+ * @param state - Object with the prefs to save (e.g. `{ agents_manager_minimized: false }`).
+ */
+export function persistAgentsManagerState( state: Record< string, unknown > ): void {
+	Object.assign( pending, state );
+	flush();
+}

package/src/agents-manager/reducer.ts

@@ -0,0 +1,106 @@
+import { combineReducers } from '@wordpress/data';
+import { PerSiteLastActivity, PerSiteRouterHistory } from './types';
+import type { AgentsManagerAction } from './actions';
+import type { Reducer } from 'redux';
+
+const isOpen: Reducer< boolean, AgentsManagerAction > = ( state = false, action ) => {
+	switch ( action.type ) {
+		case 'AGENTS_MANAGER_SET_OPEN':
+			return action.isOpen;
+	}
+	return state;
+};
+
+const isDocked: Reducer< boolean, AgentsManagerAction > = ( state = false, action ) => {
+	switch ( action.type ) {
+		case 'AGENTS_MANAGER_SET_DOCKED':
+			return action.isDocked;
+	}
+	return state;
+};
+
+export const isMinimized: Reducer< boolean, AgentsManagerAction > = ( state = false, action ) => {
+	switch ( action.type ) {
+		case 'AGENTS_MANAGER_SET_MINIMIZED':
+			return action.isMinimized;
+	}
+	return state;
+};
+
+const routerHistory: Reducer< PerSiteRouterHistory | undefined, AgentsManagerAction > = (
+	state,
+	action
+) => {
+	switch ( action.type ) {
+		case 'AGENTS_MANAGER_SET_ROUTER_HISTORY':
+			return action.history;
+	}
+	return state;
+};
+
+const lastActivity: Reducer< PerSiteLastActivity | undefined, AgentsManagerAction > = (
+	state,
+	action
+) => {
+	switch ( action.type ) {
+		case 'AGENTS_MANAGER_SET_LAST_ACTIVITY':
+			return action.lastActivity;
+	}
+	return state;
+};
+
+const isLoading: Reducer< boolean, AgentsManagerAction > = ( state = false, action ) => {
+	switch ( action.type ) {
+		case 'AGENTS_MANAGER_SET_LOADING':
+			return action.isLoading;
+	}
+	return state;
+};
+
+const hasLoaded: Reducer< boolean, AgentsManagerAction > = ( state = false, action ) => {
+	switch ( action.type ) {
+		case 'AGENTS_MANAGER_SET_HAS_LOADED':
+			return action.hasLoaded;
+	}
+	return state;
+};
+
+const floatingPosition: Reducer< 'left' | 'right', AgentsManagerAction > = (
+	state = 'right',
+	action
+) => {
+	switch ( action.type ) {
+		case 'AGENTS_MANAGER_SET_FLOATING_POSITION':
+			return action.floatingPosition;
+	}
+	return state;
+};
+
+export const isSplitScreen: Reducer< boolean, AgentsManagerAction > = ( state = false, action ) => {
+	switch ( action.type ) {
+		case 'AGENTS_MANAGER_SET_SPLIT_SCREEN':
+			return action.isSplitScreen;
+		// Split-screen only makes sense while docked. Reset on undock so an
+		// out-of-band `setIsDocked(false)` (e.g. from `window.__agentsManagerActions`)
+		// can't leave a stale `true` that re-applies on the next dock.
+		case 'AGENTS_MANAGER_SET_DOCKED':
+			return action.isDocked ? state : false;
+	}
+	return state;
+};
+
+const reducer = combineReducers( {
+	isOpen,
+	isDocked,
+	isMinimized,
+	routerHistory,
+	lastActivity,
+	isLoading,
+	hasLoaded,
+	floatingPosition,
+	isSplitScreen,
+} );
+
+export type State = ReturnType< typeof reducer >;
+
+export default reducer;

package/src/agents-manager/resolvers.ts

@@ -0,0 +1,87 @@
+import { apiFetch } from '@wordpress/data-controls';
+import { canAccessWpcomApis } from '../wpcom-request';
+import { wpcomRequest } from '../wpcom-request-controls';
+import {
+	setRouterHistory,
+	setLastActivity,
+	setIsDocked,
+	setIsMinimized,
+	setIsOpen,
+	setIsLoading,
+	setHasLoaded,
+	setFloatingPosition,
+} from './actions';
+import type { PerSiteLastActivity, PerSiteRouterHistory } from './types';
+import type { APIFetchOptions } from '../shared-types';
+
+const VALID_SITE_KEY = /^\d+$|^no-site$/;
+
+/**
+ * Validate that the router history is in the expected per-site format,
+ * keyed by numeric site ID or 'no-site'.
+ */
+function isValidRouterHistory( value: unknown ): value is PerSiteRouterHistory {
+	return (
+		value !== null &&
+		typeof value === 'object' &&
+		Object.keys( value ).every( ( key ) => VALID_SITE_KEY.test( key ) )
+	);
+}
+
+type AgentsManagerStateResponse = {
+	agents_manager_open?: boolean;
+	agents_manager_docked?: boolean;
+	agents_manager_minimized?: boolean;
+	agents_manager_floating_position?: 'left' | 'right';
+	agents_manager_router_history?: PerSiteRouterHistory;
+	agents_manager_last_activity?: PerSiteLastActivity;
+};
+
+export function* getAgentsManagerState() {
+	yield setIsLoading( true );
+	try {
+		const state: AgentsManagerStateResponse = canAccessWpcomApis()
+			? yield wpcomRequest( {
+					path: '/agents-manager/state',
+					apiNamespace: 'wpcom/v2',
+			  } )
+			: yield apiFetch( {
+					global: true,
+					path: '/agents-manager/open-state',
+			  } as APIFetchOptions );
+
+		const activityMap = state.agents_manager_last_activity;
+		if ( activityMap ) {
+			yield setLastActivity( activityMap );
+		}
+
+		if ( isValidRouterHistory( state.agents_manager_router_history ) ) {
+			yield setRouterHistory( state.agents_manager_router_history );
+		}
+
+		if ( typeof state.agents_manager_docked === 'boolean' ) {
+			yield setIsDocked( state.agents_manager_docked, false );
+		}
+
+		if ( typeof state.agents_manager_minimized === 'boolean' ) {
+			yield setIsMinimized( state.agents_manager_minimized, false );
+		}
+
+		if (
+			state.agents_manager_floating_position === 'left' ||
+			state.agents_manager_floating_position === 'right'
+		) {
+			yield setFloatingPosition( state.agents_manager_floating_position, false );
+		}
+
+		// We only want to auto-open, we don't want to auto-close (and potentially overrule the user's action).
+		if ( state.agents_manager_open ) {
+			yield setIsOpen( true, false );
+		}
+	} catch {
+		// Ignore errors
+	} finally {
+		yield setIsLoading( false );
+		yield setHasLoaded( true );
+	}
+}

package/src/agents-manager/selectors.ts

@@ -0,0 +1,32 @@
+import type { State } from './reducer';
+
+export const getAgentsManagerState = ( state: State ) => ( {
+	isOpen: state.isOpen,
+	isDocked: state.isDocked,
+	isMinimized: state.isMinimized,
+	routerHistory: state.routerHistory,
+	lastActivity: state.lastActivity,
+	isLoading: state.isLoading,
+	hasLoaded: state.hasLoaded,
+	floatingPosition: state.floatingPosition,
+	isSplitScreen: state.isSplitScreen,
+} );
+export const getIsOpen = ( state: State ) => state.isOpen;
+export const getIsDocked = ( state: State ) => state.isDocked;
+export const getIsMinimized = ( state: State ) => state.isMinimized;
+export const getIsSplitScreen = ( state: State ) => state.isSplitScreen;
+export const getRouterHistory = ( state: State, siteKey: string ) => {
+	if ( ! state.routerHistory ) {
+		return undefined;
+	}
+	return state.routerHistory[ siteKey ];
+};
+export const getLastActivity = ( state: State, siteKey: string ) => {
+	if ( ! state.lastActivity ) {
+		return undefined;
+	}
+	return state.lastActivity[ siteKey ];
+};
+export const getIsLoading = ( state: State ) => state.isLoading;
+export const getHasLoaded = ( state: State ) => state.hasLoaded;
+export const getFloatingPosition = ( state: State ) => state.floatingPosition;