@casual-simulation/aux-runtime 3.10.5 → 4.0.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@casual-simulation/aux-runtime",
-  "version": "3.10.5",
+  "version": "4.0.0",
   "description": "Runtime for AUX projects",
   "main": "index.js",
   "types": "index.d.ts",
@@ -25,23 +25,23 @@
     "access": "public"
   },
   "dependencies": {
-    "@casual-simulation/aux-common": "^3.10.5",
-    "@casual-simulation/aux-records": "^3.10.5",
-    "@casual-simulation/crypto": "^3.10.3",
+    "@casual-simulation/aux-common": "^4.0.0",
+    "@casual-simulation/aux-records": "^4.0.0",
+    "@casual-simulation/crypto": "^4.0.0",
     "@casual-simulation/engine262": "0.0.1-4de2170374e22761996e46eb1362f4496ee57f8f",
     "@casual-simulation/error-stack-parser": "^2.0.7",
-    "@casual-simulation/expect": "^3.10.3",
-    "@casual-simulation/fast-json-stable-stringify": "^3.10.3",
-    "@casual-simulation/js-interpreter": "^3.10.3",
-    "@casual-simulation/stacktrace": "^3.1.11",
+    "@casual-simulation/expect": "^4.0.0",
+    "@casual-simulation/fast-json-stable-stringify": "^4.0.0",
+    "@casual-simulation/js-interpreter": "^4.0.0",
+    "@casual-simulation/stacktrace": "^4.0.0",
     "@casual-simulation/three": "^0.140.3",
+    "@sveltejs/acorn-typescript": "1.0.8",
     "@tweenjs/tween.js": "18.6.0",
     "@types/estraverse": "5.1.7",
     "@types/seedrandom": "3.0.8",
     "@types/uuid": "10.0.0",
     "acorn": "8.11.3",
     "acorn-jsx": "5.3.2",
-    "acorn-typescript": "1.4.13",
     "astring": "1.7.5",
     "axios": "1.7.7",
     "base64-js": "^1.5.1",

package/runtime/AuxGlobalContext.d.ts

@@ -475,7 +475,7 @@ export interface WatchBotTimer {
     /**
      * The function that should be called when the bot changes.
      */
-    handler: () => void | Generator<InterpreterStop, any, InterpreterContinuation>;
+    handler: (bot: RuntimeBot, changedTags: string[], botId: string) => void | Generator<InterpreterStop, any, InterpreterContinuation>;
 }
 /**
  * Inserts the given bot into the global context.

package/runtime/AuxLibrary.d.ts

@@ -2230,6 +2230,7 @@ export declare function createDefaultLibrary(context: AuxGlobalContext): {
             (bot: string | Bot | RuntimeBot | (string | Bot | RuntimeBot)[]): void;
             [INTERPRETABLE_FUNCTION]: (bot: string | Bot | RuntimeBot | (string | Bot | RuntimeBot)[]) => Generator<any, void, any>;
         };
+        _watchBot: (bot: (Bot | string)[] | Bot | string, handler: (bot: Bot, changedTags: string[], botId: string) => void) => RuntimeBot | RuntimeBot[];
         _changeState: (bot: Bot, stateName: string, groupName?: string) => void;
         changeState: {
             (bot: Bot, stateName: string, groupName?: string): void;
@@ -2317,8 +2318,6 @@ export declare function createDefaultLibrary(context: AuxGlobalContext): {
         clearWatchBot: (id: number) => void;
         clearWatchPortal: (id: number) => void;
         assert: (condition: boolean, message?: string) => void;
-        assertEqual: (first: any, second: any) => void;
-        expect: import("@casual-simulation/expect/src/types").Expect;
         html: HtmlFunction;
         /**
          * Gets the config bot (formerly known as the player bot).
@@ -2385,6 +2384,10 @@ export declare function createDefaultLibrary(context: AuxGlobalContext): {
             showJoinCode: (inst?: string, dimension?: string) => ShowJoinCodeAction;
             requestFullscreenMode: () => RequestFullscreenAction;
             exitFullscreenMode: () => ExitFullscreenAction;
+            promptToInstallPWA: () => Promise<{
+                outcome: "accepted" | "dismissed";
+                platform: string;
+            }>;
             hideLoadingScreen: () => Promise<void>;
             showHtml: (html: string) => ShowHtmlAction;
             hideHtml: () => HideHtmlAction;
@@ -3043,7 +3046,7 @@ export declare function createDefaultLibrary(context: AuxGlobalContext): {
         setTimeout: (options: TagSpecificApiOptions) => (handler: (...args: any[]) => void | Generator<InterpreterStop, any, InterpreterContinuation>, timeout?: number, ...args: any[]) => number;
         setInterval: (options: TagSpecificApiOptions) => (handler: (...args: any[]) => void | Generator<InterpreterStop, any, InterpreterContinuation>, timeout?: number, ...args: any[]) => number;
         watchPortal: (options: TagSpecificApiOptions) => (portalId: string, handler: () => void | Generator<InterpreterStop, any, InterpreterContinuation>) => number;
-        watchBot: (options: TagSpecificApiOptions) => (bot: (Bot | string)[] | Bot | string, handler: () => void | Generator<InterpreterStop, any, InterpreterContinuation>) => number;
+        watchBot: (options: TagSpecificApiOptions) => (bot: (Bot | string)[] | Bot | string, handler: (bot: Bot, changedTags: string[], botId: string) => void | Generator<InterpreterStop, any, InterpreterContinuation>) => number;
     };
 };
 export type DefaultLibrary = ReturnType<typeof createDefaultLibrary>;

package/runtime/AuxLibrary.js

@@ -1,5 +1,5 @@
 import { DEBUG_STRING, debugStringifyFunction } from './AuxGlobalContext';
-import { hasValue, trimTag, isBot, BOT_SPACE_TAG, toast as toastMessage, getScriptIssues as scriptIssues, configureTypeChecking as calcConfigureTypeChecking, tip as tipMessage, hideTips as hideTipMessages, showJoinCode as calcShowJoinCode, requestFullscreen, exitFullscreen, html as htmlMessage, hideHtml as hideHtmlMessage, setClipboard as calcSetClipboard, tweenTo as calcTweenTo, showChat as calcShowChat, hideChat as calcHideChat, runScript, getMediaPermission as calcGetMediaPermission, getAverageFrameRate as calcGetAverageFrameRate, enableAR as calcEnableAR, disableAR as calcDisableAR, enableVR as calcEnableVR, disableVR as calcDisableVR, arSupported as calcARSupported, vrSupported as calcVRSupported, showUploadAuxFile as calcShowUploadAuxFile, openQRCodeScanner as calcOpenQRCodeScanner, showQRCode as calcShowQRCode, generateQRCode as calcGenerateQRCode, openBarcodeScanner as calcOpenBarcodeScanner, showBarcode as calcShowBarcode, importAUX as calcImportAUX, showInputForTag as calcShowInputForTag, showInput as calcShowInput, showConfirm as calcShowConfirm, showAlert as calcShowAlert, replaceDragBot as calcReplaceDragBot, goToDimension as calcGoToDimension, goToURL as calcGoToURL, openURL as calcOpenURL, playSound as calcPlaySound, bufferSound as calcBufferSound, cancelSound as calcCancelSound, shell as calcShell, reject as calcReject, localFormAnimation as calcLocalFormAnimation, webhook as calcWebhook, superShout as calcSuperShout, share as calcShare, registerPrefix as calcRegisterPrefix, localPositionTween as calcLocalPositionTween, localRotationTween as calcLocalRotationTween, showUploadFiles as calcShowUploadFiles, download, loadSimulation, unloadSimulation, getUploadState, addState, getPortalTag, KNOWN_PORTALS, openConsole, tagsOnBot, getOriginalObject, getBotSpace, trimEvent, CREATE_ACTION_NAME, CREATE_ANY_ACTION_NAME, DESTROY_ACTION_NAME, ORIGINAL_OBJECT, getRemoteCount, getRemotes, listInstUpdates as calcListInstUpdates, getInstStateFromUpdates as calcGetInstStateFromUpdates, action, calculateAnchorPoint, calculateAnchorPointOffset, getBotPosition as calcGetBotPosition, getBotRotation as calcGetBotRotation, isRuntimeBot, SET_TAG_MASK_SYMBOL, CLEAR_TAG_MASKS_SYMBOL, getBotScale, EDIT_TAG_SYMBOL, EDIT_TAG_MASK_SYMBOL, circleWipe, addDropSnap as calcAddDropSnap, addDropGrid as calcAddDropGrid, animateToPosition, beginAudioRecording as calcBeginAudioRecording, endAudioRecording as calcEndAudioRecording, beginRecording as calcBeginRecording, endRecording as calcEndRecording, speakText as calcSpeakText, getVoices as calcGetVoices, getGeolocation as calcGetGeolocation, cancelAnimation, disablePOV, enablePOV, enableCustomDragging as calcEnableCustomDragging, MINI_PORTAL, registerCustomApp, setAppOutput, unregisterCustomApp, requestAuthData as calcRequestAuthData, signOut as calcSignOut, createBot, defineGlobalBot as calcDefineGlobalBot, TEMPORARY_BOT_PARTITION_ID, convertToString, GET_TAG_MASKS_SYMBOL, isBotLink, parseBotLink, createBotLink, convertGeolocationToWhat3Words as calcConvertGeolocationToWhat3Words, meetCommand as calcMeetCommand, meetFunction as calcMeetFunction, openImageClassifier as calcOpenImageClassifier, classifyImages as calcOpenClassifyImages, isBotDate, DATE_TAG_PREFIX, parseBotDate, realNumberOrDefault, raycastFromCamera as calcRaycastFromCamera, raycastInPortal as calcRaycastInPortal, calculateRayFromCamera as calcCalculateRayFromCamera, bufferFormAddressGltf, startFormAnimation as calcStartFormAnimation, stopFormAnimation as calcStopFormAnimation, listFormAnimations as calcListFormAnimations, calculateStringTagValue, createInitializationUpdate as calcCreateInitalizationUpdate, applyUpdatesToInst as calcApplyUpdatesToInst, configureWakeLock, getWakeLockConfiguration as calcGetWakeLockConfiguration, analyticsRecordEvent as calcAnalyticsRecordEvent, KNOWN_TAGS, isStoredVersion2, getCurrentInstUpdate as calcGetCurrentInstUpdate, openPhotoCamera as calcOpenPhotoCamera, getEasing, enableCollaboration as calcEnableCollaboration, showAccountInfo as calcShowAccountInfo, reportInst as calcReportInst, getRecordsEndpoint as calcGetRecordsEndpoint, ldrawCountAddressBuildSteps as calcLdrawCountAddressBuildSteps, ldrawCountTextBuildSteps as calcLdrawCountTextBuildSteps, calculateViewportCoordinatesFromPosition as calcCalculateViewportCoordinatesFromPosition, calculateScreenCoordinatesFromViewportCoordinates as calcCalculateScreenCoordinatesFromViewportCoordinates, calculateViewportCoordinatesFromScreenCoordinates as calcCalculateViewportCoordinatesFromScreenCoordinates, capturePortalScreenshot as calcCapturePortalScreenshot, createStaticHtml as calcCreateStaticHtmlFromBots, recordLoom, watchLoom, getLoomMetadata, loadSharedDocument, installAuxFile as calcInstallAuxFile, calculateStringListTagValue, calculateScreenCoordinatesFromPosition as calcCalculateScreenCoordinatesFromPosition, addMapLayer as calcAddMapLayer, removeMapLayer as calcRemoveMapLayer, GET_DYNAMIC_LISTENERS_SYMBOL, ADD_BOT_LISTENER_SYMBOL, REMOVE_BOT_LISTENER_SYMBOL, trackConfigBotTags as calcTrackConfigBotTags, } from '@casual-simulation/aux-common/bots';
+import { hasValue, trimTag, isBot, BOT_SPACE_TAG, toast as toastMessage, getScriptIssues as scriptIssues, configureTypeChecking as calcConfigureTypeChecking, tip as tipMessage, hideTips as hideTipMessages, showJoinCode as calcShowJoinCode, requestFullscreen, exitFullscreen, promptToInstallPWA as calcPromptToInstallPWA, html as htmlMessage, hideHtml as hideHtmlMessage, setClipboard as calcSetClipboard, tweenTo as calcTweenTo, showChat as calcShowChat, hideChat as calcHideChat, runScript, getMediaPermission as calcGetMediaPermission, getAverageFrameRate as calcGetAverageFrameRate, enableAR as calcEnableAR, disableAR as calcDisableAR, enableVR as calcEnableVR, disableVR as calcDisableVR, arSupported as calcARSupported, vrSupported as calcVRSupported, showUploadAuxFile as calcShowUploadAuxFile, openQRCodeScanner as calcOpenQRCodeScanner, showQRCode as calcShowQRCode, generateQRCode as calcGenerateQRCode, openBarcodeScanner as calcOpenBarcodeScanner, showBarcode as calcShowBarcode, importAUX as calcImportAUX, showInputForTag as calcShowInputForTag, showInput as calcShowInput, showConfirm as calcShowConfirm, showAlert as calcShowAlert, replaceDragBot as calcReplaceDragBot, goToDimension as calcGoToDimension, goToURL as calcGoToURL, openURL as calcOpenURL, playSound as calcPlaySound, bufferSound as calcBufferSound, cancelSound as calcCancelSound, shell as calcShell, reject as calcReject, localFormAnimation as calcLocalFormAnimation, webhook as calcWebhook, superShout as calcSuperShout, share as calcShare, registerPrefix as calcRegisterPrefix, localPositionTween as calcLocalPositionTween, localRotationTween as calcLocalRotationTween, showUploadFiles as calcShowUploadFiles, download, loadSimulation, unloadSimulation, getUploadState, addState, getPortalTag, KNOWN_PORTALS, openConsole, tagsOnBot, getOriginalObject, getBotSpace, trimEvent, CREATE_ACTION_NAME, CREATE_ANY_ACTION_NAME, DESTROY_ACTION_NAME, ORIGINAL_OBJECT, getRemoteCount, getRemotes, listInstUpdates as calcListInstUpdates, getInstStateFromUpdates as calcGetInstStateFromUpdates, action, calculateAnchorPoint, calculateAnchorPointOffset, getBotPosition as calcGetBotPosition, getBotRotation as calcGetBotRotation, isRuntimeBot, SET_TAG_MASK_SYMBOL, CLEAR_TAG_MASKS_SYMBOL, getBotScale, EDIT_TAG_SYMBOL, EDIT_TAG_MASK_SYMBOL, circleWipe, addDropSnap as calcAddDropSnap, addDropGrid as calcAddDropGrid, animateToPosition, beginAudioRecording as calcBeginAudioRecording, endAudioRecording as calcEndAudioRecording, beginRecording as calcBeginRecording, endRecording as calcEndRecording, speakText as calcSpeakText, getVoices as calcGetVoices, getGeolocation as calcGetGeolocation, cancelAnimation, disablePOV, enablePOV, enableCustomDragging as calcEnableCustomDragging, MINI_PORTAL, registerCustomApp, setAppOutput, unregisterCustomApp, requestAuthData as calcRequestAuthData, signOut as calcSignOut, createBot, defineGlobalBot as calcDefineGlobalBot, TEMPORARY_BOT_PARTITION_ID, convertToString, GET_TAG_MASKS_SYMBOL, isBotLink, parseBotLink, createBotLink, convertGeolocationToWhat3Words as calcConvertGeolocationToWhat3Words, meetCommand as calcMeetCommand, meetFunction as calcMeetFunction, openImageClassifier as calcOpenImageClassifier, classifyImages as calcOpenClassifyImages, isBotDate, DATE_TAG_PREFIX, parseBotDate, realNumberOrDefault, raycastFromCamera as calcRaycastFromCamera, raycastInPortal as calcRaycastInPortal, calculateRayFromCamera as calcCalculateRayFromCamera, bufferFormAddressGltf, startFormAnimation as calcStartFormAnimation, stopFormAnimation as calcStopFormAnimation, listFormAnimations as calcListFormAnimations, calculateStringTagValue, createInitializationUpdate as calcCreateInitalizationUpdate, applyUpdatesToInst as calcApplyUpdatesToInst, configureWakeLock, getWakeLockConfiguration as calcGetWakeLockConfiguration, analyticsRecordEvent as calcAnalyticsRecordEvent, KNOWN_TAGS, isStoredVersion2, getCurrentInstUpdate as calcGetCurrentInstUpdate, openPhotoCamera as calcOpenPhotoCamera, getEasing, enableCollaboration as calcEnableCollaboration, showAccountInfo as calcShowAccountInfo, reportInst as calcReportInst, getRecordsEndpoint as calcGetRecordsEndpoint, ldrawCountAddressBuildSteps as calcLdrawCountAddressBuildSteps, ldrawCountTextBuildSteps as calcLdrawCountTextBuildSteps, calculateViewportCoordinatesFromPosition as calcCalculateViewportCoordinatesFromPosition, calculateScreenCoordinatesFromViewportCoordinates as calcCalculateScreenCoordinatesFromViewportCoordinates, calculateViewportCoordinatesFromScreenCoordinates as calcCalculateViewportCoordinatesFromScreenCoordinates, capturePortalScreenshot as calcCapturePortalScreenshot, createStaticHtml as calcCreateStaticHtmlFromBots, recordLoom, watchLoom, getLoomMetadata, loadSharedDocument, installAuxFile as calcInstallAuxFile, calculateStringListTagValue, calculateScreenCoordinatesFromPosition as calcCalculateScreenCoordinatesFromPosition, addMapLayer as calcAddMapLayer, removeMapLayer as calcRemoveMapLayer, GET_DYNAMIC_LISTENERS_SYMBOL, ADD_BOT_LISTENER_SYMBOL, REMOVE_BOT_LISTENER_SYMBOL, trackConfigBotTags as calcTrackConfigBotTags, } from '@casual-simulation/aux-common/bots';
 import { aiChat, aiChatStream, aiListChatModels, aiGenerateSkybox, aiGenerateImage, grantRecordPermission as calcGrantRecordPermission, revokeRecordPermission as calcRevokeRecordPermission, listPermissions as calcListPermissions, grantInstAdminPermission as calcGrantInstAdminPermission, grantUserRole as calcGrantUserRole, revokeUserRole as calcRevokeUserRole, grantInstRole as calcGrantInstRole, revokeInstRole as calcRevokeInstRole, listUserStudios as calcListUserStudios, listStudioRecords as calcListStudioRecords, joinRoom as calcJoinRoom, leaveRoom as calcLeaveRoom, setRoomOptions as calcSetRoomOptions, getRoomOptions as calcGetRoomOptions, getRoomTrackOptions as calcGetRoomTrackOptions, setRoomTrackOptions as calcSetRoomTrackOptions, getRoomRemoteOptions as calcGetRoomRemoteOptions, listDataRecord, recordEvent as calcRecordEvent, getEventCount as calcGetEventCount, getFile as calcGetFile, eraseFile as calcEraseFile, getPublicRecordKey as calcGetPublicRecordKey, recordData as calcRecordData, getRecordData, eraseRecordData, recordFile as calcRecordFile, listDataRecordByMarker, aiHumeGetAccessToken, aiSloydGenerateModel, recordWebhook as calcRecordWebhook, getWebhook as calcGetWebhook, listWebhooks as calcListWebhooks, listWebhooksByMarker as calcListWebhooksByMarker, eraseWebhook as calcEraseWebhook, runWebhook as calcRunWebhook, recordNotification as calcRecordNotification, getNotification as calcGetNotification, listNotifications as calcListNotifications, listNotificationsByMarker as calcListNotificationsByMarker, eraseNotification as calcEraseNotification, subscribeToNotification as calcSubscribeToNotification, unsubscribeFromNotification as calcUnsubscribeFromNotification, sendNotification as calcSendNotification, listNotificationSubscriptions as calcListNotificationSubscriptions, listUserNotificationSubscriptions as calcListUserNotificationSubscriptions, 
 // getXpUserMeta,
 // createXpContract,
@@ -24,7 +24,6 @@ import { Vector3, Vector2, Quaternion, Rotation, } from '@casual-simulation/aux-
 import { Fragment, h } from 'preact';
 import htm from 'htm';
 import { fromByteArray, toByteArray } from 'base64-js';
-import expect, { iterableEquality } from '@casual-simulation/expect';
 import { parseRecordKey, isRecordKey as calcIsRecordKey, } from '@casual-simulation/aux-common';
 import SeedRandom from 'seedrandom';
 import { DateTime } from 'luxon';
@@ -89,60 +88,6 @@ const MAX_RETRY_AFTER_MS = 60 * 60 * 1000;
  */
 const MAX_RETRY_COUNT = 10;
 export const GET_RUNTIME = Symbol('get_runtime');
-const botsEquality = function (first, second) {
-    if (isRuntimeBot(first) && isRuntimeBot(second)) {
-        expect(getBotSnapshot(first)).toEqual(getBotSnapshot(second));
-        return true;
-    }
-    return undefined;
-};
-expect.extend({
-    toEqual(received, expected) {
-        // Copied from https://github.com/facebook/jest/blob/7bb400c373a6f90ba956dd25fe24ee4d4788f41e/packages/expect/src/matchers.ts#L580
-        // Added the testBots matcher to make testing against bots easier.
-        const matcherName = 'toEqual';
-        const options = {
-            comment: 'deep equality',
-            isNot: this.isNot,
-            promise: this.promise,
-        };
-        const pass = this.equals(received, expected, [
-            botsEquality,
-            iterableEquality,
-        ]);
-        const message = pass
-            ? () => this.utils.matcherHint(matcherName, undefined, undefined, options) +
-                '\n\n' +
-                `Expected: not ${this.utils.printExpected(expected)}\n` +
-                (this.utils.stringify(expected) !==
-                    this.utils.stringify(received)
-                    ? `Received:     ${this.utils.printReceived(received)}`
-                    : '')
-            : () => this.utils.matcherHint(matcherName, undefined, undefined, options) +
-                '\n\n' +
-                this.utils.printDiffOrStringify(expected, received, 'Expected', 'Received', this.expand !== false);
-        // Passing the actual and expected objects so that a custom reporter
-        // could access them, for example in order to display a custom visual diff,
-        // or create a different error message
-        return { actual: received, expected, message, name: matcherName, pass };
-    },
-});
-function getBotSnapshot(bot) {
-    let b = {
-        id: bot.id,
-        space: bot.space,
-        tags: typeof bot.tags.toJSON === 'function'
-            ? bot.tags.toJSON()
-            : bot.tags,
-    };
-    let masks = isRuntimeBot(bot)
-        ? bot[GET_TAG_MASKS_SYMBOL]()
-        : cloneDeep(bot.masks ?? {});
-    if (Object.keys(masks).length > 0) {
-        b.masks = masks;
-    }
-    return b;
-}
 const DEAD_RECKONING_OFFSET = 50;
 const DEG_TO_RAD = Math.PI / 180;
 const RAD_TO_DEG = 180 / Math.PI;
@@ -414,6 +359,7 @@ export function createDefaultLibrary(context) {
             _create,
             _destroy,
             destroy: createInterpretableFunction(destroy),
+            _watchBot,
             _changeState,
             changeState: createInterpretableFunction(changeState),
             getLink: createBotLinkApi,
@@ -480,8 +426,6 @@ export function createDefaultLibrary(context) {
             clearWatchBot,
             clearWatchPortal,
             assert,
-            assertEqual,
-            expect,
             html,
             /**
              * Gets the config bot (formerly known as the player bot).
@@ -536,6 +480,7 @@ export function createDefaultLibrary(context) {
                 showJoinCode,
                 requestFullscreenMode,
                 exitFullscreenMode,
+                promptToInstallPWA,
                 hideLoadingScreen,
                 showHtml,
                 hideHtml,
@@ -1071,20 +1016,20 @@ export function createDefaultLibrary(context) {
     function watchBot() {
         let timerId = 0;
         return (options) => function (bot, handler) {
-            let id = timerId++;
-            let botIds = Array.isArray(bot)
+            const id = timerId++;
+            const botIds = Array.isArray(bot)
                 ? bot.map((b) => getID(b))
                 : [getID(bot)];
-            const finalHandler = () => {
+            const finalHandler = (bot, changedTags, botId) => {
                 try {
-                    let result = handler();
+                    const result = handler(bot, changedTags, botId);
                     return wrapGenerator(result);
                 }
                 catch (err) {
                     context.enqueueError(err);
                 }
             };
-            for (let botId of botIds) {
+            for (const botId of botIds) {
                 context.recordBotTimer(options.bot.id, {
                     type: 'watch_bot',
                     timerId: id,
@@ -1096,6 +1041,37 @@ export function createDefaultLibrary(context) {
             return id;
         };
     }
+    /**
+     * Watches the given bot(s) for changes and calls the given handler function whenever a tag on the bot changes or when the bot is destroyed.
+     *
+     * @param bot The bot or array of bots (or bot IDs) that should be watched for changes.
+     *
+     * @param handler The function that should be called whenever a tag on the bot changes.
+     * The function is called with three arguments: the bot that changed, an array of tag names that changed on the bot, and the ID of the bot.
+     * If the bot is destroyed, then the first argument will be `null` and the second argument will be an empty array.
+     *
+     * @returns The ID of the watcher that was created. This ID can be used to clear the watcher using {@link clearWatchBot}.
+     *
+     * @example Watch this bot for changes
+     * let unwatch = watchBot(thisBot, (bot, changedTags) => {
+     *   if (!bot) return; // Bot was destroyed
+     *   os.toast("The bot (" + bot.id.slice(0, 6) + ") changed! Changed tags: " + changedTags.join(", "));
+     * });
+     *
+     * @example Watch multiple bots for changes
+     * let unwatch = watchBot(getBots('color', 'red'), (bot, changedTags) => {
+     *   if (!bot) return; // Bot was destroyed
+     *   os.toast("A red bot (" + bot.id.slice(0, 6) + ") changed! Changed tags: " + changedTags.join(", "));
+     * });
+     *
+     * @dochash actions/data
+     * @docgroup 01-data-actions
+     * @docname watchBot
+     * @docid watchBot
+     */
+    function _watchBot(bot, handler) {
+        return null;
+    }
     function wrapGenerator(result) {
         if (isGenerator(result)) {
             const gen = result;
@@ -1167,6 +1143,24 @@ export function createDefaultLibrary(context) {
             return result;
         }
     }
+    /**
+     * Clears the watcher created by {@link watchBot}.
+     *
+     * @param id The ID of the watcher to clear.
+     *
+     * @example Clear a bot watcher
+     * let unwatch = watchBot(thisBot, (bot, changedTags) => {
+     *   os.toast("The bot (" + bot.id.slice(0, 6) + ") changed! Changed tags: " + changedTags.join(", "));
+     * });
+     *
+     * // When you want to clear it
+     * clearWatchBot(unwatch);
+     *
+     * @dochash actions/data
+     * @docgroup 01-data-actions
+     * @docname clearWatchBot
+     * @docid clearWatchBot
+     */
     function clearWatchBot(id) {
         context.cancelAndRemoveTimers(id, 'watch_bot');
     }
@@ -1198,38 +1192,6 @@ export function createDefaultLibrary(context) {
             }
         }
     }
-    function getAssertionValue(value) {
-        if (value instanceof Error) {
-            return value.toString();
-        }
-        return value;
-    }
-    /**
-     * Verifies that the given values are equal to each other.
-     * If they are not, then an error is thrown.
-     * This function is useful for automated testing since tests should ideally throw an error if the test fails.
-     * It can also be useful to make sure that some important code is only run if a precondition is met.
-     *
-     * @param first The first value to test.
-     * @param second The second value to test.
-     *
-     * @example Assert that the tag color is "blue"
-     * assertEqual(tags.color, "blue");
-     *
-     * @example Assert that the bot contains some specific tag values
-     * assertEqual(tags, {
-     *     color: "blue",
-     *     home: true,
-     *     homeX: 0,
-     *     homeY: 0
-     * });
-     *
-     * @dochash actions/debuggers
-     * @docname assertEqual
-     */
-    function assertEqual(first, second) {
-        expect(first).toEqual(second);
-    }
     /**
      * Gets an array of bots that match the given tag and value. The returned array is sorted alphabetically by the {@tag id} tag.
      *
@@ -2610,6 +2572,40 @@ export function createDefaultLibrary(context) {
     function exitFullscreenMode() {
         return addAction(exitFullscreen());
     }
+    /**
+     * Prompts the user to install the Progressive Web App (PWA).
+     *
+     * Returns a promise that resolves with an object containing the user's choice and platform information when they respond to the prompt. Rejects with an error if the feature is not supported (for example, on iOS devices).
+     *
+     * The returned object contains:
+     * - `outcome`: Either "accepted" or "dismissed" based on the user's choice
+     * - `platform`: The platform identifier (empty string if not provided)
+     *
+     * Note that this feature may not be available on all platforms and browsers. In particular:
+     * - iOS Safari does not support the PWA installation prompt
+     * - The prompt can only be triggered in response to user interaction
+     * - The prompt will only be shown if the app meets PWA installability criteria
+     *
+     * @example Prompt the user to install the PWA.
+     * try {
+     *     const result = await os.promptToInstallPWA();
+     *     if (result.outcome === 'accepted') {
+     *         os.toast("Thanks for installing!");
+     *     } else {
+     *         os.toast("Maybe next time!");
+     *     }
+     * } catch (error) {
+     *     os.toast("PWA installation is not available: " + error.message);
+     * }
+     *
+     * @dochash actions/os/system
+     * @docname os.promptToInstallPWA
+     */
+    function promptToInstallPWA() {
+        const task = context.createTask();
+        const event = calcPromptToInstallPWA(task.taskId);
+        return addAsyncAction(task, event);
+    }
     /**
      * Hides the loading screen.
      *
@@ -10865,6 +10861,8 @@ export function createDefaultLibrary(context) {
      * If null is provided, then a seed will be chosen in a somewhat unpredictable manner.
      *
      * @example Set the random seed for math.random() and math.randomInt().
+     * import expect from 'expect';
+     *
      * math.setRandomSeed(123);
      *
      * expect(math.randomInt(0, 10)).toBe(9);