@salesforce/plugin-agent 1.11.0 → 1.12.0

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

@@ -1,26 +0,0 @@
-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

@@ -1,208 +0,0 @@
-/*
- * 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

@@ -1 +0,0 @@
-{"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

@@ -1,29 +0,0 @@
-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

@@ -1,117 +0,0 @@
-/*
- * 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

@@ -1 +0,0 @@
-{"version":3,"file":"spec-v2.js","sourceRoot":"","sources":["../../../../src/commands/agent/generate/spec-v2.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACjE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,KAAK,EAA8C,MAAM,oBAAoB,CAAC;AACvF,OAAO,EACL,sBAAsB,EACtB,SAAS,EACT,aAAa,EACb,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,mBAAmB,CAAC;AAE3B,QAAQ,CAAC,kCAAkC,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC7D,MAAM,QAAQ,GAAG,QAAQ,CAAC,YAAY,CAAC,0BAA0B,EAAE,wBAAwB,CAAC,CAAC;AAQ7F,MAAM,CAAC,OAAO,OAAO,iBAAkB,SAAQ,SAAgC;IACtE,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,CAAC,KAAK,GAAG,MAAM,CAAC;IACtB,MAAM,CAAU,eAAe,GAAG,IAAI,CAAC;IAEvC,MAAM,CAAU,KAAK,GAAG;QAC7B,YAAY,EAAE,KAAK,CAAC,WAAW,EAAE;QACjC,aAAa,EAAE,KAAK,CAAC,aAAa,EAAE;QACpC,GAAG,SAAS,CAAC,sBAAsB,CAAC;QACpC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC;YACf,OAAO,EAAE,QAAQ,CAAC,UAAU,CAAC,oBAAoB,CAAC;YAClD,MAAM,EAAE,IAAI;SACb,CAAC;QACF,aAAa,EAAE,KAAK,CAAC,IAAI,CAAC;YACxB,OAAO,EAAE,QAAQ,CAAC,UAAU,CAAC,2BAA2B,CAAC;YACzD,OAAO,EAAE,IAAI,CAAC,QAAQ,EAAE,gBAAgB,CAAC;SAC1C,CAAC;QACF,YAAY,EAAE,KAAK,CAAC,OAAO,CAAC;YAC1B,OAAO,EAAE,QAAQ,CAAC,UAAU,CAAC,0BAA0B,CAAC;YACxD,GAAG,EAAE,CAAC;SACP,CAAC;QACF,iBAAiB,EAAE,KAAK,CAAC,MAAM,CAAC;YAC9B,OAAO,EAAE,QAAQ,CAAC,UAAU,CAAC,+BAA+B,CAAC;SAC9D,CAAC;QACF,mBAAmB,EAAE,KAAK,CAAC,MAAM,CAAC;YAChC,OAAO,EAAE,QAAQ,CAAC,UAAU,CAAC,iCAAiC,CAAC;YAC/D,SAAS,EAAE,CAAC,iBAAiB,CAAC;SAC/B,CAAC;KACH,CAAC;IAEF,sCAAsC;IAC/B,KAAK,CAAC,GAAG;QACd,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;QAEtD,wEAAwE;QACxE,IAAI,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;YACvB,MAAM,YAAY,GAAG,MAAM,CAAC,OAAO,CAAC,sBAAsB,CAAC;iBACxD,MAAM,CAAC,CAAC,CAAC,GAAG,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,UAAU,IAAI,MAAM,IAAI,MAAM,CAAC,QAAQ,IAAI,CAAC,CAAC,GAAG,IAAI,KAAK,CAAC,CAAC;iBACrF,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC;YAEvB,IAAI,YAAY,CAAC,MAAM,EAAE,CAAC;gBACxB,MAAM,QAAQ,CAAC,WAAW,CAAC,4BAA4B,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACtF,CAAC;QACH,CAAC;QAED,IAAI,CAAC,GAAG,EAAE,CAAC;QACX,IAAI,CAAC,YAAY,CAAC,eAAe,CAAC,CAAC;QAEnC,qCAAqC;QACrC,IAAI,SAAS,GAA4B,EAAE,CAAC;QAC5C,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;YACf,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,CAA4B,CAAC;QAC/F,CAAC;QAED,8DAA8D;QAC9D,MAAM,IAAI,GACR,KAAK,CAAC,IAAI,IAAI,iBAAiB,CAAC,SAAS,EAAE,SAAS,CAAC,IAAI,CAAC,MAAM,aAAa,CAAC,sBAAsB,CAAC,IAAI,CAAC,CAAC,CAAC;QAC9G,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,IAAI,SAAS,EAAE,IAAI,IAAI,CAAC,MAAM,aAAa,CAAC,sBAAsB,CAAC,IAAI,CAAC,CAAC,CAAC;QACjG,MAAM,WAAW,GACf,KAAK,CAAC,cAAc,CAAC,IAAI,SAAS,EAAE,WAAW,IAAI,CAAC,MAAM,aAAa,CAAC,sBAAsB,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;QACnH,MAAM,kBAAkB,GACtB,KAAK,CAAC,qBAAqB,CAAC;YAC5B,SAAS,EAAE,kBAAkB;YAC7B,CAAC,MAAM,aAAa,CAAC,sBAAsB,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;QACvE,MAAM,cAAc,GAClB,KAAK,CAAC,iBAAiB,CAAC;YACxB,SAAS,EAAE,cAAc;YACzB,CAAC,MAAM,aAAa,CAAC,sBAAsB,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC;QAEnE,IAAI,CAAC,GAAG,EAAE,CAAC;QACX,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC;QAE1C,MAAM,UAAU,GAAG,KAAK,CAAC,YAAY,CAAC,CAAC,aAAa,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC;QAC3E,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,UAAU,EAAE,IAAI,CAAC,OAAQ,CAAC,CAAC;QACnD,MAAM,UAAU,GAA+B;YAC7C,SAAS,EAAE,IAA+B;YAC1C,IAAI;YACJ,WAAW;YACX,kBAAkB;SACnB,CAAC;QACF,IAAI,cAAc,EAAE,CAAC;YACnB,UAAU,CAAC,cAAc,GAAG,cAAc,CAAC;QAC7C,CAAC;QACD,MAAM,kBAAkB,GAAG,KAAK,CAAC,iBAAiB,CAAC,IAAI,SAAS,EAAE,kBAAkB,CAAC;QACrF,IAAI,kBAAkB,EAAE,CAAC;YACvB,UAAU,CAAC,kBAAkB,GAAG,kBAAkB,CAAC;YACnD,MAAM,gBAAgB,GAAG,KAAK,CAAC,mBAAmB,CAAC,IAAI,SAAS,EAAE,gBAAgB,CAAC;YACnF,IAAI,gBAAgB,EAAE,CAAC;gBACrB,UAAU,CAAC,gBAAgB,GAAG,gBAAgB,CAAC;YACjD,CAAC;QACH,CAAC;QACD,MAAM,cAAc,GAAG,KAAK,CAAC,YAAY,CAAC,IAAI,iBAAiB,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;QAC3F,IAAI,cAAc,EAAE,CAAC;YACnB,UAAU,CAAC,cAAc,GAAG,cAAc,CAAC;QAC7C,CAAC;QACD,8FAA8F;QAC9F,gGAAgG;QAChG,MAAM,SAAS,GAAG,MAAM,KAAK,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC;QAEvD,MAAM,cAAc,GAAG,aAAa,CAAC,KAAK,CAAC,aAAa,CAAC,EAAE,SAAS,CAAC,CAAC;QAEtE,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;QAEpB,IAAI,CAAC,GAAG,CAAC,uBAAuB,cAAc,EAAE,CAAC,CAAC;QAElD,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,cAAc,EAAE,EAAE,GAAG,SAAS,EAAE,CAAC;IAC5E,CAAC;;AAGH,MAAM,aAAa,GAAG,CAAC,UAAkB,EAAE,SAAyB,EAAU,EAAE;IAC9E,8CAA8C;IAC9C,MAAM,cAAc,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAC3C,SAAS,CAAC,OAAO,CAAC,cAAc,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAExD,gDAAgD;IAChD,aAAa,CAAC,cAAc,EAAE,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC;IAEzD,OAAO,cAAc,CAAC;AACxB,CAAC,CAAC"}

package/messages/agent.create-v2.md

@@ -1,63 +0,0 @@
-# summary
-
-Create an agent in your org using a local agent spec file.
-
-# description
-
-Before you run this command, you must first generate an agent spec file by running the "agent generate spec" CLI command, which outputs a YAML file with the agent properties and list of AI-generated topics. Topics define the range of jobs the agent can handle. Then specify the generated agent spec file to this command using the --spec flag, along with the name (label) of the new agent using the --agent-name flag.
-
-When this command finishes, your org contains the new agent, which you can then edit in the Agent Builder UI. The new agent's topics are the same as the ones listed in the agent spec file. The agent might also have some AI-generated actions. This command also retrieves all the metadata files associated with the new agent to your local Salesforce DX project.
-
-Use the --preview flag to review what the agent looks like without actually saving it in your org. Rather, the command creates a JSON file with all the agent details in the current directory.
-
-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>".
-
-# flags.spec.summary
-
-Path to an agent spec file.
-
-# flags.preview.summary
-
-Preview the agent without saving it in your org.
-
-# flags.agent-name.summary
-
-Name (label) of the new agent.
-
-# flags.agent-api-name.summary
-
-API name of the new agent; if not specified, the API name is derived from the agent name (label); the API name must not exist in the org.
-
-# flags.user-id.summary
-
-ID of a user in your org that is assigned to your agent; determines what your agent can access and do.
-
-# flags.enrich-logs.summary
-
-Adds agent conversation data to event logs so you can view all agent session activity in one place.
-
-# flags.tone.summary
-
-Conversational style of the agent, such as how it expresses your brand personality in its messages through word choice, punctuation, and sentence structure.
-
-# flags.primary-language.summary
-
-Language the agent uses in conversations.
-
-# flags.planner-id.summary
-
-The GenAiPlanner ID to associate with the agent.
-
-# error.missingRequiredFlags
-
-Missing required flags: %s
-
-# examples
-
-- Create an agent called "ResortManager" in an org with alias "my-org" using the specified agent spec file:
-
-  <%= config.bin %> <%= command.id %> --agent-name ResortManager --spec specs/resortManagerAgent.yaml --target-org my-org
-
-- Preview the creation of an agent called "ResortManager" and use your default org:
-
-  <%= config.bin %> <%= command.id %> --agent-name ResortManager --spec specs/resortManagerAgent.yaml --preview

package/messages/agent.generate.spec-v2.md

@@ -1,53 +0,0 @@
-# summary
-
-Generate an agent spec, which is a YAML file that captures what an agent can do.
-
-# description
-
-Before you use Salesforce CLI to create an agent in your org, you must first generate an agent spec with this command. An agent spec is a YAML-formatted file that contains information about the agent, such as its role and company description, and then an AI-generated list of topics based on this information. Topics define the range of jobs your agent can handle.
-
-Use flags, such as --role and --company-description, to provide details about your company and the role that the agent plays in your company. If you prefer, you can also be prompted for the information. Upon command execution, the large language model (LLM) associated with your org uses the information you provided to generate a list of topics for the agent. Because the LLM uses the company and role information to generate the topics, we recommend that you provide accurate and specific details so the LLM generates the best and most relevant topics. Once generated, you can edit the spec file; for example, you can remove topics that don't apply to your agent or change the description of a particular topic.
-
-You can iterate the spec generation process by using the --spec flag to pass an existing agent spec file to this command, and then using the --role, --company-description, etc, flags to refine your agent properties. Iteratively improving the description of your agent allows the LLM to generate progressively better topics.
-
-You can also specify a custom prompt template that the agent uses, and ground the prompt template to add context and personalization to the agent's prompts.
-
-When your agent spec is ready, you then create the agent in your org by running the "agent create" CLI command and specifying the spec with the --spec flag.
-
-# flags.output-file.summary
-
-Path for the generated YAML agent spec file; can be an absolute or relative path.
-
-# flags.max-topics.summary
-
-Maximum number of topics to generate in the agent spec; default is 10.
-
-# flags.prompt-template.summary
-
-API name of a customized prompt template to use instead of the default prompt template.
-
-# flags.grounding-context.summary
-
-Context information and personalization that's added to your prompts when using a custom prompt template.
-
-# flags.spec.summary
-
-Agent spec file, in YAML format, to use as input to the command.
-
-# examples
-
-- Generate an agent spec in the default location and use flags to specify the agent properties, such as its role and your company details; use your default org:
-
-  <%= config.bin %> <%= command.id %> --type customer --role "Field customer complaints and manage employee schedules." --company-name "Coral Cloud Resorts" --company-description "Provide customers with exceptional destination activities, unforgettable experiences, and reservation services."
-
-- Generate an agent spec by being prompted for the required agent properties and generate a maxiumum of 5 topics; write the generated file to the "specs/resortManagerSpec.yaml" file and use the org with alias "my-org":
-
-  <%= config.bin %> <%= command.id %> --max-topics 5 --output-file specs/resortManagerAgent.yaml --target-org my-org
-
-- Specify an existing agent spec file called "specs/resortManagerAgent.yaml", and then overwrite it with a new version that contains newly AI-generated topics based on the updated role information passed in with the --role flag:
-
-  <%= config.bin %> <%= command.id %> --spec specs/resortManagerAgent.yaml --output-file specs/resortManagerAgent.yaml --role "Field customer complaints, manage employee schedules, and ensure all resort operations are running smoothly" --target-org my-org
-
-# error.missingRequiredFlags
-
-Missing required flags: %s

package/schemas/agent-create__v2.json

@@ -1,21 +0,0 @@
-{
-  "$schema": "http://json-schema.org/draft-07/schema#",
-  "$ref": "#/definitions/AgentCreateResult",
-  "definitions": {
-    "AgentCreateResult": {
-      "type": "object",
-      "properties": {
-        "isSuccess": {
-          "type": "boolean"
-        },
-        "errorMessage": {
-          "type": "string"
-        }
-      },
-      "required": [
-        "isSuccess"
-      ],
-      "additionalProperties": false
-    }
-  }
-}

package/schemas/agent-generate-spec__v2.json

@@ -1,85 +0,0 @@
-{
-  "$schema": "http://json-schema.org/draft-07/schema#",
-  "$ref": "#/definitions/AgentCreateSpecResult",
-  "definitions": {
-    "AgentCreateSpecResult": {
-      "type": "object",
-      "additionalProperties": false,
-      "properties": {
-        "topics": {
-          "$ref": "#/definitions/DraftAgentTopics"
-        },
-        "agentType": {
-          "type": "string",
-          "enum": [
-            "customer",
-            "internal"
-          ],
-          "description": "Internal type is copilots; used by customers' employees. Customer type is agents; used by customers' customers."
-        },
-        "role": {
-          "type": "string"
-        },
-        "companyName": {
-          "type": "string"
-        },
-        "companyDescription": {
-          "type": "string"
-        },
-        "companyWebsite": {
-          "type": "string"
-        },
-        "maxNumOfTopics": {
-          "type": "number",
-          "description": "The maximum number of topics to create in the spec. Default is 10."
-        },
-        "promptTemplateName": {
-          "type": "string",
-          "description": "Developer name of the prompt template."
-        },
-        "groundingContext": {
-          "type": "string",
-          "description": "Context info to be used in customized prompt template"
-        },
-        "isSuccess": {
-          "type": "boolean"
-        },
-        "errorMessage": {
-          "type": "string"
-        },
-        "specPath": {
-          "type": "string"
-        }
-      },
-      "required": [
-        "agentType",
-        "companyDescription",
-        "companyName",
-        "isSuccess",
-        "role",
-        "topics"
-      ]
-    },
-    "DraftAgentTopics": {
-      "type": "array",
-      "items": {
-        "type": "object",
-        "properties": {
-          "name": {
-            "type": "string"
-          },
-          "description": {
-            "type": "string"
-          }
-        },
-        "required": [
-          "name",
-          "description"
-        ],
-        "additionalProperties": false
-      },
-      "minItems": 1,
-      "maxItems": 1
-    }
-  }
-}