pilotswarm 0.5.70 → 0.5.72

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "pilotswarm",
-    "version": "0.5.70",
+    "version": "0.5.72",
     "description": "PilotSwarm application package: terminal UI, browser portal + Web API server, and MCP server — one install, three bins.",
     "type": "module",
     "license": "MIT",
@@ -81,7 +81,7 @@
         "ink": "^6.8.0",
         "jose": "^6.2.2",
         "mermaid": "^11.16.0",
-        "pilotswarm-sdk": "0.5.70",
+        "pilotswarm-sdk": "0.5.72",
         "react": "^19.2.4",
         "react-dom": "^19.2.4",
         "ws": "^8.18.2"

package/ui/core/src/controller.js

@@ -7545,6 +7545,7 @@ export class PilotSwarmUiController {
         force = true,
         fullscreen = false,
         pane = false,
+        preserveSession = false,
     } = {}) {
         const resolvedSessionId = sessionId || this.getState().sessions.activeSessionId;
         const name = String(filename || "").trim();
@@ -7558,7 +7559,7 @@ export class PilotSwarmUiController {
             restoreArtifactId: this.getState().files.selectedArtifactId || null,
         });
 
-        if (this.getState().sessions.activeSessionId !== resolvedSessionId) {
+        if (!preserveSession && this.getState().sessions.activeSessionId !== resolvedSessionId) {
             await this.loadSession(resolvedSessionId).catch(() => null);
         }
         // The reader REPLACES the inspector, so it has no business changing
@@ -8996,6 +8997,7 @@ export class PilotSwarmUiController {
             return;
         }
 
+        this.dispatch({ type: "sessions/used", sessionId });
         const activePendingQuestion = activeSession?.pendingQuestion || null;
         const answeringPendingQuestion = Boolean(activePendingQuestion?.question);
         const promptEdit = this.getPromptEditSessionMatch(sessionId);

package/ui/core/src/moa.js

@@ -42,7 +42,7 @@ export function normalizeMoa(value) {
             return safeLayout(dashboard, key, `MoA ${index + 1}`);
         });
         if (!dashboards.length) dashboards.push(safeLayout(null));
-        return { version: 3, activeDashboardId: dashboards.some(d => d.id === value.activeDashboardId) ? value.activeDashboardId : dashboards[0].id, dashboards };
+        return { version: 3, composerMode: value?.composerMode === "shared" ? "shared" : "per-chat", activeDashboardId: dashboards.some(d => d.id === value.activeDashboardId) ? value.activeDashboardId : dashboards[0].id, dashboards };
     }
     let source = value;
     if (!(value?.version === 2 || (object(value) && Object.hasOwn(value, "tree")))) {
@@ -51,7 +51,7 @@ export function normalizeMoa(value) {
         const active = Number.isInteger(value?.activeSlot) ? Math.max(0, Math.min(4, value.activeSlot)) : 0;
         source = safeLayout(slots[active]).tree ? slots[active] : slots.find(slot => safeLayout(slot).tree);
     }
-    return { version: 3, activeDashboardId: "moa-1", dashboards: [safeLayout(source)] };
+    return { version: 3, composerMode: value?.composerMode === "shared" ? "shared" : "per-chat", activeDashboardId: "moa-1", dashboards: [safeLayout(source)] };
 }
 export const activeMoaDashboard = value => value.dashboards.find(d => d.id === value.activeDashboardId) || value.dashboards[0];
 export function updateMoaDashboard(value, dashboardId, patch) {

package/ui/core/src/reducer.js

@@ -1,3 +1,4 @@
+import { normalizeSessionSortMode, normalizeSessionUsage, reconcileSessionSort } from "./session-sort.js";
 import { normalizeMoa } from "./moa.js";
 import { retainSessionWarnings } from "./session-errors.js";
 import { buildSessionTree, isManuallyOrderableSession } from "./session-tree.js";
@@ -846,7 +847,7 @@ export function appReducer(state, action) {
     if (sessionId && contentUpdate && state.sessions?.goneIds?.includes(sessionId)) return state;
     const next = baseReducer(state, action);
     if (next === state) return next;
-    return reconcileSessionView(state, next, action);
+    return reconcileSessionView(state, reconcileSessionSort(state, next, action), action);
 }
 
 // Per-session desktop views, kept in step with the ui slice.
@@ -1101,6 +1102,7 @@ function baseReducer(state, action) {
             const nextActiveSessionId = hasActive
                 ? normalizeStoredActiveSessionId(settings.activeSessionId)
                 : state.sessions.activeSessionId;
+            const remoteUsage = normalizeSessionUsage(settings.sessionUsedAt);
             const nextSessions = {
                 ...state.sessions,
                 ...(hasOwnerFilter
@@ -1117,6 +1119,9 @@ function baseReducer(state, action) {
                     : {}),
                 pinnedIds: nextPinnedIds,
                 manualOrder: nextManualOrder,
+                sortMode: Object.hasOwn(settings, "sessionSortMode") ? normalizeSessionSortMode(settings.sessionSortMode) : state.sessions.sortMode,
+                usedAt: Object.fromEntries([...new Set([...Object.keys(remoteUsage), ...Object.keys(state.sessions.usedAt || {})])]
+                    .map(id => [id, Math.max(remoteUsage[id] || 0, state.sessions.usedAt?.[id] || 0)])),
                 collapsedIds: nextCollapsedIds,
                 collapsedIdsExplicit: hasCollapsed ? true : state.sessions.collapsedIdsExplicit,
                 activeSessionId: nextActiveSessionId,
@@ -1891,8 +1896,15 @@ function baseReducer(state, action) {
             };
         }
 
+        case "sessions/sortMode":
+            return { ...state, sessions: { ...state.sessions, sortMode: normalizeSessionSortMode(action.mode) } };
+        case "sessions/refreshSort":
+            return { ...state, sessions: { ...state.sessions } };
+        case "sessions/used":
+            if (!action.sessionId) return state;
+            return { ...state, sessions: { ...state.sessions, usedAt: { ...state.sessions.usedAt, [action.sessionId]: action.at || Date.now() } } };
         case "sessions/selected": {
-            state = { ...state, sessions: { ...state.sessions, listDeselected: false, localSelectionMade: true } };
+            state = { ...state, sessions: { ...state.sessions, listDeselected: false, localSelectionMade: true, usedAt: action.sessionId ? { ...state.sessions.usedAt, [action.sessionId]: Date.now() } : state.sessions.usedAt } };
             // Per-session chat scroll memory: stash both the outgoing offset
             // and whether it follows the bottom. A paused reading position
             // stays paused as new messages arrive and across session switches.

package/ui/core/src/selectors.js

@@ -1332,7 +1332,7 @@ function sessionSearchOwner(session, byId) {
 
 function sessionSearchIndex(state) {
     const byId = state.sessions?.byId || {};
-    const deps = [state.sessions?.orderById, state.sessions?.pinnedIds, state.sessions?.manualOrder];
+    const deps = [state.sessions?.orderById, state.sessions?.pinnedIds, (state.sessions?.sortMode && state.sessions.sortMode !== "saved" ? state.sessions.sortSnapshot : state.sessions?.manualOrder)];
     const cached = sessionSearchIndexCache.get(byId);
     if (cached && sameRowDeps(cached.deps, deps)) return cached;
     const expanded = buildSessionTree(
@@ -1340,7 +1340,7 @@ function sessionSearchIndex(state) {
         new Set(),
         state.sessions?.orderById,
         state.sessions?.pinnedIds,
-        state.sessions?.manualOrder,
+        (state.sessions?.sortMode && state.sessions.sortMode !== "saved" ? state.sessions.sortSnapshot : state.sessions?.manualOrder),
     );
     const parentById = new Map();
     const entryById = new Map();
@@ -1371,7 +1371,7 @@ function buildSearchedSessionFlat(state, query) {
     if (!query) return existingFlat;
     const cached = searchedSessionFlatCache.get(existingFlat);
     const deps = [state.sessions?.byId, state.sessions?.ownerFilter, state.auth, state.sessions?.orderById,
-        state.sessions?.pinnedIds, state.sessions?.manualOrder, state.sessions?.filterExceptionId];
+        state.sessions?.pinnedIds, (state.sessions?.sortMode && state.sessions.sortMode !== "saved" ? state.sessions.sortSnapshot : state.sessions?.manualOrder), state.sessions?.filterExceptionId];
     if (cached?.query === query && sameRowDeps(cached.deps, deps)) return cached.result;
 
     const byId = state.sessions?.byId || {};

package/ui/core/src/session-sort.js

@@ -0,0 +1,45 @@
+import { buildSessionTree } from "./session-tree.js";
+
+export const normalizeSessionSortMode = mode => ["used", "updated"].includes(mode) ? mode : "saved";
+export function normalizeSessionUsage(value) {
+    return Object.fromEntries(Object.entries(value || {}).filter(([id, at]) => id && Number.isFinite(at) && at > 0));
+}
+export function snapshotSessionOrder(sessions, mode) {
+    const saved = buildSessionTree(Object.values(sessions.byId), new Set(), sessions.orderById, sessions.pinnedIds, sessions.manualOrder);
+    const rank = new Map(saved.map((row, index) => [row.sessionId, index]));
+    const timestamp = session => {
+        if (mode === "used") return sessions.usedAt?.[session.sessionId] || 0;
+        const raw = session.updatedAt ?? session.summaryUpdatedAt ?? session.latestSummaryUpdatedAt;
+        const value = typeof raw === "number" ? raw : Date.parse(raw || "");
+        return Number.isFinite(value) ? value : 0;
+    };
+    return Object.values(sessions.byId).sort((a, b) => timestamp(b) - timestamp(a)
+        || (rank.get(a.sessionId) ?? Infinity) - (rank.get(b.sessionId) ?? Infinity))
+        .map(session => session.sessionId);
+}
+
+// Live catalog and usage changes update row contents, never existing positions.
+// A mode change or explicit refresh captures the next order. New rows append.
+export function reconcileSessionSort(previous, next, action) {
+    const sessions = next.sessions;
+    if (!sessions) return next;
+    const mode = normalizeSessionSortMode(sessions.sortMode);
+    const modeChanged = mode !== normalizeSessionSortMode(previous.sessions?.sortMode);
+    const refresh = action.type === "sessions/refreshSort";
+    const rebuild = sessions.flat !== previous.sessions?.flat || sessions.byId !== previous.sessions?.byId || modeChanged || refresh;
+    if (!rebuild) return next;
+    let sortSnapshot = sessions.sortSnapshot;
+    if (mode !== "saved") {
+        if (!sessions.listingSeen) sortSnapshot = [];
+        else if (modeChanged || refresh || !sortSnapshot?.length) sortSnapshot = snapshotSessionOrder(sessions, mode);
+        else {
+            const known = new Set(sortSnapshot);
+            const added = Object.keys(sessions.byId).filter(id => !known.has(id));
+            if (added.length) sortSnapshot = [...sortSnapshot, ...added];
+        }
+    }
+    const flat = mode === "saved" && !modeChanged ? sessions.flat : buildSessionTree(
+        Object.values(sessions.byId), sessions.collapsedIds, sessions.orderById,
+        sessions.pinnedIds, mode === "saved" ? sessions.manualOrder : sortSnapshot);
+    return { ...next, sessions: { ...sessions, sortSnapshot, flat } };
+}

package/ui/core/src/state.js

@@ -480,6 +480,9 @@ export function createInitialState({ mode = "local", branding = null, docs = nul
             pinnedIds: normalizeStoredPinnedSessionIds(pinnedSessionIds),
             // Explicit user placement (desktop drag); read by every surface.
             manualOrder: normalizeStoredSessionOrder(sessionOrder),
+            sortMode: "saved",
+            sortSnapshot: [],
+            usedAt: {},
             // Whether a listing of each kind has been processed. "This row is
             // new" is only answerable against a previous listing OF THE SAME
             // KIND — inferring it from byId being non-empty was wrong, because

package/ui/react/src/web-app.js

@@ -1,3 +1,4 @@
+import { normalizeSessionSortMode, normalizeSessionUsage } from "../../core/src/session-sort.js";
 import { ChatCallLine } from "./chat-call-line.js";
 import React from "react";
 import { FeatureFlagsPanel } from "./feature-flags-panel.js";
@@ -291,6 +292,8 @@ function clearBrowserPreferenceCache() {
 function normalizeProfileSettings(settings) {
     const candidate = settings && typeof settings === "object" && !Array.isArray(settings) ? settings : {};
     const normalized = {};
+    if (hasOwn(candidate, "sessionSortMode")) normalized.sessionSortMode = normalizeSessionSortMode(candidate.sessionSortMode);
+    if (hasOwn(candidate, "sessionUsedAt")) normalized.sessionUsedAt = normalizeSessionUsage(candidate.sessionUsedAt);
     if (hasOwn(candidate, "moa")) normalized.moa = normalizeMoa(candidate.moa);
     if (typeof candidate.themeId === "string" && candidate.themeId.trim()) {
         normalized.themeId = candidate.themeId.trim();
@@ -441,7 +444,7 @@ function profileViewState(root) {
     return {
         ...root.ui, ...root.ui.layout,
         ownerFilter: root.sessions.ownerFilter, pinnedIds: root.sessions.pinnedIds,
-        manualOrder: root.sessions.manualOrder, collapsedSessionIds: root.sessions.collapsedIds,
+        manualOrder: root.sessions.manualOrder, sessionSortMode: root.sessions.sortMode, sessionUsedAt: root.sessions.usedAt, collapsedSessionIds: root.sessions.collapsedIds,
         activeSessionId: root.sessions.activeSessionId, canvasPrefs: root.canvas?.prefs,
     };
 }
@@ -464,6 +467,8 @@ function profileSettingsFromViewState(state, preservedOtherTouchScale = null, pr
         },
         pinnedSessionIds: state.pinnedIds,
         sessionOrder: state.manualOrder,
+        sessionSortMode: state.sessionSortMode,
+        sessionUsedAt: state.sessionUsedAt,
         collapsedSessionIds: state.collapsedSessionIds,
         activeSessionId: state.activeSessionId,
         // rightPaneMode describes the DESKTOP right column; a phone has no
@@ -528,6 +533,8 @@ function buildDefaultProfileSettingsFromState(state, preservedOtherTouchScale =
         layoutAdjustments: state?.ui?.layout,
         pinnedSessionIds: state?.sessions?.pinnedIds,
         sessionOrder: state?.sessions?.manualOrder,
+        sessionSortMode: state?.sessions?.sortMode,
+        sessionUsedAt: state?.sessions?.usedAt,
         collapsedSessionIds: state?.sessions?.collapsedIds,
         activeSessionId: state?.sessions?.activeSessionId,
         ...(isNarrowViewport()
@@ -575,6 +582,8 @@ function materializeProfileSettings(remoteSettings, defaults) {
         // here is DROPPED at startup — and the save effect then writes the
         // empty value straight back over the stored one. Leaving sessionOrder
         // out made every placement survive exactly until the next reload.
+        sessionSortMode: normalizedRemote.sessionSortMode ?? normalizedDefaults.sessionSortMode,
+        sessionUsedAt: normalizedRemote.sessionUsedAt ?? normalizedDefaults.sessionUsedAt,
         sessionOrder: hasOwn(normalizedRemote, "sessionOrder")
             ? normalizedRemote.sessionOrder
             : normalizedDefaults.sessionOrder,
@@ -2030,6 +2039,10 @@ function ArtifactLink({ artifactRef }) {
  */
 function openArtifactFromChat(controller, sessionId, filename) {
     if (!controller?.revealArtifact) return;
+    if (controller.openChatArtifact) {
+        Promise.resolve(controller.openChatArtifact(sessionId, filename)).catch(() => {});
+        return;
+    }
     const isPhone = typeof window !== "undefined"
         && typeof window.matchMedia === "function"
         && window.matchMedia("(max-width: 920px)").matches;
@@ -4545,28 +4558,26 @@ function SessionDetailBox({ session, childCount = 0, pause = null, controller =
  * fleet. That only holds while every prop is referentially stable — hence the
  * hoisted click handler and ref setter rather than closures built per row.
  */
-/**
- * True when the primary input is a finger. Drag-to-folder is armed on
- * pointerdown and needs `touch-action: none` to receive a move stream — which
- * on a touch screen also means the list can no longer be scrolled by dragging
- * it, so the gesture is withheld there entirely.
- */
-function useCoarsePointer() {
-    const query = "(pointer: coarse)";
+/** Subscribe to viewport or input changes without remounting the pane. */
+function useMediaQuery(query) {
     const read = () => (typeof window !== "undefined" && typeof window.matchMedia === "function"
         ? window.matchMedia(query).matches
         : false);
-    const [coarse, setCoarse] = React.useState(read);
+    const [matches, setMatches] = React.useState(read);
     React.useEffect(() => {
         if (typeof window === "undefined" || typeof window.matchMedia !== "function") return undefined;
         const media = window.matchMedia(query);
-        const onChange = (event) => setCoarse(event.matches);
+        const onChange = (event) => setMatches(event.matches);
+        setMatches(media.matches);
         media.addEventListener?.("change", onChange);
         return () => media.removeEventListener?.("change", onChange);
-    }, []);
-    return coarse;
+    }, [query]);
+    return matches;
 }
 
+// Withhold drag-to-folder on touch screens so finger drags can scroll the list.
+function useCoarsePointer() { return useMediaQuery("(pointer: coarse)"); }
+
 const RAIL_ORIGIN_PX = 13;
 const RAIL_STEP_PX = 11;
 const RAIL_WIDTH_PX = 1.5;
@@ -5039,11 +5050,10 @@ function useAxisLockedPan(ref, enabled = true) {
     }, [ref, enabled]);
 }
 
-const SessionSearchControl = React.memo(function SessionSearchControl({ query = "", onQuery, matchCount = 0, mobile = false, listRef = null }) {
+const SessionSearchControl = React.memo(function SessionSearchControl({ query = "", onQuery, matchCount = 0, mobile = false, expanded = false, onOpen, onClose, triggerRef, listRef = null }) {
     // Keep typing local: expensive list filtering and external-store updates
     // must never be part of the input's immediate render path.
     const [draft, setDraft] = React.useState(query);
-    const [mobileOpen, setMobileOpen] = React.useState(Boolean(query));
     const timer = React.useRef(null);
     const published = React.useRef(query);
     const composing = React.useRef(false);
@@ -5062,29 +5072,24 @@ const SessionSearchControl = React.memo(function SessionSearchControl({ query =
         cancel(); published.current = query; setDraft(query);
     }, [query]);
     const inputRef = React.useRef(null);
-    React.useEffect(() => {
-        if (query) setMobileOpen(true);
-    }, [query]);
-    const open = () => {
-        setMobileOpen(true);
-        requestAnimationFrame(() => inputRef.current?.focus({ preventScroll: true }));
-    };
     const closeOrClear = () => {
         if (draft || query) { setDraft(""); publish(""); }
-        else setMobileOpen(false);
+        else onClose?.();
     };
     const resultLabel = draft !== query ? "Searching…" : draft
         ? `${matchCount} ${matchCount === 1 ? "match" : "matches"}` : "";
     return React.createElement("div", {
-        className: `ps-session-search${mobileOpen ? " is-open" : ""}`,
+        className: `ps-session-search${expanded ? " is-open" : ""}`,
         "data-session-search": "true",
     },
     mobile ? React.createElement("button", {
         type: "button",
         className: "ps-session-search-trigger",
+        ref: triggerRef,
+        "aria-expanded": expanded,
         "aria-label": "Search sessions",
         title: "Search sessions",
-        onClick: open,
+        onClick: onOpen,
     }, React.createElement(SearchGlyph)) : null,
     React.createElement("div", { className: "ps-session-search-fields" },
         React.createElement(SearchGlyph),
@@ -5115,7 +5120,7 @@ const SessionSearchControl = React.memo(function SessionSearchControl({ query =
             role: "status",
             "aria-live": "polite",
         }, resultLabel) : null,
-        (draft || mobile) ? React.createElement("button", {
+        draft ? React.createElement("button", {
             type: "button",
             className: "ps-session-search-clear",
             "aria-label": draft ? "Clear session search" : "Close session search",
@@ -5132,6 +5137,11 @@ function SessionPane({ controller, actions = null, panelClassName = "", structur
     // sessions-ONLY layout is the exception: it has the whole screen and the
     // detail box is the point of asking for it.
     const isMobilePane = String(panelClassName).includes("ps-mobile-session-pane");
+    const compactSearch = useMediaQuery("(max-width: 920px)");
+    const [searchOpen, setSearchOpen] = React.useState(false);
+    const searchOverlay = compactSearch && searchOpen;
+    const searchDialogRef = React.useRef(null);
+    const searchTriggerRef = React.useRef(null);
     // Vertical is the primary scroll axis; sideways takes a deliberate swipe.
     const sessionListRef = React.useRef(null);
     // Selection reverts to plain taps wherever the primary input is a finger:
@@ -5159,6 +5169,8 @@ function SessionPane({ controller, actions = null, panelClassName = "", structur
         ownerFilter: state.sessions.ownerFilter,
         pinnedIds: state.sessions.pinnedIds,
         manualOrder: state.sessions.manualOrder,
+        sortMode: state.sessions.sortMode,
+        sortSnapshot: state.sessions.sortSnapshot,
         selectedIds: state.sessions.selectedIds,
         selectMode: state.sessions.selectMode,
         auth: state.auth,
@@ -5198,6 +5210,8 @@ function SessionPane({ controller, actions = null, panelClassName = "", structur
             ownerFilter: viewState.ownerFilter,
             pinnedIds: viewState.pinnedIds,
             manualOrder: viewState.manualOrder,
+            sortMode: viewState.sortMode,
+            sortSnapshot: viewState.sortSnapshot,
             selectedIds: viewState.selectedIds,
             selectMode: viewState.selectMode,
             listDeselected: viewState.listDeselected,
@@ -5216,7 +5230,7 @@ function SessionPane({ controller, actions = null, panelClassName = "", structur
             prefs: viewState.canvasPrefs,
         },
         budget: { paused: viewState.budgetPaused },
-    }), [viewState.activeSessionId, viewState.auth, viewState.branding, viewState.budgetPaused, viewState.canvasBySessionId, viewState.canvasPrefs, viewState.connectionMode, viewState.filterQuery, viewState.listDeselected, viewState.ownerFilter, viewState.pinnedIds, viewState.manualOrder, viewState.selectedIds, viewState.selectMode, viewState.sessionsById, viewState.sessionsFlat]);
+    }), [viewState.activeSessionId, viewState.auth, viewState.branding, viewState.budgetPaused, viewState.canvasBySessionId, viewState.canvasPrefs, viewState.connectionMode, viewState.filterQuery, viewState.listDeselected, viewState.ownerFilter, viewState.pinnedIds, viewState.manualOrder, viewState.sortMode, viewState.sortSnapshot, viewState.selectedIds, viewState.selectMode, viewState.sessionsById, viewState.sessionsFlat]);
     // Hold the previous rows when a poll produced identical output.
     const rows = useStableValue(computedRows);
     const searchScrollRef = React.useRef({ top: 0, left: 0, restore: false });
@@ -5236,6 +5250,35 @@ function SessionPane({ controller, actions = null, panelClassName = "", structur
         }
         searchEnvRef.current?.setQuery?.(next);
     }, []);
+    const closeSearch = React.useCallback(() => {
+        setSearchOpen(false);
+        setSearchQuery("");
+        requestAnimationFrame(() => searchTriggerRef.current?.focus({ preventScroll: true }));
+    }, [setSearchQuery]);
+    React.useLayoutEffect(() => {
+        const dialog = searchDialogRef.current;
+        if (!searchOverlay || !dialog) return undefined;
+        const viewport = window.visualViewport;
+        const resize = () => {
+            dialog.style.top = `${(viewport?.offsetTop || 0) + 8}px`;
+            dialog.style.left = `${(viewport?.offsetLeft || 0) + 8}px`;
+            dialog.style.width = `${(viewport?.width || window.innerWidth) - 16}px`;
+            dialog.style.height = `${(viewport?.height || window.innerHeight) - 16}px`;
+        };
+        resize();
+        dialog.showModal();
+        dialog.querySelector("input")?.focus({ preventScroll: true });
+        viewport?.addEventListener("resize", resize);
+        viewport?.addEventListener("scroll", resize);
+        window.addEventListener("resize", resize);
+        return () => {
+            viewport?.removeEventListener("resize", resize);
+            viewport?.removeEventListener("scroll", resize);
+            window.removeEventListener("resize", resize);
+            dialog.close();
+        };
+    }, [searchOverlay]);
+    React.useEffect(() => { if (!compactSearch) setSearchOpen(false); }, [compactSearch]);
     React.useLayoutEffect(() => {
         if (viewState.filterQuery || !searchScrollRef.current.restore || !sessionListRef.current) return;
         sessionListRef.current.scrollTop = searchScrollRef.current.top;
@@ -5369,7 +5412,7 @@ function SessionPane({ controller, actions = null, panelClassName = "", structur
     // rows/viewState from a ref that is refreshed on every render instead of
     // closing over them.
     const clickEnv = React.useRef(null);
-    clickEnv.current = { rows, viewState, controller, selection };
+    clickEnv.current = { rows, viewState, controller, selection, searchOverlay, closeSearch };
     // ── Drag sessions into / out of groups ────────────────────────────
     // Pointer-driven so it works from <button> rows, can render a collection
     // ghost for a multi-selection, and can highlight the destination folder.
@@ -5695,6 +5738,15 @@ function SessionPane({ controller, actions = null, panelClassName = "", structur
 
     const handleRowClick = React.useCallback((event, row) => {
         const { rows: currentRows, viewState: current, controller: ctl, selection: pick } = clickEnv.current;
+        if (clickEnv.current.searchOverlay && !row.isGroup) {
+            if (pick) pick.onSelect(row.sessionId);
+            else {
+                ctl.setFocus("sessions");
+                ctl.loadSession(row.sessionId).catch(() => {});
+            }
+            clickEnv.current.closeSearch();
+            return;
+        }
         if (pick) {
             if (row.isGroup || (row.hasChildren && row.active)) ctl.dispatch({ type: row.collapsed ? "sessions/expand" : "sessions/collapse", sessionId: row.sessionId });
             if (!row.isGroup) pick.onSelect(row.sessionId);
@@ -5938,14 +5990,12 @@ function SessionPane({ controller, actions = null, panelClassName = "", structur
                     : "Release to cancel"))
         : null;
 
-    return React.createElement(React.Fragment, null,
-    dragGhost,
-    actionsOnly ? (actionsHost ? createPortal(React.createElement("div", { className: "ps-moa-control-actions", onClick: onAction }, panelActions), actionsHost) : null) : React.createElement(Panel, {
-        title: [{ text: "Sessions", color: "yellow", bold: true }],
+    const sessionPanel = actionsOnly ? (actionsHost ? createPortal(React.createElement("div", { className: "ps-moa-control-actions", onClick: onAction }, panelActions), actionsHost) : null) : React.createElement(Panel, {
+        title: [{ text: searchOverlay ? "Find a session" : "Sessions", color: "yellow", bold: true }],
         color: "yellow",
         focused: viewState.focused,
         theme,
-        actions: selection ? React.createElement(React.Fragment, null,
+        actions: searchOverlay ? React.createElement(IconButton, { label: "Close session search", icon: "×", onClick: closeSearch }) : selection ? React.createElement(React.Fragment, null,
             selection.onCreate ? React.createElement(IconButton, {
                 className: "ps-mini-button", icon: React.createElement(PlusGlyph),
                 label: "Create New Session", onClick: selection.onCreate,
@@ -5991,16 +6041,45 @@ function SessionPane({ controller, actions = null, panelClassName = "", structur
                 setRef: setSessionButtonRef,
                 // Drag-to-folder is a fine-pointer gesture: arming it on
                 // touch hijacks the finger that should be scrolling the list.
-                drag: selection || touchInput ? null : dragHandlers,
+                drag: selection || touchInput || viewState.sortMode !== "saved" ? null : dragHandlers,
             }))),
-    React.createElement(SessionSearchControl, {
-        query: viewState.filterQuery,
-        onQuery: setSearchQuery,
-        matchCount: searchMatchCount,
-        mobile: isMobilePane,
-        listRef: sessionListRef,
-    }),
-    (showDetailBox === null ? !isMobilePane : showDetailBox)
+    React.createElement("div", {
+        className: "ps-session-find-controls",
+        onPointerDown: (event) => {
+            // Keep the search keyboard open while tapping sort, refresh, or clear.
+            // Safari otherwise blurs the field without focusing the button.
+            if (compactSearch && event.button === 0 && event.target.closest?.("button")
+                && event.currentTarget.contains(document.activeElement)
+                && document.activeElement?.matches("input")) event.preventDefault();
+        },
+    },
+        React.createElement("div", { className: "ps-session-sort-controls" },
+            React.createElement("div", { className: "ps-session-sort-modes", role: "group", "aria-label": "Session sort order" },
+                ...[["used", "Recently used", "M12 8v4l3 2", true], ["updated", "Recently updated", "M3 12h4l3-7 4 14 3-7h4"], ["saved", "Saved order", "M6 3h12v18l-6-4-6 4Z"]].map(([mode, label, path, clock]) => React.createElement(IconButton, {
+                    key: mode, label, className: "ps-session-sort-button", active: (viewState.sortMode || "saved") === mode, pressed: (viewState.sortMode || "saved") === mode,
+                    icon: React.createElement("svg", { viewBox: "0 0 24 24", width: 18, height: 18, fill: "none", stroke: "currentColor", strokeWidth: 1.8, strokeLinecap: "round", strokeLinejoin: "round", "aria-hidden": true }, clock ? React.createElement("circle", { cx: 12, cy: 12, r: 9 }) : null, React.createElement("path", { d: path })),
+                    onClick: () => controller.dispatch({ type: "sessions/sortMode", mode }),
+                }))),
+            React.createElement(IconButton, {
+                label: "Refresh session order", className: "ps-session-sort-refresh",
+                icon: React.createElement("svg", { viewBox: "0 0 24 24", width: 18, height: 18, fill: "none", stroke: "currentColor", strokeWidth: 1.8, strokeLinecap: "round", strokeLinejoin: "round", "aria-hidden": true }, React.createElement("path", { d: "M20 7v5h-5M20 12a8 8 0 1 0-2 5M20 7v5" })),
+                onClick: async () => {
+                    try { await controller.refreshSessions(); controller.dispatch({ type: "sessions/refreshSort" }); }
+                    catch { controller.dispatch({ type: "ui/status", text: "Could not refresh sessions. Try again." }); }
+                },
+            })),
+        React.createElement(SessionSearchControl, {
+            query: viewState.filterQuery,
+            onQuery: setSearchQuery,
+            matchCount: searchMatchCount,
+            mobile: compactSearch,
+            expanded: searchOverlay,
+            onOpen: () => setSearchOpen(true),
+            onClose: closeSearch,
+            triggerRef: searchTriggerRef,
+            listRef: sessionListRef,
+        })),
+    !searchOverlay && (showDetailBox === null ? !isMobilePane : showDetailBox)
         ? React.createElement(SessionDetailBox, {
             session: activeSession,
             childCount: activeRow?.childCount || 0,
@@ -6014,7 +6093,21 @@ function SessionPane({ controller, actions = null, panelClassName = "", structur
                 collapsed: !detailCollapsed,
             }),
         })
-        : null),
+        : null);
+
+    return React.createElement(React.Fragment, null,
+    dragGhost,
+    !searchOverlay ? sessionPanel : null,
+    React.createElement("dialog", {
+        ref: searchDialogRef,
+        className: "ps-session-search-overlay",
+        "aria-label": "Find a session",
+        onCancel: event => { event.preventDefault(); closeSearch(); },
+        onKeyDownCapture: event => {
+            if (event.key === "Escape") { event.preventDefault(); event.stopPropagation(); closeSearch(); }
+        },
+        onClick: event => { if (event.target === event.currentTarget) closeSearch(); },
+    }, searchOverlay ? sessionPanel : null),
     (manageOpen && activeSession && !activeSession.isGroup)
         ? React.createElement(SessionModifyModal, {
             controller,
@@ -7192,14 +7285,14 @@ export function evaluateKeyboardTakeover(baseline, viewportWidth, viewportHeight
 }
 
 /**
- * True while the on-screen keyboard is up AND the chat composer summoned it.
+ * True while the on-screen keyboard is up AND a matching control has focus.
  * Both conditions matter: height alone would fire for a modal's text field
  * and collapse the workspace behind the modal; focus alone would fire for
  * hardware keyboards that shrink nothing. State-driven on the keyboard
  * itself, so it reverts the moment the keyboard goes away — including the
  * iOS swipe-dismiss that closes the keyboard without blurring the input.
  */
-function useKeyboardTakeover(enabled) {
+function useKeyboardTakeover(enabled, focusSelector = ".ps-prompt-input") {
     const [takeover, setTakeover] = React.useState(false);
     React.useEffect(() => {
         if (!enabled || typeof window === "undefined" || !window.visualViewport) {
@@ -7211,7 +7304,7 @@ function useKeyboardTakeover(enabled) {
         let frame = 0;
         const evaluate = () => {
             frame = 0;
-            const composerFocused = Boolean(document.activeElement?.classList?.contains("ps-prompt-input"));
+            const composerFocused = Boolean(document.activeElement?.matches?.(focusSelector));
             const next = evaluateKeyboardTakeover(baseline, viewport.width, viewport.height, composerFocused);
             baseline = next.baseline;
             setTakeover(next.takeover);
@@ -7229,7 +7322,7 @@ function useKeyboardTakeover(enabled) {
             window.removeEventListener("focusin", schedule);
             window.removeEventListener("focusout", schedule);
         };
-    }, [enabled]);
+    }, [enabled, focusSelector]);
     return enabled ? takeover : false;
 }
 
@@ -9381,7 +9474,7 @@ function StatusStrip({ controller }) {
 // (hold ~450ms to see the label, release to dismiss — the long-press does not
 // fire onClick). aria-label carries the meaning for assistive tech.
 const ICON_HOVER_TOOLTIP_MS = 1000;
-function IconButton({ icon, label, onClick, disabled = false, active = false, className = "ps-toolbar-button" }) {
+function IconButton({ icon, label, onClick, disabled = false, active = false, pressed = undefined, className = "ps-toolbar-button" }) {
     // The tooltip is portaled to <body> so it escapes the toolbar/pane
     // overflow-clipping and stacking contexts (nested tooltips were hidden
     // behind, or bled through by, the panes). Coordinates are computed from
@@ -9524,6 +9617,7 @@ function IconButton({ icon, label, onClick, disabled = false, active = false, cl
         onClick: handleClick,
         disabled,
         "aria-label": label,
+        "aria-pressed": pressed,
         onPointerEnter: startHover,
         onPointerLeave: endHover,
         onPointerDown: startPress,
@@ -14666,6 +14760,8 @@ export function PilotSwarmWebApp({ controller, suspended = false, moa = null })
         // never persists — the reducer would reorder the list correctly and
         // the placement would vanish on reload.
         manualOrder: rootState.sessions.manualOrder,
+        sessionSortMode: rootState.sessions.sortMode,
+        sessionUsedAt: rootState.sessions.usedAt,
         // Pass the live Set reference here so shallow-equal sees the same
         // identity across renders (a fresh array would break memoization).
         // Conversion to a sorted array happens inside `normalizeProfileSettings`.
@@ -15007,7 +15103,7 @@ export function PilotSwarmWebApp({ controller, suspended = false, moa = null })
                 });
         }, 400);
         return undefined;
-    }, [controller, state.moa, state.activeSessionId, state.activityPaneAdjust, state.agentPickerUsage, state.canvasOpen, state.canvasPaneAdjust, state.canvasPrefs, state.canvasZen, state.collapsedSessionIds, state.diagnosticsOpen, state.diagnosticsPaneAdjust, state.diagnosticsSplitAdjust, state.ownerFilter, state.paneAdjust, state.manualOrder, state.pinnedIds, state.portalSessionColumnAdjust, state.rightPaneMode, state.sessionDetailCollapsed, state.sessionPaneAdjust, state.sessionViews, state.themeId, state.touchScale]);
+    }, [controller, state.moa, state.activeSessionId, state.activityPaneAdjust, state.agentPickerUsage, state.canvasOpen, state.canvasPaneAdjust, state.canvasPrefs, state.canvasZen, state.collapsedSessionIds, state.diagnosticsOpen, state.diagnosticsPaneAdjust, state.diagnosticsSplitAdjust, state.ownerFilter, state.paneAdjust, state.manualOrder, state.sessionSortMode, state.sessionUsedAt, state.pinnedIds, state.portalSessionColumnAdjust, state.rightPaneMode, state.sessionDetailCollapsed, state.sessionPaneAdjust, state.sessionViews, state.themeId, state.touchScale]);
 
     React.useEffect(() => {
         applyDocumentTheme(state.themeId);

package/web/dist/assets/{abnfDiagram-VRR7QNED-CidJDJrY.js → abnfDiagram-VRR7QNED-D__RWhK7.js}

@@ -1 +1 @@
-import{g as p,r as u,d as a}from"./chunk-MOJQB5TN-CDyGPb8L.js";import{p as f}from"./chunk-JWPE2WC7-AhysI3TD.js";import{_ as n,l as o}from"./mermaid.core-BPC8y2lr.js";import{M as c,b as d}from"./cynefin-VYW2F7L2-CHVeQsGv.js";import"./pilotswarm-BnfVgmru.js";var v=d().RailroadAbnf.parser.LangiumParser,i=n(e=>{const r=e.alternatives.map(g);return r.length===1?r[0]:{type:"choice",alternatives:r}},"transformAlternation"),g=n(e=>{const r=e.elements.map(y);return r.length===1?r[0]:{type:"sequence",elements:r}},"transformConcatenation"),b=n(e=>{if(e.includes("*")){const[t,s]=e.split("*"),l=t?parseInt(t,10):0,m=s?parseInt(s,10):1/0;return{min:l,max:m}}const r=parseInt(e,10);return{min:r,max:r}},"parseRepeat"),y=n(e=>{const r=A(e.primary);if(!e.repeat)return r;const{min:t,max:s}=b(e.repeat);return t===0&&s===1?{type:"optional",element:r}:{type:"repetition",element:r,min:t,max:s}},"transformElement"),A=n(e=>{switch(e.$type){case"AbnfStringLiteral":return{type:"terminal",value:e.value};case"AbnfNumVal":return{type:"terminal",value:e.value};case"AbnfRuleName":return{type:"nonterminal",name:e.name};case"AbnfGroup":return i(e.element);case"AbnfOptionalGroup":return{type:"optional",element:i(e.element)};default:throw new Error(`Unsupported ABNF primary node: ${e.$type}`)}},"transformPrimary"),P=n(e=>({name:e.name,definition:i(e.definition)}),"transformRule"),h=n(e=>{f(e,a),e.title&&a.setTitle(e.title),e.rules.map(r=>a.addRule(P(r)))},"populateDb"),R={parse:n(e=>{a.clear(),o.debug("[ABNF Parser] Starting Langium parse");const r=v.parse(e);if(r.lexerErrors.length>0||r.parserErrors.length>0)throw new c(r);const t=r.value;o.debug("[ABNF Parser] Parsed rules:",t.rules.length),h(t),o.debug("[ABNF Parser] Parse complete")},"parse"),parser:{yy:a}},B={parser:R,db:a,renderer:u,styles:p};export{B as diagram};
+import{g as p,r as u,d as a}from"./chunk-MOJQB5TN-BOfHzBMe.js";import{p as f}from"./chunk-JWPE2WC7-ZfmDblU2.js";import{_ as n,l as o}from"./mermaid.core-D7ywN4EU.js";import{M as c,b as d}from"./cynefin-VYW2F7L2-CD5a_UMt.js";import"./pilotswarm-Dccv5YRO.js";var v=d().RailroadAbnf.parser.LangiumParser,i=n(e=>{const r=e.alternatives.map(g);return r.length===1?r[0]:{type:"choice",alternatives:r}},"transformAlternation"),g=n(e=>{const r=e.elements.map(y);return r.length===1?r[0]:{type:"sequence",elements:r}},"transformConcatenation"),b=n(e=>{if(e.includes("*")){const[t,s]=e.split("*"),l=t?parseInt(t,10):0,m=s?parseInt(s,10):1/0;return{min:l,max:m}}const r=parseInt(e,10);return{min:r,max:r}},"parseRepeat"),y=n(e=>{const r=A(e.primary);if(!e.repeat)return r;const{min:t,max:s}=b(e.repeat);return t===0&&s===1?{type:"optional",element:r}:{type:"repetition",element:r,min:t,max:s}},"transformElement"),A=n(e=>{switch(e.$type){case"AbnfStringLiteral":return{type:"terminal",value:e.value};case"AbnfNumVal":return{type:"terminal",value:e.value};case"AbnfRuleName":return{type:"nonterminal",name:e.name};case"AbnfGroup":return i(e.element);case"AbnfOptionalGroup":return{type:"optional",element:i(e.element)};default:throw new Error(`Unsupported ABNF primary node: ${e.$type}`)}},"transformPrimary"),P=n(e=>({name:e.name,definition:i(e.definition)}),"transformRule"),h=n(e=>{f(e,a),e.title&&a.setTitle(e.title),e.rules.map(r=>a.addRule(P(r)))},"populateDb"),R={parse:n(e=>{a.clear(),o.debug("[ABNF Parser] Starting Langium parse");const r=v.parse(e);if(r.lexerErrors.length>0||r.parserErrors.length>0)throw new c(r);const t=r.value;o.debug("[ABNF Parser] Parsed rules:",t.rules.length),h(t),o.debug("[ABNF Parser] Parse complete")},"parse"),parser:{yy:a}},B={parser:R,db:a,renderer:u,styles:p};export{B as diagram};