@salesforce/cli 2.148.3 → 2.149.0

package/README.md

@@ -25,7 +25,7 @@ $ npm install -g @salesforce/cli
 $ sf COMMAND
 running command...
 $ sf (--version|-v)
-@salesforce/cli/2.148.3 linux-x64 node-v24.18.0
+@salesforce/cli/2.149.0 linux-x64 node-v24.19.0
 $ sf --help [COMMAND]
 USAGE
   $ sf COMMAND
@@ -3706,7 +3706,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/5.1.2/src/commands/data/bulk/results.ts)_
+_See code: [@salesforce/plugin-data](https://github.com/salesforcecli/plugin-data/blob/5.1.3/src/commands/data/bulk/results.ts)_
 
 ## `sf data create file`
 
@@ -3755,7 +3755,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/5.1.2/src/commands/data/create/file.ts)_
+_See code: [@salesforce/plugin-data](https://github.com/salesforcecli/plugin-data/blob/5.1.3/src/commands/data/create/file.ts)_
 
 ## `sf data create record`
 
@@ -3814,7 +3814,7 @@ EXAMPLES
       TracedEntityId=01p17000000R6bLAAS"
 ```
 
-_See code: [@salesforce/plugin-data](https://github.com/salesforcecli/plugin-data/blob/5.1.2/src/commands/data/create/record.ts)_
+_See code: [@salesforce/plugin-data](https://github.com/salesforcecli/plugin-data/blob/5.1.3/src/commands/data/create/record.ts)_
 
 ## `sf data delete bulk`
 
@@ -3873,7 +3873,7 @@ FLAG DESCRIPTIONS
     and can be enabled only by a system administrator.
 ```
 
-_See code: [@salesforce/plugin-data](https://github.com/salesforcecli/plugin-data/blob/5.1.2/src/commands/data/delete/bulk.ts)_
+_See code: [@salesforce/plugin-data](https://github.com/salesforcecli/plugin-data/blob/5.1.3/src/commands/data/delete/bulk.ts)_
 
 ## `sf data delete record`
 
@@ -3934,7 +3934,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/5.1.2/src/commands/data/delete/record.ts)_
+_See code: [@salesforce/plugin-data](https://github.com/salesforcecli/plugin-data/blob/5.1.3/src/commands/data/delete/record.ts)_
 
 ## `sf data delete resume`
 
@@ -3973,7 +3973,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/5.1.2/src/commands/data/delete/resume.ts)_
+_See code: [@salesforce/plugin-data](https://github.com/salesforcecli/plugin-data/blob/5.1.3/src/commands/data/delete/resume.ts)_
 
 ## `sf data export bulk`
 
@@ -4040,7 +4040,7 @@ EXAMPLES
       --result-format json --wait 10 --all-rows
 ```
 
-_See code: [@salesforce/plugin-data](https://github.com/salesforcecli/plugin-data/blob/5.1.2/src/commands/data/export/bulk.ts)_
+_See code: [@salesforce/plugin-data](https://github.com/salesforcecli/plugin-data/blob/5.1.3/src/commands/data/export/bulk.ts)_
 
 ## `sf data export resume`
 
@@ -4079,7 +4079,7 @@ EXAMPLES
     $ sf data export resume --use-most-recent
 ```
 
-_See code: [@salesforce/plugin-data](https://github.com/salesforcecli/plugin-data/blob/5.1.2/src/commands/data/export/resume.ts)_
+_See code: [@salesforce/plugin-data](https://github.com/salesforcecli/plugin-data/blob/5.1.3/src/commands/data/export/resume.ts)_
 
 ## `sf data export tree`
 
@@ -4139,7 +4139,7 @@ EXAMPLES
       my-scratch
 ```
 
-_See code: [@salesforce/plugin-data](https://github.com/salesforcecli/plugin-data/blob/5.1.2/src/commands/data/export/tree.ts)_
+_See code: [@salesforce/plugin-data](https://github.com/salesforcecli/plugin-data/blob/5.1.3/src/commands/data/export/tree.ts)_
 
 ## `sf data get record`
 
@@ -4203,7 +4203,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/5.1.2/src/commands/data/get/record.ts)_
+_See code: [@salesforce/plugin-data](https://github.com/salesforcecli/plugin-data/blob/5.1.3/src/commands/data/get/record.ts)_
 
 ## `sf data import bulk`
 
@@ -4255,7 +4255,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/5.1.2/src/commands/data/import/bulk.ts)_
+_See code: [@salesforce/plugin-data](https://github.com/salesforcecli/plugin-data/blob/5.1.3/src/commands/data/import/bulk.ts)_
 
 ## `sf data import resume`
 
@@ -4291,7 +4291,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/5.1.2/src/commands/data/import/resume.ts)_
+_See code: [@salesforce/plugin-data](https://github.com/salesforcecli/plugin-data/blob/5.1.3/src/commands/data/import/resume.ts)_
 
 ## `sf data import tree`
 
@@ -4355,7 +4355,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/5.1.2/src/commands/data/import/tree.ts)_
+_See code: [@salesforce/plugin-data](https://github.com/salesforcecli/plugin-data/blob/5.1.3/src/commands/data/import/tree.ts)_
 
 ## `sf data query`
 
@@ -4408,7 +4408,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/5.1.2/src/commands/data/query.ts)_
+_See code: [@salesforce/plugin-data](https://github.com/salesforcecli/plugin-data/blob/5.1.3/src/commands/data/query.ts)_
 
 ## `sf data resume`
 
@@ -4445,7 +4445,7 @@ EXAMPLES
     $ sf data resume --job-id 750xx000000005sAAA --batch-id 751xx000000005nAAA
 ```
 
-_See code: [@salesforce/plugin-data](https://github.com/salesforcecli/plugin-data/blob/5.1.2/src/commands/data/resume.ts)_
+_See code: [@salesforce/plugin-data](https://github.com/salesforcecli/plugin-data/blob/5.1.3/src/commands/data/resume.ts)_
 
 ## `sf data search`
 
@@ -4495,7 +4495,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/5.1.2/src/commands/data/search.ts)_
+_See code: [@salesforce/plugin-data](https://github.com/salesforcecli/plugin-data/blob/5.1.3/src/commands/data/search.ts)_
 
 ## `sf data update bulk`
 
@@ -4550,7 +4550,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/5.1.2/src/commands/data/update/bulk.ts)_
+_See code: [@salesforce/plugin-data](https://github.com/salesforcecli/plugin-data/blob/5.1.3/src/commands/data/update/bulk.ts)_
 
 ## `sf data update record`
 
@@ -4614,7 +4614,7 @@ EXAMPLES
       "ExpirationDate=2017-12-01T00:58:04.000+0000"
 ```
 
-_See code: [@salesforce/plugin-data](https://github.com/salesforcecli/plugin-data/blob/5.1.2/src/commands/data/update/record.ts)_
+_See code: [@salesforce/plugin-data](https://github.com/salesforcecli/plugin-data/blob/5.1.3/src/commands/data/update/record.ts)_
 
 ## `sf data update resume`
 
@@ -4653,7 +4653,7 @@ EXAMPLES
     $ sf data update resume --use-most-recent
 ```
 
-_See code: [@salesforce/plugin-data](https://github.com/salesforcecli/plugin-data/blob/5.1.2/src/commands/data/update/resume.ts)_
+_See code: [@salesforce/plugin-data](https://github.com/salesforcecli/plugin-data/blob/5.1.3/src/commands/data/update/resume.ts)_
 
 ## `sf data upsert bulk`
 
@@ -4709,7 +4709,7 @@ EXAMPLES
       my-scratch
 ```
 
-_See code: [@salesforce/plugin-data](https://github.com/salesforcecli/plugin-data/blob/5.1.2/src/commands/data/upsert/bulk.ts)_
+_See code: [@salesforce/plugin-data](https://github.com/salesforcecli/plugin-data/blob/5.1.3/src/commands/data/upsert/bulk.ts)_
 
 ## `sf data upsert resume`
 
@@ -4748,7 +4748,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/5.1.2/src/commands/data/upsert/resume.ts)_
+_See code: [@salesforce/plugin-data](https://github.com/salesforcecli/plugin-data/blob/5.1.3/src/commands/data/upsert/resume.ts)_
 
 ## `sf doctor`
 
@@ -4843,7 +4843,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/5.1.2/src/commands/force/data/bulk/delete.ts)_
+_See code: [@salesforce/plugin-data](https://github.com/salesforcecli/plugin-data/blob/5.1.3/src/commands/force/data/bulk/delete.ts)_
 
 ## `sf force data bulk status`
 
@@ -4880,7 +4880,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/5.1.2/src/commands/force/data/bulk/status.ts)_
+_See code: [@salesforce/plugin-data](https://github.com/salesforcecli/plugin-data/blob/5.1.3/src/commands/force/data/bulk/status.ts)_
 
 ## `sf force data bulk upsert`
 
@@ -4938,7 +4938,7 @@ EXAMPLES
       --target-org my-scratch
 ```
 
-_See code: [@salesforce/plugin-data](https://github.com/salesforcecli/plugin-data/blob/5.1.2/src/commands/force/data/bulk/upsert.ts)_
+_See code: [@salesforce/plugin-data](https://github.com/salesforcecli/plugin-data/blob/5.1.3/src/commands/force/data/bulk/upsert.ts)_
 
 ## `sf help [COMMAND]`
 
@@ -9201,7 +9201,7 @@ EXAMPLES
     $ sf plugins trust allowlist add --name @scope/my-plugin --name another-plugin
 ```
 
-_See code: [@salesforce/plugin-trust](https://github.com/salesforcecli/plugin-trust/blob/4.0.7/src/commands/plugins/trust/allowlist/add.ts)_
+_See code: [@salesforce/plugin-trust](https://github.com/salesforcecli/plugin-trust/blob/4.0.8/src/commands/plugins/trust/allowlist/add.ts)_
 
 ## `sf plugins trust allowlist list`
 
@@ -9229,7 +9229,7 @@ EXAMPLES
     $ sf plugins trust allowlist list
 ```
 
-_See code: [@salesforce/plugin-trust](https://github.com/salesforcecli/plugin-trust/blob/4.0.7/src/commands/plugins/trust/allowlist/list.ts)_
+_See code: [@salesforce/plugin-trust](https://github.com/salesforcecli/plugin-trust/blob/4.0.8/src/commands/plugins/trust/allowlist/list.ts)_
 
 ## `sf plugins trust allowlist remove`
 
@@ -9266,7 +9266,7 @@ EXAMPLES
     $ sf plugins trust allowlist remove --name @scope/my-plugin --name another-plugin
 ```
 
-_See code: [@salesforce/plugin-trust](https://github.com/salesforcecli/plugin-trust/blob/4.0.7/src/commands/plugins/trust/allowlist/remove.ts)_
+_See code: [@salesforce/plugin-trust](https://github.com/salesforcecli/plugin-trust/blob/4.0.8/src/commands/plugins/trust/allowlist/remove.ts)_
 
 ## `sf plugins trust verify`
 
@@ -9295,7 +9295,7 @@ EXAMPLES
   $ sf plugins trust verify --npm @scope/npmName
 ```
 
-_See code: [@salesforce/plugin-trust](https://github.com/salesforcecli/plugin-trust/blob/4.0.7/src/commands/plugins/trust/verify.ts)_
+_See code: [@salesforce/plugin-trust](https://github.com/salesforcecli/plugin-trust/blob/4.0.8/src/commands/plugins/trust/verify.ts)_
 
 ## `sf plugins uninstall [PLUGIN]`
 
@@ -9404,7 +9404,7 @@ FLAG DESCRIPTIONS
     If you specify this flag, don’t specify --metadata or --source-dir.
 ```
 
-_See code: [@salesforce/plugin-deploy-retrieve](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/4.0.2/src/commands/project/convert/mdapi.ts)_
+_See code: [@salesforce/plugin-deploy-retrieve](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/4.1.0/src/commands/project/convert/mdapi.ts)_
 
 ## `sf project convert source`
 
@@ -9477,7 +9477,7 @@ FLAG DESCRIPTIONS
     Override the api version used for api requests made by this command
 ```
 
-_See code: [@salesforce/plugin-deploy-retrieve](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/4.0.2/src/commands/project/convert/source.ts)_
+_See code: [@salesforce/plugin-deploy-retrieve](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/4.1.0/src/commands/project/convert/source.ts)_
 
 ## `sf project convert source-behavior`
 
@@ -9536,7 +9536,7 @@ EXAMPLES
     $ sf project convert source-behavior --behavior decomposePermissionSetBeta --dry-run --preserve-temp-dir
 ```
 
-_See code: [@salesforce/plugin-deploy-retrieve](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/4.0.2/src/commands/project/convert/source-behavior.ts)_
+_See code: [@salesforce/plugin-deploy-retrieve](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/4.1.0/src/commands/project/convert/source-behavior.ts)_
 
 ## `sf project delete source`
 
@@ -9689,7 +9689,7 @@ FLAG DESCRIPTIONS
     - Separate the test names with spaces: --tests Test1 Test2 "Test With Space"
 ```
 
-_See code: [@salesforce/plugin-deploy-retrieve](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/4.0.2/src/commands/project/delete/source.ts)_
+_See code: [@salesforce/plugin-deploy-retrieve](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/4.1.0/src/commands/project/delete/source.ts)_
 
 ## `sf project delete tracking`
 
@@ -9726,7 +9726,7 @@ EXAMPLES
     $ sf project delete tracking --target-org my-scratch
 ```
 
-_See code: [@salesforce/plugin-deploy-retrieve](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/4.0.2/src/commands/project/delete/tracking.ts)_
+_See code: [@salesforce/plugin-deploy-retrieve](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/4.1.0/src/commands/project/delete/tracking.ts)_
 
 ## `sf project deploy cancel`
 
@@ -9798,7 +9798,7 @@ FLAG DESCRIPTIONS
     project deploy report".
 ```
 
-_See code: [@salesforce/plugin-deploy-retrieve](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/4.0.2/src/commands/project/deploy/cancel.ts)_
+_See code: [@salesforce/plugin-deploy-retrieve](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/4.1.0/src/commands/project/deploy/cancel.ts)_
 
 ## `sf project deploy preview`
 
@@ -9881,7 +9881,7 @@ FLAG DESCRIPTIONS
     All child components are included. If you specify this flag, don’t specify --metadata or --source-dir.
 ```
 
-_See code: [@salesforce/plugin-deploy-retrieve](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/4.0.2/src/commands/project/deploy/preview.ts)_
+_See code: [@salesforce/plugin-deploy-retrieve](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/4.1.0/src/commands/project/deploy/preview.ts)_
 
 ## `sf project deploy quick`
 
@@ -9974,7 +9974,7 @@ ERROR CODES
   Canceling (69)         The deploy is being canceled.
 ```
 
-_See code: [@salesforce/plugin-deploy-retrieve](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/4.0.2/src/commands/project/deploy/quick.ts)_
+_See code: [@salesforce/plugin-deploy-retrieve](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/4.1.0/src/commands/project/deploy/quick.ts)_
 
 ## `sf project deploy report`
 
@@ -10066,7 +10066,7 @@ FLAG DESCRIPTIONS
     --coverage-formatters lcov --coverage-formatters clover
 ```
 
-_See code: [@salesforce/plugin-deploy-retrieve](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/4.0.2/src/commands/project/deploy/report.ts)_
+_See code: [@salesforce/plugin-deploy-retrieve](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/4.1.0/src/commands/project/deploy/report.ts)_
 
 ## `sf project deploy resume`
 
@@ -10163,7 +10163,7 @@ ERROR CODES
   Canceling (69)         The deploy is being canceled.
 ```
 
-_See code: [@salesforce/plugin-deploy-retrieve](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/4.0.2/src/commands/project/deploy/resume.ts)_
+_See code: [@salesforce/plugin-deploy-retrieve](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/4.1.0/src/commands/project/deploy/resume.ts)_
 
 ## `sf project deploy start`
 
@@ -10429,7 +10429,7 @@ ERROR CODES
   Canceling (69)         The deploy is being canceled.
 ```
 
-_See code: [@salesforce/plugin-deploy-retrieve](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/4.0.2/src/commands/project/deploy/start.ts)_
+_See code: [@salesforce/plugin-deploy-retrieve](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/4.1.0/src/commands/project/deploy/start.ts)_
 
 ## `sf project deploy validate`
 
@@ -10633,7 +10633,7 @@ ERROR CODES
   Canceling (69)         The deploy is being canceled.
 ```
 
-_See code: [@salesforce/plugin-deploy-retrieve](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/4.0.2/src/commands/project/deploy/validate.ts)_
+_See code: [@salesforce/plugin-deploy-retrieve](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/4.1.0/src/commands/project/deploy/validate.ts)_
 
 ## `sf project generate manifest`
 
@@ -10729,7 +10729,7 @@ EXAMPLES
     $ sf project generate manifest --from-org test@myorg.com --excluded-metadata StandardValueSet
 ```
 
-_See code: [@salesforce/plugin-deploy-retrieve](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/4.0.2/src/commands/project/generate/manifest.ts)_
+_See code: [@salesforce/plugin-deploy-retrieve](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/4.1.0/src/commands/project/generate/manifest.ts)_
 
 ## `sf project list ignored`
 
@@ -10771,7 +10771,7 @@ EXAMPLES
     $ sf project list ignored --source-dir package.xml
 ```
 
-_See code: [@salesforce/plugin-deploy-retrieve](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/4.0.2/src/commands/project/list/ignored.ts)_
+_See code: [@salesforce/plugin-deploy-retrieve](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/4.1.0/src/commands/project/list/ignored.ts)_
 
 ## `sf project reset tracking`
 
@@ -10820,7 +10820,7 @@ EXAMPLES
     $ sf project reset tracking --revision 30
 ```
 
-_See code: [@salesforce/plugin-deploy-retrieve](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/4.0.2/src/commands/project/reset/tracking.ts)_
+_See code: [@salesforce/plugin-deploy-retrieve](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/4.1.0/src/commands/project/reset/tracking.ts)_
 
 ## `sf project retrieve preview`
 
@@ -10874,7 +10874,7 @@ FLAG DESCRIPTIONS
     production orgs.
 ```
 
-_See code: [@salesforce/plugin-deploy-retrieve](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/4.0.2/src/commands/project/retrieve/preview.ts)_
+_See code: [@salesforce/plugin-deploy-retrieve](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/4.1.0/src/commands/project/retrieve/preview.ts)_
 
 ## `sf project retrieve start`
 
@@ -10883,24 +10883,27 @@ Retrieve metadata from an org to your local project.
 ```
 USAGE
   $ sf project retrieve start -o <value> [--json] [--flags-dir <value>] [-a <value>] [-c] [-x <value> | -m <value>... | -d
-    <value>...] [-r <value> | -n <value>... | ] [--single-package -t <value>] [-w <value>] [-z ] [--zip-file-name
-    <value> ]
-
-FLAGS
-  -a, --api-version=<value>      Target API version for the retrieve.
-  -c, --ignore-conflicts         Ignore conflicts and retrieve and save files to your local filesystem, even if they
-                                 overwrite your local changes.
-  -d, --source-dir=<value>...    File paths for source to retrieve from the org.
-  -m, --metadata=<value>...      Metadata component names to retrieve. Wildcards (`*`) supported as long as you use
-                                 quotes, such as `ApexClass:MyClass*`.
-  -n, --package-name=<value>...  Package names to retrieve. Use of this flag is for reference only; don't use it to
-                                 retrieve packaged metadata for development.
-  -o, --target-org=<value>       (required) Username or alias of the target org. Not required if the `target-org`
-                                 configuration variable is already set.
-  -r, --output-dir=<value>       Directory root for the retrieved source files.
-  -w, --wait=<value>             [default: 33 minutes] Number of minutes to wait for the command to complete and display
-                                 results to the terminal window.
-  -x, --manifest=<value>         File path for the manifest (package.xml) that specifies the components to retrieve.
+    <value>...] [--root-type-with-dependencies Bot|AiAgentDefinitionVersion...] [-r <value> | -n <value>... | ]
+    [--single-package -t <value>] [-w <value>] [-z ] [--zip-file-name <value> ]
+
+FLAGS
+  -a, --api-version=<value>                      Target API version for the retrieve.
+  -c, --ignore-conflicts                         Ignore conflicts and retrieve and save files to your local filesystem,
+                                                 even if they overwrite your local changes.
+  -d, --source-dir=<value>...                    File paths for source to retrieve from the org.
+  -m, --metadata=<value>...                      Metadata component names to retrieve. Wildcards (`*`) supported as long
+                                                 as you use quotes, such as `ApexClass:MyClass*`.
+  -n, --package-name=<value>...                  Package names to retrieve. Use of this flag is for reference only;
+                                                 don't use it to retrieve packaged metadata for development.
+  -o, --target-org=<value>                       (required) Username or alias of the target org. Not required if the
+                                                 `target-org` configuration variable is already set.
+  -r, --output-dir=<value>                       Directory root for the retrieved source files.
+  -w, --wait=<value>                             [default: 33 minutes] Number of minutes to wait for the command to
+                                                 complete and display results to the terminal window.
+  -x, --manifest=<value>                         File path for the manifest (package.xml) that specifies the components
+                                                 to retrieve.
+      --root-type-with-dependencies=<option>...  Metadata type whose dependent types should also be retrieved.
+                                                 <options: Bot|AiAgentDefinitionVersion>
 
 METADATA API FORMAT FLAGS
   -t, --target-metadata-dir=<value>  Directory that will contain the retrieved metadata format files or ZIP.
@@ -10962,6 +10965,11 @@ EXAMPLES
 
     $ sf project retrieve start --metadata 'ApexClass:MyApex*'
 
+  Retrieve the source files in the "force-app" directory; if any of the retrieved metadata is of type "Bot", also
+  retrieve all dependent components of the Bot, such as GenAiPlannerBundles, GenAiPlugins, and GenAiFunctions:
+
+    $ sf project retrieve start --source-dir force-app -root-type-with-dependencies Bot
+
   Retrieve a custom object called ExcitingObject that's in the SBQQ namespace:
 
     $ sf project retrieve start --metadata CustomObject:SBQQ__ExcitingObject
@@ -11055,7 +11063,7 @@ ENVIRONMENT VARIABLES
   SF_USE_PROGRESS_BAR  Set to false to disable the progress bar when running the metadata deploy command.
 ```
 
-_See code: [@salesforce/plugin-deploy-retrieve](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/4.0.2/src/commands/project/retrieve/start.ts)_
+_See code: [@salesforce/plugin-deploy-retrieve](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/4.1.0/src/commands/project/retrieve/start.ts)_
 
 ## `sf schema generate field`
 

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
   "name": "@salesforce/cli",
-  "version": "2.148.3",
+  "version": "2.149.0",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@salesforce/cli",
-      "version": "2.148.3",
+      "version": "2.149.0",
       "hasInstallScript": true,
       "license": "Apache-2.0",
       "dependencies": {
@@ -28,8 +28,8 @@
         "@salesforce/plugin-apex": "4.1.0",
         "@salesforce/plugin-api": "2.0.8",
         "@salesforce/plugin-auth": "5.0.4",
-        "@salesforce/plugin-data": "5.1.2",
-        "@salesforce/plugin-deploy-retrieve": "4.0.2",
+        "@salesforce/plugin-data": "5.1.3",
+        "@salesforce/plugin-deploy-retrieve": "4.1.0",
         "@salesforce/plugin-info": "4.0.5",
         "@salesforce/plugin-limits": "4.0.3",
         "@salesforce/plugin-marketplace": "2.0.4",
@@ -40,7 +40,7 @@
         "@salesforce/plugin-sobject": "2.0.5",
         "@salesforce/plugin-telemetry": "4.0.3",
         "@salesforce/plugin-templates": "57.0.6",
-        "@salesforce/plugin-trust": "4.0.7",
+        "@salesforce/plugin-trust": "4.0.8",
         "@salesforce/plugin-user": "5.0.0",
         "@salesforce/sf-plugins-core": "13.0.0",
         "ansis": "^3.12.0"
@@ -4856,9 +4856,9 @@
       }
     },
     "node_modules/@salesforce/plugin-data": {
-      "version": "5.1.2",
-      "resolved": "https://registry.npmjs.org/@salesforce/plugin-data/-/plugin-data-5.1.2.tgz",
-      "integrity": "sha512-F3dA1rmhZ7W7fLWQx4oJyR/LGHOPPgacOCI+robFyhAcGYfgD31NzGJQXvAUC9kJRj1KG6xeP2hgZXXqwTUmUA==",
+      "version": "5.1.3",
+      "resolved": "https://registry.npmjs.org/@salesforce/plugin-data/-/plugin-data-5.1.3.tgz",
+      "integrity": "sha512-qmRadu+h8puX1tpclgOZZTThWOyItTtJX7ugnNLN8AQCOLRAbhrv/D47U3vr34pU1PQgv51tT3nvRmFv8XaniQ==",
       "license": "Apache-2.0",
       "dependencies": {
         "@jsforce/jsforce-node": "^3.10.15",
@@ -4887,9 +4887,9 @@
       "license": "MIT"
     },
     "node_modules/@salesforce/plugin-deploy-retrieve": {
-      "version": "4.0.2",
-      "resolved": "https://registry.npmjs.org/@salesforce/plugin-deploy-retrieve/-/plugin-deploy-retrieve-4.0.2.tgz",
-      "integrity": "sha512-NDlkgWSf/zPonCsEflriHlDseu1liKAvr6IEsjMCQZCThqey8yLmabIN5MRtm21djHF23AzddCLsaqELpo4kwA==",
+      "version": "4.1.0",
+      "resolved": "https://registry.npmjs.org/@salesforce/plugin-deploy-retrieve/-/plugin-deploy-retrieve-4.1.0.tgz",
+      "integrity": "sha512-Ad6Pat0ls3guPyxRdLXKEBM3cvYvCdra3aODqQHFuU7WrnVYZvgzuUs0uDoUh/qdijy8acX4kPpYF8lAnkqlZw==",
       "license": "Apache-2.0",
       "dependencies": {
         "@inquirer/prompts": "^7.8.3",
@@ -4900,7 +4900,7 @@
         "@salesforce/kit": "^4.0.0",
         "@salesforce/plugin-info": "^4.0.0",
         "@salesforce/sf-plugins-core": "^13.0.0",
-        "@salesforce/source-deploy-retrieve": "^13.0.0",
+        "@salesforce/source-deploy-retrieve": "^13.1.0",
         "@salesforce/source-tracking": "^8.0.0",
         "@salesforce/ts-types": "^3.0.0",
         "ansis": "^3.17.0",
@@ -5166,9 +5166,9 @@
       }
     },
     "node_modules/@salesforce/plugin-trust": {
-      "version": "4.0.7",
-      "resolved": "https://registry.npmjs.org/@salesforce/plugin-trust/-/plugin-trust-4.0.7.tgz",
-      "integrity": "sha512-b70IQPIO1182LOdEXRZnuiK4zlOLDAMvALUMNE/g3A59zh1h/x5XdWAyaK9wrjGsJLLCFDX6Z2MYfhhqXDEyoA==",
+      "version": "4.0.8",
+      "resolved": "https://registry.npmjs.org/@salesforce/plugin-trust/-/plugin-trust-4.0.8.tgz",
+      "integrity": "sha512-IsAtd/tBx3soTWFRA8owbAEwdZsbHHQz2SmU0k0QdSFxnBHOlNQ0E7fa3Oh8KRkprQzFH8aW1MHNmn8xYtEHKQ==",
       "license": "Apache-2.0",
       "dependencies": {
         "@oclif/core": "^4",
@@ -5359,9 +5359,9 @@
       }
     },
     "node_modules/@salesforce/source-deploy-retrieve": {
-      "version": "13.0.1",
-      "resolved": "https://registry.npmjs.org/@salesforce/source-deploy-retrieve/-/source-deploy-retrieve-13.0.1.tgz",
-      "integrity": "sha512-7A2l/4rI6YVif2xfb3L39QSC0T0D6enKblyTLzqo/E6bxSBatW9Ra/tLEoEWCLfzcLeT/Zupjcpsgbbwm90Daw==",
+      "version": "13.1.0",
+      "resolved": "https://registry.npmjs.org/@salesforce/source-deploy-retrieve/-/source-deploy-retrieve-13.1.0.tgz",
+      "integrity": "sha512-oSOuinhSMkP1t1F0IzwX6NKgcirSl2ROV2v4GcYb1QOp0tFS9NGpofNMuViTFNoxmBdvrKv5mUT19OdrBMyeWw==",
       "license": "Apache-2.0",
       "dependencies": {
         "@salesforce/core": "^9.0.0",

package/oclif.lock

@@ -2056,10 +2056,10 @@
     debug "^4.4.3"
     handlebars "^4.7.9"
 
-"@salesforce/plugin-data@5.1.2":
-  version "5.1.2"
-  resolved "https://registry.npmjs.org/@salesforce/plugin-data/-/plugin-data-5.1.2.tgz"
-  integrity sha512-F3dA1rmhZ7W7fLWQx4oJyR/LGHOPPgacOCI+robFyhAcGYfgD31NzGJQXvAUC9kJRj1KG6xeP2hgZXXqwTUmUA==
+"@salesforce/plugin-data@5.1.3":
+  version "5.1.3"
+  resolved "https://registry.npmjs.org/@salesforce/plugin-data/-/plugin-data-5.1.3.tgz"
+  integrity sha512-qmRadu+h8puX1tpclgOZZTThWOyItTtJX7ugnNLN8AQCOLRAbhrv/D47U3vr34pU1PQgv51tT3nvRmFv8XaniQ==
   dependencies:
     "@jsforce/jsforce-node" "^3.10.15"
     "@oclif/multi-stage-output" "^0.8.44"
@@ -2076,10 +2076,10 @@
     undici "^7.29.0"
     zod "^4.4.3"
 
-"@salesforce/plugin-deploy-retrieve@4.0.2":
-  version "4.0.2"
-  resolved "https://registry.npmjs.org/@salesforce/plugin-deploy-retrieve/-/plugin-deploy-retrieve-4.0.2.tgz"
-  integrity sha512-NDlkgWSf/zPonCsEflriHlDseu1liKAvr6IEsjMCQZCThqey8yLmabIN5MRtm21djHF23AzddCLsaqELpo4kwA==
+"@salesforce/plugin-deploy-retrieve@4.1.0":
+  version "4.1.0"
+  resolved "https://registry.npmjs.org/@salesforce/plugin-deploy-retrieve/-/plugin-deploy-retrieve-4.1.0.tgz"
+  integrity sha512-Ad6Pat0ls3guPyxRdLXKEBM3cvYvCdra3aODqQHFuU7WrnVYZvgzuUs0uDoUh/qdijy8acX4kPpYF8lAnkqlZw==
   dependencies:
     "@inquirer/prompts" "^7.8.3"
     "@oclif/core" "^4.11.14"
@@ -2089,7 +2089,7 @@
     "@salesforce/kit" "^4.0.0"
     "@salesforce/plugin-info" "^4.0.0"
     "@salesforce/sf-plugins-core" "^13.0.0"
-    "@salesforce/source-deploy-retrieve" "^13.0.0"
+    "@salesforce/source-deploy-retrieve" "^13.1.0"
     "@salesforce/source-tracking" "^8.0.0"
     "@salesforce/ts-types" "^3.0.0"
     ansis "^3.17.0"
@@ -2250,10 +2250,10 @@
     "@salesforce/sf-plugins-core" "^13.0.0"
     "@salesforce/templates" "^66.13.6"
 
-"@salesforce/plugin-trust@^4.0.1", "@salesforce/plugin-trust@4.0.7":
-  version "4.0.7"
-  resolved "https://registry.npmjs.org/@salesforce/plugin-trust/-/plugin-trust-4.0.7.tgz"
-  integrity sha512-b70IQPIO1182LOdEXRZnuiK4zlOLDAMvALUMNE/g3A59zh1h/x5XdWAyaK9wrjGsJLLCFDX6Z2MYfhhqXDEyoA==
+"@salesforce/plugin-trust@^4.0.1", "@salesforce/plugin-trust@4.0.8":
+  version "4.0.8"
+  resolved "https://registry.npmjs.org/@salesforce/plugin-trust/-/plugin-trust-4.0.8.tgz"
+  integrity sha512-IsAtd/tBx3soTWFRA8owbAEwdZsbHHQz2SmU0k0QdSFxnBHOlNQ0E7fa3Oh8KRkprQzFH8aW1MHNmn8xYtEHKQ==
   dependencies:
     "@oclif/core" "^4"
     "@salesforce/core" "^9.1.0"
@@ -2320,10 +2320,10 @@
     cli-progress "^3.12.0"
     terminal-link "^3.0.0"
 
-"@salesforce/source-deploy-retrieve@^13.0.0", "@salesforce/source-deploy-retrieve@^13.0.1":
-  version "13.0.1"
-  resolved "https://registry.npmjs.org/@salesforce/source-deploy-retrieve/-/source-deploy-retrieve-13.0.1.tgz"
-  integrity sha512-7A2l/4rI6YVif2xfb3L39QSC0T0D6enKblyTLzqo/E6bxSBatW9Ra/tLEoEWCLfzcLeT/Zupjcpsgbbwm90Daw==
+"@salesforce/source-deploy-retrieve@^13.0.0", "@salesforce/source-deploy-retrieve@^13.0.1", "@salesforce/source-deploy-retrieve@^13.1.0":
+  version "13.1.0"
+  resolved "https://registry.npmjs.org/@salesforce/source-deploy-retrieve/-/source-deploy-retrieve-13.1.0.tgz"
+  integrity sha512-oSOuinhSMkP1t1F0IzwX6NKgcirSl2ROV2v4GcYb1QOp0tFS9NGpofNMuViTFNoxmBdvrKv5mUT19OdrBMyeWw==
   dependencies:
     "@salesforce/core" "^9.0.0"
     "@salesforce/kit" "^4.0.0"

package/oclif.manifest.json

@@ -6998,5 +6998,5 @@
       "requiresProject": true
     }
   },
-  "version": "2.148.3"
+  "version": "2.149.0"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@salesforce/cli",
   "description": "The Salesforce CLI",
-  "version": "2.148.3",
+  "version": "2.149.0",
   "author": "Salesforce",
   "bin": {
     "sf": "./bin/run.js",
@@ -163,8 +163,8 @@
     "@salesforce/plugin-apex": "4.1.0",
     "@salesforce/plugin-api": "2.0.8",
     "@salesforce/plugin-auth": "5.0.4",
-    "@salesforce/plugin-data": "5.1.2",
-    "@salesforce/plugin-deploy-retrieve": "4.0.2",
+    "@salesforce/plugin-data": "5.1.3",
+    "@salesforce/plugin-deploy-retrieve": "4.1.0",
     "@salesforce/plugin-info": "4.0.5",
     "@salesforce/plugin-limits": "4.0.3",
     "@salesforce/plugin-marketplace": "2.0.4",
@@ -175,7 +175,7 @@
     "@salesforce/plugin-sobject": "2.0.5",
     "@salesforce/plugin-telemetry": "4.0.3",
     "@salesforce/plugin-templates": "57.0.6",
-    "@salesforce/plugin-trust": "4.0.7",
+    "@salesforce/plugin-trust": "4.0.8",
     "@salesforce/plugin-user": "5.0.0",
     "@salesforce/sf-plugins-core": "13.0.0",
     "ansis": "^3.12.0"