wuying-agentbay-sdk 0.6.1 → 0.7.0

package/dist/index.d.mts

@@ -1739,6 +1739,19 @@ interface Config {
     endpoint: string;
     timeout_ms: number;
 }
+/**
+ * Load .env file into process.env if it exists
+ * This function should be called early to ensure .env variables are available
+ */
+declare function loadDotEnv(): void;
+/**
+ * The SDK uses the following precedence order for configuration (highest to lowest):
+ * 1. Explicitly passed configuration in code.
+ * 2. Environment variables.
+ * 3. .env file.
+ * 4. Default configuration.
+ */
+declare function loadConfig(customConfig?: Config): Config;
 
 /**
  * Base interface for API responses
@@ -2246,6 +2259,25 @@ interface DownloadPolicy {
 interface DeletePolicy {
     syncLocalFile: boolean;
 }
+interface ExtractPolicy {
+    extract: boolean;
+    deleteSrcFile: boolean;
+    extractToCurrentFolder: boolean;
+}
+declare class ExtractPolicyClass implements ExtractPolicy {
+    extract: boolean;
+    deleteSrcFile: boolean;
+    extractToCurrentFolder: boolean;
+    constructor(extract?: boolean, deleteSrcFile?: boolean, extractToCurrentFolder?: boolean);
+    /**
+     * Creates a new extract policy with default values
+     */
+    static default(): ExtractPolicyClass;
+    /**
+     * Converts to plain object for JSON serialization
+     */
+    toDict(): Record<string, any>;
+}
 interface WhiteList {
     path: string;
     excludePaths?: string[];
@@ -2257,12 +2289,14 @@ interface SyncPolicy {
     uploadPolicy?: UploadPolicy;
     downloadPolicy?: DownloadPolicy;
     deletePolicy?: DeletePolicy;
+    extractPolicy?: ExtractPolicy;
     bwList?: BWList;
 }
 declare class SyncPolicyImpl implements SyncPolicy {
     uploadPolicy?: UploadPolicy;
     downloadPolicy?: DownloadPolicy;
     deletePolicy?: DeletePolicy;
+    extractPolicy?: ExtractPolicy;
     bwList?: BWList;
     constructor(policy?: Partial<SyncPolicy>);
     private ensureDefaults;
@@ -2278,6 +2312,7 @@ declare class ContextSync {
 declare function newUploadPolicy(): UploadPolicy;
 declare function newDownloadPolicy(): DownloadPolicy;
 declare function newDeletePolicy(): DeletePolicy;
+declare function newExtractPolicy(): ExtractPolicy;
 declare function newSyncPolicy(): SyncPolicy;
 declare function newSyncPolicyWithDefaults(policy?: Partial<SyncPolicy>): SyncPolicy;
 declare function newContextSync(contextId: string, path: string, policy?: SyncPolicy): ContextSync;
@@ -2644,15 +2679,14 @@ declare class FileSystem {
      */
     moveFile(source: string, destination: string): Promise<BoolResult>;
     /**
-     * Reads the content of a file.
-     * Corresponds to Python's read_file() method
+     * Internal method to read a file chunk. Used for chunked file operations.
      *
      * @param path - Path to the file to read.
      * @param offset - Optional: Byte offset to start reading from (0-based).
      * @param length - Optional: Number of bytes to read. If 0, reads the entire file from offset.
      * @returns FileContentResult with file content and requestId
      */
-    readFile(path: string, offset?: number, length?: number): Promise<FileContentResult>;
+    private readFileChunk;
     /**
      * Reads the content of multiple files.
      * Corresponds to Python's read_multiple_files() method
@@ -2672,34 +2706,30 @@ declare class FileSystem {
      */
     searchFiles(path: string, pattern: string, excludePatterns?: string[]): Promise<FileSearchResult>;
     /**
-     * Writes content to a file.
-     * Corresponds to Python's write_file() method
+     * Internal method to write a file chunk. Used for chunked file operations.
      *
      * @param path - Path to the file to write.
      * @param content - Content to write to the file.
      * @param mode - Optional: Write mode. One of "overwrite", "append", or "create_new". Default is "overwrite".
      * @returns BoolResult with write result and requestId
      */
-    writeFile(path: string, content: string, mode?: string): Promise<BoolResult>;
+    private writeFileChunk;
     /**
-     * Reads a large file in chunks to handle size limitations of the underlying API.
-     * Corresponds to Python's read_large_file() method
+     * Reads the contents of a file. Automatically handles large files by chunking.
      *
      * @param path - Path to the file to read.
-     * @param chunkSize - Optional: Size of each chunk in bytes. Default is 60KB.
      * @returns FileContentResult with complete file content and requestId
      */
-    readLargeFile(path: string, chunkSize?: number): Promise<FileContentResult>;
+    readFile(path: string): Promise<FileContentResult>;
     /**
-     * Writes a large file in chunks to handle size limitations of the underlying API.
-     * Corresponds to Python's write_large_file() method
+     * Writes content to a file. Automatically handles large files by chunking.
      *
      * @param path - Path to the file to write.
      * @param content - Content to write to the file.
-     * @param chunkSize - Optional: Size of each chunk in bytes. Default is 60KB.
+     * @param mode - Optional: Write mode. One of "overwrite", "append", or "create_new". Default is "overwrite".
      * @returns BoolResult indicating success or failure with requestId
      */
-    writeLargeFile(path: string, content: string, chunkSize?: number): Promise<BoolResult>;
+    writeFile(path: string, content: string, mode?: string): Promise<BoolResult>;
 }
 
 /**
@@ -3123,6 +3153,8 @@ interface BrowserOption {
     screen?: BrowserScreen;
     fingerprint?: BrowserFingerprint;
     proxies?: BrowserProxy[];
+    /** Path to the extensions directory. Defaults to "/tmp/extensions/" */
+    extensionPath?: string;
 }
 declare class BrowserOptionClass implements BrowserOption {
     persistentPath?: string;
@@ -3132,6 +3164,7 @@ declare class BrowserOptionClass implements BrowserOption {
     screen?: BrowserScreen;
     fingerprint?: BrowserFingerprint;
     proxies?: BrowserProxy[];
+    extensionPath?: string;
     constructor(useStealth?: boolean, userAgent?: string, viewport?: BrowserViewport, screen?: BrowserScreen, fingerprint?: BrowserFingerprint, proxies?: BrowserProxy[]);
     toMap(): Record<string, any>;
     fromMap(m: Record<string, any> | null | undefined): BrowserOptionClass;
@@ -3194,7 +3227,6 @@ interface McpToolsResult extends OperationResult {
 declare class Session {
     private agentBay;
     sessionId: string;
-    resourceUrl: string;
     isVpc: boolean;
     networkInterfaceIp: string;
     httpPort: string;
@@ -3316,13 +3348,330 @@ declare class Session {
 }
 
 /**
- * Browser context configuration for session.
+ * Represents a browser extension as a cloud resource.
  */
-interface BrowserContext {
+declare class Extension {
+    /**
+     * The unique identifier of the extension.
+     */
+    id: string;
+    /**
+     * The name of the extension.
+     */
+    name: string;
+    /**
+     * Date and time when the extension was created.
+     */
+    createdAt?: string;
+    /**
+     * Initialize an Extension object.
+     *
+     * @param id - The unique identifier of the extension.
+     * @param name - The name of the extension.
+     * @param createdAt - Date and time when the extension was created.
+     */
+    constructor(id: string, name: string, createdAt?: string);
+}
+/**
+ * Configuration options for browser extension integration.
+ *
+ * This class encapsulates the necessary parameters for setting up
+ * browser extension synchronization and context management.
+ */
+declare class ExtensionOption {
+    /**
+     * ID of the extension context for browser extensions.
+     */
+    contextId: string;
+    /**
+     * List of extension IDs to be loaded/synchronized.
+     */
+    extensionIds: string[];
+    /**
+     * Initialize ExtensionOption with context and extension configuration.
+     *
+     * @param contextId - ID of the extension context for browser extensions.
+     *                   This should match the context where extensions are stored.
+     * @param extensionIds - List of extension IDs to be loaded in the browser session.
+     *                      Each ID should correspond to a valid extension in the context.
+     *
+     * @throws {Error} If contextId is empty or extensionIds is empty.
+     */
+    constructor(contextId: string, extensionIds: string[]);
+    /**
+     * String representation of ExtensionOption.
+     */
+    toString(): string;
+    /**
+     * Human-readable string representation.
+     */
+    toDisplayString(): string;
+    /**
+     * Validate the extension option configuration.
+     *
+     * @returns True if configuration is valid, false otherwise.
+     */
+    validate(): boolean;
+}
+/**
+ * Provides methods to manage user browser extensions.
+ * This service integrates with the existing context functionality for file operations.
+ *
+ * **Usage** (Simplified - Auto-detection):
+ * ```typescript
+ * // Service automatically detects if context exists and creates if needed
+ * const extensionsService = new ExtensionsService(agentBay, "browser_extensions");
+ *
+ * // Or use with empty contextId to auto-generate context name
+ * const extensionsService = new ExtensionsService(agentBay);  // Uses default generated name
+ *
+ * // Use the service immediately - initialization happens automatically
+ * const extension = await extensionsService.create("/path/to/plugin.zip");
+ * ```
+ *
+ * **Integration with ExtensionOption (Simplified)**:
+ * ```typescript
+ * // Create extensions and configure for browser sessions
+ * const extensionsService = new ExtensionsService(agentBay, "my_extensions");
+ * const ext1 = await extensionsService.create("/path/to/ext1.zip");
+ * const ext2 = await extensionsService.create("/path/to/ext2.zip");
+ *
+ * // Create extension option for browser integration (no contextId needed!)
+ * const extOption = extensionsService.createExtensionOption([ext1.id, ext2.id]);
+ *
+ * // Use with BrowserContext for session creation
+ * const browserContext = new BrowserContext({
+ *   contextId: "browser_session",
+ *   autoUpload: true,
+ *   extensionOption: extOption  // All extension config encapsulated
+ * });
+ * ```
+ *
+ * **Context Management**:
+ * - If contextId provided and exists: Uses the existing context
+ * - If contextId provided but doesn't exist: Creates context with provided name
+ * - If contextId empty or not provided: Generates default name and creates context
+ * - No need to manually manage context creation or call initialize()
+ * - Context initialization happens automatically on first method call
+ */
+declare class ExtensionsService {
+    private agentBay;
+    private contextService;
+    private extensionContext;
+    private contextId;
+    private contextName;
+    private autoCreated;
+    private _initializationPromise;
+    /**
+     * Initializes the ExtensionsService with a context.
+     *
+     * @param agentBay - The AgentBay client instance.
+     * @param contextId - The context ID or name. If empty or not provided,
+     *                   a default context name will be generated automatically.
+     *                   If the context doesn't exist, it will be automatically created.
+     *
+     * Note:
+     *   The service automatically detects if the context exists. If not,
+     *   it creates a new context with the provided name or a generated default name.
+     *   Context initialization is handled lazily on first use.
+     */
+    constructor(agentBay: AgentBay, contextId?: string);
+    /**
+     * Internal method to initialize the context.
+     * This ensures the context is ready before any operations.
+     */
+    private _initializeContext;
+    /**
+     * Ensures the service is initialized before performing operations.
+     */
+    private _ensureInitialized;
+    /**
+     * An internal helper method that encapsulates the flow of "get upload URL for a specific path and upload".
+     * Uses the existing context service for file operations.
+     *
+     * @param localPath - The path to the local file.
+     * @param remotePath - The path of the file in context storage.
+     *
+     * @throws {AgentBayError} If getting the credential or uploading fails.
+     */
+    private _uploadToCloud;
+    /**
+     * Lists all available browser extensions within this context from the cloud.
+     * Uses the context service to list files under the extensions directory.
+     *
+     * @returns Promise that resolves to an array of Extension objects.
+     * @throws {AgentBayError} If listing extensions fails.
+     */
+    list(): Promise<Extension[]>;
+    /**
+     * Uploads a new browser extension from a local path into the current context.
+     *
+     * @param localPath - Path to the local extension file (must be a .zip file).
+     * @returns Promise that resolves to an Extension object.
+     * @throws {Error} If the local file doesn't exist.
+     * @throws {Error} If the file format is not supported (only .zip is supported).
+     * @throws {AgentBayError} If upload fails.
+     */
+    create(localPath: string): Promise<Extension>;
+    /**
+     * Updates an existing browser extension in the current context with a new file.
+     *
+     * @param extensionId - ID of the extension to update.
+     * @param newLocalPath - Path to the new local extension file.
+     * @returns Promise that resolves to an Extension object.
+     * @throws {Error} If the new local file doesn't exist.
+     * @throws {Error} If the extension doesn't exist in the context.
+     * @throws {AgentBayError} If update fails.
+     */
+    update(extensionId: string, newLocalPath: string): Promise<Extension>;
+    /**
+     * Gets detailed information about a specific browser extension.
+     *
+     * @param extensionId - The ID of the extension to get info for.
+     * @returns Promise that resolves to an Extension object if found, undefined otherwise.
+     */
+    private _getExtensionInfo;
+    /**
+     * Cleans up the auto-created context if it was created by this service.
+     *
+     * @returns Promise that resolves to true if cleanup was successful or not needed, false if cleanup failed.
+     *
+     * Note:
+     *   This method only works if the context was auto-created by this service.
+     *   For existing contexts, no cleanup is performed.
+     */
+    cleanup(): Promise<boolean>;
+    /**
+     * Deletes a browser extension from the current context.
+     *
+     * @param extensionId - ID of the extension to delete.
+     * @returns Promise that resolves to true if deletion was successful, false otherwise.
+     */
+    delete(extensionId: string): Promise<boolean>;
+    /**
+     * Create an ExtensionOption for the current context with specified extension IDs.
+     *
+     * This is a convenience method that creates an ExtensionOption using the current
+     * service's contextId and the provided extension IDs. This option can then be
+     * used with BrowserContext for browser session creation.
+     *
+     * @param extensionIds - List of extension IDs to include in the option.
+     *                      These should be extensions that exist in the current context.
+     * @returns ExtensionOption configuration object for browser extension integration.
+     * @throws {Error} If extensionIds is empty or invalid.
+     *
+     * @example
+     * ```typescript
+     * // Create extensions
+     * const ext1 = await extensionsService.create("/path/to/ext1.zip");
+     * const ext2 = await extensionsService.create("/path/to/ext2.zip");
+     *
+     * // Create extension option for browser integration
+     * const extOption = extensionsService.createExtensionOption([ext1.id, ext2.id]);
+     *
+     * // Use with BrowserContext
+     * const browserContext = new BrowserContext({
+     *   contextId: "browser_session",
+     *   autoUpload: true,
+     *   extensionContextId: extOption.contextId,
+     *   extensionIds: extOption.extensionIds
+     * });
+     * ```
+     */
+    createExtensionOption(extensionIds: string[]): ExtensionOption;
+}
+
+/**
+ * Browser context configuration for session with optional extension support.
+ *
+ * This class provides browser context configuration for cloud sessions and supports
+ * automatic extension synchronization when ExtensionOption is provided.
+ *
+ * Key Features:
+ * - Browser context binding for sessions
+ * - Automatic browser data upload on session end
+ * - Optional extension integration with automatic context sync generation
+ * - Clean API with ExtensionOption encapsulation
+ *
+ * Extension Configuration:
+ * - **ExtensionOption**: Pass an ExtensionOption object with contextId and extensionIds
+ * - **No Extensions**: Don't provide extensionOption parameter (extensionContextSyncs will be undefined)
+ *
+ * Usage Examples:
+ * ```typescript
+ * // With extensions using ExtensionOption
+ * import { ExtensionOption } from "./extension";
+ *
+ * const extOption = new ExtensionOption(
+ *   "my_extensions",
+ *   ["ext1", "ext2"]
+ * );
+ *
+ * const browserContext = new BrowserContext(
+ *   "browser_session",
+ *   true,
+ *   extOption
+ * );
+ *
+ * // Without extensions (minimal configuration)
+ * const browserContext = new BrowserContext(
+ *   "browser_session",
+ *   true
+ * );
+ * // extensionContextSyncs will be undefined
+ * ```
+ */
+declare class BrowserContext {
     /** ID of the browser context to bind to the session */
     contextId: string;
     /** Whether to automatically upload browser data when the session ends */
     autoUpload: boolean;
+    /** Optional extension configuration object containing context_id and extension_ids */
+    extensionOption?: ExtensionOption;
+    /** ID of the extension context for browser extensions. Set automatically from extension_option. */
+    extensionContextId?: string;
+    /** List of extension IDs to synchronize. Set automatically from extension_option. */
+    extensionIds?: string[];
+    /** Auto-generated context syncs for extensions. None if no extension configuration provided. */
+    extensionContextSyncs?: ContextSync[];
+    /**
+     * Initialize BrowserContextImpl with optional extension support.
+     *
+     * @param contextId - ID of the browser context to bind to the session.
+     *                   This identifies the browser instance for the session.
+     * @param autoUpload - Whether to automatically upload browser data
+     *                    when the session ends. Defaults to true.
+     * @param extensionOption - Extension configuration object containing
+     *                         contextId and extensionIds. This encapsulates
+     *                         all extension-related configuration.
+     *                         Defaults to undefined.
+     *
+     * Extension Configuration:
+     * - **ExtensionOption**: Use extensionOption parameter with an ExtensionOption object
+     * - **No Extensions**: Don't provide extensionOption parameter
+     *
+     * Auto-generation:
+     * - extensionContextSyncs is automatically generated when extensionOption is provided
+     * - extensionContextSyncs will be undefined if no extensionOption is provided
+     * - extensionContextSyncs will be a ContextSync[] if extensionOption is valid
+     */
+    constructor(contextId: string, autoUpload?: boolean, extensionOption?: ExtensionOption);
+    /**
+     * Create ContextSync configurations for browser extensions.
+     *
+     * This method is called only when extensionOption is provided and contains
+     * valid extension configuration (contextId and extensionIds).
+     *
+     * @returns ContextSync[] - List of context sync configurations for extensions.
+     *                         Returns empty list if extension configuration is invalid.
+     */
+    private _createExtensionContextSyncs;
+    /**
+     * Get all context syncs including extension syncs.
+     *
+     * @returns ContextSync[] - All context sync configurations. Returns empty list if no extensions configured.
+     */
+    getAllContextSyncs(): ContextSync[];
 }
 /**
  * Configuration interface for CreateSessionParams
@@ -3593,4 +3942,4 @@ declare function log(message: string, ...args: any[]): void;
  */
 declare function logError(message: string, error?: any): void;
 
-export { APIError, type ActOptions, ActResult, Agent, AgentBay, AgentBayError, Application, ApplicationError, ApplyMqttTokenRequest, ApplyMqttTokenResponse, ApplyMqttTokenResponseBody, ApplyMqttTokenResponseBodyData, AuthenticationError, type BWList, Browser, BrowserAgent, type BrowserContext, BrowserError, type BrowserFingerprint, type BrowserOption, BrowserOptionClass, type BrowserProxy, BrowserProxyClass, type BrowserScreen, type BrowserViewport, CallMcpToolRequest, CallMcpToolResponse, CallMcpToolResponseBody, Client, Command, CommandError, Context, type ContextInfoResult, ContextManager, ContextService, type ContextStatusData, type ContextStatusItem, ContextSync, type ContextSyncResult, CreateMcpSessionRequest, CreateMcpSessionRequestPersistenceDataList, CreateMcpSessionResponse, CreateMcpSessionResponseBody, CreateMcpSessionResponseBodyData, CreateMcpSessionShrinkRequest, type CreateSessionParams, type CreateSessionParamsConfig, DeleteContextFileRequest, DeleteContextFileResponse, DeleteContextFileResponseBody, DeleteContextRequest, DeleteContextResponse, DeleteContextResponseBody, type DeletePolicy, DescribeContextFilesRequest, DescribeContextFilesResponse, DescribeContextFilesResponseBody, type DirectoryEntry, type DownloadPolicy, DownloadStrategy, type ExecutionResult, type ExtractOptions, FileError, type FileInfo, FileSystem, GetContextFileDownloadUrlRequest, GetContextFileDownloadUrlResponse, GetContextFileDownloadUrlResponseBody, GetContextFileUploadUrlRequest, GetContextFileUploadUrlResponse, GetContextFileUploadUrlResponseBody, GetContextInfoRequest, GetContextInfoResponse, GetContextInfoResponseBody, GetContextInfoResponseBodyData, GetContextRequest, GetContextResponse, GetContextResponseBody, GetContextResponseBodyData, GetLabelRequest, GetLabelResponse, GetLabelResponseBody, GetLabelResponseBodyData, GetLinkRequest, GetLinkResponse, GetLinkResponseBody, GetLinkResponseBodyData, GetMcpResourceRequest, GetMcpResourceResponse, GetMcpResourceResponseBody, GetMcpResourceResponseBodyData, GetMcpResourceResponseBodyDataDesktopInfo, InitBrowserRequest, InitBrowserResponse, InitBrowserResponseBody, InitBrowserResponseBodyData, type InstalledApp, KeyCode, ListContextsRequest, ListContextsResponse, ListContextsResponseBody, ListContextsResponseBodyData, ListMcpToolsRequest, ListMcpToolsResponse, ListMcpToolsResponseBody, type ListSessionParams, ListSessionRequest, ListSessionResponse, ListSessionResponseBody, ListSessionResponseBodyData, type McpSession, type McpToolResult, ModifyContextRequest, ModifyContextResponse, ModifyContextResponseBody, type ObserveOptions, ObserveResult, Oss, OssError, type Process, type QueryResult, ReleaseMcpSessionRequest, ReleaseMcpSessionResponse, ReleaseMcpSessionResponseBody, Session, SessionError, type SessionInterface, SetLabelRequest, SetLabelResponse, SetLabelResponseBody, SyncContextRequest, SyncContextResponse, SyncContextResponseBody, type SyncPolicy, SyncPolicyImpl, UI, type UIElement, UIError, type UploadPolicy, UploadStrategy, type WhiteList, log, logError, newContextManager, newContextSync, newCreateSessionParams, newDeletePolicy, newDownloadPolicy, newSyncPolicy, newSyncPolicyWithDefaults, newUploadPolicy };
+export { APIError, type ActOptions, ActResult, Agent, AgentBay, AgentBayError, Application, ApplicationError, ApplyMqttTokenRequest, ApplyMqttTokenResponse, ApplyMqttTokenResponseBody, ApplyMqttTokenResponseBodyData, AuthenticationError, type BWList, Browser, BrowserAgent, BrowserContext, BrowserError, type BrowserFingerprint, type BrowserOption, BrowserOptionClass, type BrowserProxy, BrowserProxyClass, type BrowserScreen, type BrowserViewport, CallMcpToolRequest, CallMcpToolResponse, CallMcpToolResponseBody, Client, Command, CommandError, type Config, Context, type ContextInfoResult, ContextManager, ContextService, type ContextStatusData, type ContextStatusItem, ContextSync, type ContextSyncResult, CreateMcpSessionRequest, CreateMcpSessionRequestPersistenceDataList, CreateMcpSessionResponse, CreateMcpSessionResponseBody, CreateMcpSessionResponseBodyData, CreateMcpSessionShrinkRequest, type CreateSessionParams, type CreateSessionParamsConfig, DeleteContextFileRequest, DeleteContextFileResponse, DeleteContextFileResponseBody, DeleteContextRequest, DeleteContextResponse, DeleteContextResponseBody, type DeletePolicy, DescribeContextFilesRequest, DescribeContextFilesResponse, DescribeContextFilesResponseBody, type DirectoryEntry, type DownloadPolicy, DownloadStrategy, type ExecutionResult, Extension, ExtensionOption, ExtensionsService, type ExtractOptions, type ExtractPolicy, ExtractPolicyClass, FileError, type FileInfo, FileSystem, GetContextFileDownloadUrlRequest, GetContextFileDownloadUrlResponse, GetContextFileDownloadUrlResponseBody, GetContextFileUploadUrlRequest, GetContextFileUploadUrlResponse, GetContextFileUploadUrlResponseBody, GetContextInfoRequest, GetContextInfoResponse, GetContextInfoResponseBody, GetContextInfoResponseBodyData, GetContextRequest, GetContextResponse, GetContextResponseBody, GetContextResponseBodyData, GetLabelRequest, GetLabelResponse, GetLabelResponseBody, GetLabelResponseBodyData, GetLinkRequest, GetLinkResponse, GetLinkResponseBody, GetLinkResponseBodyData, GetMcpResourceRequest, GetMcpResourceResponse, GetMcpResourceResponseBody, GetMcpResourceResponseBodyData, GetMcpResourceResponseBodyDataDesktopInfo, InitBrowserRequest, InitBrowserResponse, InitBrowserResponseBody, InitBrowserResponseBodyData, type InstalledApp, KeyCode, ListContextsRequest, ListContextsResponse, ListContextsResponseBody, ListContextsResponseBodyData, ListMcpToolsRequest, ListMcpToolsResponse, ListMcpToolsResponseBody, type ListSessionParams, ListSessionRequest, ListSessionResponse, ListSessionResponseBody, ListSessionResponseBodyData, type McpSession, type McpToolResult, ModifyContextRequest, ModifyContextResponse, ModifyContextResponseBody, type ObserveOptions, ObserveResult, Oss, OssError, type Process, type QueryResult, ReleaseMcpSessionRequest, ReleaseMcpSessionResponse, ReleaseMcpSessionResponseBody, Session, SessionError, type SessionInterface, SetLabelRequest, SetLabelResponse, SetLabelResponseBody, SyncContextRequest, SyncContextResponse, SyncContextResponseBody, type SyncPolicy, SyncPolicyImpl, UI, type UIElement, UIError, type UploadPolicy, UploadStrategy, type WhiteList, loadConfig, loadDotEnv, log, logError, newContextManager, newContextSync, newCreateSessionParams, newDeletePolicy, newDownloadPolicy, newExtractPolicy, newSyncPolicy, newSyncPolicyWithDefaults, newUploadPolicy };