@salesforce/plugin-org 5.11.3 → 5.11.5

package/README.md

@@ -161,7 +161,7 @@ EXAMPLES
     $ sf org auth show-access-token --target-org my-org --json
 ```
 
-_See code: [src/commands/org/auth/show-access-token.ts](https://github.com/salesforcecli/plugin-org/blob/5.11.3/src/commands/org/auth/show-access-token.ts)_
+_See code: [src/commands/org/auth/show-access-token.ts](https://github.com/salesforcecli/plugin-org/blob/5.11.5/src/commands/org/auth/show-access-token.ts)_
 
 ## `sf org auth show-sfdx-auth-url`
 
@@ -205,7 +205,7 @@ EXAMPLES
     $ sf org auth show-sfdx-auth-url --target-org my-org --json
 ```
 
-_See code: [src/commands/org/auth/show-sfdx-auth-url.ts](https://github.com/salesforcecli/plugin-org/blob/5.11.3/src/commands/org/auth/show-sfdx-auth-url.ts)_
+_See code: [src/commands/org/auth/show-sfdx-auth-url.ts](https://github.com/salesforcecli/plugin-org/blob/5.11.5/src/commands/org/auth/show-sfdx-auth-url.ts)_
 
 ## `sf org auth show-user-password`
 
@@ -252,7 +252,7 @@ EXAMPLES
     $ sf org auth show-user-password --target-org my-org --json
 ```
 
-_See code: [src/commands/org/auth/show-user-password.ts](https://github.com/salesforcecli/plugin-org/blob/5.11.3/src/commands/org/auth/show-user-password.ts)_
+_See code: [src/commands/org/auth/show-user-password.ts](https://github.com/salesforcecli/plugin-org/blob/5.11.5/src/commands/org/auth/show-user-password.ts)_
 
 ## `sf org create agent-user`
 
@@ -330,7 +330,7 @@ FLAG DESCRIPTIONS
     "agent.user.<GUID>@your-org-domain.com".
 ```
 
-_See code: [src/commands/org/create/agent-user.ts](https://github.com/salesforcecli/plugin-org/blob/5.11.3/src/commands/org/create/agent-user.ts)_
+_See code: [src/commands/org/create/agent-user.ts](https://github.com/salesforcecli/plugin-org/blob/5.11.5/src/commands/org/create/agent-user.ts)_
 
 ## `sf org create sandbox`
 
@@ -464,7 +464,7 @@ FLAG DESCRIPTIONS
     You can specify either --source-sandbox-name or --source-id when cloning an existing sandbox, but not both.
 ```
 
-_See code: [src/commands/org/create/sandbox.ts](https://github.com/salesforcecli/plugin-org/blob/5.11.3/src/commands/org/create/sandbox.ts)_
+_See code: [src/commands/org/create/sandbox.ts](https://github.com/salesforcecli/plugin-org/blob/5.11.5/src/commands/org/create/sandbox.ts)_
 
 ## `sf org create scratch`
 
@@ -646,7 +646,7 @@ FLAG DESCRIPTIONS
     Omit this flag to have Salesforce generate a unique username for your org.
 ```
 
-_See code: [src/commands/org/create/scratch.ts](https://github.com/salesforcecli/plugin-org/blob/5.11.3/src/commands/org/create/scratch.ts)_
+_See code: [src/commands/org/create/scratch.ts](https://github.com/salesforcecli/plugin-org/blob/5.11.5/src/commands/org/create/scratch.ts)_
 
 ## `sf org delete sandbox`
 
@@ -692,7 +692,7 @@ EXAMPLES
     $ sf org delete sandbox --target-org my-sandbox --no-prompt
 ```
 
-_See code: [src/commands/org/delete/sandbox.ts](https://github.com/salesforcecli/plugin-org/blob/5.11.3/src/commands/org/delete/sandbox.ts)_
+_See code: [src/commands/org/delete/sandbox.ts](https://github.com/salesforcecli/plugin-org/blob/5.11.5/src/commands/org/delete/sandbox.ts)_
 
 ## `sf org delete scratch`
 
@@ -736,7 +736,7 @@ EXAMPLES
     $ sf org delete scratch --target-org my-scratch-org --no-prompt
 ```
 
-_See code: [src/commands/org/delete/scratch.ts](https://github.com/salesforcecli/plugin-org/blob/5.11.3/src/commands/org/delete/scratch.ts)_
+_See code: [src/commands/org/delete/scratch.ts](https://github.com/salesforcecli/plugin-org/blob/5.11.5/src/commands/org/delete/scratch.ts)_
 
 ## `sf org disable tracking`
 
@@ -775,7 +775,7 @@ EXAMPLES
     $ sf org disable tracking
 ```
 
-_See code: [src/commands/org/disable/tracking.ts](https://github.com/salesforcecli/plugin-org/blob/5.11.3/src/commands/org/disable/tracking.ts)_
+_See code: [src/commands/org/disable/tracking.ts](https://github.com/salesforcecli/plugin-org/blob/5.11.5/src/commands/org/disable/tracking.ts)_
 
 ## `sf org display`
 
@@ -820,7 +820,7 @@ EXAMPLES
     $ sf org display --target-org TestOrg1 --verbose
 ```
 
-_See code: [src/commands/org/display.ts](https://github.com/salesforcecli/plugin-org/blob/5.11.3/src/commands/org/display.ts)_
+_See code: [src/commands/org/display.ts](https://github.com/salesforcecli/plugin-org/blob/5.11.5/src/commands/org/display.ts)_
 
 ## `sf org enable tracking`
 
@@ -862,7 +862,7 @@ EXAMPLES
     $ sf org enable tracking
 ```
 
-_See code: [src/commands/org/enable/tracking.ts](https://github.com/salesforcecli/plugin-org/blob/5.11.3/src/commands/org/enable/tracking.ts)_
+_See code: [src/commands/org/enable/tracking.ts](https://github.com/salesforcecli/plugin-org/blob/5.11.5/src/commands/org/enable/tracking.ts)_
 
 ## `sf org list`
 
@@ -901,7 +901,7 @@ EXAMPLES
     $ sf org list --clean
 ```
 
-_See code: [src/commands/org/list.ts](https://github.com/salesforcecli/plugin-org/blob/5.11.3/src/commands/org/list.ts)_
+_See code: [src/commands/org/list.ts](https://github.com/salesforcecli/plugin-org/blob/5.11.5/src/commands/org/list.ts)_
 
 ## `sf org list metadata`
 
@@ -968,7 +968,7 @@ FLAG DESCRIPTIONS
     Examples of metadata types that use folders are Dashboard, Document, EmailTemplate, and Report.
 ```
 
-_See code: [src/commands/org/list/metadata.ts](https://github.com/salesforcecli/plugin-org/blob/5.11.3/src/commands/org/list/metadata.ts)_
+_See code: [src/commands/org/list/metadata.ts](https://github.com/salesforcecli/plugin-org/blob/5.11.5/src/commands/org/list/metadata.ts)_
 
 ## `sf org list metadata-types`
 
@@ -1023,7 +1023,7 @@ FLAG DESCRIPTIONS
     Override the api version used for api requests made by this command
 ```
 
-_See code: [src/commands/org/list/metadata-types.ts](https://github.com/salesforcecli/plugin-org/blob/5.11.3/src/commands/org/list/metadata-types.ts)_
+_See code: [src/commands/org/list/metadata-types.ts](https://github.com/salesforcecli/plugin-org/blob/5.11.5/src/commands/org/list/metadata-types.ts)_
 
 ## `sf org open`
 
@@ -1099,11 +1099,11 @@ EXAMPLES
     $ sf org open --source-file force-app/main/default/bots/Coral_Cloud_Agent/Coral_Cloud_Agent.bot-meta.xml
 ```
 
-_See code: [src/commands/org/open.ts](https://github.com/salesforcecli/plugin-org/blob/5.11.3/src/commands/org/open.ts)_
+_See code: [src/commands/org/open.ts](https://github.com/salesforcecli/plugin-org/blob/5.11.5/src/commands/org/open.ts)_
 
 ## `sf org open agent`
 
-Open an agent in your org's Agent Builder UI in a browser.
+Open an agent in your org's Agentforce Builder UI in a browser.
 
 ```
 USAGE
@@ -1114,35 +1114,35 @@ FLAGS
   -b, --browser=<option>          Browser where the org opens.
                                   <options: chrome|edge|firefox>
   -n, --api-name=<value>          API name, also known as developer name, of the agent you want to open in the org's
-                                  Agent Builder UI.
+                                  Agentforce Builder UI.
   -o, --target-org=<value>        (required) Username or alias of the target org. Not required if the `target-org`
                                   configuration variable is already set.
   -r, --url-only                  Display navigation URL, but don’t launch browser.
       --api-version=<value>       Override the api version used for api requests made by this command
-      --authoring-bundle=<value>  API name of the agent to open in Agentforce Builder.
-      --private                   Open the org in the default browser using private (incognito) mode.
-      --version=<value>           Version number of the agent to open in Agentforce Builder.
+      --authoring-bundle=<value>  API name of the agent's authoring bundle to open in Agentforce Builder.
+      --private                   Open the agent in the default browser using private (incognito) mode.
+      --version=<value>           Version number of the agent to open in Agentforce Builder. If not specified, the
+                                  highest version is opened by default.
 
 GLOBAL FLAGS
   --flags-dir=<value>  Import flag values from a directory.
   --json               Format output as json.
 
 DESCRIPTION
-  Open an agent in your org's Agent Builder UI in a browser.
+  Open an agent in your org's Agentforce Builder UI in a browser.
 
-  Use the --api-name flag to open an agent using its API name in the Agent Builder UI of your org. To find the agent's
-  API name, go to Setup in your org and navigate to the agent's details page.
-
-  Alternatively, use the --authoring-bundle flag to open an agent in Agentforce Builder. Optionally include --version to
-  open a specific version of the agent. You'll specify the api name of the authoring bundle.
+  Use the --api-name flag to open an agent using its API name in the Agentforce Builder UI of your org. Alternatively,
+  use the --authoring-bundle flag to open an agent using the API name of its authoring bundle. The two API names are
+  typically the same for the same agent. Optionally specify the --version flag to open a specific version of the agent.
 
   To generate the URL but not launch it in your browser, specify --url-only.
 
-  To open Agent Builder in a specific browser, use the --browser flag. Supported browsers are "chrome", "edge", and
+  To open Agentforce Builder in a specific browser, use the --browser flag. Supported browsers are "chrome", "edge", and
   "firefox". If you don't specify --browser, the org opens in your default browser.
 
 EXAMPLES
-  Open the agent with API name Coral_Cloud_Agent in your default org using your default browser:
+  Open the agent with API name Coral_Cloud_Agent in your default org using your default browser; opens the highest
+  version:
 
     $ sf org open agent --api-name Coral_Cloud_Agent
 
@@ -1154,27 +1154,16 @@ EXAMPLES
 
     $ sf org open agent --target-org MyTestOrg1 --browser firefox --api-name Coral_Cloud_Agent
 
-  Open an agent in Agentforce Builder using its authoring bundle name:
-
-    $ sf org open agent --authoring-bundle MyAgent
-
-  Open a specific version of an agent in Agentforce Builder:
-
-    $ sf org open agent --authoring-bundle MyAgent --version 1
-
-FLAG DESCRIPTIONS
-  --authoring-bundle=<value>  API name of the agent to open in Agentforce Builder.
+  Open an agent in Agentforce Builder using its authoring bundle API name:
 
-    The API name of the agent to open directly in Agentforce Builder. Optionally specify --version to open a specific
-    version.
+    $ sf org open agent --authoring-bundle Coral_Cloud_Agent
 
-  --version=<value>  Version number of the agent to open in Agentforce Builder.
+  Open a version 1 of an agent in Agentforce Builder:
 
-    The version number of the agent to open directly in Agentforce Builder. Can only be used with the --authoring-bundle
-    flag.
+    $ sf org open agent --authoring-bundle Coral_Cloud_Agent --version 1
 ```
 
-_See code: [src/commands/org/open/agent.ts](https://github.com/salesforcecli/plugin-org/blob/5.11.3/src/commands/org/open/agent.ts)_
+_See code: [src/commands/org/open/agent.ts](https://github.com/salesforcecli/plugin-org/blob/5.11.5/src/commands/org/open/agent.ts)_
 
 ## `sf org open authoring-bundle`
 
@@ -1220,7 +1209,7 @@ EXAMPLES
     $ sf org open authoring-bundle --target-org MyTestOrg1 --browser firefox
 ```
 
-_See code: [src/commands/org/open/authoring-bundle.ts](https://github.com/salesforcecli/plugin-org/blob/5.11.3/src/commands/org/open/authoring-bundle.ts)_
+_See code: [src/commands/org/open/authoring-bundle.ts](https://github.com/salesforcecli/plugin-org/blob/5.11.5/src/commands/org/open/authoring-bundle.ts)_
 
 ## `sf org refresh sandbox`
 
@@ -1323,7 +1312,7 @@ FLAG DESCRIPTIONS
     You can specify either --source-sandbox-name or --source-id when refreshing an existing sandbox, but not both.
 ```
 
-_See code: [src/commands/org/refresh/sandbox.ts](https://github.com/salesforcecli/plugin-org/blob/5.11.3/src/commands/org/refresh/sandbox.ts)_
+_See code: [src/commands/org/refresh/sandbox.ts](https://github.com/salesforcecli/plugin-org/blob/5.11.5/src/commands/org/refresh/sandbox.ts)_
 
 ## `sf org resume sandbox`
 
@@ -1386,7 +1375,7 @@ FLAG DESCRIPTIONS
     returns the job ID. To resume checking the sandbox creation, rerun this command.
 ```
 
-_See code: [src/commands/org/resume/sandbox.ts](https://github.com/salesforcecli/plugin-org/blob/5.11.3/src/commands/org/resume/sandbox.ts)_
+_See code: [src/commands/org/resume/sandbox.ts](https://github.com/salesforcecli/plugin-org/blob/5.11.5/src/commands/org/resume/sandbox.ts)_
 
 ## `sf org resume scratch`
 
@@ -1439,6 +1428,6 @@ FLAG DESCRIPTIONS
     returns the job ID. To resume checking the scratch creation, rerun this command.
 ```
 
-_See code: [src/commands/org/resume/scratch.ts](https://github.com/salesforcecli/plugin-org/blob/5.11.3/src/commands/org/resume/scratch.ts)_
+_See code: [src/commands/org/resume/scratch.ts](https://github.com/salesforcecli/plugin-org/blob/5.11.5/src/commands/org/resume/scratch.ts)_
 
 <!-- commandsstop -->

package/lib/commands/org/open/agent.js

@@ -49,12 +49,10 @@ export class OrgOpenAgent extends OrgOpenCommandBase {
         }),
         'authoring-bundle': Flags.string({
             summary: messages.getMessage('flags.authoring-bundle.summary'),
-            description: messages.getMessage('flags.authoring-bundle.description'),
             exactlyOne: ['api-name', 'authoring-bundle'],
         }),
         version: Flags.string({
             summary: messages.getMessage('flags.version.summary'),
-            description: messages.getMessage('flags.version.description'),
         }),
     };
     async run() {

package/lib/commands/org/open/agent.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent.js","sourceRoot":"","sources":["../../../../src/commands/org/open/agent.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"agent.js","sourceRoot":"","sources":["../../../../src/commands/org/open/agent.ts"],"names":[],"mappings":"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"}

package/messages/open.agent.md

@@ -1,20 +1,18 @@
 # summary
 
-Open an agent in your org's Agent Builder UI in a browser.
+Open an agent in your org's Agentforce Builder UI in a browser.
 
 # description
 
-Use the --api-name flag to open an agent using its API name in the Agent Builder UI of your org. To find the agent's API name, go to Setup in your org and navigate to the agent's details page.
-
-Alternatively, use the --authoring-bundle flag to open an agent in Agentforce Builder. Optionally include --version to open a specific version of the agent. You'll specify the api name of the authoring bundle.
+Use the --api-name flag to open an agent using its API name in the Agentforce Builder UI of your org. Alternatively, use the --authoring-bundle flag to open an agent using the API name of its authoring bundle. The two API names are typically the same for the same agent. Optionally specify the --version flag to open a specific version of the agent.
 
 To generate the URL but not launch it in your browser, specify --url-only.
 
-To open Agent Builder in a specific browser, use the --browser flag. Supported browsers are "chrome", "edge", and "firefox". If you don't specify --browser, the org opens in your default browser.
+To open Agentforce Builder in a specific browser, use the --browser flag. Supported browsers are "chrome", "edge", and "firefox". If you don't specify --browser, the org opens in your default browser.
 
 # examples
 
-- Open the agent with API name Coral_Cloud_Agent in your default org using your default browser:
+- Open the agent with API name Coral_Cloud_Agent in your default org using your default browser; opens the highest version:
 
   $ <%= config.bin %> <%= command.id %> --api-name Coral_Cloud_Agent
 
@@ -26,21 +24,21 @@ To open Agent Builder in a specific browser, use the --browser flag. Supported b
 
   $ <%= config.bin %> <%= command.id %> --target-org MyTestOrg1 --browser firefox --api-name Coral_Cloud_Agent
 
-- Open an agent in Agentforce Builder using its authoring bundle name:
+- Open an agent in Agentforce Builder using its authoring bundle API name:
 
-  $ <%= config.bin %> <%= command.id %> --authoring-bundle MyAgent
+  $ <%= config.bin %> <%= command.id %> --authoring-bundle Coral_Cloud_Agent
 
-- Open a specific version of an agent in Agentforce Builder:
+- Open a version 1 of an agent in Agentforce Builder:
 
-  $ <%= config.bin %> <%= command.id %> --authoring-bundle MyAgent --version 1
+  $ <%= config.bin %> <%= command.id %> --authoring-bundle Coral_Cloud_Agent --version 1
 
 # flags.api-name.summary
 
-API name, also known as developer name, of the agent you want to open in the org's Agent Builder UI.
+API name, also known as developer name, of the agent you want to open in the org's Agentforce Builder UI.
 
 # flags.private.summary
 
-Open the org in the default browser using private (incognito) mode.
+Open the agent in the default browser using private (incognito) mode.
 
 # flags.browser.summary
 
@@ -52,18 +50,8 @@ Display navigation URL, but don’t launch browser.
 
 # flags.authoring-bundle.summary
 
-API name of the agent to open in Agentforce Builder.
-
-# flags.authoring-bundle.description
-
-The API name of the agent to open directly in Agentforce Builder. Optionally specify --version to open a specific
-version.
+API name of the agent's authoring bundle to open in Agentforce Builder.
 
 # flags.version.summary
 
-Version number of the agent to open in Agentforce Builder.
-
-# flags.version.description
-
-The version number of the agent to open directly in Agentforce Builder. Can only be used with the --authoring-bundle
-flag.
+Version number of the agent to open in Agentforce Builder. If not specified, the highest version is opened by default.

package/oclif.manifest.json

@@ -1389,6 +1389,69 @@
         "tracking:disable:org"
       ]
     },
+    "org:enable:tracking": {
+      "aliases": [],
+      "args": {},
+      "description": "Enabling source tracking has no direct effect on the org, it affects only your local environment. Specifically, Salesforce CLI stores the setting in the org's local configuration file so that source tracking operations are executed when working with the org.\n\nThis command throws an error if the org doesn't support tracking. Examples of orgs that don't support source tracking include Developer Edition orgs, production orgs, Partial Copy sandboxes, and Full sandboxes.",
+      "examples": [
+        "Enable source tracking for an org with alias \"myscratch\":\n<%= config.bin %> <%= command.id %> --target-org myscratch",
+        "Enable source tracking for an org using a username:\n<%= config.bin %> <%= command.id %> --target-org you@example.com",
+        "Enable source tracking for your default org:\n<%= config.bin %> <%= command.id %>"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "flags-dir": {
+          "helpGroup": "GLOBAL",
+          "name": "flags-dir",
+          "summary": "Import flag values from a directory.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "target-org": {
+          "char": "o",
+          "name": "target-org",
+          "noCacheDefault": true,
+          "required": true,
+          "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
+          "hasDynamicHelp": true,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": true,
+      "hiddenAliases": [],
+      "id": "org:enable:tracking",
+      "pluginAlias": "@salesforce/plugin-org",
+      "pluginName": "@salesforce/plugin-org",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "Allow Salesforce CLI to track changes in your source files between your project and an org.",
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "lib",
+        "commands",
+        "org",
+        "enable",
+        "tracking.js"
+      ],
+      "aliasPermutations": [],
+      "permutations": [
+        "org:enable:tracking",
+        "enable:org:tracking",
+        "enable:tracking:org",
+        "org:tracking:enable",
+        "tracking:org:enable",
+        "tracking:enable:org"
+      ]
+    },
     "org:list:metadata-types": {
       "aliases": [
         "force:mdapi:describemetadata"
@@ -1648,79 +1711,16 @@
         "metadata:list:org"
       ]
     },
-    "org:enable:tracking": {
-      "aliases": [],
-      "args": {},
-      "description": "Enabling source tracking has no direct effect on the org, it affects only your local environment. Specifically, Salesforce CLI stores the setting in the org's local configuration file so that source tracking operations are executed when working with the org.\n\nThis command throws an error if the org doesn't support tracking. Examples of orgs that don't support source tracking include Developer Edition orgs, production orgs, Partial Copy sandboxes, and Full sandboxes.",
-      "examples": [
-        "Enable source tracking for an org with alias \"myscratch\":\n<%= config.bin %> <%= command.id %> --target-org myscratch",
-        "Enable source tracking for an org using a username:\n<%= config.bin %> <%= command.id %> --target-org you@example.com",
-        "Enable source tracking for your default org:\n<%= config.bin %> <%= command.id %>"
-      ],
-      "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "flags-dir": {
-          "helpGroup": "GLOBAL",
-          "name": "flags-dir",
-          "summary": "Import flag values from a directory.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "target-org": {
-          "char": "o",
-          "name": "target-org",
-          "noCacheDefault": true,
-          "required": true,
-          "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
-          "hasDynamicHelp": true,
-          "multiple": false,
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": true,
-      "hiddenAliases": [],
-      "id": "org:enable:tracking",
-      "pluginAlias": "@salesforce/plugin-org",
-      "pluginName": "@salesforce/plugin-org",
-      "pluginType": "core",
-      "strict": true,
-      "summary": "Allow Salesforce CLI to track changes in your source files between your project and an org.",
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "lib",
-        "commands",
-        "org",
-        "enable",
-        "tracking.js"
-      ],
-      "aliasPermutations": [],
-      "permutations": [
-        "org:enable:tracking",
-        "enable:org:tracking",
-        "enable:tracking:org",
-        "org:tracking:enable",
-        "tracking:org:enable",
-        "tracking:enable:org"
-      ]
-    },
     "org:open:agent": {
       "aliases": [],
       "args": {},
-      "description": "Use the --api-name flag to open an agent using its API name in the Agent Builder UI of your org. To find the agent's API name, go to Setup in your org and navigate to the agent's details page.\n\nAlternatively, use the --authoring-bundle flag to open an agent in Agentforce Builder. Optionally include --version to open a specific version of the agent. You'll specify the api name of the authoring bundle.\n\nTo generate the URL but not launch it in your browser, specify --url-only.\n\nTo open Agent Builder in a specific browser, use the --browser flag. Supported browsers are \"chrome\", \"edge\", and \"firefox\". If you don't specify --browser, the org opens in your default browser.",
+      "description": "Use the --api-name flag to open an agent using its API name in the Agentforce Builder UI of your org. Alternatively, use the --authoring-bundle flag to open an agent using the API name of its authoring bundle. The two API names are typically the same for the same agent. Optionally specify the --version flag to open a specific version of the agent.\n\nTo generate the URL but not launch it in your browser, specify --url-only.\n\nTo open Agentforce Builder in a specific browser, use the --browser flag. Supported browsers are \"chrome\", \"edge\", and \"firefox\". If you don't specify --browser, the org opens in your default browser.",
       "examples": [
-        "Open the agent with API name Coral_Cloud_Agent in your default org using your default browser:\n$ <%= config.bin %> <%= command.id %> --api-name Coral_Cloud_Agent",
+        "Open the agent with API name Coral_Cloud_Agent in your default org using your default browser; opens the highest version:\n$ <%= config.bin %> <%= command.id %> --api-name Coral_Cloud_Agent",
         "Open the agent in an incognito window of your default browser:\n$ <%= config.bin %> <%= command.id %> --private --api-name Coral_Cloud_Agent:",
         "Open the agent in an org with alias MyTestOrg1 using the Firefox browser:\n$ <%= config.bin %> <%= command.id %> --target-org MyTestOrg1 --browser firefox --api-name Coral_Cloud_Agent",
-        "Open an agent in Agentforce Builder using its authoring bundle name:\n$ <%= config.bin %> <%= command.id %> --authoring-bundle MyAgent",
-        "Open a specific version of an agent in Agentforce Builder:\n$ <%= config.bin %> <%= command.id %> --authoring-bundle MyAgent --version 1"
+        "Open an agent in Agentforce Builder using its authoring bundle API name:\n$ <%= config.bin %> <%= command.id %> --authoring-bundle Coral_Cloud_Agent",
+        "Open a version 1 of an agent in Agentforce Builder:\n$ <%= config.bin %> <%= command.id %> --authoring-bundle Coral_Cloud_Agent --version 1"
       ],
       "flags": {
         "json": {
@@ -1758,7 +1758,7 @@
         "api-name": {
           "char": "n",
           "name": "api-name",
-          "summary": "API name, also known as developer name, of the agent you want to open in the org's Agent Builder UI.",
+          "summary": "API name, also known as developer name, of the agent you want to open in the org's Agentforce Builder UI.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -1769,7 +1769,7 @@
             "browser"
           ],
           "name": "private",
-          "summary": "Open the org in the default browser using private (incognito) mode.",
+          "summary": "Open the agent in the default browser using private (incognito) mode.",
           "allowNo": false,
           "type": "boolean"
         },
@@ -1802,17 +1802,15 @@
           "type": "boolean"
         },
         "authoring-bundle": {
-          "description": "The API name of the agent to open directly in Agentforce Builder. Optionally specify --version to open a specific\nversion.",
           "name": "authoring-bundle",
-          "summary": "API name of the agent to open in Agentforce Builder.",
+          "summary": "API name of the agent's authoring bundle to open in Agentforce Builder.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
         "version": {
-          "description": "The version number of the agent to open directly in Agentforce Builder. Can only be used with the --authoring-bundle\nflag.",
           "name": "version",
-          "summary": "Version number of the agent to open in Agentforce Builder.",
+          "summary": "Version number of the agent to open in Agentforce Builder. If not specified, the highest version is opened by default.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -1825,7 +1823,7 @@
       "pluginName": "@salesforce/plugin-org",
       "pluginType": "core",
       "strict": true,
-      "summary": "Open an agent in your org's Agent Builder UI in a browser.",
+      "summary": "Open an agent in your org's Agentforce Builder UI in a browser.",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
@@ -1957,6 +1955,157 @@
         "authoring-bundle:open:org"
       ]
     },
+    "org:refresh:sandbox": {
+      "aliases": [],
+      "args": {},
+      "description": "Refreshing a sandbox copies the metadata, and optionally data, from your source org to the refreshed sandbox org. You can optionally specify a definition file if you want to change the configuration of the refreshed sandbox, such as its license type or template ID. You can also use the --source-id or --source-sandbox-name flags to change the refreshed sandbox org's original source org to a new org; in this case, the refreshed sandbox org's metadata is updated with the new source org's metadata.\n\nYou're not allowed to change the sandbox name when you refresh it with this command. If you want to change the sandbox name, first delete it with the \"org delete sandbox\" command. And then recreate it with the \"org create sandbox\" command and give it a new name.",
+      "examples": [
+        "Refresh the sandbox named \"devSbx1\". The production org that contains the sandbox license has the alias \"prodOrg\".\n<%= config.bin %> <%= command.id %> --name devSbx1 --target-org prodOrg",
+        "Refresh the sandbox named \"devSbx2\", and override the configuration of the refreshed sandbox with the properties in the specified defintion file. The default target org is the production org, so you don't need to specify the `--target-org` flag in this case.\n<%= config.bin %> <%= command.id %> --name devSbx2 --definition-file devSbx2-config.json",
+        "Refresh the sandbox using the name defined in the definition file. The production org that contains the sandbox license has the alias \"prodOrg\".\n<%= config.bin %> <%= command.id %> --definition-file devSbx3-config.json --target-org prodOrg",
+        "Refresh the sandbox named \"devSbx2\" by changing its original source org to be a sandbox called \"devSbx3\":\n<%= config.bin %> <%= command.id %> --name devSbx2 --source-sandbox-name devSbx3 --target-org prodOrg"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "flags-dir": {
+          "helpGroup": "GLOBAL",
+          "name": "flags-dir",
+          "summary": "Import flag values from a directory.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "no-auto-activate": {
+          "description": "By default, a sandbox auto-activates after a refresh. Use this flag to control sandbox activation manually.",
+          "name": "no-auto-activate",
+          "summary": "Disable auto-activation of the sandbox after a successful refresh.",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "wait": {
+          "char": "w",
+          "description": "If the command continues to run after the wait period, the CLI returns control of the terminal to you and displays the \"<%= config.bin %> org resume sandbox\" command for you run to check the status of the refresh. The displayed command includes the job ID for the running sandbox refresh.",
+          "exclusive": [
+            "async"
+          ],
+          "name": "wait",
+          "summary": "Number of minutes to poll for sandbox refresh status.",
+          "hasDynamicHelp": true,
+          "helpValue": "<minutes>",
+          "multiple": false,
+          "type": "option"
+        },
+        "poll-interval": {
+          "char": "i",
+          "exclusive": [
+            "async"
+          ],
+          "name": "poll-interval",
+          "summary": "Number of seconds to wait between status polling requests.",
+          "hasDynamicHelp": true,
+          "helpValue": "<seconds>",
+          "multiple": false,
+          "type": "option"
+        },
+        "source-sandbox-name": {
+          "description": "The value of --source-sandbox-name must be an existing sandbox. The new source sandbox, and the refreshed sandbox specified with the --name flag, must both be associated with the production org (--target-org) that contains the sandbox licenses.\n\nYou can specify either --source-sandbox-name or --source-id when refreshing an existing sandbox, but not both.",
+          "exclusive": [
+            "source-id"
+          ],
+          "name": "source-sandbox-name",
+          "summary": "Name of the sandbox org that becomes the new source org for the refreshed sandbox.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "source-id": {
+          "description": "The value of --source-id must be an existing sandbox. The new source sandbox, and the refreshed sandbox specified with the --name flag, must both be associated with the production org (--target-org) that contains the sandbox licenses.\n\nYou can specify either --source-id or --source-sandbox-name when refreshing an existing sandbox, but not both.",
+          "exclusive": [
+            "source-sandbox-name"
+          ],
+          "name": "source-id",
+          "summary": "ID of the sandbox org that becomes the new source org for the refreshed sandbox.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "async": {
+          "description": "The command immediately displays the job ID and returns control of the terminal to you. This way, you can continue to use the CLI. To check the status of the sandbox refresh, run \"<%= config.bin %> org resume sandbox\".",
+          "exclusive": [
+            "wait",
+            "poll-interval"
+          ],
+          "name": "async",
+          "summary": "Request the sandbox refresh, but don't wait for it to complete.",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "name": {
+          "char": "n",
+          "name": "name",
+          "summary": "Name of the existing sandbox org in your production org that you want to refresh.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "definition-file": {
+          "char": "f",
+          "description": "The sandbox definition file is a blueprint for the sandbox; use the file to change the sandbox configuration during a refresh. If you don't want to change the sandbox configuration when you refresh it, then simply use the --name flag to specify the sandbox and don't use this flag. See <https://developer.salesforce.com/docs/atlas.en-us.sfdx_dev.meta/sfdx_dev/sfdx_dev_sandbox_definition.htm> for all the options you can specify in the definition file.",
+          "name": "definition-file",
+          "summary": "Path to a sandbox definition file for overriding its configuration when you refresh it.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "target-org": {
+          "char": "o",
+          "name": "target-org",
+          "noCacheDefault": true,
+          "required": true,
+          "summary": "Username or alias of the production org that contains the sandbox license.",
+          "hasDynamicHelp": true,
+          "multiple": false,
+          "type": "option"
+        },
+        "no-prompt": {
+          "name": "no-prompt",
+          "summary": "Don't prompt for confirmation about the sandbox refresh.",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": true,
+      "hiddenAliases": [],
+      "id": "org:refresh:sandbox",
+      "pluginAlias": "@salesforce/plugin-org",
+      "pluginName": "@salesforce/plugin-org",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "Refresh a sandbox org using the sandbox name.",
+      "isESM": true,
+      "relativePath": [
+        "lib",
+        "commands",
+        "org",
+        "refresh",
+        "sandbox.js"
+      ],
+      "aliasPermutations": [],
+      "permutations": [
+        "org:refresh:sandbox",
+        "refresh:org:sandbox",
+        "refresh:sandbox:org",
+        "org:sandbox:refresh",
+        "sandbox:org:refresh",
+        "sandbox:refresh:org"
+      ]
+    },
     "org:resume:sandbox": {
       "aliases": [
         "env:resume:sandbox"
@@ -2158,158 +2307,7 @@
         "scratch:org:resume",
         "scratch:resume:org"
       ]
-    },
-    "org:refresh:sandbox": {
-      "aliases": [],
-      "args": {},
-      "description": "Refreshing a sandbox copies the metadata, and optionally data, from your source org to the refreshed sandbox org. You can optionally specify a definition file if you want to change the configuration of the refreshed sandbox, such as its license type or template ID. You can also use the --source-id or --source-sandbox-name flags to change the refreshed sandbox org's original source org to a new org; in this case, the refreshed sandbox org's metadata is updated with the new source org's metadata.\n\nYou're not allowed to change the sandbox name when you refresh it with this command. If you want to change the sandbox name, first delete it with the \"org delete sandbox\" command. And then recreate it with the \"org create sandbox\" command and give it a new name.",
-      "examples": [
-        "Refresh the sandbox named \"devSbx1\". The production org that contains the sandbox license has the alias \"prodOrg\".\n<%= config.bin %> <%= command.id %> --name devSbx1 --target-org prodOrg",
-        "Refresh the sandbox named \"devSbx2\", and override the configuration of the refreshed sandbox with the properties in the specified defintion file. The default target org is the production org, so you don't need to specify the `--target-org` flag in this case.\n<%= config.bin %> <%= command.id %> --name devSbx2 --definition-file devSbx2-config.json",
-        "Refresh the sandbox using the name defined in the definition file. The production org that contains the sandbox license has the alias \"prodOrg\".\n<%= config.bin %> <%= command.id %> --definition-file devSbx3-config.json --target-org prodOrg",
-        "Refresh the sandbox named \"devSbx2\" by changing its original source org to be a sandbox called \"devSbx3\":\n<%= config.bin %> <%= command.id %> --name devSbx2 --source-sandbox-name devSbx3 --target-org prodOrg"
-      ],
-      "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "flags-dir": {
-          "helpGroup": "GLOBAL",
-          "name": "flags-dir",
-          "summary": "Import flag values from a directory.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "no-auto-activate": {
-          "description": "By default, a sandbox auto-activates after a refresh. Use this flag to control sandbox activation manually.",
-          "name": "no-auto-activate",
-          "summary": "Disable auto-activation of the sandbox after a successful refresh.",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "wait": {
-          "char": "w",
-          "description": "If the command continues to run after the wait period, the CLI returns control of the terminal to you and displays the \"<%= config.bin %> org resume sandbox\" command for you run to check the status of the refresh. The displayed command includes the job ID for the running sandbox refresh.",
-          "exclusive": [
-            "async"
-          ],
-          "name": "wait",
-          "summary": "Number of minutes to poll for sandbox refresh status.",
-          "hasDynamicHelp": true,
-          "helpValue": "<minutes>",
-          "multiple": false,
-          "type": "option"
-        },
-        "poll-interval": {
-          "char": "i",
-          "exclusive": [
-            "async"
-          ],
-          "name": "poll-interval",
-          "summary": "Number of seconds to wait between status polling requests.",
-          "hasDynamicHelp": true,
-          "helpValue": "<seconds>",
-          "multiple": false,
-          "type": "option"
-        },
-        "source-sandbox-name": {
-          "description": "The value of --source-sandbox-name must be an existing sandbox. The new source sandbox, and the refreshed sandbox specified with the --name flag, must both be associated with the production org (--target-org) that contains the sandbox licenses.\n\nYou can specify either --source-sandbox-name or --source-id when refreshing an existing sandbox, but not both.",
-          "exclusive": [
-            "source-id"
-          ],
-          "name": "source-sandbox-name",
-          "summary": "Name of the sandbox org that becomes the new source org for the refreshed sandbox.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "source-id": {
-          "description": "The value of --source-id must be an existing sandbox. The new source sandbox, and the refreshed sandbox specified with the --name flag, must both be associated with the production org (--target-org) that contains the sandbox licenses.\n\nYou can specify either --source-id or --source-sandbox-name when refreshing an existing sandbox, but not both.",
-          "exclusive": [
-            "source-sandbox-name"
-          ],
-          "name": "source-id",
-          "summary": "ID of the sandbox org that becomes the new source org for the refreshed sandbox.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "async": {
-          "description": "The command immediately displays the job ID and returns control of the terminal to you. This way, you can continue to use the CLI. To check the status of the sandbox refresh, run \"<%= config.bin %> org resume sandbox\".",
-          "exclusive": [
-            "wait",
-            "poll-interval"
-          ],
-          "name": "async",
-          "summary": "Request the sandbox refresh, but don't wait for it to complete.",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "name": {
-          "char": "n",
-          "name": "name",
-          "summary": "Name of the existing sandbox org in your production org that you want to refresh.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "definition-file": {
-          "char": "f",
-          "description": "The sandbox definition file is a blueprint for the sandbox; use the file to change the sandbox configuration during a refresh. If you don't want to change the sandbox configuration when you refresh it, then simply use the --name flag to specify the sandbox and don't use this flag. See <https://developer.salesforce.com/docs/atlas.en-us.sfdx_dev.meta/sfdx_dev/sfdx_dev_sandbox_definition.htm> for all the options you can specify in the definition file.",
-          "name": "definition-file",
-          "summary": "Path to a sandbox definition file for overriding its configuration when you refresh it.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "target-org": {
-          "char": "o",
-          "name": "target-org",
-          "noCacheDefault": true,
-          "required": true,
-          "summary": "Username or alias of the production org that contains the sandbox license.",
-          "hasDynamicHelp": true,
-          "multiple": false,
-          "type": "option"
-        },
-        "no-prompt": {
-          "name": "no-prompt",
-          "summary": "Don't prompt for confirmation about the sandbox refresh.",
-          "allowNo": false,
-          "type": "boolean"
-        }
-      },
-      "hasDynamicHelp": true,
-      "hiddenAliases": [],
-      "id": "org:refresh:sandbox",
-      "pluginAlias": "@salesforce/plugin-org",
-      "pluginName": "@salesforce/plugin-org",
-      "pluginType": "core",
-      "strict": true,
-      "summary": "Refresh a sandbox org using the sandbox name.",
-      "isESM": true,
-      "relativePath": [
-        "lib",
-        "commands",
-        "org",
-        "refresh",
-        "sandbox.js"
-      ],
-      "aliasPermutations": [],
-      "permutations": [
-        "org:refresh:sandbox",
-        "refresh:org:sandbox",
-        "refresh:sandbox:org",
-        "org:sandbox:refresh",
-        "sandbox:org:refresh",
-        "sandbox:refresh:org"
-      ]
     }
   },
-  "version": "5.11.3"
+  "version": "5.11.5"
 }

package/package.json

@@ -1,14 +1,14 @@
 {
     "name": "@salesforce/plugin-org",
     "description": "Commands to interact with Salesforce orgs",
-    "version": "5.11.3",
+    "version": "5.11.5",
     "author": "Salesforce",
     "bugs": "https://github.com/forcedotcom/cli/issues",
     "enableO11y": true,
     "o11yUploadEndpoint": "https://794testsite.my.site.com/byolwr/webruntime/log/metrics",
     "dependencies": {
         "@oclif/core": "^4.11.3",
-        "@oclif/multi-stage-output": "^0.8.40",
+        "@oclif/multi-stage-output": "^0.8.44",
         "@salesforce/core": "^8.31.0",
         "@salesforce/kit": "^3.2.4",
         "@salesforce/sf-plugins-core": "^12.2.16",
@@ -21,14 +21,14 @@
         "terminal-link": "^3.0.0"
     },
     "devDependencies": {
-        "@oclif/plugin-command-snapshot": "^5.3.21",
-        "@salesforce/cli-plugins-testkit": "^5.3.57",
+        "@oclif/plugin-command-snapshot": "^5.3.22",
+        "@salesforce/cli-plugins-testkit": "^5.3.58",
         "@salesforce/dev-scripts": "^11.0.4",
-        "@salesforce/plugin-command-reference": "^3.1.98",
+        "@salesforce/plugin-command-reference": "^3.1.103",
         "@salesforce/ts-sinon": "^1.4.34",
         "eslint-plugin-sf-plugin": "^1.20.33",
         "moment": "^2.30.1",
-        "oclif": "^4.23.5",
+        "oclif": "^4.23.8",
         "ts-node": "^10.9.2",
         "typescript": "^5.9.3"
     },
@@ -233,7 +233,7 @@
     "exports": "./lib/index.js",
     "type": "module",
     "sfdx": {
-        "publicKeyUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-org/5.11.3.crt",
-        "signatureUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-org/5.11.3.sig"
+        "publicKeyUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-org/5.11.5.crt",
+        "signatureUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-org/5.11.5.sig"
     }
 }