@daytonaio/sdk 0.222.1-alpha.1 → 0.223.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -65,6 +65,47 @@ export declare class Mouse {
65
65
  * ```
66
66
  */
67
67
  move(x: number, y: number): Promise<MousePositionResponse>;
68
+ /**
69
+ * Presses and holds a mouse button at the specified coordinates
70
+ *
71
+ * The button stays held until a matching `up()` call is made, which enables
72
+ * press-and-hold interactions such as manual drags and marquee selections.
73
+ *
74
+ * @param {number} [x] - The x coordinate to press at. Omit to press at the current cursor position
75
+ * @param {number} [y] - The y coordinate to press at. Omit to press at the current cursor position
76
+ * @param {string} [button='left'] - The mouse button to press ('left', 'right', 'middle')
77
+ * @returns {Promise<MousePositionResponse>} Position after the button press
78
+ *
79
+ * @example
80
+ * ```typescript
81
+ * // Press and hold the left button, move, then release
82
+ * await sandbox.computerUse.mouse.down(100, 200);
83
+ * await sandbox.computerUse.mouse.move(300, 400);
84
+ * await sandbox.computerUse.mouse.up(300, 400);
85
+ *
86
+ * // Press at the current cursor position
87
+ * await sandbox.computerUse.mouse.down();
88
+ * ```
89
+ */
90
+ down(x?: number, y?: number, button?: string): Promise<MousePositionResponse>;
91
+ /**
92
+ * Releases a held mouse button at the specified coordinates
93
+ *
94
+ * @param {number} [x] - The x coordinate to release at. Omit to release at the current cursor position
95
+ * @param {number} [y] - The y coordinate to release at. Omit to release at the current cursor position
96
+ * @param {string} [button='left'] - The mouse button to release ('left', 'right', 'middle')
97
+ * @returns {Promise<MousePositionResponse>} Position after the button release
98
+ *
99
+ * @example
100
+ * ```typescript
101
+ * const result = await sandbox.computerUse.mouse.up(300, 400);
102
+ * console.log(`Button released at: ${result.x}, ${result.y}`);
103
+ *
104
+ * // Release at the current cursor position
105
+ * await sandbox.computerUse.mouse.up();
106
+ * ```
107
+ */
108
+ up(x?: number, y?: number, button?: string): Promise<MousePositionResponse>;
68
109
  /**
69
110
  * Clicks the mouse at the specified coordinates
70
111
  *
@@ -72,6 +113,8 @@ export declare class Mouse {
72
113
  * @param {number} y - The y coordinate to click at
73
114
  * @param {string} [button='left'] - The mouse button to click ('left', 'right', 'middle')
74
115
  * @param {boolean} [double=false] - Whether to perform a double-click
116
+ * @param {number} [clicks] - Number of clicks to perform (1-10). Omit to let the server apply its default; `clicks` takes precedence when both it and `double` are supplied
117
+ * @param {string[]} [modifiers] - Canonical modifier names are 'ctrl', 'alt', 'shift', and 'cmd'. Held for the duration of the click
75
118
  * @returns {Promise<MouseClickResponse>} Click operation result
76
119
  *
77
120
  * @example
@@ -84,9 +127,15 @@ export declare class Mouse {
84
127
  *
85
128
  * // Right click
86
129
  * const rightClick = await sandbox.computerUse.mouse.click(100, 200, 'right');
130
+ *
131
+ * // Triple click to select a line
132
+ * const tripleClick = await sandbox.computerUse.mouse.click(100, 200, 'left', false, 3);
133
+ *
134
+ * // Ctrl+click to extend a selection
135
+ * const ctrlClick = await sandbox.computerUse.mouse.click(100, 200, 'left', false, undefined, ['ctrl']);
87
136
  * ```
88
137
  */
89
- click(x: number, y: number, button?: string, double?: boolean): Promise<MouseClickResponse>;
138
+ click(x: number, y: number, button?: string, double?: boolean, clicks?: number, modifiers?: string[]): Promise<MouseClickResponse>;
90
139
  /**
91
140
  * Drags the mouse from start coordinates to end coordinates
92
141
  *
@@ -95,22 +144,27 @@ export declare class Mouse {
95
144
  * @param {number} endX - The ending x coordinate
96
145
  * @param {number} endY - The ending y coordinate
97
146
  * @param {string} [button='left'] - The mouse button to use for dragging
147
+ * @param {string[]} [modifiers] - Canonical modifier names are 'ctrl', 'alt', 'shift', and 'cmd'. Held for the duration of the drag
98
148
  * @returns {Promise<MouseDragResponse>} Drag operation result
99
149
  *
100
150
  * @example
101
151
  * ```typescript
102
152
  * const result = await sandbox.computerUse.mouse.drag(50, 50, 150, 150);
103
153
  * console.log(`Drag ended at: ${result.x}, ${result.y}`);
154
+ *
155
+ * // Shift-constrained drag
156
+ * const constrained = await sandbox.computerUse.mouse.drag(50, 50, 150, 150, 'left', ['shift']);
104
157
  * ```
105
158
  */
106
- drag(startX: number, startY: number, endX: number, endY: number, button?: string): Promise<MouseDragResponse>;
159
+ drag(startX: number, startY: number, endX: number, endY: number, button?: string, modifiers?: string[]): Promise<MouseDragResponse>;
107
160
  /**
108
161
  * Scrolls the mouse wheel at the specified coordinates
109
162
  *
110
163
  * @param {number} x - The x coordinate to scroll at
111
164
  * @param {number} y - The y coordinate to scroll at
112
- * @param {'up' | 'down'} direction - The direction to scroll
165
+ * @param {'up' | 'down' | 'left' | 'right'} direction - The direction to scroll
113
166
  * @param {number} [amount=1] - The amount to scroll
167
+ * @param {string[]} [modifiers] - Canonical modifier names are 'ctrl', 'alt', 'shift', and 'cmd'. Held for the duration of the scroll
114
168
  * @returns {Promise<boolean>} Whether the scroll operation was successful
115
169
  *
116
170
  * @example
@@ -120,9 +174,15 @@ export declare class Mouse {
120
174
  *
121
175
  * // Scroll down
122
176
  * const scrollDown = await sandbox.computerUse.mouse.scroll(100, 200, 'down', 5);
177
+ *
178
+ * // Horizontal scroll
179
+ * const scrollRight = await sandbox.computerUse.mouse.scroll(100, 200, 'right', 2);
180
+ *
181
+ * // Ctrl+scroll to zoom
182
+ * const zoomIn = await sandbox.computerUse.mouse.scroll(100, 200, 'up', 1, ['ctrl']);
123
183
  * ```
124
184
  */
125
- scroll(x: number, y: number, direction: 'up' | 'down', amount?: number): Promise<boolean>;
185
+ scroll(x: number, y: number, direction: 'up' | 'down' | 'left' | 'right', amount?: number, modifiers?: string[]): Promise<boolean>;
126
186
  }
127
187
  /**
128
188
  * Keyboard operations for computer use functionality
@@ -191,6 +251,46 @@ export declare class Keyboard {
191
251
  * ```
192
252
  */
193
253
  press(key: string, modifiers?: string[]): Promise<void>;
254
+ /**
255
+ * Presses and holds a key
256
+ *
257
+ * The key stays held until a matching `up()` call is made, which enables
258
+ * press-and-hold interactions such as holding a modifier across several actions.
259
+ *
260
+ * @param {string} key - The key to hold. Uses the same normalized key contract as `press()`, including modifier names such as 'ctrl' and 'shift'.
261
+ * @throws {DaytonaError} If the key down operation fails
262
+ *
263
+ * @example
264
+ * ```typescript
265
+ * // Hold Shift while clicking twice, then release.
266
+ * // Release in `finally` so a failed click cannot leave Shift stuck down.
267
+ * await sandbox.computerUse.keyboard.down('shift');
268
+ * try {
269
+ * await sandbox.computerUse.mouse.click(100, 200);
270
+ * await sandbox.computerUse.mouse.click(300, 400);
271
+ * } finally {
272
+ * await sandbox.computerUse.keyboard.up('shift');
273
+ * }
274
+ * ```
275
+ */
276
+ down(key: string): Promise<void>;
277
+ /**
278
+ * Releases a held key
279
+ *
280
+ * @param {string} key - The key to release. Uses the same normalized key contract as `press()`, including modifier names such as 'ctrl' and 'shift'.
281
+ * @throws {DaytonaError} If the key up operation fails
282
+ *
283
+ * @example
284
+ * ```typescript
285
+ * try {
286
+ * await sandbox.computerUse.keyboard.up('shift');
287
+ * console.log('Operation success');
288
+ * } catch (e) {
289
+ * console.log('Operation failed:', e);
290
+ * }
291
+ * ```
292
+ */
293
+ up(key: string): Promise<void>;
194
294
  /**
195
295
  * Presses a hotkey combination
196
296
  *
@@ -16,6 +16,8 @@ let Mouse = (() => {
16
16
  let _instanceExtraInitializers = [];
17
17
  let _getPosition_decorators;
18
18
  let _move_decorators;
19
+ let _down_decorators;
20
+ let _up_decorators;
19
21
  let _click_decorators;
20
22
  let _drag_decorators;
21
23
  let _scroll_decorators;
@@ -24,11 +26,15 @@ let Mouse = (() => {
24
26
  const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(null) : void 0;
25
27
  _getPosition_decorators = [(0, otel_decorator_1.WithInstrumentation)()];
26
28
  _move_decorators = [(0, otel_decorator_1.WithInstrumentation)()];
29
+ _down_decorators = [(0, otel_decorator_1.WithInstrumentation)()];
30
+ _up_decorators = [(0, otel_decorator_1.WithInstrumentation)()];
27
31
  _click_decorators = [(0, otel_decorator_1.WithInstrumentation)()];
28
32
  _drag_decorators = [(0, otel_decorator_1.WithInstrumentation)()];
29
33
  _scroll_decorators = [(0, otel_decorator_1.WithInstrumentation)()];
30
34
  tslib_1.__esDecorate(this, null, _getPosition_decorators, { kind: "method", name: "getPosition", static: false, private: false, access: { has: obj => "getPosition" in obj, get: obj => obj.getPosition }, metadata: _metadata }, null, _instanceExtraInitializers);
31
35
  tslib_1.__esDecorate(this, null, _move_decorators, { kind: "method", name: "move", static: false, private: false, access: { has: obj => "move" in obj, get: obj => obj.move }, metadata: _metadata }, null, _instanceExtraInitializers);
36
+ tslib_1.__esDecorate(this, null, _down_decorators, { kind: "method", name: "down", static: false, private: false, access: { has: obj => "down" in obj, get: obj => obj.down }, metadata: _metadata }, null, _instanceExtraInitializers);
37
+ tslib_1.__esDecorate(this, null, _up_decorators, { kind: "method", name: "up", static: false, private: false, access: { has: obj => "up" in obj, get: obj => obj.up }, metadata: _metadata }, null, _instanceExtraInitializers);
32
38
  tslib_1.__esDecorate(this, null, _click_decorators, { kind: "method", name: "click", static: false, private: false, access: { has: obj => "click" in obj, get: obj => obj.click }, metadata: _metadata }, null, _instanceExtraInitializers);
33
39
  tslib_1.__esDecorate(this, null, _drag_decorators, { kind: "method", name: "drag", static: false, private: false, access: { has: obj => "drag" in obj, get: obj => obj.drag }, metadata: _metadata }, null, _instanceExtraInitializers);
34
40
  tslib_1.__esDecorate(this, null, _scroll_decorators, { kind: "method", name: "scroll", static: false, private: false, access: { has: obj => "scroll" in obj, get: obj => obj.scroll }, metadata: _metadata }, null, _instanceExtraInitializers);
@@ -71,6 +77,55 @@ let Mouse = (() => {
71
77
  const response = await this.apiClient.moveMouse(request);
72
78
  return response.data;
73
79
  }
80
+ /**
81
+ * Presses and holds a mouse button at the specified coordinates
82
+ *
83
+ * The button stays held until a matching `up()` call is made, which enables
84
+ * press-and-hold interactions such as manual drags and marquee selections.
85
+ *
86
+ * @param {number} [x] - The x coordinate to press at. Omit to press at the current cursor position
87
+ * @param {number} [y] - The y coordinate to press at. Omit to press at the current cursor position
88
+ * @param {string} [button='left'] - The mouse button to press ('left', 'right', 'middle')
89
+ * @returns {Promise<MousePositionResponse>} Position after the button press
90
+ *
91
+ * @example
92
+ * ```typescript
93
+ * // Press and hold the left button, move, then release
94
+ * await sandbox.computerUse.mouse.down(100, 200);
95
+ * await sandbox.computerUse.mouse.move(300, 400);
96
+ * await sandbox.computerUse.mouse.up(300, 400);
97
+ *
98
+ * // Press at the current cursor position
99
+ * await sandbox.computerUse.mouse.down();
100
+ * ```
101
+ */
102
+ async down(x, y, button = 'left') {
103
+ const request = { x, y, button };
104
+ const response = await this.apiClient.mouseDown(request);
105
+ return response.data;
106
+ }
107
+ /**
108
+ * Releases a held mouse button at the specified coordinates
109
+ *
110
+ * @param {number} [x] - The x coordinate to release at. Omit to release at the current cursor position
111
+ * @param {number} [y] - The y coordinate to release at. Omit to release at the current cursor position
112
+ * @param {string} [button='left'] - The mouse button to release ('left', 'right', 'middle')
113
+ * @returns {Promise<MousePositionResponse>} Position after the button release
114
+ *
115
+ * @example
116
+ * ```typescript
117
+ * const result = await sandbox.computerUse.mouse.up(300, 400);
118
+ * console.log(`Button released at: ${result.x}, ${result.y}`);
119
+ *
120
+ * // Release at the current cursor position
121
+ * await sandbox.computerUse.mouse.up();
122
+ * ```
123
+ */
124
+ async up(x, y, button = 'left') {
125
+ const request = { x, y, button };
126
+ const response = await this.apiClient.mouseUp(request);
127
+ return response.data;
128
+ }
74
129
  /**
75
130
  * Clicks the mouse at the specified coordinates
76
131
  *
@@ -78,6 +133,8 @@ let Mouse = (() => {
78
133
  * @param {number} y - The y coordinate to click at
79
134
  * @param {string} [button='left'] - The mouse button to click ('left', 'right', 'middle')
80
135
  * @param {boolean} [double=false] - Whether to perform a double-click
136
+ * @param {number} [clicks] - Number of clicks to perform (1-10). Omit to let the server apply its default; `clicks` takes precedence when both it and `double` are supplied
137
+ * @param {string[]} [modifiers] - Canonical modifier names are 'ctrl', 'alt', 'shift', and 'cmd'. Held for the duration of the click
81
138
  * @returns {Promise<MouseClickResponse>} Click operation result
82
139
  *
83
140
  * @example
@@ -90,10 +147,16 @@ let Mouse = (() => {
90
147
  *
91
148
  * // Right click
92
149
  * const rightClick = await sandbox.computerUse.mouse.click(100, 200, 'right');
150
+ *
151
+ * // Triple click to select a line
152
+ * const tripleClick = await sandbox.computerUse.mouse.click(100, 200, 'left', false, 3);
153
+ *
154
+ * // Ctrl+click to extend a selection
155
+ * const ctrlClick = await sandbox.computerUse.mouse.click(100, 200, 'left', false, undefined, ['ctrl']);
93
156
  * ```
94
157
  */
95
- async click(x, y, button = 'left', double = false) {
96
- const request = { x, y, button, double };
158
+ async click(x, y, button = 'left', double = false, clicks, modifiers) {
159
+ const request = { x, y, button, double, clicks, modifiers };
97
160
  const response = await this.apiClient.click(request);
98
161
  return response.data;
99
162
  }
@@ -105,16 +168,20 @@ let Mouse = (() => {
105
168
  * @param {number} endX - The ending x coordinate
106
169
  * @param {number} endY - The ending y coordinate
107
170
  * @param {string} [button='left'] - The mouse button to use for dragging
171
+ * @param {string[]} [modifiers] - Canonical modifier names are 'ctrl', 'alt', 'shift', and 'cmd'. Held for the duration of the drag
108
172
  * @returns {Promise<MouseDragResponse>} Drag operation result
109
173
  *
110
174
  * @example
111
175
  * ```typescript
112
176
  * const result = await sandbox.computerUse.mouse.drag(50, 50, 150, 150);
113
177
  * console.log(`Drag ended at: ${result.x}, ${result.y}`);
178
+ *
179
+ * // Shift-constrained drag
180
+ * const constrained = await sandbox.computerUse.mouse.drag(50, 50, 150, 150, 'left', ['shift']);
114
181
  * ```
115
182
  */
116
- async drag(startX, startY, endX, endY, button = 'left') {
117
- const request = { startX, startY, endX, endY, button };
183
+ async drag(startX, startY, endX, endY, button = 'left', modifiers) {
184
+ const request = { startX, startY, endX, endY, button, modifiers };
118
185
  const response = await this.apiClient.drag(request);
119
186
  return response.data;
120
187
  }
@@ -123,8 +190,9 @@ let Mouse = (() => {
123
190
  *
124
191
  * @param {number} x - The x coordinate to scroll at
125
192
  * @param {number} y - The y coordinate to scroll at
126
- * @param {'up' | 'down'} direction - The direction to scroll
193
+ * @param {'up' | 'down' | 'left' | 'right'} direction - The direction to scroll
127
194
  * @param {number} [amount=1] - The amount to scroll
195
+ * @param {string[]} [modifiers] - Canonical modifier names are 'ctrl', 'alt', 'shift', and 'cmd'. Held for the duration of the scroll
128
196
  * @returns {Promise<boolean>} Whether the scroll operation was successful
129
197
  *
130
198
  * @example
@@ -134,10 +202,16 @@ let Mouse = (() => {
134
202
  *
135
203
  * // Scroll down
136
204
  * const scrollDown = await sandbox.computerUse.mouse.scroll(100, 200, 'down', 5);
205
+ *
206
+ * // Horizontal scroll
207
+ * const scrollRight = await sandbox.computerUse.mouse.scroll(100, 200, 'right', 2);
208
+ *
209
+ * // Ctrl+scroll to zoom
210
+ * const zoomIn = await sandbox.computerUse.mouse.scroll(100, 200, 'up', 1, ['ctrl']);
137
211
  * ```
138
212
  */
139
- async scroll(x, y, direction, amount = 1) {
140
- const request = { x, y, direction, amount };
213
+ async scroll(x, y, direction, amount = 1, modifiers) {
214
+ const request = { x, y, direction, amount, modifiers };
141
215
  const response = await this.apiClient.scroll(request);
142
216
  return response.data.success;
143
217
  }
@@ -151,15 +225,21 @@ let Keyboard = (() => {
151
225
  let _instanceExtraInitializers = [];
152
226
  let _type_decorators;
153
227
  let _press_decorators;
228
+ let _down_decorators;
229
+ let _up_decorators;
154
230
  let _hotkey_decorators;
155
231
  return class Keyboard {
156
232
  static {
157
233
  const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(null) : void 0;
158
234
  _type_decorators = [(0, otel_decorator_1.WithInstrumentation)()];
159
235
  _press_decorators = [(0, otel_decorator_1.WithInstrumentation)()];
236
+ _down_decorators = [(0, otel_decorator_1.WithInstrumentation)()];
237
+ _up_decorators = [(0, otel_decorator_1.WithInstrumentation)()];
160
238
  _hotkey_decorators = [(0, otel_decorator_1.WithInstrumentation)()];
161
239
  tslib_1.__esDecorate(this, null, _type_decorators, { kind: "method", name: "type", static: false, private: false, access: { has: obj => "type" in obj, get: obj => obj.type }, metadata: _metadata }, null, _instanceExtraInitializers);
162
240
  tslib_1.__esDecorate(this, null, _press_decorators, { kind: "method", name: "press", static: false, private: false, access: { has: obj => "press" in obj, get: obj => obj.press }, metadata: _metadata }, null, _instanceExtraInitializers);
241
+ tslib_1.__esDecorate(this, null, _down_decorators, { kind: "method", name: "down", static: false, private: false, access: { has: obj => "down" in obj, get: obj => obj.down }, metadata: _metadata }, null, _instanceExtraInitializers);
242
+ tslib_1.__esDecorate(this, null, _up_decorators, { kind: "method", name: "up", static: false, private: false, access: { has: obj => "up" in obj, get: obj => obj.up }, metadata: _metadata }, null, _instanceExtraInitializers);
163
243
  tslib_1.__esDecorate(this, null, _hotkey_decorators, { kind: "method", name: "hotkey", static: false, private: false, access: { has: obj => "hotkey" in obj, get: obj => obj.hotkey }, metadata: _metadata }, null, _instanceExtraInitializers);
164
244
  if (_metadata) Object.defineProperty(this, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
165
245
  }
@@ -234,6 +314,52 @@ let Keyboard = (() => {
234
314
  const request = { key, modifiers };
235
315
  await this.apiClient.pressKey(request);
236
316
  }
317
+ /**
318
+ * Presses and holds a key
319
+ *
320
+ * The key stays held until a matching `up()` call is made, which enables
321
+ * press-and-hold interactions such as holding a modifier across several actions.
322
+ *
323
+ * @param {string} key - The key to hold. Uses the same normalized key contract as `press()`, including modifier names such as 'ctrl' and 'shift'.
324
+ * @throws {DaytonaError} If the key down operation fails
325
+ *
326
+ * @example
327
+ * ```typescript
328
+ * // Hold Shift while clicking twice, then release.
329
+ * // Release in `finally` so a failed click cannot leave Shift stuck down.
330
+ * await sandbox.computerUse.keyboard.down('shift');
331
+ * try {
332
+ * await sandbox.computerUse.mouse.click(100, 200);
333
+ * await sandbox.computerUse.mouse.click(300, 400);
334
+ * } finally {
335
+ * await sandbox.computerUse.keyboard.up('shift');
336
+ * }
337
+ * ```
338
+ */
339
+ async down(key) {
340
+ const request = { key };
341
+ await this.apiClient.keyDown(request);
342
+ }
343
+ /**
344
+ * Releases a held key
345
+ *
346
+ * @param {string} key - The key to release. Uses the same normalized key contract as `press()`, including modifier names such as 'ctrl' and 'shift'.
347
+ * @throws {DaytonaError} If the key up operation fails
348
+ *
349
+ * @example
350
+ * ```typescript
351
+ * try {
352
+ * await sandbox.computerUse.keyboard.up('shift');
353
+ * console.log('Operation success');
354
+ * } catch (e) {
355
+ * console.log('Operation failed:', e);
356
+ * }
357
+ * ```
358
+ */
359
+ async up(key) {
360
+ const request = { key };
361
+ await this.apiClient.keyUp(request);
362
+ }
237
363
  /**
238
364
  * Presses a hotkey combination
239
365
  *
@@ -1 +1 @@
1
- {"version":3,"file":"ComputerUse.js","sourceRoot":"","sources":["../../../../sdk-typescript/src/ComputerUse.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"ComputerUse.js","sourceRoot":"","sources":["../../../../sdk-typescript/src/ComputerUse.ts"],"names":[],"mappings":"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"}
package/cjs/Process.d.ts CHANGED
@@ -44,6 +44,19 @@ export declare class Process {
44
44
  /**
45
45
  * Executes a shell command in the Sandbox.
46
46
  *
47
+ * The command is run by the first available of zsh, bash or sh in the sandbox, which is zsh in the
48
+ * default snapshots. Quote arguments that contain glob characters, for example
49
+ * `pip install -e '.[test]'`, or wrap bash-specific scripts in `bash -c '...'`.
50
+ *
51
+ * The call returns when the command finishes. To start a long-running process such as a server, run
52
+ * it in the background with its output redirected, e.g. `python3 -m http.server 8000 > server.log 2>&1 &`,
53
+ * or use a session with `runAsync: true` (see `executeSessionCommand`). A background process that keeps
54
+ * the command's output open (`cmd &` without a redirect) can block the call until that process exits.
55
+ *
56
+ * Tools in the sandbox may report the host's CPU count and memory (for example `nproc` or
57
+ * `os.cpus()`) rather than the sandbox's own limits. Size worker pools from the sandbox's `cpu` and
58
+ * `memory` instead, e.g. `pytest -n 2` rather than `pytest -n auto`.
59
+ *
47
60
  * @param {string} command - Shell command to execute
48
61
  * @param {string} [cwd] - Working directory for command execution. If not specified, uses the sandbox working directory.
49
62
  * @param {Record<string, string>} [env] - Environment variables to set for the command
@@ -67,6 +80,10 @@ export declare class Process {
67
80
  * @example
68
81
  * // Command with timeout
69
82
  * const result = await process.executeCommand('sleep 10', undefined, 5);
83
+ *
84
+ * @example
85
+ * // Start a server in the background
86
+ * await process.executeCommand('python3 -m http.server 8000 > server.log 2>&1 &');
70
87
  */
71
88
  executeCommand(command: string, cwd?: string, env?: Record<string, string>, timeout?: number): Promise<ExecuteResponse>;
72
89
  /**
package/cjs/Process.js CHANGED
@@ -120,6 +120,19 @@ let Process = (() => {
120
120
  /**
121
121
  * Executes a shell command in the Sandbox.
122
122
  *
123
+ * The command is run by the first available of zsh, bash or sh in the sandbox, which is zsh in the
124
+ * default snapshots. Quote arguments that contain glob characters, for example
125
+ * `pip install -e '.[test]'`, or wrap bash-specific scripts in `bash -c '...'`.
126
+ *
127
+ * The call returns when the command finishes. To start a long-running process such as a server, run
128
+ * it in the background with its output redirected, e.g. `python3 -m http.server 8000 > server.log 2>&1 &`,
129
+ * or use a session with `runAsync: true` (see `executeSessionCommand`). A background process that keeps
130
+ * the command's output open (`cmd &` without a redirect) can block the call until that process exits.
131
+ *
132
+ * Tools in the sandbox may report the host's CPU count and memory (for example `nproc` or
133
+ * `os.cpus()`) rather than the sandbox's own limits. Size worker pools from the sandbox's `cpu` and
134
+ * `memory` instead, e.g. `pytest -n 2` rather than `pytest -n auto`.
135
+ *
123
136
  * @param {string} command - Shell command to execute
124
137
  * @param {string} [cwd] - Working directory for command execution. If not specified, uses the sandbox working directory.
125
138
  * @param {Record<string, string>} [env] - Environment variables to set for the command
@@ -143,6 +156,10 @@ let Process = (() => {
143
156
  * @example
144
157
  * // Command with timeout
145
158
  * const result = await process.executeCommand('sleep 10', undefined, 5);
159
+ *
160
+ * @example
161
+ * // Start a server in the background
162
+ * await process.executeCommand('python3 -m http.server 8000 > server.log 2>&1 &');
146
163
  */
147
164
  async executeCommand(command, cwd, env, timeout) {
148
165
  const response = await this.apiClient.executeCommand({
@@ -1 +1 @@
1
- {"version":3,"file":"Process.js","sourceRoot":"","sources":["../../../../sdk-typescript/src/Process.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"Process.js","sourceRoot":"","sources":["../../../../sdk-typescript/src/Process.ts"],"names":[],"mappings":"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"}
package/cjs/Sandbox.d.ts CHANGED
@@ -439,6 +439,21 @@ export declare class Sandbox {
439
439
  * await sandbox.setAutostopInterval(0);
440
440
  */
441
441
  setAutostopInterval(interval: number): Promise<void>;
442
+ /**
443
+ * Sets whether the Sandbox's preview URLs are publicly accessible.
444
+ *
445
+ * When public, preview URLs (see `getPreviewLink`) can be opened without a preview token or API key.
446
+ * When private, every preview request must authenticate.
447
+ *
448
+ * @param {boolean} isPublic - `true` to make preview URLs public, `false` to make them private.
449
+ * @returns {Promise<void>}
450
+ *
451
+ * @example
452
+ * await sandbox.setPublic(true);
453
+ * const preview = await sandbox.getPreviewLink(3000);
454
+ * // preview.url can now be opened without credentials
455
+ */
456
+ setPublic(isPublic: boolean): Promise<void>;
442
457
  /**
443
458
  * Set the auto-pause interval for the Sandbox.
444
459
  *
@@ -585,6 +600,12 @@ export declare class Sandbox {
585
600
  * it will be opened automatically. For private sandboxes, a token is included to grant access
586
601
  * to the URL.
587
602
  *
603
+ * For a private sandbox, requests to `url` must authenticate, otherwise they are answered with
604
+ * `401 Unauthorized`. Send the returned `token` in the `X-Daytona-Preview-Token` header, or send
605
+ * your Daytona API key as `Authorization: Bearer <api key>`. To get a URL that works without extra
606
+ * headers (for example to open it in a browser or share it), use `getSignedPreviewUrl` instead.
607
+ * Public sandboxes need no credentials.
608
+ *
588
609
  * @param {number} port - The port to open the preview link on.
589
610
  * @returns {PortPreviewUrl} The response object for the preview link, which includes the `url`
590
611
  * and the `token` (to access private sandboxes).
@@ -593,6 +614,11 @@ export declare class Sandbox {
593
614
  * const previewLink = await sandbox.getPreviewLink(3000);
594
615
  * console.log(`Preview URL: ${previewLink.url}`);
595
616
  * console.log(`Token: ${previewLink.token}`);
617
+ *
618
+ * // Fetch the private preview from outside the sandbox
619
+ * const response = await fetch(previewLink.url, {
620
+ * headers: { 'X-Daytona-Preview-Token': previewLink.token },
621
+ * });
596
622
  */
597
623
  getPreviewLink(port: number): Promise<PortPreviewUrl>;
598
624
  /**
@@ -640,9 +666,18 @@ export declare class Sandbox {
640
666
  /**
641
667
  * Retrieves a signed preview url for the sandbox at the specified port.
642
668
  *
669
+ * The access token is embedded in the returned URL, so it can be used without any headers, for
670
+ * example in a browser or by another service. The URL stops working when it expires (after 60
671
+ * seconds unless `expiresInSeconds` is set) or when it is expired with `expireSignedPreviewUrl`.
672
+ *
643
673
  * @param {number} port - The port to open the preview link on.
644
- * @param {number} [expiresInSeconds] - The number of seconds the signed preview url will be valid for. Defaults to 60 seconds.
674
+ * @param {number} [expiresInSeconds] - The number of seconds the signed preview url will be valid for. Defaults to 60 seconds;
675
+ * set a longer value for links that need to stay usable, e.g. `3600` for one hour.
645
676
  * @returns {Promise<SignedPortPreviewUrl>} The response object for the signed preview url.
677
+ *
678
+ * @example
679
+ * const signed = await sandbox.getSignedPreviewUrl(3000, 3600);
680
+ * console.log(`Preview URL (valid for one hour): ${signed.url}`);
646
681
  */
647
682
  getSignedPreviewUrl(port: number, expiresInSeconds?: number): Promise<SignedPortPreviewUrl>;
648
683
  /**