chore(release): 1.8.0 [skip ci]

Author: svc-cli-bot

CHANGELOG.md

@@ -1,3 +1,10 @@
+# [1.8.0](https://github.com/salesforcecli/plugin-agent/compare/1.7.2...1.8.0) (2025-01-16)
+
+### Features
+
+- add ability to create a spec from a spec ([4805a2f](https://github.com/salesforcecli/plugin-agent/commit/4805a2f66acb2984375d863276b05f91a51f8709))
+- add generate spec v2 command and tests ([3d5261b](https://github.com/salesforcecli/plugin-agent/commit/3d5261bffca3386e742ab8127f766cfc5c5adf88))
+
 ## [1.7.2](https://github.com/salesforcecli/plugin-agent/compare/1.7.2-dev.1...1.7.2) (2024-12-18)
 
 ### Bug Fixes

README.md

@@ -64,6 +64,7 @@ sf plugins
 - [`sf agent create`](#sf-agent-create)
 - [`sf agent generate definition`](#sf-agent-generate-definition)
 - [`sf agent generate spec`](#sf-agent-generate-spec)
+- [`sf agent generate spec-v2`](#sf-agent-generate-spec-v2)
 - [`sf agent generate testset`](#sf-agent-generate-testset)
 - [`sf agent preview`](#sf-agent-preview)
 - [`sf agent test cancel`](#sf-agent-test-cancel)
@@ -111,7 +112,7 @@ EXAMPLES
     $ sf agent create --name CustomerSupportAgent --spec ./config/agentSpec.json --target-org my-org
 ```
 
-_See code: [src/commands/agent/create.ts](https://github.com/salesforcecli/plugin-agent/blob/1.7.2/src/commands/agent/create.ts)_
+_See code: [src/commands/agent/create.ts](https://github.com/salesforcecli/plugin-agent/blob/1.8.0/src/commands/agent/create.ts)_
 
 ## `sf agent generate definition`
 
@@ -136,7 +137,7 @@ EXAMPLES
   $ sf agent generate definition
 ```
 
-_See code: [src/commands/agent/generate/definition.ts](https://github.com/salesforcecli/plugin-agent/blob/1.7.2/src/commands/agent/generate/definition.ts)_
+_See code: [src/commands/agent/generate/definition.ts](https://github.com/salesforcecli/plugin-agent/blob/1.8.0/src/commands/agent/generate/definition.ts)_
 
 ## `sf agent generate spec`
 
@@ -197,7 +198,71 @@ EXAMPLES
     $ sf agent generate spec --output-dir specs --target-org my-org
 ```
 
-_See code: [src/commands/agent/generate/spec.ts](https://github.com/salesforcecli/plugin-agent/blob/1.7.2/src/commands/agent/generate/spec.ts)_
+_See code: [src/commands/agent/generate/spec.ts](https://github.com/salesforcecli/plugin-agent/blob/1.8.0/src/commands/agent/generate/spec.ts)_
+
+## `sf agent generate spec-v2`
+
+Generate an agent spec, which is the list of jobs that the agent performs.
+
+```
+USAGE
+  $ sf agent generate spec-v2 -o <value> [--json] [--flags-dir <value>] [--api-version <value>] [-t customer|internal]
+    [--role <value>] [--company-name <value>] [--company-description <value>] [--company-website <value>] [--spec
+    <value>] [--output-file <value>] [--max-topics <value>] [--grounding-context <value> --prompt-template <value>]
+
+FLAGS
+  -o, --target-org=<value>           (required) Username or alias of the target org. Not required if the `target-org`
+                                     configuration variable is already set.
+  -t, --type=<option>                Type of agent to create.
+                                     <options: customer|internal>
+      --api-version=<value>          Override the api version used for api requests made by this command
+      --company-description=<value>  Description of your company.
+      --company-name=<value>         Name of your company.
+      --company-website=<value>      Website URL of your company.
+      --grounding-context=<value>    Context information to be used with the customized prompt template.
+      --max-topics=<value>           Maximum number of agent job topics to generate in the spec; default is 10.
+      --output-file=<value>          [default: config/agentSpec.yaml] Path for the generated agent spec file (yaml); can
+                                     be an absolute or relative path.
+      --prompt-template=<value>      Developer name of a customized prompt template to use instead of the default.
+      --role=<value>                 Role of the agent.
+      --spec=<value>                 Spec file (yaml) to use as input to the command.
+
+GLOBAL FLAGS
+  --flags-dir=<value>  Import flag values from a directory.
+  --json               Format output as json.
+
+DESCRIPTION
+  Generate an agent spec, which is the list of jobs that the agent performs.
+
+  When using Salesforce CLI to create an agent in your org, you can choose to generate a YAML-formatted agent spec file
+  with this command as a first step.
+
+  An agent spec is a list of jobs and descriptions that capture what the agent can do. Use flags such as --role and
+  --company-description to provide details about your company and the role that the agent plays in your company; you can
+  also enter the information interactively if you prefer. When you then execute this command, the large language model
+  (LLM) associated with your org uses the information to generate the list of jobs that the agent most likely performs.
+  We recommend that you provide good details for --role, --company-description, etc, so that the LLM can generate the
+  best and most relevant list of jobs and descriptions. Once generated, you can edit the spec file; for example, you can
+  remove jobs that don't apply to your agent.
+
+  When your agent spec is ready, you then create the agent in your org by specifying the agent spec file to the
+  --job-spec flag of the "agent create" CLI command.
+
+EXAMPLES
+  Create an agent spec for your default org in the default location and use flags to specify the agent's role and your
+  company details:
+
+    $ sf agent generate spec-v2 --type customer --role "Assist users in navigating and managing bookings" \
+      --company-name "Coral Cloud" --company-description "Resort that manages guests and their reservations and \
+      experiences"
+
+  Create an agent spec by being prompted for role and company details interactively; write the generated file to the
+  "specs" directory and use the org with alias "my-org":
+
+    $ sf agent generate spec-v2 --output-dir specs --target-org my-org
+```
+
+_See code: [src/commands/agent/generate/spec-v2.ts](https://github.com/salesforcecli/plugin-agent/blob/1.8.0/src/commands/agent/generate/spec-v2.ts)_
 
 ## `sf agent generate testset`
 
@@ -220,7 +285,7 @@ EXAMPLES
   $ sf agent generate testset
 ```
 
-_See code: [src/commands/agent/generate/testset.ts](https://github.com/salesforcecli/plugin-agent/blob/1.7.2/src/commands/agent/generate/testset.ts)_
+_See code: [src/commands/agent/generate/testset.ts](https://github.com/salesforcecli/plugin-agent/blob/1.8.0/src/commands/agent/generate/testset.ts)_
 
 ## `sf agent preview`
 
@@ -255,7 +320,7 @@ FLAG DESCRIPTIONS
     the API name of the agent? (TBD based on agents library)
 ```
 
-_See code: [src/commands/agent/preview.ts](https://github.com/salesforcecli/plugin-agent/blob/1.7.2/src/commands/agent/preview.ts)_
+_See code: [src/commands/agent/preview.ts](https://github.com/salesforcecli/plugin-agent/blob/1.8.0/src/commands/agent/preview.ts)_
 
 ## `sf agent test cancel`
 
@@ -292,7 +357,7 @@ EXAMPLES
     $ sf agent test cancel --job-id 4KBfake0000003F4AQ --target-org my-org
 ```
 
-_See code: [src/commands/agent/test/cancel.ts](https://github.com/salesforcecli/plugin-agent/blob/1.7.2/src/commands/agent/test/cancel.ts)_
+_See code: [src/commands/agent/test/cancel.ts](https://github.com/salesforcecli/plugin-agent/blob/1.8.0/src/commands/agent/test/cancel.ts)_
 
 ## `sf agent test results`
 
@@ -348,7 +413,7 @@ FLAG DESCRIPTIONS
     test results aren't written.
 ```
 
-_See code: [src/commands/agent/test/results.ts](https://github.com/salesforcecli/plugin-agent/blob/1.7.2/src/commands/agent/test/results.ts)_
+_See code: [src/commands/agent/test/results.ts](https://github.com/salesforcecli/plugin-agent/blob/1.8.0/src/commands/agent/test/results.ts)_
 
 ## `sf agent test resume`
 
@@ -411,7 +476,7 @@ FLAG DESCRIPTIONS
     test results aren't written.
 ```
 
-_See code: [src/commands/agent/test/resume.ts](https://github.com/salesforcecli/plugin-agent/blob/1.7.2/src/commands/agent/test/resume.ts)_
+_See code: [src/commands/agent/test/resume.ts](https://github.com/salesforcecli/plugin-agent/blob/1.8.0/src/commands/agent/test/resume.ts)_
 
 ## `sf agent test run`
 
@@ -474,6 +539,6 @@ FLAG DESCRIPTIONS
     test results aren't written.
 ```
 
-_See code: [src/commands/agent/test/run.ts](https://github.com/salesforcecli/plugin-agent/blob/1.7.2/src/commands/agent/test/run.ts)_
+_See code: [src/commands/agent/test/run.ts](https://github.com/salesforcecli/plugin-agent/blob/1.8.0/src/commands/agent/test/run.ts)_
 
 <!-- commandsstop -->

package.json

@@ -1,7 +1,7 @@
 {
   "name": "@salesforce/plugin-agent",
   "description": "Commands to interact with Salesforce agents",
-  "version": "1.7.2",
+  "version": "1.8.0",
   "author": "Salesforce",
   "bugs": "https://github.com/forcedotcom/cli/issues",
   "dependencies": {