Changes in version 0.18.0.9000 - getMode() no longer fails on very old versions of RStudio that lack the internal .rs.isDesktop() helper. In that case, it now falls back to versionInfo()$mode, which has been available since RStudio 0.97.124. (#326) - Added showEditSuggestion() for displaying edit suggestions in the RStudio editor. The function takes a document range and suggested replacement text, allowing RStudio to present a visual diff that users can accept or dismiss. Changes in version 0.18.0 (2026-01-16) - rstudioapi::documentNew() now accepts arbitrary document types. (#316) - Added getIdentityToken() for retrieving the current user's identity token on Posit Workbench, if possible. - Added OAuth integration functions for Posit Workbench: - getOAuthIntegrations(): List all configured OAuth integrations. - getOAuthIntegration(): Get metadata for a specific integration by GUID. - findOAuthIntegration(): Search for integrations by name, display name, GUID, or authentication status, with regex support. - getOAuthCredentials(): Retrieve OAuth credentials for an integration. - getDelegatedAzureToken() now works in any IDE running within a Posit Workbench session, not just RStudio. - launcherSubmitJob() gains the resourceProfile argument. Changes in version 0.17.1 (2024-10-22) - Ensure a more appropriate error message is emitted for calls to rstudioapi::getVersion() and rstudioapi::getMode() outside of RStudio. Changes in version 0.17.0 (2024-10-16) - Added getMode(), which can be used to differentiate between Desktop and Server installations of RStudio. (#280) Changes in version 0.16.0 (2024-03-24) - restartSession() gains the clean argument, for RStudio 2024.04 and newer. - Added setGhostText() for setting ghost text in the current editor. Changes in version 0.15.0 (2023-07-07) - Added getDelegatedAzureToken for Posit Workbench users needing to expose OAuth2 tokens for Azure services that have already had permissions configured Changes in version 0.14 (2022-08-22) - documentPath() now marks the encoding of file paths as UTF-8. (#257) - getSourceEditorContext() gains the id argument, to be used to request the editor context for a document with an already-known ID. (#251) - Added documentOpen(), for opening a document in RStudio and optionally navigating the cursor to a particular point in the file. The method is synchronous and returns the document ID upon completion. - Fixed an issue where rstudioapi::askForSecret() would erroneously fall back to using rstudioapi::askForPassword() during Knit. - Added registerCommandCallback, registerCommandStreamCallback, and unregisterCommandCallback, used to execute a callback after an IDE command is executed. Changes in version 0.13 (2020-11-12) - Fixed an issue where rstudioapi::insertText() would fail. (#208) Changes in version 0.12 (2020-11-10) - Fixed an issue where remote rstudioapi calls would erroneously use a previous response in some cases. - Allow navigateToFile to accept an empty file. This file will default to the file currently in view in the active column. - Added registerChunkExecCallback and unregisterChunkExecCallback, used to execute a callback after a chunk is ran. Changes in version 0.11 (2020-02-07) - rstudioapi::launcherResourceLimit() now properly delegates the type and memory arguments. (#164) - rstudioapi gains the function highlightUi(), used to highlight UI elements in newer versions of RStudio. - Paths returned from selectFile() are now properly marked with UTF-8 encoding. - It is now possible for rstudioapi to communicate with a parent RStudio session, for R sessions launched as RStudio jobs. Use rstudioapi::isAvailable(child_ok = TRUE) to assert that it's okay to check that rstudioapi is available and is running within an RStudio job. - Added bugReport(), a helper function for reporting RStudio bugs on the GitHub issue tracker with an issue template pre-populated with some helpful diagnostic information. - Added userIdentity and systemUsername, used to retrieve information about the current user. Changes in version 0.10 (2019-03-19) - Added the parameters echo and focus to sendToConsole(). Changes in version 0.9 - Added functions for displaying jobs in RStudio's Jobs pane: jobAdd(), jobRemove(), etc. - Added translateLocalUrl(), for translating localhost URLs to externally addressable ones on RStudio Server. Changes in version 0.8 (2018-10-02) - Added functions for installing + using build tools: buildToolsCheck(), buildToolsInstall(), buildToolsExec() - Added functions for installing + using themes: addTheme(), applyTheme(), convertTheme(), getThemes(), getThemeInfo(). - Added previewSql(), for previewing output from executing a SQL query. - Added askForSecret(), for prompting the user to enter a password or otherwise privileged information. - Fixed an issue where getActiveProject() failed for non-ASCII paths. (#86) Changes in version 0.7 (2017-09-07) - Added methods for prompting the user for file paths: selectFile(), selectDirectory(). - askForPassword() gains a default prompt (#41) - Add createProjectTemplate() function - Add setPersistentValue() / getPersistentValue() functions - Add methods for interacting with Terminal tab: terminalActivate(), terminalClear(), terminalCreate(), terminalList(), terminalBuffer(), terminalContext(), terminalVisible(), terminalBusy(), terminalRunning(), terminalKill(), terminalSend(), terminalExecute(), and terminalExitCode(). Changes in version 0.6 (2016-06-27) - Add sendToConsole function - Add APIs for setting cursor position in document Changes in version 0.5 (2016-01-24) - Add askForPassword function - Add getActiveProject function Changes in version 0.4 - Add API methods for interacting with a document open in RStudio: 'insertText()', 'modifyRange()' and 'getActiveDocumentContext()'. Changes in version 0.3 - Add stub and documentation for sourceMarker function Changes in version 0.2 (2014-12-31) - Compatibility with calling conventions for RStudio v0.99 - Stubs and documentation for versionInfo, previewRd, and viewer functions Changes in version 0.1 (2014-03-27) - Initial release to CRAN