@daytonaio/sdk 0.127.0 → 0.128.0-alpha.1

package/esm/PtyHandle.d.ts

@@ -0,0 +1,155 @@
+import WebSocket from 'isomorphic-ws';
+import { PtyResult } from './types/Pty.js';
+import { PtySessionInfo } from '@daytonaio/toolbox-api-client';
+/**
+ * PTY session handle for managing a single PTY session.
+ *
+ * Provides methods for sending input, resizing the terminal, waiting for completion,
+ * and managing the WebSocket connection to a PTY session.
+ *
+ * @example
+ * ```typescript
+ * // Create a PTY session
+ * const ptyHandle = await process.createPty({
+ *   id: 'my-session',
+ *   cols: 120,
+ *   rows: 30,
+ *   onData: (data) => {
+ *     const text = new TextDecoder().decode(data);
+ *     process.stdout.write(text);
+ *   },
+ * });
+ *
+ *
+ * // Send commands
+ * await ptyHandle.sendInput('ls -la\n');
+ * await ptyHandle.sendInput('exit\n');
+ *
+ * // Wait for completion
+ * const result = await ptyHandle.wait();
+ * console.log(`PTY exited with code: ${result.exitCode}`);
+ *
+ * // Clean up
+ * await ptyHandle.disconnect();
+ * ```
+ */
+export declare class PtyHandle {
+    private readonly ws;
+    private readonly handleResize;
+    private readonly handleKill;
+    private readonly onPty;
+    readonly sessionId: string;
+    private _exitCode?;
+    private _error?;
+    private connected;
+    private connectionEstablished;
+    constructor(ws: WebSocket, handleResize: (cols: number, rows: number) => Promise<PtySessionInfo>, handleKill: () => Promise<void>, onPty: (data: Uint8Array) => void | Promise<void>, sessionId: string);
+    /**
+     * Exit code of the PTY process (if terminated)
+     */
+    get exitCode(): number | undefined;
+    /**
+     * Error message if the PTY failed
+     */
+    get error(): string | undefined;
+    /**
+     * Check if connected to the PTY session
+     */
+    isConnected(): boolean;
+    /**
+     * Wait for the WebSocket connection to be established.
+     *
+     * This method ensures the PTY session is ready to receive input and send output.
+     * It waits for the server to confirm the connection is established.
+     *
+     * @throws {Error} If connection times out (10 seconds) or connection fails
+     */
+    waitForConnection(): Promise<void>;
+    /**
+     * Send input data to the PTY session.
+     *
+     * Sends keyboard input or commands to the terminal session. The data will be
+     * processed as if it was typed in the terminal.
+     *
+     * @param {string | Uint8Array} data - Input data to send (commands, keystrokes, etc.)
+     * @throws {Error} If PTY is not connected or sending fails
+     *
+     * @example
+     * // Send a command
+     * await ptyHandle.sendInput('ls -la\n');
+     *
+     * // Send raw bytes
+     * await ptyHandle.sendInput(new Uint8Array([3])); // Ctrl+C
+     */
+    sendInput(data: string | Uint8Array): Promise<void>;
+    /**
+     * Resize the PTY terminal dimensions.
+     *
+     * Changes the terminal size which will notify terminal applications
+     * about the new dimensions via SIGWINCH signal.
+     *
+     * @param {number} cols - New number of terminal columns
+     * @param {number} rows - New number of terminal rows
+     *
+     * @example
+     * // Resize to 120x30
+     * await ptyHandle.resize(120, 30);
+     */
+    resize(cols: number, rows: number): Promise<PtySessionInfo>;
+    /**
+     * Disconnect from the PTY session and clean up resources.
+     *
+     * Closes the WebSocket connection and releases any associated resources.
+     * Should be called when done with the PTY session.
+     *
+     * @example
+     * // Always clean up when done
+     * try {
+     *   // ... use PTY session
+     * } finally {
+     *   await ptyHandle.disconnect();
+     * }
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Wait for the PTY process to exit and return the result.
+     *
+     * This method blocks until the PTY process terminates and returns
+     * information about how it exited.
+     *
+     * @returns {Promise<PtyResult>} Result containing exit code and error information
+     *
+     * @example
+     * // Wait for process to complete
+     * const result = await ptyHandle.wait();
+     *
+     * if (result.exitCode === 0) {
+     *   console.log('Process completed successfully');
+     * } else {
+     *   console.log(`Process failed with code: ${result.exitCode}`);
+     *   if (result.error) {
+     *     console.log(`Error: ${result.error}`);
+     *   }
+     * }
+     */
+    wait(): Promise<PtyResult>;
+    /**
+     * Kill the PTY process and terminate the session.
+     *
+     * Forcefully terminates the PTY session and its associated process.
+     * This operation is irreversible and will cause the PTY to exit immediately.
+     *
+     * @throws {Error} If the kill operation fails
+     *
+     * @example
+     * // Kill a long-running process
+     * await ptyHandle.kill();
+     *
+     * // Wait to confirm termination
+     * const result = await ptyHandle.wait();
+     * console.log(`Process terminated with exit code: ${result.exitCode}`);
+     */
+    kill(): Promise<void>;
+    private setupWebSocketHandlers;
+}
+//# sourceMappingURL=PtyHandle.d.ts.map

package/esm/PtyHandle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PtyHandle.d.ts","sourceRoot":"","sources":["../../../../../libs/sdk-typescript/src/PtyHandle.ts"],"names":[],"mappings":"AAKA,OAAO,SAAS,MAAM,eAAe,CAAA;AACrC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAEvC,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAA;AAE9D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,qBAAa,SAAS;IAOlB,OAAO,CAAC,QAAQ,CAAC,EAAE;IACnB,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM;IAV5B,OAAO,CAAC,SAAS,CAAC,CAAQ;IAC1B,OAAO,CAAC,MAAM,CAAC,CAAQ;IACvB,OAAO,CAAC,SAAS,CAAQ;IACzB,OAAO,CAAC,qBAAqB,CAAQ;gBAGlB,EAAE,EAAE,SAAS,EACb,YAAY,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,EACrE,UAAU,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,EAC/B,KAAK,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,EACzD,SAAS,EAAE,MAAM;IAK5B;;OAEG;IACH,IAAI,QAAQ,IAAI,MAAM,GAAG,SAAS,CAEjC;IAED;;OAEG;IACH,IAAI,KAAK,IAAI,MAAM,GAAG,SAAS,CAE9B;IAED;;OAEG;IACH,WAAW,IAAI,OAAO;IAItB;;;;;;;OAOG;IACG,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC;IA0BxC;;;;;;;;;;;;;;;OAeG;IACG,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBzD;;;;;;;;;;;;OAYG;IACG,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAIjE;;;;;;;;;;;;;OAaG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAUjC;;;;;;;;;;;;;;;;;;;;OAoBG;IACG,IAAI,IAAI,OAAO,CAAC,SAAS,CAAC;IA2BhC;;;;;;;;;;;;;;;OAeG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B,OAAO,CAAC,sBAAsB;CA+H/B"}

package/esm/PtyHandle.js

@@ -0,0 +1,374 @@
+/*
+ * Copyright 2025 Daytona Platforms Inc.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import WebSocket from 'isomorphic-ws';
+import { DaytonaError } from './errors/DaytonaError.js';
+/**
+ * PTY session handle for managing a single PTY session.
+ *
+ * Provides methods for sending input, resizing the terminal, waiting for completion,
+ * and managing the WebSocket connection to a PTY session.
+ *
+ * @example
+ * ```typescript
+ * // Create a PTY session
+ * const ptyHandle = await process.createPty({
+ *   id: 'my-session',
+ *   cols: 120,
+ *   rows: 30,
+ *   onData: (data) => {
+ *     const text = new TextDecoder().decode(data);
+ *     process.stdout.write(text);
+ *   },
+ * });
+ *
+ *
+ * // Send commands
+ * await ptyHandle.sendInput('ls -la\n');
+ * await ptyHandle.sendInput('exit\n');
+ *
+ * // Wait for completion
+ * const result = await ptyHandle.wait();
+ * console.log(`PTY exited with code: ${result.exitCode}`);
+ *
+ * // Clean up
+ * await ptyHandle.disconnect();
+ * ```
+ */
+export class PtyHandle {
+    ws;
+    handleResize;
+    handleKill;
+    onPty;
+    sessionId;
+    _exitCode;
+    _error;
+    connected = false;
+    connectionEstablished = false; // Track control message received
+    constructor(ws, handleResize, handleKill, onPty, sessionId) {
+        this.ws = ws;
+        this.handleResize = handleResize;
+        this.handleKill = handleKill;
+        this.onPty = onPty;
+        this.sessionId = sessionId;
+        this.setupWebSocketHandlers();
+    }
+    /**
+     * Exit code of the PTY process (if terminated)
+     */
+    get exitCode() {
+        return this._exitCode;
+    }
+    /**
+     * Error message if the PTY failed
+     */
+    get error() {
+        return this._error;
+    }
+    /**
+     * Check if connected to the PTY session
+     */
+    isConnected() {
+        return this.connected && this.ws.readyState === WebSocket.OPEN;
+    }
+    /**
+     * Wait for the WebSocket connection to be established.
+     *
+     * This method ensures the PTY session is ready to receive input and send output.
+     * It waits for the server to confirm the connection is established.
+     *
+     * @throws {Error} If connection times out (10 seconds) or connection fails
+     */
+    async waitForConnection() {
+        if (this.connectionEstablished) {
+            return;
+        }
+        return new Promise((resolve, reject) => {
+            const timeout = setTimeout(() => {
+                reject(new DaytonaError('PTY connection timeout'));
+            }, 10000); // 10 second timeout
+            const checkConnection = () => {
+                if (this.connectionEstablished) {
+                    clearTimeout(timeout);
+                    resolve();
+                }
+                else if (this.ws.readyState === WebSocket.CLOSED || this._error) {
+                    clearTimeout(timeout);
+                    reject(new DaytonaError(this._error || 'Connection failed'));
+                }
+                else {
+                    setTimeout(checkConnection, 100);
+                }
+            };
+            checkConnection();
+        });
+    }
+    /**
+     * Send input data to the PTY session.
+     *
+     * Sends keyboard input or commands to the terminal session. The data will be
+     * processed as if it was typed in the terminal.
+     *
+     * @param {string | Uint8Array} data - Input data to send (commands, keystrokes, etc.)
+     * @throws {Error} If PTY is not connected or sending fails
+     *
+     * @example
+     * // Send a command
+     * await ptyHandle.sendInput('ls -la\n');
+     *
+     * // Send raw bytes
+     * await ptyHandle.sendInput(new Uint8Array([3])); // Ctrl+C
+     */
+    async sendInput(data) {
+        if (!this.isConnected()) {
+            throw new DaytonaError('PTY is not connected');
+        }
+        try {
+            if (typeof data === 'string') {
+                this.ws.send(new TextEncoder().encode(data));
+            }
+            else {
+                this.ws.send(data);
+            }
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            throw new DaytonaError(`Failed to send input to PTY: ${errorMessage}`);
+        }
+    }
+    /**
+     * Resize the PTY terminal dimensions.
+     *
+     * Changes the terminal size which will notify terminal applications
+     * about the new dimensions via SIGWINCH signal.
+     *
+     * @param {number} cols - New number of terminal columns
+     * @param {number} rows - New number of terminal rows
+     *
+     * @example
+     * // Resize to 120x30
+     * await ptyHandle.resize(120, 30);
+     */
+    async resize(cols, rows) {
+        return await this.handleResize(cols, rows);
+    }
+    /**
+     * Disconnect from the PTY session and clean up resources.
+     *
+     * Closes the WebSocket connection and releases any associated resources.
+     * Should be called when done with the PTY session.
+     *
+     * @example
+     * // Always clean up when done
+     * try {
+     *   // ... use PTY session
+     * } finally {
+     *   await ptyHandle.disconnect();
+     * }
+     */
+    async disconnect() {
+        if (this.ws) {
+            try {
+                this.ws.close();
+            }
+            catch {
+                // Ignore close errors
+            }
+        }
+    }
+    /**
+     * Wait for the PTY process to exit and return the result.
+     *
+     * This method blocks until the PTY process terminates and returns
+     * information about how it exited.
+     *
+     * @returns {Promise<PtyResult>} Result containing exit code and error information
+     *
+     * @example
+     * // Wait for process to complete
+     * const result = await ptyHandle.wait();
+     *
+     * if (result.exitCode === 0) {
+     *   console.log('Process completed successfully');
+     * } else {
+     *   console.log(`Process failed with code: ${result.exitCode}`);
+     *   if (result.error) {
+     *     console.log(`Error: ${result.error}`);
+     *   }
+     * }
+     */
+    async wait() {
+        return new Promise((resolve, reject) => {
+            if (this._exitCode !== undefined) {
+                resolve({
+                    exitCode: this._exitCode,
+                    error: this._error,
+                });
+                return;
+            }
+            const checkExit = () => {
+                if (this._exitCode !== undefined) {
+                    resolve({
+                        exitCode: this._exitCode,
+                        error: this._error,
+                    });
+                }
+                else if (this._error) {
+                    reject(new DaytonaError(this._error));
+                }
+                else {
+                    setTimeout(checkExit, 100);
+                }
+            };
+            checkExit();
+        });
+    }
+    /**
+     * Kill the PTY process and terminate the session.
+     *
+     * Forcefully terminates the PTY session and its associated process.
+     * This operation is irreversible and will cause the PTY to exit immediately.
+     *
+     * @throws {Error} If the kill operation fails
+     *
+     * @example
+     * // Kill a long-running process
+     * await ptyHandle.kill();
+     *
+     * // Wait to confirm termination
+     * const result = await ptyHandle.wait();
+     * console.log(`Process terminated with exit code: ${result.exitCode}`);
+     */
+    async kill() {
+        return await this.handleKill();
+    }
+    setupWebSocketHandlers() {
+        // Set binary type for binary data handling
+        if ('binaryType' in this.ws) {
+            this.ws.binaryType = 'arraybuffer';
+        }
+        // Handle WebSocket open
+        const handleOpen = async () => {
+            this.connected = true;
+        };
+        // Handle WebSocket messages - control messages and PTY data
+        const handleMessage = async (event) => {
+            try {
+                const data = event && typeof event === 'object' && 'data' in event ? event.data : event;
+                if (typeof data === 'string') {
+                    // Try to parse as control message first
+                    try {
+                        const controlMsg = JSON.parse(data);
+                        if (controlMsg.type === 'control') {
+                            if (controlMsg.status === 'connected') {
+                                this.connectionEstablished = true;
+                                return;
+                            }
+                            else if (controlMsg.status === 'error') {
+                                this._error = controlMsg.error || 'Unknown connection error';
+                                this.connected = false;
+                                return;
+                            }
+                        }
+                    }
+                    catch {
+                        // Not a control message, treat as PTY output
+                    }
+                    // Regular PTY text output
+                    if (this.onPty) {
+                        await this.onPty(new TextEncoder().encode(data));
+                    }
+                }
+                else {
+                    // Handle binary data (terminal output)
+                    let bytes;
+                    if (data instanceof ArrayBuffer) {
+                        bytes = new Uint8Array(data);
+                    }
+                    else if (ArrayBuffer.isView(data)) {
+                        bytes = new Uint8Array(data.buffer, data.byteOffset, data.byteLength);
+                    }
+                    else if (data instanceof Blob) {
+                        const buffer = await data.arrayBuffer();
+                        bytes = new Uint8Array(buffer);
+                    }
+                    else {
+                        throw new DaytonaError(`Unsupported message data type: ${Object.prototype.toString.call(data)}`);
+                    }
+                    if (this.onPty) {
+                        await this.onPty(bytes);
+                    }
+                }
+            }
+            catch (error) {
+                const errorMessage = error instanceof Error ? error.message : String(error);
+                throw new DaytonaError(`Error handling PTY message: ${errorMessage}`);
+            }
+        };
+        // Handle WebSocket errors
+        const handleError = async (error) => {
+            let errorMessage;
+            if (error instanceof Error) {
+                errorMessage = error.message;
+            }
+            else if (error && error instanceof Event) {
+                errorMessage = 'WebSocket connection error';
+            }
+            else {
+                errorMessage = String(error);
+            }
+            this._error = errorMessage;
+            this.connected = false;
+        };
+        // Handle WebSocket close - parse structured exit data
+        const handleClose = async (event) => {
+            this.connected = false;
+            // Parse structured exit data from close reason
+            if (event && event.reason) {
+                try {
+                    const exitData = JSON.parse(event.reason);
+                    if (typeof exitData.exitCode === 'number') {
+                        this._exitCode = exitData.exitCode;
+                        // Store exit reason if provided (undefined for exitCode 0)
+                        if (exitData.exitReason) {
+                            this._error = exitData.exitReason;
+                        }
+                    }
+                    // Handle error messages from server (e.g., "PTY session not found")
+                    if (exitData.error) {
+                        this._error = exitData.error;
+                    }
+                }
+                catch {
+                    if (event.code === 1000) {
+                        this._exitCode = 0;
+                    }
+                }
+            }
+            // Default to exit code 0 if we can't parse it and it was a normal close
+            if (this._exitCode === undefined && event && event.code === 1000) {
+                this._exitCode = 0;
+            }
+        };
+        // Attach event listeners based on WebSocket implementation
+        if (this.ws.addEventListener) {
+            // Browser WebSocket
+            this.ws.addEventListener('open', handleOpen);
+            this.ws.addEventListener('message', handleMessage);
+            this.ws.addEventListener('error', handleError);
+            this.ws.addEventListener('close', handleClose);
+        }
+        else if ('on' in this.ws && typeof this.ws.on === 'function') {
+            // Node.js WebSocket
+            this.ws.on('open', handleOpen);
+            this.ws.on('message', handleMessage);
+            this.ws.on('error', handleError);
+            this.ws.on('close', handleClose);
+        }
+        else {
+            throw new DaytonaError('Unsupported WebSocket implementation');
+        }
+    }
+}
+//# sourceMappingURL=PtyHandle.js.map

package/esm/PtyHandle.js.map

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

package/esm/README.md

@@ -0,0 +1,147 @@
+# Daytona SDK for TypeScript
+
+A TypeScript SDK for interacting with the Daytona API, providing a simple interface for Daytona Sandbox management, Git operations, file system operations, and language server protocol support.
+
+## Installation
+
+You can install the package using npm:
+
+```bash
+npm install @daytonaio/sdk
+```
+
+Or using yarn:
+
+```bash
+yarn add @daytonaio/sdk
+```
+
+## Quick Start
+
+Here's a simple example of using the SDK:
+
+```typescript
+import { Daytona } from '@daytonaio/sdk'
+
+// Initialize using environment variables
+const daytona = new Daytona()
+
+// Create a sandbox
+const sandbox = await daytona.create()
+
+// Run code in the sandbox
+const response = await sandbox.process.codeRun('console.log("Hello World!")')
+console.log(response.result)
+
+// Clean up when done
+await daytona.delete(sandbox)
+```
+
+## Configuration
+
+The SDK can be configured using environment variables or by passing a configuration object:
+
+```typescript
+import { Daytona } from '@daytonaio/sdk'
+
+// Initialize with configuration
+const daytona = new Daytona({
+  apiKey: 'your-api-key',
+  apiUrl: 'your-api-url',
+  target: 'us',
+})
+```
+
+Or using environment variables:
+
+- `DAYTONA_API_KEY`: Your Daytona API key
+- `DAYTONA_API_URL`: The Daytona API URL
+- `DAYTONA_TARGET`: Your target environment
+
+You can also customize sandbox creation:
+
+```typescript
+const sandbox = await daytona.create({
+  language: 'typescript',
+  envVars: { NODE_ENV: 'development' },
+  autoStopInterval: 60, // Auto-stop after 1 hour of inactivity,
+  autoArchiveInterval: 60, // Auto-archive after a Sandbox has been stopped for 1 hour
+  autoDeleteInterval: 120, // Auto-delete after a Sandbox has been stopped for 2 hours
+})
+```
+
+## Features
+
+- **Sandbox Management**: Create, manage and remove sandboxes
+- **Git Operations**: Clone repositories, manage branches, and more
+- **File System Operations**: Upload, download, search and manipulate files
+- **Language Server Protocol**: Interact with language servers for code intelligence
+- **Process Management**: Execute code and commands in sandboxes
+
+## Examples
+
+### Execute Commands
+
+```typescript
+// Execute a shell command
+const response = await sandbox.process.executeCommand('echo "Hello, World!"')
+console.log(response.result)
+
+// Run TypeScript code
+const response = await sandbox.process.codeRun(`
+const x = 10
+const y = 20
+console.log(\`Sum: \${x + y}\`)
+`)
+console.log(response.result)
+```
+
+### File Operations
+
+```typescript
+// Upload a file
+await sandbox.fs.uploadFile(Buffer.from('Hello, World!'), 'path/to/file.txt')
+
+// Download a file
+const content = await sandbox.fs.downloadFile('path/to/file.txt')
+
+// Search for files
+const matches = await sandbox.fs.findFiles(root_dir, 'search_pattern')
+```
+
+### Git Operations
+
+```typescript
+// Clone a repository
+await sandbox.git.clone('https://github.com/example/repo', 'path/to/clone')
+
+// List branches
+const branches = await sandbox.git.branches('path/to/repo')
+
+// Add files
+await sandbox.git.add('path/to/repo', ['file1.txt', 'file2.txt'])
+```
+
+### Language Server Protocol
+
+```typescript
+// Create and start a language server
+const lsp = await sandbox.createLspServer('typescript', 'path/to/project')
+await lsp.start()
+
+// Notify the lsp for the file
+await lsp.didOpen('path/to/file.ts')
+
+// Get document symbols
+const symbols = await lsp.documentSymbols('path/to/file.ts')
+
+// Get completions
+const completions = await lsp.completions('path/to/file.ts', {
+  line: 10,
+  character: 15,
+})
+```
+
+## Contributing
+
+Daytona is Open Source under the [Apache License 2.0](/libs/sdk-typescript//LICENSE), and is the [copyright of its contributors](/NOTICE). If you would like to contribute to the software, read the Developer Certificate of Origin Version 1.1 (https://developercertificate.org/). Afterwards, navigate to the [contributing guide](/CONTRIBUTING.md) to get started.