Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。
TypeScript agentai-agentai-assistantandroidclaude-codecodexelectroniosllmmacosreact-nativetypescriptwindows
feat(remote-desktop): 桌面远控对齐手机端改进,被控端随连接给操作权,手机仅查看改为本地 (#5492)
Dash4a998e709d0f
diff --git a/apps/desktop/src/main/remote-desktop-viewer/__tests__/connection.test.ts b/apps/desktop/src/main/remote-desktop-viewer/__tests__/connection.test.tsindex d07db20922..a2735a9335 100644--- a/apps/desktop/src/main/remote-desktop-viewer/__tests__/connection.test.ts+++ b/apps/desktop/src/main/remote-desktop-viewer/__tests__/connection.test.ts@@ -416,3 +416,242 @@ it.each([false, true])(else expect(write).toHaveBeenCalledWith(content, undefined, expect.any(Function));},);++describe('remembered viewer resolution', () => {+ function memoryFixture() {+ const stored = new Map<string, unknown>();+ const saveResolution = vi.fn(async (device: string, display: string, value: unknown) => {+ stored.set(`${device}/${display}`, value);+ });+ const connection = new RemoteViewerConnection({+ owner: () => 'owner',+ request: async (_target, message, check) => {+ check();+ return message.op === 'capabilities'+ ? { displays: [{ id: 'screen', width: 1280, height: 720 }] }+ : {};+ },+ readClipboard: () => '',+ writeClipboard: () => {},+ resolution: (device, display) =>+ (stored.get(`${device}/${display}`) as ReturnType<+ NonNullable<ConstructorParameters<typeof RemoteViewerConnection>[0]['resolution']>+ >) ?? null,+ saveResolution,+ });+ connection.bind({ deviceId: 'computer-a', name: 'Computer' });+ connection.setActive(true);+ return { connection, saveResolution, stored };+ }++ it('binds the device in Main and only accepts monitors the target reported', async () => {+ const { connection, saveResolution } = memoryFixture();+ const generation = connection.generation;+ // Before capabilities nothing is known about the target's monitors.+ await expect(connection.resolution(generation, 'screen')).rejects.toThrow('INVALID_REQUEST');+ await connection.request(generation, { op: 'capabilities' });+ const fit = { kind: 'fit', width: 1920, height: 960 };+ await expect(connection.resolution(generation, 'screen', fit)).resolves.toEqual(fit);+ expect(saveResolution).toHaveBeenCalledWith('computer-a', 'screen', fit);+ await expect(connection.resolution(generation, 'screen')).resolves.toEqual(fit);+ await expect(connection.resolution(generation, 'other', fit)).rejects.toThrow('INVALID_REQUEST');+ await connection.resolution(generation, 'screen', null);+ await expect(connection.resolution(generation, 'screen')).resolves.toBeNull();+ });++ it.each([+ { kind: 'fit', width: 4000, height: 2000 },+ { kind: 'mode', modeId: '', width: 1920, height: 1080 },+ { kind: 'mode', modeId: 'hd', width: 1.5, height: 1080 },+ { kind: 'other', width: 1920, height: 1080 },+ 'fit',+ ])('rejects a malformed remembered value %#', async (value) => {+ const { connection, saveResolution } = memoryFixture();+ await connection.request(connection.generation, { op: 'capabilities' });+ await expect(connection.resolution(connection.generation, 'screen', value)).rejects.toThrow(+ 'INVALID_REQUEST',+ );+ expect(saveResolution).not.toHaveBeenCalled();+ });++ it('rejects a retired generation', async () => {+ const { connection } = memoryFixture();+ const generation = connection.generation;+ await connection.request(generation, { op: 'capabilities' });+ connection.setActive(false);+ await expect(connection.resolution(generation, 'screen')).rejects.toThrow();+ });+});++describe('requests carried by the viewer window’s media data channel', () => {+ function channelFixture(channelRequests = true) {+ const relay = vi.fn(async (_target: string, message: RemoteDesktopRequest, check: () => void) => {+ check();+ if (message.op === 'capabilities') return { channelRequests, clipboardText: true };+ if (message.op === 'start') return { lease: 'lease', controlling: false };+ if (message.op === 'control') return { controlling: message.enabled };+ return { ok: true };+ });+ const carried: { generation: number; id: string; request: RemoteDesktopRequest }[] = [];+ let accept = true;+ const connection = new RemoteViewerConnection({+ owner: () => 'owner',+ request: relay,+ readClipboard: () => 'local text',+ writeClipboard: () => {},+ channel: (generation, id, request) => {+ if (accept) carried.push({ generation, id, request });+ return accept;+ },+ });+ connection.bind({ deviceId: 'target', name: 'Target' });+ connection.setActive(true);+ const generation = connection.generation;+ const start = async () => {+ await connection.request(generation, { op: 'capabilities' });+ await connection.request(generation, { op: 'start', displayId: 'screen' });+ };+ const reply = (index: number, outcome: unknown) =>+ connection.channelReply(generation, carried[index].id, outcome);+ return {+ connection,+ relay,+ carried,+ generation,+ start,+ reply,+ refuse: () => {+ accept = false;+ },+ };+ }+ const relayed = (relay: ReturnType<typeof vi.fn>, op: string) =>+ relay.mock.calls.filter(([, message]) => (message as RemoteDesktopRequest).op === op).length;++ it('keeps Main’s control state and clipboard gate when control rides the channel', async () => {+ const f = channelFixture();+ await f.start();+ expect(f.carried).toEqual([]); // No lease yet: capabilities and start use the relay.+ const control = f.connection.request(f.generation, {+ op: 'control',+ lease: 'lease',+ enabled: true,+ });+ await vi.waitFor(() => expect(f.carried).toHaveLength(1));+ expect(f.carried[0].request).toEqual({ op: 'control', lease: 'lease', enabled: true });+ f.reply(0, { kind: 'result', value: { controlling: true } });+ await expect(control).resolves.toEqual({ ok: true, result: { controlling: true } });+ expect(relayed(f.relay, 'control')).toBe(0);+ // Main recorded the control result, so the native clipboard is usable.+ await expect(f.connection.clipboard(f.generation, 'paste')).resolves.toEqual({+ ok: true,+ result: null,+ });+ });++ it('uses the relay only for requests the window did not send', async () => {+ const f = channelFixture();+ await f.start();+ const unsent = f.connection.request(f.generation, { op: 'displayModes', lease: 'lease' });+ await vi.waitFor(() => expect(f.carried).toHaveLength(1));+ f.reply(0, { kind: 'relay' });+ await expect(unsent).resolves.toMatchObject({ ok: true });+ expect(relayed(f.relay, 'displayModes')).toBe(1);+ const failed = f.connection.request(f.generation, {+ op: 'control',+ lease: 'lease',+ enabled: true,+ });+ await vi.waitFor(() => expect(f.carried).toHaveLength(2));+ f.reply(1, { kind: 'error', code: 'DESKTOP_INPUT_BUSY' });+ await expect(failed).resolves.toEqual({ ok: false, code: 'DESKTOP_INPUT_BUSY' });+ expect(relayed(f.relay, 'control')).toBe(0);+ f.refuse();+ await f.connection.request(f.generation, { op: 'displayModes', lease: 'lease' });+ expect(relayed(f.relay, 'displayModes')).toBe(2);+ });++ it('never routes requests outside the channel list or to a host without support', async () => {+ const f = channelFixture();+ await f.start();+ await f.connection.request(f.generation, { op: 'heartbeat', lease: 'lease' });+ await f.connection.request(f.generation, {+ op: 'windowAction',+ lease: 'lease',+ action: 'list',+ });+ expect(f.carried).toEqual([]);+ const old = channelFixture(false);+ await old.start();+ await old.connection.request(old.generation, { op: 'displayModes', lease: 'lease' });+ expect(old.carried).toEqual([]);+ });++ it('settles carried requests as unknown when the viewer retires, and ignores late replies', async () => {+ const f = channelFixture();+ await f.start();+ const pending = f.connection.request(f.generation, { op: 'displayModes', lease: 'lease' });+ await vi.waitFor(() => expect(f.carried).toHaveLength(1));+ f.connection.setActive(false);+ await expect(pending).resolves.toMatchObject({ ok: false });+ expect(relayed(f.relay, 'displayModes')).toBe(0);+ expect(() => f.reply(0, { kind: 'result', value: [] })).toThrow();+ });++ it('rejects malformed replies from the window', async () => {+ const f = channelFixture();+ await f.start();+ void f.connection.request(f.generation, { op: 'displayModes', lease: 'lease' });+ await vi.waitFor(() => expect(f.carried).toHaveLength(1));+ expect(() => f.reply(0, { kind: 'error', code: 'lowercase' })).toThrow('INVALID_REQUEST');+ expect(() => f.reply(0, { kind: 'other' })).toThrow('INVALID_REQUEST');+ expect(() => f.connection.channelReply(f.generation, 7, { kind: 'relay' })).toThrow(+ 'INVALID_REQUEST',+ );+ f.reply(0, { kind: 'relay' });+ });+});++describe('control granted with the lease (autoControl)', () => {+ it('records a grant from start or a display change like a control reply', async () => {+ const relay = vi.fn(async (_target: string, message: RemoteDesktopRequest, check: () => void) => {+ check();+ if (message.op === 'capabilities') return { autoControl: true, clipboardText: true };+ if (message.op === 'start')+ return { lease: 'lease', controlling: message.control === true, display: { id: 's' } };+ if (message.op === 'viewerDisplay')+ return { lease: 'lease', controlling: message.control === true, display: { id: 'v' } };+ return { ok: true };+ });+ const connection = new RemoteViewerConnection({+ owner: () => 'owner',+ request: relay,+ readClipboard: () => 'local text',+ writeClipboard: () => {},+ });+ connection.bind({ deviceId: 'target', name: 'Target' });+ connection.setActive(true);+ const generation = connection.generation;+ await connection.request(generation, { op: 'capabilities' });+ await connection.request(generation, { op: 'start', displayId: 's', control: true });+ await expect(connection.clipboard(generation, 'paste')).resolves.toEqual({+ ok: true,+ result: null,+ });+ await connection.request(generation, {+ op: 'viewerDisplay',+ lease: 'lease',+ width: 1280,+ height: 640,+ control: true,+ });+ await expect(connection.clipboard(generation, 'paste')).resolves.toMatchObject({ ok: true });+ // A start without the flag stays view only until control is confirmed.+ await connection.request(generation, { op: 'stop', lease: 'lease' });+ await connection.request(generation, { op: 'start', displayId: 's' });+ await expect(connection.clipboard(generation, 'paste')).resolves.toEqual({+ ok: false,+ code: 'DESKTOP_VIEW_ONLY',+ });+ });+});diff --git a/apps/desktop/src/main/remote-desktop-viewer/connection.ts b/apps/desktop/src/main/remote-desktop-viewer/connection.tsindex 0ea6146667..0520fe4c2a 100644--- a/apps/desktop/src/main/remote-desktop-viewer/connection.ts+++ b/apps/desktop/src/main/remote-desktop-viewer/connection.ts@@ -1,5 +1,7 @@import {+ isRemoteDesktopChannelRequest,parseRemoteDesktopRequest,+ REMOTE_DESKTOP_CHANNEL_TIMEOUT_MS,remoteDesktopVideoSettingsWire,isDesktopAttemptId,REMOTE_DESKTOP_MAX_CLIPBOARD_CHARS,@@ -15,6 +17,10 @@ import type {} from '../../shared/remoteDesktopViewer.js';import {DEFAULT_VIEWER_PREFERENCES,+ parseRememberedViewerResolution,+ parseRemoteViewerChannelOutcome,+ type RemoteViewerChannelOutcome,+ type RememberedViewerResolution,type RemoteViewerPreferences,type RemoteViewerSafety,} from '../../shared/remoteDesktopViewer.js';@@ -45,6 +51,8 @@ export class RemoteViewerConnection {private safetyState = new ViewerSafety();private clipboardProgress: number | null = null;private closing = false;+ private channelRequests = new Map<string, (outcome: RemoteViewerChannelOutcome) => void>();+ private channelRequestId = 0;constructor(private readonly deps: {owner(): string;@@ -59,6 +67,14 @@ export class RemoteViewerConnection {device: string,patch: Partial<RemoteViewerPreferences>,): Promise<RemoteViewerPreferences>;+ /** Hands a request to the viewer window's media data channel; false when it cannot. */+ channel?(generation: number, id: string, request: RemoteDesktopRequest): boolean;+ resolution?(device: string, display: string): RememberedViewerResolution | null;+ saveResolution?(+ device: string,+ display: string,+ value: RememberedViewerResolution | null,+ ): Promise<void>;},) {}bind(target: RemoteViewerTarget): void {@@ -148,6 +164,9 @@ export class RemoteViewerConnection {this.controlGeneration++;this.clipboardPending = null;this.starting = false;+ // Their media peer belongs to the retired viewer; the outcome is unknown.+ for (const settle of [...this.channelRequests.values()])+ settle({ kind: 'error', code: 'INVOKE_TIMEOUT' });if (lease && target && owner === this.deps.owner())void this.serializeLifecycle(() =>this.deps.request(target.deviceId, { op: 'stop', lease }, () => {@@ -185,16 +204,20 @@ export class RemoteViewerConnection {owner = this.owner;const isStart = request.op === 'start';const isControl = request.op === 'control';- if (isControl || request.op === 'stop' || isStart) {+ // Start and display changes may grant control within the same request+ // (`autoControl`); their reply is a control confirmation like `control`.+ const grantsControl = 'control' in request && request.control === true;+ const confirmsControl = isControl || grantsControl;+ if (confirmsControl || request.op === 'stop' || isStart) {this.safetyState.invalidate();this.controlGeneration++;- this.wantsControl = isControl && request.enabled;+ this.wantsControl = isControl ? request.enabled : grantsControl;this.controlling = false;- if (!isControl) this.controlPending = false;+ if (!confirmsControl) this.controlPending = false;}const controlGeneration = this.controlGeneration;const controlPendingAtStart = this.controlPending;- if (isControl) this.controlPending = true;+ if (confirmsControl) this.controlPending = true;if (isStart) {this.starting = true;}@@ -211,7 +234,7 @@ export class RemoteViewerConnection {request.op === 'offer' && request.settings? { ...request, settings: remoteDesktopVideoSettingsWire(request.settings) }: request;- const result = await this.deps.request(target.deviceId, outgoing, check);+ const result = await this.send(outgoing, check);if (request.op === 'capabilities') {check();this.caps = result as RemoteDesktopCapabilities;@@ -233,7 +256,7 @@ export class RemoteViewerConnection {this.check(generation);if (controlGeneration === this.controlGeneration &&- (isControl ||+ (confirmsControl ||(request.op === 'heartbeat' && !controlPendingAtStart && !this.controlPending))) {const wasControlling = this.controlling;@@ -254,7 +277,8 @@ export class RemoteViewerConnection {return { ok: true, result };} finally {this.pending--;- if (isControl && controlGeneration === this.controlGeneration) this.controlPending = false;+ if (confirmsControl && controlGeneration === this.controlGeneration)+ this.controlPending = false;if (generation === this.generation && isStart) this.starting = false;}} catch (error) {@@ -360,6 +384,70 @@ export class RemoteViewerConnection {}return { ...this.preferencesValue };}+ /**+ * Main still decides and checks every request; small ones only ride the+ * viewer window's live media data channel instead of the relay. Anything the+ * window did not send uses the relay, and a sent request is never replayed.+ */+ private async send(request: RemoteDesktopRequest, check: () => void): Promise<unknown> {+ const deviceId = this.target!.deviceId;+ if (+ !this.deps.channel ||+ this.caps?.channelRequests !== true ||+ !('lease' in request) ||+ request.lease !== this.lease ||+ !isRemoteDesktopChannelRequest(request)+ )+ return this.deps.request(deviceId, request, check);+ check();+ const generation = this.generation;+ const id = `${generation}-${++this.channelRequestId}`;+ const outcome = await new Promise<RemoteViewerChannelOutcome>((resolve) => {+ const timer = setTimeout(+ () => settle({ kind: 'error', code: 'INVOKE_TIMEOUT' }),+ REMOTE_DESKTOP_CHANNEL_TIMEOUT_MS,+ );+ const settle = (value: RemoteViewerChannelOutcome) => {+ if (this.channelRequests.get(id) !== settle) return;+ this.channelRequests.delete(id);+ clearTimeout(timer);+ resolve(value);+ };+ this.channelRequests.set(id, settle);+ if (!this.deps.channel!(generation, id, request)) settle({ kind: 'relay' });+ });+ if (outcome.kind === 'result') return outcome.value;+ if (outcome.kind === 'error') throw new Error(outcome.code);+ return this.deps.request(deviceId, request, check);+ }+ /** The viewer window's answer for a request handed to its data channel. */+ channelReply(generation: number, id: unknown, outcome: unknown): void {+ this.check(generation);+ const parsed = parseRemoteViewerChannelOutcome(outcome);+ if (typeof id !== 'string' || !parsed) throw new Error('INVALID_REQUEST');+ this.channelRequests.get(id)?.(parsed);+ }+ /** Remembered display choice for one monitor of the bound target. */+ async resolution(+ generation: number,+ displayId: unknown,+ value?: unknown,+ ): Promise<RememberedViewerResolution | null> {+ this.check(generation);+ // Only monitors this target reported; the payload never chooses the device.+ if (+ typeof displayId !== 'string' ||+ !this.caps?.displays.some((display) => display.id === displayId)+ )+ throw new Error('INVALID_REQUEST');+ if (value === undefined) return this.deps.resolution?.(this.target!.deviceId, displayId) ?? null;+ const parsed = value === null ? null : parseRememberedViewerResolution(value);+ if (value !== null && !parsed) throw new Error('INVALID_REQUEST');+ if (!this.deps.saveResolution) throw new Error('DESKTOP_UNAVAILABLE');+ await this.deps.saveResolution(this.target!.deviceId, displayId, parsed);+ this.check(generation);+ return parsed;+ }async focusChanged(): Promise<void> {const generation = this.generation;// Cancel local reads immediately, then reconcile after any old enable has@@ -396,7 +484,7 @@ export class RemoteViewerConnection {clipboard: this.deps.clipboard,request: async (message, check) => {check();- const result = await this.deps.request(this.target!.deviceId, message, check);+ const result = await this.send(message, check);check();return result as never;},diff --git a/apps/desktop/src/main/remote-desktop-viewer/resolutionMemory.ts b/apps/desktop/src/main/remote-desktop-viewer/resolutionMemory.tsnew file mode 100644index 0000000000..a564f3f65b--- /dev/null+++ b/apps/desktop/src/main/remote-desktop-viewer/resolutionMemory.ts@@ -0,0 +1,55 @@+import { createHash } from 'node:crypto';+import { activeOwnerScopeKey, ownerScopedUserDataPath } from '../appSessionState';+import { createOverrideSettingsFile } from '../maker-host/override-settings-file';+import { createLogger } from '../logger';+import {+ parseRememberedViewerResolution,+ type RememberedViewerResolution,+} from '../../shared/remoteDesktopViewer';++// Non-secret, account-scoped: the last display choice this computer made for+// one monitor of one remote computer. The host still restores its own display+// when the viewer leaves.+type Memory = Record<string, RememberedViewerResolution>;+const store = createOverrideSettingsFile<Memory>({+ filePath: () => ownerScopedUserDataPath('remote-desktop-viewer-resolutions.json'),+ scopeKey: activeOwnerScopeKey,+ defaults: {},+ normalize: (raw) => {+ const result: Memory = {};+ if (!raw || typeof raw !== 'object') return result;+ for (const [key, value] of Object.entries(raw)) {+ const remembered = /^[a-f0-9]{64}$/.test(key) ? parseRememberedViewerResolution(value) : null;+ if (remembered) result[key] = remembered;+ }+ return result;+ },+ maxBytes: 256 * 1024,+ preserveUnreadableFile: true,+ logLoadedValue: false,+ logReadErrorDetails: false,+ log: createLogger('remote-viewer-resolutions'),+ label: 'remote viewer resolution',+});+const keyFor = (device: string, display: string) =>+ createHash('sha256').update(device).update('\0').update(display).digest('hex');++export function readViewerResolution(+ device: string,+ display: string,+): RememberedViewerResolution | null {+ store.invalidateIfChanged();+ return store.read()[keyFor(device, display)] ?? null;+}++/** `null` forgets the choice, so the computer keeps its own display next time. */+export async function writeViewerResolution(+ device: string,+ display: string,+ value: RememberedViewerResolution | null,+): Promise<void> {+ await store.updateAtomic(() => ({+ // A normalized-away null equals the default and drops the entry.+ [keyFor(device, display)]: value as RememberedViewerResolution,+ }));+}diff --git a/apps/desktop/src/main/remote-desktop-viewer/windows.ts b/apps/desktop/src/main/remote-desktop-viewer/windows.tsindex 883576c05b..10b817c141 100644--- a/apps/desktop/src/main/remote-desktop-viewer/windows.ts+++ b/apps/desktop/src/main/remote-desktop-viewer/windows.ts@@ -27,6 +27,7 @@ import { extractIpcError } from '../../shared/ipcError.js';import { RemoteViewerConnection } from './connection.js';import { ViewerCredentials } from './credentials.js';import { readViewerPreferences, writeViewerPreferences } from './preferences.js';+import { readViewerResolution, writeViewerResolution } from './resolutionMemory.js';import { resolveDesktopInputBinary } from '../remote-desktop/inputHost.js';import { ClipboardCounter } from '../remote-desktop/clipboardCounter.js';import { transferDesktopClipboardContent } from '../remote-desktop/clipboard.js';@@ -140,6 +141,14 @@ export class RemoteDesktopViewerWindows {writeClipboard: (value) => clipboard.writeText(value),preferences: readViewerPreferences,savePreferences: writeViewerPreferences,+ resolution: readViewerResolution,+ saveResolution: writeViewerResolution,+ channel: (generation, id, request) => {+ const win = entry.window;+ if (!win || win.isDestroyed()) return false;+ win.webContents.send(REMOTE_VIEWER.CHANNEL_REQUEST, { generation, id, request });+ return true;+ },focused: () => entry.window?.isFocused() === true,clipboard: {version: (current) => {@@ -281,6 +290,23 @@ export class RemoteDesktopViewerWindows {throwIpcError('PRECONDITION_FAILED', 'DESKTOP_SETTINGS_FAILED');}});+ ipcMain.handle(REMOTE_VIEWER.RESOLUTION, async (event, generation, displayId, value) => {+ const entry = this.entry(event);+ try {+ // An omitted value reads; an explicit null forgets.+ return await entry.connection.resolution(generation, displayId, value);+ } catch {+ throwIpcError('PRECONDITION_FAILED', 'DESKTOP_SETTINGS_FAILED');+ }+ });+ ipcMain.handle(REMOTE_VIEWER.CHANNEL_REPLY, (event, generation, id, outcome) => {+ const entry = this.entry(event);+ try {+ entry.connection.channelReply(generation, id, outcome);+ } catch {+ throwIpcError('PRECONDITION_FAILED', 'DESKTOP_STOPPED');+ }+ });ipcMain.handle(REMOTE_VIEWER.SAFETY, async (event, generation, retry) => {if (retry !== undefined && typeof retry !== 'boolean')throwIpcError('INVALID_PARAMS', 'Invalid retry');diff --git a/apps/desktop/src/main/remote-desktop/__tests__/controller.test.ts b/apps/desktop/src/main/remote-desktop/__tests__/controller.test.tsindex 1922f5ef78..29d891bebb 100644--- a/apps/desktop/src/main/remote-desktop/__tests__/controller.test.ts+++ b/apps/desktop/src/main/remote-desktop/__tests__/controller.test.ts@@ -1477,3 +1477,117 @@ it('keeps background viewing when a control request is refused as busy', async (started();await starting.catch(() => {});});++describe('automatic control (autoControl)', () => {+ function viewerDisplay(h: ReturnType<typeof harness>) {+ h.deps.createViewerDisplay = vi.fn(async () => ({+ displayId: 'viewer',+ resize: async (width: number, height: number) => ({+ id: 'viewer',+ name: 'Viewer',+ width,+ height,+ }),+ restore: async () => ({ id: '1', name: 'Main', width: 1920, height: 1080 }),+ dispose: vi.fn(),+ }));+ }+ it('advertises it only when this computer can take input', async () => {+ const h = harness();+ expect(await h.controller.request('phone', { op: 'capabilities' })).toMatchObject({+ autoControl: true,+ });+ const caps = h.deps.capabilities;+ h.deps.capabilities = async () => ({ ...(await caps()), canControl: false });+ expect(await h.controller.request('phone', { op: 'capabilities' })).toMatchObject({+ autoControl: false,+ });+ });+ it('grants control with the lease without a separate control request', async () => {+ const h = harness();+ const lease = (await h.controller.request('phone', {+ op: 'start',+ displayId: '1',+ control: true,+ })) as RemoteDesktopLease;+ expect(lease.controlling).toBe(true);+ expect(h.deps.startInput).toHaveBeenCalledExactlyOnceWith('1');+ expect(h.controller.state).toEqual({ peer: 'phone', controlling: true });+ h.controller.input(lease.lease, 1, [{ kind: 'move', x: 0.5, y: 0.5 }]);+ expect(h.deps.input).toHaveBeenCalledOnce();+ });+ it('still starts view only without the flag', async () => {+ const h = harness();+ expect((await h.start()).controlling).toBe(false);+ expect(h.deps.startInput).not.toHaveBeenCalled();+ });+ it('keeps the lease view only when input cannot start, so the viewer can ask and see why', async () => {+ const h = harness();+ vi.mocked(h.deps.startInput).mockRejectedValueOnce(new Error('DESKTOP_INPUT_UNSUPPORTED'));+ const lease = (await h.controller.request('phone', {+ op: 'start',+ displayId: '1',+ control: true,+ })) as RemoteDesktopLease;+ expect(lease.controlling).toBe(false);+ expect(h.controller.state).toEqual({ peer: 'phone', controlling: false });+ await expect(+ h.controller.request('phone', { op: 'control', lease: lease.lease, enabled: true }),+ ).resolves.toEqual({ controlling: true });+ });+ it('restarts input on the new geometry within a display change', async () => {+ const h = harness();+ viewerDisplay(h);+ const { lease } = (await h.controller.request('phone', {+ op: 'start',+ displayId: '1',+ control: true,+ })) as RemoteDesktopLease;+ vi.mocked(h.deps.startInput).mockClear();+ const fitted = (await h.controller.request('phone', {+ op: 'viewerDisplay',+ lease,+ width: 1280,+ height: 640,+ control: true,+ })) as RemoteDesktopLease;+ expect(fitted).toMatchObject({ controlling: true, display: { width: 1280, height: 640 } });+ expect(h.deps.startInput).toHaveBeenCalledExactlyOnceWith('viewer');+ const restored = (await h.controller.request('phone', {+ op: 'restoreViewerDisplay',+ lease,+ control: true,+ })) as RemoteDesktopLease;+ expect(restored).toMatchObject({ controlling: true, display: { id: '1' } });+ // Without the flag a display change still returns view only.+ const plain = (await h.controller.request('phone', {+ op: 'viewerDisplay',+ lease,+ width: 1280,+ height: 640,+ })) as RemoteDesktopLease;+ expect(plain.controlling).toBe(false);+ });+ it('grants control after a temporary system resolution', async () => {+ const h = harness();+ h.deps.displayModes = vi.fn(async () => [+ { id: '1', width: 1920, height: 1080, current: true },+ { id: '2', width: 3840, height: 2160, current: false },+ ]);+ h.deps.resolution = vi.fn(async () => {});+ const { lease } = (await h.controller.request('phone', {+ op: 'start',+ displayId: '1',+ control: true,+ })) as RemoteDesktopLease;+ const result = (await h.controller.request('phone', {+ op: 'resolution',+ lease,+ modeId: '2',+ temporary: true,+ control: true,+ })) as RemoteDesktopLease;+ expect(result).toMatchObject({ controlling: true, display: { width: 3840 } });+ expect(h.controller.state?.controlling).toBe(true);+ });+});diff --git a/apps/desktop/src/main/remote-desktop/controller.ts b/apps/desktop/src/main/remote-desktop/controller.tsindex 2b1e97d3f6..4c13bfd07b 100644--- a/apps/desktop/src/main/remote-desktop/controller.ts+++ b/apps/desktop/src/main/remote-desktop/controller.ts@@ -308,6 +308,7 @@ export class RemoteDesktopController {active: NonNullable<RemoteDesktopController['active']>,modeId: string,keepVideo?: boolean,+ control?: boolean,): Promise<RemoteDesktopLease> {if (!active.controlling) throw new Error('DESKTOP_VIEW_ONLY');if (!this.deps.resolution || !this.deps.displayModes)@@ -369,12 +370,13 @@ export class RemoteDesktopController {active.controlling = false;this.controlGeneration++;this.deps.changed();- return {+ const reply: RemoteDesktopLease = {lease: active.lease,display: active.display,controlling: false,...(resumed ? { videoKept: true } : {}),};+ return control ? await this.withControl(peer, active, reply) : reply;} catch (error) {if (this.active === active) this.stop(peer);throw error;@@ -433,6 +435,58 @@ export class RemoteDesktopController {if (!active || (!active.controlling && !this.inputStarting)) return;void this.revokeControl().catch(() => log.warn('Safety restoration failed after control loss'));}+ /** Starts input for the lease's current display; shared by `control` and `autoControl`. */+ private async takeControl(+ peer: string,+ active: NonNullable<RemoteDesktopController['active']>,+ ): Promise<void> {+ if (this.locking) throw new Error('DESKTOP_BUSY');+ if (this.inputStarting) throw new Error('DESKTOP_INPUT_BUSY');+ this.setBackgroundViewing(active, false);+ this.clipboardTransfer.reset();+ const generation = ++this.controlGeneration;+ if (!active.controlling) {+ this.inputStarting = true;+ try {+ await this.deps.startInput(active.display.id);+ if (+ generation !== this.controlGeneration ||+ this.active !== active ||+ !this.deps.authorized(peer)+ ) {+ this.deps.stopInput();+ throw new Error(+ this.userStopped.get(peer) === active.lease+ ? 'DESKTOP_STOPPED'+ : 'DESKTOP_LEASE_EXPIRED',+ );+ }+ this.require(peer, active.lease);+ active.controlling = true;+ } finally {+ this.inputStarting = false;+ }+ }+ this.deps.changed();+ }+ /**+ * `autoControl`: grant control inside the request that created or changed+ * the lease. A refusal (input unavailable, permission missing) leaves the+ * lease view only; the viewer then asks with `control` and shows that reply.+ */+ private async withControl(+ peer: string,+ active: NonNullable<RemoteDesktopController['active']>,+ reply: RemoteDesktopLease,+ ): Promise<RemoteDesktopLease> {+ try {+ await this.takeControl(peer, active);+ } catch (error) {+ // A replaced or stopped lease is not a refusal; report it as before.+ if (this.active !== active) throw error;+ }+ return { ...reply, controlling: active.controlling };+ }/** Explicit local disconnect must not be undone by the phone's recovery. */stopByUser(): void {const target = this.active ?? this.lastEnded;@@ -511,6 +565,7 @@ export class RemoteDesktopController {displays: publicDisplays,automaticReconnect: true,connectionTakeover: true,+ autoControl: caps.canControl === true,resolutionRestore: Boolean(caps.displayModes && this.deps.resolution && this.deps.displayModes,),@@ -526,84 +581,102 @@ export class RemoteDesktopController {return permissions;}if (request.op === 'start') {- const authenticationSession = this.authenticationSession(peer);- if (request.resume && this.userStopped.has(peer)) throw new Error('DESKTOP_STOPPED');- const resumesActive =- request.resume &&- this.active?.peer === peer &&- this.active.sourceDisplayId === request.displayId;+ const lease = await this.start(peer, request);+ return request.control && this.active?.lease === lease.lease+ ? this.withControl(peer, this.active, lease)+ : lease;+ }+ return this.leaseRequest(peer, request);+ }+ private async start(+ peer: string,+ request: Extract<ReturnType<typeof parseRemoteDesktopRequest>, { op: 'start' }>,+ ): Promise<RemoteDesktopLease> {+ const authenticationSession = this.authenticationSession(peer);+ if (request.resume && this.userStopped.has(peer)) throw new Error('DESKTOP_STOPPED');+ const resumesActive =+ request.resume &&+ this.active?.peer === peer &&+ this.active.sourceDisplayId === request.displayId;+ if (+ this.locking ||+ this.starting ||+ this.displayChanging ||+ (this.active && !request.takeover && !resumesActive)+ )+ throw new Error('DESKTOP_BUSY');+ this.starting = true;+ this.startingPeer = peer;+ const generation = this.controlGeneration;+ try {+ if (!this.active && (this.viewerDisplay || this.originalResolution))+ await this.restoreStoppedDisplay();+ if (!this.active && this.deps.prepare) {+ const current = () =>+ this.startingPeer === peer &&+ generation === this.controlGeneration &&+ this.deps.authorized(peer) &&+ this.authenticationCurrent(peer, authenticationSession);+ if (!current()) throw new Error('DESKTOP_LEASE_EXPIRED');+ await this.deps.prepare(current);+ if (!current()) throw new Error('DESKTOP_LEASE_EXPIRED');+ }+ const caps = await this.deps.capabilities();+ if (!this.authenticationCurrent(peer, authenticationSession))+ throw new Error('DESKTOP_AUTHENTICATION_REQUIRED');+ let display = caps.displays.find((d) => d.id === request.displayId);+ if (!display) throw new Error('DESKTOP_DISPLAY_MISSING');if (- this.locking ||- this.starting ||- this.displayChanging ||- (this.active && !request.takeover && !resumesActive)+ this.startingPeer !== peer ||+ generation !== this.controlGeneration ||+ !this.deps.authorized(peer))- throw new Error('DESKTOP_BUSY');- this.starting = true;- this.startingPeer = peer;- const generation = this.controlGeneration;- try {- if (!this.active && (this.viewerDisplay || this.originalResolution))- await this.restoreStoppedDisplay();- if (!this.active && this.deps.prepare) {- const current = () =>- this.startingPeer === peer &&- generation === this.controlGeneration &&- this.deps.authorized(peer) &&- this.authenticationCurrent(peer, authenticationSession);- if (!current()) throw new Error('DESKTOP_LEASE_EXPIRED');- await this.deps.prepare(current);- if (!current()) throw new Error('DESKTOP_LEASE_EXPIRED');- }- const caps = await this.deps.capabilities();- if (!this.authenticationCurrent(peer, authenticationSession))- throw new Error('DESKTOP_AUTHENTICATION_REQUIRED');- let display = caps.displays.find((d) => d.id === request.displayId);- if (!display) throw new Error('DESKTOP_DISPLAY_MISSING');+ throw new Error('DESKTOP_DISABLED');+ if (caps.permissions && !desktopPermissionReady(caps.permissions.screenRecording))+ throw new Error('DESKTOP_SCREEN_PERMISSION_REQUIRED');+ if (request.resume && this.userStopped.has(peer)) throw new Error('DESKTOP_STOPPED');+ if (request.takeover && this.active) this.stopByUser();+ // A lost start reply can leave our own lease alive. Rotate it using the+ // existing cleanup so the new viewer can restart its input sequence at 0.+ else if (resumesActive) this.stop(peer);+ if (this.viewerDisplay || this.originalResolution) {+ const restorationGeneration = this.controlGeneration;+ await this.restoreStoppedDisplay();+ const restored = await this.deps.capabilities();if (this.startingPeer !== peer ||- generation !== this.controlGeneration ||- !this.deps.authorized(peer)+ restorationGeneration !== this.controlGeneration ||+ !this.deps.authorized(peer) ||+ !this.authenticationCurrent(peer, authenticationSession))- throw new Error('DESKTOP_DISABLED');- if (caps.permissions && !desktopPermissionReady(caps.permissions.screenRecording))- throw new Error('DESKTOP_SCREEN_PERMISSION_REQUIRED');- if (request.resume && this.userStopped.has(peer)) throw new Error('DESKTOP_STOPPED');- if (request.takeover && this.active) this.stopByUser();- // A lost start reply can leave our own lease alive. Rotate it using the- // existing cleanup so the new viewer can restart its input sequence at 0.- else if (resumesActive) this.stop(peer);- if (this.viewerDisplay || this.originalResolution) {- const restorationGeneration = this.controlGeneration;- await this.restoreStoppedDisplay();- const restored = await this.deps.capabilities();- if (- this.startingPeer !== peer ||- restorationGeneration !== this.controlGeneration ||- !this.deps.authorized(peer) ||- !this.authenticationCurrent(peer, authenticationSession)- )- throw new Error('DESKTOP_LEASE_EXPIRED');- display = restored.displays.find((d) => d.id === request.displayId);- if (!display) throw new Error('DESKTOP_DISPLAY_MISSING');- }- if (!request.resume) this.userStopped.delete(peer);- const lease: RemoteDesktopLease = { lease: randomUUID(), display, controlling: false };- this.active = {- ...lease,- peer,- sourceDisplayId: display.id,- expires: this.now() + REMOTE_DESKTOP_LEASE_MS,- sequence: -1,- authenticationSession,- };- this.deps.changed();- return lease;- } finally {- this.starting = false;- this.startingPeer = null;+ throw new Error('DESKTOP_LEASE_EXPIRED');+ display = restored.displays.find((d) => d.id === request.displayId);+ if (!display) throw new Error('DESKTOP_DISPLAY_MISSING');}+ if (!request.resume) this.userStopped.delete(peer);+ const lease: RemoteDesktopLease = { lease: randomUUID(), display, controlling: false };+ this.active = {+ ...lease,+ peer,+ sourceDisplayId: display.id,+ expires: this.now() + REMOTE_DESKTOP_LEASE_MS,+ sequence: -1,+ authenticationSession,+ };+ this.deps.changed();+ return lease;+ } finally {+ this.starting = false;+ this.startingPeer = null;}+ }+ private async leaseRequest(+ peer: string,+ request: Exclude<+ ReturnType<typeof parseRemoteDesktopRequest>,+ { op: 'capabilities' | 'permissions' | 'start' }+ >,+ ): Promise<unknown> {const active = this.require(peer, request.lease);if (this.displayChanging &&@@ -763,7 +836,7 @@ export class RemoteDesktopController {active.controlling = false;this.controlGeneration++;this.deps.changed();- return {+ const reply: RemoteDesktopLease = {lease: active.lease,display,controlling: false,@@ -774,6 +847,8 @@ export class RemoteDesktopController {}: {}),};+ // Input restarts on the new geometry within the same request.+ return request.control ? await this.withControl(peer, active, reply) : reply;} catch (error) {if (this.active === active) this.stop(peer);throw error;@@ -819,38 +894,12 @@ export class RemoteDesktopController {return { controlling: active.controlling };}case 'control': {- if (this.locking) throw new Error('DESKTOP_BUSY');- if (request.enabled && this.inputStarting) throw new Error('DESKTOP_INPUT_BUSY');- if (request.enabled) this.setBackgroundViewing(active, false);if (!request.enabled) {+ if (this.locking) throw new Error('DESKTOP_BUSY');await this.revokeControl();return { controlling: active.controlling };}- this.clipboardTransfer.reset();- const generation = ++this.controlGeneration;- if (!active.controlling) {- this.inputStarting = true;- try {- await this.deps.startInput(active.display.id);- if (- generation !== this.controlGeneration ||- this.active !== active ||- !this.deps.authorized(peer)- ) {- this.deps.stopInput();- throw new Error(- this.userStopped.get(peer) === request.lease- ? 'DESKTOP_STOPPED'- : 'DESKTOP_LEASE_EXPIRED',- );- }- this.require(peer, request.lease);- active.controlling = true;- } finally {- this.inputStarting = false;- }- }- this.deps.changed();+ await this.takeControl(peer, active);return { controlling: active.controlling };}case 'clipboardContent':@@ -939,7 +988,13 @@ export class RemoteDesktopController {}case 'resolution': {if (request.temporary)- return this.temporaryResolution(peer, active, request.modeId, request.keepVideo);+ return this.temporaryResolution(+ peer,+ active,+ request.modeId,+ request.keepVideo,+ request.control,+ );if (!active.controlling) throw new Error('DESKTOP_VIEW_ONLY');if (!this.deps.resolution) throw new Error('DESKTOP_DISPLAY_MODES_UNAVAILABLE');if (this.inputStarting || this.clipboardPending || this.locking || this.starting)diff --git a/apps/desktop/src/preload/remoteDesktopViewerPreload.ts b/apps/desktop/src/preload/remoteDesktopViewerPreload.tsindex d47b445ff1..cc4acd6daa 100644--- a/apps/desktop/src/preload/remoteDesktopViewerPreload.ts+++ b/apps/desktop/src/preload/remoteDesktopViewerPreload.ts@@ -98,6 +98,11 @@ contextBridge.exposeInMainWorld('electronAPI', {preferences: (generation, patch) =>ipcRenderer.invoke(REMOTE_VIEWER.PREFERENCES, generation, patch),safety: (generation, retry) => ipcRenderer.invoke(REMOTE_VIEWER.SAFETY, generation, retry),+ resolution: (generation, displayId, value) =>+ ipcRenderer.invoke(REMOTE_VIEWER.RESOLUTION, generation, displayId, value),+ onChannelRequest: (cb) => onPayload(REMOTE_VIEWER.CHANNEL_REQUEST, cb),+ channelReply: (generation, id, outcome) =>+ ipcRenderer.invoke(REMOTE_VIEWER.CHANNEL_REPLY, generation, id, outcome),credential: (generation, action, enabled) =>ipcRenderer.invoke(REMOTE_VIEWER.CREDENTIAL, generation, action, enabled),} satisfies RemoteDesktopViewerApi,diff --git a/apps/desktop/src/renderer/__tests__/PluginConnectionForm.test.tsx b/apps/desktop/src/renderer/__tests__/PluginConnectionForm.test.tsxindex 4ef2794572..1499793432 100644--- a/apps/desktop/src/renderer/__tests__/PluginConnectionForm.test.tsx+++ b/apps/desktop/src/renderer/__tests__/PluginConnectionForm.test.tsx@@ -6,6 +6,10 @@ import i18n from '@/i18n';import { PluginSetupPrompt } from '@/components/new-chat/PluginSetupPrompt';import type { PendingPluginSetup } from '@/lib/makerChatStore';+vi.mock('@/features/device-link/useDeviceLinkDeviceList', () => ({+ useDeviceLinkDeviceList: () => [],+}));+const pending: PendingPluginSetup = {requestId: 'connection-card',revision: 1,diff --git a/apps/desktop/src/renderer/__tests__/PluginSetupPrompt.test.tsx b/apps/desktop/src/renderer/__tests__/PluginSetupPrompt.test.tsxindex 90b9323268..3d1d47fdfd 100644--- a/apps/desktop/src/renderer/__tests__/PluginSetupPrompt.test.tsx+++ b/apps/desktop/src/renderer/__tests__/PluginSetupPrompt.test.tsx@@ -7,6 +7,11 @@ import '@/i18n';import i18n from '@/i18n';import { PluginSetupPrompt } from '@/components/new-chat/PluginSetupPrompt';import { parsePendingPluginSetup, type PendingPluginSetup } from '@/lib/makerChatStore';+import { sharedTaskHostPeer } from '@cindy/device-link';++vi.mock('@/features/device-link/useDeviceLinkDeviceList', () => ({+ useDeviceLinkDeviceList: () => [{ deviceId: 'computer-a', name: 'Studio' }],+}));const pending: PendingPluginSetup = {requestId: 'setup-1',@@ -250,6 +255,46 @@ describe('PluginSetupPrompt', () => {);});+ it('opens the target computer’s remote desktop for steps only it can finish', async () => {+ const openRemoteDesktop = vi.fn(async () => {});+ Object.assign(window.electronAPI, { openRemoteDesktop });+ const props = {+ viewerState: 'expanded' as const,+ commandInFlight: null,+ remote: true,+ onViewerStateChange: vi.fn(),+ onCommand: vi.fn(),+ };+ const { rerender } = render(+ <PluginSetupPrompt pending={pending} remoteDeviceId="computer-a" {...props} />,+ );+ fireEvent.click(screen.getByRole('button', { name: 'Open remote desktop' }));+ expect(openRemoteDesktop).toHaveBeenCalledWith({ deviceId: 'computer-a', name: 'Studio' });+ await vi.waitFor(() =>+ expect(+ (screen.getByRole('button', { name: 'Open remote desktop' }) as HTMLButtonElement).disabled,+ ).toBe(false),+ );+ // A secret entered on this card is saved remotely; nothing to do on the computer.+ rerender(+ <PluginSetupPrompt+ pending={{ ...inlinePending, remoteSecret: true }}+ remoteDeviceId="computer-a"+ {...props}+ />,+ );+ expect(screen.queryByRole('button', { name: 'Open remote desktop' })).toBeNull();+ // A shared task's host computer is not this account's to control.+ rerender(+ <PluginSetupPrompt+ pending={pending}+ remoteDeviceId={sharedTaskHostPeer('task-1', 'computer-b')}+ {...props}+ />,+ );+ expect(screen.queryByRole('button', { name: 'Open remote desktop' })).toBeNull();+ });+it('enables only OAuth actions advertised by the cloud Host', () => {const onCommand = vi.fn();render(<PluginSetupPrompt pending={{ ...pending, remoteOauth: true }} viewerState="expanded"diff --git a/apps/desktop/src/renderer/components/new-chat/PluginSetupPrompt.tsx b/apps/desktop/src/renderer/components/new-chat/PluginSetupPrompt.tsxindex 8f16d06c23..f2ae0e897d 100644--- a/apps/desktop/src/renderer/components/new-chat/PluginSetupPrompt.tsx+++ b/apps/desktop/src/renderer/components/new-chat/PluginSetupPrompt.tsx@@ -2,6 +2,7 @@ import { Button } from '@/components/ui/button';import { AlertCircle, Check, Circle, ExternalLink, LoaderCircle } from 'lucide-react';import { useEffect, useId, useState, type ComponentProps } from 'react';import { useTranslation } from 'react-i18next';+import { isSharedTaskPeer } from '@cindy/device-link';import { InteractionPromptCardShell } from '@/components/interaction-portal';import { GhostPluginIcon } from '@/features/plugin/GhostPluginIcon';@@ -17,6 +18,7 @@ import type { GhostSetupStepPhase } from '../../../shared/ghost';import { RemoteOauthSetupCard } from './RemoteOauthSetupCard';import { PluginOauthDeviceCode } from './PluginOauthDeviceCode';import { PluginConnectionForm } from './PluginConnectionForm';+import { PluginSetupRemoteDesktopButton } from './PluginSetupRemoteDesktopButton';interface PluginSetupPromptProps {remoteDeviceId?: string;@@ -115,6 +117,12 @@ function PluginSetupPromptStateful({((pending.remoteOauth && commandInFlight.action === 'run_action') ||((pending.remoteSecret || pending.remoteConnection) && commandInFlight.action === 'submit_form')));const connectionForm = (step = currentStep) => remote && pending.remoteConnection && step?.action?.kind === 'manage_connection';+ // Steps that only the target computer can finish: offer its remote desktop.+ const remoteDesktopTarget =+ remote && remoteDeviceId && !terminal && !connectionForm() && !isSharedTaskPeer(remoteDeviceId) &&+ !(pending.remoteSecret && currentStep?.action?.kind === 'inline_form')+ ? remoteDeviceId+ : null;const title = compact ? pending.ghost.name : t('newChat.pluginSetup.title', { name: pending.ghost.name });const inlineFormAction = currentStep?.action?.kind === 'inline_form' ? currentStep.action : null;const inlineFormField = inlineFormAction?.form.fields[0];@@ -452,6 +460,7 @@ function PluginSetupPromptStateful({</span></Button>) : null}+ {remoteDesktopTarget ? <PluginSetupRemoteDesktopButton deviceId={remoteDesktopTarget} /> : null}{!terminal ? (<Buttonvariant="secondary"diff --git a/apps/desktop/src/renderer/components/new-chat/PluginSetupRemoteDesktopButton.tsx b/apps/desktop/src/renderer/components/new-chat/PluginSetupRemoteDesktopButton.tsxnew file mode 100644index 0000000000..35ebfaa22d--- /dev/null+++ b/apps/desktop/src/renderer/components/new-chat/PluginSetupRemoteDesktopButton.tsx@@ -0,0 +1,42 @@+import { useEffect, useRef, useState } from 'react';+import { useTranslation } from 'react-i18next';+import { Button } from '@/components/ui/button';+import { useDeviceLinkDeviceList } from '@/features/device-link/useDeviceLinkDeviceList';+import { toast } from '@/lib/toast';++/** Navigation only: authorization and credentials stay in the computer's own UI. */+export function PluginSetupRemoteDesktopButton({ deviceId }: { deviceId: string }) {+ const { t } = useTranslation();+ const devices = useDeviceLinkDeviceList();+ const name = devices?.find((device) => device.deviceId === deviceId)?.name || deviceId;+ const [opening, setOpening] = useState(false);+ const mounted = useRef(true);+ useEffect(+ () => () => {+ mounted.current = false;+ },+ [],+ );+ return (+ <Button+ variant="secondary"+ palette="confirmation"+ size="lg"+ compact+ type="button"+ loading={opening}+ disabled={opening}+ onClick={() => {+ setOpening(true);+ void window.electronAPI+ .openRemoteDesktop({ deviceId, name })+ .catch(() => toast.error(t('remoteDesktop.connectionError')))+ .finally(() => {+ if (mounted.current) setOpening(false);+ });+ }}+ >+ {t('remoteDesktop.shortcut.open')}+ </Button>+ );+}diff --git a/apps/desktop/src/renderer/features/bots/__tests__/BotAuthorizationCard.forms.test.tsx b/apps/desktop/src/renderer/features/bots/__tests__/BotAuthorizationCard.forms.test.tsxindex 1d4514292f..404d5793e6 100644--- a/apps/desktop/src/renderer/features/bots/__tests__/BotAuthorizationCard.forms.test.tsx+++ b/apps/desktop/src/renderer/features/bots/__tests__/BotAuthorizationCard.forms.test.tsx@@ -15,6 +15,10 @@ import { remoteProjectsStore } from '@/features/device-link/remoteProjectsStore'import { __resetStickySessionOriginForTest } from '@/features/device-link/stickySessionOrigin';import { BotAuthorizationCardView } from '../BotAuthorizationCard';+vi.mock('@/features/device-link/useDeviceLinkDeviceList', () => ({+ useDeviceLinkDeviceList: () => [],+}));+// Keep the actual Host snapshot/projection, card, shared form and transport routing.vi.mock('react-i18next', () => ({ useTranslation: () => ({ t: (key: string) => key }) }));vi.mock('../../../../main/plugin-oauth/runtime', () => ({ supportsRemotePluginOauth: () => true }));diff --git a/apps/desktop/src/renderer/features/remote-desktop/RemoteDesktopViewerWindow.tsx b/apps/desktop/src/renderer/features/remote-desktop/RemoteDesktopViewerWindow.tsxindex 0215f7a950..23210f9c2b 100644--- a/apps/desktop/src/renderer/features/remote-desktop/RemoteDesktopViewerWindow.tsx+++ b/apps/desktop/src/renderer/features/remote-desktop/RemoteDesktopViewerWindow.tsx@@ -156,7 +156,7 @@ export function RemoteDesktopViewerWindow() {const owner = generation.current;setModesStatus('loading');void controller.current- ?.displayModes()+ ?.resolutionModes().then((value) => {if (owner !== generation.current) return;setModes(value);@@ -169,7 +169,8 @@ export function RemoteDesktopViewerWindow() {const openPanel = (panel: 'display' | 'clipboard' | 'security', open: boolean) => {controller.current?.releaseInput();setSettings((current) => (open ? panel : current === panel ? null : current));- if (open && panel === 'display' && state?.caps?.displayModes) loadModes();+ if (open && panel === 'display' && (state?.caps?.displayModes || state?.fittedDisplay))+ loadModes();};const onSelectOpenChange = (open: boolean) => {setSelectOpen(open);@@ -424,7 +425,15 @@ export function RemoteDesktopViewerWindow() {.catch(() => setNotice(t('remoteDesktop.viewer.settingsFailed')));}}>- {t('remoteDesktop.viewer.fitViewerDisplay')}+ {t(+ root.current &&+ controller.current?.viewerDisplayMatched(+ root.current.clientWidth,+ root.current.clientHeight,+ )+ ? 'remoteDesktop.viewer.restoreViewerDisplay'+ : 'remoteDesktop.viewer.fitViewerDisplay',+ )}</Button><p>{t('remoteDesktop.viewer.fitViewerDisplayHint')}</p></div>@@ -456,19 +465,23 @@ export function RemoteDesktopViewerWindow() {value: mode.id,label: `${mode.width} × ${mode.height}${mode.native ? ` · ${t('remoteDesktop.nativeResolution')}` : ''}`,}))}- onValueChange={(value) =>+ onValueChange={(value) => {+ const mode = modes.find((item) => item.id === value);+ if (!mode) return;void controller.current- ?.resolution(value)+ ?.resolution(mode).then(loadModes)- .catch(() => setNotice(t('remoteDesktop.viewer.settingsFailed')))- }+ .catch(() => setNotice(t('remoteDesktop.viewer.settingsFailed')));+ }}onOpenChange={onSelectOpenChange}/>)}</FormField>)}- {state?.caps?.displayModes && <p>{t('remoteDesktop.viewer.resolutionHint')}</p>}+ {(state?.caps?.displayModes || state?.fittedDisplay) && (+ <p>{t('remoteDesktop.viewer.resolutionHint')}</p>+ )}<div className="remote-viewer-panel-section"><label className="remote-viewer-toggle-row" htmlFor="viewer-audio"><span>{t('remoteDesktop.viewer.sound')}</span>diff --git a/apps/desktop/src/renderer/features/remote-desktop/__tests__/viewerControl.test.ts b/apps/desktop/src/renderer/features/remote-desktop/__tests__/viewerControl.test.tsindex f9445d91c4..ef40a45312 100644--- a/apps/desktop/src/renderer/features/remote-desktop/__tests__/viewerControl.test.ts+++ b/apps/desktop/src/renderer/features/remote-desktop/__tests__/viewerControl.test.ts@@ -1,5 +1,9 @@import { afterEach, beforeEach, expect, it, vi } from 'vitest';-import type { RemoteDesktopViewerApi } from '../../../../shared/remoteDesktopViewer';+import type {+ RememberedViewerResolution,+ RemoteDesktopViewerApi,+ RemoteViewerChannelRequest,+} from '../../../../shared/remoteDesktopViewer';import { DesktopViewerController, type ViewerSnapshot } from '../viewerController';const runtime = vi.hoisted(() => ({@@ -32,16 +36,36 @@ afterEach(() => {async function fixture(firstControl?: Promise<{ controlling: boolean }>,resolutionRestore = false,+ options: {+ caps?: Record<string, unknown>;+ remembered?: RememberedViewerResolution | null;+ root?: { clientWidth: number; clientHeight: number };+ api?: Partial<RemoteDesktopViewerApi>;+ } = {},) {const control = vi.fn(async (enabled: boolean) => ({ controlling: enabled }));if (firstControl) control.mockImplementationOnce(() => firstControl);const heartbeat = vi.fn(async () => ({ controlling: true }));const clipboard = vi.fn(async () => {});- const resolution = vi.fn(async (_modeId: string) => ({+ const resolution = vi.fn(async (modeId: string) => ({lease: 'lease',controlling: false,- display: { id: 'one', width: 3840, height: 2160 },+ display:+ modeId === 'hd'+ ? { id: 'one', width: 1920, height: 1080 }+ : { id: 'one', width: 3840, height: 2160 },}));+ let remembered = options.remembered ?? null;+ const memory = vi.fn(+ async (+ _generation: number,+ _displayId: string,+ value?: RememberedViewerResolution | null,+ ) => {+ if (value !== undefined) remembered = value;+ return remembered;+ },+ );const api = {state: async () => ({generation: 1,@@ -72,11 +96,12 @@ async function fixture(clipboardText: true,automaticReconnect: true,displays: [{ id: 'one', name: 'Display', width: 1280, height: 720 }],+ ...options.caps,};case 'start':return {lease: 'lease',- controlling: false,+ controlling: request.control === true,display: { id: 'one', width: 1280, height: 720 },};case 'control':@@ -93,8 +118,15 @@ async function fixture(case 'viewerDisplay':return {lease: 'lease',- controlling: false,+ controlling: request.control === true,display: { id: 'viewer', width: request.width, height: request.height },+ ...(request.keepVideo ? { videoKept: true } : {}),+ };+ case 'restoreViewerDisplay':+ return {+ lease: 'lease',+ controlling: false,+ display: { id: 'one', width: 1280, height: 720 },};case 'frame':return { jpeg: null };@@ -102,14 +134,22 @@ async function fixture(return {};}},+ resolution: memory,+ ...options.api,} satisfies RemoteDesktopViewerApi;- controller = new DesktopViewerController(api, {} as HTMLElement, (state) => {- snapshot = state;- });+ controller = new DesktopViewerController(+ api,+ (options.root ?? {}) as HTMLElement,+ (state) => {+ snapshot = state;+ },+ );await vi.advanceTimersByTimeAsync(0);- return { control, heartbeat, clipboard, resolution, api };+ return { control, heartbeat, clipboard, resolution, memory, api };}const present = () => runtime.post?.({ type: 'streaming', epoch: 'lease' });+const mode4k = { id: '4k', width: 3840, height: 2160, current: false };+const portrait = { id: '640', width: 640, height: 1242, current: false };const inputEnabled = () =>runtime.receive.mock.calls.filter(([message]) => message.type === 'control').at(-1)?.[0].enabled ?? false;@@ -117,7 +157,7 @@ const inputEnabled = () =>it('keeps high-resolution system modes on a restorable lease', async () => {const f = await fixture(undefined, true);present();- await controller.resolution('4k');+ await controller.resolution(mode4k);expect(f.resolution).toHaveBeenCalledWith('4k');expect(runtime.receive.mock.calls.some(([m]) => m.type === 'videoSettings' && m.width === 3840),@@ -127,7 +167,7 @@ it('keeps high-resolution system modes on a restorable lease', async () => {it('does not silently make a persistent resolution change on an older host', async () => {const f = await fixture();present();- await expect(controller.resolution('4k')).rejects.toThrow('DESKTOP_DISPLAY_MODES_UNAVAILABLE');+ await expect(controller.resolution(mode4k)).rejects.toThrow('DESKTOP_DISPLAY_MODES_UNAVAILABLE');expect(f.resolution).not.toHaveBeenCalled();});@@ -142,6 +182,7 @@ it('matches the viewer ratio without replacing the lease or resetting input sequtype: 'videoSettings',width: 960,height: 1920,+ restore: false,audio: false,});expect(runtime.receive.mock.calls.filter(([m]) => m.type === 'init')).toHaveLength(1);@@ -151,13 +192,14 @@ it('changes portrait resolution using the same temporary screen lease', async ()await fixture();present();await controller.fitDisplay(500, 1000);- await controller.resolution('640');+ await controller.resolution(portrait);expect(snapshot.controlling).toBe(true);expect(snapshot.displayId).toBe('one');expect(runtime.receive).toHaveBeenCalledWith({type: 'videoSettings',width: 640,height: 1242,+ restore: false,audio: false,});expect(runtime.receive.mock.calls.filter(([m]) => m.type === 'init')).toHaveLength(1);@@ -435,8 +477,274 @@ it('passes actual logical geometry to rendering and reacquires control after fittype: 'videoSettings',width: 960,height: 710,+ restore: false,audio: false,});expect(snapshot.controlling).toBe(true);expect(f.control).toHaveBeenLastCalledWith(true);});++const sent = (type: string) =>+ runtime.receive.mock.calls.filter(([message]) => message.type === type).map(([m]) => m);++it('keeps the running video when the host confirms a live display switch', async () => {+ const f = await fixture(undefined, false, { caps: { liveDisplaySwitch: true } });+ const request = vi.spyOn(f.api, 'request');+ present();+ runtime.receive.mockClear();+ await controller.fitDisplay(500, 1000);+ expect(request).toHaveBeenCalledWith(+ 1,+ expect.objectContaining({ op: 'viewerDisplay', keepVideo: true }),+ undefined,+ );+ expect(sent('displayGeometry')).toEqual([+ { type: 'displayGeometry', width: 960, height: 1920, restore: false },+ ]);+ expect(sent('videoSettings')).toEqual([]);+ expect(snapshot).toMatchObject({ transport: 'video', status: 'live', controlling: true });+});++it('rebuilds the video when a live-switch host does not confirm keeping it', async () => {+ const f = await fixture(undefined, true, { caps: { liveDisplaySwitch: true } });+ present();+ runtime.receive.mockClear();+ await controller.resolution(mode4k);+ expect(f.resolution).toHaveBeenCalledWith('4k');+ expect(sent('displayGeometry')).toEqual([]);+ expect(sent('videoSettings')).toEqual([+ { type: 'videoSettings', width: 3840, height: 2160, restore: true, audio: false },+ ]);+});++it('applies a listed mode without reading the mode list again', async () => {+ const f = await fixture(undefined, true);+ const request = vi.spyOn(f.api, 'request');+ present();+ await controller.resolution(mode4k);+ expect(request.mock.calls.some(([, r]) => r.op === 'displayModes')).toBe(false);+});++it('offers same-ratio choices after fitting and restores the original display', async () => {+ const f = await fixture();+ const request = vi.spyOn(f.api, 'request');+ present();+ // Host modes keep the monitor's ratio: the portrait mode is not offered.+ expect((await controller.resolutionModes()).map((mode) => mode.id)).toEqual(['4k']);+ expect(controller.viewerDisplayMatched(500, 1000)).toBe(false);+ await controller.fitDisplay(500, 1000);+ expect(snapshot.fittedDisplay).toEqual({ width: 960, height: 1920 });+ expect(controller.viewerDisplayMatched(500, 1000)).toBe(true);+ expect(controller.viewerDisplayMatched(1000, 500)).toBe(false);+ const fitted = await controller.resolutionModes();+ expect(fitted.every((mode) => Math.abs(mode.width / mode.height - 0.5) < 0.003)).toBe(true);+ expect(fitted.find((mode) => mode.current)).toMatchObject({ width: 960, height: 1920 });+ await controller.resolution(fitted[0]);+ expect(request).toHaveBeenLastCalledWith(+ 1,+ expect.objectContaining({ op: 'control', enabled: true }),+ undefined,+ );+ expect(snapshot.fittedDisplay).toEqual({ width: 960, height: 1920 });+ await controller.fitDisplay(500, 1000);+ expect(request.mock.calls.some(([, r]) => r.op === 'restoreViewerDisplay')).toBe(true);+ expect(snapshot.fittedDisplay).toBeNull();+ expect(f.memory).toHaveBeenLastCalledWith(1, 'one', null);+});++it('remembers system modes per monitor and forgets the computer’s own mode', async () => {+ const f = await fixture(undefined, true);+ const original = f.api.request;+ vi.spyOn(f.api, 'request').mockImplementation(async (generation, r) =>+ r.op === 'displayModes'+ ? [{ ...mode4k, current: true }, { id: 'hd', width: 1920, height: 1080, current: false }]+ : original(generation, r),+ );+ present();+ const [own, hd] = await controller.resolutionModes();+ await controller.resolution(hd);+ expect(f.memory).toHaveBeenLastCalledWith(1, 'one', {+ kind: 'mode',+ modeId: 'hd',+ width: 1920,+ height: 1080,+ });+ await controller.resolution(own);+ expect(f.memory).toHaveBeenLastCalledWith(1, 'one', null);+});++it('reapplies a remembered system mode once control and the first frame are ready', async () => {+ const f = await fixture(undefined, true, {+ remembered: { kind: 'mode', modeId: 'stale-id', width: 3840, height: 2160 },+ });+ present();+ await vi.advanceTimersByTimeAsync(0);+ // Mode IDs may change; the same size still matches.+ expect(f.resolution).toHaveBeenCalledExactlyOnceWith('4k');+ expect(snapshot.controlling).toBe(true);+ present();+ await vi.advanceTimersByTimeAsync(0);+ expect(f.resolution).toHaveBeenCalledOnce();+});++it('refits a remembered fit to the current window at the remembered size', async () => {+ const f = await fixture(undefined, false, {+ remembered: { kind: 'fit', width: 1280, height: 960 },+ root: { clientWidth: 1000, clientHeight: 500 },+ });+ const request = vi.spyOn(f.api, 'request');+ present();+ await vi.advanceTimersByTimeAsync(0);+ expect(request).toHaveBeenCalledWith(+ 1,+ expect.objectContaining({ op: 'viewerDisplay', width: 1280, height: 640 }),+ undefined,+ );+ expect(snapshot.fittedDisplay).toEqual({ width: 1920, height: 960 });+});++it('does not retry a remembered choice that failed in this window', async () => {+ const f = await fixture(undefined, true, {+ remembered: { kind: 'mode', modeId: '4k', width: 3840, height: 2160 },+ });+ f.resolution.mockRejectedValueOnce(new Error('DESKTOP_DISPLAY_FAILED'));+ present();+ await vi.advanceTimersByTimeAsync(0);+ expect(f.resolution).toHaveBeenCalledOnce();+ f.heartbeat.mockResolvedValueOnce({ controlling: false });+ await vi.advanceTimersByTimeAsync(3000);+ controller.retry();+ await vi.advanceTimersByTimeAsync(0);+ present();+ await vi.advanceTimersByTimeAsync(0);+ expect(f.resolution).toHaveBeenCalledOnce();+});++const channelFixture = async (caps: Record<string, unknown> = { channelRequests: true }) => {+ let forward: ((message: RemoteViewerChannelRequest) => void) | null = null;+ const channelReply = vi.fn(async () => {});+ const f = await fixture(undefined, false, {+ caps,+ api: {+ onChannelRequest: (listener: (message: RemoteViewerChannelRequest) => void) => {+ forward = listener;+ return () => {};+ },+ channelReply,+ },+ });+ const ask = (request: Record<string, unknown>, id = 'id-1', generation = 1) =>+ forward?.({ generation, id, request: request as RemoteViewerChannelRequest['request'] });+ return { ...f, channelReply, ask };+};+const control = { op: 'control', lease: 'lease', enabled: true };++it('carries Main’s small requests over the live media data channel', async () => {+ const f = await channelFixture();+ present();+ f.ask(control);+ const [channel] = sent('channelRequest') as { id: string; request: unknown }[];+ expect(channel).toMatchObject({ id: 'id-1', request: control });+ runtime.post?.({+ type: 'channelReply',+ epoch: 'lease',+ id: 'id-1',+ ok: true,+ result: { controlling: true },+ });+ await vi.advanceTimersByTimeAsync(0);+ expect(f.channelReply).toHaveBeenCalledWith(1, 'id-1', {+ kind: 'result',+ value: { controlling: true },+ });+});++it('maps channel refusals to the relay and real failures to errors', async () => {+ const f = await channelFixture();+ present();+ f.ask(control, 'busy');+ runtime.post?.({ type: 'channelReply', epoch: 'lease', id: 'busy', ok: false, error: 'DESKTOP_CHANNEL_BUSY' });+ f.ask({ op: 'displayModes', lease: 'lease' }, 'large');+ runtime.post?.({ type: 'channelReply', epoch: 'lease', id: 'large', ok: false, error: 'DESKTOP_REPLY_TOO_LARGE' });+ f.ask(control, 'failed');+ runtime.post?.({ type: 'channelReply', epoch: 'lease', id: 'failed', ok: false, error: 'DESKTOP_VIEW_ONLY' });+ f.ask(control, 'unsent');+ runtime.post?.({ type: 'channelRequestState', epoch: 'lease', id: 'unsent', sent: false });+ await vi.advanceTimersByTimeAsync(0);+ expect(f.channelReply).toHaveBeenCalledWith(1, 'busy', { kind: 'relay' });+ expect(f.channelReply).toHaveBeenCalledWith(1, 'large', { kind: 'relay' });+ expect(f.channelReply).toHaveBeenCalledWith(1, 'failed', { kind: 'error', code: 'DESKTOP_VIEW_ONLY' });+ expect(f.channelReply).toHaveBeenCalledWith(1, 'unsent', { kind: 'relay' });+});++it('returns requests to the relay without video, support, the current lease or generation', async () => {+ const unsupported = await channelFixture({});+ present();+ unsupported.ask(control);+ await vi.advanceTimersByTimeAsync(0);+ expect(unsupported.channelReply).toHaveBeenLastCalledWith(1, 'id-1', { kind: 'relay' });+ controller.dispose();+ const f = await channelFixture();+ f.ask(control, 'before-video');+ present();+ f.ask({ ...control, lease: 'old' }, 'old-lease');+ f.ask(control, 'old-generation', 0);+ f.ask({ op: 'heartbeat', lease: 'lease' }, 'not-allowed');+ await vi.advanceTimersByTimeAsync(0);+ for (const id of ['before-video', 'old-lease', 'not-allowed'])+ expect(f.channelReply).toHaveBeenCalledWith(1, id, { kind: 'relay' });+ expect(f.channelReply).toHaveBeenCalledWith(0, 'old-generation', { kind: 'relay' });+ expect(sent('channelRequest')).toEqual([]);+});++it('settles carried requests as unknown when the media peer falls back', async () => {+ const f = await channelFixture();+ present();+ f.ask(control);+ runtime.post?.({ type: 'fallback', epoch: 'lease' });+ await vi.advanceTimersByTimeAsync(0);+ expect(f.channelReply).toHaveBeenCalledWith(1, 'id-1', { kind: 'error', code: 'INVOKE_TIMEOUT' });+});++it('needs no separate control request when the host grants it with the lease and display changes', async () => {+ const f = await fixture(undefined, false, { caps: { autoControl: true } });+ const request = vi.spyOn(f.api, 'request');+ present();+ expect(f.control).not.toHaveBeenCalled();+ expect(snapshot).toMatchObject({ controlling: true, ready: true });+ await controller.fitDisplay(500, 1000);+ expect(request).toHaveBeenCalledWith(+ 1,+ expect.objectContaining({ op: 'viewerDisplay', control: true }),+ undefined,+ );+ expect(f.control).not.toHaveBeenCalled();+ expect(snapshot.controlling).toBe(true);+});++it('waits for auto-unlock to finish before reapplying a remembered resolution', async () => {+ const unlock = deferred<{+ available: boolean;+ autoUnlock: boolean;+ biometricAvailable: boolean;+ biometricVerification: boolean;+ }>();+ const credential = vi.fn(() => unlock.promise);+ const f = await fixture(undefined, true, {+ caps: { platform: 'darwin', autoControl: true },+ remembered: { kind: 'mode', modeId: '4k', width: 3840, height: 2160 },+ api: { credential },+ });+ present();+ await vi.advanceTimersByTimeAsync(0);+ expect(credential).toHaveBeenCalledWith(1, 'unlock', undefined);+ expect(f.resolution).not.toHaveBeenCalled();+ unlock.resolve({+ available: true,+ autoUnlock: true,+ biometricAvailable: false,+ biometricVerification: false,+ });+ await vi.advanceTimersByTimeAsync(0);+ expect(f.resolution).toHaveBeenCalledExactlyOnceWith('4k');+});diff --git a/apps/desktop/src/renderer/features/remote-desktop/__tests__/viewerInput.test.ts b/apps/desktop/src/renderer/features/remote-desktop/__tests__/viewerInput.test.tsindex d3a04d1f21..1aa029cc8b 100644--- a/apps/desktop/src/renderer/features/remote-desktop/__tests__/viewerInput.test.ts+++ b/apps/desktop/src/renderer/features/remote-desktop/__tests__/viewerInput.test.ts@@ -385,6 +385,21 @@ it('maps real mouse movement, right button and wheel to the picture below the toexpect(events()).toContainEqual({ kind: 'button', button: 2, down: false, x: 0.5, y: 0.5 });expect(events()).toContainEqual({ kind: 'scroll', dx: 0, dy: 32 });});+it('carries sub-pixel wheel deltas instead of letting hosts truncate them away', () => {+ pointer('pointermove');+ vi.advanceTimersByTime(34);+ const wheel = (deltaX: number, deltaY: number) =>+ stage.dispatchEvent(new WheelEvent('wheel', { deltaX, deltaY, bubbles: true, cancelable: true }));+ wheel(0, 0.4);+ wheel(0, 0.4);+ expect(events().filter((e) => e.kind === 'scroll')).toEqual([]);+ wheel(-0.5, 0.4);+ wheel(-0.7, 2.5);+ expect(events().filter((e) => e.kind === 'scroll')).toEqual([+ { kind: 'scroll', dx: 0, dy: 1 },+ { kind: 'scroll', dx: -1, dy: 2 },+ ]);+});it('commits IME text once and never forwards local toolbar keyboard input', () => {pointer('pointerdown');pointer('pointerup');@@ -561,3 +576,33 @@ it('continues edge panning when the first browser frame predates the pointer evevi.advanceTimersByTime(200);expect(parseFloat(document.getElementById('image')!.style.left)).toBeLessThan(-500);});+it('still releases host input when a local view-only switch abandons an in-flight batch', () => {+ viewer.dispose();+ messages = [];+ // No automatic ACK: the first batch stays in flight.+ viewer = mountRemoteDesktopViewer(document, (message) => messages.push(message), {+ desktop: true,+ net: REMOTE_DESKTOP_NETWORK,+ iceServers: [],+ keyCodes: DESKTOP_KEY_CODES,+ });+ viewer.receive({ type: 'init', epoch: 'lease', width: 1000, height: 600 });+ viewer.receive({ type: 'control', enabled: true });+ pointer('pointermove');+ vi.advanceTimersByTime(34);+ pointer('pointerdown');+ vi.advanceTimersByTime(34);+ const before = messages.filter((m) => m.type === 'input').length;+ viewer.receive({ type: 'control', enabled: false, release: true });+ const after = messages.filter((m) => m.type === 'input');+ expect(after.length).toBe(before + 1);+ expect(after.at(-1)?.events).toEqual([{ kind: 'release' }]);+ // Without the flag (the host revoked control) an in-flight batch still+ // drops the queued release, as before.+ viewer.receive({ type: 'control', enabled: true });+ pointer('pointermove', 400, 300);+ vi.advanceTimersByTime(34);+ const count = messages.filter((m) => m.type === 'input').length;+ viewer.receive({ type: 'control', enabled: false });+ expect(messages.filter((m) => m.type === 'input').length).toBe(count);+});diff --git a/apps/desktop/src/renderer/features/remote-desktop/__tests__/viewerWindow.test.tsx b/apps/desktop/src/renderer/features/remote-desktop/__tests__/viewerWindow.test.tsxindex 2d17d05d64..44cd41cb31 100644--- a/apps/desktop/src/renderer/features/remote-desktop/__tests__/viewerWindow.test.tsx+++ b/apps/desktop/src/renderer/features/remote-desktop/__tests__/viewerWindow.test.tsx@@ -103,6 +103,7 @@ it('confirms toolbar and native exits, keeps cancellation connected, and discardcredential: null,credentialBusy: false,credentialNotice: null,+ fittedDisplay: null,};for (const status of ['connecting', 'reconnecting']) {act(() => lifecycle.update?.({ ...connected, ready: false, status }));@@ -184,6 +185,7 @@ it('hides view-only controls and enables desktop actions only after control is ccredential: null,credentialBusy: false,credentialNotice: null,+ fittedDisplay: null,target: { deviceId: 'host', name: 'Windows' },ready: true,controlling: false,@@ -316,6 +318,7 @@ it.each([credential: null,credentialBusy: false,credentialNotice: null,+ fittedDisplay: null,target: null,ready: true,controlling: true,@@ -364,6 +367,7 @@ it('marks an active privacy screen in the toolbar and for screen readers withoutcredential: null,credentialBusy: false,credentialNotice: null,+ fittedDisplay: null,target: null,ready: true,controlling: true,diff --git a/apps/desktop/src/renderer/features/remote-desktop/viewerController.ts b/apps/desktop/src/renderer/features/remote-desktop/viewerController.tsindex 8b5f717de5..4f7ce4183f 100644--- a/apps/desktop/src/renderer/features/remote-desktop/viewerController.ts+++ b/apps/desktop/src/renderer/features/remote-desktop/viewerController.ts@@ -6,10 +6,16 @@ import {RemoteDesktopViewerSession,REMOTE_DESKTOP_CONNECTION_TIMEOUT_MS,viewerDisplaySize,+ fittedDisplayModes,+ findRememberedMode,RemoteDesktopViewerMedia,remoteDesktopFailureKey,isDesktopInput,+ isRemoteDesktopChannelRequest,+ parseRemoteDesktopChannelReply,+ REMOTE_DESKTOP_CHANNEL_TIMEOUT_MS,type RemoteDesktopCapabilities,+ type RemoteDesktopDisplayMode,type RemoteDesktopVideoSettings,type RemoteDesktopRequest,type DesktopInput,@@ -22,11 +28,16 @@ import type {} from '../../../shared/remoteDesktopViewer';import {DEFAULT_VIEWER_PREFERENCES,+ type RememberedViewerResolution,+ type RemoteViewerChannelOutcome as ChannelOutcome,+ type RemoteViewerChannelRequest,type RemoteViewerPreferences,type RemoteViewerSafety,type RemoteViewerCredentialState,} from '../../../shared/remoteDesktopViewer';+type Size = { width: number; height: number };+export interface ViewerSnapshot {target: RemoteViewerState['target'];status: string;@@ -48,8 +59,13 @@ export interface ViewerSnapshot {credential: RemoteViewerCredentialState | null;credentialBusy: boolean;credentialNotice: string | null;+ /** The picture was fitted to this window; restore and same-ratio sizes apply. */+ fittedDisplay: Size | null;}+const sameAspect = (display: Size, width: number, height: number) =>+ width > 0 && height > 0 && Math.abs(display.width / display.height - width / height) < 0.003;+/** macOS reports native fullscreen transitions as a brief hide/show; only a* viewer that stays hidden pauses the host's video. Showing resumes at once. */const HIDDEN_VIDEO_PAUSE_MS = 1500;@@ -85,6 +101,7 @@ export class DesktopViewerController {credential: null,credentialBusy: false,credentialNotice: null,+ fittedDisplay: null,};private scope: RemoteViewerState = { target: null, active: false, generation: -1 };private disposed = false;@@ -113,6 +130,17 @@ export class DesktopViewerController {private videoStream = 0;private videoHidden = false;private unlockAttempted = false;+ private unlockAttempt: Promise<void> = Promise.resolve();+ private channelRequests = new Map<+ string,+ { op: RemoteDesktopRequest['op']; settle(outcome: ChannelOutcome): void }+ >();+ /** The computer's own mode at the start of a lease; choosing it again forgets the memory. */+ private hostMode: { lease: string; modeId?: string } | null = null;+ /** The remembered display choice is reapplied once per lease. */+ private rememberedLease: string | null = null;+ /** A remembered choice that failed is not retried in this window, so it cannot loop reconnects. */+ private rememberedGaveUp = false;private credentialRetry: {action: 'settings' | 'enable' | 'disable' | 'unlock' | 'biometric';enabled?: boolean;@@ -159,7 +187,12 @@ export class DesktopViewerController {iceServers: REMOTE_DESKTOP_ICE_SERVERS,keyCodes: DESKTOP_KEY_CODES,});- this.unsubscribers = [api.onActive((scope) => this.updateScope(scope))];+ this.unsubscribers = [+ api.onActive((scope) => this.updateScope(scope)),+ ...(api.onChannelRequest+ ? [api.onChannelRequest((message) => void this.forwardChannelRequest(message))]+ : []),+ ];void api.state().then((scope) => this.updateScope(scope))@@ -201,6 +234,52 @@ export class DesktopViewerController {}if (!this.disposed) this.changed(this.state);}+ /** Main decides and checks every request, then may hand small ones back to+ * carry over this window's live media data channel: a direct peer skips the+ * relay round trip. Anything not sent here goes back to Main for the relay. */+ private async forwardChannelRequest(message: RemoteViewerChannelRequest): Promise<void> {+ const { generation, id, request } = message ?? {};+ if (!this.api.channelReply || typeof id !== 'string' || id.length > 64) return;+ const lease = this.session.lease;+ const outcome: ChannelOutcome =+ generation === this.scope.generation &&+ !this.disposed &&+ lease &&+ this.streaming &&+ this.state.caps?.channelRequests === true &&+ isRemoteDesktopChannelRequest(request) &&+ 'lease' in request &&+ request.lease === lease.lease+ ? await this.sendOverChannel(id, request)+ : { kind: 'relay' };+ await this.api.channelReply(generation, id, outcome).catch(() => {+ /* Main settles a retired or stale request itself. */+ });+ }+ private sendOverChannel(id: string, request: RemoteDesktopRequest): Promise<ChannelOutcome> {+ // Main never reuses an id; a duplicate is not sent twice.+ if (this.channelRequests.has(id)) return Promise.resolve({ kind: 'relay' });+ return new Promise((resolve) => {+ const timer = setTimeout(+ () => settle({ kind: 'error', code: 'INVOKE_TIMEOUT' }),+ REMOTE_DESKTOP_CHANNEL_TIMEOUT_MS,+ );+ const settle = (outcome: ChannelOutcome) => {+ if (this.channelRequests.get(id)?.settle !== settle) return;+ this.channelRequests.delete(id);+ clearTimeout(timer);+ resolve(outcome);+ };+ this.channelRequests.set(id, { op: request.op, settle });+ // The viewer answers with channelRequestState / channelReply.+ this.runtime.receive({ type: 'channelRequest', id, request });+ });+ }+ /** Requests ride the media peer. Once it is gone their outcome is unknown. */+ private abandonChannelRequests(): void {+ for (const pending of [...this.channelRequests.values()])+ pending.settle({ kind: 'error', code: 'INVOKE_TIMEOUT' });+ }private request = async <T>(request: RemoteDesktopRequest,beforeSend?: () => void,@@ -241,6 +320,7 @@ export class DesktopViewerController {});this.unlockAttempted = false;this.credentialRetry = null;+ this.rememberedGaveUp = false;if (scope.active)void (async () => {try {@@ -272,6 +352,7 @@ export class DesktopViewerController {this.clipboardQueued = 0;this.opening = false;this.streaming = false;+ this.abandonChannelRequests();this.media.reset();this.runtime?.receive({ type: 'releaseInput' });void this.session.stop().catch(() => {});@@ -285,6 +366,7 @@ export class DesktopViewerController {clipboardError: false,receiveRate: null,safety: { privacyActive: false, notice: null, clipboardProgress: null },+ fittedDisplay: null,});}private async connect(takeover = false): Promise<void> {@@ -302,6 +384,8 @@ export class DesktopViewerController {displayId: this.state.displayId || undefined,resume,takeover,+ // Desktop always operates; a host with `autoControl` grants it with the lease.+ control: true,isCurrent: () => this.epoch === epoch && !this.disposed && this.scope.active,onCapabilities: (caps) => this.publish({ caps }),onStart: () => {@@ -326,7 +410,11 @@ export class DesktopViewerController {});this.runtime.receive({ type: 'mode', mode: 'pointer' });if (!caps.canControl) throw new Error('DESKTOP_INPUT_UNSUPPORTED');- await this.acquireControl();+ if (lease.controlling) {+ this.publish({ error: null });+ this.syncControl();+ this.applySettings();+ } else await this.acquireControl();} catch (error) {if (epoch === this.epoch) this.fail(error);} finally {@@ -379,6 +467,7 @@ export class DesktopViewerController {this.clipboardRevision++;this.publish({ controlling });this.runtime.receive({ type: 'control', enabled: controlling });+ if (controlling) void this.applyRememberedResolution();}selectDisplay(displayId: string): void {if (@@ -617,46 +706,66 @@ export class DesktopViewerController {async permissionGuide(): Promise<void> {await this.request({ op: 'permissions', action: 'guide' });}- async displayModes() {+ async displayModes(): Promise<RemoteDesktopDisplayMode[]> {const lease = this.session.lease;if (!lease) return [];- const modes = await this.request<import('@cindy/device-link').RemoteDesktopDisplayMode[]>({+ const modes = await this.request<RemoteDesktopDisplayMode[]>({op: 'displayModes',lease: lease.lease,});if (this.session.lease !== lease) throw new Error('DESKTOP_STOPPED');+ if (this.hostMode?.lease !== lease.lease)+ this.hostMode = { lease: lease.lease, modeId: modes.find((mode) => mode.current)?.id };return modes;}- async resolution(modeId: string): Promise<void> {+ /** Choices for the resolution list. A picture fitted to this window offers+ * sizes of the same ratio instead of the physical monitor's modes; those keep+ * the monitor's own ratio so the picture is never letterboxed by the host. */+ async resolutionModes(): Promise<RemoteDesktopDisplayMode[]> {const lease = this.session.lease;- if (!lease) return;+ if (!lease) return [];+ if (this.state.fittedDisplay) return fittedDisplayModes(this.state.fittedDisplay, lease.display);+ const modes = await this.displayModes();+ // CoreGraphics modes keep their own orientation when Electron's display+ // geometry is rotated. Compare modes in the enumeration's coordinate space.+ const reference = modes.find((mode) => mode.current) ?? lease.display;+ return modes.filter((mode) => sameAspect(mode, reference.width, reference.height));+ }+ /** Applies an entry of the list just read; the host still rejects a stale mode. */+ async resolution(mode: RemoteDesktopDisplayMode): Promise<void> {+ if (!this.session.lease) return;+ const caps = this.state.caps;if (- this.state.caps?.resolutionRestore ||- (this.state.caps?.viewerDisplay && this.state.caps.viewerDisplayRestore)+ (caps?.resolutionRestore || (caps?.viewerDisplay && caps.viewerDisplayRestore)) &&+ (caps?.resolutionRestore ||+ [mode.width, mode.height].every((size) => size >= 320 && size <= 2560))) {- const mode = (await this.displayModes()).find((item) => item.id === modeId);- if (this.session.lease !== lease) return;- if (!mode) throw new Error('DESKTOP_DISPLAY_MODE_MISSING');- if (- this.state.caps?.resolutionRestore ||- [mode.width, mode.height].every((size) => size >= 320 && size <= 2560)- ) {- await this.fitDisplay(- mode.width,- mode.height,- true,- this.state.caps?.resolutionRestore ? mode.id : undefined,- );- return;- }+ await this.fitDisplay(+ mode.width,+ mode.height,+ true,+ !this.state.fittedDisplay && caps?.resolutionRestore ? mode.id : undefined,+ );+ return;}throw new Error('DESKTOP_DISPLAY_MODES_UNAVAILABLE');}+ /** Whether the fit button restores the computer's own display for this viewer size. */+ viewerDisplayMatched(width: number, height: number): boolean {+ const fitted = this.state.fittedDisplay;+ return Boolean(+ fitted &&+ this.state.caps?.viewerDisplayRestore &&+ this.session.lease &&+ sameAspect(fitted, width, height),+ );+ }async fitDisplay(width: number,height: number,exactResolution = false,modeId?: string,+ options: { viewport?: Size; remembered?: boolean } = {},): Promise<void> {if (exactResolution &&@@ -666,21 +775,51 @@ export class DesktopViewerController {throw new Error('DESKTOP_DISPLAY_MODE_MISSING');const size = exactResolution ? { width, height } : viewerDisplaySize(width, height);const lease = this.session.lease;+ const caps = this.state.caps;if (!size ||!lease?.controlling ||- !(modeId ? this.state.caps?.resolutionRestore : this.state.caps?.viewerDisplay) ||+ !(modeId ? caps?.resolutionRestore : caps?.viewerDisplay) ||this.state.controlPending)return;+ const fitted = this.state.fittedDisplay;+ // Fitting again at the ratio already fitted restores the computer's display.+ const restore = Boolean(+ !exactResolution && fitted && caps?.viewerDisplayRestore && sameAspect(fitted, width, height),+ );this.publish({ controlPending: true });this.syncControl();- this.media.reset();+ // A host that can follow display changes keeps the running stream; only a+ // response without `videoKept` falls back to rebuilding it.+ const keepVideo = caps?.liveDisplaySwitch === true;+ if (!keepVideo) this.media.reset();const sourceDisplayId = this.state.displayId;try {- const next = await this.session.fitDisplay(size.width, size.height, false, modeId);+ const { videoKept, ...next } = await this.session.fitDisplay(+ size.width,+ size.height,+ restore,+ modeId,+ keepVideo,+ caps?.autoControl === true,+ );if (this.session.lease !== lease) return;- const caps = this.state.caps;+ // The next connection reapplies this choice; restoring or choosing the+ // computer's own mode again forgets it. A fit remembers the requested+ // size: a HiDPI host may answer with a smaller mode of the same ratio.+ const ownMode = this.hostMode?.lease === lease.lease && this.hostMode.modeId === modeId;+ void this.rememberResolution(+ sourceDisplayId,+ restore || (modeId && ownMode)+ ? null+ : modeId+ ? { kind: 'mode', modeId, width, height }+ : { kind: 'fit', width: size.width, height: size.height },+ );+ const fittedBase = options.viewport+ ? viewerDisplaySize(options.viewport.width, options.viewport.height)+ : null;this.publish({// Keep the physical source as the reconnect target; the temporary// display is only the current capture/input surface.@@ -688,17 +827,33 @@ export class DesktopViewerController {// The temporary capture surface is lease state, never a reconnectable// display choice in the selector.caps,+ // Same-ratio sizes stay around the plain fit of the viewer.+ fittedDisplay:+ modeId || restore+ ? null+ : exactResolution && (fitted ?? fittedBase)+ ? (fitted ?? fittedBase)+ : { width: next.display.width, height: next.display.height },});- this.streaming = false;- this.runtime.receive({- type: 'videoSettings',+ const geometry = {width: next.display.width,height: next.display.height,- ...(modeId ? { restore: true } : {}),- audio: this.state.settings.audio && this.state.caps?.systemAudio === true,- });- await this.session.control(true);+ restore: restore || Boolean(modeId),+ };+ if (videoKept) this.runtime.receive({ type: 'displayGeometry', ...geometry });+ else {+ if (keepVideo) this.media.reset();+ this.streaming = false;+ this.abandonChannelRequests();+ this.runtime.receive({+ type: 'videoSettings',+ ...geometry,+ audio: this.state.settings.audio && this.state.caps?.systemAudio === true,+ });+ }+ if (!next.controlling) await this.session.control(true);} catch (error) {+ if (options.remembered) this.rememberedGaveUp = true;if (error instanceof Error && error.message === 'INVOKE_TIMEOUT') {this.cancel(true);void this.connect();@@ -711,6 +866,77 @@ export class DesktopViewerController {}}}+ private async rememberResolution(+ displayId: string,+ value: RememberedViewerResolution | null,+ ): Promise<void> {+ try {+ await this.api.resolution?.(this.scope.generation, displayId, value);+ } catch {+ /* Memory is a convenience; the change itself already applied. */+ }+ }+ /** The host restores its own display when a viewer leaves. Reapply this+ * window's last choice once per lease, after control and the first frame. */+ private async applyRememberedResolution(): Promise<void> {+ const lease = this.session.lease;+ const caps = this.state.caps;+ if (+ !lease ||+ !this.state.ready ||+ !this.state.controlling ||+ !this.api.resolution ||+ !(caps?.resolutionRestore || caps?.viewerDisplay) ||+ this.state.fittedDisplay ||+ this.rememberedGaveUp ||+ this.rememberedLease === lease.lease+ )+ return;+ this.rememberedLease = lease.lease;+ const displayId = this.state.displayId;+ const { id, width, height } = lease.display;+ // A display change the user made meanwhile wins over the remembered one.+ const unchanged = () =>+ this.session.lease === lease &&+ lease.display.id === id &&+ lease.display.width === width &&+ lease.display.height === height &&+ !this.state.fittedDisplay;+ try {+ const remembered = await this.api.resolution(this.scope.generation, displayId);+ if (!remembered) return;+ // A locked computer refuses display changes; let auto-unlock run first.+ await this.unlockAttempt;+ if (!unchanged()) return;+ if (remembered.kind === 'fit') {+ if (!caps.viewerDisplay) return;+ // Same path as the button: measure this window now, then fit at the+ // remembered size if it is one of the same-ratio choices.+ const viewport = { width: this.root.clientWidth, height: this.root.clientHeight };+ const base = viewerDisplaySize(viewport.width, viewport.height);+ const edge = Math.max(remembered.width, remembered.height);+ const exact = base+ ? fittedDisplayModes(base, base).find((mode) => Math.max(mode.width, mode.height) === edge)+ : undefined;+ if (exact)+ await this.fitDisplay(exact.width, exact.height, true, undefined, {+ viewport,+ remembered: true,+ });+ else+ await this.fitDisplay(viewport.width, viewport.height, false, undefined, {+ remembered: true,+ });+ return;+ }+ if (!caps.resolutionRestore) return;+ const mode = findRememberedMode(await this.resolutionModes(), remembered);+ if (!mode || mode.current || !unchanged()) return;+ await this.fitDisplay(mode.width, mode.height, true, mode.id, { remembered: true });+ } catch {+ /* A failed reapply leaves the computer's own display in place. */+ }+ }private async heartbeat(): Promise<void> {if (!this.scope.active || this.disposed || this.state.closing) return;if (!this.session.lease) {@@ -822,9 +1048,32 @@ export class DesktopViewerController {case 'fallback':this.mediaChanging = false;this.streaming = false;+ this.abandonChannelRequests();this.publish({ transport: 'screenshots', status: 'compatibility', latency: null });this.applySettings();break;+ case 'channelRequestState':+ // The channel could not take it: nothing ran, use the relay.+ if (typeof message.id === 'string' && message.sent !== true)+ this.channelRequests.get(message.id)?.settle({ kind: 'relay' });+ break;+ case 'channelReply': {+ const reply = parseRemoteDesktopChannelReply({ ...message, type: 'reply' });+ const pending = reply && this.channelRequests.get(reply.id);+ if (!reply || !pending) break;+ if (reply.ok) pending.settle({ kind: 'result', value: reply.result });+ else+ pending.settle(+ // Refused before running, or a read-only result that did not fit.+ reply.error === 'DESKTOP_CHANNEL_UNSUPPORTED' ||+ reply.error === 'DESKTOP_CHANNEL_BUSY' ||+ (reply.error === 'DESKTOP_REPLY_TOO_LARGE' &&+ (pending.op === 'displayModes' || pending.op === 'clipboardVersion'))+ ? { kind: 'relay' }+ : { kind: 'error', code: reply.error },+ );+ break;+ }case 'reconnecting':this.publish({ status: 'reconnecting' });break;@@ -890,13 +1139,15 @@ export class DesktopViewerController {if (status === 'live') this.mediaChanging = false;this.retryDelay = 1000;this.publish({ ready: true, status });- this.syncControl();- this.applySettings();- void this.refreshSafety();+ // Start auto-unlock before control can trigger the remembered display+ // change, which waits for it: a locked computer refuses display changes.if (!this.unlockAttempted && this.state.caps?.platform === 'darwin') {this.unlockAttempted = true;- void this.credential('unlock');+ this.unlockAttempt = this.credential('unlock').catch(() => {});}+ this.syncControl();+ this.applySettings();+ void this.refreshSafety();}dispose(): void {this.cancel();diff --git a/apps/desktop/src/renderer/i18n/locales/en/common.json b/apps/desktop/src/renderer/i18n/locales/en/common.jsonindex 2aa9fdcb56..5162ce8e58 100644--- a/apps/desktop/src/renderer/i18n/locales/en/common.json+++ b/apps/desktop/src/renderer/i18n/locales/en/common.json@@ -320,6 +320,7 @@"disconnectFailed": "Could not disconnect. Try again.","clipboardShortcutHint": "Use {{modifier}}+C / {{modifier}}+V in the picture to copy and paste. Supported content depends on the remote computer; files are not transferred.","fitViewerDisplay": "Match Current View",+ "restoreViewerDisplay": "Restore Original Aspect Ratio","fitViewerDisplayHint": "Temporarily adjusts the computer desktop to this view’s aspect ratio, keeping its contents. Disconnect to restore the original resolution.","resolutionHint": "Resolution changes affect the actual remote monitor."},diff --git a/apps/desktop/src/renderer/i18n/locales/ja/common.json b/apps/desktop/src/renderer/i18n/locales/ja/common.jsonindex 1a0265441a..00b296f0a9 100644--- a/apps/desktop/src/renderer/i18n/locales/ja/common.json+++ b/apps/desktop/src/renderer/i18n/locales/ja/common.json@@ -320,6 +320,7 @@"disconnectFailed": "切断できませんでした。もう一度お試しください。","clipboardShortcutHint": "画面内で {{modifier}}+C / {{modifier}}+V を使ってコピー・貼り付けできます。対応する内容は接続先のパソコンによって異なります。ファイルは転送されません。","fitViewerDisplay": "現在の画面比率に合わせる",+ "restoreViewerDisplay": "元の縦横比に戻す","fitViewerDisplayHint": "デスクトップの内容を保ったまま、パソコンの画面比率を一時的に変更します。切断すると元の解像度に戻ります。","resolutionHint": "解像度の変更はリモートの実際のモニターに反映されます。"},diff --git a/apps/desktop/src/renderer/i18n/locales/ko/common.json b/apps/desktop/src/renderer/i18n/locales/ko/common.jsonindex b3a55213f8..0ab8bf3202 100644--- a/apps/desktop/src/renderer/i18n/locales/ko/common.json+++ b/apps/desktop/src/renderer/i18n/locales/ko/common.json@@ -320,6 +320,7 @@"disconnectFailed": "연결을 끊지 못했습니다. 다시 시도하세요.","clipboardShortcutHint": "화면 안에서 {{modifier}}+C / {{modifier}}+V로 복사하고 붙여넣으세요. 지원되는 내용은 원격 컴퓨터에 따라 다르며 파일은 전송되지 않습니다.","fitViewerDisplay": "현재 화면 비율에 맞추기",+ "restoreViewerDisplay": "원래 화면 비율로 복원","fitViewerDisplayHint": "데스크톱 내용을 유지하면서 컴퓨터 화면 비율을 일시적으로 변경합니다. 연결을 종료하면 원래 해상도로 돌아갑니다.","resolutionHint": "해상도를 변경하면 원격 컴퓨터의 실제 모니터에 적용됩니다."},diff --git a/apps/desktop/src/renderer/i18n/locales/zh-CN/common.json b/apps/desktop/src/renderer/i18n/locales/zh-CN/common.jsonindex 6a889fcce1..f181e824d9 100644--- a/apps/desktop/src/renderer/i18n/locales/zh-CN/common.json+++ b/apps/desktop/src/renderer/i18n/locales/zh-CN/common.json@@ -320,6 +320,7 @@"disconnectFailed": "未能断开连接,请重试。","clipboardShortcutHint": "在画面内使用 {{modifier}}+C / {{modifier}}+V 复制粘贴。支持的内容取决于远程电脑,暂不传输文件。","fitViewerDisplay": "按当前画面比例调整",+ "restoreViewerDisplay": "恢复原始比例","fitViewerDisplayHint": "临时调整电脑桌面比例,保留当前桌面内容。退出连接后恢复原分辨率。","resolutionHint": "分辨率修改会影响远端的实际显示器。"},diff --git a/apps/desktop/src/renderer/i18n/locales/zh-TW/common.json b/apps/desktop/src/renderer/i18n/locales/zh-TW/common.jsonindex 954d15eb68..730818ba56 100644--- a/apps/desktop/src/renderer/i18n/locales/zh-TW/common.json+++ b/apps/desktop/src/renderer/i18n/locales/zh-TW/common.json@@ -320,6 +320,7 @@"disconnectFailed": "無法中斷連線,請重試。","clipboardShortcutHint": "在畫面內使用 {{modifier}}+C / {{modifier}}+V 複製貼上。支援的內容取決於遠端電腦,暫不傳輸檔案。","fitViewerDisplay": "依目前畫面比例調整",+ "restoreViewerDisplay": "恢復原始比例","fitViewerDisplayHint": "暫時調整電腦桌面比例,保留目前桌面內容。離開連線後恢復原解析度。","resolutionHint": "解析度修改會影響遠端的實際顯示器。"},diff --git a/apps/desktop/src/shared/remoteDesktopViewer.ts b/apps/desktop/src/shared/remoteDesktopViewer.tsindex d39a275203..c71e94e19a 100644--- a/apps/desktop/src/shared/remoteDesktopViewer.ts+++ b/apps/desktop/src/shared/remoteDesktopViewer.ts@@ -19,6 +19,9 @@ export const REMOTE_VIEWER = {PREFERENCES: 'remote-desktop-viewer:preferences',SAFETY: 'remote-desktop-viewer:safety',CREDENTIAL: 'remote-desktop-viewer:credential',+ RESOLUTION: 'remote-desktop-viewer:resolution',+ CHANNEL_REQUEST: 'remote-desktop-viewer:channel-request',+ CHANNEL_REPLY: 'remote-desktop-viewer:channel-reply',} as const;export interface RemoteViewerTarget {@@ -51,6 +54,50 @@ export interface RemoteViewerSafety {notice: string | null;clipboardProgress: number | null;}+/**+ * The last display choice for one monitor of the target computer. `mode` is a+ * system resolution; `fit` is the requested size of a picture fitted to the+ * viewer window, reapplied at the window's current ratio on the next connection.+ */+export type RememberedViewerResolution =+ | { kind: 'mode'; modeId: string; width: number; height: number }+ | { kind: 'fit'; width: number; height: number };++export function parseRememberedViewerResolution(value: unknown): RememberedViewerResolution | null {+ if (!value || typeof value !== 'object' || Array.isArray(value)) return null;+ const v = value as Record<string, unknown>;+ const size = [v.width, v.height];+ if (!size.every((n) => Number.isInteger(n) && (n as number) >= 320 && (n as number) <= 8192))+ return null;+ const width = v.width as number,+ height = v.height as number;+ if (v.kind === 'mode' && typeof v.modeId === 'string' && v.modeId.length > 0 && v.modeId.length <= 256)+ return { kind: 'mode', modeId: v.modeId, width, height };+ return v.kind === 'fit' && width <= 2560 && height <= 2560 ? { kind: 'fit', width, height } : null;+}++/** A request Main asks the viewer window to send over its live media data channel. */+export interface RemoteViewerChannelRequest {+ generation: number;+ id: string;+ request: RemoteDesktopRequest;+}+/** How a channel request ended; `relay` means it was never sent, so Main may use the relay. */+export type RemoteViewerChannelOutcome =+ | { kind: 'result'; value: unknown }+ | { kind: 'relay' }+ | { kind: 'error'; code: string };++export function parseRemoteViewerChannelOutcome(value: unknown): RemoteViewerChannelOutcome | null {+ if (!value || typeof value !== 'object' || Array.isArray(value)) return null;+ const v = value as Record<string, unknown>;+ if (v.kind === 'relay') return { kind: 'relay' };+ if (v.kind === 'result') return { kind: 'result', value: v.value };+ return v.kind === 'error' && typeof v.code === 'string' && /^[A-Z][A-Z0-9_]{0,63}$/.test(v.code)+ ? { kind: 'error', code: v.code }+ : null;+}+export interface RemoteViewerCredentialState {available: boolean;autoUnlock: boolean;@@ -83,6 +130,15 @@ export interface RemoteDesktopViewerApi {patch?: Partial<RemoteViewerPreferences>,): Promise<RemoteViewerPreferences>;safety?(generation: number, retry?: boolean): Promise<RemoteViewerSafety>;+ /** Main routes channel-eligible requests through the window's media data channel. */+ onChannelRequest?(listener: (request: RemoteViewerChannelRequest) => void): () => void;+ channelReply?(generation: number, id: string, outcome: RemoteViewerChannelOutcome): Promise<void>;+ /** Reads the remembered choice for a monitor; a second argument replaces it (`null` forgets). */+ resolution?(+ generation: number,+ displayId: string,+ value?: RememberedViewerResolution | null,+ ): Promise<RememberedViewerResolution | null>;credential?(generation: number,action: 'settings' | 'enable' | 'disable' | 'unlock' | 'biometric',diff --git a/apps/mobile/src/remote-desktop/RemoteDesktopScreen.tsx b/apps/mobile/src/remote-desktop/RemoteDesktopScreen.tsxindex 8209933819..b7c3ee6573 100644--- a/apps/mobile/src/remote-desktop/RemoteDesktopScreen.tsx+++ b/apps/mobile/src/remote-desktop/RemoteDesktopScreen.tsx@@ -337,7 +337,12 @@ export function RemoteDesktopSession({const [viewerReadyRevision, setViewerReadyRevision] = useState(0);const active = useRef<RemoteDesktopLease | null>(null);const wantsControl = useRef(true);+ // View only is a local guard against stray touches. The host keeps control+ // and its input helper, so switching never waits for the computer.const [viewOnlySelected, setViewOnlySelected] = useState(false);+ const viewOnlyRef = useRef(false);+ /** Input reaches the computer only with host control and outside view only. */+ const inputAllowed = (controlling: boolean) => controlling && !viewOnlyRef.current;// Last control bit we asked the host for but have not confirmed. Overflow and// take-control can time out after the local bit already moved; heartbeats use// this to retry a release or restore local control instead of ignoring host-true.@@ -443,7 +448,8 @@ export function RemoteDesktopSession({);const [busy, setBusy] = useState(false);const [inputMode, setInputMode] = useInputModePreference();- const mode: Mode = lease?.controlling ? inputMode : "pan";+ const canInput = Boolean(lease?.controlling) && !viewOnlySelected;+ const mode: Mode = canInput ? inputMode : "pan";const [operations, setOperations] = useState(false);const [controlPage, setControlPage] = useState<"controls" | "display" | "security"@@ -557,8 +563,7 @@ export function RemoteDesktopSession({(event: { nativeEvent: { data: string } }) => void>(() => {});useEffect(() => {- const enabled =- keyboard && !fullKeys && focused && Boolean(lease?.controlling);+ const enabled = keyboard && !fullKeys && focused && canInput;if (!enabled) {send({ type: "keyboard", enabled: false });Keyboard.dismiss();@@ -568,14 +573,7 @@ export function RemoteDesktopSession({// focus to a web animation frame loses WebKit's user-interaction context.webview.current?.requestFocus();send({ type: "keyboard", enabled: true });- }, [- keyboard,- fullKeys,- focused,- lease?.controlling,- keyboardFocusRequest,- send,- ]);+ }, [keyboard, fullKeys, focused, canInput, keyboardFocusRequest, send]);// Small control requests ride the media data channel when the host supports// it: a direct peer avoids the relay round trip and keeps their order with// input. Anything the channel did not take uses the relay; once sent, the@@ -1005,7 +1003,7 @@ export function RemoteDesktopSession({// The shared session may already have mutated this lease before returning.// Always publish the confirmation to React's separate snapshot as well.if (alive.current) setLease({ ...current });- send({ type: "control", enabled: controlling });+ send({ type: "control", enabled: inputAllowed(controlling) });};const requestHostControl = (current: RemoteDesktopLease,@@ -1108,6 +1106,8 @@ export function RemoteDesktopSession({displayId: displayId ?? recovery.current.displayId,resume: resuming,takeover,+ // Hosts with `autoControl` grant control with the lease.+ control: wantsControl.current,onStart: () => {recovery.current.resuming = true;},@@ -1207,14 +1207,15 @@ export function RemoteDesktopSession({send({ type: "mode", mode });// Entering remote desktop is the user's intent to control. The existing// host permission and ownership gates still decide whether it is allowed.- if (result.canControl && wantsControl.current) {+ if (next.controlling) send({ type: "control", enabled: inputAllowed(true) });+ else if (result.canControl && wantsControl.current) {try {const control = await viewerSession.current!.control(true);if (current !== generation.current) return;// Control changes keep the same session identity for in-flight replies.next.controlling = control.controlling;setLease({ ...next });- send({ type: "control", enabled: control.controlling });+ send({ type: "control", enabled: inputAllowed(control.controlling) });} catch (cause) {if (current === generation.current) resolveControlFailure(cause);}@@ -1643,7 +1644,7 @@ export function RemoteDesktopSession({focused &&!operations &&!keyboard &&- Boolean(lease?.controlling),+ canInput,labels: {left: t("remoteDesktop.leftClick"),right: t("remoteDesktop.rightClick"),@@ -1666,7 +1667,7 @@ export function RemoteDesktopSession({operations,keyboard,lease?.lease,- lease?.controlling,+ canInput,send,t,]);@@ -2137,9 +2138,18 @@ export function RemoteDesktopSession({epoch: current.lease,sequence: message.sequence,};+ // Entering view only sends one release batch: it must reach the host+ // (which keeps control) even while an older batch is still in flight.+ const releaseOnly =+ Array.isArray(message.events) &&+ message.events.length > 0 &&+ message.events.every(+ (event) => isDesktopInput(event) && event.kind === "release",+ );if (!current.controlling ||- inputBusy.current?.lease === current.lease ||+ (viewOnlyRef.current && !releaseOnly) ||+ (!releaseOnly && inputBusy.current?.lease === current.lease) ||!Number.isSafeInteger(message.sequence) ||!Array.isArray(message.events) ||message.events.length > 64 ||@@ -2149,8 +2159,10 @@ export function RemoteDesktopSession({return;}const batch = { lease: current.lease };- inputBusy.current = batch;- const ownsBatch = () => active.current === current && inputBusy.current === batch;+ if (!releaseOnly) inputBusy.current = batch;+ const ownsBatch = () =>+ active.current === current &&+ (releaseOnly || inputBusy.current === batch);const events = message.events;void (async () => {if (@@ -2158,7 +2170,13 @@ export function RemoteDesktopSession({(await nativeViewer.current?.sendInput(message).catch(() => false)))return;- if (!ownsBatch() || !current.controlling) return;+ // View only may have started while the native attempt was pending.+ if (+ !ownsBatch() ||+ !current.controlling ||+ (viewOnlyRef.current && !releaseOnly)+ )+ return;await request({op: "input",lease: current.lease,@@ -2172,7 +2190,7 @@ export function RemoteDesktopSession({}).finally(() => {if (!ownsBatch()) return;- inputBusy.current = null;+ if (!releaseOnly) inputBusy.current = null;send(ack);});break;@@ -2189,9 +2207,26 @@ export function RemoteDesktopSession({presentationTimer.current)return;- setBusy(true);setError(null);- controlInFlight.current = true;+ const viewOnly = !viewOnlySelected;+ viewOnlyRef.current = viewOnly;+ setViewOnlySelected(viewOnly);+ if (viewOnly) {+ // Local only: stop forwarding and release held keys and buttons on the+ // host, which keeps control and its input helper.+ heldKeys.current.clear();+ setModifiers([]);+ setKeyboard(false);+ send({ type: "control", enabled: false, release: true });+ return;+ }+ if (current.controlling) {+ send({ type: "control", enabled: true });+ return;+ }+ // The host dropped control meanwhile (input failure, overflow or+ // background viewing): leaving view only asks for it again.+ setBusy(true);try {pipPrepared.current = false;presentationGeneration.current++;@@ -2200,11 +2235,8 @@ export function RemoteDesktopSession({presentation.current = false;send({ type: "presentation", enabled: false });}- send({ type: "control", enabled: false });- const enabled = viewOnlySelected;- setViewOnlySelected(!enabled);- wantsControl.current = enabled;- if (pendingHostControl.current === false && enabled) {+ wantsControl.current = true;+ if (pendingHostControl.current === false) {// Overflow timed out with an unconfirmed host release. Taking control// first would skip stopInput while a key/button may still be held.const released = await request<{ controlling: boolean }>({@@ -2216,21 +2248,13 @@ export function RemoteDesktopSession({applyConfirmedControl(current, released.controlling);if (released.controlling) return;}- pendingHostControl.current = enabled;- const result = await request<{ controlling: boolean }>({- op: "control",- lease: current.lease,- enabled,- });- if (active.current !== current) return;- applyConfirmedControl(current, result.controlling);+ await requestHostControl(current, true);} catch (cause) {// Taking control can fail because this computer cannot inject input right- // now. Stay in view only and let the user retry; a session rebuild would- // cost the picture and the lease for a control-only fault.+ // now. Stay usable for viewing and let the user retry; a session rebuild+ // would cost the picture and the lease for a control-only fault.if (active.current === current) resolveControlFailure(cause);} finally {- controlInFlight.current = false;if (alive.current) setBusy(false);}};@@ -2621,6 +2645,7 @@ export function RemoteDesktopSession({restore,modeId,keepVideo,+ caps?.autoControl === true,);if (active.current !== current) return;// Reconnect the physical source display after the temporary mirror ends.@@ -2687,7 +2712,10 @@ export function RemoteDesktopSession({audio: Boolean(caps?.systemAudio && videoSettingsRef.current.audio),});}- const control = await viewerSession.current.control(true);+ // A host with `autoControl` already restarted input on the new geometry.+ const control = next.controlling+ ? { controlling: true }+ : await viewerSession.current.control(true);if (active.current === current)applyConfirmedControl(current, control.controlling);} catch (cause) {@@ -2773,7 +2801,9 @@ export function RemoteDesktopSession({if (mode.current) return false;modeId = mode.id;}- const control = await viewerSession.current.control(true);+ const control = current.controlling+ ? { controlling: true }+ : await viewerSession.current.control(true);if (!isCurrent() || !control.controlling) return false;displayChangeSent = true;await viewerSession.current.fitDisplay(@@ -2781,6 +2811,8 @@ export function RemoteDesktopSession({remembered.height,false,modeId,+ false,+ hostCaps.autoControl === true,);if (!isCurrent()) return false;rememberedResolutionLease.current = current.lease;@@ -2880,7 +2912,7 @@ export function RemoteDesktopSession({const workspaceAction = (action: "workspaceLeft" | "workspaceRight" | "omarchyMenu",) => {- if (!lease?.controlling) return;+ if (!lease || !canInput) return;const current = active.current;void request({ op: "windowAction", action, lease: lease.lease }).catch(() => {@@ -2945,7 +2977,7 @@ export function RemoteDesktopSession({pressed && styles.keyPressed,]}onPressIn={() => {- if (!active.current?.controlling) return;+ if (!inputAllowed(Boolean(active.current?.controlling))) return;const alreadyHeld = new Set([...heldKeys.current.values()].flat());const keys = comboMode ? [...modifiers, code] : [code];heldKeys.current.set(code, keys);@@ -3081,7 +3113,7 @@ export function RemoteDesktopSession({focused &&!operations &&!keyboard &&- lease?.controlling && (+ canInput && (<RemoteDesktopMouseControlssend={send}bottom={landscape ? 0 : toolbarSize.height}@@ -3228,7 +3260,8 @@ export function RemoteDesktopSession({)}{windowsOpen &&focused &&- lease?.controlling &&+ lease &&+ canInput &&caps?.windowActions && (<RemoteDesktopWindowskey={lease.lease}@@ -3367,8 +3400,8 @@ export function RemoteDesktopSession({<View testID="remoteDesktop.foldControls" style={{ position: 'absolute', left: foldControls.x,top: foldControls.y, width: foldControls.width, height: foldControls.height,paddingBottom: toolbarSize.height + (showMouseButtons ? 80 : 0) }}>- <FoldTouchpad send={send} enabled={Boolean(lease?.controlling)} />- {showMouseButtons && lease?.controlling ? <RemoteDesktopMouseControls send={send}+ <FoldTouchpad send={send} enabled={canInput} />+ {showMouseButtons && canInput ? <RemoteDesktopMouseControls send={send}bottom={toolbarSize.height} right={0} compact labels={{ left: t("remoteDesktop.leftClick"),right: t("remoteDesktop.rightClick"), wheel: t("remoteDesktop.mouseWheel") }} /> : null}</View>@@ -3458,7 +3491,7 @@ export function RemoteDesktopSession({? () => workspaceAction("omarchyMenu"): undefined}- canControl={Boolean(lease?.controlling)}+ canControl={canInput}keyboard={keyboard}operations={operations}onWindows={() => {@@ -3476,7 +3509,7 @@ export function RemoteDesktopSession({);}}onDesktop={() =>- caps?.windowActions && lease?.controlling+ caps?.windowActions && lease && canInput? void request({op: "windowAction",action: "desktop",@@ -3572,7 +3605,7 @@ export function RemoteDesktopSession({><View style={styles.keyboardHeader}><RemoteDesktopClipboardButton- enabled={!connectionPending && Boolean(lease?.controlling)}+ enabled={!connectionPending && canInput}supported={caps?.clipboardText === true}transfer={transferClipboard}/>@@ -3672,7 +3705,7 @@ export function RemoteDesktopSession({onPressIn={() => {if (comboMode ||- !active.current?.controlling ||+ !inputAllowed(Boolean(active.current?.controlling)) ||heldKeys.current.has(code))return;@@ -3691,7 +3724,8 @@ export function RemoteDesktopSession({});}}onPress={() => {- if (!comboMode || !active.current?.controlling) return;+ if (!comboMode || !inputAllowed(Boolean(active.current?.controlling)))+ return;setModifiers((previous) =>previous.includes(code)? previous.filter((v) => v !== code)diff --git a/apps/mobile/src/remote-desktop/__tests__/screen.test.tsx b/apps/mobile/src/remote-desktop/__tests__/screen.test.tsxindex 91409e23d7..686a219334 100644--- a/apps/mobile/src/remote-desktop/__tests__/screen.test.tsx+++ b/apps/mobile/src/remote-desktop/__tests__/screen.test.tsx@@ -712,12 +712,20 @@ describe("remote desktop controls", () => {: Promise.resolve(),);}- if (reason === "control-busy" || reason === "settings-busy") {- act(() => button("operations").click());+ if (reason === "control-busy") {+ // View only is local; an overflow release keeps a host request in flight.await act(async () =>- button(reason === "control-busy" ? "viewOnly" : "sound").click(),+ fixture.message!({+ nativeEvent: {+ data: JSON.stringify({ type: "inputOverflow", epoch: "lease" }),+ },+ }),);expect(finish).toBeDefined();+ } else if (reason === "settings-busy") {+ act(() => button("operations").click());+ await act(async () => button("sound").click());+ expect(finish).toBeDefined();}await act(async () => render(false));expect(onEnded).toHaveBeenCalledOnce();@@ -975,18 +983,15 @@ describe("remote desktop controls", () => {await web("presentation", { active: false });await web("presentation", { active: false });expect(fixture.pipEnabled).toBe(true);- if (controlling) {- expect(- requests().filter((r) => r.op === "control" && r.enabled),- ).toHaveLength(1);- } else {- expect(- requests().filter((r) => r.op === "control" && r.enabled),- ).toHaveLength(0);- expect(- requests().filter((r) => r.op === "presentation" && !r.enabled),- ).toHaveLength(1);- }+ // View only is local: the host gets control back either way, while a+ // view-only phone keeps its input switched off.+ expect(+ requests().filter((r) => r.op === "control" && r.enabled),+ ).toHaveLength(1);+ expect(sent().filter((m) => m.type === "control").at(-1)).toEqual({+ type: "control",+ enabled: controlling,+ });expect(requests().filter((r) => r.op === "stop")).toHaveLength(0);},);@@ -1105,9 +1110,11 @@ describe("remote desktop controls", () => {).toMatchObject({ enabled: true });act(() => button("operations").click());await act(async () => button("viewOnly").click());+ // View only is local; it never asks the host.expect(requests().filter((r) => r.op === "control")).toHaveLength(- before + 2,+ before + 1,);+ expect(button("viewOnly").getAttribute("aria-selected")).toBe("true");});it.each([true, false])("restores the prior control choice (%s) when a Home gesture is cancelled during preparation",@@ -1142,8 +1149,9 @@ describe("remote desktop controls", () => {expect(button("viewOnly").getAttribute("aria-selected")).toBe(String(!controlling),);+ // View only is local, so the host regains control either way.expect(requests().filter((r) => r.op === "control")).toHaveLength(- before + Number(controlling),+ before + 1,);expect(sent().filter((m) => m.type === "presentation" && m.enabled),@@ -1448,13 +1456,15 @@ describe("remote desktop controls", () => {fixture.post.mockClear();};const relayedControl = () => requests().filter((r) => r.op === "control");+ // View only is local now; an overflow release still asks the host.+ const release = () => viewer({ type: "inputOverflow" });const channelRequest = () =>sent().findLast((m) => m.type === "channelRequest");it("sends control over the WebView channel and settles from its reply", async () => {withChannel(true);await live();- await act(async () => button("viewOnly").click());+ await release();expect(channelRequest()).toMatchObject({request: { op: "control", lease: "lease", enabled: false },});@@ -1470,7 +1480,6 @@ describe("remote desktop controls", () => {ok: true,result: { controlling: false },});- expect(button("viewOnly").getAttribute("aria-selected")).toBe("true");expect(relayedControl()).toEqual([]);});@@ -1494,7 +1503,7 @@ describe("remote desktop controls", () => {])("uses the relay when %s", async (_name, answer) => {withChannel(true);await live();- await act(async () => button("viewOnly").click());+ await release();await viewer({ ...answer, id: channelRequest().id });expect(relayedControl()).toEqual([{ op: "control", lease: "lease", enabled: false },@@ -1504,7 +1513,7 @@ describe("remote desktop controls", () => {it("never replays a request the channel already took", async () => {withChannel(true);await live();- await act(async () => button("viewOnly").click());+ await release();await viewer({type: "channelRequestState",id: channelRequest().id,@@ -1523,13 +1532,13 @@ describe("remote desktop controls", () => {it("settles a sent request when the media falls back, without replaying it", async () => {withChannel(true);await live();- await act(async () => button("viewOnly").click());+ await release();const first = channelRequest().id;await viewer({ type: "channelRequestState", id: first, sent: true });await viewer({ type: "fallback", reason: "failed" });- // The switch is free again right away and the next one uses the relay;+ // Control is free again right away and the next release uses the relay;// the request the channel took is never sent twice.- await act(async () => button("viewOnly").click());+ await release();expect(relayedControl().filter((r) => r.enabled === false)).toHaveLength(1,);@@ -1539,7 +1548,7 @@ describe("remote desktop controls", () => {it("keeps the relay for hosts without the capability or before video", async () => {withChannel(false);await live();- await act(async () => button("viewOnly").click());+ await release();expect(sent().some((m) => m.type === "channelRequest")).toBe(false);expect(relayedControl()).toHaveLength(1);});@@ -1564,7 +1573,7 @@ describe("remote desktop controls", () => {act(() => button("operations").click());fixture.invoke.mockClear();fixture.post.mockClear();- await act(async () => button("viewOnly").click());+ await release();const native = fixture.nativeRequest.mock.calls.at(-1)?.[0] as {id: string;epoch: string;@@ -1588,8 +1597,9 @@ describe("remote desktop controls", () => {},}),);- expect(button("viewOnly").getAttribute("aria-selected")).toBe("true");fixture.nativeRequest.mockResolvedValue(false);+ // Leaving view only asks the host again once it no longer controls.+ await act(async () => button("viewOnly").click());await act(async () => button("viewOnly").click());expect(channelRequest()).toMatchObject({request: { op: "control", lease: "lease", enabled: true },@@ -4450,6 +4460,18 @@ describe("remote desktop controls", () => {expect(requests().filter((r) => r.op === "stop")).toHaveLength(0);expect(host.textContent).not.toContain("remoteDesktop.reconnecting");});+ /** The host drops control (overflow release); the phone then enters view only. */+ const dropHostControl = async () => {+ await act(async () => {+ fixture.message!({+ nativeEvent: {+ data: JSON.stringify({ type: "inputOverflow", epoch: "lease" }),+ },+ });+ });+ act(() => button("operations").click());+ await act(async () => button("viewOnly").click());+ };it("finishes a timed-out overflow release before taking control again", async () => {await connect();const original = fixture.invoke.getMockImplementation()!;@@ -4478,14 +4500,16 @@ describe("remote desktop controls", () => {requests().filter((r) => r.op === "control" && r.enabled === false),).toHaveLength(1);act(() => button("operations").click());+ // Entering view only is local and leaves the pending release alone.await act(async () => button("viewOnly").click());- const controlOps = requests()- .filter((r) => r.op === "control")- .map((r) => r.enabled);- // Overflow timed out with pending release. Take control must finish that- // release (host stopInput) before asking to enable, so the helper restarts.- expect(controlOps).toEqual([true, false, false]);+ expect(+ requests()+ .filter((r) => r.op === "control")+ .map((r) => r.enabled),+ ).toEqual([true, false]);expect(button("viewOnly").getAttribute("aria-selected")).toBe("true");+ // Overflow timed out with pending release. Taking control must finish that+ // release (host stopInput) before asking to enable, so the helper restarts.await act(async () => button("viewOnly").click());expect(requests()@@ -4505,8 +4529,7 @@ describe("remote desktop controls", () => {});it("restores control when a take-control reply is lost but the host still holds it", async () => {await connect();- act(() => button("operations").click());- await act(async () => button("viewOnly").click());+ await dropHostControl();const original = fixture.invoke.getMockImplementation()!;fixture.invoke.mockImplementation((...args) => {const req = args[2][0];@@ -4525,6 +4548,7 @@ describe("remote desktop controls", () => {).toEqual({type: "control",enabled: false,+ release: true,});await act(async () => vi.advanceTimersByTimeAsync(3000));expect(@@ -4540,8 +4564,7 @@ describe("remote desktop controls", () => {});it("keeps a take-control intent when a settling heartbeat still reports view-only", async () => {await connect();- act(() => button("operations").click());- await act(async () => button("viewOnly").click());+ await dropHostControl();const original = fixture.invoke.getMockImplementation()!;let rejectTakeControl: ((cause: unknown) => void) | undefined;let heartbeats = 0;@@ -4637,20 +4660,131 @@ describe("remote desktop controls", () => {viewer,);await act(async () => button("viewOnly").click());- expect(requests()).toContainEqual({- op: "control",- lease: "lease",+ // View only is local: input stops here and the host keeps control.+ expect(requests().some((r) => r.op === "control" && !r.enabled)).toBe(false);+ expect(sent().filter((m) => m.type === "control").at(-1)).toEqual({+ type: "control",enabled: false,+ release: true,});expect(button("keyboard").disabled).toBe(true);await connect();+ // A new lease takes host control again; the phone stays in view only.expect(requests().filter((r) => r.op === "control" && r.enabled),- ).toHaveLength(1);+ ).toHaveLength(2);expect(button("keyboard").disabled).toBe(true);await act(async () => button("viewOnly").click());expect(button("keyboard").disabled).toBe(false);});+ describe("hosts that grant control with the lease (autoControl)", () => {+ const autoControl = () => {+ const original = fixture.invoke.getMockImplementation()!;+ fixture.invoke.mockImplementation(async (...args) => {+ const request = args[2][0];+ const result = await original(...args);+ if (request.op === "capabilities")+ return { ...(result as object), autoControl: true };+ if (request.op === "start")+ return { ...(result as object), controlling: request.control === true };+ return result;+ });+ };+ it("enters without a separate control request", async () => {+ autoControl();+ await connect();+ expect(requests().find((r) => r.op === "start")).toMatchObject({+ control: true,+ });+ expect(requests().some((r) => r.op === "control")).toBe(false);+ expect(sent()).toContainEqual({ type: "control", enabled: true });+ expect(button("keyboard").disabled).toBe(false);+ });+ const viewerInput = (sequence: number, events: object[]) =>+ act(async () =>+ fixture.message!({+ nativeEvent: {+ data: JSON.stringify({ type: "input", epoch: "lease", sequence, events }),+ },+ }),+ );+ it("releases host input on entering view only even with a batch in flight", async () => {+ autoControl();+ await connect();+ const original = fixture.invoke.getMockImplementation()!;+ fixture.invoke.mockImplementation((...args) =>+ args[2][0].op === "input" && args[2][0].sequence === 1+ ? new Promise(() => {})+ : original(...args),+ );+ await viewerInput(1, [{ kind: "button", button: 0, down: true, x: 0.5, y: 0.5 }]);+ act(() => button("operations").click());+ await act(async () => button("viewOnly").click());+ expect(sent()).toContainEqual({ type: "control", enabled: false, release: true });+ // The runtime's trailing release reaches the host past the busy batch.+ await viewerInput(2, [{ kind: "release" }]);+ expect(requests()).toContainEqual({+ op: "input",+ lease: "lease",+ sequence: 2,+ events: [{ kind: "release" }],+ });+ // Other input stays local while viewing only.+ await viewerInput(3, [{ kind: "move", x: 0.2, y: 0.2 }]);+ expect(requests().some((r) => r.op === "input" && r.sequence === 3)).toBe(false);+ });+ it("drops a native-pending batch that falls back after view only started", async () => {+ fixture.nativeMedia = true;+ act(() => root.render(<RemoteDesktopScreen />));+ autoControl();+ await connect();+ let fallback!: (sent: boolean) => void;+ fixture.nativeInput.mockImplementationOnce(+ () =>+ new Promise<boolean>((resolve) => {+ fallback = resolve;+ }),+ );+ await viewerInput(1, [{ kind: "move", x: 0.5, y: 0.5 }]);+ expect(fallback).toBeTypeOf("function");+ act(() => button("operations").click());+ await act(async () => button("viewOnly").click());+ await act(async () => fallback(false));+ expect(requests().some((r) => r.op === "input" && r.sequence === 1)).toBe(false);+ });+ it("switches view only locally without asking the host", async () => {+ autoControl();+ await connect();+ act(() => button("operations").click());+ fixture.invoke.mockClear();+ fixture.post.mockClear();+ await act(async () => button("viewOnly").click());+ expect(button("viewOnly").getAttribute("aria-selected")).toBe("true");+ expect(button("keyboard").disabled).toBe(true);+ expect(sent()).toContainEqual({ type: "control", enabled: false, release: true });+ // Taps no longer reach the computer while viewing only.+ await act(async () =>+ fixture.message!({+ nativeEvent: {+ data: JSON.stringify({+ type: "input",+ epoch: "lease",+ sequence: 1,+ events: [{ kind: "move", x: 0.5, y: 0.5 }],+ }),+ },+ }),+ );+ await act(async () => button("viewOnly").click());+ expect(button("viewOnly").getAttribute("aria-selected")).toBe("false");+ expect(button("keyboard").disabled).toBe(false);+ expect(sent().filter((m) => m.type === "control").at(-1)).toEqual({+ type: "control",+ enabled: true,+ });+ expect(requests()).toEqual([]);+ });+ });it("asks before taking over an existing remote desktop viewer", async () => {const original = fixture.invoke.getMockImplementation()!;let firstStart = true;@@ -4830,9 +4964,14 @@ describe("remote desktop controls", () => {fixture.status = "online";await act(async () => root.render(<RemoteDesktopScreen />));expect(requests().filter((r) => r.op === "start")).toHaveLength(2);+ // The new lease takes host control again; view only stays a local choice.expect(requests().filter((r) => r.op === "control" && r.enabled),- ).toHaveLength(1);+ ).toHaveLength(2);+ expect(sent().filter((m) => m.type === "control").at(-1)).toEqual({+ type: "control",+ enabled: false,+ });expect(fixture.openLink.mock.calls.every(([id]) => id === "computer")).toBe(true,);diff --git a/apps/mobile/src/remote-desktop/fittedDisplayModes.ts b/apps/mobile/src/remote-desktop/fittedDisplayModes.tsindex 2db4a4b5f7..e4a8bd8d82 100644--- a/apps/mobile/src/remote-desktop/fittedDisplayModes.ts+++ b/apps/mobile/src/remote-desktop/fittedDisplayModes.ts@@ -1,35 +1,2 @@-import type { RemoteDesktopDisplayMode } from "@cindy/device-link";--type Size = { width: number; height: number };--/** Resize the fitted desktop without offering modes from the physical monitor. */-export function fittedDisplayModes(- fitted: Size,- current: Size,-): RemoteDesktopDisplayMode[] {- const modes = new Map<string, RemoteDesktopDisplayMode>();- const add = ({ width, height }: Size) => {- if (- ![width, height].every(- (size) => Number.isInteger(size) && size >= 320 && size <= 2560,- )- )- return;- const id = `fitted:${width}x${height}`;- modes.set(id, {- id,- width,- height,- current: width === current.width && height === current.height,- });- };- for (const edge of [960, 1280, 1600, 1920, 2560]) {- const scale = edge / Math.max(fitted.width, fitted.height);- add({- width: Math.round((fitted.width * scale) / 2) * 2,- height: Math.round((fitted.height * scale) / 2) * 2,- });- }- add(current);- return [...modes.values()].sort((a, b) => a.width - b.width);-}+// Shared with the Desktop viewer window.+export { fittedDisplayModes } from "@cindy/device-link";diff --git a/apps/mobile/src/remote-desktop/resolutionMemory.ts b/apps/mobile/src/remote-desktop/resolutionMemory.tsindex 32a0095e80..b10476ee93 100644--- a/apps/mobile/src/remote-desktop/resolutionMemory.ts+++ b/apps/mobile/src/remote-desktop/resolutionMemory.ts@@ -1,5 +1,7 @@import AsyncStorage from "@react-native-async-storage/async-storage";-import type { RemoteDesktopDisplayMode } from "@cindy/device-link";++// Shared with the Desktop viewer window.+export { findRememberedMode } from "@cindy/device-link";// Non-secret, phone-local: the last display choice this phone made for one// monitor of one computer. The host still restores its own display on@@ -63,16 +65,3 @@ export async function readRememberedResolution(return null;}}--/** Mode IDs may change after OS or monitor updates; fall back to the same size. */-export function findRememberedMode(- modes: RemoteDesktopDisplayMode[],- remembered: { modeId: string } & Size,-): RemoteDesktopDisplayMode | undefined {- const sameSize = (mode: RemoteDesktopDisplayMode) =>- mode.width === remembered.width && mode.height === remembered.height;- return (- modes.find((mode) => mode.id === remembered.modeId && sameSize(mode)) ??- modes.find(sameSize)- );-}diff --git a/docs/design-rules/design-inventory.md b/docs/design-rules/design-inventory.mdindex fa6c251192..0db63c524f 100644--- a/docs/design-rules/design-inventory.md+++ b/docs/design-rules/design-inventory.md@@ -18,12 +18,12 @@| `desktop.auth.add-account` | desktop | 添加账号 | hash `/add-account`(ProtectedRoute → AddAccountLoginPage) | AddAccountLoginPage | apps/desktop/src/renderer/components/login/AddAccountLoginPage.tsx, apps/desktop/src/renderer/components/login/LoginBrandStage.tsx, apps/desktop/src/renderer/components/login/LoginCaptchaOverlay.tsx, apps/desktop/src/renderer/components/login/LoginControls.tsx, apps/desktop/src/renderer/components/login/LoginPage.tsx, apps/desktop/src/renderer/components/login/loginDesignTokens.ts | 59 | 0 | 20 || `desktop.auth.legacy-migration` | desktop | 首登数据迁移弹窗 | App 顶层挂载 LegacyMigrationDialog(仅主窗;main 检测到旧版 userData 经 `legacy-migration:state` 驱动) | LegacyMigrationDialog | apps/desktop/src/renderer/components/auth/LegacyMigrationDialog.tsx | 8 | 0 | 2 || `desktop.auth.login` | desktop | 登录页 | hash `/login`(GuestRoute → LoginPage) | LoginBrandStage, LoginCaptchaOverlay, LoginControls, LoginPage | apps/desktop/src/renderer/components/login/LoginBrandStage.tsx, apps/desktop/src/renderer/components/login/LoginCaptchaOverlay.tsx, apps/desktop/src/renderer/components/login/LoginControls.tsx, apps/desktop/src/renderer/components/login/LoginPage.tsx, apps/desktop/src/renderer/components/login/loginDesignTokens.ts | 59 | 0 | 20 |-| `desktop.bots` | desktop | 伙伴(列表 / 对话 / 设置 / 历史 / 伙伴私聊 / 群聊) | hash `/bots`、`/bots/list`、`/bots/:botId`、`/bots/roster` 及伙伴当前/历史任务、伙伴私聊、伙伴群聊路由(BotsFeatureLayout) | BotBasicProfileFields, BotCollaborationCard, BotDirectMessageView, BotGroupChatView, BotGroupCreateDialog, BotGroupSettingsDrawer, BotHistorySessionView, BotLifecycleSettings, BotModelChainEditor, BotRosterView, BotSessionView, BotSettingsDrawer, BotsHomeView, BotsListView, RemoteBotSessionView | apps/desktop/src/renderer/components/chat/AgentActionRow.tsx, apps/desktop/src/renderer/components/chat/AgentActionsBlock.tsx, apps/desktop/src/renderer/components/chat/AgentTaskCard.tsx, apps/desktop/src/renderer/components/chat/AgentTaskLiveDetails.tsx, apps/desktop/src/renderer/components/chat/AnnotationStrokesSvg.tsx, apps/desktop/src/renderer/components/chat/AskUserQuestionBubble.tsx, apps/desktop/src/renderer/components/chat/AssistantMessage.tsx, apps/desktop/src/renderer/components/chat/AutomationOriginBadge.tsx, apps/desktop/src/renderer/components/chat/ChatAudioCard.tsx, apps/desktop/src/renderer/components/chat/ChatDisplaySnapshotContext.tsx, apps/desktop/src/renderer/components/chat/ChatImageView.tsx, apps/desktop/src/renderer/components/chat/ChatSessionFileContext.tsx, apps/desktop/src/renderer/components/chat/ChatSoundEffectCard.tsx, apps/desktop/src/renderer/components/chat/ChatVideoView.tsx, apps/desktop/src/renderer/components/chat/CindyMakeDoctorCard.tsx, apps/desktop/src/renderer/components/chat/CopyAsImageBlock.tsx, apps/desktop/src/renderer/components/chat/CredentialSwitchWaitBanner.tsx, apps/desktop/src/renderer/components/chat/DiffView.tsx, apps/desktop/src/renderer/components/chat/ErrorBanner.tsx, apps/desktop/src/renderer/components/chat/ErrorMessageCard.tsx, apps/desktop/src/renderer/components/chat/GeneratedFilesCard.tsx, apps/desktop/src/renderer/components/chat/GhostCardHostPrompts.tsx, apps/desktop/src/renderer/components/chat/GhostSummonCard.tsx, apps/desktop/src/renderer/components/chat/GhostToolCard.tsx, apps/desktop/src/renderer/components/chat/HookTaskCard.tsx, apps/desktop/src/renderer/components/chat/ImageGalleryContext.tsx, apps/desktop/src/renderer/components/chat/ImageHoverPreview.tsx, apps/desktop/src/renderer/components/chat/ImageLightbox.tsx, apps/desktop/src/renderer/components/chat/ImageMissingPlaceholder.tsx, apps/desktop/src/renderer/components/chat/InlineReferenceChip.tsx, apps/desktop/src/renderer/components/chat/InterruptedTurnBanner.tsx, apps/desktop/src/renderer/components/chat/JumpToBottomChip.tsx, apps/desktop/src/renderer/components/chat/MarkdownDiffBlock.tsx, apps/desktop/src/renderer/components/chat/MarkdownMermaidBlock.tsx, apps/desktop/src/renderer/components/chat/MarkdownRenderer.tsx, apps/desktop/src/renderer/components/chat/MermaidLightbox.tsx, apps/desktop/src/renderer/components/chat/MessageActionBar.tsx, apps/desktop/src/renderer/components/chat/MessageNavRail.tsx, apps/desktop/src/renderer/components/chat/MessageStream.tsx, apps/desktop/src/renderer/components/chat/MessageViewport.tsx, apps/desktop/src/renderer/components/chat/ModelLightbox.tsx, apps/desktop/src/renderer/components/chat/NewMessageIndicator.tsx, apps/desktop/src/renderer/components/chat/PlanReviewBubble.tsx, apps/desktop/src/renderer/components/chat/PrevMessageJumpChip.tsx, apps/desktop/src/renderer/components/chat/ProjectLinkChip.tsx, apps/desktop/src/renderer/components/chat/QuoteChip.tsx, apps/desktop/src/renderer/components/chat/RewindPreviewDialog.tsx, apps/desktop/src/renderer/components/chat/SelectionQuoteButton.tsx, apps/desktop/src/renderer/components/chat/SentAgentReferenceChip.tsx, apps/desktop/src/renderer/components/chat/SentInlineAtomBody.tsx, apps/desktop/src/renderer/components/chat/SessionHandoffCard.tsx, apps/desktop/src/renderer/components/chat/SessionLinkChip.tsx, apps/desktop/src/renderer/components/chat/ShareMessageCheckbox.tsx, apps/desktop/src/renderer/components/chat/ShareSelectionBar.tsx, apps/desktop/src/renderer/components/chat/SlackIcon.tsx, apps/desktop/src/renderer/components/chat/StreamFadeSpan.tsx, apps/desktop/src/renderer/components/chat/StreamingMarkdownChunk.tsx, apps/desktop/src/renderer/components/chat/SystemCard.tsx, apps/desktop/src/renderer/components/chat/TextLightbox.tsx, apps/desktop/src/renderer/components/chat/ThinkingCard.tsx, apps/desktop/src/renderer/components/chat/ThinkingText.tsx, apps/desktop/src/renderer/components/chat/TodoListCard.tsx, apps/desktop/src/renderer/components/chat/ToolCallCard.tsx, apps/desktop/src/renderer/components/chat/ToolPayloadLightbox.tsx, apps/desktop/src/renderer/components/chat/TopRightChipStack.tsx, apps/desktop/src/renderer/components/chat/TurnChangesCard.tsx, apps/desktop/src/renderer/components/chat/UnreadFailedScheduleBanner.tsx, apps/desktop/src/renderer/components/chat/UpgradeBanner.tsx, apps/desktop/src/renderer/components/chat/UserAttachmentChip.tsx, apps/desktop/src/renderer/components/chat/UserMessage.tsx, apps/desktop/src/renderer/components/chat/UserMessageEditBox.tsx, apps/desktop/src/renderer/components/chat/UserMessageUrlLink.tsx, apps/desktop/src/renderer/components/chat/VideoLightbox.tsx, apps/desktop/src/renderer/components/chat/WorkGroupBlock.tsx, apps/desktop/src/renderer/components/chat/WorktreeRestoreBanner.tsx, apps/desktop/src/renderer/components/chat/XIcon.tsx, apps/desktop/src/renderer/components/chat/activityRowChrome.ts, apps/desktop/src/renderer/components/chat/animateFocusScroll.ts, apps/desktop/src/renderer/components/chat/autoFollowIntent.ts, apps/desktop/src/renderer/components/chat/chatChrome.ts, apps/desktop/src/renderer/components/chat/errorReasonI18n.ts, apps/desktop/src/renderer/components/chat/generatedFilesProjection.ts, apps/desktop/src/renderer/components/chat/imageDisplaySize.ts, apps/desktop/src/renderer/components/chat/lightboxAnnotations.ts, apps/desktop/src/renderer/components/chat/lightboxGestures.ts, apps/desktop/src/renderer/components/chat/markdownImageTargets.ts, apps/desktop/src/renderer/components/chat/messageNavRailModel.ts, apps/desktop/src/renderer/components/chat/messageNavRailWheel.ts, apps/desktop/src/renderer/components/chat/messageNavigationProjection.ts, apps/desktop/src/renderer/components/chat/messageProjectionCache.ts, apps/desktop/src/renderer/components/chat/messageStreamIndicatorPosition.ts, apps/desktop/src/renderer/components/chat/messageViewportCompensation.ts, apps/desktop/src/renderer/components/chat/messageViewportGeometry.ts, apps/desktop/src/renderer/components/chat/messageWorkGroups.ts, apps/desktop/src/renderer/components/chat/observeProgrammaticScroll.ts, apps/desktop/src/renderer/components/chat/rehypeFencedCodeMarker.ts, apps/desktop/src/renderer/components/chat/rehypeHighlightShared.ts, apps/desktop/src/renderer/components/chat/rehypeMathBlockMarker.ts, apps/desktop/src/renderer/components/chat/rehypeStreamWordFade.ts, apps/desktop/src/renderer/components/chat/remarkHtmlImages.ts, apps/desktop/src/renderer/components/chat/remarkLocalPathLinks.ts, apps/desktop/src/renderer/components/chat/remarkPreserveRawLocalDestinations.ts, apps/desktop/src/renderer/components/chat/remarkSessionLinks.ts, apps/desktop/src/renderer/components/chat/remarkStrictInlineMath.ts, apps/desktop/src/renderer/components/chat/remarkTruncateCjkUrls.ts, apps/desktop/src/renderer/components/chat/repairStreamingMarkdown.ts, apps/desktop/src/renderer/components/chat/scrollAnchoringDetect.ts, apps/desktop/src/renderer/components/chat/shareSelectionStore.ts, apps/desktop/src/renderer/components/chat/streamingMarkdownBlocks.tsx, apps/desktop/src/renderer/components/chat/streamingMarkdownChunks.ts, apps/desktop/src/renderer/components/chat/streamingMessageProjection.ts, apps/desktop/src/renderer/components/chat/toolLoopI18n.ts, apps/desktop/src/renderer/components/chat/unreadCount.ts, apps/desktop/src/renderer/components/chat/useAutomaticHistoryLoadBudget.ts, apps/desktop/src/renderer/components/chat/useCopyAsImage.tsx, apps/desktop/src/renderer/components/chat/useDeleteMessage.ts, apps/desktop/src/renderer/components/chat/useFileChipContextMenu.tsx, apps/desktop/src/renderer/components/chat/useForkAtMessage.ts, apps/desktop/src/renderer/components/chat/useMessageViewport.ts, apps/desktop/src/renderer/components/chat/useNavigationKeyListener.ts, apps/desktop/src/renderer/components/chat/useOpenWithMenu.tsx, apps/desktop/src/renderer/components/chat/usePrevUserMessageInView.ts, apps/desktop/src/renderer/components/chat/useTurnChangeSets.ts, apps/desktop/src/renderer/components/chat/userMessageCollapse.ts, apps/desktop/src/renderer/components/chat/userMessageDisplayText.ts, apps/desktop/src/renderer/components/chat/userMessageLinkify.ts, apps/desktop/src/renderer/components/chat/viewportFillDetect.ts, apps/desktop/src/renderer/components/new-chat/AddRemoteProjectDialog.tsx, apps/desktop/src/renderer/components/new-chat/AgentSelect.tsx, apps/desktop/src/renderer/components/new-chat/AskUserQuestionPrompt.tsx, apps/desktop/src/renderer/components/new-chat/AtMentionPanel.tsx, apps/desktop/src/renderer/components/new-chat/AttachmentTypeThumb.tsx, apps/desktop/src/renderer/components/new-chat/ChatInput.tsx, apps/desktop/src/renderer/components/new-chat/CjkPunctDecoration.ts, apps/desktop/src/renderer/components/new-chat/CjkPunctuationUtils.ts, apps/desktop/src/renderer/components/new-chat/ComposerAttachments.tsx, apps/desktop/src/renderer/components/new-chat/ComposerListIndentDecoration.ts, apps/desktop/src/renderer/components/new-chat/ComposerListNodes.ts, apps/desktop/src/renderer/components/new-chat/ComposerQuoteNode.tsx, apps/desktop/src/renderer/components/new-chat/DeviceSwitcherPill.tsx, apps/desktop/src/renderer/components/new-chat/EffortSlider.tsx, apps/desktop/src/renderer/components/new-chat/EmptyDocSelectionGuard.ts, apps/desktop/src/renderer/components/new-chat/ExtraDirsButton.tsx, apps/desktop/src/renderer/components/new-chat/FastModeToggle.tsx, apps/desktop/src/renderer/components/new-chat/FolderPickerPopover.tsx, apps/desktop/src/renderer/components/new-chat/FullAccessConfirmContent.tsx, apps/desktop/src/renderer/components/new-chat/GhostCommandDecoration.ts, apps/desktop/src/renderer/components/new-chat/GoalAdvancedLimits.tsx, apps/desktop/src/renderer/components/new-chat/GoalIndicator.tsx, apps/desktop/src/renderer/components/new-chat/HomeUsageDashboard.tsx, apps/desktop/src/renderer/components/new-chat/ListComposerTextarea.tsx, apps/desktop/src/renderer/components/new-chat/LocalModelCatalogNotice.tsx, apps/desktop/src/renderer/components/new-chat/MentionChipNode.tsx, apps/desktop/src/renderer/components/new-chat/MentionDragCaretDecoration.ts, apps/desktop/src/renderer/components/new-chat/ModelCompatibilityNotice.tsx, apps/desktop/src/renderer/components/new-chat/ModelConfigFlyout.tsx, apps/desktop/src/renderer/components/new-chat/ModelHarnessPicker.tsx, apps/desktop/src/renderer/components/new-chat/ModelSelector.tsx, apps/desktop/src/renderer/components/new-chat/ModelSourceDetails.tsx, apps/desktop/src/renderer/components/new-chat/NewGoalDialog.tsx, apps/desktop/src/renderer/components/new-chat/PastedTextChipNode.tsx, apps/desktop/src/renderer/components/new-chat/PendingQueuePanel.tsx, apps/desktop/src/renderer/components/new-chat/PermissionPrompt.tsx, apps/desktop/src/renderer/components/new-chat/PermissionSelector.tsx, apps/desktop/src/renderer/components/new-chat/PinnedPlanPanel.tsx, apps/desktop/src/renderer/components/new-chat/PlanActionCard.tsx, apps/desktop/src/renderer/components/new-chat/PlanModeIndicator.tsx, apps/desktop/src/renderer/components/new-chat/PlanViewerCard.tsx, apps/desktop/src/renderer/components/new-chat/PluginConnectionForm.tsx, apps/desktop/src/renderer/components/new-chat/PluginOauthDeviceCode.tsx, apps/desktop/src/renderer/components/new-chat/PluginSetupPrompt.tsx, apps/desktop/src/renderer/components/new-chat/PluginWriteAccessRecovery.tsx, apps/desktop/src/renderer/components/new-chat/QuickStartPillMark.ts, apps/desktop/src/renderer/components/new-chat/RemoteOauthSetupCard.tsx, apps/desktop/src/renderer/components/new-chat/SendButton.tsx, apps/desktop/src/renderer/components/new-chat/SlashCommandDecoration.ts, apps/desktop/src/renderer/components/new-chat/SlashCommandPalette.tsx, apps/desktop/src/renderer/components/new-chat/TakeoverMask.tsx, apps/desktop/src/renderer/components/new-chat/ThinkingToggle.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedFlyoutHost.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelPanel.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelRail.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelRow.tsx, apps/desktop/src/renderer/components/new-chat/UsageDailyBars.tsx, apps/desktop/src/renderer/components/new-chat/UsageHeatmap.tsx, apps/desktop/src/renderer/components/new-chat/VendorSegmentedSwitcher.tsx, apps/desktop/src/renderer/components/new-chat/VoiceInputDraftDecoration.ts, apps/desktop/src/renderer/components/new-chat/WindowsSelectionReplacement.ts, apps/desktop/src/renderer/components/new-chat/WorktreeChipsRow.tsx, apps/desktop/src/renderer/components/new-chat/WorktreeCreatingOverlay.tsx, apps/desktop/src/renderer/components/new-chat/agentOptions.ts, apps/desktop/src/renderer/components/new-chat/agentSwitchConfirmation.ts, apps/desktop/src/renderer/components/new-chat/branchPick.ts, apps/desktop/src/renderer/components/new-chat/composerBlankPointerFocus.ts, apps/desktop/src/renderer/components/new-chat/composerContentSerialization.ts, apps/desktop/src/renderer/components/new-chat/composerDocState.ts, apps/desktop/src/renderer/components/new-chat/composerFrameScheduler.ts, apps/desktop/src/renderer/components/new-chat/composerHistoryProjection.ts, apps/desktop/src/renderer/components/new-chat/composerModelSelection.ts, apps/desktop/src/renderer/components/new-chat/composerPromptRecommendation.ts, apps/desktop/src/renderer/components/new-chat/composerRenderGate.ts, apps/desktop/src/renderer/components/new-chat/composerSendOwnership.ts, apps/desktop/src/renderer/components/new-chat/composerSendSnapshot.ts, apps/desktop/src/renderer/components/new-chat/effortChangeQueue.ts, apps/desktop/src/renderer/components/new-chat/extraDirsActions.ts, apps/desktop/src/renderer/components/new-chat/ghostComposerPlacement.ts, apps/desktop/src/renderer/components/new-chat/localAttachmentPicker.ts, apps/desktop/src/renderer/components/new-chat/mentionChipInsertion.ts, apps/desktop/src/renderer/components/new-chat/modelWindowErrorToast.ts, apps/desktop/src/renderer/components/new-chat/pastePipeline.ts, apps/desktop/src/renderer/components/new-chat/pathPaste.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueLocks.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueRowActivity.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueRowPresentation.ts, apps/desktop/src/renderer/components/new-chat/planModeComposerCommand.ts, apps/desktop/src/renderer/components/new-chat/priceTierMarks.tsx, apps/desktop/src/renderer/components/new-chat/remoteBrowseAdapters.ts, apps/desktop/src/renderer/components/new-chat/remoteExistingProjects.ts, apps/desktop/src/renderer/components/new-chat/restoreComposerDocument.ts, apps/desktop/src/renderer/components/new-chat/sessionLinkPaste.ts, apps/desktop/src/renderer/components/new-chat/sourceSwitch.ts, apps/desktop/src/renderer/components/new-chat/unifiedModelSelection.ts, apps/desktop/src/renderer/components/new-chat/usagePalette.ts, apps/desktop/src/renderer/components/new-chat/useComposerSendFocusRestore.ts, apps/desktop/src/renderer/components/new-chat/useModelDiscoveryPending.ts, apps/desktop/src/renderer/components/new-chat/useProviderWeeklyQuota.ts, apps/desktop/src/renderer/components/new-chat/useUnifiedRowActions.ts, apps/desktop/src/renderer/features/bots/BotAuthorizationCard.tsx, apps/desktop/src/renderer/features/bots/BotAvatar.tsx, apps/desktop/src/renderer/features/bots/BotBasicProfileFields.tsx, apps/desktop/src/renderer/features/bots/BotCapabilitySettings.tsx, apps/desktop/src/renderer/features/bots/BotCollaborationCard.tsx, apps/desktop/src/renderer/features/bots/BotConnectionStatus.tsx, apps/desktop/src/renderer/features/bots/BotCreateMenu.tsx, apps/desktop/src/renderer/features/bots/BotDeleteDialog.tsx, apps/desktop/src/renderer/features/bots/BotDirectMessageCard.tsx, apps/desktop/src/renderer/features/bots/BotDirectMessageView.tsx, apps/desktop/src/renderer/features/bots/BotFollowMark.tsx, apps/desktop/src/renderer/features/bots/BotGenerationLabel.tsx, apps/desktop/src/renderer/features/bots/BotGroupAvatars.tsx, apps/desktop/src/renderer/features/bots/BotGroupChatView.tsx, apps/desktop/src/renderer/features/bots/BotGroupComposer.tsx, apps/desktop/src/renderer/features/bots/BotGroupCreateDialog.tsx, apps/desktop/src/renderer/features/bots/BotGroupPendingInteraction.tsx, apps/desktop/src/renderer/features/bots/BotGroupPlan.tsx, apps/desktop/src/renderer/features/bots/BotGroupSettingsDrawer.tsx, apps/desktop/src/renderer/features/bots/BotGroupSidebarRow.tsx, apps/desktop/src/renderer/features/bots/BotHistorySessionView.tsx, apps/desktop/src/renderer/features/bots/BotImportForm.tsx, apps/desktop/src/renderer/features/bots/BotInvitationWelcome.tsx, apps/desktop/src/renderer/features/bots/BotLearningFooter.tsx, apps/desktop/src/renderer/features/bots/BotLifecycleSettings.tsx, apps/desktop/src/renderer/features/bots/BotMemorySettings.tsx, apps/desktop/src/renderer/features/bots/BotModelChainEditor.tsx, apps/desktop/src/renderer/features/bots/BotPortraitPicker.tsx, apps/desktop/src/renderer/features/bots/BotRosterView.tsx, apps/desktop/src/renderer/features/bots/BotRoutines.tsx, apps/desktop/src/renderer/features/bots/BotSessionContentHeader.tsx, apps/desktop/src/renderer/features/bots/BotSessionTaskResultCard.tsx, apps/desktop/src/renderer/features/bots/BotSessionView.tsx, apps/desktop/src/renderer/features/bots/BotSettingsBlock.tsx, apps/desktop/src/renderer/features/bots/BotSettingsDrawer.tsx, apps/desktop/src/renderer/features/bots/BotTaskCardHeader.tsx, apps/desktop/src/renderer/features/bots/BotTaskModelEditor.tsx, apps/desktop/src/renderer/features/bots/BotWorkbench.tsx, apps/desktop/src/renderer/features/bots/BotWorkingStatus.tsx, apps/desktop/src/renderer/features/bots/BotsFeatureLayout.tsx, apps/desktop/src/renderer/features/bots/BotsGlobalSettingsSection.tsx, apps/desktop/src/renderer/features/bots/BotsHomeView.tsx, apps/desktop/src/renderer/features/bots/BotsListView.tsx, apps/desktop/src/renderer/features/bots/BotsSidebar.tsx, apps/desktop/src/renderer/features/bots/ChatBotAccessField.tsx, apps/desktop/src/renderer/features/bots/ChatGroupSettings.tsx, apps/desktop/src/renderer/features/bots/ChatServerControls.tsx, apps/desktop/src/renderer/features/bots/ChatThreadPanel.tsx, apps/desktop/src/renderer/features/bots/CindyDevicePicker.tsx, apps/desktop/src/renderer/features/bots/CindyDeviceRow.tsx, apps/desktop/src/renderer/features/bots/RemoteBotSessionView.tsx, apps/desktop/src/renderer/features/bots/RemoteBotSettings.tsx, apps/desktop/src/renderer/features/bots/botAvatarIdentity.ts, apps/desktop/src/renderer/features/bots/botCapabilityDefaults.ts, apps/desktop/src/renderer/features/bots/botChatPresentation.ts, apps/desktop/src/renderer/features/bots/botConversationPresentation.ts, apps/desktop/src/renderer/features/bots/botConversationTimeline.ts, apps/desktop/src/renderer/features/bots/botDelegationLive.ts, apps/desktop/src/renderer/features/bots/botFollowScopes.ts, apps/desktop/src/renderer/features/bots/botGeneratedArtifacts.ts, apps/desktop/src/renderer/features/bots/botGroupAttachments.ts, apps/desktop/src/renderer/features/bots/botGroupLane.ts, apps/desktop/src/renderer/features/bots/botGroupMentions.ts, apps/desktop/src/renderer/features/bots/botGroupPresentation.ts, apps/desktop/src/renderer/features/bots/botGroupStore.ts, apps/desktop/src/renderer/features/bots/botListDisplay.ts, apps/desktop/src/renderer/features/bots/botNavigation.ts, apps/desktop/src/renderer/features/bots/botPronounContext.tsx, apps/desktop/src/renderer/features/bots/botReadState.ts, apps/desktop/src/renderer/features/bots/botRosterDisplay.ts, apps/desktop/src/renderer/features/bots/botSessionOwners.ts, apps/desktop/src/renderer/features/bots/botSettingsAutosave.ts, apps/desktop/src/renderer/features/bots/botStore.ts, apps/desktop/src/renderer/features/bots/botWelcomeContext.ts, apps/desktop/src/renderer/features/bots/botWorkbenchProjection.ts, apps/desktop/src/renderer/features/bots/cindyDeviceRoster.ts, apps/desktop/src/renderer/features/bots/remoteBotRoster.ts, apps/desktop/src/renderer/features/bots/remoteBotSettingsData.ts, apps/desktop/src/renderer/features/bots/useBotGeneratedFileDeliveries.ts, apps/desktop/src/renderer/features/bots/useBotIslandVisibleSession.ts, apps/desktop/src/renderer/features/bots/useBotSettingsAutosave.ts, apps/desktop/src/renderer/features/bots/useBotUnreadSync.ts, apps/desktop/src/renderer/features/bots/useRemoteBots.ts, apps/desktop/src/renderer/features/bots/useWorkingStatusCopy.ts, apps/desktop/src/renderer/features/cc-agent/CCAgentFeatureLayout.tsx, apps/desktop/src/renderer/features/cc-agent/CCAgentSessionView.tsx | 277 | 38 | 469 |+| `desktop.bots` | desktop | 伙伴(列表 / 对话 / 设置 / 历史 / 伙伴私聊 / 群聊) | hash `/bots`、`/bots/list`、`/bots/:botId`、`/bots/roster` 及伙伴当前/历史任务、伙伴私聊、伙伴群聊路由(BotsFeatureLayout) | BotBasicProfileFields, BotCollaborationCard, BotDirectMessageView, BotGroupChatView, BotGroupCreateDialog, BotGroupSettingsDrawer, BotHistorySessionView, BotLifecycleSettings, BotModelChainEditor, BotRosterView, BotSessionView, BotSettingsDrawer, BotsHomeView, BotsListView, RemoteBotSessionView | apps/desktop/src/renderer/components/chat/AgentActionRow.tsx, apps/desktop/src/renderer/components/chat/AgentActionsBlock.tsx, apps/desktop/src/renderer/components/chat/AgentTaskCard.tsx, apps/desktop/src/renderer/components/chat/AgentTaskLiveDetails.tsx, apps/desktop/src/renderer/components/chat/AnnotationStrokesSvg.tsx, apps/desktop/src/renderer/components/chat/AskUserQuestionBubble.tsx, apps/desktop/src/renderer/components/chat/AssistantMessage.tsx, apps/desktop/src/renderer/components/chat/AutomationOriginBadge.tsx, apps/desktop/src/renderer/components/chat/ChatAudioCard.tsx, apps/desktop/src/renderer/components/chat/ChatDisplaySnapshotContext.tsx, apps/desktop/src/renderer/components/chat/ChatImageView.tsx, apps/desktop/src/renderer/components/chat/ChatSessionFileContext.tsx, apps/desktop/src/renderer/components/chat/ChatSoundEffectCard.tsx, apps/desktop/src/renderer/components/chat/ChatVideoView.tsx, apps/desktop/src/renderer/components/chat/CindyMakeDoctorCard.tsx, apps/desktop/src/renderer/components/chat/CopyAsImageBlock.tsx, apps/desktop/src/renderer/components/chat/CredentialSwitchWaitBanner.tsx, apps/desktop/src/renderer/components/chat/DiffView.tsx, apps/desktop/src/renderer/components/chat/ErrorBanner.tsx, apps/desktop/src/renderer/components/chat/ErrorMessageCard.tsx, apps/desktop/src/renderer/components/chat/GeneratedFilesCard.tsx, apps/desktop/src/renderer/components/chat/GhostCardHostPrompts.tsx, apps/desktop/src/renderer/components/chat/GhostSummonCard.tsx, apps/desktop/src/renderer/components/chat/GhostToolCard.tsx, apps/desktop/src/renderer/components/chat/HookTaskCard.tsx, apps/desktop/src/renderer/components/chat/ImageGalleryContext.tsx, apps/desktop/src/renderer/components/chat/ImageHoverPreview.tsx, apps/desktop/src/renderer/components/chat/ImageLightbox.tsx, apps/desktop/src/renderer/components/chat/ImageMissingPlaceholder.tsx, apps/desktop/src/renderer/components/chat/InlineReferenceChip.tsx, apps/desktop/src/renderer/components/chat/InterruptedTurnBanner.tsx, apps/desktop/src/renderer/components/chat/JumpToBottomChip.tsx, apps/desktop/src/renderer/components/chat/MarkdownDiffBlock.tsx, apps/desktop/src/renderer/components/chat/MarkdownMermaidBlock.tsx, apps/desktop/src/renderer/components/chat/MarkdownRenderer.tsx, apps/desktop/src/renderer/components/chat/MermaidLightbox.tsx, apps/desktop/src/renderer/components/chat/MessageActionBar.tsx, apps/desktop/src/renderer/components/chat/MessageNavRail.tsx, apps/desktop/src/renderer/components/chat/MessageStream.tsx, apps/desktop/src/renderer/components/chat/MessageViewport.tsx, apps/desktop/src/renderer/components/chat/ModelLightbox.tsx, apps/desktop/src/renderer/components/chat/NewMessageIndicator.tsx, apps/desktop/src/renderer/components/chat/PlanReviewBubble.tsx, apps/desktop/src/renderer/components/chat/PrevMessageJumpChip.tsx, apps/desktop/src/renderer/components/chat/ProjectLinkChip.tsx, apps/desktop/src/renderer/components/chat/QuoteChip.tsx, apps/desktop/src/renderer/components/chat/RewindPreviewDialog.tsx, apps/desktop/src/renderer/components/chat/SelectionQuoteButton.tsx, apps/desktop/src/renderer/components/chat/SentAgentReferenceChip.tsx, apps/desktop/src/renderer/components/chat/SentInlineAtomBody.tsx, apps/desktop/src/renderer/components/chat/SessionHandoffCard.tsx, apps/desktop/src/renderer/components/chat/SessionLinkChip.tsx, apps/desktop/src/renderer/components/chat/ShareMessageCheckbox.tsx, apps/desktop/src/renderer/components/chat/ShareSelectionBar.tsx, apps/desktop/src/renderer/components/chat/SlackIcon.tsx, apps/desktop/src/renderer/components/chat/StreamFadeSpan.tsx, apps/desktop/src/renderer/components/chat/StreamingMarkdownChunk.tsx, apps/desktop/src/renderer/components/chat/SystemCard.tsx, apps/desktop/src/renderer/components/chat/TextLightbox.tsx, apps/desktop/src/renderer/components/chat/ThinkingCard.tsx, apps/desktop/src/renderer/components/chat/ThinkingText.tsx, apps/desktop/src/renderer/components/chat/TodoListCard.tsx, apps/desktop/src/renderer/components/chat/ToolCallCard.tsx, apps/desktop/src/renderer/components/chat/ToolPayloadLightbox.tsx, apps/desktop/src/renderer/components/chat/TopRightChipStack.tsx, apps/desktop/src/renderer/components/chat/TurnChangesCard.tsx, apps/desktop/src/renderer/components/chat/UnreadFailedScheduleBanner.tsx, apps/desktop/src/renderer/components/chat/UpgradeBanner.tsx, apps/desktop/src/renderer/components/chat/UserAttachmentChip.tsx, apps/desktop/src/renderer/components/chat/UserMessage.tsx, apps/desktop/src/renderer/components/chat/UserMessageEditBox.tsx, apps/desktop/src/renderer/components/chat/UserMessageUrlLink.tsx, apps/desktop/src/renderer/components/chat/VideoLightbox.tsx, apps/desktop/src/renderer/components/chat/WorkGroupBlock.tsx, apps/desktop/src/renderer/components/chat/WorktreeRestoreBanner.tsx, apps/desktop/src/renderer/components/chat/XIcon.tsx, apps/desktop/src/renderer/components/chat/activityRowChrome.ts, apps/desktop/src/renderer/components/chat/animateFocusScroll.ts, apps/desktop/src/renderer/components/chat/autoFollowIntent.ts, apps/desktop/src/renderer/components/chat/chatChrome.ts, apps/desktop/src/renderer/components/chat/errorReasonI18n.ts, apps/desktop/src/renderer/components/chat/generatedFilesProjection.ts, apps/desktop/src/renderer/components/chat/imageDisplaySize.ts, apps/desktop/src/renderer/components/chat/lightboxAnnotations.ts, apps/desktop/src/renderer/components/chat/lightboxGestures.ts, apps/desktop/src/renderer/components/chat/markdownImageTargets.ts, apps/desktop/src/renderer/components/chat/messageNavRailModel.ts, apps/desktop/src/renderer/components/chat/messageNavRailWheel.ts, apps/desktop/src/renderer/components/chat/messageNavigationProjection.ts, apps/desktop/src/renderer/components/chat/messageProjectionCache.ts, apps/desktop/src/renderer/components/chat/messageStreamIndicatorPosition.ts, apps/desktop/src/renderer/components/chat/messageViewportCompensation.ts, apps/desktop/src/renderer/components/chat/messageViewportGeometry.ts, apps/desktop/src/renderer/components/chat/messageWorkGroups.ts, apps/desktop/src/renderer/components/chat/observeProgrammaticScroll.ts, apps/desktop/src/renderer/components/chat/rehypeFencedCodeMarker.ts, apps/desktop/src/renderer/components/chat/rehypeHighlightShared.ts, apps/desktop/src/renderer/components/chat/rehypeMathBlockMarker.ts, apps/desktop/src/renderer/components/chat/rehypeStreamWordFade.ts, apps/desktop/src/renderer/components/chat/remarkHtmlImages.ts, apps/desktop/src/renderer/components/chat/remarkLocalPathLinks.ts, apps/desktop/src/renderer/components/chat/remarkPreserveRawLocalDestinations.ts, apps/desktop/src/renderer/components/chat/remarkSessionLinks.ts, apps/desktop/src/renderer/components/chat/remarkStrictInlineMath.ts, apps/desktop/src/renderer/components/chat/remarkTruncateCjkUrls.ts, apps/desktop/src/renderer/components/chat/repairStreamingMarkdown.ts, apps/desktop/src/renderer/components/chat/scrollAnchoringDetect.ts, apps/desktop/src/renderer/components/chat/shareSelectionStore.ts, apps/desktop/src/renderer/components/chat/streamingMarkdownBlocks.tsx, apps/desktop/src/renderer/components/chat/streamingMarkdownChunks.ts, apps/desktop/src/renderer/components/chat/streamingMessageProjection.ts, apps/desktop/src/renderer/components/chat/toolLoopI18n.ts, apps/desktop/src/renderer/components/chat/unreadCount.ts, apps/desktop/src/renderer/components/chat/useAutomaticHistoryLoadBudget.ts, apps/desktop/src/renderer/components/chat/useCopyAsImage.tsx, apps/desktop/src/renderer/components/chat/useDeleteMessage.ts, apps/desktop/src/renderer/components/chat/useFileChipContextMenu.tsx, apps/desktop/src/renderer/components/chat/useForkAtMessage.ts, apps/desktop/src/renderer/components/chat/useMessageViewport.ts, apps/desktop/src/renderer/components/chat/useNavigationKeyListener.ts, apps/desktop/src/renderer/components/chat/useOpenWithMenu.tsx, apps/desktop/src/renderer/components/chat/usePrevUserMessageInView.ts, apps/desktop/src/renderer/components/chat/useTurnChangeSets.ts, apps/desktop/src/renderer/components/chat/userMessageCollapse.ts, apps/desktop/src/renderer/components/chat/userMessageDisplayText.ts, apps/desktop/src/renderer/components/chat/userMessageLinkify.ts, apps/desktop/src/renderer/components/chat/viewportFillDetect.ts, apps/desktop/src/renderer/components/new-chat/AddRemoteProjectDialog.tsx, apps/desktop/src/renderer/components/new-chat/AgentSelect.tsx, apps/desktop/src/renderer/components/new-chat/AskUserQuestionPrompt.tsx, apps/desktop/src/renderer/components/new-chat/AtMentionPanel.tsx, apps/desktop/src/renderer/components/new-chat/AttachmentTypeThumb.tsx, apps/desktop/src/renderer/components/new-chat/ChatInput.tsx, apps/desktop/src/renderer/components/new-chat/CjkPunctDecoration.ts, apps/desktop/src/renderer/components/new-chat/CjkPunctuationUtils.ts, apps/desktop/src/renderer/components/new-chat/ComposerAttachments.tsx, apps/desktop/src/renderer/components/new-chat/ComposerListIndentDecoration.ts, apps/desktop/src/renderer/components/new-chat/ComposerListNodes.ts, apps/desktop/src/renderer/components/new-chat/ComposerQuoteNode.tsx, apps/desktop/src/renderer/components/new-chat/DeviceSwitcherPill.tsx, apps/desktop/src/renderer/components/new-chat/EffortSlider.tsx, apps/desktop/src/renderer/components/new-chat/EmptyDocSelectionGuard.ts, apps/desktop/src/renderer/components/new-chat/ExtraDirsButton.tsx, apps/desktop/src/renderer/components/new-chat/FastModeToggle.tsx, apps/desktop/src/renderer/components/new-chat/FolderPickerPopover.tsx, apps/desktop/src/renderer/components/new-chat/FullAccessConfirmContent.tsx, apps/desktop/src/renderer/components/new-chat/GhostCommandDecoration.ts, apps/desktop/src/renderer/components/new-chat/GoalAdvancedLimits.tsx, apps/desktop/src/renderer/components/new-chat/GoalIndicator.tsx, apps/desktop/src/renderer/components/new-chat/HomeUsageDashboard.tsx, apps/desktop/src/renderer/components/new-chat/ListComposerTextarea.tsx, apps/desktop/src/renderer/components/new-chat/LocalModelCatalogNotice.tsx, apps/desktop/src/renderer/components/new-chat/MentionChipNode.tsx, apps/desktop/src/renderer/components/new-chat/MentionDragCaretDecoration.ts, apps/desktop/src/renderer/components/new-chat/ModelCompatibilityNotice.tsx, apps/desktop/src/renderer/components/new-chat/ModelConfigFlyout.tsx, apps/desktop/src/renderer/components/new-chat/ModelHarnessPicker.tsx, apps/desktop/src/renderer/components/new-chat/ModelSelector.tsx, apps/desktop/src/renderer/components/new-chat/ModelSourceDetails.tsx, apps/desktop/src/renderer/components/new-chat/NewGoalDialog.tsx, apps/desktop/src/renderer/components/new-chat/PastedTextChipNode.tsx, apps/desktop/src/renderer/components/new-chat/PendingQueuePanel.tsx, apps/desktop/src/renderer/components/new-chat/PermissionPrompt.tsx, apps/desktop/src/renderer/components/new-chat/PermissionSelector.tsx, apps/desktop/src/renderer/components/new-chat/PinnedPlanPanel.tsx, apps/desktop/src/renderer/components/new-chat/PlanActionCard.tsx, apps/desktop/src/renderer/components/new-chat/PlanModeIndicator.tsx, apps/desktop/src/renderer/components/new-chat/PlanViewerCard.tsx, apps/desktop/src/renderer/components/new-chat/PluginConnectionForm.tsx, apps/desktop/src/renderer/components/new-chat/PluginOauthDeviceCode.tsx, apps/desktop/src/renderer/components/new-chat/PluginSetupPrompt.tsx, apps/desktop/src/renderer/components/new-chat/PluginSetupRemoteDesktopButton.tsx, apps/desktop/src/renderer/components/new-chat/PluginWriteAccessRecovery.tsx, apps/desktop/src/renderer/components/new-chat/QuickStartPillMark.ts, apps/desktop/src/renderer/components/new-chat/RemoteOauthSetupCard.tsx, apps/desktop/src/renderer/components/new-chat/SendButton.tsx, apps/desktop/src/renderer/components/new-chat/SlashCommandDecoration.ts, apps/desktop/src/renderer/components/new-chat/SlashCommandPalette.tsx, apps/desktop/src/renderer/components/new-chat/TakeoverMask.tsx, apps/desktop/src/renderer/components/new-chat/ThinkingToggle.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedFlyoutHost.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelPanel.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelRail.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelRow.tsx, apps/desktop/src/renderer/components/new-chat/UsageDailyBars.tsx, apps/desktop/src/renderer/components/new-chat/UsageHeatmap.tsx, apps/desktop/src/renderer/components/new-chat/VendorSegmentedSwitcher.tsx, apps/desktop/src/renderer/components/new-chat/VoiceInputDraftDecoration.ts, apps/desktop/src/renderer/components/new-chat/WindowsSelectionReplacement.ts, apps/desktop/src/renderer/components/new-chat/WorktreeChipsRow.tsx, apps/desktop/src/renderer/components/new-chat/WorktreeCreatingOverlay.tsx, apps/desktop/src/renderer/components/new-chat/agentOptions.ts, apps/desktop/src/renderer/components/new-chat/agentSwitchConfirmation.ts, apps/desktop/src/renderer/components/new-chat/branchPick.ts, apps/desktop/src/renderer/components/new-chat/composerBlankPointerFocus.ts, apps/desktop/src/renderer/components/new-chat/composerContentSerialization.ts, apps/desktop/src/renderer/components/new-chat/composerDocState.ts, apps/desktop/src/renderer/components/new-chat/composerFrameScheduler.ts, apps/desktop/src/renderer/components/new-chat/composerHistoryProjection.ts, apps/desktop/src/renderer/components/new-chat/composerModelSelection.ts, apps/desktop/src/renderer/components/new-chat/composerPromptRecommendation.ts, apps/desktop/src/renderer/components/new-chat/composerRenderGate.ts, apps/desktop/src/renderer/components/new-chat/composerSendOwnership.ts, apps/desktop/src/renderer/components/new-chat/composerSendSnapshot.ts, apps/desktop/src/renderer/components/new-chat/effortChangeQueue.ts, apps/desktop/src/renderer/components/new-chat/extraDirsActions.ts, apps/desktop/src/renderer/components/new-chat/ghostComposerPlacement.ts, apps/desktop/src/renderer/components/new-chat/localAttachmentPicker.ts, apps/desktop/src/renderer/components/new-chat/mentionChipInsertion.ts, apps/desktop/src/renderer/components/new-chat/modelWindowErrorToast.ts, apps/desktop/src/renderer/components/new-chat/pastePipeline.ts, apps/desktop/src/renderer/components/new-chat/pathPaste.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueLocks.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueRowActivity.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueRowPresentation.ts, apps/desktop/src/renderer/components/new-chat/planModeComposerCommand.ts, apps/desktop/src/renderer/components/new-chat/priceTierMarks.tsx, apps/desktop/src/renderer/components/new-chat/remoteBrowseAdapters.ts, apps/desktop/src/renderer/components/new-chat/remoteExistingProjects.ts, apps/desktop/src/renderer/components/new-chat/restoreComposerDocument.ts, apps/desktop/src/renderer/components/new-chat/sessionLinkPaste.ts, apps/desktop/src/renderer/components/new-chat/sourceSwitch.ts, apps/desktop/src/renderer/components/new-chat/unifiedModelSelection.ts, apps/desktop/src/renderer/components/new-chat/usagePalette.ts, apps/desktop/src/renderer/components/new-chat/useComposerSendFocusRestore.ts, apps/desktop/src/renderer/components/new-chat/useModelDiscoveryPending.ts, apps/desktop/src/renderer/components/new-chat/useProviderWeeklyQuota.ts, apps/desktop/src/renderer/components/new-chat/useUnifiedRowActions.ts, apps/desktop/src/renderer/features/bots/BotAuthorizationCard.tsx, apps/desktop/src/renderer/features/bots/BotAvatar.tsx, apps/desktop/src/renderer/features/bots/BotBasicProfileFields.tsx, apps/desktop/src/renderer/features/bots/BotCapabilitySettings.tsx, apps/desktop/src/renderer/features/bots/BotCollaborationCard.tsx, apps/desktop/src/renderer/features/bots/BotConnectionStatus.tsx, apps/desktop/src/renderer/features/bots/BotCreateMenu.tsx, apps/desktop/src/renderer/features/bots/BotDeleteDialog.tsx, apps/desktop/src/renderer/features/bots/BotDirectMessageCard.tsx, apps/desktop/src/renderer/features/bots/BotDirectMessageView.tsx, apps/desktop/src/renderer/features/bots/BotFollowMark.tsx, apps/desktop/src/renderer/features/bots/BotGenerationLabel.tsx, apps/desktop/src/renderer/features/bots/BotGroupAvatars.tsx, apps/desktop/src/renderer/features/bots/BotGroupChatView.tsx, apps/desktop/src/renderer/features/bots/BotGroupComposer.tsx, apps/desktop/src/renderer/features/bots/BotGroupCreateDialog.tsx, apps/desktop/src/renderer/features/bots/BotGroupPendingInteraction.tsx, apps/desktop/src/renderer/features/bots/BotGroupPlan.tsx, apps/desktop/src/renderer/features/bots/BotGroupSettingsDrawer.tsx, apps/desktop/src/renderer/features/bots/BotGroupSidebarRow.tsx, apps/desktop/src/renderer/features/bots/BotHistorySessionView.tsx, apps/desktop/src/renderer/features/bots/BotImportForm.tsx, apps/desktop/src/renderer/features/bots/BotInvitationWelcome.tsx, apps/desktop/src/renderer/features/bots/BotLearningFooter.tsx, apps/desktop/src/renderer/features/bots/BotLifecycleSettings.tsx, apps/desktop/src/renderer/features/bots/BotMemorySettings.tsx, apps/desktop/src/renderer/features/bots/BotModelChainEditor.tsx, apps/desktop/src/renderer/features/bots/BotPortraitPicker.tsx, apps/desktop/src/renderer/features/bots/BotRosterView.tsx, apps/desktop/src/renderer/features/bots/BotRoutines.tsx, apps/desktop/src/renderer/features/bots/BotSessionContentHeader.tsx, apps/desktop/src/renderer/features/bots/BotSessionTaskResultCard.tsx, apps/desktop/src/renderer/features/bots/BotSessionView.tsx, apps/desktop/src/renderer/features/bots/BotSettingsBlock.tsx, apps/desktop/src/renderer/features/bots/BotSettingsDrawer.tsx, apps/desktop/src/renderer/features/bots/BotTaskCardHeader.tsx, apps/desktop/src/renderer/features/bots/BotTaskModelEditor.tsx, apps/desktop/src/renderer/features/bots/BotWorkbench.tsx, apps/desktop/src/renderer/features/bots/BotWorkingStatus.tsx, apps/desktop/src/renderer/features/bots/BotsFeatureLayout.tsx, apps/desktop/src/renderer/features/bots/BotsGlobalSettingsSection.tsx, apps/desktop/src/renderer/features/bots/BotsHomeView.tsx, apps/desktop/src/renderer/features/bots/BotsListView.tsx, apps/desktop/src/renderer/features/bots/BotsSidebar.tsx, apps/desktop/src/renderer/features/bots/ChatBotAccessField.tsx, apps/desktop/src/renderer/features/bots/ChatGroupSettings.tsx, apps/desktop/src/renderer/features/bots/ChatServerControls.tsx, apps/desktop/src/renderer/features/bots/ChatThreadPanel.tsx, apps/desktop/src/renderer/features/bots/CindyDevicePicker.tsx, apps/desktop/src/renderer/features/bots/CindyDeviceRow.tsx, apps/desktop/src/renderer/features/bots/RemoteBotSessionView.tsx, apps/desktop/src/renderer/features/bots/RemoteBotSettings.tsx, apps/desktop/src/renderer/features/bots/botAvatarIdentity.ts, apps/desktop/src/renderer/features/bots/botCapabilityDefaults.ts, apps/desktop/src/renderer/features/bots/botChatPresentation.ts, apps/desktop/src/renderer/features/bots/botConversationPresentation.ts, apps/desktop/src/renderer/features/bots/botConversationTimeline.ts, apps/desktop/src/renderer/features/bots/botDelegationLive.ts, apps/desktop/src/renderer/features/bots/botFollowScopes.ts, apps/desktop/src/renderer/features/bots/botGeneratedArtifacts.ts, apps/desktop/src/renderer/features/bots/botGroupAttachments.ts, apps/desktop/src/renderer/features/bots/botGroupLane.ts, apps/desktop/src/renderer/features/bots/botGroupMentions.ts, apps/desktop/src/renderer/features/bots/botGroupPresentation.ts, apps/desktop/src/renderer/features/bots/botGroupStore.ts, apps/desktop/src/renderer/features/bots/botListDisplay.ts, apps/desktop/src/renderer/features/bots/botNavigation.ts, apps/desktop/src/renderer/features/bots/botPronounContext.tsx, apps/desktop/src/renderer/features/bots/botReadState.ts, apps/desktop/src/renderer/features/bots/botRosterDisplay.ts, apps/desktop/src/renderer/features/bots/botSessionOwners.ts, apps/desktop/src/renderer/features/bots/botSettingsAutosave.ts, apps/desktop/src/renderer/features/bots/botStore.ts, apps/desktop/src/renderer/features/bots/botWelcomeContext.ts, apps/desktop/src/renderer/features/bots/botWorkbenchProjection.ts, apps/desktop/src/renderer/features/bots/cindyDeviceRoster.ts, apps/desktop/src/renderer/features/bots/remoteBotRoster.ts, apps/desktop/src/renderer/features/bots/remoteBotSettingsData.ts, apps/desktop/src/renderer/features/bots/useBotGeneratedFileDeliveries.ts, apps/desktop/src/renderer/features/bots/useBotIslandVisibleSession.ts, apps/desktop/src/renderer/features/bots/useBotSettingsAutosave.ts, apps/desktop/src/renderer/features/bots/useBotUnreadSync.ts, apps/desktop/src/renderer/features/bots/useRemoteBots.ts, apps/desktop/src/renderer/features/bots/useWorkingStatusCopy.ts, apps/desktop/src/renderer/features/cc-agent/CCAgentFeatureLayout.tsx, apps/desktop/src/renderer/features/cc-agent/CCAgentSessionView.tsx | 277 | 38 | 469 || `desktop.chat.files` | desktop | 工作目录文件浏览 | hash `/cc-agent/files/:sessionId`(WorkdirBrowseRoute) | FileBodyView, FileTreeView, WorkdirBrowseRoute | apps/desktop/src/renderer/features/cc-agent/workdir-browse/DocSearchBar.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/DrawioPreview.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/FileBodyView.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/FileFilterInput.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/FileTabsBar.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/FileTreeView.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/FilterResultList.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/ImagePreview.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/OpenInSystemActions.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/PdfPreview.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/SessionTabsBar.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/UnrenderablePlaceholder.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/WorkdirBrowseRoute.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/WorkdirBrowseSidebar.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/hooks/useChatRailCollapsed.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/hooks/useChatRailResize.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/hooks/useConfirmSwitchAwayIfDirty.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/hooks/useDelayedFlag.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/hooks/useFileContent.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/hooks/useFileTree.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/hooks/useOpenTabs.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/hooks/useProjectFileList.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/hooks/useRevealFileInTree.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/activeFileBodyHandle.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/docModeSwitchProjects.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/drawioExt.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/expandedStore.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/fileContentCache.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/fileIcon.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/fileMeta.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/fileScrollStore.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/fileSelectionParams.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/filterFiles.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/imageExt.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/markdownAutosave.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/openTabsStore.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/pdfExt.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/selectedFileStore.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/search/SearchInput.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/search/SearchPanel.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/search/SearchResults.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/search/hooks/useProjectSearch.ts | 17 | 7 | 45 || `desktop.chat.new-draft` | desktop | 新建任务草稿页 | hash `/cc-agent/new`(NewMakerDraftRoute) | NewMakerDraftRoute | apps/desktop/src/renderer/features/cc-agent/NewMakerDraftRoute.tsx | 15 | 0 | 2 |-| `desktop.chat.orca-workflow` | desktop | Orca 协同工作台 | hash `/cc-agent/orca/:sessionId`(OrcaWorkflowRoute) | CCAgentSessionView, OrcaSplitView, OrcaWorkerPanel, OrcaWorkflowRoute | apps/desktop/src/renderer/components/chat/AgentActionRow.tsx, apps/desktop/src/renderer/components/chat/AgentActionsBlock.tsx, apps/desktop/src/renderer/components/chat/AgentTaskCard.tsx, apps/desktop/src/renderer/components/chat/AgentTaskLiveDetails.tsx, apps/desktop/src/renderer/components/chat/AnnotationStrokesSvg.tsx, apps/desktop/src/renderer/components/chat/AskUserQuestionBubble.tsx, apps/desktop/src/renderer/components/chat/AssistantMessage.tsx, apps/desktop/src/renderer/components/chat/AutomationOriginBadge.tsx, apps/desktop/src/renderer/components/chat/ChatAudioCard.tsx, apps/desktop/src/renderer/components/chat/ChatDisplaySnapshotContext.tsx, apps/desktop/src/renderer/components/chat/ChatImageView.tsx, apps/desktop/src/renderer/components/chat/ChatSessionFileContext.tsx, apps/desktop/src/renderer/components/chat/ChatSoundEffectCard.tsx, apps/desktop/src/renderer/components/chat/ChatVideoView.tsx, apps/desktop/src/renderer/components/chat/CindyMakeDoctorCard.tsx, apps/desktop/src/renderer/components/chat/CopyAsImageBlock.tsx, apps/desktop/src/renderer/components/chat/CredentialSwitchWaitBanner.tsx, apps/desktop/src/renderer/components/chat/DiffView.tsx, apps/desktop/src/renderer/components/chat/ErrorBanner.tsx, apps/desktop/src/renderer/components/chat/ErrorMessageCard.tsx, apps/desktop/src/renderer/components/chat/GeneratedFilesCard.tsx, apps/desktop/src/renderer/components/chat/GhostCardHostPrompts.tsx, apps/desktop/src/renderer/components/chat/GhostSummonCard.tsx, apps/desktop/src/renderer/components/chat/GhostToolCard.tsx, apps/desktop/src/renderer/components/chat/HookTaskCard.tsx, apps/desktop/src/renderer/components/chat/ImageGalleryContext.tsx, apps/desktop/src/renderer/components/chat/ImageHoverPreview.tsx, apps/desktop/src/renderer/components/chat/ImageLightbox.tsx, apps/desktop/src/renderer/components/chat/ImageMissingPlaceholder.tsx, apps/desktop/src/renderer/components/chat/InlineReferenceChip.tsx, apps/desktop/src/renderer/components/chat/InterruptedTurnBanner.tsx, apps/desktop/src/renderer/components/chat/JumpToBottomChip.tsx, apps/desktop/src/renderer/components/chat/MarkdownDiffBlock.tsx, apps/desktop/src/renderer/components/chat/MarkdownMermaidBlock.tsx, apps/desktop/src/renderer/components/chat/MarkdownRenderer.tsx, apps/desktop/src/renderer/components/chat/MermaidLightbox.tsx, apps/desktop/src/renderer/components/chat/MessageActionBar.tsx, apps/desktop/src/renderer/components/chat/MessageNavRail.tsx, apps/desktop/src/renderer/components/chat/MessageStream.tsx, apps/desktop/src/renderer/components/chat/MessageViewport.tsx, apps/desktop/src/renderer/components/chat/ModelLightbox.tsx, apps/desktop/src/renderer/components/chat/NewMessageIndicator.tsx, apps/desktop/src/renderer/components/chat/PlanReviewBubble.tsx, apps/desktop/src/renderer/components/chat/PrevMessageJumpChip.tsx, apps/desktop/src/renderer/components/chat/ProjectLinkChip.tsx, apps/desktop/src/renderer/components/chat/QuoteChip.tsx, apps/desktop/src/renderer/components/chat/RewindPreviewDialog.tsx, apps/desktop/src/renderer/components/chat/SelectionQuoteButton.tsx, apps/desktop/src/renderer/components/chat/SentAgentReferenceChip.tsx, apps/desktop/src/renderer/components/chat/SentInlineAtomBody.tsx, apps/desktop/src/renderer/components/chat/SessionHandoffCard.tsx, apps/desktop/src/renderer/components/chat/SessionLinkChip.tsx, apps/desktop/src/renderer/components/chat/ShareMessageCheckbox.tsx, apps/desktop/src/renderer/components/chat/ShareSelectionBar.tsx, apps/desktop/src/renderer/components/chat/SlackIcon.tsx, apps/desktop/src/renderer/components/chat/StreamFadeSpan.tsx, apps/desktop/src/renderer/components/chat/StreamingMarkdownChunk.tsx, apps/desktop/src/renderer/components/chat/SystemCard.tsx, apps/desktop/src/renderer/components/chat/TextLightbox.tsx, apps/desktop/src/renderer/components/chat/ThinkingCard.tsx, apps/desktop/src/renderer/components/chat/ThinkingText.tsx, apps/desktop/src/renderer/components/chat/TodoListCard.tsx, apps/desktop/src/renderer/components/chat/ToolCallCard.tsx, apps/desktop/src/renderer/components/chat/ToolPayloadLightbox.tsx, apps/desktop/src/renderer/components/chat/TopRightChipStack.tsx, apps/desktop/src/renderer/components/chat/TurnChangesCard.tsx, apps/desktop/src/renderer/components/chat/UnreadFailedScheduleBanner.tsx, apps/desktop/src/renderer/components/chat/UpgradeBanner.tsx, apps/desktop/src/renderer/components/chat/UserAttachmentChip.tsx, apps/desktop/src/renderer/components/chat/UserMessage.tsx, apps/desktop/src/renderer/components/chat/UserMessageEditBox.tsx, apps/desktop/src/renderer/components/chat/UserMessageUrlLink.tsx, apps/desktop/src/renderer/components/chat/VideoLightbox.tsx, apps/desktop/src/renderer/components/chat/WorkGroupBlock.tsx, apps/desktop/src/renderer/components/chat/WorktreeRestoreBanner.tsx, apps/desktop/src/renderer/components/chat/XIcon.tsx, apps/desktop/src/renderer/components/chat/activityRowChrome.ts, apps/desktop/src/renderer/components/chat/animateFocusScroll.ts, apps/desktop/src/renderer/components/chat/autoFollowIntent.ts, apps/desktop/src/renderer/components/chat/chatChrome.ts, apps/desktop/src/renderer/components/chat/errorReasonI18n.ts, apps/desktop/src/renderer/components/chat/generatedFilesProjection.ts, apps/desktop/src/renderer/components/chat/imageDisplaySize.ts, apps/desktop/src/renderer/components/chat/lightboxAnnotations.ts, apps/desktop/src/renderer/components/chat/lightboxGestures.ts, apps/desktop/src/renderer/components/chat/markdownImageTargets.ts, apps/desktop/src/renderer/components/chat/messageNavRailModel.ts, apps/desktop/src/renderer/components/chat/messageNavRailWheel.ts, apps/desktop/src/renderer/components/chat/messageNavigationProjection.ts, apps/desktop/src/renderer/components/chat/messageProjectionCache.ts, apps/desktop/src/renderer/components/chat/messageStreamIndicatorPosition.ts, apps/desktop/src/renderer/components/chat/messageViewportCompensation.ts, apps/desktop/src/renderer/components/chat/messageViewportGeometry.ts, apps/desktop/src/renderer/components/chat/messageWorkGroups.ts, apps/desktop/src/renderer/components/chat/observeProgrammaticScroll.ts, apps/desktop/src/renderer/components/chat/rehypeFencedCodeMarker.ts, apps/desktop/src/renderer/components/chat/rehypeHighlightShared.ts, apps/desktop/src/renderer/components/chat/rehypeMathBlockMarker.ts, apps/desktop/src/renderer/components/chat/rehypeStreamWordFade.ts, apps/desktop/src/renderer/components/chat/remarkHtmlImages.ts, apps/desktop/src/renderer/components/chat/remarkLocalPathLinks.ts, apps/desktop/src/renderer/components/chat/remarkPreserveRawLocalDestinations.ts, apps/desktop/src/renderer/components/chat/remarkSessionLinks.ts, apps/desktop/src/renderer/components/chat/remarkStrictInlineMath.ts, apps/desktop/src/renderer/components/chat/remarkTruncateCjkUrls.ts, apps/desktop/src/renderer/components/chat/repairStreamingMarkdown.ts, apps/desktop/src/renderer/components/chat/scrollAnchoringDetect.ts, apps/desktop/src/renderer/components/chat/shareSelectionStore.ts, apps/desktop/src/renderer/components/chat/streamingMarkdownBlocks.tsx, apps/desktop/src/renderer/components/chat/streamingMarkdownChunks.ts, apps/desktop/src/renderer/components/chat/streamingMessageProjection.ts, apps/desktop/src/renderer/components/chat/toolLoopI18n.ts, apps/desktop/src/renderer/components/chat/unreadCount.ts, apps/desktop/src/renderer/components/chat/useAutomaticHistoryLoadBudget.ts, apps/desktop/src/renderer/components/chat/useCopyAsImage.tsx, apps/desktop/src/renderer/components/chat/useDeleteMessage.ts, apps/desktop/src/renderer/components/chat/useFileChipContextMenu.tsx, apps/desktop/src/renderer/components/chat/useForkAtMessage.ts, apps/desktop/src/renderer/components/chat/useMessageViewport.ts, apps/desktop/src/renderer/components/chat/useNavigationKeyListener.ts, apps/desktop/src/renderer/components/chat/useOpenWithMenu.tsx, apps/desktop/src/renderer/components/chat/usePrevUserMessageInView.ts, apps/desktop/src/renderer/components/chat/useTurnChangeSets.ts, apps/desktop/src/renderer/components/chat/userMessageCollapse.ts, apps/desktop/src/renderer/components/chat/userMessageDisplayText.ts, apps/desktop/src/renderer/components/chat/userMessageLinkify.ts, apps/desktop/src/renderer/components/chat/viewportFillDetect.ts, apps/desktop/src/renderer/components/new-chat/AddRemoteProjectDialog.tsx, apps/desktop/src/renderer/components/new-chat/AgentSelect.tsx, apps/desktop/src/renderer/components/new-chat/AskUserQuestionPrompt.tsx, apps/desktop/src/renderer/components/new-chat/AtMentionPanel.tsx, apps/desktop/src/renderer/components/new-chat/AttachmentTypeThumb.tsx, apps/desktop/src/renderer/components/new-chat/ChatInput.tsx, apps/desktop/src/renderer/components/new-chat/CjkPunctDecoration.ts, apps/desktop/src/renderer/components/new-chat/CjkPunctuationUtils.ts, apps/desktop/src/renderer/components/new-chat/ComposerAttachments.tsx, apps/desktop/src/renderer/components/new-chat/ComposerListIndentDecoration.ts, apps/desktop/src/renderer/components/new-chat/ComposerListNodes.ts, apps/desktop/src/renderer/components/new-chat/ComposerQuoteNode.tsx, apps/desktop/src/renderer/components/new-chat/DeviceSwitcherPill.tsx, apps/desktop/src/renderer/components/new-chat/EffortSlider.tsx, apps/desktop/src/renderer/components/new-chat/EmptyDocSelectionGuard.ts, apps/desktop/src/renderer/components/new-chat/ExtraDirsButton.tsx, apps/desktop/src/renderer/components/new-chat/FastModeToggle.tsx, apps/desktop/src/renderer/components/new-chat/FolderPickerPopover.tsx, apps/desktop/src/renderer/components/new-chat/FullAccessConfirmContent.tsx, apps/desktop/src/renderer/components/new-chat/GhostCommandDecoration.ts, apps/desktop/src/renderer/components/new-chat/GoalAdvancedLimits.tsx, apps/desktop/src/renderer/components/new-chat/GoalIndicator.tsx, apps/desktop/src/renderer/components/new-chat/HomeUsageDashboard.tsx, apps/desktop/src/renderer/components/new-chat/ListComposerTextarea.tsx, apps/desktop/src/renderer/components/new-chat/LocalModelCatalogNotice.tsx, apps/desktop/src/renderer/components/new-chat/MentionChipNode.tsx, apps/desktop/src/renderer/components/new-chat/MentionDragCaretDecoration.ts, apps/desktop/src/renderer/components/new-chat/ModelCompatibilityNotice.tsx, apps/desktop/src/renderer/components/new-chat/ModelConfigFlyout.tsx, apps/desktop/src/renderer/components/new-chat/ModelHarnessPicker.tsx, apps/desktop/src/renderer/components/new-chat/ModelSelector.tsx, apps/desktop/src/renderer/components/new-chat/ModelSourceDetails.tsx, apps/desktop/src/renderer/components/new-chat/NewGoalDialog.tsx, apps/desktop/src/renderer/components/new-chat/PastedTextChipNode.tsx, apps/desktop/src/renderer/components/new-chat/PendingQueuePanel.tsx, apps/desktop/src/renderer/components/new-chat/PermissionPrompt.tsx, apps/desktop/src/renderer/components/new-chat/PermissionSelector.tsx, apps/desktop/src/renderer/components/new-chat/PinnedPlanPanel.tsx, apps/desktop/src/renderer/components/new-chat/PlanActionCard.tsx, apps/desktop/src/renderer/components/new-chat/PlanModeIndicator.tsx, apps/desktop/src/renderer/components/new-chat/PlanViewerCard.tsx, apps/desktop/src/renderer/components/new-chat/PluginConnectionForm.tsx, apps/desktop/src/renderer/components/new-chat/PluginOauthDeviceCode.tsx, apps/desktop/src/renderer/components/new-chat/PluginSetupPrompt.tsx, apps/desktop/src/renderer/components/new-chat/PluginWriteAccessRecovery.tsx, apps/desktop/src/renderer/components/new-chat/QuickStartPillMark.ts, apps/desktop/src/renderer/components/new-chat/RemoteOauthSetupCard.tsx, apps/desktop/src/renderer/components/new-chat/SendButton.tsx, apps/desktop/src/renderer/components/new-chat/SlashCommandDecoration.ts, apps/desktop/src/renderer/components/new-chat/SlashCommandPalette.tsx, apps/desktop/src/renderer/components/new-chat/TakeoverMask.tsx, apps/desktop/src/renderer/components/new-chat/ThinkingToggle.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedFlyoutHost.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelPanel.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelRail.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelRow.tsx, apps/desktop/src/renderer/components/new-chat/UsageDailyBars.tsx, apps/desktop/src/renderer/components/new-chat/UsageHeatmap.tsx, apps/desktop/src/renderer/components/new-chat/VendorSegmentedSwitcher.tsx, apps/desktop/src/renderer/components/new-chat/VoiceInputDraftDecoration.ts, apps/desktop/src/renderer/components/new-chat/WindowsSelectionReplacement.ts, apps/desktop/src/renderer/components/new-chat/WorktreeChipsRow.tsx, apps/desktop/src/renderer/components/new-chat/WorktreeCreatingOverlay.tsx, apps/desktop/src/renderer/components/new-chat/agentOptions.ts, apps/desktop/src/renderer/components/new-chat/agentSwitchConfirmation.ts, apps/desktop/src/renderer/components/new-chat/branchPick.ts, apps/desktop/src/renderer/components/new-chat/composerBlankPointerFocus.ts, apps/desktop/src/renderer/components/new-chat/composerContentSerialization.ts, apps/desktop/src/renderer/components/new-chat/composerDocState.ts, apps/desktop/src/renderer/components/new-chat/composerFrameScheduler.ts, apps/desktop/src/renderer/components/new-chat/composerHistoryProjection.ts, apps/desktop/src/renderer/components/new-chat/composerModelSelection.ts, apps/desktop/src/renderer/components/new-chat/composerPromptRecommendation.ts, apps/desktop/src/renderer/components/new-chat/composerRenderGate.ts, apps/desktop/src/renderer/components/new-chat/composerSendOwnership.ts, apps/desktop/src/renderer/components/new-chat/composerSendSnapshot.ts, apps/desktop/src/renderer/components/new-chat/effortChangeQueue.ts, apps/desktop/src/renderer/components/new-chat/extraDirsActions.ts, apps/desktop/src/renderer/components/new-chat/ghostComposerPlacement.ts, apps/desktop/src/renderer/components/new-chat/localAttachmentPicker.ts, apps/desktop/src/renderer/components/new-chat/mentionChipInsertion.ts, apps/desktop/src/renderer/components/new-chat/modelWindowErrorToast.ts, apps/desktop/src/renderer/components/new-chat/pastePipeline.ts, apps/desktop/src/renderer/components/new-chat/pathPaste.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueLocks.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueRowActivity.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueRowPresentation.ts, apps/desktop/src/renderer/components/new-chat/planModeComposerCommand.ts, apps/desktop/src/renderer/components/new-chat/priceTierMarks.tsx, apps/desktop/src/renderer/components/new-chat/remoteBrowseAdapters.ts, apps/desktop/src/renderer/components/new-chat/remoteExistingProjects.ts, apps/desktop/src/renderer/components/new-chat/restoreComposerDocument.ts, apps/desktop/src/renderer/components/new-chat/sessionLinkPaste.ts, apps/desktop/src/renderer/components/new-chat/sourceSwitch.ts, apps/desktop/src/renderer/components/new-chat/unifiedModelSelection.ts, apps/desktop/src/renderer/components/new-chat/usagePalette.ts, apps/desktop/src/renderer/components/new-chat/useComposerSendFocusRestore.ts, apps/desktop/src/renderer/components/new-chat/useModelDiscoveryPending.ts, apps/desktop/src/renderer/components/new-chat/useProviderWeeklyQuota.ts, apps/desktop/src/renderer/components/new-chat/useUnifiedRowActions.ts, apps/desktop/src/renderer/features/cc-agent/CCAgentFeatureLayout.tsx, apps/desktop/src/renderer/features/cc-agent/CCAgentSessionView.tsx, apps/desktop/src/renderer/features/cc-agent/OrcaSplitView.tsx, apps/desktop/src/renderer/features/cc-agent/OrcaWorkerPanel.tsx, apps/desktop/src/renderer/features/cc-agent/OrcaWorkflowRoute.tsx | 252 | 38 | 337 |+| `desktop.chat.orca-workflow` | desktop | Orca 协同工作台 | hash `/cc-agent/orca/:sessionId`(OrcaWorkflowRoute) | CCAgentSessionView, OrcaSplitView, OrcaWorkerPanel, OrcaWorkflowRoute | apps/desktop/src/renderer/components/chat/AgentActionRow.tsx, apps/desktop/src/renderer/components/chat/AgentActionsBlock.tsx, apps/desktop/src/renderer/components/chat/AgentTaskCard.tsx, apps/desktop/src/renderer/components/chat/AgentTaskLiveDetails.tsx, apps/desktop/src/renderer/components/chat/AnnotationStrokesSvg.tsx, apps/desktop/src/renderer/components/chat/AskUserQuestionBubble.tsx, apps/desktop/src/renderer/components/chat/AssistantMessage.tsx, apps/desktop/src/renderer/components/chat/AutomationOriginBadge.tsx, apps/desktop/src/renderer/components/chat/ChatAudioCard.tsx, apps/desktop/src/renderer/components/chat/ChatDisplaySnapshotContext.tsx, apps/desktop/src/renderer/components/chat/ChatImageView.tsx, apps/desktop/src/renderer/components/chat/ChatSessionFileContext.tsx, apps/desktop/src/renderer/components/chat/ChatSoundEffectCard.tsx, apps/desktop/src/renderer/components/chat/ChatVideoView.tsx, apps/desktop/src/renderer/components/chat/CindyMakeDoctorCard.tsx, apps/desktop/src/renderer/components/chat/CopyAsImageBlock.tsx, apps/desktop/src/renderer/components/chat/CredentialSwitchWaitBanner.tsx, apps/desktop/src/renderer/components/chat/DiffView.tsx, apps/desktop/src/renderer/components/chat/ErrorBanner.tsx, apps/desktop/src/renderer/components/chat/ErrorMessageCard.tsx, apps/desktop/src/renderer/components/chat/GeneratedFilesCard.tsx, apps/desktop/src/renderer/components/chat/GhostCardHostPrompts.tsx, apps/desktop/src/renderer/components/chat/GhostSummonCard.tsx, apps/desktop/src/renderer/components/chat/GhostToolCard.tsx, apps/desktop/src/renderer/components/chat/HookTaskCard.tsx, apps/desktop/src/renderer/components/chat/ImageGalleryContext.tsx, apps/desktop/src/renderer/components/chat/ImageHoverPreview.tsx, apps/desktop/src/renderer/components/chat/ImageLightbox.tsx, apps/desktop/src/renderer/components/chat/ImageMissingPlaceholder.tsx, apps/desktop/src/renderer/components/chat/InlineReferenceChip.tsx, apps/desktop/src/renderer/components/chat/InterruptedTurnBanner.tsx, apps/desktop/src/renderer/components/chat/JumpToBottomChip.tsx, apps/desktop/src/renderer/components/chat/MarkdownDiffBlock.tsx, apps/desktop/src/renderer/components/chat/MarkdownMermaidBlock.tsx, apps/desktop/src/renderer/components/chat/MarkdownRenderer.tsx, apps/desktop/src/renderer/components/chat/MermaidLightbox.tsx, apps/desktop/src/renderer/components/chat/MessageActionBar.tsx, apps/desktop/src/renderer/components/chat/MessageNavRail.tsx, apps/desktop/src/renderer/components/chat/MessageStream.tsx, apps/desktop/src/renderer/components/chat/MessageViewport.tsx, apps/desktop/src/renderer/components/chat/ModelLightbox.tsx, apps/desktop/src/renderer/components/chat/NewMessageIndicator.tsx, apps/desktop/src/renderer/components/chat/PlanReviewBubble.tsx, apps/desktop/src/renderer/components/chat/PrevMessageJumpChip.tsx, apps/desktop/src/renderer/components/chat/ProjectLinkChip.tsx, apps/desktop/src/renderer/components/chat/QuoteChip.tsx, apps/desktop/src/renderer/components/chat/RewindPreviewDialog.tsx, apps/desktop/src/renderer/components/chat/SelectionQuoteButton.tsx, apps/desktop/src/renderer/components/chat/SentAgentReferenceChip.tsx, apps/desktop/src/renderer/components/chat/SentInlineAtomBody.tsx, apps/desktop/src/renderer/components/chat/SessionHandoffCard.tsx, apps/desktop/src/renderer/components/chat/SessionLinkChip.tsx, apps/desktop/src/renderer/components/chat/ShareMessageCheckbox.tsx, apps/desktop/src/renderer/components/chat/ShareSelectionBar.tsx, apps/desktop/src/renderer/components/chat/SlackIcon.tsx, apps/desktop/src/renderer/components/chat/StreamFadeSpan.tsx, apps/desktop/src/renderer/components/chat/StreamingMarkdownChunk.tsx, apps/desktop/src/renderer/components/chat/SystemCard.tsx, apps/desktop/src/renderer/components/chat/TextLightbox.tsx, apps/desktop/src/renderer/components/chat/ThinkingCard.tsx, apps/desktop/src/renderer/components/chat/ThinkingText.tsx, apps/desktop/src/renderer/components/chat/TodoListCard.tsx, apps/desktop/src/renderer/components/chat/ToolCallCard.tsx, apps/desktop/src/renderer/components/chat/ToolPayloadLightbox.tsx, apps/desktop/src/renderer/components/chat/TopRightChipStack.tsx, apps/desktop/src/renderer/components/chat/TurnChangesCard.tsx, apps/desktop/src/renderer/components/chat/UnreadFailedScheduleBanner.tsx, apps/desktop/src/renderer/components/chat/UpgradeBanner.tsx, apps/desktop/src/renderer/components/chat/UserAttachmentChip.tsx, apps/desktop/src/renderer/components/chat/UserMessage.tsx, apps/desktop/src/renderer/components/chat/UserMessageEditBox.tsx, apps/desktop/src/renderer/components/chat/UserMessageUrlLink.tsx, apps/desktop/src/renderer/components/chat/VideoLightbox.tsx, apps/desktop/src/renderer/components/chat/WorkGroupBlock.tsx, apps/desktop/src/renderer/components/chat/WorktreeRestoreBanner.tsx, apps/desktop/src/renderer/components/chat/XIcon.tsx, apps/desktop/src/renderer/components/chat/activityRowChrome.ts, apps/desktop/src/renderer/components/chat/animateFocusScroll.ts, apps/desktop/src/renderer/components/chat/autoFollowIntent.ts, apps/desktop/src/renderer/components/chat/chatChrome.ts, apps/desktop/src/renderer/components/chat/errorReasonI18n.ts, apps/desktop/src/renderer/components/chat/generatedFilesProjection.ts, apps/desktop/src/renderer/components/chat/imageDisplaySize.ts, apps/desktop/src/renderer/components/chat/lightboxAnnotations.ts, apps/desktop/src/renderer/components/chat/lightboxGestures.ts, apps/desktop/src/renderer/components/chat/markdownImageTargets.ts, apps/desktop/src/renderer/components/chat/messageNavRailModel.ts, apps/desktop/src/renderer/components/chat/messageNavRailWheel.ts, apps/desktop/src/renderer/components/chat/messageNavigationProjection.ts, apps/desktop/src/renderer/components/chat/messageProjectionCache.ts, apps/desktop/src/renderer/components/chat/messageStreamIndicatorPosition.ts, apps/desktop/src/renderer/components/chat/messageViewportCompensation.ts, apps/desktop/src/renderer/components/chat/messageViewportGeometry.ts, apps/desktop/src/renderer/components/chat/messageWorkGroups.ts, apps/desktop/src/renderer/components/chat/observeProgrammaticScroll.ts, apps/desktop/src/renderer/components/chat/rehypeFencedCodeMarker.ts, apps/desktop/src/renderer/components/chat/rehypeHighlightShared.ts, apps/desktop/src/renderer/components/chat/rehypeMathBlockMarker.ts, apps/desktop/src/renderer/components/chat/rehypeStreamWordFade.ts, apps/desktop/src/renderer/components/chat/remarkHtmlImages.ts, apps/desktop/src/renderer/components/chat/remarkLocalPathLinks.ts, apps/desktop/src/renderer/components/chat/remarkPreserveRawLocalDestinations.ts, apps/desktop/src/renderer/components/chat/remarkSessionLinks.ts, apps/desktop/src/renderer/components/chat/remarkStrictInlineMath.ts, apps/desktop/src/renderer/components/chat/remarkTruncateCjkUrls.ts, apps/desktop/src/renderer/components/chat/repairStreamingMarkdown.ts, apps/desktop/src/renderer/components/chat/scrollAnchoringDetect.ts, apps/desktop/src/renderer/components/chat/shareSelectionStore.ts, apps/desktop/src/renderer/components/chat/streamingMarkdownBlocks.tsx, apps/desktop/src/renderer/components/chat/streamingMarkdownChunks.ts, apps/desktop/src/renderer/components/chat/streamingMessageProjection.ts, apps/desktop/src/renderer/components/chat/toolLoopI18n.ts, apps/desktop/src/renderer/components/chat/unreadCount.ts, apps/desktop/src/renderer/components/chat/useAutomaticHistoryLoadBudget.ts, apps/desktop/src/renderer/components/chat/useCopyAsImage.tsx, apps/desktop/src/renderer/components/chat/useDeleteMessage.ts, apps/desktop/src/renderer/components/chat/useFileChipContextMenu.tsx, apps/desktop/src/renderer/components/chat/useForkAtMessage.ts, apps/desktop/src/renderer/components/chat/useMessageViewport.ts, apps/desktop/src/renderer/components/chat/useNavigationKeyListener.ts, apps/desktop/src/renderer/components/chat/useOpenWithMenu.tsx, apps/desktop/src/renderer/components/chat/usePrevUserMessageInView.ts, apps/desktop/src/renderer/components/chat/useTurnChangeSets.ts, apps/desktop/src/renderer/components/chat/userMessageCollapse.ts, apps/desktop/src/renderer/components/chat/userMessageDisplayText.ts, apps/desktop/src/renderer/components/chat/userMessageLinkify.ts, apps/desktop/src/renderer/components/chat/viewportFillDetect.ts, apps/desktop/src/renderer/components/new-chat/AddRemoteProjectDialog.tsx, apps/desktop/src/renderer/components/new-chat/AgentSelect.tsx, apps/desktop/src/renderer/components/new-chat/AskUserQuestionPrompt.tsx, apps/desktop/src/renderer/components/new-chat/AtMentionPanel.tsx, apps/desktop/src/renderer/components/new-chat/AttachmentTypeThumb.tsx, apps/desktop/src/renderer/components/new-chat/ChatInput.tsx, apps/desktop/src/renderer/components/new-chat/CjkPunctDecoration.ts, apps/desktop/src/renderer/components/new-chat/CjkPunctuationUtils.ts, apps/desktop/src/renderer/components/new-chat/ComposerAttachments.tsx, apps/desktop/src/renderer/components/new-chat/ComposerListIndentDecoration.ts, apps/desktop/src/renderer/components/new-chat/ComposerListNodes.ts, apps/desktop/src/renderer/components/new-chat/ComposerQuoteNode.tsx, apps/desktop/src/renderer/components/new-chat/DeviceSwitcherPill.tsx, apps/desktop/src/renderer/components/new-chat/EffortSlider.tsx, apps/desktop/src/renderer/components/new-chat/EmptyDocSelectionGuard.ts, apps/desktop/src/renderer/components/new-chat/ExtraDirsButton.tsx, apps/desktop/src/renderer/components/new-chat/FastModeToggle.tsx, apps/desktop/src/renderer/components/new-chat/FolderPickerPopover.tsx, apps/desktop/src/renderer/components/new-chat/FullAccessConfirmContent.tsx, apps/desktop/src/renderer/components/new-chat/GhostCommandDecoration.ts, apps/desktop/src/renderer/components/new-chat/GoalAdvancedLimits.tsx, apps/desktop/src/renderer/components/new-chat/GoalIndicator.tsx, apps/desktop/src/renderer/components/new-chat/HomeUsageDashboard.tsx, apps/desktop/src/renderer/components/new-chat/ListComposerTextarea.tsx, apps/desktop/src/renderer/components/new-chat/LocalModelCatalogNotice.tsx, apps/desktop/src/renderer/components/new-chat/MentionChipNode.tsx, apps/desktop/src/renderer/components/new-chat/MentionDragCaretDecoration.ts, apps/desktop/src/renderer/components/new-chat/ModelCompatibilityNotice.tsx, apps/desktop/src/renderer/components/new-chat/ModelConfigFlyout.tsx, apps/desktop/src/renderer/components/new-chat/ModelHarnessPicker.tsx, apps/desktop/src/renderer/components/new-chat/ModelSelector.tsx, apps/desktop/src/renderer/components/new-chat/ModelSourceDetails.tsx, apps/desktop/src/renderer/components/new-chat/NewGoalDialog.tsx, apps/desktop/src/renderer/components/new-chat/PastedTextChipNode.tsx, apps/desktop/src/renderer/components/new-chat/PendingQueuePanel.tsx, apps/desktop/src/renderer/components/new-chat/PermissionPrompt.tsx, apps/desktop/src/renderer/components/new-chat/PermissionSelector.tsx, apps/desktop/src/renderer/components/new-chat/PinnedPlanPanel.tsx, apps/desktop/src/renderer/components/new-chat/PlanActionCard.tsx, apps/desktop/src/renderer/components/new-chat/PlanModeIndicator.tsx, apps/desktop/src/renderer/components/new-chat/PlanViewerCard.tsx, apps/desktop/src/renderer/components/new-chat/PluginConnectionForm.tsx, apps/desktop/src/renderer/components/new-chat/PluginOauthDeviceCode.tsx, apps/desktop/src/renderer/components/new-chat/PluginSetupPrompt.tsx, apps/desktop/src/renderer/components/new-chat/PluginSetupRemoteDesktopButton.tsx, apps/desktop/src/renderer/components/new-chat/PluginWriteAccessRecovery.tsx, apps/desktop/src/renderer/components/new-chat/QuickStartPillMark.ts, apps/desktop/src/renderer/components/new-chat/RemoteOauthSetupCard.tsx, apps/desktop/src/renderer/components/new-chat/SendButton.tsx, apps/desktop/src/renderer/components/new-chat/SlashCommandDecoration.ts, apps/desktop/src/renderer/components/new-chat/SlashCommandPalette.tsx, apps/desktop/src/renderer/components/new-chat/TakeoverMask.tsx, apps/desktop/src/renderer/components/new-chat/ThinkingToggle.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedFlyoutHost.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelPanel.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelRail.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelRow.tsx, apps/desktop/src/renderer/components/new-chat/UsageDailyBars.tsx, apps/desktop/src/renderer/components/new-chat/UsageHeatmap.tsx, apps/desktop/src/renderer/components/new-chat/VendorSegmentedSwitcher.tsx, apps/desktop/src/renderer/components/new-chat/VoiceInputDraftDecoration.ts, apps/desktop/src/renderer/components/new-chat/WindowsSelectionReplacement.ts, apps/desktop/src/renderer/components/new-chat/WorktreeChipsRow.tsx, apps/desktop/src/renderer/components/new-chat/WorktreeCreatingOverlay.tsx, apps/desktop/src/renderer/components/new-chat/agentOptions.ts, apps/desktop/src/renderer/components/new-chat/agentSwitchConfirmation.ts, apps/desktop/src/renderer/components/new-chat/branchPick.ts, apps/desktop/src/renderer/components/new-chat/composerBlankPointerFocus.ts, apps/desktop/src/renderer/components/new-chat/composerContentSerialization.ts, apps/desktop/src/renderer/components/new-chat/composerDocState.ts, apps/desktop/src/renderer/components/new-chat/composerFrameScheduler.ts, apps/desktop/src/renderer/components/new-chat/composerHistoryProjection.ts, apps/desktop/src/renderer/components/new-chat/composerModelSelection.ts, apps/desktop/src/renderer/components/new-chat/composerPromptRecommendation.ts, apps/desktop/src/renderer/components/new-chat/composerRenderGate.ts, apps/desktop/src/renderer/components/new-chat/composerSendOwnership.ts, apps/desktop/src/renderer/components/new-chat/composerSendSnapshot.ts, apps/desktop/src/renderer/components/new-chat/effortChangeQueue.ts, apps/desktop/src/renderer/components/new-chat/extraDirsActions.ts, apps/desktop/src/renderer/components/new-chat/ghostComposerPlacement.ts, apps/desktop/src/renderer/components/new-chat/localAttachmentPicker.ts, apps/desktop/src/renderer/components/new-chat/mentionChipInsertion.ts, apps/desktop/src/renderer/components/new-chat/modelWindowErrorToast.ts, apps/desktop/src/renderer/components/new-chat/pastePipeline.ts, apps/desktop/src/renderer/components/new-chat/pathPaste.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueLocks.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueRowActivity.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueRowPresentation.ts, apps/desktop/src/renderer/components/new-chat/planModeComposerCommand.ts, apps/desktop/src/renderer/components/new-chat/priceTierMarks.tsx, apps/desktop/src/renderer/components/new-chat/remoteBrowseAdapters.ts, apps/desktop/src/renderer/components/new-chat/remoteExistingProjects.ts, apps/desktop/src/renderer/components/new-chat/restoreComposerDocument.ts, apps/desktop/src/renderer/components/new-chat/sessionLinkPaste.ts, apps/desktop/src/renderer/components/new-chat/sourceSwitch.ts, apps/desktop/src/renderer/components/new-chat/unifiedModelSelection.ts, apps/desktop/src/renderer/components/new-chat/usagePalette.ts, apps/desktop/src/renderer/components/new-chat/useComposerSendFocusRestore.ts, apps/desktop/src/renderer/components/new-chat/useModelDiscoveryPending.ts, apps/desktop/src/renderer/components/new-chat/useProviderWeeklyQuota.ts, apps/desktop/src/renderer/components/new-chat/useUnifiedRowActions.ts, apps/desktop/src/renderer/features/cc-agent/CCAgentFeatureLayout.tsx, apps/desktop/src/renderer/features/cc-agent/CCAgentSessionView.tsx, apps/desktop/src/renderer/features/cc-agent/OrcaSplitView.tsx, apps/desktop/src/renderer/features/cc-agent/OrcaWorkerPanel.tsx, apps/desktop/src/renderer/features/cc-agent/OrcaWorkflowRoute.tsx | 252 | 38 | 337 || `desktop.chat.scheduled` | desktop | 调度任务列表 | hash `/cc-agent/scheduled`(SchedulerPage) | SchedulerPage | apps/desktop/src/renderer/features/scheduler/SchedulerPage.tsx, apps/desktop/src/renderer/features/scheduler/components/AgentMark.tsx, apps/desktop/src/renderer/features/scheduler/components/BoundSessionCard.tsx, apps/desktop/src/renderer/features/scheduler/components/ProjectAutomationNotifyBridge.tsx, apps/desktop/src/renderer/features/scheduler/components/RunHistoryCard.tsx, apps/desktop/src/renderer/features/scheduler/components/RunHistoryPane.tsx, apps/desktop/src/renderer/features/scheduler/components/ScheduleChips.tsx, apps/desktop/src/renderer/features/scheduler/components/ScheduleFormDialog.tsx, apps/desktop/src/renderer/features/scheduler/components/ScheduleSessionIndexOwner.tsx, apps/desktop/src/renderer/features/scheduler/components/ScheduleStatusChip.tsx, apps/desktop/src/renderer/features/scheduler/components/ScriptCapabilityMultiSelect.tsx, apps/desktop/src/renderer/features/scheduler/components/TaskListCell.tsx, apps/desktop/src/renderer/features/scheduler/components/TaskListFilterPopover.tsx, apps/desktop/src/renderer/features/scheduler/components/TaskListPane.tsx, apps/desktop/src/renderer/features/scheduler/components/TemplateCard.tsx, apps/desktop/src/renderer/features/scheduler/components/TemplateGallery.tsx, apps/desktop/src/renderer/features/scheduler/components/TemplateParamForm.tsx, apps/desktop/src/renderer/features/scheduler/hooks/useDeleteScheduleWithSessions.tsx, apps/desktop/src/renderer/features/scheduler/hooks/useReadFailedScheduleRuns.ts, apps/desktop/src/renderer/features/scheduler/hooks/useRunNowBusyGuard.ts, apps/desktop/src/renderer/features/scheduler/hooks/useRuns.ts, apps/desktop/src/renderer/features/scheduler/hooks/useScheduleForm.ts, apps/desktop/src/renderer/features/scheduler/hooks/useScheduleUnreadRunCounts.ts, apps/desktop/src/renderer/features/scheduler/hooks/useSchedules.ts, apps/desktop/src/renderer/features/scheduler/hooks/useSessionReferences.ts, apps/desktop/src/renderer/features/scheduler/hooks/useTemplates.ts, apps/desktop/src/renderer/features/scheduler/index.ts, apps/desktop/src/renderer/features/scheduler/lib/cronCodexPreset.ts, apps/desktop/src/renderer/features/scheduler/lib/cronToHuman.ts, apps/desktop/src/renderer/features/scheduler/lib/failedScheduleDismissal.ts, apps/desktop/src/renderer/features/scheduler/lib/formatters.ts, apps/desktop/src/renderer/features/scheduler/lib/pluginScheduleCreateIntent.ts, apps/desktop/src/renderer/features/scheduler/lib/projectAutomationConfig.ts, apps/desktop/src/renderer/features/scheduler/lib/projectScheduleSidebarIndex.ts, apps/desktop/src/renderer/features/scheduler/lib/runHistoryGrouping.ts, apps/desktop/src/renderer/features/scheduler/lib/runUnread.ts, apps/desktop/src/renderer/features/scheduler/lib/scheduleFormLogic.ts, apps/desktop/src/renderer/features/scheduler/lib/scheduleRunReadSync.ts, apps/desktop/src/renderer/features/scheduler/lib/scheduleSessionBinding.ts, apps/desktop/src/renderer/features/scheduler/lib/scheduleSidebarIndexRuns.ts, apps/desktop/src/renderer/features/scheduler/lib/schedulesStore.ts, apps/desktop/src/renderer/features/scheduler/lib/statusFilter.ts, apps/desktop/src/renderer/features/scheduler/lib/statusFilterStorage.ts, apps/desktop/src/renderer/features/scheduler/lib/templateLocalization.ts, apps/desktop/src/renderer/features/scheduler/lib/usageLimitScheduleCreateIntent.ts | 34 | 0 | 90 |-| `desktop.chat.session` | desktop | 会话工作台 | hash `/cc-agent/:sessionId`;副窗经 `/cc-agent/boot` 解析后落到同一会话视图 | AssistantMessage, CCAgentFeatureLayout, CCAgentSessionView, ChatInput, PermissionPrompt | apps/desktop/src/renderer/components/chat/AgentActionRow.tsx, apps/desktop/src/renderer/components/chat/AgentActionsBlock.tsx, apps/desktop/src/renderer/components/chat/AgentTaskCard.tsx, apps/desktop/src/renderer/components/chat/AgentTaskLiveDetails.tsx, apps/desktop/src/renderer/components/chat/AnnotationStrokesSvg.tsx, apps/desktop/src/renderer/components/chat/AskUserQuestionBubble.tsx, apps/desktop/src/renderer/components/chat/AssistantMessage.tsx, apps/desktop/src/renderer/components/chat/AutomationOriginBadge.tsx, apps/desktop/src/renderer/components/chat/ChatAudioCard.tsx, apps/desktop/src/renderer/components/chat/ChatDisplaySnapshotContext.tsx, apps/desktop/src/renderer/components/chat/ChatImageView.tsx, apps/desktop/src/renderer/components/chat/ChatSessionFileContext.tsx, apps/desktop/src/renderer/components/chat/ChatSoundEffectCard.tsx, apps/desktop/src/renderer/components/chat/ChatVideoView.tsx, apps/desktop/src/renderer/components/chat/CindyMakeDoctorCard.tsx, apps/desktop/src/renderer/components/chat/CopyAsImageBlock.tsx, apps/desktop/src/renderer/components/chat/CredentialSwitchWaitBanner.tsx, apps/desktop/src/renderer/components/chat/DiffView.tsx, apps/desktop/src/renderer/components/chat/ErrorBanner.tsx, apps/desktop/src/renderer/components/chat/ErrorMessageCard.tsx, apps/desktop/src/renderer/components/chat/GeneratedFilesCard.tsx, apps/desktop/src/renderer/components/chat/GhostCardHostPrompts.tsx, apps/desktop/src/renderer/components/chat/GhostSummonCard.tsx, apps/desktop/src/renderer/components/chat/GhostToolCard.tsx, apps/desktop/src/renderer/components/chat/HookTaskCard.tsx, apps/desktop/src/renderer/components/chat/ImageGalleryContext.tsx, apps/desktop/src/renderer/components/chat/ImageHoverPreview.tsx, apps/desktop/src/renderer/components/chat/ImageLightbox.tsx, apps/desktop/src/renderer/components/chat/ImageMissingPlaceholder.tsx, apps/desktop/src/renderer/components/chat/InlineReferenceChip.tsx, apps/desktop/src/renderer/components/chat/InterruptedTurnBanner.tsx, apps/desktop/src/renderer/components/chat/JumpToBottomChip.tsx, apps/desktop/src/renderer/components/chat/MarkdownDiffBlock.tsx, apps/desktop/src/renderer/components/chat/MarkdownMermaidBlock.tsx, apps/desktop/src/renderer/components/chat/MarkdownRenderer.tsx, apps/desktop/src/renderer/components/chat/MermaidLightbox.tsx, apps/desktop/src/renderer/components/chat/MessageActionBar.tsx, apps/desktop/src/renderer/components/chat/MessageNavRail.tsx, apps/desktop/src/renderer/components/chat/MessageStream.tsx, apps/desktop/src/renderer/components/chat/MessageViewport.tsx, apps/desktop/src/renderer/components/chat/ModelLightbox.tsx, apps/desktop/src/renderer/components/chat/NewMessageIndicator.tsx, apps/desktop/src/renderer/components/chat/PlanReviewBubble.tsx, apps/desktop/src/renderer/components/chat/PrevMessageJumpChip.tsx, apps/desktop/src/renderer/components/chat/ProjectLinkChip.tsx, apps/desktop/src/renderer/components/chat/QuoteChip.tsx, apps/desktop/src/renderer/components/chat/RewindPreviewDialog.tsx, apps/desktop/src/renderer/components/chat/SelectionQuoteButton.tsx, apps/desktop/src/renderer/components/chat/SentAgentReferenceChip.tsx, apps/desktop/src/renderer/components/chat/SentInlineAtomBody.tsx, apps/desktop/src/renderer/components/chat/SessionHandoffCard.tsx, apps/desktop/src/renderer/components/chat/SessionLinkChip.tsx, apps/desktop/src/renderer/components/chat/ShareMessageCheckbox.tsx, apps/desktop/src/renderer/components/chat/ShareSelectionBar.tsx, apps/desktop/src/renderer/components/chat/SlackIcon.tsx, apps/desktop/src/renderer/components/chat/StreamFadeSpan.tsx, apps/desktop/src/renderer/components/chat/StreamingMarkdownChunk.tsx, apps/desktop/src/renderer/components/chat/SystemCard.tsx, apps/desktop/src/renderer/components/chat/TextLightbox.tsx, apps/desktop/src/renderer/components/chat/ThinkingCard.tsx, apps/desktop/src/renderer/components/chat/ThinkingText.tsx, apps/desktop/src/renderer/components/chat/TodoListCard.tsx, apps/desktop/src/renderer/components/chat/ToolCallCard.tsx, apps/desktop/src/renderer/components/chat/ToolPayloadLightbox.tsx, apps/desktop/src/renderer/components/chat/TopRightChipStack.tsx, apps/desktop/src/renderer/components/chat/TurnChangesCard.tsx, apps/desktop/src/renderer/components/chat/UnreadFailedScheduleBanner.tsx, apps/desktop/src/renderer/components/chat/UpgradeBanner.tsx, apps/desktop/src/renderer/components/chat/UserAttachmentChip.tsx, apps/desktop/src/renderer/components/chat/UserMessage.tsx, apps/desktop/src/renderer/components/chat/UserMessageEditBox.tsx, apps/desktop/src/renderer/components/chat/UserMessageUrlLink.tsx, apps/desktop/src/renderer/components/chat/VideoLightbox.tsx, apps/desktop/src/renderer/components/chat/WorkGroupBlock.tsx, apps/desktop/src/renderer/components/chat/WorktreeRestoreBanner.tsx, apps/desktop/src/renderer/components/chat/XIcon.tsx, apps/desktop/src/renderer/components/chat/activityRowChrome.ts, apps/desktop/src/renderer/components/chat/animateFocusScroll.ts, apps/desktop/src/renderer/components/chat/autoFollowIntent.ts, apps/desktop/src/renderer/components/chat/chatChrome.ts, apps/desktop/src/renderer/components/chat/errorReasonI18n.ts, apps/desktop/src/renderer/components/chat/generatedFilesProjection.ts, apps/desktop/src/renderer/components/chat/imageDisplaySize.ts, apps/desktop/src/renderer/components/chat/lightboxAnnotations.ts, apps/desktop/src/renderer/components/chat/lightboxGestures.ts, apps/desktop/src/renderer/components/chat/markdownImageTargets.ts, apps/desktop/src/renderer/components/chat/messageNavRailModel.ts, apps/desktop/src/renderer/components/chat/messageNavRailWheel.ts, apps/desktop/src/renderer/components/chat/messageNavigationProjection.ts, apps/desktop/src/renderer/components/chat/messageProjectionCache.ts, apps/desktop/src/renderer/components/chat/messageStreamIndicatorPosition.ts, apps/desktop/src/renderer/components/chat/messageViewportCompensation.ts, apps/desktop/src/renderer/components/chat/messageViewportGeometry.ts, apps/desktop/src/renderer/components/chat/messageWorkGroups.ts, apps/desktop/src/renderer/components/chat/observeProgrammaticScroll.ts, apps/desktop/src/renderer/components/chat/rehypeFencedCodeMarker.ts, apps/desktop/src/renderer/components/chat/rehypeHighlightShared.ts, apps/desktop/src/renderer/components/chat/rehypeMathBlockMarker.ts, apps/desktop/src/renderer/components/chat/rehypeStreamWordFade.ts, apps/desktop/src/renderer/components/chat/remarkHtmlImages.ts, apps/desktop/src/renderer/components/chat/remarkLocalPathLinks.ts, apps/desktop/src/renderer/components/chat/remarkPreserveRawLocalDestinations.ts, apps/desktop/src/renderer/components/chat/remarkSessionLinks.ts, apps/desktop/src/renderer/components/chat/remarkStrictInlineMath.ts, apps/desktop/src/renderer/components/chat/remarkTruncateCjkUrls.ts, apps/desktop/src/renderer/components/chat/repairStreamingMarkdown.ts, apps/desktop/src/renderer/components/chat/scrollAnchoringDetect.ts, apps/desktop/src/renderer/components/chat/shareSelectionStore.ts, apps/desktop/src/renderer/components/chat/streamingMarkdownBlocks.tsx, apps/desktop/src/renderer/components/chat/streamingMarkdownChunks.ts, apps/desktop/src/renderer/components/chat/streamingMessageProjection.ts, apps/desktop/src/renderer/components/chat/toolLoopI18n.ts, apps/desktop/src/renderer/components/chat/unreadCount.ts, apps/desktop/src/renderer/components/chat/useAutomaticHistoryLoadBudget.ts, apps/desktop/src/renderer/components/chat/useCopyAsImage.tsx, apps/desktop/src/renderer/components/chat/useDeleteMessage.ts, apps/desktop/src/renderer/components/chat/useFileChipContextMenu.tsx, apps/desktop/src/renderer/components/chat/useForkAtMessage.ts, apps/desktop/src/renderer/components/chat/useMessageViewport.ts, apps/desktop/src/renderer/components/chat/useNavigationKeyListener.ts, apps/desktop/src/renderer/components/chat/useOpenWithMenu.tsx, apps/desktop/src/renderer/components/chat/usePrevUserMessageInView.ts, apps/desktop/src/renderer/components/chat/useTurnChangeSets.ts, apps/desktop/src/renderer/components/chat/userMessageCollapse.ts, apps/desktop/src/renderer/components/chat/userMessageDisplayText.ts, apps/desktop/src/renderer/components/chat/userMessageLinkify.ts, apps/desktop/src/renderer/components/chat/viewportFillDetect.ts, apps/desktop/src/renderer/components/new-chat/AddRemoteProjectDialog.tsx, apps/desktop/src/renderer/components/new-chat/AgentSelect.tsx, apps/desktop/src/renderer/components/new-chat/AskUserQuestionPrompt.tsx, apps/desktop/src/renderer/components/new-chat/AtMentionPanel.tsx, apps/desktop/src/renderer/components/new-chat/AttachmentTypeThumb.tsx, apps/desktop/src/renderer/components/new-chat/ChatInput.tsx, apps/desktop/src/renderer/components/new-chat/CjkPunctDecoration.ts, apps/desktop/src/renderer/components/new-chat/CjkPunctuationUtils.ts, apps/desktop/src/renderer/components/new-chat/ComposerAttachments.tsx, apps/desktop/src/renderer/components/new-chat/ComposerListIndentDecoration.ts, apps/desktop/src/renderer/components/new-chat/ComposerListNodes.ts, apps/desktop/src/renderer/components/new-chat/ComposerQuoteNode.tsx, apps/desktop/src/renderer/components/new-chat/DeviceSwitcherPill.tsx, apps/desktop/src/renderer/components/new-chat/EffortSlider.tsx, apps/desktop/src/renderer/components/new-chat/EmptyDocSelectionGuard.ts, apps/desktop/src/renderer/components/new-chat/ExtraDirsButton.tsx, apps/desktop/src/renderer/components/new-chat/FastModeToggle.tsx, apps/desktop/src/renderer/components/new-chat/FolderPickerPopover.tsx, apps/desktop/src/renderer/components/new-chat/FullAccessConfirmContent.tsx, apps/desktop/src/renderer/components/new-chat/GhostCommandDecoration.ts, apps/desktop/src/renderer/components/new-chat/GoalAdvancedLimits.tsx, apps/desktop/src/renderer/components/new-chat/GoalIndicator.tsx, apps/desktop/src/renderer/components/new-chat/HomeUsageDashboard.tsx, apps/desktop/src/renderer/components/new-chat/ListComposerTextarea.tsx, apps/desktop/src/renderer/components/new-chat/LocalModelCatalogNotice.tsx, apps/desktop/src/renderer/components/new-chat/MentionChipNode.tsx, apps/desktop/src/renderer/components/new-chat/MentionDragCaretDecoration.ts, apps/desktop/src/renderer/components/new-chat/ModelCompatibilityNotice.tsx, apps/desktop/src/renderer/components/new-chat/ModelConfigFlyout.tsx, apps/desktop/src/renderer/components/new-chat/ModelHarnessPicker.tsx, apps/desktop/src/renderer/components/new-chat/ModelSelector.tsx, apps/desktop/src/renderer/components/new-chat/ModelSourceDetails.tsx, apps/desktop/src/renderer/components/new-chat/NewGoalDialog.tsx, apps/desktop/src/renderer/components/new-chat/PastedTextChipNode.tsx, apps/desktop/src/renderer/components/new-chat/PendingQueuePanel.tsx, apps/desktop/src/renderer/components/new-chat/PermissionPrompt.tsx, apps/desktop/src/renderer/components/new-chat/PermissionSelector.tsx, apps/desktop/src/renderer/components/new-chat/PinnedPlanPanel.tsx, apps/desktop/src/renderer/components/new-chat/PlanActionCard.tsx, apps/desktop/src/renderer/components/new-chat/PlanModeIndicator.tsx, apps/desktop/src/renderer/components/new-chat/PlanViewerCard.tsx, apps/desktop/src/renderer/components/new-chat/PluginConnectionForm.tsx, apps/desktop/src/renderer/components/new-chat/PluginOauthDeviceCode.tsx, apps/desktop/src/renderer/components/new-chat/PluginSetupPrompt.tsx, apps/desktop/src/renderer/components/new-chat/PluginWriteAccessRecovery.tsx, apps/desktop/src/renderer/components/new-chat/QuickStartPillMark.ts, apps/desktop/src/renderer/components/new-chat/RemoteOauthSetupCard.tsx, apps/desktop/src/renderer/components/new-chat/SendButton.tsx, apps/desktop/src/renderer/components/new-chat/SlashCommandDecoration.ts, apps/desktop/src/renderer/components/new-chat/SlashCommandPalette.tsx, apps/desktop/src/renderer/components/new-chat/TakeoverMask.tsx, apps/desktop/src/renderer/components/new-chat/ThinkingToggle.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedFlyoutHost.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelPanel.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelRail.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelRow.tsx, apps/desktop/src/renderer/components/new-chat/UsageDailyBars.tsx, apps/desktop/src/renderer/components/new-chat/UsageHeatmap.tsx, apps/desktop/src/renderer/components/new-chat/VendorSegmentedSwitcher.tsx, apps/desktop/src/renderer/components/new-chat/VoiceInputDraftDecoration.ts, apps/desktop/src/renderer/components/new-chat/WindowsSelectionReplacement.ts, apps/desktop/src/renderer/components/new-chat/WorktreeChipsRow.tsx, apps/desktop/src/renderer/components/new-chat/WorktreeCreatingOverlay.tsx, apps/desktop/src/renderer/components/new-chat/agentOptions.ts, apps/desktop/src/renderer/components/new-chat/agentSwitchConfirmation.ts, apps/desktop/src/renderer/components/new-chat/branchPick.ts, apps/desktop/src/renderer/components/new-chat/composerBlankPointerFocus.ts, apps/desktop/src/renderer/components/new-chat/composerContentSerialization.ts, apps/desktop/src/renderer/components/new-chat/composerDocState.ts, apps/desktop/src/renderer/components/new-chat/composerFrameScheduler.ts, apps/desktop/src/renderer/components/new-chat/composerHistoryProjection.ts, apps/desktop/src/renderer/components/new-chat/composerModelSelection.ts, apps/desktop/src/renderer/components/new-chat/composerPromptRecommendation.ts, apps/desktop/src/renderer/components/new-chat/composerRenderGate.ts, apps/desktop/src/renderer/components/new-chat/composerSendOwnership.ts, apps/desktop/src/renderer/components/new-chat/composerSendSnapshot.ts, apps/desktop/src/renderer/components/new-chat/effortChangeQueue.ts, apps/desktop/src/renderer/components/new-chat/extraDirsActions.ts, apps/desktop/src/renderer/components/new-chat/ghostComposerPlacement.ts, apps/desktop/src/renderer/components/new-chat/localAttachmentPicker.ts, apps/desktop/src/renderer/components/new-chat/mentionChipInsertion.ts, apps/desktop/src/renderer/components/new-chat/modelWindowErrorToast.ts, apps/desktop/src/renderer/components/new-chat/pastePipeline.ts, apps/desktop/src/renderer/components/new-chat/pathPaste.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueLocks.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueRowActivity.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueRowPresentation.ts, apps/desktop/src/renderer/components/new-chat/planModeComposerCommand.ts, apps/desktop/src/renderer/components/new-chat/priceTierMarks.tsx, apps/desktop/src/renderer/components/new-chat/remoteBrowseAdapters.ts, apps/desktop/src/renderer/components/new-chat/remoteExistingProjects.ts, apps/desktop/src/renderer/components/new-chat/restoreComposerDocument.ts, apps/desktop/src/renderer/components/new-chat/sessionLinkPaste.ts, apps/desktop/src/renderer/components/new-chat/sourceSwitch.ts, apps/desktop/src/renderer/components/new-chat/unifiedModelSelection.ts, apps/desktop/src/renderer/components/new-chat/usagePalette.ts, apps/desktop/src/renderer/components/new-chat/useComposerSendFocusRestore.ts, apps/desktop/src/renderer/components/new-chat/useModelDiscoveryPending.ts, apps/desktop/src/renderer/components/new-chat/useProviderWeeklyQuota.ts, apps/desktop/src/renderer/components/new-chat/useUnifiedRowActions.ts, apps/desktop/src/renderer/features/cc-agent/CCAgentFeatureLayout.tsx, apps/desktop/src/renderer/features/cc-agent/CCAgentSessionView.tsx | 252 | 38 | 336 |+| `desktop.chat.session` | desktop | 会话工作台 | hash `/cc-agent/:sessionId`;副窗经 `/cc-agent/boot` 解析后落到同一会话视图 | AssistantMessage, CCAgentFeatureLayout, CCAgentSessionView, ChatInput, PermissionPrompt | apps/desktop/src/renderer/components/chat/AgentActionRow.tsx, apps/desktop/src/renderer/components/chat/AgentActionsBlock.tsx, apps/desktop/src/renderer/components/chat/AgentTaskCard.tsx, apps/desktop/src/renderer/components/chat/AgentTaskLiveDetails.tsx, apps/desktop/src/renderer/components/chat/AnnotationStrokesSvg.tsx, apps/desktop/src/renderer/components/chat/AskUserQuestionBubble.tsx, apps/desktop/src/renderer/components/chat/AssistantMessage.tsx, apps/desktop/src/renderer/components/chat/AutomationOriginBadge.tsx, apps/desktop/src/renderer/components/chat/ChatAudioCard.tsx, apps/desktop/src/renderer/components/chat/ChatDisplaySnapshotContext.tsx, apps/desktop/src/renderer/components/chat/ChatImageView.tsx, apps/desktop/src/renderer/components/chat/ChatSessionFileContext.tsx, apps/desktop/src/renderer/components/chat/ChatSoundEffectCard.tsx, apps/desktop/src/renderer/components/chat/ChatVideoView.tsx, apps/desktop/src/renderer/components/chat/CindyMakeDoctorCard.tsx, apps/desktop/src/renderer/components/chat/CopyAsImageBlock.tsx, apps/desktop/src/renderer/components/chat/CredentialSwitchWaitBanner.tsx, apps/desktop/src/renderer/components/chat/DiffView.tsx, apps/desktop/src/renderer/components/chat/ErrorBanner.tsx, apps/desktop/src/renderer/components/chat/ErrorMessageCard.tsx, apps/desktop/src/renderer/components/chat/GeneratedFilesCard.tsx, apps/desktop/src/renderer/components/chat/GhostCardHostPrompts.tsx, apps/desktop/src/renderer/components/chat/GhostSummonCard.tsx, apps/desktop/src/renderer/components/chat/GhostToolCard.tsx, apps/desktop/src/renderer/components/chat/HookTaskCard.tsx, apps/desktop/src/renderer/components/chat/ImageGalleryContext.tsx, apps/desktop/src/renderer/components/chat/ImageHoverPreview.tsx, apps/desktop/src/renderer/components/chat/ImageLightbox.tsx, apps/desktop/src/renderer/components/chat/ImageMissingPlaceholder.tsx, apps/desktop/src/renderer/components/chat/InlineReferenceChip.tsx, apps/desktop/src/renderer/components/chat/InterruptedTurnBanner.tsx, apps/desktop/src/renderer/components/chat/JumpToBottomChip.tsx, apps/desktop/src/renderer/components/chat/MarkdownDiffBlock.tsx, apps/desktop/src/renderer/components/chat/MarkdownMermaidBlock.tsx, apps/desktop/src/renderer/components/chat/MarkdownRenderer.tsx, apps/desktop/src/renderer/components/chat/MermaidLightbox.tsx, apps/desktop/src/renderer/components/chat/MessageActionBar.tsx, apps/desktop/src/renderer/components/chat/MessageNavRail.tsx, apps/desktop/src/renderer/components/chat/MessageStream.tsx, apps/desktop/src/renderer/components/chat/MessageViewport.tsx, apps/desktop/src/renderer/components/chat/ModelLightbox.tsx, apps/desktop/src/renderer/components/chat/NewMessageIndicator.tsx, apps/desktop/src/renderer/components/chat/PlanReviewBubble.tsx, apps/desktop/src/renderer/components/chat/PrevMessageJumpChip.tsx, apps/desktop/src/renderer/components/chat/ProjectLinkChip.tsx, apps/desktop/src/renderer/components/chat/QuoteChip.tsx, apps/desktop/src/renderer/components/chat/RewindPreviewDialog.tsx, apps/desktop/src/renderer/components/chat/SelectionQuoteButton.tsx, apps/desktop/src/renderer/components/chat/SentAgentReferenceChip.tsx, apps/desktop/src/renderer/components/chat/SentInlineAtomBody.tsx, apps/desktop/src/renderer/components/chat/SessionHandoffCard.tsx, apps/desktop/src/renderer/components/chat/SessionLinkChip.tsx, apps/desktop/src/renderer/components/chat/ShareMessageCheckbox.tsx, apps/desktop/src/renderer/components/chat/ShareSelectionBar.tsx, apps/desktop/src/renderer/components/chat/SlackIcon.tsx, apps/desktop/src/renderer/components/chat/StreamFadeSpan.tsx, apps/desktop/src/renderer/components/chat/StreamingMarkdownChunk.tsx, apps/desktop/src/renderer/components/chat/SystemCard.tsx, apps/desktop/src/renderer/components/chat/TextLightbox.tsx, apps/desktop/src/renderer/components/chat/ThinkingCard.tsx, apps/desktop/src/renderer/components/chat/ThinkingText.tsx, apps/desktop/src/renderer/components/chat/TodoListCard.tsx, apps/desktop/src/renderer/components/chat/ToolCallCard.tsx, apps/desktop/src/renderer/components/chat/ToolPayloadLightbox.tsx, apps/desktop/src/renderer/components/chat/TopRightChipStack.tsx, apps/desktop/src/renderer/components/chat/TurnChangesCard.tsx, apps/desktop/src/renderer/components/chat/UnreadFailedScheduleBanner.tsx, apps/desktop/src/renderer/components/chat/UpgradeBanner.tsx, apps/desktop/src/renderer/components/chat/UserAttachmentChip.tsx, apps/desktop/src/renderer/components/chat/UserMessage.tsx, apps/desktop/src/renderer/components/chat/UserMessageEditBox.tsx, apps/desktop/src/renderer/components/chat/UserMessageUrlLink.tsx, apps/desktop/src/renderer/components/chat/VideoLightbox.tsx, apps/desktop/src/renderer/components/chat/WorkGroupBlock.tsx, apps/desktop/src/renderer/components/chat/WorktreeRestoreBanner.tsx, apps/desktop/src/renderer/components/chat/XIcon.tsx, apps/desktop/src/renderer/components/chat/activityRowChrome.ts, apps/desktop/src/renderer/components/chat/animateFocusScroll.ts, apps/desktop/src/renderer/components/chat/autoFollowIntent.ts, apps/desktop/src/renderer/components/chat/chatChrome.ts, apps/desktop/src/renderer/components/chat/errorReasonI18n.ts, apps/desktop/src/renderer/components/chat/generatedFilesProjection.ts, apps/desktop/src/renderer/components/chat/imageDisplaySize.ts, apps/desktop/src/renderer/components/chat/lightboxAnnotations.ts, apps/desktop/src/renderer/components/chat/lightboxGestures.ts, apps/desktop/src/renderer/components/chat/markdownImageTargets.ts, apps/desktop/src/renderer/components/chat/messageNavRailModel.ts, apps/desktop/src/renderer/components/chat/messageNavRailWheel.ts, apps/desktop/src/renderer/components/chat/messageNavigationProjection.ts, apps/desktop/src/renderer/components/chat/messageProjectionCache.ts, apps/desktop/src/renderer/components/chat/messageStreamIndicatorPosition.ts, apps/desktop/src/renderer/components/chat/messageViewportCompensation.ts, apps/desktop/src/renderer/components/chat/messageViewportGeometry.ts, apps/desktop/src/renderer/components/chat/messageWorkGroups.ts, apps/desktop/src/renderer/components/chat/observeProgrammaticScroll.ts, apps/desktop/src/renderer/components/chat/rehypeFencedCodeMarker.ts, apps/desktop/src/renderer/components/chat/rehypeHighlightShared.ts, apps/desktop/src/renderer/components/chat/rehypeMathBlockMarker.ts, apps/desktop/src/renderer/components/chat/rehypeStreamWordFade.ts, apps/desktop/src/renderer/components/chat/remarkHtmlImages.ts, apps/desktop/src/renderer/components/chat/remarkLocalPathLinks.ts, apps/desktop/src/renderer/components/chat/remarkPreserveRawLocalDestinations.ts, apps/desktop/src/renderer/components/chat/remarkSessionLinks.ts, apps/desktop/src/renderer/components/chat/remarkStrictInlineMath.ts, apps/desktop/src/renderer/components/chat/remarkTruncateCjkUrls.ts, apps/desktop/src/renderer/components/chat/repairStreamingMarkdown.ts, apps/desktop/src/renderer/components/chat/scrollAnchoringDetect.ts, apps/desktop/src/renderer/components/chat/shareSelectionStore.ts, apps/desktop/src/renderer/components/chat/streamingMarkdownBlocks.tsx, apps/desktop/src/renderer/components/chat/streamingMarkdownChunks.ts, apps/desktop/src/renderer/components/chat/streamingMessageProjection.ts, apps/desktop/src/renderer/components/chat/toolLoopI18n.ts, apps/desktop/src/renderer/components/chat/unreadCount.ts, apps/desktop/src/renderer/components/chat/useAutomaticHistoryLoadBudget.ts, apps/desktop/src/renderer/components/chat/useCopyAsImage.tsx, apps/desktop/src/renderer/components/chat/useDeleteMessage.ts, apps/desktop/src/renderer/components/chat/useFileChipContextMenu.tsx, apps/desktop/src/renderer/components/chat/useForkAtMessage.ts, apps/desktop/src/renderer/components/chat/useMessageViewport.ts, apps/desktop/src/renderer/components/chat/useNavigationKeyListener.ts, apps/desktop/src/renderer/components/chat/useOpenWithMenu.tsx, apps/desktop/src/renderer/components/chat/usePrevUserMessageInView.ts, apps/desktop/src/renderer/components/chat/useTurnChangeSets.ts, apps/desktop/src/renderer/components/chat/userMessageCollapse.ts, apps/desktop/src/renderer/components/chat/userMessageDisplayText.ts, apps/desktop/src/renderer/components/chat/userMessageLinkify.ts, apps/desktop/src/renderer/components/chat/viewportFillDetect.ts, apps/desktop/src/renderer/components/new-chat/AddRemoteProjectDialog.tsx, apps/desktop/src/renderer/components/new-chat/AgentSelect.tsx, apps/desktop/src/renderer/components/new-chat/AskUserQuestionPrompt.tsx, apps/desktop/src/renderer/components/new-chat/AtMentionPanel.tsx, apps/desktop/src/renderer/components/new-chat/AttachmentTypeThumb.tsx, apps/desktop/src/renderer/components/new-chat/ChatInput.tsx, apps/desktop/src/renderer/components/new-chat/CjkPunctDecoration.ts, apps/desktop/src/renderer/components/new-chat/CjkPunctuationUtils.ts, apps/desktop/src/renderer/components/new-chat/ComposerAttachments.tsx, apps/desktop/src/renderer/components/new-chat/ComposerListIndentDecoration.ts, apps/desktop/src/renderer/components/new-chat/ComposerListNodes.ts, apps/desktop/src/renderer/components/new-chat/ComposerQuoteNode.tsx, apps/desktop/src/renderer/components/new-chat/DeviceSwitcherPill.tsx, apps/desktop/src/renderer/components/new-chat/EffortSlider.tsx, apps/desktop/src/renderer/components/new-chat/EmptyDocSelectionGuard.ts, apps/desktop/src/renderer/components/new-chat/ExtraDirsButton.tsx, apps/desktop/src/renderer/components/new-chat/FastModeToggle.tsx, apps/desktop/src/renderer/components/new-chat/FolderPickerPopover.tsx, apps/desktop/src/renderer/components/new-chat/FullAccessConfirmContent.tsx, apps/desktop/src/renderer/components/new-chat/GhostCommandDecoration.ts, apps/desktop/src/renderer/components/new-chat/GoalAdvancedLimits.tsx, apps/desktop/src/renderer/components/new-chat/GoalIndicator.tsx, apps/desktop/src/renderer/components/new-chat/HomeUsageDashboard.tsx, apps/desktop/src/renderer/components/new-chat/ListComposerTextarea.tsx, apps/desktop/src/renderer/components/new-chat/LocalModelCatalogNotice.tsx, apps/desktop/src/renderer/components/new-chat/MentionChipNode.tsx, apps/desktop/src/renderer/components/new-chat/MentionDragCaretDecoration.ts, apps/desktop/src/renderer/components/new-chat/ModelCompatibilityNotice.tsx, apps/desktop/src/renderer/components/new-chat/ModelConfigFlyout.tsx, apps/desktop/src/renderer/components/new-chat/ModelHarnessPicker.tsx, apps/desktop/src/renderer/components/new-chat/ModelSelector.tsx, apps/desktop/src/renderer/components/new-chat/ModelSourceDetails.tsx, apps/desktop/src/renderer/components/new-chat/NewGoalDialog.tsx, apps/desktop/src/renderer/components/new-chat/PastedTextChipNode.tsx, apps/desktop/src/renderer/components/new-chat/PendingQueuePanel.tsx, apps/desktop/src/renderer/components/new-chat/PermissionPrompt.tsx, apps/desktop/src/renderer/components/new-chat/PermissionSelector.tsx, apps/desktop/src/renderer/components/new-chat/PinnedPlanPanel.tsx, apps/desktop/src/renderer/components/new-chat/PlanActionCard.tsx, apps/desktop/src/renderer/components/new-chat/PlanModeIndicator.tsx, apps/desktop/src/renderer/components/new-chat/PlanViewerCard.tsx, apps/desktop/src/renderer/components/new-chat/PluginConnectionForm.tsx, apps/desktop/src/renderer/components/new-chat/PluginOauthDeviceCode.tsx, apps/desktop/src/renderer/components/new-chat/PluginSetupPrompt.tsx, apps/desktop/src/renderer/components/new-chat/PluginSetupRemoteDesktopButton.tsx, apps/desktop/src/renderer/components/new-chat/PluginWriteAccessRecovery.tsx, apps/desktop/src/renderer/components/new-chat/QuickStartPillMark.ts, apps/desktop/src/renderer/components/new-chat/RemoteOauthSetupCard.tsx, apps/desktop/src/renderer/components/new-chat/SendButton.tsx, apps/desktop/src/renderer/components/new-chat/SlashCommandDecoration.ts, apps/desktop/src/renderer/components/new-chat/SlashCommandPalette.tsx, apps/desktop/src/renderer/components/new-chat/TakeoverMask.tsx, apps/desktop/src/renderer/components/new-chat/ThinkingToggle.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedFlyoutHost.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelPanel.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelRail.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelRow.tsx, apps/desktop/src/renderer/components/new-chat/UsageDailyBars.tsx, apps/desktop/src/renderer/components/new-chat/UsageHeatmap.tsx, apps/desktop/src/renderer/components/new-chat/VendorSegmentedSwitcher.tsx, apps/desktop/src/renderer/components/new-chat/VoiceInputDraftDecoration.ts, apps/desktop/src/renderer/components/new-chat/WindowsSelectionReplacement.ts, apps/desktop/src/renderer/components/new-chat/WorktreeChipsRow.tsx, apps/desktop/src/renderer/components/new-chat/WorktreeCreatingOverlay.tsx, apps/desktop/src/renderer/components/new-chat/agentOptions.ts, apps/desktop/src/renderer/components/new-chat/agentSwitchConfirmation.ts, apps/desktop/src/renderer/components/new-chat/branchPick.ts, apps/desktop/src/renderer/components/new-chat/composerBlankPointerFocus.ts, apps/desktop/src/renderer/components/new-chat/composerContentSerialization.ts, apps/desktop/src/renderer/components/new-chat/composerDocState.ts, apps/desktop/src/renderer/components/new-chat/composerFrameScheduler.ts, apps/desktop/src/renderer/components/new-chat/composerHistoryProjection.ts, apps/desktop/src/renderer/components/new-chat/composerModelSelection.ts, apps/desktop/src/renderer/components/new-chat/composerPromptRecommendation.ts, apps/desktop/src/renderer/components/new-chat/composerRenderGate.ts, apps/desktop/src/renderer/components/new-chat/composerSendOwnership.ts, apps/desktop/src/renderer/components/new-chat/composerSendSnapshot.ts, apps/desktop/src/renderer/components/new-chat/effortChangeQueue.ts, apps/desktop/src/renderer/components/new-chat/extraDirsActions.ts, apps/desktop/src/renderer/components/new-chat/ghostComposerPlacement.ts, apps/desktop/src/renderer/components/new-chat/localAttachmentPicker.ts, apps/desktop/src/renderer/components/new-chat/mentionChipInsertion.ts, apps/desktop/src/renderer/components/new-chat/modelWindowErrorToast.ts, apps/desktop/src/renderer/components/new-chat/pastePipeline.ts, apps/desktop/src/renderer/components/new-chat/pathPaste.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueLocks.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueRowActivity.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueRowPresentation.ts, apps/desktop/src/renderer/components/new-chat/planModeComposerCommand.ts, apps/desktop/src/renderer/components/new-chat/priceTierMarks.tsx, apps/desktop/src/renderer/components/new-chat/remoteBrowseAdapters.ts, apps/desktop/src/renderer/components/new-chat/remoteExistingProjects.ts, apps/desktop/src/renderer/components/new-chat/restoreComposerDocument.ts, apps/desktop/src/renderer/components/new-chat/sessionLinkPaste.ts, apps/desktop/src/renderer/components/new-chat/sourceSwitch.ts, apps/desktop/src/renderer/components/new-chat/unifiedModelSelection.ts, apps/desktop/src/renderer/components/new-chat/usagePalette.ts, apps/desktop/src/renderer/components/new-chat/useComposerSendFocusRestore.ts, apps/desktop/src/renderer/components/new-chat/useModelDiscoveryPending.ts, apps/desktop/src/renderer/components/new-chat/useProviderWeeklyQuota.ts, apps/desktop/src/renderer/components/new-chat/useUnifiedRowActions.ts, apps/desktop/src/renderer/features/cc-agent/CCAgentFeatureLayout.tsx, apps/desktop/src/renderer/features/cc-agent/CCAgentSessionView.tsx | 252 | 38 | 336 || `desktop.dev.maker-experimental` | desktop | Maker 实验诊断页 | hash `/maker-experimental`(MakerExperimentalView;EXPERIMENTAL_FEATURES 现为空,仍是生产路由) | MakerExperimentalView | apps/desktop/src/renderer/features/maker-experimental/MakerExperimentalView.tsx | 9 | 0 | 7 || `desktop.issues.guide` | desktop | Issue 引导页 | hash `/issues`(IssueTrackerFeatureLayout,已迁 GitHub 后的引导页) | IssueTrackerFeatureLayout | apps/desktop/src/renderer/features/issue-tracker/IssueTrackerFeatureLayout.tsx, apps/desktop/src/renderer/features/issue-tracker/MyIssueList.tsx, apps/desktop/src/renderer/features/issue-tracker/hooks/useMyIssues.ts, apps/desktop/src/renderer/features/issue-tracker/lib/myIssuesNotices.ts, apps/desktop/src/renderer/features/issue-tracker/lib/startIssueChat.ts | 0 | 0 | 7 || `desktop.native.app-menu` | desktop | 应用菜单 | Menu.setApplicationMenu(用户可见出口,不展开业务逻辑) | applicationMenuLabels | apps/desktop/src/main/applicationMenuLabels.ts | 0 | 0 | 0 |@@ -44,7 +44,7 @@| `desktop.skillhub.market` | desktop | SkillHub 市场 | hash `/skillhub/market`(SkillhubMarketListView) | InstallTargetPicker, MarketCard, MarketInfoEditDialog, SkillhubMarketDetailView, SkillhubMarketListView, VisibilityEditorDialog | apps/desktop/src/renderer/features/skillhub/SkillhubMarketDetailView.tsx, apps/desktop/src/renderer/features/skillhub/SkillhubMarketListView.tsx, apps/desktop/src/renderer/features/skillhub/components/HomeMarketCard.tsx, apps/desktop/src/renderer/features/skillhub/components/InstallTargetPicker.tsx, apps/desktop/src/renderer/features/skillhub/components/LocalSkillControls.tsx, apps/desktop/src/renderer/features/skillhub/components/MarketCard.tsx, apps/desktop/src/renderer/features/skillhub/components/MarketInfoEditDialog.tsx, apps/desktop/src/renderer/features/skillhub/components/MarketInstallStatus.tsx, apps/desktop/src/renderer/features/skillhub/components/MarketListError.tsx, apps/desktop/src/renderer/features/skillhub/components/MarketLocalSkills.tsx, apps/desktop/src/renderer/features/skillhub/components/MarketPreviewTree.tsx, apps/desktop/src/renderer/features/skillhub/components/OfficialSkillBadge.tsx, apps/desktop/src/renderer/features/skillhub/components/PlatformTagSelector.tsx, apps/desktop/src/renderer/features/skillhub/components/SkillCategoryFilterBar.tsx, apps/desktop/src/renderer/features/skillhub/components/SkillDetailLayout.tsx, apps/desktop/src/renderer/features/skillhub/components/SkillIcon.tsx, apps/desktop/src/renderer/features/skillhub/components/SkillTagList.tsx, apps/desktop/src/renderer/features/skillhub/components/TeamScopePicker.tsx, apps/desktop/src/renderer/features/skillhub/components/VisibilityEditorDialog.tsx | 43 | 0 | 37 || `desktop.window.computer-permission-guide` | desktop | 电脑使用权限引导 | `?view=computer-permission-guide` → ComputerPermissionGuideWindow;backdrop 同文件 | ComputerPermissionBackdrop, ComputerPermissionGuideWindow | apps/desktop/src/main/computer-permission-guide/MacComputerPermissionGuideNativeHost.ts, apps/desktop/src/main/computer-permission-guide/placement.ts, apps/desktop/src/main/computer-permission-guide/request.ts, apps/desktop/src/main/computer-permission-guide/switch-target.ts, apps/desktop/src/main/computer-permission-guide/window.ts, apps/desktop/src/renderer/components/settings/ComputerPermissionGuideWindow.tsx | 7 | 2 | 9 || `desktop.window.ghost-panel` | desktop | 插件面板独立窗口 | `?ghostPanelWindow=<id>` → renderer/ghost-panel-window-entry.tsx;hash `/ghost-panel-window` | GhostPanelWindowLayout | apps/desktop/src/main/ghost-panel-window/controller.ts, apps/desktop/src/main/ghost-panel-window/ipc.ts, apps/desktop/src/main/ghost-panel-window/registry.ts, apps/desktop/src/main/ghost-panel-window/settings-store.ts, apps/desktop/src/main/ghost-panel-window/window.ts, apps/desktop/src/renderer/components/layout/GhostPanelWindowLayout.tsx, apps/desktop/src/renderer/ghost-panel-window-entry.tsx, apps/desktop/src/renderer/styles/generated/tokens.css, apps/desktop/src/renderer/styles/globals.css | 76 | 38 | 15 |-| `desktop.window.remote-desktop` | desktop | 远程桌面独立窗口 | `?remoteDesktopViewer=1` → renderer/remote-desktop-viewer-entry.tsx | Button, ConfirmDialog, FormField, Popover, RemoteDesktopViewerWindow, Select, Switch, Tip | apps/desktop/src/main/remote-desktop-viewer/connection.ts, apps/desktop/src/main/remote-desktop-viewer/credentials.ts, apps/desktop/src/main/remote-desktop-viewer/preferences.ts, apps/desktop/src/main/remote-desktop-viewer/registry.ts, apps/desktop/src/main/remote-desktop-viewer/safety.ts, apps/desktop/src/main/remote-desktop-viewer/windows.ts, apps/desktop/src/renderer/components/ui/button.tsx, apps/desktop/src/renderer/components/ui/confirm-dialog.tsx, apps/desktop/src/renderer/components/ui/form-field.tsx, apps/desktop/src/renderer/components/ui/popover.tsx, apps/desktop/src/renderer/components/ui/select.tsx, apps/desktop/src/renderer/components/ui/switch.tsx, apps/desktop/src/renderer/components/ui/tooltip.tsx, apps/desktop/src/renderer/features/remote-desktop/RemoteDesktopViewerWindow.tsx, apps/desktop/src/renderer/features/remote-desktop/viewerWindow.css, apps/desktop/src/renderer/remote-desktop-viewer-entry.tsx, apps/desktop/src/renderer/styles/generated/tokens.css, apps/desktop/src/renderer/styles/globals.css | 128 | 36 | 31 |+| `desktop.window.remote-desktop` | desktop | 远程桌面独立窗口 | `?remoteDesktopViewer=1` → renderer/remote-desktop-viewer-entry.tsx | Button, ConfirmDialog, FormField, Popover, RemoteDesktopViewerWindow, Select, Switch, Tip | apps/desktop/src/main/remote-desktop-viewer/connection.ts, apps/desktop/src/main/remote-desktop-viewer/credentials.ts, apps/desktop/src/main/remote-desktop-viewer/preferences.ts, apps/desktop/src/main/remote-desktop-viewer/registry.ts, apps/desktop/src/main/remote-desktop-viewer/resolutionMemory.ts, apps/desktop/src/main/remote-desktop-viewer/safety.ts, apps/desktop/src/main/remote-desktop-viewer/windows.ts, apps/desktop/src/renderer/components/ui/button.tsx, apps/desktop/src/renderer/components/ui/confirm-dialog.tsx, apps/desktop/src/renderer/components/ui/form-field.tsx, apps/desktop/src/renderer/components/ui/popover.tsx, apps/desktop/src/renderer/components/ui/select.tsx, apps/desktop/src/renderer/components/ui/switch.tsx, apps/desktop/src/renderer/components/ui/tooltip.tsx, apps/desktop/src/renderer/features/remote-desktop/RemoteDesktopViewerWindow.tsx, apps/desktop/src/renderer/features/remote-desktop/viewerWindow.css, apps/desktop/src/renderer/remote-desktop-viewer-entry.tsx, apps/desktop/src/renderer/styles/generated/tokens.css, apps/desktop/src/renderer/styles/globals.css | 128 | 36 | 31 || `desktop.window.resource-usage` | desktop | 资源用量窗口 | `?resourceUsageWindow=1` → renderer/resource-usage-entry.tsx(不走 router.tsx) | ResourceUsageWindowLayout, ResourceUsageWindowRoot | apps/desktop/src/main/resource-usage-window/controller.ts, apps/desktop/src/main/resource-usage-window/ipc.ts, apps/desktop/src/main/resource-usage-window/open-sender.ts, apps/desktop/src/main/resource-usage-window/registry.ts, apps/desktop/src/main/resource-usage-window/window.ts, apps/desktop/src/renderer/components/resource-usage/ResourceUsageWindowLayout.tsx, apps/desktop/src/renderer/resource-usage-entry.tsx, apps/desktop/src/renderer/styles/generated/tokens.css, apps/desktop/src/renderer/styles/globals.css | 76 | 38 | 15 || `desktop.window.review-artifact-confirm` | desktop | Review 成果确认窗 | main/reviewer/reviewArtifactConfirmWindow.ts 内联 HTML/CSS(不走 renderer 路由) | reviewArtifactConfirmWindow | apps/desktop/src/main/reviewer/reviewArtifactConfirmWindow.ts | 8 | 18 | 2 || `desktop.window.session-drag-preview` | desktop | 会话拖拽预览 | main/session-drag-preview.ts 透明预览窗 | session-drag-preview | apps/desktop/src/main/session-drag-preview.ts | 0 | 1 | 0 |diff --git a/docs/dev-rules/protocol-compatibility.md b/docs/dev-rules/protocol-compatibility.mdindex 6451cb34d6..fc25e4ac80 100644--- a/docs/dev-rules/protocol-compatibility.md+++ b/docs/dev-rules/protocol-compatibility.md@@ -158,6 +158,9 @@ Mobile 未新增卡片入口。服务端无需改动。按原流程拆掉重建。旧被控端丢弃不认识的 `keepVideo`,照旧拆掉重建;旧控制端不发 `keepVideo`,新被控端照旧拆掉重建。切换失败仍只结束本次远程桌面 lease。不修改 relay、IPC allowlist 或协议版本;先发被控端。+Mobile 与 Desktop 远程桌面窗口都按上述规则发送 `keepVideo` 并以 `videoKept` 回执为准;两端还按电脑和+显示器记住上次的系统分辨率或「适配画面」尺寸(各自本地保存,不进协议),下次连接拿到操作权后重新套用,+选回电脑原分辨率或恢复原始比例时清除。实现见 `apps/desktop/src/main/remote-desktop/controller.ts`,回归见同目录 `__tests__/controller.test.ts`与 `packages/device-link/src/__tests__/viewerDisplay.test.ts`。@@ -227,6 +230,26 @@ lease 与当前 lease 一致时才走通道,否则照旧走 relay。被控端其余失败不自动改走 relay 重试,超时按结果未知处理。旧控制端不发通道请求,新被控端行为不变。此扩展不修改 relay、服务端或 device-link 帧格式;iOS 原生接收器新增 `sendRequest`,属于冷更新。+Desktop 控制端由主进程决定并校验每个请求(lease、操作权记录、剪贴板权限都不变),白名单内的请求交给+远程桌面窗口经它的媒体数据通道发出,回复再交回主进程(`remote-desktop-viewer:channel-request` /+`channel-reply`,仅限该窗口);窗口没有发出(无视频、能力缺失、lease 或代次不符、通道拒收)时主进程照旧+走 relay,已发出的请求不经 relay 重发,窗口退场时在途请求按结果未知结束。++## 远程桌面随连接自动给操作权++被控端以可选能力 `autoControl` 声明(仅当本机能注入输入,即 `canControl` 为真):`start`、`viewerDisplay`、+`restoreViewerDisplay` 与 `resolution { temporary: true }` 接受 `control: true`(只接受布尔值),被控端在同一个+请求里启动输入并以 `controlling: true` 回复,控制端不再单独发 `control`。启动输入失败(缺权限、输入不可用)+时租约照常返回且 `controlling: false`,控制端再发 `control` 取得具体错误。操作权仍由被控端持有:它决定输入+助手的启停,手机画中画后台观看照旧经 `presentation` 收回,回到前台再取回;Agent 让位仍只看实际输入。++控制端仅在能力为真时发送 `control: true`;会话层只在请求过时接受 `controlling: true` 回复。旧被控端丢弃不认识的+字段并回复 `controlling: false`,控制端按原流程补发 `control`;旧控制端不发该字段,新被控端行为不变。+Desktop 控制端主进程把带 `control: true` 的回复与 `control` 回复同样记录,用于本机剪贴板判定。++Mobile 的「仅查看」改为纯本地开关:只停止转发输入、关闭键盘与鼠标按钮,不再向被控端发 `control: false`;+被控端仍持有操作权。退出仅查看时若被控端已不再给操作权(输入失败、溢出释放、后台观看),才重新请求。+不修改 relay、服务端或 IPC allowlist;需被控端和控制端都更新才省掉这次往返。## 手机首页会话活动快照diff --git a/docs/remote-desktop.md b/docs/remote-desktop.mdindex 4ec462e97d..9bcff3f9d3 100644--- a/docs/remote-desktop.md+++ b/docs/remote-desktop.md@@ -120,10 +120,12 @@ network verification requirements below.The device detail page opens the real desktop of the selected computer. On thecomputer, enable **Settings → Remote control → Allow remote desktop**, as wellas device control. Screen recording and accessibility permissions are granted-in the operating system. The phone automatically requests control on connection-when the host supports input, using the existing permission and ownership checks.-**Controls → View only** releases control and preserves that choice when reconnecting-within this page. The computer always has a **Disconnect**+in the operating system. The phone takes control on connection when the host+supports input, using the existing permission and ownership checks; a host that+advertises `autoControl` grants it with the lease, with no separate request.+**Controls → View only** is a local switch: the phone stops sending input while+the computer keeps control, and the choice is preserved when reconnecting within+this page. The computer always has a **Disconnect**button while being viewed or controlled.The host allows one active remote-desktop viewer at a time. Starting a newdiff --git a/packages/device-link/src/__tests__/viewerDisplay.test.ts b/packages/device-link/src/__tests__/viewerDisplay.test.tsindex 4064f96d09..ba3ec0c9c1 100644--- a/packages/device-link/src/__tests__/viewerDisplay.test.ts+++ b/packages/device-link/src/__tests__/viewerDisplay.test.ts@@ -290,3 +290,108 @@ describe("live display switch", () => {expect(torn.videoKept).toBeUndefined();});});++describe("automatic control on start and display changes", () => {+ it("parses an optional boolean control flag and drops it where it has no meaning", () => {+ expect(+ parseRemoteDesktopRequest({ op: "start", displayId: "1", control: true }),+ ).toEqual({ op: "start", displayId: "1", control: true });+ expect(+ parseRemoteDesktopRequest({ op: "start", displayId: "1", control: false }),+ ).toEqual({ op: "start", displayId: "1" });+ expect(+ parseRemoteDesktopRequest({ op: "restoreViewerDisplay", lease: "l", control: true }),+ ).toEqual({ op: "restoreViewerDisplay", lease: "l", control: true });+ expect(+ parseRemoteDesktopRequest({+ op: "viewerDisplay",+ lease: "l",+ width: 1280,+ height: 640,+ control: true,+ }),+ ).toMatchObject({ control: true });+ expect(+ parseRemoteDesktopRequest({+ op: "resolution",+ lease: "l",+ modeId: "2",+ temporary: true,+ control: true,+ }),+ ).toMatchObject({ temporary: true, control: true });+ // A persistent resolution ends the lease; there is nothing to control.+ expect(+ parseRemoteDesktopRequest({ op: "resolution", lease: "l", modeId: "2", control: true }),+ ).toEqual({ op: "resolution", lease: "l", modeId: "2" });+ expect(() =>+ parseRemoteDesktopRequest({ op: "start", displayId: "1", control: "yes" }),+ ).toThrow("INVALID_REQUEST");+ });++ function session(caps: Record<string, unknown>, startControlling: boolean) {+ const sent: Record<string, unknown>[] = [];+ const request = vi.fn(async (message: Record<string, unknown>) => {+ sent.push(message);+ if (message.op === "capabilities")+ return {+ version: 1,+ enabled: true,+ canControl: true,+ displays: [{ id: "1", name: "Main", width: 1920, height: 1080 }],+ ...caps,+ };+ if (message.op === "start")+ return {+ lease: "lease",+ display: { id: "1", width: 1920, height: 1080 },+ controlling: startControlling,+ };+ if (message.op === "viewerDisplay")+ return {+ lease: "lease",+ display: { id: "v", width: message.width, height: message.height },+ controlling: message.control === true,+ };+ return {};+ }) as unknown as DesktopViewerRequest;+ return { viewer: new RemoteDesktopViewerSession(request), sent };+ }++ it("asks for control with the lease only from hosts that advertise it", async () => {+ const supported = session({ autoControl: true }, true);+ const { lease } = await supported.viewer.connect({ control: true, isCurrent: () => true });+ expect(supported.sent.find((m) => m.op === "start")).toMatchObject({ control: true });+ expect(lease.controlling).toBe(true);+ const old = session({}, false);+ const result = await old.viewer.connect({ control: true, isCurrent: () => true });+ expect(old.sent.find((m) => m.op === "start")).not.toHaveProperty("control");+ expect(result.lease.controlling).toBe(false);+ const viewOnly = session({ autoControl: true, canControl: false }, false);+ await viewOnly.viewer.connect({ control: true, isCurrent: () => true });+ expect(viewOnly.sent.find((m) => m.op === "start")).not.toHaveProperty("control");+ });++ it("keeps control across a display change only when it asked for it", async () => {+ const { viewer, sent } = session({ autoControl: true }, true);+ await viewer.connect({ control: true, isCurrent: () => true });+ const kept = await viewer.fitDisplay(1280, 640, false, undefined, false, true);+ expect(sent.at(-1)).toMatchObject({ op: "viewerDisplay", control: true });+ expect(kept.controlling).toBe(true);+ expect(viewer.lease?.controlling).toBe(true);+ await expect(viewer.fitDisplay(1280, 640)).resolves.toMatchObject({ controlling: false });+ });++ it("rejects a grant nobody asked for", async () => {+ const request = vi.fn(async (message: Record<string, unknown>) =>+ message.op === "capabilities"+ ? { version: 1, enabled: true, canControl: true, displays: [{ id: "1", name: "M", width: 1, height: 1 }] }+ : message.op === "start"+ ? { lease: "lease", display: { id: "1", width: 1, height: 1 }, controlling: true }+ : { lease: "lease", display: { id: "v", width: 1280, height: 640 }, controlling: true },+ ) as unknown as DesktopViewerRequest;+ const viewer = new RemoteDesktopViewerSession(request);+ await viewer.connect({ isCurrent: () => true });+ await expect(viewer.fitDisplay(1280, 640)).rejects.toThrow("INVALID_RESPONSE");+ });+});diff --git a/packages/device-link/src/remoteDesktop.ts b/packages/device-link/src/remoteDesktop.tsindex ff7908b1fd..0b78dde300 100644--- a/packages/device-link/src/remoteDesktop.ts+++ b/packages/device-link/src/remoteDesktop.ts@@ -169,6 +169,12 @@ export interface RemoteDesktopCapabilities {channelRequests?: boolean;/** Display changes requested with `keepVideo` may keep the live video stream. */liveDisplaySwitch?: boolean;+ /**+ * `start` and display changes accept `control: true`: the host takes control+ * (starts input) within the same request and replies `controlling: true`, so+ * the viewer needs no separate `control` request.+ */+ autoControl?: boolean;backgroundViewing?: boolean;cursorOverlay?: boolean;clipboardText?: boolean;@@ -236,7 +242,13 @@ export type RemoteDesktopRequest =| ClipboardContentRequest| { op: "capabilities" }| { op: "permissions"; action: "check" | "guide" }- | { op: "start"; displayId: string; resume?: boolean; takeover?: boolean }+ | {+ op: "start";+ displayId: string;+ resume?: boolean;+ takeover?: boolean;+ control?: boolean;+ }| { op: "heartbeat"; lease: string }| { op: "stop"; lease: string; lockScreen?: boolean }| { op: "frame"; lease: string; cursorOverlay?: boolean }@@ -259,14 +271,21 @@ export type RemoteDesktopRequest =width: number;height: number;keepVideo?: boolean;+ control?: boolean;+ }+ | {+ op: "restoreViewerDisplay";+ lease: string;+ keepVideo?: boolean;+ control?: boolean;}- | { op: "restoreViewerDisplay"; lease: string; keepVideo?: boolean }| {op: "resolution";lease: string;modeId: string;temporary?: boolean;keepVideo?: boolean;+ control?: boolean;};export function parseRemoteDesktopRequest(@@ -275,6 +294,13 @@ export function parseRemoteDesktopRequest(if (!value || typeof value !== "object" || Array.isArray(value))throw new Error("INVALID_REQUEST");const v = value as Record<string, unknown>;+ // Optional on start and display changes; older hosts drop it and the viewer+ // asks for control separately.+ const control = () => {+ if (v.control !== undefined && typeof v.control !== "boolean")+ throw new Error("INVALID_REQUEST");+ return v.control === true ? { control: true as const } : {};+ };if (v.op === "capabilities") return { op: v.op };if (v.op === "permissions" && (v.action === "check" || v.action === "guide"))return { op: v.op, action: v.action };@@ -294,6 +320,7 @@ export function parseRemoteDesktopRequest(displayId: v.displayId,...(v.takeover === true ? { takeover: true } : {}),...(typeof v.resume === "boolean" ? { resume: v.resume } : {}),+ ...control(),};}if (typeof v.lease !== "string" || v.lease.length > 128 || !v.lease)@@ -393,7 +420,7 @@ export function parseRemoteDesktopRequest(return v.keepVideo === true ? { keepVideo: true as const } : {};};if (v.op === "restoreViewerDisplay")- return { op: v.op, lease, ...keepVideo() };+ return { op: v.op, lease, ...keepVideo(), ...control() };if (v.op === "displayModes") return { op: v.op, lease };if (v.op === "viewerDisplay") {if (@@ -412,6 +439,7 @@ export function parseRemoteDesktopRequest(width: v.width as number,height: v.height as number,...keepVideo(),+ ...control(),};}if (@@ -425,7 +453,7 @@ export function parseRemoteDesktopRequest(op: v.op,lease,modeId: v.modeId,- ...(v.temporary === true ? { temporary: true } : {}),+ ...(v.temporary === true ? { temporary: true, ...control() } : {}),...keepVideo(),};}diff --git a/packages/device-link/src/remoteDesktopViewerSession.ts b/packages/device-link/src/remoteDesktopViewerSession.tsindex 0306653401..ec8dc1dc88 100644--- a/packages/device-link/src/remoteDesktopViewerSession.ts+++ b/packages/device-link/src/remoteDesktopViewerSession.ts@@ -1,5 +1,6 @@import type {RemoteDesktopCapabilities,+ RemoteDesktopDisplayMode,RemoteDesktopLease,RemoteDesktopRequest,} from "./remoteDesktop.js";@@ -18,6 +19,8 @@ interface ViewerConnectOptions {resume?: boolean;takeover?: boolean;isCurrent: () => boolean;+ /** Ask a host advertising `autoControl` to grant control with the lease. */+ control?: boolean;onCapabilities?: (caps: RemoteDesktopCapabilities) => void | Promise<void>;onStart?: () => void;}@@ -95,6 +98,9 @@ export class RemoteDesktopViewerSession {: options.resume? { resume: true }: {}),+ ...(options.control && caps.autoControl && caps.canControl+ ? { control: true }+ : {}),},check,);@@ -102,6 +108,8 @@ export class RemoteDesktopViewerSession {await this.request({ op: "stop", lease: lease.lease }).catch(() => {});throw new Error("DESKTOP_VIDEO_STOPPED");}+ // Only a confirmed grant counts; older hosts always start view only.+ lease.controlling = lease.controlling === true;this.active = lease;return { caps, lease };}@@ -165,7 +173,9 @@ export class RemoteDesktopViewerSession {/*** Keep the lease and input sequence, replacing only its display geometry.* With `keepVideo`, a host advertising `liveDisplaySwitch` may also keep the- * current video stream; the result then carries `videoKept: true`.+ * current video stream; the result then carries `videoKept: true`. With+ * `control`, a host advertising `autoControl` grants control in the same+ * request; otherwise the lease returns view only, as before.*/async fitDisplay(width: number,@@ -173,6 +183,7 @@ export class RemoteDesktopViewerSession {restore = false,modeId?: string,keepVideo = false,+ control = false,): Promise<RemoteDesktopLease> {const lease = this.active;if (!lease?.controlling) throw new Error("DESKTOP_VIEW_ONLY");@@ -189,12 +200,14 @@ export class RemoteDesktopViewerSession {modeId,temporary: true,...(keepVideo ? { keepVideo: true } : {}),+ ...(control ? { control: true } : {}),}: restore? {op: "restoreViewerDisplay",lease: lease.lease,...(keepVideo ? { keepVideo: true } : {}),+ ...(control ? { control: true } : {}),}: {op: "viewerDisplay",@@ -202,6 +215,7 @@ export class RemoteDesktopViewerSession {width,height,...(keepVideo ? { keepVideo: true } : {}),+ ...(control ? { control: true } : {}),},check,);@@ -235,11 +249,12 @@ export class RemoteDesktopViewerSession {result.display.width <= 0 ||!Number.isFinite(result.display.height) ||result.display.height <= 0 ||- result.controlling !== false+ // Control comes back only when it was asked for.+ (control ? typeof result.controlling !== "boolean" : result.controlling !== false))throw new Error("INVALID_RESPONSE");lease.display = result.display;- lease.controlling = false;+ lease.controlling = control && result.controlling === true;return keepVideo && result.videoKept === true? { ...lease, videoKept: true }: lease;@@ -287,6 +302,53 @@ export function viewerDisplaySize(return Math.min(result.width, result.height) >= 320 ? result : null;}+type DisplaySize = { width: number; height: number };++/** Resize the fitted desktop without offering modes from the physical monitor. */+export function fittedDisplayModes(+ fitted: DisplaySize,+ current: DisplaySize,+): RemoteDesktopDisplayMode[] {+ const modes = new Map<string, RemoteDesktopDisplayMode>();+ const add = ({ width, height }: DisplaySize) => {+ if (+ ![width, height].every(+ (size) => Number.isInteger(size) && size >= 320 && size <= 2560,+ )+ )+ return;+ const id = `fitted:${width}x${height}`;+ modes.set(id, {+ id,+ width,+ height,+ current: width === current.width && height === current.height,+ });+ };+ for (const edge of [960, 1280, 1600, 1920, 2560]) {+ const scale = edge / Math.max(fitted.width, fitted.height);+ add({+ width: Math.round((fitted.width * scale) / 2) * 2,+ height: Math.round((fitted.height * scale) / 2) * 2,+ });+ }+ add(current);+ return [...modes.values()].sort((a, b) => a.width - b.width);+}++/** Mode IDs may change after OS or monitor updates; fall back to the same size. */+export function findRememberedMode(+ modes: RemoteDesktopDisplayMode[],+ remembered: { modeId: string } & DisplaySize,+): RemoteDesktopDisplayMode | undefined {+ const sameSize = (mode: RemoteDesktopDisplayMode) =>+ mode.width === remembered.width && mode.height === remembered.height;+ return (+ modes.find((mode) => mode.id === remembered.modeId && sameSize(mode)) ??+ modes.find(sameSize)+ );+}+/** Only transient connection errors may restart a viewer. Explicit stop wins. */export function remoteDesktopFailureKey(code: string): string | null {if (/DESKTOP_CONNECTION_TIMEOUT/.test(code)) return "connectionTimeout";diff --git a/packages/maker-shared/src/remote-desktop/viewerRuntime.js b/packages/maker-shared/src/remote-desktop/viewerRuntime.jsindex 416477a1da..85fac214cc 100644--- a/packages/maker-shared/src/remote-desktop/viewerRuntime.js+++ b/packages/maker-shared/src/remote-desktop/viewerRuntime.js@@ -1444,19 +1444,33 @@ export function mountRemoteDesktopViewer(root, postMessage, config) {desktopPan = null;if (config.desktop && heldMouse.size) release();});+ let wheelRestX = 0,+ wheelRestY = 0;if (config.desktop)listen(stage,"wheel",(e) => {e.preventDefault();- if (!control) return;+ if (!control) {+ wheelRestX = wheelRestY = 0;+ return;+ }const factor =e.deltaMode === 1 ? 16 : e.deltaMode === 2 ? stage.clientHeight : 1;+ // Hosts inject whole pixels; carry fractions so slow trackpad and+ // scaled-display deltas still scroll.+ const sx = wheelRestX + e.deltaX * factor,+ sy = wheelRestY + e.deltaY * factor,+ wx = Math.trunc(sx) || 0,+ wy = Math.trunc(sy) || 0;+ wheelRestX = sx - wx;+ wheelRestY = sy - wy;+ if (!wx && !wy) return;queue({kind: "scroll",- dx: Math.max(-2000, Math.min(2000, e.deltaX * factor)),- dy: Math.max(-2000, Math.min(2000, e.deltaY * factor)),+ dx: Math.max(-2000, Math.min(2000, wx)),+ dy: Math.max(-2000, Math.min(2000, wy)),});flush();},@@ -2423,7 +2437,11 @@ export function mountRemoteDesktopViewer(root, postMessage, config) {image.src = "data:image/jpeg;base64," + message.jpeg;break;}- case "control":+ case "control": {+ // A local view-only switch keeps host control, so its release must+ // still reach the host even if a batch was waiting for its ACK.+ const releaseHost =+ control && message.enabled !== true && message.release === true;release();// A new control intent abandons the previous relay batch. Advance the// existing sequence fence so a late old ACK cannot unlock a new batch.@@ -2432,9 +2450,15 @@ export function mountRemoteDesktopViewer(root, postMessage, config) {control = message.enabled;if (!control) showKeyboard(false);pending = [];+ if (releaseHost) {+ pending = [{ kind: "release" }];+ pendingSince = performance.now();+ flush();+ }updateMouseButtons();render();break;+ }case "mode":release();if (message.mode !== "pointer") followRest = null;diff --git a/packages/maker-shared/src/remote-desktop/viewerSource.ts b/packages/maker-shared/src/remote-desktop/viewerSource.tsindex fe363e0346..51c73380c3 100644--- a/packages/maker-shared/src/remote-desktop/viewerSource.ts+++ b/packages/maker-shared/src/remote-desktop/viewerSource.ts@@ -1,2 +1,2 @@// Generated by scripts/sync-remote-desktop-viewer.mjs. Do not edit.-export const DESKTOP_VIEWER_SOURCE = "/** Shared browser viewer. Mobile bundles this exact source; Desktop imports it as a CSP-safe module. */\nfunction mountRemoteDesktopViewer(root, postMessage, config) {\n const cleanups = [];\n const listen = (target, type, fn, options) => {\n target.addEventListener(type, fn, options);\n cleanups.push(() => target.removeEventListener(type, fn, options));\n };\n const find = (id) =>\n root.getElementById\n ? root.getElementById(id)\n : root.querySelector(\"#\" + id);\n const { net, iceServers } = config;\n let nativeVideoActive = false;\n const validKeys = new Set(config.keyCodes);\n const transform =\n /* BEGIN TRANSFORM */\n function desktopTransform(\n vw,\n vh,\n dw,\n dh,\n zoom,\n fx,\n fy,\n fillHeight = false,\n ) {\n const fit = fillHeight\n ? vh / Math.max(1, dh)\n : Math.min(vw / Math.max(1, dw), vh / Math.max(1, dh));\n // Pinch stops at two viewer points per desktop point, never below fit.\n const maxZoom = Math.max(1, 2 / fit);\n const scale = fit * Math.max(1, Math.min(maxZoom, zoom));\n const width = dw * scale;\n const height = dh * scale;\n const x =\n width <= vw\n ? (vw - width) / 2\n : Math.min(0, Math.max(vw - width, vw / 2 - fx * width));\n const y =\n height <= vh\n ? (vh - height) / 2\n : Math.min(0, Math.max(vh - height, vh / 2 - fy * height));\n return { x, y, width, height, scale, maxZoom };\n };\n /* END TRANSFORM */ const networkStats =\n /* BEGIN NETWORK_STATS */\n function networkStats(stats, previous) {\n const rows = [...stats.values()];\n const video = rows.find(\n (s) =>\n s.type === \"inbound-rtp\" &&\n (s.kind === \"video\" || s.mediaType === \"video\"),\n );\n const transport = rows.find(\n (s) => s.type === \"transport\" && s.selectedCandidatePairId,\n );\n const pair = transport\n ? stats.get(transport.selectedCandidatePairId)\n : rows.find(\n (s) =>\n s.type === \"candidate-pair\" &&\n s.state === \"succeeded\" &&\n s.nominated,\n );\n const local = pair && stats.get(pair.localCandidateId),\n remote = pair && stats.get(pair.remoteCandidateId);\n const direct = [\"host\", \"srflx\", \"prflx\"];\n const route =\n local?.candidateType === \"relay\" || remote?.candidateType === \"relay\"\n ? \"relay\"\n : direct.includes(local?.candidateType) &&\n direct.includes(remote?.candidateType)\n ? \"direct\"\n : \"video\";\n const sample =\n video &&\n Number.isFinite(video.bytesReceived) &&\n Number.isFinite(video.timestamp)\n ? {\n id: video.id,\n path: pair?.id,\n bytes: video.bytesReceived,\n time: video.timestamp,\n }\n : null;\n let bytesPerSecond = null;\n if (\n sample &&\n previous &&\n sample.id === previous.id &&\n sample.path === previous.path &&\n sample.time > previous.time &&\n sample.bytes >= previous.bytes\n )\n bytesPerSecond =\n ((sample.bytes - previous.bytes) * 1000) /\n (sample.time - previous.time);\n const latencyMs =\n Number.isFinite(pair?.currentRoundTripTime) &&\n pair.currentRoundTripTime >= 0\n ? pair.currentRoundTripTime * 1000\n : null;\n return { transport: route, bytesPerSecond, latencyMs, sample };\n };\n\n /* END NETWORK_STATS */ const stage = find(\"stage\"),\n image = find(\"image\"),\n video = find(\"video\"),\n cursor = find(\"cursor\");\n // Shared ambient backdrop. Minimal viewer embeds may omit its subtree.\n const bg = find(\"bg\") || null,\n bgCanvas = find(\"bg-canvas\") || null,\n bgContext = bgCanvas ? bgCanvas.getContext(\"2d\") : null;\n let dw = 1920,\n dh = 1080,\n viewerSized = false,\n zoom = 1,\n desktopScale = null,\n reportedScaleMode = null,\n desktopPan = null,\n edgePointer = null,\n edgeFrame = null,\n edgeTime = 0,\n fx = 0.5,\n fy = 0.5,\n mode = \"pointer\",\n control = false,\n clipboardShortcuts = false,\n clipboardModifier = \"control\",\n deferredClipboardModifier = null,\n pc = null,\n dc = null,\n seq = 0,\n generation = 0,\n epoch = null,\n gestureFrame = null;\n let remoteCursor = null,\n lastLocalMove = 0,\n localCursorAwake = false;\n let touchCursor = null,\n touchCursorTimer = null,\n touchCursorVisible = false;\n const reducedMotion = matchMedia(\"(prefers-reduced-motion: reduce)\");\n const cursorImage = find(\"cursor-image\");\n let pending = [],\n pendingSince = 0,\n sending = false,\n cx = 0.5,\n cy = 0.5,\n drag = false,\n start = null,\n last = null,\n multi = null,\n hold = null,\n moved = false;\n const pointers = new Map();\n const mouseButtons = find(\"mouse-buttons\"),\n wheel = find(\"mouse-wheel\"),\n wheelGrip = find(\"mouse-wheel-grip\");\n let nativeMouseControls = false;\n const mouseControlHandlers = new Map();\n function listenMouse(el, type, handler) {\n listen(el, type, handler);\n mouseControlHandlers.set(el.id + \":\" + type, handler);\n }\n const keyboardInput = find(\"keyboard-input\");\n let keyboardEnabled = false,\n composing = false;\n const keyboardSentinel = \"\\u200b\";\n function resetKeyboard() {\n keyboardInput.value = keyboardSentinel;\n keyboardInput.setSelectionRange(1, 1);\n }\n function showKeyboard(enabled) {\n keyboardEnabled = enabled && control;\n if (!keyboardEnabled) {\n composing = false;\n resetKeyboard();\n keyboardInput.blur();\n return;\n }\n if (composing) return;\n if (config.desktop && document.activeElement === keyboardInput) return;\n // Keep focus inside the native evaluateJavaScript call; WebKit can reject\n // keyboard presentation after requestAnimationFrame loses user activation.\n keyboardInput.blur();\n resetKeyboard();\n keyboardInput.focus({ preventScroll: true });\n }\n function keyboardKey(code) {\n if (!keyboardEnabled || !control) return;\n queue({ kind: \"key\", code, down: true });\n queue({ kind: \"key\", code, down: false });\n flush();\n }\n function commitKeyboard() {\n if (!keyboardEnabled || !control || composing) return;\n const text = keyboardInput.value.replace(keyboardSentinel, \"\");\n if (text) {\n for (let i = 0; i < text.length; i += 4096)\n queue({ kind: \"text\", text: text.slice(i, i + 4096) });\n flush();\n }\n resetKeyboard();\n }\n listen(keyboardInput, \"compositionstart\", () => {\n composing = true;\n });\n listen(keyboardInput, \"compositionend\", () => {\n composing = false;\n commitKeyboard();\n });\n listen(keyboardInput, \"input\", (e) => {\n if (!e.isComposing) commitKeyboard();\n });\n listen(keyboardInput, \"beforeinput\", (e) => {\n if (composing || e.isComposing) return;\n if (e.inputType === \"deleteContentBackward\") {\n e.preventDefault();\n keyboardKey(\"Backspace\");\n resetKeyboard();\n } else if (\n e.inputType === \"insertLineBreak\" ||\n e.inputType === \"insertParagraph\"\n ) {\n e.preventDefault();\n keyboardKey(\"Enter\");\n resetKeyboard();\n }\n });\n const heldMouse = new Map();\n let showMouseButtons = false,\n wheelY = null;\n function resetWheel() {\n wheelY = null;\n wheelGrip.style.transform = \"translateY(0px)\";\n }\n let statsTimer = null,\n statsSample = null;\n const post = (message) => postMessage({ ...message, epoch });\n const clamp = (v) => Math.max(0, Math.min(1, v));\n let fillHeight = false;\n let fitToInsets = false;\n const usesViewportInsets = () => viewerSized || fitToInsets;\n let panAnimation = null,\n viewportRightInset = 0,\n viewportLeftInset = 0,\n viewportBottomInset = 0,\n viewportTopInset = 0,\n keyboardViewportInset = 0,\n portraitKeyboardTopInset = 0;\n let keyboardViewportOpen = false;\n let keyboardFitWidth = null;\n let cursorNeedsEntry = true,\n manualViewMoved = false,\n followRest = null;\n // Insets guide centering and pan limits without clipping the full-screen\n // video surface or adding an opaque strip beside the Dynamic Island.\n const viewportLeft = () => (fillHeight ? viewportLeftInset : 0);\n const usableHeight = () =>\n Math.max(1, stage.clientHeight - viewportTopInset - viewportBottomInset);\n const viewportHeight = () =>\n usesViewportInsets() ? usableHeight() : Math.max(1, stage.clientHeight);\n const viewportWidth = () =>\n Math.max(\n 1,\n stage.clientWidth -\n viewportLeft() -\n (fillHeight ? viewportRightInset : 0),\n );\n // Center between the measured top controls and the keyboard edge (stage bottom).\n // The usable center is (topInset + stageHeight) / 2, so shift by topInset / 2.\n // Keep the fitted size and cap the shift when the desktop is too tall to fit.\n const verticalOffset = (height) =>\n (usesViewportInsets() ? viewportTopInset : 0) +\n (fillHeight\n ? 0\n : Math.min(\n Math.max(\n 0,\n portraitKeyboardTopInset - (usesViewportInsets() ? viewportTopInset : 0),\n ) / 2,\n Math.max(0, (viewportHeight() - height) / 2),\n ));\n const layout = () => {\n const r =\n config.desktop && desktopScale !== null\n ? {\n scale: desktopScale,\n width: dw * desktopScale,\n height: dh * desktopScale,\n maxZoom: 1,\n }\n : transform(\n keyboardFitWidth?.stageWidth === stage.clientWidth\n ? keyboardFitWidth.width : viewportWidth(),\n viewportHeight(),\n dw,\n dh,\n zoom,\n fx,\n fy,\n // Mobile fits both axes; retain Desktop scale semantics.\n config.desktop ? fillHeight && !viewerSized : false,\n );\n return {\n ...r,\n x: viewportLeft() + viewportWidth() / 2 - fx * r.width,\n y: viewportHeight() / 2 + verticalOffset(r.height) - fy * r.height,\n };\n };\n // 0 at fit, 1 at the pinch limit for the current viewport and display.\n const zoomProgress = (r = layout()) =>\n r.maxZoom > 1\n ? Math.max(0, Math.min(1, (zoom - 1) / (r.maxZoom - 1)))\n : 0;\n // The backdrop uses 5% / 90% / 5% source segments. The middle 90%\n // keeps the fitted picture's scale; each outer 5% stretches uniformly\n // to fill the remaining space, horizontally or vertically as needed.\n // Zoom and pan never move the backdrop: where the picture covers it, the\n // opaque picture simply occludes it, so input mapping stays uniform. Returns\n // null when the fitted picture already covers the stage, unless a Desktop\n // viewer has shrunk its foreground below fit and still needs the backdrop.\n const bgEdgeFraction = 0.05;\n const bgCenterFraction = 1 - 2 * bgEdgeFraction;\n function backgroundSegments(vw, vh, dw, dh, fill, includeFitted = false) {\n if (!(vw > 0 && vh > 0 && dw > 0 && dh > 0)) return null;\n const s = fill\n ? vh / Math.max(1, dh)\n : Math.min(vw / dw, vh / Math.max(1, dh));\n const w = dw * s,\n h = dh * s;\n if (w < vw || (includeFitted && w === vw && h === vh)) {\n const centerW = w * bgCenterFraction,\n centerX = vw / 2 - centerW / 2,\n sideW = centerX,\n top = (vh - h) / 2;\n return { axis: \"x\", s, w, h, top, centerW, centerX, sideW };\n }\n if (h < vh) {\n const centerH = h * bgCenterFraction,\n centerY = vh / 2 - centerH / 2,\n sideH = centerY,\n left = (vw - w) / 2;\n return { axis: \"y\", s, w, h, left, centerH, centerY, sideH };\n }\n return null;\n }\n // Native video renders beneath this WebView, so z-order cannot hide the\n // status behind the picture; cut the picture's rectangle out instead.\n // Measure the status only after its text or the stage changes, not per frame.\n let statusOrigin = null;\n function clipNetworkStatus(r = layout()) {\n const status = find(\"network-status\");\n if (!status) return;\n if (!nativeVideoActive || status.style.display === \"none\") {\n status.style.clipPath = \"\";\n return;\n }\n if (!statusOrigin)\n statusOrigin = { x: status.offsetLeft, y: status.offsetTop };\n const left = r.x - statusOrigin.x,\n top = r.y - statusOrigin.y,\n right = left + r.width,\n bottom = top + r.height;\n status.style.clipPath = `polygon(evenodd,0 0,100% 0,100% 100%,0 100%,0 0,${left}px ${top}px,${right}px ${top}px,${right}px ${bottom}px,${left}px ${bottom}px,${left}px ${top}px)`;\n }\n function paintBackground() {\n if (nativeVideoActive) {\n if (bg) bg.style.display = \"none\";\n return;\n }\n if (!bg || !bgCanvas || !bgContext) return;\n const vw = stage.clientWidth,\n vh = stage.clientHeight;\n const picture = config.desktop ? layout() : null;\n const coversStage =\n picture &&\n picture.x <= 0 &&\n picture.y <= 0 &&\n picture.x + picture.width >= vw &&\n picture.y + picture.height >= vh;\n const seg = coversStage\n ? null\n : backgroundSegments(vw, vh, dw, dh, config.desktop ? fillHeight : false, config.desktop);\n if (!seg) {\n bg.style.display = \"none\";\n bgRects = null;\n stopBackgroundLoop();\n return;\n }\n bg.style.display = \"block\";\n bgAxis = seg.axis;\n // The ambient layer also fills the notch and the area beneath native\n // controls. Only the interactive picture respects viewport insets.\n const originX = 0;\n // Source segments are resolved at draw time from the live source dimensions;\n // these dest rects only encode where each segment lands on the stage.\n bgRects =\n seg.axis === \"x\"\n ? [\n {\n x: originX,\n y: seg.top,\n w: seg.sideW,\n h: seg.h,\n },\n {\n x: originX + seg.centerX,\n y: seg.top,\n w: seg.centerW,\n h: seg.h,\n },\n {\n x: originX + seg.centerX + seg.centerW,\n y: seg.top,\n w: seg.sideW,\n h: seg.h,\n },\n ]\n : [\n {\n x: seg.left,\n y: 0,\n w: seg.w,\n h: seg.sideH,\n },\n {\n x: seg.left,\n y: seg.centerY,\n w: seg.w,\n h: seg.centerH,\n },\n {\n x: seg.left,\n y: seg.centerY + seg.centerH,\n w: seg.w,\n h: seg.sideH,\n },\n ];\n // Keep the backing store at stage resolution (capped) so the stretched\n // edges stay crisp without oversized allocations.\n bgDpr = Math.min(2, window.devicePixelRatio || 1);\n const bw = Math.round(stage.clientWidth * bgDpr),\n bh = Math.round(vh * bgDpr);\n if (bgCanvas.width !== bw || bgCanvas.height !== bh) {\n bgCanvas.width = bw;\n bgCanvas.height = bh;\n }\n scheduleBackgroundDraw();\n startBackgroundLoop();\n }\n // One canvas, three draws: each source segment stretches into whatever bar\n // the picture leaves open. The live video feeds it once presented; until\n // then the decoded JPEG frame does, so the backdrop always matches the\n // picture's own pixels and scale in the center segment.\n let bgRects = null,\n bgAxis = \"x\",\n bgDpr = 1,\n bgDrawFrame = null,\n bgLoopFrame = null;\n function drawBackground() {\n if (!bgContext || !bgRects) return;\n const useVideo =\n videoPresented && video.videoWidth > 0 && video.videoHeight > 0;\n const src = useVideo ? video : image;\n // drawImage source rects live in the source's own pixel space, which can\n // differ from dw/dh; fractions of the real bitmap keep every segment lined\n // up with what the picture element actually shows.\n const sw = useVideo ? video.videoWidth : image.naturalWidth;\n const sh = useVideo ? video.videoHeight : image.naturalHeight;\n // Cursor updates can schedule a repaint while the next JPEG is loading.\n // Keep the last backdrop until the replacement has drawable pixels.\n if ((!useVideo && !image.complete) || !(sw > 0 && sh > 0)) return;\n bgContext.setTransform(bgDpr, 0, 0, bgDpr, 0, 0);\n bgContext.clearRect(0, 0, stage.clientWidth, stage.clientHeight);\n const horizontal = bgAxis === \"x\";\n const sourceLength = horizontal ? sw : sh;\n const cuts = [0, bgEdgeFraction, 1 - bgEdgeFraction, 1];\n for (let i = 0; i < bgRects.length; i++) {\n const rect = bgRects[i];\n const origin = cuts[i] * sourceLength;\n const length = (cuts[i + 1] - cuts[i]) * sourceLength;\n bgContext.drawImage(\n src,\n horizontal ? origin : 0,\n horizontal ? 0 : origin,\n horizontal ? length : sw,\n horizontal ? sh : length,\n rect.x,\n rect.y,\n rect.w,\n rect.h,\n );\n }\n }\n function scheduleBackgroundDraw() {\n if (bgDrawFrame !== null || !bgRects || !bgContext) return;\n bgDrawFrame = requestAnimationFrame(() => {\n bgDrawFrame = null;\n drawBackground();\n });\n }\n function startBackgroundLoop() {\n if (\n bgLoopFrame !== null ||\n !bgContext ||\n !bgRects ||\n !videoPresented ||\n typeof video.requestVideoFrameCallback !== \"function\"\n )\n return;\n const frame = video.requestVideoFrameCallback(() => {\n if (bgLoopFrame !== frame) return;\n bgLoopFrame = null;\n drawBackground();\n startBackgroundLoop();\n });\n bgLoopFrame = frame;\n }\n // Only the streaming loop stops here; a pending one-shot draw is harmless\n // (it re-paints the preserved frame) and must survive reconnects.\n function stopBackgroundLoop() {\n if (bgLoopFrame !== null) video.cancelVideoFrameCallback?.(bgLoopFrame);\n bgLoopFrame = null;\n }\n function clearBackground() {\n stopBackgroundLoop();\n bgRects = null;\n // Resizing a canvas resets its bitmap; same-value assignment still clears.\n if (bgCanvas) bgCanvas.width = bgCanvas.width;\n }\n listen(image, \"load\", () => scheduleBackgroundDraw());\n // Older WebViews update the ambient layer on media progress, never with an\n // idle display-refresh loop. Geometry changes still get a one-shot repaint.\n listen(video, \"timeupdate\", () => {\n if (videoPresented && typeof video.requestVideoFrameCallback !== \"function\")\n scheduleBackgroundDraw();\n });\n function panBounds(r) {\n const vw = viewportWidth(),\n vh = viewportHeight();\n // Grow extra resting travel continuously from zero at fit to 180 screen\n // points at maximum zoom. Never count the unused space of a fitting axis.\n const clearance = 180 * zoomProgress(r);\n const axis = (viewport, content) =>\n content <= viewport\n ? {\n min: (viewport - content) / 2 - clearance,\n max: (viewport - content) / 2 + clearance,\n }\n : { min: viewport - content - clearance, max: clearance };\n const x = axis(vw, r.width),\n y = axis(vh, r.height);\n const bounds = {\n minX: viewportLeft() + x.min,\n maxX: viewportLeft() + x.max,\n minY: y.min + verticalOffset(r.height),\n maxY: y.max + verticalOffset(r.height),\n };\n // A camera position required to expose the cursor is a valid resting point,\n // not elastic overshoot. Preserve it across the next pan/pinch handoff.\n if (followRest) {\n const restX = viewportLeft() + vw / 2 - followRest.fx * r.width,\n restY = vh / 2 + verticalOffset(r.height) - followRest.fy * r.height;\n const weight =\n followRest.zoom > 1 ? clamp((zoom - 1) / (followRest.zoom - 1)) : 1;\n bounds.minX += Math.min(0, restX - bounds.minX) * weight;\n bounds.maxX += Math.max(0, restX - bounds.maxX) * weight;\n bounds.minY += Math.min(0, restY - bounds.minY) * weight;\n bounds.maxY += Math.max(0, restY - bounds.maxY) * weight;\n }\n return bounds;\n }\n const bounded = (v, min, max) => Math.max(min, Math.min(max, v));\n // Convert displayed overshoot back to finger travel before the next delta,\n // so reversing direction unwinds smoothly without an edge jump.\n function rubber(v, min, max, inverse = false) {\n const edge = bounded(v, min, max),\n d = v - edge;\n const reach = 40 + 40 * zoomProgress();\n return (\n edge +\n Math.sign(d) *\n (inverse\n ? (reach * Math.abs(d)) / Math.max(1, reach - Math.abs(d))\n : (reach * Math.abs(d)) / (reach + Math.abs(d)))\n );\n }\n function place(x, y, r) {\n fx = (viewportLeft() + viewportWidth() / 2 - x) / r.width;\n fy = (viewportHeight() / 2 + verticalOffset(r.height) - y) / r.height;\n }\n function cursorViewport() {\n const hotX = remoteCursor?.hotX ?? 9,\n hotY = remoteCursor?.hotY ?? 9;\n const w = remoteCursor?.width ?? 18,\n h = remoteCursor?.height ?? 18;\n const left = viewportLeft(),\n right = left + viewportWidth(),\n bottom = Math.max(1, stage.clientHeight - viewportBottomInset);\n // Keep the entire cursor, including its hotspot offset, clear of chrome.\n const minX = Math.min(right - 1, left + 8 + hotX),\n minY = Math.min(\n bottom - 1,\n (usesViewportInsets() ? viewportTopInset : 0) + 8 + hotY,\n );\n return {\n minX,\n maxX: Math.max(minX, right - 8 - (w - hotX)),\n minY,\n maxY: Math.max(minY, bottom - 8 - (h - hotY)),\n };\n }\n function moveTouchpad(dx, dy) {\n stopPanAnimation();\n const r = layout(),\n v = cursorViewport();\n if (cursorNeedsEntry) {\n // Re-enter at the nearest visible edge; do not pull a manually positioned\n // desktop back to the old off-screen cursor before applying this movement.\n cx = clamp((bounded(r.x + cx * r.width, v.minX, v.maxX) - r.x) / r.width);\n cy = clamp(\n (bounded(r.y + cy * r.height, v.minY, v.maxY) - r.y) / r.height,\n );\n cursorNeedsEntry = false;\n }\n cx = clamp(cx + dx / r.width);\n cy = clamp(cy + dy / r.height);\n const x = r.x + cx * r.width,\n y = r.y + cy * r.height;\n if (\n zoom > 1 ||\n r.width > viewportWidth() ||\n r.height > stage.clientHeight - viewportBottomInset\n ) {\n place(\n r.x + bounded(x, v.minX, v.maxX) - x,\n r.y + bounded(y, v.minY, v.maxY) - y,\n r,\n );\n followRest = { fx, fy, zoom };\n }\n manualViewMoved = false;\n }\n function stopPanAnimation() {\n if (panAnimation !== null) cancelAnimationFrame(panAnimation);\n panAnimation = null;\n }\n function settlePan() {\n stopPanAnimation();\n const r = layout(),\n b = panBounds(r),\n x = bounded(r.x, b.minX, b.maxX),\n y = bounded(r.y, b.minY, b.maxY);\n if (x === r.x && y === r.y) return;\n if (reducedMotion.matches) {\n place(x, y, r);\n render();\n return;\n }\n const started = performance.now();\n const tick = (now) => {\n const t = Math.min(1, (now - started) / 280),\n ease = 1 - Math.pow(1 - t, 3);\n place(r.x + (x - r.x) * ease, r.y + (y - r.y) * ease, r);\n render();\n panAnimation = t < 1 ? requestAnimationFrame(tick) : null;\n };\n panAnimation = requestAnimationFrame(tick);\n }\n function render() {\n const r = layout();\n if (config.nativeMedia && epoch)\n post({\n type: \"nativeViewport\",\n fillHeight: false,\n x: r.x,\n y: r.y,\n width: r.width,\n height: r.height,\n });\n if (config.desktop && epoch) {\n const scaleMode =\n desktopScale === null\n ? \"fit\"\n : desktopScale === 1\n ? \"actual\"\n : \"custom\";\n if (reportedScaleMode !== scaleMode) {\n reportedScaleMode = scaleMode;\n post({ type: \"scaleMode\", mode: scaleMode });\n }\n }\n const touchFeedback = control && mode === \"touch\" && touchCursorVisible;\n const cursorX = mode === \"touch\" && touchCursor ? touchCursor.x : cx;\n const cursorY = mode === \"touch\" && touchCursor ? touchCursor.y : cy;\n cursor.style.transition =\n mode === \"touch\" && !touchFeedback && !reducedMotion.matches\n ? \"opacity 120ms ease-out\"\n : \"none\";\n for (const el of [image, video]) {\n el.style.width = r.width + \"px\";\n el.style.height = r.height + \"px\";\n el.style.left = r.x + \"px\";\n el.style.top = r.y + \"px\";\n }\n clipNetworkStatus(r);\n paintBackground();\n if (remoteCursor) {\n cursor.style.width = remoteCursor.width + \"px\";\n cursor.style.height = remoteCursor.height + \"px\";\n cursor.style.border = \"0\";\n cursor.style.borderRadius = \"0\";\n cursor.style.transform = \"none\";\n cursor.style.left = r.x + cursorX * r.width - remoteCursor.hotX + \"px\";\n cursor.style.top = r.y + cursorY * r.height - remoteCursor.hotY + \"px\";\n cursor.style.display = \"block\";\n cursor.style.opacity = (\n mode === \"touch\"\n ? touchFeedback\n : remoteCursor.visible ||\n (control && mode === \"pointer\" && localCursorAwake)\n )\n ? \"1\"\n : \"0\";\n } else {\n cursor.style.opacity = (mode === \"touch\" ? !touchFeedback : false)\n ? \"0\"\n : \"1\";\n cursor.style.width = \"18px\";\n cursor.style.height = \"18px\";\n cursor.style.border = \"2px solid var(--foreground)\";\n cursor.style.borderRadius = \"50%\";\n cursor.style.transform = \"translate(-50%,-50%)\";\n cursor.style.left = r.x + cursorX * r.width + \"px\";\n cursor.style.top = r.y + cursorY * r.height + \"px\";\n cursor.style.display =\n !config.desktop && control && (mode === \"pointer\" || mode === \"touch\")\n ? \"block\"\n : \"none\";\n }\n if (config.desktop) {\n // Let the local OS own pointer size, DPI and accessibility preferences.\n // Never use a remote URL or bitmap as the desktop's native cursor.\n cursor.style.display = \"none\";\n const shape = remoteCursor?.shape;\n stage.style.cursor =\n control &&\n [\n \"default\",\n \"text\",\n \"vertical-text\",\n \"pointer\",\n \"crosshair\",\n \"grab\",\n \"grabbing\",\n \"ew-resize\",\n \"ns-resize\",\n \"nwse-resize\",\n \"nesw-resize\",\n \"move\",\n \"not-allowed\",\n \"copy\",\n \"alias\",\n \"wait\",\n \"progress\",\n \"help\",\n ].includes(shape)\n ? shape\n : \"default\";\n }\n }\n // Literal source is required: Hermes function.toString() yields bytecode.\n function validCursor(v) {\n return (\n !!v &&\n typeof v === \"object\" &&\n typeof v.visible === \"boolean\" &&\n [v.x, v.y, v.width, v.height, v.hotX, v.hotY].every(Number.isFinite) &&\n v.x >= 0 &&\n v.x <= 1 &&\n v.y >= 0 &&\n v.y <= 1 &&\n v.width > 0 &&\n v.width <= 256 &&\n v.height > 0 &&\n v.height <= 256 &&\n v.hotX >= 0 &&\n v.hotX <= v.width &&\n v.hotY >= 0 &&\n v.hotY <= v.height &&\n typeof v.png === \"string\" &&\n v.png.length <= 65536 &&\n /^iVBORw0KGgo[A-Za-z0-9+/]*={0,2}$/.test(v.png)\n );\n }\n function receiveCursor(value) {\n if (value === null) {\n if (remoteCursor) {\n remoteCursor = { ...remoteCursor, visible: false };\n render();\n }\n return;\n }\n if (!validCursor(value)) return;\n if (!remoteCursor || remoteCursor.png !== value.png)\n cursorImage.src = \"data:image/png;base64,\" + value.png;\n // Keep delayed host coordinates from pulling the local touchpad backwards.\n if (\n !remoteCursor ||\n !control ||\n mode !== \"pointer\" ||\n (!pointers.size && performance.now() - lastLocalMove > 200)\n ) {\n cx = value.x;\n cy = value.y;\n }\n if (value.visible) localCursorAwake = false;\n remoteCursor = value;\n render();\n }\n function resetCursor() {\n clearTimeout(touchCursorTimer);\n touchCursorVisible = false;\n touchCursor = null;\n localCursorAwake = false;\n remoteCursor = null;\n cursorImage.removeAttribute(\"src\");\n render();\n }\n function queue(event) {\n if (!control) return;\n if (!pending.length) pendingSince = performance.now();\n if (config.desktop && (event.kind === \"button\" || event.kind === \"scroll\"))\n flushClipboardModifier();\n // Remote visibility can remain hidden after synthetic mouse movement. Wake\n // the local touchpad cursor until the host reports a visible cursor again.\n if (event.kind === \"move\" && mode === \"pointer\") localCursorAwake = true;\n if (event.kind === \"key\" || event.kind === \"text\") {\n localCursorAwake = false;\n render();\n }\n if (event.kind === \"move\" || event.kind === \"button\")\n lastLocalMove = performance.now();\n const tail = pending[pending.length - 1];\n if (event.kind === \"move\" && tail?.kind === \"move\")\n pending[pending.length - 1] = event;\n // Coalesce only adjacent scrolls, preserving button/key ordering. Bound the\n // accumulated distance so a delayed ACK cannot replay a large scroll backlog.\n else if (event.kind === \"scroll\" && tail?.kind === \"scroll\") {\n tail.dx = Math.max(-2000, Math.min(2000, tail.dx + event.dx));\n tail.dy = Math.max(-2000, Math.min(2000, tail.dy + event.dy));\n } else pending.push(event);\n if (pending.length > 64) {\n pending = [{ kind: \"release\" }];\n control = false;\n post({ type: \"inputOverflow\" });\n }\n }\n function flush() {\n if (!pending.length) return;\n // Input is an intent about the picture the user saw, not durable work.\n // Never replay old clicks/typing after a stalled ACK or data channel drains.\n if (performance.now() - pendingSince >= 2000) {\n pending = [];\n control = false;\n release();\n updateMouseButtons();\n post({ type: \"inputOverflow\" });\n return;\n }\n if (sending) return;\n // Do not route around a congested live data channel: the relay could\n // overtake its already-buffered key/button events and reorder input.\n if (pc?.connectionState === \"connected\" && dc?.readyState === \"open\" && dc.bufferedAmount >= 16384) return;\n const events = pending.splice(0, 64),\n sequence = ++seq;\n if (\n pc?.connectionState === \"connected\" &&\n dc &&\n dc.readyState === \"open\" &&\n dc.bufferedAmount < 16384\n ) {\n try {\n dc.send(JSON.stringify({ sequence, events }));\n } catch {\n pending = [];\n control = false;\n release();\n post({ type: \"inputOverflow\" });\n }\n } else {\n sending = true;\n post({ type: \"input\", sequence, events });\n }\n }\n const inputTimer = setInterval(() => {\n // Hold displacement controls speed, even without further pointer moves.\n // Skip missed ticks while awaiting ACK instead of building a scroll backlog.\n if (wheelY?.moved && !sending) {\n const offset = Math.max(-24, Math.min(24, wheelY.y - wheelY.start));\n if (Math.abs(offset) > 4)\n scrollMouse(Math.sign(offset) * (Math.abs(offset) - 4) * 1.5);\n }\n flush();\n }, 33);\n cleanups.push(() => clearInterval(inputTimer));\n function release() {\n stopEdgePan();\n desktopPan = null;\n deferredClipboardModifier = null;\n clearTimeout(hold);\n if (gestureFrame !== null) cancelAnimationFrame(gestureFrame);\n gestureFrame = null;\n if (control) {\n queue({ kind: \"release\" });\n flush();\n }\n heldMouse.clear();\n resetWheel();\n updateMouseButtons();\n drag = false;\n pointers.clear();\n start = null;\n last = null;\n multi = null;\n }\n function updateMouseButtons() {\n mouseButtons.style.display =\n showMouseButtons && control && !nativeMouseControls ? \"block\" : \"none\";\n for (const [name, button] of [\n [\"left\", 0],\n [\"right\", 2],\n ])\n find(\"mouse-\" + name).setAttribute(\n \"aria-pressed\",\n String(heldMouse.has(button)),\n );\n }\n for (const [name, button] of [\n [\"left\", 0],\n [\"right\", 2],\n ]) {\n const el = find(\"mouse-\" + name);\n listenMouse(el, \"pointerdown\", (e) => {\n e.preventDefault();\n if (!control || !showMouseButtons || heldMouse.has(button)) return;\n clearTimeout(hold);\n if (!e.nativeInput) el.setPointerCapture(e.pointerId);\n heldMouse.set(button, e.pointerId);\n queue({ kind: \"button\", button, down: true, x: cx, y: cy });\n flush();\n updateMouseButtons();\n });\n const up = (e) => {\n e.preventDefault();\n if (heldMouse.get(button) !== e.pointerId) return;\n heldMouse.delete(button);\n queue({ kind: \"button\", button, down: false, x: cx, y: cy });\n flush();\n updateMouseButtons();\n };\n listenMouse(el, \"pointerup\", up);\n listenMouse(el, \"pointercancel\", up);\n listenMouse(el, \"lostpointercapture\", up);\n listenMouse(el, \"click\", (e) => {\n if (e.detail === 0 && control && showMouseButtons) {\n click(button);\n flush();\n }\n });\n }\n const scrollMouse = (dy) => {\n if (control && showMouseButtons && Number.isFinite(dy)) {\n queue({ kind: \"scroll\", dx: 0, dy: Math.max(-2000, Math.min(2000, dy)) });\n }\n };\n listenMouse(wheel, \"pointerdown\", (e) => {\n e.preventDefault();\n if (!control || !showMouseButtons || wheelY) return;\n if (!e.nativeInput) wheel.setPointerCapture(e.pointerId);\n wheelY = { id: e.pointerId, y: e.clientY, start: e.clientY, moved: false };\n });\n // A small dead zone preserves middle clicks; displacement drives the timer.\n listenMouse(wheel, \"pointermove\", (e) => {\n if (!wheelY || wheelY.id !== e.pointerId) return;\n e.preventDefault();\n wheelGrip.style.transform =\n \"translateY(\" +\n Math.max(-24, Math.min(24, e.clientY - wheelY.start)) +\n \"px)\";\n wheelY.y = e.clientY;\n if (Math.abs(e.clientY - wheelY.start) > 4) wheelY.moved = true;\n });\n listenMouse(wheel, \"pointerup\", (e) => {\n if (!wheelY || wheelY.id !== e.pointerId) return;\n e.preventDefault();\n if (!wheelY.moved && control && showMouseButtons) {\n click(1);\n flush();\n }\n resetWheel();\n });\n const cancelWheel = (e) => {\n if (wheelY?.id === e.pointerId) resetWheel();\n };\n listenMouse(wheel, \"pointercancel\", cancelWheel);\n listenMouse(wheel, \"lostpointercapture\", cancelWheel);\n listenMouse(wheel, \"click\", (e) => {\n if (e.detail === 0 && control && showMouseButtons) {\n click(1);\n flush();\n }\n });\n listenMouse(wheel, \"keydown\", (e) => {\n if (e.key === \"ArrowUp\" || e.key === \"ArrowDown\") {\n e.preventDefault();\n scrollMouse(e.key === \"ArrowUp\" ? -120 : 120);\n }\n });\n function insideDesktop(p) {\n const r = layout();\n return (\n p.x >= r.x && p.x <= r.x + r.width && p.y >= r.y && p.y <= r.y + r.height\n );\n }\n function point(p) {\n const r = layout();\n return {\n x: clamp((p.x - r.x) / r.width),\n y: clamp((p.y - r.y) / r.height),\n };\n }\n const desktopPoint = (e) => {\n const bounds = stage.getBoundingClientRect();\n return { x: e.clientX - bounds.left, y: e.clientY - bounds.top };\n };\n function stopEdgePan() {\n if (edgeFrame !== null) cancelAnimationFrame(edgeFrame);\n edgeFrame = null;\n edgePointer = null;\n }\n function edgePanTick(now) {\n edgeFrame = null;\n if (!edgePointer || desktopPan || !epoch) return;\n const r = layout(),\n vw = viewportWidth(),\n vh = viewportHeight();\n const p = edgePointer;\n const dt = Math.min(32, Math.max(0, now - edgeTime)) / 1000;\n edgeTime = now;\n // rAF timestamps describe the frame start and can precede the pointer\n // handler's performance.now(). A zero-time first frame is not a boundary.\n if (dt === 0) {\n edgeFrame = requestAnimationFrame(edgePanTick);\n return;\n }\n // A narrow edge band accelerates smoothly to 720 local pixels per second.\n const velocity = (position, extent) => {\n const band = Math.min(28, extent / 4);\n return position < band\n ? -(1 - position / band)\n : position > extent - band\n ? (position - extent + band) / band\n : 0;\n };\n const x =\n r.width > vw\n ? bounded(\n r.x - velocity(p.x - viewportLeft(), vw) * 720 * dt,\n viewportLeft() + vw - r.width,\n viewportLeft(),\n )\n : r.x;\n const y =\n r.height > vh\n ? bounded(r.y - velocity(p.y, vh) * 720 * dt, vh - r.height, 0)\n : r.y;\n if (Math.abs(x - r.x) < 0.001 && Math.abs(y - r.y) < 0.001) return;\n stopPanAnimation();\n manualViewMoved = true;\n place(x, y, r);\n // Keep remote hover/drag attached to the local pointer as the picture moves.\n if (control) {\n const next = point(p);\n cx = next.x;\n cy = next.y;\n queue({ kind: \"move\", x: cx, y: cy });\n }\n render();\n edgeFrame = requestAnimationFrame(edgePanTick);\n }\n function trackEdgePointer(e) {\n const p = desktopPoint(e);\n if (\n !epoch ||\n desktopPan ||\n p.x < viewportLeft() ||\n p.x > viewportLeft() + viewportWidth() ||\n p.y < 0 ||\n p.y > viewportHeight() ||\n !insideDesktop(p)\n ) {\n stopEdgePan();\n return;\n }\n edgePointer = p;\n if (edgeFrame === null) {\n edgeTime = performance.now();\n edgeFrame = requestAnimationFrame(edgePanTick);\n }\n }\n listen(stage, \"pointerleave\", stopEdgePan);\n function mouse(e, down) {\n if (!control || ![0, 1, 2].includes(e.button)) return;\n const local = desktopPoint(e);\n if (down && !insideDesktop(local)) return;\n const p = point(local);\n cx = p.x;\n cy = p.y;\n if (down) {\n showKeyboard(true);\n stage.setPointerCapture(e.pointerId);\n heldMouse.set(e.button, e.pointerId);\n } else if (!heldMouse.delete(e.button)) return;\n queue({ kind: \"button\", button: e.button, down, x: cx, y: cy });\n flush();\n render();\n }\n function click(button = 0) {\n if (control && mode === \"touch\") {\n clearTimeout(touchCursorTimer);\n touchCursor = { x: cx, y: cy };\n touchCursorVisible = true;\n render();\n touchCursorTimer = setTimeout(() => {\n touchCursorVisible = false;\n render();\n }, 450);\n }\n queue({ kind: \"button\", button, down: true, x: cx, y: cy });\n queue({ kind: \"button\", button, down: false, x: cx, y: cy });\n }\n function pan(dx, dy) {\n manualViewMoved = true;\n cursorNeedsEntry = true;\n stopPanAnimation();\n const r = layout(),\n b = panBounds(r);\n place(\n rubber(rubber(r.x, b.minX, b.maxX, true) + dx, b.minX, b.maxX),\n rubber(rubber(r.y, b.minY, b.maxY, true) + dy, b.minY, b.maxY),\n r,\n );\n render();\n }\n function pair() {\n const [a, b] = [...pointers.values()];\n return {\n x: (a.x + b.x) / 2,\n y: (a.y + b.y) / 2,\n d: Math.hypot(a.x - b.x, a.y - b.y),\n };\n }\n function movePair() {\n gestureFrame = null;\n if (pointers.size < 2 || !multi) return;\n const next = pair(),\n span = Math.abs(next.d - multi.d),\n travel = Math.hypot(next.x - multi.x, next.y - multi.y);\n if (multi.kind !== \"pinch\") {\n const pinchSlop = Math.max(6, Math.min(12, multi.d * 0.04));\n if (span >= pinchSlop && span > travel * 0.65) {\n // A parallel scroll may deliver its two pointer updates in different\n // frames. Confirm separation briefly before taking over as a pinch.\n if (!multi.candidate)\n multi.candidate = {\n at: Date.now(),\n d: next.d,\n zoom,\n anchor: point(next),\n };\n if (Date.now() - multi.candidate.at >= 40) {\n if (multi.kind === \"scroll\") {\n multi.d = multi.candidate.d;\n multi.zoom = multi.candidate.zoom;\n multi.anchor = multi.candidate.anchor;\n }\n multi.kind = \"pinch\";\n multi.candidate = null;\n } else {\n gestureFrame = requestAnimationFrame(movePair);\n return;\n }\n } else {\n multi.candidate = null;\n if (!multi.kind && travel > 8 && travel > span) {\n multi.kind = \"scroll\";\n multi.restX = 0;\n multi.restY = 0;\n multi.aimed = mode !== \"touch\";\n }\n }\n }\n if (multi.kind === \"pinch\") {\n manualViewMoved = true;\n cursorNeedsEntry = true;\n const { maxZoom } = layout();\n zoom = Math.max(\n 1,\n Math.min(\n maxZoom,\n (Math.min(maxZoom, multi.zoom) * next.d) / Math.max(1, multi.d),\n ),\n );\n const r = layout();\n fx =\n multi.anchor.x +\n (viewportLeft() + viewportWidth() / 2 - next.x) / r.width;\n fy =\n multi.anchor.y +\n (viewportHeight() / 2 + verticalOffset(r.height) - next.y) / r.height;\n const moved = layout(),\n b = panBounds(moved);\n place(\n rubber(moved.x, b.minX, b.maxX),\n rubber(moved.y, b.minY, b.maxY),\n moved,\n );\n } else if (multi.kind === \"scroll\") {\n const dx = next.x - multi.lastX,\n dy = next.y - multi.lastY;\n if (control && mode !== \"pan\") {\n // Hosts scroll whatever is under the desktop cursor. Touch mode has no\n // visible pointer, so aim it at the fingers once they are over the\n // desktop; like taps, scrolling over the letterbox does nothing.\n if (!multi.aimed && insideDesktop(next)) {\n const p = point(next);\n cx = p.x;\n cy = p.y;\n queue({ kind: \"move\", x: cx, y: cy });\n multi.aimed = true;\n }\n // Hosts inject whole pixels; carry fractions so slow drags still scroll.\n const sx = multi.restX - dx,\n sy = multi.restY - dy,\n wx = Math.trunc(sx),\n wy = Math.trunc(sy);\n multi.restX = sx - wx;\n multi.restY = sy - wy;\n if (multi.aimed && (wx || wy))\n queue({\n kind: \"scroll\",\n dx: Math.max(-2000, Math.min(2000, wx)),\n dy: Math.max(-2000, Math.min(2000, wy)),\n });\n } else pan(dx, dy);\n }\n if (multi.kind) {\n multi.lastX = next.x;\n multi.lastY = next.y;\n }\n render();\n }\n listen(stage, \"pointerdown\", (e) => {\n if (config.desktop) {\n e.preventDefault();\n if (\n e.button === 1 &&\n (layout().width > viewportWidth() || layout().height > viewportHeight())\n ) {\n stopEdgePan();\n stopPanAnimation();\n desktopPan = {\n id: e.pointerId,\n x: e.clientX,\n y: e.clientY,\n start: e,\n moved: false,\n };\n stage.setPointerCapture(e.pointerId);\n return;\n }\n mouse(e, true);\n return;\n }\n e.preventDefault();\n stopPanAnimation();\n stage.setPointerCapture(e.pointerId);\n pointers.set(e.pointerId, { x: e.clientX, y: e.clientY });\n if (pointers.size === 1) {\n cursorNeedsEntry = true;\n start = { x: e.clientX, y: e.clientY };\n last = start;\n moved = false;\n hold = setTimeout(() => {\n if (\n control &&\n mode !== \"pan\" &&\n !moved &&\n pointers.size === 1 &&\n !heldMouse.size &&\n (mode !== \"touch\" || insideDesktop(start))\n ) {\n if (mode === \"touch\") {\n const p = point(start);\n cx = p.x;\n cy = p.y;\n }\n queue({ kind: \"button\", button: 0, down: true, x: cx, y: cy });\n drag = true;\n }\n }, 400);\n } else {\n clearTimeout(hold);\n if (drag) queue({ kind: \"release\" });\n drag = false;\n start = null;\n const p = pair();\n multi = {\n ...p,\n lastX: p.x,\n lastY: p.y,\n zoom,\n anchor: point(p),\n kind: null,\n };\n }\n });\n listen(stage, \"pointermove\", (e) => {\n if (config.desktop) {\n if (desktopPan?.id === e.pointerId) {\n const dx = e.clientX - desktopPan.x,\n dy = e.clientY - desktopPan.y;\n if (!desktopPan.moved && Math.hypot(dx, dy) < 3) return;\n desktopPan.moved = true;\n desktopPan.x = e.clientX;\n desktopPan.y = e.clientY;\n pan(dx, dy);\n return;\n }\n trackEdgePointer(e);\n if (!control) return;\n const local = desktopPoint(e);\n if (!heldMouse.size && !insideDesktop(local)) return;\n const p = point(local);\n cx = p.x;\n cy = p.y;\n queue({ kind: \"move\", x: cx, y: cy });\n render();\n return;\n }\n if (!pointers.has(e.pointerId)) return;\n e.preventDefault();\n pointers.set(e.pointerId, { x: e.clientX, y: e.clientY });\n if (pointers.size >= 2) {\n if (gestureFrame === null) gestureFrame = requestAnimationFrame(movePair);\n return;\n }\n if (!start || !last) return;\n const now = { x: e.clientX, y: e.clientY },\n dx = now.x - last.x,\n dy = now.y - last.y;\n last = now;\n if (Math.hypot(now.x - start.x, now.y - start.y) > 6) {\n moved = true;\n clearTimeout(hold);\n }\n if (\n !control ||\n mode === \"pan\" ||\n (mode === \"touch\" && !drag && !heldMouse.size)\n ) {\n pan(dx, dy);\n return;\n }\n if (mode === \"pointer\") {\n moveTouchpad(dx, dy);\n } else {\n const p = point(now);\n cx = p.x;\n cy = p.y;\n }\n queue({ kind: \"move\", x: cx, y: cy });\n render();\n });\n function up(e) {\n if (config.desktop) {\n if (desktopPan?.id === e.pointerId) {\n const gesture = desktopPan;\n desktopPan = null;\n if (gesture.moved) settlePan();\n else {\n mouse(gesture.start, true);\n mouse(e, false);\n }\n return;\n }\n mouse(e, false);\n return;\n }\n if (!pointers.has(e.pointerId)) return;\n clearTimeout(hold);\n if (pointers.size >= 2 && multi) {\n pointers.set(e.pointerId, { x: e.clientX, y: e.clientY });\n if (gestureFrame !== null) cancelAnimationFrame(gestureFrame);\n movePair();\n if (gestureFrame !== null) cancelAnimationFrame(gestureFrame);\n gestureFrame = null;\n }\n pointers.delete(e.pointerId);\n if (drag) {\n queue({ kind: \"button\", button: 0, down: false, x: cx, y: cy });\n drag = false;\n } else if (\n start &&\n !moved &&\n control &&\n mode !== \"pan\" &&\n !heldMouse.size &&\n e.type === \"pointerup\" &&\n (mode !== \"touch\" || insideDesktop({ x: e.clientX, y: e.clientY }))\n ) {\n if (mode === \"touch\") {\n const p = point({ x: e.clientX, y: e.clientY });\n cx = p.x;\n cy = p.y;\n }\n click();\n }\n start = null;\n last = null;\n multi = null;\n render();\n if (!pointers.size && manualViewMoved) settlePan();\n }\n listen(stage, \"pointerup\", up);\n listen(stage, \"pointercancel\", () => {\n release();\n settlePan();\n });\n listen(stage, \"lostpointercapture\", () => {\n desktopPan = null;\n if (config.desktop && heldMouse.size) release();\n });\n if (config.desktop)\n listen(\n stage,\n \"wheel\",\n (e) => {\n e.preventDefault();\n if (!control) return;\n const factor =\n e.deltaMode === 1 ? 16 : e.deltaMode === 2 ? stage.clientHeight : 1;\n queue({\n kind: \"scroll\",\n dx: Math.max(-2000, Math.min(2000, e.deltaX * factor)),\n dy: Math.max(-2000, Math.min(2000, e.deltaY * factor)),\n });\n flush();\n },\n { passive: false },\n );\n listen(config.desktop ? stage : document, \"contextmenu\", (e) =>\n e.preventDefault(),\n );\n // Scope selection suppression to the desktop surface, preserving the hidden\n // textarea's native keyboard/IME editing and programmatic selection.\n listen(stage, \"selectstart\", (e) => e.preventDefault());\n listen(stage, \"dragstart\", (e) => e.preventDefault());\n const normalizedKey = (code) =>\n /^(Shift|Control|Alt|Meta)Right$/.test(code)\n ? code.replace(/Right$/, \"Left\")\n : code;\n const hardwareKeys = new Set();\n function flushClipboardModifier() {\n if (!deferredClipboardModifier) return;\n const code = deferredClipboardModifier;\n deferredClipboardModifier = null;\n hardwareKeys.add(code);\n queue({ kind: \"key\", code, down: true });\n }\n listen(document, \"keydown\", (e) => {\n if (config.desktop) {\n if (e.ctrlKey && e.altKey && e.code === \"Escape\") {\n e.preventDefault();\n release();\n showKeyboard(false);\n post({ type: \"releaseFocus\" });\n return;\n }\n if (\n document.activeElement !== keyboardInput ||\n e.isComposing ||\n composing\n )\n return;\n if (\n control &&\n clipboardShortcuts &&\n normalizedKey(e.code) ===\n (clipboardModifier === \"meta\" ? \"MetaLeft\" : \"ControlLeft\")\n ) {\n e.preventDefault();\n if (!hardwareKeys.has(normalizedKey(e.code)))\n deferredClipboardModifier = normalizedKey(e.code);\n return;\n }\n if (\n control &&\n clipboardShortcuts &&\n (clipboardModifier === \"meta\"\n ? e.metaKey && !e.ctrlKey\n : e.ctrlKey && !e.metaKey) &&\n !e.altKey &&\n !e.shiftKey &&\n (e.code === \"KeyC\" || e.code === \"KeyV\")\n ) {\n e.preventDefault();\n if (!e.repeat) {\n release();\n hardwareKeys.clear();\n post({\n type: \"clipboard\",\n action: e.code === \"KeyC\" ? \"copy\" : \"paste\",\n });\n }\n return;\n }\n }\n // The focused textarea delivers characters through input (and editing\n // keys through beforeinput). Forwarding their keydown too types twice on\n // iOS, where the software keyboard reports both events.\n if (\n (config.desktop || keyboardEnabled) &&\n document.activeElement === keyboardInput &&\n !e.ctrlKey &&\n !e.metaKey &&\n !e.altKey &&\n (e.key?.length === 1 ||\n e.key === \"Process\" ||\n e.key === \"Dead\" ||\n (keyboardEnabled && [\"Backspace\", \"Enter\"].includes(e.code)))\n )\n return;\n if (control && validKeys.has(normalizedKey(e.code))) {\n e.preventDefault();\n flushClipboardModifier();\n hardwareKeys.add(normalizedKey(e.code));\n queue({ kind: \"key\", code: normalizedKey(e.code), down: true });\n }\n });\n listen(document, \"keyup\", (e) => {\n const code = normalizedKey(e.code);\n if (config.desktop && control && deferredClipboardModifier === code) {\n flushClipboardModifier();\n }\n if (!hardwareKeys.delete(code)) return;\n if (control && validKeys.has(code)) {\n e.preventDefault();\n queue({ kind: \"key\", code, down: false });\n }\n });\n if (config.desktop)\n listen(keyboardInput, \"blur\", () => {\n hardwareKeys.clear();\n release();\n });\n listen(window, \"blur\", () => {\n release();\n settlePan();\n });\n function reportViewport() {\n post({\n type: \"viewportChanged\",\n width: viewportWidth(),\n height: usableHeight(),\n });\n }\n const observer = new ResizeObserver(() => {\n statusOrigin = null;\n reportViewport();\n release();\n settlePan();\n render();\n });\n observer.observe(stage);\n cleanups.push(\n () => observer.disconnect(),\n () => stopPanAnimation(),\n () => stopBackgroundLoop(),\n () => clearTimeout(touchCursorTimer),\n );\n // Keep one bounded frame in this document only; never persist desktop pixels.\n // Snapshot before detaching the track. A JPEG fallback already lives in image.\n function retainFrame() {\n if (\n !videoPresented ||\n video.style.display !== \"block\" ||\n video.readyState < 2 ||\n !video.videoWidth ||\n !video.videoHeight\n )\n return;\n const canvas = document.createElement(\"canvas\");\n try {\n const scale = Math.min(\n 1,\n 1280 / Math.max(video.videoWidth, video.videoHeight),\n );\n canvas.width = Math.max(1, Math.round(video.videoWidth * scale));\n canvas.height = Math.max(1, Math.round(video.videoHeight * scale));\n const context = canvas.getContext(\"2d\");\n if (context) {\n context.drawImage(video, 0, 0, canvas.width, canvas.height);\n image.src = canvas.toDataURL(\"image/jpeg\", 0.7);\n }\n } catch {\n /* Keep the previous compatibility frame if WebKit cannot read video. */\n } finally {\n canvas.width = 0;\n canvas.height = 0;\n }\n }\n /* BEGIN RTC */\n\n let trickleIce = false,\n attemptId = null,\n retries = 0,\n exchangeId = 0;\n let configPending = false;\n let videoPresented = false,\n videoFrameCallback = null,\n videoPaintCallback = null;\n function cancelVideoHandoff() {\n if (videoFrameCallback !== null)\n video.cancelVideoFrameCallback?.(videoFrameCallback);\n if (videoPaintCallback !== null) cancelAnimationFrame(videoPaintCallback);\n videoFrameCallback = videoPaintCallback = null;\n }\n function revealVideo(g) {\n post({ type: \"videoFrameReady\", attemptId });\n // Keep the JPEG decoded and painted as a backing layer. Promote the video\n // only after its first frame; removing the image exposes WebKit repaint gaps.\n videoPaintCallback = requestAnimationFrame(() => {\n if (g !== generation) return;\n videoPaintCallback = requestAnimationFrame(() => {\n if (g !== generation) return;\n videoPaintCallback = null;\n videoPresented = true;\n video.style.zIndex = \"2\";\n if (typeof startBackgroundLoop === \"function\") startBackgroundLoop();\n post({ type: \"streaming\", attemptId });\n post({\n type: \"pipCapability\",\n supported: !!(\n video.webkitSupportsPresentationMode?.(\"picture-in-picture\") ||\n document.pictureInPictureEnabled\n ),\n });\n });\n });\n }\n function waitForVideoFrame(g) {\n if (g !== generation) return;\n if (\n video.readyState >= 2 &&\n video.videoWidth > 0 &&\n video.videoHeight > 0\n ) {\n revealVideo(g);\n return;\n }\n videoPaintCallback = requestAnimationFrame(() => waitForVideoFrame(g));\n }\n let retryTimer = null,\n deadlineTimer = null,\n disconnectTimer = null,\n stableTimer = null,\n iceTimer = null,\n gatherTimer = null,\n gatherDone = null;\n let localCandidates = [],\n localAck = 0,\n remoteAfter = 0,\n icePending = null,\n remoteSeen = new Set(),\n exchangeUntil = 0,\n remoteComplete = false;\n function clearRtcTimers() {\n for (const timer of [\n retryTimer,\n deadlineTimer,\n disconnectTimer,\n stableTimer,\n iceTimer,\n gatherTimer,\n ])\n clearTimeout(timer);\n retryTimer =\n deadlineTimer =\n disconnectTimer =\n stableTimer =\n iceTimer =\n gatherTimer =\n null;\n if (gatherDone) {\n gatherDone();\n gatherDone = null;\n }\n }\n function closeRtc(preserveFrame = true) {\n configPending = false;\n if (preserveFrame) retainFrame();\n generation++;\n clearRtcTimers();\n cancelVideoHandoff();\n videoPresented = false;\n localCandidates = [];\n localAck = remoteAfter = 0;\n icePending = null;\n remoteSeen = new Set();\n attemptId = null;\n clearInterval(statsTimer);\n statsTimer = null;\n statsSample = null;\n if (dc) dc.close();\n if (pc) pc.close();\n pc = null;\n dc = null;\n video.onplaying = null;\n video.srcObject = null;\n video.style.display = \"none\";\n video.style.zIndex = \"0\";\n image.style.display = \"block\";\n if (typeof stopBackgroundLoop === \"function\") stopBackgroundLoop();\n if (!preserveFrame) {\n image.removeAttribute(\"src\");\n if (typeof clearBackground === \"function\") clearBackground();\n }\n }\n function failRtc(reason, canRetry = true) {\n const failedAttempt = attemptId;\n release();\n closeRtc();\n post({ type: \"fallback\", attemptId: failedAttempt, reason });\n // Local consent is bounded by the host's picker lifetime. Reuse this retry\n // timer without consuming the finite network-recovery attempts.\n const capturePending = reason === \"capture-pending\";\n if (canRetry && epoch && (capturePending || retries < net.retryMs.length)) {\n const delay = capturePending\n ? net.retryMs[net.retryMs.length - 1]\n : net.retryMs[retries++];\n retryTimer = setTimeout(() => {\n retryTimer = null;\n if (epoch) connect();\n }, delay);\n }\n }\n function pollIce() {\n if (\n !pc ||\n !trickleIce ||\n !pc.remoteDescription ||\n icePending ||\n Date.now() >= exchangeUntil\n )\n return;\n const candidates = localCandidates.slice(\n localAck,\n localAck + net.batchSize,\n );\n icePending = {\n after: remoteAfter,\n sent: candidates.length,\n exchangeId: ++exchangeId,\n };\n post({\n type: \"ice\",\n attemptId,\n candidates,\n after: remoteAfter,\n exchangeId,\n });\n iceTimer = setTimeout(() => {\n icePending = null;\n pollIce();\n }, 4500);\n }\n async function receiveIce(message) {\n if (\n !pc ||\n !icePending ||\n message.attemptId !== attemptId ||\n message.exchangeId !== icePending.exchangeId\n )\n return;\n const rtc = pc,\n g = generation,\n batch = icePending;\n clearTimeout(iceTimer);\n try {\n if (message.error) {\n icePending = null;\n iceTimer = setTimeout(pollIce, 1000);\n return;\n }\n if (\n !Array.isArray(message.candidates) ||\n message.candidates.length > net.batchSize ||\n message.next !== batch.after + message.candidates.length ||\n message.next > net.maxCandidates\n )\n throw new Error();\n for (const candidate of message.candidates) {\n if (g !== generation) return;\n const key = JSON.stringify(candidate);\n if (remoteSeen.has(key)) continue;\n if (remoteSeen.size >= net.maxCandidates) throw new Error();\n await rtc.addIceCandidate(candidate);\n if (g !== generation) return;\n remoteSeen.add(key);\n }\n if (g !== generation) return;\n localAck += batch.sent;\n remoteAfter = message.next;\n remoteComplete = message.complete === true;\n icePending = null;\n if (!(\n remoteComplete &&\n rtc.iceGatheringState === \"complete\" &&\n localAck === localCandidates.length\n ))\n iceTimer = setTimeout(pollIce, net.pollMs);\n } catch {\n if (g === generation) failRtc(\"candidates\");\n }\n }\n async function receiveAnswer(message) {\n if (!pc || message.attemptId !== attemptId) return;\n const rtc = pc,\n g = generation;\n try {\n await rtc.setRemoteDescription({ type: \"answer\", sdp: message.sdp });\n if (g !== generation) return;\n clearTimeout(deadlineTimer);\n deadlineTimer = setTimeout(() => {\n if (g === generation && rtc.connectionState !== \"connected\")\n failRtc(\"connect-timeout\");\n }, net.connectMs);\n exchangeUntil = Date.now() + net.exchangeMs;\n pollIce();\n } catch {\n if (g === generation) failRtc(\"answer\");\n }\n }\n async function connect() {\n closeRtc();\n const g = generation;\n attemptId = String(g);\n if (!window.RTCPeerConnection) {\n failRtc(\"unsupported\", false);\n return;\n }\n configPending = true;\n deadlineTimer = setTimeout(\n () => {\n if (g === generation && configPending) {\n configPending = false;\n void startRtc(g, iceServers);\n }\n },\n (net.iceConfigMs ?? 8000) + (net.iceConfigBridgeMs ?? 500),\n );\n return post({ type: \"iceConfig\", attemptId });\n }\n async function receiveIceConfig(message) {\n if (!epoch || !configPending || message.attemptId !== attemptId) return;\n configPending = false;\n clearTimeout(deadlineTimer);\n deadlineTimer = null;\n await startRtc(generation, message.iceServers);\n }\n async function startRtc(g, servers) {\n try {\n const rtc = new RTCPeerConnection({ iceServers: servers });\n pc = rtc;\n dc = rtc.createDataChannel(\"input-v1\");\n rtc.addTransceiver(\"video\", { direction: \"recvonly\" });\n rtc.addTransceiver(\"audio\", { direction: \"recvonly\" });\n rtc.onicecandidate = ({ candidate }) => {\n if (g !== generation || !candidate?.candidate || !trickleIce) return;\n if (localCandidates.length >= net.maxCandidates) {\n failRtc(\"candidate-limit\", false);\n return;\n }\n localCandidates.push({\n candidate: candidate.candidate,\n sdpMid: candidate.sdpMid,\n sdpMLineIndex: candidate.sdpMLineIndex,\n ...(candidate.usernameFragment\n ? { usernameFragment: candidate.usernameFragment }\n : {}),\n });\n // Gathering continues after the offer; the serial exchange flushes late addresses.\n };\n dc.onmessage = (e) => {\n try {\n if (g !== generation || pc !== rtc) return;\n if (typeof e.data !== \"string\" || e.data.length > 80000) return;\n const message = JSON.parse(e.data);\n if (message.type === \"cursor\") receiveCursor(message.cursor);\n if (\n message.type === \"reply\" &&\n typeof message.id === \"string\" &&\n message.id.length <= 64\n )\n post({\n type: \"channelReply\",\n id: message.id,\n ok: message.ok === true,\n result: message.result,\n error: typeof message.error === \"string\" ? message.error : null,\n });\n if (\n (video.webkitPresentationMode === \"picture-in-picture\" ||\n document.pictureInPictureElement === video) &&\n message.type === \"viewPing\" &&\n typeof message.challenge === \"string\" &&\n message.challenge.length <= 64 &&\n dc?.readyState === \"open\"\n )\n dc.send(message.challenge);\n } catch {}\n };\n let readingStats = false;\n statsTimer = setInterval(async () => {\n if (readingStats || g !== generation) return;\n readingStats = true;\n try {\n const stats = await rtc.getStats();\n if (g !== generation || pc !== rtc) return;\n const result = networkStats(stats, statsSample);\n statsSample = result.sample;\n post({\n type: \"network\",\n transport: result.transport,\n bytesPerSecond: result.bytesPerSecond,\n latencyMs: result.latencyMs,\n });\n } catch {\n } finally {\n readingStats = false;\n }\n }, 1000);\n rtc.ontrack = (e) => {\n if (g !== generation) return;\n video.srcObject = e.streams[0] || new MediaStream([e.track]);\n video.play().catch(() => {});\n };\n video.onplaying = () => {\n if (\n g !== generation ||\n videoPresented ||\n videoFrameCallback !== null ||\n videoPaintCallback !== null\n )\n return;\n video.style.display = \"block\";\n render();\n if (typeof scheduleBackgroundDraw === \"function\")\n scheduleBackgroundDraw();\n if (typeof video.requestVideoFrameCallback === \"function\") {\n videoFrameCallback = video.requestVideoFrameCallback(() => {\n if (g !== generation) return;\n videoFrameCallback = null;\n revealVideo(g);\n });\n } else waitForVideoFrame(g);\n };\n rtc.onconnectionstatechange = () => {\n if (g !== generation) return;\n if ([\"failed\", \"closed\"].includes(rtc.connectionState)) {\n failRtc(\"transport\");\n return;\n }\n if (rtc.connectionState === \"disconnected\") {\n clearTimeout(stableTimer);\n stableTimer = null;\n if (!disconnectTimer) {\n release();\n post({ type: \"reconnecting\", attemptId });\n disconnectTimer = setTimeout(() => {\n if (g === generation) failRtc(\"disconnected\");\n }, net.disconnectedMs);\n }\n } else if (rtc.connectionState === \"connected\") {\n clearTimeout(disconnectTimer);\n disconnectTimer = null;\n clearTimeout(deadlineTimer);\n if (!stableTimer)\n stableTimer = setTimeout(() => {\n if (g === generation) retries = 0;\n }, net.stableMs);\n if (videoPresented) post({ type: \"streaming\", attemptId });\n }\n };\n await rtc.setLocalDescription(await rtc.createOffer());\n if (!trickleIce)\n await new Promise((resolve) => {\n if (rtc.iceGatheringState === \"complete\") return resolve();\n gatherDone = resolve;\n gatherTimer = setTimeout(resolve, net.legacyGatherMs);\n rtc.onicegatheringstatechange = () => {\n if (rtc.iceGatheringState === \"complete\") {\n clearTimeout(gatherTimer);\n resolve();\n }\n };\n });\n if (g !== generation) return;\n post({ type: \"offer\", attemptId, sdp: rtc.localDescription.sdp });\n deadlineTimer = setTimeout(() => {\n if (g === generation) failRtc(\"answer-timeout\");\n }, net.answerMs);\n } catch {\n if (g === generation) failRtc(\"setup\");\n }\n }\n\n /* END RTC */\n function reportPresentation() {\n post({\n type: \"presentation\",\n active:\n video.webkitPresentationMode === \"picture-in-picture\" ||\n document.pictureInPictureElement === video,\n });\n }\n listen(video, \"webkitpresentationmodechanged\", reportPresentation);\n listen(video, \"enterpictureinpicture\", reportPresentation);\n listen(video, \"leavepictureinpicture\", reportPresentation);\n function applyDisplayGeometry(message) {\n if (\n !Number.isInteger(message.width) ||\n !Number.isInteger(message.height) ||\n message.width < 320 ||\n message.height < 320 ||\n (message.restore !== true &&\n (message.width > 2560 || message.height > 2560))\n )\n return;\n release();\n stopPanAnimation();\n viewerSized = message.restore !== true;\n zoom = 1;\n desktopScale = null;\n fx = fy = 0.5;\n followRest = null;\n dw = message.width;\n dh = message.height;\n render();\n }\n function receive(event) {\n let message;\n try {\n message = JSON.parse(event.data);\n } catch {\n return;\n }\n switch (message.type) {\n // A small control request routed over the live data channel. The host\n // only receives it after advertising support; otherwise the parent uses\n // the relay. `sent` tells the parent whether the channel took it.\n case \"channelRequest\": {\n const id =\n typeof message.id === \"string\" && message.id.length <= 64\n ? message.id\n : null;\n if (!id) break;\n let sent = false;\n try {\n const data = JSON.stringify({\n type: \"request\",\n id,\n request: message.request,\n });\n if (\n pc?.connectionState === \"connected\" &&\n dc?.readyState === \"open\" &&\n dc.bufferedAmount < 16384 &&\n data.length <= 32768\n ) {\n dc.send(data);\n sent = true;\n }\n } catch {}\n post({ type: \"channelRequestState\", id, sent });\n break;\n }\n case \"measureViewport\":\n post({\n type: \"viewportSize\",\n width: viewportWidth(),\n height: usableHeight(),\n });\n break;\n case \"presentation\":\n if (config.nativeMedia) {\n release();\n showKeyboard(false);\n break;\n }\n try {\n if (message.enabled) {\n release();\n showKeyboard(false);\n if (video.webkitSupportsPresentationMode?.(\"picture-in-picture\"))\n video.webkitSetPresentationMode(\"picture-in-picture\");\n else if (video.requestPictureInPicture)\n video\n .requestPictureInPicture()\n .catch(() => post({ type: \"presentationFailed\" }));\n else post({ type: \"presentationFailed\" });\n } else if (video.webkitSetPresentationMode)\n video.webkitSetPresentationMode(\"inline\");\n else if (document.pictureInPictureElement)\n document.exitPictureInPicture().catch(() => {});\n } catch {\n post({ type: \"presentationFailed\" });\n }\n break;\n case \"videoSettings\":\n applyDisplayGeometry(message);\n video.muted = !message.audio;\n retries = 0;\n if (!config.nativeMedia) connect();\n break;\n // The host kept the stream across a display change: layout only.\n case \"displayGeometry\":\n applyDisplayGeometry(message);\n break;\n case \"keyboard\":\n showKeyboard(message.enabled === true);\n break;\n case \"resume\":\n if (video.srcObject) video.play().catch(() => {});\n break;\n case \"releaseInput\":\n release();\n break;\n case \"theme\":\n if (/^#[0-9a-f]{3,8}$/i.test(message.surface)) {\n document.body.style.background = config.nativeMedia\n ? \"transparent\"\n : message.surface;\n document.documentElement.style.background = config.nativeMedia\n ? \"transparent\"\n : message.surface;\n document.documentElement.style.setProperty(\n \"--surface\",\n message.surface,\n );\n }\n if (/^#[0-9a-f]{3,8}$/i.test(message.foreground)) {\n cursor.style.borderColor = message.foreground;\n document.documentElement.style.setProperty(\n \"--foreground\",\n message.foreground,\n );\n }\n break;\n case \"networkStatus\": {\n const status = find(\"network-status\");\n if (!status) break;\n status.textContent =\n typeof message.text === \"string\" ? message.text : \"\";\n status.style.display = status.textContent ? \"block\" : \"none\";\n for (const key of [\"top\", \"right\", \"fontSize\"]) {\n if (Number.isFinite(message[key]) && message[key] >= 0)\n status.style[key] = message[key] + \"px\";\n }\n if (/^#[0-9a-f]{3,8}$/i.test(message.color))\n status.style.color = message.color;\n statusOrigin = null;\n clipNetworkStatus();\n break;\n }\n case \"nativeTouchpad\": {\n if (!nativeMouseControls || !control) break;\n if (message.tap === true) {\n if (!heldMouse.size) { click(); flush(); }\n break;\n }\n if (!Number.isFinite(message.dx) || !Number.isFinite(message.dy)) break;\n moveTouchpad(message.dx, message.dy);\n queue({ kind: \"move\", x: cx, y: cy });\n touchCursor = { x: cx, y: cy };\n touchCursorVisible = true;\n render();\n break;\n }\n case \"nativeMouse\": {\n if (\n !nativeMouseControls ||\n ![\"left\", \"right\", \"wheel\"].includes(message.control)\n )\n break;\n if (\n ![\n \"pointerdown\",\n \"pointermove\",\n \"pointerup\",\n \"pointercancel\",\n \"click\",\n ].includes(message.event)\n )\n break;\n if (!Number.isFinite(message.id) || !Number.isFinite(message.y)) break;\n mouseControlHandlers.get(\n \"mouse-\" + message.control + \":\" + message.event,\n )?.({\n pointerId: message.id,\n clientY: message.y,\n detail: 0,\n nativeInput: true,\n preventDefault() {},\n });\n break;\n }\n case \"mouseButtons\": {\n nativeMouseControls = message.native === true;\n const before = layout(),\n previousTopInset = viewportTopInset,\n previousBottomInset = viewportBottomInset,\n keyboardOpen = fillHeight && message.keyboardOpen === true;\n const keepHorizontal =\n fillHeight && (keyboardOpen || keyboardViewportOpen);\n // Hiding the rail for the keyboard must not enlarge a width-fitted desktop.\n if (keyboardOpen && (!keyboardViewportOpen || !keyboardFitWidth)) {\n keyboardFitWidth = { stageWidth: stage.clientWidth, width: viewportWidth() };\n }\n if (!keyboardOpen) keyboardFitWidth = null;\n // Opening is observable before the native keyboard has a measured height.\n keyboardViewportOpen = keyboardOpen;\n const fitChanged = fitToInsets !== (message.fitToInsets === true);\n fitToInsets = message.fitToInsets === true;\n const previousOffset = portraitKeyboardTopInset;\n if (Number.isFinite(message.portraitKeyboardTopInset))\n portraitKeyboardTopInset = Math.max(\n 0,\n message.portraitKeyboardTopInset,\n );\n const offsetChanged = previousOffset !== portraitKeyboardTopInset;\n let sideInsetsChanged = false;\n if (Number.isFinite(message.topInset))\n viewportTopInset = Math.max(\n 0,\n Math.min(stage.clientHeight - 1, message.topInset),\n );\n if (Number.isFinite(message.bottomInset))\n viewportBottomInset = Math.max(\n 0,\n Math.min(stage.clientHeight - 1, message.bottomInset),\n );\n if (Number.isFinite(message.leftInset)) {\n const inset = Math.max(\n 0,\n Math.min(stage.clientWidth - 1, message.leftInset),\n );\n sideInsetsChanged = sideInsetsChanged || inset !== viewportLeftInset;\n viewportLeftInset = inset;\n }\n if (Number.isFinite(message.rightInset)) {\n const inset = Math.max(\n 0,\n Math.min(stage.clientWidth - 1, message.rightInset),\n );\n sideInsetsChanged = sideInsetsChanged || inset !== viewportRightInset;\n viewportRightInset = inset;\n }\n // Hiding the side toolbar changes the viewport center. Keep the image's\n // actual horizontal position instead of following that center sideways.\n if (keepHorizontal) {\n stopPanAnimation();\n const r = layout();\n place(before.x, r.y, r);\n }\n const keyboardInset = keyboardOpen ? viewportBottomInset : 0;\n if (keyboardInset !== keyboardViewportInset) {\n const wasOpen = keyboardViewportInset > 0;\n keyboardViewportInset = keyboardInset;\n if (fillHeight && (keyboardInset > 0 || wasOpen)) {\n const r = layout(),\n v = cursorViewport();\n place(r.x, (v.minY + v.maxY) / 2 - cy * r.height, r);\n cursorNeedsEntry = false;\n manualViewMoved = false;\n }\n }\n if (keepHorizontal) {\n // Restoring the toolbar can cover the cursor even after a zero-height opening.\n if (!keyboardOpen || keyboardInset > 0) {\n const r = layout(),\n v = cursorViewport(),\n x = r.x + cx * r.width;\n place(r.x + bounded(x, v.minX, v.maxX) - x, r.y, r);\n }\n followRest = { fx, fy, zoom };\n render();\n } else if (\n fitChanged ||\n sideInsetsChanged ||\n offsetChanged ||\n (usesViewportInsets() && previousTopInset !== viewportTopInset) ||\n (usesViewportInsets() && previousBottomInset !== viewportBottomInset)\n ) {\n settlePan();\n render();\n }\n reportViewport();\n if (!message.enabled) {\n for (const button of heldMouse.keys())\n queue({ kind: \"button\", button, down: false, x: cx, y: cy });\n heldMouse.clear();\n resetWheel();\n flush();\n }\n for (const [edge, value] of [\n [\"bottom\", message.bottomInset],\n [\"right\", message.rightInset],\n ])\n if (Number.isFinite(value) && value >= 0 && value <= 4096)\n mouseButtons.style[edge] = value + \"px\";\n showMouseButtons = message.enabled === true;\n for (const name of [\"left\", \"right\", \"wheel\"])\n if (typeof message.labels?.[name] === \"string\")\n find(\"mouse-\" + name).setAttribute(\n \"aria-label\",\n message.labels[name],\n );\n updateMouseButtons();\n break;\n }\n case \"init\":\n nativeVideoActive = false;\n image.style.visibility = \"visible\";\n desktopScale = null;\n reportedScaleMode = null;\n if (config.desktop) {\n zoom = 1;\n fx = 0.5;\n fy = 0.5;\n }\n viewerSized = false;\n followRest = null;\n cursorNeedsEntry = true;\n stopPanAnimation();\n resetCursor();\n control = false;\n release();\n pending = [];\n sending = false;\n seq = 0;\n epoch = message.epoch;\n clipboardShortcuts =\n config.desktop && message.clipboardShortcuts === true;\n clipboardModifier =\n message.clipboardModifier === \"meta\" ? \"meta\" : \"control\";\n dw = message.width;\n dh = message.height;\n fillHeight = message.fillHeight === true;\n video.muted = !message.audio;\n trickleIce = message.trickleIce === true;\n retries = 0;\n render();\n if (!config.nativeMedia) connect();\n break;\n case \"nativeVideo\":\n if (!config.nativeMedia || message.epoch !== epoch) break;\n nativeVideoActive = message.active === true;\n image.style.visibility = nativeVideoActive ? \"hidden\" : \"visible\";\n clipNetworkStatus();\n paintBackground();\n break;\n case \"nativeCursor\":\n if (config.nativeMedia && message.epoch === epoch)\n receiveCursor(message.cursor);\n break;\n case \"viewport\":\n if (fillHeight !== (message.fillHeight === true)) keyboardFitWidth = null;\n fillHeight = message.fillHeight === true;\n release();\n render();\n break;\n case \"answer\":\n if (message.epoch === epoch) void receiveAnswer(message);\n break;\n case \"iceConfig\":\n if (message.epoch === epoch) void receiveIceConfig(message);\n break;\n case \"ice\":\n if (message.epoch === epoch) void receiveIce(message);\n break;\n case \"fallback\":\n if (message.epoch === epoch && message.attemptId === attemptId)\n failRtc(\n message.capturePending === true ? \"capture-pending\" : \"host\",\n message.retry !== false,\n );\n break;\n case \"frame\": {\n if (\"cursor\" in message) receiveCursor(message.cursor);\n else resetCursor();\n const frameEpoch = epoch;\n image.onload = () => {\n if (epoch === frameEpoch) {\n scheduleBackgroundDraw();\n post({ type: \"framePresented\" });\n }\n };\n image.src = \"data:image/jpeg;base64,\" + message.jpeg;\n break;\n }\n case \"control\":\n release();\n // A new control intent abandons the previous relay batch. Advance the\n // existing sequence fence so a late old ACK cannot unlock a new batch.\n seq++;\n sending = false;\n control = message.enabled;\n if (!control) showKeyboard(false);\n pending = [];\n updateMouseButtons();\n render();\n break;\n case \"mode\":\n release();\n if (message.mode !== \"pointer\") followRest = null;\n settlePan();\n clearTimeout(touchCursorTimer);\n touchCursorVisible = false;\n mode = message.mode;\n render();\n break;\n case \"zoom\":\n stopEdgePan();\n if (\n !config.desktop ||\n !Number.isFinite(message.factor) ||\n message.factor <= 0\n )\n break;\n followRest = null;\n cursorNeedsEntry = true;\n manualViewMoved = true;\n stopPanAnimation();\n const fitScale = Math.min(viewportWidth() / dw, viewportHeight() / dh);\n // Include actual size even when it lies outside the fit-relative range.\n desktopScale = Math.max(\n Math.min(fitScale, 1) * 0.1,\n Math.min(Math.max(5 * fitScale, 5), layout().scale * message.factor),\n );\n if (Math.abs(desktopScale - fitScale) < 1e-9) desktopScale = null;\n if (desktopScale === null) {\n fx = 0.5;\n fy = 0.5;\n manualViewMoved = false;\n }\n render();\n settlePan();\n break;\n case \"actualSize\":\n stopEdgePan();\n if (!config.desktop) break;\n followRest = null;\n cursorNeedsEntry = true;\n manualViewMoved = true;\n stopPanAnimation();\n desktopScale = 1;\n fx = 0.5;\n fy = 0.5;\n render();\n break;\n case \"fit\":\n stopEdgePan();\n desktopScale = null;\n followRest = null;\n cursorNeedsEntry = true;\n manualViewMoved = false;\n stopPanAnimation();\n zoom = 1;\n fx = 0.5;\n fy = 0.5;\n render();\n break;\n case \"rightClick\":\n click(2);\n break;\n case \"events\":\n for (const e of message.events) queue(e);\n flush();\n break;\n case \"ack\":\n if (message.epoch === epoch && message.sequence === seq)\n sending = false;\n break;\n case \"stop\":\n nativeVideoActive = false;\n image.style.visibility = \"visible\";\n showKeyboard(false);\n control = false;\n release();\n pending = [];\n sending = false;\n epoch = null;\n closeRtc(message.preserveFrame === true);\n updateMouseButtons();\n render();\n break;\n }\n }\n // iOS can report equal left/right safe areas in both landscape directions.\n // Its interface angle distinguishes the notch side even on a 180-degree turn.\n const reportOrientation = () => {\n const angle =\n typeof window.orientation === \"number\"\n ? window.orientation\n : window.screen?.orientation?.angle;\n if (Number.isFinite(angle)) post({ type: \"orientation\", angle });\n };\n listen(window, \"orientationchange\", reportOrientation);\n if (window.screen?.orientation?.addEventListener)\n listen(window.screen.orientation, \"change\", reportOrientation);\n render();\n reportOrientation();\n post({ type: \"ready\" });\n return {\n receive: (message) => receive({ data: JSON.stringify(message) }),\n dispose: () => {\n release();\n epoch = null;\n closeRtc(false);\n if (bgDrawFrame !== null) cancelAnimationFrame(bgDrawFrame);\n bgDrawFrame = null;\n for (const cleanup of cleanups) cleanup();\n },\n };\n}\n";+export const DESKTOP_VIEWER_SOURCE = "/** Shared browser viewer. Mobile bundles this exact source; Desktop imports it as a CSP-safe module. */\nfunction mountRemoteDesktopViewer(root, postMessage, config) {\n const cleanups = [];\n const listen = (target, type, fn, options) => {\n target.addEventListener(type, fn, options);\n cleanups.push(() => target.removeEventListener(type, fn, options));\n };\n const find = (id) =>\n root.getElementById\n ? root.getElementById(id)\n : root.querySelector(\"#\" + id);\n const { net, iceServers } = config;\n let nativeVideoActive = false;\n const validKeys = new Set(config.keyCodes);\n const transform =\n /* BEGIN TRANSFORM */\n function desktopTransform(\n vw,\n vh,\n dw,\n dh,\n zoom,\n fx,\n fy,\n fillHeight = false,\n ) {\n const fit = fillHeight\n ? vh / Math.max(1, dh)\n : Math.min(vw / Math.max(1, dw), vh / Math.max(1, dh));\n // Pinch stops at two viewer points per desktop point, never below fit.\n const maxZoom = Math.max(1, 2 / fit);\n const scale = fit * Math.max(1, Math.min(maxZoom, zoom));\n const width = dw * scale;\n const height = dh * scale;\n const x =\n width <= vw\n ? (vw - width) / 2\n : Math.min(0, Math.max(vw - width, vw / 2 - fx * width));\n const y =\n height <= vh\n ? (vh - height) / 2\n : Math.min(0, Math.max(vh - height, vh / 2 - fy * height));\n return { x, y, width, height, scale, maxZoom };\n };\n /* END TRANSFORM */ const networkStats =\n /* BEGIN NETWORK_STATS */\n function networkStats(stats, previous) {\n const rows = [...stats.values()];\n const video = rows.find(\n (s) =>\n s.type === \"inbound-rtp\" &&\n (s.kind === \"video\" || s.mediaType === \"video\"),\n );\n const transport = rows.find(\n (s) => s.type === \"transport\" && s.selectedCandidatePairId,\n );\n const pair = transport\n ? stats.get(transport.selectedCandidatePairId)\n : rows.find(\n (s) =>\n s.type === \"candidate-pair\" &&\n s.state === \"succeeded\" &&\n s.nominated,\n );\n const local = pair && stats.get(pair.localCandidateId),\n remote = pair && stats.get(pair.remoteCandidateId);\n const direct = [\"host\", \"srflx\", \"prflx\"];\n const route =\n local?.candidateType === \"relay\" || remote?.candidateType === \"relay\"\n ? \"relay\"\n : direct.includes(local?.candidateType) &&\n direct.includes(remote?.candidateType)\n ? \"direct\"\n : \"video\";\n const sample =\n video &&\n Number.isFinite(video.bytesReceived) &&\n Number.isFinite(video.timestamp)\n ? {\n id: video.id,\n path: pair?.id,\n bytes: video.bytesReceived,\n time: video.timestamp,\n }\n : null;\n let bytesPerSecond = null;\n if (\n sample &&\n previous &&\n sample.id === previous.id &&\n sample.path === previous.path &&\n sample.time > previous.time &&\n sample.bytes >= previous.bytes\n )\n bytesPerSecond =\n ((sample.bytes - previous.bytes) * 1000) /\n (sample.time - previous.time);\n const latencyMs =\n Number.isFinite(pair?.currentRoundTripTime) &&\n pair.currentRoundTripTime >= 0\n ? pair.currentRoundTripTime * 1000\n : null;\n return { transport: route, bytesPerSecond, latencyMs, sample };\n };\n\n /* END NETWORK_STATS */ const stage = find(\"stage\"),\n image = find(\"image\"),\n video = find(\"video\"),\n cursor = find(\"cursor\");\n // Shared ambient backdrop. Minimal viewer embeds may omit its subtree.\n const bg = find(\"bg\") || null,\n bgCanvas = find(\"bg-canvas\") || null,\n bgContext = bgCanvas ? bgCanvas.getContext(\"2d\") : null;\n let dw = 1920,\n dh = 1080,\n viewerSized = false,\n zoom = 1,\n desktopScale = null,\n reportedScaleMode = null,\n desktopPan = null,\n edgePointer = null,\n edgeFrame = null,\n edgeTime = 0,\n fx = 0.5,\n fy = 0.5,\n mode = \"pointer\",\n control = false,\n clipboardShortcuts = false,\n clipboardModifier = \"control\",\n deferredClipboardModifier = null,\n pc = null,\n dc = null,\n seq = 0,\n generation = 0,\n epoch = null,\n gestureFrame = null;\n let remoteCursor = null,\n lastLocalMove = 0,\n localCursorAwake = false;\n let touchCursor = null,\n touchCursorTimer = null,\n touchCursorVisible = false;\n const reducedMotion = matchMedia(\"(prefers-reduced-motion: reduce)\");\n const cursorImage = find(\"cursor-image\");\n let pending = [],\n pendingSince = 0,\n sending = false,\n cx = 0.5,\n cy = 0.5,\n drag = false,\n start = null,\n last = null,\n multi = null,\n hold = null,\n moved = false;\n const pointers = new Map();\n const mouseButtons = find(\"mouse-buttons\"),\n wheel = find(\"mouse-wheel\"),\n wheelGrip = find(\"mouse-wheel-grip\");\n let nativeMouseControls = false;\n const mouseControlHandlers = new Map();\n function listenMouse(el, type, handler) {\n listen(el, type, handler);\n mouseControlHandlers.set(el.id + \":\" + type, handler);\n }\n const keyboardInput = find(\"keyboard-input\");\n let keyboardEnabled = false,\n composing = false;\n const keyboardSentinel = \"\\u200b\";\n function resetKeyboard() {\n keyboardInput.value = keyboardSentinel;\n keyboardInput.setSelectionRange(1, 1);\n }\n function showKeyboard(enabled) {\n keyboardEnabled = enabled && control;\n if (!keyboardEnabled) {\n composing = false;\n resetKeyboard();\n keyboardInput.blur();\n return;\n }\n if (composing) return;\n if (config.desktop && document.activeElement === keyboardInput) return;\n // Keep focus inside the native evaluateJavaScript call; WebKit can reject\n // keyboard presentation after requestAnimationFrame loses user activation.\n keyboardInput.blur();\n resetKeyboard();\n keyboardInput.focus({ preventScroll: true });\n }\n function keyboardKey(code) {\n if (!keyboardEnabled || !control) return;\n queue({ kind: \"key\", code, down: true });\n queue({ kind: \"key\", code, down: false });\n flush();\n }\n function commitKeyboard() {\n if (!keyboardEnabled || !control || composing) return;\n const text = keyboardInput.value.replace(keyboardSentinel, \"\");\n if (text) {\n for (let i = 0; i < text.length; i += 4096)\n queue({ kind: \"text\", text: text.slice(i, i + 4096) });\n flush();\n }\n resetKeyboard();\n }\n listen(keyboardInput, \"compositionstart\", () => {\n composing = true;\n });\n listen(keyboardInput, \"compositionend\", () => {\n composing = false;\n commitKeyboard();\n });\n listen(keyboardInput, \"input\", (e) => {\n if (!e.isComposing) commitKeyboard();\n });\n listen(keyboardInput, \"beforeinput\", (e) => {\n if (composing || e.isComposing) return;\n if (e.inputType === \"deleteContentBackward\") {\n e.preventDefault();\n keyboardKey(\"Backspace\");\n resetKeyboard();\n } else if (\n e.inputType === \"insertLineBreak\" ||\n e.inputType === \"insertParagraph\"\n ) {\n e.preventDefault();\n keyboardKey(\"Enter\");\n resetKeyboard();\n }\n });\n const heldMouse = new Map();\n let showMouseButtons = false,\n wheelY = null;\n function resetWheel() {\n wheelY = null;\n wheelGrip.style.transform = \"translateY(0px)\";\n }\n let statsTimer = null,\n statsSample = null;\n const post = (message) => postMessage({ ...message, epoch });\n const clamp = (v) => Math.max(0, Math.min(1, v));\n let fillHeight = false;\n let fitToInsets = false;\n const usesViewportInsets = () => viewerSized || fitToInsets;\n let panAnimation = null,\n viewportRightInset = 0,\n viewportLeftInset = 0,\n viewportBottomInset = 0,\n viewportTopInset = 0,\n keyboardViewportInset = 0,\n portraitKeyboardTopInset = 0;\n let keyboardViewportOpen = false;\n let keyboardFitWidth = null;\n let cursorNeedsEntry = true,\n manualViewMoved = false,\n followRest = null;\n // Insets guide centering and pan limits without clipping the full-screen\n // video surface or adding an opaque strip beside the Dynamic Island.\n const viewportLeft = () => (fillHeight ? viewportLeftInset : 0);\n const usableHeight = () =>\n Math.max(1, stage.clientHeight - viewportTopInset - viewportBottomInset);\n const viewportHeight = () =>\n usesViewportInsets() ? usableHeight() : Math.max(1, stage.clientHeight);\n const viewportWidth = () =>\n Math.max(\n 1,\n stage.clientWidth -\n viewportLeft() -\n (fillHeight ? viewportRightInset : 0),\n );\n // Center between the measured top controls and the keyboard edge (stage bottom).\n // The usable center is (topInset + stageHeight) / 2, so shift by topInset / 2.\n // Keep the fitted size and cap the shift when the desktop is too tall to fit.\n const verticalOffset = (height) =>\n (usesViewportInsets() ? viewportTopInset : 0) +\n (fillHeight\n ? 0\n : Math.min(\n Math.max(\n 0,\n portraitKeyboardTopInset - (usesViewportInsets() ? viewportTopInset : 0),\n ) / 2,\n Math.max(0, (viewportHeight() - height) / 2),\n ));\n const layout = () => {\n const r =\n config.desktop && desktopScale !== null\n ? {\n scale: desktopScale,\n width: dw * desktopScale,\n height: dh * desktopScale,\n maxZoom: 1,\n }\n : transform(\n keyboardFitWidth?.stageWidth === stage.clientWidth\n ? keyboardFitWidth.width : viewportWidth(),\n viewportHeight(),\n dw,\n dh,\n zoom,\n fx,\n fy,\n // Mobile fits both axes; retain Desktop scale semantics.\n config.desktop ? fillHeight && !viewerSized : false,\n );\n return {\n ...r,\n x: viewportLeft() + viewportWidth() / 2 - fx * r.width,\n y: viewportHeight() / 2 + verticalOffset(r.height) - fy * r.height,\n };\n };\n // 0 at fit, 1 at the pinch limit for the current viewport and display.\n const zoomProgress = (r = layout()) =>\n r.maxZoom > 1\n ? Math.max(0, Math.min(1, (zoom - 1) / (r.maxZoom - 1)))\n : 0;\n // The backdrop uses 5% / 90% / 5% source segments. The middle 90%\n // keeps the fitted picture's scale; each outer 5% stretches uniformly\n // to fill the remaining space, horizontally or vertically as needed.\n // Zoom and pan never move the backdrop: where the picture covers it, the\n // opaque picture simply occludes it, so input mapping stays uniform. Returns\n // null when the fitted picture already covers the stage, unless a Desktop\n // viewer has shrunk its foreground below fit and still needs the backdrop.\n const bgEdgeFraction = 0.05;\n const bgCenterFraction = 1 - 2 * bgEdgeFraction;\n function backgroundSegments(vw, vh, dw, dh, fill, includeFitted = false) {\n if (!(vw > 0 && vh > 0 && dw > 0 && dh > 0)) return null;\n const s = fill\n ? vh / Math.max(1, dh)\n : Math.min(vw / dw, vh / Math.max(1, dh));\n const w = dw * s,\n h = dh * s;\n if (w < vw || (includeFitted && w === vw && h === vh)) {\n const centerW = w * bgCenterFraction,\n centerX = vw / 2 - centerW / 2,\n sideW = centerX,\n top = (vh - h) / 2;\n return { axis: \"x\", s, w, h, top, centerW, centerX, sideW };\n }\n if (h < vh) {\n const centerH = h * bgCenterFraction,\n centerY = vh / 2 - centerH / 2,\n sideH = centerY,\n left = (vw - w) / 2;\n return { axis: \"y\", s, w, h, left, centerH, centerY, sideH };\n }\n return null;\n }\n // Native video renders beneath this WebView, so z-order cannot hide the\n // status behind the picture; cut the picture's rectangle out instead.\n // Measure the status only after its text or the stage changes, not per frame.\n let statusOrigin = null;\n function clipNetworkStatus(r = layout()) {\n const status = find(\"network-status\");\n if (!status) return;\n if (!nativeVideoActive || status.style.display === \"none\") {\n status.style.clipPath = \"\";\n return;\n }\n if (!statusOrigin)\n statusOrigin = { x: status.offsetLeft, y: status.offsetTop };\n const left = r.x - statusOrigin.x,\n top = r.y - statusOrigin.y,\n right = left + r.width,\n bottom = top + r.height;\n status.style.clipPath = `polygon(evenodd,0 0,100% 0,100% 100%,0 100%,0 0,${left}px ${top}px,${right}px ${top}px,${right}px ${bottom}px,${left}px ${bottom}px,${left}px ${top}px)`;\n }\n function paintBackground() {\n if (nativeVideoActive) {\n if (bg) bg.style.display = \"none\";\n return;\n }\n if (!bg || !bgCanvas || !bgContext) return;\n const vw = stage.clientWidth,\n vh = stage.clientHeight;\n const picture = config.desktop ? layout() : null;\n const coversStage =\n picture &&\n picture.x <= 0 &&\n picture.y <= 0 &&\n picture.x + picture.width >= vw &&\n picture.y + picture.height >= vh;\n const seg = coversStage\n ? null\n : backgroundSegments(vw, vh, dw, dh, config.desktop ? fillHeight : false, config.desktop);\n if (!seg) {\n bg.style.display = \"none\";\n bgRects = null;\n stopBackgroundLoop();\n return;\n }\n bg.style.display = \"block\";\n bgAxis = seg.axis;\n // The ambient layer also fills the notch and the area beneath native\n // controls. Only the interactive picture respects viewport insets.\n const originX = 0;\n // Source segments are resolved at draw time from the live source dimensions;\n // these dest rects only encode where each segment lands on the stage.\n bgRects =\n seg.axis === \"x\"\n ? [\n {\n x: originX,\n y: seg.top,\n w: seg.sideW,\n h: seg.h,\n },\n {\n x: originX + seg.centerX,\n y: seg.top,\n w: seg.centerW,\n h: seg.h,\n },\n {\n x: originX + seg.centerX + seg.centerW,\n y: seg.top,\n w: seg.sideW,\n h: seg.h,\n },\n ]\n : [\n {\n x: seg.left,\n y: 0,\n w: seg.w,\n h: seg.sideH,\n },\n {\n x: seg.left,\n y: seg.centerY,\n w: seg.w,\n h: seg.centerH,\n },\n {\n x: seg.left,\n y: seg.centerY + seg.centerH,\n w: seg.w,\n h: seg.sideH,\n },\n ];\n // Keep the backing store at stage resolution (capped) so the stretched\n // edges stay crisp without oversized allocations.\n bgDpr = Math.min(2, window.devicePixelRatio || 1);\n const bw = Math.round(stage.clientWidth * bgDpr),\n bh = Math.round(vh * bgDpr);\n if (bgCanvas.width !== bw || bgCanvas.height !== bh) {\n bgCanvas.width = bw;\n bgCanvas.height = bh;\n }\n scheduleBackgroundDraw();\n startBackgroundLoop();\n }\n // One canvas, three draws: each source segment stretches into whatever bar\n // the picture leaves open. The live video feeds it once presented; until\n // then the decoded JPEG frame does, so the backdrop always matches the\n // picture's own pixels and scale in the center segment.\n let bgRects = null,\n bgAxis = \"x\",\n bgDpr = 1,\n bgDrawFrame = null,\n bgLoopFrame = null;\n function drawBackground() {\n if (!bgContext || !bgRects) return;\n const useVideo =\n videoPresented && video.videoWidth > 0 && video.videoHeight > 0;\n const src = useVideo ? video : image;\n // drawImage source rects live in the source's own pixel space, which can\n // differ from dw/dh; fractions of the real bitmap keep every segment lined\n // up with what the picture element actually shows.\n const sw = useVideo ? video.videoWidth : image.naturalWidth;\n const sh = useVideo ? video.videoHeight : image.naturalHeight;\n // Cursor updates can schedule a repaint while the next JPEG is loading.\n // Keep the last backdrop until the replacement has drawable pixels.\n if ((!useVideo && !image.complete) || !(sw > 0 && sh > 0)) return;\n bgContext.setTransform(bgDpr, 0, 0, bgDpr, 0, 0);\n bgContext.clearRect(0, 0, stage.clientWidth, stage.clientHeight);\n const horizontal = bgAxis === \"x\";\n const sourceLength = horizontal ? sw : sh;\n const cuts = [0, bgEdgeFraction, 1 - bgEdgeFraction, 1];\n for (let i = 0; i < bgRects.length; i++) {\n const rect = bgRects[i];\n const origin = cuts[i] * sourceLength;\n const length = (cuts[i + 1] - cuts[i]) * sourceLength;\n bgContext.drawImage(\n src,\n horizontal ? origin : 0,\n horizontal ? 0 : origin,\n horizontal ? length : sw,\n horizontal ? sh : length,\n rect.x,\n rect.y,\n rect.w,\n rect.h,\n );\n }\n }\n function scheduleBackgroundDraw() {\n if (bgDrawFrame !== null || !bgRects || !bgContext) return;\n bgDrawFrame = requestAnimationFrame(() => {\n bgDrawFrame = null;\n drawBackground();\n });\n }\n function startBackgroundLoop() {\n if (\n bgLoopFrame !== null ||\n !bgContext ||\n !bgRects ||\n !videoPresented ||\n typeof video.requestVideoFrameCallback !== \"function\"\n )\n return;\n const frame = video.requestVideoFrameCallback(() => {\n if (bgLoopFrame !== frame) return;\n bgLoopFrame = null;\n drawBackground();\n startBackgroundLoop();\n });\n bgLoopFrame = frame;\n }\n // Only the streaming loop stops here; a pending one-shot draw is harmless\n // (it re-paints the preserved frame) and must survive reconnects.\n function stopBackgroundLoop() {\n if (bgLoopFrame !== null) video.cancelVideoFrameCallback?.(bgLoopFrame);\n bgLoopFrame = null;\n }\n function clearBackground() {\n stopBackgroundLoop();\n bgRects = null;\n // Resizing a canvas resets its bitmap; same-value assignment still clears.\n if (bgCanvas) bgCanvas.width = bgCanvas.width;\n }\n listen(image, \"load\", () => scheduleBackgroundDraw());\n // Older WebViews update the ambient layer on media progress, never with an\n // idle display-refresh loop. Geometry changes still get a one-shot repaint.\n listen(video, \"timeupdate\", () => {\n if (videoPresented && typeof video.requestVideoFrameCallback !== \"function\")\n scheduleBackgroundDraw();\n });\n function panBounds(r) {\n const vw = viewportWidth(),\n vh = viewportHeight();\n // Grow extra resting travel continuously from zero at fit to 180 screen\n // points at maximum zoom. Never count the unused space of a fitting axis.\n const clearance = 180 * zoomProgress(r);\n const axis = (viewport, content) =>\n content <= viewport\n ? {\n min: (viewport - content) / 2 - clearance,\n max: (viewport - content) / 2 + clearance,\n }\n : { min: viewport - content - clearance, max: clearance };\n const x = axis(vw, r.width),\n y = axis(vh, r.height);\n const bounds = {\n minX: viewportLeft() + x.min,\n maxX: viewportLeft() + x.max,\n minY: y.min + verticalOffset(r.height),\n maxY: y.max + verticalOffset(r.height),\n };\n // A camera position required to expose the cursor is a valid resting point,\n // not elastic overshoot. Preserve it across the next pan/pinch handoff.\n if (followRest) {\n const restX = viewportLeft() + vw / 2 - followRest.fx * r.width,\n restY = vh / 2 + verticalOffset(r.height) - followRest.fy * r.height;\n const weight =\n followRest.zoom > 1 ? clamp((zoom - 1) / (followRest.zoom - 1)) : 1;\n bounds.minX += Math.min(0, restX - bounds.minX) * weight;\n bounds.maxX += Math.max(0, restX - bounds.maxX) * weight;\n bounds.minY += Math.min(0, restY - bounds.minY) * weight;\n bounds.maxY += Math.max(0, restY - bounds.maxY) * weight;\n }\n return bounds;\n }\n const bounded = (v, min, max) => Math.max(min, Math.min(max, v));\n // Convert displayed overshoot back to finger travel before the next delta,\n // so reversing direction unwinds smoothly without an edge jump.\n function rubber(v, min, max, inverse = false) {\n const edge = bounded(v, min, max),\n d = v - edge;\n const reach = 40 + 40 * zoomProgress();\n return (\n edge +\n Math.sign(d) *\n (inverse\n ? (reach * Math.abs(d)) / Math.max(1, reach - Math.abs(d))\n : (reach * Math.abs(d)) / (reach + Math.abs(d)))\n );\n }\n function place(x, y, r) {\n fx = (viewportLeft() + viewportWidth() / 2 - x) / r.width;\n fy = (viewportHeight() / 2 + verticalOffset(r.height) - y) / r.height;\n }\n function cursorViewport() {\n const hotX = remoteCursor?.hotX ?? 9,\n hotY = remoteCursor?.hotY ?? 9;\n const w = remoteCursor?.width ?? 18,\n h = remoteCursor?.height ?? 18;\n const left = viewportLeft(),\n right = left + viewportWidth(),\n bottom = Math.max(1, stage.clientHeight - viewportBottomInset);\n // Keep the entire cursor, including its hotspot offset, clear of chrome.\n const minX = Math.min(right - 1, left + 8 + hotX),\n minY = Math.min(\n bottom - 1,\n (usesViewportInsets() ? viewportTopInset : 0) + 8 + hotY,\n );\n return {\n minX,\n maxX: Math.max(minX, right - 8 - (w - hotX)),\n minY,\n maxY: Math.max(minY, bottom - 8 - (h - hotY)),\n };\n }\n function moveTouchpad(dx, dy) {\n stopPanAnimation();\n const r = layout(),\n v = cursorViewport();\n if (cursorNeedsEntry) {\n // Re-enter at the nearest visible edge; do not pull a manually positioned\n // desktop back to the old off-screen cursor before applying this movement.\n cx = clamp((bounded(r.x + cx * r.width, v.minX, v.maxX) - r.x) / r.width);\n cy = clamp(\n (bounded(r.y + cy * r.height, v.minY, v.maxY) - r.y) / r.height,\n );\n cursorNeedsEntry = false;\n }\n cx = clamp(cx + dx / r.width);\n cy = clamp(cy + dy / r.height);\n const x = r.x + cx * r.width,\n y = r.y + cy * r.height;\n if (\n zoom > 1 ||\n r.width > viewportWidth() ||\n r.height > stage.clientHeight - viewportBottomInset\n ) {\n place(\n r.x + bounded(x, v.minX, v.maxX) - x,\n r.y + bounded(y, v.minY, v.maxY) - y,\n r,\n );\n followRest = { fx, fy, zoom };\n }\n manualViewMoved = false;\n }\n function stopPanAnimation() {\n if (panAnimation !== null) cancelAnimationFrame(panAnimation);\n panAnimation = null;\n }\n function settlePan() {\n stopPanAnimation();\n const r = layout(),\n b = panBounds(r),\n x = bounded(r.x, b.minX, b.maxX),\n y = bounded(r.y, b.minY, b.maxY);\n if (x === r.x && y === r.y) return;\n if (reducedMotion.matches) {\n place(x, y, r);\n render();\n return;\n }\n const started = performance.now();\n const tick = (now) => {\n const t = Math.min(1, (now - started) / 280),\n ease = 1 - Math.pow(1 - t, 3);\n place(r.x + (x - r.x) * ease, r.y + (y - r.y) * ease, r);\n render();\n panAnimation = t < 1 ? requestAnimationFrame(tick) : null;\n };\n panAnimation = requestAnimationFrame(tick);\n }\n function render() {\n const r = layout();\n if (config.nativeMedia && epoch)\n post({\n type: \"nativeViewport\",\n fillHeight: false,\n x: r.x,\n y: r.y,\n width: r.width,\n height: r.height,\n });\n if (config.desktop && epoch) {\n const scaleMode =\n desktopScale === null\n ? \"fit\"\n : desktopScale === 1\n ? \"actual\"\n : \"custom\";\n if (reportedScaleMode !== scaleMode) {\n reportedScaleMode = scaleMode;\n post({ type: \"scaleMode\", mode: scaleMode });\n }\n }\n const touchFeedback = control && mode === \"touch\" && touchCursorVisible;\n const cursorX = mode === \"touch\" && touchCursor ? touchCursor.x : cx;\n const cursorY = mode === \"touch\" && touchCursor ? touchCursor.y : cy;\n cursor.style.transition =\n mode === \"touch\" && !touchFeedback && !reducedMotion.matches\n ? \"opacity 120ms ease-out\"\n : \"none\";\n for (const el of [image, video]) {\n el.style.width = r.width + \"px\";\n el.style.height = r.height + \"px\";\n el.style.left = r.x + \"px\";\n el.style.top = r.y + \"px\";\n }\n clipNetworkStatus(r);\n paintBackground();\n if (remoteCursor) {\n cursor.style.width = remoteCursor.width + \"px\";\n cursor.style.height = remoteCursor.height + \"px\";\n cursor.style.border = \"0\";\n cursor.style.borderRadius = \"0\";\n cursor.style.transform = \"none\";\n cursor.style.left = r.x + cursorX * r.width - remoteCursor.hotX + \"px\";\n cursor.style.top = r.y + cursorY * r.height - remoteCursor.hotY + \"px\";\n cursor.style.display = \"block\";\n cursor.style.opacity = (\n mode === \"touch\"\n ? touchFeedback\n : remoteCursor.visible ||\n (control && mode === \"pointer\" && localCursorAwake)\n )\n ? \"1\"\n : \"0\";\n } else {\n cursor.style.opacity = (mode === \"touch\" ? !touchFeedback : false)\n ? \"0\"\n : \"1\";\n cursor.style.width = \"18px\";\n cursor.style.height = \"18px\";\n cursor.style.border = \"2px solid var(--foreground)\";\n cursor.style.borderRadius = \"50%\";\n cursor.style.transform = \"translate(-50%,-50%)\";\n cursor.style.left = r.x + cursorX * r.width + \"px\";\n cursor.style.top = r.y + cursorY * r.height + \"px\";\n cursor.style.display =\n !config.desktop && control && (mode === \"pointer\" || mode === \"touch\")\n ? \"block\"\n : \"none\";\n }\n if (config.desktop) {\n // Let the local OS own pointer size, DPI and accessibility preferences.\n // Never use a remote URL or bitmap as the desktop's native cursor.\n cursor.style.display = \"none\";\n const shape = remoteCursor?.shape;\n stage.style.cursor =\n control &&\n [\n \"default\",\n \"text\",\n \"vertical-text\",\n \"pointer\",\n \"crosshair\",\n \"grab\",\n \"grabbing\",\n \"ew-resize\",\n \"ns-resize\",\n \"nwse-resize\",\n \"nesw-resize\",\n \"move\",\n \"not-allowed\",\n \"copy\",\n \"alias\",\n \"wait\",\n \"progress\",\n \"help\",\n ].includes(shape)\n ? shape\n : \"default\";\n }\n }\n // Literal source is required: Hermes function.toString() yields bytecode.\n function validCursor(v) {\n return (\n !!v &&\n typeof v === \"object\" &&\n typeof v.visible === \"boolean\" &&\n [v.x, v.y, v.width, v.height, v.hotX, v.hotY].every(Number.isFinite) &&\n v.x >= 0 &&\n v.x <= 1 &&\n v.y >= 0 &&\n v.y <= 1 &&\n v.width > 0 &&\n v.width <= 256 &&\n v.height > 0 &&\n v.height <= 256 &&\n v.hotX >= 0 &&\n v.hotX <= v.width &&\n v.hotY >= 0 &&\n v.hotY <= v.height &&\n typeof v.png === \"string\" &&\n v.png.length <= 65536 &&\n /^iVBORw0KGgo[A-Za-z0-9+/]*={0,2}$/.test(v.png)\n );\n }\n function receiveCursor(value) {\n if (value === null) {\n if (remoteCursor) {\n remoteCursor = { ...remoteCursor, visible: false };\n render();\n }\n return;\n }\n if (!validCursor(value)) return;\n if (!remoteCursor || remoteCursor.png !== value.png)\n cursorImage.src = \"data:image/png;base64,\" + value.png;\n // Keep delayed host coordinates from pulling the local touchpad backwards.\n if (\n !remoteCursor ||\n !control ||\n mode !== \"pointer\" ||\n (!pointers.size && performance.now() - lastLocalMove > 200)\n ) {\n cx = value.x;\n cy = value.y;\n }\n if (value.visible) localCursorAwake = false;\n remoteCursor = value;\n render();\n }\n function resetCursor() {\n clearTimeout(touchCursorTimer);\n touchCursorVisible = false;\n touchCursor = null;\n localCursorAwake = false;\n remoteCursor = null;\n cursorImage.removeAttribute(\"src\");\n render();\n }\n function queue(event) {\n if (!control) return;\n if (!pending.length) pendingSince = performance.now();\n if (config.desktop && (event.kind === \"button\" || event.kind === \"scroll\"))\n flushClipboardModifier();\n // Remote visibility can remain hidden after synthetic mouse movement. Wake\n // the local touchpad cursor until the host reports a visible cursor again.\n if (event.kind === \"move\" && mode === \"pointer\") localCursorAwake = true;\n if (event.kind === \"key\" || event.kind === \"text\") {\n localCursorAwake = false;\n render();\n }\n if (event.kind === \"move\" || event.kind === \"button\")\n lastLocalMove = performance.now();\n const tail = pending[pending.length - 1];\n if (event.kind === \"move\" && tail?.kind === \"move\")\n pending[pending.length - 1] = event;\n // Coalesce only adjacent scrolls, preserving button/key ordering. Bound the\n // accumulated distance so a delayed ACK cannot replay a large scroll backlog.\n else if (event.kind === \"scroll\" && tail?.kind === \"scroll\") {\n tail.dx = Math.max(-2000, Math.min(2000, tail.dx + event.dx));\n tail.dy = Math.max(-2000, Math.min(2000, tail.dy + event.dy));\n } else pending.push(event);\n if (pending.length > 64) {\n pending = [{ kind: \"release\" }];\n control = false;\n post({ type: \"inputOverflow\" });\n }\n }\n function flush() {\n if (!pending.length) return;\n // Input is an intent about the picture the user saw, not durable work.\n // Never replay old clicks/typing after a stalled ACK or data channel drains.\n if (performance.now() - pendingSince >= 2000) {\n pending = [];\n control = false;\n release();\n updateMouseButtons();\n post({ type: \"inputOverflow\" });\n return;\n }\n if (sending) return;\n // Do not route around a congested live data channel: the relay could\n // overtake its already-buffered key/button events and reorder input.\n if (pc?.connectionState === \"connected\" && dc?.readyState === \"open\" && dc.bufferedAmount >= 16384) return;\n const events = pending.splice(0, 64),\n sequence = ++seq;\n if (\n pc?.connectionState === \"connected\" &&\n dc &&\n dc.readyState === \"open\" &&\n dc.bufferedAmount < 16384\n ) {\n try {\n dc.send(JSON.stringify({ sequence, events }));\n } catch {\n pending = [];\n control = false;\n release();\n post({ type: \"inputOverflow\" });\n }\n } else {\n sending = true;\n post({ type: \"input\", sequence, events });\n }\n }\n const inputTimer = setInterval(() => {\n // Hold displacement controls speed, even without further pointer moves.\n // Skip missed ticks while awaiting ACK instead of building a scroll backlog.\n if (wheelY?.moved && !sending) {\n const offset = Math.max(-24, Math.min(24, wheelY.y - wheelY.start));\n if (Math.abs(offset) > 4)\n scrollMouse(Math.sign(offset) * (Math.abs(offset) - 4) * 1.5);\n }\n flush();\n }, 33);\n cleanups.push(() => clearInterval(inputTimer));\n function release() {\n stopEdgePan();\n desktopPan = null;\n deferredClipboardModifier = null;\n clearTimeout(hold);\n if (gestureFrame !== null) cancelAnimationFrame(gestureFrame);\n gestureFrame = null;\n if (control) {\n queue({ kind: \"release\" });\n flush();\n }\n heldMouse.clear();\n resetWheel();\n updateMouseButtons();\n drag = false;\n pointers.clear();\n start = null;\n last = null;\n multi = null;\n }\n function updateMouseButtons() {\n mouseButtons.style.display =\n showMouseButtons && control && !nativeMouseControls ? \"block\" : \"none\";\n for (const [name, button] of [\n [\"left\", 0],\n [\"right\", 2],\n ])\n find(\"mouse-\" + name).setAttribute(\n \"aria-pressed\",\n String(heldMouse.has(button)),\n );\n }\n for (const [name, button] of [\n [\"left\", 0],\n [\"right\", 2],\n ]) {\n const el = find(\"mouse-\" + name);\n listenMouse(el, \"pointerdown\", (e) => {\n e.preventDefault();\n if (!control || !showMouseButtons || heldMouse.has(button)) return;\n clearTimeout(hold);\n if (!e.nativeInput) el.setPointerCapture(e.pointerId);\n heldMouse.set(button, e.pointerId);\n queue({ kind: \"button\", button, down: true, x: cx, y: cy });\n flush();\n updateMouseButtons();\n });\n const up = (e) => {\n e.preventDefault();\n if (heldMouse.get(button) !== e.pointerId) return;\n heldMouse.delete(button);\n queue({ kind: \"button\", button, down: false, x: cx, y: cy });\n flush();\n updateMouseButtons();\n };\n listenMouse(el, \"pointerup\", up);\n listenMouse(el, \"pointercancel\", up);\n listenMouse(el, \"lostpointercapture\", up);\n listenMouse(el, \"click\", (e) => {\n if (e.detail === 0 && control && showMouseButtons) {\n click(button);\n flush();\n }\n });\n }\n const scrollMouse = (dy) => {\n if (control && showMouseButtons && Number.isFinite(dy)) {\n queue({ kind: \"scroll\", dx: 0, dy: Math.max(-2000, Math.min(2000, dy)) });\n }\n };\n listenMouse(wheel, \"pointerdown\", (e) => {\n e.preventDefault();\n if (!control || !showMouseButtons || wheelY) return;\n if (!e.nativeInput) wheel.setPointerCapture(e.pointerId);\n wheelY = { id: e.pointerId, y: e.clientY, start: e.clientY, moved: false };\n });\n // A small dead zone preserves middle clicks; displacement drives the timer.\n listenMouse(wheel, \"pointermove\", (e) => {\n if (!wheelY || wheelY.id !== e.pointerId) return;\n e.preventDefault();\n wheelGrip.style.transform =\n \"translateY(\" +\n Math.max(-24, Math.min(24, e.clientY - wheelY.start)) +\n \"px)\";\n wheelY.y = e.clientY;\n if (Math.abs(e.clientY - wheelY.start) > 4) wheelY.moved = true;\n });\n listenMouse(wheel, \"pointerup\", (e) => {\n if (!wheelY || wheelY.id !== e.pointerId) return;\n e.preventDefault();\n if (!wheelY.moved && control && showMouseButtons) {\n click(1);\n flush();\n }\n resetWheel();\n });\n const cancelWheel = (e) => {\n if (wheelY?.id === e.pointerId) resetWheel();\n };\n listenMouse(wheel, \"pointercancel\", cancelWheel);\n listenMouse(wheel, \"lostpointercapture\", cancelWheel);\n listenMouse(wheel, \"click\", (e) => {\n if (e.detail === 0 && control && showMouseButtons) {\n click(1);\n flush();\n }\n });\n listenMouse(wheel, \"keydown\", (e) => {\n if (e.key === \"ArrowUp\" || e.key === \"ArrowDown\") {\n e.preventDefault();\n scrollMouse(e.key === \"ArrowUp\" ? -120 : 120);\n }\n });\n function insideDesktop(p) {\n const r = layout();\n return (\n p.x >= r.x && p.x <= r.x + r.width && p.y >= r.y && p.y <= r.y + r.height\n );\n }\n function point(p) {\n const r = layout();\n return {\n x: clamp((p.x - r.x) / r.width),\n y: clamp((p.y - r.y) / r.height),\n };\n }\n const desktopPoint = (e) => {\n const bounds = stage.getBoundingClientRect();\n return { x: e.clientX - bounds.left, y: e.clientY - bounds.top };\n };\n function stopEdgePan() {\n if (edgeFrame !== null) cancelAnimationFrame(edgeFrame);\n edgeFrame = null;\n edgePointer = null;\n }\n function edgePanTick(now) {\n edgeFrame = null;\n if (!edgePointer || desktopPan || !epoch) return;\n const r = layout(),\n vw = viewportWidth(),\n vh = viewportHeight();\n const p = edgePointer;\n const dt = Math.min(32, Math.max(0, now - edgeTime)) / 1000;\n edgeTime = now;\n // rAF timestamps describe the frame start and can precede the pointer\n // handler's performance.now(). A zero-time first frame is not a boundary.\n if (dt === 0) {\n edgeFrame = requestAnimationFrame(edgePanTick);\n return;\n }\n // A narrow edge band accelerates smoothly to 720 local pixels per second.\n const velocity = (position, extent) => {\n const band = Math.min(28, extent / 4);\n return position < band\n ? -(1 - position / band)\n : position > extent - band\n ? (position - extent + band) / band\n : 0;\n };\n const x =\n r.width > vw\n ? bounded(\n r.x - velocity(p.x - viewportLeft(), vw) * 720 * dt,\n viewportLeft() + vw - r.width,\n viewportLeft(),\n )\n : r.x;\n const y =\n r.height > vh\n ? bounded(r.y - velocity(p.y, vh) * 720 * dt, vh - r.height, 0)\n : r.y;\n if (Math.abs(x - r.x) < 0.001 && Math.abs(y - r.y) < 0.001) return;\n stopPanAnimation();\n manualViewMoved = true;\n place(x, y, r);\n // Keep remote hover/drag attached to the local pointer as the picture moves.\n if (control) {\n const next = point(p);\n cx = next.x;\n cy = next.y;\n queue({ kind: \"move\", x: cx, y: cy });\n }\n render();\n edgeFrame = requestAnimationFrame(edgePanTick);\n }\n function trackEdgePointer(e) {\n const p = desktopPoint(e);\n if (\n !epoch ||\n desktopPan ||\n p.x < viewportLeft() ||\n p.x > viewportLeft() + viewportWidth() ||\n p.y < 0 ||\n p.y > viewportHeight() ||\n !insideDesktop(p)\n ) {\n stopEdgePan();\n return;\n }\n edgePointer = p;\n if (edgeFrame === null) {\n edgeTime = performance.now();\n edgeFrame = requestAnimationFrame(edgePanTick);\n }\n }\n listen(stage, \"pointerleave\", stopEdgePan);\n function mouse(e, down) {\n if (!control || ![0, 1, 2].includes(e.button)) return;\n const local = desktopPoint(e);\n if (down && !insideDesktop(local)) return;\n const p = point(local);\n cx = p.x;\n cy = p.y;\n if (down) {\n showKeyboard(true);\n stage.setPointerCapture(e.pointerId);\n heldMouse.set(e.button, e.pointerId);\n } else if (!heldMouse.delete(e.button)) return;\n queue({ kind: \"button\", button: e.button, down, x: cx, y: cy });\n flush();\n render();\n }\n function click(button = 0) {\n if (control && mode === \"touch\") {\n clearTimeout(touchCursorTimer);\n touchCursor = { x: cx, y: cy };\n touchCursorVisible = true;\n render();\n touchCursorTimer = setTimeout(() => {\n touchCursorVisible = false;\n render();\n }, 450);\n }\n queue({ kind: \"button\", button, down: true, x: cx, y: cy });\n queue({ kind: \"button\", button, down: false, x: cx, y: cy });\n }\n function pan(dx, dy) {\n manualViewMoved = true;\n cursorNeedsEntry = true;\n stopPanAnimation();\n const r = layout(),\n b = panBounds(r);\n place(\n rubber(rubber(r.x, b.minX, b.maxX, true) + dx, b.minX, b.maxX),\n rubber(rubber(r.y, b.minY, b.maxY, true) + dy, b.minY, b.maxY),\n r,\n );\n render();\n }\n function pair() {\n const [a, b] = [...pointers.values()];\n return {\n x: (a.x + b.x) / 2,\n y: (a.y + b.y) / 2,\n d: Math.hypot(a.x - b.x, a.y - b.y),\n };\n }\n function movePair() {\n gestureFrame = null;\n if (pointers.size < 2 || !multi) return;\n const next = pair(),\n span = Math.abs(next.d - multi.d),\n travel = Math.hypot(next.x - multi.x, next.y - multi.y);\n if (multi.kind !== \"pinch\") {\n const pinchSlop = Math.max(6, Math.min(12, multi.d * 0.04));\n if (span >= pinchSlop && span > travel * 0.65) {\n // A parallel scroll may deliver its two pointer updates in different\n // frames. Confirm separation briefly before taking over as a pinch.\n if (!multi.candidate)\n multi.candidate = {\n at: Date.now(),\n d: next.d,\n zoom,\n anchor: point(next),\n };\n if (Date.now() - multi.candidate.at >= 40) {\n if (multi.kind === \"scroll\") {\n multi.d = multi.candidate.d;\n multi.zoom = multi.candidate.zoom;\n multi.anchor = multi.candidate.anchor;\n }\n multi.kind = \"pinch\";\n multi.candidate = null;\n } else {\n gestureFrame = requestAnimationFrame(movePair);\n return;\n }\n } else {\n multi.candidate = null;\n if (!multi.kind && travel > 8 && travel > span) {\n multi.kind = \"scroll\";\n multi.restX = 0;\n multi.restY = 0;\n multi.aimed = mode !== \"touch\";\n }\n }\n }\n if (multi.kind === \"pinch\") {\n manualViewMoved = true;\n cursorNeedsEntry = true;\n const { maxZoom } = layout();\n zoom = Math.max(\n 1,\n Math.min(\n maxZoom,\n (Math.min(maxZoom, multi.zoom) * next.d) / Math.max(1, multi.d),\n ),\n );\n const r = layout();\n fx =\n multi.anchor.x +\n (viewportLeft() + viewportWidth() / 2 - next.x) / r.width;\n fy =\n multi.anchor.y +\n (viewportHeight() / 2 + verticalOffset(r.height) - next.y) / r.height;\n const moved = layout(),\n b = panBounds(moved);\n place(\n rubber(moved.x, b.minX, b.maxX),\n rubber(moved.y, b.minY, b.maxY),\n moved,\n );\n } else if (multi.kind === \"scroll\") {\n const dx = next.x - multi.lastX,\n dy = next.y - multi.lastY;\n if (control && mode !== \"pan\") {\n // Hosts scroll whatever is under the desktop cursor. Touch mode has no\n // visible pointer, so aim it at the fingers once they are over the\n // desktop; like taps, scrolling over the letterbox does nothing.\n if (!multi.aimed && insideDesktop(next)) {\n const p = point(next);\n cx = p.x;\n cy = p.y;\n queue({ kind: \"move\", x: cx, y: cy });\n multi.aimed = true;\n }\n // Hosts inject whole pixels; carry fractions so slow drags still scroll.\n const sx = multi.restX - dx,\n sy = multi.restY - dy,\n wx = Math.trunc(sx),\n wy = Math.trunc(sy);\n multi.restX = sx - wx;\n multi.restY = sy - wy;\n if (multi.aimed && (wx || wy))\n queue({\n kind: \"scroll\",\n dx: Math.max(-2000, Math.min(2000, wx)),\n dy: Math.max(-2000, Math.min(2000, wy)),\n });\n } else pan(dx, dy);\n }\n if (multi.kind) {\n multi.lastX = next.x;\n multi.lastY = next.y;\n }\n render();\n }\n listen(stage, \"pointerdown\", (e) => {\n if (config.desktop) {\n e.preventDefault();\n if (\n e.button === 1 &&\n (layout().width > viewportWidth() || layout().height > viewportHeight())\n ) {\n stopEdgePan();\n stopPanAnimation();\n desktopPan = {\n id: e.pointerId,\n x: e.clientX,\n y: e.clientY,\n start: e,\n moved: false,\n };\n stage.setPointerCapture(e.pointerId);\n return;\n }\n mouse(e, true);\n return;\n }\n e.preventDefault();\n stopPanAnimation();\n stage.setPointerCapture(e.pointerId);\n pointers.set(e.pointerId, { x: e.clientX, y: e.clientY });\n if (pointers.size === 1) {\n cursorNeedsEntry = true;\n start = { x: e.clientX, y: e.clientY };\n last = start;\n moved = false;\n hold = setTimeout(() => {\n if (\n control &&\n mode !== \"pan\" &&\n !moved &&\n pointers.size === 1 &&\n !heldMouse.size &&\n (mode !== \"touch\" || insideDesktop(start))\n ) {\n if (mode === \"touch\") {\n const p = point(start);\n cx = p.x;\n cy = p.y;\n }\n queue({ kind: \"button\", button: 0, down: true, x: cx, y: cy });\n drag = true;\n }\n }, 400);\n } else {\n clearTimeout(hold);\n if (drag) queue({ kind: \"release\" });\n drag = false;\n start = null;\n const p = pair();\n multi = {\n ...p,\n lastX: p.x,\n lastY: p.y,\n zoom,\n anchor: point(p),\n kind: null,\n };\n }\n });\n listen(stage, \"pointermove\", (e) => {\n if (config.desktop) {\n if (desktopPan?.id === e.pointerId) {\n const dx = e.clientX - desktopPan.x,\n dy = e.clientY - desktopPan.y;\n if (!desktopPan.moved && Math.hypot(dx, dy) < 3) return;\n desktopPan.moved = true;\n desktopPan.x = e.clientX;\n desktopPan.y = e.clientY;\n pan(dx, dy);\n return;\n }\n trackEdgePointer(e);\n if (!control) return;\n const local = desktopPoint(e);\n if (!heldMouse.size && !insideDesktop(local)) return;\n const p = point(local);\n cx = p.x;\n cy = p.y;\n queue({ kind: \"move\", x: cx, y: cy });\n render();\n return;\n }\n if (!pointers.has(e.pointerId)) return;\n e.preventDefault();\n pointers.set(e.pointerId, { x: e.clientX, y: e.clientY });\n if (pointers.size >= 2) {\n if (gestureFrame === null) gestureFrame = requestAnimationFrame(movePair);\n return;\n }\n if (!start || !last) return;\n const now = { x: e.clientX, y: e.clientY },\n dx = now.x - last.x,\n dy = now.y - last.y;\n last = now;\n if (Math.hypot(now.x - start.x, now.y - start.y) > 6) {\n moved = true;\n clearTimeout(hold);\n }\n if (\n !control ||\n mode === \"pan\" ||\n (mode === \"touch\" && !drag && !heldMouse.size)\n ) {\n pan(dx, dy);\n return;\n }\n if (mode === \"pointer\") {\n moveTouchpad(dx, dy);\n } else {\n const p = point(now);\n cx = p.x;\n cy = p.y;\n }\n queue({ kind: \"move\", x: cx, y: cy });\n render();\n });\n function up(e) {\n if (config.desktop) {\n if (desktopPan?.id === e.pointerId) {\n const gesture = desktopPan;\n desktopPan = null;\n if (gesture.moved) settlePan();\n else {\n mouse(gesture.start, true);\n mouse(e, false);\n }\n return;\n }\n mouse(e, false);\n return;\n }\n if (!pointers.has(e.pointerId)) return;\n clearTimeout(hold);\n if (pointers.size >= 2 && multi) {\n pointers.set(e.pointerId, { x: e.clientX, y: e.clientY });\n if (gestureFrame !== null) cancelAnimationFrame(gestureFrame);\n movePair();\n if (gestureFrame !== null) cancelAnimationFrame(gestureFrame);\n gestureFrame = null;\n }\n pointers.delete(e.pointerId);\n if (drag) {\n queue({ kind: \"button\", button: 0, down: false, x: cx, y: cy });\n drag = false;\n } else if (\n start &&\n !moved &&\n control &&\n mode !== \"pan\" &&\n !heldMouse.size &&\n e.type === \"pointerup\" &&\n (mode !== \"touch\" || insideDesktop({ x: e.clientX, y: e.clientY }))\n ) {\n if (mode === \"touch\") {\n const p = point({ x: e.clientX, y: e.clientY });\n cx = p.x;\n cy = p.y;\n }\n click();\n }\n start = null;\n last = null;\n multi = null;\n render();\n if (!pointers.size && manualViewMoved) settlePan();\n }\n listen(stage, \"pointerup\", up);\n listen(stage, \"pointercancel\", () => {\n release();\n settlePan();\n });\n listen(stage, \"lostpointercapture\", () => {\n desktopPan = null;\n if (config.desktop && heldMouse.size) release();\n });\n let wheelRestX = 0,\n wheelRestY = 0;\n if (config.desktop)\n listen(\n stage,\n \"wheel\",\n (e) => {\n e.preventDefault();\n if (!control) {\n wheelRestX = wheelRestY = 0;\n return;\n }\n const factor =\n e.deltaMode === 1 ? 16 : e.deltaMode === 2 ? stage.clientHeight : 1;\n // Hosts inject whole pixels; carry fractions so slow trackpad and\n // scaled-display deltas still scroll.\n const sx = wheelRestX + e.deltaX * factor,\n sy = wheelRestY + e.deltaY * factor,\n wx = Math.trunc(sx) || 0,\n wy = Math.trunc(sy) || 0;\n wheelRestX = sx - wx;\n wheelRestY = sy - wy;\n if (!wx && !wy) return;\n queue({\n kind: \"scroll\",\n dx: Math.max(-2000, Math.min(2000, wx)),\n dy: Math.max(-2000, Math.min(2000, wy)),\n });\n flush();\n },\n { passive: false },\n );\n listen(config.desktop ? stage : document, \"contextmenu\", (e) =>\n e.preventDefault(),\n );\n // Scope selection suppression to the desktop surface, preserving the hidden\n // textarea's native keyboard/IME editing and programmatic selection.\n listen(stage, \"selectstart\", (e) => e.preventDefault());\n listen(stage, \"dragstart\", (e) => e.preventDefault());\n const normalizedKey = (code) =>\n /^(Shift|Control|Alt|Meta)Right$/.test(code)\n ? code.replace(/Right$/, \"Left\")\n : code;\n const hardwareKeys = new Set();\n function flushClipboardModifier() {\n if (!deferredClipboardModifier) return;\n const code = deferredClipboardModifier;\n deferredClipboardModifier = null;\n hardwareKeys.add(code);\n queue({ kind: \"key\", code, down: true });\n }\n listen(document, \"keydown\", (e) => {\n if (config.desktop) {\n if (e.ctrlKey && e.altKey && e.code === \"Escape\") {\n e.preventDefault();\n release();\n showKeyboard(false);\n post({ type: \"releaseFocus\" });\n return;\n }\n if (\n document.activeElement !== keyboardInput ||\n e.isComposing ||\n composing\n )\n return;\n if (\n control &&\n clipboardShortcuts &&\n normalizedKey(e.code) ===\n (clipboardModifier === \"meta\" ? \"MetaLeft\" : \"ControlLeft\")\n ) {\n e.preventDefault();\n if (!hardwareKeys.has(normalizedKey(e.code)))\n deferredClipboardModifier = normalizedKey(e.code);\n return;\n }\n if (\n control &&\n clipboardShortcuts &&\n (clipboardModifier === \"meta\"\n ? e.metaKey && !e.ctrlKey\n : e.ctrlKey && !e.metaKey) &&\n !e.altKey &&\n !e.shiftKey &&\n (e.code === \"KeyC\" || e.code === \"KeyV\")\n ) {\n e.preventDefault();\n if (!e.repeat) {\n release();\n hardwareKeys.clear();\n post({\n type: \"clipboard\",\n action: e.code === \"KeyC\" ? \"copy\" : \"paste\",\n });\n }\n return;\n }\n }\n // The focused textarea delivers characters through input (and editing\n // keys through beforeinput). Forwarding their keydown too types twice on\n // iOS, where the software keyboard reports both events.\n if (\n (config.desktop || keyboardEnabled) &&\n document.activeElement === keyboardInput &&\n !e.ctrlKey &&\n !e.metaKey &&\n !e.altKey &&\n (e.key?.length === 1 ||\n e.key === \"Process\" ||\n e.key === \"Dead\" ||\n (keyboardEnabled && [\"Backspace\", \"Enter\"].includes(e.code)))\n )\n return;\n if (control && validKeys.has(normalizedKey(e.code))) {\n e.preventDefault();\n flushClipboardModifier();\n hardwareKeys.add(normalizedKey(e.code));\n queue({ kind: \"key\", code: normalizedKey(e.code), down: true });\n }\n });\n listen(document, \"keyup\", (e) => {\n const code = normalizedKey(e.code);\n if (config.desktop && control && deferredClipboardModifier === code) {\n flushClipboardModifier();\n }\n if (!hardwareKeys.delete(code)) return;\n if (control && validKeys.has(code)) {\n e.preventDefault();\n queue({ kind: \"key\", code, down: false });\n }\n });\n if (config.desktop)\n listen(keyboardInput, \"blur\", () => {\n hardwareKeys.clear();\n release();\n });\n listen(window, \"blur\", () => {\n release();\n settlePan();\n });\n function reportViewport() {\n post({\n type: \"viewportChanged\",\n width: viewportWidth(),\n height: usableHeight(),\n });\n }\n const observer = new ResizeObserver(() => {\n statusOrigin = null;\n reportViewport();\n release();\n settlePan();\n render();\n });\n observer.observe(stage);\n cleanups.push(\n () => observer.disconnect(),\n () => stopPanAnimation(),\n () => stopBackgroundLoop(),\n () => clearTimeout(touchCursorTimer),\n );\n // Keep one bounded frame in this document only; never persist desktop pixels.\n // Snapshot before detaching the track. A JPEG fallback already lives in image.\n function retainFrame() {\n if (\n !videoPresented ||\n video.style.display !== \"block\" ||\n video.readyState < 2 ||\n !video.videoWidth ||\n !video.videoHeight\n )\n return;\n const canvas = document.createElement(\"canvas\");\n try {\n const scale = Math.min(\n 1,\n 1280 / Math.max(video.videoWidth, video.videoHeight),\n );\n canvas.width = Math.max(1, Math.round(video.videoWidth * scale));\n canvas.height = Math.max(1, Math.round(video.videoHeight * scale));\n const context = canvas.getContext(\"2d\");\n if (context) {\n context.drawImage(video, 0, 0, canvas.width, canvas.height);\n image.src = canvas.toDataURL(\"image/jpeg\", 0.7);\n }\n } catch {\n /* Keep the previous compatibility frame if WebKit cannot read video. */\n } finally {\n canvas.width = 0;\n canvas.height = 0;\n }\n }\n /* BEGIN RTC */\n\n let trickleIce = false,\n attemptId = null,\n retries = 0,\n exchangeId = 0;\n let configPending = false;\n let videoPresented = false,\n videoFrameCallback = null,\n videoPaintCallback = null;\n function cancelVideoHandoff() {\n if (videoFrameCallback !== null)\n video.cancelVideoFrameCallback?.(videoFrameCallback);\n if (videoPaintCallback !== null) cancelAnimationFrame(videoPaintCallback);\n videoFrameCallback = videoPaintCallback = null;\n }\n function revealVideo(g) {\n post({ type: \"videoFrameReady\", attemptId });\n // Keep the JPEG decoded and painted as a backing layer. Promote the video\n // only after its first frame; removing the image exposes WebKit repaint gaps.\n videoPaintCallback = requestAnimationFrame(() => {\n if (g !== generation) return;\n videoPaintCallback = requestAnimationFrame(() => {\n if (g !== generation) return;\n videoPaintCallback = null;\n videoPresented = true;\n video.style.zIndex = \"2\";\n if (typeof startBackgroundLoop === \"function\") startBackgroundLoop();\n post({ type: \"streaming\", attemptId });\n post({\n type: \"pipCapability\",\n supported: !!(\n video.webkitSupportsPresentationMode?.(\"picture-in-picture\") ||\n document.pictureInPictureEnabled\n ),\n });\n });\n });\n }\n function waitForVideoFrame(g) {\n if (g !== generation) return;\n if (\n video.readyState >= 2 &&\n video.videoWidth > 0 &&\n video.videoHeight > 0\n ) {\n revealVideo(g);\n return;\n }\n videoPaintCallback = requestAnimationFrame(() => waitForVideoFrame(g));\n }\n let retryTimer = null,\n deadlineTimer = null,\n disconnectTimer = null,\n stableTimer = null,\n iceTimer = null,\n gatherTimer = null,\n gatherDone = null;\n let localCandidates = [],\n localAck = 0,\n remoteAfter = 0,\n icePending = null,\n remoteSeen = new Set(),\n exchangeUntil = 0,\n remoteComplete = false;\n function clearRtcTimers() {\n for (const timer of [\n retryTimer,\n deadlineTimer,\n disconnectTimer,\n stableTimer,\n iceTimer,\n gatherTimer,\n ])\n clearTimeout(timer);\n retryTimer =\n deadlineTimer =\n disconnectTimer =\n stableTimer =\n iceTimer =\n gatherTimer =\n null;\n if (gatherDone) {\n gatherDone();\n gatherDone = null;\n }\n }\n function closeRtc(preserveFrame = true) {\n configPending = false;\n if (preserveFrame) retainFrame();\n generation++;\n clearRtcTimers();\n cancelVideoHandoff();\n videoPresented = false;\n localCandidates = [];\n localAck = remoteAfter = 0;\n icePending = null;\n remoteSeen = new Set();\n attemptId = null;\n clearInterval(statsTimer);\n statsTimer = null;\n statsSample = null;\n if (dc) dc.close();\n if (pc) pc.close();\n pc = null;\n dc = null;\n video.onplaying = null;\n video.srcObject = null;\n video.style.display = \"none\";\n video.style.zIndex = \"0\";\n image.style.display = \"block\";\n if (typeof stopBackgroundLoop === \"function\") stopBackgroundLoop();\n if (!preserveFrame) {\n image.removeAttribute(\"src\");\n if (typeof clearBackground === \"function\") clearBackground();\n }\n }\n function failRtc(reason, canRetry = true) {\n const failedAttempt = attemptId;\n release();\n closeRtc();\n post({ type: \"fallback\", attemptId: failedAttempt, reason });\n // Local consent is bounded by the host's picker lifetime. Reuse this retry\n // timer without consuming the finite network-recovery attempts.\n const capturePending = reason === \"capture-pending\";\n if (canRetry && epoch && (capturePending || retries < net.retryMs.length)) {\n const delay = capturePending\n ? net.retryMs[net.retryMs.length - 1]\n : net.retryMs[retries++];\n retryTimer = setTimeout(() => {\n retryTimer = null;\n if (epoch) connect();\n }, delay);\n }\n }\n function pollIce() {\n if (\n !pc ||\n !trickleIce ||\n !pc.remoteDescription ||\n icePending ||\n Date.now() >= exchangeUntil\n )\n return;\n const candidates = localCandidates.slice(\n localAck,\n localAck + net.batchSize,\n );\n icePending = {\n after: remoteAfter,\n sent: candidates.length,\n exchangeId: ++exchangeId,\n };\n post({\n type: \"ice\",\n attemptId,\n candidates,\n after: remoteAfter,\n exchangeId,\n });\n iceTimer = setTimeout(() => {\n icePending = null;\n pollIce();\n }, 4500);\n }\n async function receiveIce(message) {\n if (\n !pc ||\n !icePending ||\n message.attemptId !== attemptId ||\n message.exchangeId !== icePending.exchangeId\n )\n return;\n const rtc = pc,\n g = generation,\n batch = icePending;\n clearTimeout(iceTimer);\n try {\n if (message.error) {\n icePending = null;\n iceTimer = setTimeout(pollIce, 1000);\n return;\n }\n if (\n !Array.isArray(message.candidates) ||\n message.candidates.length > net.batchSize ||\n message.next !== batch.after + message.candidates.length ||\n message.next > net.maxCandidates\n )\n throw new Error();\n for (const candidate of message.candidates) {\n if (g !== generation) return;\n const key = JSON.stringify(candidate);\n if (remoteSeen.has(key)) continue;\n if (remoteSeen.size >= net.maxCandidates) throw new Error();\n await rtc.addIceCandidate(candidate);\n if (g !== generation) return;\n remoteSeen.add(key);\n }\n if (g !== generation) return;\n localAck += batch.sent;\n remoteAfter = message.next;\n remoteComplete = message.complete === true;\n icePending = null;\n if (!(\n remoteComplete &&\n rtc.iceGatheringState === \"complete\" &&\n localAck === localCandidates.length\n ))\n iceTimer = setTimeout(pollIce, net.pollMs);\n } catch {\n if (g === generation) failRtc(\"candidates\");\n }\n }\n async function receiveAnswer(message) {\n if (!pc || message.attemptId !== attemptId) return;\n const rtc = pc,\n g = generation;\n try {\n await rtc.setRemoteDescription({ type: \"answer\", sdp: message.sdp });\n if (g !== generation) return;\n clearTimeout(deadlineTimer);\n deadlineTimer = setTimeout(() => {\n if (g === generation && rtc.connectionState !== \"connected\")\n failRtc(\"connect-timeout\");\n }, net.connectMs);\n exchangeUntil = Date.now() + net.exchangeMs;\n pollIce();\n } catch {\n if (g === generation) failRtc(\"answer\");\n }\n }\n async function connect() {\n closeRtc();\n const g = generation;\n attemptId = String(g);\n if (!window.RTCPeerConnection) {\n failRtc(\"unsupported\", false);\n return;\n }\n configPending = true;\n deadlineTimer = setTimeout(\n () => {\n if (g === generation && configPending) {\n configPending = false;\n void startRtc(g, iceServers);\n }\n },\n (net.iceConfigMs ?? 8000) + (net.iceConfigBridgeMs ?? 500),\n );\n return post({ type: \"iceConfig\", attemptId });\n }\n async function receiveIceConfig(message) {\n if (!epoch || !configPending || message.attemptId !== attemptId) return;\n configPending = false;\n clearTimeout(deadlineTimer);\n deadlineTimer = null;\n await startRtc(generation, message.iceServers);\n }\n async function startRtc(g, servers) {\n try {\n const rtc = new RTCPeerConnection({ iceServers: servers });\n pc = rtc;\n dc = rtc.createDataChannel(\"input-v1\");\n rtc.addTransceiver(\"video\", { direction: \"recvonly\" });\n rtc.addTransceiver(\"audio\", { direction: \"recvonly\" });\n rtc.onicecandidate = ({ candidate }) => {\n if (g !== generation || !candidate?.candidate || !trickleIce) return;\n if (localCandidates.length >= net.maxCandidates) {\n failRtc(\"candidate-limit\", false);\n return;\n }\n localCandidates.push({\n candidate: candidate.candidate,\n sdpMid: candidate.sdpMid,\n sdpMLineIndex: candidate.sdpMLineIndex,\n ...(candidate.usernameFragment\n ? { usernameFragment: candidate.usernameFragment }\n : {}),\n });\n // Gathering continues after the offer; the serial exchange flushes late addresses.\n };\n dc.onmessage = (e) => {\n try {\n if (g !== generation || pc !== rtc) return;\n if (typeof e.data !== \"string\" || e.data.length > 80000) return;\n const message = JSON.parse(e.data);\n if (message.type === \"cursor\") receiveCursor(message.cursor);\n if (\n message.type === \"reply\" &&\n typeof message.id === \"string\" &&\n message.id.length <= 64\n )\n post({\n type: \"channelReply\",\n id: message.id,\n ok: message.ok === true,\n result: message.result,\n error: typeof message.error === \"string\" ? message.error : null,\n });\n if (\n (video.webkitPresentationMode === \"picture-in-picture\" ||\n document.pictureInPictureElement === video) &&\n message.type === \"viewPing\" &&\n typeof message.challenge === \"string\" &&\n message.challenge.length <= 64 &&\n dc?.readyState === \"open\"\n )\n dc.send(message.challenge);\n } catch {}\n };\n let readingStats = false;\n statsTimer = setInterval(async () => {\n if (readingStats || g !== generation) return;\n readingStats = true;\n try {\n const stats = await rtc.getStats();\n if (g !== generation || pc !== rtc) return;\n const result = networkStats(stats, statsSample);\n statsSample = result.sample;\n post({\n type: \"network\",\n transport: result.transport,\n bytesPerSecond: result.bytesPerSecond,\n latencyMs: result.latencyMs,\n });\n } catch {\n } finally {\n readingStats = false;\n }\n }, 1000);\n rtc.ontrack = (e) => {\n if (g !== generation) return;\n video.srcObject = e.streams[0] || new MediaStream([e.track]);\n video.play().catch(() => {});\n };\n video.onplaying = () => {\n if (\n g !== generation ||\n videoPresented ||\n videoFrameCallback !== null ||\n videoPaintCallback !== null\n )\n return;\n video.style.display = \"block\";\n render();\n if (typeof scheduleBackgroundDraw === \"function\")\n scheduleBackgroundDraw();\n if (typeof video.requestVideoFrameCallback === \"function\") {\n videoFrameCallback = video.requestVideoFrameCallback(() => {\n if (g !== generation) return;\n videoFrameCallback = null;\n revealVideo(g);\n });\n } else waitForVideoFrame(g);\n };\n rtc.onconnectionstatechange = () => {\n if (g !== generation) return;\n if ([\"failed\", \"closed\"].includes(rtc.connectionState)) {\n failRtc(\"transport\");\n return;\n }\n if (rtc.connectionState === \"disconnected\") {\n clearTimeout(stableTimer);\n stableTimer = null;\n if (!disconnectTimer) {\n release();\n post({ type: \"reconnecting\", attemptId });\n disconnectTimer = setTimeout(() => {\n if (g === generation) failRtc(\"disconnected\");\n }, net.disconnectedMs);\n }\n } else if (rtc.connectionState === \"connected\") {\n clearTimeout(disconnectTimer);\n disconnectTimer = null;\n clearTimeout(deadlineTimer);\n if (!stableTimer)\n stableTimer = setTimeout(() => {\n if (g === generation) retries = 0;\n }, net.stableMs);\n if (videoPresented) post({ type: \"streaming\", attemptId });\n }\n };\n await rtc.setLocalDescription(await rtc.createOffer());\n if (!trickleIce)\n await new Promise((resolve) => {\n if (rtc.iceGatheringState === \"complete\") return resolve();\n gatherDone = resolve;\n gatherTimer = setTimeout(resolve, net.legacyGatherMs);\n rtc.onicegatheringstatechange = () => {\n if (rtc.iceGatheringState === \"complete\") {\n clearTimeout(gatherTimer);\n resolve();\n }\n };\n });\n if (g !== generation) return;\n post({ type: \"offer\", attemptId, sdp: rtc.localDescription.sdp });\n deadlineTimer = setTimeout(() => {\n if (g === generation) failRtc(\"answer-timeout\");\n }, net.answerMs);\n } catch {\n if (g === generation) failRtc(\"setup\");\n }\n }\n\n /* END RTC */\n function reportPresentation() {\n post({\n type: \"presentation\",\n active:\n video.webkitPresentationMode === \"picture-in-picture\" ||\n document.pictureInPictureElement === video,\n });\n }\n listen(video, \"webkitpresentationmodechanged\", reportPresentation);\n listen(video, \"enterpictureinpicture\", reportPresentation);\n listen(video, \"leavepictureinpicture\", reportPresentation);\n function applyDisplayGeometry(message) {\n if (\n !Number.isInteger(message.width) ||\n !Number.isInteger(message.height) ||\n message.width < 320 ||\n message.height < 320 ||\n (message.restore !== true &&\n (message.width > 2560 || message.height > 2560))\n )\n return;\n release();\n stopPanAnimation();\n viewerSized = message.restore !== true;\n zoom = 1;\n desktopScale = null;\n fx = fy = 0.5;\n followRest = null;\n dw = message.width;\n dh = message.height;\n render();\n }\n function receive(event) {\n let message;\n try {\n message = JSON.parse(event.data);\n } catch {\n return;\n }\n switch (message.type) {\n // A small control request routed over the live data channel. The host\n // only receives it after advertising support; otherwise the parent uses\n // the relay. `sent` tells the parent whether the channel took it.\n case \"channelRequest\": {\n const id =\n typeof message.id === \"string\" && message.id.length <= 64\n ? message.id\n : null;\n if (!id) break;\n let sent = false;\n try {\n const data = JSON.stringify({\n type: \"request\",\n id,\n request: message.request,\n });\n if (\n pc?.connectionState === \"connected\" &&\n dc?.readyState === \"open\" &&\n dc.bufferedAmount < 16384 &&\n data.length <= 32768\n ) {\n dc.send(data);\n sent = true;\n }\n } catch {}\n post({ type: \"channelRequestState\", id, sent });\n break;\n }\n case \"measureViewport\":\n post({\n type: \"viewportSize\",\n width: viewportWidth(),\n height: usableHeight(),\n });\n break;\n case \"presentation\":\n if (config.nativeMedia) {\n release();\n showKeyboard(false);\n break;\n }\n try {\n if (message.enabled) {\n release();\n showKeyboard(false);\n if (video.webkitSupportsPresentationMode?.(\"picture-in-picture\"))\n video.webkitSetPresentationMode(\"picture-in-picture\");\n else if (video.requestPictureInPicture)\n video\n .requestPictureInPicture()\n .catch(() => post({ type: \"presentationFailed\" }));\n else post({ type: \"presentationFailed\" });\n } else if (video.webkitSetPresentationMode)\n video.webkitSetPresentationMode(\"inline\");\n else if (document.pictureInPictureElement)\n document.exitPictureInPicture().catch(() => {});\n } catch {\n post({ type: \"presentationFailed\" });\n }\n break;\n case \"videoSettings\":\n applyDisplayGeometry(message);\n video.muted = !message.audio;\n retries = 0;\n if (!config.nativeMedia) connect();\n break;\n // The host kept the stream across a display change: layout only.\n case \"displayGeometry\":\n applyDisplayGeometry(message);\n break;\n case \"keyboard\":\n showKeyboard(message.enabled === true);\n break;\n case \"resume\":\n if (video.srcObject) video.play().catch(() => {});\n break;\n case \"releaseInput\":\n release();\n break;\n case \"theme\":\n if (/^#[0-9a-f]{3,8}$/i.test(message.surface)) {\n document.body.style.background = config.nativeMedia\n ? \"transparent\"\n : message.surface;\n document.documentElement.style.background = config.nativeMedia\n ? \"transparent\"\n : message.surface;\n document.documentElement.style.setProperty(\n \"--surface\",\n message.surface,\n );\n }\n if (/^#[0-9a-f]{3,8}$/i.test(message.foreground)) {\n cursor.style.borderColor = message.foreground;\n document.documentElement.style.setProperty(\n \"--foreground\",\n message.foreground,\n );\n }\n break;\n case \"networkStatus\": {\n const status = find(\"network-status\");\n if (!status) break;\n status.textContent =\n typeof message.text === \"string\" ? message.text : \"\";\n status.style.display = status.textContent ? \"block\" : \"none\";\n for (const key of [\"top\", \"right\", \"fontSize\"]) {\n if (Number.isFinite(message[key]) && message[key] >= 0)\n status.style[key] = message[key] + \"px\";\n }\n if (/^#[0-9a-f]{3,8}$/i.test(message.color))\n status.style.color = message.color;\n statusOrigin = null;\n clipNetworkStatus();\n break;\n }\n case \"nativeTouchpad\": {\n if (!nativeMouseControls || !control) break;\n if (message.tap === true) {\n if (!heldMouse.size) { click(); flush(); }\n break;\n }\n if (!Number.isFinite(message.dx) || !Number.isFinite(message.dy)) break;\n moveTouchpad(message.dx, message.dy);\n queue({ kind: \"move\", x: cx, y: cy });\n touchCursor = { x: cx, y: cy };\n touchCursorVisible = true;\n render();\n break;\n }\n case \"nativeMouse\": {\n if (\n !nativeMouseControls ||\n ![\"left\", \"right\", \"wheel\"].includes(message.control)\n )\n break;\n if (\n ![\n \"pointerdown\",\n \"pointermove\",\n \"pointerup\",\n \"pointercancel\",\n \"click\",\n ].includes(message.event)\n )\n break;\n if (!Number.isFinite(message.id) || !Number.isFinite(message.y)) break;\n mouseControlHandlers.get(\n \"mouse-\" + message.control + \":\" + message.event,\n )?.({\n pointerId: message.id,\n clientY: message.y,\n detail: 0,\n nativeInput: true,\n preventDefault() {},\n });\n break;\n }\n case \"mouseButtons\": {\n nativeMouseControls = message.native === true;\n const before = layout(),\n previousTopInset = viewportTopInset,\n previousBottomInset = viewportBottomInset,\n keyboardOpen = fillHeight && message.keyboardOpen === true;\n const keepHorizontal =\n fillHeight && (keyboardOpen || keyboardViewportOpen);\n // Hiding the rail for the keyboard must not enlarge a width-fitted desktop.\n if (keyboardOpen && (!keyboardViewportOpen || !keyboardFitWidth)) {\n keyboardFitWidth = { stageWidth: stage.clientWidth, width: viewportWidth() };\n }\n if (!keyboardOpen) keyboardFitWidth = null;\n // Opening is observable before the native keyboard has a measured height.\n keyboardViewportOpen = keyboardOpen;\n const fitChanged = fitToInsets !== (message.fitToInsets === true);\n fitToInsets = message.fitToInsets === true;\n const previousOffset = portraitKeyboardTopInset;\n if (Number.isFinite(message.portraitKeyboardTopInset))\n portraitKeyboardTopInset = Math.max(\n 0,\n message.portraitKeyboardTopInset,\n );\n const offsetChanged = previousOffset !== portraitKeyboardTopInset;\n let sideInsetsChanged = false;\n if (Number.isFinite(message.topInset))\n viewportTopInset = Math.max(\n 0,\n Math.min(stage.clientHeight - 1, message.topInset),\n );\n if (Number.isFinite(message.bottomInset))\n viewportBottomInset = Math.max(\n 0,\n Math.min(stage.clientHeight - 1, message.bottomInset),\n );\n if (Number.isFinite(message.leftInset)) {\n const inset = Math.max(\n 0,\n Math.min(stage.clientWidth - 1, message.leftInset),\n );\n sideInsetsChanged = sideInsetsChanged || inset !== viewportLeftInset;\n viewportLeftInset = inset;\n }\n if (Number.isFinite(message.rightInset)) {\n const inset = Math.max(\n 0,\n Math.min(stage.clientWidth - 1, message.rightInset),\n );\n sideInsetsChanged = sideInsetsChanged || inset !== viewportRightInset;\n viewportRightInset = inset;\n }\n // Hiding the side toolbar changes the viewport center. Keep the image's\n // actual horizontal position instead of following that center sideways.\n if (keepHorizontal) {\n stopPanAnimation();\n const r = layout();\n place(before.x, r.y, r);\n }\n const keyboardInset = keyboardOpen ? viewportBottomInset : 0;\n if (keyboardInset !== keyboardViewportInset) {\n const wasOpen = keyboardViewportInset > 0;\n keyboardViewportInset = keyboardInset;\n if (fillHeight && (keyboardInset > 0 || wasOpen)) {\n const r = layout(),\n v = cursorViewport();\n place(r.x, (v.minY + v.maxY) / 2 - cy * r.height, r);\n cursorNeedsEntry = false;\n manualViewMoved = false;\n }\n }\n if (keepHorizontal) {\n // Restoring the toolbar can cover the cursor even after a zero-height opening.\n if (!keyboardOpen || keyboardInset > 0) {\n const r = layout(),\n v = cursorViewport(),\n x = r.x + cx * r.width;\n place(r.x + bounded(x, v.minX, v.maxX) - x, r.y, r);\n }\n followRest = { fx, fy, zoom };\n render();\n } else if (\n fitChanged ||\n sideInsetsChanged ||\n offsetChanged ||\n (usesViewportInsets() && previousTopInset !== viewportTopInset) ||\n (usesViewportInsets() && previousBottomInset !== viewportBottomInset)\n ) {\n settlePan();\n render();\n }\n reportViewport();\n if (!message.enabled) {\n for (const button of heldMouse.keys())\n queue({ kind: \"button\", button, down: false, x: cx, y: cy });\n heldMouse.clear();\n resetWheel();\n flush();\n }\n for (const [edge, value] of [\n [\"bottom\", message.bottomInset],\n [\"right\", message.rightInset],\n ])\n if (Number.isFinite(value) && value >= 0 && value <= 4096)\n mouseButtons.style[edge] = value + \"px\";\n showMouseButtons = message.enabled === true;\n for (const name of [\"left\", \"right\", \"wheel\"])\n if (typeof message.labels?.[name] === \"string\")\n find(\"mouse-\" + name).setAttribute(\n \"aria-label\",\n message.labels[name],\n );\n updateMouseButtons();\n break;\n }\n case \"init\":\n nativeVideoActive = false;\n image.style.visibility = \"visible\";\n desktopScale = null;\n reportedScaleMode = null;\n if (config.desktop) {\n zoom = 1;\n fx = 0.5;\n fy = 0.5;\n }\n viewerSized = false;\n followRest = null;\n cursorNeedsEntry = true;\n stopPanAnimation();\n resetCursor();\n control = false;\n release();\n pending = [];\n sending = false;\n seq = 0;\n epoch = message.epoch;\n clipboardShortcuts =\n config.desktop && message.clipboardShortcuts === true;\n clipboardModifier =\n message.clipboardModifier === \"meta\" ? \"meta\" : \"control\";\n dw = message.width;\n dh = message.height;\n fillHeight = message.fillHeight === true;\n video.muted = !message.audio;\n trickleIce = message.trickleIce === true;\n retries = 0;\n render();\n if (!config.nativeMedia) connect();\n break;\n case \"nativeVideo\":\n if (!config.nativeMedia || message.epoch !== epoch) break;\n nativeVideoActive = message.active === true;\n image.style.visibility = nativeVideoActive ? \"hidden\" : \"visible\";\n clipNetworkStatus();\n paintBackground();\n break;\n case \"nativeCursor\":\n if (config.nativeMedia && message.epoch === epoch)\n receiveCursor(message.cursor);\n break;\n case \"viewport\":\n if (fillHeight !== (message.fillHeight === true)) keyboardFitWidth = null;\n fillHeight = message.fillHeight === true;\n release();\n render();\n break;\n case \"answer\":\n if (message.epoch === epoch) void receiveAnswer(message);\n break;\n case \"iceConfig\":\n if (message.epoch === epoch) void receiveIceConfig(message);\n break;\n case \"ice\":\n if (message.epoch === epoch) void receiveIce(message);\n break;\n case \"fallback\":\n if (message.epoch === epoch && message.attemptId === attemptId)\n failRtc(\n message.capturePending === true ? \"capture-pending\" : \"host\",\n message.retry !== false,\n );\n break;\n case \"frame\": {\n if (\"cursor\" in message) receiveCursor(message.cursor);\n else resetCursor();\n const frameEpoch = epoch;\n image.onload = () => {\n if (epoch === frameEpoch) {\n scheduleBackgroundDraw();\n post({ type: \"framePresented\" });\n }\n };\n image.src = \"data:image/jpeg;base64,\" + message.jpeg;\n break;\n }\n case \"control\": {\n // A local view-only switch keeps host control, so its release must\n // still reach the host even if a batch was waiting for its ACK.\n const releaseHost =\n control && message.enabled !== true && message.release === true;\n release();\n // A new control intent abandons the previous relay batch. Advance the\n // existing sequence fence so a late old ACK cannot unlock a new batch.\n seq++;\n sending = false;\n control = message.enabled;\n if (!control) showKeyboard(false);\n pending = [];\n if (releaseHost) {\n pending = [{ kind: \"release\" }];\n pendingSince = performance.now();\n flush();\n }\n updateMouseButtons();\n render();\n break;\n }\n case \"mode\":\n release();\n if (message.mode !== \"pointer\") followRest = null;\n settlePan();\n clearTimeout(touchCursorTimer);\n touchCursorVisible = false;\n mode = message.mode;\n render();\n break;\n case \"zoom\":\n stopEdgePan();\n if (\n !config.desktop ||\n !Number.isFinite(message.factor) ||\n message.factor <= 0\n )\n break;\n followRest = null;\n cursorNeedsEntry = true;\n manualViewMoved = true;\n stopPanAnimation();\n const fitScale = Math.min(viewportWidth() / dw, viewportHeight() / dh);\n // Include actual size even when it lies outside the fit-relative range.\n desktopScale = Math.max(\n Math.min(fitScale, 1) * 0.1,\n Math.min(Math.max(5 * fitScale, 5), layout().scale * message.factor),\n );\n if (Math.abs(desktopScale - fitScale) < 1e-9) desktopScale = null;\n if (desktopScale === null) {\n fx = 0.5;\n fy = 0.5;\n manualViewMoved = false;\n }\n render();\n settlePan();\n break;\n case \"actualSize\":\n stopEdgePan();\n if (!config.desktop) break;\n followRest = null;\n cursorNeedsEntry = true;\n manualViewMoved = true;\n stopPanAnimation();\n desktopScale = 1;\n fx = 0.5;\n fy = 0.5;\n render();\n break;\n case \"fit\":\n stopEdgePan();\n desktopScale = null;\n followRest = null;\n cursorNeedsEntry = true;\n manualViewMoved = false;\n stopPanAnimation();\n zoom = 1;\n fx = 0.5;\n fy = 0.5;\n render();\n break;\n case \"rightClick\":\n click(2);\n break;\n case \"events\":\n for (const e of message.events) queue(e);\n flush();\n break;\n case \"ack\":\n if (message.epoch === epoch && message.sequence === seq)\n sending = false;\n break;\n case \"stop\":\n nativeVideoActive = false;\n image.style.visibility = \"visible\";\n showKeyboard(false);\n control = false;\n release();\n pending = [];\n sending = false;\n epoch = null;\n closeRtc(message.preserveFrame === true);\n updateMouseButtons();\n render();\n break;\n }\n }\n // iOS can report equal left/right safe areas in both landscape directions.\n // Its interface angle distinguishes the notch side even on a 180-degree turn.\n const reportOrientation = () => {\n const angle =\n typeof window.orientation === \"number\"\n ? window.orientation\n : window.screen?.orientation?.angle;\n if (Number.isFinite(angle)) post({ type: \"orientation\", angle });\n };\n listen(window, \"orientationchange\", reportOrientation);\n if (window.screen?.orientation?.addEventListener)\n listen(window.screen.orientation, \"change\", reportOrientation);\n render();\n reportOrientation();\n post({ type: \"ready\" });\n return {\n receive: (message) => receive({ data: JSON.stringify(message) }),\n dispose: () => {\n release();\n epoch = null;\n closeRtc(false);\n if (bgDrawFrame !== null) cancelAnimationFrame(bgDrawFrame);\n bgDrawFrame = null;\n for (const cleanup of cleanups) cleanup();\n },\n };\n}\n";