@casual-simulation/aux-common 3.1.35 → 3.2.0

package/runtime/AuxLibrary.d.ts

@@ -1,5 +1,5 @@
 import { AuxGlobalContext, DEBUG_STRING } from './AuxGlobalContext';
-import { BotTags, Bot, ShowChatOptions, BotAction, BotsState, CameraType, BarcodeFormat, PortalType, ShowInputOptions, StartCheckoutOptions, 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, StartCheckoutAction, FinishCheckoutAction, RejectAction, FocusOnOptions, SnapTarget, AddDropSnapTargetsAction, RecordingOptions, Recording, SyntheticVoice, EnablePOVAction, EnableCustomDraggingAction, SetAppOutputAction, Record, RecordReference, PartialBotsState, ParsedBotLink, ConvertGeolocationToWhat3WordsOptions, BeginAudioRecordingAction, MediaPermssionOptions, ImageClassifierOptions, AddDropGridTargetsAction, DataRecordOptions, RecordActionOptions, JoinRoomActionOptions, RoomOptions, RoomTrackOptions, SetRoomTrackOptions, RoomRemoteOptions, InstUpdate, StartFormAnimationOptions, StopFormAnimationOptions, FormAnimationData, WakeLockConfiguration, EnableXROptions, TagMapper, ShowConfirmOptions } from '../bots';
+import { BotTags, Bot, ShowChatOptions, BotAction, BotsState, CameraType, BarcodeFormat, PortalType, ShowInputOptions, StartCheckoutOptions, 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, StartCheckoutAction, FinishCheckoutAction, RejectAction, FocusOnOptions, SnapTarget, AddDropSnapTargetsAction, RecordingOptions, Recording, SyntheticVoice, EnablePOVAction, EnableCustomDraggingAction, SetAppOutputAction, Record, RecordReference, PartialBotsState, ParsedBotLink, ConvertGeolocationToWhat3WordsOptions, BeginAudioRecordingAction, MediaPermssionOptions, ImageClassifierOptions, AddDropGridTargetsAction, DataRecordOptions, RecordActionOptions, JoinRoomActionOptions, RoomOptions, RoomTrackOptions, SetRoomTrackOptions, RoomRemoteOptions, InstUpdate, StartFormAnimationOptions, StopFormAnimationOptions, FormAnimationData, WakeLockConfiguration, EnableXROptions, TagMapper, ShowConfirmOptions, Geolocation } from '../bots';
 import { RemoteAction } from '@casual-simulation/causal-trees';
 import '../polyfill/Array.first.polyfill';
 import '../polyfill/Array.last.polyfill';
@@ -9,7 +9,8 @@ import './BlobPolyfill';
 import { AuxDevice } from './AuxDevice';
 import { AuxVersion } from './AuxVersion';
 import { Vector3, Vector2, Quaternion, Rotation } from '../math';
-import { CreatePublicRecordKeyResult, GetDataResult, RecordDataResult, RecordFileFailure, EraseDataResult, EraseFileResult, ListDataResult, AddCountResult, GetCountResult, GrantMarkerPermissionResponse, RevokeMarkerPermissionResult, GrantRoleResult, RevokeRoleResult } from '@casual-simulation/aux-records';
+import { CreatePublicRecordKeyResult, GetDataResult, RecordDataResult, RecordFileFailure, EraseDataResult, EraseFileResult, ListDataResult, AddCountResult, GetCountResult, GrantMarkerPermissionResult, RevokeMarkerPermissionResult, GrantRoleResult, RevokeRoleResult } from '@casual-simulation/aux-records';
+import type { AvailablePermissions } from '@casual-simulation/aux-records';
 import { DateTime } from 'luxon';
 import * as hooks from 'preact/hooks';
 import { render } from 'preact';
@@ -61,12 +62,23 @@ export interface AuxLibrary {
     };
     typeDefinitions?: string;
 }
-type TagFilter = ((value: any) => boolean) | string | number | boolean | null | undefined;
+/**
+ * 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
  */
-type Mod = BotTags | Bot;
+export type Mod = BotTags | Bot;
 /**
  * An interface that is used to say which user/device/session an event should be sent to.
  */
@@ -138,6 +150,12 @@ interface SaveFileOptions {
 }
 /**
  * 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 {
     /**
@@ -150,6 +168,8 @@ export interface WebhookOptions {
     url?: string;
     /**
      * The headers to include in the request.
+     *
+     * @docsource Headers
      */
     headers?: {
         [key: string]: string;
@@ -176,7 +196,13 @@ export interface WebhookOptions {
     retryAfterMs?: number;
 }
 /**
- * Defines a set of options for animateTag().
+ * 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 {
     /**
@@ -212,6 +238,19 @@ export interface AnimateTagFunctionOptions {
      */
     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;
@@ -325,8 +364,701 @@ export interface DebuggerInterface {
      */
     [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 {
     /**
@@ -335,8 +1067,51 @@ export interface AttachDebuggerOptions {
      */
     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 {
     /**
@@ -361,6 +1136,9 @@ export interface AuxDebuggerOptions {
 }
 /**
  * Defines an interface that contains options for a pause trigger.
+ *
+ * @dochash types/debuggers/common
+ * @docname PauseTriggerOptions
  */
 export interface PauseTriggerOptions {
     /**
@@ -384,6 +1162,9 @@ export interface PauseTriggerOptions {
 }
 /**
  * Defines an interface that represents a pause trigger.
+ *
+ * @dochash types/debuggers/common
+ * @docname PauseTrigger
  */
 export interface PauseTrigger extends PauseTriggerOptions {
     /**
@@ -401,6 +1182,8 @@ export interface PauseTrigger extends PauseTriggerOptions {
 }
 /**
  * Defines an interface that contains information about the current debugger pause state.
+ * @dochash types/debuggers/common
+ * @docname DebuggerPause
  */
 export interface DebuggerPause {
     /**
@@ -427,6 +1210,9 @@ export interface DebuggerPause {
 }
 /**
  * Defines an interface that contains information about a single call stack frame.
+ *
+ * @dochash types/debuggers/common
+ * @docname DebuggerCallFrame
  */
 export interface DebuggerCallFrame {
     /**
@@ -446,6 +1232,9 @@ export interface DebuggerCallFrame {
 }
 /**
  * Defines an interface that represents a location in a debugger.
+ *
+ * @dochash types/debuggers/common
+ * @docname DebuggerFunctionLocation
  */
 export interface DebuggerFunctionLocation {
     /**
@@ -471,6 +1260,9 @@ export interface DebuggerFunctionLocation {
 }
 /**
  * Defines an interface that represents a debugger variable.
+ *
+ * @dochash types/debuggers/common
+ * @docname DebuggerVariable
  */
 export interface DebuggerVariable {
     /**
@@ -500,6 +1292,9 @@ export interface DebuggerVariable {
 }
 /**
  * Defines an interface for a random number generator.
+ *
+ * @dochash types/core
+ * @docname PseudoRandomNumberGenerator
  */
 export interface PseudoRandomNumberGenerator {
     /**
@@ -536,6 +1331,9 @@ export interface WebhookInterface extends MaskableFunction {
 }
 /**
  * Defines an interface that represents the result of a webhook.
+ *
+ * @dochash types/web
+ * @docname WebhookResult
  */
 export interface WebhookResult {
     /**
@@ -550,12 +1348,30 @@ export interface WebhookResult {
     /**
      * 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;
     /**
@@ -568,11 +1384,38 @@ export interface RecordFileApiSuccess {
      */
     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.
@@ -627,90 +1470,324 @@ export interface SnapGridTarget {
      */
     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;
 }
 /**
@@ -737,6 +1814,9 @@ export interface RecordFileOptions {
 }
 /**
  * Defines an interface that represents the result of a raycast operation.
+ *
+ * @dochash types/os
+ * @docname RaycastResult
  */
 export interface RaycastResult {
     /**
@@ -786,7 +1866,10 @@ export interface BotIntersection {
     dimension: string;
 }
 /**
- * Defines an interface that represents a ray.
+ * 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 {
     /**
@@ -798,13 +1881,37 @@ export interface RaycastRay {
      */
     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: (...args: any[]) => RuntimeBot[];
+        _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;
@@ -826,32 +1933,50 @@ export declare function createDefaultLibrary(context: AuxGlobalContext): {
         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, ...diffs: Mod[]) => void;
-        subtractMods: (bot: any, ...diffs: Mod[]) => 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[];
@@ -861,33 +1986,42 @@ export declare function createDefaultLibrary(context: AuxGlobalContext): {
                 [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) => BotFilterFunction;
-        byID: (id: string) => IDRecordFilter;
-        byMod: (mod: Mod) => BotFilterFunction;
-        inDimension: (dimension: string) => BotFilterFunction;
-        atPosition: (dimension: string, x: number, y: number) => BotFilterFunction;
-        inStack: (bot: Bot, dimension: string) => BotFilterFunction;
-        neighboring: (bot: Bot, dimension: string, direction?: 'front' | 'left' | 'right' | 'back') => BotFilterFunction;
-        bySpace: (space: string) => SpaceFilter;
-        byCreator: (bot: Bot | string) => BotFilterFunction;
-        either: (...filters: BotFilterFunction[]) => BotFilterFunction;
-        not: (filter: BotFilterFunction) => BotFilterFunction;
-        remote: (event: BotAction, selector?: SessionSelector | string | (SessionSelector | string)[], allowBatching?: boolean) => RemoteAction | RemoteAction[];
+        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;
@@ -897,6 +2031,26 @@ export declare function createDefaultLibrary(context: AuxGlobalContext): {
         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;
         os: {
             [x: symbol]: boolean;
             sleep: (time: number) => Promise<void>;
@@ -911,11 +2065,19 @@ export declare function createDefaultLibrary(context: AuxGlobalContext): {
             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>;
@@ -927,8 +2089,8 @@ export declare function createDefaultLibrary(context: AuxGlobalContext): {
             disableAR: () => EnableARAction;
             enableVR: (options?: EnableXROptions) => EnableVRAction;
             disableVR: () => EnableVRAction;
-            arSupported: () => Promise<any>;
-            vrSupported: () => Promise<any>;
+            arSupported: () => Promise<boolean>;
+            vrSupported: () => Promise<boolean>;
             enablePointOfView: (center?: {
                 x: number;
                 y: number;
@@ -944,7 +2106,7 @@ export declare function createDefaultLibrary(context: AuxGlobalContext): {
             downloadServer: () => DownloadAction;
             downloadInst: () => DownloadAction;
             showUploadAuxFile: () => ShowUploadAuxFileAction;
-            showUploadFiles: () => Promise<any>;
+            showUploadFiles: () => Promise<UploadedFile[]>;
             openQRCodeScanner: (camera?: CameraType) => OpenQRCodeScannerAction;
             closeQRCodeScanner: () => OpenQRCodeScannerAction;
             showQRCode: (code: string) => ShowQRCodeAction;
@@ -956,29 +2118,72 @@ export declare function createDefaultLibrary(context: AuxGlobalContext): {
             openImageClassifier: (options: ImageClassifierOptions) => Promise<void>;
             closeImageClassifier: () => Promise<void>;
             /**
-             * Gets the local device time in Miliseconds since January 1st 1970 UTC-0.
+             * 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 current agreed upon inst time in miliseconds since January 1st 1970 UTC-0.
+             * 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 calculated latency (in miliseconds) between this device and the inst server.
+             * 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 this device and the inst server in miliseconds.
+             * 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 maximum spread between time offset samples in miliseconds.
-             * Useful for determining how closely the agreedUponTime matches the server time.
+             * 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 current agreed upon time plus an offset that attempts to ensure that
-             * changes/events will have been synchronized between all connected devices by the moment that this time occurrs.
+             * 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;
@@ -987,7 +2192,7 @@ export declare function createDefaultLibrary(context: AuxGlobalContext): {
             unloadInst: (id: string) => UnloadServerAction;
             importAUX: (urlOrJSON: string) => Promise<void>;
             parseBotsFromData: (jsonOrPdf: string | ArrayBuffer) => Bot[];
-            replaceDragBot: (bot: Mod) => ReplaceDragBotAction;
+            replaceDragBot: (bot: RuntimeBot) => ReplaceDragBotAction;
             isInDimension: (dimension: string) => boolean;
             getCurrentDimension: () => string;
             getCurrentServer: () => string;
@@ -997,6 +2202,7 @@ export declare function createDefaultLibrary(context: AuxGlobalContext): {
             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;
@@ -1046,8 +2252,8 @@ export declare function createDefaultLibrary(context: AuxGlobalContext): {
             getRoomRemoteOptions: (roomName: string, remoteId: string) => Promise<GetRoomRemoteOptionsResult>;
             registerTagPrefix: (prefix: string, options?: RegisterPrefixOptions) => Promise<void>;
             registerApp: (portalId: string, bot: Bot | string) => Promise<void>;
-            unregisterApp: (portalId: string) => Promise<void>;
-            compileApp: (portalId: string, output: any) => SetAppOutputAction;
+            unregisterApp: (appId: string) => Promise<void>;
+            compileApp: (appId: string, content: any) => SetAppOutputAction;
             appHooks: {
                 render: typeof render;
                 useState<S>(initialState: S | (() => S)): [S, hooks.StateUpdater<S>];
@@ -1070,35 +2276,39 @@ export declare function createDefaultLibrary(context: AuxGlobalContext): {
             requestAuthBot: () => Promise<Bot>;
             getPublicRecordKey: (name: string) => Promise<CreatePublicRecordKeyResult>;
             getSubjectlessPublicRecordKey: (name: string) => Promise<CreatePublicRecordKeyResult>;
-            grantRecordMarkerPermission: (recordName: string, marker: string, permission: object, options?: RecordActionOptions) => Promise<GrantMarkerPermissionResponse>;
-            revokeRecordMarkerPermission: (recordName: string, marker: string, permission: object, options?: RecordActionOptions) => Promise<RevokeMarkerPermissionResult>;
+            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: (recordKey: string, address: string, data: any, endpointOrOptions?: string | (DataRecordOptions & {
-                marker?: string;
-            })) => Promise<RecordDataResult>;
-            recordManualApprovalData: (recordKey: string, address: string, data: any, endpointOrOptions?: string | (DataRecordOptions & {
-                marker?: string;
-            })) => Promise<RecordDataResult>;
+            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: (recordKey: string, address: string, endpoint?: string) => Promise<EraseDataResult>;
-            eraseManualApprovalData: (recordKey: string, address: string, endpoint?: string) => Promise<EraseDataResult>;
-            recordFile: (recordKey: string, data: any, options?: RecordFileOptions, endpoint?: string) => Promise<RecordFileApiResult>;
+            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: {
-                (recordKey: string, result: RecordFileApiSuccess, endpoint?: string): Promise<EraseFileResult>;
-                (recordKey: string, url: string, endpoint?: string): Promise<EraseFileResult>;
+                (recordKeyOrName: string, result: RecordFileApiSuccess, endpoint?: string): Promise<EraseFileResult>;
+                (recordKeyOrName: string, url: string, endpoint?: string): Promise<EraseFileResult>;
             };
-            recordEvent: (recordKey: string, eventName: string, endpoint?: string) => Promise<AddCountResult>;
+            recordEvent: (recordKeyOrName: string, eventName: string, endpoint?: string) => Promise<AddCountResult>;
             countEvents: (recordNameOrKey: string, eventName: string, endpoint?: string) => Promise<GetCountResult>;
             convertGeolocationToWhat3Words: (location: ConvertGeolocationToWhat3WordsOptions) => Promise<string>;
             raycastFromCamera: (portal: 'grid' | 'miniGrid' | 'map' | 'miniMap', viewportCoordinates: Vector2) => Promise<RaycastResult>;
@@ -1130,6 +2340,11 @@ export declare function createDefaultLibrary(context: AuxGlobalContext): {
             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>;
@@ -1206,6 +2421,9 @@ export declare function createDefaultLibrary(context: AuxGlobalContext): {
             perform: (action: any) => any;
             reject: (action: any) => RejectAction;
         };
+        /**
+         * @hidden
+         */
         adminSpace: {
             unlock: (password: string) => Promise<void>;
             setPassword: (oldPassword: string, newPassword: string) => Promise<void>;
@@ -1301,12 +2519,16 @@ export declare function createDefaultLibrary(context: AuxGlobalContext): {
             fromHexString: (hex: string) => Uint8Array;
         };
         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;
@@ -1335,6 +2557,9 @@ export declare function createDefaultLibrary(context: AuxGlobalContext): {
             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: {
@@ -1356,5 +2581,6 @@ export declare function createDefaultLibrary(context: AuxGlobalContext): {
         watchBot: (options: TagSpecificApiOptions) => (bot: (Bot | string)[] | Bot | string, handler: () => void | Generator<InterpreterStop, any, InterpreterContinuation>) => number;
     };
 };
+export type DefaultLibrary = ReturnType<typeof createDefaultLibrary>;
 export {};
 //# sourceMappingURL=AuxLibrary.d.ts.map