npm - @salesforce/agents - Versions diffs - 0.4.0 → 0.4.1 - Mend

@salesforce/agents 0.4.0 → 0.4.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (8) hide show

package/lib/agent.d.ts CHANGED Viewed

@@ -1,5 +1,11 @@
 import { Connection, SfProject } from '@salesforce/core';
 import { type SfAgent, type AgentCreateConfig, type AgentCreateResponse, type AgentJobSpec, type AgentJobSpecCreateConfig } from './types.js';
+export declare const AgentCreateLifecycleStages: {
+    CreatingLocally: string;
+    DeployingMetadata: string;
+    CreatingRemotely: string;
+    RetrievingMetadata: string;
+};
 /**
  * Class for creating Agents and agent specs.
  */
@@ -7,7 +13,15 @@ export declare class Agent implements SfAgent {
     private project;
     private logger;
     private maybeMock;
+    private readonly connection;
     constructor(connection: Connection, project: SfProject);
+    /**
+     * From an AgentCreateConfig, deploy the required metadata, call the connect/attach-agent-topics endpoint, and then retrieve
+     * the newly updated metadata back to the local project
+     *
+     * @param {AgentCreateConfig} config
+     * @returns {Promise<AgentCreateResponse>}
+     */
     create(config: AgentCreateConfig): Promise<AgentCreateResponse>;
     /**
      * Create an agent spec from provided data.
@@ -17,4 +31,5 @@ export declare class Agent implements SfAgent {
     createSpec(config: AgentJobSpecCreateConfig): Promise<AgentJobSpec>;
     private verifyAgentSpecConfig;
     private buildAgentJobSpecUrl;
+    private createMetadata;
 }

package/lib/agent.js CHANGED Viewed

@@ -5,12 +5,24 @@
  * 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
  */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Agent = void 0;
+exports.Agent = exports.AgentCreateLifecycleStages = void 0;
 const node_util_1 = require("node:util");
+const node_path_1 = __importDefault(require("node:path"));
+const node_fs_1 = __importDefault(require("node:fs"));
 const core_1 = require("@salesforce/core");
+const source_deploy_retrieve_1 = require("@salesforce/source-deploy-retrieve");
 const kit_1 = require("@salesforce/kit");
 const maybe_mock_1 = require("./maybe-mock");
+exports.AgentCreateLifecycleStages = {
+    CreatingLocally: 'creatinglocally',
+    DeployingMetadata: 'deployingmetadata',
+    CreatingRemotely: 'creatingremotely',
+    RetrievingMetadata: 'retrievingmetadata',
+};
 /**
  * Class for creating Agents and agent specs.
  */
@@ -18,18 +30,60 @@ class Agent {
     project;
     logger;
     maybeMock;
+    connection;
     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;
     }
+    /**
+     * From an AgentCreateConfig, deploy the required metadata, call the connect/attach-agent-topics endpoint, and then retrieve
+     * the newly updated metadata back to the local project
+     *
+     * @param {AgentCreateConfig} config
+     * @returns {Promise<AgentCreateResponse>}
+     */
     async create(config) {
         this.logger.debug(`Creating Agent using config: ${(0, node_util_1.inspect)(config)} in project: ${this.project.getPath()}`);
-        // Generate a GenAiPlanner in the local project and deploy
-        // make API request to /services/data/{api-version}/connect/attach-agent-topics
-        await (0, kit_1.sleep)(kit_1.Duration.seconds(3));
-        // on success, retrieve all Agent metadata
-        return { isSuccess: true };
+        await core_1.Lifecycle.getInstance().emit(exports.AgentCreateLifecycleStages.CreatingLocally, {});
+        const sourcepaths = await this.createMetadata(config);
+        await core_1.Lifecycle.getInstance().emit(exports.AgentCreateLifecycleStages.DeployingMetadata, {});
+        const cs = await source_deploy_retrieve_1.ComponentSetBuilder.build({ sourcepath: sourcepaths });
+        const deploy = await cs.deploy({ usernameOrConnection: this.connection });
+        const result = await deploy.pollStatus({ timeout: kit_1.Duration.minutes(10_000), frequency: kit_1.Duration.seconds(1) });
+        if (!result.response.success) {
+            throw new core_1.SfError(result.response.errorMessage ?? `Unable to deploy ${result.response.id}`);
+        }
+        await core_1.Lifecycle.getInstance().emit(exports.AgentCreateLifecycleStages.CreatingRemotely, {});
+        const plannerId = (await this.connection.singleRecordQuery(`SELECT Id
+           FROM GenAiPlanner
+           WHERE MasterLabel = 'MasterLabel for ${config.name}'`, { tooling: true })).Id;
+        const url = `${this.connection.instanceUrl}/services/data/v${this.connection.getApiVersion()}/connect/attach-agent-topics`;
+        const body = {
+            plannerId,
+            agentJobSpecs: config.jobSpec,
+            companyDescription: config.companyDescription,
+            role: config.role,
+            companyName: config.companyName,
+            agentType: config.type,
+        };
+        const response = await this.maybeMock.request('POST', url, body);
+        await core_1.Lifecycle.getInstance().emit(exports.AgentCreateLifecycleStages.RetrievingMetadata, {});
+        const retrieve = await cs.retrieve({
+            usernameOrConnection: this.connection,
+            merge: true,
+            format: 'source',
+            output: this.project.getDefaultPackage().path ?? 'force-app',
+        });
+        const retrieveResult = await retrieve.pollStatus({
+            frequency: kit_1.Duration.seconds(1),
+            timeout: kit_1.Duration.minutes(10_000),
+        });
+        if (!retrieveResult.response.success) {
+            throw new core_1.SfError(`Unable to retrieve ${retrieveResult.response.id}`);
+        }
+        return response;
     }
     /**
      * Create an agent spec from provided data.
@@ -60,8 +114,265 @@ class Agent {
     // eslint-disable-next-line class-methods-use-this
     buildAgentJobSpecUrl(config) {
         const { type, role, companyName, companyDescription, companyWebsite } = config;
-        const website = companyWebsite ? `&companyWebsite=${companyWebsite}` : '';
-        return `/connect/agent-job-spec?agentType=${type}&role=${role}&companyName=${companyName}&companyDescription=${companyDescription}${website}`;
+        const encodedType = `agentType=${encodeURIComponent(type)}`;
+        const encodedRole = `role=${encodeURIComponent(role)}`;
+        const encodedCompanyName = `companyName=${encodeURIComponent(companyName)}`;
+        const encodedCompanyDescription = `companyDescription=${encodeURIComponent(companyDescription)}`;
+        const encodedCompanyWebsite = companyWebsite ? `&companyWebsite=${companyWebsite}` : '';
+        return `/connect/agent-job-spec?${encodedType}&${encodedRole}&${encodedCompanyName}&${encodedCompanyDescription}${encodedCompanyWebsite}`;
+    }
+    async createMetadata(config) {
+        const genAiSourceDirPath = node_path_1.default.join(this.project.getPath(), 'force-app', 'main', 'default', 'genAiPlanners');
+        const botDirPath = node_path_1.default.join(this.project.getPath(), 'force-app', 'main', 'default', 'bots', config.name);
+        const genAiSourcePath = node_path_1.default.join(genAiSourceDirPath, `${config.name}.genAiPlanner-meta.xml`);
+        const botSourcePath = node_path_1.default.join(botDirPath, `${config.name}.bot-meta.xml`);
+        const botVersionSourcePath = node_path_1.default.join(botDirPath, 'v1.botVersion-meta.xml');
+        // TODO: will this need to be user specified? Something to update for V2 APIs
+        const botUser = (await this.connection.singleRecordQuery("SELECT Username FROM User Where Profile.name='Einstein Agent User' LIMIT 1")).Username;
+        this.logger.debug(`Creating Agent using config: ${(0, node_util_1.inspect)(config)} in project: ${this.project.getPath()}`);
+        await Promise.all([
+            node_fs_1.default.promises.mkdir(genAiSourceDirPath, { recursive: true }),
+            node_fs_1.default.promises.mkdir(botDirPath, { recursive: true }),
+        ]);
+        // the dirs must exist before we write the files
+        await Promise.all([
+            node_fs_1.default.promises.writeFile(genAiSourcePath, `<?xml version="1.0" encoding="UTF-8"?>
+<GenAiPlanner xmlns="http://soap.sforce.com/2006/04/metadata">
+    <description>description for ${config.name}</description>
+    <masterLabel>MasterLabel for ${config.name}</masterLabel>
+    <plannerType>AiCopilot__ReAct</plannerType>
+</GenAiPlanner>
+      `),
+            node_fs_1.default.promises.writeFile(botSourcePath, `<?xml version="1.0" encoding="UTF-8"?>
+<Bot xmlns="http://soap.sforce.com/2006/04/metadata">
+    <botMlDomain>
+        <label>${config.name}</label>
+        <name>${config.name}</name>
+    </botMlDomain>
+    <botUser>${botUser}</botUser>
+    <contextVariables>
+        <contextVariableMappings>
+            <SObjectType>MessagingSession</SObjectType>
+            <fieldName>MessagingSession.MessagingEndUserId</fieldName>
+            <messageType>Facebook</messageType>
+        </contextVariableMappings>
+        <contextVariableMappings>
+            <SObjectType>MessagingSession</SObjectType>
+            <fieldName>MessagingSession.MessagingEndUserId</fieldName>
+            <messageType>EmbeddedMessaging</messageType>
+        </contextVariableMappings>
+        <contextVariableMappings>
+            <SObjectType>MessagingSession</SObjectType>
+            <fieldName>MessagingSession.MessagingEndUserId</fieldName>
+            <messageType>AppleBusinessChat</messageType>
+        </contextVariableMappings>
+        <contextVariableMappings>
+            <SObjectType>MessagingSession</SObjectType>
+            <fieldName>MessagingSession.MessagingEndUserId</fieldName>
+            <messageType>WhatsApp</messageType>
+        </contextVariableMappings>
+        <contextVariableMappings>
+            <SObjectType>MessagingSession</SObjectType>
+            <fieldName>MessagingSession.MessagingEndUserId</fieldName>
+            <messageType>Text</messageType>
+        </contextVariableMappings>
+        <contextVariableMappings>
+            <SObjectType>MessagingSession</SObjectType>
+            <fieldName>MessagingSession.MessagingEndUserId</fieldName>
+            <messageType>Line</messageType>
+        </contextVariableMappings>
+        <dataType>Id</dataType>
+        <developerName>EndUserId</developerName>
+        <label>End User Id</label>
+    </contextVariables>
+    <contextVariables>
+        <contextVariableMappings>
+            <SObjectType>MessagingSession</SObjectType>
+            <fieldName>MessagingSession.Id</fieldName>
+            <messageType>Line</messageType>
+        </contextVariableMappings>
+        <contextVariableMappings>
+            <SObjectType>MessagingSession</SObjectType>
+            <fieldName>MessagingSession.Id</fieldName>
+            <messageType>EmbeddedMessaging</messageType>
+        </contextVariableMappings>
+        <contextVariableMappings>
+            <SObjectType>MessagingSession</SObjectType>
+            <fieldName>MessagingSession.Id</fieldName>
+            <messageType>AppleBusinessChat</messageType>
+        </contextVariableMappings>
+        <contextVariableMappings>
+            <SObjectType>MessagingSession</SObjectType>
+            <fieldName>MessagingSession.Id</fieldName>
+            <messageType>WhatsApp</messageType>
+        </contextVariableMappings>
+        <contextVariableMappings>
+            <SObjectType>MessagingSession</SObjectType>
+            <fieldName>MessagingSession.Id</fieldName>
+            <messageType>Text</messageType>
+        </contextVariableMappings>
+        <contextVariableMappings>
+            <SObjectType>MessagingSession</SObjectType>
+            <fieldName>MessagingSession.Id</fieldName>
+            <messageType>Facebook</messageType>
+        </contextVariableMappings>
+        <dataType>Id</dataType>
+        <developerName>RoutableId</developerName>
+        <label>Routable Id</label>
+    </contextVariables>
+    <contextVariables>
+        <contextVariableMappings>
+            <SObjectType>MessagingSession</SObjectType>
+            <fieldName>MessagingSession.EndUserLanguage</fieldName>
+            <messageType>Line</messageType>
+        </contextVariableMappings>
+        <contextVariableMappings>
+            <SObjectType>MessagingSession</SObjectType>
+            <fieldName>MessagingSession.EndUserLanguage</fieldName>
+            <messageType>EmbeddedMessaging</messageType>
+        </contextVariableMappings>
+        <contextVariableMappings>
+            <SObjectType>MessagingSession</SObjectType>
+            <fieldName>MessagingSession.EndUserLanguage</fieldName>
+            <messageType>AppleBusinessChat</messageType>
+        </contextVariableMappings>
+        <contextVariableMappings>
+            <SObjectType>MessagingSession</SObjectType>
+            <fieldName>MessagingSession.EndUserLanguage</fieldName>
+            <messageType>WhatsApp</messageType>
+        </contextVariableMappings>
+        <contextVariableMappings>
+            <SObjectType>MessagingSession</SObjectType>
+            <fieldName>MessagingSession.EndUserLanguage</fieldName>
+            <messageType>Text</messageType>
+        </contextVariableMappings>
+        <contextVariableMappings>
+            <SObjectType>MessagingSession</SObjectType>
+            <fieldName>MessagingSession.EndUserLanguage</fieldName>
+            <messageType>Facebook</messageType>
+        </contextVariableMappings>
+        <dataType>Text</dataType>
+        <developerName>EndUserLanguage</developerName>
+        <label>End User Language</label>
+    </contextVariables>
+    <contextVariables>
+        <contextVariableMappings>
+            <SObjectType>MessagingEndUser</SObjectType>
+            <fieldName>MessagingEndUser.ContactId</fieldName>
+            <messageType>Line</messageType>
+        </contextVariableMappings>
+        <contextVariableMappings>
+            <SObjectType>MessagingEndUser</SObjectType>
+            <fieldName>MessagingEndUser.ContactId</fieldName>
+            <messageType>EmbeddedMessaging</messageType>
+        </contextVariableMappings>
+        <contextVariableMappings>
+            <SObjectType>MessagingEndUser</SObjectType>
+            <fieldName>MessagingEndUser.ContactId</fieldName>
+            <messageType>AppleBusinessChat</messageType>
+        </contextVariableMappings>
+        <contextVariableMappings>
+            <SObjectType>MessagingEndUser</SObjectType>
+            <fieldName>MessagingEndUser.ContactId</fieldName>
+            <messageType>WhatsApp</messageType>
+        </contextVariableMappings>
+        <contextVariableMappings>
+            <SObjectType>MessagingEndUser</SObjectType>
+            <fieldName>MessagingEndUser.ContactId</fieldName>
+            <messageType>Text</messageType>
+        </contextVariableMappings>
+        <contextVariableMappings>
+            <SObjectType>MessagingEndUser</SObjectType>
+            <fieldName>MessagingEndUser.ContactId</fieldName>
+            <messageType>Facebook</messageType>
+        </contextVariableMappings>
+        <dataType>Id</dataType>
+        <developerName>ContactId</developerName>
+        <label>Contact Id</label>
+    </contextVariables>
+    <description>${config.companyDescription}</description>
+    <label>${config.name}</label>
+    <logPrivateConversationData>false</logPrivateConversationData>
+    <richContentEnabled>true</richContentEnabled>
+    <sessionTimeout>480</sessionTimeout>
+    <type>ExternalCopilot</type>
+</Bot>
+`),
+            node_fs_1.default.promises.writeFile(botVersionSourcePath, `<?xml version="1.0" encoding="UTF-8"?>
+<BotVersion xmlns="http://soap.sforce.com/2006/04/metadata">
+    <fullName>v1</fullName>
+    <articleAnswersGPTEnabled>false</articleAnswersGPTEnabled>
+    <botDialogs>
+        <botSteps>
+            <botMessages>
+                <message>Hi, I&apos;m an AI assistant. How can I help you?</message>
+                <messageIdentifier>bfafa206-133e-44e0-8560-c47c45715124</messageIdentifier>
+            </botMessages>
+            <stepIdentifier>f85fa042-f009-4722-ba6a-6f743ebd44e8</stepIdentifier>
+            <type>Message</type>
+        </botSteps>
+        <botSteps>
+            <stepIdentifier>cc7b5414-18df-43aa-b97a-c5d2682eee62</stepIdentifier>
+            <type>Wait</type>
+        </botSteps>
+        <developerName>Welcome</developerName>
+        <isPlaceholderDialog>false</isPlaceholderDialog>
+        <label>Hi! I&apos;m your helpful bot.</label>
+        <showInFooterMenu>false</showInFooterMenu>
+    </botDialogs>
+    <botDialogs>
+        <botSteps>
+            <botMessages>
+                <message>Sorry, it looks like something has gone wrong.</message>
+                <messageIdentifier>41556708-3dda-4bc7-9444-fb9d3972a47f</messageIdentifier>
+            </botMessages>
+            <stepIdentifier>76ef6e29-6a3e-42fb-a325-606736f36268</stepIdentifier>
+            <type>Message</type>
+        </botSteps>
+        <botSteps>
+            <stepIdentifier>c2964b65-3c22-4cfb-9974-1a91820011e0</stepIdentifier>
+            <type>Wait</type>
+        </botSteps>
+        <developerName>Error_Handling</developerName>
+        <isPlaceholderDialog>false</isPlaceholderDialog>
+        <label>Unfortunately, a system error occurred. Let us start again.</label>
+        <showInFooterMenu>false</showInFooterMenu>
+    </botDialogs>
+    <botDialogs>
+        <botSteps>
+            <botMessages>
+                <message>One moment while I connect you to the next available service representative.</message>
+                <messageIdentifier>ddf568e3-4805-4529-a71d-4601ec9b5e16</messageIdentifier>
+            </botMessages>
+            <stepIdentifier>fc998b13-39e8-4142-aa14-80b5c80934dc</stepIdentifier>
+            <type>Message</type>
+        </botSteps>
+        <botSteps>
+            <conversationSystemMessage>
+                <type>Transfer</type>
+            </conversationSystemMessage>
+            <stepIdentifier>e9a1f351-66fc-4a2e-8871-905ea08bdfa5</stepIdentifier>
+            <type>SystemMessage</type>
+        </botSteps>
+        <developerName>Transfer_To_Agent</developerName>
+        <isPlaceholderDialog>false</isPlaceholderDialog>
+        <label>Transfer To Agent</label>
+        <showInFooterMenu>false</showInFooterMenu>
+    </botDialogs>
+    <citationsEnabled>false</citationsEnabled>
+    <conversationDefinitionPlanners>
+        <genAiPlannerName>${config.name}</genAiPlannerName>
+    </conversationDefinitionPlanners>
+    <entryDialog>Welcome</entryDialog>
+    <intentDisambiguationEnabled>false</intentDisambiguationEnabled>
+    <intentV3Enabled>false</intentV3Enabled>
+    <knowledgeFallbackEnabled>false</knowledgeFallbackEnabled>
+    <smallTalkEnabled>false</smallTalkEnabled>
+    <toneType>Casual</toneType>
+</BotVersion>
+`),
+        ]);
+        return [genAiSourcePath, botSourcePath, botVersionSourcePath];
     }
 }
 exports.Agent = Agent;

package/lib/agent.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"agent.js","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":";AAAA;;;;;GAKG~~;;;~~AAEH,yCAAoC;AACpC,~~2CAA0E~~;~~AAC1E~~,~~yCAAkD~~;~~AAClD~~,6CAAyC;~~AAUzC~~;;GAEG;AACH,MAAa,KAAK;~~IAImC~~;~~IAH3C~~,MAAM,CAAS;IACf,SAAS,CAAY;~~IAE7B~~,YAAmB,UAAsB,EAAU,OAAkB;QAAlB,YAAO,GAAP,OAAO,CAAW;QACnE,IAAI,CAAC,MAAM,GAAG,aAAM,CAAC,aAAa,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QAC1D,IAAI,CAAC,SAAS,GAAG,IAAI,sBAAS,CAAC,UAAU,CAAC,CAAC;~~IAC7C~~,CAAC;~~IAEM~~,KAAK,CAAC,MAAM,CAAC,MAAyB;QAC3C,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,gCAAgC,IAAA,mBAAO,EAAC,MAAM,CAAC,gBAAgB,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QAC3G,~~0DAA0D~~;~~QAE1D,+EAA+E~~;~~QAC/E~~,MAAM,~~IAAA~~,~~WAAK~~,~~EAAC~~,cAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;~~QAEjC~~,~~0CAA0C~~;~~QAE1C~~,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;~~IAC7B~~,CAAC;IAED;;;;OAIG;IACI,KAAK,CAAC,UAAU,CAAC,MAAgC;QACtD,IAAI,CAAC,qBAAqB,CAAC,MAAM,CAAC,CAAC;QAEnC,IAAI,SAAuB,CAAC;QAC5B,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,CAA6B,KAAK,EAAE,IAAI,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAC,CAAC;QACpH,IAAI,QAAQ,CAAC,SAAS,IAAI,QAAQ,CAAC,QAAQ,EAAE,CAAC;YAC5C,SAAS,GAAG,QAAQ,CAAC,QAAQ,CAAC;QAChC,CAAC;aAAM,CAAC;YACN,MAAM,cAAO,CAAC,MAAM,CAAC;gBACnB,IAAI,EAAE,yBAAyB;gBAC/B,OAAO,EAAE,QAAQ,CAAC,YAAY,IAAI,SAAS;aAC5C,CAAC,CAAC;QACL,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,kDAAkD;IAC1C,qBAAqB,CAAC,MAAgC;QAC5D,6EAA6E;QAC7E,IAAI,MAAM;YAAE,OAAO;IACrB,CAAC;IAED,kDAAkD;IAC1C,oBAAoB,CAAC,MAAgC;QAC3D,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,kBAAkB,EAAE,cAAc,EAAE,GAAG,MAAM,CAAC;QAC/E,MAAM,~~OAAO~~,GAAG,cAAc,CAAC,CAAC,CAAC,mBAAmB,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;~~QAC1E~~,OAAO,~~qCAAqC~~,IAAI,SAAS,IAAI,~~gBAAgB~~,WAAW,~~uBAAuB~~,kBAAkB,GAAG,OAAO,EAAE,CAAC;~~IAChJ~~,CAAC;CACF;~~AAvDD~~,~~sBAuDC~~"}
1	+ {"version":3,"file":"agent.js","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"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"}

package/lib/index.d.ts CHANGED Viewed

@@ -1,3 +1,3 @@
 export { type AgentCreateConfig, type AgentCreateResponse, type AgentJobSpec, type AgentJobSpecCreateConfig, type AgentJobSpecCreateResponse, SfAgent, } from './types';
-export { Agent } from './agent';
+export { Agent, AgentCreateLifecycleStages } from './agent';
 export { AgentTester, humanFormat, jsonFormat, junitFormat, type AgentTestDetailsResponse, type AgentTestStartResponse, type AgentTestStatusResponse, type TestCaseResult, type TestStatus, } from './agentTester';

package/lib/index.js CHANGED Viewed

@@ -6,9 +6,10 @@
  * 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.junitFormat = exports.jsonFormat = exports.humanFormat = exports.AgentTester = exports.Agent = void 0;
+exports.junitFormat = exports.jsonFormat = exports.humanFormat = exports.AgentTester = exports.AgentCreateLifecycleStages = exports.Agent = void 0;
 var agent_1 = require("./agent");
 Object.defineProperty(exports, "Agent", { enumerable: true, get: function () { return agent_1.Agent; } });
+Object.defineProperty(exports, "AgentCreateLifecycleStages", { enumerable: true, get: function () { return agent_1.AgentCreateLifecycleStages; } });
 var agentTester_1 = require("./agentTester");
 Object.defineProperty(exports, "AgentTester", { enumerable: true, get: function () { return agentTester_1.AgentTester; } });
 Object.defineProperty(exports, "humanFormat", { enumerable: true, get: function () { return agentTester_1.humanFormat; } });

package/lib/index.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAUH,~~iCAAgC~~;~~AAAvB~~,8FAAA,KAAK,OAAA;~~AACd~~,6CAUuB;AATrB,0GAAA,WAAW,OAAA;AACX,0GAAA,WAAW,OAAA;AACX,yGAAA,UAAU,OAAA;AACV,0GAAA,WAAW,OAAA"}
1	+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAUH,iCAA4D;AAAnD,8FAAA,KAAK,OAAA;AAAE,mHAAA,0BAA0B,OAAA;AAC1C,6CAUuB;AATrB,0GAAA,WAAW,OAAA;AACX,0GAAA,WAAW,OAAA;AACX,yGAAA,UAAU,OAAA;AACV,0GAAA,WAAW,OAAA"}

package/lib/types.d.ts CHANGED Viewed

@@ -8,6 +8,17 @@ export type AgentJobSpec = [
         jobDescription: string;
     }
 ];
+/**
+ * The body POST'd to /services/data/{api-version}/connect/attach-agent-topics
+ */
+export type AttachAgentTopicsBody = {
+    plannerId: string;
+    role: string;
+    companyName: string;
+    companyDescription: string;
+    agentType: string;
+    agentJobSpecs: AgentJobSpec;
+};
 /**
  * The parameters used to generate an agent spec.
  */
@@ -25,7 +36,7 @@ export type AgentJobSpecCreateConfig = {
  * NOTE: This is likely to change with planned serverside APIs.
  */
 export type AgentCreateConfig = AgentJobSpecCreateConfig & {
-    jobSpecs: AgentJobSpec;
+    jobSpec: AgentJobSpec;
 };
 /**
  * An interface for working with Agents.

package/package.json CHANGED Viewed

@@ -1,7 +1,7 @@
 {
   "name": "@salesforce/agents",
   "description": "Client side APIs for working with Salesforce agents",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "license": "BSD-3-Clause",
   "author": "Salesforce",
   "main": "lib/index",
@@ -15,6 +15,7 @@
     "@salesforce/core": "^8.8.0",
     "@salesforce/kit": "^3.2.3",
     "@salesforce/sf-plugins-core": "^12.1.0",
+    "@salesforce/source-deploy-retrieve": "^12.10.2",
     "fast-xml-parser": "^4",
     "nock": "^13.5.6"
   },