@agimon-ai/po-web-dashboard 0.0.0-alpha.0

package/dist/web/features/sessions/useSessionRail.cjs

@@ -0,0 +1,302 @@
+const require_pluginRegistry = require("../../lib/pluginRegistry.cjs");
+const require_composition = require("../../lib/composition.cjs");
+const require_hubApi = require("../../lib/hubApi.cjs");
+const require_sessionAvatar = require("../../lib/sessionAvatar.cjs");
+const require_sessionMcpApi = require("../../lib/sessionMcpApi.cjs");
+const require_sessionRailModel = require("../../lib/sessionRailModel.cjs");
+const require_settingsSections = require("../../lib/settingsSections.cjs");
+const require_sessionsStore = require("../../stores/sessionsStore.cjs");
+const require_sessionStore = require("../../stores/sessionStore.cjs");
+const require_newSessionStore = require("../../stores/newSessionStore.cjs");
+const require_paletteStore = require("../../stores/paletteStore.cjs");
+const require_railDialogStore = require("../../stores/railDialogStore.cjs");
+const require_remoteAccessStore = require("../../stores/remoteAccessStore.cjs");
+const require_workspacesStore = require("../../stores/workspacesStore.cjs");
+const require_workspaceAdmissionStore = require("../../stores/workspaceAdmissionStore.cjs");
+const require_PluginSurface = require("../../components/PluginSurface.cjs");
+let react = require("react");
+let _tanstack_react_router = require("@tanstack/react-router");
+let _tanstack_react_store = require("@tanstack/react-store");
+let react_jsx_runtime = require("react/jsx-runtime");
+//#region src/web/features/sessions/useSessionRail.tsx
+const STATUS_REFRESH_MS = 3e4;
+function isEditable(target) {
+	if (!(target instanceof HTMLElement)) return false;
+	return target.isContentEditable || target.tagName === "INPUT" || target.tagName === "TEXTAREA";
+}
+/** A key pressed inside an overlay belongs to that overlay, never to the rail. */
+function insideOverlay(target) {
+	return target instanceof Element && target.closest("[role=\"dialog\"], [role=\"menu\"], [role=\"alertdialog\"]") !== null;
+}
+/**
+* Loads each distinct profile avatar once, keyed by profile and icon version so
+* sessions sharing a persona share one image, and revokes images no card shows.
+*/
+function useSessionAvatars(order, byId) {
+	const wanted = /* @__PURE__ */ new Map();
+	for (const id of order) {
+		const profile = byId[id]?.summary.profile;
+		if (profile?.iconVersion !== void 0) wanted.set(id, `${profile.name}:${profile.iconVersion}`);
+	}
+	const wantedKey = [...wanted].map(([id, key]) => `${id}=${key}`).join("\n");
+	const [loaded, setLoaded] = (0, react.useState)({});
+	const requested = (0, react.useRef)(/* @__PURE__ */ new Set());
+	(0, react.useEffect)(() => {
+		const keys = new Set(wanted.values());
+		for (const [id, key] of wanted) {
+			if (requested.current.has(key)) continue;
+			requested.current.add(key);
+			const version = key.slice(key.lastIndexOf(":") + 1);
+			require_sessionAvatar.loadSessionAvatar(id, version).then((url) => setLoaded((previous) => ({
+				...previous,
+				[key]: url
+			})), () => void 0);
+		}
+		setLoaded((previous) => {
+			const stale = Object.keys(previous).filter((key) => !keys.has(key));
+			if (stale.length === 0) return previous;
+			const next = { ...previous };
+			for (const key of stale) {
+				URL.revokeObjectURL(next[key]);
+				delete next[key];
+				requested.current.delete(key);
+			}
+			return next;
+		});
+	}, [wantedKey]);
+	(0, react.useEffect)(() => () => {
+		setLoaded((previous) => {
+			for (const url of Object.values(previous)) URL.revokeObjectURL(url);
+			return {};
+		});
+	}, []);
+	const urls = {};
+	for (const [id, key] of wanted) {
+		const url = loaded[key];
+		if (url !== void 0) urls[id] = url;
+	}
+	return urls;
+}
+/**
+* The session rail as data and actions for the active template.
+*
+* Owns what must keep working whichever template renders (or hides) the rail:
+* the status clock, workspace hydration, the Ctrl+T and 1-9 shortcuts, and the
+* actions that reach the hub and the router.
+*/
+function useSessionRail({ onDismiss }) {
+	const navigate = (0, _tanstack_react_router.useNavigate)();
+	const scrollTop = (0, react.useRef)(0);
+	const scrollRef = (0, react.useCallback)((element) => {
+		if (element === null) return;
+		element.scrollTop = scrollTop.current;
+		return () => {
+			scrollTop.current = element.scrollTop;
+		};
+	}, []);
+	const order = (0, _tanstack_react_store.useStore)(require_sessionsStore.sessionsStore, (state) => state.order);
+	const byId = (0, _tanstack_react_store.useStore)(require_sessionsStore.sessionsStore, (state) => state.byId);
+	const activeId = (0, _tanstack_react_store.useStore)(require_sessionsStore.sessionsStore, (state) => state.activeId);
+	const workspaceOrder = (0, _tanstack_react_store.useStore)(require_workspacesStore.workspacesStore, (state) => state.order);
+	const workspacesById = (0, _tanstack_react_store.useStore)(require_workspacesStore.workspacesStore, (state) => state.byId);
+	const selectedWorkspaceId = (0, _tanstack_react_store.useStore)(require_workspacesStore.workspacesStore, (state) => state.selectedId);
+	const workspacesHydrated = (0, _tanstack_react_store.useStore)(require_workspacesStore.workspacesStore, (state) => state.hydrated);
+	const hasDialog = (0, _tanstack_react_store.useStore)(require_sessionStore.sessionStoreFor(activeId), (state) => state.dialog !== null);
+	const remote = (0, _tanstack_react_store.useStore)(require_remoteAccessStore.remoteAccessStore, (state) => state.view);
+	const creating = (0, _tanstack_react_store.useStore)(require_newSessionStore.newSessionStore, (state) => state);
+	const [now, setNow] = (0, react.useState)(() => Date.now());
+	const restarts = (0, _tanstack_react_store.useStore)(require_railDialogStore.railRestartStore);
+	const avatarUrls = useSessionAvatars(order, byId);
+	const backgroundWorkKey = (0, react.useSyncExternalStore)((0, react.useCallback)((listener) => {
+		const releases = [require_composition.subscribeActivitySources(listener), ...order.map((id) => {
+			const subscription = require_sessionStore.sessionStoreFor(id).subscribe(listener);
+			return () => subscription.unsubscribe();
+		})];
+		return () => releases.forEach((release) => release());
+	}, [order]), () => JSON.stringify(order.filter((id) => {
+		const { statuses, widgets } = require_sessionStore.sessionStoreFor(id).state;
+		return require_composition.activityGroups(statuses, widgets, id).some((group) => group.active && group.marksBackgroundWork !== false);
+	})));
+	const backgroundWorkSessions = (0, react.useMemo)(() => new Set(JSON.parse(backgroundWorkKey)), [backgroundWorkKey]);
+	(0, react.useEffect)(() => {
+		const timer = setInterval(() => setNow(Date.now()), STATUS_REFRESH_MS);
+		return () => clearInterval(timer);
+	}, []);
+	(0, react.useEffect)(() => {
+		if (workspacesHydrated) return;
+		let stale = false;
+		require_hubApi.listWorkspaces().then((result) => {
+			if (!stale && "workspaces" in result) require_workspacesStore.applyWorkspacesSnapshot(result);
+		});
+		return () => {
+			stale = true;
+		};
+	}, [workspacesHydrated]);
+	(0, react.useEffect)(() => {
+		const workspaceId = activeId === null ? void 0 : byId[activeId]?.summary.workspaceId;
+		if (workspaceId !== void 0 && workspacesById[workspaceId] !== void 0) require_workspacesStore.selectWorkspace(workspaceId);
+	}, [
+		activeId,
+		byId,
+		workspacesById
+	]);
+	(0, react.useEffect)(() => {
+		const onKeyDown = (event) => {
+			if (event.ctrlKey && !event.metaKey && !event.altKey && event.key === "t") {
+				event.preventDefault();
+				onDismiss?.();
+				require_newSessionStore.openNewSession(selectedWorkspaceId);
+				return;
+			}
+			if (event.ctrlKey || event.metaKey || event.altKey || event.defaultPrevented) return;
+			if (isEditable(event.target) || insideOverlay(event.target) || require_paletteStore.paletteStore.state.open || hasDialog) return;
+			const ordinal = Number.parseInt(event.key, 10);
+			if (!Number.isInteger(ordinal) || ordinal < 1 || ordinal > 9) return;
+			const target = order[ordinal - 1];
+			if (target === void 0) return;
+			event.preventDefault();
+			onDismiss?.();
+			navigate({
+				to: "/session/$sessionId",
+				params: { sessionId: target }
+			});
+		};
+		window.addEventListener("keydown", onKeyDown);
+		return () => window.removeEventListener("keydown", onKeyDown);
+	}, [
+		order,
+		hasDialog,
+		navigate,
+		onDismiss,
+		selectedWorkspaceId
+	]);
+	const workspaces = (0, react.useMemo)(() => require_sessionRailModel.buildRailWorkspaces({
+		order,
+		byId,
+		activeId,
+		workspaceOrder,
+		workspacesById,
+		nested: new Set(order.filter((id) => require_sessionsStore.resolveParentId(byId, id) !== void 0)),
+		now,
+		restarts,
+		avatarUrls,
+		backgroundWorkSessions
+	}), [
+		order,
+		byId,
+		activeId,
+		workspaceOrder,
+		workspacesById,
+		now,
+		restarts,
+		avatarUrls,
+		backgroundWorkSessions
+	]);
+	const addingWorkspace = creating.open && (creating.workspaceId === null || workspacesById[creating.workspaceId] === void 0);
+	return {
+		workspaces,
+		scrollRef,
+		remote: {
+			status: remote?.status ?? "off",
+			deviceCount: remote?.devices.length ?? 0,
+			...remote?.publicUrl === void 0 ? {} : { host: new URL(remote.publicUrl).host },
+			...remote?.error === void 0 ? {} : { error: remote.error }
+		},
+		pluginContent: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_PluginSurface.PluginSurface, {
+			slot: require_pluginRegistry.HOST_SLOTS.rail,
+			sessionId: activeId
+		}),
+		...addingWorkspace ? { addWorkspace: { suggestedPaths: remote?.settings.sandbox.workspaces ?? [] } } : {},
+		actions: {
+			openSession(sessionId) {
+				onDismiss?.();
+				navigate({
+					to: "/session/$sessionId",
+					params: { sessionId }
+				});
+			},
+			renameSession(sessionId, name) {
+				const trimmed = name.trim();
+				if (trimmed !== "" && trimmed !== byId[sessionId]?.summary.name) require_sessionStore.renameSession(trimmed, sessionId);
+			},
+			restartSession(sessionId) {
+				require_railDialogStore.restartDashboardSession(sessionId);
+			},
+			async removeSession(sessionId) {
+				const result = await require_hubApi.stopSession(sessionId);
+				if ("error" in result) return { error: result.error };
+				require_sessionsStore.applySessionRemoved({ sessionId });
+			},
+			resumeSession(sessionId) {
+				require_railDialogStore.openResumeDialog({ sessionId });
+			},
+			createSession(workspaceId) {
+				require_workspacesStore.selectWorkspace(workspaceId);
+				onDismiss?.();
+				require_newSessionStore.openNewSession(workspaceId);
+			},
+			resumeInWorkspace(workspaceId) {
+				require_railDialogStore.openResumeDialog({ workspaceId });
+			},
+			openWorkspaceSettings(workspaceId) {
+				require_workspacesStore.selectWorkspace(workspaceId);
+				onDismiss?.();
+				navigate({
+					to: "/settings/$section",
+					params: { section: require_settingsSections.DEFAULT_REPOSITORY_SETTINGS_SECTION },
+					search: { workspace: workspaceId }
+				});
+			},
+			async deleteWorkspace(workspaceId) {
+				const result = await require_hubApi.removeWorkspace(workspaceId);
+				if ("error" in result) return { error: result.error };
+				require_workspacesStore.applyWorkspaceRemoved({ workspaceId });
+			},
+			openAddWorkspace() {
+				onDismiss?.();
+				require_newSessionStore.openNewSession(null);
+			},
+			closeAddWorkspace() {
+				if (require_workspaceAdmissionStore.workspaceAdmissionStore.state.pending) return;
+				require_workspaceAdmissionStore.resetWorkspaceAdmission();
+				require_newSessionStore.closeNewSession();
+			},
+			async addWorkspace(input) {
+				const result = await require_workspaceAdmissionStore.admitDashboardWorkspace(input);
+				if (result === void 0) require_newSessionStore.closeNewSession();
+				return result;
+			},
+			searchDirectories: require_hubApi.searchDirectories,
+			listDirectory: require_hubApi.listDirectory,
+			async removePendingSetup(sessionId, setupId) {
+				const workspaceId = byId[sessionId]?.summary.workspaceId;
+				if (workspaceId === void 0) return { error: "This session belongs to no workspace." };
+				const result = await require_sessionMcpApi.removeSessionMcpSetup(workspaceId, sessionId, setupId);
+				return "error" in result ? { error: result.error } : void 0;
+			},
+			openSettings() {
+				onDismiss?.();
+				navigate({
+					to: "/settings/$section",
+					params: { section: require_settingsSections.DEFAULT_SETTINGS_SECTION },
+					search: { workspace: selectedWorkspaceId ?? void 0 }
+				});
+			},
+			openRemoteAccess() {
+				onDismiss?.();
+				require_remoteAccessStore.openRemoteDialog();
+			},
+			turnRemoteAccessOff() {
+				require_remoteAccessStore.turnRemoteAccessOff();
+			},
+			renderSessionMenuItems: (sessionId) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_PluginSurface.PluginSurface, {
+				slot: require_pluginRegistry.HOST_SLOTS.sessionMenu,
+				sessionId
+			})
+		}
+	};
+}
+//#endregion
+exports.useSessionRail = useSessionRail;
+
+//# sourceMappingURL=useSessionRail.cjs.map

package/dist/web/features/sessions/useSessionRail.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSessionRail.cjs","names":["useState","useRef","loadSessionAvatar","useNavigate","useCallback","useStore","sessionsStore","workspacesStore","sessionStoreFor","remoteAccessStore","newSessionStore","railRestartStore","useSyncExternalStore","subscribeActivitySources","activityGroups","useMemo","listWorkspaces","paletteStore","buildRailWorkspaces","resolveParentId","PluginSurface","HOST_SLOTS","restartDashboardSession","stopSession","DEFAULT_REPOSITORY_SETTINGS_SECTION","removeWorkspace","workspaceAdmissionStore","admitDashboardWorkspace","removeSessionMcpSetup","DEFAULT_SETTINGS_SECTION","turnRemoteAccessOff"],"sources":["../../../../src/web/features/sessions/useSessionRail.tsx"],"sourcesContent":["import type { WebTemplateRail } from '@agimon-ai/po-core/web';\nimport { useNavigate } from '@tanstack/react-router';\nimport { useStore } from '@tanstack/react-store';\nimport { useCallback, useEffect, useMemo, useRef, useState, useSyncExternalStore } from 'react';\n\nimport { PluginSurface } from '../../components/PluginSurface';\nimport { activityGroups, subscribeActivitySources } from '../../lib/composition';\nimport { listDirectory, listWorkspaces, removeWorkspace, searchDirectories, stopSession } from '../../lib/hubApi';\nimport { HOST_SLOTS } from '../../lib/pluginRegistry';\nimport { loadSessionAvatar } from '../../lib/sessionAvatar';\nimport { removeSessionMcpSetup } from '../../lib/sessionMcpApi';\nimport { buildRailWorkspaces } from '../../lib/sessionRailModel';\nimport { DEFAULT_REPOSITORY_SETTINGS_SECTION, DEFAULT_SETTINGS_SECTION } from '../../lib/settingsSections';\nimport { closeNewSession, newSessionStore, openNewSession } from '../../stores/newSessionStore';\nimport { paletteStore } from '../../stores/paletteStore';\nimport { openResumeDialog, railRestartStore, restartDashboardSession } from '../../stores/railDialogStore';\nimport { openRemoteDialog, remoteAccessStore, turnRemoteAccessOff } from '../../stores/remoteAccessStore';\nimport { applySessionRemoved, resolveParentId, sessionsStore, type SessionMeta } from '../../stores/sessionsStore';\nimport { renameSession, sessionStoreFor } from '../../stores/sessionStore';\nimport {\n  admitDashboardWorkspace,\n  resetWorkspaceAdmission,\n  workspaceAdmissionStore,\n} from '../../stores/workspaceAdmissionStore';\nimport {\n  applyWorkspaceRemoved,\n  applyWorkspacesSnapshot,\n  selectWorkspace,\n  workspacesStore,\n} from '../../stores/workspacesStore';\n\nconst STATUS_REFRESH_MS = 30_000;\n\nfunction isEditable(target: EventTarget | null): boolean {\n  if (!(target instanceof HTMLElement)) return false;\n  return target.isContentEditable || target.tagName === 'INPUT' || target.tagName === 'TEXTAREA';\n}\n\n/** A key pressed inside an overlay belongs to that overlay, never to the rail. */\nfunction insideOverlay(target: EventTarget | null): boolean {\n  return target instanceof Element && target.closest('[role=\"dialog\"], [role=\"menu\"], [role=\"alertdialog\"]') !== null;\n}\n\n/**\n * Loads each distinct profile avatar once, keyed by profile and icon version so\n * sessions sharing a persona share one image, and revokes images no card shows.\n */\nfunction useSessionAvatars(order: readonly string[], byId: Readonly<Record<string, SessionMeta>>) {\n  const wanted = new Map<string, string>();\n  for (const id of order) {\n    const profile = byId[id]?.summary.profile;\n    if (profile?.iconVersion !== undefined) wanted.set(id, `${profile.name}:${profile.iconVersion}`);\n  }\n  const wantedKey = [...wanted].map(([id, key]) => `${id}=${key}`).join('\\n');\n  const [loaded, setLoaded] = useState<Readonly<Record<string, string>>>({});\n  const requested = useRef(new Set<string>());\n\n  useEffect(() => {\n    const keys = new Set(wanted.values());\n    for (const [id, key] of wanted) {\n      if (requested.current.has(key)) continue;\n      requested.current.add(key);\n      const version = key.slice(key.lastIndexOf(':') + 1);\n      void loadSessionAvatar(id, version).then(\n        (url) => setLoaded((previous) => ({ ...previous, [key]: url })),\n        // A missing image leaves the initials in place; the next icon version retries.\n        () => undefined,\n      );\n    }\n    setLoaded((previous) => {\n      const stale = Object.keys(previous).filter((key) => !keys.has(key));\n      if (stale.length === 0) return previous;\n      const next = { ...previous };\n      for (const key of stale) {\n        URL.revokeObjectURL(next[key]!);\n        delete next[key];\n        requested.current.delete(key);\n      }\n      return next;\n    });\n    // eslint-disable-next-line react-hooks/exhaustive-deps -- `wanted` is rebuilt each render; `wantedKey` tracks its content.\n  }, [wantedKey]);\n\n  useEffect(\n    () => () => {\n      setLoaded((previous) => {\n        for (const url of Object.values(previous)) URL.revokeObjectURL(url);\n        return {};\n      });\n    },\n    [],\n  );\n\n  const urls: Record<string, string> = {};\n  for (const [id, key] of wanted) {\n    const url = loaded[key];\n    if (url !== undefined) urls[id] = url;\n  }\n  return urls;\n}\n\n/**\n * The session rail as data and actions for the active template.\n *\n * Owns what must keep working whichever template renders (or hides) the rail:\n * the status clock, workspace hydration, the Ctrl+T and 1-9 shortcuts, and the\n * actions that reach the hub and the router.\n */\nexport function useSessionRail({ onDismiss }: { onDismiss?: () => void }): WebTemplateRail {\n  const navigate = useNavigate();\n  const scrollTop = useRef(0);\n  const scrollRef = useCallback((element: HTMLElement | null) => {\n    if (element === null) return;\n    element.scrollTop = scrollTop.current;\n    return () => {\n      scrollTop.current = element.scrollTop;\n    };\n  }, []);\n  const order = useStore(sessionsStore, (state) => state.order);\n  const byId = useStore(sessionsStore, (state) => state.byId);\n  const activeId = useStore(sessionsStore, (state) => state.activeId);\n  const workspaceOrder = useStore(workspacesStore, (state) => state.order);\n  const workspacesById = useStore(workspacesStore, (state) => state.byId);\n  const selectedWorkspaceId = useStore(workspacesStore, (state) => state.selectedId);\n  const workspacesHydrated = useStore(workspacesStore, (state) => state.hydrated);\n  const hasDialog = useStore(sessionStoreFor(activeId), (state) => state.dialog !== null);\n  const remote = useStore(remoteAccessStore, (state) => state.view);\n  const creating = useStore(newSessionStore, (state) => state);\n  const [now, setNow] = useState(() => Date.now());\n  const restarts = useStore(railRestartStore);\n  const avatarUrls = useSessionAvatars(order, byId);\n  const backgroundWorkKey = useSyncExternalStore(\n    useCallback(\n      (listener: () => void) => {\n        const releases = [\n          subscribeActivitySources(listener),\n          ...order.map((id) => {\n            const subscription = sessionStoreFor(id).subscribe(listener);\n            return () => subscription.unsubscribe();\n          }),\n        ];\n        return () => releases.forEach((release) => release());\n      },\n      [order],\n    ),\n    () =>\n      JSON.stringify(\n        order.filter((id) => {\n          const { statuses, widgets } = sessionStoreFor(id).state;\n          return activityGroups(statuses, widgets, id).some(\n            (group) => group.active && group.marksBackgroundWork !== false,\n          );\n        }),\n      ),\n  );\n  const backgroundWorkSessions = useMemo<ReadonlySet<string>>(\n    () => new Set(JSON.parse(backgroundWorkKey) as string[]),\n    [backgroundWorkKey],\n  );\n\n  useEffect(() => {\n    const timer = setInterval(() => setNow(Date.now()), STATUS_REFRESH_MS);\n    return () => clearInterval(timer);\n  }, []);\n\n  useEffect(() => {\n    if (workspacesHydrated) return;\n    let stale = false;\n    void listWorkspaces().then((result) => {\n      if (!stale && 'workspaces' in result) applyWorkspacesSnapshot(result);\n    });\n    return () => {\n      stale = true;\n    };\n  }, [workspacesHydrated]);\n\n  useEffect(() => {\n    const workspaceId = activeId === null ? undefined : byId[activeId]?.summary.workspaceId;\n    if (workspaceId !== undefined && workspacesById[workspaceId] !== undefined) selectWorkspace(workspaceId);\n  }, [activeId, byId, workspacesById]);\n\n  useEffect(() => {\n    const onKeyDown = (event: KeyboardEvent): void => {\n      if (event.ctrlKey && !event.metaKey && !event.altKey && event.key === 't') {\n        event.preventDefault();\n        onDismiss?.();\n        openNewSession(selectedWorkspaceId);\n        return;\n      }\n      if (event.ctrlKey || event.metaKey || event.altKey || event.defaultPrevented) return;\n      if (isEditable(event.target) || insideOverlay(event.target) || paletteStore.state.open || hasDialog) return;\n      const ordinal = Number.parseInt(event.key, 10);\n      if (!Number.isInteger(ordinal) || ordinal < 1 || ordinal > 9) return;\n      const target = order[ordinal - 1];\n      if (target === undefined) return;\n      event.preventDefault();\n      onDismiss?.();\n      void navigate({ to: '/session/$sessionId', params: { sessionId: target } });\n    };\n    window.addEventListener('keydown', onKeyDown);\n    return () => window.removeEventListener('keydown', onKeyDown);\n  }, [order, hasDialog, navigate, onDismiss, selectedWorkspaceId]);\n\n  const workspaces = useMemo(\n    () =>\n      buildRailWorkspaces({\n        order,\n        byId,\n        activeId,\n        workspaceOrder,\n        workspacesById,\n        nested: new Set(order.filter((id) => resolveParentId(byId, id) !== undefined)),\n        now,\n        restarts,\n        avatarUrls,\n        backgroundWorkSessions,\n      }),\n    [order, byId, activeId, workspaceOrder, workspacesById, now, restarts, avatarUrls, backgroundWorkSessions],\n  );\n\n  const addingWorkspace =\n    creating.open && (creating.workspaceId === null || workspacesById[creating.workspaceId] === undefined);\n\n  return {\n    workspaces,\n    scrollRef,\n    remote: {\n      status: remote?.status ?? 'off',\n      deviceCount: remote?.devices.length ?? 0,\n      ...(remote?.publicUrl === undefined ? {} : { host: new URL(remote.publicUrl).host }),\n      ...(remote?.error === undefined ? {} : { error: remote.error }),\n    },\n    pluginContent: <PluginSurface slot={HOST_SLOTS.rail} sessionId={activeId} />,\n    ...(addingWorkspace ? { addWorkspace: { suggestedPaths: remote?.settings.sandbox.workspaces ?? [] } } : {}),\n    actions: {\n      openSession(sessionId) {\n        onDismiss?.();\n        void navigate({ to: '/session/$sessionId', params: { sessionId } });\n      },\n      renameSession(sessionId, name) {\n        const trimmed = name.trim();\n        if (trimmed !== '' && trimmed !== byId[sessionId]?.summary.name) renameSession(trimmed, sessionId);\n      },\n      restartSession(sessionId) {\n        void restartDashboardSession(sessionId);\n      },\n      async removeSession(sessionId) {\n        const result = await stopSession(sessionId);\n        if ('error' in result) return { error: result.error };\n        applySessionRemoved({ sessionId });\n        return undefined;\n      },\n      resumeSession(sessionId) {\n        openResumeDialog({ sessionId });\n      },\n      createSession(workspaceId) {\n        selectWorkspace(workspaceId);\n        onDismiss?.();\n        openNewSession(workspaceId);\n      },\n      resumeInWorkspace(workspaceId) {\n        openResumeDialog({ workspaceId });\n      },\n      openWorkspaceSettings(workspaceId) {\n        selectWorkspace(workspaceId);\n        onDismiss?.();\n        void navigate({\n          to: '/settings/$section',\n          params: { section: DEFAULT_REPOSITORY_SETTINGS_SECTION },\n          search: { workspace: workspaceId },\n        });\n      },\n      async deleteWorkspace(workspaceId) {\n        const result = await removeWorkspace(workspaceId);\n        if ('error' in result) return { error: result.error };\n        applyWorkspaceRemoved({ workspaceId });\n        return undefined;\n      },\n      openAddWorkspace() {\n        onDismiss?.();\n        openNewSession(null);\n      },\n      closeAddWorkspace() {\n        if (workspaceAdmissionStore.state.pending) return;\n        resetWorkspaceAdmission();\n        closeNewSession();\n      },\n      async addWorkspace(input) {\n        const result = await admitDashboardWorkspace(input);\n        if (result === undefined) closeNewSession();\n        return result;\n      },\n      searchDirectories,\n      listDirectory,\n      async removePendingSetup(sessionId, setupId) {\n        const workspaceId = byId[sessionId]?.summary.workspaceId;\n        if (workspaceId === undefined) return { error: 'This session belongs to no workspace.' };\n        const result = await removeSessionMcpSetup(workspaceId, sessionId, setupId);\n        return 'error' in result ? { error: result.error } : undefined;\n      },\n      openSettings() {\n        onDismiss?.();\n        void navigate({\n          to: '/settings/$section',\n          params: { section: DEFAULT_SETTINGS_SECTION },\n          search: { workspace: selectedWorkspaceId ?? undefined },\n        });\n      },\n      openRemoteAccess() {\n        onDismiss?.();\n        openRemoteDialog();\n      },\n      turnRemoteAccessOff() {\n        void turnRemoteAccessOff();\n      },\n      renderSessionMenuItems: (sessionId) => <PluginSurface slot={HOST_SLOTS.sessionMenu} sessionId={sessionId} />,\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/web/features/sessions/useSessionRail.d.mts

@@ -0,0 +1,14 @@
+import { WebTemplateRail } from "@agimon-ai/po-core/web";
+//#region src/web/features/sessions/useSessionRail.d.ts
+/**
+ * The session rail as data and actions for the active template.
+ *
+ * Owns what must keep working whichever template renders (or hides) the rail:
+ * the status clock, workspace hydration, the Ctrl+T and 1-9 shortcuts, and the
+ * actions that reach the hub and the router.
+ */
+export declare function useSessionRail({ onDismiss }: {
+  onDismiss?: () => void;
+}): WebTemplateRail;
+//#endregion
+//# sourceMappingURL=useSessionRail.d.mts.map

package/dist/web/features/sessions/useSessionRail.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSessionRail.d.mts","names":[],"sources":["../../../../src/web/features/sessions/useSessionRail.tsx"],"mappings":";;;;;;;;;wBA4GgB,iBAAiB;EAAe;IAA2B"}

package/dist/web/features/sessions/useSessionRail.mjs

@@ -0,0 +1,302 @@
+import { HOST_SLOTS } from "../../lib/pluginRegistry.mjs";
+import { activityGroups, subscribeActivitySources } from "../../lib/composition.mjs";
+import { listDirectory, listWorkspaces, removeWorkspace, searchDirectories, stopSession } from "../../lib/hubApi.mjs";
+import { loadSessionAvatar } from "../../lib/sessionAvatar.mjs";
+import { removeSessionMcpSetup } from "../../lib/sessionMcpApi.mjs";
+import { buildRailWorkspaces } from "../../lib/sessionRailModel.mjs";
+import { DEFAULT_REPOSITORY_SETTINGS_SECTION, DEFAULT_SETTINGS_SECTION } from "../../lib/settingsSections.mjs";
+import { applySessionRemoved, resolveParentId, sessionsStore } from "../../stores/sessionsStore.mjs";
+import { renameSession, sessionStoreFor } from "../../stores/sessionStore.mjs";
+import { closeNewSession, newSessionStore, openNewSession } from "../../stores/newSessionStore.mjs";
+import { paletteStore } from "../../stores/paletteStore.mjs";
+import { openResumeDialog, railRestartStore, restartDashboardSession } from "../../stores/railDialogStore.mjs";
+import { openRemoteDialog, remoteAccessStore, turnRemoteAccessOff } from "../../stores/remoteAccessStore.mjs";
+import { applyWorkspaceRemoved, applyWorkspacesSnapshot, selectWorkspace, workspacesStore } from "../../stores/workspacesStore.mjs";
+import { admitDashboardWorkspace, resetWorkspaceAdmission, workspaceAdmissionStore } from "../../stores/workspaceAdmissionStore.mjs";
+import { PluginSurface } from "../../components/PluginSurface.mjs";
+import { useCallback, useEffect, useMemo, useRef, useState, useSyncExternalStore } from "react";
+import { useNavigate } from "@tanstack/react-router";
+import { useStore } from "@tanstack/react-store";
+import { jsx } from "react/jsx-runtime";
+//#region src/web/features/sessions/useSessionRail.tsx
+const STATUS_REFRESH_MS = 3e4;
+function isEditable(target) {
+	if (!(target instanceof HTMLElement)) return false;
+	return target.isContentEditable || target.tagName === "INPUT" || target.tagName === "TEXTAREA";
+}
+/** A key pressed inside an overlay belongs to that overlay, never to the rail. */
+function insideOverlay(target) {
+	return target instanceof Element && target.closest("[role=\"dialog\"], [role=\"menu\"], [role=\"alertdialog\"]") !== null;
+}
+/**
+* Loads each distinct profile avatar once, keyed by profile and icon version so
+* sessions sharing a persona share one image, and revokes images no card shows.
+*/
+function useSessionAvatars(order, byId) {
+	const wanted = /* @__PURE__ */ new Map();
+	for (const id of order) {
+		const profile = byId[id]?.summary.profile;
+		if (profile?.iconVersion !== void 0) wanted.set(id, `${profile.name}:${profile.iconVersion}`);
+	}
+	const wantedKey = [...wanted].map(([id, key]) => `${id}=${key}`).join("\n");
+	const [loaded, setLoaded] = useState({});
+	const requested = useRef(/* @__PURE__ */ new Set());
+	useEffect(() => {
+		const keys = new Set(wanted.values());
+		for (const [id, key] of wanted) {
+			if (requested.current.has(key)) continue;
+			requested.current.add(key);
+			const version = key.slice(key.lastIndexOf(":") + 1);
+			loadSessionAvatar(id, version).then((url) => setLoaded((previous) => ({
+				...previous,
+				[key]: url
+			})), () => void 0);
+		}
+		setLoaded((previous) => {
+			const stale = Object.keys(previous).filter((key) => !keys.has(key));
+			if (stale.length === 0) return previous;
+			const next = { ...previous };
+			for (const key of stale) {
+				URL.revokeObjectURL(next[key]);
+				delete next[key];
+				requested.current.delete(key);
+			}
+			return next;
+		});
+	}, [wantedKey]);
+	useEffect(() => () => {
+		setLoaded((previous) => {
+			for (const url of Object.values(previous)) URL.revokeObjectURL(url);
+			return {};
+		});
+	}, []);
+	const urls = {};
+	for (const [id, key] of wanted) {
+		const url = loaded[key];
+		if (url !== void 0) urls[id] = url;
+	}
+	return urls;
+}
+/**
+* The session rail as data and actions for the active template.
+*
+* Owns what must keep working whichever template renders (or hides) the rail:
+* the status clock, workspace hydration, the Ctrl+T and 1-9 shortcuts, and the
+* actions that reach the hub and the router.
+*/
+function useSessionRail({ onDismiss }) {
+	const navigate = useNavigate();
+	const scrollTop = useRef(0);
+	const scrollRef = useCallback((element) => {
+		if (element === null) return;
+		element.scrollTop = scrollTop.current;
+		return () => {
+			scrollTop.current = element.scrollTop;
+		};
+	}, []);
+	const order = useStore(sessionsStore, (state) => state.order);
+	const byId = useStore(sessionsStore, (state) => state.byId);
+	const activeId = useStore(sessionsStore, (state) => state.activeId);
+	const workspaceOrder = useStore(workspacesStore, (state) => state.order);
+	const workspacesById = useStore(workspacesStore, (state) => state.byId);
+	const selectedWorkspaceId = useStore(workspacesStore, (state) => state.selectedId);
+	const workspacesHydrated = useStore(workspacesStore, (state) => state.hydrated);
+	const hasDialog = useStore(sessionStoreFor(activeId), (state) => state.dialog !== null);
+	const remote = useStore(remoteAccessStore, (state) => state.view);
+	const creating = useStore(newSessionStore, (state) => state);
+	const [now, setNow] = useState(() => Date.now());
+	const restarts = useStore(railRestartStore);
+	const avatarUrls = useSessionAvatars(order, byId);
+	const backgroundWorkKey = useSyncExternalStore(useCallback((listener) => {
+		const releases = [subscribeActivitySources(listener), ...order.map((id) => {
+			const subscription = sessionStoreFor(id).subscribe(listener);
+			return () => subscription.unsubscribe();
+		})];
+		return () => releases.forEach((release) => release());
+	}, [order]), () => JSON.stringify(order.filter((id) => {
+		const { statuses, widgets } = sessionStoreFor(id).state;
+		return activityGroups(statuses, widgets, id).some((group) => group.active && group.marksBackgroundWork !== false);
+	})));
+	const backgroundWorkSessions = useMemo(() => new Set(JSON.parse(backgroundWorkKey)), [backgroundWorkKey]);
+	useEffect(() => {
+		const timer = setInterval(() => setNow(Date.now()), STATUS_REFRESH_MS);
+		return () => clearInterval(timer);
+	}, []);
+	useEffect(() => {
+		if (workspacesHydrated) return;
+		let stale = false;
+		listWorkspaces().then((result) => {
+			if (!stale && "workspaces" in result) applyWorkspacesSnapshot(result);
+		});
+		return () => {
+			stale = true;
+		};
+	}, [workspacesHydrated]);
+	useEffect(() => {
+		const workspaceId = activeId === null ? void 0 : byId[activeId]?.summary.workspaceId;
+		if (workspaceId !== void 0 && workspacesById[workspaceId] !== void 0) selectWorkspace(workspaceId);
+	}, [
+		activeId,
+		byId,
+		workspacesById
+	]);
+	useEffect(() => {
+		const onKeyDown = (event) => {
+			if (event.ctrlKey && !event.metaKey && !event.altKey && event.key === "t") {
+				event.preventDefault();
+				onDismiss?.();
+				openNewSession(selectedWorkspaceId);
+				return;
+			}
+			if (event.ctrlKey || event.metaKey || event.altKey || event.defaultPrevented) return;
+			if (isEditable(event.target) || insideOverlay(event.target) || paletteStore.state.open || hasDialog) return;
+			const ordinal = Number.parseInt(event.key, 10);
+			if (!Number.isInteger(ordinal) || ordinal < 1 || ordinal > 9) return;
+			const target = order[ordinal - 1];
+			if (target === void 0) return;
+			event.preventDefault();
+			onDismiss?.();
+			navigate({
+				to: "/session/$sessionId",
+				params: { sessionId: target }
+			});
+		};
+		window.addEventListener("keydown", onKeyDown);
+		return () => window.removeEventListener("keydown", onKeyDown);
+	}, [
+		order,
+		hasDialog,
+		navigate,
+		onDismiss,
+		selectedWorkspaceId
+	]);
+	const workspaces = useMemo(() => buildRailWorkspaces({
+		order,
+		byId,
+		activeId,
+		workspaceOrder,
+		workspacesById,
+		nested: new Set(order.filter((id) => resolveParentId(byId, id) !== void 0)),
+		now,
+		restarts,
+		avatarUrls,
+		backgroundWorkSessions
+	}), [
+		order,
+		byId,
+		activeId,
+		workspaceOrder,
+		workspacesById,
+		now,
+		restarts,
+		avatarUrls,
+		backgroundWorkSessions
+	]);
+	const addingWorkspace = creating.open && (creating.workspaceId === null || workspacesById[creating.workspaceId] === void 0);
+	return {
+		workspaces,
+		scrollRef,
+		remote: {
+			status: remote?.status ?? "off",
+			deviceCount: remote?.devices.length ?? 0,
+			...remote?.publicUrl === void 0 ? {} : { host: new URL(remote.publicUrl).host },
+			...remote?.error === void 0 ? {} : { error: remote.error }
+		},
+		pluginContent: /* @__PURE__ */ jsx(PluginSurface, {
+			slot: HOST_SLOTS.rail,
+			sessionId: activeId
+		}),
+		...addingWorkspace ? { addWorkspace: { suggestedPaths: remote?.settings.sandbox.workspaces ?? [] } } : {},
+		actions: {
+			openSession(sessionId) {
+				onDismiss?.();
+				navigate({
+					to: "/session/$sessionId",
+					params: { sessionId }
+				});
+			},
+			renameSession(sessionId, name) {
+				const trimmed = name.trim();
+				if (trimmed !== "" && trimmed !== byId[sessionId]?.summary.name) renameSession(trimmed, sessionId);
+			},
+			restartSession(sessionId) {
+				restartDashboardSession(sessionId);
+			},
+			async removeSession(sessionId) {
+				const result = await stopSession(sessionId);
+				if ("error" in result) return { error: result.error };
+				applySessionRemoved({ sessionId });
+			},
+			resumeSession(sessionId) {
+				openResumeDialog({ sessionId });
+			},
+			createSession(workspaceId) {
+				selectWorkspace(workspaceId);
+				onDismiss?.();
+				openNewSession(workspaceId);
+			},
+			resumeInWorkspace(workspaceId) {
+				openResumeDialog({ workspaceId });
+			},
+			openWorkspaceSettings(workspaceId) {
+				selectWorkspace(workspaceId);
+				onDismiss?.();
+				navigate({
+					to: "/settings/$section",
+					params: { section: DEFAULT_REPOSITORY_SETTINGS_SECTION },
+					search: { workspace: workspaceId }
+				});
+			},
+			async deleteWorkspace(workspaceId) {
+				const result = await removeWorkspace(workspaceId);
+				if ("error" in result) return { error: result.error };
+				applyWorkspaceRemoved({ workspaceId });
+			},
+			openAddWorkspace() {
+				onDismiss?.();
+				openNewSession(null);
+			},
+			closeAddWorkspace() {
+				if (workspaceAdmissionStore.state.pending) return;
+				resetWorkspaceAdmission();
+				closeNewSession();
+			},
+			async addWorkspace(input) {
+				const result = await admitDashboardWorkspace(input);
+				if (result === void 0) closeNewSession();
+				return result;
+			},
+			searchDirectories,
+			listDirectory,
+			async removePendingSetup(sessionId, setupId) {
+				const workspaceId = byId[sessionId]?.summary.workspaceId;
+				if (workspaceId === void 0) return { error: "This session belongs to no workspace." };
+				const result = await removeSessionMcpSetup(workspaceId, sessionId, setupId);
+				return "error" in result ? { error: result.error } : void 0;
+			},
+			openSettings() {
+				onDismiss?.();
+				navigate({
+					to: "/settings/$section",
+					params: { section: DEFAULT_SETTINGS_SECTION },
+					search: { workspace: selectedWorkspaceId ?? void 0 }
+				});
+			},
+			openRemoteAccess() {
+				onDismiss?.();
+				openRemoteDialog();
+			},
+			turnRemoteAccessOff() {
+				turnRemoteAccessOff();
+			},
+			renderSessionMenuItems: (sessionId) => /* @__PURE__ */ jsx(PluginSurface, {
+				slot: HOST_SLOTS.sessionMenu,
+				sessionId
+			})
+		}
+	};
+}
+//#endregion
+export { useSessionRail };
+
+//# sourceMappingURL=useSessionRail.mjs.map