@daytonaio/sdk 0.11.2 → 0.11.3

package/README.md

@@ -1,6 +1,6 @@
 # Daytona SDK for TypeScript
 
-A TypeScript SDK for interacting with Daytona Server API, providing a simple interface for Daytona Sandbox management, Git operations, file system operations, and language server protocol support.
+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
 
@@ -47,7 +47,7 @@ import { Daytona } from '@daytonaio/sdk'
 // Initialize with configuration
 const daytona = new Daytona({
   apiKey: 'your-api-key',
-  serverUrl: 'your-server-url',
+  apiUrl: 'your-api-url',
   target: 'us',
 })
 ```
@@ -55,7 +55,7 @@ const daytona = new Daytona({
 Or using environment variables:
 
 - `DAYTONA_API_KEY`: Your Daytona API key
-- `DAYTONA_SERVER_URL`: The Daytona server URL
+- `DAYTONA_API_URL`: The Daytona API URL
 - `DAYTONA_TARGET`: Your target environment
 
 You can also customize sandbox creation:

package/dist/Daytona.d.ts

@@ -1,72 +1,31 @@
-/**
- * Sandboxes are isolated development environments managed by Daytona.
- * This guide covers how to create, manage, and remove Sandboxes using the SDK.
- *
- * @module Daytona
- *
- * @example
- * // Initialize using environment variables (DAYTONA_API_KEY, DAYTONA_SERVER_URL, DAYTONA_TARGET)
- * const daytona = new Daytona();
- *
- * // Create and use a sandbox
- * const sandbox = await daytona.create({
- *     language: 'typescript',
- *     envVars: { NODE_ENV: 'development' }
- * });
- *
- * // Execute commands in the sandbox
- * const response = await sandbox.process.executeCommand('echo "Hello, World!"');
- * console.log(response.result);
- *
- * // Execute code in the sandbox
- * const response = await sandbox.process.codeRun('console.log("Hello, World!")');
- * console.log(response.result);
- *
- * @example
- * // Initialize with explicit configuration
- * const daytona = new Daytona({
- *     apiKey: process.env.CUSTOM_API_KEY,
- *     serverUrl: 'https://daytona.example.com',
- *     target: 'us'
- * });
- *
- * // Create a custom sandbox
- * const sandbox = await daytona.create({
- *     language: 'typescript',
- *     image: 'node:18',
- *     resources: {
- *         cpu: 2,
- *         memory: 4 // 4GB RAM
- *     },
- *     autoStopInterval: 60 // Auto-stop after 1 hour of inactivity
- * });
- *
- * // Use sandbox features
- * await sandbox.git.clone('https://github.com/user/repo.git');
- * await sandbox.process.executeCommand('npm test');
- */
 import { Sandbox, Sandbox as Workspace } from './Sandbox';
 import { CreateWorkspaceTargetEnum as SandboxTargetRegion } from '@daytonaio/api-client';
 /**
  * Configuration options for initializing the Daytona client.
  *
  * @interface
- * @property {string} apiKey - API key for authentication with Daytona server
- * @property {string} serverUrl - URL of the Daytona server
+ * @property {string} apiKey - API key for authentication with the Daytona API
+ * @property {string} apiUrl - URL of the Daytona API. Defaults to 'https://app.daytona.io/api'
+ * if not set here and not set in environment variable DAYTONA_API_URL.
  * @property {CreateSandboxTargetEnum} target - Target location for Sandboxes
  *
  * @example
  * const config: DaytonaConfig = {
  *     apiKey: "your-api-key",
- *     serverUrl: "https://your-server.com",
+ *     apiUrl: "https://your-api.com",
  *     target: "us"
  * };
  * const daytona = new Daytona(config);
  */
 export interface DaytonaConfig {
-    /** API key for authentication with Daytona server */
+    /** API key for authentication with the Daytona API */
     apiKey?: string;
-    /** URL of the Daytona server */
+    /** URL of the Daytona API.
+     */
+    apiUrl?: string;
+    /**
+     * @deprecated Use `apiUrl` instead. This property will be removed in future versions.
+     */
     serverUrl?: string;
     /** Target environment for sandboxes */
     target?: SandboxTargetRegion;
@@ -112,11 +71,11 @@ export interface SandboxResources {
  * @property {string} [id] - Optional Sandbox ID. If not provided, a random ID will be generated
  * @property {string} [image] - Optional Docker image to use for the Sandbox
  * @property {string} [user] - Optional os user to use for the Sandbox
- * @property {CodeLanguage} [language] - Programming language for direct code execution
+ * @property {CodeLanguage | string} [language] - Programming language for direct code execution
  * @property {Record<string, string>} [envVars] - Optional environment variables to set in the Sandbox
  * @property {Record<string, string>} [labels] - Sandbox labels
  * @property {boolean} [public] - Is the Sandbox port preview public
- * @property {string} [target] - Target location for the Sandbox
+ * @property {SandboxTargetRegion | string} [target] - Target location for the Sandbox
  * @property {SandboxResources} [resources] - Resource allocation for the Sandbox
  * @property {boolean} [async] - If true, will not wait for the Sandbox to be ready before returning
  * @property {number} [timeout] - Timeout in seconds for the Sandbox to be ready (0 means no timeout)
@@ -164,7 +123,7 @@ export type CreateSandboxParams = {
     autoStopInterval?: number;
 };
 /**
- * Main class for interacting with Daytona Server API.
+ * Main class for interacting with the Daytona API.
  *
  * Provides methods for creating, managing, and interacting with Daytona Sandboxes.
  * Can be initialized either with explicit configuration or using environment variables.
@@ -172,7 +131,7 @@ export type CreateSandboxParams = {
  *
  * @example
  * // Using environment variables
- * // Uses DAYTONA_API_KEY, DAYTONA_SERVER_URL, DAYTONA_TARGET
+ * // Uses DAYTONA_API_KEY, DAYTONA_API_URL, DAYTONA_TARGET
  * const daytona = new Daytona();
  * const sandbox = await daytona.create();
  *
@@ -180,7 +139,7 @@ export type CreateSandboxParams = {
  * // Using explicit configuration
  * const config: DaytonaConfig = {
  *     apiKey: "your-api-key",
- *     serverUrl: "https://your-server.com",
+ *     apiUrl: "https://your-api.com",
  *     target: "us"
  * };
  * const daytona = new Daytona(config);
@@ -192,12 +151,12 @@ export declare class Daytona {
     private readonly toolboxApi;
     private readonly target;
     private readonly apiKey;
-    private readonly serverUrl;
+    private readonly apiUrl;
     /**
      * Creates a new Daytona client instance.
      *
      * @param {DaytonaConfig} [config] - Configuration options
-     * @throws {DaytonaError} - `DaytonaError` - When API key or server URL is missing
+     * @throws {DaytonaError} - `DaytonaError` - When API key is missing
      */
     constructor(config?: DaytonaConfig);
     /**

package/dist/Daytona.js

@@ -1,51 +1,4 @@
 "use strict";
-/**
- * Sandboxes are isolated development environments managed by Daytona.
- * This guide covers how to create, manage, and remove Sandboxes using the SDK.
- *
- * @module Daytona
- *
- * @example
- * // Initialize using environment variables (DAYTONA_API_KEY, DAYTONA_SERVER_URL, DAYTONA_TARGET)
- * const daytona = new Daytona();
- *
- * // Create and use a sandbox
- * const sandbox = await daytona.create({
- *     language: 'typescript',
- *     envVars: { NODE_ENV: 'development' }
- * });
- *
- * // Execute commands in the sandbox
- * const response = await sandbox.process.executeCommand('echo "Hello, World!"');
- * console.log(response.result);
- *
- * // Execute code in the sandbox
- * const response = await sandbox.process.codeRun('console.log("Hello, World!")');
- * console.log(response.result);
- *
- * @example
- * // Initialize with explicit configuration
- * const daytona = new Daytona({
- *     apiKey: process.env.CUSTOM_API_KEY,
- *     serverUrl: 'https://daytona.example.com',
- *     target: 'us'
- * });
- *
- * // Create a custom sandbox
- * const sandbox = await daytona.create({
- *     language: 'typescript',
- *     image: 'node:18',
- *     resources: {
- *         cpu: 2,
- *         memory: 4 // 4GB RAM
- *     },
- *     autoStopInterval: 60 // Auto-stop after 1 hour of inactivity
- * });
- *
- * // Use sandbox features
- * await sandbox.git.clone('https://github.com/user/repo.git');
- * await sandbox.process.executeCommand('npm test');
- */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     var desc = Object.getOwnPropertyDescriptor(m, k);
@@ -101,7 +54,7 @@ var CodeLanguage;
     CodeLanguage["JAVASCRIPT"] = "javascript";
 })(CodeLanguage || (exports.CodeLanguage = CodeLanguage = {}));
 /**
- * Main class for interacting with Daytona Server API.
+ * Main class for interacting with the Daytona API.
  *
  * Provides methods for creating, managing, and interacting with Daytona Sandboxes.
  * Can be initialized either with explicit configuration or using environment variables.
@@ -109,7 +62,7 @@ var CodeLanguage;
  *
  * @example
  * // Using environment variables
- * // Uses DAYTONA_API_KEY, DAYTONA_SERVER_URL, DAYTONA_TARGET
+ * // Uses DAYTONA_API_KEY, DAYTONA_API_URL, DAYTONA_TARGET
  * const daytona = new Daytona();
  * const sandbox = await daytona.create();
  *
@@ -117,7 +70,7 @@ var CodeLanguage;
  * // Using explicit configuration
  * const config: DaytonaConfig = {
  *     apiKey: "your-api-key",
- *     serverUrl: "https://your-server.com",
+ *     apiUrl: "https://your-api.com",
  *     target: "us"
  * };
  * const daytona = new Daytona(config);
@@ -129,7 +82,7 @@ class Daytona {
      * Creates a new Daytona client instance.
      *
      * @param {DaytonaConfig} [config] - Configuration options
-     * @throws {DaytonaError} - `DaytonaError` - When API key or server URL is missing
+     * @throws {DaytonaError} - `DaytonaError` - When API key is missing
      */
     constructor(config) {
         dotenv_1.default.config();
@@ -138,14 +91,21 @@ class Daytona {
         if (!apiKey) {
             throw new DaytonaError_1.DaytonaError('API key is required');
         }
-        const serverUrl = (config === null || config === void 0 ? void 0 : config.serverUrl) || process.env.DAYTONA_SERVER_URL || 'https://app.daytona.io/api';
+        const apiUrl = (config === null || config === void 0 ? void 0 : config.apiUrl) ||
+            (config === null || config === void 0 ? void 0 : config.serverUrl) ||
+            process.env.DAYTONA_API_URL ||
+            process.env.DAYTONA_SERVER_URL ||
+            'https://app.daytona.io/api';
         const envTarget = process.env.DAYTONA_TARGET;
         const target = (config === null || config === void 0 ? void 0 : config.target) || envTarget || api_client_1.CreateWorkspaceTargetEnum.US;
+        if (process.env.DAYTONA_SERVER_URL && !process.env.DAYTONA_API_URL) {
+            console.warn('[Deprecation Warning] Environment variable `DAYTONA_SERVER_URL` is deprecated and will be removed in future versions. Use `DAYTONA_API_URL` instead.');
+        }
         this.apiKey = apiKey;
-        this.serverUrl = serverUrl;
+        this.apiUrl = apiUrl;
         this.target = target;
         const configuration = new api_client_1.Configuration({
-            basePath: this.serverUrl,
+            basePath: this.apiUrl,
             baseOptions: {
                 headers: {
                     Authorization: `Bearer ${this.apiKey}`,

package/dist/FileSystem.d.ts

@@ -1,72 +1,9 @@
-/**
- * The Daytona SDK provides comprehensive file system operations through the `fs` module in Sandboxes.
- * You can perform various operations like listing files, creating directories, reading and writing files, and more.
- * This guide covers all available file system operations and best practices.
- *
- * @module FileSystem
- *
- * @example
- * // Basic file operations
- * // Create a sandbox
- * const sandbox = await daytona.create();
- *
- * // Create a directory
- * await sandbox.fs.createFolder('/workspace/data', '755');
- *
- * // Upload a file
- * const fileContent = new File(['content'], 'local_file.txt');
- * await sandbox.fs.uploadFile('/workspace/data/file.txt', fileContent);
- *
- * // List directory contents
- * const files = await sandbox.fs.listFiles('/workspace');
- * files.forEach(file => {
- *   console.log(`Name: ${file.name}`);
- *   console.log(`Is directory: ${file.isDir}`);
- *   console.log(`Size: ${file.size}`);
- *   console.log(`Modified: ${file.modTime}`);
- * });
- *
- * // Search file contents
- * const matches = await sandbox.fs.findFiles(
- *   '/workspace/src',
- *   'text-of-interest'
- * );
- * matches.forEach(match => {
- *   console.log(`Absolute file path: ${match.file}`);
- *   console.log(`Line number: ${match.line}`);
- *   console.log(`Line content: ${match.content}\n`);
- * });
- *
- * @example
- * // File manipulation
- * // Move files
- * await sandbox.fs.moveFiles(
- *   '/workspace/data/old.txt',
- *   '/workspace/data/new.txt'
- * );
- *
- * // Replace text in files
- * const results = await sandbox.fs.replaceInFiles(
- *   ['/workspace/data/new.txt'],
- *   'old_version',
- *   'new_version'
- * );
- *
- * // Set permissions
- * await sandbox.fs.setFilePermissions(
- *   '/workspace/data/script.sh',
- *   {
- *     mode: '755',
- *     owner: 'daytona'
- *   }
- * );
- */
 import { FileInfo, Match, ReplaceResult, SearchFilesResponse, ToolboxApi } from '@daytonaio/api-client';
 import { SandboxInstance } from './Sandbox';
 /**
  * Parameters for setting file permissions in the Sandbox.
  *
- * @interface FilePermissionsParams
+ * @interface
  * @property {string} [mode] - File mode/permissions in octal format (e.g. "644")
  * @property {string} [owner] - User owner of the file
  * @property {string} [group] - Group owner of the file
@@ -89,10 +26,7 @@ export type FilePermissionsParams = {
 /**
  * Provides file system operations within a Sandbox.
  *
- * This class implements a high-level interface to file system operations that can
- * be performed within a Daytona Sandbox. It supports common operations like
- * creating, deleting, and moving files, as well as searching file contents and
- * managing permissions.
+ * @class
  */
 export declare class FileSystem {
     private readonly instance;

package/dist/FileSystem.js

@@ -1,76 +1,10 @@
 "use strict";
-/**
- * The Daytona SDK provides comprehensive file system operations through the `fs` module in Sandboxes.
- * You can perform various operations like listing files, creating directories, reading and writing files, and more.
- * This guide covers all available file system operations and best practices.
- *
- * @module FileSystem
- *
- * @example
- * // Basic file operations
- * // Create a sandbox
- * const sandbox = await daytona.create();
- *
- * // Create a directory
- * await sandbox.fs.createFolder('/workspace/data', '755');
- *
- * // Upload a file
- * const fileContent = new File(['content'], 'local_file.txt');
- * await sandbox.fs.uploadFile('/workspace/data/file.txt', fileContent);
- *
- * // List directory contents
- * const files = await sandbox.fs.listFiles('/workspace');
- * files.forEach(file => {
- *   console.log(`Name: ${file.name}`);
- *   console.log(`Is directory: ${file.isDir}`);
- *   console.log(`Size: ${file.size}`);
- *   console.log(`Modified: ${file.modTime}`);
- * });
- *
- * // Search file contents
- * const matches = await sandbox.fs.findFiles(
- *   '/workspace/src',
- *   'text-of-interest'
- * );
- * matches.forEach(match => {
- *   console.log(`Absolute file path: ${match.file}`);
- *   console.log(`Line number: ${match.line}`);
- *   console.log(`Line content: ${match.content}\n`);
- * });
- *
- * @example
- * // File manipulation
- * // Move files
- * await sandbox.fs.moveFiles(
- *   '/workspace/data/old.txt',
- *   '/workspace/data/new.txt'
- * );
- *
- * // Replace text in files
- * const results = await sandbox.fs.replaceInFiles(
- *   ['/workspace/data/new.txt'],
- *   'old_version',
- *   'new_version'
- * );
- *
- * // Set permissions
- * await sandbox.fs.setFilePermissions(
- *   '/workspace/data/script.sh',
- *   {
- *     mode: '755',
- *     owner: 'daytona'
- *   }
- * );
- */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.FileSystem = void 0;
 /**
  * Provides file system operations within a Sandbox.
  *
- * This class implements a high-level interface to file system operations that can
- * be performed within a Daytona Sandbox. It supports common operations like
- * creating, deleting, and moving files, as well as searching file contents and
- * managing permissions.
+ * @class
  */
 class FileSystem {
     constructor(instance, toolboxApi) {

package/dist/Git.d.ts

@@ -1,56 +1,26 @@
+import { ToolboxApi, ListBranchResponse, GitStatus } from '@daytonaio/api-client';
+import { Sandbox, SandboxInstance } from './Sandbox';
 /**
- * The Daytona SDK provides built-in Git support. This guide covers all available Git
- * operations and best practices. Daytona SDK provides an option to clone, check status,
- * and manage Git repositories in Sandboxes. You can interact with Git repositories using
- * the `git` module.
- *
- * @module Git
- *
- * @example
- * // Basic Git workflow
- * // Create and initialize sandbox
- * const sandbox = await daytona.create();
- *
- * // Clone a repository
- * await sandbox.git.clone(
- *   'https://github.com/user/repo.git',
- *   '/workspace/repo'
- * );
+ * Response from the git commit.
  *
- * // Make some changes
- * await sandbox.fs.uploadFile(
- *   '/workspace/repo/test.txt',
- *   new File([Buffer.from('Hello, World!')], 'test.txt')
- * );
- *
- * // Stage and commit changes
- * await sandbox.git.add('/workspace/repo', ['test.txt']);
- * await sandbox.git.commit(
- *   '/workspace/repo',
- *   'Add test file',
- *   'John Doe',
- *   'john@example.com'
- * );
- *
- * // Push changes (with authentication)
- * await sandbox.git.push(
- *   '/workspace/repo',
- *   'user',
- *   'token'
- * );
+ * @interface
+ * @property {string} sha - The SHA of the commit
+ */
+export interface GitCommitResponse {
+    sha: string;
+}
+/**
+ * Provides Git operations within a Sandbox.
  *
+ * @class
  */
-import { ToolboxApi, ListBranchResponse, GitStatus } from '@daytonaio/api-client';
-import { Sandbox, SandboxInstance } from './Sandbox';
 export declare class Git {
     private readonly sandbox;
     private readonly toolboxApi;
     private readonly instance;
     constructor(sandbox: Sandbox, toolboxApi: ToolboxApi, instance: SandboxInstance);
     /**
-     * Stages files for commit.
-     *
-     * This method stages the specified files for the next commit, similar to
+     * Stages the specified files for the next commit, similar to
      * running 'git add' on the command line.
      *
      * @param {string} path - Absolute path to the Git repository root
@@ -69,8 +39,6 @@ export declare class Git {
     /**
      * List branches in the repository.
      *
-     * This method returns information about all branches in the repository.
-     *
      * @param {string} path - Absolute path to the Git repository root
      * @returns {Promise<ListBranchResponse>} List of branches in the repository
      *
@@ -80,9 +48,7 @@ export declare class Git {
      */
     branches(path: string): Promise<ListBranchResponse>;
     /**
-     * Clones a Git repository.
-     *
-     * This method clones a Git repository into the specified path. It supports
+     * Clones a Git repository into the specified path. It supports
      * cloning specific branches or commits, and can authenticate with the remote
      * repository if credentials are provided.
      *
@@ -123,9 +89,6 @@ export declare class Git {
     /**
      * Commits staged changes.
      *
-     * This method creates a new commit with the staged changes. Make sure to stage
-     * changes using the add() method before committing.
-     *
      * @param {string} path - Absolute path to the Git repository root
      * @param {string} message - Commit message describing the changes
      * @param {string} author - Name of the commit author
@@ -142,13 +105,10 @@ export declare class Git {
      *   'john@example.com'
      * );
      */
-    commit(path: string, message: string, author: string, email: string): Promise<void>;
+    commit(path: string, message: string, author: string, email: string): Promise<GitCommitResponse>;
     /**
      * Push local changes to the remote repository.
      *
-     * This method pushes committed changes to the remote repository. If the remote
-     * requires authentication, username and password/token must be provided.
-     *
      * @param {string} path - Absolute path to the Git repository root
      * @param {string} [username] - Git username for authentication
      * @param {string} [password] - Git password or token for authentication
@@ -170,9 +130,6 @@ export declare class Git {
     /**
      * Pulls changes from the remote repository.
      *
-     * This method fetches and merges changes from the remote repository. If the remote
-     * requires authentication, username and password/token must be provided.
-     *
      * @param {string} path - Absolute path to the Git repository root
      * @param {string} [username] - Git username for authentication
      * @param {string} [password] - Git password or token for authentication
@@ -194,9 +151,6 @@ export declare class Git {
     /**
      * Gets the current status of the Git repository.
      *
-     * This method returns information about the current state of the repository,
-     * including staged and unstaged changes, current branch, and untracked files.
-     *
      * @param {string} path - Absolute path to the Git repository root
      * @returns {Promise<GitStatus>} Current repository status including:
      *                               - currentBranch: Name of the current branch

package/dist/Git.js

@@ -1,48 +1,11 @@
 "use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Git = void 0;
 /**
- * The Daytona SDK provides built-in Git support. This guide covers all available Git
- * operations and best practices. Daytona SDK provides an option to clone, check status,
- * and manage Git repositories in Sandboxes. You can interact with Git repositories using
- * the `git` module.
- *
- * @module Git
- *
- * @example
- * // Basic Git workflow
- * // Create and initialize sandbox
- * const sandbox = await daytona.create();
- *
- * // Clone a repository
- * await sandbox.git.clone(
- *   'https://github.com/user/repo.git',
- *   '/workspace/repo'
- * );
- *
- * // Make some changes
- * await sandbox.fs.uploadFile(
- *   '/workspace/repo/test.txt',
- *   new File([Buffer.from('Hello, World!')], 'test.txt')
- * );
- *
- * // Stage and commit changes
- * await sandbox.git.add('/workspace/repo', ['test.txt']);
- * await sandbox.git.commit(
- *   '/workspace/repo',
- *   'Add test file',
- *   'John Doe',
- *   'john@example.com'
- * );
- *
- * // Push changes (with authentication)
- * await sandbox.git.push(
- *   '/workspace/repo',
- *   'user',
- *   'token'
- * );
+ * Provides Git operations within a Sandbox.
  *
+ * @class
  */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Git = void 0;
 class Git {
     constructor(sandbox, toolboxApi, instance) {
         this.sandbox = sandbox;
@@ -50,9 +13,7 @@ class Git {
         this.instance = instance;
     }
     /**
-     * Stages files for commit.
-     *
-     * This method stages the specified files for the next commit, similar to
+     * Stages the specified files for the next commit, similar to
      * running 'git add' on the command line.
      *
      * @param {string} path - Absolute path to the Git repository root
@@ -76,8 +37,6 @@ class Git {
     /**
      * List branches in the repository.
      *
-     * This method returns information about all branches in the repository.
-     *
      * @param {string} path - Absolute path to the Git repository root
      * @returns {Promise<ListBranchResponse>} List of branches in the repository
      *
@@ -90,9 +49,7 @@ class Git {
         return response.data;
     }
     /**
-     * Clones a Git repository.
-     *
-     * This method clones a Git repository into the specified path. It supports
+     * Clones a Git repository into the specified path. It supports
      * cloning specific branches or commits, and can authenticate with the remote
      * repository if credentials are provided.
      *
@@ -142,9 +99,6 @@ class Git {
     /**
      * Commits staged changes.
      *
-     * This method creates a new commit with the staged changes. Make sure to stage
-     * changes using the add() method before committing.
-     *
      * @param {string} path - Absolute path to the Git repository root
      * @param {string} message - Commit message describing the changes
      * @param {string} author - Name of the commit author
@@ -162,19 +116,19 @@ class Git {
      * );
      */
     async commit(path, message, author, email) {
-        await this.toolboxApi.gitCommitChanges(this.instance.id, {
+        const response = await this.toolboxApi.gitCommitChanges(this.instance.id, {
             path,
             message,
             author,
             email,
         });
+        return {
+            sha: response.data.hash,
+        };
     }
     /**
      * Push local changes to the remote repository.
      *
-     * This method pushes committed changes to the remote repository. If the remote
-     * requires authentication, username and password/token must be provided.
-     *
      * @param {string} path - Absolute path to the Git repository root
      * @param {string} [username] - Git username for authentication
      * @param {string} [password] - Git password or token for authentication
@@ -202,9 +156,6 @@ class Git {
     /**
      * Pulls changes from the remote repository.
      *
-     * This method fetches and merges changes from the remote repository. If the remote
-     * requires authentication, username and password/token must be provided.
-     *
      * @param {string} path - Absolute path to the Git repository root
      * @param {string} [username] - Git username for authentication
      * @param {string} [password] - Git password or token for authentication
@@ -232,9 +183,6 @@ class Git {
     /**
      * Gets the current status of the Git repository.
      *
-     * This method returns information about the current state of the repository,
-     * including staged and unstaged changes, current branch, and untracked files.
-     *
      * @param {string} path - Absolute path to the Git repository root
      * @returns {Promise<GitStatus>} Current repository status including:
      *                               - currentBranch: Name of the current branch

package/dist/LspServer.d.ts

@@ -1,42 +1,3 @@
-/**
- * The Daytona SDK provides Language Server Protocol (LSP) support through Sandbox instances.
- * This enables advanced language features like code completion, diagnostics, and more.
- *
- * The LSP server must be started with start() before using any other methods,
- * and should be stopped with stop() when no longer needed to free resources.
- *
- * @module LspServer
- *
- * @example
- * // Basic LSP server usage
- * // Create and initialize sandbox
- * const sandbox = await daytona.create();
- *
- * // Create and start LSP server
- * const lsp = sandbox.createLspServer('typescript', '/workspace/project');
- * await lsp.start();
- *
- * // Open a file for editing
- * await lsp.didOpen('/workspace/project/src/index.ts');
- *
- * // Get completions at a position
- * const completions = await lsp.completions(
- *   '/workspace/project/src/index.ts',
- *   { line: 10, character: 15 }
- * );
- * console.log('Completions:', completions);
- *
- * // Get document symbols
- * const symbols = await lsp.documentSymbols('/workspace/project/src/index.ts');
- * symbols.forEach(symbol => {
- *   console.log(`${symbol.name}: ${symbol.kind}`);
- * });
- *
- * // Clean up
- * await lsp.didClose('/workspace/project/src/index.ts');
- * await lsp.stop();
- *
- */
 import { CompletionList, LspSymbol, ToolboxApi } from '@daytonaio/api-client';
 import { SandboxInstance } from './Sandbox';
 /**
@@ -48,12 +9,10 @@ export declare enum LspLanguageId {
     JAVASCRIPT = "javascript"
 }
 /**
- * Represents a position in a text document.
- *
- * This interface represents a zero-based position within a text document,
+ * Represents a zero-based position within a text document,
  * specified by line number and character offset.
  *
- * @interface Position
+ * @interface
  * @property {number} line - Zero-based line number in the document
  * @property {number} character - Zero-based character offset on the line
  *
@@ -70,17 +29,15 @@ export type Position = {
     character: number;
 };
 /**
- * Provides Language Server Protocol functionality for code intelligence.
- *
- * This class implements a subset of the Language Server Protocol (LSP) to provide
+ * Provides Language Server Protocol functionality for code intelligence to provide
  * IDE-like features such as code completion, symbol search, and more.
  *
- * @class LspServer
- *
  * @property {LspLanguageId} languageId - The language server type (e.g., "typescript")
  * @property {string} pathToProject - Absolute path to the project root directory
  * @property {ToolboxApi} toolboxApi - API client for Sandbox operations
  * @property {SandboxInstance} instance - The Sandbox instance this server belongs to
+ *
+ * @class
  */
 export declare class LspServer {
     private readonly languageId;
@@ -89,9 +46,7 @@ export declare class LspServer {
     private readonly instance;
     constructor(languageId: LspLanguageId, pathToProject: string, toolboxApi: ToolboxApi, instance: SandboxInstance);
     /**
-     * Starts the language server.
-     *
-     * This method must be called before using any other LSP functionality.
+     * Starts the language server, must be called before using any other LSP functionality.
      * It initializes the language server for the specified language and project.
      *
      * @returns {Promise<void>}
@@ -103,9 +58,7 @@ export declare class LspServer {
      */
     start(): Promise<void>;
     /**
-     * Stops the language server.
-     *
-     * This method should be called when the LSP server is no longer needed to
+     * Stops the language server, should be called when the LSP server is no longer needed to
      * free up system resources.
      *
      * @returns {Promise<void>}
@@ -116,9 +69,7 @@ export declare class LspServer {
      */
     stop(): Promise<void>;
     /**
-     * Notifies the language server that a file has been opened.
-     *
-     * This method should be called when a file is opened in the editor to enable
+     * Notifies the language server that a file has been opened, enabling
      * language features like diagnostics and completions for that file. The server
      * will begin tracking the file's contents and providing language features.
      *
@@ -132,10 +83,8 @@ export declare class LspServer {
      */
     didOpen(path: string): Promise<void>;
     /**
-     * Notifies the language server that a file has been closed.
-     *
-     * This method should be called when a file is closed in the editor to allow
-     * the language server to clean up any resources associated with that file.
+     * Notifies the language server that a file has been closed, should be called when a file is closed
+     * in the editor to allow the language server to clean up any resources associated with that file.
      *
      * @param {string} path - Absolute path to the closed file
      * @returns {Promise<void>}
@@ -146,10 +95,7 @@ export declare class LspServer {
      */
     didClose(path: string): Promise<void>;
     /**
-     * Get symbol information from a document.
-     *
-     * This method returns information about all symbols (functions, classes,
-     * variables, etc.) defined in the specified document.
+     * Get symbol information (functions, classes, variables, etc.) from a document.
      *
      * @param {string} path - Absolute path to the file to get symbols from
      * @returns {Promise<LspSymbol[]>} List of symbols in the document. Each symbol includes:
@@ -166,11 +112,7 @@ export declare class LspServer {
      */
     documentSymbols(path: string): Promise<LspSymbol[]>;
     /**
-     * Searches for symbols across the entire Sandbox.
-     *
-     * This method searches for symbols matching the query string across all files
-     * in the Sandbox. It's useful for finding declarations and definitions
-     * without knowing which file they're in.
+     * Searches for symbols matching the query string across the entire Sandbox.
      *
      * @param {string} query - Search query to match against symbol names
      * @returns {Promise<LspSymbol[]>} List of matching symbols from all files. Each symbol includes:
@@ -182,11 +124,7 @@ export declare class LspServer {
      */
     workspaceSymbols(query: string): Promise<LspSymbol[]>;
     /**
-     * Searches for symbols across the entire Sandbox.
-     *
-     * This method searches for symbols matching the query string across all files
-     * in the Sandbox. It's useful for finding declarations and definitions
-     * without knowing which file they're in.
+     * Searches for symbols matching the query string across the entire Sandbox.
      *
      * @param {string} query - Search query to match against symbol names
      * @returns {Promise<LspSymbol[]>} List of matching symbols from all files. Each symbol includes:

package/dist/LspServer.js

@@ -1,43 +1,4 @@
 "use strict";
-/**
- * The Daytona SDK provides Language Server Protocol (LSP) support through Sandbox instances.
- * This enables advanced language features like code completion, diagnostics, and more.
- *
- * The LSP server must be started with start() before using any other methods,
- * and should be stopped with stop() when no longer needed to free resources.
- *
- * @module LspServer
- *
- * @example
- * // Basic LSP server usage
- * // Create and initialize sandbox
- * const sandbox = await daytona.create();
- *
- * // Create and start LSP server
- * const lsp = sandbox.createLspServer('typescript', '/workspace/project');
- * await lsp.start();
- *
- * // Open a file for editing
- * await lsp.didOpen('/workspace/project/src/index.ts');
- *
- * // Get completions at a position
- * const completions = await lsp.completions(
- *   '/workspace/project/src/index.ts',
- *   { line: 10, character: 15 }
- * );
- * console.log('Completions:', completions);
- *
- * // Get document symbols
- * const symbols = await lsp.documentSymbols('/workspace/project/src/index.ts');
- * symbols.forEach(symbol => {
- *   console.log(`${symbol.name}: ${symbol.kind}`);
- * });
- *
- * // Clean up
- * await lsp.didClose('/workspace/project/src/index.ts');
- * await lsp.stop();
- *
- */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.LspServer = exports.LspLanguageId = void 0;
 /**
@@ -50,17 +11,15 @@ var LspLanguageId;
     LspLanguageId["JAVASCRIPT"] = "javascript";
 })(LspLanguageId || (exports.LspLanguageId = LspLanguageId = {}));
 /**
- * Provides Language Server Protocol functionality for code intelligence.
- *
- * This class implements a subset of the Language Server Protocol (LSP) to provide
+ * Provides Language Server Protocol functionality for code intelligence to provide
  * IDE-like features such as code completion, symbol search, and more.
  *
- * @class LspServer
- *
  * @property {LspLanguageId} languageId - The language server type (e.g., "typescript")
  * @property {string} pathToProject - Absolute path to the project root directory
  * @property {ToolboxApi} toolboxApi - API client for Sandbox operations
  * @property {SandboxInstance} instance - The Sandbox instance this server belongs to
+ *
+ * @class
  */
 class LspServer {
     constructor(languageId, pathToProject, toolboxApi, instance) {
@@ -73,9 +32,7 @@ class LspServer {
         }
     }
     /**
-     * Starts the language server.
-     *
-     * This method must be called before using any other LSP functionality.
+     * Starts the language server, must be called before using any other LSP functionality.
      * It initializes the language server for the specified language and project.
      *
      * @returns {Promise<void>}
@@ -92,9 +49,7 @@ class LspServer {
         });
     }
     /**
-     * Stops the language server.
-     *
-     * This method should be called when the LSP server is no longer needed to
+     * Stops the language server, should be called when the LSP server is no longer needed to
      * free up system resources.
      *
      * @returns {Promise<void>}
@@ -110,9 +65,7 @@ class LspServer {
         });
     }
     /**
-     * Notifies the language server that a file has been opened.
-     *
-     * This method should be called when a file is opened in the editor to enable
+     * Notifies the language server that a file has been opened, enabling
      * language features like diagnostics and completions for that file. The server
      * will begin tracking the file's contents and providing language features.
      *
@@ -132,10 +85,8 @@ class LspServer {
         });
     }
     /**
-     * Notifies the language server that a file has been closed.
-     *
-     * This method should be called when a file is closed in the editor to allow
-     * the language server to clean up any resources associated with that file.
+     * Notifies the language server that a file has been closed, should be called when a file is closed
+     * in the editor to allow the language server to clean up any resources associated with that file.
      *
      * @param {string} path - Absolute path to the closed file
      * @returns {Promise<void>}
@@ -152,10 +103,7 @@ class LspServer {
         });
     }
     /**
-     * Get symbol information from a document.
-     *
-     * This method returns information about all symbols (functions, classes,
-     * variables, etc.) defined in the specified document.
+     * Get symbol information (functions, classes, variables, etc.) from a document.
      *
      * @param {string} path - Absolute path to the file to get symbols from
      * @returns {Promise<LspSymbol[]>} List of symbols in the document. Each symbol includes:
@@ -175,11 +123,7 @@ class LspServer {
         return response.data;
     }
     /**
-     * Searches for symbols across the entire Sandbox.
-     *
-     * This method searches for symbols matching the query string across all files
-     * in the Sandbox. It's useful for finding declarations and definitions
-     * without knowing which file they're in.
+     * Searches for symbols matching the query string across the entire Sandbox.
      *
      * @param {string} query - Search query to match against symbol names
      * @returns {Promise<LspSymbol[]>} List of matching symbols from all files. Each symbol includes:
@@ -193,11 +137,7 @@ class LspServer {
         return await this.sandboxSymbols(query);
     }
     /**
-     * Searches for symbols across the entire Sandbox.
-     *
-     * This method searches for symbols matching the query string across all files
-     * in the Sandbox. It's useful for finding declarations and definitions
-     * without knowing which file they're in.
+     * Searches for symbols matching the query string across the entire Sandbox.
      *
      * @param {string} query - Search query to match against symbol names
      * @returns {Promise<LspSymbol[]>} List of matching symbols from all files. Each symbol includes:

package/dist/Process.d.ts

@@ -1,38 +1,3 @@
-/**
- * The Daytona SDK provides powerful process and code execution capabilities through
- * the `process` module in Sandboxes. This guide covers all available process operations
- * and best practices.
- *
- * @module Process
- *
- * @example
- * // Execute a shell command
- * const response = await sandbox.process.executeCommand('ls -la');
- * console.log(response.result);
- *
- * // Run TypeScript code
- * const response = await sandbox.process.codeRun('console.log("Hello, World!")');
- * console.log(response.result);
- *
- * @example
- * // Using interactive sessions
- * // Create a new session
- * const sessionId = 'my-session';
- * await sandbox.process.createSession(sessionId);
- *
- * // Execute commands in the session
- * const response = await sandbox.process.executeSessionCommand(sessionId, {
- *   command: 'cd /workspace'
- * });
- *
- * const response2 = await sandbox.process.executeSessionCommand(sessionId, {
- *   command: 'pwd'
- * });
- * console.log(response2.result);  // Should print "/workspace"
- *
- * // Clean up
- * await sandbox.process.deleteSession(sessionId);
- */
 import { Command, ExecuteResponse, Session, SessionExecuteRequest, SessionExecuteResponse, ToolboxApi } from '@daytonaio/api-client';
 import { SandboxCodeToolbox, SandboxInstance } from './Sandbox';
 /**
@@ -48,6 +13,11 @@ export declare class CodeRunParams {
      */
     env?: Record<string, string>;
 }
+/**
+ * Handles process and code execution within a Sandbox.
+ *
+ * @class
+ */
 export declare class Process {
     private readonly codeToolbox;
     private readonly toolboxApi;

package/dist/Process.js

@@ -1,39 +1,4 @@
 "use strict";
-/**
- * The Daytona SDK provides powerful process and code execution capabilities through
- * the `process` module in Sandboxes. This guide covers all available process operations
- * and best practices.
- *
- * @module Process
- *
- * @example
- * // Execute a shell command
- * const response = await sandbox.process.executeCommand('ls -la');
- * console.log(response.result);
- *
- * // Run TypeScript code
- * const response = await sandbox.process.codeRun('console.log("Hello, World!")');
- * console.log(response.result);
- *
- * @example
- * // Using interactive sessions
- * // Create a new session
- * const sessionId = 'my-session';
- * await sandbox.process.createSession(sessionId);
- *
- * // Execute commands in the session
- * const response = await sandbox.process.executeSessionCommand(sessionId, {
- *   command: 'cd /workspace'
- * });
- *
- * const response2 = await sandbox.process.executeSessionCommand(sessionId, {
- *   command: 'pwd'
- * });
- * console.log(response2.result);  // Should print "/workspace"
- *
- * // Clean up
- * await sandbox.process.deleteSession(sessionId);
- */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Process = exports.CodeRunParams = void 0;
 /**
@@ -42,6 +7,11 @@ exports.Process = exports.CodeRunParams = void 0;
 class CodeRunParams {
 }
 exports.CodeRunParams = CodeRunParams;
+/**
+ * Handles process and code execution within a Sandbox.
+ *
+ * @class
+ */
 class Process {
     constructor(codeToolbox, toolboxApi, instance) {
         this.codeToolbox = codeToolbox;

package/dist/Sandbox.d.ts

@@ -1,43 +1,3 @@
-/**
- * The Daytona SDK core Sandbox functionality.
- *
- * Provides the main Sandbox class representing a Daytona Sandbox that coordinates file system,
- * Git, process execution, and LSP functionality. It serves as the central point
- * for interacting with Daytona Sandboxes.
- *
- * The Sandbox must be in a 'started' state before performing operations.
- *
- * @module Sandbox
- *
- * @example
- * // Create and initialize sandbox
- * const daytona = new Daytona();
- * const sandbox = await daytona.create();
- *
- * // File operations
- * await sandbox.fs.uploadFile(
- *   '/app/config.json',
- *   new File(['{"setting": "value"}'], 'config.json')
- * );
- * const contentBlob = await sandbox.fs.downloadFile('/app/config.json');
- *
- * // Git operations
- * await sandbox.git.clone('https://github.com/user/repo.git');
- *
- * // Process execution
- * const response = await sandbox.process.executeCommand('ls -la');
- * console.log(response.result);
- *
- * // LSP functionality
- * const lsp = sandbox.createLspServer('typescript', '/workspace/project');
- * await lsp.didOpen('/workspace/project/src/index.ts');
- * const completions = await lsp.completions('/workspace/project/src/index.ts', {
- *   line: 10,
- *   character: 15
- * });
- * console.log(completions);
- *
- */
 import { ToolboxApi, WorkspaceState as SandboxState, WorkspaceApi as SandboxApi, Workspace as ApiSandbox, WorkspaceInfo as ApiSandboxInfo, CreateNodeClassEnum as SandboxClass, CreateNodeRegionEnum as SandboxTargetRegion, Workspace as ApiWorkspace } from '@daytonaio/api-client';
 import { FileSystem } from './FileSystem';
 import { Git } from './Git';
@@ -51,7 +11,7 @@ export interface SandboxInstance extends Omit<ApiSandbox, 'info'> {
 /**
  * Resources allocated to a Sandbox
  *
- * @interface SandboxResources
+ * @interface
  * @property {string} cpu - Number of CPU cores allocated (e.g., "1", "2")
  * @property {string | null} gpu - Number of GPUs allocated (e.g., "1") or null if no GPU
  * @property {string} memory - Amount of memory allocated with unit (e.g., "2Gi", "4Gi")
@@ -81,7 +41,7 @@ export interface SandboxResources {
  * This interface provides detailed information about a Sandbox's configuration,
  * resources, and current state.
  *
- * @interface SandboxInfo
+ * @interface
  * @property {string} id - Unique identifier for the Sandbox
  * @property {string} name - Display name of the Sandbox
  * @property {string} image - Docker image used for the Sandbox
@@ -148,7 +108,7 @@ export interface SandboxInfo extends ApiSandboxInfo {
 }
 /**
  * Interface defining methods that a code toolbox must implement
- * @interface SandboxCodeToolbox
+ * @interface
  */
 export interface SandboxCodeToolbox {
     /** Generates a command to run the provided code */
@@ -157,10 +117,6 @@ export interface SandboxCodeToolbox {
 /**
  * Represents a Daytona Sandbox.
  *
- * A Sandbox provides file system operations, Git operations, process execution,
- * and LSP functionality. It serves as the main interface for interacting with
- * a Daytona sandbox.
- *
  * @property {string} id - Unique identifier for the Sandbox
  * @property {SandboxInstance} instance - The underlying Sandbox instance
  * @property {SandboxApi} sandboxApi - API client for Sandbox operations
@@ -169,6 +125,8 @@ export interface SandboxCodeToolbox {
  * @property {FileSystem} fs - File system operations interface
  * @property {Git} git - Git operations interface
  * @property {Process} process - Process execution interface
+ *
+ * @class
  */
 export declare class Sandbox {
     readonly id: string;

package/dist/Sandbox.js

@@ -1,44 +1,4 @@
 "use strict";
-/**
- * The Daytona SDK core Sandbox functionality.
- *
- * Provides the main Sandbox class representing a Daytona Sandbox that coordinates file system,
- * Git, process execution, and LSP functionality. It serves as the central point
- * for interacting with Daytona Sandboxes.
- *
- * The Sandbox must be in a 'started' state before performing operations.
- *
- * @module Sandbox
- *
- * @example
- * // Create and initialize sandbox
- * const daytona = new Daytona();
- * const sandbox = await daytona.create();
- *
- * // File operations
- * await sandbox.fs.uploadFile(
- *   '/app/config.json',
- *   new File(['{"setting": "value"}'], 'config.json')
- * );
- * const contentBlob = await sandbox.fs.downloadFile('/app/config.json');
- *
- * // Git operations
- * await sandbox.git.clone('https://github.com/user/repo.git');
- *
- * // Process execution
- * const response = await sandbox.process.executeCommand('ls -la');
- * console.log(response.result);
- *
- * // LSP functionality
- * const lsp = sandbox.createLspServer('typescript', '/workspace/project');
- * await lsp.didOpen('/workspace/project/src/index.ts');
- * const completions = await lsp.completions('/workspace/project/src/index.ts', {
- *   line: 10,
- *   character: 15
- * });
- * console.log(completions);
- *
- */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Sandbox = void 0;
 const FileSystem_1 = require("./FileSystem");
@@ -49,10 +9,6 @@ const DaytonaError_1 = require("./errors/DaytonaError");
 /**
  * Represents a Daytona Sandbox.
  *
- * A Sandbox provides file system operations, Git operations, process execution,
- * and LSP functionality. It serves as the main interface for interacting with
- * a Daytona sandbox.
- *
  * @property {string} id - Unique identifier for the Sandbox
  * @property {SandboxInstance} instance - The underlying Sandbox instance
  * @property {SandboxApi} sandboxApi - API client for Sandbox operations
@@ -61,6 +17,8 @@ const DaytonaError_1 = require("./errors/DaytonaError");
  * @property {FileSystem} fs - File system operations interface
  * @property {Git} git - Git operations interface
  * @property {Process} process - Process execution interface
+ *
+ * @class
  */
 class Sandbox {
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@daytonaio/sdk",
-  "version": "0.11.2",
+  "version": "0.11.3",
   "description": "Daytona client library for AI Agents",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",