@casual-simulation/aux-common 2.0.16 → 2.0.21

package/runtime/AuxLibrary.js

@@ -11,8 +11,8 @@ import { DEBUG_STRING, debugStringifyFunction, } from './AuxGlobalContext';
 import { hasValue, trimTag, isBot, BOT_SPACE_TAG, toast as toastMessage, showJoinCode as calcShowJoinCode, requestFullscreen, exitFullscreen, html as htmlMessage, hideHtml as hideHtmlMessage, setClipboard as calcSetClipboard, tweenTo as calcTweenTo, showChat as calcShowChat, hideChat as calcHideChat, runScript, enableAR as calcEnableAR, disableAR as calcDisableAR, enableVR as calcEnableVR, disableVR as calcDisableVR, showUploadAuxFile as calcShowUploadAuxFile, openQRCodeScanner as calcOpenQRCodeScanner, showQRCode as calcShowQRCode, openBarcodeScanner as calcOpenBarcodeScanner, showBarcode as calcShowBarcode, importAUX as calcImportAUX, showInputForTag as calcShowInputForTag, showInput as calcShowInput, replaceDragBot as calcReplaceDragBot, goToDimension as calcGoToDimension, goToURL as calcGoToURL, openURL as calcOpenURL, checkout as calcCheckout, playSound as calcPlaySound, bufferSound as calcBufferSound, cancelSound as calcCancelSound, setupServer as calcSetupServer, shell as calcShell, backupToGithub as calcBackupToGithub, backupAsDownload as calcBackupAsDownload, finishCheckout as calcFinishCheckout, markHistory as calcMarkHistory, browseHistory as calcBrowseHistory, restoreHistoryMark as calcRestoreHistoryMark, loadFile as calcLoadFile, saveFile as calcSaveFile, reject as calcReject, localFormAnimation as calcLocalFormAnimation, webhook as calcWebhook, superShout as calcSuperShout, share as calcShare, registerPrefix as calcRegisterPrefix, createCertificate as calcCreateCertificate, signTag as calcSignTag, revokeCertificate as calcRevokeCertificate, 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, unlockSpace, getRemoteCount, getServers, getRemotes, action, getServerStatuses, setSpacePassword, exportGpioPin, unexportGpioPin, setGpioPin, getGpioPin, rpioInitPin, rpioExitPin, rpioOpenPin, rpioModePin, rpioReadPin, rpioReadSequencePin, rpioWritePin, rpioWriteSequencePin, rpioReadpadPin, rpioWritepadPin, rpioPudPin, rpioPollPin, rpioClosePin, rpioI2CBeginPin, rpioI2CSetSlaveAddressPin, rpioI2CSetBaudRatePin, rpioI2CSetClockDividerPin, rpioI2CReadPin, rpioI2CWritePin, 
 // rpioI2CReadRegisterRestartPin,
 // rpioI2CWriteReadRestartPin,
-rpioI2CEndPin, rpioPWMSetClockDividerPin, rpioPWMSetRangePin, rpioPWMSetDataPin, rpioSPIBeginPin, rpioSPIChipSelectPin, rpioSPISetCSPolarityPin, rpioSPISetClockDividerPin, rpioSPISetDataModePin, rpioSPITransferPin, rpioSPIWritePin, rpioSPIEndPin, serialConnectPin, serialOpenPin, serialStreamPin, serialUpdatePin, serialWritePin, serialReadPin, serialClosePin, serialFlushPin, serialDrainPin, serialPausePin, serialResumePin, calculateAnchorPoint, calculateAnchorPointOffset, getBotPosition as calcGetBotPosition, isRuntimeBot, SET_TAG_MASK_SYMBOL, CLEAR_TAG_MASKS_SYMBOL, getBotScale, EDIT_TAG_SYMBOL, EDIT_TAG_MASK_SYMBOL, circleWipe, addDropSnap as calcAddDropSnap, 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, createBot, defineGlobalBot as calcDefineGlobalBot, TEMPORARY_BOT_PARTITION_ID, publishRecord as calcPublishRecord, DEFAULT_RECORD_SPACE, getRecords as calcGetRecords, requestPermanentAuthToken as calcRequestPermanentAuthToken, deleteRecord, } from '../bots';
-import { sortBy, every } from 'lodash';
+rpioI2CEndPin, rpioPWMSetClockDividerPin, rpioPWMSetRangePin, rpioPWMSetDataPin, rpioSPIBeginPin, rpioSPIChipSelectPin, rpioSPISetCSPolarityPin, rpioSPISetClockDividerPin, rpioSPISetDataModePin, rpioSPITransferPin, rpioSPIWritePin, rpioSPIEndPin, serialConnectPin, serialOpenPin, serialStreamPin, serialUpdatePin, serialWritePin, serialReadPin, serialClosePin, serialFlushPin, serialDrainPin, serialPausePin, serialResumePin, calculateAnchorPoint, calculateAnchorPointOffset, getBotPosition as calcGetBotPosition, isRuntimeBot, SET_TAG_MASK_SYMBOL, CLEAR_TAG_MASKS_SYMBOL, getBotScale, EDIT_TAG_SYMBOL, EDIT_TAG_MASK_SYMBOL, circleWipe, addDropSnap as calcAddDropSnap, 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, createBot, defineGlobalBot as calcDefineGlobalBot, TEMPORARY_BOT_PARTITION_ID, publishRecord as calcPublishRecord, DEFAULT_RECORD_SPACE, getRecords as calcGetRecords, requestPermanentAuthToken as calcRequestPermanentAuthToken, deleteRecord, convertToString, GET_TAG_MASKS_SYMBOL, isBotLink, parseBotLink, createBotLink, convertGeolocationToWhat3Words as calcConvertGeolocationToWhat3Words, } from '../bots';
+import { sortBy, every, cloneDeep, union, isEqual, flatMap } from 'lodash';
 import { remote as calcRemote, } from '@casual-simulation/causal-trees';
 import { RanOutOfEnergyError } from './AuxResults';
 import '../polyfill/Array.first.polyfill';
@@ -22,7 +22,7 @@ import { sha256 as hashSha256, sha512 as hashSha512, hmac } from 'hash.js';
 import stableStringify from '@casual-simulation/fast-json-stable-stringify';
 import { encrypt as realEncrypt, decrypt as realDecrypt, keypair as realKeypair, sign as realSign, verify as realVerify, asymmetricKeypair as realAsymmetricKeypair, asymmetricEncrypt as realAsymmetricEncrypt, asymmetricDecrypt as realAsymmetricDecrypt, isAsymmetricKeypair, isAsymmetricEncrypted, isEncrypted, } from '@casual-simulation/crypto';
 import { tagValueHash } from '../aux-format-2/AuxOpTypes';
-import { convertToString, del, insert, isTagEdit, preserve, } from '../aux-format-2';
+import { apply, del, insert, isTagEdit, preserve } from '../aux-format-2';
 import { Euler, Vector3, Plane, Ray, } from '@casual-simulation/three';
 import mime from 'mime';
 import TWEEN from '@tweenjs/tween.js';
@@ -31,12 +31,94 @@ import './BlobPolyfill';
 import { Fragment, h } from 'preact';
 import htm from 'htm';
 import { fromByteArray, toByteArray } from 'base64-js';
+import expect, { iterableEquality } from '@casual-simulation/expect';
 const _html = htm.bind(h);
 const html = ((...args) => {
     return _html(...args);
 });
 html.h = h;
 html.f = Fragment;
+/**
+ * The status codes that should be used to retry web requests.
+ */
+const DEFUALT_RETRY_STATUS_CODES = [
+    408,
+    429,
+    500,
+    502,
+    503,
+    504,
+    0, // Network Failure / CORS
+];
+/**
+ * The time to wait until another web request retry unless specified by the webhook options.
+ * Defaults to 3 seconds.
+ */
+const DEFAULT_RETRY_AFTER_MS = 3 * 1000;
+/**
+ * The maximum amount of time to wait before giving up on a set of requests.
+ * Defaults to 1 minute.
+ */
+const MAX_RETRY_AFTER_MS = 60 * 60 * 1000;
+/**
+ * The maximum number of times that a web request should be retried for.
+ */
+const MAX_RETRY_COUNT = 10;
+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) {
+    var _a;
+    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((_a = bot.masks) !== null && _a !== void 0 ? _a : {});
+    if (Object.keys(masks).length > 0) {
+        b.masks = masks;
+    }
+    return b;
+}
 /**
  * Creates a library that includes the default functions and APIs.
  * @param context The global context that should be used.
@@ -48,6 +130,14 @@ export function createDefaultLibrary(context) {
     };
     const webhookFunc = makeMockableFunction(webhook, 'webhook');
     webhookFunc.post = makeMockableFunction(webhook.post, 'webhook.post');
+    const shoutImpl = shout;
+    const shoutProxy = new Proxy(shoutImpl, {
+        get(target, name, reciever) {
+            return (arg) => {
+                return shout(name, arg);
+            };
+        },
+    });
     return {
         api: {
             getBots,
@@ -57,6 +147,10 @@ export function createDefaultLibrary(context) {
             getBotPosition,
             getID,
             getJSON,
+            getFormattedJSON,
+            getSnapshot,
+            diffSnapshots,
+            applyDiffToSnapshot,
             getTag,
             setTag,
             setTagMask,
@@ -71,9 +165,12 @@ export function createDefaultLibrary(context) {
             subtractMods,
             destroy,
             changeState,
+            getLink: createBotLinkApi,
+            getBotLinks,
+            updateBotLinks,
             superShout,
             priorityShout,
-            shout,
+            shout: shoutProxy,
             whisper,
             byTag,
             byID,
@@ -107,6 +204,7 @@ export function createDefaultLibrary(context) {
             clearWatchPortal,
             assert,
             assertEqual,
+            expect,
             html,
             os: {
                 sleep,
@@ -199,12 +297,16 @@ export function createDefaultLibrary(context) {
                 publishRecord: makeMockableFunction(publishRecord, 'os.publishRecord'),
                 getRecords: makeMockableFunction(getRecords, 'os.getRecords'),
                 destroyRecord: makeMockableFunction(destroyRecord, 'os.destroyRecord'),
+                convertGeolocationToWhat3Words,
                 setupInst: setupServer,
                 remotes,
                 instances: servers,
                 remoteCount: serverRemoteCount,
                 totalRemoteCount: totalRemoteCount,
                 instStatuses: serverStatuses,
+                get vars() {
+                    return context.global;
+                },
             },
             portal: {
                 registerPrefix,
@@ -472,11 +574,14 @@ export function createDefaultLibrary(context) {
      * @param second The second value to test.
      */
     function assertEqual(first, second) {
-        const json = getPrettyJSON(getAssertionValue(first));
-        const json2 = getPrettyJSON(getAssertionValue(second));
-        if (json !== json2) {
-            throw new Error(`Assertion failed.\n\nExpected: ${json2}\nReceived: ${json}`);
-        }
+        expect(first).toEqual(second);
+        // const json = getFormattedJSON(getAssertionValue(first));
+        // const json2 = getFormattedJSON(getAssertionValue(second));
+        // if (json !== json2) {
+        //     throw new Error(
+        //         `Assertion failed.\n\nExpected: ${json2}\nReceived: ${json}`
+        //     );
+        // }
     }
     /**
      * Gets a list of all the bots.
@@ -646,10 +751,37 @@ export function createDefaultLibrary(context) {
             };
         }
         else if (hasValue(filter)) {
-            return (bot) => {
-                let val = bot.tags[tag];
-                return hasValue(val) && filter === val;
-            };
+            if (isBotLink(filter)) {
+                const ids = parseBotLink(filter);
+                if (ids.length === 0) {
+                    return (bot) => {
+                        let val = bot.tags[tag];
+                        return val === filter;
+                    };
+                }
+                else if (ids.length === 1) {
+                    return (bot) => {
+                        let val = bot.tags[tag];
+                        return (ids[0] === val ||
+                            (isBotLink(val) &&
+                                parseBotLink(val).some((id) => id === ids[0])));
+                    };
+                }
+                else {
+                    return (bot) => {
+                        let val = bot.tags[tag];
+                        const valIds = parseBotLink(val);
+                        return (!!valIds &&
+                            ids.every((id1) => valIds.some((id2) => id1 === id2)));
+                    };
+                }
+            }
+            else {
+                return (bot) => {
+                    let val = bot.tags[tag];
+                    return hasValue(val) && filter === val;
+                };
+            }
         }
         else if (filter === null) {
             return (bot) => {
@@ -922,15 +1054,123 @@ export function createDefaultLibrary(context) {
         return stableStringify(data);
     }
     /**
-     * Gets JSON for the given data.
+     * Gets formatted JSON for the given data.
      * @param data The data.
      */
-    function getPrettyJSON(data) {
+    function getFormattedJSON(data) {
         if (hasValue(data === null || data === void 0 ? void 0 : data[ORIGINAL_OBJECT])) {
             return stableStringify(data[ORIGINAL_OBJECT], { space: 2 });
         }
         return stableStringify(data, { space: 2 });
     }
+    /**
+     * Gets a snapshot of the data that the bots contain.
+     * This is useful for getting all the tags and masks that are attached to the given bots.
+     * @param bots The array of bots to get the snapshot for.
+     */
+    function getSnapshot(bots) {
+        var _a;
+        if (!Array.isArray(bots)) {
+            return getSnapshot([bots]);
+        }
+        let state = {};
+        for (let bot of bots) {
+            let b = (state[bot.id] = {
+                id: bot.id,
+                tags: Object.assign({}, (typeof bot.tags.toJSON === 'function'
+                    ? bot.tags.toJSON()
+                    : bot.tags)),
+            });
+            if (bot.space) {
+                b.space = bot.space;
+            }
+            let masks = isRuntimeBot(bot)
+                ? bot[GET_TAG_MASKS_SYMBOL]()
+                : cloneDeep((_a = bot.masks) !== null && _a !== void 0 ? _a : {});
+            if (Object.keys(masks).length > 0) {
+                b.masks = masks;
+            }
+        }
+        return state;
+    }
+    /**
+     * Calculates the difference between the two given snapshots.
+     * @param first The first snapshot.
+     * @param second The second snapshot.
+     */
+    function diffSnapshots(first, second) {
+        const allIds = union(Object.keys(first), Object.keys(second));
+        let diff = {};
+        for (let id of allIds) {
+            const inFirst = id in first;
+            const inSecond = id in second;
+            if (inFirst && inSecond) {
+                // possibly updated
+                const firstBot = first[id];
+                const secondBot = second[id];
+                if (firstBot && secondBot) {
+                    let botDiff = {};
+                    let tagsDiff = diffTags(firstBot.tags, secondBot.tags);
+                    if (!!tagsDiff) {
+                        botDiff.tags = tagsDiff;
+                    }
+                    const firstBotMasks = firstBot.masks || {};
+                    const secondBotMasks = secondBot.masks || {};
+                    let masksDiff = {};
+                    let hasMasksDiff = false;
+                    const allMaskSpaces = union(Object.keys(firstBotMasks), Object.keys(secondBotMasks));
+                    for (let space of allMaskSpaces) {
+                        const firstMasks = firstBotMasks[space] || {};
+                        const secondMasks = secondBotMasks[space] || {};
+                        let tagsDiff = diffTags(firstMasks, secondMasks);
+                        if (!!tagsDiff) {
+                            hasMasksDiff = true;
+                            masksDiff[space] = tagsDiff;
+                        }
+                    }
+                    if (hasMasksDiff) {
+                        botDiff.masks = masksDiff;
+                    }
+                    if (!!tagsDiff || hasMasksDiff) {
+                        diff[id] = botDiff;
+                    }
+                }
+            }
+            else if (inFirst) {
+                // deleted
+                diff[id] = null;
+            }
+            else if (inSecond) {
+                // added
+                diff[id] = second[id];
+            }
+        }
+        return diff;
+        function diffTags(firstTags, secondTags) {
+            let tagsDiff = {};
+            let hasTagsDiff = false;
+            const allTags = union(Object.keys(firstTags), Object.keys(secondTags));
+            for (let tag of allTags) {
+                const firstValue = firstTags[tag];
+                const secondValue = secondTags[tag];
+                if (!isEqual(firstValue, secondValue)) {
+                    // updated, deleted, or added
+                    hasTagsDiff = true;
+                    tagsDiff[tag] = hasValue(secondValue) ? secondValue : null;
+                }
+            }
+            return hasTagsDiff ? tagsDiff : null;
+        }
+    }
+    /**
+     * Applies the given delta to the given snapshot and returns the result.
+     * This is essentially the opposite of diffSnapshots().
+     * @param snapshot The snapshot that the diff should be applied to.
+     * @param diff The delta that should be applied to the snapshot.
+     */
+    function applyDiffToSnapshot(snapshot, diff) {
+        return apply(snapshot, diff);
+    }
     // Actions
     /**
      * Shows a toast message to the user.
@@ -1917,6 +2157,15 @@ export function createDefaultLibrary(context) {
         const event = deleteRecord(token, address, space, task.taskId);
         return addAsyncAction(task, event);
     }
+    /**
+     * Converts the given geolocation to a what3words (https://what3words.com/) address.
+     * @param location The latitude and longitude that should be converted to a 3 word address.
+     */
+    function convertGeolocationToWhat3Words(location) {
+        const task = context.createTask();
+        const event = calcConvertGeolocationToWhat3Words(location, task.taskId);
+        return addAsyncAction(task, event);
+    }
     /**
      * Sends an event to the server to setup a new instance if it does not exist.
      * @param inst The instance.
@@ -2718,8 +2967,46 @@ export function createDefaultLibrary(context) {
      * @param options The options that should be used to send the webhook.
      */
     function webhook(options) {
+        if (options.retryCount > 0) {
+            return _retryWebhook(options);
+        }
+        else {
+            return _webhook(options);
+        }
+    }
+    function _retryWebhook(options) {
+        var _a, _b, _c, _d;
+        return __awaiter(this, void 0, void 0, function* () {
+            const retryCount = Math.min(options.retryCount, MAX_RETRY_COUNT);
+            const timeToWait = Math.max(0, Math.min((_a = options.retryAfterMs) !== null && _a !== void 0 ? _a : DEFAULT_RETRY_AFTER_MS, MAX_RETRY_AFTER_MS));
+            const statusCodes = (_b = options.retryStatusCodes) !== null && _b !== void 0 ? _b : DEFUALT_RETRY_STATUS_CODES;
+            let retries = 0;
+            while (true) {
+                try {
+                    return yield _webhook(options);
+                }
+                catch (err) {
+                    if (retries >= retryCount) {
+                        throw err;
+                    }
+                    else if (!statusCodes.includes((_d = (_c = err.response) === null || _c === void 0 ? void 0 : _c.status) !== null && _d !== void 0 ? _d : 0)) {
+                        throw err;
+                    }
+                    yield sleep(timeToWait);
+                    retries += 1;
+                }
+            }
+        });
+    }
+    function _webhook(options) {
         const task = context.createTask();
-        const event = calcWebhook(options, task.taskId);
+        const event = calcWebhook({
+            method: options.method,
+            url: options.url,
+            responseShout: options.responseShout,
+            data: options.data,
+            headers: options.headers,
+        }, task.taskId);
         return addAsyncAction(task, event);
     }
     /**
@@ -4172,7 +4459,7 @@ export function createDefaultLibrary(context) {
         destroyChildren(id);
     }
     function destroyChildren(id) {
-        const children = getBots('creator', id);
+        const children = getBots(byTag('creator', createBotLink([id])));
         for (let child of children) {
             destroyBot(child);
         }
@@ -4198,6 +4485,93 @@ export function createDefaultLibrary(context) {
         }
         whisper(bot, `${groupName}${stateName}OnEnter`, arg);
     }
+    /**
+     * Creates a tag value that can be used to link to the given bots.
+     * @param bots The bots that the link should point to.
+     */
+    function createBotLinkApi(...bots) {
+        let targets = flatMap(bots);
+        let result = [];
+        for (let t of targets) {
+            if (isBot(t)) {
+                result.push(t.id);
+            }
+            else {
+                let links = parseBotLink(t);
+                if (links) {
+                    result.push(...links);
+                }
+                else {
+                    result.push(t);
+                }
+            }
+        }
+        return createBotLink(result);
+    }
+    /**
+     * Gets the list of bot links that are stored in this bot's tags.
+     * @param bot The bot to get the links for.
+     */
+    function getBotLinks(bot) {
+        let links = [];
+        for (let tag of Object.keys(bot.tags)) {
+            const val = bot.tags[tag];
+            const ids = parseBotLink(val);
+            if (ids) {
+                links.push({
+                    tag,
+                    botIDs: ids,
+                });
+            }
+        }
+        return links;
+    }
+    /**
+     * Updates all the links in the given bot using the given ID map.
+     * Useful if you know that the links in the given bot are outdated and you know which IDs map to the new IDs.
+     * @param bot The bot to update.
+     * @param idMap The map of old IDs to new IDs that should be used.
+     */
+    function updateBotLinks(bot, idMap) {
+        let map;
+        if (idMap instanceof Map) {
+            map = idMap;
+        }
+        else if (typeof idMap === 'object') {
+            map = new Map();
+            for (let key in idMap) {
+                const newId = idMap[key];
+                if (typeof newId === 'string') {
+                    map.set(key, newId);
+                }
+                else if (isBot(newId)) {
+                    map.set(key, newId.id);
+                }
+            }
+        }
+        else {
+            return;
+        }
+        for (let tag of Object.keys(bot.tags)) {
+            const val = bot.tags[tag];
+            const ids = parseBotLink(val);
+            if (ids) {
+                const mapped = ids.map((id) => {
+                    if (map.has(id)) {
+                        const newId = map.get(id);
+                        if (typeof newId === 'string') {
+                            return newId;
+                        }
+                        else if (isBot(newId)) {
+                            return newId.id;
+                        }
+                    }
+                    return id;
+                });
+                bot.tags[tag] = createBotLink(mapped);
+            }
+        }
+    }
     /**
      * Shouts the given event to every bot in every loaded simulation.
      * @param eventName The name of the event to shout.