@salesforce/agents 0.13.7 → 0.14.0

package/README.md

@@ -1,8 +1,8 @@
-# Salesforce Agents
+# Salesforce Agents - BETA
 
 ---
 
-### :warning: THIS LIBRARY IS UNDER DEVELOPMENT AND IS NOT MEANT FOR PRODUCTION USAGE. :warning:
+### :warning: All APIs are beta. :warning:
 
 ---
 

package/lib/agent.d.ts

@@ -1,5 +1,5 @@
 import { Connection, SfProject } from '@salesforce/core';
-import { type AgentCreateConfig, type AgentCreateResponse, type AgentJobSpec, type AgentJobSpecCreateConfig } from './types.js';
+import { type AgentCreateConfig, type AgentCreateResponse, type AgentJobSpec, type AgentJobSpecCreateConfig, type AgentOptions } from './types.js';
 /**
  * Events emitted during Agent.create() for consumers to listen to and keep track of progress
  *
@@ -11,38 +11,62 @@ export declare const AgentCreateLifecycleStages: {
     Retrieving: string;
 };
 /**
- * Class for creating Agents and agent specs.
+ * A client side representation of an agent within an org. Also provides utilities
+ * such as creating agents, listing agents, and creating agent specs.
+ *
+ * **Examples**
+ *
+ * Create a new instance and get the ID (uses the `Bot` ID):
+ *
+ * `const id = new Agent({connection, name}).getId();`
+ *
+ * Create a new agent in the org:
+ *
+ * `const myAgent = await Agent.create(connection, project, options);`
+ *
+ * List all agents in the local project:
+ *
+ * `const agentList = await Agent.list(project);`
  */
 export declare class Agent {
-    private project;
-    private logger;
-    private maybeMock;
-    private readonly connection;
+    private options;
+    private id?;
     /**
-     * Create an Agent instance
+     * Create an instance of an agent in an org. Must provide a connection to an org
+     * and the agent (Bot) API name as part of `AgentOptions`.
      *
-     * @param {Connection} connection
-     * @param {SfProject} project
+     * @param {options} AgentOptions
      */
-    constructor(connection: Connection, project: SfProject);
+    constructor(options: AgentOptions);
     /**
      * List all agents in the current project.
+     *
+     * @param project a `SfProject` for a local DX project.
      */
     static list(project: SfProject): Promise<string[]>;
     /**
      * Creates an agent from a configuration, optionally saving the agent in an org.
      *
-     * @param config a configuration for creating or previewing an agent
+     * @param connection a `Connection` to an org.
+     * @param project a `SfProject` for a local DX project.
+     * @param config a configuration for creating or previewing an agent.
      * @returns the agent definition
      */
-    create(config: AgentCreateConfig): Promise<AgentCreateResponse>;
+    static create(connection: Connection, project: SfProject, config: AgentCreateConfig): Promise<AgentCreateResponse>;
     /**
      * Create an agent spec from provided data.
      *
+     * @param connection a `Connection` to an org.
      * @param config The configuration used to generate an agent spec.
+     * @returns the agent job spec
+     */
+    static createSpec(connection: Connection, config: AgentJobSpecCreateConfig): Promise<AgentJobSpec>;
+    /**
+     * Returns the ID for this agent.
+     *
+     * @returns The ID of the agent (The `Bot` ID).
      */
-    createSpec(config: AgentJobSpecCreateConfig): Promise<AgentJobSpec>;
-    private verifyAgentSpecConfig;
+    getId(): Promise<string>;
 }
 /**
  * Generate an API name from an agent name. Matches what the UI does.

package/lib/agent.js

@@ -50,6 +50,13 @@ const maybe_mock_1 = require("./maybe-mock");
 const utils_1 = require("./utils");
 ;
 const messages = new core_1.Messages('@salesforce/agents', 'agents', new Map([["invalidAgentSpecConfig", "Missing one or more of the required agent spec arguments: type, role, companyName, companyDescription"], ["missingAgentName", "The \"agentName\" configuration property is required when saving an agent."], ["agentRetrievalError", "Unable to retrieve newly created Agent metadata. Due to: %s"], ["agentRetrievalErrorActions", "Retrieve the agent metadata using the \"project retrieve start\" command."]]));
+let logger;
+const getLogger = () => {
+    if (!logger) {
+        logger = core_1.Logger.childFromRoot('Agent');
+    }
+    return logger;
+};
 /**
  * Events emitted during Agent.create() for consumers to listen to and keep track of progress
  *
@@ -61,27 +68,39 @@ exports.AgentCreateLifecycleStages = {
     Retrieving: 'retrievingAgent',
 };
 /**
- * Class for creating Agents and agent specs.
+ * A client side representation of an agent within an org. Also provides utilities
+ * such as creating agents, listing agents, and creating agent specs.
+ *
+ * **Examples**
+ *
+ * Create a new instance and get the ID (uses the `Bot` ID):
+ *
+ * `const id = new Agent({connection, name}).getId();`
+ *
+ * Create a new agent in the org:
+ *
+ * `const myAgent = await Agent.create(connection, project, options);`
+ *
+ * List all agents in the local project:
+ *
+ * `const agentList = await Agent.list(project);`
  */
 class Agent {
-    project;
-    logger;
-    maybeMock;
-    connection;
+    options;
+    id;
     /**
-     * Create an Agent instance
+     * Create an instance of an agent in an org. Must provide a connection to an org
+     * and the agent (Bot) API name as part of `AgentOptions`.
      *
-     * @param {Connection} connection
-     * @param {SfProject} project
+     * @param {options} AgentOptions
      */
-    constructor(connection, project) {
-        this.project = project;
-        this.logger = core_1.Logger.childFromRoot(this.constructor.name);
-        this.maybeMock = new maybe_mock_1.MaybeMock(connection);
-        this.connection = connection;
+    constructor(options) {
+        this.options = options;
     }
     /**
      * List all agents in the current project.
+     *
+     * @param project a `SfProject` for a local DX project.
      */
     static async list(project) {
         const projectDirs = project.getPackageDirectories();
@@ -109,31 +128,34 @@ class Agent {
     /**
      * Creates an agent from a configuration, optionally saving the agent in an org.
      *
-     * @param config a configuration for creating or previewing an agent
+     * @param connection a `Connection` to an org.
+     * @param project a `SfProject` for a local DX project.
+     * @param config a configuration for creating or previewing an agent.
      * @returns the agent definition
      */
-    async create(config) {
+    static async create(connection, project, config) {
         const url = '/connect/ai-assist/create-agent';
+        const maybeMock = new maybe_mock_1.MaybeMock(connection);
         // When previewing agent creation just return the response.
         if (!config.saveAgent) {
-            this.logger.debug(`Previewing agent creation using config: ${(0, node_util_1.inspect)(config)} in project: ${this.project.getPath()}`);
+            getLogger().debug(`Previewing agent creation using config: ${(0, node_util_1.inspect)(config)} in project: ${project.getPath()}`);
             await core_1.Lifecycle.getInstance().emit(exports.AgentCreateLifecycleStages.Previewing, {});
-            const response = await this.maybeMock.request('POST', url, config);
+            const response = await maybeMock.request('POST', url, config);
             return decodeResponse(response);
         }
         if (!config.agentSettings?.agentName) {
             throw messages.createError('missingAgentName');
         }
-        this.logger.debug(`Creating agent using config: ${(0, node_util_1.inspect)(config)} in project: ${this.project.getPath()}`);
+        getLogger().debug(`Creating agent using config: ${(0, node_util_1.inspect)(config)} in project: ${project.getPath()}`);
         await core_1.Lifecycle.getInstance().emit(exports.AgentCreateLifecycleStages.Creating, {});
         if (!config.agentSettings.agentApiName) {
             config.agentSettings.agentApiName = (0, exports.generateAgentApiName)(config.agentSettings?.agentName);
         }
-        const response = await this.maybeMock.request('POST', url, config);
+        const response = await maybeMock.request('POST', url, config);
         // When saving agent creation we need to retrieve the created metadata.
         if (response.isSuccess) {
             await core_1.Lifecycle.getInstance().emit(exports.AgentCreateLifecycleStages.Retrieving, {});
-            const defaultPackagePath = this.project.getDefaultPackage().path ?? 'force-app';
+            const defaultPackagePath = project.getDefaultPackage().path ?? 'force-app';
             try {
                 const cs = await source_deploy_retrieve_1.ComponentSetBuilder.build({
                     metadata: {
@@ -141,12 +163,12 @@ class Agent {
                         directoryPaths: [defaultPackagePath],
                     },
                     org: {
-                        username: this.connection.getUsername(),
+                        username: connection.getUsername(),
                         exclude: [],
                     },
                 });
                 const retrieve = await cs.retrieve({
-                    usernameOrConnection: this.connection,
+                    usernameOrConnection: connection,
                     merge: true,
                     format: 'source',
                     output: defaultPackagePath,
@@ -180,10 +202,13 @@ class Agent {
     /**
      * Create an agent spec from provided data.
      *
+     * @param connection a `Connection` to an org.
      * @param config The configuration used to generate an agent spec.
+     * @returns the agent job spec
      */
-    async createSpec(config) {
-        this.verifyAgentSpecConfig(config);
+    static async createSpec(connection, config) {
+        const maybeMock = new maybe_mock_1.MaybeMock(connection);
+        verifyAgentSpecConfig(config);
         const url = '/connect/ai-assist/draft-agent-topics';
         const body = {
             agentType: config.agentType,
@@ -207,7 +232,7 @@ class Agent {
                 body.generationInfo.customizedInfo.groundingContext = config.groundingContext;
             }
         }
-        const response = await this.maybeMock.request('POST', url, body);
+        const response = await maybeMock.request('POST', url, body);
         const htmlDecodedResponse = decodeResponse(response);
         if (htmlDecodedResponse.isSuccess) {
             return { ...config, topics: htmlDecodedResponse.topicDrafts };
@@ -220,15 +245,27 @@ class Agent {
             });
         }
     }
-    // eslint-disable-next-line class-methods-use-this
-    verifyAgentSpecConfig(config) {
-        const { agentType, role, companyName, companyDescription } = config;
-        if (!agentType || !role || !companyName || !companyDescription) {
-            throw messages.createError('invalidAgentSpecConfig');
+    /**
+     * Returns the ID for this agent.
+     *
+     * @returns The ID of the agent (The `Bot` ID).
+     */
+    async getId() {
+        if (!this.id) {
+            const query = `SELECT Id FROM BotDefinition WHERE DeveloperName = '${this.options.name}'`;
+            this.id = (await this.options.connection.singleRecordQuery(query)).Id;
         }
+        return this.id;
     }
 }
 exports.Agent = Agent;
+// private function used by Agent.createSpec()
+const verifyAgentSpecConfig = (config) => {
+    const { agentType, role, companyName, companyDescription } = config;
+    if (!agentType || !role || !companyName || !companyDescription) {
+        throw messages.createError('invalidAgentSpecConfig');
+    }
+};
 /**
  * Generate an API name from an agent name. Matches what the UI does.
  */
@@ -243,8 +280,8 @@ const generateAgentApiName = (agentName) => {
         .replace(/(^\d+)/, 'X$1')
         .slice(0, maxLength)
         .replace(/_$/, '');
-    const logger = core_1.Logger.childFromRoot('Agent-GenApiName');
-    logger.debug(`Generated Agent API name: [${apiName}] from Agent name: [${agentName}]`);
+    const genLogger = core_1.Logger.childFromRoot('Agent-GenApiName');
+    genLogger.debug(`Generated Agent API name: [${apiName}] from Agent name: [${agentName}]`);
     return apiName;
 };
 exports.generateAgentApiName = generateAgentApiName;

package/lib/agent.js.map

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

package/lib/agentPreview.d.ts

@@ -1,70 +1,59 @@
 import { Connection } from '@salesforce/core';
-type ApiStatus = {
-    status: 'UP' | 'DOWN';
-};
-type Href = {
-    href: string;
-};
-export type AgentPreviewError = {
-    status: number;
-    path: string;
-    requestId: string;
-    error: string;
-    message: string;
-    timestamp: number;
-};
-export type AgentPreviewMessageLinks = {
-    self: Href | null;
-    messages: Href | null;
-    session: Href | null;
-    end: Href | null;
-};
-export type MessageType = 'Inform' | 'TextChunk' | 'ProgressIndicator' | 'Inquire' | 'Confirm' | 'Failure' | 'Escalate' | 'SessionEnded' | 'EndOfTurn' | 'Error';
-export type AgentPreviewMessage = {
-    type: MessageType;
-    id: string;
-    feedbackId: string;
-    planId: string;
-    isContentSafe: boolean;
-    message: string;
-    result: {
-        type: string;
-        property: string;
-        value: any;
-    };
-    citedReferences: {
-        type: string;
-        value: string;
-    };
-};
-export type AgentPreviewStartResponse = {
-    sessionId: string;
-    _links: AgentPreviewMessageLinks;
-    messages: AgentPreviewMessage[];
-};
-export type AgentPreviewSendResponse = {
-    messages: AgentPreviewMessage[];
-    _links: AgentPreviewMessageLinks;
-};
-export type AgentPreviewEndMessage = {
-    type: string;
-    id: string;
-    reason: string;
-    feedbackId: string;
-};
-export type AgentPreviewEndResponse = {
-    messages: AgentPreviewEndMessage[];
-    _links: AgentPreviewMessageLinks;
-};
-type EndReason = 'UserRequest' | 'Transfer' | 'Expiration' | 'Error' | 'Other';
+import { type AgentPreviewEndResponse, type AgentPreviewStartResponse, type AgentPreviewSendResponse, type ApiStatus, type EndReason } from './types.js';
+/**
+ * A service to interact with an agent. Start an interactive session,
+ * send messages to the agent, and end the session.
+ *
+ * **Examples**
+ *
+ * Create an instance of the service:
+ *
+ * `const agentPreview = new AgentPreview(connection);`
+ *
+ * Start an interactive session:
+ *
+ * `const { sessionId } = await agentPreview.start(botId);`
+ *
+ * Send a message to the agent using the session ID from the startResponse:
+ *
+ * `const sendResponse = await agentPreview.send(sessionId, message);`
+ *
+ * End an interactive session:
+ *
+ * `await agentPreview.end(sessionId, 'UserRequest');`
+ */
 export declare class AgentPreview {
     private apiBase;
     private instanceUrl;
     private maybeMock;
     constructor(connection: Connection);
+    /**
+     * Start an interactive session with the provided agent.
+     *
+     * @param botId The ID of the agent (`Bot` ID).
+     * @returns `AgentPreviewStartResponse`, which includes a session ID needed for other actions.
+     */
     start(botId: string): Promise<AgentPreviewStartResponse>;
+    /**
+     * Send a message to the agent using the session ID obtained by calling `start()`.
+     *
+     * @param sessionId A session ID provided by first calling `agentPreview.start()`.
+     * @param message A message to send to the agent.
+     * @returns `AgentPreviewSendResponse`
+     */
     send(sessionId: string, message: string): Promise<AgentPreviewSendResponse>;
+    /**
+     * Ends an interactive session with the agent.
+     *
+     * @param sessionId A session ID provided by first calling `agentPreview.start()`.
+     * @param reason A reason why the interactive session was ended.
+     * @returns `AgentPreviewEndResponse`
+     */
     end(sessionId: string, reason: EndReason): Promise<AgentPreviewEndResponse>;
+    /**
+     * Get the status of the Agent API (UP | DOWN).
+     *
+     * @returns `ApiStatus`
+     */
     status(): Promise<ApiStatus>;
 }
-export {};

package/lib/agentPreview.js

@@ -10,6 +10,28 @@ exports.AgentPreview = void 0;
 const node_crypto_1 = require("node:crypto");
 const core_1 = require("@salesforce/core");
 const maybe_mock_1 = require("./maybe-mock");
+/**
+ * A service to interact with an agent. Start an interactive session,
+ * send messages to the agent, and end the session.
+ *
+ * **Examples**
+ *
+ * Create an instance of the service:
+ *
+ * `const agentPreview = new AgentPreview(connection);`
+ *
+ * Start an interactive session:
+ *
+ * `const { sessionId } = await agentPreview.start(botId);`
+ *
+ * Send a message to the agent using the session ID from the startResponse:
+ *
+ * `const sendResponse = await agentPreview.send(sessionId, message);`
+ *
+ * End an interactive session:
+ *
+ * `await agentPreview.end(sessionId, 'UserRequest');`
+ */
 class AgentPreview {
     apiBase;
     instanceUrl;
@@ -19,6 +41,12 @@ class AgentPreview {
         this.instanceUrl = connection.instanceUrl;
         this.maybeMock = new maybe_mock_1.MaybeMock(connection);
     }
+    /**
+     * Start an interactive session with the provided agent.
+     *
+     * @param botId The ID of the agent (`Bot` ID).
+     * @returns `AgentPreviewStartResponse`, which includes a session ID needed for other actions.
+     */
     async start(botId) {
         const url = `${this.apiBase}/agents/${botId}/sessions`;
         const body = {
@@ -38,6 +66,13 @@ class AgentPreview {
             throw core_1.SfError.wrap(err);
         }
     }
+    /**
+     * Send a message to the agent using the session ID obtained by calling `start()`.
+     *
+     * @param sessionId A session ID provided by first calling `agentPreview.start()`.
+     * @param message A message to send to the agent.
+     * @returns `AgentPreviewSendResponse`
+     */
     async send(sessionId, message) {
         const url = `${this.apiBase}/sessions/${sessionId}/messages`;
         const body = {
@@ -57,6 +92,13 @@ class AgentPreview {
             throw core_1.SfError.wrap(err);
         }
     }
+    /**
+     * Ends an interactive session with the agent.
+     *
+     * @param sessionId A session ID provided by first calling `agentPreview.start()`.
+     * @param reason A reason why the interactive session was ended.
+     * @returns `AgentPreviewEndResponse`
+     */
     async end(sessionId, reason) {
         const url = `${this.apiBase}/sessions/${sessionId}`;
         try {
@@ -69,7 +111,11 @@ class AgentPreview {
             throw core_1.SfError.wrap(err);
         }
     }
-    // Get the status of the Agent API (UP | DOWN)
+    /**
+     * Get the status of the Agent API (UP | DOWN).
+     *
+     * @returns `ApiStatus`
+     */
     async status() {
         const base = 'https://test.api.salesforce.com';
         const url = `${base}/einstein/ai-agent/v1/status`;

package/lib/agentPreview.js.map

@@ -1 +1 @@
-{"version":3,"file":"agentPreview.js","sourceRoot":"","sources":["../src/agentPreview.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,6CAAyC;AACzC,2CAA2C;AAE3C,6CAAyC;AAgFzC,MAAa,YAAY;IACf,OAAO,CAAS;IAChB,WAAW,CAAS;IACpB,SAAS,CAAY;IAE7B,YAAmB,UAAsB;QACvC,IAAI,CAAC,OAAO,GAAG,iDAAiD,CAAC;QACjE,IAAI,CAAC,WAAW,GAAG,UAAU,CAAC,WAAW,CAAC;QAC1C,IAAI,CAAC,SAAS,GAAG,IAAI,sBAAS,CAAC,UAAU,CAAC,CAAC;IAC7C,CAAC;IAEM,KAAK,CAAC,KAAK,CAAC,KAAa;QAC9B,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,OAAO,WAAW,KAAK,WAAW,CAAC;QAEvD,MAAM,IAAI,GAAG;YACX,kBAAkB,EAAE,IAAA,wBAAU,GAAE;YAChC,cAAc,EAAE;gBACd,QAAQ,EAAE,IAAI,CAAC,WAAW;aAC3B;YACD,qBAAqB,EAAE;gBACrB,UAAU,EAAE,CAAC,MAAM,CAAC;aACrB;YACD,UAAU,EAAE,IAAI;SACjB,CAAC;QAEF,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,CAA4B,MAAM,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;QACpF,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,cAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IAEM,KAAK,CAAC,IAAI,CAAC,SAAiB,EAAE,OAAe;QAClD,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,OAAO,aAAa,SAAS,WAAW,CAAC;QAC7D,MAAM,IAAI,GAAG;YACX,OAAO,EAAE;gBACP,+GAA+G;gBAC/G,8HAA8H;gBAC9H,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE;gBACtB,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,OAAO;aACd;YACD,SAAS,EAAE,EAAE;SACd,CAAC;QAEF,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,CAA2B,MAAM,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;QACnF,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,cAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IAEM,KAAK,CAAC,GAAG,CAAC,SAAiB,EAAE,MAAiB;QACnD,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,OAAO,aAAa,SAAS,EAAE,CAAC;QAEpD,IAAI,CAAC;YACH,iGAAiG;YACjG,OAAO,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,CAA0B,QAAQ,EAAE,GAAG,EAAE,SAAS,EAAE;gBACrF,sBAAsB,EAAE,MAAM;aAC/B,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,cAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IAED,8CAA8C;IACvC,KAAK,CAAC,MAAM;QACjB,MAAM,IAAI,GAAG,iCAAiC,CAAC;QAC/C,MAAM,GAAG,GAAG,GAAG,IAAI,8BAA8B,CAAC;QAElD,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,CAAY,KAAK,EAAE,GAAG,CAAC,CAAC;QAC7D,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,cAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;CACF;AA5ED,oCA4EC"}
+{"version":3,"file":"agentPreview.js","sourceRoot":"","sources":["../src/agentPreview.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,6CAAyC;AACzC,2CAA2C;AAE3C,6CAAyC;AASzC;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAa,YAAY;IACf,OAAO,CAAS;IAChB,WAAW,CAAS;IACpB,SAAS,CAAY;IAE7B,YAAmB,UAAsB;QACvC,IAAI,CAAC,OAAO,GAAG,iDAAiD,CAAC;QACjE,IAAI,CAAC,WAAW,GAAG,UAAU,CAAC,WAAW,CAAC;QAC1C,IAAI,CAAC,SAAS,GAAG,IAAI,sBAAS,CAAC,UAAU,CAAC,CAAC;IAC7C,CAAC;IAED;;;;;OAKG;IACI,KAAK,CAAC,KAAK,CAAC,KAAa;QAC9B,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,OAAO,WAAW,KAAK,WAAW,CAAC;QAEvD,MAAM,IAAI,GAAG;YACX,kBAAkB,EAAE,IAAA,wBAAU,GAAE;YAChC,cAAc,EAAE;gBACd,QAAQ,EAAE,IAAI,CAAC,WAAW;aAC3B;YACD,qBAAqB,EAAE;gBACrB,UAAU,EAAE,CAAC,MAAM,CAAC;aACrB;YACD,UAAU,EAAE,IAAI;SACjB,CAAC;QAEF,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,CAA4B,MAAM,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;QACpF,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,cAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACI,KAAK,CAAC,IAAI,CAAC,SAAiB,EAAE,OAAe;QAClD,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,OAAO,aAAa,SAAS,WAAW,CAAC;QAC7D,MAAM,IAAI,GAAG;YACX,OAAO,EAAE;gBACP,+GAA+G;gBAC/G,8HAA8H;gBAC9H,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE;gBACtB,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,OAAO;aACd;YACD,SAAS,EAAE,EAAE;SACd,CAAC;QAEF,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,CAA2B,MAAM,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;QACnF,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,cAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACI,KAAK,CAAC,GAAG,CAAC,SAAiB,EAAE,MAAiB;QACnD,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,OAAO,aAAa,SAAS,EAAE,CAAC;QAEpD,IAAI,CAAC;YACH,iGAAiG;YACjG,OAAO,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,CAA0B,QAAQ,EAAE,GAAG,EAAE,SAAS,EAAE;gBACrF,sBAAsB,EAAE,MAAM;aAC/B,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,cAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IAED;;;;OAIG;IACI,KAAK,CAAC,MAAM;QACjB,MAAM,IAAI,GAAG,iCAAiC,CAAC;QAC/C,MAAM,GAAG,GAAG,GAAG,IAAI,8BAA8B,CAAC;QAElD,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,CAAY,KAAK,EAAE,GAAG,CAAC,CAAC;QAC7D,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,cAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;CACF;AApGD,oCAoGC"}

package/lib/agentTester.d.ts

@@ -1,68 +1,10 @@
 import { Connection } from '@salesforce/core';
 import { Duration } from '@salesforce/kit';
-import { DeployResult, FileProperties } from '@salesforce/source-deploy-retrieve';
-export type TestStatus = 'NEW' | 'IN_PROGRESS' | 'COMPLETED' | 'ERROR' | 'TERMINATED';
-export type AgentTestStartResponse = {
-    runId: string;
-    status: TestStatus;
-};
-export type AgentTestStatusResponse = {
-    status: TestStatus;
-    startTime: string;
-    endTime?: string;
-    errorMessage?: string;
-};
-export type TestCaseResult = {
-    status: TestStatus;
-    startTime: string;
-    endTime?: string;
-    inputs: {
-        utterance: string;
-    };
-    generatedData: {
-        actionsSequence: string[];
-        outcome: string;
-        topic: string;
-    };
-    testResults: Array<{
-        name: string;
-        actualValue: string;
-        expectedValue: string;
-        score: number;
-        result: null | 'PASS' | 'FAILURE';
-        metricLabel: 'Accuracy' | 'Precision';
-        metricExplainability: string;
-        status: TestStatus;
-        startTime: string;
-        endTime?: string;
-        errorCode?: string;
-        errorMessage?: string;
-    }>;
-    testNumber: number;
-};
-export type AgentTestResultsResponse = {
-    status: TestStatus;
-    startTime: string;
-    endTime?: string;
-    errorMessage?: string;
-    subjectName: string;
-    testCases: TestCaseResult[];
-};
-export type AvailableDefinition = Omit<FileProperties, 'manageableState' | 'namespacePrefix'>;
-export type TestCase = {
-    utterance: string;
-    expectedActions: string[] | undefined;
-    expectedOutcome: string | undefined;
-    expectedTopic: string | undefined;
-};
-export type TestSpec = {
-    name: string;
-    description?: string;
-    subjectType: string;
-    subjectName: string;
-    subjectVersion?: string;
-    testCases: TestCase[];
-};
+import { DeployResult } from '@salesforce/source-deploy-retrieve';
+import { type AvailableDefinition, type AgentTestStartResponse, type AgentTestStatusResponse, type AgentTestResultsResponse, type TestSpec } from './types.js';
+/**
+ * Events emitted during agent test creation for consumers to listen to and keep track of progress.
+ */
 export declare const AgentTestCreateLifecycleStages: {
     CreatingLocalMetadata: string;
     Waiting: string;
@@ -70,7 +12,26 @@ export declare const AgentTestCreateLifecycleStages: {
     Done: string;
 };
 /**
- * AgentTester class to test Agents
+ * A service for testing agents using `AiEvaluationDefinition` metadata. Start asynchronous
+ * test runs, get or poll for test status, and get detailed test results.
+ *
+ * **Examples**
+ *
+ * Create an instance of the service:
+ *
+ * `const agentTester = new AgentTester(connection);`
+ *
+ * Start a test run:
+ *
+ * `const startResponse = await agentTester.start(aiEvalDef);`
+ *
+ * Get the status for a test run:
+ *
+ * `const status = await agentTester.status(startResponse.runId);`
+ *
+ * Get detailed results for a test run:
+ *
+ * `const results = await agentTester.results(startResponse.runId);`
  */
 export declare class AgentTester {
     private connection;
@@ -81,21 +42,21 @@ export declare class AgentTester {
      */
     list(): Promise<AvailableDefinition[]>;
     /**
-     * Initiates an AI evaluation run.
+     * Initiates a test run (i.e., AI evaluation).
      *
      * @param aiEvalDefName - The name of the AI evaluation definition to run.
      * @returns Promise that resolves with the response from starting the test.
      */
     start(aiEvalDefName: string): Promise<AgentTestStartResponse>;
     /**
-     * Get the status of a test run
+     * Get the status of a test run.
      *
      * @param {string} jobId
      * @returns {Promise<AgentTestStatusResponse>}
      */
     status(jobId: string): Promise<AgentTestStatusResponse>;
     /**
-     * Poll for a test run to complete
+     * Poll the status of a test run until the tests are complete or the timeout is reached.
      *
      * @param {string} jobId
      * @param {Duration} timeout
@@ -105,14 +66,14 @@ export declare class AgentTester {
         timeout?: Duration;
     }): Promise<AgentTestResultsResponse>;
     /**
-     * Request test run details
+     * Get detailed test run results.
      *
      * @param {string} jobId
      * @returns {Promise<AgentTestResultsResponse>}
      */
     results(jobId: string): Promise<AgentTestResultsResponse>;
     /**
-     * Cancel an in-progress test run
+     * Cancel an in-progress test run.
      *
      * @param {string} jobId
      * @returns {Promise<{success: boolean}>}
@@ -145,6 +106,13 @@ export declare class AgentTester {
         deployResult?: DeployResult;
     }>;
 }
+/**
+ * Convert the raw, detailed test results to another format.
+ *
+ * @param results The detailed results from a test run.
+ * @param format The desired format. One of: json, junit, or tap.
+ * @returns
+ */
 export declare function convertTestResultsToFormat(results: AgentTestResultsResponse, format: 'json' | 'junit' | 'tap'): Promise<string>;
 /**
  * Normalizes test results by decoding HTML entities in utterances and test result values.
@@ -153,6 +121,7 @@ export declare function convertTestResultsToFormat(results: AgentTestResultsResp
  * @returns A new AgentTestResultsResponse with decoded HTML entities
  *
  * @example
+ * ```
  * const results = {
  *   testCases: [{
  *     inputs: { utterance: "&quot;hello&quot;" },
@@ -163,6 +132,7 @@ export declare function convertTestResultsToFormat(results: AgentTestResultsResp
  *   }]
  * };
  * const normalized = normalizeResults(results);
+ * ```
  */
 export declare function normalizeResults(results: AgentTestResultsResponse): AgentTestResultsResponse;
 export declare function humanFriendlyName(name: string): string;

package/lib/agentTester.js

@@ -1,4 +1,10 @@
 "use strict";
+/*
+ * 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
+ */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AgentTester = exports.AgentTestCreateLifecycleStages = void 0;
 exports.convertTestResultsToFormat = convertTestResultsToFormat;
@@ -6,13 +12,6 @@ exports.normalizeResults = normalizeResults;
 exports.humanFriendlyName = humanFriendlyName;
 exports.writeTestSpec = writeTestSpec;
 exports.generateTestSpecFromAiEvalDefinition = generateTestSpecFromAiEvalDefinition;
-/*
- * 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
- */
-/* eslint-disable jsdoc/check-indentation */
 const promises_1 = require("node:fs/promises");
 const node_path_1 = require("node:path");
 const core_1 = require("@salesforce/core");
@@ -22,6 +21,9 @@ const yaml_1 = require("yaml");
 const fast_xml_parser_1 = require("fast-xml-parser");
 const maybe_mock_1 = require("./maybe-mock");
 const utils_1 = require("./utils");
+/**
+ * Events emitted during agent test creation for consumers to listen to and keep track of progress.
+ */
 exports.AgentTestCreateLifecycleStages = {
     CreatingLocalMetadata: 'Creating Local Metadata',
     Waiting: 'Waiting for the org to respond',
@@ -29,7 +31,26 @@ exports.AgentTestCreateLifecycleStages = {
     Done: 'Done',
 };
 /**
- * AgentTester class to test Agents
+ * A service for testing agents using `AiEvaluationDefinition` metadata. Start asynchronous
+ * test runs, get or poll for test status, and get detailed test results.
+ *
+ * **Examples**
+ *
+ * Create an instance of the service:
+ *
+ * `const agentTester = new AgentTester(connection);`
+ *
+ * Start a test run:
+ *
+ * `const startResponse = await agentTester.start(aiEvalDef);`
+ *
+ * Get the status for a test run:
+ *
+ * `const status = await agentTester.status(startResponse.runId);`
+ *
+ * Get detailed results for a test run:
+ *
+ * `const results = await agentTester.results(startResponse.runId);`
  */
 class AgentTester {
     connection;
@@ -45,7 +66,7 @@ class AgentTester {
         return this.connection.metadata.list({ type: 'AiEvaluationDefinition' });
     }
     /**
-     * Initiates an AI evaluation run.
+     * Initiates a test run (i.e., AI evaluation).
      *
      * @param aiEvalDefName - The name of the AI evaluation definition to run.
      * @returns Promise that resolves with the response from starting the test.
@@ -57,7 +78,7 @@ class AgentTester {
         });
     }
     /**
-     * Get the status of a test run
+     * Get the status of a test run.
      *
      * @param {string} jobId
      * @returns {Promise<AgentTestStatusResponse>}
@@ -67,7 +88,7 @@ class AgentTester {
         return this.maybeMock.request('GET', url);
     }
     /**
-     * Poll for a test run to complete
+     * Poll the status of a test run until the tests are complete or the timeout is reached.
      *
      * @param {string} jobId
      * @param {Duration} timeout
@@ -113,7 +134,7 @@ class AgentTester {
         return client.subscribe();
     }
     /**
-     * Request test run details
+     * Get detailed test run results.
      *
      * @param {string} jobId
      * @returns {Promise<AgentTestResultsResponse>}
@@ -124,7 +145,7 @@ class AgentTester {
         return normalizeResults(results);
     }
     /**
-     * Cancel an in-progress test run
+     * Cancel an in-progress test run.
      *
      * @param {string} jobId
      * @returns {Promise<{success: boolean}>}
@@ -228,6 +249,13 @@ class AgentTester {
     }
 }
 exports.AgentTester = AgentTester;
+/**
+ * Convert the raw, detailed test results to another format.
+ *
+ * @param results The detailed results from a test run.
+ * @param format The desired format. One of: json, junit, or tap.
+ * @returns
+ */
 async function convertTestResultsToFormat(results, format) {
     switch (format) {
         case 'json':
@@ -247,6 +275,7 @@ async function convertTestResultsToFormat(results, format) {
  * @returns A new AgentTestResultsResponse with decoded HTML entities
  *
  * @example
+ * ```
  * const results = {
  *   testCases: [{
  *     inputs: { utterance: "&quot;hello&quot;" },
@@ -257,6 +286,7 @@ async function convertTestResultsToFormat(results, format) {
  *   }]
  * };
  * const normalized = normalizeResults(results);
+ * ```
  */
 function normalizeResults(results) {
     return {

package/lib/agentTester.js.map

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

package/lib/index.d.ts

@@ -1,4 +1,4 @@
-export { type AgentCreateConfig, type AgentCreateResponse, type AgentJobSpec, type AgentJobSpecCreateConfig, type AgentTone, type AgentType, type DraftAgentTopics, type DraftAgentTopicsBody, type DraftAgentTopicsResponse, } from './types';
+export { type AgentCreateConfig, type AgentCreateResponse, type AgentJobSpec, type AgentJobSpecCreateConfig, type AgentOptions, type AgentTone, type AgentType, type AgentPreviewMessageLinks, type AgentPreviewMessage, type AgentPreviewStartResponse, type AgentPreviewSendResponse, type AgentPreviewEndResponse, type DraftAgentTopics, type DraftAgentTopicsBody, type DraftAgentTopicsResponse, type AvailableDefinition, type AgentTestResultsResponse, type AgentTestStartResponse, type AgentTestStatusResponse, type TestCaseResult, type TestStatus, } from './types';
 export { Agent, AgentCreateLifecycleStages, generateAgentApiName } from './agent';
-export { AgentTester, AgentTestCreateLifecycleStages, convertTestResultsToFormat, writeTestSpec, generateTestSpecFromAiEvalDefinition, humanFriendlyName, type AvailableDefinition, type AgentTestResultsResponse, type AgentTestStartResponse, type AgentTestStatusResponse, type TestCaseResult, type TestStatus, } from './agentTester';
-export { AgentPreview, type AgentPreviewMessageLinks, type AgentPreviewMessage, type AgentPreviewStartResponse, type AgentPreviewSendResponse, type AgentPreviewEndResponse, } from './agentPreview';
+export { AgentTester, AgentTestCreateLifecycleStages, convertTestResultsToFormat, writeTestSpec, generateTestSpecFromAiEvalDefinition, humanFriendlyName, } from './agentTester';
+export { AgentPreview } from './agentPreview';

package/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAaH,iCAAkF;AAAzE,8FAAA,KAAK,OAAA;AAAE,mHAAA,0BAA0B,OAAA;AAAE,6GAAA,oBAAoB,OAAA;AAChE,6CAauB;AAZrB,0GAAA,WAAW,OAAA;AACX,6HAAA,8BAA8B,OAAA;AAC9B,yHAAA,0BAA0B,OAAA;AAC1B,4GAAA,aAAa,OAAA;AACb,mIAAA,oCAAoC,OAAA;AACpC,gHAAA,iBAAiB,OAAA;AAQnB,+CAOwB;AANtB,4GAAA,YAAY,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAyBH,iCAAkF;AAAzE,8FAAA,KAAK,OAAA;AAAE,mHAAA,0BAA0B,OAAA;AAAE,6GAAA,oBAAoB,OAAA;AAChE,6CAOuB;AANrB,0GAAA,WAAW,OAAA;AACX,6HAAA,8BAA8B,OAAA;AAC9B,yHAAA,0BAA0B,OAAA;AAC1B,4GAAA,aAAa,OAAA;AACb,mIAAA,oCAAoC,OAAA;AACpC,gHAAA,iBAAiB,OAAA;AAEnB,+CAA8C;AAArC,4GAAA,YAAY,OAAA"}

package/lib/types.d.ts

@@ -1,3 +1,13 @@
+import { Connection, SfProject } from '@salesforce/core';
+import { FileProperties } from '@salesforce/source-deploy-retrieve';
+/**
+ * Options for creating instances of agents from an org.
+ */
+export type AgentOptions = {
+    connection: Connection;
+    project?: SfProject;
+    name: string;
+};
 /**
  * An agent job spec is a list of job titles and descriptions
  * to be performed by the agent.
@@ -179,3 +189,142 @@ export type DraftAgentTopicsResponse = {
     errorMessage?: string;
     topicDrafts: DraftAgentTopics;
 };
+export type TestStatus = 'NEW' | 'IN_PROGRESS' | 'COMPLETED' | 'ERROR' | 'TERMINATED';
+export type AgentTestStartResponse = {
+    runId: string;
+    status: TestStatus;
+};
+export type AgentTestStatusResponse = {
+    status: TestStatus;
+    startTime: string;
+    endTime?: string;
+    errorMessage?: string;
+};
+export type TestCaseResult = {
+    status: TestStatus;
+    startTime: string;
+    endTime?: string;
+    inputs: {
+        utterance: string;
+    };
+    generatedData: {
+        actionsSequence: string[];
+        outcome: string;
+        topic: string;
+    };
+    testResults: Array<{
+        name: string;
+        actualValue: string;
+        expectedValue: string;
+        score: number;
+        result: null | 'PASS' | 'FAILURE';
+        metricLabel: 'Accuracy' | 'Precision';
+        metricExplainability: string;
+        status: TestStatus;
+        startTime: string;
+        endTime?: string;
+        errorCode?: string;
+        errorMessage?: string;
+    }>;
+    testNumber: number;
+};
+export type AgentTestResultsResponse = {
+    status: TestStatus;
+    startTime: string;
+    endTime?: string;
+    errorMessage?: string;
+    subjectName: string;
+    testCases: TestCaseResult[];
+};
+export type AvailableDefinition = Omit<FileProperties, 'manageableState' | 'namespacePrefix'>;
+export type TestCase = {
+    utterance: string;
+    expectedActions: string[] | undefined;
+    expectedOutcome: string | undefined;
+    expectedTopic: string | undefined;
+};
+export type TestSpec = {
+    name: string;
+    description?: string;
+    subjectType: string;
+    subjectName: string;
+    subjectVersion?: string;
+    testCases: TestCase[];
+};
+export type AiEvaluationDefinition = {
+    AiEvaluationDefinition: {
+        description?: string;
+        name: string;
+        subjectType: 'AGENT';
+        subjectName: string;
+        subjectVersion?: string;
+        testCase: Array<{
+            expectation: Array<{
+                name: string;
+                expectedValue: string;
+            }>;
+            inputs: {
+                utterance: string;
+            };
+        }>;
+    };
+};
+export type ApiStatus = {
+    status: 'UP' | 'DOWN';
+};
+type Href = {
+    href: string;
+};
+export type AgentPreviewError = {
+    status: number;
+    path: string;
+    requestId: string;
+    error: string;
+    message: string;
+    timestamp: number;
+};
+export type AgentPreviewMessageLinks = {
+    self: Href | null;
+    messages: Href | null;
+    session: Href | null;
+    end: Href | null;
+};
+export type MessageType = 'Inform' | 'TextChunk' | 'ProgressIndicator' | 'Inquire' | 'Confirm' | 'Failure' | 'Escalate' | 'SessionEnded' | 'EndOfTurn' | 'Error';
+export type AgentPreviewMessage = {
+    type: MessageType;
+    id: string;
+    feedbackId: string;
+    planId: string;
+    isContentSafe: boolean;
+    message: string;
+    result: {
+        type: string;
+        property: string;
+        value: any;
+    };
+    citedReferences: {
+        type: string;
+        value: string;
+    };
+};
+export type AgentPreviewStartResponse = {
+    sessionId: string;
+    _links: AgentPreviewMessageLinks;
+    messages: AgentPreviewMessage[];
+};
+export type AgentPreviewSendResponse = {
+    messages: AgentPreviewMessage[];
+    _links: AgentPreviewMessageLinks;
+};
+export type AgentPreviewEndMessage = {
+    type: string;
+    id: string;
+    reason: string;
+    feedbackId: string;
+};
+export type AgentPreviewEndResponse = {
+    messages: AgentPreviewEndMessage[];
+    _links: AgentPreviewMessageLinks;
+};
+export type EndReason = 'UserRequest' | 'Transfer' | 'Expiration' | 'Error' | 'Other';
+export {};

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@salesforce/agents",
   "description": "Client side APIs for working with Salesforce agents",
-  "version": "0.13.7",
+  "version": "0.14.0",
   "license": "BSD-3-Clause",
   "author": "Salesforce",
   "main": "lib/index",
@@ -16,7 +16,7 @@
     "@salesforce/source-deploy-retrieve": "^12.18.2",
     "fast-xml-parser": "^4.5.3",
     "nock": "^13.5.6",
-    "yaml": "^2.7.0"
+    "yaml": "^2.7.1"
   },
   "devDependencies": {
     "@salesforce/cli-plugins-testkit": "^5.3.39",