@salesforce/agents 0.20.0 → 0.21.1

package/lib/utils.js

@@ -33,9 +33,10 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.readTranscriptEntries = exports.appendTranscriptEntry = exports.useNamedUserJwt = exports.findLocalAgents = exports.findAuthoringBundle = exports.decodeHtmlEntities = exports.sanitizeFilename = exports.metric = void 0;
+exports.readTranscriptEntries = exports.getAllHistory = exports.updateMetadataEndTime = exports.writeMetaFileToHistory = exports.writeTraceToHistory = exports.appendTranscriptToHistory = exports.getHistoryDir = exports.useNamedUserJwt = exports.findLocalAgents = exports.findAuthoringBundle = exports.decodeHtmlEntities = exports.sanitizeFilename = exports.metric = void 0;
+exports.getEndpoint = getEndpoint;
 /*
- * 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.
@@ -53,6 +54,7 @@ const node_fs_1 = require("node:fs");
 const promises_1 = require("node:fs/promises");
 const path = __importStar(require("node:path"));
 const core_1 = require("@salesforce/core");
+const kit_1 = require("@salesforce/kit");
 exports.metric = ['completeness', 'coherence', 'conciseness', 'output_latency_milliseconds'];
 /**
  * Sanitize a filename by removing or replacing illegal characters.
@@ -190,6 +192,12 @@ const findLocalAgents = (dir) => {
     return results;
 };
 exports.findLocalAgents = findLocalAgents;
+/**
+ * takes a connection and upgrades it to a NamedJWT connection
+ *
+ * @param {Connection} connection original Connection
+ * @returns {Promise<Connection>} upgraded connection
+ */
 const useNamedUserJwt = async (connection) => {
     // Refresh the connection to ensure we have the latest, valid access token
     try {
@@ -248,39 +256,226 @@ const resolveProjectLocalSfdx = async () => {
         return undefined;
     }
 };
-const getConversationDir = async (agentId) => {
+/**
+ * returns a path, and ensures it's created, to the agents history directory
+ *
+ * Initialize session directory
+ * 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 {string} agentId gotten from Agent.getAgentIdForStorage()
+ * @param {string} sessionId the preview's start call .SessionId
+ * @returns {Promise<string>} path to where history/metadata/transcripts are stored inside of local .sfdx
+ */
+const getHistoryDir = async (agentId, sessionId) => {
     const base = (await resolveProjectLocalSfdx()) ?? path.join(process.cwd(), '.sfdx');
-    const dir = path.join(base, 'agents', agentId);
+    const dir = path.join(base, 'agents', agentId, 'sessions', sessionId);
     await (0, promises_1.mkdir)(dir, { recursive: true });
     return dir;
 };
-const getLastConversationPath = async (agentId) => path.join(await getConversationDir(agentId), 'history.json');
+exports.getHistoryDir = getHistoryDir;
 /**
- * Append a transcript entry to the last conversation JSON file under the project local .sfdx folder.
- * If the entry has event: 'start', this will clear the previous conversation and start fresh.
- * Path: <project>/.sfdx/agents/conversations/<agentId>/history.json
+ * Append a transcript entry to the transcript.jsonl transcript file
+ *
+ * @param {TranscriptEntry} entry to save
+ * @param {string} sessionDir the preview's start call .SessionId
+ * @returns {Promise<void>}
  */
-const appendTranscriptEntry = async (entry, newSession = false) => {
-    const filePath = await getLastConversationPath(entry.agentId);
+const appendTranscriptToHistory = async (entry, sessionDir) => {
+    const transcriptPath = path.join(sessionDir, 'transcript.jsonl');
     const line = `${JSON.stringify(entry)}\n`;
-    // If this is a new session start, clear the file first
-    if (newSession) {
-        await (0, promises_1.writeFile)(filePath, line, 'utf-8');
+    await (0, promises_1.appendFile)(transcriptPath, line, 'utf-8');
+};
+exports.appendTranscriptToHistory = appendTranscriptToHistory;
+/**
+ * writes a trace to <plan-id>.json in history directory
+ *
+ * @param {string} planId
+ * @param {PlannerResponse | undefined} trace
+ * @param {string} historyDir
+ * @returns {Promise<void>}
+ */
+const writeTraceToHistory = async (planId, trace, historyDir) => {
+    const tracesDir = path.join(historyDir, 'traces');
+    await (0, promises_1.mkdir)(tracesDir, { recursive: true });
+    const tracePath = path.join(tracesDir, `${planId}.json`);
+    await (0, promises_1.writeFile)(tracePath, JSON.stringify(trace ?? {}, null, 2), 'utf-8');
+};
+exports.writeTraceToHistory = writeTraceToHistory;
+/**
+ * Write preview metadata to the history directory
+ */
+const writeMetaFileToHistory = async (historyDir, metadata) => {
+    const metadataPath = path.join(historyDir, 'metadata.json');
+    await (0, promises_1.writeFile)(metadataPath, JSON.stringify(metadata, null, 2), 'utf-8');
+};
+exports.writeMetaFileToHistory = writeMetaFileToHistory;
+/**
+ * Calculates the correct endpoint based on env vars
+ *
+ * @returns {string}
+ */
+function getEndpoint() {
+    return kit_1.env.getBoolean('SF_TEST_API') ? 'test.' : '';
+}
+/**
+ * Update preview metadata with end time and plan IDs
+ */
+const updateMetadataEndTime = async (historyDir, endTime, planIds) => {
+    const metadataPath = path.join(historyDir, 'metadata.json');
+    try {
+        const metadata = JSON.parse(await (0, promises_1.readFile)(metadataPath, 'utf-8'));
+        metadata.endTime = endTime;
+        metadata.planIds = Array.from(planIds);
+        await (0, promises_1.writeFile)(metadataPath, JSON.stringify(metadata, null, 2), 'utf-8');
+    }
+    catch {
+        // If metadata doesn't exist, create it
+        await (0, exports.writeMetaFileToHistory)(historyDir, {
+            sessionId: '',
+            agentId: '',
+            startTime: '',
+            endTime,
+            planIds: Array.from(planIds),
+        });
+    }
+};
+exports.updateMetadataEndTime = updateMetadataEndTime;
+/**
+ * Find the most recent session ID for an agent by checking metadata.json startTime
+ *
+ * @param agentId gotten from Agent.getAgentIdForStorage()
+ * @returns The most recent sessionId, or undefined if no sessions found
+ */
+const findMostRecentSessionId = async (agentId) => {
+    const base = (await resolveProjectLocalSfdx()) ?? path.join(process.cwd(), '.sfdx');
+    const sessionsDir = path.join(base, 'agents', agentId, 'sessions');
+    try {
+        const sessionDirs = await (0, promises_1.readdir)(sessionsDir);
+        if (sessionDirs.length === 0) {
+            return undefined;
+        }
+        // Get all sessions with their metadata to find the most recent
+        const sessionPromises = sessionDirs.map(async (sessionId) => {
+            const sessionPath = path.join(sessionsDir, sessionId);
+            const metadataPath = path.join(sessionPath, 'metadata.json');
+            try {
+                const metadataData = await (0, promises_1.readFile)(metadataPath, 'utf-8');
+                const metadata = JSON.parse(metadataData);
+                const statResult = await (0, promises_1.stat)(sessionPath);
+                return {
+                    sessionId,
+                    startTime: metadata.startTime ? new Date(metadata.startTime).getTime() : statResult.mtimeMs,
+                    mtime: statResult.mtimeMs,
+                };
+            }
+            catch {
+                // If metadata doesn't exist or can't be read, use directory modification time
+                try {
+                    const statResult = await (0, promises_1.stat)(sessionPath);
+                    return {
+                        sessionId,
+                        startTime: statResult.mtimeMs,
+                        mtime: statResult.mtimeMs,
+                    };
+                }
+                catch {
+                    return null;
+                }
+            }
+        });
+        const sessions = (await Promise.all(sessionPromises)).filter((s) => s !== null);
+        if (sessions.length === 0) {
+            return undefined;
+        }
+        // Sort by startTime (most recent first), fallback to mtime
+        sessions.sort((a, b) => b.startTime - a.startTime);
+        return sessions[0].sessionId;
+    }
+    catch {
+        // Sessions directory doesn't exist or can't be read
+        return undefined;
+    }
+};
+/**
+ * Get all history data for a session including metadata, transcript, and traces
+ *
+ * @param agentId gotten from Agent.getAgentIdForStorage()
+ * @param sessionId optional - the preview sessions' ID, gotten originally from /start .SessionId. If not provided, returns the most recent conversation
+ * @returns Object containing parsed metadata, transcript entries, and traces
+ */
+const getAllHistory = async (agentId, sessionId) => {
+    // If sessionId is not provided, find the most recent session
+    let actualSessionId = sessionId;
+    if (!actualSessionId) {
+        actualSessionId = await findMostRecentSessionId(agentId);
+        if (!actualSessionId) {
+            throw core_1.SfError.create({
+                name: 'NoSessionFound',
+                message: `No sessions found for agent ${agentId}`,
+            });
+        }
+    }
+    const historyDir = await (0, exports.getHistoryDir)(agentId, actualSessionId);
+    const result = {
+        metadata: null,
+        transcript: [],
+        traces: [],
+    };
+    // Read metadata.json
+    try {
+        const metadataPath = path.join(historyDir, 'metadata.json');
+        const metadataData = await (0, promises_1.readFile)(metadataPath, 'utf-8');
+        result.metadata = JSON.parse(metadataData);
+    }
+    catch {
+        // Metadata file doesn't exist or can't be read - leave as null
+    }
+    // Read transcript.jsonl
+    try {
+        const transcriptPath = path.join(historyDir, 'transcript.jsonl');
+        const transcriptData = await (0, promises_1.readFile)(transcriptPath, 'utf-8');
+        result.transcript = transcriptData
+            .split('\n')
+            .filter((line) => line.trim().length > 0)
+            .map((line) => JSON.parse(line));
+    }
+    catch {
+        // Transcript file doesn't exist or can't be read - leave as empty array
+    }
+    // Read all trace files from traces/ directory
+    try {
+        const tracesDir = path.join(historyDir, 'traces');
+        const files = await (0, promises_1.readdir)(tracesDir);
+        const tracePromises = files
+            .filter((file) => file.endsWith('.json'))
+            .map(async (file) => {
+            const tracePath = path.join(tracesDir, file);
+            const traceData = await (0, promises_1.readFile)(tracePath, 'utf-8');
+            return JSON.parse(traceData);
+        });
+        result.traces = await Promise.all(tracePromises);
     }
-    else {
-        await (0, promises_1.appendFile)(filePath, line);
+    catch {
+        // Traces directory doesn't exist or can't be read - leave as empty array
     }
+    return result;
 };
-exports.appendTranscriptEntry = appendTranscriptEntry;
+exports.getAllHistory = getAllHistory;
 /**
  * Read and parse the last conversation's transcript entries from JSON.
- * Path: <project>/.sfdx/agents/conversations/<agentId>/history.json
  *
- * @param agentId The agent's API name (developerName)
+ * @param agentId gotten from Agent.getAgentIdForStorage()
+ * @param sessionId the preview sessions' ID, gotten originally from /start .SessionId
  * @returns Array of TranscriptEntry in file order (chronological append order).
  */
-const readTranscriptEntries = async (agentId) => {
-    const filePath = await getLastConversationPath(agentId);
+const readTranscriptEntries = async (agentId, sessionId) => {
+    const filePath = await (0, exports.getHistoryDir)(agentId, sessionId);
     try {
         const data = await (0, promises_1.readFile)(filePath, 'utf-8');
         return data

package/lib/utils.js.map

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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@salesforce/agents",
   "description": "Client side APIs for working with Salesforce agents",
-  "version": "0.20.0",
+  "version": "0.21.1",
   "license": "Apache-2.0",
   "author": "Salesforce",
   "main": "lib/index",
@@ -11,9 +11,9 @@
     "url": "https://github.com/forcedotcom/agents.git"
   },
   "dependencies": {
-    "@salesforce/core": "^8.23.5",
+    "@salesforce/core": "^8.24.0",
     "@salesforce/kit": "^3.2.4",
-    "@salesforce/source-deploy-retrieve": "^12.30.0",
+    "@salesforce/source-deploy-retrieve": "^12.31.6",
     "@salesforce/types": "^1.5.0",
     "fast-xml-parser": "^5.3.2",
     "nock": "^13.5.6",

package/lib/agentPreview.d.ts

@@ -1,78 +0,0 @@
-import { Connection } from '@salesforce/core';
-import { AgentPreviewBase } from './agentPreviewBase';
-import { type AgentPreviewStartResponse, type AgentPreviewSendResponse, type AgentPreviewEndResponse, type ApiStatus, type EndReason, PlannerResponse } 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, botId);`
- *
- * Start an interactive session:
- *
- * `const { sessionId } = await agentPreview.start();`
- *
- * 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');`
- *
- * Enable Apex Debug Mode:
- *
- * `agentPreview.toggleApexDebugMode(true);`
- */
-export declare class AgentPreview extends AgentPreviewBase {
-    protected readonly apiBase: string;
-    private readonly botId;
-    /**
-     * Create an instance of the service.
-     *
-     * @param connection The connection to use to make requests.
-     * @param botId The ID of the agent (`Bot` ID).
-     */
-    constructor(connection: Connection, botId: string);
-    /**
-     * Start an interactive session with the agent.
-     *
-     * @returns `AgentPreviewStartResponse`, which includes a session ID needed for other actions.
-     */
-    start(): 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>;
-    /**
-     * Get the traces for a given session and message IDs.
-     *
-     * @param sessionId A session ID provided by first calling `start()`.
-     * @param messageIds An array of message IDs to get the traces for.
-     * @returns `AgentPreviewEndResponse`
-     */
-    traces(sessionId: string, messageIds: string[]): Promise<PlannerResponse[]>;
-    private getBotUserId;
-    private ensureTraceFlag;
-}

package/lib/agentPreview.js

@@ -1,258 +0,0 @@
-"use strict";
-/*
- * Copyright 2025, 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.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.AgentPreview = void 0;
-const node_crypto_1 = require("node:crypto");
-const core_1 = require("@salesforce/core");
-const kit_1 = require("@salesforce/kit");
-const agent_1 = require("./agent");
-const agentPreviewBase_1 = require("./agentPreviewBase");
-const utils_1 = require("./utils");
-const apexUtils_1 = require("./apexUtils");
-;
-const messages = new core_1.Messages('@salesforce/agents', 'agentPreview', new Map([["invalidBotId", "The Bot ID provided must begin with \"0Xx\" and be either 15 or 18 characters. Found: %s"], ["agentApexDebuggingError", "Agent must have a user assigned to enable apex debug mode."]]));
-/**
- * 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, botId);`
- *
- * Start an interactive session:
- *
- * `const { sessionId } = await agentPreview.start();`
- *
- * 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');`
- *
- * Enable Apex Debug Mode:
- *
- * `agentPreview.toggleApexDebugMode(true);`
- */
-class AgentPreview extends agentPreviewBase_1.AgentPreviewBase {
-    apiBase = `https://${kit_1.env.getBoolean('SF_TEST_API') ? 'test.' : ''}api.salesforce.com/einstein/ai-agent/v1`;
-    botId;
-    /**
-     * Create an instance of the service.
-     *
-     * @param connection The connection to use to make requests.
-     * @param botId The ID of the agent (`Bot` ID).
-     */
-    constructor(connection, botId) {
-        super({ connection });
-        if (!botId.startsWith('0Xx') || ![15, 18].includes(botId.length)) {
-            throw messages.createError('invalidBotId', [botId]);
-        }
-        this.botId = botId;
-    }
-    /**
-     * Start an interactive session with the agent.
-     *
-     * @returns `AgentPreviewStartResponse`, which includes a session ID needed for other actions.
-     */
-    async start() {
-        const url = `${this.apiBase}/agents/${this.botId}/sessions`;
-        this.logger.debug(`Starting agent preview session for botId: ${this.botId}`);
-        const body = {
-            externalSessionKey: (0, node_crypto_1.randomUUID)(),
-            instanceConfig: {
-                endpoint: this.connection.instanceUrl,
-            },
-            streamingCapabilities: {
-                chunkTypes: ['Text'],
-            },
-            bypassUser: true,
-        };
-        try {
-            const response = await this.maybeMock.request('POST', url, body);
-            // Persist any initial agent messages (welcome, etc.)
-            await (0, utils_1.appendTranscriptEntry)({
-                timestamp: new Date().toISOString(),
-                agentId: this.botId,
-                sessionId: response.sessionId,
-                role: 'agent',
-                text: response.messages.map((m) => m.message).join('\n'),
-                raw: response.messages,
-            }, true);
-            return response;
-        }
-        catch (err) {
-            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 = {
-            message: {
-                // https://developer.salesforce.com/docs/einstein/genai/guide/agent-api-examples.html#send-synchronous-messages
-                // > A number that you provide to represent the sequence ID. Increase this number for each subsequent message in this session.
-                sequenceId: Date.now(),
-                type: 'Text',
-                text: message,
-            },
-            variables: [],
-        };
-        this.logger.debug(`Sending message to botId: ${this.botId} with apexDebugMode ${this.apexDebugMode ? 'enabled' : 'disabled'}`);
-        try {
-            // If apex debug mode is enabled, ensure we have a trace flag for the bot user and
-            // if there isn't one, create one.
-            const start = Date.now();
-            if (this.apexDebugMode) {
-                await this.ensureTraceFlag();
-            }
-            const response = await this.maybeMock.request('POST', url, body);
-            // Save user entry
-            await (0, utils_1.appendTranscriptEntry)({
-                timestamp: new Date().toISOString(),
-                agentId: this.botId,
-                sessionId,
-                role: 'user',
-                text: message,
-            });
-            // Save agent response entry
-            const agentText = (response.messages ?? [])
-                .map((m) => m.message)
-                .filter(Boolean)
-                .join('\n');
-            await (0, utils_1.appendTranscriptEntry)({
-                timestamp: new Date().toISOString(),
-                agentId: this.botId,
-                sessionId,
-                role: 'agent',
-                text: agentText || undefined,
-                raw: response.messages,
-            });
-            if (this.apexDebugMode) {
-                // get apex debug logs and look for a log within the start and end time
-                const apexLog = await (0, apexUtils_1.getDebugLog)(this.connection, start, Date.now());
-                if (apexLog) {
-                    if (apexLog.Id)
-                        this.logger.debug(`Apex debug log ID for message is ${apexLog.Id}`);
-                    response.apexDebugLog = apexLog;
-                }
-                else {
-                    this.logger.debug('No apex debug log found for this message');
-                }
-            }
-            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 end(sessionId, reason) {
-        const url = `${this.apiBase}/sessions/${sessionId}`;
-        this.logger.debug(`Ending agent preview session for botId: ${this.botId} with sessionId: ${sessionId}`);
-        try {
-            // https://developer.salesforce.com/docs/einstein/genai/guide/agent-api-examples.html#end-session
-            const response = await this.maybeMock.request('DELETE', url, undefined, {
-                'x-session-end-reason': reason,
-            });
-            await (0, utils_1.appendTranscriptEntry)({
-                timestamp: new Date().toISOString(),
-                agentId: this.botId,
-                sessionId,
-                role: 'agent',
-                reason,
-                raw: response.messages,
-            });
-            return response;
-        }
-        catch (err) {
-            throw core_1.SfError.wrap(err);
-        }
-    }
-    /**
-     * Get the status of the Agent API (UP | DOWN).
-     *
-     * @returns `ApiStatus`
-     */
-    async status() {
-        const url = `https://${kit_1.env.getBoolean('SF_TEST_API') ? 'test.' : ''}api.salesforce.com/einstein/ai-agent/v1/status`;
-        try {
-            return await this.maybeMock.request('GET', url);
-        }
-        catch (err) {
-            throw core_1.SfError.wrap(err);
-        }
-    }
-    /**
-     * Get the traces for a given session and message IDs.
-     *
-     * @param sessionId A session ID provided by first calling `start()`.
-     * @param messageIds An array of message IDs to get the traces for.
-     * @returns `AgentPreviewEndResponse`
-     */
-    traces(sessionId, messageIds) {
-        this.logger.info(`Get traces for published agents is not implemented yet. Session ID: ${sessionId}, Message IDs: ${messageIds.join(', ')}`);
-        return Promise.resolve([]);
-    }
-    async getBotUserId() {
-        const agent = new agent_1.Agent({ connection: this.connection, nameOrId: this.botId });
-        const botMetadata = await agent.getBotMetadata();
-        return botMetadata.BotUserId;
-    }
-    // If apex debug mode is enabled, ensure we have a trace flag for the bot user
-    // that is not expired checking in this order:
-    // 1. instance var (this.apexTraceFlag)
-    // 2. query the org
-    // 3. create a new trace flag
-    async ensureTraceFlag() {
-        if (this.apexTraceFlag) {
-            const expDate = this.apexTraceFlag.ExpirationDate;
-            if (expDate && new Date(expDate) > new Date()) {
-                this.logger.debug(`Using cached apexTraceFlag with ExpirationDate of ${expDate}`);
-                return;
-            }
-            else {
-                this.logger.debug('Cached apex trace flag is expired');
-            }
-        }
-        const userId = await this.getBotUserId();
-        if (!userId) {
-            throw messages.createError('agentApexDebuggingError');
-        }
-        this.apexTraceFlag = await (0, apexUtils_1.findTraceFlag)(this.connection, userId);
-        if (!this.apexTraceFlag) {
-            await (0, apexUtils_1.createTraceFlag)(this.connection, userId);
-        }
-    }
-}
-exports.AgentPreview = AgentPreview;
-//# sourceMappingURL=agentPreview.js.map