@salesforce/agents 0.19.7 → 0.20.0-beta.2

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 (46) hide show
  1. package/README.md +3 -1
  2. package/lib/agent.d.ts +26 -86
  3. package/lib/agent.js +115 -315
  4. package/lib/agent.js.map +1 -1
  5. package/lib/agentTest.js +1 -1
  6. package/lib/agentTestResults.js +1 -1
  7. package/lib/agentTester.js +1 -1
  8. package/lib/agents/agentBase.d.ts +82 -0
  9. package/lib/agents/agentBase.js +106 -0
  10. package/lib/agents/agentBase.js.map +1 -0
  11. package/lib/agents/productionAgent.d.ts +51 -0
  12. package/lib/agents/productionAgent.js +336 -0
  13. package/lib/agents/productionAgent.js.map +1 -0
  14. package/lib/agents/scriptAgent.d.ts +61 -0
  15. package/lib/agents/scriptAgent.js +502 -0
  16. package/lib/agents/scriptAgent.js.map +1 -0
  17. package/lib/{agentPublisher.d.ts → agents/scriptAgentPublisher.d.ts} +26 -10
  18. package/lib/{agentPublisher.js → agents/scriptAgentPublisher.js} +50 -24
  19. package/lib/agents/scriptAgentPublisher.js.map +1 -0
  20. package/lib/apexUtils.d.ts +1 -0
  21. package/lib/apexUtils.js +11 -1
  22. package/lib/apexUtils.js.map +1 -1
  23. package/lib/index.d.ts +4 -5
  24. package/lib/index.js +8 -10
  25. package/lib/index.js.map +1 -1
  26. package/lib/maybe-mock.js +1 -1
  27. package/lib/types.d.ts +22 -8
  28. package/lib/types.js +1 -1
  29. package/lib/types.js.map +1 -1
  30. package/lib/utils.d.ts +36 -4
  31. package/lib/utils.js +69 -13
  32. package/lib/utils.js.map +1 -1
  33. package/package.json +2 -2
  34. package/lib/agentPreview.d.ts +0 -70
  35. package/lib/agentPreview.js +0 -247
  36. package/lib/agentPreview.js.map +0 -1
  37. package/lib/agentPreviewBase.d.ts +0 -51
  38. package/lib/agentPreviewBase.js +0 -55
  39. package/lib/agentPreviewBase.js.map +0 -1
  40. package/lib/agentPublisher.js.map +0 -1
  41. package/lib/agentSimulate.d.ts +0 -78
  42. package/lib/agentSimulate.js +0 -286
  43. package/lib/agentSimulate.js.map +0 -1
  44. package/lib/agentTrace.d.ts +0 -23
  45. package/lib/agentTrace.js +0 -47
  46. package/lib/agentTrace.js.map +0 -1
package/lib/utils.js CHANGED
@@ -33,9 +33,10 @@ var __importStar = (this && this.__importStar) || (function () {
33
33
  };
34
34
  })();
35
35
  Object.defineProperty(exports, "__esModule", { value: true });
36
- exports.readTranscriptEntries = exports.appendTranscriptEntry = exports.useNamedUserJwt = exports.findLocalAgents = exports.findAuthoringBundle = exports.decodeHtmlEntities = exports.sanitizeFilename = exports.metric = void 0;
36
+ exports.readTranscriptEntries = exports.updateMetadataEndTime = exports.writeMetadataToSession = exports.writeTraceToSession = exports.appendTranscriptEntryToSession = exports.copyDirectory = exports.getSessionDir = exports.useNamedUserJwt = exports.findLocalAgents = exports.findAuthoringBundle = exports.decodeHtmlEntities = exports.sanitizeFilename = exports.metric = void 0;
37
+ exports.getEndpoint = getEndpoint;
37
38
  /*
38
- * Copyright 2025, Salesforce, Inc.
39
+ * Copyright 2026, Salesforce, Inc.
39
40
  *
40
41
  * Licensed under the Apache License, Version 2.0 (the "License");
41
42
  * you may not use this file except in compliance with the License.
@@ -53,6 +54,7 @@ const node_fs_1 = require("node:fs");
53
54
  const promises_1 = require("node:fs/promises");
54
55
  const path = __importStar(require("node:path"));
55
56
  const core_1 = require("@salesforce/core");
57
+ const kit_1 = require("@salesforce/kit");
56
58
  exports.metric = ['completeness', 'coherence', 'conciseness', 'output_latency_milliseconds'];
57
59
  /**
58
60
  * Sanitize a filename by removing or replacing illegal characters.
@@ -256,22 +258,76 @@ const getConversationDir = async (agentId) => {
256
258
  };
257
259
  const getLastConversationPath = async (agentId) => path.join(await getConversationDir(agentId), 'history.json');
258
260
  /**
259
- * Append a transcript entry to the last conversation JSON file under the project local .sfdx folder.
260
- * If the entry has event: 'start', this will clear the previous conversation and start fresh.
261
- * Path: <project>/.sfdx/agents/conversations/<agentId>/history.json
261
+ * Get the session directory path for a specific session
262
262
  */
263
- const appendTranscriptEntry = async (entry, newSession = false) => {
264
- const filePath = await getLastConversationPath(entry.agentId);
263
+ const getSessionDir = async (agentId, sessionId) => {
264
+ const base = (await resolveProjectLocalSfdx()) ?? path.join(process.cwd(), '.sfdx');
265
+ const dir = path.join(base, 'agents', agentId, 'sessions', sessionId);
266
+ await (0, promises_1.mkdir)(dir, { recursive: true });
267
+ return dir;
268
+ };
269
+ exports.getSessionDir = getSessionDir;
270
+ /**
271
+ * Copy a directory recursively
272
+ */
273
+ const copyDirectory = async (src, dest) => {
274
+ await (0, promises_1.mkdir)(dest, { recursive: true });
275
+ await (0, promises_1.cp)(src, dest, { recursive: true });
276
+ };
277
+ exports.copyDirectory = copyDirectory;
278
+ /**
279
+ * Append a transcript entry to the session transcript file
280
+ */
281
+ const appendTranscriptEntryToSession = async (entry, sessionDir) => {
282
+ const transcriptPath = path.join(sessionDir, 'transcript.jsonl');
265
283
  const line = `${JSON.stringify(entry)}\n`;
266
- // If this is a new session start, clear the file first
267
- if (newSession) {
268
- await (0, promises_1.writeFile)(filePath, line, 'utf-8');
284
+ await (0, promises_1.appendFile)(transcriptPath, line, 'utf-8');
285
+ };
286
+ exports.appendTranscriptEntryToSession = appendTranscriptEntryToSession;
287
+ /**
288
+ * Write a trace to the session traces directory
289
+ */
290
+ const writeTraceToSession = async (planId, trace, sessionDir) => {
291
+ const tracesDir = path.join(sessionDir, 'traces');
292
+ await (0, promises_1.mkdir)(tracesDir, { recursive: true });
293
+ const tracePath = path.join(tracesDir, `${planId}.json`);
294
+ await (0, promises_1.writeFile)(tracePath, JSON.stringify(trace ?? {}, null, 2), 'utf-8');
295
+ };
296
+ exports.writeTraceToSession = writeTraceToSession;
297
+ function getEndpoint() {
298
+ return kit_1.env.getBoolean('SF_TEST_API') ? 'test.' : '';
299
+ }
300
+ /**
301
+ * Write session metadata to the session directory
302
+ */
303
+ const writeMetadataToSession = async (sessionDir, metadata) => {
304
+ const metadataPath = path.join(sessionDir, 'metadata.json');
305
+ await (0, promises_1.writeFile)(metadataPath, JSON.stringify(metadata, null, 2), 'utf-8');
306
+ };
307
+ exports.writeMetadataToSession = writeMetadataToSession;
308
+ /**
309
+ * Update session metadata with end time and plan IDs
310
+ */
311
+ const updateMetadataEndTime = async (sessionDir, endTime, planIds) => {
312
+ const metadataPath = path.join(sessionDir, 'metadata.json');
313
+ try {
314
+ const metadata = JSON.parse(await (0, promises_1.readFile)(metadataPath, 'utf-8'));
315
+ metadata.endTime = endTime;
316
+ metadata.planIds = Array.from(planIds);
317
+ await (0, promises_1.writeFile)(metadataPath, JSON.stringify(metadata, null, 2), 'utf-8');
269
318
  }
270
- else {
271
- await (0, promises_1.appendFile)(filePath, line);
319
+ catch {
320
+ // If metadata doesn't exist, create it
321
+ await (0, exports.writeMetadataToSession)(sessionDir, {
322
+ sessionId: '',
323
+ agentId: '',
324
+ startTime: '',
325
+ endTime,
326
+ planIds: Array.from(planIds),
327
+ });
272
328
  }
273
329
  };
274
- exports.appendTranscriptEntry = appendTranscriptEntry;
330
+ exports.updateMetadataEndTime = updateMetadataEndTime;
275
331
  /**
276
332
  * Read and parse the last conversation's transcript entries from JSON.
277
333
  * Path: <project>/.sfdx/agents/conversations/<agentId>/history.json
package/lib/utils.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"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"}
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@salesforce/agents",
3
3
  "description": "Client side APIs for working with Salesforce agents",
4
- "version": "0.19.7",
4
+ "version": "0.20.0-beta.2",
5
5
  "license": "Apache-2.0",
6
6
  "author": "Salesforce",
7
7
  "main": "lib/index",
@@ -184,7 +184,7 @@
184
184
  "output": []
185
185
  },
186
186
  "link-check": {
187
- "command": "node -e \"process.exit(process.env.CI ? 0 : 1)\" || linkinator \"**/*.md\" --skip \"CHANGELOG.md|node_modules|test/|confluence.internal.salesforce.com|my.salesforce.com|%s\" --markdown --retry --directory-listing --verbosity error",
187
+ "command": "node -e \"process.exit(process.env.CI ? 0 : 1)\" || linkinator \"**/*.md\" --skip \"CHANGELOG.md|node_modules|test/|confluence.internal.salesforce.com|my.salesforce.com|npmjs.com|%s\" --markdown --retry --directory-listing --verbosity error",
188
188
  "files": [
189
189
  "./*.md",
190
190
  "./!(CHANGELOG).md",
@@ -1,70 +0,0 @@
1
- import { Connection } from '@salesforce/core';
2
- import { AgentPreviewBase } from './agentPreviewBase';
3
- import { type AgentPreviewStartResponse, type AgentPreviewSendResponse, type AgentPreviewEndResponse, type ApiStatus, type EndReason } from './types.js';
4
- /**
5
- * A service to interact with an agent. Start an interactive session,
6
- * send messages to the agent, and end the session.
7
- *
8
- * **Examples**
9
- *
10
- * Create an instance of the service:
11
- *
12
- * `const agentPreview = new AgentPreview(connection, botId);`
13
- *
14
- * Start an interactive session:
15
- *
16
- * `const { sessionId } = await agentPreview.start();`
17
- *
18
- * Send a message to the agent using the session ID from the startResponse:
19
- *
20
- * `const sendResponse = await agentPreview.send(sessionId, message);`
21
- *
22
- * End an interactive session:
23
- *
24
- * `await agentPreview.end(sessionId, 'UserRequest');`
25
- *
26
- * Enable Apex Debug Mode:
27
- *
28
- * `agentPreview.toggleApexDebugMode(true);`
29
- */
30
- export declare class AgentPreview extends AgentPreviewBase {
31
- protected readonly apiBase: string;
32
- private readonly botId;
33
- /**
34
- * Create an instance of the service.
35
- *
36
- * @param connection The connection to use to make requests.
37
- * @param botId The ID of the agent (`Bot` ID).
38
- */
39
- constructor(connection: Connection, botId: string);
40
- /**
41
- * Start an interactive session with the agent.
42
- *
43
- * @returns `AgentPreviewStartResponse`, which includes a session ID needed for other actions.
44
- */
45
- start(): Promise<AgentPreviewStartResponse>;
46
- /**
47
- * Send a message to the agent using the session ID obtained by calling `start()`.
48
- *
49
- * @param sessionId A session ID provided by first calling `agentPreview.start()`.
50
- * @param message A message to send to the agent.
51
- * @returns `AgentPreviewSendResponse`
52
- */
53
- send(sessionId: string, message: string): Promise<AgentPreviewSendResponse>;
54
- /**
55
- * Ends an interactive session with the agent.
56
- *
57
- * @param sessionId A session ID provided by first calling `agentPreview.start()`.
58
- * @param reason A reason why the interactive session was ended.
59
- * @returns `AgentPreviewEndResponse`
60
- */
61
- end(sessionId: string, reason: EndReason): Promise<AgentPreviewEndResponse>;
62
- /**
63
- * Get the status of the Agent API (UP | DOWN).
64
- *
65
- * @returns `ApiStatus`
66
- */
67
- status(): Promise<ApiStatus>;
68
- private getBotUserId;
69
- private ensureTraceFlag;
70
- }
@@ -1,247 +0,0 @@
1
- "use strict";
2
- /*
3
- * Copyright 2025, Salesforce, Inc.
4
- *
5
- * Licensed under the Apache License, Version 2.0 (the "License");
6
- * you may not use this file except in compliance with the License.
7
- * You may obtain a copy of the License at
8
- *
9
- * http://www.apache.org/licenses/LICENSE-2.0
10
- *
11
- * Unless required by applicable law or agreed to in writing, software
12
- * distributed under the License is distributed on an "AS IS" BASIS,
13
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14
- * See the License for the specific language governing permissions and
15
- * limitations under the License.
16
- */
17
- Object.defineProperty(exports, "__esModule", { value: true });
18
- exports.AgentPreview = void 0;
19
- const node_crypto_1 = require("node:crypto");
20
- const core_1 = require("@salesforce/core");
21
- const kit_1 = require("@salesforce/kit");
22
- const agent_1 = require("./agent");
23
- const agentPreviewBase_1 = require("./agentPreviewBase");
24
- const utils_1 = require("./utils");
25
- const apexUtils_1 = require("./apexUtils");
26
- ;
27
- 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."]]));
28
- /**
29
- * A service to interact with an agent. Start an interactive session,
30
- * send messages to the agent, and end the session.
31
- *
32
- * **Examples**
33
- *
34
- * Create an instance of the service:
35
- *
36
- * `const agentPreview = new AgentPreview(connection, botId);`
37
- *
38
- * Start an interactive session:
39
- *
40
- * `const { sessionId } = await agentPreview.start();`
41
- *
42
- * Send a message to the agent using the session ID from the startResponse:
43
- *
44
- * `const sendResponse = await agentPreview.send(sessionId, message);`
45
- *
46
- * End an interactive session:
47
- *
48
- * `await agentPreview.end(sessionId, 'UserRequest');`
49
- *
50
- * Enable Apex Debug Mode:
51
- *
52
- * `agentPreview.toggleApexDebugMode(true);`
53
- */
54
- class AgentPreview extends agentPreviewBase_1.AgentPreviewBase {
55
- apiBase = `https://${kit_1.env.getBoolean('SF_TEST_API') ? 'test.' : ''}api.salesforce.com/einstein/ai-agent/v1`;
56
- botId;
57
- /**
58
- * Create an instance of the service.
59
- *
60
- * @param connection The connection to use to make requests.
61
- * @param botId The ID of the agent (`Bot` ID).
62
- */
63
- constructor(connection, botId) {
64
- super({ connection });
65
- if (!botId.startsWith('0Xx') || ![15, 18].includes(botId.length)) {
66
- throw messages.createError('invalidBotId', [botId]);
67
- }
68
- this.botId = botId;
69
- }
70
- /**
71
- * Start an interactive session with the agent.
72
- *
73
- * @returns `AgentPreviewStartResponse`, which includes a session ID needed for other actions.
74
- */
75
- async start() {
76
- const url = `${this.apiBase}/agents/${this.botId}/sessions`;
77
- this.logger.debug(`Starting agent preview session for botId: ${this.botId}`);
78
- const body = {
79
- externalSessionKey: (0, node_crypto_1.randomUUID)(),
80
- instanceConfig: {
81
- endpoint: this.connection.instanceUrl,
82
- },
83
- streamingCapabilities: {
84
- chunkTypes: ['Text'],
85
- },
86
- bypassUser: true,
87
- };
88
- try {
89
- const response = await this.maybeMock.request('POST', url, body);
90
- // Persist any initial agent messages (welcome, etc.)
91
- await (0, utils_1.appendTranscriptEntry)({
92
- timestamp: new Date().toISOString(),
93
- agentId: this.botId,
94
- sessionId: response.sessionId,
95
- role: 'agent',
96
- text: response.messages.map((m) => m.message).join('\n'),
97
- raw: response.messages,
98
- }, true);
99
- return response;
100
- }
101
- catch (err) {
102
- throw core_1.SfError.wrap(err);
103
- }
104
- }
105
- /**
106
- * Send a message to the agent using the session ID obtained by calling `start()`.
107
- *
108
- * @param sessionId A session ID provided by first calling `agentPreview.start()`.
109
- * @param message A message to send to the agent.
110
- * @returns `AgentPreviewSendResponse`
111
- */
112
- async send(sessionId, message) {
113
- const url = `${this.apiBase}/sessions/${sessionId}/messages`;
114
- const body = {
115
- message: {
116
- // https://developer.salesforce.com/docs/einstein/genai/guide/agent-api-examples.html#send-synchronous-messages
117
- // > A number that you provide to represent the sequence ID. Increase this number for each subsequent message in this session.
118
- sequenceId: Date.now(),
119
- type: 'Text',
120
- text: message,
121
- },
122
- variables: [],
123
- };
124
- this.logger.debug(`Sending message to botId: ${this.botId} with apexDebugMode ${this.apexDebugMode ? 'enabled' : 'disabled'}`);
125
- try {
126
- // If apex debug mode is enabled, ensure we have a trace flag for the bot user and
127
- // if there isn't one, create one.
128
- const start = Date.now();
129
- if (this.apexDebugMode) {
130
- await this.ensureTraceFlag();
131
- }
132
- const response = await this.maybeMock.request('POST', url, body);
133
- // Save user entry
134
- await (0, utils_1.appendTranscriptEntry)({
135
- timestamp: new Date().toISOString(),
136
- agentId: this.botId,
137
- sessionId,
138
- role: 'user',
139
- text: message,
140
- });
141
- // Save agent response entry
142
- const agentText = (response.messages ?? [])
143
- .map((m) => m.message)
144
- .filter(Boolean)
145
- .join('\n');
146
- await (0, utils_1.appendTranscriptEntry)({
147
- timestamp: new Date().toISOString(),
148
- agentId: this.botId,
149
- sessionId,
150
- role: 'agent',
151
- text: agentText || undefined,
152
- raw: response.messages,
153
- });
154
- if (this.apexDebugMode) {
155
- // get apex debug logs and look for a log within the start and end time
156
- const apexLog = await (0, apexUtils_1.getDebugLog)(this.connection, start, Date.now());
157
- if (apexLog) {
158
- if (apexLog.Id)
159
- this.logger.debug(`Apex debug log ID for message is ${apexLog.Id}`);
160
- response.apexDebugLog = apexLog;
161
- }
162
- else {
163
- this.logger.debug('No apex debug log found for this message');
164
- }
165
- }
166
- return response;
167
- }
168
- catch (err) {
169
- throw core_1.SfError.wrap(err);
170
- }
171
- }
172
- /**
173
- * Ends an interactive session with the agent.
174
- *
175
- * @param sessionId A session ID provided by first calling `agentPreview.start()`.
176
- * @param reason A reason why the interactive session was ended.
177
- * @returns `AgentPreviewEndResponse`
178
- */
179
- async end(sessionId, reason) {
180
- const url = `${this.apiBase}/sessions/${sessionId}`;
181
- this.logger.debug(`Ending agent preview session for botId: ${this.botId} with sessionId: ${sessionId}`);
182
- try {
183
- // https://developer.salesforce.com/docs/einstein/genai/guide/agent-api-examples.html#end-session
184
- const response = await this.maybeMock.request('DELETE', url, undefined, {
185
- 'x-session-end-reason': reason,
186
- });
187
- await (0, utils_1.appendTranscriptEntry)({
188
- timestamp: new Date().toISOString(),
189
- agentId: this.botId,
190
- sessionId,
191
- role: 'agent',
192
- reason,
193
- raw: response.messages,
194
- });
195
- return response;
196
- }
197
- catch (err) {
198
- throw core_1.SfError.wrap(err);
199
- }
200
- }
201
- /**
202
- * Get the status of the Agent API (UP | DOWN).
203
- *
204
- * @returns `ApiStatus`
205
- */
206
- async status() {
207
- const url = `https://${kit_1.env.getBoolean('SF_TEST_API') ? 'test.' : ''}api.salesforce.com/einstein/ai-agent/v1/status`;
208
- try {
209
- return await this.maybeMock.request('GET', url);
210
- }
211
- catch (err) {
212
- throw core_1.SfError.wrap(err);
213
- }
214
- }
215
- async getBotUserId() {
216
- const agent = new agent_1.Agent({ connection: this.connection, nameOrId: this.botId });
217
- const botMetadata = await agent.getBotMetadata();
218
- return botMetadata.BotUserId;
219
- }
220
- // If apex debug mode is enabled, ensure we have a trace flag for the bot user
221
- // that is not expired checking in this order:
222
- // 1. instance var (this.apexTraceFlag)
223
- // 2. query the org
224
- // 3. create a new trace flag
225
- async ensureTraceFlag() {
226
- if (this.apexTraceFlag) {
227
- const expDate = this.apexTraceFlag.ExpirationDate;
228
- if (expDate && new Date(expDate) > new Date()) {
229
- this.logger.debug(`Using cached apexTraceFlag with ExpirationDate of ${expDate}`);
230
- return;
231
- }
232
- else {
233
- this.logger.debug('Cached apex trace flag is expired');
234
- }
235
- }
236
- const userId = await this.getBotUserId();
237
- if (!userId) {
238
- throw messages.createError('agentApexDebuggingError');
239
- }
240
- this.apexTraceFlag = await (0, apexUtils_1.findTraceFlag)(this.connection, userId);
241
- if (!this.apexTraceFlag) {
242
- await (0, apexUtils_1.createTraceFlag)(this.connection, userId);
243
- }
244
- }
245
- }
246
- exports.AgentPreview = AgentPreview;
247
- //# sourceMappingURL=agentPreview.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"agentPreview.js","sourceRoot":"","sources":["../src/agentPreview.ts"],"names":[],"mappings":"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"}
@@ -1,51 +0,0 @@
1
- import { Connection, Logger } from '@salesforce/core';
2
- import { MaybeMock } from './maybe-mock';
3
- import { type AgentPreviewEndResponse, type AgentPreviewStartResponse, type AgentPreviewSendResponse, type EndReason, type BaseAgentConfig, type AgentInteractionBase } from './types.js';
4
- /**
5
- * Abstract base class for agent runners that provides common functionality
6
- * for interacting with agents through the Einstein AI Agent API.
7
- */
8
- export declare abstract class AgentPreviewBase implements AgentInteractionBase {
9
- protected connection: Connection;
10
- protected apexTraceFlag?: {
11
- Id?: string;
12
- ExpirationDate?: string;
13
- };
14
- protected readonly logger: Logger;
15
- protected readonly maybeMock: MaybeMock;
16
- protected apexDebugMode?: boolean;
17
- protected constructor(config: BaseAgentConfig);
18
- /**
19
- * Get the base API URL for the agent service.
20
- * This is overridden by child classes to provide their specific API base.
21
- */
22
- protected abstract get apiBase(): string;
23
- /**
24
- * Enable or disable Apex Debug Mode, which will enable trace flags for the Bot user
25
- * and create apex debug logs for use within VS Code's Apex Replay Debugger.
26
- *
27
- * @param enable Whether to enable or disable Apex Debug Mode.
28
- */
29
- setApexDebugMode(enable: boolean): void;
30
- /**
31
- * Start an interactive session with the agent.
32
- * This is implemented by child classes to provide their specific start logic.
33
- */
34
- abstract start(): Promise<AgentPreviewStartResponse>;
35
- /**
36
- * Send a message to the agent using the session ID obtained by calling `start()`.
37
- *
38
- * @param sessionId A session ID provided by first calling `start()`.
39
- * @param message A message to send to the agent.
40
- * @returns `AgentPreviewSendResponse`
41
- */
42
- abstract send(sessionId: string, message: string): Promise<AgentPreviewSendResponse>;
43
- /**
44
- * Ends an interactive session with the agent.
45
- *
46
- * @param sessionId A session ID provided by first calling `start()`.
47
- * @param reason A reason why the interactive session was ended.
48
- * @returns `AgentPreviewEndResponse`
49
- */
50
- abstract end(sessionId: string, reason: EndReason): Promise<AgentPreviewEndResponse>;
51
- }
@@ -1,55 +0,0 @@
1
- "use strict";
2
- /*
3
- * Copyright 2025, Salesforce, Inc.
4
- *
5
- * Licensed under the Apache License, Version 2.0 (the "License");
6
- * you may not use this file except in compliance with the License.
7
- * You may obtain a copy of the License at
8
- *
9
- * http://www.apache.org/licenses/LICENSE-2.0
10
- *
11
- * Unless required by applicable law or agreed to in writing, software
12
- * distributed under the License is distributed on an "AS IS" BASIS,
13
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14
- * See the License for the specific language governing permissions and
15
- * limitations under the License.
16
- */
17
- Object.defineProperty(exports, "__esModule", { value: true });
18
- exports.AgentPreviewBase = void 0;
19
- const core_1 = require("@salesforce/core");
20
- const maybe_mock_1 = require("./maybe-mock");
21
- /**
22
- * Abstract base class for agent runners that provides common functionality
23
- * for interacting with agents through the Einstein AI Agent API.
24
- */
25
- class AgentPreviewBase {
26
- connection;
27
- apexTraceFlag;
28
- logger;
29
- maybeMock;
30
- apexDebugMode;
31
- constructor(config) {
32
- if (!config.connection) {
33
- throw new Error('Connection is required');
34
- }
35
- // Protected properties
36
- const connection = config.connection;
37
- const logger = config.logger ?? core_1.Logger.childFromRoot(this.constructor.name);
38
- // Initialize protected properties
39
- this.connection = connection;
40
- this.logger = logger;
41
- this.maybeMock = new maybe_mock_1.MaybeMock(connection);
42
- }
43
- /**
44
- * Enable or disable Apex Debug Mode, which will enable trace flags for the Bot user
45
- * and create apex debug logs for use within VS Code's Apex Replay Debugger.
46
- *
47
- * @param enable Whether to enable or disable Apex Debug Mode.
48
- */
49
- setApexDebugMode(enable) {
50
- this.apexDebugMode = enable;
51
- this.logger.debug(`Apex Debug Mode is now ${enable ? 'enabled' : 'disabled'}`);
52
- }
53
- }
54
- exports.AgentPreviewBase = AgentPreviewBase;
55
- //# sourceMappingURL=agentPreviewBase.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"agentPreviewBase.js","sourceRoot":"","sources":["../src/agentPreviewBase.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;GAcG;;;AAEH,2CAAsD;AACtD,6CAAyC;AAUzC;;;GAGG;AACH,MAAsB,gBAAgB;IAC1B,UAAU,CAAa;IACvB,aAAa,CAA4C;IAChD,MAAM,CAAS;IACf,SAAS,CAAY;IAC9B,aAAa,CAAW;IAElC,YAAsB,MAAuB;QAC3C,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;QAC5C,CAAC;QAED,uBAAuB;QACvB,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;QACrC,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,aAAM,CAAC,aAAa,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QAE5E,kCAAkC;QAClC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,SAAS,GAAG,IAAI,sBAAS,CAAC,UAAU,CAAC,CAAC;IAC7C,CAAC;IAOD;;;;;OAKG;IACI,gBAAgB,CAAC,MAAe;QACrC,IAAI,CAAC,aAAa,GAAG,MAAM,CAAC;QAC5B,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,0BAA0B,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC;IACjF,CAAC;CAyBF;AA7DD,4CA6DC"}
@@ -1 +0,0 @@
1
- {"version":3,"file":"agentPublisher.js","sourceRoot":"","sources":["../src/agentPublisher.ts"],"names":[],"mappings":"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"}