@mentra/sdk 2.0.0 → 2.0.2

package/README.md

@@ -74,7 +74,7 @@ We are going to use ngrok to expose your local app to the internet. This is usef
      ```
      PORT=3000
      PACKAGE_NAME=com.yourName.yourAppName
-     AUGMENTOS_API_KEY=your_api_key_from_console
+     MENTRAOS_API_KEY=your_api_key_from_console
      ```
    * Make sure the `PACKAGE_NAME` matches what you registered in the MentraOS Console
    * Get your `API_KEY` from the MentraOS Developer Console

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

@@ -1,7 +1,7 @@
 /**
  * 🚀 App Server Module
  *
- * Creates and manages a server for Third Party Apps (Apps) in the AugmentOS ecosystem.
+ * Creates and manages a server for Third Party Apps (Apps) in the MentraOS ecosystem.
  * Handles webhook endpoints, session management, and cleanup.
  */
 import { type Express } from 'express';
@@ -24,7 +24,7 @@ import { Logger } from 'pino';
 export interface AppServerConfig {
     /** 📦 Unique identifier for your App (e.g., 'org.company.appname') must match what you specified at https://console.mentra.glass */
     packageName: string;
-    /** 🔑 API key for authentication with AugmentOS Cloud */
+    /** 🔑 API key for authentication with MentraOS Cloud */
     apiKey: string;
     /** 🌐 Port number for the server (default: 7010) */
     port?: number;
@@ -50,7 +50,7 @@ export interface AppServerConfig {
  *
  * Base class for creating App servers. Handles:
  * - 🔄 Session lifecycle management
- * - 📡 Webhook endpoints for AugmentOS Cloud
+ * - 📡 Webhook endpoints for MentraOS Cloud
  * - 📂 Static file serving
  * - ❤️ Health checks
  * - 🧹 Cleanup on shutdown
@@ -110,11 +110,11 @@ export declare class AppServer {
     protected onStop(sessionId: string, userId: string, reason: string): Promise<void>;
     /**
      * 🛠️ Tool Call Handler
-     * Override this method to handle tool calls from AugmentOS Cloud.
+     * Override this method to handle tool calls from MentraOS Cloud.
      * This is where you implement your app's tool functionality.
      *
      * @param toolCall - The tool call request containing tool details and parameters
-     * @returns Optional string response that will be sent back to AugmentOS Cloud
+     * @returns Optional string response that will be sent back to MentraOS Cloud
      */
     protected onToolCall(toolCall: ToolCall): Promise<string | undefined>;
     /**
@@ -148,12 +148,12 @@ export declare class AppServer {
     protected addCleanupHandler(handler: () => void): void;
     /**
      * 🎯 Setup Webhook Endpoint
-     * Creates the webhook endpoint that AugmentOS Cloud calls to start new sessions.
+     * Creates the webhook endpoint that MentraOS Cloud calls to start new sessions.
      */
     private setupWebhook;
     /**
      * 🛠️ Setup Tool Call Endpoint
-     * Creates a /tool endpoint for handling tool calls from AugmentOS Cloud.
+     * Creates a /tool endpoint for handling tool calls from MentraOS Cloud.
      */
     private setupToolCallEndpoint;
     /**
@@ -171,7 +171,7 @@ export declare class AppServer {
     private setupHealthCheck;
     /**
      * ⚙️ Setup Settings Endpoint
-     * Creates a /settings endpoint that the AugmentOS Cloud can use to update settings.
+     * Creates a /settings endpoint that the MentraOS Cloud can use to update settings.
      */
     private setupSettingsEndpoint;
     /**

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":"AAAA;;;;;GAKG;AACH,OAAgB,EAAE,KAAK,OAAO,EAAE,MAAM,SAAS,CAAC;AAEhD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,OAAO,EAQL,QAAQ,EACT,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAI9B;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,eAAe;IAC9B,oIAAoI;IACpI,WAAW,EAAE,MAAM,CAAC;IACpB,yDAAyD;IACzD,MAAM,EAAE,MAAM,CAAC;IACf,oDAAoD;IACpD,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,+FAA+F;IAC/F,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IAE3B,iEAAiE;IACjE,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gDAAgD;IAChD,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,qBAAa,SAAS;IAYR,OAAO,CAAC,MAAM;IAX1B,2BAA2B;IAC3B,OAAO,CAAC,GAAG,CAAU;IACrB,+CAA+C;IAC/C,OAAO,CAAC,cAAc,CAAiC;IACvD,mDAAmD;IACnD,OAAO,CAAC,eAAe,CAAyB;IAChD,gDAAgD;IAChD,OAAO,CAAC,eAAe,CAAuB;IAE9C,SAAgB,MAAM,EAAE,MAAM,CAAC;gBAEX,MAAM,EAAE,eAAe;IAuCpC,aAAa,IAAI,OAAO;IAI/B;;;;;;;;OAQG;cACa,SAAS,CAAC,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMhG;;;;;;;;OAQG;cACa,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAWxF;;;;;;;OAOG;cACa,UAAU,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAM3E;;;;;OAKG;IACI,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAY7B;;;OAGG;IACI,IAAI,IAAI,IAAI;IAMnB;;;;;;;;KAQC;IACD,SAAS,CAAC,aAAa,CACrB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAChB,MAAM;IAYT;;;;;OAKG;IACH,SAAS,CAAC,iBAAiB,CAAC,OAAO,EAAE,MAAM,IAAI,GAAG,IAAI;IAItD;;;OAGG;IACH,OAAO,CAAC,YAAY;IAoCpB;;;OAGG;IACH,OAAO,CAAC,qBAAqB;IA2B7B;;OAEG;YACW,oBAAoB;IA6DlC;;OAEG;YACW,iBAAiB;IAgB/B;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IAYxB;;;OAGG;IACH,OAAO,CAAC,qBAAqB;IAyD7B;;;OAGG;IACH,OAAO,CAAC,cAAc;IAQtB;;;OAGG;IACH,OAAO,CAAC,aAAa;IAKrB;;;OAGG;IACH,OAAO,CAAC,OAAO;CAWhB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/app/server/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAgB,EAAE,KAAK,OAAO,EAAE,MAAM,SAAS,CAAC;AAEhD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,OAAO,EAQL,QAAQ,EACT,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAI9B;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,eAAe;IAC9B,oIAAoI;IACpI,WAAW,EAAE,MAAM,CAAC;IACpB,wDAAwD;IACxD,MAAM,EAAE,MAAM,CAAC;IACf,oDAAoD;IACpD,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,+FAA+F;IAC/F,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IAE3B,iEAAiE;IACjE,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gDAAgD;IAChD,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,qBAAa,SAAS;IAYR,OAAO,CAAC,MAAM;IAX1B,2BAA2B;IAC3B,OAAO,CAAC,GAAG,CAAU;IACrB,+CAA+C;IAC/C,OAAO,CAAC,cAAc,CAAiC;IACvD,mDAAmD;IACnD,OAAO,CAAC,eAAe,CAAyB;IAChD,gDAAgD;IAChD,OAAO,CAAC,eAAe,CAAuB;IAE9C,SAAgB,MAAM,EAAE,MAAM,CAAC;gBAEX,MAAM,EAAE,eAAe;IAuCpC,aAAa,IAAI,OAAO;IAI/B;;;;;;;;OAQG;cACa,SAAS,CAAC,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMhG;;;;;;;;OAQG;cACa,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAWxF;;;;;;;OAOG;cACa,UAAU,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAM3E;;;;;OAKG;IACI,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAY7B;;;OAGG;IACI,IAAI,IAAI,IAAI;IAMnB;;;;;;;;KAQC;IACD,SAAS,CAAC,aAAa,CACrB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAChB,MAAM;IAYT;;;;;OAKG;IACH,SAAS,CAAC,iBAAiB,CAAC,OAAO,EAAE,MAAM,IAAI,GAAG,IAAI;IAItD;;;OAGG;IACH,OAAO,CAAC,YAAY;IAoCpB;;;OAGG;IACH,OAAO,CAAC,qBAAqB;IA2B7B;;OAEG;YACW,oBAAoB;IA6DlC;;OAEG;YACW,iBAAiB;IAgB/B;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IAYxB;;;OAGG;IACH,OAAO,CAAC,qBAAqB;IAyD7B;;;OAGG;IACH,OAAO,CAAC,cAAc;IAQtB;;;OAGG;IACH,OAAO,CAAC,aAAa;IAKrB;;;OAGG;IACH,OAAO,CAAC,OAAO;CAWhB"}

package/dist/app/server/index.js

@@ -7,7 +7,7 @@ exports.AppServer = void 0;
 /**
  * 🚀 App Server Module
  *
- * Creates and manages a server for Third Party Apps (Apps) in the AugmentOS ecosystem.
+ * Creates and manages a server for Third Party Apps (Apps) in the MentraOS ecosystem.
  * Handles webhook endpoints, session management, and cleanup.
  */
 const express_1 = __importDefault(require("express"));
@@ -21,7 +21,7 @@ const logger_1 = require("../../logging/logger");
  *
  * Base class for creating App servers. Handles:
  * - 🔄 Session lifecycle management
- * - 📡 Webhook endpoints for AugmentOS Cloud
+ * - 📡 Webhook endpoints for MentraOS Cloud
  * - 📂 Static file serving
  * - ❤️ Health checks
  * - 🧹 Cleanup on shutdown
@@ -123,11 +123,11 @@ class AppServer {
     }
     /**
      * 🛠️ Tool Call Handler
-     * Override this method to handle tool calls from AugmentOS Cloud.
+     * Override this method to handle tool calls from MentraOS Cloud.
      * This is where you implement your app's tool functionality.
      *
      * @param toolCall - The tool call request containing tool details and parameters
-     * @returns Optional string response that will be sent back to AugmentOS Cloud
+     * @returns Optional string response that will be sent back to MentraOS Cloud
      */
     async onToolCall(toolCall) {
         this.logger.debug(`Tool call received: ${toolCall.toolId}`);
@@ -188,7 +188,7 @@ class AppServer {
     }
     /**
      * 🎯 Setup Webhook Endpoint
-     * Creates the webhook endpoint that AugmentOS Cloud calls to start new sessions.
+     * Creates the webhook endpoint that MentraOS Cloud calls to start new sessions.
      */
     setupWebhook() {
         if (!this.config.webhookPath) {
@@ -226,7 +226,7 @@ class AppServer {
     }
     /**
      * 🛠️ Setup Tool Call Endpoint
-     * Creates a /tool endpoint for handling tool calls from AugmentOS Cloud.
+     * Creates a /tool endpoint for handling tool calls from MentraOS Cloud.
      */
     setupToolCallEndpoint() {
         this.app.post('/tool', async (req, res) => {
@@ -259,13 +259,13 @@ class AppServer {
      * Handle a session request webhook
      */
     async handleSessionRequest(request, res) {
-        const { sessionId, userId, augmentOSWebsocketUrl } = request;
+        const { sessionId, userId, mentraOSWebsocketUrl } = request;
         this.logger.info({ userId }, `🗣️ Received session request for user ${userId}, session ${sessionId}\n\n`);
         // Create new App session
         const session = new index_1.AppSession({
             packageName: this.config.packageName,
             apiKey: this.config.apiKey,
-            augmentOSWebsocketUrl, // The websocket URL for the specific AugmentOS server that this userSession is connecting to.
+            mentraOSWebsocketUrl, // The websocket URL for the specific MentraOS server that this userSession is connecting to.
             appServer: this,
             userId,
         });
@@ -347,7 +347,7 @@ class AppServer {
     }
     /**
      * ⚙️ Setup Settings Endpoint
-     * Creates a /settings endpoint that the AugmentOS Cloud can use to update settings.
+     * Creates a /settings endpoint that the MentraOS Cloud can use to update settings.
      */
     setupSettingsEndpoint() {
         this.app.post('/settings', async (req, res) => {

package/dist/app/session/api-client.d.ts

@@ -1,7 +1,7 @@
 /**
  * 🔌 API Client Module
  *
- * Provides HTTP API access to AugmentOS Cloud services.
+ * Provides HTTP API access to MentraOS Cloud services.
  * Automatically uses the correct server URL derived from the WebSocket URL.
  */
 /**
@@ -12,7 +12,7 @@
  */
 export declare function wsUrlToHttpUrl(wsUrl?: string): string | undefined;
 /**
- * API client class for making HTTP requests to AugmentOS Cloud
+ * API client class for making HTTP requests to MentraOS Cloud
  */
 export declare class ApiClient {
     private baseUrl;
@@ -39,7 +39,7 @@ export declare class ApiClient {
      */
     setUserId(userId: string): void;
     /**
-     * Fetch settings from AugmentOS Cloud
+     * Fetch settings from MentraOS Cloud
      *
      * @returns Promise resolving to settings array
      * @throws Error if client is not configured correctly or if request fails

package/dist/app/session/api-client.js

@@ -2,7 +2,7 @@
 /**
  * 🔌 API Client Module
  *
- * Provides HTTP API access to AugmentOS Cloud services.
+ * Provides HTTP API access to MentraOS Cloud services.
  * Automatically uses the correct server URL derived from the WebSocket URL.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
@@ -31,7 +31,7 @@ function wsUrlToHttpUrl(wsUrl) {
     }
 }
 /**
- * API client class for making HTTP requests to AugmentOS Cloud
+ * API client class for making HTTP requests to MentraOS Cloud
  */
 class ApiClient {
     /**
@@ -65,7 +65,7 @@ class ApiClient {
         this.userId = userId;
     }
     /**
-     * Fetch settings from AugmentOS Cloud
+     * Fetch settings from MentraOS Cloud
      *
      * @returns Promise resolving to settings array
      * @throws Error if client is not configured correctly or if request fails

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

@@ -22,10 +22,10 @@ import { AppServer } from '../server';
 export interface AppSessionConfig {
     /** 📦 Unique identifier for your App (e.g., 'org.company.appname') */
     packageName: string;
-    /** 🔑 API key for authentication with AugmentOS Cloud */
+    /** 🔑 API key for authentication with MentraOS Cloud */
     apiKey: string;
     /** 🔌 WebSocket server URL (default: 'ws://localhost:7002/app-ws') */
-    augmentOSWebsocketUrl?: string;
+    mentraOSWebsocketUrl?: string;
     /** 🔄 Automatically attempt to reconnect on disconnect (default: true) */
     autoReconnect?: boolean;
     /** 🔁 Maximum number of reconnection attempts (default: 3) */
@@ -38,7 +38,7 @@ export interface AppSessionConfig {
 /**
  * 🚀 App Session Implementation
  *
- * Manages a live connection between your App and AugmentOS Cloud.
+ * Manages a live connection between your App and MentraOS Cloud.
  * Provides interfaces for:
  * - 🎮 Event handling (transcription, head position, etc.)
  * - 📱 Display management in AR view
@@ -63,7 +63,7 @@ export interface AppSessionConfig {
  */
 export declare class AppSession {
     private config;
-    /** WebSocket connection to AugmentOS Cloud */
+    /** WebSocket connection to MentraOS Cloud */
     private ws;
     /** Current session identifier */
     private sessionId;
@@ -118,9 +118,7 @@ export declare class AppSession {
      */
     getPackageName(): string;
     /**
-     * 🎤 Listen for speech transcription events
-     * @param handler - Function to handle transcription data
-     * @returns Cleanup function to remove the handler
+     * @deprecated Use session.events.onTranscription() instead
      */
     onTranscription(handler: (data: TranscriptionData) => void): () => void;
     /**
@@ -129,6 +127,7 @@ export declare class AppSession {
      * @param handler - Function to handle transcription data
      * @returns Cleanup function to remove the handler
      * @throws Error if language code is invalid
+     * @deprecated Use session.events.onTranscriptionForLanguage() instead
      */
     onTranscriptionForLanguage(language: string, handler: (data: TranscriptionData) => void): () => void;
     /**
@@ -138,36 +137,42 @@ export declare class AppSession {
      * @param handler - Function to handle translation data
      * @returns Cleanup function to remove the handler
      * @throws Error if language codes are invalid
+     * @deprecated Use session.events.onTranslationForLanguage() instead
      */
     onTranslationForLanguage(sourceLanguage: string, targetLanguage: string, handler: (data: TranslationData) => void): () => void;
     /**
      * 👤 Listen for head position changes
      * @param handler - Function to handle head position updates
      * @returns Cleanup function to remove the handler
+     * @deprecated Use session.events.onHeadPosition() instead
      */
     onHeadPosition(handler: (data: HeadPosition) => void): () => void;
     /**
      * 🔘 Listen for hardware button press events
      * @param handler - Function to handle button events
      * @returns Cleanup function to remove the handler
+     * @deprecated Use session.events.onButtonPress() instead
      */
     onButtonPress(handler: (data: ButtonPress) => void): () => void;
     /**
      * 📱 Listen for phone notification events
      * @param handler - Function to handle notifications
      * @returns Cleanup function to remove the handler
+     * @deprecated Use session.events.onPhoneNotifications() instead
      */
     onPhoneNotifications(handler: (data: PhoneNotification) => void): () => void;
     /**
      * 📡 Listen for VPS coordinates updates
      * @param handler - Function to handle VPS coordinates
      * @returns Cleanup function to remove the handler
+     * @deprecated Use session.events.onVpsCoordinates() instead
      */
     onVpsCoordinates(handler: (data: VpsCoordinates) => void): () => void;
     /**
      * 📸 Listen for photo responses
      * @param handler - Function to handle photo response data
      * @returns Cleanup function to remove the handler
+     * @deprecated Use session.events.onPhotoTaken() instead
      */
     onPhotoTaken(handler: (data: PhotoTaken) => void): () => void;
     /**
@@ -187,13 +192,13 @@ export declare class AppSession {
      */
     on<T extends ExtendedStreamType>(event: T, handler: (data: EventData<T>) => void): () => void;
     /**
-     * 🚀 Connect to AugmentOS Cloud
+     * 🚀 Connect to MentraOS Cloud
      * @param sessionId - Unique session identifier
      * @returns Promise that resolves when connected
      */
     connect(sessionId: string): Promise<void>;
     /**
-     * 👋 Disconnect from AugmentOS Cloud
+     * 👋 Disconnect from MentraOS Cloud
      */
     disconnect(): void;
     /**

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

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

package/dist/app/session/index.js

@@ -7,7 +7,7 @@ exports.AppSession = void 0;
 /**
  * 🎯 App Session Module
  *
- * Manages an active Third Party App session with AugmentOS Cloud.
+ * Manages an active Third Party App session with MentraOS Cloud.
  * Handles real-time communication, event subscriptions, and display management.
  */
 const ws_1 = require("ws");
@@ -32,7 +32,7 @@ const APP_TO_APP_EVENT_TYPES = [
 /**
  * 🚀 App Session Implementation
  *
- * Manages a live connection between your App and AugmentOS Cloud.
+ * Manages a live connection between your App and MentraOS Cloud.
  * Provides interfaces for:
  * - 🎮 Event handling (transcription, head position, etc.)
  * - 📱 Display management in AR view
@@ -58,7 +58,7 @@ const APP_TO_APP_EVENT_TYPES = [
 class AppSession {
     constructor(config) {
         this.config = config;
-        /** WebSocket connection to AugmentOS Cloud */
+        /** WebSocket connection to MentraOS Cloud */
         this.ws = null;
         /** Current session identifier */
         this.sessionId = null;
@@ -88,7 +88,7 @@ class AppSession {
         this.appEvents = new events_2.default();
         // Set defaults and merge with provided config
         this.config = {
-            augmentOSWebsocketUrl: `ws://localhost:8002/app-ws`, // Use localhost as default
+            mentraOSWebsocketUrl: `ws://localhost:8002/app-ws`, // Use localhost as default
             autoReconnect: true, // Enable auto-reconnection by default for better reliability
             maxReconnectAttempts: 3, // Default to 3 reconnection attempts for better resilience
             reconnectDelay: 1000, // Start with 1 second delay (uses exponential backoff)
@@ -98,45 +98,45 @@ class AppSession {
         this.logger = this.appServer.logger.child({ userId: this.config.userId, service: 'app-session' });
         this.userId = this.config.userId;
         // Make sure the URL is correctly formatted to prevent double protocol issues
-        if (this.config.augmentOSWebsocketUrl) {
+        if (this.config.mentraOSWebsocketUrl) {
             try {
-                const url = new URL(this.config.augmentOSWebsocketUrl);
+                const url = new URL(this.config.mentraOSWebsocketUrl);
                 if (!['ws:', 'wss:'].includes(url.protocol)) {
                     // Fix URLs with incorrect protocol (e.g., 'ws://http://host')
-                    const fixedUrl = this.config.augmentOSWebsocketUrl.replace(/^ws:\/\/http:\/\//, 'ws://');
-                    this.config.augmentOSWebsocketUrl = fixedUrl;
+                    const fixedUrl = this.config.mentraOSWebsocketUrl.replace(/^ws:\/\/http:\/\//, 'ws://');
+                    this.config.mentraOSWebsocketUrl = fixedUrl;
                     this.logger.warn(`⚠️ [${this.config.packageName}] Fixed malformed WebSocket URL: ${fixedUrl}`);
                 }
             }
             catch (error) {
-                this.logger.error(error, `⚠️ [${this.config.packageName}] Invalid WebSocket URL format: ${this.config.augmentOSWebsocketUrl}`);
+                this.logger.error(error, `⚠️ [${this.config.packageName}] Invalid WebSocket URL format: ${this.config.mentraOSWebsocketUrl}`);
             }
         }
         // Log initialization
         this.logger.debug(`🚀 [${this.config.packageName}] App Session initialized`);
-        this.logger.debug(`🚀 [${this.config.packageName}] WebSocket URL: ${this.config.augmentOSWebsocketUrl}`);
+        this.logger.debug(`🚀 [${this.config.packageName}] WebSocket URL: ${this.config.mentraOSWebsocketUrl}`);
         // Validate URL format - give early warning for obvious issues
         // Check URL format but handle undefined case
-        if (this.config.augmentOSWebsocketUrl) {
+        if (this.config.mentraOSWebsocketUrl) {
             try {
-                const url = new URL(this.config.augmentOSWebsocketUrl);
+                const url = new URL(this.config.mentraOSWebsocketUrl);
                 if (!['ws:', 'wss:'].includes(url.protocol)) {
                     this.logger.error({ config: this.config }, `⚠️ [${this.config.packageName}] Invalid WebSocket URL protocol: ${url.protocol}. Should be ws: or wss:`);
                 }
             }
             catch (error) {
-                this.logger.error(error, `⚠️ [${this.config.packageName}] Invalid WebSocket URL format: ${this.config.augmentOSWebsocketUrl}`);
+                this.logger.error(error, `⚠️ [${this.config.packageName}] Invalid WebSocket URL format: ${this.config.mentraOSWebsocketUrl}`);
             }
         }
         this.events = new events_1.EventManager(this.subscribe.bind(this), this.unsubscribe.bind(this));
         this.layouts = new layouts_1.LayoutManager(config.packageName, this.send.bind(this));
-        // Initialize settings manager with all necessary parameters, including subscribeFn for AugmentOS settings
-        this.settings = new settings_1.SettingsManager(this.settingsData, this.config.packageName, this.config.augmentOSWebsocketUrl, this.sessionId ?? undefined, async (streams) => {
+        // Initialize settings manager with all necessary parameters, including subscribeFn for MentraOS settings
+        this.settings = new settings_1.SettingsManager(this.settingsData, this.config.packageName, this.config.mentraOSWebsocketUrl, this.sessionId ?? undefined, async (streams) => {
             this.logger.debug(`[AppSession] subscribeFn called for streams:`, streams);
             streams.forEach((stream) => {
                 if (!this.subscriptions.has(stream)) {
                     this.subscriptions.add(stream);
-                    this.logger.debug(`[AppSession] Auto-subscribed to stream '${stream}' for AugmentOS setting.`);
+                    this.logger.debug(`[AppSession] Auto-subscribed to stream '${stream}' for MentraOS setting.`);
                 }
                 else {
                     this.logger.debug(`[AppSession] Already subscribed to stream '${stream}'.`);
@@ -145,7 +145,7 @@ class AppSession {
             this.logger.debug(`[AppSession] Current subscriptions after subscribeFn:`, Array.from(this.subscriptions));
             if (this.ws?.readyState === 1) {
                 this.updateSubscriptions();
-                this.logger.debug(`[AppSession] Sent updated subscriptions to cloud after auto-subscribing to AugmentOS setting.`);
+                this.logger.debug(`[AppSession] Sent updated subscriptions to cloud after auto-subscribing to MentraOS setting.`);
             }
             else {
                 this.logger.debug(`[AppSession] WebSocket not open, will send subscriptions when connected.`);
@@ -177,9 +177,7 @@ class AppSession {
     // 🎮 Direct Event Handling Interface
     // =====================================
     /**
-     * 🎤 Listen for speech transcription events
-     * @param handler - Function to handle transcription data
-     * @returns Cleanup function to remove the handler
+     * @deprecated Use session.events.onTranscription() instead
      */
     onTranscription(handler) {
         return this.events.onTranscription(handler);
@@ -190,6 +188,7 @@ class AppSession {
      * @param handler - Function to handle transcription data
      * @returns Cleanup function to remove the handler
      * @throws Error if language code is invalid
+     * @deprecated Use session.events.onTranscriptionForLanguage() instead
      */
     onTranscriptionForLanguage(language, handler) {
         return this.events.onTranscriptionForLanguage(language, handler);
@@ -201,6 +200,7 @@ class AppSession {
      * @param handler - Function to handle translation data
      * @returns Cleanup function to remove the handler
      * @throws Error if language codes are invalid
+     * @deprecated Use session.events.onTranslationForLanguage() instead
      */
     onTranslationForLanguage(sourceLanguage, targetLanguage, handler) {
         return this.events.ontranslationForLanguage(sourceLanguage, targetLanguage, handler);
@@ -209,6 +209,7 @@ class AppSession {
      * 👤 Listen for head position changes
      * @param handler - Function to handle head position updates
      * @returns Cleanup function to remove the handler
+     * @deprecated Use session.events.onHeadPosition() instead
      */
     onHeadPosition(handler) {
         return this.events.onHeadPosition(handler);
@@ -217,6 +218,7 @@ class AppSession {
      * 🔘 Listen for hardware button press events
      * @param handler - Function to handle button events
      * @returns Cleanup function to remove the handler
+     * @deprecated Use session.events.onButtonPress() instead
      */
     onButtonPress(handler) {
         return this.events.onButtonPress(handler);
@@ -225,6 +227,7 @@ class AppSession {
      * 📱 Listen for phone notification events
      * @param handler - Function to handle notifications
      * @returns Cleanup function to remove the handler
+     * @deprecated Use session.events.onPhoneNotifications() instead
      */
     onPhoneNotifications(handler) {
         return this.events.onPhoneNotifications(handler);
@@ -233,6 +236,7 @@ class AppSession {
      * 📡 Listen for VPS coordinates updates
      * @param handler - Function to handle VPS coordinates
      * @returns Cleanup function to remove the handler
+     * @deprecated Use session.events.onVpsCoordinates() instead
      */
     onVpsCoordinates(handler) {
         this.subscribe(types_1.StreamType.VPS_COORDINATES);
@@ -242,6 +246,7 @@ class AppSession {
      * 📸 Listen for photo responses
      * @param handler - Function to handle photo response data
      * @returns Cleanup function to remove the handler
+     * @deprecated Use session.events.onPhotoTaken() instead
      */
     onPhotoTaken(handler) {
         this.subscribe(types_1.StreamType.PHOTO_TAKEN);
@@ -290,7 +295,7 @@ class AppSession {
     // 🔌 Connection Management
     // =====================================
     /**
-     * 🚀 Connect to AugmentOS Cloud
+     * 🚀 Connect to MentraOS Cloud
      * @param sessionId - Unique session identifier
      * @returns Promise that resolves when connected
      */
@@ -298,7 +303,7 @@ class AppSession {
         this.sessionId = sessionId;
         // Configure settings API client with the WebSocket URL and session ID
         // This allows settings to be fetched from the correct server
-        this.settings.configureApiClient(this.config.packageName, this.config.augmentOSWebsocketUrl || '', sessionId);
+        this.settings.configureApiClient(this.config.packageName, this.config.mentraOSWebsocketUrl || '', sessionId);
         // Update the sessionId in the streaming module
         if (this.streaming) {
             Object.defineProperty(this.streaming, 'sessionId', { value: sessionId });
@@ -314,15 +319,15 @@ class AppSession {
                     this.ws = null;
                 }
                 // Validate WebSocket URL before attempting connection
-                if (!this.config.augmentOSWebsocketUrl) {
+                if (!this.config.mentraOSWebsocketUrl) {
                     this.logger.error('WebSocket URL is missing or undefined');
                     reject(new Error('WebSocket URL is required'));
                     return;
                 }
                 // Add debug logging for connection attempts
-                this.logger.info(`🔌🔌🔌 [${this.config.packageName}] Attempting to connect to: ${this.config.augmentOSWebsocketUrl} for session ${this.sessionId}`);
+                this.logger.info(`🔌🔌🔌 [${this.config.packageName}] Attempting to connect to: ${this.config.mentraOSWebsocketUrl} for session ${this.sessionId}`);
                 // Create connection with error handling
-                this.ws = new ws_1.WebSocket(this.config.augmentOSWebsocketUrl);
+                this.ws = new ws_1.WebSocket(this.config.mentraOSWebsocketUrl);
                 // Track WebSocket for automatic cleanup
                 this.resources.track(() => {
                     if (this.ws && this.ws.readyState !== 3) { // 3 = CLOSED
@@ -513,7 +518,7 @@ class AppSession {
         });
     }
     /**
-     * 👋 Disconnect from AugmentOS Cloud
+     * 👋 Disconnect from MentraOS Cloud
      */
     disconnect() {
         // Use the resource tracker to clean up everything
@@ -668,13 +673,13 @@ class AppSession {
      * @returns The WebSocket server URL used by this session
      */
     getServerUrl() {
-        return this.config.augmentOSWebsocketUrl;
+        return this.config.mentraOSWebsocketUrl;
     }
     getHttpsServerUrl() {
-        if (!this.config.augmentOSWebsocketUrl) {
+        if (!this.config.mentraOSWebsocketUrl) {
             return undefined;
         }
-        return AppSession.convertToHttps(this.config.augmentOSWebsocketUrl);
+        return AppSession.convertToHttps(this.config.mentraOSWebsocketUrl);
     }
     static convertToHttps(rawUrl) {
         if (!rawUrl)
@@ -752,14 +757,14 @@ class AppSession {
                     }
                     // Update the settings manager with the new settings
                     this.settings.updateSettings(this.settingsData);
-                    // Handle AugmentOS system settings if provided
-                    this.logger.debug(`[AppSession] CONNECTION_ACK augmentosSettings:`, message.augmentosSettings);
-                    if (message.augmentosSettings) {
-                        this.logger.info(`[AppSession] Calling updateAugmentosSettings with:`, message.augmentosSettings);
-                        this.settings.updateAugmentosSettings(message.augmentosSettings);
+                    // Handle MentraOS system settings if provided
+                    this.logger.debug(`[AppSession] CONNECTION_ACK mentraosSettings:`, message.mentraosSettings);
+                    if (message.mentraosSettings) {
+                        this.logger.info(`[AppSession] Calling updatementraosSettings with:`, message.mentraosSettings);
+                        this.settings.updateMentraosSettings(message.mentraosSettings);
                     }
                     else {
-                        this.logger.warn(`[AppSession] CONNECTION_ACK message missing augmentosSettings field`);
+                        this.logger.warn(`[AppSession] CONNECTION_ACK message missing mentraosSettings field`);
                     }
                     // Handle device capabilities if provided
                     if (message.capabilities) {
@@ -834,10 +839,10 @@ class AppSession {
                     const changes = this.settings.updateSettings(this.settingsData);
                     // Emit settings update event (for backwards compatibility)
                     this.events.emit('settings_update', this.settingsData);
-                    // --- AugmentOS settings update logic ---
-                    // If the message.settings looks like AugmentOS settings (object with known keys), update augmentosSettings
+                    // --- MentraOS settings update logic ---
+                    // If the message.settings looks like MentraOS settings (object with known keys), update mentraosSettings
                     if (message.settings && typeof message.settings === 'object') {
-                        this.settings.updateAugmentosSettings(message.settings);
+                        this.settings.updateMentraosSettings(message.settings);
                     }
                     // Check if we should update subscriptions
                     if (this.shouldUpdateSubscriptionsOnSettingsChange) {
@@ -918,18 +923,18 @@ class AppSession {
                     }
                 }
                 else if (message.type === 'augmentos_settings_update') {
-                    const augmentosMsg = message;
-                    if (augmentosMsg.settings && typeof augmentosMsg.settings === 'object') {
-                        this.settings.updateAugmentosSettings(augmentosMsg.settings);
+                    const mentraosMsg = message;
+                    if (mentraosMsg.settings && typeof mentraosMsg.settings === 'object') {
+                        this.settings.updateMentraosSettings(mentraosMsg.settings);
                     }
                 }
                 // Handle 'connection_error' as a specific case if cloud sends this string literal
                 else if (message.type === 'connection_error') {
                     // Treat 'connection_error' (string literal) like AppConnectionError
                     // This handles cases where the cloud might send the type as a direct string
-                    // instead of the enum's 'app_connection_error' value.
+                    // instead of the enum's 'tpa_connection_error' value.
                     const errorMessage = message.message || 'Unknown connection error (type: connection_error)';
-                    this.logger.warn(`Received 'connection_error' type directly. Consider aligning cloud to send 'app_connection_error'. Message: ${errorMessage}`);
+                    this.logger.warn(`Received 'connection_error' type directly. Consider aligning cloud to send 'tpa_connection_error'. Message: ${errorMessage}`);
                     this.events.emit('error', new Error(errorMessage));
                 }
                 else if (message.type === 'permission_error') {

package/dist/app/session/layouts.d.ts

@@ -23,7 +23,7 @@ export declare class LayoutManager {
      * 🎯 Creates a new LayoutManager instance
      *
      * @param packageName - App package identifier
-     * @param sendMessage - Function to send display requests to AugmentOS
+     * @param sendMessage - Function to send display requests to MentraOS
      */
     constructor(packageName: string, sendMessage: (message: DisplayRequest) => void);
     /**