@salesforce/agents 0.19.8 → 0.20.1-beta.0

package/lib/productionAgent.d.ts

@@ -0,0 +1,51 @@
+import { type BotMetadata, type BotVersionMetadata, PlannerResponse, ProductionAgentOptions } from './types';
+import { AgentInteractionBase, type AgentPreviewInterface } from './agentInteractionBase';
+export declare class ProductionAgent extends AgentInteractionBase {
+    private options;
+    preview: AgentPreviewInterface;
+    private botMetadata;
+    private id;
+    private apiName;
+    private apiBase;
+    constructor(options: ProductionAgentOptions);
+    getBotMetadata(): Promise<BotMetadata>;
+    /**
+     * Returns the latest bot version metadata.
+     *
+     * @returns the latest bot version metadata
+     */
+    getLatestBotVersionMetadata(): Promise<BotVersionMetadata>;
+    getTrace(planId: string): Promise<PlannerResponse | undefined>;
+    /**
+     * Returns the ID for this agent.
+     *
+     * @returns The ID of the agent (The `Bot` ID).
+     */
+    getId(): Promise<string>;
+    /**
+     * Activates the agent.
+     *
+     * @returns void
+     */
+    activate(): Promise<void>;
+    /**
+     * Deactivates the agent.
+     *
+     * @returns void
+     */
+    deactivate(): Promise<void>;
+    protected getAgentIdForStorage(): string;
+    protected canApexDebug(): boolean;
+    protected handleApexDebuggingSetup(): Promise<void>;
+    protected getSendMessageUrl(): string;
+    private setAgentStatus;
+    private startPreview;
+    /**
+     * 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`
+     */
+    private endSession;
+}

package/lib/productionAgent.js

@@ -0,0 +1,272 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProductionAgent = void 0;
+/*
+ * Copyright 2026, Salesforce, Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+const node_crypto_1 = require("node:crypto");
+const core_1 = require("@salesforce/core");
+const kit_1 = require("@salesforce/kit");
+const maybe_mock_1 = require("./maybe-mock");
+const utils_1 = require("./utils");
+const apexUtils_1 = require("./apexUtils");
+const agentInteractionBase_1 = require("./agentInteractionBase");
+;
+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."], ["missingAgentNameOrId", "The \"nameOrId\" agent option is required when creating an Agent instance."], ["agentIsDeleted", "The %s agent has been deleted and its activation state can't be changed."], ["agentActivationError", "Changing the agent's activation status was unsuccessful due to %s."]]));
+class ProductionAgent extends agentInteractionBase_1.AgentInteractionBase {
+    options;
+    preview;
+    botMetadata;
+    id;
+    apiName;
+    apiBase = `https://${kit_1.env.getBoolean('SF_TEST_API') ? 'test.' : ''}api.salesforce.com/einstein/ai-agent/v1`;
+    constructor(options) {
+        super(options.connection);
+        this.options = options;
+        if (!options.apiNameOrId) {
+            throw messages.createError('missingAgentNameOrId');
+        }
+        this.preview = {
+            start: (apexDebugging) => this.startPreview(apexDebugging),
+            send: (message) => this.sendMessage(message),
+            getAllTraces: () => this.getAllTracesFromDisc(),
+            end: (reason) => this.endSession(reason),
+            saveSession: (outputDir) => this.saveSessionToDisc(outputDir),
+            setApexDebugging: (apexDebugging) => this.setApexDebugging(apexDebugging),
+        };
+        if (options.apiNameOrId.startsWith('0Xx') && [15, 18].includes(options.apiNameOrId.length)) {
+            this.id = options.apiNameOrId;
+        }
+        else {
+            this.apiName = options.apiNameOrId;
+        }
+    }
+    async getBotMetadata() {
+        if (!this.botMetadata) {
+            const whereClause = this.id ? `Id = '${this.id}'` : `DeveloperName = '${this.apiName}'`;
+            this.botMetadata = await this.connection.singleRecordQuery(`SELECT FIELDS(ALL), (SELECT FIELDS(ALL) FROM BotVersions LIMIT 10) FROM BotDefinition WHERE ${whereClause} LIMIT 1`);
+            this.id = this.botMetadata.Id;
+            this.apiName = this.botMetadata.DeveloperName;
+            // Set the display name from MasterLabel
+            this.name = this.botMetadata.MasterLabel;
+        }
+        return this.botMetadata;
+    }
+    /**
+     * Returns the latest bot version metadata.
+     *
+     * @returns the latest bot version metadata
+     */
+    async getLatestBotVersionMetadata() {
+        if (!this.botMetadata) {
+            this.botMetadata = await this.getBotMetadata();
+        }
+        const botVersions = this.botMetadata.BotVersions.records;
+        return botVersions[botVersions.length - 1];
+    }
+    // eslint-disable-next-line @typescript-eslint/require-await,class-methods-use-this,@typescript-eslint/no-unused-vars
+    async getTrace(planId) {
+        // return this.connection.request<PlannerResponse>({
+        //   method: 'GET',
+        //   url: `${this.connection.getConnectionOptions().instanceUrl!}:9443/proxy/worker/internal/sessions/${this
+        //     .sessionId!}/plans/${planId}`,
+        //   headers: {
+        //     'x-client-name': 'afdx',
+        //   },
+        // });
+        return undefined;
+    }
+    /**
+     * Returns the ID for this agent.
+     *
+     * @returns The ID of the agent (The `Bot` ID).
+     */
+    async getId() {
+        if (!this.id) {
+            await this.getBotMetadata();
+        }
+        return this.id; // getBotMetadata() ensures this.id is not undefined
+    }
+    /**
+     * Activates the agent.
+     *
+     * @returns void
+     */
+    async activate() {
+        return this.setAgentStatus('Active');
+    }
+    /**
+     * Deactivates the agent.
+     *
+     * @returns void
+     */
+    async deactivate() {
+        return this.setAgentStatus('Inactive');
+    }
+    getAgentIdForStorage() {
+        if (!this.id) {
+            throw core_1.SfError.create({ name: 'noId', message: 'Agent ID not found. Call .getBotMetadata() first.' });
+        }
+        return this.id;
+    }
+    // eslint-disable-next-line class-methods-use-this
+    canApexDebug() {
+        return true;
+    }
+    async handleApexDebuggingSetup() {
+        const botMetadata = await this.getBotMetadata();
+        if (botMetadata.BotUserId) {
+            const traceFlag = await (0, apexUtils_1.findTraceFlag)(this.connection, botMetadata.BotUserId);
+            if (!traceFlag) {
+                await (0, apexUtils_1.createTraceFlag)(this.connection, botMetadata.BotUserId);
+            }
+        }
+    }
+    getSendMessageUrl() {
+        if (!this.sessionId) {
+            throw core_1.SfError.create({ name: 'noSessionId', message: 'Session not started' });
+        }
+        return `${this.apiBase}/sessions/${this.sessionId}/messages`;
+    }
+    async setAgentStatus(desiredState) {
+        const botMetadata = await this.getBotMetadata();
+        const botVersionMetadata = await this.getLatestBotVersionMetadata();
+        if (botMetadata.IsDeleted) {
+            throw messages.createError('agentIsDeleted', [botMetadata.DeveloperName]);
+        }
+        if (botVersionMetadata.Status === desiredState) {
+            return;
+        }
+        const url = `/connect/bot-versions/${botVersionMetadata.Id}/activation`;
+        const maybeMock = new maybe_mock_1.MaybeMock(this.connection);
+        const response = await maybeMock.request('POST', url, { status: desiredState });
+        if (response.success) {
+            this.botMetadata.BotVersions.records[0].Status = response.isActivated ? 'Active' : 'Inactive';
+        }
+        else {
+            throw messages.createError('agentActivationError', [response.messages?.toString() ?? 'unknown']);
+        }
+    }
+    async startPreview(apexDebugging) {
+        if (!this.id) {
+            await this.getId();
+        }
+        const url = `${this.apiBase}/agents/${this.id}/sessions`;
+        // Use the provided apexDebugging parameter if given, otherwise keep the previously set one
+        if (apexDebugging !== undefined) {
+            this.apexDebugging = apexDebugging;
+        }
+        const body = {
+            externalSessionKey: (0, node_crypto_1.randomUUID)(),
+            instanceConfig: {
+                endpoint: this.options.connection.instanceUrl,
+            },
+            streamingCapabilities: {
+                chunkTypes: ['Text'],
+            },
+            bypassUser: true,
+        };
+        try {
+            const response = await this.connection.request({
+                method: 'POST',
+                url,
+                body: JSON.stringify(body),
+                headers: {
+                    'x-client-name': 'afdx',
+                },
+            });
+            this.sessionId = response.sessionId;
+            // Initialize session directory and write initial data
+            // Session directory structure:
+            // .sfdx/agents/<agentId>/sessions/<sessionId>/
+            // ├── transcript.jsonl    # All transcript entries (one per line)
+            // ├── traces/             # Individual trace files
+            // │   ├── <planId1>.json
+            // │   └── <planId2>.json
+            // └── metadata.json       # Session metadata (start time, end time, planIds, etc.)
+            const agentId = this.id;
+            this.sessionDir = await (0, utils_1.getSessionDir)(agentId, response.sessionId);
+            await (0, utils_1.appendTranscriptEntryToSession)({
+                timestamp: new Date().toISOString(),
+                agentId,
+                sessionId: response.sessionId,
+                role: 'agent',
+                text: response.messages.map((m) => m.message).join('\n'),
+                raw: response.messages,
+            }, this.sessionDir);
+            // Write initial metadata
+            await (0, utils_1.writeMetadataToSession)(this.sessionDir, {
+                sessionId: response.sessionId,
+                agentId,
+                startTime: new Date().toISOString(),
+                apexDebugging: this.apexDebugging,
+                planIds: [],
+            });
+            return response;
+        }
+        catch (err) {
+            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 endSession(reason) {
+        if (!this.sessionId) {
+            throw core_1.SfError.create({ name: 'noSessionId', message: 'please call .start() first' });
+        }
+        if (!this.id) {
+            throw core_1.SfError.create({ name: 'noId', message: 'please call .getId() first' });
+        }
+        const url = `${this.apiBase}/v1.1/sessions/${this.sessionId}`;
+        try {
+            // https://developer.salesforce.com/docs/einstein/genai/guide/agent-api-examples.html#end-session
+            const response = await this.connection.request({
+                method: 'DELETE',
+                url,
+                headers: {
+                    'x-session-end-reason': reason,
+                },
+            });
+            // Write end entry immediately
+            if (this.sessionDir) {
+                await (0, utils_1.appendTranscriptEntryToSession)({
+                    timestamp: new Date().toISOString(),
+                    agentId: this.id,
+                    sessionId: this.sessionId,
+                    role: 'agent',
+                    reason,
+                    raw: response.messages,
+                }, this.sessionDir);
+                // Update metadata with end time
+                await (0, utils_1.updateMetadataEndTime)(this.sessionDir, new Date().toISOString(), this.planIds);
+            }
+            // Clear session data for next session
+            this.sessionId = undefined;
+            this.sessionDir = undefined;
+            this.planIds = new Set();
+            return response;
+        }
+        catch (err) {
+            throw core_1.SfError.wrap(err);
+        }
+    }
+}
+exports.ProductionAgent = ProductionAgent;
+//# sourceMappingURL=productionAgent.js.map

package/lib/productionAgent.js.map

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

package/lib/scriptAgent.d.ts

@@ -0,0 +1,63 @@
+import { SfProject } from '@salesforce/core';
+import { type AgentPreviewEndResponse, type AgentPreviewSendResponse, type CompileAgentScriptResponse, ExtendedAgentJobSpec, PlannerResponse, PublishAgent, ScriptAgentOptions } from './types';
+import { AgentInteractionBase, type AgentPreviewInterface } from './agentInteractionBase';
+export declare class ScriptAgent extends AgentInteractionBase {
+    private options;
+    preview: AgentPreviewInterface & {
+        setMockMode: (mockMode: 'Mock' | 'Live Test') => void;
+    };
+    private mockMode;
+    private agentScriptContent;
+    private metaContent;
+    private agentJson;
+    private apiBase;
+    constructor(options: ScriptAgentOptions);
+    /**
+     * Creates an AiAuthoringBundle directory, .script file, and -meta.xml file
+     *
+     * @returns Promise<void>
+     * @beta
+     * @param options {
+     * project: SfProject;
+     * bundleApiName: string;
+     * outputDir?: string;
+     * agentSpec?: ExtendedAgentJobSpec;
+     *}
+     */
+    static createAuthoringBundle(options: {
+        project: SfProject;
+        bundleApiName: string;
+        outputDir?: string;
+        agentSpec?: ExtendedAgentJobSpec;
+    }): Promise<void>;
+    refreshContent(): Promise<void>;
+    getTrace(planId: string): Promise<PlannerResponse>;
+    /**
+     * Compiles AgentScript returning agent JSON when successful, otherwise the compile errors are returned.
+     *
+     * @returns Promise<CompileAgentScriptResponse> The raw API response
+     * @beta
+     */
+    compile(): Promise<CompileAgentScriptResponse>;
+    /**
+     * Publish an AgentJson representation to the org
+     *
+     * @beta
+     * @returns {Promise<PublishAgentJsonResponse>} The publish response
+     */
+    publish(): Promise<PublishAgent>;
+    /**
+     * Ending is not required
+     * this will save all of the transcripts to disc
+     *
+     * @returns `AgentPreviewEndResponse`
+     */
+    endSession(): Promise<AgentPreviewEndResponse>;
+    protected getAgentIdForStorage(): string;
+    protected canApexDebug(): boolean;
+    protected getSendMessageUrl(): string;
+    protected handleApexDebuggingSetup(): Promise<void>;
+    protected sendMessage(message: string): Promise<AgentPreviewSendResponse>;
+    private setMockMode;
+    private startPreview;
+}