@mentra/sdk 1.1.19 → 2.0.0

package/dist/{tpa → app}/session/index.js

@@ -3,9 +3,9 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TpaSession = void 0;
+exports.AppSession = void 0;
 /**
- * 🎯 TPA Session Module
+ * 🎯 App Session Module
  *
  * Manages an active Third Party App session with AugmentOS Cloud.
  * Handles real-time communication, event subscriptions, and display management.
@@ -19,20 +19,20 @@ const resource_tracker_1 = require("../../utils/resource-tracker");
 const types_1 = require("../../types");
 const axios_1 = __importDefault(require("axios"));
 const events_2 = __importDefault(require("events"));
-// Import the cloud-to-tpa specific type guards
-const cloud_to_tpa_1 = require("../../types/messages/cloud-to-tpa");
+// Import the cloud-to-app specific type guards
+const cloud_to_app_1 = require("../../types/messages/cloud-to-app");
 // List of event types that should never be subscribed to as streams
-const TPA_TO_TPA_EVENT_TYPES = [
-    'tpa_message_received',
-    'tpa_user_joined',
-    'tpa_user_left',
-    'tpa_room_updated',
-    'tpa_direct_message_response'
+const APP_TO_APP_EVENT_TYPES = [
+    'app_message_received',
+    'app_user_joined',
+    'app_user_left',
+    'app_room_updated',
+    'app_direct_message_response'
 ];
 /**
- * 🚀 TPA Session Implementation
+ * 🚀 App Session Implementation
  *
- * Manages a live connection between your TPA and AugmentOS Cloud.
+ * Manages a live connection between your App and AugmentOS Cloud.
  * Provides interfaces for:
  * - 🎮 Event handling (transcription, head position, etc.)
  * - 📱 Display management in AR view
@@ -41,7 +41,7 @@ const TPA_TO_TPA_EVENT_TYPES = [
  *
  * @example
  * ```typescript
- * const session = new TpaSession({
+ * const session = new AppSession({
  *   packageName: 'org.example.myapp',
  *   apiKey: 'your_api_key'
  * });
@@ -55,7 +55,7 @@ const TPA_TO_TPA_EVENT_TYPES = [
  * await session.connect('session_123');
  * ```
  */
-class TpaSession {
+class AppSession {
     constructor(config) {
         this.config = config;
         /** WebSocket connection to AugmentOS Cloud */
@@ -70,8 +70,8 @@ class TpaSession {
         this.resources = new resource_tracker_1.ResourceTracker();
         /** Internal settings storage - use public settings API instead */
         this.settingsData = [];
-        /** TPA configuration loaded from tpa_config.json */
-        this.tpaConfig = null;
+        /** App configuration loaded from app_config.json */
+        this.appConfig = null;
         /** Whether to update subscriptions when settings change */
         this.shouldUpdateSubscriptionsOnSettingsChange = false;
         /** Settings that should trigger subscription updates when changed */
@@ -82,18 +82,20 @@ class TpaSession {
         this.pendingUserDiscoveryRequests = new Map();
         /** Pending direct message requests waiting for responses */
         this.pendingDirectMessages = new Map();
-        /** Dedicated emitter for TPA-to-TPA events */
-        this.tpaEvents = new events_2.default();
+        /** 🔧 Device capabilities available for this session */
+        this.capabilities = null;
+        /** Dedicated emitter for App-to-App events */
+        this.appEvents = new events_2.default();
         // Set defaults and merge with provided config
         this.config = {
-            augmentOSWebsocketUrl: `ws://localhost:8002/tpa-ws`, // Use localhost as default
+            augmentOSWebsocketUrl: `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)
             ...config
         };
-        this.tpaServer = this.config.tpaServer;
-        this.logger = this.tpaServer.logger.child({ userId: this.config.userId, service: 'tpa-session' });
+        this.appServer = this.config.appServer;
+        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) {
@@ -111,7 +113,7 @@ class TpaSession {
             }
         }
         // Log initialization
-        this.logger.debug(`🚀 [${this.config.packageName}] TPA Session initialized`);
+        this.logger.debug(`🚀 [${this.config.packageName}] App Session initialized`);
         this.logger.debug(`🚀 [${this.config.packageName}] WebSocket URL: ${this.config.augmentOSWebsocketUrl}`);
         // Validate URL format - give early warning for obvious issues
         // Check URL format but handle undefined case
@@ -130,23 +132,23 @@ class TpaSession {
         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) => {
-            this.logger.debug(`[TpaSession] subscribeFn called for streams:`, 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(`[TpaSession] Auto-subscribed to stream '${stream}' for AugmentOS setting.`);
+                    this.logger.debug(`[AppSession] Auto-subscribed to stream '${stream}' for AugmentOS setting.`);
                 }
                 else {
-                    this.logger.debug(`[TpaSession] Already subscribed to stream '${stream}'.`);
+                    this.logger.debug(`[AppSession] Already subscribed to stream '${stream}'.`);
                 }
             });
-            this.logger.debug(`[TpaSession] Current subscriptions after subscribeFn:`, Array.from(this.subscriptions));
+            this.logger.debug(`[AppSession] Current subscriptions after subscribeFn:`, Array.from(this.subscriptions));
             if (this.ws?.readyState === 1) {
                 this.updateSubscriptions();
-                this.logger.debug(`[TpaSession] Sent updated subscriptions to cloud after auto-subscribing to AugmentOS setting.`);
+                this.logger.debug(`[AppSession] Sent updated subscriptions to cloud after auto-subscribing to AugmentOS setting.`);
             }
             else {
-                this.logger.debug(`[TpaSession] WebSocket not open, will send subscriptions when connected.`);
+                this.logger.debug(`[AppSession] WebSocket not open, will send subscriptions when connected.`);
             }
         });
         // Initialize dashboard API with this session instance
@@ -165,7 +167,7 @@ class TpaSession {
         return this.sessionId || 'unknown-session-id';
     }
     /**
-     * Get the package name for this TPA
+     * Get the package name for this App
      * @returns The package name
      */
     getPackageName() {
@@ -253,8 +255,8 @@ class TpaSession {
      * @param type - Type of event to subscribe to
      */
     subscribe(type) {
-        if (TPA_TO_TPA_EVENT_TYPES.includes(type)) {
-            this.logger.warn(`[TpaSession] Attempted to subscribe to TPA-to-TPA event type '${type}', which is not a valid stream. Use the event handler (e.g., onTpaMessage) instead.`);
+        if (APP_TO_APP_EVENT_TYPES.includes(type)) {
+            this.logger.warn(`[AppSession] Attempted to subscribe to App-to-App event type '${type}', which is not a valid stream. Use the event handler (e.g., onAppMessage) instead.`);
             return;
         }
         this.subscriptions.add(type);
@@ -267,8 +269,8 @@ class TpaSession {
      * @param type - Type of event to unsubscribe from
      */
     unsubscribe(type) {
-        if (TPA_TO_TPA_EVENT_TYPES.includes(type)) {
-            this.logger.warn(`[TpaSession] Attempted to unsubscribe from TPA-to-TPA event type '${type}', which is not a valid stream.`);
+        if (APP_TO_APP_EVENT_TYPES.includes(type)) {
+            this.logger.warn(`[AppSession] Attempted to unsubscribe from App-to-App event type '${type}', which is not a valid stream.`);
             return;
         }
         this.subscriptions.delete(type);
@@ -536,7 +538,7 @@ class TpaSession {
                 this.pendingPhotoRequests.set(requestId, { resolve, reject });
                 // Create photo request message
                 const message = {
-                    type: types_1.TpaToCloudMessageType.PHOTO_REQUEST,
+                    type: types_1.AppToCloudMessageType.PHOTO_REQUEST,
                     packageName: this.config.packageName,
                     sessionId: this.sessionId,
                     timestamp: new Date(),
@@ -578,7 +580,7 @@ class TpaSession {
     }
     /**
      * ⚙️ Configure settings-based subscription updates
-     * This allows TPAs to automatically update their subscriptions when certain settings change
+     * This allows Apps to automatically update their subscriptions when certain settings change
      * @param options Configuration options for settings-based subscriptions
      */
     setSubscriptionSettings(options) {
@@ -634,32 +636,32 @@ class TpaSession {
     }
     /**
      * 📝 Load configuration from a JSON file
-     * @param jsonData JSON string containing TPA configuration
+     * @param jsonData JSON string containing App configuration
      * @returns The loaded configuration
      * @throws Error if the configuration is invalid
      */
     loadConfigFromJson(jsonData) {
         try {
             const parsedConfig = JSON.parse(jsonData);
-            if ((0, types_1.validateTpaConfig)(parsedConfig)) {
-                this.tpaConfig = parsedConfig;
+            if ((0, types_1.validateAppConfig)(parsedConfig)) {
+                this.appConfig = parsedConfig;
                 return parsedConfig;
             }
             else {
-                throw new Error('Invalid TPA configuration format');
+                throw new Error('Invalid App configuration format');
             }
         }
         catch (error) {
             const errorMessage = error instanceof Error ? error.message : String(error);
-            throw new Error(`Failed to load TPA configuration: ${errorMessage}`);
+            throw new Error(`Failed to load App configuration: ${errorMessage}`);
         }
     }
     /**
-     * 📋 Get the loaded TPA configuration
-     * @returns The current TPA configuration or null if not loaded
+     * 📋 Get the loaded App configuration
+     * @returns The current App configuration or null if not loaded
      */
     getConfig() {
-        return this.tpaConfig;
+        return this.appConfig;
     }
     /**
      * 🔌 Get the WebSocket server URL for this session
@@ -672,28 +674,28 @@ class TpaSession {
         if (!this.config.augmentOSWebsocketUrl) {
             return undefined;
         }
-        return TpaSession.convertToHttps(this.config.augmentOSWebsocketUrl);
+        return AppSession.convertToHttps(this.config.augmentOSWebsocketUrl);
     }
     static convertToHttps(rawUrl) {
         if (!rawUrl)
             return '';
         // Remove ws:// or wss://
         let url = rawUrl.replace(/^wss?:\/\//, '');
-        // Remove trailing /tpa-ws
-        url = url.replace(/\/tpa-ws$/, '');
+        // Remove trailing /app-ws
+        url = url.replace(/\/app-ws$/, '');
         // Prepend https://
         return `https://${url}`;
     }
     /**
-     * 🔍 Get default settings from the TPA configuration
+     * 🔍 Get default settings from the App configuration
      * @returns Array of settings with default values
      * @throws Error if configuration is not loaded
      */
     getDefaultSettings() {
-        if (!this.tpaConfig) {
-            throw new Error('TPA configuration not loaded. Call loadConfigFromJson first.');
+        if (!this.appConfig) {
+            throw new Error('App configuration not loaded. Call loadConfigFromJson first.');
         }
-        return this.tpaConfig.settings
+        return this.appConfig.settings
             .filter((s) => s.type !== 'group')
             .map((s) => ({
             ...s,
@@ -706,9 +708,9 @@ class TpaSession {
      * @returns The setting schema or undefined if not found
      */
     getSettingSchema(key) {
-        if (!this.tpaConfig)
+        if (!this.appConfig)
             return undefined;
-        const setting = this.tpaConfig.settings.find((s) => s.type !== 'group' && 'key' in s && s.key === key);
+        const setting = this.appConfig.settings.find((s) => s.type !== 'group' && 'key' in s && s.key === key);
         return setting;
     }
     // =====================================
@@ -731,16 +733,16 @@ class TpaSession {
             }
             // Using type guards to determine message type and safely handle each case
             try {
-                if ((0, types_1.isTpaConnectionAck)(message)) {
+                if ((0, types_1.isAppConnectionAck)(message)) {
                     // Get settings from connection acknowledgment
                     const receivedSettings = message.settings || [];
                     this.settingsData = receivedSettings;
                     // Store config if provided
-                    if (message.config && (0, types_1.validateTpaConfig)(message.config)) {
-                        this.tpaConfig = message.config;
+                    if (message.config && (0, types_1.validateAppConfig)(message.config)) {
+                        this.appConfig = message.config;
                     }
                     // Use default settings from config if no settings were provided
-                    if (receivedSettings.length === 0 && this.tpaConfig) {
+                    if (receivedSettings.length === 0 && this.appConfig) {
                         try {
                             this.settingsData = this.getDefaultSettings();
                         }
@@ -751,13 +753,21 @@ class TpaSession {
                     // Update the settings manager with the new settings
                     this.settings.updateSettings(this.settingsData);
                     // Handle AugmentOS system settings if provided
-                    this.logger.debug(`[TpaSession] CONNECTION_ACK augmentosSettings:`, message.augmentosSettings);
+                    this.logger.debug(`[AppSession] CONNECTION_ACK augmentosSettings:`, message.augmentosSettings);
                     if (message.augmentosSettings) {
-                        this.logger.info(`[TpaSession] Calling updateAugmentosSettings with:`, message.augmentosSettings);
+                        this.logger.info(`[AppSession] Calling updateAugmentosSettings with:`, message.augmentosSettings);
                         this.settings.updateAugmentosSettings(message.augmentosSettings);
                     }
                     else {
-                        this.logger.warn(`[TpaSession] CONNECTION_ACK message missing augmentosSettings field`);
+                        this.logger.warn(`[AppSession] CONNECTION_ACK message missing augmentosSettings field`);
+                    }
+                    // Handle device capabilities if provided
+                    if (message.capabilities) {
+                        this.capabilities = message.capabilities;
+                        this.logger.info(`[AppSession] Device capabilities loaded for model: ${message.capabilities.modelName}`);
+                    }
+                    else {
+                        this.logger.debug(`[AppSession] No capabilities provided in CONNECTION_ACK`);
                     }
                     // Emit connected event with settings
                     this.events.emit('connected', this.settingsData);
@@ -768,8 +778,8 @@ class TpaSession {
                         this.updateSubscriptionsFromSettings();
                     }
                 }
-                else if ((0, types_1.isTpaConnectionError)(message) || message.type === 'connection_error') {
-                    // Handle both TPA-specific connection_error and standard connection_error
+                else if ((0, types_1.isAppConnectionError)(message) || message.type === 'connection_error') {
+                    // Handle both App-specific connection_error and standard connection_error
                     const errorMessage = message.message || 'Unknown connection error';
                     this.events.emit('error', new Error(errorMessage));
                 }
@@ -799,7 +809,7 @@ class TpaSession {
                         this.events.emit(messageStreamType, sanitizedData);
                     }
                 }
-                else if ((0, cloud_to_tpa_1.isPhotoResponse)(message)) {
+                else if ((0, cloud_to_app_1.isPhotoResponse)(message)) {
                     // Handle photo response by resolving the pending promise
                     if (this.pendingPhotoRequests.has(message.requestId)) {
                         const { resolve } = this.pendingPhotoRequests.get(message.requestId);
@@ -807,7 +817,7 @@ class TpaSession {
                         this.pendingPhotoRequests.delete(message.requestId);
                     }
                 }
-                else if ((0, cloud_to_tpa_1.isRtmpStreamStatus)(message)) {
+                else if ((0, cloud_to_app_1.isRtmpStreamStatus)(message)) {
                     // Emit as a standard stream event if subscribed
                     if (this.subscriptions.has(types_1.StreamType.RTMP_STREAM_STATUS)) {
                         this.events.emit(types_1.StreamType.RTMP_STREAM_STATUS, message);
@@ -882,24 +892,24 @@ class TpaSession {
                     }
                 }
                 // Handle custom messages
-                else if (message.type === types_1.CloudToTpaMessageType.CUSTOM_MESSAGE) {
+                else if (message.type === types_1.CloudToAppMessageType.CUSTOM_MESSAGE) {
                     this.events.emit('custom_message', message);
                     return;
                 }
-                // Handle TPA-to-TPA communication messages
-                else if (message.type === 'tpa_message_received') {
-                    this.tpaEvents.emit('tpa_message_received', message);
+                // Handle App-to-App communication messages
+                else if (message.type === 'app_message_received') {
+                    this.appEvents.emit('app_message_received', message);
                 }
-                else if (message.type === 'tpa_user_joined') {
-                    this.tpaEvents.emit('tpa_user_joined', message);
+                else if (message.type === 'app_user_joined') {
+                    this.appEvents.emit('app_user_joined', message);
                 }
-                else if (message.type === 'tpa_user_left') {
-                    this.tpaEvents.emit('tpa_user_left', message);
+                else if (message.type === 'app_user_left') {
+                    this.appEvents.emit('app_user_left', message);
                 }
-                else if (message.type === 'tpa_room_updated') {
-                    this.tpaEvents.emit('tpa_room_updated', message);
+                else if (message.type === 'app_room_updated') {
+                    this.appEvents.emit('app_room_updated', message);
                 }
-                else if (message.type === 'tpa_direct_message_response') {
+                else if (message.type === 'app_direct_message_response') {
                     const response = message;
                     if (response.messageId && this.pendingDirectMessages.has(response.messageId)) {
                         const { resolve } = this.pendingDirectMessages.get(response.messageId);
@@ -915,11 +925,11 @@ class TpaSession {
                 }
                 // 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 TpaConnectionError
+                    // 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 'tpa_connection_error' value.
+                    // instead of the enum's 'app_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 'tpa_connection_error'. Message: ${errorMessage}`);
+                    this.logger.warn(`Received 'connection_error' type directly. Consider aligning cloud to send 'app_connection_error'. Message: ${errorMessage}`);
                     this.events.emit('error', new Error(errorMessage));
                 }
                 else if (message.type === 'permission_error') {
@@ -964,14 +974,14 @@ class TpaSession {
                 }
             }
             catch (processingError) {
-                // Catch any errors during message processing to prevent TPA crashes
+                // Catch any errors during message processing to prevent App crashes
                 this.logger.error(processingError, 'Error processing message:');
                 const errorMessage = processingError instanceof Error ? processingError.message : String(processingError);
                 this.events.emit('error', new Error(`Error processing message: ${errorMessage}`));
             }
         }
         catch (error) {
-            // Final safety net to ensure the TPA doesn't crash on any unexpected errors
+            // Final safety net to ensure the App doesn't crash on any unexpected errors
             this.logger.error(error, 'Unexpected error in message handler');
             const errorMessage = error instanceof Error ? error.message : String(error);
             this.events.emit('error', new Error(`Unexpected error in message handler: ${errorMessage}`));
@@ -1083,7 +1093,7 @@ class TpaSession {
      */
     sendConnectionInit() {
         const message = {
-            type: types_1.TpaToCloudMessageType.CONNECTION_INIT,
+            type: types_1.AppToCloudMessageType.CONNECTION_INIT,
             sessionId: this.sessionId,
             packageName: this.config.packageName,
             apiKey: this.config.apiKey,
@@ -1095,9 +1105,9 @@ class TpaSession {
      * 📝 Update subscription list with cloud
      */
     updateSubscriptions() {
-        this.logger.info(`[TpaSession] updateSubscriptions: sending subscriptions to cloud:`, Array.from(this.subscriptions));
+        this.logger.info(`[AppSession] updateSubscriptions: sending subscriptions to cloud:`, Array.from(this.subscriptions));
         const message = {
-            type: types_1.TpaToCloudMessageType.SUBSCRIPTION_UPDATE,
+            type: types_1.AppToCloudMessageType.SUBSCRIPTION_UPDATE,
             packageName: this.config.packageName,
             subscriptions: Array.from(this.subscriptions),
             sessionId: this.sessionId,
@@ -1118,7 +1128,7 @@ class TpaSession {
         const maxAttempts = this.config.maxReconnectAttempts || 3;
         if (this.reconnectAttempts >= maxAttempts) {
             this.logger.info(`🔄 Maximum reconnection attempts (${maxAttempts}) reached, giving up`);
-            // Emit a permanent disconnection event to trigger onStop in the TPA server
+            // Emit a permanent disconnection event to trigger onStop in the App server
             this.events.emit('disconnected', {
                 message: `Connection permanently lost after ${maxAttempts} failed reconnection attempts`,
                 code: 4000, // Custom code for max reconnection attempts exhausted
@@ -1203,7 +1213,7 @@ class TpaSession {
             }
         }
         catch (error) {
-            // Log the error and emit an event so TPA developers are aware
+            // Log the error and emit an event so App developers are aware
             this.logger.error(error, 'Message send error');
             // Ensure we always emit an Error object
             if (error instanceof Error) {
@@ -1232,22 +1242,22 @@ class TpaSession {
         }
     }
     // =====================================
-    // 👥 TPA-to-TPA Communication Interface
+    // 👥 App-to-App Communication Interface
     // =====================================
     /**
-     * 👥 Discover other users currently using the same TPA
+     * 👥 Discover other users currently using the same App
      * @param includeProfiles - Whether to include user profile information
      * @returns Promise that resolves with list of active users
      */
-    async discoverTpaUsers(domain, includeProfiles = false) {
+    async discoverAppUsers(domain, includeProfiles = false) {
         // Use the domain argument as the base URL if provided
         if (!domain) {
             throw new Error('Domain (API base URL) is required for user discovery');
         }
-        const url = `${domain}/api/tpa-communication/discover-users`;
+        const url = `${domain}/api/app-communication/discover-users`;
         // Use the user's core token for authentication
-        const tpaApiKey = this.config.apiKey; // This may need to be updated if you store the core token elsewhere
-        if (!tpaApiKey) {
+        const appApiKey = this.config.apiKey; // This may need to be updated if you store the core token elsewhere
+        if (!appApiKey) {
             throw new Error('Core token (apiKey) is required for user discovery');
         }
         const body = {
@@ -1258,7 +1268,7 @@ class TpaSession {
         const response = await fetch(url, {
             method: 'POST',
             headers: {
-                'Authorization': `Bearer ${tpaApiKey}`,
+                'Authorization': `Bearer ${appApiKey}`,
                 'Content-Type': 'application/json'
             },
             body: JSON.stringify(body)
@@ -1276,7 +1286,7 @@ class TpaSession {
      */
     async isUserActive(userId) {
         try {
-            const userList = await this.discoverTpaUsers('', false);
+            const userList = await this.discoverAppUsers('', false);
             return userList.users.some((user) => user.userId === userId);
         }
         catch (error) {
@@ -1285,12 +1295,12 @@ class TpaSession {
         }
     }
     /**
-     * 📊 Get user count for this TPA
+     * 📊 Get user count for this App
      * @returns Promise that resolves with number of active users
      */
     async getUserCount(domain) {
         try {
-            const userList = await this.discoverTpaUsers(domain, false);
+            const userList = await this.discoverAppUsers(domain, false);
             return userList.totalUsers;
         }
         catch (error) {
@@ -1299,16 +1309,16 @@ class TpaSession {
         }
     }
     /**
-     * 📢 Send broadcast message to all users with same TPA active
+     * 📢 Send broadcast message to all users with same App active
      * @param payload - Message payload to send
      * @param roomId - Optional room ID for room-based messaging
      * @returns Promise that resolves when message is sent
      */
-    async broadcastToTpaUsers(payload, roomId) {
+    async broadcastToAppUsers(payload, roomId) {
         try {
             const messageId = this.generateMessageId();
             const message = {
-                type: 'tpa_broadcast_message',
+                type: 'app_broadcast_message',
                 packageName: this.config.packageName,
                 sessionId: this.sessionId,
                 payload,
@@ -1336,7 +1346,7 @@ class TpaSession {
                 // Store promise resolver
                 this.pendingDirectMessages.set(messageId, { resolve, reject });
                 const message = {
-                    type: 'tpa_direct_message',
+                    type: 'app_direct_message',
                     packageName: this.config.packageName,
                     sessionId: this.sessionId,
                     targetUserId,
@@ -1367,10 +1377,10 @@ class TpaSession {
      * @param roomConfig - Optional room configuration
      * @returns Promise that resolves when room is joined
      */
-    async joinTpaRoom(roomId, roomConfig) {
+    async joinAppRoom(roomId, roomConfig) {
         try {
             const message = {
-                type: 'tpa_room_join',
+                type: 'app_room_join',
                 packageName: this.config.packageName,
                 sessionId: this.sessionId,
                 roomId,
@@ -1389,10 +1399,10 @@ class TpaSession {
      * @param roomId - Room ID to leave
      * @returns Promise that resolves when room is left
      */
-    async leaveTpaRoom(roomId) {
+    async leaveAppRoom(roomId) {
         try {
             const message = {
-                type: 'tpa_room_leave',
+                type: 'app_room_leave',
                 packageName: this.config.packageName,
                 sessionId: this.sessionId,
                 roomId,
@@ -1406,40 +1416,40 @@ class TpaSession {
         }
     }
     /**
-     * 📨 Listen for messages from other TPA users
+     * 📨 Listen for messages from other App users
      * @param handler - Function to handle incoming messages
      * @returns Cleanup function to remove the handler
      */
-    onTpaMessage(handler) {
-        this.tpaEvents.on('tpa_message_received', handler);
-        return () => this.tpaEvents.off('tpa_message_received', handler);
+    onAppMessage(handler) {
+        this.appEvents.on('app_message_received', handler);
+        return () => this.appEvents.off('app_message_received', handler);
     }
     /**
      * 👋 Listen for user join events
      * @param handler - Function to handle user join events
      * @returns Cleanup function to remove the handler
      */
-    onTpaUserJoined(handler) {
-        this.tpaEvents.on('tpa_user_joined', handler);
-        return () => this.tpaEvents.off('tpa_user_joined', handler);
+    onAppUserJoined(handler) {
+        this.appEvents.on('app_user_joined', handler);
+        return () => this.appEvents.off('app_user_joined', handler);
     }
     /**
      * 🚪 Listen for user leave events
      * @param handler - Function to handle user leave events
      * @returns Cleanup function to remove the handler
      */
-    onTpaUserLeft(handler) {
-        this.tpaEvents.on('tpa_user_left', handler);
-        return () => this.tpaEvents.off('tpa_user_left', handler);
+    onAppUserLeft(handler) {
+        this.appEvents.on('app_user_left', handler);
+        return () => this.appEvents.off('app_user_left', handler);
     }
     /**
      * 🏠 Listen for room update events
      * @param handler - Function to handle room updates
      * @returns Cleanup function to remove the handler
      */
-    onTpaRoomUpdated(handler) {
-        this.tpaEvents.on('tpa_room_updated', handler);
-        return () => this.tpaEvents.off('tpa_room_updated', handler);
+    onAppRoomUpdated(handler) {
+        this.appEvents.on('app_room_updated', handler);
+        return () => this.appEvents.off('app_room_updated', handler);
     }
     /**
      * 🔧 Generate unique message ID
@@ -1449,4 +1459,4 @@ class TpaSession {
         return `msg_${Date.now()}_${Math.random().toString(36).substring(2, 9)}`;
     }
 }
-exports.TpaSession = TpaSession;
+exports.AppSession = AppSession;

package/dist/{tpa → app}/session/layouts.d.ts

@@ -1,7 +1,7 @@
 /**
  * 🎨 Layout Manager Module
  *
- * Manages AR display layouts for TPAs. This class provides an easy-to-use interface
+ * Manages AR display layouts for Apps. This class provides an easy-to-use interface
  * for showing different types of content in the user's AR view.
  *
  * @example
@@ -22,7 +22,7 @@ export declare class LayoutManager {
     /**
      * 🎯 Creates a new LayoutManager instance
      *
-     * @param packageName - TPA package identifier
+     * @param packageName - App package identifier
      * @param sendMessage - Function to send display requests to AugmentOS
      */
     constructor(packageName: string, sendMessage: (message: DisplayRequest) => void);

package/dist/{tpa → app}/session/layouts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"layouts.d.ts","sourceRoot":"","sources":["../../../src/tpa/session/layouts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EACL,cAAc,EAOd,QAAQ,EAGT,MAAM,aAAa,CAAC;AAErB,qBAAa,aAAa;IAQtB,OAAO,CAAC,WAAW;IACnB,OAAO,CAAC,WAAW;IARrB;;;;;OAKG;gBAEO,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,IAAI;IAGxD;;;;;;;;OAQG;IACH,OAAO,CAAC,kBAAkB;IAmG1B;;;;;;;;;;;;;;;;;OAiBG;IACH,YAAY,CACV,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,QAAQ,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAC;IAuCnD;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,kBAAkB,CAChB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,QAAQ,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE;IAcpD;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,iBAAiB,CACf,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,QAAQ,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE;IAclD;;;;;;;;;;;;KAYC;IACH,cAAc,CACZ,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,QAAQ,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE;IAapD;;;;;;;;;;;;;;;;OAgBG;IACH,iBAAiB,CACf,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,QAAQ,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE;CAarD"}
+{"version":3,"file":"layouts.d.ts","sourceRoot":"","sources":["../../../src/app/session/layouts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EACL,cAAc,EAOd,QAAQ,EAGT,MAAM,aAAa,CAAC;AAErB,qBAAa,aAAa;IAQtB,OAAO,CAAC,WAAW;IACnB,OAAO,CAAC,WAAW;IARrB;;;;;OAKG;gBAEO,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,IAAI;IAGxD;;;;;;;;OAQG;IACH,OAAO,CAAC,kBAAkB;IAmG1B;;;;;;;;;;;;;;;;;OAiBG;IACH,YAAY,CACV,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,QAAQ,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAC;IAuCnD;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,kBAAkB,CAChB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,QAAQ,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE;IAcpD;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,iBAAiB,CACf,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,QAAQ,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE;IAclD;;;;;;;;;;;;KAYC;IACH,cAAc,CACZ,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,QAAQ,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE;IAapD;;;;;;;;;;;;;;;;OAgBG;IACH,iBAAiB,CACf,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,QAAQ,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE;CAarD"}