@daytonaio/sdk 0.16.0-alpha.0 → 0.16.0-alpha.3

package/dist/Git.d.ts

@@ -18,32 +18,35 @@ export declare class Git {
     private readonly sandbox;
     private readonly toolboxApi;
     private readonly instance;
-    constructor(sandbox: Sandbox, toolboxApi: ToolboxApi, instance: SandboxInstance);
+    private readonly getRootDir;
+    constructor(sandbox: Sandbox, toolboxApi: ToolboxApi, instance: SandboxInstance, getRootDir: () => Promise<string>);
     /**
      * 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
+     * @param {string} path - Path to the Git repository root. Relative paths are resolved based on the user's
+     * root directory.
      * @param {string[]} files - List of file paths or directories to stage, relative to the repository root
      * @returns {Promise<void>}
      *
      * @example
      * // Stage a single file
-     * await git.add('/workspace/repo', ['file.txt']);
+     * await git.add('workspace/repo', ['file.txt']);
      *
      * @example
      * // Stage whole repository
-     * await git.add('/workspace/repo', ['.']);
+     * await git.add('workspace/repo', ['.']);
      */
     add(path: string, files: string[]): Promise<void>;
     /**
      * List branches in the repository.
      *
-     * @param {string} path - Absolute path to the Git repository root
+     * @param {string} path - Path to the Git repository root. Relative paths are resolved based on the user's
+     * root directory.
      * @returns {Promise<ListBranchResponse>} List of branches in the repository
      *
      * @example
-     * const response = await git.branches('/workspace/repo');
+     * const response = await git.branches('workspace/repo');
      * console.log(`Branches: ${response.branches}`);
      */
     branches(path: string): Promise<ListBranchResponse>;
@@ -53,7 +56,8 @@ export declare class Git {
      * repository if credentials are provided.
      *
      * @param {string} url - Repository URL to clone from
-     * @param {string} path - Absolute path where the repository should be cloned
+     * @param {string} path - Path where the repository should be cloned. Relative paths are resolved based on the user's
+     * root directory.
      * @param {string} [branch] - Specific branch to clone. If not specified, clones the default branch
      * @param {string} [commitId] - Specific commit to clone. If specified, the repository will be left in a detached HEAD state at this commit
      * @param {string} [username] - Git username for authentication
@@ -64,14 +68,14 @@ export declare class Git {
      * // Clone the default branch
      * await git.clone(
      *   'https://github.com/user/repo.git',
-     *   '/workspace/repo'
+     *   'workspace/repo'
      * );
      *
      * @example
      * // Clone a specific branch with authentication
      * await git.clone(
      *   'https://github.com/user/private-repo.git',
-     *   '/workspace/private',
+     *   'workspace/private',
      *   branch='develop',
      *   username='user',
      *   password='token'
@@ -81,7 +85,7 @@ export declare class Git {
      * // Clone a specific commit
      * await git.clone(
      *   'https://github.com/user/repo.git',
-     *   '/workspace/repo-old',
+     *   'workspace/repo-old',
      *   commitId='abc123'
      * );
      */
@@ -89,7 +93,8 @@ export declare class Git {
     /**
      * Commits staged changes.
      *
-     * @param {string} path - Absolute path to the Git repository root
+     * @param {string} path - Path to the Git repository root. Relative paths are resolved based on the user's
+     * root directory.
      * @param {string} message - Commit message describing the changes
      * @param {string} author - Name of the commit author
      * @param {string} email - Email address of the commit author
@@ -97,9 +102,9 @@ export declare class Git {
      *
      * @example
      * // Stage and commit changes
-     * await git.add('/workspace/repo', ['README.md']);
+     * await git.add('workspace/repo', ['README.md']);
      * await git.commit(
-     *   '/workspace/repo',
+     *   'workspace/repo',
      *   'Update documentation',
      *   'John Doe',
      *   'john@example.com'
@@ -109,19 +114,20 @@ export declare class Git {
     /**
      * Push local changes to the remote repository.
      *
-     * @param {string} path - Absolute path to the Git repository root
+     * @param {string} path - Path to the Git repository root. Relative paths are resolved based on the user's
+     * root directory.
      * @param {string} [username] - Git username for authentication
      * @param {string} [password] - Git password or token for authentication
      * @returns {Promise<void>}
      *
      * @example
      * // Push to a public repository
-     * await git.push('/workspace/repo');
+     * await git.push('workspace/repo');
      *
      * @example
      * // Push to a private repository
      * await git.push(
-     *   '/workspace/repo',
+     *   'workspace/repo',
      *   'user',
      *   'token'
      * );
@@ -130,19 +136,20 @@ export declare class Git {
     /**
      * Pulls changes from the remote repository.
      *
-     * @param {string} path - Absolute path to the Git repository root
+     * @param {string} path - Path to the Git repository root. Relative paths are resolved based on the user's
+     * root directory.
      * @param {string} [username] - Git username for authentication
      * @param {string} [password] - Git password or token for authentication
      * @returns {Promise<void>}
      *
      * @example
      * // Pull from a public repository
-     * await git.pull('/workspace/repo');
+     * await git.pull('workspace/repo');
      *
      * @example
      * // Pull from a private repository
      * await git.pull(
-     *   '/workspace/repo',
+     *   'workspace/repo',
      *   'user',
      *   'token'
      * );
@@ -151,7 +158,8 @@ export declare class Git {
     /**
      * Gets the current status of the Git repository.
      *
-     * @param {string} path - Absolute path to the Git repository root
+     * @param {string} path - Path to the Git repository root. Relative paths are resolved based on the user's
+     * root directory.
      * @returns {Promise<GitStatus>} Current repository status including:
      *                               - currentBranch: Name of the current branch
      *                               - ahead: Number of commits ahead of the remote branch
@@ -160,7 +168,7 @@ export declare class Git {
      *                               - fileStatus: List of file statuses
      *
      * @example
-     * const status = await sandbox.git.status('/workspace/repo');
+     * const status = await sandbox.git.status('workspace/repo');
      * console.log(`Current branch: ${status.currentBranch}`);
      * console.log(`Commits ahead: ${status.ahead}`);
      * console.log(`Commits behind: ${status.behind}`);

package/dist/Git.js

@@ -1,51 +1,55 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Git = void 0;
+const Path_1 = require("./utils/Path");
 /**
  * Provides Git operations within a Sandbox.
  *
  * @class
  */
 class Git {
-    constructor(sandbox, toolboxApi, instance) {
+    constructor(sandbox, toolboxApi, instance, getRootDir) {
         this.sandbox = sandbox;
         this.toolboxApi = toolboxApi;
         this.instance = instance;
+        this.getRootDir = getRootDir;
     }
     /**
      * 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
+     * @param {string} path - Path to the Git repository root. Relative paths are resolved based on the user's
+     * root directory.
      * @param {string[]} files - List of file paths or directories to stage, relative to the repository root
      * @returns {Promise<void>}
      *
      * @example
      * // Stage a single file
-     * await git.add('/workspace/repo', ['file.txt']);
+     * await git.add('workspace/repo', ['file.txt']);
      *
      * @example
      * // Stage whole repository
-     * await git.add('/workspace/repo', ['.']);
+     * await git.add('workspace/repo', ['.']);
      */
     async add(path, files) {
         await this.toolboxApi.gitAddFiles(this.instance.id, {
-            path,
+            path: (0, Path_1.prefixRelativePath)(await this.getRootDir(), path),
             files,
         });
     }
     /**
      * List branches in the repository.
      *
-     * @param {string} path - Absolute path to the Git repository root
+     * @param {string} path - Path to the Git repository root. Relative paths are resolved based on the user's
+     * root directory.
      * @returns {Promise<ListBranchResponse>} List of branches in the repository
      *
      * @example
-     * const response = await git.branches('/workspace/repo');
+     * const response = await git.branches('workspace/repo');
      * console.log(`Branches: ${response.branches}`);
      */
     async branches(path) {
-        const response = await this.toolboxApi.gitListBranches(this.instance.id, path);
+        const response = await this.toolboxApi.gitListBranches(this.instance.id, (0, Path_1.prefixRelativePath)(await this.getRootDir(), path));
         return response.data;
     }
     /**
@@ -54,7 +58,8 @@ class Git {
      * repository if credentials are provided.
      *
      * @param {string} url - Repository URL to clone from
-     * @param {string} path - Absolute path where the repository should be cloned
+     * @param {string} path - Path where the repository should be cloned. Relative paths are resolved based on the user's
+     * root directory.
      * @param {string} [branch] - Specific branch to clone. If not specified, clones the default branch
      * @param {string} [commitId] - Specific commit to clone. If specified, the repository will be left in a detached HEAD state at this commit
      * @param {string} [username] - Git username for authentication
@@ -65,14 +70,14 @@ class Git {
      * // Clone the default branch
      * await git.clone(
      *   'https://github.com/user/repo.git',
-     *   '/workspace/repo'
+     *   'workspace/repo'
      * );
      *
      * @example
      * // Clone a specific branch with authentication
      * await git.clone(
      *   'https://github.com/user/private-repo.git',
-     *   '/workspace/private',
+     *   'workspace/private',
      *   branch='develop',
      *   username='user',
      *   password='token'
@@ -82,7 +87,7 @@ class Git {
      * // Clone a specific commit
      * await git.clone(
      *   'https://github.com/user/repo.git',
-     *   '/workspace/repo-old',
+     *   'workspace/repo-old',
      *   commitId='abc123'
      * );
      */
@@ -90,7 +95,7 @@ class Git {
         await this.toolboxApi.gitCloneRepository(this.instance.id, {
             url: url,
             branch: branch,
-            path,
+            path: (0, Path_1.prefixRelativePath)(await this.getRootDir(), path),
             username,
             password,
             commit_id: commitId,
@@ -99,7 +104,8 @@ class Git {
     /**
      * Commits staged changes.
      *
-     * @param {string} path - Absolute path to the Git repository root
+     * @param {string} path - Path to the Git repository root. Relative paths are resolved based on the user's
+     * root directory.
      * @param {string} message - Commit message describing the changes
      * @param {string} author - Name of the commit author
      * @param {string} email - Email address of the commit author
@@ -107,9 +113,9 @@ class Git {
      *
      * @example
      * // Stage and commit changes
-     * await git.add('/workspace/repo', ['README.md']);
+     * await git.add('workspace/repo', ['README.md']);
      * await git.commit(
-     *   '/workspace/repo',
+     *   'workspace/repo',
      *   'Update documentation',
      *   'John Doe',
      *   'john@example.com'
@@ -117,7 +123,7 @@ class Git {
      */
     async commit(path, message, author, email) {
         const response = await this.toolboxApi.gitCommitChanges(this.instance.id, {
-            path,
+            path: (0, Path_1.prefixRelativePath)(await this.getRootDir(), path),
             message,
             author,
             email,
@@ -129,26 +135,27 @@ class Git {
     /**
      * Push local changes to the remote repository.
      *
-     * @param {string} path - Absolute path to the Git repository root
+     * @param {string} path - Path to the Git repository root. Relative paths are resolved based on the user's
+     * root directory.
      * @param {string} [username] - Git username for authentication
      * @param {string} [password] - Git password or token for authentication
      * @returns {Promise<void>}
      *
      * @example
      * // Push to a public repository
-     * await git.push('/workspace/repo');
+     * await git.push('workspace/repo');
      *
      * @example
      * // Push to a private repository
      * await git.push(
-     *   '/workspace/repo',
+     *   'workspace/repo',
      *   'user',
      *   'token'
      * );
      */
     async push(path, username, password) {
         await this.toolboxApi.gitPushChanges(this.instance.id, {
-            path,
+            path: (0, Path_1.prefixRelativePath)(await this.getRootDir(), path),
             username,
             password,
         });
@@ -156,26 +163,27 @@ class Git {
     /**
      * Pulls changes from the remote repository.
      *
-     * @param {string} path - Absolute path to the Git repository root
+     * @param {string} path - Path to the Git repository root. Relative paths are resolved based on the user's
+     * root directory.
      * @param {string} [username] - Git username for authentication
      * @param {string} [password] - Git password or token for authentication
      * @returns {Promise<void>}
      *
      * @example
      * // Pull from a public repository
-     * await git.pull('/workspace/repo');
+     * await git.pull('workspace/repo');
      *
      * @example
      * // Pull from a private repository
      * await git.pull(
-     *   '/workspace/repo',
+     *   'workspace/repo',
      *   'user',
      *   'token'
      * );
      */
     async pull(path, username, password) {
         await this.toolboxApi.gitPullChanges(this.instance.id, {
-            path,
+            path: (0, Path_1.prefixRelativePath)(await this.getRootDir(), path),
             username,
             password,
         });
@@ -183,7 +191,8 @@ class Git {
     /**
      * Gets the current status of the Git repository.
      *
-     * @param {string} path - Absolute path to the Git repository root
+     * @param {string} path - Path to the Git repository root. Relative paths are resolved based on the user's
+     * root directory.
      * @returns {Promise<GitStatus>} Current repository status including:
      *                               - currentBranch: Name of the current branch
      *                               - ahead: Number of commits ahead of the remote branch
@@ -192,13 +201,13 @@ class Git {
      *                               - fileStatus: List of file statuses
      *
      * @example
-     * const status = await sandbox.git.status('/workspace/repo');
+     * const status = await sandbox.git.status('workspace/repo');
      * console.log(`Current branch: ${status.currentBranch}`);
      * console.log(`Commits ahead: ${status.ahead}`);
      * console.log(`Commits behind: ${status.behind}`);
      */
     async status(path) {
-        const response = await this.toolboxApi.gitGetStatus(this.instance.id, path);
+        const response = await this.toolboxApi.gitGetStatus(this.instance.id, (0, Path_1.prefixRelativePath)(await this.getRootDir(), path));
         return response.data;
     }
 }

package/dist/LspServer.d.ts

@@ -52,7 +52,7 @@ export declare class LspServer {
      * @returns {Promise<void>}
      *
      * @example
-     * const lsp = sandbox.createLspServer('typescript', '/workspace/project');
+     * const lsp = sandbox.createLspServer('typescript', 'workspace/project');
      * await lsp.start();  // Initialize the server
      * // Now ready for LSP operations
      */
@@ -73,12 +73,13 @@ export declare class LspServer {
      * language features like diagnostics and completions for that file. The server
      * will begin tracking the file's contents and providing language features.
      *
-     * @param {string} path - Absolute path to the opened file
+     * @param {string} path - Path to the opened file. Relative paths are resolved based on the user's
+     * root directory.
      * @returns {Promise<void>}
      *
      * @example
      * // When opening a file for editing
-     * await lsp.didOpen('/workspace/project/src/index.ts');
+     * await lsp.didOpen('workspace/project/src/index.ts');
      * // Now can get completions, symbols, etc. for this file
      */
     didOpen(path: string): Promise<void>;
@@ -86,18 +87,20 @@ export declare class LspServer {
      * 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
+     * @param {string} path - Path to the closed file. Relative paths are resolved based on the project path
+     * set in the LSP server constructor.
      * @returns {Promise<void>}
      *
      * @example
      * // When done editing a file
-     * await lsp.didClose('/workspace/project/src/index.ts');
+     * await lsp.didClose('workspace/project/src/index.ts');
      */
     didClose(path: string): Promise<void>;
     /**
      * Get symbol information (functions, classes, variables, etc.) from a document.
      *
-     * @param {string} path - Absolute path to the file to get symbols from
+     * @param {string} path - Path to the file to get symbols from. Relative paths are resolved based on the project path
+     * set in the LSP server constructor.
      * @returns {Promise<LspSymbol[]>} List of symbols in the document. Each symbol includes:
      *                                 - name: The symbol's name
      *                                 - kind: The symbol's kind (function, class, variable, etc.)
@@ -105,7 +108,7 @@ export declare class LspServer {
      *
      * @example
      * // Get all symbols in a file
-     * const symbols = await lsp.documentSymbols('/workspace/project/src/index.ts');
+     * const symbols = await lsp.documentSymbols('workspace/project/src/index.ts');
      * symbols.forEach(symbol => {
      *   console.log(`${symbol.kind} ${symbol.name}: ${symbol.location}`);
      * });
@@ -143,7 +146,8 @@ export declare class LspServer {
     /**
      * Gets completion suggestions at a position in a file.
      *
-     * @param {string} path - Absolute path to the file
+     * @param {string} path - Path to the file. Relative paths are resolved based on the project path
+     * set in the LSP server constructor.
      * @param {Position} position - The position in the file where completion was requested
      * @returns {Promise<CompletionList>} List of completion suggestions. The list includes:
      *                                    - isIncomplete: Whether more items might be available
@@ -158,7 +162,7 @@ export declare class LspServer {
      *
      * @example
      * // Get completions at a specific position
-     * const completions = await lsp.completions('/workspace/project/src/index.ts', {
+     * const completions = await lsp.completions('workspace/project/src/index.ts', {
      *   line: 10,
      *   character: 15
      * });

package/dist/LspServer.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.LspServer = exports.LspLanguageId = void 0;
+const Path_1 = require("./utils/Path");
 /**
  * Supported language server types.
  */
@@ -38,7 +39,7 @@ class LspServer {
      * @returns {Promise<void>}
      *
      * @example
-     * const lsp = sandbox.createLspServer('typescript', '/workspace/project');
+     * const lsp = sandbox.createLspServer('typescript', 'workspace/project');
      * await lsp.start();  // Initialize the server
      * // Now ready for LSP operations
      */
@@ -69,43 +70,46 @@ class LspServer {
      * language features like diagnostics and completions for that file. The server
      * will begin tracking the file's contents and providing language features.
      *
-     * @param {string} path - Absolute path to the opened file
+     * @param {string} path - Path to the opened file. Relative paths are resolved based on the user's
+     * root directory.
      * @returns {Promise<void>}
      *
      * @example
      * // When opening a file for editing
-     * await lsp.didOpen('/workspace/project/src/index.ts');
+     * await lsp.didOpen('workspace/project/src/index.ts');
      * // Now can get completions, symbols, etc. for this file
      */
     async didOpen(path) {
         await this.toolboxApi.lspDidOpen(this.instance.id, {
             languageId: this.languageId,
             pathToProject: this.pathToProject,
-            uri: 'file://' + path,
+            uri: 'file://' + (0, Path_1.prefixRelativePath)(this.pathToProject, path),
         });
     }
     /**
      * 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
+     * @param {string} path - Path to the closed file. Relative paths are resolved based on the project path
+     * set in the LSP server constructor.
      * @returns {Promise<void>}
      *
      * @example
      * // When done editing a file
-     * await lsp.didClose('/workspace/project/src/index.ts');
+     * await lsp.didClose('workspace/project/src/index.ts');
      */
     async didClose(path) {
         await this.toolboxApi.lspDidClose(this.instance.id, {
             languageId: this.languageId,
             pathToProject: this.pathToProject,
-            uri: 'file://' + path,
+            uri: 'file://' + (0, Path_1.prefixRelativePath)(this.pathToProject, path),
         });
     }
     /**
      * Get symbol information (functions, classes, variables, etc.) from a document.
      *
-     * @param {string} path - Absolute path to the file to get symbols from
+     * @param {string} path - Path to the file to get symbols from. Relative paths are resolved based on the project path
+     * set in the LSP server constructor.
      * @returns {Promise<LspSymbol[]>} List of symbols in the document. Each symbol includes:
      *                                 - name: The symbol's name
      *                                 - kind: The symbol's kind (function, class, variable, etc.)
@@ -113,13 +117,13 @@ class LspServer {
      *
      * @example
      * // Get all symbols in a file
-     * const symbols = await lsp.documentSymbols('/workspace/project/src/index.ts');
+     * const symbols = await lsp.documentSymbols('workspace/project/src/index.ts');
      * symbols.forEach(symbol => {
      *   console.log(`${symbol.kind} ${symbol.name}: ${symbol.location}`);
      * });
      */
     async documentSymbols(path) {
-        const response = await this.toolboxApi.lspDocumentSymbols(this.instance.id, this.languageId, this.pathToProject, 'file://' + path);
+        const response = await this.toolboxApi.lspDocumentSymbols(this.instance.id, this.languageId, this.pathToProject, 'file://' + (0, Path_1.prefixRelativePath)(this.pathToProject, path));
         return response.data;
     }
     /**
@@ -159,7 +163,8 @@ class LspServer {
     /**
      * Gets completion suggestions at a position in a file.
      *
-     * @param {string} path - Absolute path to the file
+     * @param {string} path - Path to the file. Relative paths are resolved based on the project path
+     * set in the LSP server constructor.
      * @param {Position} position - The position in the file where completion was requested
      * @returns {Promise<CompletionList>} List of completion suggestions. The list includes:
      *                                    - isIncomplete: Whether more items might be available
@@ -174,7 +179,7 @@ class LspServer {
      *
      * @example
      * // Get completions at a specific position
-     * const completions = await lsp.completions('/workspace/project/src/index.ts', {
+     * const completions = await lsp.completions('workspace/project/src/index.ts', {
      *   line: 10,
      *   character: 15
      * });
@@ -186,7 +191,7 @@ class LspServer {
         const response = await this.toolboxApi.lspCompletions(this.instance.id, {
             languageId: this.languageId,
             pathToProject: this.pathToProject,
-            uri: 'file://' + path,
+            uri: 'file://' + (0, Path_1.prefixRelativePath)(this.pathToProject, path),
             position,
         });
         return response.data;

package/dist/Process.d.ts

@@ -23,12 +23,14 @@ export declare class Process {
     private readonly codeToolbox;
     private readonly toolboxApi;
     private readonly instance;
-    constructor(codeToolbox: SandboxCodeToolbox, toolboxApi: ToolboxApi, instance: SandboxInstance);
+    private readonly getRootDir;
+    constructor(codeToolbox: SandboxCodeToolbox, toolboxApi: ToolboxApi, instance: SandboxInstance, getRootDir: () => Promise<string>);
     /**
      * Executes a shell command in the Sandbox.
      *
      * @param {string} command - Shell command to execute
-     * @param {string} [cwd] - Working directory for command execution. If not specified, uses the Sandbox root directory
+     * @param {string} [cwd] - Working directory for command execution. If not specified, uses the Sandbox root directory.
+     * Default is the user's root directory.
      * @param {Record<string, string>} [env] - Environment variables to set for the command
      * @param {number} [timeout] - Maximum time in seconds to wait for the command to complete. 0 means wait indefinitely.
      * @returns {Promise<ExecuteResponse>} Command execution results containing:
@@ -43,7 +45,7 @@ export declare class Process {
      *
      * @example
      * // Command with working directory
-     * const result = await process.executeCommand('ls', '/workspace/src');
+     * const result = await process.executeCommand('ls', 'workspace/src');
      *
      * @example
      * // Command with timeout
@@ -166,7 +168,7 @@ export declare class Process {
      * @param {string} sessionId - Unique identifier of the session to use
      * @param {SessionExecuteRequest} req - Command execution request containing:
      *                                     - command: The command to execute
-     *                                     - async: Whether to execute asynchronously
+     *                                     - runAsync: Whether to execute asynchronously
      * @param {number} timeout - Timeout in seconds
      * @returns {Promise<SessionExecuteResponse>} Command execution results containing:
      *                                           - cmdId: Unique identifier for the executed command
@@ -179,14 +181,14 @@ export declare class Process {
      *
      * // Change directory
      * await process.executeSessionCommand(sessionId, {
-     *   command: 'cd /workspace'
+     *   command: 'cd /home/daytona'
      * });
      *
      * // Run command in new directory
      * const result = await process.executeSessionCommand(sessionId, {
      *   command: 'pwd'
      * });
-     * console.log(result.output);  // Prints: /workspace
+     * console.log(result.output);  // Prints: /home/daytona
      */
     executeSessionCommand(sessionId: string, req: SessionExecuteRequest, timeout?: number): Promise<SessionExecuteResponse>;
     /**