@casual-simulation/aux-runtime 3.2.7-alpha.6226622763

package/runtime/AuxLibrary.d.ts

@@ -0,0 +1,2566 @@
+import { AuxGlobalContext, DEBUG_STRING } from './AuxGlobalContext';
+import { BotTags, Bot, ShowChatOptions, BotAction, BotsState, CameraType, BarcodeFormat, PortalType, ShowInputOptions, LocalFormAnimationAction, ShareOptions, Easing, BotAnchorPoint, RuntimeBot, BotSpace, EaseType, RegisterPrefixOptions, OpenCircleWipeOptions, SuperShoutAction, ShowToastAction, ShowJoinCodeAction, RequestFullscreenAction, ExitFullscreenAction, ShowHtmlAction, HideHtmlAction, SetClipboardAction, FocusOnBotAction, ShowChatBarAction, EnableARAction, EnableVRAction, DownloadAction, ShowUploadAuxFileAction, OpenQRCodeScannerAction, ShowQRCodeAction, OpenBarcodeScannerAction, ShowBarcodeAction, LoadServerAction, UnloadServerAction, ReplaceDragBotAction, ShowInputForTagAction, GoToDimensionAction, GoToURLAction, OpenURLAction, OpenConsoleAction, RejectAction, FocusOnOptions, SnapTarget, AddDropSnapTargetsAction, RecordingOptions, Recording, SyntheticVoice, EnablePOVAction, EnableCustomDraggingAction, SetAppOutputAction, Record, RecordReference, PartialBotsState, ParsedBotLink, ConvertGeolocationToWhat3WordsOptions, BeginAudioRecordingAction, MediaPermssionOptions, ImageClassifierOptions, AddDropGridTargetsAction, InstUpdate, StartFormAnimationOptions, StopFormAnimationOptions, FormAnimationData, WakeLockConfiguration, EnableXROptions, ShowConfirmOptions, Geolocation, OpenPhotoCameraOptions, Photo } from '@casual-simulation/aux-common/bots';
+import { AIChatOptions, AIGenerateSkyboxOptions, AIGenerateImageOptions, JoinRoomActionOptions, RoomOptions, RoomTrackOptions, SetRoomTrackOptions, RoomRemoteOptions, DataRecordOptions, RecordActionOptions } from './RecordsEvents';
+import { RemoteAction } from '@casual-simulation/aux-common';
+import '@casual-simulation/aux-common/polyfill/Array.first.polyfill';
+import '@casual-simulation/aux-common/polyfill/Array.last.polyfill';
+import { isAsymmetricKeypair, isAsymmetricEncrypted, isEncrypted } from '@casual-simulation/crypto';
+import './PerformanceNowPolyfill';
+import '@casual-simulation/aux-common/BlobPolyfill';
+import { AuxDevice } from './AuxDevice';
+import { AuxVersion } from './AuxVersion';
+import { Vector3, Vector2, Quaternion, Rotation } from '@casual-simulation/aux-common/math';
+import { CreatePublicRecordKeyResult, GetDataResult, RecordDataResult, RecordFileFailure, EraseDataResult, EraseFileResult, ListDataResult, AddCountResult, GetCountResult, GrantMarkerPermissionResult, RevokeMarkerPermissionResult, GrantRoleResult, RevokeRoleResult } from '@casual-simulation/aux-records';
+import type { AIChatMessage, AvailablePermissions, ListStudiosResult } from '@casual-simulation/aux-records';
+import { DateTime } from 'luxon';
+import * as hooks from 'preact/hooks';
+import { render } from 'preact';
+import type { Breakpoint, InterpreterContinuation, InterpreterStop } from '@casual-simulation/js-interpreter';
+import { INTERPRETABLE_FUNCTION } from './AuxCompiler';
+import type { AuxRuntime } from './AuxRuntime';
+import { TagMapper } from './RuntimeEvents';
+/**
+ * Defines an interface for a function that provides HTML VDOM capabilities to bots.
+ */
+export interface HtmlFunction {
+    (...args: any[]): any;
+    h: (name: string | Function, props: any, ...children: any[]) => any;
+    f: any;
+}
+/**
+ * Creates a new interpretable function based on the given function.
+ * @param interpretableFunc
+ */
+export declare function createInterpretableFunction<TArg extends Array<any>, R>(interpretableFunc: (...args: TArg) => Generator<any, R, any>): {
+    (...args: TArg): R;
+    [INTERPRETABLE_FUNCTION]: (...args: TArg) => Generator<any, R, any>;
+};
+/**
+ * Sets the INTERPRETABLE_FUNCTION property on the given object (semantically a function) to the given interpretable version and returns the object.
+ * @param interpretableFunc The version of the function that should be used as the interpretable version of the function.
+ * @param normalFunc The function that should be tagged.
+ */
+export declare function tagAsInterpretableFunction<T, N>(interpretableFunc: T, normalFunc: N): N & {
+    [INTERPRETABLE_FUNCTION]: T;
+};
+/**
+ * Defines an interface for a library of functions and values that can be used by formulas and listeners.
+ */
+export interface AuxLibrary {
+    /**
+     * The functions that are part of the general API.
+     */
+    api: {
+        whisper(bot: (Bot | string)[] | Bot | string, eventName: string, arg?: any): any[];
+        shout(name: string, arg?: any): any[];
+        __energyCheck(): void;
+        [key: string]: any;
+    };
+    /**
+     * The functions that are part of the bot-specific API.
+     */
+    tagSpecificApi: {
+        [key: string]: (options: TagSpecificApiOptions) => any;
+    };
+    typeDefinitions?: string;
+}
+/**
+ * Defines the possible values that can be used as a tag filter.
+ *
+ * @dochash types/core
+ * @docgroup 01-core
+ * @docname TagFilter
+ */
+export type TagFilter = ((value: any) => boolean) | string | number | boolean | null | undefined;
+/**
+ * Defines a type that represents a mod.
+ * That is, a set of tags that can be applied to another bot.
+ *
+ * @dochash types/core
+ * @docgroup 01-core
+ * @docname Mod
+ */
+export type Mod = BotTags | Bot;
+/**
+ * An interface that is used to say which user/device/session an event should be sent to.
+ */
+export interface SessionSelector {
+    userId?: string;
+    sessionId?: string;
+    connectionId?: string;
+    broadcast?: boolean;
+}
+/**
+ * Defines a set of options for a webhook.
+ *
+ * @dochash types/web
+ * @doctitle Web Types
+ * @docsidebar Web
+ * @docdescription These types are used for web requests.
+ * @docname WebhookOptions
+ */
+export interface WebhookOptions {
+    /**
+     * The HTTP Method that the request should use.
+     */
+    method?: string;
+    /**
+     * The URL that the request should be made to.
+     */
+    url?: string;
+    /**
+     * The headers to include in the request.
+     *
+     * @docsource Headers
+     */
+    headers?: {
+        [key: string]: string;
+    };
+    /**
+     * The data to send with the request.
+     */
+    data?: any;
+    /**
+     * The shout that should be made when the request finishes.
+     */
+    responseShout?: string;
+    /**
+     * The number of retries that should be attempted for the webhook.
+     */
+    retryCount?: number;
+    /**
+     * The HTTP response status codes that should allow the web request to be retried.
+     */
+    retryStatusCodes?: number[];
+    /**
+     * The number of miliseconds to wait between retry requests.
+     */
+    retryAfterMs?: number;
+}
+/**
+ * Defines an interface that represents a request for {@link ai.generateSkybox-request}.
+ *
+ * @dochash types/ai
+ * @docname AIGenerateSkyboxRequest
+ */
+export interface AIGenerateSkyboxRequest {
+    /**
+     * The prompt that describes what the generated skybox should look like.
+     */
+    prompt: string;
+    /**
+     * The prompt that that describes what the generated skybox should avoid looking like.
+     */
+    negativePrompt?: string;
+    /**
+     * The options that should be included in the request.
+     */
+    options?: AIGenerateSkyboxOptions;
+}
+/**
+ * Defines an interface that represents the result from {@link ai.generateSkybox-request}.
+ *
+ * @dochash types/ai
+ * @docname AIGenerateSkyboxResult
+ */
+export interface AIGenerateSkyboxResult {
+    /**
+     * The URL that the generated skybox is located at.
+     */
+    fileUrl: string;
+    /**
+     * The URL that the thumbnail for the generated skybox is located at.
+     */
+    thumbnailUrl?: string;
+}
+/**
+ * Defines an interface that represents a result from {@link ai.generateImage-request}.
+ * @dochash types/ai
+ * @docname AIGenerateImageSuccess
+ */
+export interface AIGenerateImageAPISuccess {
+    success: true;
+    /**
+     * The list of images that were generated.
+     */
+    images: AIGeneratedImageAPI[];
+}
+/**
+ * Defines an interface that represents an AI generated image.
+ *
+ * @dochash types/ai
+ * @docname AIGeneratedImage
+ */
+export interface AIGeneratedImageAPI {
+    /**
+     * The base64 encoded image.
+     */
+    base64: string;
+    /**
+     * The URL that can be used to display the image.
+     */
+    url: string;
+    /**
+     * The seed of the generated image.
+     */
+    seed?: number;
+    /**
+     * The MIME Type of the image data.
+     */
+    mimeType: string;
+}
+/**
+ * Defines a set of options for {@link animateTag-byTag}.
+ *
+ * @dochash types/animation
+ * @doctitle Animation Types
+ * @docsidebar Animation
+ * @docdescription These types are used for animating tags.
+ * @docname AnimateTagOptions
+ */
+export interface AnimateTagFunctionOptions {
+    /**
+     * The value that should be animated from.
+     * If not specified then the current tag value will be used.
+     */
+    fromValue?: any;
+    /**
+     * The value that should be animated to.
+     */
+    toValue: any;
+    /**
+     * The duration of the animation in seconds.
+     */
+    duration: number;
+    /**
+     * The time that the animation should start.
+     * Should be the number of miliseconds since January 1st 1970 UTC-0. (e.g. os.localTime or os.agreedUponTime).
+     */
+    startTime?: number;
+    /**
+     * The type of easing to use.
+     * If not specified then "linear" "inout" will be used.
+     *
+     * Can also be a custom function that takes a single parameter and returns a number.
+     * The paramater will be a number between 0 and 1 indicating the progress through the tween.
+     */
+    easing?: EaseType | Easing | ((progress: number) => number);
+    /**
+     * The space that the tag should be animated in.
+     * If not specified then "tempLocal" will be used.
+     * If false, then the bot will be edited instead of using tag masks.
+     */
+    tagMaskSpace?: BotSpace | false;
+}
+/**
+ * Defines a bot filter function.
+ *
+ * Common bot filters are {@link byTag}
+ *
+ * @dochash types/core
+ * @docgroup 01-core
+ * @docname BotFilter
+ */
+export type BotFilter = ((bot: Bot) => boolean) | null;
+/**
+ * Defines a bot filter function.
+ */
+export interface BotFilterFunction {
+    (bot: Bot): boolean;
+    sort?: (bot: Bot) => any;
+    [DEBUG_STRING]?: string;
+}
+export interface RecordFilter {
+    recordFilter: true;
+    [DEBUG_STRING]?: string;
+}
+export interface AuthIdRecordFilter extends RecordFilter {
+    authID: string;
+}
+export interface SpaceFilter extends BotFilterFunction, RecordFilter {
+    space: string;
+    toJSON: () => RecordFilter;
+}
+export interface AddressRecordFilter extends RecordFilter {
+    address: string;
+}
+export interface IDRecordFilter extends BotFilterFunction, RecordFilter {
+    id: string;
+    toJSON: () => RecordFilter;
+}
+export type RecordFilters = AuthIdRecordFilter | SpaceFilter | AddressRecordFilter | IDRecordFilter | RecordReference;
+/**
+ * Defines the options for {@link experiment.speakText}.
+ *
+ * @dochash types/experimental
+ * @docname SpeakTextOptions
+ */
+export interface SpeakTextApiOptions {
+    /**
+     * The rate that the text should be spoken at.
+     * This can be any positive number.
+     */
+    rate?: number;
+    /**
+     * The pitch that the text should be spoken at.
+     * This can be any positive number.
+     */
+    pitch?: number;
+    /**
+     * The voice that the text should be spoken with.
+     * This can be the voice object or the name of a voice.
+     * Note that not all browsers support the same voices.
+     */
+    voice?: string | SyntheticVoice;
+}
+/**
+ * Defines a set of options for a tween.
+ *
+ * @dochash types/experimental
+ * @docname TweenOptions
+ */
+export interface TweenOptions {
+    /**
+     * The easing for the tween.
+     */
+    easing?: Easing;
+    /**
+     * The duration of the tween in seconds.
+     */
+    duration?: number;
+}
+/**
+ * Defines an interface that contains performance statistics about a inst.
+ */
+export interface PerformanceStats {
+    /**
+     * The number of bots in the inst.
+     */
+    numberOfBots: number;
+    /**
+     * A list of listen tags and the amount of time spent executing them (in miliseconds).
+     * Useful to guage if a listen tag is causing the inst to slow down.
+     */
+    shoutTimes: {
+        tag: string;
+        timeMs: number;
+    }[];
+    /**
+     * The total number of active setTimeout() and setInterval() timers that are active.
+     */
+    numberOfActiveTimers: number;
+    loadTimes: {
+        [key: string]: number;
+    };
+}
+/**
+ * Options needed for the Bot-specific API.
+ */
+export interface TagSpecificApiOptions {
+    /**
+     * The Bot that the API is for.
+     */
+    bot: Bot;
+    /**
+     * The tag that the API is for.
+     */
+    tag: string;
+    /**
+     * The bot that is set as the creator of the current bot.
+     */
+    creator: RuntimeBot;
+    /**
+     * The bot that is set as the config of the current bot.
+     */
+    config: RuntimeBot;
+}
+/**
+ * Defines an interface that represents a set of records that were retrieved.
+ */
+export interface GetRecordsResult {
+    /**
+     * The set of records that were retrieved.
+     */
+    records: Record[];
+    /**
+     * The total number of records that the query would have returned.
+     */
+    totalCount: number;
+    /**
+     * Whether there are more records available to retrieve for the query.
+     */
+    hasMoreRecords: boolean;
+    /**
+     * Gets the set page of records.
+     */
+    getMoreRecords(): Promise<GetRecordsResult>;
+}
+export declare const GET_RUNTIME: unique symbol;
+/**
+ * Defines an interface for objects that represent a debugger and can retrieve their internal runtime.
+ */
+export interface DebuggerInterface {
+    /**
+     * Gets the runtime for the debugger.
+     */
+    [GET_RUNTIME]: () => AuxRuntime;
+}
+export interface DebuggerBase {
+    /**
+     * Gets the list of portal bots in the debugger.
+     */
+    getPortalBots(): Map<string, Bot>;
+    /**
+     * Gets the list of action objects that have been performed by bots in the current debugger.
+     * Action objects are used by CasualOS to represent changes to bots or external effects that should be performed.
+     * Examples of this are {@link create}, {@link os.toast} and {@link os.enableVR}.
+     *
+     * @example Get the list of bot changes and actions that have been performed in a debugger
+     * const debug = await os.createDebugger();
+     * debug.create({
+     *     test: '@os.toast("Hello")'
+     * });
+     * debug.shout("test");
+     *
+     * const actions = debug.getAllActions();
+     *
+     * assertEqual(actions, [
+     *     {
+     *         type: 'add_bot',
+     *         id: 'uuid-1',
+     *         bot: {
+     *             id: 'uuid-1',
+     *             tags: {
+     *                 test: '@os.toast("Hello")'
+     *             }
+     *         }
+     *     },
+     *     {
+     *         type: 'show_toast',
+     *         message: 'Hello',
+     *         duration: 2000
+     *     }
+     * ]);
+     */
+    getAllActions(): BotAction[];
+    /**
+     * Gets the list of common action objects that have been performed by bots in the current debugger. Action objects are used by CasualOS to represent changes to bots or external effects that should be performed.
+     * Common actions are actions that do not immediately change bots or bot tags or masks.
+     *
+     * Examples of common actions are {@link os.toast} and {@link os.enableVR}.
+     *
+     * @example Get the list of actions that have been performed in a debugger
+     * const debug = await os.createDebugger();
+     * debug.create({
+     *     test: '@os.toast("Hello")'
+     * });
+     * debug.shout("test");
+     *
+     * const actions = debug.getCommonActions();
+     *
+     * assertEqual(actions, [
+     *     {
+     *         type: 'show_toast',
+     *         message: 'Hello',
+     *         duration: 2000
+     *     }
+     * ]);
+     */
+    getCommonActions(): BotAction[];
+    /**
+     * Gets the list of bot actions that have been performed by bots in the current debugger.
+     * Action objects are used by CasualOS to represent changes to bots or external effects that should be performed.
+     * Bot actions are actions that immediately change bots or bot tags or masks.
+     *
+     * Examples of bot actions are {@link create}, {@link destroy} or {@link setTagMask}.
+     *
+     * @example Get the list of bot changes that have been performed in a debugger
+     * const debug = await os.createDebugger();
+     * debug.create({
+     *     test: '@os.toast("Hello")'
+     * });
+     * debug.shout("test");
+     *
+     * const actions = debug.getBotActions();
+     *
+     * assertEqual(actions, [
+     *     {
+     *         type: 'add_bot',
+     *         id: 'uuid-1',
+     *         bot: {
+     *             id: 'uuid-1',
+     *             tags: {
+     *                 test: '@os.toast("Hello")'
+     *             }
+     *         }
+     *     },
+     * ]);
+     */
+    getBotActions(): BotAction[];
+    /**
+     * Gets the list of errors that have occurred in the current debugger. Errors occur when an exceptional event happens in a script and prevents the rest of the script from executing.
+     *
+     * Debuggers capture these errors and let you inspect them afterwards.
+     *
+     * @example Get the list of errors that have happened in a debugger
+     * const debug = await os.createDebugger();
+     * debug.create({
+     *     test: '@throw new Error("My Error")'
+     * });
+     * debug.shout("test");
+     *
+     * const errors = debug.getErrors();
+     *
+     * assertEqual(errors.length, 1);
+     * assertEqual(errors[0].error, new Error("My Error"));
+     * assertEqual(errors[0].tag, "test");
+     */
+    getErrors(): any[];
+    /**
+     * Registers the given handler to be called before a bot action is executed in this debugger.
+     * @param handler The handler that should be called.
+     */
+    onBeforeAction(handler: (action: BotAction) => void): void;
+    /**
+     * Registers the given handler to be called after a bot action is executed in this debugger.
+     * @param handler The handler that should be called.
+     */
+    onAfterAction(handler: (action: BotAction) => void): void;
+    /**
+     * Registers the given handler function to be called before a user action is performed in the debugger.
+     *
+     * User actions are like normal actions, except they are generated by the CasualOS frontend.
+     * Generally, this only happens for built-in shouts and whispers.
+     * Additionally, these actions can only be automatically created for debuggers that are attached using {@link os.attachDebugger}.
+     *
+     * @param listener the function that should be called before a user action is performed.
+     *
+     * @example Listen for tag updates in a debugger
+     * const debug = await os.createDebugger({
+     *     pausable: true
+     * });
+     *
+     * // Register a listener that gets called whenever a user action is about to be performed.
+     * debug.onBeforeUserAction(update => {
+     *     console.log('user action', update);
+     * });
+     *
+     * // Because the debugger is pausable, the create() function returns a promise
+     * // because it calls @onCreate which could cause a pause trigger to be hit.
+     * const debuggerBot = await debug.create({
+     *     home: true,
+     * });
+     *
+     * // Attach the debugger to the front end
+     * await os.attachDebugger(debug);
+     *
+     * @docname onBeforeUserAction
+     * @docid debug.onBeforeUserAction
+     */
+    onBeforeUserAction(listener: (action: BotAction) => void): void;
+    /**
+     * Registers the given handler function to be called by the debugger whenever a script enqueues an action.
+     * This occurrs for common actions like {@link os.toast} and {@link os.showInput}.
+     *
+     * Every action that is enqueued ends up being performed.
+     *
+     * @param listener the function that should be called whenever an action is scheduled to be performed.
+     *
+     * @example Listen for actions to be enqueued in a debugger
+     * const debug = await os.createDebugger({
+     *     pausable: true
+     * });
+     *
+     * // Register a listener that gets called whenever an action is scheduled to be performed.
+     * debug.onScriptActionEnqueued(action => {
+     *     console.log('action enqueued', action);
+     * });
+     *
+     * // Because the debugger is pausable, the create() function returns a promise
+     * // because it calls @onCreate which could cause a pause trigger to be hit.
+     * const debuggerBot = await debug.create({
+     *     test: '@let abc = 123; os.toast(abc);'
+     * });
+     *
+     * // Send a shout. Just like the create() function above, we recieve a promise that we can await.
+     * await debug.shout('test');
+     */
+    onScriptActionEnqueued(listener: (action: BotAction) => void): void;
+    /**
+     * Registers the given handler function to be called after any tag is updated in the debugger.
+     *
+     * @param listener the function that should be called when a tag is updated.
+     *
+     * @example Listen for tag updates in a debugger
+     * const debug = await os.createDebugger({
+     *     pausable: true
+     * });
+     *
+     * // Register a listener that gets called whenever a tag is updated.
+     * debug.onAfterScriptUpdatedTag(update => {
+     *     console.log('tag updated', update);
+     * });
+     *
+     * // Because the debugger is pausable, the create() function returns a promise
+     * // because it calls @onCreate which could cause a pause trigger to be hit.
+     * const debuggerBot = await debug.create({
+     *     test: '@tags.message = "hello, world";'
+     * });
+     *
+     * // Send a shout. Just like the create() function above, we recieve a promise that we can await.
+     * await debug.shout('test');
+     */
+    onAfterScriptUpdatedTag(listener: (update: DebuggerTagUpdate) => void): void;
+    /**
+     * Registers the given handler function to be called after any tag mask is updated in the debugger.
+     *
+     * @param listener the function that should be called when a tag mask is updated.
+     *
+     * @example Listen for tag mask updates in a debugger
+     * const debug = await os.createDebugger({
+     *     pausable: true
+     * });
+     *
+     * // Register a listener that gets called whenever a tag mask is updated.
+     * debug.onAfterScriptUpdatedTagMask(update => {
+     *     console.log('tag mask updated', update);
+     * });
+     *
+     * // Because the debugger is pausable, the create() function returns a promise
+     * // because it calls @onCreate which could cause a pause trigger to be hit.
+     * const debuggerBot = await debug.create({
+     *     test: '@masks.message = "hello, world";'
+     * });
+     *
+     * // Send a shout. Just like the create() function above, we recieve a promise that we can await.
+     * await debug.shout('test');
+     */
+    onAfterScriptUpdatedTagMask(listener: (update: DebuggerTagMaskUpdate) => void): void;
+    /**
+     * Performs the given actions in order as if they were user actions.
+     *
+     * This function works similarly to {@link action.perform} except that actions performed with it will also call handlers registered with {@link debug.onBeforeUserAction}.
+     * @param actions the actions that should be performed.
+     */
+    performUserAction(...actions: BotAction[]): Promise<(any[] | null)[]>;
+    /**
+     * The web actions that are available in this debugger.
+     *
+     * @docreferenceactions ^web\.
+     * @docsource WebActions
+     */
+    web: {};
+    /**
+     * The OS actions that are available in this debugger.
+     *
+     * @docreferenceactions ^os\.
+     * @docsource OSActions
+     */
+    os: {};
+    /**
+     * The action-related actions that are available in this debugger.
+     *
+     * @docreferenceactions ^action\.
+     * @docsource ActionActions
+     */
+    action: {};
+}
+/**
+ * Defines the possible types that represent a debugger.
+ *
+ * @dochash types/debuggers
+ * @docname Debugger
+ */
+export type Debugger = NormalDebugger | PausableDebugger;
+/**
+ * Defines an interface that represents a debugger.
+ *
+ * @dochash types/debuggers/debugger
+ * @doctitle Debugger
+ * @docsidebar Debugger
+ * @docdescription Defines an interface that represents a debugger.
+ * @docname Debugger
+ * @docreferenceactions ^\w+$
+ */
+export interface NormalDebugger extends DebuggerBase {
+}
+/**
+ * Defines an interface that represents a pausable debugger.
+ *
+ * @dochash types/debuggers/pausable-debugger
+ * @doctitle Pausable Debugger
+ * @docsidebar Pausable Debugger
+ * @docdescription Defines an interface that represents a pausable debugger.
+ * @docname PausableDebugger
+ * @docreferenceactions ^\w+$
+ */
+export interface PausableDebugger extends DebuggerBase {
+    /**
+     * Registers the given function to be called whenever the debugger is paused by hitting a pause trigger.
+     *
+     * @param handler the function that should be called when the debugger is paused.
+     *
+     * @example Listen for pauses on a debugger
+     * const debug = await os.createDebugger({
+     *     pausable: true
+     * });
+     *
+     * debug.onPause(pause => {
+     *     console.log('pause happened!', pause);
+     * });
+     *
+     * @docname onPause
+     * @docid debug.onPause
+     */
+    onPause(handler: (pause: DebuggerPause) => void): void;
+    /**
+     * Registers or updates a pause trigger with a debugger. Returns the newly created trigger.
+     *
+     * Pause triggers can be used to tell the debugger where you want it to temporarily stop execution. You specify the bot, tag, line and column numbers, and the debugger will stop before it executes the code at that location.
+     * Additionally, the debugger will call all handlers that have been registered with {@link debug.onPause}.
+     *
+     * @param trigger The trigger that should be registered or updated.
+     *
+     * @docname setPauseTrigger
+     * @docid debug.setPauseTrigger-trigger
+     */
+    _setPauseTrigger_trigger(trigger: PauseTrigger): PauseTrigger;
+    /**
+     * Registers or updates a pause trigger with this debugger.
+     * Pause triggers can be used to tell the debugger when you want it to stop execution.
+     * You specify the bot, tag, line and column numbers and the debugger will stop before/after it executes the code at that location.
+     * @param botOrIdOrTrigger the bot, or bot ID that should be registered.
+     * @param tag the name of the tag that the trigger should be set on.
+     * @param options The options that go with this pause trigger.
+     *
+     * @example Set a pause trigger on a script
+     * const debug = await os.createDebugger({
+     *     pausable: true
+     * });
+     *
+     * const b = await debug.create({
+     *     test: '@os.toast("Hello, World!")'
+     * });
+     *
+     * const trigger = debug.setPauseTrigger(b, 'test', {
+     *     lineNumber: 1,
+     *     columnNumber: 1
+     * });
+     *
+     * @example Update a pause trigger on a script
+     * const debug = await os.createDebugger({
+     *     pausable: true
+     * });
+     *
+     * const b = await debug.create({
+     *     test: '@os.toast("Hello, World!")'
+     * });
+     *
+     * let trigger = debug.setPauseTrigger(b, 'test', {
+     *     lineNumber: 1,
+     *     columnNumber: 1
+     * });
+     *
+     * trigger = debug.setPauseTrigger({
+     *     ...trigger,
+     *     states: ['before', 'after']
+     * });
+
+     * @docname setPauseTrigger
+     * @docid debug.setPauseTrigger-botOrId
+     */
+    _setPauseTrigger_botOrId(botOrIdOrTrigger: Bot | string, tag?: string, options?: PauseTriggerOptions): PauseTrigger;
+    /**
+     * Removes the given pause trigger from the debugger.
+     * @param triggerOrId the trigger or trigger ID that should be removed from the debugger.
+     *
+     * @example Remove a pause trigger
+     * const debug = await os.createDebugger({
+     *     pausable: true
+     * });
+     *
+     * const b = await debug.create({
+     *     test: '@os.toast("Hello, World!")'
+     * });
+     *
+     * const trigger = debug.setPauseTrigger(b, 'test', {
+     *     lineNumber: 1,
+     *     columnNumber: 1
+     * });
+     *
+     * debug.removePauseTrigger(trigger);
+     */
+    removePauseTrigger(triggerOrId: string | PauseTrigger): void;
+    /**
+     * Disables the given pause trigger.
+     * Disabled pause triggers will continue to be listed with {@link debug.listPauseTriggers}, but will not cause a pause to happen while they are disabled.
+     *
+     * @param triggerOrId The trigger or trigger ID that should be disabled.
+     *
+     * @example Disable a pause trigger
+     * const debug = await os.createDebugger({
+     *     pausable: true
+     * });
+     *
+     * const b = await debug.create({
+     *     test: '@os.toast("Hello, World!")'
+     * });
+     *
+     * const trigger = debug.setPauseTrigger(b, 'test', {
+     *     lineNumber: 1,
+     *     columnNumber: 1
+     * });
+     *
+     * debug.disablePauseTrigger(trigger);
+     */
+    disablePauseTrigger(triggerOrId: string | PauseTrigger): void;
+    /**
+     * Enables the given pause trigger
+     * @param triggerOrId The trigger or trigger ID that should be enabled.
+     *
+     * @example Enable a pause trigger
+     * const debug = await os.createDebugger({
+     *     pausable: true
+     * });
+     *
+     * const b = await debug.create({
+     *     test: '@os.toast("Hello, World!")'
+     * });
+     *
+     * const trigger = debug.setPauseTrigger(b, 'test', {
+     *     lineNumber: 1,
+     *     columnNumber: 1,
+     *     enabled: false
+     * });
+     *
+     * debug.enablePauseTrigger(trigger);
+     */
+    enablePauseTrigger(triggerOrId: string | PauseTrigger): void;
+    /**
+     * Gets the list of pause triggers that have been registered with this debugger.
+     *
+     * @example List the triggers that are set on this debugger
+     * const debug = await os.createDebugger({
+     *     pausable: true
+     * });
+     *
+     * const b = await debug.create({
+     *     test: '@os.toast("Hello, World!")'
+     * });
+     *
+     * const trigger = debug.setPauseTrigger(b, 'test', {
+     *     lineNumber: 1,
+     *     columnNumber: 1,
+     *     enabled: false
+     * });
+     *
+     * const triggers = debug.listPauseTriggers();
+     *
+     * @docname listPauseTriggers
+     * @docid debug.listPauseTriggers
+     */
+    listPauseTriggers(): PauseTrigger[];
+    /**
+     * Gets a list of common trigger locations for the specified tag on the specified bot. Returns an array containing the list of possible pause trigger locations.
+     *
+     * @param botOrId the bot or bot ID that the locations should be listed for.
+     * @param tag the name of the tag that the locations should be listed for.
+     *
+     * @example List common trigger locations for a script
+     * const debug = await os.createDebugger({
+     *     pausable: true
+     * });
+     *
+     * const b = await debug.create({
+     *     test: '@os.toast("Hello, World!")'
+     * });
+     *
+     * const triggerLocations = debug.listCommonPauseTriggers(b, 'test');
+     *
+     * @example Register a trigger from a common location
+     * const debug = await os.createDebugger({
+     *     pausable: true
+     * });
+     *
+     * const b = await debug.create({
+     *     test: '@os.toast("Hello, World!")'
+     * });
+     *
+     * const triggerLocations = debug.listCommonPauseTriggers(b, 'test');
+     *
+     * const trigger = debug.setPauseTrigger(b, 'test', {
+     *     lineNumber: triggerLocations[0].lineNumber,
+     *     columnNumber: triggerLocations[0].columnNumber,
+     *     states: triggerLocations[0].possibleStates
+     * });
+     */
+    listCommonPauseTriggers(botOrId: Bot | string, tag: string): PossiblePauseTriggerLocation[];
+    /**
+     * Resumes the debugger execution from the given pause.
+     * @param pause the debugger pause that was passed to the handler of {@link debug.onPause}.
+     *
+     * @example Resume execution on a debugger
+     * const debug = await os.createDebugger({
+     *     pausable: true
+     * });
+     *
+     * // Register a listener that gets called whenever a pause happens in this debugger.
+     * debug.onPause(pause => {
+     *     // Get the current stack frame from the pause
+     *     const currentFrame = pause.callStack[pause.callStack.length - 1];
+     *
+     *     // Set the abc variable to 999
+     *     currentFrame.setVariableValue('abc', 999);
+     *
+     *     // Resume execution after the pause.
+     *     debug.resume(pause);
+     * });
+     *
+     * // Because the debugger is pausable, the create() function returns a promise
+     * // because it calls @onCreate which could cause a pause trigger to be hit.
+     * const debuggerBot = await debug.create({
+     *     test: '@let abc = 123; os.toast(abc);'
+     * });
+     *
+     * // Set a pause trigger in the "test" script of the bot we just created
+     * // at line 1 column 16
+     * const trigger = debug.setPauseTrigger(debuggerBot, 'test', {
+     *     lineNumber: 1,
+     *     columnNumber: 16
+     * });
+     *
+     * // Send a shout. Just like the create() function above, we recieve a promise that we can await.
+     * await debug.shout('test');
+     *
+     * // Get the resulting actions from the debugger
+     * // and perform the first one. This should be the os.toast(), but instead of printing 123,
+     * // it should print 999 because we changed the value of abc during the debugger pause.
+     * const actions = debug.getCommonActions();
+     * action.perform(actions[0]);
+     */
+    resume(pause: DebuggerPause): void;
+    /**
+     * Gets the current call stack for the debugger. Call stacks are useful for determining program flow and how scripts interact with each other.
+     *
+     * @example Get the call stack from a debugger
+     * const debug = os.createDebugger({
+     *     pausable: true
+     * });
+     *
+     * const callStack = debug.getCallStack();
+     */
+    getCallStack(): DebuggerCallFrame[];
+    /**
+     * Creates a new bot and returns it.
+     * @param parent The bot that should be the parent of the new bot.
+     * @param mods The mods which specify the new bot's tag values. If given a mod with no tags, then an error will be thrown.
+     * @returns The bot(s) that were created.
+     *
+     * @example Create a red bot without a parent.
+     * let debugger = await os.createDebugger({
+     *     pausable: true
+     * });
+     * let redBot = await debugger.create(null, { "color": "red" });
+     *
+     * @example Create a red bot and a blue bot with `this` as the parent.
+     * let debugger = await os.createDebugger({
+     *     pausable: true
+     * });
+     * let [redBot, blueBot] = await debugger.create(this, [
+     *    { "color": "red" },
+     *    { "color": "blue" }
+     * ]);
+     */
+    create(...mods: Mod[]): Promise<Bot | Bot[]>;
+    /**
+     * Destroys the given bot, bot ID, or list of bots.
+     * @param bot The bot, bot ID, or list of bots to destroy.
+     */
+    destroy(bot: Bot | string | Bot[]): Promise<void>;
+    /**
+     * Shouts the given events in order until a bot returns a result.
+     * Returns the result that was produced or undefined if no result was produced.
+     * @param eventNames The names of the events to shout.
+     * @param arg The argument to shout.
+     */
+    priorityShout(eventNames: string[], arg?: any): Promise<any>;
+    /**
+     * Asks every bot in the inst to run the given action.
+     * In effect, this is like shouting to a bunch of people in a room.
+     *
+     * @param name The event name.
+     * @param arg The optional argument to include in the shout.
+     * @returns Returns a list which contains the values returned from each script that was run for the shout.
+     *
+     * @example Tell every bot to reset themselves.
+     * let debugger = await os.createDebugger({
+     *     pausable: true
+     * });
+     * await debugger.shout("reset()");
+     *
+     * @example Ask every bot for its name.
+     * let debugger = await os.createDebugger({
+     *     pausable: true
+     * });
+     * const names = await debugger.shout("getName()");
+     *
+     * @example Tell every bot say "Hi" to you.
+     * let debugger = await os.createDebugger({
+     *     pausable: true
+     * });
+     * await debugger.shout("sayHi()", "My Name");
+     */
+    shout(name: string, arg?: any): Promise<any[]>;
+    /**
+     * Asks the given bots to run the given action.
+     * In effect, this is like whispering to a specific set of people in a room.
+     *
+     * @param bot The bot(s) to send the event to.
+     * @param eventName The name of the event to send.
+     * @param arg The optional argument to include.
+     * @returns Returns a list which contains the values returned from each script that was run for the shout.
+     */
+    whisper(bot: (Bot | string)[] | Bot | string, eventName: string, arg?: any): Promise<any>;
+    /**
+     * Changes the state that the given bot is in.
+     * @param bot The bot to change.
+     * @param stateName The state that the bot should move to.
+     * @param groupName The group of states that the bot's state should change in. (Defaults to "state")
+     */
+    changeState(bot: Bot, stateName: string, groupName?: string): Promise<void>;
+}
+/**
+ * Defines an interface for a possible pause trigger location.
+ *
+ * @dochash types/debuggers/common
+ * @docname PossiblePauseTriggerLocation
+ */
+export interface PossiblePauseTriggerLocation {
+    /**
+     * The line number that the trigger would pause the debugger at.
+     */
+    lineNumber: number;
+    /**
+     * The column number that the trigger would pause the debugger at.
+     */
+    columnNumber: number;
+    /**
+     * The states that are reasonable for this pause trigger to stop at.
+     */
+    possibleStates: PossiblePauseTriggerStates;
+}
+/**
+ * The possible states that a pause trigger can be set to.
+ *
+ * @dochash types/debuggers/common
+ * @docname PossiblePauseTriggerStates
+ */
+export type PossiblePauseTriggerStates = ['before' | 'after'] | ['before', 'after'];
+/**
+ * Defines an interface for a debugger trace that represents when a tag was updated.
+ *
+ * @dochash types/debuggers/common
+ * @docname DebuggerTagUpdate
+ */
+export interface DebuggerTagUpdate {
+    /**
+     * The ID of the bot that was updated.
+     */
+    botId: string;
+    /**
+     * The tag that was updated.
+     */
+    tag: string;
+    /**
+     * The old value of the tag.
+     */
+    oldValue: any;
+    /**
+     * The new value for the tag.
+     */
+    newValue: any;
+}
+/**
+ * Defines an interface for a debugger trace that represents when a tag mask was updated.
+ *
+ * @dochash types/debuggers/common
+ * @docname DebuggerTagMaskUpdate
+ */
+export interface DebuggerTagMaskUpdate extends DebuggerTagUpdate {
+    /**
+     * The space of the tag mask.
+     */
+    space: string;
+}
+/**
+ * Defines an interface that contains options for attaching a debugger.
+ *
+ * @dochash types/debuggers/common
+ * @doctitle Common
+ * @docsidebar Common
+ * @docdescription Defines common interfaces related to debuggers.
+ * @docname AttachDebuggerOptions
+ */
+export interface AttachDebuggerOptions {
+    /**
+     * Gets the tag name mapper that should be used.
+     * This is useful for ensuring that the debugger objects utilize different tag names for the front end.
+     */
+    tagNameMapper?: TagMapper;
+}
+/**
+ * Defines an interface that contains options for a debugger.
+ */
+export interface CommonDebuggerOptions {
+    /**
+     * Whether to use "real" UUIDs instead of predictable ones.
+     */
+    useRealUUIDs?: boolean;
+    /**
+     * Whether to allow scripts to be asynchronous.
+     * If false, then all scripts will be forced to be synchronous.
+     * Defaults to true.
+     */
+    allowAsynchronousScripts?: boolean;
+    /**
+     * The data that the configBot should be created from.
+     * Can be a mod or another bot.
+     */
+    configBot?: Bot | BotTags;
+}
+/**
+ * Defines an interface that contains options for a normal debugger.
+ * That is, a debugger that is not pausable.
+ *
+ * @dochash types/debuggers/common
+ * @docname NormalDebuggerOptions
+ */
+export interface NormalDebuggerOptions extends CommonDebuggerOptions {
+    pausable?: false;
+}
+/**
+ * Defines an interface that contains options for a pausable debugger.
+ * That is, a debugger that is pausable.
+ *
+ * @dochash types/debuggers/common
+ * @docname PausableDebuggerOptions
+ */
+export interface PausableDebuggerOptions extends CommonDebuggerOptions {
+    pausable: true;
+}
+/**
+ * Defines an interface that contains options for an aux debugger.
+ *
+ * @dochash types/debuggers/common
+ * @docname DebuggerOptions
+ */
+export interface AuxDebuggerOptions {
+    /**
+     * Whether the debugger should be pausable.
+     */
+    pausable: boolean;
+    /**
+     * Whether to use "real" UUIDs instead of predictable ones.
+     */
+    useRealUUIDs: boolean;
+    /**
+     * Whether to allow scripts to be asynchronous.
+     * If false, then all scripts will be forced to be synchronous.
+     * Defaults to true.
+     */
+    allowAsynchronousScripts: boolean;
+    /**
+     * The data that the configBot should be created from.
+     * Can be a mod or another bot.
+     */
+    configBot: Bot | BotTags;
+}
+/**
+ * Defines an interface that contains options for a pause trigger.
+ *
+ * @dochash types/debuggers/common
+ * @docname PauseTriggerOptions
+ */
+export interface PauseTriggerOptions {
+    /**
+     * The line number that the trigger starts at.
+     */
+    lineNumber: number;
+    /**
+     * The column number that the trigger starts at.
+     */
+    columnNumber: number;
+    /**
+     * The states that the trigger should use.
+     * Defaults to ["before"] if not specified.
+     */
+    states?: Breakpoint['states'];
+    /**
+     * Whether the trigger is enabled.
+     * Defaults to true.
+     */
+    enabled?: boolean;
+}
+/**
+ * Defines an interface that represents a pause trigger.
+ *
+ * @dochash types/debuggers/common
+ * @docname PauseTrigger
+ */
+export interface PauseTrigger extends PauseTriggerOptions {
+    /**
+     * The ID of the trigger.
+     */
+    triggerId: string;
+    /**
+     * The ID of the bot that the trigger is set on.
+     */
+    botId: string;
+    /**
+     * The tag that the trigger is set on.
+     */
+    tag: string;
+}
+/**
+ * Defines an interface that contains information about the current debugger pause state.
+ * @dochash types/debuggers/common
+ * @docname DebuggerPause
+ */
+export interface DebuggerPause {
+    /**
+     * The ID of the pause.
+     */
+    pauseId: string | number;
+    /**
+     * The pause trigger that started this pause.
+     */
+    trigger: PauseTrigger;
+    /**
+     * The state of the pause.
+     * Indicates whether the pause is before or after the node was executed.
+     */
+    state: 'before' | 'after';
+    /**
+     * The result of the node evaluation.
+     */
+    result?: any;
+    /**
+     * The call stack that the debugger currently has.
+     */
+    callStack: DebuggerCallFrame[];
+}
+/**
+ * Defines an interface that contains information about a single call stack frame.
+ *
+ * @dochash types/debuggers/common
+ * @docname DebuggerCallFrame
+ */
+export interface DebuggerCallFrame {
+    /**
+     * The location that was last evaluated in this frame.
+     */
+    location: DebuggerFunctionLocation;
+    /**
+     * Gets the list of variables that are avaiable from this frame.
+     */
+    listVariables(): DebuggerVariable[];
+    /**
+     * Sets the given variable name to the given value.
+     * @param variableName The name of the variable to set.
+     * @param value The value to set in the variable.
+     */
+    setVariableValue(variableName: string, value: any): void;
+}
+/**
+ * Defines an interface that represents a location in a debugger.
+ *
+ * @dochash types/debuggers/common
+ * @docname DebuggerFunctionLocation
+ */
+export interface DebuggerFunctionLocation {
+    /**
+     * The name of the function.
+     */
+    name?: string;
+    /**
+     * The ID of the bot that this function is defined in.
+     */
+    botId?: string;
+    /**
+     * The name of the tag that this function is defined in.
+     */
+    tag?: string;
+    /**
+     * The line number that this function is defined at.
+     */
+    lineNumber?: number;
+    /**
+     * The column number that this function is defined at.
+     */
+    columnNumber?: number;
+}
+/**
+ * Defines an interface that represents a debugger variable.
+ *
+ * @dochash types/debuggers/common
+ * @docname DebuggerVariable
+ */
+export interface DebuggerVariable {
+    /**
+     * The name of the variable.
+     */
+    name: string;
+    /**
+     * The value contained by the variable.
+     */
+    value: any;
+    /**
+     * The scope that the variable exists in.
+     *
+     * "block" indicates that the variable was defined in and exists only in the current block.
+     * "frame" indicates that the variable was defined in and exists in the current stack frame.
+     * "closure" indicates that the variable was inherited from a parent stack frame.
+     */
+    scope: 'block' | 'frame' | 'closure';
+    /**
+     * Whether the variable value can be overwriten.
+     */
+    writable: boolean;
+    /**
+     * Whether this variable has been initialized.
+     */
+    initialized?: boolean;
+}
+/**
+ * Defines an interface for a random number generator.
+ *
+ * @dochash types/core
+ * @docname PseudoRandomNumberGenerator
+ */
+export interface PseudoRandomNumberGenerator {
+    /**
+     * The seed used for this random number generator.
+     * If null then an unpredictable seed was used.
+     */
+    seed: number | string | null;
+    /**
+     * Generates a random number between 0 and 1.
+     */
+    random(): number;
+    /**
+     * Generates a random decimal number between the given min and max values.
+     * @param min The minimum output number.
+     * @param max The maximum output number.
+     */
+    random(min?: number, max?: number): number;
+    /**
+     * Generates a random integer between the given min and max values.
+     * @param min The minimum output number.
+     * @param max The maximum output number.
+     */
+    randomInt(min: number, max: number): number;
+}
+export interface MaskableFunction {
+    mask(...args: any[]): MaskedFunction;
+}
+export interface MaskedFunction {
+    returns(value: any): void;
+}
+export interface WebhookInterface extends MaskableFunction {
+    (options: WebhookOptions): void;
+    post: ((url: string, data?: any, options?: WebhookOptions) => Promise<any>) & MaskableFunction;
+}
+/**
+ * Defines an interface that represents the result of a webhook.
+ *
+ * @dochash types/web
+ * @docname WebhookResult
+ */
+export interface WebhookResult {
+    /**
+     * The data that was returned from the webhook.
+     */
+    data: any;
+    /**
+     * The HTTP Status Code that was returned from the webhook.
+     * See https://developer.mozilla.org/en-US/docs/Web/HTTP/Status for more information.
+     */
+    status: number;
+    /**
+     * The HTTP Headers that were included in the response.
+     * See https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers for more information.
+     *
+     * @docsource Headers
+     */
+    headers: {
+        [name: string]: string;
+    };
+}
+/**
+ * Defines the possible results of a "record file" request.
+ *
+ * @dochash types/records/files
+ * @docgroup 01-create
+ * @docorder 1
+ * @docname RecordFileResult
+ */
+export type RecordFileApiResult = RecordFileApiSuccess | RecordFileApiFailure;
+/**
+ * Defines an interface that represents a successful "record file" request.
+ *
+ * @dochash types/records/files
+ * @docgroup 01-create
+ * @docorder 2
+ * @docname RecordFileSuccess
+ */
+export interface RecordFileApiSuccess {
+    success: true;
+    /**
+     * The URL that the file can be accessed at.
+     */
+    url: string;
+    /**
+     * The SHA-256 hash of the file.
+     * When downloading the URL, the resulting data is guaranteed to have a SHA-256 hash that matches this value.
+     */
+    sha256Hash: string;
+}
+/**
+ * Defines an interface that represents a failed "record file" request.
+ *
+ * @dochash types/records/files
+ * @doctitle File Types
+ * @docsidebar Files
+ * @docdescription File types are used for uploading and downloading files.
+ * @docgroup 01-create
+ * @docorder 3
+ * @docname RecordFileFailure
+ */
+export interface RecordFileApiFailure {
+    success: false;
+    /**
+     * The error code that describes why the request failed.
+     */
+    errorCode: RecordFileFailure['errorCode'] | 'file_already_exists' | 'invalid_file_data';
+    /**
+     * The error message that describes why the request failed.
+     */
+    errorMessage: string;
+    /**
+     * The URL that the file is available at if it has already been uploaded.
+     */
+    existingFileUrl?: string;
+}
+/**
+ * Defines an interface that contains options for a snap grid for {@link os.addDropGrid}.
+ *
+ * @dochash types/os
+ * @docname SnapGridTarget
+ */
+export interface SnapGridTarget {
+    /**
+     * The 3D position that the grid should appear at.
+     */
+    position?: {
+        x: number;
+        y: number;
+        z: number;
+    };
+    /**
+     * The 3D rotation that the grid should appear at.
+     */
+    rotation?: {
+        x: number;
+        y: number;
+        z: number;
+        w?: number;
+    };
+    /**
+     * The bot that defines the portal that the grid should exist in.
+     * If null, then this defaults to the configBot.
+     */
+    portalBot?: Bot | string;
+    /**
+     * The tag that the portal uses to determine which dimension to show. Defaults to formAddress.
+     */
+    portalTag?: string;
+    /**
+     * The bounds of the grid.
+     * Defaults to 10 x 10.
+     */
+    bounds?: {
+        x: number;
+        y: number;
+    };
+    /**
+     * The priority that this grid should be evaluated in over other grids.
+     * Higher priorities will be evaluated before lower priorities.
+     */
+    priority?: number;
+    /**
+     * Whether to visualize the grid while a bot is being dragged.
+     * Defaults to false.
+     */
+    showGrid?: boolean;
+    /**
+     * The type of grid that this snap grid should be.
+     * Defaults to the type of grid that the portal bot uses.
+     *
+     * - "grid" indicates that the snap target should be a flat grid.
+     * - "sphere" indicates that the snap target should be a sphere.
+     */
+    type?: 'grid' | 'sphere';
+}
+/**
+ * The possible results for a "join room" request.
+ *
+ * @dochash types/os
+ * @docname JoinRoomResult
+ */
+export type JoinRoomResult = JoinRoomSuccess | JoinRoomFailure;
+/**
+ * Defines an interface that represents a successful "join room" request.
+ *
+ * @dochash types/os
+ * @docname JoinRoomSuccess
+ */
+export interface JoinRoomSuccess {
+    success: true;
+    /**
+     * The name of the room that was joined.
+     */
+    roomName: string;
+}
+/**
+ * Defines an interface that represents a failed "join room" request.
+ *
+ * @dochash types/os
+ * @docname JoinRoomFailure
+ */
+export interface JoinRoomFailure {
+    success: false;
+    /**
+     * The name of the room that was attempted to be joined.
+     */
+    roomName: string;
+    /**
+     * The error code that describes why the request failed.
+     */
+    errorCode: string;
+    /**
+     * The error message that describes why the request failed.
+     */
+    errorMessage: string;
+}
+/**
+ * The possible results for a "leave room" request.
+ *
+ * @dochash types/os
+ * @docname LeaveRoomResult
+ */
+export type LeaveRoomResult = LeaveRoomSuccess | LeaveRoomFailure;
+/**
+ * Defines an interface that represents a successful "leave room" request.
+ *
+ * @dochash types/os
+ * @docname LeaveRoomSuccess
+ */
+export interface LeaveRoomSuccess {
+    success: true;
+    /**
+     * The name of the room that was left.
+     */
+    roomName: string;
+}
+/**
+ * Defines an interface that represents a failed "leave room" request.
+ *
+ * @dochash types/os
+ * @docname LeaveRoomFailure
+ */
+export interface LeaveRoomFailure {
+    success: false;
+    /**
+     * The name of the room that was attempted to be left.
+     */
+    roomName: string;
+    /**
+     * The error code that describes why the request failed.
+     */
+    errorCode: string;
+    /**
+     * The error message that describes why the request failed.
+     */
+    errorMessage: string;
+}
+/**
+ * The possible results for a "set room options" request.
+ *
+ * @dochash types/os
+ * @docname SetRoomOptionsResult
+ */
+export type SetRoomOptionsResult = SetRoomOptionsSuccess | SetRoomOptionsFailure;
+/**
+ * Defines an interface that represents a successful "set room options" request.
+ *
+ * @dochash types/os
+ * @docname SetRoomOptionsSuccess
+ */
+export interface SetRoomOptionsSuccess {
+    success: true;
+    /**
+     * The name of the room that the options were set on.
+     */
+    roomName: true;
+}
+/**
+ * Defines an interface that represents a failed "set room options" request.
+ */
+export interface SetRoomOptionsFailure {
+    success: false;
+    /**
+     * The name of the room that the options were attempted to be set on.
+     */
+    roomName: string;
+    /**
+     * The error code that describes why the request failed.
+     */
+    errorCode: string;
+    /**
+     * The error message that describes why the request failed.
+     */
+    errorMessage: string;
+}
+/**
+ * The possible results for a "get room options" request.
+ *
+ * @dochash types/os
+ * @docname GetRoomOptionsResult
+ */
+export type GetRoomOptionsResult = GetRoomOptionsSuccess | GetRoomOptionsFailure;
+/**
+ * Defines an interface that represents a successful "get room options" request.
+ *
+ * @dochash types/os
+ * @docname GetRoomOptionsSuccess
+ */
+export interface GetRoomOptionsSuccess {
+    success: true;
+    /**
+     * The name of the room that the options were retrieved from.
+     */
+    roomName: string;
+    /**
+     * The options that were retrieved.
+     */
+    options: RoomOptions;
+}
+/**
+ * Defines an interface that represents a failed "get room options" request.
+ *
+ * @dochash types/os
+ * @docname GetRoomOptionsFailure
+ */
+export interface GetRoomOptionsFailure {
+    success: false;
+    /**
+     * The error code that describes why the request failed.
+     */
+    errorCode: string;
+    /**
+     * The error message that describes why the request failed.
+     */
+    errorMessage: string;
+}
+/**
+ * The possible results for a "get room track options" request.
+ *
+ * @dochash types/os
+ * @docname GetRoomTrackOptionsResult
+ */
+export type GetRoomTrackOptionsResult = GetRoomTrackOptionsSuccess | GetRoomTrackOptionsFailure;
+/**
+ * Defines an interface that represents a successful "get room track options" request.
+ *
+ * @dochash types/os
+ * @docname GetRoomTrackOptionsSuccess
+ */
+export interface GetRoomTrackOptionsSuccess {
+    success: true;
+    /**
+     * The name of the room that the options were retrieved from.
+     */
+    roomName: string;
+    /**
+     * The address of the track that the options were retrieved from.
+     */
+    address: string;
+    /**
+     * The options that were retrieved.
+     */
+    options: RoomTrackOptions;
+}
+/**
+ * Defines an interface that represents a failed "get room track options" request.
+ *
+ * @dochash types/os
+ * @docname GetRoomTrackOptionsFailure
+ */
+export interface GetRoomTrackOptionsFailure {
+    success: false;
+    /**
+     * The error code that describes why the request failed.
+     */
+    errorCode: string;
+    /**
+     * The error message that describes why the request failed.
+     */
+    errorMessage: string;
+    /**
+     * The name of the room that the options were attempted to be retrieved from.
+     */
+    roomName: string;
+    /**
+     * The address of the track that the options were attempted to be retrieved from.
+     */
+    address: string;
+}
+/**
+ * The possible results for a "set room track options" request.
+ *
+ * @dochash types/os
+ * @docname SetRoomTrackOptionsResult
+ */
+export type SetRoomTrackOptionsResult = SetRoomTrackOptionsSuccess | SetRoomTrackOptionsFailure;
+/**
+ * Defines an interface that represents a successful "set room track options" request.
+ *
+ * @dochash types/os
+ * @docname SetRoomTrackOptionsSuccess
+ */
+export interface SetRoomTrackOptionsSuccess {
+    success: true;
+    /**
+     * The name of the room that the options were set on.
+     */
+    roomName: string;
+    /**
+     * The address of the track that the options were set on.
+     */
+    address: string;
+    /**
+     * The options that were set.
+     */
+    options: RoomTrackOptions;
+}
+/**
+ * Defines an interface that represents a failed "set room track options" request.
+ *
+ * @dochash types/os
+ * @docname SetRoomTrackOptionsFailure
+ */
+export interface SetRoomTrackOptionsFailure {
+    success: false;
+    /**
+     * The error code that describes why the request failed.
+     */
+    errorCode: string;
+    /**
+     * The error message that describes why the request failed.
+     */
+    errorMessage: string;
+    /**
+     * The name of the room that the options were attempted to be set on.
+     */
+    roomName: string;
+    /**
+     * The address of the track that the options were attempted to be set on.
+     */
+    address: string;
+}
+/**
+ * The possible results for a "get room remote options" request.
+ *
+ * @dochash types/os
+ * @docname GetRoomRemoteOptionsResult
+ */
+export type GetRoomRemoteOptionsResult = GetRoomRemoteOptionsSuccess | GetRoomRemoteOptionsFailure;
+/**
+ * Defines an interface that represents a successful "get room remote options" request.
+ *
+ * @dochash types/os
+ * @docname GetRoomRemoteOptionsSuccess
+ */
+export interface GetRoomRemoteOptionsSuccess {
+    success: true;
+    /**
+     * The name of the room that the options were retrieved from.
+     */
+    roomName: string;
+    /**
+     * The ID of the remote that the options were retrieved from.
+     */
+    remoteId: string;
+    /**
+     * The options that were retrieved.
+     */
+    options: RoomRemoteOptions;
+}
+/**
+ * Defines an interface that represents a failed "get room remote options" request.
+ *
+ * @dochash types/os
+ * @docname GetRoomRemoteOptionsFailure
+ */
+export interface GetRoomRemoteOptionsFailure {
+    success: false;
+    /**
+     * The error code that describes why the request failed.
+     */
+    errorCode: string;
+    /**
+     * The error message that describes why the request failed.
+     */
+    errorMessage: string;
+    /**
+     * The name of the room that the options were attempted to be retrieved from.
+     */
+    roomName: string;
+    /**
+     * The ID of the remote that the options were attempted to be retrieved from.
+     */
+    remoteId: string;
+}
+/**
+ * Defines an interface that represents the set of additional options that can be provided when recording a file.
+ */
+export interface RecordFileOptions {
+    /**
+     * The description of the file.
+     */
+    description?: string;
+    /**
+     * The MIME type of the file.
+     * See https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/MIME_types for more information.
+     */
+    mimeType?: string;
+    /**
+     * The marker that should be applied to the file.
+     */
+    marker?: string;
+    /**
+     * The markers that should be applied to the file.
+     */
+    markers?: string[];
+}
+/**
+ * Defines an interface that represents the result of a raycast operation.
+ *
+ * @dochash types/os
+ * @docname RaycastResult
+ */
+export interface RaycastResult {
+    /**
+     * The list of intersections.
+     */
+    botIntersections: BotIntersection[];
+    /**
+     * The ray that the operation sent.
+     */
+    ray: RaycastRay;
+}
+/**
+ * Defines an interface that represents the intersection of a bot and ray.
+ */
+export interface BotIntersection {
+    /**
+     * The bot that was intersected.
+     */
+    bot: Bot;
+    /**
+     * The distance from the origin of the ray that the intersection ocurred at.
+     */
+    distance: number;
+    /**
+     * The point that the intersection ocurred at.
+     */
+    point: Vector3;
+    /**
+     * The normal that the intersection ocurred at.
+     */
+    normal: Vector3;
+    /**
+     * The face that the intersection hit.
+     */
+    face: string;
+    /**
+     * The UV coordinates that the intersection ocurred at.
+     */
+    uv: Vector2;
+    /**
+     * The portal that the bot is in.
+     */
+    portal: string;
+    /**
+     * The dimension that the bot is in.
+     */
+    dimension: string;
+}
+/**
+ * Defines an interface that represents a ray. That is, a line that has a start position and a direction, but no end.
+ *
+ * @dochash types/os
+ * @docname RaycastRay
+ */
+export interface RaycastRay {
+    /**
+     * The origin of the ray.
+     */
+    origin: Vector3;
+    /**
+     * The direction that the ray travels in.
+     */
+    direction: Vector3;
+}
+/**
+ * Defines an interface that represents a file that was uploaded.
+ *
+ * @dochash types/os
+ * @docname UploadedFile
+ */
+export interface UploadedFile {
+    /**
+     * The name of the file that was uploaded.
+     */
+    name: string;
+    /**
+     * The size of the file in bytes.
+     */
+    size: number;
+    /**
+     * The data that the file contains.
+     */
+    data: string | ArrayBuffer;
+}
+/**
+ * Creates a library that includes the default functions and APIs.
+ * @param context The global context that should be used.
+ */
+export declare function createDefaultLibrary(context: AuxGlobalContext): {
+    api: {
+        _getBots: (...filters: BotFilter[]) => RuntimeBot[];
+        __getBots: (tag: string, value?: any) => RuntimeBot[];
+        getBots: (...filters: any[]) => RuntimeBot[];
+        _getBot: (...filters: BotFilter[]) => RuntimeBot;
+        __getBot: (tag: string, value?: any) => RuntimeBot;
+        getBot: (...args: any[]) => RuntimeBot;
+        getBotTagValues: (tag: string, filter?: TagFilter) => any[];
+        getMod: (bot: any, ...tags: (string | RegExp)[]) => Mod;
+        getBotPosition: (bot: RuntimeBot | string, dimension: string) => Vector3;
+        getBotRotation: (bot: RuntimeBot | string, dimension: string) => Rotation;
+        getID: (bot: Bot | string) => string;
+        getJSON: (data: any) => string;
+        getFormattedJSON: (data: any) => string;
+        getSnapshot: (bots: Bot[] | Bot) => BotsState;
+        diffSnapshots: (first: BotsState, second: BotsState) => PartialBotsState;
+        applyDiffToSnapshot: (snapshot: BotsState, diff: PartialBotsState) => BotsState;
+        getTag: (bot: Bot, ...tags: string[]) => any;
+        setTag: (bot: Bot | Bot[] | BotTags, tag: string, value: any) => any;
+        setTagMask: (bot: RuntimeBot | RuntimeBot[], tag: string, value: any, space?: string) => any;
+        clearTagMasks: (bot: RuntimeBot | RuntimeBot[], space?: string) => void;
+        insertTagText: (bot: RuntimeBot, tag: string, index: number, text: string) => string;
+        insertTagMaskText: (bot: RuntimeBot, tag: string, index: number, text: string, space?: BotSpace) => string;
+        deleteTagText: (bot: RuntimeBot, tag: string, index: number, count: number) => string;
+        deleteTagMaskText: (bot: RuntimeBot, tag: string, index: number, count: number, space?: string) => string;
+        removeTags: (bot: Bot | Bot[], tagSection: string | RegExp) => void;
+        renameTag: (bot: Bot | Bot[], originalTag: string, newTag: string) => void;
+        applyMod: (bot: any, ...mods: Mod[]) => void;
+        subtractMods: (bot: any, ...mods: Mod[]) => void;
+        _create: (...mods: Mod[]) => RuntimeBot | RuntimeBot[];
+        _destroy: (bot: string | Bot | string[] | Bot[]) => void;
+        destroy: {
+            (bot: string | Bot | RuntimeBot | (string | Bot | RuntimeBot)[]): void;
+            [INTERPRETABLE_FUNCTION]: (bot: string | Bot | RuntimeBot | (string | Bot | RuntimeBot)[]) => Generator<any, void, any>;
+        };
+        _changeState: (bot: Bot, stateName: string, groupName?: string) => void;
+        changeState: {
+            (bot: Bot, stateName: string, groupName?: string): void;
+            [INTERPRETABLE_FUNCTION]: (bot: Bot, stateName: string, groupName?: string) => Generator<any, void, any>;
+        };
+        getLink: (...bots: (Bot | string | (Bot | string)[])[]) => string;
+        getBotLinks: (bot: Bot) => ParsedBotLink[];
+        _updateBotLinks: (bot: Bot, idMap: object) => void;
+        updateBotLinks: (bot: Bot, idMap: Map<string, string | Bot> | {
+            [id: string]: string | Bot;
+        }) => void;
+        getDateTime: (value: unknown) => DateTime;
+        DateTime: typeof DateTime;
+        /**
+         * @hidden
+         */
+        Vector2: typeof Vector2;
+        /**
+         * @hidden
+         */
+        Vector3: typeof Vector3;
+        /**
+         * @hidden
+         */
+        Quaternion: typeof Quaternion;
+        /**
+         * @hidden
+         */
+        Rotation: typeof Rotation;
+        superShout: (eventName: string, arg?: any) => SuperShoutAction;
+        _priorityShout: (eventNames: string[], arg?: any) => any;
+        priorityShout: {
+            (eventNames: string[], arg?: any): any;
+            [INTERPRETABLE_FUNCTION]: (eventNames: string[], arg?: any) => Generator<any, any, any>;
+        };
+        _shout: (name: string, arg?: any) => any;
+        shout: {
+            (name: string, arg?: any): any[];
+            [name: string]: (arg?: any) => any[];
+        } & {
+            [INTERPRETABLE_FUNCTION]: {
+                (name: string, arg?: any): Generator<any, any[], any>;
+                [name: string]: (arg?: any) => Generator<any, any[], any>;
+            };
+        };
+        _whisper: (bot: (Bot | string)[] | Bot | string, eventName: string, arg?: any) => any;
+        whisper: {
+            (bot: string | Bot | (string | Bot)[], eventName: string, arg?: any): any[];
+            [INTERPRETABLE_FUNCTION]: (bot: string | Bot | (string | Bot)[], eventName: string, arg?: any) => Generator<any, any[], any>;
+        };
+        byTag: (tag: string, filter?: TagFilter) => BotFilter;
+        byID: (id: string) => BotFilter;
+        byMod: (mod: Mod) => BotFilter;
+        inDimension: (dimension: string) => BotFilter;
+        atPosition: (dimension: string, x: number, y: number) => BotFilter;
+        inStack: (bot: Bot, dimension: string) => BotFilter;
+        neighboring: (bot: Bot, dimension: string, direction?: 'front' | 'left' | 'right' | 'back') => BotFilter;
+        bySpace: (space: string) => BotFilter;
+        byCreator: (bot: Bot | string) => BotFilter;
+        either: (...filters: BotFilter[]) => BotFilter;
+        not: (filter: BotFilter) => BotFilter;
+        remote: (action: BotAction, selector?: SessionSelector | string | (SessionSelector | string)[], allowBatching?: boolean) => RemoteAction | RemoteAction[];
+        sendRemoteData: (remoteId: string | string[], name: string, arg?: any) => RemoteAction | RemoteAction[];
+        remoteWhisper: (remoteId: string | string[], name: string, arg?: any) => RemoteAction | RemoteAction[];
+        remoteShout: (name: string, arg?: any) => RemoteAction | RemoteAction[];
+        uuid: () => string;
+        _animateTag: (bot: RuntimeBot | string | (RuntimeBot | string)[], tag: string, options: AnimateTagFunctionOptions) => Promise<void>;
+        __animateTag: (bot: RuntimeBot | string | (RuntimeBot | string)[], options: AnimateTagFunctionOptions) => Promise<void>;
+        animateTag: {
+            (bot: RuntimeBot | (RuntimeBot | string)[] | string, tag: string, options: AnimateTagFunctionOptions): Promise<void>;
+            (bot: RuntimeBot | (RuntimeBot | string)[] | string, options: AnimateTagFunctionOptions): Promise<void>;
+        };
+        clearAnimations: (bot: RuntimeBot | (RuntimeBot | string)[] | string, tag?: string | string[]) => void;
+        webhook: WebhookInterface;
+        /**
+         * @hidden
+         */
+        sleep: (time: number) => Promise<void>;
+        /**
+         * @hidden
+         */
+        __energyCheck: () => void;
+        clearTimeout: (id: number) => void;
+        clearInterval: (id: number) => void;
+        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<import("@casual-simulation/expect/src/types").MatcherState>;
+        html: HtmlFunction;
+        /**
+         * Gets the config bot (formerly known as the player bot).
+         * This is the bot that represents the player's browser tab.
+         *
+         * It is `tempLocal` and is used to configure various portals.
+         *
+         * @example Get the config bot and set a username on it.
+         * configBot.tags.username = "bob";
+         *
+         * @example Open the sheetPortal to "testDimension".
+         * configBot.tags.sheetPortal = "testDimension";
+         *
+         * @dochash actions/os
+         * @doctitle OS Actions
+         * @docsidebar OS
+         * @docdescription OS actions are used to interact with the player's current session.
+         * @docname configBot
+         * @docgroup 01-os
+         */
+        readonly _configBot: RuntimeBot;
+        ai: {
+            chat: {
+                (message: string, options?: AIChatOptions): Promise<string>;
+                (message: AIChatMessage, options?: AIChatOptions): Promise<AIChatMessage>;
+                (messages: AIChatMessage[], options?: AIChatOptions): Promise<AIChatMessage>;
+            };
+            generateSkybox: {
+                (prompt: string, negativePrompt?: string, options?: AIGenerateSkyboxOptions): Promise<string>;
+                (request: AIGenerateSkyboxRequest): Promise<AIGenerateSkyboxResult>;
+            };
+            generateImage: {
+                (prompt: string, negativePrompt?: string, options?: AIGenerateImageOptions & RecordActionOptions): Promise<string>;
+                (request: AIGenerateImageOptions, options?: RecordActionOptions): Promise<AIGenerateImageAPISuccess>;
+            };
+        };
+        os: {
+            [x: symbol]: boolean;
+            sleep: (time: number) => Promise<void>;
+            toast: (message: string | number | boolean | object | Array<any> | null, duration?: number) => ShowToastAction;
+            tip: (message: string | number | boolean | object | Array<any> | null, pixelX?: number, pixelY?: number, duration?: number) => Promise<number>;
+            hideTips: (tipIds?: number | number[]) => Promise<void>;
+            showJoinCode: (inst?: string, dimension?: string) => ShowJoinCodeAction;
+            requestFullscreenMode: () => RequestFullscreenAction;
+            exitFullscreenMode: () => ExitFullscreenAction;
+            showHtml: (html: string) => ShowHtmlAction;
+            hideHtml: () => HideHtmlAction;
+            setClipboard: (text: string) => SetClipboardAction;
+            tweenTo: (bot: Bot | string, zoomValue?: number, rotX?: number, rotY?: number, duration?: number) => FocusOnBotAction;
+            moveTo: (bot: Bot | string, zoomValue?: number, rotX?: number, rotY?: number) => FocusOnBotAction;
+            _focusOn_bot: (bot: Bot | string, options?: FocusOnOptions) => Promise<void>;
+            _focusOn_position: (position: {
+                x: number;
+                y: number;
+                z?: number;
+            }, options?: FocusOnOptions) => Promise<void>;
+            focusOn: (botOrPosition: Bot | string | {
+                x: number;
+                y: number;
+                z?: number;
+            }, options?: FocusOnOptions) => Promise<void>;
+            _showChat_placeholder: (placeholder?: string) => void;
+            _showChat_options: (options?: ShowChatOptions) => void;
+            showChat: (placeholderOrOptions?: string | ShowChatOptions) => ShowChatBarAction;
+            hideChat: () => ShowChatBarAction;
+            run: (script: string) => Promise<any>;
+            version: () => AuxVersion;
+            device: () => AuxDevice;
+            isCollaborative: () => boolean;
+            getAB1BootstrapURL: () => string;
+            enableAR: (options?: EnableXROptions) => EnableARAction;
+            disableAR: () => EnableARAction;
+            enableVR: (options?: EnableXROptions) => EnableVRAction;
+            disableVR: () => EnableVRAction;
+            arSupported: () => Promise<boolean>;
+            vrSupported: () => Promise<boolean>;
+            enablePointOfView: (center?: {
+                x: number;
+                y: number;
+                z: number;
+            }, imu?: boolean) => EnablePOVAction;
+            disablePointOfView: () => EnablePOVAction;
+            requestWakeLock: () => Promise<void>;
+            disableWakeLock: () => Promise<void>;
+            getWakeLockConfiguration: () => Promise<WakeLockConfiguration>;
+            download: (data: string | object | ArrayBuffer | Blob, filename: string, mimeType?: string) => DownloadAction;
+            downloadBots: (bots: Bot[], filename: string) => DownloadAction;
+            downloadBotsAsInitialzationUpdate: (bots: Bot[], filename: string) => DownloadAction;
+            downloadServer: () => DownloadAction;
+            downloadInst: () => DownloadAction;
+            showUploadAuxFile: () => ShowUploadAuxFileAction;
+            showUploadFiles: () => Promise<UploadedFile[]>;
+            openQRCodeScanner: (camera?: CameraType) => OpenQRCodeScannerAction;
+            closeQRCodeScanner: () => OpenQRCodeScannerAction;
+            showQRCode: (code: string) => ShowQRCodeAction;
+            hideQRCode: () => ShowQRCodeAction;
+            openBarcodeScanner: (camera?: CameraType) => OpenBarcodeScannerAction;
+            closeBarcodeScanner: () => OpenBarcodeScannerAction;
+            showBarcode: (code: string, format?: BarcodeFormat) => ShowBarcodeAction;
+            hideBarcode: () => ShowBarcodeAction;
+            openImageClassifier: (options: ImageClassifierOptions) => Promise<void>;
+            closeImageClassifier: () => Promise<void>;
+            openPhotoCamera: (options?: OpenPhotoCameraOptions) => Promise<void>;
+            capturePhoto: (options?: OpenPhotoCameraOptions) => Promise<Photo>;
+            closePhotoCamera: () => Promise<void>;
+            /**
+             * Gets the device-local time as the number of miliseconds since midnight January 1st, 1970 UTC-0 (i.e. the Unix Epoch). This is what your device's clock thinks the current time is.
+             *
+             * @example Toast the number of miliseconds since the Unix Epoch
+             * os.toast(os.localTime);
+             *
+             * @dochash actions/time
+             * @doctitle Time Actions
+             * @docsidebar Time
+             * @docdescription Time actions make working with time across devices easy.
+             * @docgroup 01-time
+             * @docname os.localTime
+             */
+            readonly localTime: number;
+            /**
+             * Gets the shared time that has been agreed upon between devices in the inst as the number of miliseconds since midnight January 1st, 1970 UTC-0 (i.e. the Unix Epoch).
+             * This is what your device's clock thinks the inst clock says.
+             *
+             * If an agreed upon time cannot be determined (for example, because collaboration is disabled in the inst), then this value will always be `NaN`.
+             *
+             * @example Toast the current shared time
+             * os.toast(os.agreedUponTime);
+             *
+             * @dochash actions/time
+             * @docgroup 01-time
+             * @docname os.agreedUponTime
+             */
+            readonly agreedUponTime: number;
+            /**
+             * Gets the average latency between this device's clock and the inst clock in miliseconds. Lower values tend to indicate a good connection while higher values tend to indicate a bad connection.
+             *
+             * If an agreed upon time cannot be determined (for example, because collaboration is disabled in the inst), then this value will always be `NaN`.
+             *
+             * @dochash actions/time
+             * @docgroup 01-time
+             * @docname os.instLatency
+             */
+            readonly instLatency: number;
+            /**
+             * Gets the calculated time offset between the inst clock and the local clock. This value is equivalent to `os.agreedUponTime - os.localTime`.
+             *
+             * If an agreed upon time cannot be determined (for example, because collaboration is disabled in the inst), then this value will always be `NaN`.
+             *
+             * @dochash actions/time
+             * @docgroup 01-time
+             * @docname os.instTimeOffset
+             */
+            readonly instTimeOffset: number;
+            /**
+             * Gets the spread between calculated time offsets. Higher values indicate that {@link os.agreedUponTime} is less accurate. Lower values indicate that {@link os.agreedUponTime} is more accurate.
+             *
+             * If an agreed upon time cannot be determined (for example, because collaboration is disabled in the inst), then this value will always be `NaN`.
+             *
+             * @dochash actions/time
+             * @docgroup 01-time
+             * @docname os.instTimeOffsetSpread
+             */
+            readonly instTimeOffsetSpread: number;
+            /**
+             * Gets the shared time that has been agreed upon between devices but with an additional 50ms offset added.
+             * This offset attempts to ensure that changes/events will be recieved by all connected devices by the time it occurs, thereby making synchronized actions easier to perform.
+             *
+             * If an agreed upon time cannot be determined (for example, because collaboration is disabled in the inst), then this value will always be `NaN`.
+             *
+             * @dochash actions/time
+             * @docgroup 01-time
+             * @docname os.deadReckoningTime
+             */
+            readonly deadReckoningTime: number;
+            loadServer: (id: string) => LoadServerAction;
+            unloadServer: (id: string) => UnloadServerAction;
+            loadInst: (id: string) => LoadServerAction;
+            unloadInst: (id: string) => UnloadServerAction;
+            importAUX: (urlOrJSON: string) => Promise<void>;
+            parseBotsFromData: (jsonOrPdf: string | ArrayBuffer) => Bot[];
+            replaceDragBot: (bot: RuntimeBot) => ReplaceDragBotAction;
+            isInDimension: (dimension: string) => boolean;
+            getCurrentDimension: () => string;
+            getCurrentServer: () => string;
+            getCurrentInst: () => string;
+            getMenuDimension: () => string;
+            getMiniPortalDimension: () => string;
+            getPortalDimension: (portal: PortalType) => string;
+            getDimensionalDepth: (dimension: string) => number;
+            showInputForTag: (bot: Bot | string, tag: string, options?: Partial<ShowInputOptions>) => ShowInputForTagAction;
+            _showInput: (currentValue?: any, options?: Partial<ShowInputOptions>) => Promise<any>;
+            showInput: ((currentValue?: any, options?: Partial<ShowInputOptions>) => Promise<any>) & MaskableFunction;
+            showConfirm: (options: ShowConfirmOptions) => Promise<boolean>;
+            goToDimension: (dimension: string) => GoToDimensionAction;
+            goToURL: (url: string) => GoToURLAction;
+            openURL: (url: string) => OpenURLAction;
+            openDevConsole: () => OpenConsoleAction;
+            playSound: (url: string) => Promise<any>;
+            bufferSound: (url: string) => Promise<any>;
+            cancelSound: (soundId: number | string | object) => Promise<any>;
+            hasBotInMiniPortal: (bots: Bot | Bot[]) => boolean;
+            share: (options: ShareOptions) => Promise<void>;
+            closeCircleWipe: (options?: Partial<OpenCircleWipeOptions>) => Promise<void>;
+            openCircleWipe: (options?: Partial<OpenCircleWipeOptions>) => Promise<void>;
+            addDropSnap: (...targets: SnapTarget[]) => AddDropSnapTargetsAction;
+            addBotDropSnap: (bot: RuntimeBot | string, ...targets: SnapTarget[]) => AddDropSnapTargetsAction;
+            addDropGrid: (...targets: SnapGridTarget[]) => AddDropGridTargetsAction;
+            addBotDropGrid: (bot: Bot | string, ...targets: SnapGridTarget[]) => AddDropGridTargetsAction;
+            enableCustomDragging: () => EnableCustomDraggingAction;
+            log: (...args: any[]) => void;
+            getGeolocation: () => Promise<Geolocation>;
+            inSheet: () => boolean;
+            getCameraPosition: (portal?: 'grid' | 'miniGrid') => Vector3;
+            getCameraRotation: (portal?: 'grid' | 'miniGrid') => {
+                x: number;
+                y: number;
+                z: number;
+            };
+            getFocusPoint: (portal?: 'grid' | 'miniGrid') => Vector3;
+            getPointerPosition: (pointer?: 'mouse' | 'left' | 'right') => Vector3;
+            getPointerRotation: (pointer?: 'mouse' | 'left' | 'right') => {
+                x: number;
+                y: number;
+                z: number;
+            };
+            getPointerDirection: (pointer?: 'mouse' | 'left' | 'right') => Vector3;
+            getInputState: (controller: string, button: string) => null | 'down' | 'held';
+            getInputList: () => string[];
+            getMediaPermission: (options: MediaPermssionOptions) => Promise<any>;
+            getAverageFrameRate: () => Promise<number>;
+            joinRoom: (roomName: string, options?: JoinRoomActionOptions) => Promise<JoinRoomResult>;
+            leaveRoom: (roomName: string, options?: RecordActionOptions) => Promise<LeaveRoomResult>;
+            setRoomOptions: (roomName: string, options: Partial<RoomOptions>) => Promise<SetRoomOptionsResult>;
+            getRoomOptions: (roomName: string) => Promise<GetRoomOptionsResult>;
+            getRoomTrackOptions: (roomName: string, address: string) => Promise<GetRoomTrackOptionsResult>;
+            setRoomTrackOptions: (roomName: string, address: string, options: SetRoomTrackOptions) => Promise<SetRoomTrackOptionsResult>;
+            getRoomRemoteOptions: (roomName: string, remoteId: string) => Promise<GetRoomRemoteOptionsResult>;
+            registerTagPrefix: (prefix: string, options?: RegisterPrefixOptions) => Promise<void>;
+            registerApp: (portalId: string, bot: Bot | string) => Promise<void>;
+            unregisterApp: (appId: string) => Promise<void>;
+            compileApp: (appId: string, content: any) => SetAppOutputAction;
+            appHooks: {
+                render: typeof render;
+                useState<S>(initialState: S | (() => S)): [S, hooks.StateUpdater<S>];
+                useState<S_1 = undefined>(): [S_1, hooks.StateUpdater<S_1>];
+                useReducer<S_2, A>(reducer: hooks.Reducer<S_2, A>, initialState: S_2): [S_2, (action: A) => void];
+                useReducer<S_3, A_1, I>(reducer: hooks.Reducer<S_3, A_1>, initialArg: I, init: (arg: I) => S_3): [S_3, (action: A_1) => void];
+                useRef<T>(initialValue: T): hooks.MutableRef<T>;
+                useRef<T_1>(initialValue: T_1): hooks.Ref<T_1>;
+                useRef<T_2 = undefined>(): hooks.MutableRef<T_2>;
+                useEffect(effect: hooks.EffectCallback, inputs?: hooks.Inputs): void;
+                useImperativeHandle<T_3, R extends T_3>(ref: import("preact").Ref<T_3>, create: () => R, inputs?: hooks.Inputs): void;
+                useLayoutEffect(effect: hooks.EffectCallback, inputs?: hooks.Inputs): void;
+                useCallback<T_4 extends Function>(callback: T_4, inputs: hooks.Inputs): T_4;
+                useMemo<T_5>(factory: () => T_5, inputs: hooks.Inputs): T_5;
+                useContext<T_6>(context: import("preact").PreactContext<T_6>): T_6;
+                useDebugValue<T_7>(value: T_7, formatter?: (value: T_7) => any): void;
+                useErrorBoundary(callback?: (error: any) => void | Promise<void>): [any, () => void];
+            };
+            listBuiltinTags: () => string[];
+            requestAuthBot: () => Promise<Bot>;
+            getPublicRecordKey: (name: string) => Promise<CreatePublicRecordKeyResult>;
+            getSubjectlessPublicRecordKey: (name: string) => Promise<CreatePublicRecordKeyResult>;
+            grantRecordMarkerPermission: (recordName: string, marker: string, permission: AvailablePermissions, options?: RecordActionOptions) => Promise<GrantMarkerPermissionResult>;
+            revokeRecordMarkerPermission: (recordName: string, marker: string, permission: AvailablePermissions, options?: RecordActionOptions) => Promise<RevokeMarkerPermissionResult>;
+            grantInstAdminPermission: (recordName: string, options?: RecordActionOptions) => Promise<GrantRoleResult>;
+            grantUserRole: (recordName: string, role: string, userId: string, expireTimeMs?: number, options?: RecordActionOptions) => Promise<GrantRoleResult>;
+            revokeUserRole: (recordName: string, role: string, userId: string, options?: RecordActionOptions) => Promise<RevokeRoleResult>;
+            grantInstRole: (recordName: string, role: string, inst: string, expireTimeMs?: number, options?: RecordActionOptions) => Promise<GrantRoleResult>;
+            revokeInstRole: (recordName: string, role: string, inst: string, options?: RecordActionOptions) => Promise<RevokeRoleResult>;
+            isRecordKey: (key: unknown) => boolean;
+            recordData: (recordKeyOrRecordName: string, address: string, data: any, endpointOrOptions?: string | DataRecordOptions) => Promise<RecordDataResult>;
+            recordManualApprovalData: (recordKeyOrRecordName: string, address: string, data: any, endpointOrOptions?: string | DataRecordOptions) => Promise<RecordDataResult>;
+            getData: (recordKeyOrName: string, address: string, endpoint?: string) => Promise<GetDataResult>;
+            getManualApprovalData: (recordKeyOrName: string, address: string, endpoint?: string) => Promise<GetDataResult>;
+            listData: (recordKeyOrName: string, startingAddress?: string, endpoint?: string) => Promise<ListDataResult>;
+            eraseData: (recordKeyOrName: string, address: string, endpoint?: string) => Promise<EraseDataResult>;
+            eraseManualApprovalData: (recordKeyOrName: string, address: string, endpoint?: string) => Promise<EraseDataResult>;
+            recordFile: (recordKeyOrName: string, data: any, options?: RecordFileOptions, endpoint?: string) => Promise<RecordFileApiResult>;
+            getFile: {
+                (result: RecordFileApiSuccess, endpoint?: string): Promise<any>;
+                (url: string, endpoint?: string): Promise<any>;
+            };
+            getPublicFile: {
+                (result: RecordFileApiSuccess): Promise<any>;
+                (url: string): Promise<any>;
+            };
+            getPrivateFile: {
+                (result: RecordFileApiSuccess, endpoint?: string): Promise<any>;
+                (url: string, endpoint?: string): Promise<any>;
+            };
+            eraseFile: {
+                (recordKeyOrName: string, result: RecordFileApiSuccess, endpoint?: string): Promise<EraseFileResult>;
+                (recordKeyOrName: string, url: string, endpoint?: string): Promise<EraseFileResult>;
+            };
+            recordEvent: (recordKeyOrName: string, eventName: string, endpoint?: string) => Promise<AddCountResult>;
+            countEvents: (recordNameOrKey: string, eventName: string, endpoint?: string) => Promise<GetCountResult>;
+            listUserStudios: (endpoint?: string) => Promise<ListStudiosResult>;
+            convertGeolocationToWhat3Words: (location: ConvertGeolocationToWhat3WordsOptions) => Promise<string>;
+            raycastFromCamera: (portal: 'grid' | 'miniGrid' | 'map' | 'miniMap', viewportCoordinates: Vector2) => Promise<RaycastResult>;
+            raycast: (portal: 'grid' | 'miniGrid' | 'map' | 'miniMap', origin: Vector3, direction: Vector3) => Promise<RaycastResult>;
+            calculateRayFromCamera: (portal: 'grid' | 'miniGrid' | 'map' | 'miniMap', viewportCoordinates: Vector2) => Promise<RaycastRay>;
+            bufferFormAddressGLTF: (address: string) => Promise<void>;
+            startFormAnimation: (botOrBots: Bot | string | (Bot | string)[], nameOrIndex: string | number, options?: StartFormAnimationOptions) => Promise<void>;
+            stopFormAnimation: (botOrBots: Bot | string | (Bot | string)[], options?: StopFormAnimationOptions) => Promise<void>;
+            listFormAnimations: (botOrAddress: Bot | string) => Promise<FormAnimationData[]>;
+            attachDebugger: (debug: DebuggerInterface, options?: AttachDebuggerOptions) => Promise<void>;
+            detachDebugger: (debug: DebuggerInterface) => Promise<void>;
+            remotes: () => Promise<string[]>;
+            listInstUpdates: () => Promise<InstUpdate[]>;
+            getInstStateFromUpdates: (updates: InstUpdate[]) => Promise<BotsState>;
+            createInitializationUpdate: (bots: RuntimeBot[]) => Promise<InstUpdate>;
+            applyUpdatesToInst: (updates: InstUpdate[]) => Promise<void>;
+            getCurrentInstUpdate: () => Promise<InstUpdate>;
+            mergeInstUpdates: (updates: InstUpdate[]) => InstUpdate;
+            remoteCount: (inst?: string) => Promise<number>;
+            totalRemoteCount: () => Promise<number>;
+            beginAudioRecording: (options?: Omit<BeginAudioRecordingAction, 'type' | 'taskId'>) => Promise<void>;
+            endAudioRecording: () => Promise<Blob>;
+            meetCommand: (command: string, ...args: any) => Promise<void>;
+            meetFunction: (functionName: string, ...args: any[]) => Promise<any>;
+            readonly vars: any;
+            _createDebugger_normal: (options?: NormalDebuggerOptions) => Promise<NormalDebugger>;
+            _createDebugger_pausable: (options: PausableDebuggerOptions) => Promise<PausableDebugger>;
+            _getExecutingDebugger: () => Debugger;
+            _attachDebugger: (debug: Debugger, options?: AttachDebuggerOptions) => Promise<void>;
+            _detachDebugger: (debug: Debugger) => Promise<void>;
+        };
+        portal: {
+            registerPrefix: (prefix: string, options?: RegisterPrefixOptions) => Promise<void>;
+        };
+        server: {
+            shell: (script: string) => RemoteAction | RemoteAction[];
+            serverRemoteCount: (inst?: string) => Promise<number>;
+            totalRemoteCount: () => Promise<number>;
+            remotes: () => Promise<string[]>;
+            players: () => Promise<string[]>;
+            serverPlayerCount: (inst?: string) => Promise<number>;
+            totalPlayerCount: () => Promise<number>;
+        };
+        action: {
+            perform: (action: any) => any;
+            reject: (action: any) => RejectAction;
+        };
+        experiment: {
+            localFormAnimation: (bot: Bot | string, animation: string | number) => LocalFormAnimationAction;
+            localPositionTween: (bot: Bot | string, dimension: string, position: {
+                x: number;
+                y: number;
+                z?: number;
+            }, options?: TweenOptions) => Promise<void>;
+            localRotationTween: (bot: Bot | string, dimension: string, rotation: {
+                x: number;
+                y: number;
+                z?: number;
+            }, options?: TweenOptions) => Promise<void>;
+            getAnchorPointPosition: (bot: Bot, dimension: string, anchorPoint: BotAnchorPoint) => {
+                x: number;
+                y: number;
+                z: number;
+            };
+            beginAudioRecording: (options?: Omit<BeginAudioRecordingAction, 'type' | 'taskId'>) => Promise<void>;
+            endAudioRecording: () => Promise<Blob>;
+            beginRecording: (options?: RecordingOptions) => Promise<void>;
+            endRecording: () => Promise<Recording>;
+            speakText: (text: string, options?: SpeakTextApiOptions) => Promise<void>;
+            getVoices: () => Promise<SyntheticVoice[]>;
+        };
+        math: {
+            sum: (list: any) => number;
+            avg: (list: any) => number;
+            sqrt: (value: any) => number;
+            abs: (number: any) => number;
+            stdDev: (list: any) => number;
+            getSeededRandomNumberGenerator: (seed?: number | string) => PseudoRandomNumberGenerator;
+            setRandomSeed: (seed: number | string) => void;
+            randomInt: (min?: number, max?: number) => number;
+            random: (min?: number, max?: number) => number;
+            degreesToRadians: (degrees: number) => number;
+            radiansToDegrees: (radians: number) => number;
+            getForwardDirection: (pointerRotation: {
+                x: number;
+                y: number;
+                z: number;
+                w?: number;
+            } | Rotation) => Vector3;
+            intersectPlane: (origin: {
+                x: number;
+                y: number;
+                z: number;
+            }, direction: {
+                x: number;
+                y: number;
+                z: number;
+            }, planeNormal?: {
+                x: number;
+                y: number;
+                z: number;
+            }, planeOrigin?: {
+                x: number;
+                y: number;
+                z: number;
+            }) => Vector3;
+            getAnchorPointOffset: (anchorPoint: BotAnchorPoint) => Vector3;
+            addVectors: <T_8>(...vectors: T_8[]) => T_8;
+            subtractVectors: <T_9>(...vectors: T_9[]) => T_9;
+            negateVector: <T_10>(vector: T_10) => T_10;
+            normalizeVector: <T_11>(vector: T_11) => T_11;
+            vectorLength: <T_12>(vector: T_12) => number;
+            scaleVector: <T_13>(vector: T_13, scale: number) => T_13;
+            areClose: (first: number, second: number) => boolean;
+        };
+        mod: {
+            cameraPositionOffset: (point: {
+                x?: number;
+                y?: number;
+                z?: number;
+            }) => any;
+            cameraRotationOffset: (rotation: {
+                x?: number;
+                y?: number;
+                z?: number;
+            }) => any;
+        };
+        bytes: {
+            toBase64String: (bytes: Uint8Array) => string;
+            fromBase64String: (base64: string) => Uint8Array;
+            toHexString: (bytes: Uint8Array) => string;
+            fromHexString: (hex: string) => Uint8Array;
+            toBase64Url: (bytes: Uint8Array | string, mimeType?: string) => string;
+            fromBase64Url: (url: string) => Blob;
+        };
+        crypto: {
+            _hash_raw: (algorithm: 'sha256' | 'sha512' | 'sha1', format: 'raw', ...data: unknown[]) => Uint8Array;
+            _hash_string: (algorithm: 'sha256' | 'sha512' | 'sha1', format: 'hex' | 'base64', ...data: unknown[]) => string;
+            hash: {
+                (algorithm: 'sha256' | 'sha512' | 'sha1', format: 'hex' | 'base64', ...data: unknown[]): string;
+                (algorithm: 'sha256' | 'sha512' | 'sha1', format: 'raw', ...data: unknown[]): Uint8Array;
+            };
+            sha256: (...data: unknown[]) => string;
+            sha512: (...data: unknown[]) => string;
+            _hmac_string: (algorithm: 'sha256' | 'sha512' | 'sha1', format: 'hex' | 'base64', key: string, ...data: unknown[]) => string;
+            _hmac_raw: (algorithm: 'sha256' | 'sha512' | 'sha1', format: 'raw', key: string, ...data: unknown[]) => Uint8Array;
+            hmac: {
+                (algorithm: 'hmac-sha256' | 'hmac-sha512' | 'hmac-sha1', format: 'hex' | 'base64', key: string, ...data: unknown[]): string;
+                (algorithm: 'hmac-sha256' | 'hmac-sha512' | 'hmac-sha1', format: 'raw', key: string, ...data: unknown[]): Uint8Array;
+            };
+            hmacSha256: (key: string, ...data: unknown[]) => string;
+            hmacSha512: (key: string, ...data: unknown[]) => string;
+            encrypt: (secret: string, data: string) => string;
+            decrypt: (secret: string, data: string) => string;
+            isEncrypted: typeof isEncrypted;
+            asymmetric: {
+                keypair: (secret: string) => string;
+                isKeypair: typeof isAsymmetricKeypair;
+                encrypt: (keypair: string, data: string) => string;
+                decrypt: (keypair: string, secret: string, data: string) => string;
+                isEncrypted: typeof isAsymmetricEncrypted;
+            };
+            keypair: (secret: string) => string;
+            sign: (keypair: string, secret: string, data: string) => string;
+            verify: (keypair: string, signature: string, data: string) => boolean;
+        };
+        perf: {
+            getStats: () => PerformanceStats;
+        };
+        web: {
+            _webGet: (url: string, options?: WebhookOptions) => Promise<WebhookResult>;
+            _webPost: (url: string, data?: any, options?: WebhookOptions) => Promise<WebhookResult>;
+            _webHook: (options: WebhookOptions) => Promise<WebhookResult>;
+            get: ((url: string, options?: WebhookOptions) => Promise<WebhookResult>) & MaskableFunction;
+            post: ((url: string, data?: any, options?: WebhookOptions) => Promise<WebhookResult>) & MaskableFunction;
+            hook: {
+                (options: WebhookOptions): Promise<WebhookResult>;
+                post(url: string, data?: any, options?: WebhookOptions): Promise<WebhookResult>;
+            } & MaskableFunction;
+        };
+        analytics: {
+            recordEvent: (name: string, metadata?: any) => Promise<void>;
+        };
+    };
+    tagSpecificApi: {
+        create: ((options: TagSpecificApiOptions) => (...args: any[]) => RuntimeBot | RuntimeBot[]) & {
+            [INTERPRETABLE_FUNCTION]: (options: TagSpecificApiOptions) => (...args: any[]) => Generator<any, RuntimeBot | RuntimeBot[], any>;
+        };
+        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;
+    };
+};
+export type DefaultLibrary = ReturnType<typeof createDefaultLibrary>;
+//# sourceMappingURL=AuxLibrary.d.ts.map