@mentra/sdk 2.1.31-beta.4 → 2.1.31-beta.6

package/dist/app/server/index.d.ts

@@ -8,7 +8,23 @@ import { type Express } from "express";
 import { AppSession } from "../session/index";
 import { ToolCall } from "../../types";
 import { Logger } from "pino";
+import { PhotoData } from "../../types/photo-data";
 export declare const GIVE_APP_CONTROL_OF_TOOL_RESPONSE: string;
+/**
+ * Pending photo request stored at AppServer level
+ * This allows O(1) lookup when photo uploads arrive via HTTP,
+ * and survives session reconnections.
+ * See: cloud/issues/019-sdk-photo-request-architecture
+ */
+export interface PendingPhotoRequest {
+    userId: string;
+    sessionId: string;
+    session: AppSession;
+    resolve: (photo: PhotoData) => void;
+    reject: (error: Error) => void;
+    timestamp: number;
+    timeoutId?: NodeJS.Timeout;
+}
 /**
  * 🔧 Configuration options for App Server
  *
@@ -90,6 +106,16 @@ export declare class AppServer {
     private cleanupHandlers;
     /** App instructions string shown to the user */
     private appInstructions;
+    /**
+     * Pending photo requests by requestId - owned by AppServer for HTTP endpoint access.
+     * This is the single source of truth for pending photo requests.
+     * Stored here (not on CameraModule) because:
+     * 1. Photo uploads arrive via HTTP to AppServer, not via WebSocket to session
+     * 2. Allows O(1) lookup by requestId instead of iterating all sessions
+     * 3. Survives session reconnections (session may be removed from activeSessions temporarily)
+     * See: cloud/issues/019-sdk-photo-request-architecture
+     */
+    private pendingPhotoRequests;
     readonly logger: Logger;
     constructor(config: AppServerConfig);
     getExpressApp(): Express;
@@ -192,7 +218,18 @@ export declare class AppServer {
     /**
      * 🧹 Cleanup
      * Closes all active sessions and runs cleanup handlers.
-     * Releases ownership before disconnecting to enable clean handoffs (no resurrection).
+     * Does NOT release ownership - we want the cloud to resurrect when we come back up.
+     *
+     * OWNERSHIP_RELEASE should only be sent for:
+     * - switching_clouds: User moved to another cloud, don't compete
+     * - user_logout: User explicitly logged out
+     *
+     * NOT for clean_shutdown, because:
+     * - Server is restarting/redeploying
+     * - Cloud should resurrect the app (trigger webhook)
+     * - User expects their app to keep running
+     *
+     * See: cloud/issues/023-disposed-appsession-resurrection-bug
      */
     private cleanup;
     /**
@@ -200,15 +237,42 @@ export declare class AppServer {
      * Creates a /photo-upload endpoint for receiving photos directly from ASG glasses
      */
     private setupPhotoUploadEndpoint;
+    /**
+     * Register a pending photo request.
+     * Called by CameraModule when a photo is requested.
+     * Stores the request at AppServer level for O(1) lookup when HTTP response arrives.
+     *
+     * @param requestId - Unique identifier for this photo request
+     * @param request - Request details including session, resolve/reject callbacks
+     */
+    registerPhotoRequest(requestId: string, request: Omit<PendingPhotoRequest, "timeoutId">): void;
+    /**
+     * Get a pending photo request by ID.
+     *
+     * @param requestId - The request ID to look up
+     * @returns The pending request, or undefined if not found
+     */
+    getPhotoRequest(requestId: string): PendingPhotoRequest | undefined;
+    /**
+     * Complete a photo request (success or error).
+     * Clears the timeout and removes from the pending map.
+     *
+     * @param requestId - The request ID to complete
+     * @returns The pending request that was completed, or undefined if not found
+     */
+    completePhotoRequest(requestId: string): PendingPhotoRequest | undefined;
+    /**
+     * Clean up all pending photo requests for a session.
+     * Called when a session permanently disconnects.
+     *
+     * @param sessionId - The session ID to clean up requests for
+     */
+    cleanupPhotoRequestsForSession(sessionId: string): void;
     /**
      * 🔐 Setup Mentra Auth Redirect Endpoint
      * Creates a /mentra-auth endpoint that redirects to the MentraOS OAuth flow.
      */
     private setupMentraAuthRedirect;
-    /**
-     * Find session that has a pending photo request for the given requestId
-     */
-    private findSessionByPhotoRequestId;
 }
 /**
  * @deprecated Use `AppServerConfig` instead. `TpaServerConfig` is deprecated and will be removed in a future version.

package/dist/app/server/index.d.ts.map

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

package/dist/app/session/modules/camera.d.ts

@@ -74,8 +74,6 @@ export declare class CameraModule {
     private packageName;
     private sessionId;
     private logger;
-    /** Map to store pending photo request promises */
-    private pendingPhotoRequests;
     private isStreaming;
     private currentStreamUrl?;
     private currentStreamState?;
@@ -108,63 +106,27 @@ export declare class CameraModule {
      * ```
      */
     requestPhoto(options?: PhotoRequestOptions): Promise<PhotoData>;
-    /**
-     * 📥 Handle photo received from /photo-upload endpoint
-     *
-     * This method is called internally when a photo response is received.
-     * It resolves the corresponding pending promise with the photo data.
-     *
-     * @param photoData - The photo data received
-     * @internal This method is used internally by AppSession
-     */
-    handlePhotoReceived(photoData: PhotoData): void;
-    /**
-     * ❌ Handle photo error from /photo-upload endpoint
-     *
-     * This method is called internally when a photo error response is received.
-     * It rejects the corresponding pending promise with the error information.
-     *
-     * @param errorResponse - The error response received
-     * @internal This method is used internally by AppSession
-     */
-    handlePhotoError(errorResponse: {
-        requestId: string;
-        success: false;
-        error: {
-            code: string;
-            message: string;
-        };
-    }): void;
     /**
      * 🔍 Check if there's a pending photo request for the given request ID
+     * @deprecated Photo requests are now managed at AppServer level. This method delegates to AppServer.
      *
      * @param requestId - The request ID to check
      * @returns true if there's a pending request
      */
     hasPhotoPendingRequest(requestId: string): boolean;
-    /**
-     * 📊 Get the number of pending photo requests
-     *
-     * @returns Number of pending photo requests
-     */
-    getPhotoPendingRequestCount(): number;
-    /**
-     * 📋 Get all pending photo request IDs
-     *
-     * @returns Array of pending request IDs
-     */
-    getPhotoPendingRequestIds(): string[];
     /**
      * ❌ Cancel a pending photo request
+     * @deprecated Photo requests are now managed at AppServer level. This method delegates to AppServer.
      *
      * @param requestId - The request ID to cancel
      * @returns true if the request was cancelled, false if it wasn't found
      */
     cancelPhotoRequest(requestId: string): boolean;
     /**
-     * 🧹 Cancel all pending photo requests
+     * 🧹 Cancel all pending photo requests for this session
+     * @deprecated Photo requests are now managed at AppServer level. Use AppServer.cleanupPhotoRequestsForSession() instead.
      *
-     * @returns Number of requests that were cancelled
+     * @returns Number of requests that were cancelled (always 0, cleanup happens at AppServer level)
      */
     cancelAllPhotoRequests(): number;
     /**

package/dist/app/session/modules/camera.d.ts.map

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

package/dist/index.js

@@ -326,6 +326,8 @@ var init_message_types = __esm(() => {
     GlassesToCloudMessageType2["AUDIO_PLAY_RESPONSE"] = "audio_play_response";
     GlassesToCloudMessageType2["RGB_LED_CONTROL_RESPONSE"] = "rgb_led_control_response";
     GlassesToCloudMessageType2["LIVEKIT_INIT"] = "livekit_init";
+    GlassesToCloudMessageType2["UDP_REGISTER"] = "udp_register";
+    GlassesToCloudMessageType2["UDP_UNREGISTER"] = "udp_unregister";
   })(GlassesToCloudMessageType ||= {});
   ((CloudToGlassesMessageType2) => {
     CloudToGlassesMessageType2["CONNECTION_ACK"] = "connection_ack";
@@ -349,6 +351,7 @@ var init_message_types = __esm(() => {
     CloudToGlassesMessageType2["REQUEST_SINGLE_LOCATION"] = "request_single_location";
     CloudToGlassesMessageType2["WEBSOCKET_ERROR"] = "websocket_error";
     CloudToGlassesMessageType2["LIVEKIT_INFO"] = "livekit_info";
+    CloudToGlassesMessageType2["UDP_PING_ACK"] = "udp_ping_ack";
   })(CloudToGlassesMessageType ||= {});
   ((AppToCloudMessageType2) => {
     AppToCloudMessageType2["CONNECTION_INIT"] = "tpa_connection_init";
@@ -737,6 +740,12 @@ function isAudioPlayResponse(message) {
 function isLocalTranscription(message) {
   return message.type === "local_transcription" /* LOCAL_TRANSCRIPTION */;
 }
+function isUdpRegister(message) {
+  return message.type === "udp_register" /* UDP_REGISTER */;
+}
+function isUdpUnregister(message) {
+  return message.type === "udp_unregister" /* UDP_UNREGISTER */;
+}
 // src/types/messages/cloud-to-glasses.ts
 init_message_types();
 function isResponse(message) {
@@ -2646,7 +2655,6 @@ class CameraModule {
   packageName;
   sessionId;
   logger;
-  pendingPhotoRequests = new Map;
   isStreaming = false;
   currentStreamUrl;
   currentStreamState;
@@ -2663,9 +2671,15 @@ class CameraModule {
       const baseUrl = this.session?.getHttpsServerUrl?.() || "";
       cameraWarnLog(baseUrl, this.packageName, "requestPhoto");
       try {
-        console.log("DEBUG: requestPhoto options:", options);
         const requestId = `photo_req_${Date.now()}_${Math.random().toString(36).substring(2, 9)}`;
-        this.pendingPhotoRequests.set(requestId, { resolve, reject });
+        this.session.appServer.registerPhotoRequest(requestId, {
+          userId: this.session.userId,
+          sessionId: this.sessionId,
+          session: this.session,
+          resolve,
+          reject: (error) => reject(error.message),
+          timestamp: Date.now()
+        });
         const message = {
           type: "photo_request" /* PHOTO_REQUEST */,
           packageName: this.packageName,
@@ -2687,91 +2701,41 @@ class CameraModule {
         }, `\uD83D\uDCF8 Photo request sent`);
         if (options?.customWebhookUrl) {
           this.logger.info({ requestId, customWebhookUrl: options.customWebhookUrl }, `\uD83D\uDCF8 Using custom webhook URL - resolving promise immediately since photo will be uploaded directly to custom endpoint`);
-          const mockPhotoData = {
-            buffer: Buffer.from([]),
-            mimeType: "image/jpeg",
-            filename: "photo.jpg",
-            requestId,
-            size: 0,
-            timestamp: new Date
-          };
-          this.pendingPhotoRequests.delete(requestId);
-          resolve(mockPhotoData);
+          const pending = this.session.appServer.completePhotoRequest(requestId);
+          if (pending) {
+            const mockPhotoData = {
+              buffer: Buffer.from([]),
+              mimeType: "image/jpeg",
+              filename: "photo.jpg",
+              requestId,
+              size: 0,
+              timestamp: new Date
+            };
+            pending.resolve(mockPhotoData);
+          }
           return;
         }
-        const timeoutMs = 30000;
-        if (this.session && this.session.resources) {
-          this.session.resources.setTimeout(() => {
-            if (this.pendingPhotoRequests.has(requestId)) {
-              this.pendingPhotoRequests.get(requestId).reject("Photo request timed out");
-              this.pendingPhotoRequests.delete(requestId);
-              this.logger.warn({ requestId }, `\uD83D\uDCF8 Photo request timed out`);
-            }
-          }, timeoutMs);
-        } else {
-          setTimeout(() => {
-            if (this.pendingPhotoRequests.has(requestId)) {
-              this.pendingPhotoRequests.get(requestId).reject("Photo request timed out");
-              this.pendingPhotoRequests.delete(requestId);
-              this.logger.warn({ requestId }, `\uD83D\uDCF8 Photo request timed out`);
-            }
-          }, timeoutMs);
-        }
       } catch (error) {
         const errorMessage = error instanceof Error ? error.message : String(error);
         reject(`Failed to request photo: ${errorMessage}`);
       }
     });
   }
-  handlePhotoReceived(photoData) {
-    const { requestId } = photoData;
-    const pendingRequest = this.pendingPhotoRequests.get(requestId);
-    if (pendingRequest) {
-      this.logger.info({ requestId }, `\uD83D\uDCF8 Photo received for request ${requestId}`);
-      pendingRequest.resolve(photoData);
-      this.pendingPhotoRequests.delete(requestId);
-    } else {
-      this.logger.warn({ requestId }, `\uD83D\uDCF8 Received photo for unknown request ID: ${requestId}`);
-    }
-  }
-  handlePhotoError(errorResponse) {
-    const { requestId, error } = errorResponse;
-    const pendingRequest = this.pendingPhotoRequests.get(requestId);
-    if (pendingRequest) {
-      this.logger.error({ requestId, errorCode: error.code, errorMessage: error.message }, `\uD83D\uDCF8 Photo capture failed: ${error.code} - ${error.message}`);
-      pendingRequest.reject(`${error.code}: ${error.message}`);
-      this.pendingPhotoRequests.delete(requestId);
-    } else {
-      this.logger.warn({ requestId, errorCode: error.code, errorMessage: error.message }, `\uD83D\uDCF8 Received photo error for unknown request ID: ${requestId}`);
-    }
-  }
   hasPhotoPendingRequest(requestId) {
-    return this.pendingPhotoRequests.has(requestId);
-  }
-  getPhotoPendingRequestCount() {
-    return this.pendingPhotoRequests.size;
-  }
-  getPhotoPendingRequestIds() {
-    return Array.from(this.pendingPhotoRequests.keys());
+    return this.session.appServer.getPhotoRequest(requestId) !== undefined;
   }
   cancelPhotoRequest(requestId) {
-    const pendingRequest = this.pendingPhotoRequests.get(requestId);
-    if (pendingRequest) {
-      pendingRequest.reject("Photo request cancelled");
-      this.pendingPhotoRequests.delete(requestId);
+    const pending = this.session.appServer.completePhotoRequest(requestId);
+    if (pending) {
+      pending.reject(new Error("Photo request cancelled"));
       this.logger.info({ requestId }, `\uD83D\uDCF8 Photo request cancelled`);
       return true;
     }
     return false;
   }
   cancelAllPhotoRequests() {
-    const count = this.pendingPhotoRequests.size;
-    for (const [requestId, { reject }] of this.pendingPhotoRequests) {
-      reject("Photo request cancelled - session cleanup");
-      this.logger.info({ requestId }, `\uD83D\uDCF8 Photo request cancelled during cleanup`);
-    }
-    this.pendingPhotoRequests.clear();
-    return count;
+    this.logger.debug(`\uD83D\uDCF8 cancelAllPhotoRequests called - cleanup now happens at AppServer level`);
+    return 0;
   }
   async startStream(options) {
     this.logger.info({ rtmpUrl: options.rtmpUrl }, `\uD83D\uDCF9 RTMP stream request starting`);
@@ -5072,6 +5036,7 @@ class AppServer {
   activeSessionsByUserId = new Map;
   cleanupHandlers = [];
   appInstructions = null;
+  pendingPhotoRequests = new Map;
   logger;
   constructor(config) {
     this.config = config;
@@ -5246,6 +5211,23 @@ class AppServer {
     this.logger.info({ userId }, `\uD83D\uDDE3️ Received session request for user ${userId}, session ${sessionId}
 
 `);
+    const existingSession = this.activeSessions.get(sessionId);
+    if (existingSession) {
+      this.logger.info({ sessionId, userId }, `\uD83D\uDD04 Existing session found for ${sessionId} - sending OWNERSHIP_RELEASE and disconnecting before new connection`);
+      try {
+        await existingSession.releaseOwnership("switching_clouds");
+      } catch (error) {
+        this.logger.warn({ error, sessionId }, `⚠️ Failed to send OWNERSHIP_RELEASE to old session - continuing anyway`);
+      }
+      try {
+        existingSession.disconnect();
+      } catch (error) {
+        this.logger.warn({ error, sessionId }, `⚠️ Failed to disconnect old session - continuing anyway`);
+      }
+      this.activeSessions.delete(sessionId);
+      this.activeSessionsByUserId.delete(userId);
+      this.logger.info({ sessionId, userId }, `✅ Old session cleaned up, proceeding with new connection`);
+    }
     const session = new AppSession({
       packageName: this.config.packageName,
       apiKey: this.config.apiKey,
@@ -5254,25 +5236,48 @@ class AppServer {
       userId
     });
     const cleanupDisconnect = session.events.onDisconnected((info) => {
+      let isPermanent = false;
+      let reason = "unknown";
       if (typeof info === "string") {
         this.logger.info(`\uD83D\uDC4B Session ${sessionId} disconnected: ${info}`);
+        reason = info;
+        isPermanent = false;
       } else {
         this.logger.info(`\uD83D\uDC4B Session ${sessionId} disconnected: ${info.message} (code: ${info.code}, reason: ${info.reason})`);
+        reason = info.reason || info.message;
         if (info.sessionEnded === true) {
           this.logger.info(`\uD83D\uDED1 User session ended for session ${sessionId}, calling onStop`);
+          isPermanent = true;
           this.onStop(sessionId, userId, "User session ended").catch((error) => {
             this.logger.error(error, `❌ Error in onStop handler for session end:`);
           });
         } else if (info.permanent === true) {
           this.logger.info(`\uD83D\uDED1 Permanent disconnection detected for session ${sessionId}, calling onStop`);
-          const _session = this.activeSessions.get(sessionId);
+          isPermanent = true;
           this.onStop(sessionId, userId, `Connection permanently lost: ${info.reason}`).catch((error) => {
             this.logger.error(error, `❌ Error in onStop handler for permanent disconnection:`);
           });
+        } else if (info.wasClean === true || info.code === 1000 || info.code === 1001) {
+          this.logger.info(`\uD83D\uDED1 Clean WebSocket closure for session ${sessionId} (code: ${info.code}), treating as permanent`);
+          isPermanent = true;
+          this.onStop(sessionId, userId, `Clean disconnect: ${reason}`).catch((error) => {
+            this.logger.error(error, `❌ Error in onStop handler for clean disconnect:`);
+          });
         }
       }
-      this.activeSessions.delete(sessionId);
-      this.activeSessionsByUserId.delete(userId);
+      if (isPermanent) {
+        if (this.activeSessions.get(sessionId) === session) {
+          this.activeSessions.delete(sessionId);
+        } else {
+          this.logger.debug({ sessionId }, `\uD83D\uDD04 Session ${sessionId} cleanup skipped - a newer session has taken over`);
+        }
+        if (this.activeSessionsByUserId.get(userId) === session) {
+          this.activeSessionsByUserId.delete(userId);
+        }
+        this.cleanupPhotoRequestsForSession(sessionId);
+      } else {
+        this.logger.debug({ sessionId, reason }, `\uD83D\uDD04 Temporary disconnect for session ${sessionId}, keeping in maps for reconnection`);
+      }
     });
     const cleanupError = session.events.onError((error) => {
       this.logger.error(error, `❌ [Session ${sessionId}] Error:`);
@@ -5376,12 +5381,12 @@ class AppServer {
     process.on("SIGINT", () => this.stop());
   }
   async cleanup() {
+    this.logger.info(`\uD83D\uDD27 [LOCAL SDK] cleanup() called - NOT sending OWNERSHIP_RELEASE`);
     for (const [sessionId, session] of this.activeSessions) {
-      this.logger.info(`\uD83D\uDC4B Closing session ${sessionId} with ownership release`);
+      this.logger.info(`\uD83D\uDC4B Closing session ${sessionId} (no ownership release - cloud will resurrect)`);
       try {
         await session.disconnect({
-          releaseOwnership: true,
-          reason: "clean_shutdown"
+          releaseOwnership: false
         });
       } catch (error) {
         this.logger.error(error, `Error during cleanup of session ${sessionId}`);
@@ -5413,7 +5418,6 @@ class AppServer {
       try {
         const { requestId, type, success, errorCode, errorMessage } = req.body;
         const photoFile = req.file;
-        console.log("Received photo response: ", req.body);
         this.logger.info({ requestId, type, success, errorCode }, `\uD83D\uDCF8 Received photo response: ${requestId} (type: ${type})`);
         if (!requestId) {
           this.logger.error("No requestId in photo response");
@@ -5422,24 +5426,18 @@ class AppServer {
             error: "No requestId provided"
           });
         }
-        const session = this.findSessionByPhotoRequestId(requestId);
-        if (!session) {
-          this.logger.warn({ requestId }, "No active session found for photo request");
+        const pending = this.completePhotoRequest(requestId);
+        if (!pending) {
+          this.logger.warn({ requestId, pendingCount: this.pendingPhotoRequests.size }, "\uD83D\uDCF8 No pending request found for photo (may have timed out or session ended)");
           return res.status(404).json({
             success: false,
-            error: "No active session found for this photo request"
+            error: "No pending request found for this photo (may have timed out or session ended)"
           });
         }
         if (type === "photo_error" || success === false) {
-          const errorResponse = {
-            requestId,
-            success: false,
-            error: {
-              code: errorCode || "UNKNOWN_ERROR",
-              message: errorMessage || "Unknown error occurred"
-            }
-          };
-          session.camera.handlePhotoError(errorResponse);
+          const errorMsg = errorMessage || "Unknown error occurred";
+          this.logger.info({ requestId, errorCode, errorMessage: errorMsg }, "\uD83D\uDCF8 Photo error received");
+          pending.reject(new Error(`Photo capture failed: ${errorMsg} (code: ${errorCode || "UNKNOWN_ERROR"})`));
           return res.json({
             success: true,
             requestId,
@@ -5448,6 +5446,7 @@ class AppServer {
         }
         if (!photoFile) {
           this.logger.error({ requestId }, "No photo file in successful upload");
+          pending.reject(new Error("No photo file provided for successful upload"));
           return res.status(400).json({
             success: false,
             error: "No photo file provided for successful upload"
@@ -5461,7 +5460,8 @@ class AppServer {
           size: photoFile.size,
           timestamp: new Date
         };
-        session.camera.handlePhotoReceived(photoData);
+        this.logger.info({ requestId, size: photoFile.size, mimeType: photoFile.mimetype }, "\uD83D\uDCF8 Photo received successfully, resolving promise");
+        pending.resolve(photoData);
         res.json({
           success: true,
           requestId,
@@ -5476,6 +5476,53 @@ class AppServer {
       }
     });
   }
+  registerPhotoRequest(requestId, request) {
+    const timeoutMs = 30000;
+    const timeoutId = setTimeout(() => {
+      const pending = this.pendingPhotoRequests.get(requestId);
+      if (pending) {
+        pending.reject(new Error("Photo request timed out"));
+        this.pendingPhotoRequests.delete(requestId);
+        this.logger.warn({ requestId }, "\uD83D\uDCF8 Photo request timed out");
+      }
+    }, timeoutMs);
+    this.pendingPhotoRequests.set(requestId, {
+      ...request,
+      timeoutId
+    });
+    this.logger.debug({ requestId, userId: request.userId, sessionId: request.sessionId }, "\uD83D\uDCF8 Photo request registered at AppServer level");
+  }
+  getPhotoRequest(requestId) {
+    return this.pendingPhotoRequests.get(requestId);
+  }
+  completePhotoRequest(requestId) {
+    const pending = this.pendingPhotoRequests.get(requestId);
+    if (pending) {
+      if (pending.timeoutId) {
+        clearTimeout(pending.timeoutId);
+      }
+      this.pendingPhotoRequests.delete(requestId);
+      this.logger.debug({ requestId }, "\uD83D\uDCF8 Photo request completed");
+    }
+    return pending;
+  }
+  cleanupPhotoRequestsForSession(sessionId) {
+    let cleanedCount = 0;
+    for (const [requestId, pending] of this.pendingPhotoRequests) {
+      if (pending.sessionId === sessionId) {
+        if (pending.timeoutId) {
+          clearTimeout(pending.timeoutId);
+        }
+        pending.reject(new Error("Session ended"));
+        this.pendingPhotoRequests.delete(requestId);
+        cleanedCount++;
+        this.logger.debug({ requestId, sessionId }, "\uD83D\uDCF8 Photo request cleaned up (session ended)");
+      }
+    }
+    if (cleanedCount > 0) {
+      this.logger.info({ sessionId, cleanedCount }, "\uD83D\uDCF8 Cleaned up photo requests for ended session");
+    }
+  }
   setupMentraAuthRedirect() {
     this.app.get("/mentra-auth", (req, res) => {
       const authUrl = `https://account.mentra.glass/auth?packagename=${encodeURIComponent(this.config.packageName)}`;
@@ -5483,14 +5530,6 @@ class AppServer {
       res.redirect(302, authUrl);
     });
   }
-  findSessionByPhotoRequestId(requestId) {
-    for (const [_sessionId, session] of this.activeSessions) {
-      if (session.camera.hasPhotoPendingRequest(requestId)) {
-        return session;
-      }
-    }
-    return;
-  }
 }
 
 class TpaServer extends AppServer {
@@ -5511,6 +5550,8 @@ export {
   isValidLanguageCode,
   isVad,
   isUpdate,
+  isUdpUnregister,
+  isUdpRegister,
   isStreamStatusCheckResponse,
   isStreamCategory,
   isStopWebhookRequest,
@@ -5638,4 +5679,4 @@ export {
   AnimationUtils
 };
 
-//# debugId=5178B6743C1469D964756E2164756E21
+//# debugId=82AABDD8D6AA68F464756E2164756E21