@salesforce/cli 2.127.2 → 2.128.1

package/README.md

@@ -25,7 +25,7 @@ $ npm install -g @salesforce/cli
 $ sf COMMAND
 running command...
 $ sf (--version|-v)
-@salesforce/cli/2.127.2 linux-x64 node-v22.22.0
+@salesforce/cli/2.128.1 linux-x64 node-v22.22.0
 $ sf --help [COMMAND]
 USAGE
   $ sf COMMAND
@@ -223,13 +223,17 @@ Activate an agent in an org.
 
 ```
 USAGE
-  $ sf agent activate -o <value> [--json] [--flags-dir <value>] [--api-version <value>] [-n <value>]
+  $ sf agent activate -o <value> [--json] [--flags-dir <value>] [--api-version <value>] [-n <value>] [--version
+    <value>]
 
 FLAGS
-  -n, --api-name=<value>     API name of the agent to activate.
+  -n, --api-name=<value>     API name of the agent to activate; if not specified, the command provides a list that you
+                             choose from.
   -o, --target-org=<value>   (required) Username or alias of the target org. Not required if the `target-org`
                              configuration variable is already set.
       --api-version=<value>  Override the api version used for api requests made by this command
+      --version=<value>      Version number of the agent to activate; if not specified, the command provides a list that
+                             you choose from.
 
 GLOBAL FLAGS
   --flags-dir=<value>  Import flag values from a directory.
@@ -238,23 +242,29 @@ GLOBAL FLAGS
 DESCRIPTION
   Activate an agent in an org.
 
-  Activating an agent makes it immediately available to your users. An agent must be active before you can preview it
-  with the "agent preview" CLI command or VS Code.
+  Activating an agent makes it immediately available to your users. A published agent must be active before you can
+  preview it with the "agent preview" CLI command or VS Code. Agents can have multiple versions; only one version can be
+  active at a time.
+
+  If you run the command without the --api-name or --version flags, the command provides a list of agent API names and
+  versions for you to choose from. Use the flags to specify the exact agent and version without being prompted. If you
+  use the --json flag and not --version, then the latest agent version is automatically activated.
 
-  You must know the agent's API name to activate it; you can either be prompted for it or you can specify it with the
-  --api-name flag. Find the agent's API name in its Agent Details page of your org's Agentforce Studio UI in Setup.
+  The value of the --version flag is always a number, corresponding to the "vX" part of the "BotVersion" metadata in
+  your project. For example, if you have a force-app/main/default/bots/My_Agent/v4.botVersion-meta.xml file in your
+  project, then you activate this version with the "--version 4" flag.
 
 EXAMPLES
-  Activate an agent in your default target org by being prompted:
+  Activate an agent in your default target org by being prompted for both its API name and version:
 
     $ sf agent activate
 
-  Activate an agent with API name Resort_Manager in the org with alias "my-org":
+  Activate version 2 of an agent with API name Resort_Manager in the org with alias "my-org":
 
-    $ sf agent activate --api-name Resort_Manager --target-org my-org
+    $ sf agent activate --api-name Resort_Manager --version 2 --target-org my-org
 ```
 
-_See code: [@salesforce/plugin-agent](https://github.com/salesforcecli/plugin-agent/blob/1.32.0/src/commands/agent/activate.ts)_
+_See code: [@salesforce/plugin-agent](https://github.com/salesforcecli/plugin-agent/blob/1.32.1/src/commands/agent/activate.ts)_
 
 ## `sf agent create`
 
@@ -321,7 +331,7 @@ EXAMPLES
     $ sf agent create --name "Resort Manager" --spec specs/resortManagerAgent.yaml --preview
 ```
 
-_See code: [@salesforce/plugin-agent](https://github.com/salesforcecli/plugin-agent/blob/1.32.0/src/commands/agent/create.ts)_
+_See code: [@salesforce/plugin-agent](https://github.com/salesforcecli/plugin-agent/blob/1.32.1/src/commands/agent/create.ts)_
 
 ## `sf agent deactivate`
 
@@ -332,7 +342,8 @@ USAGE
   $ sf agent deactivate -o <value> [--json] [--flags-dir <value>] [--api-version <value>] [-n <value>]
 
 FLAGS
-  -n, --api-name=<value>     API name of the agent to deactivate.
+  -n, --api-name=<value>     API name of the agent to deactivate; if not specified, the command provides a list that you
+                             choose from.
   -o, --target-org=<value>   (required) Username or alias of the target org. Not required if the `target-org`
                              configuration variable is already set.
       --api-version=<value>  Override the api version used for api requests made by this command
@@ -348,8 +359,8 @@ DESCRIPTION
   topics or actions, you must deactivate it. You can't preview an agent with the "agent preview" CLI command or VS Code
   if it's deactivated.
 
-  You must know the agent's API name to deactivate it; you can either be prompted for it or you can specify it with the
-  --api-name flag. Find the agent's API name in its Agent Details page of your org's Agentforce Studio UI in Setup.
+  If you run the command without the --api-name flag, the command provides a list of agent API names for you to choose
+  from. Use the flag to specify the exact agent without being prompted.
 
 EXAMPLES
   Deactivate an agent in your default target org by being prompted:
@@ -361,7 +372,7 @@ EXAMPLES
     $ sf agent deactivate --api-name Resort_Manager --target-org my-org
 ```
 
-_See code: [@salesforce/plugin-agent](https://github.com/salesforcecli/plugin-agent/blob/1.32.0/src/commands/agent/deactivate.ts)_
+_See code: [@salesforce/plugin-agent](https://github.com/salesforcecli/plugin-agent/blob/1.32.1/src/commands/agent/deactivate.ts)_
 
 ## `sf agent generate agent-spec`
 
@@ -468,7 +479,7 @@ EXAMPLES
     $ sf agent generate agent-spec --tone formal --agent-user resortmanager@myorg.com
 ```
 
-_See code: [@salesforce/plugin-agent](https://github.com/salesforcecli/plugin-agent/blob/1.32.0/src/commands/agent/generate/agent-spec.ts)_
+_See code: [@salesforce/plugin-agent](https://github.com/salesforcecli/plugin-agent/blob/1.32.1/src/commands/agent/generate/agent-spec.ts)_
 
 ## `sf agent generate authoring-bundle`
 
@@ -545,7 +556,7 @@ EXAMPLES
       other-package-dir/main/default --target-org my-dev-org
 ```
 
-_See code: [@salesforce/plugin-agent](https://github.com/salesforcecli/plugin-agent/blob/1.32.0/src/commands/agent/generate/authoring-bundle.ts)_
+_See code: [@salesforce/plugin-agent](https://github.com/salesforcecli/plugin-agent/blob/1.32.1/src/commands/agent/generate/authoring-bundle.ts)_
 
 ## `sf agent generate template`
 
@@ -593,7 +604,7 @@ EXAMPLES
       force-app/main/default/bots/My_Awesome_Agent/My_Awesome_Agent.bot-meta.xml --agent-version 1
 ```
 
-_See code: [@salesforce/plugin-agent](https://github.com/salesforcecli/plugin-agent/blob/1.32.0/src/commands/agent/generate/template.ts)_
+_See code: [@salesforce/plugin-agent](https://github.com/salesforcecli/plugin-agent/blob/1.32.1/src/commands/agent/generate/template.ts)_
 
 ## `sf agent generate test-spec`
 
@@ -658,7 +669,7 @@ EXAMPLES
       force-app//main/default/aiEvaluationDefinitions/Resort_Manager_Tests.aiEvaluationDefinition-meta.xml
 ```
 
-_See code: [@salesforce/plugin-agent](https://github.com/salesforcecli/plugin-agent/blob/1.32.0/src/commands/agent/generate/test-spec.ts)_
+_See code: [@salesforce/plugin-agent](https://github.com/salesforcecli/plugin-agent/blob/1.32.1/src/commands/agent/generate/test-spec.ts)_
 
 ## `sf agent preview`
 
@@ -731,7 +742,7 @@ EXAMPLES
     $ sf agent preview --use-live-actions --apex-debug --output-dir transcripts/my-preview
 ```
 
-_See code: [@salesforce/plugin-agent](https://github.com/salesforcecli/plugin-agent/blob/1.32.0/src/commands/agent/preview.ts)_
+_See code: [@salesforce/plugin-agent](https://github.com/salesforcecli/plugin-agent/blob/1.32.1/src/commands/agent/preview.ts)_
 
 ## `sf agent preview end`
 
@@ -786,7 +797,7 @@ EXAMPLES
     $ sf agent preview end --authoring-bundle My_Local_Agent
 ```
 
-_See code: [@salesforce/plugin-agent](https://github.com/salesforcecli/plugin-agent/blob/1.32.0/src/commands/agent/preview/end.ts)_
+_See code: [@salesforce/plugin-agent](https://github.com/salesforcecli/plugin-agent/blob/1.32.1/src/commands/agent/preview/end.ts)_
 
 ## `sf agent preview send`
 
@@ -844,7 +855,7 @@ EXAMPLES
     $ sf agent preview send --utterance "what can you help me with?" --authoring-bundle My_Local_Agent
 ```
 
-_See code: [@salesforce/plugin-agent](https://github.com/salesforcecli/plugin-agent/blob/1.32.0/src/commands/agent/preview/send.ts)_
+_See code: [@salesforce/plugin-agent](https://github.com/salesforcecli/plugin-agent/blob/1.32.1/src/commands/agent/preview/send.ts)_
 
 ## `sf agent preview sessions`
 
@@ -877,7 +888,7 @@ EXAMPLES
     $ sf agent preview sessions
 ```
 
-_See code: [@salesforce/plugin-agent](https://github.com/salesforcecli/plugin-agent/blob/1.32.0/src/commands/agent/preview/sessions.ts)_
+_See code: [@salesforce/plugin-agent](https://github.com/salesforcecli/plugin-agent/blob/1.32.1/src/commands/agent/preview/sessions.ts)_
 
 ## `sf agent preview start`
 
@@ -934,7 +945,7 @@ EXAMPLES
     $ sf agent preview start --api-name My_Published_Agent
 ```
 
-_See code: [@salesforce/plugin-agent](https://github.com/salesforcecli/plugin-agent/blob/1.32.0/src/commands/agent/preview/start.ts)_
+_See code: [@salesforce/plugin-agent](https://github.com/salesforcecli/plugin-agent/blob/1.32.1/src/commands/agent/preview/start.ts)_
 
 ## `sf agent publish authoring-bundle`
 
@@ -983,7 +994,7 @@ EXAMPLES
     $ sf agent publish authoring-bundle --api-name MyAuthoringbundle --target-org my-dev-org
 ```
 
-_See code: [@salesforce/plugin-agent](https://github.com/salesforcecli/plugin-agent/blob/1.32.0/src/commands/agent/publish/authoring-bundle.ts)_
+_See code: [@salesforce/plugin-agent](https://github.com/salesforcecli/plugin-agent/blob/1.32.1/src/commands/agent/publish/authoring-bundle.ts)_
 
 ## `sf agent test create`
 
@@ -1038,7 +1049,7 @@ EXAMPLES
     $ sf agent test create --spec specs/Resort_Manager-testSpec.yaml --api-name Resort_Manager_Test --preview
 ```
 
-_See code: [@salesforce/plugin-agent](https://github.com/salesforcecli/plugin-agent/blob/1.32.0/src/commands/agent/test/create.ts)_
+_See code: [@salesforce/plugin-agent](https://github.com/salesforcecli/plugin-agent/blob/1.32.1/src/commands/agent/test/create.ts)_
 
 ## `sf agent test list`
 
@@ -1073,7 +1084,7 @@ EXAMPLES
     $ sf agent test list --target-org my-org
 ```
 
-_See code: [@salesforce/plugin-agent](https://github.com/salesforcecli/plugin-agent/blob/1.32.0/src/commands/agent/test/list.ts)_
+_See code: [@salesforce/plugin-agent](https://github.com/salesforcecli/plugin-agent/blob/1.32.1/src/commands/agent/test/list.ts)_
 
 ## `sf agent test results`
 
@@ -1139,7 +1150,7 @@ FLAG DESCRIPTIONS
     expression when using custom evaluations.
 ```
 
-_See code: [@salesforce/plugin-agent](https://github.com/salesforcecli/plugin-agent/blob/1.32.0/src/commands/agent/test/results.ts)_
+_See code: [@salesforce/plugin-agent](https://github.com/salesforcecli/plugin-agent/blob/1.32.1/src/commands/agent/test/results.ts)_
 
 ## `sf agent test resume`
 
@@ -1212,7 +1223,7 @@ FLAG DESCRIPTIONS
     expression when using custom evaluations.
 ```
 
-_See code: [@salesforce/plugin-agent](https://github.com/salesforcecli/plugin-agent/blob/1.32.0/src/commands/agent/test/resume.ts)_
+_See code: [@salesforce/plugin-agent](https://github.com/salesforcecli/plugin-agent/blob/1.32.1/src/commands/agent/test/resume.ts)_
 
 ## `sf agent test run`
 
@@ -1286,7 +1297,7 @@ FLAG DESCRIPTIONS
     expression when using custom evaluations.
 ```
 
-_See code: [@salesforce/plugin-agent](https://github.com/salesforcecli/plugin-agent/blob/1.32.0/src/commands/agent/test/run.ts)_
+_See code: [@salesforce/plugin-agent](https://github.com/salesforcecli/plugin-agent/blob/1.32.1/src/commands/agent/test/run.ts)_
 
 ## `sf agent validate authoring-bundle`
 
@@ -1333,7 +1344,7 @@ EXAMPLES
     $ sf agent validate authoring-bundle --api-name MyAuthoringBundle --target-org my-dev-org
 ```
 
-_See code: [@salesforce/plugin-agent](https://github.com/salesforcecli/plugin-agent/blob/1.32.0/src/commands/agent/validate/authoring-bundle.ts)_
+_See code: [@salesforce/plugin-agent](https://github.com/salesforcecli/plugin-agent/blob/1.32.1/src/commands/agent/validate/authoring-bundle.ts)_
 
 ## `sf alias list`
 
@@ -2318,7 +2329,7 @@ EXAMPLES
     $ sf data bulk results --job-id 7507i000fake341G --target-org my-scratch
 ```
 
-_See code: [@salesforce/plugin-data](https://github.com/salesforcecli/plugin-data/blob/4.0.77/src/commands/data/bulk/results.ts)_
+_See code: [@salesforce/plugin-data](https://github.com/salesforcecli/plugin-data/blob/4.0.78/src/commands/data/bulk/results.ts)_
 
 ## `sf data create file`
 
@@ -2367,7 +2378,7 @@ EXAMPLES
     $ sf data create file --file path/to/astro.png --parent-id a03fakeLoJWPIA3
 ```
 
-_See code: [@salesforce/plugin-data](https://github.com/salesforcecli/plugin-data/blob/4.0.77/src/commands/data/create/file.ts)_
+_See code: [@salesforce/plugin-data](https://github.com/salesforcecli/plugin-data/blob/4.0.78/src/commands/data/create/file.ts)_
 
 ## `sf data create record`
 
@@ -2423,7 +2434,7 @@ EXAMPLES
       TracedEntityId=01p17000000R6bLAAS"
 ```
 
-_See code: [@salesforce/plugin-data](https://github.com/salesforcecli/plugin-data/blob/4.0.77/src/commands/data/create/record.ts)_
+_See code: [@salesforce/plugin-data](https://github.com/salesforcecli/plugin-data/blob/4.0.78/src/commands/data/create/record.ts)_
 
 ## `sf data delete bulk`
 
@@ -2482,7 +2493,7 @@ FLAG DESCRIPTIONS
     and can be enabled only by a system administrator.
 ```
 
-_See code: [@salesforce/plugin-data](https://github.com/salesforcecli/plugin-data/blob/4.0.77/src/commands/data/delete/bulk.ts)_
+_See code: [@salesforce/plugin-data](https://github.com/salesforcecli/plugin-data/blob/4.0.78/src/commands/data/delete/bulk.ts)_
 
 ## `sf data delete record`
 
@@ -2543,7 +2554,7 @@ EXAMPLES
     $ sf data delete record --use-tooling-api --sobject TraceFlag --record-id 7tf8c
 ```
 
-_See code: [@salesforce/plugin-data](https://github.com/salesforcecli/plugin-data/blob/4.0.77/src/commands/data/delete/record.ts)_
+_See code: [@salesforce/plugin-data](https://github.com/salesforcecli/plugin-data/blob/4.0.78/src/commands/data/delete/record.ts)_
 
 ## `sf data delete resume`
 
@@ -2582,7 +2593,7 @@ EXAMPLES
     $ sf data delete resume --use-most-recent --target-org my-scratch
 ```
 
-_See code: [@salesforce/plugin-data](https://github.com/salesforcecli/plugin-data/blob/4.0.77/src/commands/data/delete/resume.ts)_
+_See code: [@salesforce/plugin-data](https://github.com/salesforcecli/plugin-data/blob/4.0.78/src/commands/data/delete/resume.ts)_
 
 ## `sf data export bulk`
 
@@ -2649,7 +2660,7 @@ EXAMPLES
       --result-format json --wait 10 --all-rows
 ```
 
-_See code: [@salesforce/plugin-data](https://github.com/salesforcecli/plugin-data/blob/4.0.77/src/commands/data/export/bulk.ts)_
+_See code: [@salesforce/plugin-data](https://github.com/salesforcecli/plugin-data/blob/4.0.78/src/commands/data/export/bulk.ts)_
 
 ## `sf data export resume`
 
@@ -2688,7 +2699,7 @@ EXAMPLES
     $ sf data export resume --use-most-recent
 ```
 
-_See code: [@salesforce/plugin-data](https://github.com/salesforcecli/plugin-data/blob/4.0.77/src/commands/data/export/resume.ts)_
+_See code: [@salesforce/plugin-data](https://github.com/salesforcecli/plugin-data/blob/4.0.78/src/commands/data/export/resume.ts)_
 
 ## `sf data export tree`
 
@@ -2748,7 +2759,7 @@ EXAMPLES
       my-scratch
 ```
 
-_See code: [@salesforce/plugin-data](https://github.com/salesforcecli/plugin-data/blob/4.0.77/src/commands/data/export/tree.ts)_
+_See code: [@salesforce/plugin-data](https://github.com/salesforcecli/plugin-data/blob/4.0.78/src/commands/data/export/tree.ts)_
 
 ## `sf data get record`
 
@@ -2812,7 +2823,7 @@ EXAMPLES
     $ sf data get record --use-tooling-api --sobject TraceFlag --record-id 7tf8c
 ```
 
-_See code: [@salesforce/plugin-data](https://github.com/salesforcecli/plugin-data/blob/4.0.77/src/commands/data/get/record.ts)_
+_See code: [@salesforce/plugin-data](https://github.com/salesforcecli/plugin-data/blob/4.0.78/src/commands/data/get/record.ts)_
 
 ## `sf data import bulk`
 
@@ -2864,7 +2875,7 @@ EXAMPLES
     $ sf data import bulk --file accounts.csv --sobject Account --wait 10 --target-org my-scratch
 ```
 
-_See code: [@salesforce/plugin-data](https://github.com/salesforcecli/plugin-data/blob/4.0.77/src/commands/data/import/bulk.ts)_
+_See code: [@salesforce/plugin-data](https://github.com/salesforcecli/plugin-data/blob/4.0.78/src/commands/data/import/bulk.ts)_
 
 ## `sf data import resume`
 
@@ -2900,7 +2911,7 @@ EXAMPLES
     $ sf data import resume --use-most-recent --target-org my-scratch
 ```
 
-_See code: [@salesforce/plugin-data](https://github.com/salesforcecli/plugin-data/blob/4.0.77/src/commands/data/import/resume.ts)_
+_See code: [@salesforce/plugin-data](https://github.com/salesforcecli/plugin-data/blob/4.0.78/src/commands/data/import/resume.ts)_
 
 ## `sf data import tree`
 
@@ -2964,7 +2975,7 @@ FLAG DESCRIPTIONS
     - files(array) - Files: An array of files paths to load
 ```
 
-_See code: [@salesforce/plugin-data](https://github.com/salesforcecli/plugin-data/blob/4.0.77/src/commands/data/import/tree.ts)_
+_See code: [@salesforce/plugin-data](https://github.com/salesforcecli/plugin-data/blob/4.0.78/src/commands/data/import/tree.ts)_
 
 ## `sf data query`
 
@@ -3017,7 +3028,7 @@ EXAMPLES
     $ sf data query --query "SELECT Name FROM ApexTrigger" --use-tooling-api
 ```
 
-_See code: [@salesforce/plugin-data](https://github.com/salesforcecli/plugin-data/blob/4.0.77/src/commands/data/query.ts)_
+_See code: [@salesforce/plugin-data](https://github.com/salesforcecli/plugin-data/blob/4.0.78/src/commands/data/query.ts)_
 
 ## `sf data resume`
 
@@ -3054,7 +3065,7 @@ EXAMPLES
     $ sf data resume --job-id 750xx000000005sAAA --batch-id 751xx000000005nAAA
 ```
 
-_See code: [@salesforce/plugin-data](https://github.com/salesforcecli/plugin-data/blob/4.0.77/src/commands/data/resume.ts)_
+_See code: [@salesforce/plugin-data](https://github.com/salesforcecli/plugin-data/blob/4.0.78/src/commands/data/resume.ts)_
 
 ## `sf data search`
 
@@ -3104,7 +3115,7 @@ EXAMPLES
     $ sf data search --file query.txt --target-org my-scratch --result-format csv
 ```
 
-_See code: [@salesforce/plugin-data](https://github.com/salesforcecli/plugin-data/blob/4.0.77/src/commands/data/search.ts)_
+_See code: [@salesforce/plugin-data](https://github.com/salesforcecli/plugin-data/blob/4.0.78/src/commands/data/search.ts)_
 
 ## `sf data update bulk`
 
@@ -3159,7 +3170,7 @@ EXAMPLES
     $ sf data update bulk --file accounts.csv --sobject Account --wait 10 --target-org my-scratch
 ```
 
-_See code: [@salesforce/plugin-data](https://github.com/salesforcecli/plugin-data/blob/4.0.77/src/commands/data/update/bulk.ts)_
+_See code: [@salesforce/plugin-data](https://github.com/salesforcecli/plugin-data/blob/4.0.78/src/commands/data/update/bulk.ts)_
 
 ## `sf data update record`
 
@@ -3221,7 +3232,7 @@ EXAMPLES
       "ExpirationDate=2017-12-01T00:58:04.000+0000"
 ```
 
-_See code: [@salesforce/plugin-data](https://github.com/salesforcecli/plugin-data/blob/4.0.77/src/commands/data/update/record.ts)_
+_See code: [@salesforce/plugin-data](https://github.com/salesforcecli/plugin-data/blob/4.0.78/src/commands/data/update/record.ts)_
 
 ## `sf data update resume`
 
@@ -3260,7 +3271,7 @@ EXAMPLES
     $ sf data update resume --use-most-recent
 ```
 
-_See code: [@salesforce/plugin-data](https://github.com/salesforcecli/plugin-data/blob/4.0.77/src/commands/data/update/resume.ts)_
+_See code: [@salesforce/plugin-data](https://github.com/salesforcecli/plugin-data/blob/4.0.78/src/commands/data/update/resume.ts)_
 
 ## `sf data upsert bulk`
 
@@ -3316,7 +3327,7 @@ EXAMPLES
       my-scratch
 ```
 
-_See code: [@salesforce/plugin-data](https://github.com/salesforcecli/plugin-data/blob/4.0.77/src/commands/data/upsert/bulk.ts)_
+_See code: [@salesforce/plugin-data](https://github.com/salesforcecli/plugin-data/blob/4.0.78/src/commands/data/upsert/bulk.ts)_
 
 ## `sf data upsert resume`
 
@@ -3355,7 +3366,7 @@ EXAMPLES
     $ sf data upsert resume --use-most-recent --target-org my-scratch
 ```
 
-_See code: [@salesforce/plugin-data](https://github.com/salesforcecli/plugin-data/blob/4.0.77/src/commands/data/upsert/resume.ts)_
+_See code: [@salesforce/plugin-data](https://github.com/salesforcecli/plugin-data/blob/4.0.78/src/commands/data/upsert/resume.ts)_
 
 ## `sf doctor`
 
@@ -3450,7 +3461,7 @@ EXAMPLES
     $ sf force data bulk delete --sobject MyObject__c --file files/delete.csv --wait 5 --target-org my-scratch
 ```
 
-_See code: [@salesforce/plugin-data](https://github.com/salesforcecli/plugin-data/blob/4.0.77/src/commands/force/data/bulk/delete.ts)_
+_See code: [@salesforce/plugin-data](https://github.com/salesforcecli/plugin-data/blob/4.0.78/src/commands/force/data/bulk/delete.ts)_
 
 ## `sf force data bulk status`
 
@@ -3487,7 +3498,7 @@ EXAMPLES
     $ sf force data bulk status --job-id 750xx000000005sAAA --batch-id 751xx000000005nAAA --target-org my-scratch
 ```
 
-_See code: [@salesforce/plugin-data](https://github.com/salesforcecli/plugin-data/blob/4.0.77/src/commands/force/data/bulk/status.ts)_
+_See code: [@salesforce/plugin-data](https://github.com/salesforcecli/plugin-data/blob/4.0.78/src/commands/force/data/bulk/status.ts)_
 
 ## `sf force data bulk upsert`
 
@@ -3545,7 +3556,7 @@ EXAMPLES
       --target-org my-scratch
 ```
 
-_See code: [@salesforce/plugin-data](https://github.com/salesforcecli/plugin-data/blob/4.0.77/src/commands/force/data/bulk/upsert.ts)_
+_See code: [@salesforce/plugin-data](https://github.com/salesforcecli/plugin-data/blob/4.0.78/src/commands/force/data/bulk/upsert.ts)_
 
 ## `sf help [COMMAND]`
 
@@ -3821,7 +3832,7 @@ EXAMPLES
     $ sf org assign permset --name DreamHouse --on-behalf-of user1@my.org --on-behalf-of user2 --on-behalf-of user
 ```
 
-_See code: [@salesforce/plugin-user](https://github.com/salesforcecli/plugin-user/blob/3.6.53/src/commands/org/assign/permset.ts)_
+_See code: [@salesforce/plugin-user](https://github.com/salesforcecli/plugin-user/blob/3.7.0/src/commands/org/assign/permset.ts)_
 
 ## `sf org assign permsetlicense`
 
@@ -3868,7 +3879,7 @@ EXAMPLES
       user3
 ```
 
-_See code: [@salesforce/plugin-user](https://github.com/salesforcecli/plugin-user/blob/3.6.53/src/commands/org/assign/permsetlicense.ts)_
+_See code: [@salesforce/plugin-user](https://github.com/salesforcecli/plugin-user/blob/3.7.0/src/commands/org/assign/permsetlicense.ts)_
 
 ## `sf org create sandbox`
 
@@ -4292,7 +4303,7 @@ FLAG DESCRIPTIONS
     might be different than what you specify in the definition file.
 ```
 
-_See code: [@salesforce/plugin-user](https://github.com/salesforcecli/plugin-user/blob/3.6.53/src/commands/org/create/user.ts)_
+_See code: [@salesforce/plugin-user](https://github.com/salesforcecli/plugin-user/blob/3.7.0/src/commands/org/create/user.ts)_
 
 ## `sf org delete sandbox`
 
@@ -4505,7 +4516,7 @@ EXAMPLES
     $ sf org display user --target-org me@my.org --json
 ```
 
-_See code: [@salesforce/plugin-user](https://github.com/salesforcecli/plugin-user/blob/3.6.53/src/commands/org/display/user.ts)_
+_See code: [@salesforce/plugin-user](https://github.com/salesforcecli/plugin-user/blob/3.7.0/src/commands/org/display/user.ts)_
 
 ## `sf org enable tracking`
 
@@ -4563,8 +4574,8 @@ FLAGS
                                  created locally with the "org create user" command.
   -c, --complexity=<value>       [default: 5] Level of password complexity or strength; the higher the value, the
                                  stronger the password.
-  -l, --length=<value>           [default: 13] Number of characters in the generated password; valid values are between
-                                 8 and 100.
+  -l, --length=<value>           [default: 20] Number of characters in the generated password; valid values are between
+                                 20 and 100. Default value is 20.
   -o, --target-org=<value>       (required) Username or alias of the target org. Not required if the `target-org`
                                  configuration variable is already set.
       --api-version=<value>      Override the api version used for api requests made by this command
@@ -4599,10 +4610,10 @@ EXAMPLES
 
     $ sf org generate password
 
-  Generate a password that contains 12 characters for the original admin user of the scratch org with alias
+  Generate a password that contains 25 characters for the original admin user of the scratch org with alias
   "my-scratch":
 
-    $ sf org generate password --length 12 --target-org my-scratch
+    $ sf org generate password --length 25 --target-org my-scratch
 
   Generate a password for your default scratch org admin user that uses lower and upper case letters and numbers only:
 
@@ -4614,7 +4625,7 @@ EXAMPLES
     $ sf org generate password --on-behalf-of user1@my.org --on-behalf-of user2@my.org --on-behalf-of user3@my.org
 ```
 
-_See code: [@salesforce/plugin-user](https://github.com/salesforcecli/plugin-user/blob/3.6.53/src/commands/org/generate/password.ts)_
+_See code: [@salesforce/plugin-user](https://github.com/salesforcecli/plugin-user/blob/3.7.0/src/commands/org/generate/password.ts)_
 
 ## `sf org list`
 
@@ -4931,7 +4942,7 @@ EXAMPLES
     $ sf org list users --target-org me@my.org
 ```
 
-_See code: [@salesforce/plugin-user](https://github.com/salesforcecli/plugin-user/blob/3.6.53/src/commands/org/list/users.ts)_
+_See code: [@salesforce/plugin-user](https://github.com/salesforcecli/plugin-user/blob/3.7.0/src/commands/org/list/users.ts)_
 
 ## `sf org login access-token`
 

package/npm-shrinkwrap.json

@@ -1,17 +1,17 @@
 {
   "name": "@salesforce/cli",
-  "version": "2.127.2",
+  "version": "2.128.1",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@salesforce/cli",
-      "version": "2.127.2",
+      "version": "2.128.1",
       "hasInstallScript": true,
       "license": "Apache-2.0",
       "dependencies": {
         "@inquirer/select": "^2.3.5",
-        "@oclif/core": "4.8.4",
+        "@oclif/core": "4.9.0",
         "@oclif/plugin-autocomplete": "3.2.40",
         "@oclif/plugin-commands": "4.1.40",
         "@oclif/plugin-help": "6.2.37",
@@ -24,11 +24,11 @@
         "@oclif/plugin-which": "3.2.44",
         "@salesforce/core": "^8.25.0",
         "@salesforce/kit": "^3.1.6",
-        "@salesforce/plugin-agent": "1.32.0",
+        "@salesforce/plugin-agent": "1.32.1",
         "@salesforce/plugin-apex": "3.9.12",
         "@salesforce/plugin-api": "1.3.11",
         "@salesforce/plugin-auth": "4.3.0",
-        "@salesforce/plugin-data": "4.0.77",
+        "@salesforce/plugin-data": "4.0.78",
         "@salesforce/plugin-deploy-retrieve": "3.24.15",
         "@salesforce/plugin-info": "3.4.109",
         "@salesforce/plugin-limits": "3.3.79",
@@ -41,7 +41,7 @@
         "@salesforce/plugin-telemetry": "3.8.2",
         "@salesforce/plugin-templates": "56.10.5",
         "@salesforce/plugin-trust": "3.7.114",
-        "@salesforce/plugin-user": "3.6.53",
+        "@salesforce/plugin-user": "3.7.0",
         "@salesforce/sf-plugins-core": "12.2.6",
         "ansis": "^3.12.0"
       },
@@ -3651,9 +3651,9 @@
       }
     },
     "node_modules/@oclif/core": {
-      "version": "4.8.4",
-      "resolved": "https://registry.npmjs.org/@oclif/core/-/core-4.8.4.tgz",
-      "integrity": "sha512-UTAqwXJJyRvLBvosL+1uPZYSpr8lEHgUb/EVGbPXo5WZqUIBHfJ0sR2bkBEsrj00/ar4IegKxx4YK0wn2c8SQg==",
+      "version": "4.9.0",
+      "resolved": "https://registry.npmjs.org/@oclif/core/-/core-4.9.0.tgz",
+      "integrity": "sha512-k/ntRgDcUprTT+aaNoF+whk3cY3f9fRD2lkF6ul7JeCUg2MaMXVXZXfbRhJCfsiX51X8/5Pqo0LGdO9SLYXNHg==",
       "license": "MIT",
       "dependencies": {
         "ansi-escapes": "^4.3.2",
@@ -4636,14 +4636,14 @@
       "license": "BSD-3-Clause"
     },
     "node_modules/@salesforce/agents": {
-      "version": "0.24.1",
-      "resolved": "https://registry.npmjs.org/@salesforce/agents/-/agents-0.24.1.tgz",
-      "integrity": "sha512-eU9WRbUwtCsKsv2PhCW8ZXIG2sKS4FFhvKlTFeoCKdEj/rleNseF0Rwn6MI3sIsrP9HfZvhAkh2vbvoPRK/8rQ==",
+      "version": "0.24.2",
+      "resolved": "https://registry.npmjs.org/@salesforce/agents/-/agents-0.24.2.tgz",
+      "integrity": "sha512-apYmYxeS3bnqUl32BvqZX2ALu50GUfdLw4iyJjR2jGm2q/kVTSeb/UBq8FhJBCnsPocnhu+Hmmb60bU0NCLwbw==",
       "license": "Apache-2.0",
       "dependencies": {
-        "@salesforce/core": "^8.26.2",
+        "@salesforce/core": "^8.26.3",
         "@salesforce/kit": "^3.2.4",
-        "@salesforce/source-deploy-retrieve": "^12.31.12",
+        "@salesforce/source-deploy-retrieve": "^12.31.14",
         "@salesforce/types": "^1.6.0",
         "fast-xml-parser": "^5.3.6",
         "nock": "^13.5.6",
@@ -5026,16 +5026,16 @@
       }
     },
     "node_modules/@salesforce/plugin-agent": {
-      "version": "1.32.0",
-      "resolved": "https://registry.npmjs.org/@salesforce/plugin-agent/-/plugin-agent-1.32.0.tgz",
-      "integrity": "sha512-p02UJ9TV3tj1R9qpB3A9mM0ypR+NnlUIt299rwrbraVtx4X0A40GhNYkjsFYLbO6MYBauOIhLknNqGBtHZI6pg==",
+      "version": "1.32.1",
+      "resolved": "https://registry.npmjs.org/@salesforce/plugin-agent/-/plugin-agent-1.32.1.tgz",
+      "integrity": "sha512-F7/aRxjfPe+wQ2oGZF8QJpQpNxy+ANJQOgkgeqx+Pp2LiTImKXwNBk5EJW/9xVYB8Vm6tgP6Qyr/1lC0maBSJg==",
       "license": "Apache-2.0",
       "dependencies": {
         "@inquirer/core": "^10.3.2",
         "@inquirer/prompts": "^7.10.1",
         "@oclif/core": "^4",
         "@oclif/multi-stage-output": "^0.8.29",
-        "@salesforce/agents": "^0.24.1",
+        "@salesforce/agents": "^0.24.2",
         "@salesforce/core": "^8.26.3",
         "@salesforce/kit": "^3.2.4",
         "@salesforce/sf-plugins-core": "^12.2.6",
@@ -5321,9 +5321,9 @@
       }
     },
     "node_modules/@salesforce/plugin-data": {
-      "version": "4.0.77",
-      "resolved": "https://registry.npmjs.org/@salesforce/plugin-data/-/plugin-data-4.0.77.tgz",
-      "integrity": "sha512-GPELAeKDCwhfr3YpPX9jBSE/ZtBP5imGnx7CWzfTO9/wWMv3F8rhu6kHh8srH4xLANXjF+F7utXShd9Z2Y10HQ==",
+      "version": "4.0.78",
+      "resolved": "https://registry.npmjs.org/@salesforce/plugin-data/-/plugin-data-4.0.78.tgz",
+      "integrity": "sha512-5bpRkzqc2Qxc1Vt6xWEXd/DEgbKVHnFgVEuS9PI0ekEUyKpKt1rks1yI0L6jIjlxMI78APG2ABV17nwtRzy9tA==",
       "license": "Apache-2.0",
       "dependencies": {
         "@jsforce/jsforce-node": "^3.10.14",
@@ -5805,9 +5805,9 @@
       }
     },
     "node_modules/@salesforce/plugin-user": {
-      "version": "3.6.53",
-      "resolved": "https://registry.npmjs.org/@salesforce/plugin-user/-/plugin-user-3.6.53.tgz",
-      "integrity": "sha512-37S+loE29qwLtwPZRrRX6TN1O+BX1na6jz0TrzwDRTLaQiB/BD+ifHeoxIMHlKdn/jZdSkNGR+lwgzG0NK0ECg==",
+      "version": "3.7.0",
+      "resolved": "https://registry.npmjs.org/@salesforce/plugin-user/-/plugin-user-3.7.0.tgz",
+      "integrity": "sha512-FB6KfXY/r6sKRX1frnkb+K5jGwVUk3izlMXjfg0umxOct2tihQRhwMBoI2LMWkun/EQt9VSnSXZM4g/7Ci1iPA==",
       "license": "Apache-2.0",
       "dependencies": {
         "@salesforce/core": "^8.26.3",
@@ -24084,9 +24084,9 @@
       }
     },
     "node_modules/undici": {
-      "version": "7.22.0",
-      "resolved": "https://registry.npmjs.org/undici/-/undici-7.22.0.tgz",
-      "integrity": "sha512-RqslV2Us5BrllB+JeiZnK4peryVTndy9Dnqq62S3yYRRTj0tFQCwEniUy2167skdGOy3vqRzEvl1Dm4sV2ReDg==",
+      "version": "7.24.1",
+      "resolved": "https://registry.npmjs.org/undici/-/undici-7.24.1.tgz",
+      "integrity": "sha512-5xoBibbmnjlcR3jdqtY2Lnx7WbrD/tHlT01TmvqZUFVc9Q1w4+j5hbnapTqbcXITMH1ovjq/W7BkqBilHiVAaA==",
       "license": "MIT",
       "engines": {
         "node": ">=20.18.1"

package/oclif.lock

@@ -1635,10 +1635,10 @@
     proc-log "^5.0.0"
     which "^5.0.0"
 
-"@oclif/core@^4", "@oclif/core@^4.0.27", "@oclif/core@^4.2.8", "@oclif/core@^4.5.2", "@oclif/core@^4.8.0", "@oclif/core@^4.8.2", "@oclif/core@^4.8.4", "@oclif/core@>= 3.0.0", "@oclif/core@4.8.4":
-  version "4.8.4"
-  resolved "https://registry.npmjs.org/@oclif/core/-/core-4.8.4.tgz"
-  integrity sha512-UTAqwXJJyRvLBvosL+1uPZYSpr8lEHgUb/EVGbPXo5WZqUIBHfJ0sR2bkBEsrj00/ar4IegKxx4YK0wn2c8SQg==
+"@oclif/core@^4", "@oclif/core@^4.0.27", "@oclif/core@^4.2.8", "@oclif/core@^4.5.2", "@oclif/core@^4.8.0", "@oclif/core@^4.8.2", "@oclif/core@^4.8.4", "@oclif/core@>= 3.0.0", "@oclif/core@4.9.0":
+  version "4.9.0"
+  resolved "https://registry.npmjs.org/@oclif/core/-/core-4.9.0.tgz"
+  integrity sha512-k/ntRgDcUprTT+aaNoF+whk3cY3f9fRD2lkF6ul7JeCUg2MaMXVXZXfbRhJCfsiX51X8/5Pqo0LGdO9SLYXNHg==
   dependencies:
     ansi-escapes "^4.3.2"
     ansis "^3.17.0"
@@ -2045,14 +2045,14 @@
   resolved "https://registry.npmjs.org/@protobufjs/utf8/-/utf8-1.1.0.tgz"
   integrity sha512-Vvn3zZrhQZkkBE8LSuW3em98c0FwgO4nxzv6OdSxPKJIEKY2bGbHn+mhGIPerzI4twdxaP8/0+06HBpwf345Lw==
 
-"@salesforce/agents@^0.24.1":
-  version "0.24.1"
-  resolved "https://registry.npmjs.org/@salesforce/agents/-/agents-0.24.1.tgz"
-  integrity sha512-eU9WRbUwtCsKsv2PhCW8ZXIG2sKS4FFhvKlTFeoCKdEj/rleNseF0Rwn6MI3sIsrP9HfZvhAkh2vbvoPRK/8rQ==
+"@salesforce/agents@^0.24.2":
+  version "0.24.2"
+  resolved "https://registry.npmjs.org/@salesforce/agents/-/agents-0.24.2.tgz"
+  integrity sha512-apYmYxeS3bnqUl32BvqZX2ALu50GUfdLw4iyJjR2jGm2q/kVTSeb/UBq8FhJBCnsPocnhu+Hmmb60bU0NCLwbw==
   dependencies:
-    "@salesforce/core" "^8.26.2"
+    "@salesforce/core" "^8.26.3"
     "@salesforce/kit" "^3.2.4"
-    "@salesforce/source-deploy-retrieve" "^12.31.12"
+    "@salesforce/source-deploy-retrieve" "^12.31.14"
     "@salesforce/types" "^1.6.0"
     fast-xml-parser "^5.3.6"
     nock "^13.5.6"
@@ -2186,16 +2186,16 @@
     jszip "^3.10.1"
     object-treeify "^2"
 
-"@salesforce/plugin-agent@1.32.0":
-  version "1.32.0"
-  resolved "https://registry.npmjs.org/@salesforce/plugin-agent/-/plugin-agent-1.32.0.tgz"
-  integrity sha512-p02UJ9TV3tj1R9qpB3A9mM0ypR+NnlUIt299rwrbraVtx4X0A40GhNYkjsFYLbO6MYBauOIhLknNqGBtHZI6pg==
+"@salesforce/plugin-agent@1.32.1":
+  version "1.32.1"
+  resolved "https://registry.npmjs.org/@salesforce/plugin-agent/-/plugin-agent-1.32.1.tgz"
+  integrity sha512-F7/aRxjfPe+wQ2oGZF8QJpQpNxy+ANJQOgkgeqx+Pp2LiTImKXwNBk5EJW/9xVYB8Vm6tgP6Qyr/1lC0maBSJg==
   dependencies:
     "@inquirer/core" "^10.3.2"
     "@inquirer/prompts" "^7.10.1"
     "@oclif/core" "^4"
     "@oclif/multi-stage-output" "^0.8.29"
-    "@salesforce/agents" "^0.24.1"
+    "@salesforce/agents" "^0.24.2"
     "@salesforce/core" "^8.26.3"
     "@salesforce/kit" "^3.2.4"
     "@salesforce/sf-plugins-core" "^12.2.6"
@@ -2265,10 +2265,10 @@
     debug "^4.4.0"
     handlebars "^4.7.8"
 
-"@salesforce/plugin-data@4.0.77":
-  version "4.0.77"
-  resolved "https://registry.npmjs.org/@salesforce/plugin-data/-/plugin-data-4.0.77.tgz"
-  integrity sha512-GPELAeKDCwhfr3YpPX9jBSE/ZtBP5imGnx7CWzfTO9/wWMv3F8rhu6kHh8srH4xLANXjF+F7utXShd9Z2Y10HQ==
+"@salesforce/plugin-data@4.0.78":
+  version "4.0.78"
+  resolved "https://registry.npmjs.org/@salesforce/plugin-data/-/plugin-data-4.0.78.tgz"
+  integrity sha512-5bpRkzqc2Qxc1Vt6xWEXd/DEgbKVHnFgVEuS9PI0ekEUyKpKt1rks1yI0L6jIjlxMI78APG2ABV17nwtRzy9tA==
   dependencies:
     "@jsforce/jsforce-node" "^3.10.14"
     "@oclif/multi-stage-output" "^0.8.30"
@@ -2473,10 +2473,10 @@
     semver "^7.7.4"
     shelljs "0.10.0"
 
-"@salesforce/plugin-user@3.6.53":
-  version "3.6.53"
-  resolved "https://registry.npmjs.org/@salesforce/plugin-user/-/plugin-user-3.6.53.tgz"
-  integrity sha512-37S+loE29qwLtwPZRrRX6TN1O+BX1na6jz0TrzwDRTLaQiB/BD+ifHeoxIMHlKdn/jZdSkNGR+lwgzG0NK0ECg==
+"@salesforce/plugin-user@3.7.0":
+  version "3.7.0"
+  resolved "https://registry.npmjs.org/@salesforce/plugin-user/-/plugin-user-3.7.0.tgz"
+  integrity sha512-FB6KfXY/r6sKRX1frnkb+K5jGwVUk3izlMXjfg0umxOct2tihQRhwMBoI2LMWkun/EQt9VSnSXZM4g/7Ci1iPA==
   dependencies:
     "@salesforce/core" "^8.26.3"
     "@salesforce/kit" "^3.2.4"
@@ -2527,7 +2527,7 @@
     cli-progress "^3.12.0"
     terminal-link "^3.0.0"
 
-"@salesforce/source-deploy-retrieve@^12.31.11", "@salesforce/source-deploy-retrieve@^12.31.12", "@salesforce/source-deploy-retrieve@^12.31.14", "@salesforce/source-deploy-retrieve@^12.31.19", "@salesforce/source-deploy-retrieve@^12.31.8":
+"@salesforce/source-deploy-retrieve@^12.31.11", "@salesforce/source-deploy-retrieve@^12.31.14", "@salesforce/source-deploy-retrieve@^12.31.19", "@salesforce/source-deploy-retrieve@^12.31.8":
   version "12.31.19"
   resolved "https://registry.npmjs.org/@salesforce/source-deploy-retrieve/-/source-deploy-retrieve-12.31.19.tgz"
   integrity sha512-ITf0KQOWS4OfNGE8SYerwaB9PnVZS2aXgctM9EjINmRiMJBVgQ5Pjm71IIJiR6yiEsAGfnn0S7Efir2RgtmL7Q==
@@ -11383,9 +11383,9 @@ undici-types@~7.8.0:
   integrity sha512-9UJ2xGDvQ43tYyVMpuHlsgApydB8ZKfVYTsLDhXkFL/6gfkp+U8xTGdh8pMJv1SpZna0zxG1DwsKZsreLbXBxw==
 
 undici@^7.22.0:
-  version "7.22.0"
-  resolved "https://registry.npmjs.org/undici/-/undici-7.22.0.tgz"
-  integrity sha512-RqslV2Us5BrllB+JeiZnK4peryVTndy9Dnqq62S3yYRRTj0tFQCwEniUy2167skdGOy3vqRzEvl1Dm4sV2ReDg==
+  version "7.24.1"
+  resolved "https://registry.npmjs.org/undici/-/undici-7.24.1.tgz"
+  integrity sha512-5xoBibbmnjlcR3jdqtY2Lnx7WbrD/tHlT01TmvqZUFVc9Q1w4+j5hbnapTqbcXITMH1ovjq/W7BkqBilHiVAaA==
 
 unicorn-magic@^0.1.0:
   version "0.1.0"

package/oclif.manifest.json

@@ -4180,5 +4180,5 @@
       "requiresProject": true
     }
   },
-  "version": "2.127.2"
+  "version": "2.128.1"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@salesforce/cli",
   "description": "The Salesforce CLI",
-  "version": "2.127.2",
+  "version": "2.128.1",
   "author": "Salesforce",
   "bin": {
     "sf": "./bin/run.js",
@@ -144,7 +144,7 @@
   },
   "dependencies": {
     "@inquirer/select": "^2.3.5",
-    "@oclif/core": "4.8.4",
+    "@oclif/core": "4.9.0",
     "@oclif/plugin-autocomplete": "3.2.40",
     "@oclif/plugin-commands": "4.1.40",
     "@oclif/plugin-help": "6.2.37",
@@ -157,11 +157,11 @@
     "@oclif/plugin-which": "3.2.44",
     "@salesforce/core": "^8.25.0",
     "@salesforce/kit": "^3.1.6",
-    "@salesforce/plugin-agent": "1.32.0",
+    "@salesforce/plugin-agent": "1.32.1",
     "@salesforce/plugin-apex": "3.9.12",
     "@salesforce/plugin-api": "1.3.11",
     "@salesforce/plugin-auth": "4.3.0",
-    "@salesforce/plugin-data": "4.0.77",
+    "@salesforce/plugin-data": "4.0.78",
     "@salesforce/plugin-deploy-retrieve": "3.24.15",
     "@salesforce/plugin-info": "3.4.109",
     "@salesforce/plugin-limits": "3.3.79",
@@ -174,7 +174,7 @@
     "@salesforce/plugin-telemetry": "3.8.2",
     "@salesforce/plugin-templates": "56.10.5",
     "@salesforce/plugin-trust": "3.7.114",
-    "@salesforce/plugin-user": "3.6.53",
+    "@salesforce/plugin-user": "3.7.0",
     "@salesforce/sf-plugins-core": "12.2.6",
     "ansis": "^3.12.0"
   },