@abitat_reece/host-daemon 0.1.20 → 0.1.22

package/dist/local-control/remote-control/session-manager.js

@@ -0,0 +1,259 @@
+import { randomUUID } from "node:crypto";
+const DEFAULT_FRAME_INTERVAL_MS = 120;
+const stoppedStatuses = new Set(["ended", "failed"]);
+export function createLocalRemoteControlManager(options) {
+    const states = new Map();
+    const now = options.now ?? (() => new Date());
+    const idGenerator = options.idGenerator ??
+        ((prefix) => `${prefix}_${randomUUID().replaceAll("-", "").slice(0, 16)}`);
+    const frameIntervalMs = options.frameIntervalMs ?? DEFAULT_FRAME_INTERVAL_MS;
+    async function captureNextFrame(sessionId) {
+        const state = states.get(sessionId);
+        if (!state || stoppedStatuses.has(state.session.status)) {
+            return;
+        }
+        if (state.isFrameCaptureInFlight) {
+            return;
+        }
+        state.isFrameCaptureInFlight = true;
+        try {
+            const nextFrame = await options.driver.captureFrame(state.session);
+            if (stoppedStatuses.has(state.session.status)) {
+                return;
+            }
+            state.latestFrame = nextFrame;
+            state.session = {
+                ...state.session,
+                errorMessage: null,
+                permissionState: {
+                    ...state.session.permissionState,
+                    screenRecording: "granted"
+                },
+                status: "active",
+                updatedAt: now().toISOString()
+            };
+        }
+        catch (error) {
+            if (stoppedStatuses.has(state.session.status)) {
+                return;
+            }
+            const permission = permissionKind(error);
+            state.session = {
+                ...state.session,
+                errorMessage: error instanceof Error ? error.message : "Unable to capture Mac screen",
+                permissionState: {
+                    ...state.session.permissionState,
+                    screenRecording: permission === "screenRecording" ? "needed" : state.session.permissionState.screenRecording
+                },
+                status: permission === "screenRecording" ? "failed" : state.session.status,
+                updatedAt: now().toISOString()
+            };
+        }
+        finally {
+            state.isFrameCaptureInFlight = false;
+        }
+    }
+    function startFrameLoop(state) {
+        if (!state.session.screenEnabled || state.frameTimer) {
+            return;
+        }
+        state.frameTimer = setInterval(() => {
+            void captureNextFrame(state.session.id);
+        }, frameIntervalMs);
+        state.frameTimer.unref?.();
+        void captureNextFrame(state.session.id);
+    }
+    function requireSession(sessionId, clientMachineId) {
+        const state = states.get(sessionId);
+        if (!state || state.session.clientMachineId !== clientMachineId) {
+            throw Object.assign(new Error("Remote-control session not found"), { statusCode: 404 });
+        }
+        return state;
+    }
+    function activeSessionFor(input) {
+        return [...states.values()].find((state) => state.session.clientMachineId === input.clientMachineId &&
+            state.session.hostMachineId === input.hostMachineId &&
+            !stoppedStatuses.has(state.session.status));
+    }
+    async function readCursorPosition() {
+        if (!options.driver.getCursorPosition) {
+            return null;
+        }
+        try {
+            return await options.driver.getCursorPosition();
+        }
+        catch {
+            return null;
+        }
+    }
+    async function readTextInputTarget() {
+        if (!options.driver.getTextInputTarget) {
+            return null;
+        }
+        return options.driver.getTextInputTarget();
+    }
+    return {
+        async applyInput(sessionId, clientMachineId, event) {
+            const state = requireSession(sessionId, clientMachineId);
+            if (stoppedStatuses.has(state.session.status)) {
+                throw Object.assign(new Error("Remote-control session is not active"), {
+                    statusCode: 409
+                });
+            }
+            if (!state.session.inputEnabled) {
+                throw Object.assign(new Error("Remote-control input is disabled for this session"), {
+                    statusCode: 403
+                });
+            }
+            try {
+                const inputResult = await options.driver.applyInput(state.session, event);
+                const cursorPosition = inputResult && "cursorPosition" in inputResult
+                    ? inputResult.cursorPosition
+                    : state.session.cursorPosition;
+                state.session = {
+                    ...state.session,
+                    cursorPosition,
+                    errorMessage: null,
+                    permissionState: {
+                        ...state.session.permissionState,
+                        accessibility: "granted"
+                    },
+                    updatedAt: now().toISOString()
+                };
+                return state.session;
+            }
+            catch (error) {
+                const permission = permissionKind(error);
+                state.session = {
+                    ...state.session,
+                    errorMessage: error instanceof Error ? error.message : "Unable to send Mac input",
+                    permissionState: {
+                        ...state.session.permissionState,
+                        accessibility: permission === "accessibility" ? "needed" : state.session.permissionState.accessibility
+                    },
+                    updatedAt: now().toISOString()
+                };
+                throw error;
+            }
+        },
+        async captureNextFrameForTest(sessionId) {
+            await captureNextFrame(sessionId);
+        },
+        async endSession(sessionId, clientMachineId) {
+            const state = requireSession(sessionId, clientMachineId);
+            if (state.frameTimer) {
+                clearInterval(state.frameTimer);
+                state.frameTimer = null;
+            }
+            state.session = {
+                ...state.session,
+                status: "ended",
+                updatedAt: now().toISOString()
+            };
+            state.latestFrame = null;
+            await options.driver.closeSession(state.session);
+            return state.session;
+        },
+        getLatestFrame(sessionId, clientMachineId, afterSequence = -1) {
+            const state = requireSession(sessionId, clientMachineId);
+            return {
+                frame: state.latestFrame && state.latestFrame.sequence > afterSequence ? state.latestFrame : null,
+                session: state.session
+            };
+        },
+        getSession(sessionId, clientMachineId) {
+            return requireSession(sessionId, clientMachineId).session;
+        },
+        async getTextInputTarget(sessionId, clientMachineId) {
+            const state = requireSession(sessionId, clientMachineId);
+            if (stoppedStatuses.has(state.session.status)) {
+                throw Object.assign(new Error("Remote-control session is not active"), {
+                    statusCode: 409
+                });
+            }
+            try {
+                const target = await readTextInputTarget();
+                state.session = {
+                    ...state.session,
+                    errorMessage: null,
+                    permissionState: {
+                        ...state.session.permissionState,
+                        accessibility: options.driver.getTextInputTarget
+                            ? "granted"
+                            : state.session.permissionState.accessibility
+                    },
+                    updatedAt: now().toISOString()
+                };
+                return target;
+            }
+            catch (error) {
+                const permission = permissionKind(error);
+                state.session = {
+                    ...state.session,
+                    errorMessage: error instanceof Error ? error.message : "Unable to inspect Mac text input focus",
+                    permissionState: {
+                        ...state.session.permissionState,
+                        accessibility: permission === "accessibility" ? "needed" : state.session.permissionState.accessibility
+                    },
+                    updatedAt: now().toISOString()
+                };
+                throw error;
+            }
+        },
+        listSessions(clientMachineId) {
+            return [...states.values()]
+                .map((state) => state.session)
+                .filter((session) => session.clientMachineId === clientMachineId);
+        },
+        async startSession(input) {
+            const existing = activeSessionFor(input);
+            if (existing) {
+                return existing.session;
+            }
+            const timestamp = now().toISOString();
+            const cursorPosition = await readCursorPosition();
+            const session = {
+                id: idGenerator("remote"),
+                status: "connecting",
+                hostMachineId: input.hostMachineId,
+                clientMachineId: input.clientMachineId,
+                screenEnabled: input.screenEnabled,
+                inputEnabled: input.inputEnabled,
+                permissionState: {
+                    accessibility: "unknown",
+                    screenRecording: "unknown"
+                },
+                cursorPosition,
+                errorMessage: null,
+                createdAt: timestamp,
+                updatedAt: timestamp
+            };
+            const state = {
+                frameTimer: null,
+                isFrameCaptureInFlight: false,
+                latestFrame: null,
+                session
+            };
+            states.set(session.id, state);
+            startFrameLoop(state);
+            return session;
+        },
+        async stopAll() {
+            await Promise.all([...states.values()].map(async (state) => {
+                if (state.frameTimer) {
+                    clearInterval(state.frameTimer);
+                    state.frameTimer = null;
+                }
+                await options.driver.closeSession(state.session);
+            }));
+        }
+    };
+}
+function permissionKind(error) {
+    if (typeof error === "object" && error && "permission" in error) {
+        const value = error.permission;
+        return value === "screenRecording" || value === "accessibility" ? value : null;
+    }
+    return null;
+}
+//# sourceMappingURL=session-manager.js.map

package/dist/local-control/remote-control/session-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-manager.js","sourceRoot":"","sources":["../../../src/local-control/remote-control/session-manager.ts"],"names":[],"mappings":"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"}

package/dist/local-control/remote-control/types.d.ts

@@ -0,0 +1,49 @@
+import type { RemoteControlCursorPosition, RemoteControlFrame, RemoteControlStatus, RemoteControlTextTarget, RemoteInputEvent } from "@abitat_reece/shared";
+export type RemoteControlPermissionState = "unknown" | "granted" | "needed";
+export interface LocalRemoteControlPermissionState {
+    accessibility: RemoteControlPermissionState;
+    screenRecording: RemoteControlPermissionState;
+}
+export interface LocalRemoteControlSession {
+    id: string;
+    status: RemoteControlStatus;
+    hostMachineId: string;
+    clientMachineId: string;
+    screenEnabled: boolean;
+    inputEnabled: boolean;
+    permissionState: LocalRemoteControlPermissionState;
+    cursorPosition?: RemoteControlCursorPosition | null;
+    errorMessage?: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface LocalRemoteControlStartInput {
+    hostMachineId: string;
+    clientMachineId: string;
+    screenEnabled: boolean;
+    inputEnabled: boolean;
+}
+export interface LocalRemoteControlDriver {
+    captureFrame(session: LocalRemoteControlSession): Promise<RemoteControlFrame>;
+    applyInput(session: LocalRemoteControlSession, event: RemoteInputEvent): Promise<{
+        cursorPosition?: RemoteControlCursorPosition | null;
+    } | void>;
+    closeSession(session: LocalRemoteControlSession): Promise<void>;
+    getCursorPosition?(): Promise<RemoteControlCursorPosition | null>;
+    getTextInputTarget?(): Promise<RemoteControlTextTarget | null>;
+}
+export interface LocalRemoteControlManager {
+    applyInput(sessionId: string, clientMachineId: string, event: RemoteInputEvent): Promise<LocalRemoteControlSession>;
+    captureNextFrameForTest(sessionId: string): Promise<void>;
+    endSession(sessionId: string, clientMachineId: string): Promise<LocalRemoteControlSession>;
+    getLatestFrame(sessionId: string, clientMachineId: string, afterSequence?: number): {
+        frame: RemoteControlFrame | null;
+        session: LocalRemoteControlSession;
+    };
+    getSession(sessionId: string, clientMachineId: string): LocalRemoteControlSession;
+    getTextInputTarget(sessionId: string, clientMachineId: string): Promise<RemoteControlTextTarget | null>;
+    listSessions(clientMachineId: string): LocalRemoteControlSession[];
+    startSession(input: LocalRemoteControlStartInput): Promise<LocalRemoteControlSession>;
+    stopAll(): Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/local-control/remote-control/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/local-control/remote-control/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,2BAA2B,EAC3B,kBAAkB,EAClB,mBAAmB,EACnB,uBAAuB,EACvB,gBAAgB,EACjB,MAAM,sBAAsB,CAAC;AAE9B,MAAM,MAAM,4BAA4B,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC;AAE5E,MAAM,WAAW,iCAAiC;IAChD,aAAa,EAAE,4BAA4B,CAAC;IAC5C,eAAe,EAAE,4BAA4B,CAAC;CAC/C;AAED,MAAM,WAAW,yBAAyB;IACxC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,mBAAmB,CAAC;IAC5B,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,OAAO,CAAC;IACvB,YAAY,EAAE,OAAO,CAAC;IACtB,eAAe,EAAE,iCAAiC,CAAC;IACnD,cAAc,CAAC,EAAE,2BAA2B,GAAG,IAAI,CAAC;IACpD,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,4BAA4B;IAC3C,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,OAAO,CAAC;IACvB,YAAY,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,wBAAwB;IACvC,YAAY,CAAC,OAAO,EAAE,yBAAyB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAC9E,UAAU,CACR,OAAO,EAAE,yBAAyB,EAClC,KAAK,EAAE,gBAAgB,GACtB,OAAO,CAAC;QAAE,cAAc,CAAC,EAAE,2BAA2B,GAAG,IAAI,CAAA;KAAE,GAAG,IAAI,CAAC,CAAC;IAC3E,YAAY,CAAC,OAAO,EAAE,yBAAyB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChE,iBAAiB,CAAC,IAAI,OAAO,CAAC,2BAA2B,GAAG,IAAI,CAAC,CAAC;IAClE,kBAAkB,CAAC,IAAI,OAAO,CAAC,uBAAuB,GAAG,IAAI,CAAC,CAAC;CAChE;AAED,MAAM,WAAW,yBAAyB;IACxC,UAAU,CACR,SAAS,EAAE,MAAM,EACjB,eAAe,EAAE,MAAM,EACvB,KAAK,EAAE,gBAAgB,GACtB,OAAO,CAAC,yBAAyB,CAAC,CAAC;IACtC,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAAC;IAC3F,cAAc,CACZ,SAAS,EAAE,MAAM,EACjB,eAAe,EAAE,MAAM,EACvB,aAAa,CAAC,EAAE,MAAM,GACrB;QACD,KAAK,EAAE,kBAAkB,GAAG,IAAI,CAAC;QACjC,OAAO,EAAE,yBAAyB,CAAC;KACpC,CAAC;IACF,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,yBAAyB,CAAC;IAClF,kBAAkB,CAChB,SAAS,EAAE,MAAM,EACjB,eAAe,EAAE,MAAM,GACtB,OAAO,CAAC,uBAAuB,GAAG,IAAI,CAAC,CAAC;IAC3C,YAAY,CAAC,eAAe,EAAE,MAAM,GAAG,yBAAyB,EAAE,CAAC;IACnE,YAAY,CAAC,KAAK,EAAE,4BAA4B,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAAC;IACtF,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B"}

package/dist/local-control/remote-control/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/local-control/remote-control/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/local-control/remote-control/types.ts"],"names":[],"mappings":""}

package/dist/local-control/server.d.ts

@@ -3,6 +3,7 @@ import type { CodexMobileModelSettings, CodexModelOption, ConversationStatus } f
 import { type LocalControlStore, type LocalControlTransport } from "./state.js";
 import { type MobileControlDiagnosticsLogger } from "./diagnostics-log.js";
 import { type CodexTokenUsageSummary } from "./token-usage.js";
+import { type LocalRemoteControlManager } from "./remote-control/session-manager.js";
 export interface LocalCodexProjectSummary {
     id: string;
     workspaceId: string;
@@ -67,6 +68,9 @@ export interface LocalCodexCompletionState {
     updatedAt: string;
     workspaceId: string;
 }
+export interface LocalCodexCompletionStateOptions {
+    hydrateIdleSummariesSince?: number;
+}
 export interface LocalCodexBridge {
     bootstrap(): Promise<{
         available: boolean;
@@ -97,7 +101,7 @@ export interface LocalCodexBridge {
         status: ConversationStatus | string;
         updated: boolean;
     }>;
-    listCompletionStates(): Promise<LocalCodexCompletionState[]>;
+    listCompletionStates(options?: LocalCodexCompletionStateOptions): Promise<LocalCodexCompletionState[]>;
     downloadGeneratedFile(conversationId: string, fileId: string): Promise<LocalGeneratedFileDownload>;
     listMessages(conversationId: string, options?: {
         afterSequence?: number;
@@ -129,6 +133,7 @@ interface StartLocalControlServerInput {
     diagnostics?: MobileControlDiagnosticsLogger;
     endpoint: string;
     port: number;
+    remoteControl?: LocalRemoteControlManager;
     store: LocalControlStore;
     tokenUsageProvider?: () => Promise<CodexTokenUsageSummary>;
     transport: LocalControlTransport;
@@ -136,7 +141,7 @@ interface StartLocalControlServerInput {
 export declare function startLocalControlServer(input: StartLocalControlServerInput): Promise<{
     readonly endpoint: string;
     server: Server<typeof IncomingMessage, typeof ServerResponse>;
-    close: () => Promise<void>;
+    close(): Promise<void>;
 }>;
 export {};
 //# sourceMappingURL=server.d.ts.map

package/dist/local-control/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/local-control/server.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/local-control/server.ts"],"names":[],"mappings":"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"}

package/dist/local-control/server.js

@@ -5,13 +5,18 @@ import { dirname, join } from "node:path";
 import { defaultLocalAttachmentDirectory } from "./state.js";
 import { attachmentDiagnostics, errorDiagnostics, logDiagnostics, mobileControlDiagnosticsLogPath, promptDiagnostics } from "./diagnostics-log.js";
 import { readCodexTokenUsageSummary } from "./token-usage.js";
+import { createMacOsRemoteControlDriver } from "./remote-control/macos-driver.js";
+import { handleLocalRemoteControlRoute } from "./remote-control/routes.js";
+import { createLocalRemoteControlManager } from "./remote-control/session-manager.js";
 const LOCAL_WORKSPACE_ID = "local";
 const MOBILE_DIAGNOSTICS_LOG_LIMIT_BYTES = 3 * 1024 * 1024;
 export async function startLocalControlServer(input) {
     const identity = await input.store.getMacIdentity();
     const diagnostics = input.diagnostics;
-    const sessions = new Map();
-    const signals = [];
+    const remoteControl = input.remoteControl ??
+        createLocalRemoteControlManager({
+            driver: createMacOsRemoteControlDriver()
+        });
     let endpoint = input.endpoint;
     const server = createServer(async (request, response) => {
         const method = request.method ?? "GET";
@@ -377,77 +382,19 @@ export async function startLocalControlServer(input) {
                 writeJson(response, 201, { attachment });
                 return;
             }
-            if (method === "GET" && path === "/remote-control/status") {
-                writeJson(response, 200, {
-                    sessions: Array.from(sessions.values()).filter((session) => session.clientMachineId === actor.id)
-                });
-                return;
-            }
-            if (method === "GET" &&
-                (path === "/api/remote-control/sessions" || path === "/remote-control/sessions")) {
-                writeJson(response, 200, {
-                    sessions: Array.from(sessions.values()).filter((session) => session.clientMachineId === actor.id)
-                });
-                return;
-            }
-            if (method === "POST" &&
-                (path === "/api/remote-control/sessions" || path === "/remote-control/start")) {
-                const body = await readJson(request);
-                const hostMachineId = stringValue(body.hostMachineId) || identity.macId;
-                if (hostMachineId !== identity.macId) {
-                    throw Object.assign(new Error("Phone is not paired to this Mac host"), {
-                        statusCode: 403
-                    });
-                }
-                const timestamp = new Date().toISOString();
-                const session = {
-                    id: `remote_${randomBytes(8).toString("hex")}`,
-                    status: "requested",
-                    hostMachineId,
-                    clientMachineId: actor.id,
-                    screenEnabled: body.screenEnabled !== false,
-                    inputEnabled: body.inputEnabled !== false,
-                    errorMessage: null,
-                    createdAt: timestamp,
-                    updatedAt: timestamp
-                };
-                sessions.set(session.id, session);
-                writeJson(response, 201, { session });
-                return;
-            }
-            const remoteSessionMatch = matchPath(path, "/api/remote-control/sessions/:sessionId");
-            if (remoteSessionMatch && method === "DELETE") {
-                const session = requireRemoteSession(sessions, remoteSessionMatch.sessionId, actor.id);
-                const ended = { ...session, status: "ended", updatedAt: new Date().toISOString() };
-                sessions.set(session.id, ended);
-                writeJson(response, 200, { session: ended });
-                return;
-            }
-            const signalMatch = matchPath(path, "/api/remote-control/sessions/:sessionId/signals");
-            if (signalMatch && method === "GET") {
-                requireRemoteSession(sessions, signalMatch.sessionId, actor.id);
-                writeJson(response, 200, {
-                    signals: signals.filter((signal) => signal.sessionId === signalMatch.sessionId &&
-                        (!signal.recipientMachineId || signal.recipientMachineId === actor.id))
-                });
-                return;
-            }
-            if ((signalMatch && method === "POST") ||
-                (path === "/remote-control/input" && method === "POST")) {
-                const body = await readJson(request);
-                const sessionId = signalMatch?.sessionId ?? stringValue(body.sessionId);
-                const session = requireRemoteSession(sessions, sessionId, actor.id);
-                const signal = {
-                    id: `signal_${randomBytes(8).toString("hex")}`,
-                    sessionId: session.id,
-                    senderMachineId: actor.id,
-                    recipientMachineId: stringValue(body.recipientMachineId) || identity.macId,
-                    type: stringValue(body.type) || "input",
-                    payload: recordValue(body.payload) ?? { event: body.event },
-                    createdAt: new Date().toISOString()
-                };
-                signals.push(signal);
-                writeJson(response, 201, { signal });
+            if (await handleLocalRemoteControlRoute({
+                actor,
+                diagnostics,
+                hostMachineId: identity.macId,
+                manager: remoteControl,
+                method,
+                path,
+                readJson,
+                request,
+                response,
+                searchParams: url.searchParams,
+                writeJson
+            })) {
                 return;
             }
             writeJson(response, 404, { error: "Not found" });
@@ -487,7 +434,10 @@ export async function startLocalControlServer(input) {
             return endpoint;
         },
         server,
-        close: () => closeServer(server)
+        async close() {
+            await remoteControl.stopAll();
+            await closeServer(server);
+        }
     };
 }
 async function readAndClearMobileDiagnosticsLog(diagnostics) {
@@ -578,13 +528,6 @@ async function requireMobileDevice(request, store) {
 function hasAuthorizationHeader(request) {
     return typeof request.headers.authorization === "string" && request.headers.authorization !== "";
 }
-function requireRemoteSession(sessions, sessionId, clientMachineId) {
-    const session = sessions.get(sessionId);
-    if (!session || session.clientMachineId !== clientMachineId) {
-        throw Object.assign(new Error("Remote-control session not found"), { statusCode: 404 });
-    }
-    return session;
-}
 async function readJson(request) {
     const chunks = [];
     for await (const chunk of request) {
@@ -691,11 +634,6 @@ function requiredString(value, message) {
     }
     return parsed;
 }
-function recordValue(value) {
-    return value && typeof value === "object" && !Array.isArray(value)
-        ? value
-        : null;
-}
 function numberQuery(value) {
     if (value === null) {
         return undefined;