import { Connection } from '@salesforce/core';
import { type AgentPreviewEndResponse, type AgentPreviewStartResponse, type AgentPreviewSendResponse, type ApiStatus, type EndReason } 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 {
    private readonly apiBase;
    private connection;
    private logger;
    private maybeMock;
    private apexDebugMode?;
    private apexTraceFlag?;
    private 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>;
    /**
     * 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;
    private getBotUserId;
    private ensureTraceFlag;
}