@salesforce/plugin-agent 1.32.0 → 1.32.2-dev.0

package/lib/commands/agent/generate/template.d.ts

@@ -1,8 +1,15 @@
 import { SfCommand } from '@salesforce/sf-plugins-core';
-import type { BotTemplate, GenAiPlanner, BotDialogGroup, ConversationDefinitionGoal, ConversationVariable } from '@salesforce/types/metadata';
+import type { Connection } from '@salesforce/core';
+import type { BotTemplate, GenAiPlannerBundle, BotDialogGroup, ConversationDefinitionGoal, ConversationVariable, GenAiFunction, GenAiPlugin, GenAiPlannerFunctionDef } from '@salesforce/types/metadata';
+/** Global function names that are allowed to be emitted in genAiFunctions when converting localActionLinks. */
+export declare const ALLOWED_GLOBAL_FUNCTIONS: Set<string>;
 export type GenAiPlannerBundleExt = {
-    GenAiPlannerBundle: GenAiPlanner & {
+    GenAiPlannerBundle: GenAiPlannerBundle & {
         botTemplate?: string;
+        localActionLinks?: GenAiPlannerFunctionDef[];
+        localTopicLinks: GenAiPlannerFunctionDef[];
+        localTopics?: GenAiPlugin[];
+        plannerActions?: GenAiFunction[];
     };
 };
 export type BotTemplateExt = {
@@ -28,8 +35,44 @@ export default class AgentGenerateTemplate extends SfCommand<AgentGenerateTempla
     static readonly requiresProject = true;
     static readonly flags: {
         'api-version': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'source-org': import("@oclif/core/interfaces").OptionFlag<import("@salesforce/core").Org, import("@oclif/core/interfaces").CustomOptions>;
         'agent-version': import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
         'agent-file': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        'output-dir': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };
     run(): Promise<AgentGenerateTemplateResult>;
 }
+/**
+ * Extracts local topics and actions from the GenAiPlannerBundle and validates that each has a `source` reference to its global counterpart.
+ * Throws if any local topic or action is missing `source`.
+ *
+ * @param genAiPlannerBundleMetaJson - The GenAiPlannerBundle metadata to read from
+ * @returns { localTopics, localActions } - The local topics and the flattened local actions from all plugins
+ */
+export declare const getLocalAssets: (genAiPlannerBundleMetaJson: GenAiPlannerBundleExt) => {
+    localTopics: GenAiPlugin[];
+    localActions: GenAiFunction[];
+};
+/**
+ * Uses localTopics' <source> elements to identify global assets, then updates topic links (genAiPlugins), action links (genAiFunctions), attributeMappings and ruleExpressionAssignments.
+ * Replaces localTopicLinks with genAiPlugins. Replaces localActionLinks with genAiFunctions.
+ */
+export declare const replaceReferencesToGlobalAssets: (genAiPlannerBundleMetaJson: GenAiPlannerBundleExt, localTopics: GenAiPlugin[]) => void;
+/** Tooling API row for GenAiPluginDefinition or GenAiFunctionDefinition (shared field shape). */
+export type GenAiBundledAssetToolingRecord = {
+    Id: string;
+    DeveloperName: string;
+    NamespacePrefix: string | null;
+    IsLocal: boolean;
+    Source: string | null;
+};
+/**
+ * Validates that local topics and actions reference global assets that exist in the source org.
+ *
+ * @param localTopics - Local genAiPlugin topics (GenAiPluginDefinition)
+ * @param localActions - Local genAiFunction actions (GenAiFunctionDefinition)
+ * @param connection - Source org connection (--source-org)
+ * @param namespaceFromSfdxProject - `namespace` from sfdx-project.json (empty if unset)
+ * @param warn - Command warn hook (e.g. `(msg) => this.warn(msg)`)
+ */
+export declare const validateGlobalAssets: (localTopics: GenAiPlugin[], localActions: GenAiFunction[], connection: Connection, namespaceFromSfdxProject: string, warn: (msg: string) => void) => Promise<void>;

package/lib/commands/agent/generate/template.js

@@ -14,10 +14,12 @@
  * limitations under the License.
  */
 import { join, dirname, basename, resolve } from 'node:path';
-import { mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { cpSync, existsSync, mkdirSync, readFileSync, statSync, writeFileSync } from 'node:fs';
 import { SfCommand, Flags } from '@salesforce/sf-plugins-core';
-import { Messages, SfError } from '@salesforce/core';
+import { Messages, SfError, validateSalesforceId } from '@salesforce/core';
 import { XMLParser, XMLBuilder } from 'fast-xml-parser';
+/** Global function names that are allowed to be emitted in genAiFunctions when converting localActionLinks. */
+export const ALLOWED_GLOBAL_FUNCTIONS = new Set(['EmployeeCopilot__AnswerQuestionsWithKnowledge']);
 Messages.importMessagesDirectoryFromMetaUrl(import.meta.url);
 const messages = Messages.loadMessages('@salesforce/plugin-agent', 'agent.generate.template');
 export default class AgentGenerateTemplate extends SfCommand {
@@ -27,6 +29,9 @@ export default class AgentGenerateTemplate extends SfCommand {
     static requiresProject = true;
     static flags = {
         'api-version': Flags.orgApiVersion(),
+        'source-org': Flags.requiredOrg({
+            summary: messages.getMessage('flags.source-org.summary'),
+        }),
         'agent-version': Flags.integer({
             summary: messages.getMessage('flags.agent-version.summary'),
             required: true,
@@ -37,10 +42,14 @@ export default class AgentGenerateTemplate extends SfCommand {
             required: true,
             exists: true,
         }),
+        'output-dir': Flags.directory({
+            summary: messages.getMessage('flags.output-dir.summary'),
+            char: 'r',
+        }),
     };
     async run() {
         const { flags } = await this.parse(AgentGenerateTemplate);
-        const { 'agent-file': agentFile, 'agent-version': botVersion } = flags;
+        const { 'agent-file': agentFile, 'agent-version': botVersion, 'output-dir': outputDir } = flags;
         if (!agentFile.endsWith('.bot-meta.xml')) {
             throw new SfError(messages.getMessage('error.invalid-agent-file'));
         }
@@ -50,24 +59,39 @@ export default class AgentGenerateTemplate extends SfCommand {
         // Since we are cloning the GenAiPlannerBundle, we need to use a different name than the Agent (Bot) we started with
         // We will use this name for the BotTemplate also to make it clear they are related
         const finalFilename = `${botName}_v${botVersion}_Template`;
-        // Build the base dir from the AgentFile
+        // Base path for reading metadata
         const basePath = resolve(dirname(agentFile), '..', '..');
         const botDir = join(basePath, 'bots', botName);
         const genAiPlannerBundleDir = join(basePath, 'genAiPlannerBundles');
-        const botTemplateDir = join(basePath, 'botTemplates');
+        const outputBase = resolve(outputDir ?? basePath);
+        const botTemplateDir = join(outputBase, 'botTemplates');
+        const outputGenAiPlannerBundleDir = join(outputBase, 'genAiPlannerBundles');
         const botTemplateFilePath = join(botTemplateDir, `${finalFilename}.botTemplate-meta.xml`);
-        const clonedGenAiPlannerBundleFilePath = join(genAiPlannerBundleDir, finalFilename, `${finalFilename}.genAiPlannerBundle`);
+        const clonedGenAiPlannerBundleFilePath = join(outputGenAiPlannerBundleDir, finalFilename, `${finalFilename}.genAiPlannerBundle`);
         // Parse the metadata files as JSON
         const botJson = xmlToJson(join(botDir, `${botName}.bot-meta.xml`), parser);
+        if (botJson.Bot.agentDSLEnabled) {
+            throw new SfError(messages.getMessage('error.nga-agent-not-supported'));
+        }
         const botVersionJson = xmlToJson(join(botDir, `v${botVersion}.botVersion-meta.xml`), parser);
         const genAiPlannerBundleMetaJson = xmlToJson(join(genAiPlannerBundleDir, botName, `${botName}.genAiPlannerBundle`), parser);
         // Modify the metadata files for final output
-        // TODO: Confirm this name (might be conversationDefinitionPlanners)
         genAiPlannerBundleMetaJson.GenAiPlannerBundle.botTemplate = finalFilename;
+        // Process local assets
+        const { localTopics, localActions } = getLocalAssets(genAiPlannerBundleMetaJson);
+        const connection = flags['source-org'].getConnection(flags['api-version']);
+        const resolvedProjectConfig = await this.project.resolveProjectConfig();
+        const namespaceFromSfdxProject = typeof resolvedProjectConfig.namespace === 'string' ? resolvedProjectConfig.namespace : '';
+        await validateGlobalAssets(localTopics, localActions, connection, namespaceFromSfdxProject, (msg) => this.warn(msg));
+        replaceReferencesToGlobalAssets(genAiPlannerBundleMetaJson, localTopics);
         const botTemplate = convertBotToBotTemplate(botJson, botVersionJson, finalFilename, botTemplateFilePath);
         // Build and save the metadata files
         jsonToXml(clonedGenAiPlannerBundleFilePath, genAiPlannerBundleMetaJson, builder);
         jsonToXml(botTemplateFilePath, botTemplate, builder);
+        if (outputDir) {
+            const copiedDirs = copyMetadataDirsIfPresent(basePath, outputBase);
+            this.warn(messages.getMessage('warn.copied-asset-directories', [copiedDirs.join(', ')]));
+        }
         this.log(`\nSaved BotTemplate to:\n - ${botTemplateFilePath}`);
         this.log(`Saved GenAiPlannerBundle to:\n - ${clonedGenAiPlannerBundleFilePath}`);
         return {
@@ -134,7 +158,236 @@ const jsonToXml = (filename, json, builder) => {
         writeFileSync(filename, xml);
     }
     catch (error) {
-        throw new SfError(`Failed save to file: ${filename}`);
+        throw new SfError(`Failed save to file: ${filename}`, undefined, undefined, undefined, error);
+    }
+};
+/**
+ * Extracts local topics and actions from the GenAiPlannerBundle and validates that each has a `source` reference to its global counterpart.
+ * Throws if any local topic or action is missing `source`.
+ *
+ * @param genAiPlannerBundleMetaJson - The GenAiPlannerBundle metadata to read from
+ * @returns { localTopics, localActions } - The local topics and the flattened local actions from all plugins
+ */
+export const getLocalAssets = (genAiPlannerBundleMetaJson) => {
+    const rawLocalTopics = genAiPlannerBundleMetaJson.GenAiPlannerBundle.localTopics;
+    const localTopics = Array.isArray(rawLocalTopics) ? rawLocalTopics : rawLocalTopics ? [rawLocalTopics] : [];
+    const localTopicsWithoutSource = localTopics.filter((topic) => !topic.source);
+    if (localTopicsWithoutSource.length > 0) {
+        throw new SfError(messages.getMessage('error.local-topics-without-source', [
+            localTopicsWithoutSource.map((topic) => topic.developerName).join(', '),
+        ]));
+    }
+    const actionsFromPlugins = localTopics.flatMap((plugin) => Array.isArray(plugin.localActions) ? plugin.localActions : plugin.localActions ? [plugin.localActions] : []);
+    const plannerBundle = genAiPlannerBundleMetaJson.GenAiPlannerBundle;
+    const plannerActions = Array.isArray(plannerBundle.plannerActions)
+        ? plannerBundle.plannerActions
+        : plannerBundle.plannerActions
+            ? [plannerBundle.plannerActions]
+            : [];
+    // localActions are the actions from the plugins and the plannerActions
+    const localActions = [...actionsFromPlugins, ...plannerActions];
+    if (localActions.length > 0) {
+        const localActionsWithoutSource = localActions.filter((action) => !action.source);
+        if (localActionsWithoutSource.length > 0) {
+            throw new SfError(messages.getMessage('error.local-actions-without-source', [
+                localActionsWithoutSource.map((action) => action.developerName ?? action.fullName).join(', '),
+            ]));
+        }
+    }
+    return { localTopics, localActions };
+};
+/**
+ * Uses localTopics' <source> elements to identify global assets, then updates topic links (genAiPlugins), action links (genAiFunctions), attributeMappings and ruleExpressionAssignments.
+ * Replaces localTopicLinks with genAiPlugins. Replaces localActionLinks with genAiFunctions.
+ */
+export const replaceReferencesToGlobalAssets = (genAiPlannerBundleMetaJson, localTopics) => {
+    const plannerBundle = genAiPlannerBundleMetaJson.GenAiPlannerBundle;
+    const localToGlobalAssets = buildLocalToGlobalAssetMap(localTopics, plannerBundle);
+    // replace localTopicLinks with global genAiPlugins
+    plannerBundle.genAiPlugins = localTopics.map((topic) => ({
+        genAiPluginName: topic.source,
+    }));
+    plannerBundle.localTopicLinks = [];
+    // Replaces localActionLinks with global genAiFunctions (only names in ALLOWED_GLOBAL_FUNCTIONS are emitted)
+    if (plannerBundle.localActionLinks) {
+        plannerBundle.localActionLinks = Array.isArray(plannerBundle.localActionLinks)
+            ? plannerBundle.localActionLinks
+            : [plannerBundle.localActionLinks];
+        const allowedFound = new Set();
+        for (const link of plannerBundle.localActionLinks) {
+            const globalName = localToGlobalAssets.get(link.genAiFunctionName);
+            if (globalName && ALLOWED_GLOBAL_FUNCTIONS.has(globalName)) {
+                allowedFound.add(globalName);
+            }
+        }
+        plannerBundle.genAiFunctions = [...allowedFound].map((genAiFunctionName) => ({ genAiFunctionName }));
+        plannerBundle.localActionLinks = [];
+    }
+    // replace references in attributeMappings and ruleExpressionAssignments
+    const attributeMappings = Array.isArray(plannerBundle.attributeMappings)
+        ? plannerBundle.attributeMappings
+        : plannerBundle.attributeMappings
+            ? [plannerBundle.attributeMappings]
+            : [];
+    for (const mapping of attributeMappings) {
+        if (mapping.attributeName) {
+            mapping.attributeName = replaceLocalRefsWithGlobal(mapping.attributeName, localToGlobalAssets);
+        }
+    }
+    const ruleExpressionAssignments = Array.isArray(plannerBundle.ruleExpressionAssignments)
+        ? plannerBundle.ruleExpressionAssignments
+        : plannerBundle.ruleExpressionAssignments
+            ? [plannerBundle.ruleExpressionAssignments]
+            : [];
+    for (const assignment of ruleExpressionAssignments) {
+        if (assignment.targetName) {
+            assignment.targetName = replaceLocalRefsWithGlobal(assignment.targetName, localToGlobalAssets);
+        }
+    }
+    // delete local assets from the GenAiPlannerBundle
+    plannerBundle.localTopics = [];
+    plannerBundle.plannerActions = [];
+};
+/**
+ * Queries the org for asset definitions (topics or functions) and checks each local asset against the results.
+ *
+ * @returns { referenceAssetFromManagedPackage, notFoundInOrg } - The assets that are referenced from managed packages and the assets that are not found in the org
+ */
+const doValidateGlobalAssets = async (connection, toolingObject, localAssets, namespaceFromSfdxProject) => {
+    const developerNames = localAssets.map((asset) => asset.fullName).filter((name) => Boolean(name));
+    // early return if there are no local assets to validate
+    if (developerNames.length === 0) {
+        return { referenceAssetFromManagedPackage: new Set(), notFoundInOrg: new Set() };
+    }
+    const inClause = developerNames.map((name) => `'${String(name).replace(/'/g, "''")}'`).join(', ');
+    const soql = `SELECT Id, DeveloperName, NamespacePrefix, IsLocal, Source FROM ${toolingObject} WHERE DeveloperName IN (${inClause}) OR IsLocal = false`;
+    const result = await connection.tooling.query(soql);
+    const assetDefinitionResults = result.records ?? [];
+    const localAssetDefinitionResults = new Map();
+    const globalAssetDefinitionById = new Map();
+    for (const assetDefinition of assetDefinitionResults) {
+        if (assetDefinition.IsLocal) {
+            localAssetDefinitionResults.set(assetDefinition.DeveloperName, assetDefinition);
+        }
+        else {
+            globalAssetDefinitionById.set(assetDefinition.Id, assetDefinition);
+        }
+    }
+    const referenceAssetFromManagedPackage = new Set();
+    const notFoundInOrg = new Set();
+    for (const localAsset of localAssets) {
+        const currentAssetDefinitionResult = localAssetDefinitionResults.get(localAsset.fullName);
+        if (currentAssetDefinitionResult) {
+            // if source is an Id, it means it's pointing to a record created in the org
+            // if is not an Id, it means it's pointing to an standard OOTB Salesforce asset
+            if (validateSalesforceId(currentAssetDefinitionResult.Source)) {
+                const globalAsset = globalAssetDefinitionById.get(currentAssetDefinitionResult.Source);
+                if (globalAsset) {
+                    // find global assets from managed packages other than the one in the sfdx-project.json
+                    if (globalAsset.NamespacePrefix && globalAsset.NamespacePrefix !== namespaceFromSfdxProject) {
+                        referenceAssetFromManagedPackage.add(`${globalAsset.NamespacePrefix}__${globalAsset.DeveloperName}`);
+                    }
+                }
+                else {
+                    notFoundInOrg.add(currentAssetDefinitionResult.Source);
+                }
+            }
+            else {
+                // OOTB Salesforce asset, no validation needed
+            }
+        }
+        else {
+            notFoundInOrg.add(localAsset.fullName);
+        }
+    }
+    return {
+        referenceAssetFromManagedPackage,
+        notFoundInOrg,
+    };
+};
+/**
+ * Validates that local topics and actions reference global assets that exist in the source org.
+ *
+ * @param localTopics - Local genAiPlugin topics (GenAiPluginDefinition)
+ * @param localActions - Local genAiFunction actions (GenAiFunctionDefinition)
+ * @param connection - Source org connection (--source-org)
+ * @param namespaceFromSfdxProject - `namespace` from sfdx-project.json (empty if unset)
+ * @param warn - Command warn hook (e.g. `(msg) => this.warn(msg)`)
+ */
+export const validateGlobalAssets = async (localTopics, localActions, connection, namespaceFromSfdxProject, warn) => {
+    const topicsValidationResults = await doValidateGlobalAssets(connection, 'GenAiPluginDefinition', localTopics, namespaceFromSfdxProject);
+    const actionsValidationResults = await doValidateGlobalAssets(connection, 'GenAiFunctionDefinition', localActions, namespaceFromSfdxProject);
+    const referenceAssetFromManagedPackage = new Set([
+        ...topicsValidationResults.referenceAssetFromManagedPackage,
+        ...actionsValidationResults.referenceAssetFromManagedPackage,
+    ]);
+    const notFoundInOrg = new Set([
+        ...topicsValidationResults.notFoundInOrg,
+        ...actionsValidationResults.notFoundInOrg,
+    ]);
+    if (referenceAssetFromManagedPackage.size > 0) {
+        warn(messages.getMessage('warn.reference-asset-from-managed-package', [
+            [...referenceAssetFromManagedPackage].join(', '),
+        ]));
+    }
+    if (notFoundInOrg.size > 0) {
+        throw new SfError(messages.getMessage('error.global-asset-not-found', [[...notFoundInOrg].join(', ')]));
+    }
+};
+/**
+ * Builds a map from local asset names to their global (source) asset names.
+ *
+ * @param localTopics - The local topics of the GenAiPlannerBundle
+ * @param plannerBundle - The GenAiPlannerBundle (for plannerActions)
+ * @returns A map of local asset name → global asset name
+ */
+const buildLocalToGlobalAssetMap = (localTopics, plannerBundle) => {
+    const map = new Map();
+    for (const topic of localTopics) {
+        map.set(topic.fullName, topic.source);
+        const actions = Array.isArray(topic.localActions)
+            ? topic.localActions
+            : topic.localActions
+                ? [topic.localActions]
+                : [];
+        for (const action of actions) {
+            map.set(action.fullName, action.source);
+        }
+    }
+    const plannerActions = Array.isArray(plannerBundle.plannerActions)
+        ? plannerBundle.plannerActions
+        : plannerBundle.plannerActions
+            ? [plannerBundle.plannerActions]
+            : [];
+    for (const action of plannerActions) {
+        if (action.fullName && action.source)
+            map.set(action.fullName, action.source);
+    }
+    return map;
+};
+/**
+ * Replaces dot-separated local refs with global names. Each segment is replaced only when present in localToGlobalMap;
+ * segments not in localToGlobalMap (e.g. namespace, attribute path) are kept as-is. Used for attributeName, targetName, expression.
+ */
+const replaceLocalRefsWithGlobal = (value, localToGlobalMap) => value
+    .split('.')
+    .map((segment) => localToGlobalMap.get(segment) ?? segment)
+    .join('.');
+/**
+ * Copies metadata directories from the source package (basePath) to the output directory if they exist.
+ * Source path is derived from the agent file location (e.g. force-app/main/default).
+ */
+const copyMetadataDirsIfPresent = (basePath, outputBase) => {
+    const METADATA_DIRS_TO_COPY = ['genAiPlugins', 'genAiFunctions', 'classes', 'flows', 'genAiPromptTemplates'];
+    const copiedDirs = [];
+    for (const dirName of METADATA_DIRS_TO_COPY) {
+        const srcDir = join(basePath, dirName);
+        if (existsSync(srcDir) && statSync(srcDir).isDirectory()) {
+            const destDir = join(outputBase, dirName);
+            cpSync(srcDir, destDir, { recursive: true });
+            copiedDirs.push(dirName);
+        }
     }
+    return copiedDirs;
 };
 //# sourceMappingURL=template.js.map

package/lib/commands/agent/generate/template.js.map

@@ -1 +1 @@
-{"version":3,"file":"template.js","sourceRoot":"","sources":["../../../../src/commands/agent/generate/template.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC7D,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,OAAO,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAqCxD,QAAQ,CAAC,kCAAkC,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC7D,MAAM,QAAQ,GAAG,QAAQ,CAAC,YAAY,CAAC,0BAA0B,EAAE,yBAAyB,CAAC,CAAC;AAM9F,MAAM,CAAC,OAAO,OAAO,qBAAsB,SAAQ,SAAsC;IAChF,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,eAAe,GAAG,IAAI,CAAC;IAEvC,MAAM,CAAU,KAAK,GAAG;QAC7B,aAAa,EAAE,KAAK,CAAC,aAAa,EAAE;QACpC,eAAe,EAAE,KAAK,CAAC,OAAO,CAAC;YAC7B,OAAO,EAAE,QAAQ,CAAC,UAAU,CAAC,6BAA6B,CAAC;YAC3D,QAAQ,EAAE,IAAI;SACf,CAAC;QACF,YAAY,EAAE,KAAK,CAAC,IAAI,CAAC;YACvB,OAAO,EAAE,QAAQ,CAAC,UAAU,CAAC,0BAA0B,CAAC;YACxD,IAAI,EAAE,GAAG;YACT,QAAQ,EAAE,IAAI;YACd,MAAM,EAAE,IAAI;SACb,CAAC;KACH,CAAC;IAEK,KAAK,CAAC,GAAG;QACd,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC;QAC1D,MAAM,EAAE,YAAY,EAAE,SAAS,EAAE,eAAe,EAAE,UAAU,EAAE,GAAG,KAAK,CAAC;QAEvE,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC;YACzC,MAAM,IAAI,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,0BAA0B,CAAC,CAAC,CAAC;QACrE,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,EAAE,gBAAgB,EAAE,KAAK,EAAE,CAAC,CAAC;QAC1D,MAAM,OAAO,GAAG,IAAI,UAAU,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;QAE5F,MAAM,OAAO,GAAG,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAC,CAAC;QACrD,oHAAoH;QACpH,mFAAmF;QACnF,MAAM,aAAa,GAAG,GAAG,OAAO,KAAK,UAAU,WAAW,CAAC;QAE3D,wCAAwC;QACxC,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;QACzD,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;QAC/C,MAAM,qBAAqB,GAAG,IAAI,CAAC,QAAQ,EAAE,qBAAqB,CAAC,CAAC;QACpE,MAAM,cAAc,GAAG,IAAI,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;QAEtD,MAAM,mBAAmB,GAAG,IAAI,CAAC,cAAc,EAAE,GAAG,aAAa,uBAAuB,CAAC,CAAC;QAC1F,MAAM,gCAAgC,GAAG,IAAI,CAC3C,qBAAqB,EACrB,aAAa,EACb,GAAG,aAAa,qBAAqB,CACtC,CAAC;QAEF,mCAAmC;QACnC,MAAM,OAAO,GAAG,SAAS,CAAS,IAAI,CAAC,MAAM,EAAE,GAAG,OAAO,eAAe,CAAC,EAAE,MAAM,CAAC,CAAC;QACnF,MAAM,cAAc,GAAG,SAAS,CAAgB,IAAI,CAAC,MAAM,EAAE,IAAI,UAAU,sBAAsB,CAAC,EAAE,MAAM,CAAC,CAAC;QAC5G,MAAM,0BAA0B,GAAG,SAAS,CAC1C,IAAI,CAAC,qBAAqB,EAAE,OAAO,EAAE,GAAG,OAAO,qBAAqB,CAAC,EACrE,MAAM,CACP,CAAC;QAEF,6CAA6C;QAC7C,oEAAoE;QACpE,0BAA0B,CAAC,kBAAkB,CAAC,WAAW,GAAG,aAAa,CAAC;QAC1E,MAAM,WAAW,GAAG,uBAAuB,CAAC,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,mBAAmB,CAAC,CAAC;QAEzG,oCAAoC;QACpC,SAAS,CAAwB,gCAAgC,EAAE,0BAA0B,EAAE,OAAO,CAAC,CAAC;QACxG,SAAS,CAAiB,mBAAmB,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC;QAErE,IAAI,CAAC,GAAG,CAAC,+BAA+B,mBAAmB,EAAE,CAAC,CAAC;QAC/D,IAAI,CAAC,GAAG,CAAC,oCAAoC,gCAAgC,EAAE,CAAC,CAAC;QAEjF,OAAO;YACL,sBAAsB,EAAE,gCAAgC;YACxD,eAAe,EAAE,mBAAmB;SACrC,CAAC;IACJ,CAAC;;AAGH,MAAM,uBAAuB,GAAG,CAC9B,GAAW,EACX,cAA6B,EAC7B,eAAuB,EACvB,WAAmB,EACH,EAAE;IAClB,MAAM,WAAW,GAAG,cAAc,CAAC,UAAU,CAAC,WAAW,CAAC;IAC1D,MAAM,EAAE,yBAAyB,EAAE,qBAAqB,EAAE,GAAG,cAAc,CAAC,UAAU,CAAC;IAEvF,sFAAsF;IACtF,wCAAwC;IACxC,MAAM,eAAe,GAAG,cAAc,CAAC,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,aAAa,KAAK,WAAW,CAAC,CAAC;IAEpH,IAAI,CAAC,eAAe;QAAE,MAAM,IAAI,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,uBAAuB,CAAC,CAAC,CAAC;IACtF,8DAA8D;IAC9D,eAAe,CAAC,KAAK,GAAG,WAAW,CAAC;IAEpC,+EAA+E;IAC/E,IAAI,GAAG,CAAC,GAAG,CAAC,IAAI,KAAK,KAAK;QAAE,MAAM,IAAI,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,wBAAwB,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IAC5G,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK;QAAE,MAAM,IAAI,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,gBAAgB,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IAC5F,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,WAAW;QAAE,MAAM,IAAI,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,oBAAoB,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IAEtG,MAAM,WAAW,GAAG,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC;IAClC,MAAM,QAAQ,GAAG,GAAG,CAAC,GAAG,CAAC,WAAW,CAAC;IAErC,OAAO,GAAG,CAAC,GAAG,CAAC,WAAW,CAAC;IAC3B,OAAO,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC;IACrB,OAAO,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC;IACvB,OAAO,GAAG,CAAC,GAAG,CAAC,0BAA0B,CAAC;IAC1C,OAAO,GAAG,CAAC,GAAG,CAAC,cAAc,CAAC;IAC9B,OAAO,GAAG,CAAC,GAAG,CAAC,eAAe,CAAC;IAC/B,OAAO,GAAG,CAAC,GAAG,CAAC,SAAS,CAAC;IACzB,OAAO,GAAG,CAAC,GAAG,CAAC,aAAa,CAAC;IAE7B,MAAM,WAAW,GAAmB;QAClC,MAAM,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE;QACrD,WAAW,EAAE;YACX,WAAW;YACX,qBAAqB,EAAE,OAAO;YAC9B,UAAU,EAAE,CAAC,eAAe,CAAC;YAC7B,yBAAyB;YACzB,qBAAqB;YACrB,WAAW;YACX,QAAQ;YACR,GAAG,GAAG,CAAC,GAAG;SACX;KACF,CAAC;IAEF,kFAAkF;IAClF,WAAW,CAAC,WAAW,CAAC,QAAS,CAAC,IAAI,GAAG,eAAe,CAAC;IAEzD,OAAO,WAAW,CAAC;AACrB,CAAC,CAAC;AAEF,MAAM,SAAS,GAAG,CAAI,IAAY,EAAE,MAAiB,EAAK,EAAE;IAC1D,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAExC,IAAI,CAAC,IAAI;QAAE,MAAM,IAAI,OAAO,CAAC,6BAA6B,IAAI,EAAE,CAAC,CAAC;IAElE,OAAO,MAAM,CAAC,KAAK,CAAC,IAAI,CAAM,CAAC;AACjC,CAAC,CAAC;AAEF,MAAM,SAAS,GAAG,CAAI,QAAgB,EAAE,IAAO,EAAE,OAAmB,EAAQ,EAAE;IAC5E,6CAA6C;IAC7C,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAElD,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAChC,aAAa,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IAC/B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,OAAO,CAAC,wBAAwB,QAAQ,EAAE,CAAC,CAAC;IACxD,CAAC;AACH,CAAC,CAAC"}
+{"version":3,"file":"template.js","sourceRoot":"","sources":["../../../../src/commands/agent/generate/template.ts"],"names":[],"mappings":"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"}

package/messages/agent.activate.md

@@ -4,23 +4,29 @@ Activate an agent in an org.
 
 # description
 
-Activating an agent makes it immediately available to your users. An agent must be active before you can preview it with the "agent preview" CLI command or VS Code.
+Activating an agent makes it immediately available to your users. A published agent must be active before you can preview it with the "agent preview" CLI command or VS Code. Agents can have multiple versions; only one version can be active at a time.
 
-You must know the agent's API name to activate it; you can either be prompted for it or you can specify it with the --api-name flag. Find the agent's API name in its Agent Details page of your org's Agentforce Studio UI in Setup.
+If you run the command without the --api-name or --version flags, the command provides a list of agent API names and versions for you to choose from. Use the flags to specify the exact agent and version without being prompted. If you use the --json flag and not --version, then the latest agent version is automatically activated.
+
+The value of the --version flag is always a number, corresponding to the "vX" part of the "BotVersion" metadata in your project. For example, if you have a force-app/main/default/bots/My_Agent/v4.botVersion-meta.xml file in your project, then you activate this version with the "--version 4" flag.
 
 # examples
 
-- Activate an agent in your default target org by being prompted:
+- Activate an agent in your default target org by being prompted for both its API name and version:
 
   <%= config.bin %> <%= command.id %>
 
-- Activate an agent with API name Resort_Manager in the org with alias "my-org":
+- Activate version 2 of an agent with API name Resort_Manager in the org with alias "my-org":
 
-  <%= config.bin %> <%= command.id %> --api-name Resort_Manager --target-org my-org
+  <%= config.bin %> <%= command.id %> --api-name Resort_Manager --version 2 --target-org my-org
 
 # flags.api-name.summary
 
-API name of the agent to activate.
+API name of the agent to activate; if not specified, the command provides a list that you choose from.
+
+# flags.version.summary
+
+Version number of the agent to activate; if not specified, the command provides a list that you choose from.
 
 # error.missingRequiredFlags
 

package/messages/agent.activation.md

@@ -13,3 +13,7 @@ Agent %s has been deleted and can't be activated.
 # error.agentIsDefault
 
 Agent %s is the default Agentforce agent in your org and you can't change its activation status.
+
+# error.noVersionsAvailable
+
+No versions available to %s. All versions are already in the target state.

package/messages/agent.deactivate.md

@@ -6,7 +6,7 @@ Deactivate an agent in an org.
 
 Deactivating an agent makes it unavailable to your users. To make changes to an agent, such as adding or removing topics or actions, you must deactivate it. You can't preview an agent with the "agent preview" CLI command or VS Code if it's deactivated.
 
-You must know the agent's API name to deactivate it; you can either be prompted for it or you can specify it with the --api-name flag. Find the agent's API name in its Agent Details page of your org's Agentforce Studio UI in Setup.
+If you run the command without the --api-name flag, the command provides a list of agent API names for you to choose from. Use the flag to specify the exact agent without being prompted.
 
 # examples
 
@@ -20,7 +20,7 @@ You must know the agent's API name to deactivate it; you can either be prompted
 
 # flags.api-name.summary
 
-API name of the agent to deactivate.
+API name of the agent to deactivate; if not specified, the command provides a list that you choose from.
 
 # error.missingRequiredFlags
 

package/messages/agent.generate.template.md

@@ -1,20 +1,24 @@
 # summary
 
-Generate an agent template from an existing agent in your DX project so you can then package the template in a managed package.
+Generate an agent template from an existing agent in your DX project so you can then package the template in a second-generation managed package.
 
 # description
 
-At a high-level, agents are defined by the Bot, BotVersion, and GenAiPlannerBundle metadata types. The GenAiPlannerBundle type in turn defines the agent's topics and actions. This command uses the metadata files for these three types, located in your local DX project, to generate a BotTemplate file for a specific agent (Bot). You then use the BotTemplate file, along with the GenAiPlannerBundle file that references the BotTemplate, to package the template in a managed package that you can share between orgs or on AppExchange.
+WARNING: This command doesn't work for agents that were created from an Agent Script file. In other words, you can't currently package an agent template for agents that use Agent Script.
 
-Use the --agent-file flag to specify the relative or full pathname of the Bot metadata file, such as force-app/main/default/bots/My_Awesome_Agent/My_Awesome_Agent.bot-meta.xml. A single Bot can have multiple BotVersions, so use the --agent-version flag to specify the version. The corresponding BotVersion file must exist locally. For example, if you specify "--agent-version 4", then the file force-app/main/default/bots/My_Awesome_Agent/v4.botVersion-meta.xml must exist.
+At a high-level, agents are defined by the Bot, BotVersion, and GenAiPlannerBundle metadata types. The GenAiPlannerBundle type in turn defines the agent's topics and actions. This command uses the metadata files for these three types, located in your local DX project, to generate a BotTemplate metadata file for a specific agent (Bot). You then use the BotTemplate metadata file, along with the GenAiPlannerBundle metadata file that references the BotTemplate, to package the template in a managed package that you can share between orgs or on AppExchange.
 
-The new BotTemplate file is generated in the "botTemplates" directory in your local package directory, and has the name <Agent_API_name>_v<Version>_Template.botTemplate-meta.xml, such as force-app/main/default/botTemplates/My_Awesome_Agent_v4_Template.botTemplate-meta.xml. The command displays the full pathname of the generated files when it completes.
+Use the --agent-file flag to specify the relative or full pathname of the Bot metadata file, such as force-app/main/default/bots/My_Awesome_Agent/My_Awesome_Agent.bot-meta.xml. A single Bot can have multiple BotVersions, so use the --agent-version flag to specify the version. The corresponding BotVersion metadata file must exist locally. For example, if you specify "--agent-version 4", then the file force-app/main/default/bots/My_Awesome_Agent/v4.botVersion-meta.xml must exist.
+
+The new BotTemplate metadata file is generated in the "botTemplates" directory in the output directory specified with the --output-dir flag, and has the name <Agent_API_name>\_v<Version>\_Template.botTemplate-meta.xml, such as my-package/botTemplates/My_Awesome_Agent_v4_Template.botTemplate-meta.xml. The command displays the full pathname of the generated files when it completes.
+
+See "Develop and Package Agent Templates Using Scratch Orgs" (https://developer.salesforce.com/docs/atlas.en-us.pkg2_dev.meta/pkg2_dev/dev2gp_package_agent_templates.htm) for details about the complete process, which includes using a scratch org to create and test the agent, retrieving the agent metadata to your DX project, running this command to create the agent template, and then packaging the template.
 
 # examples
 
-- Generate an agent template from a Bot metadata file in your DX project that corresponds to the My_Awesome_Agent agent; use version 1 of the agent.
+- Generate an agent template from the My_Awesome_Agent Bot metadata file in your DX project and save the BotTemplate and GenAiPlannerBundle to the specified directory; use version 1 of the agent:
 
-  <%= config.bin %> <%= command.id %> --agent-file force-app/main/default/bots/My_Awesome_Agent/My_Awesome_Agent.bot-meta.xml --agent-version 1
+  <%= config.bin %> <%= command.id %> --agent-file force-app/main/default/bots/My_Awesome_Agent/My_Awesome_Agent.bot-meta.xml --agent-version 1 --output-dir my-package --source-org my-scratch-org
 
 # flags.agent-version.summary
 
@@ -24,13 +28,21 @@ Version of the agent (BotVersion).
 
 Path to an agent (Bot) metadata file.
 
+# flags.output-dir.summary
+
+Directory where the generated BotTemplate and GenAiPlannerBundle files are saved.
+
+# flags.source-org.summary
+
+Username or alias of the namespaced scratch org that contains the agent which this template is based on.
+
 # error.invalid-agent-file
 
-Invalid Agent file. Must be a Bot metadata file. Example: force-app/main/default/bots/MyBot/MyBot.bot-meta.xml
+Invalid Agent file. Must be a Bot metadata file. Example: force-app/main/default/bots/MyBot/MyBot.bot-meta.xml.
 
 # error.no-entry-dialog
 
-No entryDialog found in BotVersion file.
+No entryDialog found in the BotVersion metadata file.
 
 # error.invalid-bot-type
 
@@ -38,8 +50,37 @@ The 'type' attribute of this Bot metadata component XML file can't have a value
 
 # error.no-label
 
-No label found in Agent (Bot) file: %s.
+No label found in Agent (Bot) metadata file: %s.
 
 # error.no-ml-domain
 
 No botMlDomain found in Agent (Bot) file: %s.
+
+# error.local-topics-without-source
+
+The local topic (genAiPlugin) you're trying to include in the agent template doesn't have a reference to a global topic. All topics in the agent template must be global assets defined in the Agent Asset Library in the source org that contains the agent that the template is based on.
+%s.
+
+# error.local-actions-without-source
+
+The local action (genAiFunction) you're trying to include in the agent template doesn't have a reference to a global action. All actions in the agent template must be global assets defined in the Agent Asset Library in the source org that contains the agent that the template is based on.
+%s.
+
+# warn.reference-asset-from-managed-package
+
+The local asset (genAiPlugin or genAiFunction) you're including in the agent template references an asset from a managed package. Make sure that the managed package is defined as dependency in the sfdx-project.json file:
+%s.
+
+# error.global-asset-not-found
+
+The following assets (genAiPlugin or genAiFunction) you're including in the agent template reference an asset that is not present in the source org:
+%s.
+
+# error.nga-agent-not-supported
+
+This command doesn't work for agents that were created from an Agent Script file. In other words, you can't currently package an agent template for agents that use Agent Script.
+
+# warn.copied-asset-directories
+
+The following directories have been copied to the target path. Review their contents and remove any unnecessary assets:
+%s.