@khorsheed/dsh-mobile 0.1.0 → 0.1.2

package/lib/types/client/ConnectPhone.js

@@ -32,9 +32,16 @@ export function ConnectPhone({ t }) {
         try {
             const response = await fetch(CONNECT_PATH, { method: generate ? 'POST' : 'GET', credentials: 'same-origin', cache: 'no-store', signal: controller.signal,
                 ...(generate ? { headers: { 'content-type': 'application/json' }, body: '{}' } : {}) });
-            if (!response.ok)
-                throw new Error('unavailable');
             const result = await response.json();
+            if (controller.signal.aborted)
+                return;
+            if (!response.ok) {
+                if (result.state === 'unreachable') {
+                    setInfo(result);
+                    return;
+                }
+                throw new Error('unavailable');
+            }
             if (controller.signal.aborted)
                 return;
             if (generate) {
@@ -64,7 +71,39 @@ export function ConnectPhone({ t }) {
         window.addEventListener('pagehide', hide);
         return () => { request.current?.abort(); clearTimeout(timer.current); document.removeEventListener('visibilitychange', conceal); window.removeEventListener('pagehide', hide); };
     }, []);
-    return _jsxs("section", { "data-mobile-connect": true, children: [_jsx("style", { children: styles }), _jsx("h2", { children: t('connectPhone') }), _jsx("p", { children: t('connectIntro') }), info?.origin && _jsxs("div", { "data-connect-host": true, children: [_jsx("span", { children: t('server') }), _jsx("strong", { children: new URL(info.origin).host })] }), info && info.state !== 'ready' && _jsx("div", { role: "status", children: _jsx("p", { children: t(info.state === 'untrusted-origin' ? 'connectUntrusted' : info.state === 'unsupported' ? 'connectUnsupported' : 'connectSetup') }) }), failed && _jsx("p", { role: "alert", children: t('connectError') }), busy && _jsx("p", { role: "status", children: t('connectLoading') }), login ? _jsxs("div", { "data-connect-code": true, children: [_jsx(LoginQR, { value: login, label: t('connectQR') }), _jsx("p", { children: t('connectConceal') }), _jsx("button", { type: "button", onClick: hide, children: t('connectHide') })] })
+    useEffect(() => {
+        if (!login)
+            return;
+        const controller = new AbortController();
+        let checking = false;
+        const poll = setInterval(async () => {
+            if (checking)
+                return;
+            checking = true;
+            try {
+                const response = await fetch(CONNECT_PATH, { credentials: 'same-origin', cache: 'no-store', signal: controller.signal });
+                if (!response.ok)
+                    throw new Error('unavailable');
+                const next = await response.json();
+                if (controller.signal.aborted)
+                    return;
+                setInfo(next);
+                if (next.state !== 'ready' || next.origin !== new URL(login).origin)
+                    hide();
+            }
+            catch {
+                if (!controller.signal.aborted) {
+                    hide();
+                    setFailed(true);
+                }
+            }
+            finally {
+                checking = false;
+            }
+        }, 15_000);
+        return () => { controller.abort(); clearInterval(poll); };
+    }, [login]);
+    return _jsxs("section", { "data-mobile-connect": true, children: [_jsx("style", { children: styles }), _jsx("h2", { children: t('connectPhone') }), _jsx("p", { children: t('connectIntro') }), info?.origin && _jsxs("div", { "data-connect-host": true, children: [_jsx("span", { children: t('server') }), _jsx("strong", { children: new URL(info.origin).host })] }), info && info.state !== 'ready' && _jsx("div", { role: "status", children: _jsx("p", { children: t(info.state === 'unreachable' ? 'connectUnreachable' : info.state === 'untrusted-origin' ? 'connectUntrusted' : info.state === 'unsupported' ? 'connectUnsupported' : 'connectSetup') }) }), failed && _jsx("p", { role: "alert", children: t('connectError') }), busy && _jsx("p", { role: "status", children: t('connectLoading') }), login ? _jsxs("div", { "data-connect-code": true, children: [_jsx(LoginQR, { value: login, label: t('connectQR') }), _jsx("p", { children: t('connectConceal') }), _jsx("button", { type: "button", onClick: hide, children: t('connectHide') })] })
                 : _jsx("button", { type: "button", disabled: busy, onClick: () => { void load(info?.state === 'ready'); }, children: t(info?.state === 'ready' ? 'connectGenerate' : 'directoryRetry') }), _jsxs("ol", { children: [_jsx("li", { children: t('connectStepOpen') }), _jsx("li", { children: t('connectStepScan') }), _jsx("li", { children: t('connectStepConfirm') })] }), _jsx("p", { "data-connect-note": true, children: t('connectPrivacy') }), _jsx("p", { "data-connect-note": true, children: t('connectNetwork') })] });
 }
 const styles = `

package/lib/types/client/MobileChrome.js

@@ -119,6 +119,6 @@ export function MobileChrome({ presentation, toggleSidebar, connection, navigati
     }, [state.drawer, settings, library, toggleSidebar]);
     if (!state.active && !settings && state.mode !== 'desktop')
         return null;
-    return _jsxs(_Fragment, { children: [!state.active && state.mode === 'desktop' && _jsx("button", { "data-mobile-restore": true, onClick: () => presentation.setMode('mobile'), children: t('restoreMobile') }), state.active && _jsxs(_Fragment, { children: [available && _jsxs("aside", { "data-mobile-library-pane": true, hidden: !library && !wide, children: [_jsxs("nav", { "data-mobile-library-toolbar": true, "aria-label": t('menu'), children: [_jsx("button", { "aria-label": t('settings'), onClick: openSettings, children: _jsx(MobileIcon, { name: "settings" }) }), _jsx("button", { "aria-label": t('newSession'), onClick: startSession, children: _jsx(MobileIcon, { name: "compose" }) })] }), _jsx(MobileLibrary, { ...(rooms ? { rooms } : {}), navigation: available, t: t, onBeforeOpen: presentation.prepareNavigation, onOpen: () => setLibrary(false) })] }), library && available && !wide && _jsx("button", { type: "button", "data-mobile-peek-close": true, "aria-label": t('returnToConversation'), onClick: () => { presentation.prepareNavigation(); setLibrary(false); } }), state.drawer && _jsx("button", { "data-mobile-shade": true, "aria-label": t('close'), onClick: toggleSidebar }), _jsxs("nav", { "data-mobile-toolbar": true, "data-library": false, "aria-label": t('menu'), children: [_jsx("button", { "aria-label": t('menu'), onClick: openLibrary, children: _jsx(MobileIcon, { name: "back" }) }), _jsxs("div", { "data-mobile-nav-title": true, children: [(available ? _jsx(ConversationTitle, { navigation: available, prepareNavigation: presentation.prepareNavigation, surface: presentation.surface, fallback: t('newSession'), t: t }) : _jsx("strong", { children: t('brand') })), wire !== 'connected' && !connectionExpanded && _jsx("small", { role: "status", children: t(wire ?? 'connecting') })] }), _jsx("button", { "data-mobile-new": !!available, "aria-label": available ? t('newSession') : t('settings'), onClick: available ? startSession : openSettings, children: _jsx(MobileIcon, { name: available ? "compose" : "settings" }) }), available && rooms && _jsx(MobileRoomNavigation, { rooms: rooms, navigation: available, prepareNavigation: presentation.prepareNavigation, t: t })] }), wire !== 'connected' && connectionExpanded && _jsxs("div", { "data-mobile-connection-status": true, role: "status", children: [_jsx("span", { children: t(wire ?? 'connecting') }), _jsx("button", { onClick: () => connection.reconnect(), children: t('reconnect') })] })] }), _jsxs("dialog", { ref: dialog, "data-mobile-dialog": true, onClose: () => setSettings(false), "aria-label": t('settings'), children: [_jsx("h2", { children: t('settings') }), available && _jsx("button", { "data-mobile-option": true, onClick: startSession, children: t('newSession') }), _jsx("button", { "data-mobile-option": true, onClick: () => { setSettings(false); setLibrary(false); if (!state.drawer)
+    return _jsxs(_Fragment, { children: [!state.active && state.mode === 'desktop' && _jsx("button", { "data-mobile-restore": true, onClick: () => presentation.setMode('mobile'), children: t('restoreMobile') }), state.active && _jsxs(_Fragment, { children: [available && _jsxs("aside", { "data-mobile-library-pane": true, hidden: !library && !wide, children: [_jsxs("nav", { "data-mobile-library-toolbar": true, "aria-label": t('menu'), children: [_jsx("button", { "aria-label": t('settings'), onClick: openSettings, children: _jsx(MobileIcon, { name: "settings" }) }), _jsx("button", { "aria-label": t('newSession'), onClick: startSession, children: _jsx(MobileIcon, { name: "compose" }) })] }), _jsx(MobileLibrary, { ...(rooms ? { rooms } : {}), navigation: available, visible: library || wide, t: t, onBeforeOpen: presentation.prepareNavigation, onOpen: () => setLibrary(false) })] }), library && available && !wide && _jsx("button", { type: "button", "data-mobile-peek-close": true, "aria-label": t('returnToConversation'), onClick: () => { presentation.prepareNavigation(); setLibrary(false); } }), state.drawer && _jsx("button", { "data-mobile-shade": true, "aria-label": t('close'), onClick: toggleSidebar }), _jsxs("nav", { "data-mobile-toolbar": true, "data-library": false, "aria-label": t('menu'), children: [_jsx("button", { "aria-label": t('menu'), onClick: openLibrary, children: _jsx(MobileIcon, { name: "back" }) }), _jsxs("div", { "data-mobile-nav-title": true, children: [(available ? _jsx(ConversationTitle, { navigation: available, prepareNavigation: presentation.prepareNavigation, surface: presentation.surface, fallback: t('newSession'), t: t }) : _jsx("strong", { children: t('brand') })), wire !== 'connected' && !connectionExpanded && _jsx("small", { role: "status", children: t(wire ?? 'connecting') })] }), _jsx("button", { "data-mobile-new": !!available, "aria-label": available ? t('newSession') : t('settings'), onClick: available ? startSession : openSettings, children: _jsx(MobileIcon, { name: available ? "compose" : "settings" }) }), available && rooms && _jsx(MobileRoomNavigation, { rooms: rooms, navigation: available, prepareNavigation: presentation.prepareNavigation, t: t })] }), wire !== 'connected' && connectionExpanded && _jsxs("div", { "data-mobile-connection-status": true, role: "status", children: [_jsx("span", { children: t(wire ?? 'connecting') }), _jsx("button", { onClick: () => connection.reconnect(), children: t('reconnect') })] })] }), _jsxs("dialog", { ref: dialog, "data-mobile-dialog": true, onClose: () => setSettings(false), "aria-label": t('settings'), children: [_jsx("h2", { children: t('settings') }), available && _jsx("button", { "data-mobile-option": true, onClick: startSession, children: t('newSession') }), _jsx("button", { "data-mobile-option": true, onClick: () => { setSettings(false); setLibrary(false); if (!state.drawer)
                             toggleSidebar(); }, children: t('workspaces') }), hasNativeAction('settings') ? _jsx("button", { "data-mobile-option": true, onClick: () => { setSettings(false); requestNativeAction('settings'); }, children: t('connectionSettings') }) : _jsxs(_Fragment, { children: [_jsx("h3", { children: t('connection') }), _jsx("p", { children: window.location.host }), _jsx("p", { children: t(wire ?? 'connecting') }), _jsx("button", { onClick: () => connection.reconnect(), children: t('reconnect') })] }), _jsx("h3", { children: t('display') }), _jsx("div", { role: "group", "aria-label": t('display'), children: ['auto', 'mobile', 'desktop'].map((mode) => _jsx("button", { "aria-pressed": state.mode === mode, onClick: () => presentation.setMode(mode), children: t(mode === 'auto' ? 'automatic' : mode) }, mode)) }), _jsx("p", { children: t('appearance') }), _jsx("button", { "data-mobile-done": true, onClick: () => setSettings(false), children: t('done') })] })] });
 }

package/lib/types/client/MobileLibrary.d.ts

@@ -6,8 +6,9 @@ type Props = PropsLocale<'mobile'> & {
     navigation: NavigationCapabilities;
     onOpen: () => void;
     onBeforeOpen?: () => void;
+    visible?: boolean;
 };
 /** Browse official metadata; the official workspace service remains the only navigation writer. */
-export declare function MobileLibrary({ rooms, navigation, onOpen, onBeforeOpen, t }: Props): import("react").JSX.Element;
+export declare function MobileLibrary({ rooms, navigation, onOpen, onBeforeOpen, visible, t }: Props): import("react").JSX.Element;
 export {};
 //# sourceMappingURL=MobileLibrary.d.ts.map

package/lib/types/client/MobileLibrary.js

@@ -1,10 +1,12 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { useCallback, useEffect, useRef, useState, useSyncExternalStore } from 'react';
+import { useCallback, useEffect, useMemo, useRef, useState, useSyncExternalStore } from 'react';
 import { GROUPING_KEY, groupSessions, mainSessionId, recentSessions } from './navigation.js';
+import { CatalogReads } from './catalogReads.js';
 import { MobileIcon } from './MobileIcon.js';
 import { hasNativeAction, requestNativeAction } from './native.js';
 /** Browse official metadata; the official workspace service remains the only navigation writer. */
-export function MobileLibrary({ rooms, navigation, onOpen, onBeforeOpen, t }) {
+export function MobileLibrary({ rooms, navigation, onOpen, onBeforeOpen, visible = true, t }) {
+    const reads = useMemo(() => new CatalogReads(), [navigation.sessions]);
     const sessionFeed = navigation.sessions.list, workspaceFeed = navigation.workspaces.list;
     // Official feeds may expose prototype methods. Keep their receiver and stable subscriptions.
     const sessions = useSyncExternalStore(useCallback(listener => sessionFeed.subscribe(listener), [sessionFeed]), useCallback(() => sessionFeed.getSnapshot(), [sessionFeed]));
@@ -46,28 +48,45 @@ export function MobileLibrary({ rooms, navigation, onOpen, onBeforeOpen, t }) {
                                                 catch {
                                                     setError(true);
                                                 }
-                                            }, children: [_jsxs("span", { "data-mobile-session-copy": true, children: [_jsx("strong", { children: row.title || (row.blank ? t('newSession') : row.displayTitle) }), _jsx(SessionMetadata, { id: row.id, cwd: row.cwd ?? '', ...(rooms ? { rooms } : {}), t: t })] }), row.running ? _jsx("span", { "data-mobile-activity": true, role: "status", children: t('running') }) : _jsx("time", { dateTime: new Date(row.updatedAt).toISOString(), children: new Date(row.updatedAt).toLocaleDateString(undefined, { month: 'short', day: 'numeric' }) })] }) }, row.id)) })] }, group.key);
+                                            }, children: [_jsxs("span", { "data-mobile-session-copy": true, children: [_jsx("strong", { children: row.title || (row.blank ? t('newSession') : row.displayTitle) }), _jsx(SessionMetadata, { row: row, sessions: navigation.sessions, reads: reads, visible: visible, ...(rooms ? { rooms } : {}), t: t })] }), row.running ? _jsx("span", { "data-mobile-activity": true, role: "status", children: t('running') }) : _jsx("time", { dateTime: new Date(row.updatedAt).toISOString(), children: new Date(row.updatedAt).toLocaleDateString(undefined, { month: 'short', day: 'numeric' }) })] }) }, row.id)) })] }, group.key);
                     })] }), _jsxs("footer", { "data-mobile-search-dock": true, children: [_jsxs("label", { "data-mobile-search": true, children: [_jsx(MobileIcon, { name: "search", size: 20 }), _jsx("input", { ref: input, type: "search", enterKeyHint: "search", autoComplete: "off", value: query, onFocus: () => setSearching(true), onChange: e => setQuery(e.target.value), placeholder: t('searchTitles'), "aria-label": t('searchTitles') })] }), searching ? _jsx("button", { "data-mobile-search-cancel": true, "aria-label": t('cancel'), onClick: () => { setQuery(''); setSearching(false); input.current?.blur(); }, children: _jsx(MobileIcon, { name: "close" }) }) : hasNativeAction('scan') && _jsx("button", { "data-mobile-scan": true, "aria-label": t('scan'), onClick: () => requestNativeAction('scan'), children: _jsx(MobileIcon, { name: "scan" }) })] })] });
 }
 const emptyRoomSubscribe = () => () => { };
 const emptyRoomSnapshot = () => 0;
-function SessionMetadata({ id, cwd, rooms, t }) {
+function SessionMetadata({ row, sessions, reads, visible, rooms, t }) {
     const ref = useRef(null);
     useSyncExternalStore(rooms?.subscribe ?? emptyRoomSubscribe, rooms?.getSnapshot ?? emptyRoomSnapshot);
     useEffect(() => {
-        if (!rooms?.available() || !ref.current)
+        if (!visible || !ref.current)
             return;
+        let cancel;
+        const enter = () => {
+            if (cancel)
+                return;
+            // Cold list hints may omit titles. Read the official projection store without
+            // retaining/opening a Session; queued title reads take priority over Room scans.
+            const cancelTitle = !row.title && !row.blank && typeof sessions.refreshProjections === 'function'
+                ? reads.add(async () => { await sessions.refreshProjections(row.id); }, 0)
+                : undefined;
+            const cancelRoom = rooms?.available()
+                ? reads.add(async () => { await rooms.refresh(row.id); })
+                : undefined;
+            cancel = () => { cancelTitle?.(); cancelRoom?.(); };
+        };
+        const leave = () => { cancel?.(); cancel = undefined; };
         if (typeof IntersectionObserver === 'undefined') {
-            void rooms.refresh(id);
-            return;
+            enter();
+            return leave;
         }
-        const observer = new IntersectionObserver(entries => { if (entries.some(e => e.isIntersecting)) {
-            void rooms.refresh(id);
-            observer.disconnect();
-        } });
+        const observer = new IntersectionObserver(entries => {
+            if (entries.some(entry => entry.isIntersecting))
+                enter();
+            else
+                leave();
+        }, { root: ref.current.closest('[data-mobile-recents]') });
         observer.observe(ref.current);
-        return () => observer.disconnect();
-    }, [rooms, id]);
-    const state = rooms?.get(id), count = state ? state.members.length : state === null || !rooms?.available() ? 1 : '…';
-    return _jsxs("small", { ref: ref, children: [cwd.split(/[\\/]/).filter(Boolean).at(-1) || t('unassignedWorkspace'), " \u00B7 ", count, " ", t('memberUnit')] });
+        return () => { observer.disconnect(); leave(); };
+    }, [rooms, row.id, row.title, row.blank, sessions, reads, visible]);
+    const state = rooms?.get(row.id), count = state ? state.members.length : state === null || !rooms?.available() ? 1 : '…';
+    return _jsxs("small", { ref: ref, children: [(row.cwd ?? '').split(/[\\/]/).filter(Boolean).at(-1) || t('unassignedWorkspace'), " \u00B7 ", count, " ", t('memberUnit')] });
 }

package/lib/types/client/MobileTools.d.ts

@@ -1,7 +1,17 @@
 import type { PropsRuntime, PropsLocale } from '@deepseek-ai/dsh-client-ui-slots';
+import { ComposerActions } from './composerActions.ts';
 import type { MobileRooms } from './rooms.ts';
-/** Own only the launcher and grouped navigation; action targets stay host-owned. */
-export declare function MobileTools({ t, useSession, rooms }: PropsLocale<'mobile'> & PropsRuntime<'conversation.input.left'> & {
+import type { SessionSummary } from '@deepseek-ai/dsh-api-session-controller/client';
+import type { TokenSpan } from '@deepseek-ai/dsh-client-ui-conversation/client';
+export interface MobileToolsInjected {
     rooms: MobileRooms;
-}): import("react").JSX.Element;
+    openCommands: (id: SessionSummary['id'], draft: string, span: TokenSpan) => boolean;
+}
+/** Own only the launcher and grouped navigation; action targets stay host-owned. */
+export declare function MobileTools({ t, useSession, useInput, inputActions, rooms, openCommands }: PropsLocale<'mobile'> & PropsRuntime<'conversation.input.left'> & MobileToolsInjected): import("react").JSX.Element;
+export declare function Tools({ actions, t, invite, openCommands }: {
+    actions: ComposerActions;
+    openCommands?: (() => boolean) | undefined;
+    invite: (() => void) | undefined;
+} & PropsLocale<'mobile'>): import("react").JSX.Element | null;
 //# sourceMappingURL=MobileTools.d.ts.map

package/lib/types/client/MobileTools.js

@@ -4,8 +4,9 @@ import { ComposerActions } from './composerActions.js';
 import { openMobileMembers } from './MobileRooms.js';
 import { MobileIcon } from './MobileIcon.js';
 /** Own only the launcher and grouped navigation; action targets stay host-owned. */
-export function MobileTools({ t, useSession, rooms }) {
+export function MobileTools({ t, useSession, useInput, inputActions, rooms, openCommands }) {
     const sessionId = useSession(s => s.sessionId);
+    const draft = useInput(s => s.draft);
     const seat = useRef(null);
     const [actions, setActions] = useState();
     useLayoutEffect(() => {
@@ -15,9 +16,9 @@ export function MobileTools({ t, useSession, rooms }) {
         setActions(controller);
         return () => controller.dispose();
     }, []);
-    return _jsx("span", { ref: seat, "data-mobile-tools-seat": true, children: actions && _jsx(Tools, { actions: actions, t: t, invite: rooms.available() ? () => openMobileMembers(sessionId, true) : undefined }) });
+    return _jsx("span", { ref: seat, "data-mobile-tools-seat": true, children: actions && _jsx(Tools, { actions: actions, t: t, openCommands: openCommands ? () => openCommands(sessionId, draft, inputActions.captureInsertion()) : undefined, invite: rooms.available() ? () => openMobileMembers(sessionId, true) : undefined }) });
 }
-function Tools({ actions, t, invite }) {
+export function Tools({ actions, t, invite, openCommands }) {
     const targets = useSyncExternalStore(actions.subscribe, actions.getSnapshot);
     const dialog = useRef(null), launcher = useRef(null);
     const close = () => { dialog.current?.close(); launcher.current?.setAttribute('aria-expanded', 'false'); };
@@ -25,8 +26,9 @@ function Tools({ actions, t, invite }) {
         close(); }, [targets.commands, targets.attachments]);
     if (!targets.commands || !targets.attachments)
         return null;
-    const invoke = (action) => { close(); actions.invoke(action); };
-    return _jsxs(_Fragment, { children: [_jsx("button", { ref: launcher, "data-mobile-tools-open": true, "aria-label": t('inputTools'), "aria-haspopup": "dialog", "aria-expanded": "false", onClick: () => { dialog.current?.showModal(); launcher.current?.setAttribute('aria-expanded', 'true'); }, children: _jsx(MobileIcon, { name: "plus" }) }), _jsxs("dialog", { ref: dialog, "data-mobile-tools-dialog": true, "aria-label": t('inputTools'), onClose: () => launcher.current?.setAttribute('aria-expanded', 'false'), onClick: event => { if (event.target === dialog.current) {
+    const invoke = (action) => { close(); actions.invoke(action, openCommands); };
+    return _jsxs(_Fragment, { children: [_jsx("button", { ref: launcher, "data-mobile-tools-open": true, "aria-label": t('inputTools'), "aria-haspopup": "dialog", "aria-expanded": "false", onClick: () => { if (document.activeElement instanceof HTMLElement)
+                    document.activeElement.blur(); launcher.current?.focus({ preventScroll: true }); dialog.current?.showModal(); launcher.current?.setAttribute('aria-expanded', 'true'); }, children: _jsx(MobileIcon, { name: "plus" }) }), _jsxs("dialog", { ref: dialog, "data-mobile-tools-dialog": true, "aria-label": t('inputTools'), onClose: () => launcher.current?.setAttribute('aria-expanded', 'false'), onClick: event => { if (event.target === dialog.current) {
                     const r = dialog.current.getBoundingClientRect();
                     if (event.clientY < r.top || event.clientX < r.left || event.clientX > r.right || event.clientY > r.bottom)
                         close();

package/lib/types/client/catalogReads.d.ts

@@ -0,0 +1,10 @@
+/** Bound optional catalog enrichment so cold log reads cannot fan out across the library. */
+export declare class CatalogReads {
+    private readonly limit;
+    private pending;
+    private running;
+    constructor(limit?: number);
+    add(work: (active: () => boolean) => Promise<void>, priority?: number): () => void;
+    private pump;
+}
+//# sourceMappingURL=catalogReads.d.ts.map

package/lib/types/client/catalogReads.js

@@ -0,0 +1,28 @@
+/** Bound optional catalog enrichment so cold log reads cannot fan out across the library. */
+export class CatalogReads {
+    limit;
+    pending = [];
+    running = 0;
+    constructor(limit = 2) {
+        this.limit = limit;
+    }
+    add(work, priority = 1) {
+        const item = { cancelled: false, priority, work };
+        this.pending.push(item);
+        this.pending.sort((a, b) => a.priority - b.priority);
+        this.pump();
+        return () => { item.cancelled = true; this.pending = this.pending.filter(entry => entry !== item); };
+    }
+    pump() {
+        while (this.running < this.limit && this.pending.length) {
+            const item = this.pending.shift();
+            if (item.cancelled)
+                continue;
+            this.running++;
+            // The owner APIs have no caller cancellation. Keep their slot until they settle;
+            // cancelling only suppresses queued reads and subsequent optional work.
+            void Promise.resolve().then(() => item.cancelled ? undefined : item.work(() => !item.cancelled))
+                .catch(() => { }).finally(() => { this.running--; this.pump(); });
+        }
+    }
+}

package/lib/types/client/commands.d.ts

@@ -0,0 +1,18 @@
+import type { Context } from '@deepseek-ai/cordis';
+import type { TokenSpan } from '@deepseek-ai/dsh-client-ui-conversation/client';
+/** Narrow structural face of the host's public inputTriggers.sessionOf API.
+ * Candidate discovery, filtering and picks remain owned by the host. */
+export interface MobileCommandController {
+    toggleSource(source: string, hit: {
+        trigger: '/';
+        query: string;
+        quoted: boolean;
+        position: 'leading' | 'inline';
+        span: TokenSpan;
+    }): void;
+}
+export interface MobileCommandService {
+    sessionOf(ctx: Context): MobileCommandController;
+}
+export declare function openMobileCommands(controller: MobileCommandController | undefined, draft: string, span: TokenSpan): boolean;
+//# sourceMappingURL=commands.d.ts.map

package/lib/types/client/commands.js

@@ -0,0 +1,6 @@
+export function openMobileCommands(controller, draft, span) {
+    if (!controller || typeof controller.toggleSource !== 'function')
+        return false;
+    controller.toggleSource('command', { trigger: '/', query: '', quoted: false, position: draft.slice(0, span.start).trim() === '' ? 'leading' : 'inline', span });
+    return true;
+}

package/lib/types/client/composerActions.d.ts

@@ -1,8 +1,8 @@
-/** Checked rc1 button bridge. The official editor, chooser, permission menu and
+/** Checked legacy and 0.1.7 composer bridge. The official editor, chooser, permission menu and
  * confirmation remain mounted and retain their callbacks. Unknown markup falls back. */
 export type ComposerAction = 'commands' | 'attachments' | 'permissions';
 export interface ActionTarget {
-    button: HTMLButtonElement;
+    button: HTMLButtonElement | HTMLInputElement;
     label: string;
     disabled: boolean;
 }
@@ -18,7 +18,7 @@ export declare class ComposerActions {
     readonly subscribe: (listener: () => void) => () => void;
     private sync;
     private target;
-    invoke(action: ComposerAction): boolean;
+    invoke(action: ComposerAction, openCommands?: () => boolean): boolean;
     dispose(): void;
 }
 //# sourceMappingURL=composerActions.d.ts.map

package/lib/types/client/composerActions.js

@@ -9,7 +9,7 @@ export class ComposerActions {
         this.observer = new MutationObserver(() => this.sync());
         const card = seat.closest('[data-composer-card]');
         if (card)
-            this.observer.observe(card, { childList: true, subtree: true, characterData: true, attributes: true, attributeFilter: ['disabled', 'aria-label'] });
+            this.observer.observe(card, { childList: true, subtree: true, characterData: true, attributes: true, attributeFilter: ['disabled', 'aria-label', 'contenteditable'] });
         this.sync();
     }
     getSnapshot = () => this.snapshot;
@@ -17,14 +17,21 @@ export class ComposerActions {
     sync() {
         const card = this.seat.closest('[data-composer-card]');
         const file = card?.querySelector(':scope > div:last-child > div:first-child > input[type=file][hidden]');
-        const attachments = file?.previousElementSibling;
-        const commands = attachments?.previousElementSibling;
+        const previous = file?.previousElementSibling;
+        const unified = previous instanceof HTMLButtonElement && previous.getAttribute('aria-haspopup') === 'listbox';
+        const attachments = unified ? file : previous;
+        const commands = unified ? previous : previous?.previousElementSibling;
         const next = {};
-        if (commands instanceof HTMLButtonElement && commands.getAttribute('aria-haspopup') === 'listbox' && attachments instanceof HTMLButtonElement) {
+        if (commands instanceof HTMLButtonElement && commands.getAttribute('aria-haspopup') === 'listbox' && (attachments instanceof HTMLButtonElement || attachments instanceof HTMLInputElement)) {
             next.commands = this.target(commands);
             next.attachments = this.target(attachments);
+            // The new host retains its file input and onChange validation, but folds
+            // its button into commands. Match the owner picker admission: editable
+            // composer (live, unlocked, not committing) and input enabled (not child).
+            if (unified)
+                next.attachments.disabled ||= commands.disabled || !card?.querySelector('[contenteditable="true"]');
             const modes = file?.nextElementSibling;
-            const permission = modes?.querySelector(':scope > span > button[aria-label]');
+            const permission = modes?.querySelector('[data-slot="conversation.input.permission"] button[aria-label], :scope > span > button[aria-label]');
             // PermissionSelect has a text label between optional glyph and chevron spans.
             if (permission?.querySelector(':scope > span:not([aria-hidden])') && permission.querySelector(':scope > span[aria-hidden] svg'))
                 next.permissions = this.target(permission);
@@ -35,7 +42,7 @@ export class ComposerActions {
                 this.marked.delete(button);
             }
         for (const value of Object.values(next))
-            if (!this.marked.has(value.button)) {
+            if (value.button instanceof HTMLButtonElement && !this.marked.has(value.button)) {
                 value.button.setAttribute('data-mobile-folded-action', '');
                 this.marked.add(value.button);
             }
@@ -48,13 +55,15 @@ export class ComposerActions {
     target(button) {
         return { button, label: button.textContent?.trim() || button.getAttribute('aria-label') || '', disabled: button.disabled };
     }
-    invoke(action) {
+    invoke(action, openCommands) {
         this.sync();
         const target = this.snapshot[action];
         if (!target || target.disabled || !target.button.isConnected)
             return false;
-        // The official command list is a combobox whose keyboard handling stays
-        // with Lexical. Only an explicit command-menu choice may focus the editor.
+        // Open the public source without focusing Lexical. Older hosts retain
+        // their original button behavior when the optional service is absent.
+        if (action === 'commands' && openCommands?.())
+            return true;
         if (action === 'commands')
             this.seat.closest('[data-composer-card]')?.querySelector('[contenteditable="true"]')?.focus({ preventScroll: true });
         // Synchronous with the user's click, including the native file-picker gesture.

package/lib/types/client/index.js

@@ -6,11 +6,13 @@ import { MobileDirectory, installMobileDirectoryPicker } from './directory.js';
 import { MobileNavigation, mainSessionId } from './navigation.js';
 import { MobileWelcome } from './MobileSeats.js';
 import { MobileSubmissionFocus } from './SubmissionFocus.js';
+import { openMobileCommands } from './commands.js';
 import { MobileTools } from './MobileTools.js';
 import { MobileChrome } from './MobileChrome.js';
 import { MobileQueue } from './MobileQueue.js';
 import { MobileRooms } from './rooms.js';
 import { MessageMenu } from './messageMenu.js';
+import { installSheetGestures } from './sheetGestures.js';
 import { installForegroundRecovery } from './foreground.js';
 import { NS, en, zh } from './locales.js';
 export const inject = ['slots', 'locale', 'layout', 'connection'];
@@ -36,6 +38,7 @@ export function apply(ctx) {
     ctx.effect(() => { const off = presentation.subscribe(() => { if (!presentation.getSnapshot().active)
         directory.finish(null); }); return () => { off(); directory.finish(null); }; }, 'mobile: pending directory');
     ctx.slots.inject('shell.overlay', () => ctx.slots.register({ name: 'shell.overlay', id: 'mobile-directory', locale: NS, inject: () => ({ directory, navigation }) }, MobileDirectoryOverlay));
+    ctx.effect(() => installSheetGestures(document), 'mobile: sheet dismissal');
     ctx.effect(() => () => { presentation.dispose(); }, 'mobile: presentation');
     ctx.effect(() => {
         let remove;
@@ -104,7 +107,11 @@ export function apply(ctx) {
         let remove;
         const sync = () => {
             if (presentation.getSnapshot().active)
-                remove ??= ctx.slots.register({ name: 'conversation.input.left', id: 'mobile-input-tools', order: -100, locale: NS, inject: () => ({ rooms }) }, MobileTools);
+                remove ??= ctx.slots.register({ name: 'conversation.input.left', id: 'mobile-input-tools', order: -100, locale: NS, inject: () => ({ rooms, openCommands: (id, draft, span) => {
+                            const actx = ctx.get('sessions')?.scope(id);
+                            const service = ctx.get('inputTriggers');
+                            return actx !== undefined && typeof service?.sessionOf === 'function' && openMobileCommands(service.sessionOf(actx), draft, span);
+                        } }) }, MobileTools);
             else {
                 remove?.();
                 remove = undefined;

package/lib/types/client/locales.d.ts

@@ -12,6 +12,7 @@ export declare const en: {
     readonly connectStepConfirm: "Scan this code, check the host address, then confirm the connection.";
     readonly connectPrivacy: "This QR code grants access to this host. Keep it private. Hiding the code does not revoke the official login link; it remains valid until the host process restarts.";
     readonly connectNetwork: "Keep the computer and its HTTPS entry online. Scanning reconnects the App; it cannot repair a disconnected tunnel.";
+    readonly connectUnreachable: "The public connection is unavailable. Wait for the computer to restore it, then retry to get a new QR code.";
     readonly connectSetup: "The operator must configure a reachable HTTPS origin using mobile.publicOrigin or DSH_MOBILE_PUBLIC_ORIGIN, and add its hostname to the host trusted hosts.";
     readonly connectUntrusted: "The configured address is not trusted by this host. Update --trusted-host and restart the host before generating a code.";
     readonly connectUnsupported: "This host version cannot provide official login links. Update the supported host/plugin combination.";

package/lib/types/client/locales.js

@@ -12,6 +12,7 @@ export const en = {
     connectStepConfirm: "Scan this code, check the host address, then confirm the connection.",
     connectPrivacy: "This QR code grants access to this host. Keep it private. Hiding the code does not revoke the official login link; it remains valid until the host process restarts.",
     connectNetwork: "Keep the computer and its HTTPS entry online. Scanning reconnects the App; it cannot repair a disconnected tunnel.",
+    connectUnreachable: "The public connection is unavailable. Wait for the computer to restore it, then retry to get a new QR code.",
     connectSetup: "The operator must configure a reachable HTTPS origin using mobile.publicOrigin or DSH_MOBILE_PUBLIC_ORIGIN, and add its hostname to the host trusted hosts.",
     connectUntrusted: "The configured address is not trusted by this host. Update --trusted-host and restart the host before generating a code.",
     connectUnsupported: "This host version cannot provide official login links. Update the supported host/plugin combination.",
@@ -51,6 +52,7 @@ export const zh = {
     connectStepConfirm: "扫描二维码，核对主机地址后确认连接。",
     connectPrivacy: "二维码可授予这台主机的访问权限，请勿分享。隐藏二维码不会撤销官方登录链接；链接在宿主进程重启前仍然有效。",
     connectNetwork: "请保持电脑和 HTTPS 入口在线。扫码用于重新连接 App，无法修复已经断开的隧道。",
+    connectUnreachable: "公网入口暂不可用。请等待电脑端恢复后重试，获取新的二维码。",
     connectSetup: "请由部署者通过 mobile.publicOrigin 或 DSH_MOBILE_PUBLIC_ORIGIN 配置手机可达的 HTTPS 地址，并将域名加入宿主信任列表。",
     connectUntrusted: "宿主尚未信任配置的地址。请更新 --trusted-host 并重启宿主后再生成二维码。",
     connectUnsupported: "此宿主版本不能提供官方登录链接，请更新到支持的宿主和插件组合。",

package/lib/types/client/sheetGestures.d.ts

@@ -0,0 +1,3 @@
+/** Mobile dismissal delegates to native dialog.close or the Room owner's close handler. */
+export declare function installSheetGestures(doc: Document): () => void;
+//# sourceMappingURL=sheetGestures.d.ts.map

package/lib/types/client/sheetGestures.js

@@ -0,0 +1,81 @@
+/** Mobile dismissal delegates to native dialog.close or the Room owner's close handler. */
+export function installSheetGestures(doc) {
+    let drag;
+    const reset = () => { if (drag)
+        drag.sheet.style.transform = drag.transform; drag = undefined; };
+    const close = (overlay) => {
+        if (overlay.isConnected && doc.documentElement.hasAttribute('data-dsh-mobile')) {
+            if (overlay instanceof HTMLDialogElement) {
+                overlay.close();
+                return;
+            }
+            overlay.dispatchEvent(new MouseEvent('mousedown', { bubbles: true, cancelable: true }));
+        }
+    };
+    const down = (event) => {
+        reset();
+        if (!doc.documentElement.hasAttribute('data-dsh-mobile') || event.touches.length !== 1)
+            return;
+        const target = event.target;
+        const native = target.closest('dialog[data-mobile-tools-dialog][open]');
+        const overlay = native ?? target.closest('[data-mobile-room-overlay]');
+        const sheet = native ?? overlay?.querySelector('[data-mobile-room-form]');
+        if (!sheet || !overlay || !native && doc.querySelector('dialog[open]') || doc.getSelection()?.toString())
+            return;
+        const point = event.touches[0], bounds = sheet.getBoundingClientRect();
+        const outside = native ? target === native && (point.clientY < bounds.top || point.clientY > bounds.bottom || point.clientX < bounds.left || point.clientX > bounds.right) : target === overlay;
+        // Only the handle/title band claims drags; the form body keeps native scrolling.
+        if (!outside && (sheet.scrollTop > 0 || point.clientY > sheet.getBoundingClientRect().top + 96
+            || target.closest('button,input,textarea,select,details,a,[contenteditable],[role=menu]')))
+            return;
+        drag = { sheet, overlay, x: point.clientX, y: point.clientY, outside, dragging: false, transform: sheet.style.transform };
+    };
+    const move = (event) => {
+        if (!drag)
+            return;
+        if (event.touches.length !== 1 || !drag.sheet.isConnected || !doc.documentElement.hasAttribute('data-dsh-mobile')) {
+            reset();
+            return;
+        }
+        const dx = event.touches[0].clientX - drag.x, dy = event.touches[0].clientY - drag.y;
+        if (drag.outside) {
+            if (Math.hypot(dx, dy) > 10)
+                reset();
+            return;
+        }
+        if (!drag.dragging && (dy < -10 || Math.abs(dx) > 12 && Math.abs(dx) > Math.abs(dy))) {
+            reset();
+            return;
+        }
+        if (!drag.dragging && (dy < 12 || dy < Math.abs(dx) * 1.5))
+            return;
+        drag.dragging = true;
+        drag.sheet.style.transform = `translate3d(0,${Math.max(0, dy)}px,0)`;
+        if (event.cancelable)
+            event.preventDefault();
+    };
+    const up = (event) => {
+        const from = drag, point = event.changedTouches[0];
+        reset();
+        if (!from || !point)
+            return;
+        const dx = point.clientX - from.x, dy = point.clientY - from.y;
+        if (from.outside && Math.hypot(dx, dy) <= 10 || from.dragging && dy >= 72 && dy > Math.abs(dx) * 1.5) {
+            // Suppress the compatibility mouse sequence; the owner receives one close action.
+            if (event.cancelable)
+                event.preventDefault();
+            close(from.overlay);
+        }
+    };
+    doc.addEventListener('touchstart', down, { passive: true });
+    doc.addEventListener('touchmove', move, { passive: false });
+    doc.addEventListener('touchend', up, { passive: false });
+    doc.addEventListener('touchcancel', reset);
+    return () => {
+        reset();
+        doc.removeEventListener('touchstart', down);
+        doc.removeEventListener('touchmove', move);
+        doc.removeEventListener('touchend', up);
+        doc.removeEventListener('touchcancel', reset);
+    };
+}