@salesforce/cli 2.121.0 → 2.121.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -25,7 +25,7 @@ $ npm install -g @salesforce/cli
25
25
  $ sf COMMAND
26
26
  running command...
27
27
  $ sf (--version|-v)
28
- @salesforce/cli/2.121.0 linux-x64 node-v22.22.0
28
+ @salesforce/cli/2.121.1 linux-x64 node-v22.22.0
29
29
  $ sf --help [COMMAND]
30
30
  USAGE
31
31
  $ sf COMMAND
@@ -248,7 +248,7 @@ EXAMPLES
248
248
  $ sf agent activate --api-name Resort_Manager --target-org my-org
249
249
  ```
250
250
 
251
- _See code: [@salesforce/plugin-agent](https://github.com/salesforcecli/plugin-agent/blob/1.26.6/src/commands/agent/activate.ts)_
251
+ _See code: [@salesforce/plugin-agent](https://github.com/salesforcecli/plugin-agent/blob/1.26.7/src/commands/agent/activate.ts)_
252
252
 
253
253
  ## `sf agent create`
254
254
 
@@ -315,7 +315,7 @@ EXAMPLES
315
315
  $ sf agent create --name "Resort Manager" --spec specs/resortManagerAgent.yaml --preview
316
316
  ```
317
317
 
318
- _See code: [@salesforce/plugin-agent](https://github.com/salesforcecli/plugin-agent/blob/1.26.6/src/commands/agent/create.ts)_
318
+ _See code: [@salesforce/plugin-agent](https://github.com/salesforcecli/plugin-agent/blob/1.26.7/src/commands/agent/create.ts)_
319
319
 
320
320
  ## `sf agent deactivate`
321
321
 
@@ -355,7 +355,7 @@ EXAMPLES
355
355
  $ sf agent deactivate --api-name Resort_Manager --target-org my-org
356
356
  ```
357
357
 
358
- _See code: [@salesforce/plugin-agent](https://github.com/salesforcecli/plugin-agent/blob/1.26.6/src/commands/agent/deactivate.ts)_
358
+ _See code: [@salesforce/plugin-agent](https://github.com/salesforcecli/plugin-agent/blob/1.26.7/src/commands/agent/deactivate.ts)_
359
359
 
360
360
  ## `sf agent generate agent-spec`
361
361
 
@@ -462,7 +462,7 @@ EXAMPLES
462
462
  $ sf agent generate agent-spec --tone formal --agent-user resortmanager@myorg.com
463
463
  ```
464
464
 
465
- _See code: [@salesforce/plugin-agent](https://github.com/salesforcecli/plugin-agent/blob/1.26.6/src/commands/agent/generate/agent-spec.ts)_
465
+ _See code: [@salesforce/plugin-agent](https://github.com/salesforcecli/plugin-agent/blob/1.26.7/src/commands/agent/generate/agent-spec.ts)_
466
466
 
467
467
  ## `sf agent generate authoring-bundle`
468
468
 
@@ -528,7 +528,7 @@ EXAMPLES
528
528
  other-package-dir/main/default --target-org my-dev-org
529
529
  ```
530
530
 
531
- _See code: [@salesforce/plugin-agent](https://github.com/salesforcecli/plugin-agent/blob/1.26.6/src/commands/agent/generate/authoring-bundle.ts)_
531
+ _See code: [@salesforce/plugin-agent](https://github.com/salesforcecli/plugin-agent/blob/1.26.7/src/commands/agent/generate/authoring-bundle.ts)_
532
532
 
533
533
  ## `sf agent generate template`
534
534
 
@@ -576,7 +576,7 @@ EXAMPLES
576
576
  force-app/main/default/bots/My_Awesome_Agent/My_Awesome_Agent.bot-meta.xml --agent-version 1
577
577
  ```
578
578
 
579
- _See code: [@salesforce/plugin-agent](https://github.com/salesforcecli/plugin-agent/blob/1.26.6/src/commands/agent/generate/template.ts)_
579
+ _See code: [@salesforce/plugin-agent](https://github.com/salesforcecli/plugin-agent/blob/1.26.7/src/commands/agent/generate/template.ts)_
580
580
 
581
581
  ## `sf agent generate test-spec`
582
582
 
@@ -637,7 +637,7 @@ EXAMPLES
637
637
  force-app//main/default/aiEvaluationDefinitions/Resort_Manager_Tests.aiEvaluationDefinition-meta.xml
638
638
  ```
639
639
 
640
- _See code: [@salesforce/plugin-agent](https://github.com/salesforcecli/plugin-agent/blob/1.26.6/src/commands/agent/generate/test-spec.ts)_
640
+ _See code: [@salesforce/plugin-agent](https://github.com/salesforcecli/plugin-agent/blob/1.26.7/src/commands/agent/generate/test-spec.ts)_
641
641
 
642
642
  ## `sf agent preview`
643
643
 
@@ -666,37 +666,41 @@ GLOBAL FLAGS
666
666
  DESCRIPTION
667
667
  Interact with an agent to preview how it responds to your statements, questions, and commands (utterances).
668
668
 
669
- Use this command to have a natural language conversation with an agent while you code its Agent Script file.
670
- Previewing an agent works like an initial test to make sure it responds to your utterances as you expect. For example,
671
- you can test that the agent uses a particular topic when asked a question, and then whether it invokes the correct
672
- action associated with that topic. This command is the CLI-equivalent of the Preview panel in your org's Agentforce
673
- Builder UI.
669
+ Use this command to have a natural language conversation with an agent, either while you code its local Agent Script
670
+ file or when it's published to an org. Previewing an agent acts like an initial test to make sure it responds to your
671
+ utterances as you expect. For example, you can test that the agent uses a particular topic when asked a question, and
672
+ then whether it invokes the correct action associated with that topic. This command is the CLI-equivalent of the
673
+ Preview panel in your org's Agentforce Builder UI.
674
674
 
675
- This command uses the agent's local authoring bundle, which contains its Agent Script file. You can let the command
676
- provide a list of authoring bundles (labeled "(Agent Script)") to choose from or use the --authoring-bundle flag to
677
- specify a bundle's API name.
675
+ Run without flags, this command provides a list of agents to preview, divided into two categories: "Agent Script",
676
+ which are agents that have a local authoring bundle in your DX project, or "Published", which are agents that are
677
+ published and activated in your org. Authoring bundles contain an agent's Agent Script file. You then choose the agent
678
+ you want to preview from the list. Or you can use the --authoring-bundle flag to specify a local authoring bundle's
679
+ API name or --api-name to specify an activated published agent.
678
680
 
679
- You can use these two modes when previewing an agent from its Agent Script file:
681
+ When previewing an agent from its Agent Script file, you can use these two modes:
680
682
 
681
683
  - Simulated mode (Default): Uses only the Agent Script file to converse, and it simulates (mocks) all the actions. Use
682
- this mode if none of the Apex classes, flows, and prompt templates that implement your actions are available yet. The
684
+ this mode if none of the Apex classes, flows, or prompt templates that implement your actions are available yet. The
683
685
  LLM uses the information about topics in the Agent Script file to simulate what the action does or how it responds.
684
686
  - Live mode: Uses the actual Apex classes, flows, and prompt templates in your development org in the agent preview.
685
687
  If you've changed the Apex classe, flows, or prompt templates in your local DX project, then you must deploy them to
686
- your development org if you want to use them in your live preview. You can use the Apex Replay Debugger to debug your
687
- Apex classes when using live mode.
688
+ your development org if you want to use them in your live preview.
688
689
 
689
- The interface is simple: in the "Start typing..." prompt, enter a statement, question, or command; when you're done,
690
- enter Return. Your utterance is posted on the right along with a timestamp. The agent then responds on the left. To
691
- exit the conversation, hit ESC or Control+C.
690
+ You can use the Apex Replay Debugger to debug your Apex classes when using live mode for Agent Script files and for
691
+ activated published agents; specify the --apex-debug flag.
692
+
693
+ Once connected to your agent, the preview interface is simple: in the "Start typing..." prompt, enter a statement,
694
+ question, or command; when you're done, enter Return. Your utterance is posted on the right along with a timestamp.
695
+ The agent then responds on the left. To exit the conversation, hit ESC or Control+C.
692
696
 
693
697
  When the session concludes, the command asks if you want to save the API responses and chat transcripts. By default,
694
698
  the files are saved to the "./temp/agent-preview" directory. Specify a new default directory with the --output-dir
695
699
  flag.
696
700
 
697
701
  EXAMPLES
698
- Preview an agent in simulated mode by choosing from a list of authoring bundles provided by the command; use the org
699
- with alias "my-dev-org":
702
+ Preview an agent by choosing from the list of available local Agent Script or published agents. If previewing a
703
+ local Agent Script agent, use simulated mode. Use the org with alias "my-dev-org".
700
704
 
701
705
  $ sf agent preview --target-org my-dev-org
702
706
 
@@ -706,7 +710,7 @@ EXAMPLES
706
710
  $ sf agent preview --use-live-actions --apex-debug --output-dir transcripts/my-preview
707
711
  ```
708
712
 
709
- _See code: [@salesforce/plugin-agent](https://github.com/salesforcecli/plugin-agent/blob/1.26.6/src/commands/agent/preview.ts)_
713
+ _See code: [@salesforce/plugin-agent](https://github.com/salesforcecli/plugin-agent/blob/1.26.7/src/commands/agent/preview.ts)_
710
714
 
711
715
  ## `sf agent publish authoring-bundle`
712
716
 
@@ -753,7 +757,7 @@ EXAMPLES
753
757
  $ sf agent publish authoring-bundle --api-name MyAuthoringbundle --target-org my-dev-org
754
758
  ```
755
759
 
756
- _See code: [@salesforce/plugin-agent](https://github.com/salesforcecli/plugin-agent/blob/1.26.6/src/commands/agent/publish/authoring-bundle.ts)_
760
+ _See code: [@salesforce/plugin-agent](https://github.com/salesforcecli/plugin-agent/blob/1.26.7/src/commands/agent/publish/authoring-bundle.ts)_
757
761
 
758
762
  ## `sf agent test create`
759
763
 
@@ -808,7 +812,7 @@ EXAMPLES
808
812
  $ sf agent test create --spec specs/Resort_Manager-testSpec.yaml --api-name Resort_Manager_Test --preview
809
813
  ```
810
814
 
811
- _See code: [@salesforce/plugin-agent](https://github.com/salesforcecli/plugin-agent/blob/1.26.6/src/commands/agent/test/create.ts)_
815
+ _See code: [@salesforce/plugin-agent](https://github.com/salesforcecli/plugin-agent/blob/1.26.7/src/commands/agent/test/create.ts)_
812
816
 
813
817
  ## `sf agent test list`
814
818
 
@@ -843,7 +847,7 @@ EXAMPLES
843
847
  $ sf agent test list --target-org my-org
844
848
  ```
845
849
 
846
- _See code: [@salesforce/plugin-agent](https://github.com/salesforcecli/plugin-agent/blob/1.26.6/src/commands/agent/test/list.ts)_
850
+ _See code: [@salesforce/plugin-agent](https://github.com/salesforcecli/plugin-agent/blob/1.26.7/src/commands/agent/test/list.ts)_
847
851
 
848
852
  ## `sf agent test results`
849
853
 
@@ -909,7 +913,7 @@ FLAG DESCRIPTIONS
909
913
  expression when using custom evaluations.
910
914
  ```
911
915
 
912
- _See code: [@salesforce/plugin-agent](https://github.com/salesforcecli/plugin-agent/blob/1.26.6/src/commands/agent/test/results.ts)_
916
+ _See code: [@salesforce/plugin-agent](https://github.com/salesforcecli/plugin-agent/blob/1.26.7/src/commands/agent/test/results.ts)_
913
917
 
914
918
  ## `sf agent test resume`
915
919
 
@@ -982,7 +986,7 @@ FLAG DESCRIPTIONS
982
986
  expression when using custom evaluations.
983
987
  ```
984
988
 
985
- _See code: [@salesforce/plugin-agent](https://github.com/salesforcecli/plugin-agent/blob/1.26.6/src/commands/agent/test/resume.ts)_
989
+ _See code: [@salesforce/plugin-agent](https://github.com/salesforcecli/plugin-agent/blob/1.26.7/src/commands/agent/test/resume.ts)_
986
990
 
987
991
  ## `sf agent test run`
988
992
 
@@ -1056,7 +1060,7 @@ FLAG DESCRIPTIONS
1056
1060
  expression when using custom evaluations.
1057
1061
  ```
1058
1062
 
1059
- _See code: [@salesforce/plugin-agent](https://github.com/salesforcecli/plugin-agent/blob/1.26.6/src/commands/agent/test/run.ts)_
1063
+ _See code: [@salesforce/plugin-agent](https://github.com/salesforcecli/plugin-agent/blob/1.26.7/src/commands/agent/test/run.ts)_
1060
1064
 
1061
1065
  ## `sf agent validate authoring-bundle`
1062
1066
 
@@ -1103,7 +1107,7 @@ EXAMPLES
1103
1107
  $ sf agent validate authoring-bundle --api-name MyAuthoringBundle --target-org my-dev-org
1104
1108
  ```
1105
1109
 
1106
- _See code: [@salesforce/plugin-agent](https://github.com/salesforcecli/plugin-agent/blob/1.26.6/src/commands/agent/validate/authoring-bundle.ts)_
1110
+ _See code: [@salesforce/plugin-agent](https://github.com/salesforcecli/plugin-agent/blob/1.26.7/src/commands/agent/validate/authoring-bundle.ts)_
1107
1111
 
1108
1112
  ## `sf alias list`
1109
1113
 
@@ -1836,7 +1840,7 @@ EXAMPLES
1836
1840
  $ sf api request graphql --body example.txt --stream-to-file output.txt --include
1837
1841
  ```
1838
1842
 
1839
- _See code: [@salesforce/plugin-api](https://github.com/salesforcecli/plugin-api/blob/1.3.7/src/commands/api/request/graphql.ts)_
1843
+ _See code: [@salesforce/plugin-api](https://github.com/salesforcecli/plugin-api/blob/1.3.8/src/commands/api/request/graphql.ts)_
1840
1844
 
1841
1845
  ## `sf api request rest [URL]`
1842
1846
 
@@ -1945,7 +1949,7 @@ FLAG DESCRIPTIONS
1945
1949
  https://github.com/salesforcecli/plugin-api/tree/main/test/test-files/data-project.
1946
1950
  ```
1947
1951
 
1948
- _See code: [@salesforce/plugin-api](https://github.com/salesforcecli/plugin-api/blob/1.3.7/src/commands/api/request/rest.ts)_
1952
+ _See code: [@salesforce/plugin-api](https://github.com/salesforcecli/plugin-api/blob/1.3.8/src/commands/api/request/rest.ts)_
1949
1953
 
1950
1954
  ## `sf autocomplete [SHELL]`
1951
1955
 
@@ -1,12 +1,12 @@
1
1
  {
2
2
  "name": "@salesforce/cli",
3
- "version": "2.121.0",
3
+ "version": "2.121.1",
4
4
  "lockfileVersion": 3,
5
5
  "requires": true,
6
6
  "packages": {
7
7
  "": {
8
8
  "name": "@salesforce/cli",
9
- "version": "2.121.0",
9
+ "version": "2.121.1",
10
10
  "hasInstallScript": true,
11
11
  "license": "Apache-2.0",
12
12
  "dependencies": {
@@ -24,9 +24,9 @@
24
24
  "@oclif/plugin-which": "3.2.43",
25
25
  "@salesforce/core": "8.24.3",
26
26
  "@salesforce/kit": "^3.1.6",
27
- "@salesforce/plugin-agent": "1.26.6",
27
+ "@salesforce/plugin-agent": "1.26.7",
28
28
  "@salesforce/plugin-apex": "3.9.5",
29
- "@salesforce/plugin-api": "1.3.7",
29
+ "@salesforce/plugin-api": "1.3.8",
30
30
  "@salesforce/plugin-auth": "4.1.3",
31
31
  "@salesforce/plugin-data": "4.0.67",
32
32
  "@salesforce/plugin-deploy-retrieve": "3.24.7",
@@ -5081,9 +5081,9 @@
5081
5081
  }
5082
5082
  },
5083
5083
  "node_modules/@salesforce/plugin-agent": {
5084
- "version": "1.26.6",
5085
- "resolved": "https://registry.npmjs.org/@salesforce/plugin-agent/-/plugin-agent-1.26.6.tgz",
5086
- "integrity": "sha512-5hQuxkdJ7xYoM0oKBVcbYlSH36FqYgg2d8wlk3HJgez/f6Zd/rRQ2VATRmnjme8K4swpyIDT7xfI1qJxBONPLA==",
5084
+ "version": "1.26.7",
5085
+ "resolved": "https://registry.npmjs.org/@salesforce/plugin-agent/-/plugin-agent-1.26.7.tgz",
5086
+ "integrity": "sha512-AHvCYuJxdX2RrPW8MQk20BY/ZdFtRpTeAx8GLL9RhgSjy8kxnTNg9jbZlvZ3iW+DtoB8oepYsmas/7bLg6TfgQ==",
5087
5087
  "license": "Apache-2.0",
5088
5088
  "dependencies": {
5089
5089
  "@inquirer/core": "^10.3.2",
@@ -5204,9 +5204,9 @@
5204
5204
  }
5205
5205
  },
5206
5206
  "node_modules/@salesforce/plugin-api": {
5207
- "version": "1.3.7",
5208
- "resolved": "https://registry.npmjs.org/@salesforce/plugin-api/-/plugin-api-1.3.7.tgz",
5209
- "integrity": "sha512-i2NknQshuZi6Dp0gZhSi/+WOLMRqHj2gsRZkzOOpdDdZy0/56CAJuS4VQ0AlWNs4f1WyRrmnae6BThvXr/C59w==",
5207
+ "version": "1.3.8",
5208
+ "resolved": "https://registry.npmjs.org/@salesforce/plugin-api/-/plugin-api-1.3.8.tgz",
5209
+ "integrity": "sha512-yXqXmoXmbyALzVbGZ/b98yEAbgcZE1YoEfEWn/VRmul9W7/ZLCtBd5AKia5AAEWT1ilOf6P3pj83D8TlrcGk2Q==",
5210
5210
  "license": "BSD-3-Clause",
5211
5211
  "dependencies": {
5212
5212
  "@oclif/core": "^4",
package/oclif.lock CHANGED
@@ -2215,10 +2215,10 @@
2215
2215
  jszip "^3.10.1"
2216
2216
  object-treeify "^2"
2217
2217
 
2218
- "@salesforce/plugin-agent@1.26.6":
2219
- version "1.26.6"
2220
- resolved "https://registry.npmjs.org/@salesforce/plugin-agent/-/plugin-agent-1.26.6.tgz"
2221
- integrity sha512-5hQuxkdJ7xYoM0oKBVcbYlSH36FqYgg2d8wlk3HJgez/f6Zd/rRQ2VATRmnjme8K4swpyIDT7xfI1qJxBONPLA==
2218
+ "@salesforce/plugin-agent@1.26.7":
2219
+ version "1.26.7"
2220
+ resolved "https://registry.npmjs.org/@salesforce/plugin-agent/-/plugin-agent-1.26.7.tgz"
2221
+ integrity sha512-AHvCYuJxdX2RrPW8MQk20BY/ZdFtRpTeAx8GLL9RhgSjy8kxnTNg9jbZlvZ3iW+DtoB8oepYsmas/7bLg6TfgQ==
2222
2222
  dependencies:
2223
2223
  "@inquirer/core" "^10.3.2"
2224
2224
  "@inquirer/prompts" "^7.10.1"
@@ -2250,10 +2250,10 @@
2250
2250
  "@salesforce/sf-plugins-core" "^12.2.6"
2251
2251
  ansis "^3.3.1"
2252
2252
 
2253
- "@salesforce/plugin-api@1.3.7":
2254
- version "1.3.7"
2255
- resolved "https://registry.npmjs.org/@salesforce/plugin-api/-/plugin-api-1.3.7.tgz"
2256
- integrity sha512-i2NknQshuZi6Dp0gZhSi/+WOLMRqHj2gsRZkzOOpdDdZy0/56CAJuS4VQ0AlWNs4f1WyRrmnae6BThvXr/C59w==
2253
+ "@salesforce/plugin-api@1.3.8":
2254
+ version "1.3.8"
2255
+ resolved "https://registry.npmjs.org/@salesforce/plugin-api/-/plugin-api-1.3.8.tgz"
2256
+ integrity sha512-yXqXmoXmbyALzVbGZ/b98yEAbgcZE1YoEfEWn/VRmul9W7/ZLCtBd5AKia5AAEWT1ilOf6P3pj83D8TlrcGk2Q==
2257
2257
  dependencies:
2258
2258
  "@oclif/core" "^4"
2259
2259
  "@salesforce/core" "^8.8.1"
@@ -4180,5 +4180,5 @@
4180
4180
  "requiresProject": true
4181
4181
  }
4182
4182
  },
4183
- "version": "2.121.0"
4183
+ "version": "2.121.1"
4184
4184
  }
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@salesforce/cli",
3
3
  "description": "The Salesforce CLI",
4
- "version": "2.121.0",
4
+ "version": "2.121.1",
5
5
  "author": "Salesforce",
6
6
  "bin": {
7
7
  "sf": "./bin/run.js",
@@ -157,9 +157,9 @@
157
157
  "@oclif/plugin-which": "3.2.43",
158
158
  "@salesforce/core": "8.24.3",
159
159
  "@salesforce/kit": "^3.1.6",
160
- "@salesforce/plugin-agent": "1.26.6",
160
+ "@salesforce/plugin-agent": "1.26.7",
161
161
  "@salesforce/plugin-apex": "3.9.5",
162
- "@salesforce/plugin-api": "1.3.7",
162
+ "@salesforce/plugin-api": "1.3.8",
163
163
  "@salesforce/plugin-auth": "4.1.3",
164
164
  "@salesforce/plugin-data": "4.0.67",
165
165
  "@salesforce/plugin-deploy-retrieve": "3.24.7",