Skip to content

armgit / cindy

Public Imported from GitHub
0

Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。

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.ts
index 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.ts
index 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.ts
new file mode 100644
index 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.ts
index 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.ts
index 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.ts
index 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.ts
index 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.tsx
index 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.tsx
index 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.tsx
index 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 ? (
<Button
variant="secondary"
diff --git a/apps/desktop/src/renderer/components/new-chat/PluginSetupRemoteDesktopButton.tsx b/apps/desktop/src/renderer/components/new-chat/PluginSetupRemoteDesktopButton.tsx
new file mode 100644
index 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.tsx
index 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.tsx
index 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.ts
index 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 sequ
type: '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 fit
type: '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.ts
index 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 to
expect(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 eve
vi.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.tsx
index 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 discard
credential: 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 c
credential: 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 without
credential: 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.ts
index 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.json
index 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.json
index 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.json
index 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.json
index 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.json
index 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.ts
index 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.tsx
index 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 && (
<RemoteDesktopMouseControls
send={send}
bottom={landscape ? 0 : toolbarSize.height}
@@ -3228,7 +3260,8 @@ export function RemoteDesktopSession({
)}
{windowsOpen &&
focused &&
- lease?.controlling &&
+ lease &&
+ canInput &&
caps?.windowActions && (
<RemoteDesktopWindows
key={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.tsx
index 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.ts
index 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.ts
index 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.md
index 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.md
index 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.md
index 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 the
computer, enable **Settings → Remote control → Allow remote desktop**, as well
as 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 new
diff --git a/packages/device-link/src/__tests__/viewerDisplay.test.ts b/packages/device-link/src/__tests__/viewerDisplay.test.ts
index 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.ts
index 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.ts
index 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.js
index 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.ts
index 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";