@salesforce/agents 0.19.8 → 0.20.0-beta.2

package/lib/agentTester.js

@@ -1,6 +1,6 @@
 "use strict";
 /*
- * Copyright 2025, Salesforce, Inc.
+ * 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.

package/lib/agents/agentBase.d.ts

@@ -0,0 +1,82 @@
+import { Connection } from '@salesforce/core';
+import { type AgentPreviewEndResponse, type AgentPreviewSendResponse, type AgentPreviewStartResponse, type PlannerResponse } from '../types';
+/**
+ * Common preview interface that both ScriptAgent and ProductionAgent implement
+ */
+export type AgentPreviewInterface = {
+    start: (...args: unknown[]) => Promise<AgentPreviewStartResponse>;
+    send: (message: string) => Promise<AgentPreviewSendResponse>;
+    getAllTraces: () => Promise<PlannerResponse[]>;
+    end: (...args: unknown[]) => Promise<AgentPreviewEndResponse>;
+    saveSession: (outputDir?: string) => Promise<string>;
+    setApexDebugging: (apexDebugging: boolean) => void;
+};
+/**
+ * Abstract base class for agent preview functionality.
+ * Contains shared properties and methods between ScriptAgent and ProductionAgent.
+ */
+export declare abstract class AgentBase {
+    protected readonly connection: Connection;
+    /**
+     * The display name of the agent (user-friendly name, not API name)
+     */
+    name: string | undefined;
+    protected sessionId: string | undefined;
+    protected sessionDir: string | undefined;
+    protected apexDebugging: boolean | undefined;
+    protected planIds: Set<string>;
+    abstract preview: AgentPreviewInterface;
+    protected constructor(connection: Connection);
+    restoreConnection(): Promise<void>;
+    /**
+     * Get all traces from the current session
+     * Reads traces from the session directory if available, otherwise fetches from API
+     */
+    protected getAllTracesFromDisc(): Promise<PlannerResponse[]>;
+    /**
+     * Save the complete session data to disk by copying the session directory.
+     * The session directory is already populated during the session with:
+     * - Transcript entries (transcript.jsonl)
+     * - Traces (traces/*.json)
+     * - Session metadata (metadata.json)
+     *
+     * 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.)
+     *
+     * @param outputDir Optional output directory. If not provided, uses default location.
+     * @returns The path to the copied session directory
+     */
+    protected saveSessionToDisc(outputDir: string): Promise<string>;
+    /**
+     * Set the Apex debugging mode for the agent preview.
+     * This can be called before starting a session.
+     *
+     * @param apexDebugging true to enable Apex debugging, false to disable
+     */
+    protected setApexDebugging(apexDebugging: boolean): void;
+    /**
+     * Send a message to the agent using the session ID obtained by calling `start()`.
+     *
+     * @param message A message to send to the agent.
+     * @returns `AgentPreviewSendResponse`
+     */
+    protected abstract sendMessage(message: string): Promise<AgentPreviewSendResponse>;
+    /**
+     * Get the agent ID to use for storage/transcript purposes
+     */
+    protected abstract getAgentIdForStorage(): string | Promise<string>;
+    /**
+     * Check if Apex debugging should be enabled for this agent type
+     */
+    protected abstract canApexDebug(): boolean;
+    /**
+     * Handle Apex debugging setup before sending a message
+     */
+    protected abstract handleApexDebuggingSetup(): Promise<void>;
+    protected abstract getTrace(planId: string): Promise<PlannerResponse | undefined>;
+}

package/lib/agents/agentBase.js

@@ -0,0 +1,106 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentBase = 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 promises_1 = require("node:fs/promises");
+const node_path_1 = require("node:path");
+const core_1 = require("@salesforce/core");
+const utils_1 = require("../utils");
+/**
+ * Abstract base class for agent preview functionality.
+ * Contains shared properties and methods between ScriptAgent and ProductionAgent.
+ */
+class AgentBase {
+    connection;
+    /**
+     * The display name of the agent (user-friendly name, not API name)
+     */
+    name;
+    sessionId;
+    sessionDir;
+    apexDebugging;
+    planIds = new Set();
+    constructor(connection) {
+        this.connection = connection;
+    }
+    async restoreConnection() {
+        delete this.connection.accessToken;
+        await this.connection.refreshAuth();
+    }
+    /**
+     * Get all traces from the current session
+     * Reads traces from the session directory if available, otherwise fetches from API
+     */
+    async getAllTracesFromDisc() {
+        if (!this.sessionDir) {
+            throw core_1.SfError.create({ message: 'history never created' });
+        }
+        const traces = [];
+        // If we have a session directory, try reading traces from disk first
+        const tracesDir = (0, node_path_1.join)(this.sessionDir, 'traces');
+        const files = await (0, promises_1.readdir)(tracesDir);
+        const tracePromises = files
+            .filter((file) => file.endsWith('.json'))
+            .map(async (file) => {
+            const traceData = await (0, promises_1.readFile)((0, node_path_1.join)(tracesDir, file), 'utf-8');
+            return JSON.parse(traceData);
+        });
+        traces.push(...(await Promise.all(tracePromises)));
+        return traces;
+    }
+    /**
+     * Save the complete session data to disk by copying the session directory.
+     * The session directory is already populated during the session with:
+     * - Transcript entries (transcript.jsonl)
+     * - Traces (traces/*.json)
+     * - Session metadata (metadata.json)
+     *
+     * 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.)
+     *
+     * @param outputDir Optional output directory. If not provided, uses default location.
+     * @returns The path to the copied session directory
+     */
+    async saveSessionToDisc(outputDir) {
+        if (!this.sessionId || !this.sessionDir) {
+            throw core_1.SfError.create({ name: 'noSessionId', message: 'No active session. Call .start() first.' });
+        }
+        const agentId = await this.getAgentIdForStorage();
+        // Determine output directory
+        const destDir = (0, node_path_1.join)(outputDir, agentId, `session_${this.sessionId}`);
+        // Copy the entire session directory from .sfdx to the output directory
+        // This includes transcript.jsonl, traces/, and metadata.json
+        await (0, utils_1.copyDirectory)(this.sessionDir, destDir);
+        return destDir;
+    }
+    /**
+     * Set the Apex debugging mode for the agent preview.
+     * This can be called before starting a session.
+     *
+     * @param apexDebugging true to enable Apex debugging, false to disable
+     */
+    setApexDebugging(apexDebugging) {
+        this.apexDebugging = apexDebugging;
+    }
+}
+exports.AgentBase = AgentBase;
+//# sourceMappingURL=agentBase.js.map

package/lib/agents/agentBase.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentBase.js","sourceRoot":"","sources":["../../src/agents/agentBase.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;;;;;GAcG;AACH,+CAAqD;AACrD,yCAAiC;AACjC,2CAAuD;AAOvD,oCAAyC;AAczC;;;GAGG;AACH,MAAsB,SAAS;IAWY;IAVzC;;OAEG;IACI,IAAI,CAAqB;IACtB,SAAS,CAAqB;IAC9B,UAAU,CAAqB;IAC/B,aAAa,CAAsB;IACnC,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAGtC,YAAyC,UAAsB;QAAtB,eAAU,GAAV,UAAU,CAAY;IAAG,CAAC;IAE5D,KAAK,CAAC,iBAAiB;QAC5B,OAAO,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC;QACnC,MAAM,IAAI,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC;IACtC,CAAC;IAED;;;OAGG;IACO,KAAK,CAAC,oBAAoB;QAClC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;YACrB,MAAM,cAAO,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,uBAAuB,EAAE,CAAC,CAAC;QAC7D,CAAC;QACD,MAAM,MAAM,GAAsB,EAAE,CAAC;QAErC,qEAAqE;QACrE,MAAM,SAAS,GAAG,IAAA,gBAAI,EAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;QAClD,MAAM,KAAK,GAAG,MAAM,IAAA,kBAAO,EAAC,SAAS,CAAC,CAAC;QACvC,MAAM,aAAa,GAAG,KAAK;aACxB,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;aACxC,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;YAClB,MAAM,SAAS,GAAG,MAAM,IAAA,mBAAQ,EAAC,IAAA,gBAAI,EAAC,SAAS,EAAE,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;YACjE,OAAO,IAAI,CAAC,KAAK,CAAC,SAAS,CAAoB,CAAC;QAClD,CAAC,CAAC,CAAC;QACL,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;QACnD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;;;;;;;;;;;;;;;OAiBG;IACO,KAAK,CAAC,iBAAiB,CAAC,SAAiB;QACjD,IAAI,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;YACxC,MAAM,cAAO,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,yCAAyC,EAAE,CAAC,CAAC;QACpG,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,oBAAoB,EAAE,CAAC;QAElD,6BAA6B;QAC7B,MAAM,OAAO,GAAG,IAAA,gBAAI,EAAC,SAAS,EAAE,OAAO,EAAE,WAAW,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;QAEtE,uEAAuE;QACvE,6DAA6D;QAC7D,MAAM,IAAA,qBAAa,EAAC,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QAE9C,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;;;;OAKG;IACO,gBAAgB,CAAC,aAAsB;QAC/C,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;IACrC,CAAC;CAyBF;AA7GD,8BA6GC"}

package/lib/agents/productionAgent.d.ts

@@ -0,0 +1,51 @@
+import { type AgentPreviewSendResponse, type BotMetadata, type BotVersionMetadata, PlannerResponse, ProductionAgentOptions } from '../types';
+import { AgentBase, type AgentPreviewInterface } from './agentBase';
+export declare class ProductionAgent extends AgentBase {
+    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 sendMessage(message: string): Promise<AgentPreviewSendResponse>;
+    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/agents/productionAgent.js

@@ -0,0 +1,336 @@
+"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 maybe_mock_1 = require("../maybe-mock");
+const utils_1 = require("../utils");
+const apexUtils_1 = require("../apexUtils");
+const agentBase_1 = require("./agentBase");
+;
+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 agentBase_1.AgentBase {
+    options;
+    preview;
+    botMetadata;
+    id;
+    apiName;
+    apiBase = `https://${(0, utils_1.getEndpoint)()}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);
+            }
+        }
+    }
+    async sendMessage(message) {
+        if (!this.sessionId) {
+            throw core_1.SfError.create({ name: 'noSessionId', message: 'Agent not started, please call .start() first' });
+        }
+        const url = `${this.apiBase}/sessions/${this.sessionId}/messages`;
+        const body = {
+            message: {
+                sequenceId: Date.now(),
+                type: 'Text',
+                text: message,
+            },
+            variables: [],
+        };
+        try {
+            const start = Date.now();
+            // Handle Apex debugging setup if needed
+            if (this.apexDebugging && this.canApexDebug()) {
+                await this.handleApexDebuggingSetup();
+            }
+            const agentId = this.getAgentIdForStorage();
+            // Ensure session directory exists
+            if (!this.sessionDir) {
+                this.sessionDir = await (0, utils_1.getSessionDir)(agentId, this.sessionId);
+            }
+            void (0, utils_1.appendTranscriptEntryToSession)({
+                timestamp: new Date().toISOString(),
+                agentId,
+                sessionId: this.sessionId,
+                role: 'user',
+                text: message,
+            }, this.sessionDir);
+            const response = await this.connection.request({
+                method: 'POST',
+                url,
+                body: JSON.stringify(body),
+                headers: {
+                    'x-client-name': 'afdx',
+                },
+            });
+            const planId = response.messages.at(0).planId;
+            this.planIds.add(planId);
+            await (0, utils_1.appendTranscriptEntryToSession)({
+                timestamp: new Date().toISOString(),
+                agentId,
+                sessionId: this.sessionId,
+                role: 'agent',
+                text: response.messages.at(0)?.message,
+                raw: response.messages,
+            }, this.sessionDir);
+            // Fetch and write trace immediately if available
+            if (planId) {
+                try {
+                    const trace = await this.getTrace(planId);
+                    await (0, utils_1.writeTraceToSession)(planId, trace, this.sessionDir);
+                }
+                catch (error) {
+                    throw core_1.SfError.wrap(error);
+                }
+            }
+            if (this.apexDebugging && this.canApexDebug()) {
+                const apexLog = await (0, apexUtils_1.getDebugLog)(this.connection, start, Date.now());
+                if (apexLog) {
+                    response.apexDebugLog = apexLog;
+                }
+            }
+            return response;
+        }
+        catch (err) {
+            throw core_1.SfError.wrap(err);
+        }
+    }
+    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/agents/productionAgent.js.map

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

package/lib/agents/scriptAgent.d.ts

@@ -0,0 +1,61 @@
+import { SfProject } from '@salesforce/core';
+import { type AgentPreviewEndResponse, type AgentPreviewSendResponse, type CompileAgentScriptResponse, ExtendedAgentJobSpec, PlannerResponse, PublishAgent, ScriptAgentOptions } from '../types';
+import { AgentBase, type AgentPreviewInterface } from './agentBase';
+export declare class ScriptAgent extends AgentBase {
+    private options;
+    preview: AgentPreviewInterface & {
+        setMockMode: (mockMode: 'Mock' | 'Live Test') => void;
+    };
+    private mockMode;
+    private agentScriptContent;
+    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 the transcripts to disc
+     *
+     * @returns `AgentPreviewEndResponse`
+     */
+    endSession(): Promise<AgentPreviewEndResponse>;
+    protected getAgentIdForStorage(): string;
+    protected canApexDebug(): boolean;
+    protected handleApexDebuggingSetup(): Promise<void>;
+    protected sendMessage(message: string): Promise<AgentPreviewSendResponse>;
+    private setMockMode;
+    private startPreview;
+}