@khorsheed/dsh-mobile 0.1.0

package/lib/types/client/locales.js

@@ -0,0 +1,80 @@
+/** Copy for controls owned by mobile; all conversation copy stays with its owner. */
+export const NS = 'mobile';
+export const en = {
+    connectPhone: "Connect phone",
+    connectIntro: "Continue your conversations in DSH Mobile.",
+    connectQR: "Scan with DSH Mobile to sign in",
+    connectGenerate: "Show login QR code",
+    connectHide: "Hide QR code",
+    connectConceal: "Hidden automatically after 2 minutes or when you leave this page.",
+    connectStepOpen: "Open DSH Mobile on your iPhone.",
+    connectStepScan: "Go to Connection Settings → Scan to connect.",
+    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.",
+    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.",
+    connectError: "Could not load the connection information. Check the connection and retry.",
+    connectLoading: "Loading connection information…",
+    directoryManual: 'Enter a path', directoryTitle: 'Choose working directory', directoryHint: 'Select a folder on your computer.', directoryComputer: 'Browse computer', directoryNoSaved: 'No saved workspaces yet. Browse your computer to choose one.', directoryGo: 'Go', directoryParent: 'Parent folder', directoryHidden: 'Hidden folders', directoryLoading: 'Loading folders…', directoryError: 'Could not read this folder. Check the path, permissions and connection.', directoryRetry: 'Retry', directorySearch: 'Filter folders', directoryEmpty: 'No subfolders.', directoryTruncated: 'This listing is limited. Enter a full path to open another folder.', directorySelect: 'Use this directory',
+    renameSession: 'Rename session', sessionTitle: 'Session title', renameUnavailable: 'Could not rename this conversation. Please try again.',
+    roomActionUnavailable: 'Open Members to manage this room; its shortcut is unavailable.', memberFailed: 'Task failed',
+    currentConversation: 'Current conversation',
+    loadingAgents: 'Checking available agents…', noAgents: 'No local agents are available on this host.', loginAgents: 'Sign in to an agent on the computer before inviting it.',
+    queued: 'Queued messages', queueError: 'Could not update the queue. Please try again.', editQueued: 'Edit', removeQueued: 'Remove', sendNow: 'Send now', sendingQueued: 'Waiting for host admission…',
+    members: 'Members', membersHint: 'Open a member conversation, or adjust its role.', inviteMember: 'Invite member', memberSettings: 'Member settings', duplicateMember: 'This member name is already in use.', invalidMember: 'Use a name without spaces or @.', roomError: 'Could not complete this request. Check the connection and try again.', mainMember: 'Main agent', openMemberChat: 'Open conversation', awaitingMember: 'Waiting for a first task', agentProvider: 'Agent', chooseProvider: 'Choose an available agent', needsLogin: 'Sign in on computer', memberName: 'Name', memberRole: 'Role instructions', memberRoleHint: 'What should this member focus on?', inviteHint: 'Invitation adds the member. Send an @message in the room to start a task.', roleChangeHint: 'Role changes apply to subsequent dispatches.', advanced: 'Advanced', inheritWorkspace: 'Inherit room workspace', saving: 'Saving…', save: 'Save', stopMemberConfirm: 'Stop this member’s current task?', removeMemberConfirm: 'Remove this member from the room? Its conversation history is retained.', confirm: 'Confirm', stopMember: 'Stop task', removeMember: 'Remove member', backMembers: 'Back to members', memberUnit: 'members',
+    inputTools: 'Add and configure', closeTools: 'Close input tools', attachments: 'Add attachment', commands: 'Commands', permissions: 'Permissions',
+    welcome: 'What would you like to do?', welcomeHint: 'Continue an idea, or start a new task.',
+    menu: 'Conversations', close: 'Close navigation', returnToConversation: 'Return to full conversation', title: 'Your workspace, with you',
+    settings: 'Mobile settings', back: 'Back', display: 'Display',
+    automatic: 'Follow screen size', mobile: 'Mobile', desktop: 'Desktop',
+    restoreMobile: 'Return to mobile layout',
+    appearance: 'Layout applies only to this browser.',
+    connection: 'Connection', reconnect: 'Reconnect', connected: 'Connected',
+    connecting: 'Connecting…', disconnected: 'Connection interrupted',
+    server: 'Host', privacy: 'Models, tools and files run on your host.',
+    done: 'Done', brand: 'DSH',
+    grouping: 'Conversation view', byTime: 'Time', byWorkspace: 'Workspace', today: 'Today', yesterday: 'Yesterday', earlier: 'Earlier', unassignedWorkspace: 'No workspace', scan: 'Scan to connect', conversation: 'Conversation', options: 'Conversation options', connectionSettings: 'Connection settings',
+    libraryEyebrow: 'YOUR WORKSPACE', libraryTitle: 'Pick up where you left off.', librarySubtitle: 'A thought, a conversation, a little progress.', newSession: 'New conversation', searchTitles: 'Search', searchResults: 'Results', recent: 'Recent conversations', workspaces: 'Workspaces', loadingSessions: 'Loading conversations…', noMatches: 'No matching conversations.', noSessions: 'Your conversations will appear here.', navigationError: 'Could not open this conversation. Please try again.', running: 'Working', completed: 'Completed', libraryFooter: 'A little closer, wherever you are.',
+    workspace: 'Open workspace', hostPath: 'Computer directory', hostPathHelp: 'Enter an existing absolute directory on your computer. This does not select a folder on your phone.', openWorkspace: 'Open', cancel: 'Cancel',
+};
+export const zh = {
+    connectPhone: "连接手机",
+    connectIntro: "在 DSH Mobile 中继续你的会话。",
+    connectQR: "使用 DSH Mobile 扫码登录",
+    connectGenerate: "显示登录二维码",
+    connectHide: "隐藏二维码",
+    connectConceal: "展示 2 分钟后或离开此页面时自动隐藏。",
+    connectStepOpen: "在 iPhone 上打开 DSH Mobile。",
+    connectStepScan: "进入「连接设置 → 扫码连接电脑」。",
+    connectStepConfirm: "扫描二维码，核对主机地址后确认连接。",
+    connectPrivacy: "二维码可授予这台主机的访问权限，请勿分享。隐藏二维码不会撤销官方登录链接；链接在宿主进程重启前仍然有效。",
+    connectNetwork: "请保持电脑和 HTTPS 入口在线。扫码用于重新连接 App，无法修复已经断开的隧道。",
+    connectSetup: "请由部署者通过 mobile.publicOrigin 或 DSH_MOBILE_PUBLIC_ORIGIN 配置手机可达的 HTTPS 地址，并将域名加入宿主信任列表。",
+    connectUntrusted: "宿主尚未信任配置的地址。请更新 --trusted-host 并重启宿主后再生成二维码。",
+    connectUnsupported: "此宿主版本不能提供官方登录链接，请更新到支持的宿主和插件组合。",
+    connectError: "暂时无法读取连接信息，请检查连接后重试。",
+    connectLoading: "正在读取连接信息…",
+    directoryManual: '输入路径', directoryTitle: '选择工作目录', directoryHint: '选择电脑上的文件夹。', directoryComputer: '浏览电脑', directoryNoSaved: '暂无工作区，可以浏览电脑选择文件夹。', directoryGo: '前往', directoryParent: '上一级', directoryHidden: '隐藏目录', directoryLoading: '正在读取目录…', directoryError: '暂时无法读取此目录，请检查路径、权限和连接。', directoryRetry: '重试', directorySearch: '筛选文件夹', directoryEmpty: '没有子目录。', directoryTruncated: '目录较多，仅显示部分内容；可输入完整路径前往。', directorySelect: '使用此目录',
+    renameSession: '重命名会话', sessionTitle: '会话标题', renameUnavailable: '暂时无法修改标题，请重试。',
+    roomActionUnavailable: '快捷入口暂不可用，请进入成员页管理。', memberFailed: '任务失败',
+    currentConversation: '当前会话',
+    loadingAgents: '正在检查可用代理…', noAgents: '这台电脑暂时没有可用的本地代理。', loginAgents: '请先在电脑上登录代理，再邀请加入。',
+    queued: '排队消息', queueError: '队列更新失败，请重试。', editQueued: '编辑', removeQueued: '移除', sendNow: '立即发送', sendingQueued: '等待主机确认…',
+    members: '成员', membersHint: '进入成员对话，或调整成员的分工。', inviteMember: '邀请成员', memberSettings: '成员设置', duplicateMember: '这个成员名称已被使用。', invalidMember: '成员名称不能包含空格或 @。', roomError: '操作未完成，请检查连接后重试。', mainMember: '主代理', openMemberChat: '进入对话', awaitingMember: '等待首个任务', agentProvider: '代理', chooseProvider: '选择可用代理', needsLogin: '需在电脑登录', memberName: '名称', memberRole: '角色指令', memberRoleHint: '这位成员主要负责什么？', inviteHint: '邀请仅添加成员。在群聊中发送 @消息后才开始任务。', roleChangeHint: '角色修改从后续任务开始生效。', advanced: '高级信息', inheritWorkspace: '跟随群聊工作区', saving: '正在保存…', save: '保存', stopMemberConfirm: '停止这位成员当前的任务？', removeMemberConfirm: '将这位成员移出群聊？已有对话记录会保留。', confirm: '确认', stopMember: '停止任务', removeMember: '移出成员', backMembers: '返回成员列表', memberUnit: '位成员',
+    inputTools: '添加与设置', closeTools: '关闭输入工具', attachments: '添加附件', commands: '指令', permissions: '会话权限',
+    welcome: '今天想做点什么？', welcomeHint: '继续一个想法，或开始新的任务。',
+    menu: '会话', close: '关闭会话导航', returnToConversation: '展开完整聊天', title: '工作空间，随身同行',
+    settings: '移动端设置', back: '返回', display: '界面',
+    automatic: '跟随屏幕尺寸', mobile: '移动布局', desktop: '桌面布局',
+    restoreMobile: '返回移动布局',
+    appearance: '布局设置仅对当前客户端生效。',
+    connection: '连接', reconnect: '重新连接', connected: '已连接',
+    connecting: '正在连接…', disconnected: '连接已中断',
+    server: '主机', privacy: '模型、工具与文件操作由电脑执行。',
+    done: '完成', brand: 'DSH',
+    grouping: '会话查看方式', byTime: '时间', byWorkspace: '工作区', today: '今天', yesterday: '昨天', earlier: '更早', unassignedWorkspace: '未指定工作区', scan: '扫码连接电脑', conversation: '会话', options: '会话选项', connectionSettings: '连接设置',
+    libraryEyebrow: '随身工作空间', libraryTitle: '继续你的想法。', librarySubtitle: '从一段对话，开始新的进展。', newSession: '新建会话', searchTitles: '搜索', searchResults: '搜索结果', recent: '最近会话', workspaces: '工作区', loadingSessions: '正在加载会话…', noMatches: '没有匹配的会话。', noSessions: '新的对话，会出现在这里。', navigationError: '暂时无法打开这段会话，请重试。', running: '进行中', completed: '已完成', libraryFooter: '让每一个想法，向前一步。',
+    workspace: '打开工作区', hostPath: '电脑目录', hostPathHelp: '输入电脑上已有目录的完整路径。这里选择的是电脑工作区，不是手机文件夹。', openWorkspace: '打开', cancel: '取消',
+};

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

@@ -0,0 +1,19 @@
+/** A touch presentation of the rendered message's own actions. The source
+ * button stays mounted; its plugin still owns edits, confirmations and errors. */
+export declare class MessageMenu {
+    private doc;
+    private timer;
+    private point;
+    private menu;
+    constructor(doc: Document);
+    private row;
+    private actions;
+    private down;
+    private move;
+    private cancel;
+    private context;
+    private close;
+    private open;
+    dispose(): void;
+}
+//# sourceMappingURL=messageMenu.d.ts.map

package/lib/types/client/messageMenu.js

@@ -0,0 +1,99 @@
+/** A touch presentation of the rendered message's own actions. The source
+ * button stays mounted; its plugin still owns edits, confirmations and errors. */
+export class MessageMenu {
+    doc;
+    timer;
+    point;
+    menu;
+    constructor(doc) {
+        this.doc = doc;
+        doc.addEventListener('pointerdown', this.down, true);
+        doc.addEventListener('pointermove', this.move, true);
+        doc.addEventListener('pointerup', this.cancel, true);
+        doc.addEventListener('pointercancel', this.cancel, true);
+        doc.addEventListener('scroll', this.cancel, true);
+        doc.addEventListener('contextmenu', this.context, true);
+    }
+    row(target) {
+        if (!this.doc.documentElement.hasAttribute('data-dsh-mobile') || !(target instanceof Element) || target.closest('button,a,input,textarea,[contenteditable],pre,code,[role=dialog]'))
+            return;
+        const user = target.closest('[data-conversation-scroll] [data-time-hover-root]');
+        if (user)
+            return user;
+        const assistant = target.closest('[data-chat-flow-kind="assistant-step"][data-chat-turn]'), turn = assistant?.getAttribute('data-chat-turn');
+        if (turn && /^\d+$/.test(turn))
+            return assistant?.closest('[data-conversation-scroll]')?.querySelector(`[data-turn-tail="${turn}"]`) ?? undefined;
+        return undefined;
+    }
+    actions(row) {
+        // An action bar's immediate buttons have accessible labels. Never harvest
+        // controls inside the text, tool calls, JSON viewers or nested messages.
+        return [...row.querySelectorAll(row.hasAttribute('data-turn-tail') ? 'button[aria-label]' : ':scope > div > button[aria-label], :scope > div > span > button[aria-label]')]
+            .filter(b => /^(复制|已复制|编辑|撤回|点赞|点踩|不喜欢|分支|好的回答|有问题的回答|在新对话中分支|Copy|Copied|Edit|Withdraw|Like|Dislike|Branch)/i.test(b.getAttribute('aria-label') ?? ''));
+    }
+    down = (e) => {
+        this.cancel();
+        const row = this.row(e.target);
+        if (!row || e.pointerType === 'mouse' || !this.actions(row).length)
+            return;
+        this.point = { x: e.clientX, y: e.clientY, row };
+        this.timer = setTimeout(() => { if (this.point)
+            this.open(row, e.clientX, e.clientY); }, 500);
+    };
+    move = (e) => { if (this.point && Math.hypot(e.clientX - this.point.x, e.clientY - this.point.y) > 10)
+        this.cancel(); };
+    cancel = () => { clearTimeout(this.timer); this.timer = undefined; this.point = undefined; };
+    context = (e) => {
+        const row = this.row(e.target);
+        if (row && this.actions(row).length) {
+            e.preventDefault();
+            this.open(row, e.clientX, e.clientY);
+        }
+    };
+    close = () => { this.menu?.close(); this.menu?.remove(); this.menu = undefined; };
+    open(row, x, y) {
+        this.cancel();
+        this.close();
+        const actions = this.actions(row);
+        if (!actions.length)
+            return;
+        const menu = this.doc.createElement('dialog');
+        this.menu = menu;
+        menu.dataset.mobileMessageMenu = '';
+        menu.setAttribute('aria-label', this.doc.documentElement.lang.startsWith('zh') ? '消息操作' : 'Message actions');
+        for (const target of actions) {
+            const button = this.doc.createElement('button');
+            button.type = 'button';
+            button.disabled = target.disabled;
+            const icon = target.querySelector('svg')?.cloneNode(true);
+            if (icon)
+                button.append(icon);
+            button.append(this.doc.createTextNode(target.getAttribute('aria-label')));
+            button.onclick = () => { this.close(); if (target.isConnected && !target.disabled && this.doc.documentElement.hasAttribute('data-dsh-mobile'))
+                target.click(); };
+            menu.append(button);
+        }
+        menu.addEventListener('cancel', this.close);
+        menu.addEventListener('click', e => { if (e.target === menu) {
+            const r = menu.getBoundingClientRect();
+            if (e.clientX < r.left || e.clientX > r.right || e.clientY < r.top || e.clientY > r.bottom)
+                this.close();
+        } });
+        this.doc.body.append(menu);
+        menu.showModal();
+        const bounds = menu.getBoundingClientRect(), viewport = this.doc.defaultView?.visualViewport;
+        const width = viewport?.width ?? this.doc.documentElement.clientWidth, height = viewport?.height ?? this.doc.documentElement.clientHeight;
+        menu.style.left = `${Math.max(12, Math.min(x - bounds.width / 2, width - bounds.width - 12))}px`;
+        menu.style.top = `${Math.max(12, Math.min(y + 12, height - bounds.height - 12))}px`;
+    }
+    dispose() {
+        this.cancel();
+        this.close();
+        this.doc.removeEventListener('pointerdown', this.down, true);
+        this.doc.removeEventListener('pointermove', this.move, true);
+        this.doc.removeEventListener('pointerup', this.cancel, true);
+        this.doc.removeEventListener('pointercancel', this.cancel, true);
+        this.doc.removeEventListener('scroll', this.cancel, true);
+        this.doc.removeEventListener('contextmenu', this.context, true);
+    }
+}

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

@@ -0,0 +1,6 @@
+export type NativeAction = 'settings' | 'scan';
+/** Additive bridge features: older shells and ordinary browsers retain Web controls. */
+export declare function hasNativeAction(action: NativeAction): boolean;
+export declare function requestNativeAction(action: NativeAction): void;
+export declare function reportChrome(visible: boolean): void;
+//# sourceMappingURL=native.d.ts.map

package/lib/types/client/native.js

@@ -0,0 +1,15 @@
+import { BRIDGE_VERSION } from '../protocol.js';
+/** Additive bridge features: older shells and ordinary browsers retain Web controls. */
+export function hasNativeAction(action) {
+    return window.__DSH_MOBILE_SHELL__?.bridgeVersion === BRIDGE_VERSION
+        && window.__DSH_MOBILE_SHELL__.capabilities?.includes(action) === true
+        && !!window.webkit?.messageHandlers?.dshMobile;
+}
+export function requestNativeAction(action) {
+    if (hasNativeAction(action))
+        window.webkit?.messageHandlers?.dshMobile?.postMessage({ type: action, bridgeVersion: BRIDGE_VERSION });
+}
+export function reportChrome(visible) {
+    if (hasNativeAction('settings'))
+        window.webkit?.messageHandlers?.dshMobile?.postMessage({ type: 'chrome', bridgeVersion: BRIDGE_VERSION, visible });
+}

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

@@ -0,0 +1,41 @@
+import type { ISessions, SessionListState, SessionSummary } from '@deepseek-ai/dsh-api-session-controller/client';
+import type { IWorkspaces } from '@deepseek-ai/dsh-api-workspace-controller/client';
+import type { UiWorkspace } from '@deepseek-ai/dsh-client-ui-workspace/client';
+type SessionId = SessionSummary['id'];
+/**
+ * The session the main view shows, read off both host lines: alpha.2 deleted
+ * the list's `current` for the per-row `retainedBy.mainView` reference count;
+ * 0.1.5 carries only `current`.
+ */
+export declare function mainSessionId(list: SessionListState): SessionId | undefined;
+export interface NavigationCapabilities {
+    sessions: ISessions;
+    workspaces: IWorkspaces;
+    workspace: UiWorkspace;
+}
+export type LibraryGrouping = 'time' | 'workspace';
+export declare const GROUPING_KEY = "dsh.mobile.grouping";
+export interface SessionGroup {
+    key: string;
+    label: string;
+    rows: SessionSummary[];
+}
+/** Group an ordered projection without joining different directories with the same basename. */
+export declare function groupSessions(rows: SessionSummary[], mode: LibraryGrouping, labels: {
+    today: string;
+    yesterday: string;
+    earlier: string;
+    workspace: string;
+}, now?: Date): SessionGroup[];
+/** Optional official services can disappear without removing basic mobile presentation. */
+export declare class MobileNavigation {
+    private value;
+    private listeners;
+    readonly getSnapshot: () => NavigationCapabilities | undefined;
+    readonly subscribe: (listener: () => void) => () => void;
+    set(value: NavigationCapabilities | undefined): void;
+}
+/** The Host owns metadata and membership; this projection only orders visible ordinary sessions. */
+export declare function recentSessions(state: SessionListState, archived: readonly string[], query: string): SessionSummary[];
+export {};
+//# sourceMappingURL=navigation.d.ts.map

package/lib/types/client/navigation.js

@@ -0,0 +1,61 @@
+/**
+ * The session the main view shows, read off both host lines: alpha.2 deleted
+ * the list's `current` for the per-row `retainedBy.mainView` reference count;
+ * 0.1.5 carries only `current`.
+ */
+export function mainSessionId(list) {
+    return Object.values(list.byId).find(summary => (summary.retainedBy?.mainView ?? 0) > 0)?.id
+        ?? list.current;
+}
+export const GROUPING_KEY = 'dsh.mobile.grouping';
+/** Group an ordered projection without joining different directories with the same basename. */
+export function groupSessions(rows, mode, labels, now = new Date()) {
+    const today = new Date(now.getFullYear(), now.getMonth(), now.getDate()).getTime();
+    const yesterday = new Date(now.getFullYear(), now.getMonth(), now.getDate() - 1).getTime();
+    const groups = new Map();
+    for (const row of rows) {
+        const key = mode === 'workspace' ? row.cwd || '' : row.updatedAt >= today ? 'today' : row.updatedAt >= yesterday ? 'yesterday' : 'earlier';
+        let group = groups.get(key);
+        if (!group) {
+            const label = mode === 'workspace' ? key.split(/[\\/]/).filter(Boolean).at(-1) || labels.workspace : labels[key];
+            group = { key, label, rows: [] };
+            groups.set(key, group);
+        }
+        group.rows.push(row);
+    }
+    if (mode === 'workspace') {
+        const counts = new Map();
+        for (const group of groups.values())
+            counts.set(group.label, (counts.get(group.label) ?? 0) + 1);
+        for (const group of groups.values())
+            if ((counts.get(group.label) ?? 0) > 1 && group.key)
+                group.label = group.key;
+    }
+    return [...groups.values()];
+}
+/** Optional official services can disappear without removing basic mobile presentation. */
+export class MobileNavigation {
+    value;
+    listeners = new Set();
+    getSnapshot = () => this.value;
+    subscribe = (listener) => { this.listeners.add(listener); return () => { this.listeners.delete(listener); }; };
+    set(value) {
+        this.value = value;
+        for (const listener of this.listeners)
+            listener();
+    }
+}
+/** The Host owns metadata and membership; this projection only orders visible ordinary sessions. */
+export function recentSessions(state, archived, query) {
+    const hidden = new Set(archived);
+    const term = query.trim().toLocaleLowerCase();
+    const current = mainSessionId(state);
+    return state.ids.flatMap(id => {
+        const row = state.byId[id];
+        if (!row || hidden.has(id) || row.origin === 'subagent' || (row.blank && id !== current))
+            return [];
+        if (term && !`${row.title ?? ''} ${row.displayTitle} ${row.cwd ?? ''}`.toLocaleLowerCase().includes(term))
+            return [];
+        return [row];
+    }).sort((a, b) => b.updatedAt - a.updatedAt || a.id.localeCompare(b.id));
+}

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

@@ -0,0 +1,17 @@
+/** Adapt only the next menu opened by a checked official hero trigger.
+ * Choices, disabled state, selection, refusal and dismissal remain with its owner. */
+export declare class MobilePickers {
+    private readonly doc;
+    private pending;
+    private menu;
+    private chrome;
+    private shade;
+    private hidden;
+    private separators;
+    constructor(doc: Document);
+    private readonly click;
+    sync(active: boolean): void;
+    private clear;
+    dispose(): void;
+}
+//# sourceMappingURL=pickers.d.ts.map

package/lib/types/client/pickers.js

@@ -0,0 +1,109 @@
+/** Adapt only the next menu opened by a checked official hero trigger.
+ * Choices, disabled state, selection, refusal and dismissal remain with its owner. */
+export class MobilePickers {
+    doc;
+    pending;
+    menu;
+    chrome;
+    shade;
+    hidden = [];
+    separators = [];
+    constructor(doc) {
+        this.doc = doc;
+        doc.addEventListener('click', this.click, true);
+    }
+    click = (event) => {
+        if (!this.doc.documentElement.hasAttribute('data-dsh-mobile'))
+            return;
+        const trigger = event.target.closest('button[aria-haspopup="menu"]');
+        if (!trigger || trigger.getAttribute('aria-expanded') === 'true')
+            return;
+        const preset = trigger.closest('[data-slot="conversation.hero.agentPreset"]');
+        const workspace = trigger.closest('[data-phase="hero"]') && trigger.querySelector('svg') && trigger.parentElement?.querySelector(':scope > [data-slot="conversation.hero.workspace"]');
+        if (!preset && !workspace)
+            return;
+        this.pending = { trigger, kind: preset ? 'preset' : 'workspace', before: new Set(this.doc.querySelectorAll('[role=menu]')), until: Date.now() + 1000 };
+    };
+    sync(active) {
+        if (!active) {
+            this.clear();
+            return;
+        }
+        if (this.menu && !this.menu.isConnected)
+            this.clear();
+        const pending = this.pending;
+        if (!pending)
+            return;
+        if (Date.now() > pending.until || !pending.trigger.isConnected) {
+            this.pending = undefined;
+            return;
+        }
+        const menu = Array.from(this.doc.querySelectorAll('[role=menu]')).find(el => !pending.before.has(el) && !el.parentElement?.closest('[role=menu]'));
+        if (!menu)
+            return;
+        this.pending = undefined;
+        this.menu = menu;
+        menu.dataset.mobilePicker = pending.kind;
+        if (pending.kind === 'preset')
+            for (const item of Array.from(menu.querySelectorAll('[role=menuitem]')).slice(1)) {
+                if (!item.hasAttribute('data-mobile-picker-divider')) {
+                    item.setAttribute('data-mobile-picker-divider', '');
+                    this.separators.push(item);
+                }
+            }
+        const zh = /^zh/i.test(this.doc.documentElement.lang || navigator.language);
+        const header = this.doc.createElement('div');
+        header.dataset.mobilePickerChrome = '';
+        const title = this.doc.createElement('strong');
+        title.textContent = pending.kind === 'workspace' ? (zh ? '选择工作区' : 'Choose workspace') : (zh ? '选择模式' : 'Choose mode');
+        const close = this.doc.createElement('button');
+        close.textContent = zh ? '完成' : 'Done';
+        close.onclick = () => pending.trigger.click();
+        header.append(title, close);
+        if (pending.kind === 'workspace') {
+            const input = this.doc.createElement('input');
+            input.type = 'search';
+            input.placeholder = zh ? '搜索工作区' : 'Search workspaces';
+            input.setAttribute('aria-label', input.placeholder);
+            input.oninput = () => {
+                for (const el of this.hidden)
+                    el.hidden = false;
+                this.hidden = [];
+                for (const item of menu.querySelectorAll('[role=menuitem]')) {
+                    // Keep the add-workspace action available when no existing directory matches.
+                    if (item.parentElement?.parentElement === menu.lastElementChild && menu.children.length > 2)
+                        continue;
+                    if (!item.textContent?.toLocaleLowerCase().includes(input.value.toLocaleLowerCase()) && !item.hidden) {
+                        item.hidden = true;
+                        this.hidden.push(item);
+                    }
+                }
+            };
+            header.append(input);
+        }
+        menu.prepend(header);
+        this.chrome = header;
+        const shade = this.doc.createElement('div');
+        shade.dataset.mobilePickerShade = '';
+        shade.setAttribute('aria-hidden', 'true');
+        // The official outside-pointer handler closes its menu, including focus restoration.
+        menu.before(shade);
+        this.shade = shade;
+    }
+    clear() {
+        this.menu?.removeAttribute('data-mobile-picker');
+        this.chrome?.remove();
+        this.shade?.remove();
+        for (const el of this.hidden)
+            el.hidden = false;
+        for (const el of this.separators)
+            el.removeAttribute('data-mobile-picker-divider');
+        this.separators = [];
+        this.hidden = [];
+        this.menu = undefined;
+        this.chrome = undefined;
+        this.shade = undefined;
+        this.pending = undefined;
+    }
+    dispose() { this.doc.removeEventListener('click', this.click, true); this.clear(); }
+}

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

@@ -0,0 +1,38 @@
+import { MobileSurface } from './surface.ts';
+export type DisplayMode = 'auto' | 'mobile' | 'desktop';
+export interface MobileSnapshot {
+    mode: DisplayMode;
+    active: boolean;
+    drawer: boolean;
+    supported: boolean;
+}
+/** Owns only this document's mobile effects. It never writes Host or sibling state. */
+export declare class MobilePresentation {
+    private readonly win;
+    private readonly shell;
+    private readonly listeners;
+    private readonly media;
+    private readonly observer;
+    private readonly style;
+    private frame;
+    private snapshot;
+    private disposed;
+    private pending;
+    private readonly composerFocus;
+    private readonly pickers;
+    private readonly viewport;
+    readonly surface: MobileSurface;
+    constructor(win: Window, shell: boolean);
+    readonly getSnapshot: () => MobileSnapshot;
+    readonly prepareNavigation: () => void;
+    readonly subscribe: (listener: () => void) => (() => void);
+    readonly setMode: (mode: DisplayMode) => void;
+    private readonly display;
+    private readonly pointer;
+    private readonly keyboard;
+    private readonly schedule;
+    private reconcile;
+    /** Release only owned presentation resources; leave shared streams and drafts intact. */
+    dispose(): void;
+}
+//# sourceMappingURL=presentation.d.ts.map

package/lib/types/client/presentation.js

@@ -0,0 +1,146 @@
+import { MobilePickers } from './pickers.js';
+import { MobileViewport } from './viewport.js';
+import { MOBILE_CSS } from './styles.js';
+import { MobileSurface } from './surface.js';
+import { ComposerFocus } from './composerFocus.js';
+const STORAGE_KEY = 'dsh.mobile.display';
+/** Owns only this document's mobile effects. It never writes Host or sibling state. */
+export class MobilePresentation {
+    win;
+    shell;
+    listeners = new Set();
+    media;
+    observer;
+    style;
+    frame;
+    snapshot;
+    disposed = false;
+    pending = 0;
+    composerFocus;
+    pickers;
+    viewport;
+    surface;
+    constructor(win, shell) {
+        this.win = win;
+        this.shell = shell;
+        const query = new URL(win.location.href).searchParams.get('mobile');
+        let saved = null;
+        try {
+            saved = win.localStorage.getItem(STORAGE_KEY);
+        }
+        catch { /* Storage may be disabled; preferences remain document-local. */ }
+        const mode = query === '1' ? 'mobile' : query === '0' ? 'desktop'
+            : saved === 'mobile' || saved === 'desktop' ? saved : 'auto';
+        this.snapshot = { mode, active: false, drawer: false, supported: false };
+        this.surface = new MobileSurface(win.document);
+        this.viewport = new MobileViewport(win);
+        this.pickers = new MobilePickers(win.document);
+        this.composerFocus = new ComposerFocus(win.document, () => this.snapshot.active);
+        this.media = win.matchMedia('(max-width: 760px) and (pointer: coarse)');
+        this.style = win.document.createElement('style');
+        this.style.dataset.mobileOwned = 'styles';
+        this.style.textContent = MOBILE_CSS;
+        win.document.head.append(this.style);
+        this.observer = new MutationObserver(this.schedule);
+        this.observer.observe(win.document.body, { subtree: true, childList: true, attributes: true, attributeFilter: ['data-sidebar-collapsed', 'data-phase', 'aria-selected', 'aria-expanded', 'data-ds-dark-theme', 'src'], characterData: true });
+        this.media.addEventListener('change', this.schedule);
+        win.addEventListener('resize', this.schedule);
+        win.addEventListener('dsh-mobile-display', this.display);
+        win.document.addEventListener('pointerdown', this.pointer, true);
+        win.document.addEventListener('keydown', this.keyboard, true);
+        win.visualViewport?.addEventListener('resize', this.schedule);
+        win.visualViewport?.addEventListener('scroll', this.schedule);
+        this.reconcile();
+    }
+    getSnapshot = () => this.snapshot;
+    prepareNavigation = () => { this.composerFocus.arm(); };
+    subscribe = (listener) => {
+        this.listeners.add(listener);
+        return () => { this.listeners.delete(listener); };
+    };
+    setMode = (mode) => {
+        this.snapshot = { ...this.snapshot, mode };
+        try {
+            this.win.localStorage.setItem(STORAGE_KEY, mode);
+        }
+        catch { /* Private storage denial does not block the UI. */ }
+        this.reconcile(true);
+    };
+    display = (event) => {
+        const mode = event.detail?.mode;
+        if (mode === 'auto' || mode === 'mobile' || mode === 'desktop')
+            this.setMode(mode);
+    };
+    pointer = () => { if (this.snapshot.active)
+        this.win.document.documentElement.dataset.mobileInput = 'pointer'; };
+    keyboard = (event) => { if (this.snapshot.active && event.key === 'Tab')
+        this.win.document.documentElement.dataset.mobileInput = 'keyboard'; };
+    schedule = () => {
+        if (this.disposed || this.pending)
+            return;
+        this.pending = this.win.requestAnimationFrame(() => { this.pending = 0; this.reconcile(); });
+    };
+    reconcile(force = false) {
+        if (this.disposed)
+            return;
+        const doc = this.win.document;
+        // Root priority alone cannot transfer child-slot render authority. Keep
+        // the official frame and require its observed rc1 anchor arrangement.
+        const candidate = doc.querySelector('[data-slot="root"] > div:has(> [data-shell-overlay])');
+        const frame = candidate?.querySelector('[data-slot="main"]') && candidate.querySelector('[data-slot="sidebar"]') ? candidate : undefined;
+        if (this.frame !== frame)
+            this.frame?.removeAttribute('data-mobile-frame');
+        this.frame = frame;
+        const active = !!frame && (this.snapshot.mode === 'mobile' || (this.snapshot.mode === 'auto' && (this.shell || this.media.matches)));
+        doc.documentElement.toggleAttribute('data-dsh-mobile', active);
+        frame?.toggleAttribute('data-mobile-frame', active);
+        if (active)
+            doc.documentElement.style.setProperty('--mobile-height', `${Math.round(this.win.visualViewport?.height ?? this.win.innerHeight)}px`);
+        else
+            doc.documentElement.style.removeProperty('--mobile-height');
+        if (active)
+            doc.documentElement.style.setProperty('--mobile-top', `${Math.round(this.win.visualViewport?.offsetTop ?? 0)}px`);
+        else
+            doc.documentElement.style.removeProperty('--mobile-top');
+        doc.documentElement.toggleAttribute('data-mobile-native-insets', active && this.shell);
+        if (active && !doc.documentElement.dataset.mobileInput)
+            doc.documentElement.dataset.mobileInput = 'pointer';
+        if (!active)
+            doc.documentElement.removeAttribute('data-mobile-input');
+        this.surface.sync(active ? frame : undefined);
+        this.viewport.sync(active ? frame : undefined);
+        this.pickers.sync(active);
+        const drawer = active && !frame?.hasAttribute('data-sidebar-collapsed');
+        if (force || active !== this.snapshot.active || drawer !== this.snapshot.drawer || !!frame !== this.snapshot.supported) {
+            this.snapshot = { ...this.snapshot, active, drawer, supported: !!frame };
+            for (const listener of this.listeners)
+                listener();
+        }
+    }
+    /** Release only owned presentation resources; leave shared streams and drafts intact. */
+    dispose() {
+        this.disposed = true;
+        this.observer.disconnect();
+        this.composerFocus.dispose();
+        this.surface.dispose();
+        this.viewport.dispose();
+        this.pickers.dispose();
+        this.win.removeEventListener('dsh-mobile-display', this.display);
+        this.win.document.removeEventListener('pointerdown', this.pointer, true);
+        this.win.document.removeEventListener('keydown', this.keyboard, true);
+        this.win.document.documentElement.removeAttribute('data-mobile-input');
+        this.win.document.documentElement.removeAttribute('data-mobile-native-insets');
+        this.media.removeEventListener('change', this.schedule);
+        this.win.removeEventListener('resize', this.schedule);
+        this.win.visualViewport?.removeEventListener('resize', this.schedule);
+        this.win.visualViewport?.removeEventListener('scroll', this.schedule);
+        if (this.pending)
+            this.win.cancelAnimationFrame(this.pending);
+        this.frame?.removeAttribute('data-mobile-frame');
+        this.win.document.documentElement.removeAttribute('data-dsh-mobile');
+        this.win.document.documentElement.style.removeProperty('--mobile-height');
+        this.win.document.documentElement.style.removeProperty('--mobile-top');
+        this.style.remove();
+        this.listeners.clear();
+    }
+}