@salesforce/agents 0.20.0 → 0.21.1

package/lib/agentPreview.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"agentPreview.js","sourceRoot":"","sources":["../src/agentPreview.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;GAcG;;;AAEH,6CAAyC;AACzC,2CAAiE;AACjE,yCAAsC;AACtC,mCAAgC;AAChC,yDAAsD;AAStD,mCAAgD;AAChD,2CAA0E;;AAG1E,MAAM,QAAQ,OAAG,eAAQ,CAAc,oBAAoB,EAAE,cAAc,qNAAC,CAAC;AAE7E;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAa,YAAa,SAAQ,mCAAgB;IAC7B,OAAO,GAAG,WAC3B,SAAG,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAC5C,yCAAyC,CAAC;IACzB,KAAK,CAAS;IAE/B;;;;;OAKG;IACH,YAAmB,UAAsB,EAAE,KAAa;QACtD,KAAK,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC;QACtB,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;YACjE,MAAM,QAAQ,CAAC,WAAW,CAAC,cAAc,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;QACtD,CAAC;QACD,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAED;;;;OAIG;IACI,KAAK,CAAC,KAAK;QAChB,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,OAAO,WAAW,IAAI,CAAC,KAAK,WAAW,CAAC;QAC5D,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,6CAA6C,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;QAE7E,MAAM,IAAI,GAAG;YACX,kBAAkB,EAAE,IAAA,wBAAU,GAAE;YAChC,cAAc,EAAE;gBACd,QAAQ,EAAE,IAAI,CAAC,UAAU,CAAC,WAAW;aACtC;YACD,qBAAqB,EAAE;gBACrB,UAAU,EAAE,CAAC,MAAM,CAAC;aACrB;YACD,UAAU,EAAE,IAAI;SACjB,CAAC;QAEF,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,CAA4B,MAAM,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;YAC5F,qDAAqD;YAErD,MAAM,IAAA,6BAAqB,EACzB;gBACE,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBACnC,OAAO,EAAE,IAAI,CAAC,KAAK;gBACnB,SAAS,EAAE,QAAQ,CAAC,SAAS;gBAC7B,IAAI,EAAE,OAAO;gBACb,IAAI,EAAE,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;gBACxD,GAAG,EAAE,QAAQ,CAAC,QAAQ;aACvB,EACD,IAAI,CACL,CAAC;YAEF,OAAO,QAAQ,CAAC;QAClB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,cAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACI,KAAK,CAAC,IAAI,CAAC,SAAiB,EAAE,OAAe;QAClD,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,OAAO,aAAa,SAAS,WAAW,CAAC;QAC7D,MAAM,IAAI,GAAG;YACX,OAAO,EAAE;gBACP,+GAA+G;gBAC/G,8HAA8H;gBAC9H,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE;gBACtB,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,OAAO;aACd;YACD,SAAS,EAAE,EAAE;SACd,CAAC;QACF,IAAI,CAAC,MAAM,CAAC,KAAK,CACf,6BAA6B,IAAI,CAAC,KAAK,uBAAuB,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,EAAE,CAC5G,CAAC;QAEF,IAAI,CAAC;YACH,kFAAkF;YAClF,kCAAkC;YAClC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACzB,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;gBACvB,MAAM,IAAI,CAAC,eAAe,EAAE,CAAC;YAC/B,CAAC;YACD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,CAA2B,MAAM,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;YAC3F,kBAAkB;YAClB,MAAM,IAAA,6BAAqB,EAAC;gBAC1B,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBACnC,OAAO,EAAE,IAAI,CAAC,KAAK;gBACnB,SAAS;gBACT,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,OAAO;aACd,CAAC,CAAC;YACH,4BAA4B;YAC5B,MAAM,SAAS,GAAG,CAAC,QAAQ,CAAC,QAAQ,IAAI,EAAE,CAAC;iBACxC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;iBACrB,MAAM,CAAC,OAAO,CAAC;iBACf,IAAI,CAAC,IAAI,CAAC,CAAC;YACd,MAAM,IAAA,6BAAqB,EAAC;gBAC1B,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBACnC,OAAO,EAAE,IAAI,CAAC,KAAK;gBACnB,SAAS;gBACT,IAAI,EAAE,OAAO;gBACb,IAAI,EAAE,SAAS,IAAI,SAAS;gBAC5B,GAAG,EAAE,QAAQ,CAAC,QAAQ;aACvB,CAAC,CAAC;YACH,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;gBACvB,uEAAuE;gBACvE,MAAM,OAAO,GAAG,MAAM,IAAA,uBAAW,EAAC,IAAI,CAAC,UAAU,EAAE,KAAK,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;gBACtE,IAAI,OAAO,EAAE,CAAC;oBACZ,IAAI,OAAO,CAAC,EAAE;wBAAE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,oCAAoC,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC;oBACpF,QAAQ,CAAC,YAAY,GAAG,OAAO,CAAC;gBAClC,CAAC;qBAAM,CAAC;oBACN,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,0CAA0C,CAAC,CAAC;gBAChE,CAAC;YACH,CAAC;YAED,OAAO,QAAQ,CAAC;QAClB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,cAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACI,KAAK,CAAC,GAAG,CAAC,SAAiB,EAAE,MAAiB;QACnD,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,OAAO,aAAa,SAAS,EAAE,CAAC;QACpD,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,2CAA2C,IAAI,CAAC,KAAK,oBAAoB,SAAS,EAAE,CAAC,CAAC;QACxG,IAAI,CAAC;YACH,iGAAiG;YACjG,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,CAA0B,QAAQ,EAAE,GAAG,EAAE,SAAS,EAAE;gBAC/F,sBAAsB,EAAE,MAAM;aAC/B,CAAC,CAAC;YACH,MAAM,IAAA,6BAAqB,EAAC;gBAC1B,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBACnC,OAAO,EAAE,IAAI,CAAC,KAAK;gBACnB,SAAS;gBACT,IAAI,EAAE,OAAO;gBACb,MAAM;gBACN,GAAG,EAAE,QAAQ,CAAC,QAAQ;aACvB,CAAC,CAAC;YACH,OAAO,QAAQ,CAAC;QAClB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,cAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IAED;;;;OAIG;IACI,KAAK,CAAC,MAAM;QACjB,MAAM,GAAG,GAAG,WAAW,SAAG,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,gDAAgD,CAAC;QAEpH,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,CAAY,KAAK,EAAE,GAAG,CAAC,CAAC;QAC7D,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,cAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACI,MAAM,CAAC,SAAiB,EAAE,UAAoB;QACnD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,uEAAuE,SAAS,kBAAkB,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC5I,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAC7B,CAAC;IAEO,KAAK,CAAC,YAAY;QACxB,MAAM,KAAK,GAAG,IAAI,aAAK,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,QAAQ,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;QAC/E,MAAM,WAAW,GAAG,MAAM,KAAK,CAAC,cAAc,EAAE,CAAC;QACjD,OAAO,WAAW,CAAC,SAAS,CAAC;IAC/B,CAAC;IAED,8EAA8E;IAC9E,8CAA8C;IAC9C,uCAAuC;IACvC,mBAAmB;IACnB,6BAA6B;IACrB,KAAK,CAAC,eAAe;QAC3B,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YACvB,MAAM,OAAO,GAAG,IAAI,CAAC,aAAa,CAAC,cAAc,CAAC;YAClD,IAAI,OAAO,IAAI,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,IAAI,IAAI,EAAE,EAAE,CAAC;gBAC9C,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,qDAAqD,OAAO,EAAE,CAAC,CAAC;gBAClF,OAAO;YACT,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,mCAAmC,CAAC,CAAC;YACzD,CAAC;QACH,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;QACzC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,QAAQ,CAAC,WAAW,CAAC,yBAAyB,CAAC,CAAC;QACxD,CAAC;QACD,IAAI,CAAC,aAAa,GAAG,MAAM,IAAA,yBAAa,EAAC,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;QAClE,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;YACxB,MAAM,IAAA,2BAAe,EAAC,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;QACjD,CAAC;IACH,CAAC;CACF;AA1ND,oCA0NC"}

package/lib/agentPreviewBase.d.ts

@@ -1,59 +0,0 @@
-import { Connection, Logger } from '@salesforce/core';
-import { MaybeMock } from './maybe-mock';
-import { type AgentPreviewEndResponse, type AgentPreviewStartResponse, type AgentPreviewSendResponse, type EndReason, type BaseAgentConfig, type AgentInteractionBase, PlannerResponse } from './types.js';
-/**
- * Abstract base class for agent runners that provides common functionality
- * for interacting with agents through the Einstein AI Agent API.
- */
-export declare abstract class AgentPreviewBase implements AgentInteractionBase {
-    protected connection: Connection;
-    protected apexTraceFlag?: {
-        Id?: string;
-        ExpirationDate?: string;
-    };
-    protected readonly logger: Logger;
-    protected readonly maybeMock: MaybeMock;
-    protected apexDebugMode?: boolean;
-    protected constructor(config: BaseAgentConfig);
-    /**
-     * Get the base API URL for the agent service.
-     * This is overridden by child classes to provide their specific API base.
-     */
-    protected abstract get apiBase(): string;
-    /**
-     * Enable or disable Apex Debug Mode, which will enable trace flags for the Bot user
-     * and create apex debug logs for use within VS Code's Apex Replay Debugger.
-     *
-     * @param enable Whether to enable or disable Apex Debug Mode.
-     */
-    setApexDebugMode(enable: boolean): void;
-    /**
-     * Start an interactive session with the agent.
-     * This is implemented by child classes to provide their specific start logic.
-     */
-    abstract 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 `start()`.
-     * @param message A message to send to the agent.
-     * @returns `AgentPreviewSendResponse`
-     */
-    abstract send(sessionId: string, message: string): Promise<AgentPreviewSendResponse>;
-    /**
-     * Ends an interactive session with the agent.
-     *
-     * @param sessionId A session ID provided by first calling `start()`.
-     * @param reason A reason why the interactive session was ended.
-     * @returns `AgentPreviewEndResponse`
-     */
-    abstract end(sessionId: string, reason: EndReason): Promise<AgentPreviewEndResponse>;
-    /**
-     * 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 `PlannerResponse[]`
-     */
-    abstract traces(sessionId: string, messageIds: string[]): Promise<PlannerResponse[]>;
-}

package/lib/agentPreviewBase.js

@@ -1,55 +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.AgentPreviewBase = void 0;
-const core_1 = require("@salesforce/core");
-const maybe_mock_1 = require("./maybe-mock");
-/**
- * Abstract base class for agent runners that provides common functionality
- * for interacting with agents through the Einstein AI Agent API.
- */
-class AgentPreviewBase {
-    connection;
-    apexTraceFlag;
-    logger;
-    maybeMock;
-    apexDebugMode;
-    constructor(config) {
-        if (!config.connection) {
-            throw new Error('Connection is required');
-        }
-        // Protected properties
-        const connection = config.connection;
-        const logger = config.logger ?? core_1.Logger.childFromRoot(this.constructor.name);
-        // Initialize protected properties
-        this.connection = connection;
-        this.logger = logger;
-        this.maybeMock = new maybe_mock_1.MaybeMock(connection);
-    }
-    /**
-     * Enable or disable Apex Debug Mode, which will enable trace flags for the Bot user
-     * and create apex debug logs for use within VS Code's Apex Replay Debugger.
-     *
-     * @param enable Whether to enable or disable Apex Debug Mode.
-     */
-    setApexDebugMode(enable) {
-        this.apexDebugMode = enable;
-        this.logger.debug(`Apex Debug Mode is now ${enable ? 'enabled' : 'disabled'}`);
-    }
-}
-exports.AgentPreviewBase = AgentPreviewBase;
-//# sourceMappingURL=agentPreviewBase.js.map

package/lib/agentPreviewBase.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"agentPreviewBase.js","sourceRoot":"","sources":["../src/agentPreviewBase.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;GAcG;;;AAEH,2CAAsD;AACtD,6CAAyC;AAWzC;;;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;CAkCF;AAtED,4CAsEC"}

package/lib/agentPublisher.js.map

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

package/lib/agentSimulate.d.ts

@@ -1,79 +0,0 @@
-import { Connection } from '@salesforce/core';
-import { AgentPreviewBase } from './agentPreviewBase';
-import { type AgentPreviewEndResponse, type AgentPreviewSendResponse, type AgentPreviewStartResponse, PlannerResponse } from './types.js';
-/**
- * A service to simulate interactions with an agent using a local .agent file.
- * The file will be compiled using Agent.compileAgent before being used
- * with the simulation endpoints.
- *
- * **Examples**
- *
- * Create an instance of the service:
- *
- * `const agentSimulate = new AgentSimulate(connection, './path/to/agent.agent');`
- *
- * Start an interactive session:
- *
- * `const { sessionId } = await agentSimulate.start();`
- *
- * Send a message to the agent using the session ID from the startResponse:
- *
- * `const sendResponse = await agentSimulate.send(sessionId, message);`
- *
- * End an interactive session:
- *
- * `await agentSimulate.end(sessionId, 'UserRequest');`
- *
- * Enable Apex Debug Mode:
- *
- * `agentSimulate.toggleApexDebugMode(true);`
- */
-export declare class AgentSimulate extends AgentPreviewBase {
-    /**
-     * The client can specify whether the actions will run in a simulated mode ("mock actions", no side effects, mockActions=true) or a non-simulated mode ("real actions", actions with side effects, mockActions=false)
-     */
-    mockActions: boolean;
-    protected readonly apiBase: string;
-    private readonly agentFilePath;
-    private compiledAgent?;
-    /**
-     * Create an instance of the service.
-     *
-     * @param connection The connection to use to make requests.
-     * @param agentFilePath Path to the .agent file to simulate.
-     * @param mockActions whether or not to mock the actions of the simulated agent
-     */
-    constructor(connection: Connection, agentFilePath: string, mockActions: boolean);
-    /**
-     * Start an interactive simulation session with the agent.
-     * This will first compile the agent script if it hasn't been compiled yet.
-     *
-     * @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 `agentSimulate.start()`.
-     * @param message A message to send to the agent.
-     * @returns `AgentPreviewSendResponse`
-     */
-    send(sessionId: string, message: string): Promise<AgentPreviewSendResponse>;
-    /**
-     * Ending is not required, or supported, for AgentSimulation
-     * this is a noop method to support easier consumer typings
-     *
-     * @returns `AgentPreviewEndResponse`
-     */
-    end(): Promise<AgentPreviewEndResponse>;
-    /**
-     * Enable or disable Apex Debug Mode, which will enable trace flags for the Bot user
-     * and create apex debug logs for use within VS Code's Apex Replay Debugger.
-     *
-     * @param enable Whether to enable or disable Apex Debug Mode.
-     */
-    toggleApexDebugMode(enable: boolean): void;
-    trace(sessionId: string, messageId: string): Promise<PlannerResponse | null>;
-    traces(sessionId: string, messageIds: string[]): Promise<PlannerResponse[]>;
-    private ensureTraceFlag;
-}

package/lib/agentSimulate.js

@@ -1,297 +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.AgentSimulate = void 0;
-const promises_1 = require("node:fs/promises");
-const node_path_1 = require("node:path");
-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 apexUtils_1 = require("./apexUtils");
-const utils_1 = require("./utils");
-/**
- * A service to simulate interactions with an agent using a local .agent file.
- * The file will be compiled using Agent.compileAgent before being used
- * with the simulation endpoints.
- *
- * **Examples**
- *
- * Create an instance of the service:
- *
- * `const agentSimulate = new AgentSimulate(connection, './path/to/agent.agent');`
- *
- * Start an interactive session:
- *
- * `const { sessionId } = await agentSimulate.start();`
- *
- * Send a message to the agent using the session ID from the startResponse:
- *
- * `const sendResponse = await agentSimulate.send(sessionId, message);`
- *
- * End an interactive session:
- *
- * `await agentSimulate.end(sessionId, 'UserRequest');`
- *
- * Enable Apex Debug Mode:
- *
- * `agentSimulate.toggleApexDebugMode(true);`
- */
-class AgentSimulate extends agentPreviewBase_1.AgentPreviewBase {
-    /**
-     * The client can specify whether the actions will run in a simulated mode ("mock actions", no side effects, mockActions=true) or a non-simulated mode ("real actions", actions with side effects, mockActions=false)
-     */
-    mockActions;
-    apiBase = `https://${kit_1.env.getBoolean('SF_TEST_API') ? 'test.' : ''}api.salesforce.com/einstein/ai-agent`;
-    agentFilePath;
-    compiledAgent;
-    /**
-     * Create an instance of the service.
-     *
-     * @param connection The connection to use to make requests.
-     * @param agentFilePath Path to the .agent file to simulate.
-     * @param mockActions whether or not to mock the actions of the simulated agent
-     */
-    constructor(connection, agentFilePath, mockActions) {
-        super({ connection });
-        this.agentFilePath = agentFilePath;
-        this.mockActions = mockActions;
-    }
-    /**
-     * Start an interactive simulation session with the agent.
-     * This will first compile the agent script if it hasn't been compiled yet.
-     *
-     * @returns `AgentPreviewStartResponse`, which includes a session ID needed for other actions.
-     */
-    async start() {
-        if (!this.compiledAgent) {
-            void core_1.Lifecycle.getInstance().emit('agents:compiling', {});
-            this.logger.debug(`Compiling agent script from ${this.agentFilePath}`);
-            const agentString = await (0, promises_1.readFile)(this.agentFilePath, 'utf-8');
-            const compiledAgent = await agent_1.Agent.compileAgentScript(this.connection, agentString);
-            if (compiledAgent.status === 'success' && compiledAgent.compiledArtifact) {
-                this.compiledAgent = compiledAgent.compiledArtifact;
-                // we must set the compiledAgent.agentVersion.developerName, we'll get this from the -meta <target> field
-                const metaContent = await (0, promises_1.readFile)(`${this.agentFilePath.replace('.agent', '.bundle-meta.xml')}`, 'utf-8');
-                this.compiledAgent.agentVersion.developerName = metaContent.match(/<target>.*(v\d+)<\/target>/)?.at(1) ?? 'v0';
-            }
-            else {
-                const formattedError = compiledAgent.errors
-                    .map((e) => `- ${e.errorType} ${e.description}: ${e.lineStart}:${e.colStart} / ${e.lineEnd}:${e.colEnd}`)
-                    .join('\n');
-                throw new core_1.SfError('Failed to compile agent script', formattedError);
-            }
-        }
-        this.logger.debug('Starting agent simulation session');
-        // send bypassUser=false when the compiledAgent.globalConfiguration.defaultAgentUser is INVALID
-        let bypassUser = (await this.connection.query(`SELECT Id FROM USER WHERE username='${this.compiledAgent.globalConfiguration.defaultAgentUser}'`)).totalSize === 1;
-        if (bypassUser && this.compiledAgent.globalConfiguration.agentType === 'AgentforceEmployeeAgent') {
-            // another situation which bypassUser = false, is when previewing an agent script, with a valid default_agent_user, and it's an AgentforceEmployeeAgent type
-            bypassUser = false;
-        }
-        const body = {
-            agentDefinition: this.compiledAgent,
-            enableSimulationMode: this.mockActions,
-            externalSessionKey: (0, node_crypto_1.randomUUID)(),
-            instanceConfig: {
-                endpoint: this.connection.instanceUrl,
-            },
-            variables: [],
-            parameters: {},
-            streamingCapabilities: {
-                chunkTypes: ['Text', 'LightningChunk'],
-            },
-            richContentCapabilities: {},
-            bypassUser,
-            executionHistory: [],
-            conversationContext: [],
-        };
-        try {
-            void core_1.Lifecycle.getInstance().emit('agents:simulation-starting', {});
-            this.connection = await (0, utils_1.useNamedUserJwt)(this.connection);
-            const response = await this.connection.request({
-                method: 'POST',
-                url: `${this.apiBase}/v1.1/preview/sessions`,
-                headers: {
-                    'x-attributed-client': 'no-builder', // <- removes markdown from responses
-                    'x-client-name': 'afdx',
-                },
-                body: JSON.stringify(body),
-            }, { retry: { maxRetries: 3 } });
-            const agentIdForStorage = (0, node_path_1.basename)(this.agentFilePath);
-            await (0, utils_1.appendTranscriptEntry)({
-                timestamp: new Date().toISOString(),
-                agentId: agentIdForStorage,
-                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);
-        }
-        finally {
-            // Always restore the original connection, even if an error occurred
-            delete this.connection.accessToken;
-            await this.connection.refreshAuth();
-        }
-    }
-    /**
-     * Send a message to the agent using the session ID obtained by calling `start()`.
-     *
-     * @param sessionId A session ID provided by first calling `agentSimulate.start()`.
-     * @param message A message to send to the agent.
-     * @returns `AgentPreviewSendResponse`
-     */
-    async send(sessionId, message) {
-        if (!this.compiledAgent) {
-            throw new core_1.SfError('Agent not compiled, please call .start() first');
-        }
-        const url = `${this.apiBase}/v1.1/preview/sessions/${sessionId}/messages`;
-        const body = {
-            message: {
-                sequenceId: Date.now(),
-                type: 'Text',
-                text: message,
-            },
-            variables: [],
-        };
-        this.logger.debug(`Sending message with apexDebugMode ${this.apexDebugMode ? 'enabled' : 'disabled'}`);
-        const agentIdForStorage = (0, node_path_1.basename)(this.agentFilePath);
-        try {
-            const start = Date.now();
-            if (this.apexDebugMode && !this.mockActions) {
-                await this.ensureTraceFlag();
-            }
-            await (0, utils_1.appendTranscriptEntry)({
-                timestamp: new Date().toISOString(),
-                agentId: agentIdForStorage,
-                sessionId,
-                role: 'user',
-                text: message,
-            });
-            this.connection = await (0, utils_1.useNamedUserJwt)(this.connection);
-            const response = await this.connection.request({
-                method: 'POST',
-                url,
-                body: JSON.stringify(body),
-                headers: {
-                    'x-client-name': 'afdx',
-                },
-            });
-            await (0, utils_1.appendTranscriptEntry)({
-                timestamp: new Date().toISOString(),
-                agentId: agentIdForStorage,
-                sessionId,
-                role: 'agent',
-                text: response.messages.map((m) => m.message).join('\n'),
-                raw: response.messages,
-            });
-            if (this.apexDebugMode && !this.mockActions) {
-                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);
-        }
-        finally {
-            // Always restore the original connection, even if an error occurred
-            delete this.connection.accessToken;
-            await this.connection.refreshAuth();
-        }
-    }
-    /**
-     * Ending is not required, or supported, for AgentSimulation
-     * this is a noop method to support easier consumer typings
-     *
-     * @returns `AgentPreviewEndResponse`
-     */
-    // eslint-disable-next-line class-methods-use-this
-    async end() {
-        return Promise.resolve({ messages: [], _links: [] });
-    }
-    /**
-     * Enable or disable Apex Debug Mode, which will enable trace flags for the Bot user
-     * and create apex debug logs for use within VS Code's Apex Replay Debugger.
-     *
-     * @param enable Whether to enable or disable Apex Debug Mode.
-     */
-    toggleApexDebugMode(enable) {
-        this.setApexDebugMode(enable);
-    }
-    async trace(sessionId, messageId) {
-        const traces = await this.traces(sessionId, [messageId]);
-        return traces.length ? traces[0] : null;
-    }
-    async traces(sessionId, messageIds) {
-        try {
-            this.connection = await (0, utils_1.useNamedUserJwt)(this.connection);
-            const traces = [];
-            const tracePromises = messageIds.map((messageId) => this.connection.request({
-                method: 'GET',
-                url: `${this.apiBase}/v1.1/preview/sessions/${sessionId}/plans/${messageId}`,
-                headers: {
-                    'x-client-name': 'afdx',
-                },
-            }));
-            const traceResults = await Promise.all(tracePromises);
-            traces.push(...traceResults);
-            return traces;
-        }
-        catch (err) {
-            throw core_1.SfError.wrap(err);
-        }
-        finally {
-            // Always restore the original connection, even if an error occurred
-            delete this.connection.accessToken;
-            await this.connection.refreshAuth();
-        }
-    }
-    // once we're previewing agents in the org, with mockActions = false, we'll have to figure out how to get the correct user that was simulated for apex invocattion
-    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 user = this.compiledAgent?.globalConfiguration.defaultAgentUser ?? this.connection.getUsername();
-        const userId = (await this.connection.singleRecordQuery(`SELECT Id FROM User WHERE Username = '${user}'`)).Id;
-        this.apexTraceFlag = await (0, apexUtils_1.findTraceFlag)(this.connection, userId);
-        if (!this.apexTraceFlag) {
-            await (0, apexUtils_1.createTraceFlag)(this.connection, userId);
-        }
-    }
-}
-exports.AgentSimulate = AgentSimulate;
-//# sourceMappingURL=agentSimulate.js.map

package/lib/agentSimulate.js.map

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

package/lib/agentTrace.d.ts

@@ -1,23 +0,0 @@
-import { Connection } from '@salesforce/core';
-import { type AgentTraceResponse } from './types';
-/**
- * A service for retrieving agent execution traces. Provides detailed information
- * about agent plan execution including steps, timing, and safety scores.
- *
- * **Examples**
- *
- * Get trace data for a specific trace ID:
- *
- * `const traceData = await AgentTrace.getTrace(connection, '12-23-34');`
- */
-export declare class AgentTrace {
-    /**
-     * Get the trace data for a given trace ID.
-     *
-     * @param connection The connection to use for making the API request
-     * @param traceId The trace ID to retrieve trace data for
-     * @returns Promise that resolves with the trace data response containing actions and their execution details
-     * @beta
-     */
-    static getTrace(connection: Connection, traceId: string): Promise<AgentTraceResponse>;
-}

package/lib/agentTrace.js

@@ -1,47 +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.AgentTrace = void 0;
-const maybe_mock_1 = require("./maybe-mock");
-/**
- * A service for retrieving agent execution traces. Provides detailed information
- * about agent plan execution including steps, timing, and safety scores.
- *
- * **Examples**
- *
- * Get trace data for a specific trace ID:
- *
- * `const traceData = await AgentTrace.getTrace(connection, '12-23-34');`
- */
-class AgentTrace {
-    /**
-     * Get the trace data for a given trace ID.
-     *
-     * @param connection The connection to use for making the API request
-     * @param traceId The trace ID to retrieve trace data for
-     * @returns Promise that resolves with the trace data response containing actions and their execution details
-     * @beta
-     */
-    static async getTrace(connection, traceId) {
-        const maybeMock = new maybe_mock_1.MaybeMock(connection);
-        // TODO: who knows what the real endpoint will be, or if the return type is 100% accurate
-        const url = `/api/trace/${traceId}`;
-        return maybeMock.request('GET', url);
-    }
-}
-exports.AgentTrace = AgentTrace;
-//# sourceMappingURL=agentTrace.js.map

package/lib/agentTrace.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"agentTrace.js","sourceRoot":"","sources":["../src/agentTrace.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;GAcG;;;AAGH,6CAAyC;AAGzC;;;;;;;;;GASG;AACH,MAAa,UAAU;IACrB;;;;;;;OAOG;IACI,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,UAAsB,EAAE,OAAe;QAClE,MAAM,SAAS,GAAG,IAAI,sBAAS,CAAC,UAAU,CAAC,CAAC;QAC5C,yFAAyF;QACzF,MAAM,GAAG,GAAG,cAAc,OAAO,EAAE,CAAC;QAEpC,OAAO,SAAS,CAAC,OAAO,CAAqB,KAAK,EAAE,GAAG,CAAC,CAAC;IAC3D,CAAC;CACF;AAhBD,gCAgBC"}