chore(release): 5.10.0 [skip ci]

Author: svc-cli-bot

CHANGELOG.md

@@ -1,3 +1,16 @@
+# [5.10.0](https://github.com/salesforcecli/plugin-org/compare/5.9.86...5.10.0) (2026-04-21)
+
+### Bug Fixes
+
+- deprecate 'org open authoring-bundle' expand 'org open agent' ([fecb66c](https://github.com/salesforcecli/plugin-org/commit/fecb66c37c03f9abf0cbf7fc3436086c5eab3f6c))
+- remove mid-sentence line breaks in open.agent.md ([56e1e7f](https://github.com/salesforcecli/plugin-org/commit/56e1e7fa8c0762ebb647a73a9f2b464fd17459d2))
+
+### Features
+
+- add helpful error messages for agent not found cases ([139bb7a](https://github.com/salesforcecli/plugin-org/commit/139bb7a4269446b280993a02727a0d7ed4c5a555))
+- add new flags to open AAB ([be28860](https://github.com/salesforcecli/plugin-org/commit/be288601f871649144e237e89eb37731a0c115c0))
+- support --version flag with --api-name in org open agent ([62658c9](https://github.com/salesforcecli/plugin-org/commit/62658c93b6ec7793ed523d759d803bb96e87c1f1))
+
 ## [5.9.86](https://github.com/salesforcecli/plugin-org/compare/5.9.85...5.9.86) (2026-04-17)
 
 ### Bug Fixes

README.md

@@ -193,7 +193,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.9.86/src/commands/org/create/agent-user.ts)_
+_See code: [src/commands/org/create/agent-user.ts](https://github.com/salesforcecli/plugin-org/blob/5.10.0/src/commands/org/create/agent-user.ts)_
 
 ## `sf org create sandbox`
 
@@ -327,7 +327,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.9.86/src/commands/org/create/sandbox.ts)_
+_See code: [src/commands/org/create/sandbox.ts](https://github.com/salesforcecli/plugin-org/blob/5.10.0/src/commands/org/create/sandbox.ts)_
 
 ## `sf org create scratch`
 
@@ -509,7 +509,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.9.86/src/commands/org/create/scratch.ts)_
+_See code: [src/commands/org/create/scratch.ts](https://github.com/salesforcecli/plugin-org/blob/5.10.0/src/commands/org/create/scratch.ts)_
 
 ## `sf org delete sandbox`
 
@@ -555,7 +555,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.9.86/src/commands/org/delete/sandbox.ts)_
+_See code: [src/commands/org/delete/sandbox.ts](https://github.com/salesforcecli/plugin-org/blob/5.10.0/src/commands/org/delete/sandbox.ts)_
 
 ## `sf org delete scratch`
 
@@ -599,7 +599,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.9.86/src/commands/org/delete/scratch.ts)_
+_See code: [src/commands/org/delete/scratch.ts](https://github.com/salesforcecli/plugin-org/blob/5.10.0/src/commands/org/delete/scratch.ts)_
 
 ## `sf org disable tracking`
 
@@ -638,7 +638,7 @@ EXAMPLES
     $ sf org disable tracking
 ```
 
-_See code: [src/commands/org/disable/tracking.ts](https://github.com/salesforcecli/plugin-org/blob/5.9.86/src/commands/org/disable/tracking.ts)_
+_See code: [src/commands/org/disable/tracking.ts](https://github.com/salesforcecli/plugin-org/blob/5.10.0/src/commands/org/disable/tracking.ts)_
 
 ## `sf org display`
 
@@ -683,7 +683,7 @@ EXAMPLES
     $ sf org display --target-org TestOrg1 --verbose
 ```
 
-_See code: [src/commands/org/display.ts](https://github.com/salesforcecli/plugin-org/blob/5.9.86/src/commands/org/display.ts)_
+_See code: [src/commands/org/display.ts](https://github.com/salesforcecli/plugin-org/blob/5.10.0/src/commands/org/display.ts)_
 
 ## `sf org enable tracking`
 
@@ -725,7 +725,7 @@ EXAMPLES
     $ sf org enable tracking
 ```
 
-_See code: [src/commands/org/enable/tracking.ts](https://github.com/salesforcecli/plugin-org/blob/5.9.86/src/commands/org/enable/tracking.ts)_
+_See code: [src/commands/org/enable/tracking.ts](https://github.com/salesforcecli/plugin-org/blob/5.10.0/src/commands/org/enable/tracking.ts)_
 
 ## `sf org list`
 
@@ -764,7 +764,7 @@ EXAMPLES
     $ sf org list --clean
 ```
 
-_See code: [src/commands/org/list.ts](https://github.com/salesforcecli/plugin-org/blob/5.9.86/src/commands/org/list.ts)_
+_See code: [src/commands/org/list.ts](https://github.com/salesforcecli/plugin-org/blob/5.10.0/src/commands/org/list.ts)_
 
 ## `sf org list metadata`
 
@@ -831,7 +831,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.9.86/src/commands/org/list/metadata.ts)_
+_See code: [src/commands/org/list/metadata.ts](https://github.com/salesforcecli/plugin-org/blob/5.10.0/src/commands/org/list/metadata.ts)_
 
 ## `sf org list metadata-types`
 
@@ -886,7 +886,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.9.86/src/commands/org/list/metadata-types.ts)_
+_See code: [src/commands/org/list/metadata-types.ts](https://github.com/salesforcecli/plugin-org/blob/5.10.0/src/commands/org/list/metadata-types.ts)_
 
 ## `sf org open`
 
@@ -962,27 +962,29 @@ 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.9.86/src/commands/org/open.ts)_
+_See code: [src/commands/org/open.ts](https://github.com/salesforcecli/plugin-org/blob/5.10.0/src/commands/org/open.ts)_
 
 ## `sf org open agent`
 
 Open an agent in your org's Agent Builder UI in a browser.
 
 ```
 USAGE
-  $ sf org open agent -o <value> -n <value> [--json] [--flags-dir <value>] [--api-version <value>] [--private | -r |
-    -b chrome|edge|firefox]
+  $ sf org open agent -o <value> [--json] [--flags-dir <value>] [--api-version <value>] [-n <value>] [--private | -r
+    | -b chrome|edge|firefox] [--authoring-bundle <value>] [--version <value>]
 
 FLAGS
-  -b, --browser=<option>     Browser where the org opens.
-                             <options: chrome|edge|firefox>
-  -n, --api-name=<value>     (required) API name, also known as developer name, of the agent you want to open in the
-                             org's Agent 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
-      --private              Open the org in the default browser using private (incognito) mode.
+  -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.
+  -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.
 
 GLOBAL FLAGS
   --flags-dir=<value>  Import flag values from a directory.
@@ -994,6 +996,9 @@ 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.
+
   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
@@ -1011,9 +1016,28 @@ EXAMPLES
   Open the agent in an org with alias MyTestOrg1 using the Firefox browser:
 
     $ 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.
+
+    The API name of the agent to open directly in Agentforce Builder. Optionally specify --version to open a specific
+    version.
+
+  --version=<value>  Version number of the agent to open in Agentforce Builder.
+
+    The version number of the agent to open directly in Agentforce Builder. Can only be used with the --authoring-bundle
+    flag.
 ```
 
-_See code: [src/commands/org/open/agent.ts](https://github.com/salesforcecli/plugin-org/blob/5.9.86/src/commands/org/open/agent.ts)_
+_See code: [src/commands/org/open/agent.ts](https://github.com/salesforcecli/plugin-org/blob/5.10.0/src/commands/org/open/agent.ts)_
 
 ## `sf org open authoring-bundle`
 
@@ -1059,7 +1083,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.9.86/src/commands/org/open/authoring-bundle.ts)_
+_See code: [src/commands/org/open/authoring-bundle.ts](https://github.com/salesforcecli/plugin-org/blob/5.10.0/src/commands/org/open/authoring-bundle.ts)_
 
 ## `sf org refresh sandbox`
 
@@ -1162,7 +1186,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.9.86/src/commands/org/refresh/sandbox.ts)_
+_See code: [src/commands/org/refresh/sandbox.ts](https://github.com/salesforcecli/plugin-org/blob/5.10.0/src/commands/org/refresh/sandbox.ts)_
 
 ## `sf org resume sandbox`
 
@@ -1225,7 +1249,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.9.86/src/commands/org/resume/sandbox.ts)_
+_See code: [src/commands/org/resume/sandbox.ts](https://github.com/salesforcecli/plugin-org/blob/5.10.0/src/commands/org/resume/sandbox.ts)_
 
 ## `sf org resume scratch`
 
@@ -1278,6 +1302,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.9.86/src/commands/org/resume/scratch.ts)_
+_See code: [src/commands/org/resume/scratch.ts](https://github.com/salesforcecli/plugin-org/blob/5.10.0/src/commands/org/resume/scratch.ts)_
 
 <!-- commandsstop -->

package.json

@@ -1,7 +1,7 @@
 {
   "name": "@salesforce/plugin-org",
   "description": "Commands to interact with Salesforce orgs",
-  "version": "5.9.86",
+  "version": "5.10.0",
   "author": "Salesforce",
   "bugs": "https://github.com/forcedotcom/cli/issues",
   "enableO11y": true,