@salesforce/plugin-agent 1.36.0 → 1.36.1

package/oclif.manifest.json

@@ -879,130 +879,6 @@
         "test-spec:generate:agent"
       ]
     },
-    "agent:publish:authoring-bundle": {
-      "aliases": [],
-      "args": {},
-      "description": "An authoring bundle is a metadata type (named aiAuthoringBundle) that provides the blueprint for an agent. The metadata type contains two files: the standard metatada XML file and an Agent Script file (extension \".agent\") that fully describes the agent using the Agent Script language.\n\nWhen you publish an authoring bundle to your org, a number of things happen. First, this command validates that the Agent Script file successfully compiles. If there are compilation errors, the command exits and you must fix the Agent Script file to continue. Once the Agent Script file compiles, then it's published to the org, which in turn creates new associated metadata (Bot, BotVersion, GenAiX), or new versions of the metadata if the agent already exists. The new or updated metadata is retrieved back to your DX project; specify the --skip-retrieve flag to skip this step. Finally, the authoring bundle metadata (AiAuthoringBundle) is deployed to your org.\n\nThis command uses the API name of the authoring bundle.",
-      "examples": [
-        "Publish an authoring bundle by being prompted for its API name; use your default org:\n<%= config.bin %> <%= command.id %>",
-        "Publish an authoring bundle with API name MyAuthoringBundle to the org with alias \"my-dev-org\":\n<%= config.bin %> <%= command.id %> --api-name MyAuthoringbundle --target-org my-dev-org",
-        "Publish with verbose output to see all retrieved and deployed metadata components:\n<%= config.bin %> <%= command.id %> --api-name MyAuthoringbundle --verbose",
-        "Publish with concise output showing only essential information:\n<%= config.bin %> <%= command.id %> --api-name MyAuthoringbundle --concise"
-      ],
-      "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "flags-dir": {
-          "helpGroup": "GLOBAL",
-          "name": "flags-dir",
-          "summary": "Import flag values from a directory.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "target-org": {
-          "char": "o",
-          "name": "target-org",
-          "noCacheDefault": true,
-          "required": true,
-          "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
-          "hasDynamicHelp": true,
-          "multiple": false,
-          "type": "option"
-        },
-        "api-version": {
-          "description": "Override the api version used for api requests made by this command",
-          "name": "api-version",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "api-name": {
-          "char": "n",
-          "name": "api-name",
-          "summary": "API name of the authoring bundle you want to publish; if not specified, the command provides a list that you can choose from.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "skip-retrieve": {
-          "name": "skip-retrieve",
-          "summary": "Don't retrieve the metadata associated with the agent to your DX project.",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "verbose": {
-          "char": "v",
-          "exclusive": [
-            "concise"
-          ],
-          "name": "verbose",
-          "summary": "Display detailed output showing all metadata components retrieved and deployed during the publish process.",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "concise": {
-          "exclusive": [
-            "verbose"
-          ],
-          "name": "concise",
-          "summary": "Display minimal output with only essential information about the publish operation.",
-          "allowNo": false,
-          "type": "boolean"
-        }
-      },
-      "hasDynamicHelp": true,
-      "hiddenAliases": [],
-      "id": "agent:publish:authoring-bundle",
-      "pluginAlias": "@salesforce/plugin-agent",
-      "pluginName": "@salesforce/plugin-agent",
-      "pluginType": "core",
-      "strict": true,
-      "summary": "Publish an authoring bundle to your org, which results in a new agent or a new version of an existing agent.",
-      "enableJsonFlag": true,
-      "requiresProject": true,
-      "errorCodes": {
-        "header": "ERROR CODES",
-        "body": [
-          {
-            "name": "Succeeded (0)",
-            "description": "Agent published successfully without errors."
-          },
-          {
-            "name": "Failed (1)",
-            "description": "Compilation errors found in the Agent Script file."
-          }
-        ]
-      },
-      "FLAGGABLE_PROMPTS": {
-        "api-name": {
-          "message": "API name of the authoring bundle you want to publish; if not specified, the command provides a list that you can choose from.",
-          "promptMessage": "API name of the authoring bundle to publish"
-        }
-      },
-      "isESM": true,
-      "relativePath": [
-        "lib",
-        "commands",
-        "agent",
-        "publish",
-        "authoring-bundle.js"
-      ],
-      "aliasPermutations": [],
-      "permutations": [
-        "agent:publish:authoring-bundle",
-        "publish:agent:authoring-bundle",
-        "publish:authoring-bundle:agent",
-        "agent:authoring-bundle:publish",
-        "authoring-bundle:agent:publish",
-        "authoring-bundle:publish:agent"
-      ]
-    },
     "agent:preview:end": {
       "aliases": [],
       "args": {},
@@ -1470,6 +1346,130 @@
         "start:preview:agent"
       ]
     },
+    "agent:publish:authoring-bundle": {
+      "aliases": [],
+      "args": {},
+      "description": "An authoring bundle is a metadata type (named aiAuthoringBundle) that provides the blueprint for an agent. The metadata type contains two files: the standard metatada XML file and an Agent Script file (extension \".agent\") that fully describes the agent using the Agent Script language.\n\nWhen you publish an authoring bundle to your org, a number of things happen. First, this command validates that the Agent Script file successfully compiles. If there are compilation errors, the command exits and you must fix the Agent Script file to continue. Once the Agent Script file compiles, then it's published to the org, which in turn creates new associated metadata (Bot, BotVersion, GenAiX), or new versions of the metadata if the agent already exists. The new or updated metadata is retrieved back to your DX project; specify the --skip-retrieve flag to skip this step. Finally, the authoring bundle metadata (AiAuthoringBundle) is deployed to your org.\n\nThis command uses the API name of the authoring bundle.",
+      "examples": [
+        "Publish an authoring bundle by being prompted for its API name; use your default org:\n<%= config.bin %> <%= command.id %>",
+        "Publish an authoring bundle with API name MyAuthoringBundle to the org with alias \"my-dev-org\":\n<%= config.bin %> <%= command.id %> --api-name MyAuthoringbundle --target-org my-dev-org",
+        "Publish with verbose output to see all retrieved and deployed metadata components:\n<%= config.bin %> <%= command.id %> --api-name MyAuthoringbundle --verbose",
+        "Publish with concise output showing only essential information:\n<%= config.bin %> <%= command.id %> --api-name MyAuthoringbundle --concise"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "flags-dir": {
+          "helpGroup": "GLOBAL",
+          "name": "flags-dir",
+          "summary": "Import flag values from a directory.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "target-org": {
+          "char": "o",
+          "name": "target-org",
+          "noCacheDefault": true,
+          "required": true,
+          "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
+          "hasDynamicHelp": true,
+          "multiple": false,
+          "type": "option"
+        },
+        "api-version": {
+          "description": "Override the api version used for api requests made by this command",
+          "name": "api-version",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "api-name": {
+          "char": "n",
+          "name": "api-name",
+          "summary": "API name of the authoring bundle you want to publish; if not specified, the command provides a list that you can choose from.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "skip-retrieve": {
+          "name": "skip-retrieve",
+          "summary": "Don't retrieve the metadata associated with the agent to your DX project.",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "verbose": {
+          "char": "v",
+          "exclusive": [
+            "concise"
+          ],
+          "name": "verbose",
+          "summary": "Display detailed output showing all metadata components retrieved and deployed during the publish process.",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "concise": {
+          "exclusive": [
+            "verbose"
+          ],
+          "name": "concise",
+          "summary": "Display minimal output with only essential information about the publish operation.",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": true,
+      "hiddenAliases": [],
+      "id": "agent:publish:authoring-bundle",
+      "pluginAlias": "@salesforce/plugin-agent",
+      "pluginName": "@salesforce/plugin-agent",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "Publish an authoring bundle to your org, which results in a new agent or a new version of an existing agent.",
+      "enableJsonFlag": true,
+      "requiresProject": true,
+      "errorCodes": {
+        "header": "ERROR CODES",
+        "body": [
+          {
+            "name": "Succeeded (0)",
+            "description": "Agent published successfully without errors."
+          },
+          {
+            "name": "Failed (1)",
+            "description": "Compilation errors found in the Agent Script file."
+          }
+        ]
+      },
+      "FLAGGABLE_PROMPTS": {
+        "api-name": {
+          "message": "API name of the authoring bundle you want to publish; if not specified, the command provides a list that you can choose from.",
+          "promptMessage": "API name of the authoring bundle to publish"
+        }
+      },
+      "isESM": true,
+      "relativePath": [
+        "lib",
+        "commands",
+        "agent",
+        "publish",
+        "authoring-bundle.js"
+      ],
+      "aliasPermutations": [],
+      "permutations": [
+        "agent:publish:authoring-bundle",
+        "publish:agent:authoring-bundle",
+        "publish:authoring-bundle:agent",
+        "agent:authoring-bundle:publish",
+        "authoring-bundle:agent:publish",
+        "authoring-bundle:publish:agent"
+      ]
+    },
     "agent:test:create": {
       "aliases": [],
       "args": {},
@@ -1599,7 +1599,7 @@
     "agent:test:list": {
       "aliases": [],
       "args": {},
-      "description": "The command outputs a table with the name (API name) of each test along with its unique ID and the date it was created in the org.",
+      "description": "The command outputs a table with the name (API name) of each test along with its unique ID, type ('agentforce-studio' or 'testing-center'), and the date it was created in the org.",
       "examples": [
         "List the agent tests in your default org:\n<%= config.bin %> <%= command.id %>",
         "List the agent tests in an org with alias \"my-org\"\"\n<%= config.bin %> <%= command.id %> --target-org my-org"
@@ -1761,6 +1761,18 @@
           "multiple": false,
           "type": "option"
         },
+        "test-runner": {
+          "description": "By default, the command automatically detects which test runner to use based on the test definition metadata type in your org. Use this flag to explicitly specify the runner type. 'agentforce-studio' uses AiTestingDefinition metadata. 'testing-center' uses AiEvaluationDefinition metadata.",
+          "name": "test-runner",
+          "summary": "Explicitly specify which test runner to use (agentforce-studio or testing-center).",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "agentforce-studio",
+            "testing-center"
+          ],
+          "type": "option"
+        },
         "verbose": {
           "description": "When enabled, includes detailed generated data (such as invoked actions) in the human-readable test results output. This is useful for debugging test failures and understanding what actions were actually invoked during the test run.\n\nThe generated data is in JSON format and includes the Apex classes or Flows that were invoked, the Salesforce objects that were touched, and so on. Use the JSON structure of this information to build the test case JSONPath expression when using custom evaluations.",
           "name": "verbose",
@@ -1911,6 +1923,18 @@
           "multiple": false,
           "type": "option"
         },
+        "test-runner": {
+          "description": "By default, the command automatically detects which test runner to use based on the test definition metadata type in your org. Use this flag to explicitly specify the runner type. 'agentforce-studio' uses AiTestingDefinition metadata. 'testing-center' uses AiEvaluationDefinition metadata.",
+          "name": "test-runner",
+          "summary": "Explicitly specify which test runner to use (agentforce-studio or testing-center).",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "agentforce-studio",
+            "testing-center"
+          ],
+          "type": "option"
+        },
         "verbose": {
           "description": "When enabled, includes detailed generated data (such as invoked actions) in the human-readable test results output. This is useful for debugging test failures and understanding what actions were actually invoked during the test run.\n\nThe generated data is in JSON format and includes the Apex classes or Flows that were invoked, the Salesforce objects that were touched, and so on. Use the JSON structure of this information to build the test case JSONPath expression when using custom evaluations.",
           "name": "verbose",
@@ -2216,6 +2240,18 @@
           "multiple": false,
           "type": "option"
         },
+        "test-runner": {
+          "description": "By default, the command automatically detects which test runner to use based on the test definition metadata type in your org. Use this flag to explicitly specify the runner type. 'agentforce-studio' uses AiTestingDefinition metadata. 'testing-center' uses AiEvaluationDefinition metadata.",
+          "name": "test-runner",
+          "summary": "Explicitly specify which test runner to use (agentforce-studio or testing-center).",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "agentforce-studio",
+            "testing-center"
+          ],
+          "type": "option"
+        },
         "verbose": {
           "description": "When enabled, includes detailed generated data (such as invoked actions) in the human-readable test results output. This is useful for debugging test failures and understanding what actions were actually invoked during the test run.\n\nThe generated data is in JSON format and includes the Apex classes or Flows that were invoked, the Salesforce objects that were touched, and so on. Use the JSON structure of this information to build the test case JSONPath expression when using custom evaluations.",
           "name": "verbose",
@@ -2396,5 +2432,5 @@
       ]
     }
   },
-  "version": "1.36.0"
+  "version": "1.36.1"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "@salesforce/plugin-agent",
     "description": "Commands to interact with Salesforce agents",
-    "version": "1.36.0",
+    "version": "1.36.1",
     "author": "Salesforce",
     "bugs": "https://github.com/forcedotcom/cli/issues",
     "enableO11y": true,
@@ -12,11 +12,11 @@
         "@inquirer/prompts": "^7.10.1",
         "@oclif/core": "^4",
         "@oclif/multi-stage-output": "^0.8.36",
-        "@salesforce/agents": "^1.4.0",
+        "@salesforce/agents": "^1.5.1",
         "@salesforce/core": "^8.28.3",
         "@salesforce/kit": "^3.2.6",
         "@salesforce/sf-plugins-core": "^12.2.6",
-        "@salesforce/source-deploy-retrieve": "^12.32.8",
+        "@salesforce/source-deploy-retrieve": "^12.35.3",
         "@salesforce/types": "^1.7.1",
         "ansis": "^3.3.2",
         "fast-xml-parser": "^5.7.1",
@@ -240,7 +240,7 @@
     "exports": "./lib/index.js",
     "type": "module",
     "sfdx": {
-        "publicKeyUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-agent/1.36.0.crt",
-        "signatureUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-agent/1.36.0.sig"
+        "publicKeyUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-agent/1.36.1.crt",
+        "signatureUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-agent/1.36.1.sig"
     }
 }

package/schemas/agent-activate.json

@@ -12,8 +12,11 @@
           "type": "number"
         }
       },
-      "required": ["success", "version"],
+      "required": [
+        "success",
+        "version"
+      ],
       "additionalProperties": false
     }
   }
-}
+}

package/schemas/agent-create.json

@@ -28,7 +28,11 @@
               "type": "string"
             }
           },
-          "required": ["botId", "botVersionId", "plannerId"],
+          "required": [
+            "botId",
+            "botVersionId",
+            "plannerId"
+          ],
           "additionalProperties": false,
           "description": "If the agent was created with saveAgent=true, these are the IDs that make up an agent; Bot, BotVersion, and GenAiPlanner metadata."
         },
@@ -78,7 +82,11 @@
                                 "type": "string"
                               }
                             },
-                            "required": ["inputName", "inputDataType", "inputDescription"],
+                            "required": [
+                              "inputName",
+                              "inputDataType",
+                              "inputDescription"
+                            ],
                             "additionalProperties": false
                           },
                           "minItems": 1,
@@ -99,14 +107,24 @@
                                 "type": "string"
                               }
                             },
-                            "required": ["outputName", "outputDataType", "outputDescription"],
+                            "required": [
+                              "outputName",
+                              "outputDataType",
+                              "outputDescription"
+                            ],
                             "additionalProperties": false
                           },
                           "minItems": 1,
                           "maxItems": 1
                         }
                       },
-                      "required": ["actionName", "exampleOutput", "actionDescription", "inputs", "outputs"],
+                      "required": [
+                        "actionName",
+                        "exampleOutput",
+                        "actionDescription",
+                        "inputs",
+                        "outputs"
+                      ],
                       "additionalProperties": false
                     },
                     "minItems": 1,
@@ -122,7 +140,13 @@
                     "type": "string"
                   }
                 },
-                "required": ["scope", "topic", "actions", "instructions", "classificationDescription"],
+                "required": [
+                  "scope",
+                  "topic",
+                  "actions",
+                  "instructions",
+                  "classificationDescription"
+                ],
                 "additionalProperties": false
               },
               "minItems": 1,
@@ -135,11 +159,18 @@
               }
             }
           },
-          "required": ["agentDescription", "topics", "sampleUtterances"],
+          "required": [
+            "agentDescription",
+            "topics",
+            "sampleUtterances"
+          ],
           "additionalProperties": false
         }
       },
-      "required": ["agentDefinition", "isSuccess"]
+      "required": [
+        "agentDefinition",
+        "isSuccess"
+      ]
     }
   }
-}
+}

package/schemas/agent-deactivate.json

@@ -12,8 +12,11 @@
           "type": "number"
         }
       },
-      "required": ["success", "version"],
+      "required": [
+        "success",
+        "version"
+      ],
       "additionalProperties": false
     }
   }
-}
+}

package/schemas/agent-generate-agent__spec.json

@@ -47,7 +47,14 @@
           "type": "string"
         }
       },
-      "required": ["agentType", "companyDescription", "companyName", "isSuccess", "role", "topics"]
+      "required": [
+        "agentType",
+        "companyDescription",
+        "companyName",
+        "isSuccess",
+        "role",
+        "topics"
+      ]
     },
     "DraftAgentTopics": {
       "type": "array",
@@ -61,7 +68,10 @@
             "type": "string"
           }
         },
-        "required": ["name", "description"],
+        "required": [
+          "name",
+          "description"
+        ],
         "additionalProperties": false
       },
       "minItems": 1,
@@ -69,7 +79,11 @@
     },
     "AgentType": {
       "type": "string",
-      "enum": ["customer", "internal", "AGENT"]
+      "enum": [
+        "customer",
+        "internal",
+        "AGENT"
+      ]
     }
   }
-}
+}

package/schemas/agent-generate-authoring__bundle.json

@@ -15,8 +15,12 @@
           "type": "string"
         }
       },
-      "required": ["agentPath", "metaXmlPath", "outputDir"],
+      "required": [
+        "agentPath",
+        "metaXmlPath",
+        "outputDir"
+      ],
       "additionalProperties": false
     }
   }
-}
+}

package/schemas/agent-generate-template.json

@@ -12,8 +12,11 @@
           "type": "string"
         }
       },
-      "required": ["genAiPlannerBundlePath", "botTemplatePath"],
+      "required": [
+        "genAiPlannerBundlePath",
+        "botTemplatePath"
+      ],
       "additionalProperties": false
     }
   }
-}
+}

package/schemas/agent-preview-end.json

@@ -12,8 +12,11 @@
           "type": "string"
         }
       },
-      "required": ["sessionId", "tracesPath"],
+      "required": [
+        "sessionId",
+        "tracesPath"
+      ],
       "additionalProperties": false
     }
   }
-}
+}

package/schemas/agent-preview-send.json

@@ -27,8 +27,12 @@
           "type": "string"
         }
       },
-      "required": ["messages", "agentApiName", "sessionId"],
+      "required": [
+        "messages",
+        "agentApiName",
+        "sessionId"
+      ],
       "additionalProperties": false
     }
   }
-}
+}

package/schemas/agent-preview-sessions.json

@@ -23,13 +23,20 @@
             "$ref": "#/definitions/SessionType"
           }
         },
-        "required": ["agentId", "sessionId"],
+        "required": [
+          "agentId",
+          "sessionId"
+        ],
         "additionalProperties": false
       }
     },
     "SessionType": {
       "type": "string",
-      "enum": ["simulated", "live", "published"]
+      "enum": [
+        "simulated",
+        "live",
+        "published"
+      ]
     }
   }
-}
+}

package/schemas/agent-preview-start.json

@@ -12,8 +12,11 @@
           "type": "string"
         }
       },
-      "required": ["sessionId", "agentApiName"],
+      "required": [
+        "sessionId",
+        "agentApiName"
+      ],
       "additionalProperties": false
     }
   }
-}
+}

package/schemas/agent-preview.json

@@ -6,4 +6,4 @@
       "type": "null"
     }
   }
-}
+}

package/schemas/agent-test-create.json

@@ -12,8 +12,11 @@
           "type": "string"
         }
       },
-      "required": ["path", "contents"],
+      "required": [
+        "path",
+        "contents"
+      ],
       "additionalProperties": false
     }
   }
-}
+}

package/schemas/agent-test-list.json

@@ -57,4 +57,4 @@
       "additionalProperties": false
     }
   }
-}
+}