@salesforce/plugin-agent 1.7.3-dev.5 → 1.9.2

package/README.md

@@ -62,7 +62,9 @@ sf plugins
 <!-- commands -->
 
 - [`sf agent create`](#sf-agent-create)
+- [`sf agent create-v2`](#sf-agent-create-v2)
 - [`sf agent generate spec`](#sf-agent-generate-spec)
+- [`sf agent generate spec-v2`](#sf-agent-generate-spec-v2)
 - [`sf agent generate test-cases`](#sf-agent-generate-test-cases)
 - [`sf agent generate test-definition`](#sf-agent-generate-test-definition)
 - [`sf agent preview`](#sf-agent-preview)
@@ -111,7 +113,58 @@ 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.3-dev.5/src/commands/agent/create.ts)_
+_See code: [src/commands/agent/create.ts](https://github.com/salesforcecli/plugin-agent/blob/1.9.2/src/commands/agent/create.ts)_
+
+## `sf agent create-v2`
+
+Create an agent in your org from a local agent spec file.
+
+```
+USAGE
+  $ sf agent create-v2 -o <value> --spec <value> [--json] [--flags-dir <value>] [--api-version <value>] [--agent-name
+    <value>] [--user-id <value>] [--enrich-logs true|false] [--tone formal|casual|neutral] [--preview] [--planner-id
+    <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.
+      --agent-name=<value>    Name for the new agent.
+      --api-version=<value>   Override the api version used for api requests made by this command
+      --enrich-logs=<option>  Adds agent conversation data to event logs.
+                              <options: true|false>
+      --planner-id=<value>    The GenAiPlanner ID to associate with the agent.
+      --preview               Preview the agent without saving in your org.
+      --spec=<value>          (required) Path to an agent spec file.
+      --tone=<option>         Conversational style of agent responses.
+                              <options: formal|casual|neutral>
+      --user-id=<value>       Custom user ID for the agent.
+
+GLOBAL FLAGS
+  --flags-dir=<value>  Import flag values from a directory.
+  --json               Format output as json.
+
+DESCRIPTION
+  Create an agent in your org from a local agent spec file.
+
+  To generate an agent spec file, run the "agent generate spec" CLI command, which outputs a YAML file with the list of
+  jobs and descriptions that the new agent can perform. Then specify this generated spec file to the --spec flag of this
+  command, along with the name of the new agent.
+
+  When this command finishes, your org contains the new agent, which you can then edit in the Agent Builder UI. The new
+  agent already has a list of topics and actions that were automatically created from the list of jobs in the provided
+  agent spec file. This command also retrieves all the metadata files associated with the new agent to your local DX
+  project.
+
+  To open the new agent in your org's Agent Builder UI, run this command: "sf org open agent --name
+  <api-name-of-your-agent>".
+
+EXAMPLES
+  Create an agent called "CustomerSupportAgent" in an org with alias "my-org" using the specified agent spec file:
+
+    $ sf agent create-v2 --name CustomerSupportAgent --spec ./config/agentSpec.json --target-org my-org
+```
+
+_See code: [src/commands/agent/create-v2.ts](https://github.com/salesforcecli/plugin-agent/blob/1.9.2/src/commands/agent/create-v2.ts)_
 
 ## `sf agent generate spec`
 
@@ -172,7 +225,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.3-dev.5/src/commands/agent/generate/spec.ts)_
+_See code: [src/commands/agent/generate/spec.ts](https://github.com/salesforcecli/plugin-agent/blob/1.9.2/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.9.2/src/commands/agent/generate/spec-v2.ts)_
 
 ## `sf agent generate test-cases`
 
@@ -195,7 +312,7 @@ EXAMPLES
   $ sf agent generate test-cases
 ```
 
-_See code: [src/commands/agent/generate/test-cases.ts](https://github.com/salesforcecli/plugin-agent/blob/1.7.3-dev.5/src/commands/agent/generate/test-cases.ts)_
+_See code: [src/commands/agent/generate/test-cases.ts](https://github.com/salesforcecli/plugin-agent/blob/1.9.2/src/commands/agent/generate/test-cases.ts)_
 
 ## `sf agent generate test-definition`
 
@@ -220,7 +337,7 @@ EXAMPLES
   $ sf agent generate test-definition
 ```
 
-_See code: [src/commands/agent/generate/test-definition.ts](https://github.com/salesforcecli/plugin-agent/blob/1.7.3-dev.5/src/commands/agent/generate/test-definition.ts)_
+_See code: [src/commands/agent/generate/test-definition.ts](https://github.com/salesforcecli/plugin-agent/blob/1.9.2/src/commands/agent/generate/test-definition.ts)_
 
 ## `sf agent preview`
 
@@ -255,7 +372,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.3-dev.5/src/commands/agent/preview.ts)_
+_See code: [src/commands/agent/preview.ts](https://github.com/salesforcecli/plugin-agent/blob/1.9.2/src/commands/agent/preview.ts)_
 
 ## `sf agent test cancel`
 
@@ -292,7 +409,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.3-dev.5/src/commands/agent/test/cancel.ts)_
+_See code: [src/commands/agent/test/cancel.ts](https://github.com/salesforcecli/plugin-agent/blob/1.9.2/src/commands/agent/test/cancel.ts)_
 
 ## `sf agent test results`
 
@@ -348,7 +465,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.3-dev.5/src/commands/agent/test/results.ts)_
+_See code: [src/commands/agent/test/results.ts](https://github.com/salesforcecli/plugin-agent/blob/1.9.2/src/commands/agent/test/results.ts)_
 
 ## `sf agent test resume`
 
@@ -411,7 +528,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.3-dev.5/src/commands/agent/test/resume.ts)_
+_See code: [src/commands/agent/test/resume.ts](https://github.com/salesforcecli/plugin-agent/blob/1.9.2/src/commands/agent/test/resume.ts)_
 
 ## `sf agent test run`
 
@@ -474,6 +591,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.3-dev.5/src/commands/agent/test/run.ts)_
+_See code: [src/commands/agent/test/run.ts](https://github.com/salesforcecli/plugin-agent/blob/1.9.2/src/commands/agent/test/run.ts)_
 
 <!-- commandsstop -->

package/lib/commands/agent/create-v2.d.ts

@@ -0,0 +1,26 @@
+import { SfCommand } from '@salesforce/sf-plugins-core';
+export type AgentCreateResult = {
+    isSuccess: boolean;
+    errorMessage?: string;
+};
+export default class AgentCreateV2 extends SfCommand<AgentCreateResult> {
+    static readonly summary: string;
+    static readonly description: string;
+    static readonly examples: string[];
+    static readonly requiresProject = true;
+    static state: string;
+    static readonly flags: {
+        spec: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        preview: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'agent-api-name': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'primary-language': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        'planner-id': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        "agent-name": import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        "user-id": import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        "enrich-logs": import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        tone: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'target-org': import("@oclif/core/interfaces").OptionFlag<import("@salesforce/core").Org, import("@oclif/core/interfaces").CustomOptions>;
+        'api-version': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<AgentCreateResult>;
+}

package/lib/commands/agent/create-v2.js

@@ -0,0 +1,202 @@
+/*
+ * Copyright (c) 2024, salesforce.com, inc.
+ * All rights reserved.
+ * Licensed under the BSD 3-Clause license.
+ * For full license text, see LICENSE.txt file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+import { resolve } from 'node:path';
+import { readFileSync, writeFileSync } from 'node:fs';
+import YAML from 'yaml';
+import { SfCommand, Flags } from '@salesforce/sf-plugins-core';
+import { Lifecycle, Messages } from '@salesforce/core';
+import { MultiStageOutput } from '@oclif/multi-stage-output';
+import { colorize } from '@oclif/core/ux';
+import { Agent, AgentCreateLifecycleStagesV2 } from '@salesforce/agents';
+import { makeFlags, promptForFlag, validateAgentType } from '../../flags.js';
+Messages.importMessagesDirectoryFromMetaUrl(import.meta.url);
+const messages = Messages.loadMessages('@salesforce/plugin-agent', 'agent.create-v2');
+const MSO_STAGES = {
+    parse: 'Parsing Agent spec',
+    preview: 'Creating Agent for preview',
+    create: 'Creating Agent in org',
+    retrieve: 'Retrieving Agent metadata',
+};
+const FLAGGABLE_PROMPTS = {
+    'agent-name': {
+        message: messages.getMessage('flags.agent-name.summary'),
+        validate: (d) => d.length > 0 || 'Agent Name cannot be empty',
+        required: true,
+    },
+    'user-id': {
+        message: messages.getMessage('flags.user-id.summary'),
+        validate: (d) => {
+            // Allow empty string
+            if (d.length === 0)
+                return true;
+            if (d.length === 15 || d.length === 18) {
+                if (d.startsWith('005')) {
+                    return true;
+                }
+            }
+            return 'Please enter a valid User ID (005 prefix)';
+        }
+    },
+    'enrich-logs': {
+        message: messages.getMessage('flags.enrich-logs.summary'),
+        validate: () => true,
+        options: ['true', 'false'],
+        default: 'false',
+    },
+    tone: {
+        message: messages.getMessage('flags.tone.summary'),
+        validate: () => true,
+        options: ['formal', 'casual', 'neutral'],
+        default: 'casual',
+    },
+};
+export default class AgentCreateV2 extends SfCommand {
+    static summary = messages.getMessage('summary');
+    static description = messages.getMessage('description');
+    static examples = messages.getMessages('examples');
+    static requiresProject = true;
+    static state = 'beta';
+    static flags = {
+        'target-org': Flags.requiredOrg(),
+        'api-version': Flags.orgApiVersion(),
+        ...makeFlags(FLAGGABLE_PROMPTS),
+        spec: Flags.file({
+            // char: 'f',
+            summary: messages.getMessage('flags.spec.summary'),
+            exists: true,
+            required: true,
+        }),
+        preview: Flags.boolean({
+            summary: messages.getMessage('flags.preview.summary'),
+        }),
+        // Currently hidden; Do we even want to expose this?
+        'agent-api-name': Flags.string({
+            summary: messages.getMessage('flags.agent-api-name.summary'),
+            hidden: true,
+        }),
+        // Currently hidden because only 'en_US' is supported
+        'primary-language': Flags.string({
+            summary: messages.getMessage('flags.primary-language.summary'),
+            options: ['en_US'],
+            default: 'en_US',
+            hidden: true,
+        }),
+        // Seems a very uncommon usecase, but it's possible to do it in the server side API
+        'planner-id': Flags.string({
+            summary: messages.getMessage('flags.planner-id.summary'),
+        }),
+    };
+    // eslint-disable-next-line complexity
+    async run() {
+        const { flags } = await this.parse(AgentCreateV2);
+        // throw error if --json is used and not all required flags are provided
+        if (this.jsonEnabled()) {
+            if (!flags.preview && !flags['agent-name']) {
+                throw messages.createError('error.missingRequiredFlags', ['agent-name']);
+            }
+        }
+        // Read the agent spec and validate
+        const inputSpec = YAML.parse(readFileSync(resolve(flags.spec), 'utf8'));
+        validateSpec(inputSpec);
+        // If we're saving the agent and we don't have flag values, prompt.
+        let agentName = flags['agent-name'];
+        let userId = flags['user-id'];
+        let enrichLogs = flags['enrich-logs'];
+        let tone = flags.tone;
+        if (!this.jsonEnabled() && !flags.preview) {
+            agentName ??= await promptForFlag(FLAGGABLE_PROMPTS['agent-name']);
+            userId ??= await promptForFlag(FLAGGABLE_PROMPTS['user-id']);
+            enrichLogs ??= await promptForFlag(FLAGGABLE_PROMPTS['enrich-logs']);
+            tone ??= await promptForFlag(FLAGGABLE_PROMPTS.tone);
+        }
+        let title;
+        const stages = [MSO_STAGES.parse];
+        if (flags.preview) {
+            title = 'Previewing Agent Creation';
+            stages.push(MSO_STAGES.preview);
+        }
+        else {
+            title = `Creating ${agentName} Agent`;
+            stages.push(MSO_STAGES.create);
+            stages.push(MSO_STAGES.retrieve);
+        }
+        const mso = new MultiStageOutput({
+            jsonEnabled: this.jsonEnabled(),
+            title,
+            stages,
+        });
+        mso.goto(MSO_STAGES.parse);
+        // @ts-expect-error not using async method in callback
+        Lifecycle.getInstance().on(AgentCreateLifecycleStagesV2.Previewing, () => mso.goto(MSO_STAGES.preview));
+        // @ts-expect-error not using async method in callback
+        Lifecycle.getInstance().on(AgentCreateLifecycleStagesV2.Creating, () => mso.goto(MSO_STAGES.create));
+        // @ts-expect-error not using async method in callback
+        Lifecycle.getInstance().on(AgentCreateLifecycleStagesV2.Retrieving, () => mso.goto(MSO_STAGES.retrieve));
+        const connection = flags['target-org'].getConnection(flags['api-version']);
+        const agent = new Agent(connection, this.project);
+        const agentConfig = {
+            agentType: inputSpec.agentType,
+            generationInfo: {
+                defaultInfo: {
+                    role: inputSpec.role,
+                    companyName: inputSpec.companyName,
+                    companyDescription: inputSpec.companyDescription,
+                    preDefinedTopics: inputSpec.topics,
+                }
+            },
+            generationSettings: {},
+        };
+        if (inputSpec?.companyWebsite) {
+            agentConfig.generationInfo.defaultInfo.companyWebsite = inputSpec?.companyWebsite;
+        }
+        if (!flags.preview) {
+            agentConfig.saveAgent = true;
+            agentConfig.agentSettings = {
+                agentName: agentName,
+            };
+            if (flags['agent-api-name']) {
+                agentConfig.agentSettings.agentApiName = flags['agent-api-name'];
+            }
+            if (flags['planner-id']) {
+                agentConfig.agentSettings.plannerId = flags['planner-id'];
+            }
+            if (flags['user-id']) {
+                agentConfig.agentSettings.userId = userId;
+            }
+            agentConfig.agentSettings.enrichLogs = Boolean(enrichLogs);
+            agentConfig.agentSettings.tone = tone;
+        }
+        const response = await agent.createV2(agentConfig);
+        mso.stop();
+        if (response.isSuccess) {
+            if (!flags.preview) {
+                this.log(colorize('green', `Successfully created ${agentName} in ${flags['target-org'].getUsername() ?? 'the target org'}.`));
+                this.log(`Use ${colorize('dim', `sf org open agent --name ${agentName}`)} to view the agent in the browser.`);
+            }
+            else {
+                const previewFileName = `agentPreview_${new Date().toISOString()}.json`;
+                writeFileSync(previewFileName, JSON.stringify(response, null, 2));
+                this.log(colorize('green', `Successfully created agent for preview. See ${previewFileName}`));
+            }
+        }
+        else {
+            this.log(colorize('red', `failed to create agent: ${response.errorMessage ?? ''}`));
+        }
+        return response;
+    }
+}
+// The spec must define: agentType, role, companyName, companyDescription, and topics.
+// Agent type must be 'customer' or 'internal'.
+const validateSpec = (spec) => {
+    const requiredSpecValues = ['agentType', 'role', 'companyName', 'companyDescription', 'topics'];
+    const missingFlags = requiredSpecValues.filter(f => !spec[f]);
+    if (missingFlags.length) {
+        throw messages.createError('error.missingRequiredFlags', [missingFlags.join(', ')]);
+    }
+    validateAgentType(spec.agentType, true);
+};
+//# sourceMappingURL=create-v2.js.map

package/lib/commands/agent/create-v2.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-v2.js","sourceRoot":"","sources":["../../../src/commands/agent/create-v2.ts"],"names":[],"mappings":"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"}

package/lib/commands/agent/generate/spec-v2.d.ts

@@ -0,0 +1,29 @@
+import { SfCommand } from '@salesforce/sf-plugins-core';
+import { AgentJobSpecV2 } from '@salesforce/agents';
+export type AgentCreateSpecResult = {
+    isSuccess: boolean;
+    errorMessage?: string;
+    specPath?: string;
+} & AgentJobSpecV2;
+export default class AgentCreateSpecV2 extends SfCommand<AgentCreateSpecResult> {
+    static readonly summary: string;
+    static readonly description: string;
+    static readonly examples: string[];
+    static state: string;
+    static readonly requiresProject = true;
+    static readonly flags: {
+        spec: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'output-file': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        'max-topics': import("@oclif/core/interfaces").OptionFlag<number | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'prompt-template': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'grounding-context': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        type: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        role: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        "company-name": import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        "company-description": import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        "company-website": import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'target-org': import("@oclif/core/interfaces").OptionFlag<import("@salesforce/core").Org, import("@oclif/core/interfaces").CustomOptions>;
+        'api-version': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<AgentCreateSpecResult>;
+}

package/lib/commands/agent/generate/spec-v2.js

@@ -0,0 +1,117 @@
+/*
+ * Copyright (c) 2024, salesforce.com, inc.
+ * All rights reserved.
+ * Licensed under the BSD 3-Clause license.
+ * For full license text, see LICENSE.txt file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+import { join, resolve, dirname } from 'node:path';
+import { mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { SfCommand, Flags } from '@salesforce/sf-plugins-core';
+import { Messages } from '@salesforce/core';
+import YAML from 'yaml';
+import { Agent } from '@salesforce/agents';
+import { FLAGGABLE_SPEC_PROMPTS, makeFlags, promptForFlag, validateAgentType, validateMaxTopics } from '../../../flags.js';
+Messages.importMessagesDirectoryFromMetaUrl(import.meta.url);
+const messages = Messages.loadMessages('@salesforce/plugin-agent', 'agent.generate.spec-v2');
+export default class AgentCreateSpecV2 extends SfCommand {
+    static summary = messages.getMessage('summary');
+    static description = messages.getMessage('description');
+    static examples = messages.getMessages('examples');
+    static state = 'beta';
+    static requiresProject = true;
+    static flags = {
+        'target-org': Flags.requiredOrg(),
+        'api-version': Flags.orgApiVersion(),
+        ...makeFlags(FLAGGABLE_SPEC_PROMPTS),
+        spec: Flags.file({
+            summary: messages.getMessage('flags.spec.summary'),
+            exists: true,
+        }),
+        'output-file': Flags.file({
+            summary: messages.getMessage('flags.output-file.summary'),
+            default: join('config', 'agentSpec.yaml'),
+        }),
+        'max-topics': Flags.integer({
+            summary: messages.getMessage('flags.max-topics.summary'),
+            min: 1,
+        }),
+        'prompt-template': Flags.string({
+            summary: messages.getMessage('flags.prompt-template.summary'),
+        }),
+        'grounding-context': Flags.string({
+            summary: messages.getMessage('flags.grounding-context.summary'),
+            dependsOn: ['prompt-template'],
+        }),
+    };
+    // eslint-disable-next-line complexity
+    async run() {
+        const { flags } = await this.parse(AgentCreateSpecV2);
+        // throw error if --json is used and not all required flags are provided
+        if (this.jsonEnabled()) {
+            const missingFlags = Object.entries(FLAGGABLE_SPEC_PROMPTS)
+                .filter(([key, prompt]) => 'required' in prompt && prompt.required && !(key in flags))
+                .map(([key]) => key);
+            if (missingFlags.length) {
+                throw messages.createError('error.missingRequiredFlags', [missingFlags.join(', ')]);
+            }
+        }
+        this.log();
+        this.styledHeader('Agent Details');
+        // If spec is provided, read it first
+        let inputSpec = {};
+        if (flags.spec) {
+            inputSpec = YAML.parse(readFileSync(resolve(flags.spec), 'utf8'));
+        }
+        // Flags override inputSpec values.  Prompt if neither is set.
+        const type = flags.type ?? validateAgentType(inputSpec?.agentType) ?? (await promptForFlag(FLAGGABLE_SPEC_PROMPTS.type));
+        const role = flags.role ?? inputSpec?.role ?? (await promptForFlag(FLAGGABLE_SPEC_PROMPTS.role));
+        const companyName = flags['company-name'] ?? inputSpec?.companyName ?? (await promptForFlag(FLAGGABLE_SPEC_PROMPTS['company-name']));
+        const companyDescription = flags['company-description'] ??
+            inputSpec?.companyDescription ??
+            (await promptForFlag(FLAGGABLE_SPEC_PROMPTS['company-description']));
+        const companyWebsite = flags['company-website'] ??
+            inputSpec?.companyWebsite ??
+            (await promptForFlag(FLAGGABLE_SPEC_PROMPTS['company-website']));
+        this.log();
+        this.spinner.start('Creating agent spec');
+        const connection = flags['target-org'].getConnection(flags['api-version']);
+        const agent = new Agent(connection, this.project);
+        const specConfig = {
+            agentType: type,
+            role,
+            companyName,
+            companyDescription,
+        };
+        if (companyWebsite) {
+            specConfig.companyWebsite = companyWebsite;
+        }
+        const promptTemplateName = flags['prompt-template'] ?? inputSpec?.promptTemplateName;
+        if (promptTemplateName) {
+            specConfig.promptTemplateName = promptTemplateName;
+            const groundingContext = flags['grounding-context'] ?? inputSpec?.groundingContext;
+            if (groundingContext) {
+                specConfig.groundingContext = groundingContext;
+            }
+        }
+        const maxNumOfTopics = flags['max-topics'] ?? validateMaxTopics(inputSpec?.maxNumOfTopics);
+        if (maxNumOfTopics) {
+            specConfig.maxNumOfTopics = maxNumOfTopics;
+        }
+        // Should we log the specConfig being used?  It's returned in the JSON and the generated spec.
+        // this.log(`${ansis.green(figures.tick)} ${ansis.bold(message)} ${ansis.cyan(valueFromFlag)}`);
+        const agentSpec = await agent.createSpecV2(specConfig);
+        const outputFilePath = writeSpecFile(flags['output-file'], agentSpec);
+        this.spinner.stop();
+        this.log(`\nSaved agent spec: ${outputFilePath}`);
+        return { ...{ isSuccess: true, specPath: outputFilePath }, ...agentSpec };
+    }
+}
+const writeSpecFile = (outputFile, agentSpec) => {
+    // create the directory if not already created
+    const outputFilePath = resolve(outputFile);
+    mkdirSync(dirname(outputFilePath), { recursive: true });
+    // Write a yaml file with the returned job specs
+    writeFileSync(outputFilePath, YAML.stringify(agentSpec));
+    return outputFilePath;
+};
+//# sourceMappingURL=spec-v2.js.map

package/lib/commands/agent/generate/spec-v2.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-v2.js","sourceRoot":"","sources":["../../../../src/commands/agent/generate/spec-v2.ts"],"names":[],"mappings":"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"}

package/lib/commands/agent/generate/test-definition.js

@@ -24,7 +24,7 @@ export default class AgentGenerateTestDefinition extends SfCommand {
         const testSets = (await readDir(testSetDir)).map((testSet) => testSet.replace('.aiEvaluationTestSet-meta.xml', ''));
         if (testSets.length === 0) {
             throw new SfError(`No test sets found in ${testSetDir}`, 'NoTestSetsFoundError', [
-                'Run the "sf agent generate testset" command to create a test set',
+                'Run the "sf agent generate test-cases" command to create a test set',
             ]);
         }
         const botsDir = join('force-app', 'main', 'default', 'bots');

package/lib/commands/agent/generate/test-definition.js.map

@@ -1 +1 @@
-{"version":3,"file":"test-definition.js","sourceRoot":"","sources":["../../../../src/commands/agent/generate/test-definition.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AACxD,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,KAAK,EAAE,MAAM,4BAA4B,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAE/C,QAAQ,CAAC,kCAAkC,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC7D,MAAM,QAAQ,GAAG,QAAQ,CAAC,YAAY,CAAC,0BAA0B,EAAE,gCAAgC,CAAC,CAAC;AAErG,MAAM,CAAC,OAAO,OAAO,2BAA4B,SAAQ,SAAe;IAC/D,MAAM,CAAU,OAAO,GAAG,QAAQ,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;IACzD,MAAM,CAAU,WAAW,GAAG,QAAQ,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;IACjE,MAAM,CAAU,QAAQ,GAAG,QAAQ,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;IAC5D,MAAM,CAAU,cAAc,GAAG,KAAK,CAAC;IACvC,MAAM,CAAU,KAAK,GAAG,MAAM,CAAC;IAE/B,KAAK,CAAC,GAAG;QACd,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,sBAAsB,CAAC,CAAC;QAChF,MAAM,QAAQ,GAAG,CAAC,MAAM,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,+BAA+B,EAAE,EAAE,CAAC,CAAC,CAAC;QACpH,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,OAAO,CAAC,yBAAyB,UAAU,EAAE,EAAE,sBAAsB,EAAE;gBAC/E,kEAAkE;aACnE,CAAC,CAAC;QACL,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;QAC7D,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;QACpC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtB,MAAM,IAAI,OAAO,CAAC,sBAAsB,OAAO,EAAE,EAAE,oBAAoB,CAAC,CAAC;QAC3E,CAAC;QAED,MAAM,WAAW,GAAG,MAAM,MAAM,CAAS;YACvC,OAAO,EAAE,sBAAsB;YAC/B,OAAO,EAAE,CAAC,OAAO,CAAC;YAClB,KAAK;SACN,CAAC,CAAC;QAEH,MAAM,KAAK,GAAG,MAAM,MAAM,CAAS;YACjC,OAAO,EAAE,0BAA0B;YACnC,OAAO,EAAE,IAAI;YACb,KAAK;SACN,CAAC,CAAC;QAEH,MAAM,OAAO,GAAG,MAAM,MAAM,CAAS;YACnC,OAAO,EAAE,4BAA4B;YACrC,OAAO,EAAE,QAAQ;YACjB,KAAK;SACN,CAAC,CAAC;QAEH,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC;YACvB,OAAO,EAAE,sCAAsC;YAC/C,QAAQ,EAAE,CAAC,CAAS,EAAoB,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,sBAAsB,CAAC;YACzF,KAAK;SACN,CAAC,CAAC;QAEH,MAAM,WAAW,GAAG,MAAM,KAAK,CAAC;YAC9B,OAAO,EAAE,oDAAoD;YAC7D,KAAK;SACN,CAAC,CAAC;QAEH,MAAM,GAAG,GAAG;;MAEV,WAAW,CAAC,CAAC,CAAC,gBAAgB,WAAW,gBAAgB,CAAC,CAAC,CAAC,EAAE;YACxD,IAAI;mBACG,WAAW;mBACX,KAAK;mBACL,OAAO;0BACA,CAAC;QAEvB,yBAAyB;QACzB,MAAM,UAAU,GAAG,GAAG,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;QAEnD,MAAM,cAAc,GAAG,IAAI,CACzB,WAAW,EACX,MAAM,EACN,SAAS,EACT,yBAAyB,EACzB,GAAG,IAAI,kCAAkC,CAC1C,CAAC;QACF,MAAM,KAAK,CAAC,OAAO,CAAC,cAAc,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC1D,IAAI,CAAC,GAAG,EAAE,CAAC;QACX,IAAI,CAAC,GAAG,CAAC,WAAW,cAAc,EAAE,CAAC,CAAC;QACtC,MAAM,SAAS,CAAC,cAAc,EAAE,UAAU,CAAC,CAAC;IAC9C,CAAC"}
+{"version":3,"file":"test-definition.js","sourceRoot":"","sources":["../../../../src/commands/agent/generate/test-definition.ts"],"names":[],"mappings":"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"}