instavm 0.15.0 → 0.17.0

package/dist/index.d.mts

@@ -1,922 +1,9 @@
-import FormData from 'form-data';
-import { EventEmitter } from 'eventemitter3';
+export { aX as APIKey, aY as APIKeyCreateRequest, A as APIKeysManager, ai as AddVaultCredentialOptions, aj as AddVaultServiceOptions, M as ApiResponse, m as AsyncExecutionResult, aZ as AuditEventQuery, e as AuditManager, B as BrowserManager, b as BrowserSession, r as BrowserSessionInfo, q as BrowserSessionOptions, t as ClickOptions, d as ComputerUseManager, aW as ComputerUseProxyOptions, L as ContentAnchor, aq as CreditAllocation, ar as CreditCheckResponse, as as CreditForecastResponse, at as CreditPeriod, au as CreditRates, av as CreditSummary, aw as CreditTrendsGranularity, ax as CreditTrendsPeriod, ay as CreditTrendsResponse, az as CreditUsageEntry, h as CreditsManager, $ as CurrentUserResponse, aV as CustomDomainCreateRequest, C as CustomDomainsManager, D as DownloadOptions, p as DownloadResult, Y as EgressPolicy, Z as EgressPolicyOptions, E as ExecuteOptions, l as ExecutionResult, H as ExtractContentOptions, G as ExtractOptions, J as ExtractedContent, z as ExtractedElement, F as FileUpload, v as FillOptions, O as HttpClientConfig, I as InstaVM, a as InstaVMOptions, K as InteractiveElement, aA as JsonMap, N as NavigateOptions, s as NavigationResult, al as PTYCreateOptions, P as PTYManager, am as PTYRecord, ap as RecordingDownloadResult, an as RecordingListQuery, ao as RecordingRecord, R as RecordingsManager, Q as RequestConfig, X as RetryConfig, _ as SSHKey, x as ScreenshotOptions, w as ScrollOptions, a0 as SessionStatusResponse, aT as ShareCreateRequest, aU as ShareUpdateRequest, c as SharesManager, aF as SnapshotBuildArgs, aG as SnapshotCreateRequest, aH as SnapshotQueryOptions, S as SnapshotsManager, a4 as TapeAppendEventOptions, a5 as TapeBranchOptions, aa as TapeBranchResponse, i as TapeContext, a9 as TapeDiffResponse, a7 as TapeEvent, a3 as TapeEventsQuery, ab as TapeExportBundle, a8 as TapeLanesResponse, a2 as TapeListQuery, a6 as TapeRecord, a1 as TapeStartOptions, T as TapesManager, j as ToolCallRecorder, k as ToolCallSpan, u as TypeOptions, ak as UpdateVaultOptions, U as UploadOptions, n as UploadResult, o as UsageStats, aD as VMCloneRequest, aB as VMCreateRequest, aS as VMMountedVolumeResponse, aE as VMSnapshotRequest, aC as VMUpdateRequest, aR as VMVolumeMountRequest, V as VMsManager, ah as VaultCatalogTemplate, ad as VaultCredential, ag as VaultDiscoverResponse, ac as VaultRecord, af as VaultRequestLog, ae as VaultService, g as VaultsManager, aL as VolumeCheckpointCreateRequest, aM as VolumeCheckpointResponse, aI as VolumeCreateRequest, aO as VolumeFileDownloadResponse, aN as VolumeFileEntry, aQ as VolumeFileListQuery, aP as VolumeFileUploadRequest, aK as VolumeResponse, aJ as VolumeUpdateRequest, f as VolumesManager, y as WaitCondition, b0 as WebhookDeliveryQuery, a_ as WebhookEndpointCreateRequest, a$ as WebhookEndpointUpdateRequest, W as WebhooksManager } from './InstaVM-DjkmUcaP.mjs';
+import 'form-data';
+import 'eventemitter3';
 
-interface ApiResponse<T = any> {
-    success?: boolean;
-    data?: T;
-    error?: string;
-    message?: string;
-}
-interface HttpClientConfig {
-    baseURL: string;
-    timeout: number;
-    maxRetries: number;
-    retryDelay: number;
-    apiKey: string;
-}
-interface RequestConfig {
-    method: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH' | 'OPTIONS' | 'HEAD';
-    url: string;
-    headers?: Record<string, string>;
-    data?: any;
-    params?: Record<string, any>;
-    timeout?: number;
-}
-interface RetryConfig {
-    retries: number;
-    retryDelay: number;
-    retryCondition?: (error: any) => boolean;
-}
-
-/**
- * HTTP client with authentication, retry logic, and error handling
- */
-declare class HTTPClient {
-    private client;
-    private config;
-    get apiKey(): string;
-    constructor(config: HttpClientConfig);
-    private setupInterceptors;
-    /**
-     * Make an HTTP request with retry logic
-     */
-    request<T = any>(requestConfig: RequestConfig): Promise<T>;
-    /**
-     * POST request with JSON body
-     */
-    post<T = any>(url: string, data?: any, headers?: Record<string, string>, timeout?: number): Promise<T>;
-    /**
-     * POST request for code execution (uses X-API-Key header like Python client)
-     */
-    postExecution<T = any>(url: string, data: any, headers?: Record<string, string>, timeout?: number): Promise<T>;
-    /**
-     * POST request with form data (for file uploads)
-     */
-    postFormData<T = any>(url: string, formData: FormData, headers?: Record<string, string>): Promise<T>;
-    /**
-     * POST request with URL-encoded form data (like Python requests data= parameter)
-     */
-    postFormUrlEncoded<T = any>(url: string, data: any, headers?: Record<string, string>): Promise<T>;
-    /**
-     * GET request
-     */
-    get<T = any>(url: string, params?: Record<string, any>, headers?: Record<string, string>): Promise<T>;
-    /**
-     * DELETE request
-     */
-    delete<T = any>(url: string, headers?: Record<string, string>): Promise<T>;
-    /**
-     * PUT request
-     */
-    put<T = any>(url: string, data?: any, headers?: Record<string, string>): Promise<T>;
-    /**
-     * PATCH request
-     */
-    patch<T = any>(url: string, data?: any, headers?: Record<string, string>): Promise<T>;
-    /**
-     * OPTIONS request
-     */
-    options<T = any>(url: string, headers?: Record<string, string>, params?: Record<string, any>): Promise<T>;
-    /**
-     * POST request that returns raw binary data (for file downloads)
-     */
-    postRaw(url: string, data?: any, headers?: Record<string, string>): Promise<ArrayBuffer>;
-}
-
-interface BrowserSessionOptions {
-    viewportWidth?: number;
-    viewportHeight?: number;
-    userAgent?: string;
-}
-interface BrowserSessionInfo {
-    sessionId: string;
-    status: 'active' | 'inactive' | 'closed';
-    createdAt: string;
-    viewportWidth: number;
-    viewportHeight: number;
-    userAgent?: string;
-}
-interface NavigateOptions {
-    waitTimeout?: number;
-    waitUntil?: 'load' | 'domcontentloaded' | 'networkidle';
-}
-interface NavigationResult {
-    success: boolean;
-    url: string;
-    title?: string;
-    status?: number;
-}
-interface ClickOptions {
-    timeout?: number;
-    button?: 'left' | 'right' | 'middle';
-    clickCount?: number;
-    force?: boolean;
-}
-interface TypeOptions {
-    timeout?: number;
-    delay?: number;
-    clear?: boolean;
-}
-interface FillOptions {
-    timeout?: number;
-    force?: boolean;
-}
-interface ScrollOptions {
-    x?: number;
-    y?: number;
-    behavior?: 'auto' | 'smooth';
-}
-interface ScreenshotOptions {
-    fullPage?: boolean;
-    format?: 'png' | 'jpeg';
-    quality?: number;
-    clip?: {
-        x: number;
-        y: number;
-        width: number;
-        height: number;
-    };
-}
-type WaitCondition = {
-    type: 'visible';
-    selector: string;
-} | {
-    type: 'hidden';
-    selector: string;
-} | {
-    type: 'attached';
-    selector: string;
-} | {
-    type: 'detached';
-    selector: string;
-} | {
-    type: 'timeout';
-    ms: number;
-};
-interface ExtractedElement {
-    text?: string;
-    href?: string;
-    src?: string;
-    class?: string;
-    id?: string;
-    tagName?: string;
-    [attribute: string]: any;
-}
-interface ExtractOptions {
-    attributes?: string[];
-    maxResults?: number;
-}
-interface ExtractContentOptions {
-    url?: string;
-    includeInteractive?: boolean;
-    includeAnchors?: boolean;
-    maxAnchors?: number;
-}
-interface InteractiveElement {
-    type: 'button' | 'link' | 'input' | 'select' | 'textarea';
-    selector: string;
-    text?: string;
-    label?: string;
-    placeholder?: string;
-    value?: string;
-}
-interface ContentAnchor {
-    text: string;
-    selector: string;
-}
-interface ExtractedContent {
-    readableContent: {
-        content: string;
-        title?: string;
-        byline?: string;
-        excerpt?: string;
-        siteName?: string;
-    };
-    interactiveElements?: InteractiveElement[];
-    contentAnchors?: ContentAnchor[];
-}
-
-/**
- * Browser session for automation
- */
-declare class BrowserSession extends EventEmitter {
-    readonly sessionId: string;
-    private httpClient;
-    private _isActive;
-    constructor(sessionId: string, httpClient: HTTPClient);
-    /**
-     * Navigate to a URL
-     */
-    navigate(url: string, options?: NavigateOptions): Promise<NavigationResult>;
-    /**
-     * Click an element
-     */
-    click(selector: string, options?: ClickOptions): Promise<void>;
-    /**
-     * Type text into an element
-     */
-    type(selector: string, text: string, options?: TypeOptions): Promise<void>;
-    /**
-     * Fill a form field
-     */
-    fill(selector: string, value: string, options?: FillOptions): Promise<void>;
-    /**
-     * Scroll the page
-     */
-    scroll(options?: ScrollOptions): Promise<void>;
-    /**
-     * Take a screenshot
-     */
-    screenshot(options?: ScreenshotOptions): Promise<string>;
-    /**
-     * Extract elements from the page
-     */
-    extractElements(selector: string, attributes?: string[], options?: ExtractOptions): Promise<ExtractedElement[]>;
-    /**
-     * Extract LLM-friendly content from the current page
-     *
-     * Returns clean article content, interactive elements, and content anchors
-     * for intelligent browser automation with LLMs.
-     *
-     * @param options - Content extraction options
-     * @returns Extracted content with readable text, interactive elements, and content anchors
-     *
-     * @example
-     * ```typescript
-     * const content = await session.extractContent();
-     *
-     * // LLM reads clean content
-     * const article = content.readableContent.content;
-     *
-     * // LLM finds "Sign Up" in content and uses anchors to get selector
-     * const signUpAnchor = content.contentAnchors?.find(
-     *   anchor => anchor.text.toLowerCase().includes('sign up')
-     * );
-     * if (signUpAnchor) {
-     *   await session.click(signUpAnchor.selector);
-     * }
-     * ```
-     */
-    extractContent(options?: ExtractContentOptions): Promise<ExtractedContent>;
-    /**
-     * Wait for a condition
-     */
-    wait(condition: WaitCondition, timeout?: number): Promise<void>;
-    /**
-     * Close the browser session
-     */
-    close(): Promise<void>;
-    /**
-     * Check if session is active
-     */
-    get isActive(): boolean;
-    /**
-     * Ensure session is active before operations
-     */
-    private ensureActive;
-}
-
-/**
- * Browser automation manager
- */
-declare class BrowserManager {
-    private httpClient;
-    private activeSessions;
-    private local;
-    constructor(httpClient: HTTPClient, local?: boolean);
-    /**
-     * Create a new browser session
-     */
-    createSession(options?: BrowserSessionOptions): Promise<BrowserSession>;
-    /**
-     * Get information about a specific session
-     */
-    getSession(sessionId: string): Promise<BrowserSessionInfo>;
-    /**
-     * List all browser sessions
-     */
-    listSessions(): Promise<BrowserSessionInfo[]>;
-    /**
-     * Get a locally tracked session
-     */
-    getLocalSession(sessionId: string): BrowserSession | undefined;
-    /**
-     * Get all locally tracked sessions
-     */
-    getLocalSessions(): BrowserSession[];
-    /**
-     * Close all active sessions
-     */
-    closeAllSessions(): Promise<void>;
-    /**
-     * Navigate to a URL (local mode support - no session required)
-     */
-    navigate(url: string, options?: NavigateOptions): Promise<NavigationResult>;
-    /**
-     * Extract LLM-friendly content (local mode support - no session required)
-     */
-    extractContent(options?: ExtractContentOptions): Promise<ExtractedContent>;
-    /**
-     * Clean up resources
-     */
-    dispose(): Promise<void>;
-}
-
-type JsonMap = Record<string, any>;
-interface VMCreateRequest extends JsonMap {
-    session_id?: string | null;
-    vm_lifetime_seconds?: number | null;
-    memory_mb?: number | null;
-    vcpu_count?: number | null;
-    metadata?: JsonMap | null;
-    egress_policy?: JsonMap | null;
-    snapshot_id?: string | null;
-    snapshot_on_terminate?: boolean | null;
-    snapshot_name?: string | null;
-    share?: JsonMap | null;
-    custom_domain?: JsonMap | null;
-    image_variant?: string | null;
-    volumes?: VMVolumeMountRequest[] | null;
-}
-interface VMUpdateRequest extends JsonMap {
-    memory_mb?: number | null;
-    egress_policy?: JsonMap | null;
-    snapshot_on_terminate?: boolean | null;
-    snapshot_name?: string | null;
-}
-interface VMCloneRequest extends JsonMap {
-    snapshot_name?: string | null;
-}
-interface VMSnapshotRequest extends JsonMap {
-    name?: string | null;
-}
-interface SnapshotBuildArgs extends JsonMap {
-    extra_apt_packages?: string | null;
-    extra_pip_packages?: string | null;
-    extra_npm_packages?: string | null;
-    git_clone_url?: string | null;
-    git_clone_branch?: string | null;
-    disk_size_gb?: number | null;
-    envs?: Record<string, string> | null;
-    post_build_cmd?: string | null;
-}
-interface SnapshotCreateRequest extends JsonMap {
-    oci_image: string;
-    name?: string | null;
-    vcpu_count?: number;
-    memory_mb?: number;
-    build_args?: SnapshotBuildArgs | null;
-    type?: 'user' | 'system';
-}
-interface SnapshotQueryOptions {
-    type?: 'user' | 'system';
-}
-interface VolumeCreateRequest extends JsonMap {
-    name: string;
-    quota_bytes: number;
-}
-interface VolumeUpdateRequest extends JsonMap {
-    name?: string | null;
-    quota_bytes?: number | null;
-}
-interface VolumeResponse extends JsonMap {
-    id: string;
-    name: string;
-    quota_bytes: number;
-    used_bytes: number;
-    status: string;
-    created_at?: string | null;
-    updated_at?: string | null;
-}
-interface VolumeCheckpointCreateRequest extends JsonMap {
-    name?: string | null;
-}
-interface VolumeCheckpointResponse extends JsonMap {
-    id: string;
-    volume_id: string;
-    name?: string | null;
-    status: string;
-    created_at?: string | null;
-}
-interface VolumeFileEntry extends JsonMap {
-    path: string;
-    filename: string;
-    size: number;
-}
-interface VolumeFileDownloadResponse extends JsonMap {
-    path: string;
-    filename: string;
-    size: number;
-    content: Buffer;
-}
-interface VolumeFileUploadRequest extends JsonMap {
-    path: string;
-    overwrite?: boolean;
-    filePath?: string;
-    fileContent?: Buffer | string;
-    filename?: string;
-}
-interface VolumeFileListQuery {
-    prefix?: string;
-    recursive?: boolean;
-    limit?: number;
-}
-interface VMVolumeMountRequest extends JsonMap {
-    volume_id: string;
-    mount_path: string;
-    mode?: string;
-    checkpoint_id?: string | null;
-}
-interface VMMountedVolumeResponse extends JsonMap {
-    volume_id: string;
-    mount_path: string;
-    mode: string;
-    checkpoint_id?: string | null;
-    status: string;
-}
-interface ShareCreateRequest extends JsonMap {
-    session_id?: string | null;
-    vm_id?: string | null;
-    port: number;
-    is_public?: boolean;
-}
-interface ShareUpdateRequest extends JsonMap {
-    is_public?: boolean | null;
-    revoke?: boolean | null;
-}
-interface CustomDomainCreateRequest extends JsonMap {
-    domain: string;
-    share_id: string;
-    dns_provider: string;
-    dns_credentials?: Record<string, string> | null;
-}
-interface ComputerUseProxyOptions {
-    params?: Record<string, any>;
-    body?: any;
-}
-interface APIKeyCreateRequest extends JsonMap {
-    description?: string | null;
-    expires_at?: string | null;
-}
-interface APIKey extends JsonMap {
-    id?: number;
-    description?: string | null;
-    /** @deprecated Use key_prefix instead */
-    prefix?: string;
-    key_prefix?: string;
-    full_key?: string;
-    created_at?: string;
-    expires_at?: string | null;
-}
-interface AuditEventQuery {
-    event_group?: string;
-    event_type?: string;
-    status?: string;
-    user_id?: number;
-    vm_id?: string;
-    session_id?: string;
-    cursor?: string;
-    limit?: number;
-}
-interface WebhookEndpointCreateRequest extends JsonMap {
-    url: string;
-    description?: string | null;
-    event_patterns?: string[] | null;
-    timeout_seconds?: number;
-    max_retries?: number;
-}
-interface WebhookEndpointUpdateRequest extends JsonMap {
-    url?: string | null;
-    description?: string | null;
-    enabled?: boolean | null;
-    event_patterns?: string[] | null;
-    timeout_seconds?: number | null;
-    max_retries?: number | null;
-}
-interface WebhookDeliveryQuery {
-    endpoint_id?: string;
-    status?: string;
-    event_type?: string;
-    cursor?: string;
-    limit?: number;
-}
-
-declare class VMsManager {
-    private httpClient;
-    private local;
-    constructor(httpClient: HTTPClient, local?: boolean);
-    private ensureCloud;
-    create(payload?: VMCreateRequest, wait?: boolean): Promise<JsonMap>;
-    list(): Promise<JsonMap[]>;
-    listAll(): Promise<JsonMap[]>;
-    /**
-     * Calls GET /v1/vms/ (trailing slash), a distinct route from GET /v1/vms.
-     */
-    listAllRecords(): Promise<JsonMap[]>;
-    get(itemId: string | number): Promise<JsonMap>;
-    update(vmId: string, payload?: VMUpdateRequest): Promise<JsonMap>;
-    delete(vmId: string): Promise<JsonMap>;
-    clone(vmId: string, payload?: VMCloneRequest, wait?: boolean): Promise<JsonMap>;
-    snapshot(vmId: string, payload?: VMSnapshotRequest, wait?: boolean): Promise<JsonMap>;
-    mountVolume(vmId: string, payload: VMVolumeMountRequest, wait?: boolean): Promise<VMMountedVolumeResponse>;
-    listVolumes(vmId: string): Promise<VMMountedVolumeResponse[]>;
-    unmountVolume(vmId: string, volumeId: string, mountPath: string, wait?: boolean): Promise<JsonMap>;
-}
-
-declare class SnapshotsManager {
-    private httpClient;
-    private local;
-    constructor(httpClient: HTTPClient, local?: boolean);
-    private ensureCloud;
-    create(payload: SnapshotCreateRequest): Promise<JsonMap>;
-    list(options?: SnapshotQueryOptions): Promise<JsonMap[]>;
-    get(snapshotId: string): Promise<JsonMap>;
-    delete(snapshotId: string): Promise<JsonMap>;
-}
-
-declare class SharesManager {
-    private httpClient;
-    private local;
-    private getSessionId;
-    constructor(httpClient: HTTPClient, local?: boolean, getSessionId?: () => string | null);
-    private ensureCloud;
-    create(payload: ShareCreateRequest): Promise<JsonMap>;
-    update(shareId: string, payload: ShareUpdateRequest): Promise<JsonMap>;
-}
-
-declare class CustomDomainsManager {
-    private httpClient;
-    private local;
-    constructor(httpClient: HTTPClient, local?: boolean);
-    private ensureCloud;
-    create(payload: CustomDomainCreateRequest): Promise<JsonMap>;
-    list(): Promise<JsonMap[]>;
-    health(domainId: number): Promise<JsonMap>;
-    verify(domainId: number): Promise<JsonMap>;
-    delete(domainId: number): Promise<JsonMap>;
-}
-
-type ProxyMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'OPTIONS' | 'HEAD';
-declare class ComputerUseManager {
-    private httpClient;
-    private local;
-    constructor(httpClient: HTTPClient, local?: boolean);
-    private ensureCloud;
-    viewerUrl(sessionId: string): Promise<JsonMap>;
-    proxy(sessionId: string, path: string, method?: ProxyMethod, options?: ComputerUseProxyOptions): Promise<any>;
-    get(sessionId: string, path: string, params?: Record<string, any>): Promise<any>;
-    post(sessionId: string, path: string, body?: any): Promise<any>;
-    put(sessionId: string, path: string, body?: any): Promise<any>;
-    patch(sessionId: string, path: string, body?: any): Promise<any>;
-    delete(sessionId: string, path: string, params?: Record<string, any>): Promise<any>;
-    options(sessionId: string, path: string, params?: Record<string, any>): Promise<any>;
-    head(sessionId: string, path: string, params?: Record<string, any>): Promise<any>;
-    /**
-     * Get the VNC WebSocket URL for a computer-use session.
-     * Returns the URL to connect to; the actual connection requires a WebSocket client.
-     */
-    vncWebsockify(sessionId: string): Promise<JsonMap>;
-}
-
-declare class APIKeysManager {
-    private httpClient;
-    private local;
-    constructor(httpClient: HTTPClient, local?: boolean);
-    private ensureCloud;
-    create(payload?: APIKeyCreateRequest): Promise<APIKey>;
-    list(): Promise<APIKey[]>;
-    get(itemId: number): Promise<APIKey>;
-    update(itemId: number, payload: APIKeyCreateRequest): Promise<APIKey>;
-    delete(itemId: number): Promise<JsonMap>;
-}
-
-declare class AuditManager {
-    private httpClient;
-    private local;
-    constructor(httpClient: HTTPClient, local?: boolean);
-    private ensureCloud;
-    catalog(): Promise<JsonMap>;
-    events(query?: AuditEventQuery): Promise<JsonMap>;
-    getEvent(eventId: string): Promise<JsonMap>;
-}
-
-declare class WebhooksManager {
-    private httpClient;
-    private local;
-    constructor(httpClient: HTTPClient, local?: boolean);
-    private ensureCloud;
-    createEndpoint(payload: WebhookEndpointCreateRequest): Promise<JsonMap>;
-    listEndpoints(): Promise<JsonMap[]>;
-    getEndpoint(endpointId: string): Promise<JsonMap>;
-    updateEndpoint(endpointId: string, payload: WebhookEndpointUpdateRequest): Promise<JsonMap>;
-    deleteEndpoint(endpointId: string): Promise<JsonMap>;
-    rotateSecret(endpointId: string): Promise<JsonMap>;
-    sendTestEvent(endpointId: string): Promise<JsonMap>;
-    verifyEndpoint(endpointId: string): Promise<JsonMap>;
-    listDeliveries(query?: WebhookDeliveryQuery): Promise<JsonMap>;
-    replayDelivery(deliveryId: string): Promise<JsonMap>;
-}
-
-declare class VolumesManager {
-    private httpClient;
-    private local;
-    constructor(httpClient: HTTPClient, local?: boolean);
-    private ensureCloud;
-    create(payload: VolumeCreateRequest): Promise<VolumeResponse>;
-    list(refreshUsage?: boolean): Promise<VolumeResponse[]>;
-    get(volumeId: string, refreshUsage?: boolean): Promise<VolumeResponse>;
-    update(volumeId: string, payload: VolumeUpdateRequest): Promise<VolumeResponse>;
-    delete(volumeId: string): Promise<JsonMap>;
-    createCheckpoint(volumeId: string, payload?: VolumeCheckpointCreateRequest): Promise<VolumeCheckpointResponse>;
-    listCheckpoints(volumeId: string): Promise<VolumeCheckpointResponse[]>;
-    deleteCheckpoint(volumeId: string, checkpointId: string): Promise<JsonMap>;
-    uploadFile(volumeId: string, payload: VolumeFileUploadRequest): Promise<VolumeFileEntry>;
-    downloadFile(volumeId: string, path: string): Promise<VolumeFileDownloadResponse>;
-    listFiles(volumeId: string, options?: VolumeFileListQuery): Promise<VolumeFileEntry[]>;
-    deleteFile(volumeId: string, targetPath: string): Promise<JsonMap>;
-}
-
-interface ExecuteOptions {
-    language?: 'python' | 'bash';
-    timeout?: number;
-    sessionId?: string;
-}
-interface ExecutionResult {
-    stdout: string;
-    stderr: string;
-    success: boolean;
-    executionTime?: number;
-    cpuTime?: number;
-    createdAt?: string;
-    sessionId?: string;
-    error?: string;
-}
-interface AsyncExecutionResult {
-    taskId: string;
-    status: 'pending' | 'running' | 'completed' | 'failed';
-    output?: string;
-    success?: boolean;
-    executionTime?: number;
-    sessionId?: string;
-    error?: string;
-}
-interface TaskResult {
-    stdout: string;
-    stderr: string;
-    executionTime?: number;
-    cpuTime?: number;
-    createdAt?: string;
-}
-interface FileUpload {
-    name: string;
-    content: Buffer | string;
-    path?: string;
-}
-interface UploadOptions {
-    sessionId?: string;
-    remotePath?: string;
-    recursive?: boolean;
-}
-interface UploadResult {
-    success: boolean;
-    files: string[];
-    message?: string;
-}
-interface UsageStats {
-    sessionsUsed: number;
-    executionTime: number;
-    quotaRemaining: number;
-    quotaLimit: number;
-}
-interface DownloadOptions {
-    sessionId?: string;
-}
-interface DownloadResult {
-    success: boolean;
-    filename: string;
-    content: Buffer;
-    size: number;
-}
-
-interface EgressPolicy {
-    allowPackageManagers: boolean;
-    allowHttp: boolean;
-    allowHttps: boolean;
-    allowedDomains: string[];
-    allowedCidrs: string[];
-}
-interface EgressPolicyOptions {
-    allowPackageManagers?: boolean;
-    allowHttp?: boolean;
-    allowHttps?: boolean;
-    allowedDomains?: string[];
-    allowedCidrs?: string[];
-}
-
-interface SSHKey {
-    id: number;
-    fingerprint: string;
-    keyType: string;
-    comment: string | null;
-    createdAt: string;
-}
-
-interface CurrentUserResponse extends Record<string, any> {
-    id: number;
-    name: string;
-    email: string;
-    is_verified: boolean;
-}
-interface SessionStatusResponse extends Record<string, any> {
-    session_id: string;
-    exists: boolean;
-    vm_assigned: boolean;
-    vm_status?: string | null;
-    vm_id?: string | null;
-    vm_alive: boolean;
-    uptime_seconds?: number | null;
-    expires_in_seconds?: number | null;
-    created_at?: string | null;
-}
-
-interface InstaVMOptions {
-    baseURL?: string;
-    /**
-     * Timeout in milliseconds. Used for HTTP request timeout and sent to API as VM lifetime (in seconds).
-     * Default: 300000 (5 minutes)
-     */
-    timeout?: number;
-    maxRetries?: number;
-    retryDelay?: number;
-    local?: boolean;
-    localURL?: string;
-    /** VM memory in megabytes (optional). Range: 128-8192 MB */
-    memory_mb?: number;
-    /** VM vCPU count (optional). Valid values: 1, 2, 4, 6, 8 */
-    cpu_count?: number;
-    /** Optional user-defined metadata for filtering */
-    metadata?: Record<string, any>;
-    /** Optional environment variables to set in the VM */
-    env?: Record<string, any>;
-}
-/**
- * Main InstaVM client class
- */
-declare class InstaVM {
-    private httpClient;
-    private _sessionId;
-    readonly browser: BrowserManager;
-    readonly vms: VMsManager;
-    readonly snapshots: SnapshotsManager;
-    readonly shares: SharesManager;
-    readonly customDomains: CustomDomainsManager;
-    readonly computerUse: ComputerUseManager;
-    readonly apiKeys: APIKeysManager;
-    readonly audit: AuditManager;
-    readonly webhooks: WebhooksManager;
-    readonly volumes: VolumesManager;
-    readonly local: boolean;
-    private readonly timeout;
-    readonly memory_mb?: number;
-    readonly cpu_count?: number;
-    readonly metadata?: Record<string, any>;
-    readonly env?: Record<string, any>;
-    private _vmUsed;
-    constructor(apiKey: string, options?: InstaVMOptions);
-    /**
-     * Ensure operation is not called in local mode
-     */
-    private ensureNotLocal;
-    /**
-     * Execute code synchronously
-     *
-     * @param command - Command to execute
-     * @param options - Execution options
-     * @param options.timeout - Request timeout in milliseconds (used for HTTP request timeout and sent to API in seconds)
-     * @returns Execution result
-     */
-    execute(command: string, options?: ExecuteOptions): Promise<ExecutionResult>;
-    /**
-     * Execute code asynchronously
-     */
-    executeAsync(command: string, options?: ExecuteOptions): Promise<AsyncExecutionResult>;
-    /**
-     * Poll for async task result
-     *
-     * @param taskId - The task ID from executeAsync
-     * @param pollInterval - Seconds between polls (default: 1)
-     * @param timeout - Maximum seconds to wait (default: 60)
-     * @returns Task result with stdout, stderr, execution time, etc.
-     * @throws Error if task doesn't complete within timeout
-     */
-    getTaskResult(taskId: string, pollInterval?: number, timeout?: number): Promise<TaskResult>;
-    /**
-     * Upload files to the execution environment
-     */
-    upload(files: FileUpload[], options?: UploadOptions): Promise<UploadResult>;
-    /**
-     * Create a new execution session
-     */
-    createSession(): Promise<string>;
-    /**
-     * Close a session
-     * Note: Sessions auto-expire on the server side. This just clears local state.
-     */
-    closeSession(sessionId?: string): Promise<void>;
-    /**
-     * Check if current session is still active by checking VM status
-     *
-     * @returns true if session is active, false otherwise
-     */
-    isSessionActive(sessionId?: string): Promise<boolean>;
-    /**
-     * Get the app URL for a session
-     *
-     * @param sessionId - Session ID (uses current session if not provided)
-     * @param port - Port to expose (1-65535, default: 80)
-     */
-    getSessionAppUrl(sessionId?: string, port?: number): Promise<Record<string, any>>;
-    /**
-     * List sandbox records with optional filtering
-     *
-     * @param options.metadata - JSON-serializable metadata filters
-     * @param options.limit - Maximum number of results (1-1000, default: 100)
-     */
-    listSandboxes(options?: {
-        metadata?: Record<string, any>;
-        limit?: number;
-    }): Promise<Record<string, any>[]>;
-    /**
-     * Get usage statistics for a session
-     */
-    getUsage(sessionId?: string): Promise<UsageStats>;
-    /**
-     * Get the current user profile.
-     */
-    getCurrentUser(): Promise<CurrentUserResponse>;
-    /**
-     * Get the current status of a session.
-     */
-    getSessionStatus(sessionId?: string): Promise<SessionStatusResponse>;
-    /**
-     * Download a file from the remote VM
-     */
-    download(filename: string, options?: DownloadOptions): Promise<DownloadResult>;
-    /**
-     * Get the current session ID
-     */
-    get sessionId(): string | null;
-    /**
-     * Kill the VM associated with a session
-     *
-     * @param sessionId - The session UUID whose VM should be killed. If not provided, uses current sessionId
-     * @returns Result containing success message and killed VM ID
-     */
-    kill(sessionId?: string): Promise<{
-        success: boolean;
-        killed: string;
-    }>;
-    /**
-     * Set egress policy for a session
-     */
-    setSessionEgress(options?: EgressPolicyOptions, sessionId?: string): Promise<{
-        status: string;
-        sessionId: string;
-    }>;
-    /**
-     * Get egress policy for a session
-     */
-    getSessionEgress(sessionId?: string): Promise<EgressPolicy>;
-    /**
-     * Set egress policy for a specific VM
-     */
-    setVmEgress(vmId: string, options?: EgressPolicyOptions): Promise<{
-        status: string;
-        vmId: string;
-    }>;
-    /**
-     * Get egress policy for a specific VM
-     */
-    getVmEgress(vmId: string): Promise<EgressPolicy>;
-    /**
-     * Add an SSH public key
-     */
-    addSshKey(publicKey: string): Promise<SSHKey>;
-    /**
-     * List all active SSH keys
-     */
-    listSshKeys(): Promise<SSHKey[]>;
-    /**
-     * Delete an SSH key by ID
-     */
-    deleteSshKey(keyId: number): Promise<{
-        status: string;
-    }>;
-    /**
-     * Clean up resources
-     */
-    dispose(): Promise<void>;
-}
+/** Keep in sync with root `package.json` `version`. */
+declare const INSTAVM_JS_SDK_VERSION = "0.17.0";
 
 /**
  * Base error class for all InstaVM SDK errors
@@ -952,6 +39,12 @@ declare class RateLimitError extends InstaVMError {
 declare class QuotaExceededError extends InstaVMError {
     constructor(message?: string, options?: any);
 }
+/**
+ * Forbidden errors (403, tier limits, ownership mismatch).
+ */
+declare class ForbiddenError extends InstaVMError {
+    constructor(message?: string, options?: any);
+}
 /**
  * Network-related errors (timeouts, connection issues, 5xx errors)
  */
@@ -1016,4 +109,4 @@ declare class UnsupportedOperationError extends InstaVMError {
     constructor(message?: string, options?: any);
 }
 
-export { type APIKey, type APIKeyCreateRequest, APIKeysManager, type ApiResponse, type AsyncExecutionResult, type AuditEventQuery, AuditManager, AuthenticationError, BrowserError, BrowserInteractionError, BrowserManager, BrowserNavigationError, BrowserSession, BrowserSessionError, type BrowserSessionInfo, type BrowserSessionOptions, BrowserTimeoutError, type ClickOptions, ComputerUseManager, type ComputerUseProxyOptions, type ContentAnchor, type CurrentUserResponse, type CustomDomainCreateRequest, CustomDomainsManager, type DownloadOptions, type DownloadResult, type EgressPolicy, type EgressPolicyOptions, ElementNotFoundError, type ExecuteOptions, ExecutionError, type ExecutionResult, type ExtractContentOptions, type ExtractOptions, type ExtractedContent, type ExtractedElement, type FileUpload, type FillOptions, type HttpClientConfig, InstaVM, InstaVMError, type InstaVMOptions, type InteractiveElement, type JsonMap, type NavigateOptions, type NavigationResult, NetworkError, QuotaExceededError, RateLimitError, type RequestConfig, type RetryConfig, type SSHKey, type ScreenshotOptions, type ScrollOptions, SessionError, type SessionStatusResponse, type ShareCreateRequest, type ShareUpdateRequest, SharesManager, type SnapshotBuildArgs, type SnapshotCreateRequest, type SnapshotQueryOptions, SnapshotsManager, type TypeOptions, UnsupportedOperationError, type UploadOptions, type UploadResult, type UsageStats, type VMCloneRequest, type VMCreateRequest, type VMMountedVolumeResponse, type VMSnapshotRequest, type VMUpdateRequest, type VMVolumeMountRequest, VMsManager, type VolumeCheckpointCreateRequest, type VolumeCheckpointResponse, type VolumeCreateRequest, type VolumeFileDownloadResponse, type VolumeFileEntry, type VolumeFileListQuery, type VolumeFileUploadRequest, type VolumeResponse, type VolumeUpdateRequest, VolumesManager, type WaitCondition, type WebhookDeliveryQuery, type WebhookEndpointCreateRequest, type WebhookEndpointUpdateRequest, WebhooksManager };
+export { AuthenticationError, BrowserError, BrowserInteractionError, BrowserNavigationError, BrowserSessionError, BrowserTimeoutError, ElementNotFoundError, ExecutionError, ForbiddenError, INSTAVM_JS_SDK_VERSION, InstaVMError, NetworkError, QuotaExceededError, RateLimitError, SessionError, UnsupportedOperationError };