eve 0.46.1 → 0.47.0

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.
Files changed (124) hide show
  1. package/CHANGELOG.md +15 -0
  2. package/dist/src/channel/schedule.d.ts +1 -0
  3. package/dist/src/channel/schedule.js +1 -1
  4. package/dist/src/compiled/.vendor-stamp.json +2 -1
  5. package/dist/src/compiled/@vercel/sandbox/index.js +9 -15
  6. package/dist/src/compiled/@vercel/sandbox-delete/LICENSE +201 -0
  7. package/dist/src/compiled/@vercel/sandbox-delete/_async-retry.d.ts +8 -0
  8. package/dist/src/compiled/@vercel/sandbox-delete/_workflow-serde.d.ts +5 -0
  9. package/dist/src/compiled/@vercel/sandbox-delete/api-client/api-client.d.ts +1730 -0
  10. package/dist/src/compiled/@vercel/sandbox-delete/api-client/api-error.d.ts +29 -0
  11. package/dist/src/compiled/@vercel/sandbox-delete/api-client/base-client.d.ts +39 -0
  12. package/dist/src/compiled/@vercel/sandbox-delete/api-client/file-writer.d.ts +66 -0
  13. package/dist/src/compiled/@vercel/sandbox-delete/api-client/index.d.ts +2 -0
  14. package/dist/src/compiled/@vercel/sandbox-delete/api-client/validators.d.ts +907 -0
  15. package/dist/src/compiled/@vercel/sandbox-delete/api-client/with-retry.d.ts +10 -0
  16. package/dist/src/compiled/@vercel/sandbox-delete/auth/error.d.ts +15 -0
  17. package/dist/src/compiled/@vercel/sandbox-delete/auth/file.d.ts +18 -0
  18. package/dist/src/compiled/@vercel/sandbox-delete/auth/index.d.ts +6 -0
  19. package/dist/src/compiled/@vercel/sandbox-delete/auth/oauth.d.ts +111 -0
  20. package/dist/src/compiled/@vercel/sandbox-delete/auth/poll-for-token.d.ts +28 -0
  21. package/dist/src/compiled/@vercel/sandbox-delete/auth/project.d.ts +40 -0
  22. package/dist/src/compiled/@vercel/sandbox-delete/command.d.ts +292 -0
  23. package/dist/src/compiled/@vercel/sandbox-delete/constants.d.ts +15 -0
  24. package/dist/src/compiled/@vercel/sandbox-delete/execution-context.d.ts +116 -0
  25. package/dist/src/compiled/@vercel/sandbox-delete/filesystem.d.ts +258 -0
  26. package/dist/src/compiled/@vercel/sandbox-delete/index.d.ts +13 -0
  27. package/dist/src/compiled/@vercel/sandbox-delete/index.js +9 -0
  28. package/dist/src/compiled/@vercel/sandbox-delete/network-policy.d.ts +169 -0
  29. package/dist/src/compiled/@vercel/sandbox-delete/proxy.d.ts +55 -0
  30. package/dist/src/compiled/@vercel/sandbox-delete/sandbox-user.d.ts +211 -0
  31. package/dist/src/compiled/@vercel/sandbox-delete/sandbox.d.ts +1258 -0
  32. package/dist/src/compiled/@vercel/sandbox-delete/session.d.ts +435 -0
  33. package/dist/src/compiled/@vercel/sandbox-delete/snapshot.d.ts +238 -0
  34. package/dist/src/compiled/@vercel/sandbox-delete/utils/get-credentials.d.ts +21 -0
  35. package/dist/src/compiled/@vercel/sandbox-delete/utils/paginator.d.ts +16 -0
  36. package/dist/src/compiled/@vercel/sandbox-delete/utils/resolveSignal.d.ts +15 -0
  37. package/dist/src/compiled/@vercel/sandbox-delete/utils/sandbox-snapshot.d.ts +11 -0
  38. package/dist/src/compiled/@vercel/sandbox-delete/utils/types.d.ts +11 -0
  39. package/dist/src/compiled/_chunks/node/auth-DpzFWvTn.js +2 -0
  40. package/dist/src/compiled/_chunks/node/auth-QgeX8nBM.js +2 -0
  41. package/dist/src/compiled/_chunks/node/decode_jwt-Col8JOnf.js +7 -0
  42. package/dist/src/compiled/_chunks/node/version-DH6yRy-M.js +1 -0
  43. package/dist/src/compiled/_chunks/node/xdg-app-paths-Bys8q02u.js +1 -0
  44. package/dist/src/compiler/extension-compatibility.d.ts +12 -12
  45. package/dist/src/compiler/extension-compatibility.js +1 -1
  46. package/dist/src/compiler/model-catalog.js +1 -1
  47. package/dist/src/context/build-callback-context.js +1 -1
  48. package/dist/src/context/dynamic-tool-lifecycle.js +1 -1
  49. package/dist/src/context/keys.d.ts +2 -0
  50. package/dist/src/context/keys.js +1 -1
  51. package/dist/src/context/memory-tools.js +1 -1
  52. package/dist/src/context/providers/sandbox.js +1 -1
  53. package/dist/src/evals/context.js +1 -1
  54. package/dist/src/evals/session-content.d.ts +5 -0
  55. package/dist/src/evals/session-content.js +3 -0
  56. package/dist/src/evals/session.d.ts +1 -0
  57. package/dist/src/evals/session.js +1 -1
  58. package/dist/src/evals/types.d.ts +5 -0
  59. package/dist/src/execution/dispatch-runtime-actions-shared.js +1 -1
  60. package/dist/src/execution/eve-workflow-attributes.d.ts +3 -0
  61. package/dist/src/execution/eve-workflow-attributes.js +1 -1
  62. package/dist/src/execution/runtime-context.js +1 -1
  63. package/dist/src/execution/sandbox/bindings/docker-base-setup.d.ts +4 -4
  64. package/dist/src/execution/sandbox/bindings/docker-base-setup.js +1 -1
  65. package/dist/src/execution/sandbox/bindings/docker-session.d.ts +1 -1
  66. package/dist/src/execution/sandbox/bindings/docker-session.js +1 -1
  67. package/dist/src/execution/sandbox/bindings/docker.js +1 -1
  68. package/dist/src/execution/sandbox/bindings/just-bash-runtime.js +1 -1
  69. package/dist/src/execution/sandbox/bindings/microsandbox-lifecycle.js +1 -1
  70. package/dist/src/execution/sandbox/bindings/microsandbox-runtime.js +1 -1
  71. package/dist/src/execution/sandbox/bindings/vercel-base-runtime.d.ts +4 -0
  72. package/dist/src/execution/sandbox/bindings/vercel-base-runtime.js +2 -2
  73. package/dist/src/execution/sandbox/bindings/vercel-lifecycle.d.ts +8 -0
  74. package/dist/src/execution/sandbox/bindings/vercel-lifecycle.js +1 -0
  75. package/dist/src/execution/sandbox/bindings/vercel-sdk-types.d.ts +3 -0
  76. package/dist/src/execution/sandbox/bindings/vercel.d.ts +2 -1
  77. package/dist/src/execution/sandbox/bindings/vercel.js +1 -1
  78. package/dist/src/execution/sandbox/ensure.d.ts +2 -0
  79. package/dist/src/execution/sandbox/ensure.js +1 -1
  80. package/dist/src/execution/sandbox/require-sandbox.js +1 -1
  81. package/dist/src/execution/tasks/parent/tool-execution.js +1 -1
  82. package/dist/src/execution/tools/connection-search.js +2 -2
  83. package/dist/src/execution/tools/file-state.js +1 -1
  84. package/dist/src/execution/tools/load-skill.js +1 -1
  85. package/dist/src/execution/tools/subagent/local.js +1 -1
  86. package/dist/src/execution/workflow-steps.js +1 -1
  87. package/dist/src/harness/approval-delivery-coordinator.js +1 -1
  88. package/dist/src/harness/attachment-staging.js +1 -1
  89. package/dist/src/harness/authorization.js +1 -1
  90. package/dist/src/harness/current-messages.d.ts +15 -0
  91. package/dist/src/harness/current-messages.js +1 -0
  92. package/dist/src/harness/instrumentation/runtime-context.js +1 -1
  93. package/dist/src/harness/instrumentation/state.js +1 -1
  94. package/dist/src/harness/step-hooks.js +1 -1
  95. package/dist/src/harness/tool-loop.js +2 -2
  96. package/dist/src/harness/tools.js +1 -1
  97. package/dist/src/internal/application/package.js +1 -1
  98. package/dist/src/internal/model-catalog.js +1 -1
  99. package/dist/src/packages/eve-catalog/src/index.js +1 -1
  100. package/dist/src/public/channels/chat-sdk/chatSdkChannel.js +2 -2
  101. package/dist/src/public/definitions/sandbox-backend.d.ts +1 -1
  102. package/dist/src/public/sandbox/index.d.ts +1 -1
  103. package/dist/src/runtime/agent/resolve-model.js +1 -1
  104. package/dist/src/runtime/connections/principal.js +1 -1
  105. package/dist/src/sandbox/state.d.ts +2 -0
  106. package/dist/src/setup/scaffold/create/project.js +1 -1
  107. package/dist/src/setup/scaffold/create/web-template.d.ts +1 -1
  108. package/dist/src/setup/scaffold/create/web-template.js +4 -2
  109. package/dist/src/shared/sandbox-backend.d.ts +9 -0
  110. package/dist/src/shared/sandbox-definition.d.ts +5 -4
  111. package/dist/src/shared/sandbox-session.d.ts +4 -1
  112. package/dist/src/tasks/delivery-policy.d.ts +12 -0
  113. package/dist/src/tasks/delivery-policy.js +1 -0
  114. package/dist/src/tracing/agent-trace-context-store.js +1 -1
  115. package/docs/evals/cases.mdx +11 -2
  116. package/docs/evals/judge.mdx +15 -0
  117. package/docs/evals/overview.mdx +2 -2
  118. package/docs/guides/instrumentation.md +1 -0
  119. package/docs/guides/session-context.md +2 -2
  120. package/docs/sandbox.mdx +25 -2
  121. package/docs/schedules.mdx +2 -0
  122. package/docs/tools/overview.mdx +2 -0
  123. package/package.json +2 -1
  124. package/dist/src/compiled/_chunks/node/auth-BaNbsImr.js +0 -2
@@ -0,0 +1,1730 @@
1
+ import { BaseClient, Parsed, RequestParams } from "./base-client.js";
2
+ import { CommandData, CommandFinishedData, CommandFinishedResponse, CommandResponse, CreateSnapshotResponse, InteractiveSessionResponse, LogOutputLine, SessionResponse, SnapshotResponse, StopSessionResponse } from "./validators.js";
3
+ import { FileWriter } from "./file-writer.js";
4
+ import { NetworkPolicy } from "../network-policy.js";
5
+ import { WithPrivate } from "../utils/types.js";
6
+ import { RUNTIMES, SandboxRegion } from "../constants.js";
7
+ import { z } from "#compiled/zod/index.js";
8
+ import { Readable } from "stream";
9
+
10
+ //#region src/api-client/api-client.d.ts
11
+ interface WithFetchOptions {
12
+ fetch?: typeof globalThis.fetch;
13
+ }
14
+ declare class APIClient extends BaseClient {
15
+ private teamId;
16
+ private projectId;
17
+ private isJwtToken;
18
+ constructor(params: {
19
+ baseUrl?: string;
20
+ teamId: string;
21
+ token: string;
22
+ fetch?: typeof globalThis.fetch;
23
+ });
24
+ private ensureValidToken;
25
+ protected request(path: string, params?: RequestParams): Promise<Response>;
26
+ getSession(params: WithPrivate<{
27
+ sessionId: string;
28
+ signal?: AbortSignal;
29
+ }>): Promise<Parsed<{
30
+ session: {
31
+ [x: string]: unknown;
32
+ id: string;
33
+ memory: number;
34
+ vcpus: number;
35
+ region: string;
36
+ timeout: number;
37
+ status: "pending" | "running" | "stopping" | "stopped" | "failed" | "aborted" | "snapshotting";
38
+ requestedAt: number;
39
+ createdAt: number;
40
+ cwd: string;
41
+ updatedAt: number;
42
+ runtime?: string | undefined;
43
+ startedAt?: number | undefined;
44
+ requestedStopAt?: number | undefined;
45
+ stoppedAt?: number | undefined;
46
+ abortedAt?: number | undefined;
47
+ duration?: number | undefined;
48
+ sourceSnapshotId?: string | undefined;
49
+ snapshottedAt?: number | undefined;
50
+ interactivePort?: number | undefined;
51
+ networkPolicy?: {
52
+ [x: string]: unknown;
53
+ mode: "allow-all";
54
+ } | {
55
+ [x: string]: unknown;
56
+ mode: "deny-all";
57
+ } | {
58
+ [x: string]: unknown;
59
+ mode: "custom";
60
+ allowedDomains?: string[] | undefined;
61
+ allowedCIDRs?: string[] | undefined;
62
+ deniedCIDRs?: string[] | undefined;
63
+ injectionRules?: {
64
+ domain: string;
65
+ headers?: Record<string, string> | undefined;
66
+ headerNames?: string[] | undefined;
67
+ match?: {
68
+ path?: {
69
+ exact?: string | undefined;
70
+ startsWith?: string | undefined;
71
+ regex?: string | undefined;
72
+ } | undefined;
73
+ method?: string[] | undefined;
74
+ queryString?: {
75
+ key?: {
76
+ exact?: string | undefined;
77
+ startsWith?: string | undefined;
78
+ regex?: string | undefined;
79
+ } | undefined;
80
+ value?: {
81
+ exact?: string | undefined;
82
+ startsWith?: string | undefined;
83
+ regex?: string | undefined;
84
+ } | undefined;
85
+ }[] | undefined;
86
+ headers?: {
87
+ key?: {
88
+ exact?: string | undefined;
89
+ startsWith?: string | undefined;
90
+ regex?: string | undefined;
91
+ } | undefined;
92
+ value?: {
93
+ exact?: string | undefined;
94
+ startsWith?: string | undefined;
95
+ regex?: string | undefined;
96
+ } | undefined;
97
+ }[] | undefined;
98
+ } | undefined;
99
+ }[] | undefined;
100
+ forwardRules?: {
101
+ domain: string;
102
+ forwardURL: string;
103
+ match?: {
104
+ path?: {
105
+ exact?: string | undefined;
106
+ startsWith?: string | undefined;
107
+ regex?: string | undefined;
108
+ } | undefined;
109
+ method?: string[] | undefined;
110
+ queryString?: {
111
+ key?: {
112
+ exact?: string | undefined;
113
+ startsWith?: string | undefined;
114
+ regex?: string | undefined;
115
+ } | undefined;
116
+ value?: {
117
+ exact?: string | undefined;
118
+ startsWith?: string | undefined;
119
+ regex?: string | undefined;
120
+ } | undefined;
121
+ }[] | undefined;
122
+ headers?: {
123
+ key?: {
124
+ exact?: string | undefined;
125
+ startsWith?: string | undefined;
126
+ regex?: string | undefined;
127
+ } | undefined;
128
+ value?: {
129
+ exact?: string | undefined;
130
+ startsWith?: string | undefined;
131
+ regex?: string | undefined;
132
+ } | undefined;
133
+ }[] | undefined;
134
+ } | undefined;
135
+ }[] | undefined;
136
+ } | undefined;
137
+ activeCpuDurationMs?: number | undefined;
138
+ networkTransfer?: {
139
+ ingress: number;
140
+ egress: number;
141
+ } | undefined;
142
+ };
143
+ routes: {
144
+ url: string;
145
+ subdomain: string;
146
+ port: number;
147
+ }[];
148
+ }>>;
149
+ createSandbox(params: WithPrivate<{
150
+ name?: string;
151
+ ports?: number[];
152
+ projectId: string;
153
+ source?: {
154
+ type: "git";
155
+ url: string;
156
+ depth?: number;
157
+ revision?: string;
158
+ username?: string;
159
+ password?: string;
160
+ } | {
161
+ type: "tarball";
162
+ url: string;
163
+ } | {
164
+ type: "snapshot";
165
+ snapshotId: string;
166
+ };
167
+ timeout?: number;
168
+ resources?: {
169
+ vcpus: number;
170
+ };
171
+ persistent?: boolean;
172
+ runtime?: RUNTIMES | (string & {});
173
+ image?: string;
174
+ networkPolicy?: NetworkPolicy;
175
+ env?: Record<string, string>;
176
+ tags?: Record<string, string>;
177
+ snapshotExpiration?: number;
178
+ keepLastSnapshots?: {
179
+ count: number;
180
+ expiration?: number;
181
+ deleteEvicted?: boolean;
182
+ };
183
+ region?: SandboxRegion;
184
+ failoverRegions?: SandboxRegion[];
185
+ signal?: AbortSignal;
186
+ }>): Promise<Parsed<{
187
+ sandbox: {
188
+ name: string;
189
+ persistent: boolean;
190
+ createdAt: number;
191
+ updatedAt: number;
192
+ currentSessionId: string;
193
+ status: "pending" | "running" | "stopping" | "stopped" | "failed" | "aborted" | "snapshotting";
194
+ region?: string | undefined;
195
+ failoverRegions?: string[] | undefined;
196
+ vcpus?: number | undefined;
197
+ memory?: number | undefined;
198
+ runtime?: string | undefined;
199
+ image?: string | undefined;
200
+ timeout?: number | undefined;
201
+ networkPolicy?: {
202
+ [x: string]: unknown;
203
+ mode: "allow-all";
204
+ } | {
205
+ [x: string]: unknown;
206
+ mode: "deny-all";
207
+ } | {
208
+ [x: string]: unknown;
209
+ mode: "custom";
210
+ allowedDomains?: string[] | undefined;
211
+ allowedCIDRs?: string[] | undefined;
212
+ deniedCIDRs?: string[] | undefined;
213
+ injectionRules?: {
214
+ domain: string;
215
+ headers?: Record<string, string> | undefined;
216
+ headerNames?: string[] | undefined;
217
+ match?: {
218
+ path?: {
219
+ exact?: string | undefined;
220
+ startsWith?: string | undefined;
221
+ regex?: string | undefined;
222
+ } | undefined;
223
+ method?: string[] | undefined;
224
+ queryString?: {
225
+ key?: {
226
+ exact?: string | undefined;
227
+ startsWith?: string | undefined;
228
+ regex?: string | undefined;
229
+ } | undefined;
230
+ value?: {
231
+ exact?: string | undefined;
232
+ startsWith?: string | undefined;
233
+ regex?: string | undefined;
234
+ } | undefined;
235
+ }[] | undefined;
236
+ headers?: {
237
+ key?: {
238
+ exact?: string | undefined;
239
+ startsWith?: string | undefined;
240
+ regex?: string | undefined;
241
+ } | undefined;
242
+ value?: {
243
+ exact?: string | undefined;
244
+ startsWith?: string | undefined;
245
+ regex?: string | undefined;
246
+ } | undefined;
247
+ }[] | undefined;
248
+ } | undefined;
249
+ }[] | undefined;
250
+ forwardRules?: {
251
+ domain: string;
252
+ forwardURL: string;
253
+ match?: {
254
+ path?: {
255
+ exact?: string | undefined;
256
+ startsWith?: string | undefined;
257
+ regex?: string | undefined;
258
+ } | undefined;
259
+ method?: string[] | undefined;
260
+ queryString?: {
261
+ key?: {
262
+ exact?: string | undefined;
263
+ startsWith?: string | undefined;
264
+ regex?: string | undefined;
265
+ } | undefined;
266
+ value?: {
267
+ exact?: string | undefined;
268
+ startsWith?: string | undefined;
269
+ regex?: string | undefined;
270
+ } | undefined;
271
+ }[] | undefined;
272
+ headers?: {
273
+ key?: {
274
+ exact?: string | undefined;
275
+ startsWith?: string | undefined;
276
+ regex?: string | undefined;
277
+ } | undefined;
278
+ value?: {
279
+ exact?: string | undefined;
280
+ startsWith?: string | undefined;
281
+ regex?: string | undefined;
282
+ } | undefined;
283
+ }[] | undefined;
284
+ } | undefined;
285
+ }[] | undefined;
286
+ } | undefined;
287
+ totalEgressBytes?: number | undefined;
288
+ totalIngressBytes?: number | undefined;
289
+ totalActiveCpuDurationMs?: number | undefined;
290
+ totalDurationMs?: number | undefined;
291
+ expiresAt?: number | undefined;
292
+ currentSnapshotId?: string | undefined;
293
+ statusUpdatedAt?: number | undefined;
294
+ cwd?: string | undefined;
295
+ tags?: Record<string, string> | undefined;
296
+ snapshotExpiration?: number | undefined;
297
+ keepLastSnapshots?: {
298
+ count: number;
299
+ expiration?: number | undefined;
300
+ deleteEvicted?: boolean | undefined;
301
+ } | undefined;
302
+ };
303
+ session: {
304
+ [x: string]: unknown;
305
+ id: string;
306
+ memory: number;
307
+ vcpus: number;
308
+ region: string;
309
+ timeout: number;
310
+ status: "pending" | "running" | "stopping" | "stopped" | "failed" | "aborted" | "snapshotting";
311
+ requestedAt: number;
312
+ createdAt: number;
313
+ cwd: string;
314
+ updatedAt: number;
315
+ runtime?: string | undefined;
316
+ startedAt?: number | undefined;
317
+ requestedStopAt?: number | undefined;
318
+ stoppedAt?: number | undefined;
319
+ abortedAt?: number | undefined;
320
+ duration?: number | undefined;
321
+ sourceSnapshotId?: string | undefined;
322
+ snapshottedAt?: number | undefined;
323
+ interactivePort?: number | undefined;
324
+ networkPolicy?: {
325
+ [x: string]: unknown;
326
+ mode: "allow-all";
327
+ } | {
328
+ [x: string]: unknown;
329
+ mode: "deny-all";
330
+ } | {
331
+ [x: string]: unknown;
332
+ mode: "custom";
333
+ allowedDomains?: string[] | undefined;
334
+ allowedCIDRs?: string[] | undefined;
335
+ deniedCIDRs?: string[] | undefined;
336
+ injectionRules?: {
337
+ domain: string;
338
+ headers?: Record<string, string> | undefined;
339
+ headerNames?: string[] | undefined;
340
+ match?: {
341
+ path?: {
342
+ exact?: string | undefined;
343
+ startsWith?: string | undefined;
344
+ regex?: string | undefined;
345
+ } | undefined;
346
+ method?: string[] | undefined;
347
+ queryString?: {
348
+ key?: {
349
+ exact?: string | undefined;
350
+ startsWith?: string | undefined;
351
+ regex?: string | undefined;
352
+ } | undefined;
353
+ value?: {
354
+ exact?: string | undefined;
355
+ startsWith?: string | undefined;
356
+ regex?: string | undefined;
357
+ } | undefined;
358
+ }[] | undefined;
359
+ headers?: {
360
+ key?: {
361
+ exact?: string | undefined;
362
+ startsWith?: string | undefined;
363
+ regex?: string | undefined;
364
+ } | undefined;
365
+ value?: {
366
+ exact?: string | undefined;
367
+ startsWith?: string | undefined;
368
+ regex?: string | undefined;
369
+ } | undefined;
370
+ }[] | undefined;
371
+ } | undefined;
372
+ }[] | undefined;
373
+ forwardRules?: {
374
+ domain: string;
375
+ forwardURL: string;
376
+ match?: {
377
+ path?: {
378
+ exact?: string | undefined;
379
+ startsWith?: string | undefined;
380
+ regex?: string | undefined;
381
+ } | undefined;
382
+ method?: string[] | undefined;
383
+ queryString?: {
384
+ key?: {
385
+ exact?: string | undefined;
386
+ startsWith?: string | undefined;
387
+ regex?: string | undefined;
388
+ } | undefined;
389
+ value?: {
390
+ exact?: string | undefined;
391
+ startsWith?: string | undefined;
392
+ regex?: string | undefined;
393
+ } | undefined;
394
+ }[] | undefined;
395
+ headers?: {
396
+ key?: {
397
+ exact?: string | undefined;
398
+ startsWith?: string | undefined;
399
+ regex?: string | undefined;
400
+ } | undefined;
401
+ value?: {
402
+ exact?: string | undefined;
403
+ startsWith?: string | undefined;
404
+ regex?: string | undefined;
405
+ } | undefined;
406
+ }[] | undefined;
407
+ } | undefined;
408
+ }[] | undefined;
409
+ } | undefined;
410
+ activeCpuDurationMs?: number | undefined;
411
+ networkTransfer?: {
412
+ ingress: number;
413
+ egress: number;
414
+ } | undefined;
415
+ };
416
+ routes: {
417
+ url: string;
418
+ subdomain: string;
419
+ port: number;
420
+ }[];
421
+ resumed?: boolean | undefined;
422
+ }>>;
423
+ forkSandbox(params: WithPrivate<{
424
+ sourceSandbox: string;
425
+ projectId: string;
426
+ name?: string;
427
+ ports?: number[];
428
+ timeout?: number;
429
+ resources?: {
430
+ vcpus: number;
431
+ };
432
+ persistent?: boolean;
433
+ image?: string;
434
+ networkPolicy?: NetworkPolicy;
435
+ env?: Record<string, string>;
436
+ tags?: Record<string, string>;
437
+ snapshotExpiration?: number;
438
+ keepLastSnapshots?: {
439
+ count: number;
440
+ expiration?: number;
441
+ deleteEvicted?: boolean;
442
+ };
443
+ region?: SandboxRegion;
444
+ failoverRegions?: SandboxRegion[];
445
+ signal?: AbortSignal;
446
+ }>): Promise<Parsed<{
447
+ sandbox: {
448
+ name: string;
449
+ persistent: boolean;
450
+ createdAt: number;
451
+ updatedAt: number;
452
+ currentSessionId: string;
453
+ status: "pending" | "running" | "stopping" | "stopped" | "failed" | "aborted" | "snapshotting";
454
+ region?: string | undefined;
455
+ failoverRegions?: string[] | undefined;
456
+ vcpus?: number | undefined;
457
+ memory?: number | undefined;
458
+ runtime?: string | undefined;
459
+ image?: string | undefined;
460
+ timeout?: number | undefined;
461
+ networkPolicy?: {
462
+ [x: string]: unknown;
463
+ mode: "allow-all";
464
+ } | {
465
+ [x: string]: unknown;
466
+ mode: "deny-all";
467
+ } | {
468
+ [x: string]: unknown;
469
+ mode: "custom";
470
+ allowedDomains?: string[] | undefined;
471
+ allowedCIDRs?: string[] | undefined;
472
+ deniedCIDRs?: string[] | undefined;
473
+ injectionRules?: {
474
+ domain: string;
475
+ headers?: Record<string, string> | undefined;
476
+ headerNames?: string[] | undefined;
477
+ match?: {
478
+ path?: {
479
+ exact?: string | undefined;
480
+ startsWith?: string | undefined;
481
+ regex?: string | undefined;
482
+ } | undefined;
483
+ method?: string[] | undefined;
484
+ queryString?: {
485
+ key?: {
486
+ exact?: string | undefined;
487
+ startsWith?: string | undefined;
488
+ regex?: string | undefined;
489
+ } | undefined;
490
+ value?: {
491
+ exact?: string | undefined;
492
+ startsWith?: string | undefined;
493
+ regex?: string | undefined;
494
+ } | undefined;
495
+ }[] | undefined;
496
+ headers?: {
497
+ key?: {
498
+ exact?: string | undefined;
499
+ startsWith?: string | undefined;
500
+ regex?: string | undefined;
501
+ } | undefined;
502
+ value?: {
503
+ exact?: string | undefined;
504
+ startsWith?: string | undefined;
505
+ regex?: string | undefined;
506
+ } | undefined;
507
+ }[] | undefined;
508
+ } | undefined;
509
+ }[] | undefined;
510
+ forwardRules?: {
511
+ domain: string;
512
+ forwardURL: string;
513
+ match?: {
514
+ path?: {
515
+ exact?: string | undefined;
516
+ startsWith?: string | undefined;
517
+ regex?: string | undefined;
518
+ } | undefined;
519
+ method?: string[] | undefined;
520
+ queryString?: {
521
+ key?: {
522
+ exact?: string | undefined;
523
+ startsWith?: string | undefined;
524
+ regex?: string | undefined;
525
+ } | undefined;
526
+ value?: {
527
+ exact?: string | undefined;
528
+ startsWith?: string | undefined;
529
+ regex?: string | undefined;
530
+ } | undefined;
531
+ }[] | undefined;
532
+ headers?: {
533
+ key?: {
534
+ exact?: string | undefined;
535
+ startsWith?: string | undefined;
536
+ regex?: string | undefined;
537
+ } | undefined;
538
+ value?: {
539
+ exact?: string | undefined;
540
+ startsWith?: string | undefined;
541
+ regex?: string | undefined;
542
+ } | undefined;
543
+ }[] | undefined;
544
+ } | undefined;
545
+ }[] | undefined;
546
+ } | undefined;
547
+ totalEgressBytes?: number | undefined;
548
+ totalIngressBytes?: number | undefined;
549
+ totalActiveCpuDurationMs?: number | undefined;
550
+ totalDurationMs?: number | undefined;
551
+ expiresAt?: number | undefined;
552
+ currentSnapshotId?: string | undefined;
553
+ statusUpdatedAt?: number | undefined;
554
+ cwd?: string | undefined;
555
+ tags?: Record<string, string> | undefined;
556
+ snapshotExpiration?: number | undefined;
557
+ keepLastSnapshots?: {
558
+ count: number;
559
+ expiration?: number | undefined;
560
+ deleteEvicted?: boolean | undefined;
561
+ } | undefined;
562
+ };
563
+ session: {
564
+ [x: string]: unknown;
565
+ id: string;
566
+ memory: number;
567
+ vcpus: number;
568
+ region: string;
569
+ timeout: number;
570
+ status: "pending" | "running" | "stopping" | "stopped" | "failed" | "aborted" | "snapshotting";
571
+ requestedAt: number;
572
+ createdAt: number;
573
+ cwd: string;
574
+ updatedAt: number;
575
+ runtime?: string | undefined;
576
+ startedAt?: number | undefined;
577
+ requestedStopAt?: number | undefined;
578
+ stoppedAt?: number | undefined;
579
+ abortedAt?: number | undefined;
580
+ duration?: number | undefined;
581
+ sourceSnapshotId?: string | undefined;
582
+ snapshottedAt?: number | undefined;
583
+ interactivePort?: number | undefined;
584
+ networkPolicy?: {
585
+ [x: string]: unknown;
586
+ mode: "allow-all";
587
+ } | {
588
+ [x: string]: unknown;
589
+ mode: "deny-all";
590
+ } | {
591
+ [x: string]: unknown;
592
+ mode: "custom";
593
+ allowedDomains?: string[] | undefined;
594
+ allowedCIDRs?: string[] | undefined;
595
+ deniedCIDRs?: string[] | undefined;
596
+ injectionRules?: {
597
+ domain: string;
598
+ headers?: Record<string, string> | undefined;
599
+ headerNames?: string[] | undefined;
600
+ match?: {
601
+ path?: {
602
+ exact?: string | undefined;
603
+ startsWith?: string | undefined;
604
+ regex?: string | undefined;
605
+ } | undefined;
606
+ method?: string[] | undefined;
607
+ queryString?: {
608
+ key?: {
609
+ exact?: string | undefined;
610
+ startsWith?: string | undefined;
611
+ regex?: string | undefined;
612
+ } | undefined;
613
+ value?: {
614
+ exact?: string | undefined;
615
+ startsWith?: string | undefined;
616
+ regex?: string | undefined;
617
+ } | undefined;
618
+ }[] | undefined;
619
+ headers?: {
620
+ key?: {
621
+ exact?: string | undefined;
622
+ startsWith?: string | undefined;
623
+ regex?: string | undefined;
624
+ } | undefined;
625
+ value?: {
626
+ exact?: string | undefined;
627
+ startsWith?: string | undefined;
628
+ regex?: string | undefined;
629
+ } | undefined;
630
+ }[] | undefined;
631
+ } | undefined;
632
+ }[] | undefined;
633
+ forwardRules?: {
634
+ domain: string;
635
+ forwardURL: string;
636
+ match?: {
637
+ path?: {
638
+ exact?: string | undefined;
639
+ startsWith?: string | undefined;
640
+ regex?: string | undefined;
641
+ } | undefined;
642
+ method?: string[] | undefined;
643
+ queryString?: {
644
+ key?: {
645
+ exact?: string | undefined;
646
+ startsWith?: string | undefined;
647
+ regex?: string | undefined;
648
+ } | undefined;
649
+ value?: {
650
+ exact?: string | undefined;
651
+ startsWith?: string | undefined;
652
+ regex?: string | undefined;
653
+ } | undefined;
654
+ }[] | undefined;
655
+ headers?: {
656
+ key?: {
657
+ exact?: string | undefined;
658
+ startsWith?: string | undefined;
659
+ regex?: string | undefined;
660
+ } | undefined;
661
+ value?: {
662
+ exact?: string | undefined;
663
+ startsWith?: string | undefined;
664
+ regex?: string | undefined;
665
+ } | undefined;
666
+ }[] | undefined;
667
+ } | undefined;
668
+ }[] | undefined;
669
+ } | undefined;
670
+ activeCpuDurationMs?: number | undefined;
671
+ networkTransfer?: {
672
+ ingress: number;
673
+ egress: number;
674
+ } | undefined;
675
+ };
676
+ routes: {
677
+ url: string;
678
+ subdomain: string;
679
+ port: number;
680
+ }[];
681
+ resumed?: boolean | undefined;
682
+ }>>;
683
+ runCommand(params: {
684
+ sessionId: string;
685
+ cwd?: string;
686
+ command: string;
687
+ args: string[];
688
+ env: Record<string, string>;
689
+ sudo: boolean;
690
+ wait: true;
691
+ logs?: boolean;
692
+ onLog?: (log: LogOutputLine) => void;
693
+ timeout?: number;
694
+ signal?: AbortSignal;
695
+ }): Promise<{
696
+ command: CommandData;
697
+ finished: Promise<CommandFinishedData>;
698
+ }>;
699
+ runCommand(params: {
700
+ sessionId: string;
701
+ cwd?: string;
702
+ command: string;
703
+ args: string[];
704
+ env: Record<string, string>;
705
+ sudo: boolean;
706
+ wait?: false;
707
+ timeout?: number;
708
+ signal?: AbortSignal;
709
+ }): Promise<Parsed<z.infer<typeof CommandResponse>>>;
710
+ getCommand(params: {
711
+ sessionId: string;
712
+ cmdId: string;
713
+ wait: true;
714
+ signal?: AbortSignal;
715
+ }): Promise<Parsed<z.infer<typeof CommandFinishedResponse>>>;
716
+ getCommand(params: {
717
+ sessionId: string;
718
+ cmdId: string;
719
+ wait?: boolean;
720
+ signal?: AbortSignal;
721
+ }): Promise<Parsed<z.infer<typeof CommandResponse>>>;
722
+ openInteractive(params: {
723
+ sessionId: string;
724
+ signal?: AbortSignal;
725
+ }): Promise<Parsed<z.infer<typeof InteractiveSessionResponse>>>;
726
+ mkDir(params: {
727
+ sessionId: string;
728
+ path: string;
729
+ cwd?: string;
730
+ signal?: AbortSignal;
731
+ }): Promise<Parsed<Record<string, never>>>;
732
+ getFileWriter(params: {
733
+ sessionId: string;
734
+ extractDir: string;
735
+ signal?: AbortSignal;
736
+ }): {
737
+ response: Promise<Response>;
738
+ writer: FileWriter;
739
+ };
740
+ listSessions(params: {
741
+ /**
742
+ * The ID or name of the project to which the sessions belong.
743
+ * @example "my-project"
744
+ */
745
+ projectId: string;
746
+ /**
747
+ * Filter sessions by sandbox name.
748
+ */
749
+ name?: string;
750
+ /**
751
+ * Maximum number of sessions to list from a request.
752
+ * @example 10
753
+ */
754
+ limit?: number;
755
+ /**
756
+ * Cursor for pagination.
757
+ */
758
+ cursor?: string;
759
+ /**
760
+ * Sort order for results.
761
+ */
762
+ sortOrder?: "asc" | "desc";
763
+ signal?: AbortSignal;
764
+ }): Promise<Parsed<{
765
+ sessions: {
766
+ [x: string]: unknown;
767
+ id: string;
768
+ memory: number;
769
+ vcpus: number;
770
+ region: string;
771
+ timeout: number;
772
+ status: "pending" | "running" | "stopping" | "stopped" | "failed" | "aborted" | "snapshotting";
773
+ requestedAt: number;
774
+ createdAt: number;
775
+ cwd: string;
776
+ updatedAt: number;
777
+ runtime?: string | undefined;
778
+ startedAt?: number | undefined;
779
+ requestedStopAt?: number | undefined;
780
+ stoppedAt?: number | undefined;
781
+ abortedAt?: number | undefined;
782
+ duration?: number | undefined;
783
+ sourceSnapshotId?: string | undefined;
784
+ snapshottedAt?: number | undefined;
785
+ interactivePort?: number | undefined;
786
+ networkPolicy?: {
787
+ [x: string]: unknown;
788
+ mode: "allow-all";
789
+ } | {
790
+ [x: string]: unknown;
791
+ mode: "deny-all";
792
+ } | {
793
+ [x: string]: unknown;
794
+ mode: "custom";
795
+ allowedDomains?: string[] | undefined;
796
+ allowedCIDRs?: string[] | undefined;
797
+ deniedCIDRs?: string[] | undefined;
798
+ injectionRules?: {
799
+ domain: string;
800
+ headers?: Record<string, string> | undefined;
801
+ headerNames?: string[] | undefined;
802
+ match?: {
803
+ path?: {
804
+ exact?: string | undefined;
805
+ startsWith?: string | undefined;
806
+ regex?: string | undefined;
807
+ } | undefined;
808
+ method?: string[] | undefined;
809
+ queryString?: {
810
+ key?: {
811
+ exact?: string | undefined;
812
+ startsWith?: string | undefined;
813
+ regex?: string | undefined;
814
+ } | undefined;
815
+ value?: {
816
+ exact?: string | undefined;
817
+ startsWith?: string | undefined;
818
+ regex?: string | undefined;
819
+ } | undefined;
820
+ }[] | undefined;
821
+ headers?: {
822
+ key?: {
823
+ exact?: string | undefined;
824
+ startsWith?: string | undefined;
825
+ regex?: string | undefined;
826
+ } | undefined;
827
+ value?: {
828
+ exact?: string | undefined;
829
+ startsWith?: string | undefined;
830
+ regex?: string | undefined;
831
+ } | undefined;
832
+ }[] | undefined;
833
+ } | undefined;
834
+ }[] | undefined;
835
+ forwardRules?: {
836
+ domain: string;
837
+ forwardURL: string;
838
+ match?: {
839
+ path?: {
840
+ exact?: string | undefined;
841
+ startsWith?: string | undefined;
842
+ regex?: string | undefined;
843
+ } | undefined;
844
+ method?: string[] | undefined;
845
+ queryString?: {
846
+ key?: {
847
+ exact?: string | undefined;
848
+ startsWith?: string | undefined;
849
+ regex?: string | undefined;
850
+ } | undefined;
851
+ value?: {
852
+ exact?: string | undefined;
853
+ startsWith?: string | undefined;
854
+ regex?: string | undefined;
855
+ } | undefined;
856
+ }[] | undefined;
857
+ headers?: {
858
+ key?: {
859
+ exact?: string | undefined;
860
+ startsWith?: string | undefined;
861
+ regex?: string | undefined;
862
+ } | undefined;
863
+ value?: {
864
+ exact?: string | undefined;
865
+ startsWith?: string | undefined;
866
+ regex?: string | undefined;
867
+ } | undefined;
868
+ }[] | undefined;
869
+ } | undefined;
870
+ }[] | undefined;
871
+ } | undefined;
872
+ activeCpuDurationMs?: number | undefined;
873
+ networkTransfer?: {
874
+ ingress: number;
875
+ egress: number;
876
+ } | undefined;
877
+ }[];
878
+ pagination: {
879
+ count: number;
880
+ next: string | null;
881
+ };
882
+ }>>;
883
+ listSnapshots(params: {
884
+ /**
885
+ * The ID or name of the project to which the snapshots belong.
886
+ * @example "my-project"
887
+ */
888
+ projectId: string;
889
+ /**
890
+ * Filter snapshots by sandbox name.
891
+ */
892
+ name?: string;
893
+ /**
894
+ * Maximum number of snapshots to list from a request.
895
+ * @example 10
896
+ */
897
+ limit?: number;
898
+ /**
899
+ * Cursor for pagination.
900
+ */
901
+ cursor?: string;
902
+ /**
903
+ * Sort order for results.
904
+ */
905
+ sortOrder?: "asc" | "desc";
906
+ signal?: AbortSignal;
907
+ }): Promise<Parsed<{
908
+ snapshots: {
909
+ id: string;
910
+ sourceSessionId: string;
911
+ region: string;
912
+ status: "failed" | "created" | "deleted";
913
+ sizeBytes: number;
914
+ createdAt: number;
915
+ updatedAt: number;
916
+ regions?: string[] | undefined;
917
+ expiresAt?: number | undefined;
918
+ lastUsedAt?: number | undefined;
919
+ creationMethod?: string | undefined;
920
+ parentId?: string | undefined;
921
+ }[];
922
+ pagination: {
923
+ count: number;
924
+ next: string | null;
925
+ };
926
+ }>>;
927
+ getSnapshotTree(params: {
928
+ /**
929
+ * The ID or name of the project to which the snapshots belong.
930
+ */
931
+ projectId: string;
932
+ /**
933
+ * The snapshot ID to use as the anchor for the tree traversal.
934
+ */
935
+ snapshotId: string;
936
+ /**
937
+ * Maximum number of nodes to return.
938
+ */
939
+ limit?: number;
940
+ /**
941
+ * Sort order: "asc" for descendants, "desc" for ancestors.
942
+ */
943
+ sortOrder?: "asc" | "desc";
944
+ signal?: AbortSignal;
945
+ }): Promise<Parsed<{
946
+ snapshots: {
947
+ snapshot: {
948
+ id: string;
949
+ sourceSessionId: string;
950
+ region: string;
951
+ status: "failed" | "created" | "deleted";
952
+ sizeBytes: number;
953
+ createdAt: number;
954
+ updatedAt: number;
955
+ regions?: string[] | undefined;
956
+ expiresAt?: number | undefined;
957
+ lastUsedAt?: number | undefined;
958
+ creationMethod?: string | undefined;
959
+ parentId?: string | undefined;
960
+ };
961
+ siblings: {
962
+ id: string;
963
+ sourceSessionId: string;
964
+ region: string;
965
+ status: "failed" | "created" | "deleted";
966
+ sizeBytes: number;
967
+ createdAt: number;
968
+ updatedAt: number;
969
+ regions?: string[] | undefined;
970
+ expiresAt?: number | undefined;
971
+ lastUsedAt?: number | undefined;
972
+ creationMethod?: string | undefined;
973
+ parentId?: string | undefined;
974
+ }[];
975
+ count: string;
976
+ }[];
977
+ pagination: {
978
+ count: number;
979
+ next: string | null;
980
+ };
981
+ anchor?: {
982
+ snapshot: {
983
+ id: string;
984
+ sourceSessionId: string;
985
+ region: string;
986
+ status: "failed" | "created" | "deleted";
987
+ sizeBytes: number;
988
+ createdAt: number;
989
+ updatedAt: number;
990
+ regions?: string[] | undefined;
991
+ expiresAt?: number | undefined;
992
+ lastUsedAt?: number | undefined;
993
+ creationMethod?: string | undefined;
994
+ parentId?: string | undefined;
995
+ };
996
+ siblings: {
997
+ id: string;
998
+ sourceSessionId: string;
999
+ region: string;
1000
+ status: "failed" | "created" | "deleted";
1001
+ sizeBytes: number;
1002
+ createdAt: number;
1003
+ updatedAt: number;
1004
+ regions?: string[] | undefined;
1005
+ expiresAt?: number | undefined;
1006
+ lastUsedAt?: number | undefined;
1007
+ creationMethod?: string | undefined;
1008
+ parentId?: string | undefined;
1009
+ }[];
1010
+ count: string;
1011
+ } | undefined;
1012
+ }>>;
1013
+ writeFiles(params: {
1014
+ sessionId: string;
1015
+ cwd: string;
1016
+ files: {
1017
+ path: string;
1018
+ content: string | Uint8Array;
1019
+ mode?: number;
1020
+ }[];
1021
+ extractDir: string;
1022
+ signal?: AbortSignal;
1023
+ }): Promise<void>;
1024
+ readFile(params: {
1025
+ sessionId: string;
1026
+ path: string;
1027
+ cwd?: string;
1028
+ signal?: AbortSignal;
1029
+ }): Promise<Readable | null>;
1030
+ killCommand(params: {
1031
+ sessionId: string;
1032
+ commandId: string;
1033
+ signal: number;
1034
+ abortSignal?: AbortSignal;
1035
+ }): Promise<Parsed<{
1036
+ command: {
1037
+ id: string;
1038
+ name: string;
1039
+ args: string[];
1040
+ cwd: string;
1041
+ sessionId: string;
1042
+ exitCode: number | null;
1043
+ startedAt: number;
1044
+ durationMs?: number | undefined;
1045
+ };
1046
+ }>>;
1047
+ getLogs(params: {
1048
+ sessionId: string;
1049
+ cmdId: string;
1050
+ signal?: AbortSignal;
1051
+ }): AsyncGenerator<LogOutputLine, void, void> & Disposable & {
1052
+ close(): void;
1053
+ };
1054
+ stopSession(params: {
1055
+ sessionId: string;
1056
+ signal?: AbortSignal;
1057
+ }): Promise<Parsed<z.infer<typeof StopSessionResponse>>>;
1058
+ updateNetworkPolicy(params: {
1059
+ sessionId: string;
1060
+ networkPolicy: NetworkPolicy;
1061
+ signal?: AbortSignal;
1062
+ }): Promise<Parsed<z.infer<typeof SessionResponse>>>;
1063
+ extendTimeout(params: {
1064
+ sessionId: string;
1065
+ duration: number;
1066
+ signal?: AbortSignal;
1067
+ }): Promise<Parsed<z.infer<typeof SessionResponse>>>;
1068
+ createSnapshot(params: {
1069
+ sessionId: string;
1070
+ expiration?: number;
1071
+ signal?: AbortSignal;
1072
+ }): Promise<Parsed<z.infer<typeof CreateSnapshotResponse>>>;
1073
+ deleteSnapshot(params: {
1074
+ snapshotId: string;
1075
+ signal?: AbortSignal;
1076
+ }): Promise<Parsed<z.infer<typeof SnapshotResponse>>>;
1077
+ getSnapshot(params: {
1078
+ snapshotId: string;
1079
+ signal?: AbortSignal;
1080
+ }): Promise<Parsed<z.infer<typeof SnapshotResponse>>>;
1081
+ getSandbox(params: WithPrivate<{
1082
+ name: string;
1083
+ projectId: string;
1084
+ resume?: boolean;
1085
+ signal?: AbortSignal;
1086
+ }>): Promise<Parsed<{
1087
+ sandbox: {
1088
+ name: string;
1089
+ persistent: boolean;
1090
+ createdAt: number;
1091
+ updatedAt: number;
1092
+ currentSessionId: string;
1093
+ status: "pending" | "running" | "stopping" | "stopped" | "failed" | "aborted" | "snapshotting";
1094
+ region?: string | undefined;
1095
+ failoverRegions?: string[] | undefined;
1096
+ vcpus?: number | undefined;
1097
+ memory?: number | undefined;
1098
+ runtime?: string | undefined;
1099
+ image?: string | undefined;
1100
+ timeout?: number | undefined;
1101
+ networkPolicy?: {
1102
+ [x: string]: unknown;
1103
+ mode: "allow-all";
1104
+ } | {
1105
+ [x: string]: unknown;
1106
+ mode: "deny-all";
1107
+ } | {
1108
+ [x: string]: unknown;
1109
+ mode: "custom";
1110
+ allowedDomains?: string[] | undefined;
1111
+ allowedCIDRs?: string[] | undefined;
1112
+ deniedCIDRs?: string[] | undefined;
1113
+ injectionRules?: {
1114
+ domain: string;
1115
+ headers?: Record<string, string> | undefined;
1116
+ headerNames?: string[] | undefined;
1117
+ match?: {
1118
+ path?: {
1119
+ exact?: string | undefined;
1120
+ startsWith?: string | undefined;
1121
+ regex?: string | undefined;
1122
+ } | undefined;
1123
+ method?: string[] | undefined;
1124
+ queryString?: {
1125
+ key?: {
1126
+ exact?: string | undefined;
1127
+ startsWith?: string | undefined;
1128
+ regex?: string | undefined;
1129
+ } | undefined;
1130
+ value?: {
1131
+ exact?: string | undefined;
1132
+ startsWith?: string | undefined;
1133
+ regex?: string | undefined;
1134
+ } | undefined;
1135
+ }[] | undefined;
1136
+ headers?: {
1137
+ key?: {
1138
+ exact?: string | undefined;
1139
+ startsWith?: string | undefined;
1140
+ regex?: string | undefined;
1141
+ } | undefined;
1142
+ value?: {
1143
+ exact?: string | undefined;
1144
+ startsWith?: string | undefined;
1145
+ regex?: string | undefined;
1146
+ } | undefined;
1147
+ }[] | undefined;
1148
+ } | undefined;
1149
+ }[] | undefined;
1150
+ forwardRules?: {
1151
+ domain: string;
1152
+ forwardURL: string;
1153
+ match?: {
1154
+ path?: {
1155
+ exact?: string | undefined;
1156
+ startsWith?: string | undefined;
1157
+ regex?: string | undefined;
1158
+ } | undefined;
1159
+ method?: string[] | undefined;
1160
+ queryString?: {
1161
+ key?: {
1162
+ exact?: string | undefined;
1163
+ startsWith?: string | undefined;
1164
+ regex?: string | undefined;
1165
+ } | undefined;
1166
+ value?: {
1167
+ exact?: string | undefined;
1168
+ startsWith?: string | undefined;
1169
+ regex?: string | undefined;
1170
+ } | undefined;
1171
+ }[] | undefined;
1172
+ headers?: {
1173
+ key?: {
1174
+ exact?: string | undefined;
1175
+ startsWith?: string | undefined;
1176
+ regex?: string | undefined;
1177
+ } | undefined;
1178
+ value?: {
1179
+ exact?: string | undefined;
1180
+ startsWith?: string | undefined;
1181
+ regex?: string | undefined;
1182
+ } | undefined;
1183
+ }[] | undefined;
1184
+ } | undefined;
1185
+ }[] | undefined;
1186
+ } | undefined;
1187
+ totalEgressBytes?: number | undefined;
1188
+ totalIngressBytes?: number | undefined;
1189
+ totalActiveCpuDurationMs?: number | undefined;
1190
+ totalDurationMs?: number | undefined;
1191
+ expiresAt?: number | undefined;
1192
+ currentSnapshotId?: string | undefined;
1193
+ statusUpdatedAt?: number | undefined;
1194
+ cwd?: string | undefined;
1195
+ tags?: Record<string, string> | undefined;
1196
+ snapshotExpiration?: number | undefined;
1197
+ keepLastSnapshots?: {
1198
+ count: number;
1199
+ expiration?: number | undefined;
1200
+ deleteEvicted?: boolean | undefined;
1201
+ } | undefined;
1202
+ };
1203
+ session: {
1204
+ [x: string]: unknown;
1205
+ id: string;
1206
+ memory: number;
1207
+ vcpus: number;
1208
+ region: string;
1209
+ timeout: number;
1210
+ status: "pending" | "running" | "stopping" | "stopped" | "failed" | "aborted" | "snapshotting";
1211
+ requestedAt: number;
1212
+ createdAt: number;
1213
+ cwd: string;
1214
+ updatedAt: number;
1215
+ runtime?: string | undefined;
1216
+ startedAt?: number | undefined;
1217
+ requestedStopAt?: number | undefined;
1218
+ stoppedAt?: number | undefined;
1219
+ abortedAt?: number | undefined;
1220
+ duration?: number | undefined;
1221
+ sourceSnapshotId?: string | undefined;
1222
+ snapshottedAt?: number | undefined;
1223
+ interactivePort?: number | undefined;
1224
+ networkPolicy?: {
1225
+ [x: string]: unknown;
1226
+ mode: "allow-all";
1227
+ } | {
1228
+ [x: string]: unknown;
1229
+ mode: "deny-all";
1230
+ } | {
1231
+ [x: string]: unknown;
1232
+ mode: "custom";
1233
+ allowedDomains?: string[] | undefined;
1234
+ allowedCIDRs?: string[] | undefined;
1235
+ deniedCIDRs?: string[] | undefined;
1236
+ injectionRules?: {
1237
+ domain: string;
1238
+ headers?: Record<string, string> | undefined;
1239
+ headerNames?: string[] | undefined;
1240
+ match?: {
1241
+ path?: {
1242
+ exact?: string | undefined;
1243
+ startsWith?: string | undefined;
1244
+ regex?: string | undefined;
1245
+ } | undefined;
1246
+ method?: string[] | undefined;
1247
+ queryString?: {
1248
+ key?: {
1249
+ exact?: string | undefined;
1250
+ startsWith?: string | undefined;
1251
+ regex?: string | undefined;
1252
+ } | undefined;
1253
+ value?: {
1254
+ exact?: string | undefined;
1255
+ startsWith?: string | undefined;
1256
+ regex?: string | undefined;
1257
+ } | undefined;
1258
+ }[] | undefined;
1259
+ headers?: {
1260
+ key?: {
1261
+ exact?: string | undefined;
1262
+ startsWith?: string | undefined;
1263
+ regex?: string | undefined;
1264
+ } | undefined;
1265
+ value?: {
1266
+ exact?: string | undefined;
1267
+ startsWith?: string | undefined;
1268
+ regex?: string | undefined;
1269
+ } | undefined;
1270
+ }[] | undefined;
1271
+ } | undefined;
1272
+ }[] | undefined;
1273
+ forwardRules?: {
1274
+ domain: string;
1275
+ forwardURL: string;
1276
+ match?: {
1277
+ path?: {
1278
+ exact?: string | undefined;
1279
+ startsWith?: string | undefined;
1280
+ regex?: string | undefined;
1281
+ } | undefined;
1282
+ method?: string[] | undefined;
1283
+ queryString?: {
1284
+ key?: {
1285
+ exact?: string | undefined;
1286
+ startsWith?: string | undefined;
1287
+ regex?: string | undefined;
1288
+ } | undefined;
1289
+ value?: {
1290
+ exact?: string | undefined;
1291
+ startsWith?: string | undefined;
1292
+ regex?: string | undefined;
1293
+ } | undefined;
1294
+ }[] | undefined;
1295
+ headers?: {
1296
+ key?: {
1297
+ exact?: string | undefined;
1298
+ startsWith?: string | undefined;
1299
+ regex?: string | undefined;
1300
+ } | undefined;
1301
+ value?: {
1302
+ exact?: string | undefined;
1303
+ startsWith?: string | undefined;
1304
+ regex?: string | undefined;
1305
+ } | undefined;
1306
+ }[] | undefined;
1307
+ } | undefined;
1308
+ }[] | undefined;
1309
+ } | undefined;
1310
+ activeCpuDurationMs?: number | undefined;
1311
+ networkTransfer?: {
1312
+ ingress: number;
1313
+ egress: number;
1314
+ } | undefined;
1315
+ };
1316
+ routes: {
1317
+ url: string;
1318
+ subdomain: string;
1319
+ port: number;
1320
+ }[];
1321
+ resumed?: boolean | undefined;
1322
+ }>>;
1323
+ listSandboxes(params: {
1324
+ projectId: string;
1325
+ limit?: number;
1326
+ sortBy?: "createdAt" | "name" | "statusUpdatedAt";
1327
+ sortOrder?: "asc" | "desc";
1328
+ namePrefix?: string;
1329
+ cursor?: string;
1330
+ tags?: Record<string, string>;
1331
+ signal?: AbortSignal;
1332
+ }): Promise<Parsed<{
1333
+ sandboxes: {
1334
+ name: string;
1335
+ persistent: boolean;
1336
+ createdAt: number;
1337
+ updatedAt: number;
1338
+ currentSessionId: string;
1339
+ status: "pending" | "running" | "stopping" | "stopped" | "failed" | "aborted" | "snapshotting";
1340
+ region?: string | undefined;
1341
+ failoverRegions?: string[] | undefined;
1342
+ vcpus?: number | undefined;
1343
+ memory?: number | undefined;
1344
+ runtime?: string | undefined;
1345
+ image?: string | undefined;
1346
+ timeout?: number | undefined;
1347
+ networkPolicy?: {
1348
+ [x: string]: unknown;
1349
+ mode: "allow-all";
1350
+ } | {
1351
+ [x: string]: unknown;
1352
+ mode: "deny-all";
1353
+ } | {
1354
+ [x: string]: unknown;
1355
+ mode: "custom";
1356
+ allowedDomains?: string[] | undefined;
1357
+ allowedCIDRs?: string[] | undefined;
1358
+ deniedCIDRs?: string[] | undefined;
1359
+ injectionRules?: {
1360
+ domain: string;
1361
+ headers?: Record<string, string> | undefined;
1362
+ headerNames?: string[] | undefined;
1363
+ match?: {
1364
+ path?: {
1365
+ exact?: string | undefined;
1366
+ startsWith?: string | undefined;
1367
+ regex?: string | undefined;
1368
+ } | undefined;
1369
+ method?: string[] | undefined;
1370
+ queryString?: {
1371
+ key?: {
1372
+ exact?: string | undefined;
1373
+ startsWith?: string | undefined;
1374
+ regex?: string | undefined;
1375
+ } | undefined;
1376
+ value?: {
1377
+ exact?: string | undefined;
1378
+ startsWith?: string | undefined;
1379
+ regex?: string | undefined;
1380
+ } | undefined;
1381
+ }[] | undefined;
1382
+ headers?: {
1383
+ key?: {
1384
+ exact?: string | undefined;
1385
+ startsWith?: string | undefined;
1386
+ regex?: string | undefined;
1387
+ } | undefined;
1388
+ value?: {
1389
+ exact?: string | undefined;
1390
+ startsWith?: string | undefined;
1391
+ regex?: string | undefined;
1392
+ } | undefined;
1393
+ }[] | undefined;
1394
+ } | undefined;
1395
+ }[] | undefined;
1396
+ forwardRules?: {
1397
+ domain: string;
1398
+ forwardURL: string;
1399
+ match?: {
1400
+ path?: {
1401
+ exact?: string | undefined;
1402
+ startsWith?: string | undefined;
1403
+ regex?: string | undefined;
1404
+ } | undefined;
1405
+ method?: string[] | undefined;
1406
+ queryString?: {
1407
+ key?: {
1408
+ exact?: string | undefined;
1409
+ startsWith?: string | undefined;
1410
+ regex?: string | undefined;
1411
+ } | undefined;
1412
+ value?: {
1413
+ exact?: string | undefined;
1414
+ startsWith?: string | undefined;
1415
+ regex?: string | undefined;
1416
+ } | undefined;
1417
+ }[] | undefined;
1418
+ headers?: {
1419
+ key?: {
1420
+ exact?: string | undefined;
1421
+ startsWith?: string | undefined;
1422
+ regex?: string | undefined;
1423
+ } | undefined;
1424
+ value?: {
1425
+ exact?: string | undefined;
1426
+ startsWith?: string | undefined;
1427
+ regex?: string | undefined;
1428
+ } | undefined;
1429
+ }[] | undefined;
1430
+ } | undefined;
1431
+ }[] | undefined;
1432
+ } | undefined;
1433
+ totalEgressBytes?: number | undefined;
1434
+ totalIngressBytes?: number | undefined;
1435
+ totalActiveCpuDurationMs?: number | undefined;
1436
+ totalDurationMs?: number | undefined;
1437
+ expiresAt?: number | undefined;
1438
+ currentSnapshotId?: string | undefined;
1439
+ statusUpdatedAt?: number | undefined;
1440
+ cwd?: string | undefined;
1441
+ tags?: Record<string, string> | undefined;
1442
+ snapshotExpiration?: number | undefined;
1443
+ keepLastSnapshots?: {
1444
+ count: number;
1445
+ expiration?: number | undefined;
1446
+ deleteEvicted?: boolean | undefined;
1447
+ } | undefined;
1448
+ }[];
1449
+ pagination: {
1450
+ count: number;
1451
+ next: string | null;
1452
+ };
1453
+ }>>;
1454
+ updateSandbox(params: {
1455
+ name: string;
1456
+ projectId: string;
1457
+ persistent?: boolean;
1458
+ resources?: {
1459
+ vcpus?: number;
1460
+ memory?: number;
1461
+ };
1462
+ timeout?: number;
1463
+ networkPolicy?: NetworkPolicy;
1464
+ tags?: Record<string, string>;
1465
+ ports?: number[];
1466
+ snapshotExpiration?: number;
1467
+ keepLastSnapshots?: {
1468
+ count: number;
1469
+ expiration?: number;
1470
+ deleteEvicted?: boolean;
1471
+ } | null;
1472
+ currentSnapshotId?: string;
1473
+ region?: SandboxRegion;
1474
+ failoverRegions?: SandboxRegion[];
1475
+ signal?: AbortSignal;
1476
+ }): Promise<Parsed<{
1477
+ sandbox: {
1478
+ name: string;
1479
+ persistent: boolean;
1480
+ createdAt: number;
1481
+ updatedAt: number;
1482
+ currentSessionId: string;
1483
+ status: "pending" | "running" | "stopping" | "stopped" | "failed" | "aborted" | "snapshotting";
1484
+ region?: string | undefined;
1485
+ failoverRegions?: string[] | undefined;
1486
+ vcpus?: number | undefined;
1487
+ memory?: number | undefined;
1488
+ runtime?: string | undefined;
1489
+ image?: string | undefined;
1490
+ timeout?: number | undefined;
1491
+ networkPolicy?: {
1492
+ [x: string]: unknown;
1493
+ mode: "allow-all";
1494
+ } | {
1495
+ [x: string]: unknown;
1496
+ mode: "deny-all";
1497
+ } | {
1498
+ [x: string]: unknown;
1499
+ mode: "custom";
1500
+ allowedDomains?: string[] | undefined;
1501
+ allowedCIDRs?: string[] | undefined;
1502
+ deniedCIDRs?: string[] | undefined;
1503
+ injectionRules?: {
1504
+ domain: string;
1505
+ headers?: Record<string, string> | undefined;
1506
+ headerNames?: string[] | undefined;
1507
+ match?: {
1508
+ path?: {
1509
+ exact?: string | undefined;
1510
+ startsWith?: string | undefined;
1511
+ regex?: string | undefined;
1512
+ } | undefined;
1513
+ method?: string[] | undefined;
1514
+ queryString?: {
1515
+ key?: {
1516
+ exact?: string | undefined;
1517
+ startsWith?: string | undefined;
1518
+ regex?: string | undefined;
1519
+ } | undefined;
1520
+ value?: {
1521
+ exact?: string | undefined;
1522
+ startsWith?: string | undefined;
1523
+ regex?: string | undefined;
1524
+ } | undefined;
1525
+ }[] | undefined;
1526
+ headers?: {
1527
+ key?: {
1528
+ exact?: string | undefined;
1529
+ startsWith?: string | undefined;
1530
+ regex?: string | undefined;
1531
+ } | undefined;
1532
+ value?: {
1533
+ exact?: string | undefined;
1534
+ startsWith?: string | undefined;
1535
+ regex?: string | undefined;
1536
+ } | undefined;
1537
+ }[] | undefined;
1538
+ } | undefined;
1539
+ }[] | undefined;
1540
+ forwardRules?: {
1541
+ domain: string;
1542
+ forwardURL: string;
1543
+ match?: {
1544
+ path?: {
1545
+ exact?: string | undefined;
1546
+ startsWith?: string | undefined;
1547
+ regex?: string | undefined;
1548
+ } | undefined;
1549
+ method?: string[] | undefined;
1550
+ queryString?: {
1551
+ key?: {
1552
+ exact?: string | undefined;
1553
+ startsWith?: string | undefined;
1554
+ regex?: string | undefined;
1555
+ } | undefined;
1556
+ value?: {
1557
+ exact?: string | undefined;
1558
+ startsWith?: string | undefined;
1559
+ regex?: string | undefined;
1560
+ } | undefined;
1561
+ }[] | undefined;
1562
+ headers?: {
1563
+ key?: {
1564
+ exact?: string | undefined;
1565
+ startsWith?: string | undefined;
1566
+ regex?: string | undefined;
1567
+ } | undefined;
1568
+ value?: {
1569
+ exact?: string | undefined;
1570
+ startsWith?: string | undefined;
1571
+ regex?: string | undefined;
1572
+ } | undefined;
1573
+ }[] | undefined;
1574
+ } | undefined;
1575
+ }[] | undefined;
1576
+ } | undefined;
1577
+ totalEgressBytes?: number | undefined;
1578
+ totalIngressBytes?: number | undefined;
1579
+ totalActiveCpuDurationMs?: number | undefined;
1580
+ totalDurationMs?: number | undefined;
1581
+ expiresAt?: number | undefined;
1582
+ currentSnapshotId?: string | undefined;
1583
+ statusUpdatedAt?: number | undefined;
1584
+ cwd?: string | undefined;
1585
+ tags?: Record<string, string> | undefined;
1586
+ snapshotExpiration?: number | undefined;
1587
+ keepLastSnapshots?: {
1588
+ count: number;
1589
+ expiration?: number | undefined;
1590
+ deleteEvicted?: boolean | undefined;
1591
+ } | undefined;
1592
+ };
1593
+ routes?: {
1594
+ url: string;
1595
+ subdomain: string;
1596
+ port: number;
1597
+ }[] | undefined;
1598
+ }>>;
1599
+ deleteSandbox(params: {
1600
+ name: string;
1601
+ projectId: string;
1602
+ deleteOrphanSnapshots?: boolean;
1603
+ signal?: AbortSignal;
1604
+ }): Promise<Parsed<{
1605
+ sandbox: {
1606
+ name: string;
1607
+ persistent: boolean;
1608
+ createdAt: number;
1609
+ updatedAt: number;
1610
+ currentSessionId: string;
1611
+ status: "pending" | "running" | "stopping" | "stopped" | "failed" | "aborted" | "snapshotting";
1612
+ region?: string | undefined;
1613
+ failoverRegions?: string[] | undefined;
1614
+ vcpus?: number | undefined;
1615
+ memory?: number | undefined;
1616
+ runtime?: string | undefined;
1617
+ image?: string | undefined;
1618
+ timeout?: number | undefined;
1619
+ networkPolicy?: {
1620
+ [x: string]: unknown;
1621
+ mode: "allow-all";
1622
+ } | {
1623
+ [x: string]: unknown;
1624
+ mode: "deny-all";
1625
+ } | {
1626
+ [x: string]: unknown;
1627
+ mode: "custom";
1628
+ allowedDomains?: string[] | undefined;
1629
+ allowedCIDRs?: string[] | undefined;
1630
+ deniedCIDRs?: string[] | undefined;
1631
+ injectionRules?: {
1632
+ domain: string;
1633
+ headers?: Record<string, string> | undefined;
1634
+ headerNames?: string[] | undefined;
1635
+ match?: {
1636
+ path?: {
1637
+ exact?: string | undefined;
1638
+ startsWith?: string | undefined;
1639
+ regex?: string | undefined;
1640
+ } | undefined;
1641
+ method?: string[] | undefined;
1642
+ queryString?: {
1643
+ key?: {
1644
+ exact?: string | undefined;
1645
+ startsWith?: string | undefined;
1646
+ regex?: string | undefined;
1647
+ } | undefined;
1648
+ value?: {
1649
+ exact?: string | undefined;
1650
+ startsWith?: string | undefined;
1651
+ regex?: string | undefined;
1652
+ } | undefined;
1653
+ }[] | undefined;
1654
+ headers?: {
1655
+ key?: {
1656
+ exact?: string | undefined;
1657
+ startsWith?: string | undefined;
1658
+ regex?: string | undefined;
1659
+ } | undefined;
1660
+ value?: {
1661
+ exact?: string | undefined;
1662
+ startsWith?: string | undefined;
1663
+ regex?: string | undefined;
1664
+ } | undefined;
1665
+ }[] | undefined;
1666
+ } | undefined;
1667
+ }[] | undefined;
1668
+ forwardRules?: {
1669
+ domain: string;
1670
+ forwardURL: string;
1671
+ match?: {
1672
+ path?: {
1673
+ exact?: string | undefined;
1674
+ startsWith?: string | undefined;
1675
+ regex?: string | undefined;
1676
+ } | undefined;
1677
+ method?: string[] | undefined;
1678
+ queryString?: {
1679
+ key?: {
1680
+ exact?: string | undefined;
1681
+ startsWith?: string | undefined;
1682
+ regex?: string | undefined;
1683
+ } | undefined;
1684
+ value?: {
1685
+ exact?: string | undefined;
1686
+ startsWith?: string | undefined;
1687
+ regex?: string | undefined;
1688
+ } | undefined;
1689
+ }[] | undefined;
1690
+ headers?: {
1691
+ key?: {
1692
+ exact?: string | undefined;
1693
+ startsWith?: string | undefined;
1694
+ regex?: string | undefined;
1695
+ } | undefined;
1696
+ value?: {
1697
+ exact?: string | undefined;
1698
+ startsWith?: string | undefined;
1699
+ regex?: string | undefined;
1700
+ } | undefined;
1701
+ }[] | undefined;
1702
+ } | undefined;
1703
+ }[] | undefined;
1704
+ } | undefined;
1705
+ totalEgressBytes?: number | undefined;
1706
+ totalIngressBytes?: number | undefined;
1707
+ totalActiveCpuDurationMs?: number | undefined;
1708
+ totalDurationMs?: number | undefined;
1709
+ expiresAt?: number | undefined;
1710
+ currentSnapshotId?: string | undefined;
1711
+ statusUpdatedAt?: number | undefined;
1712
+ cwd?: string | undefined;
1713
+ tags?: Record<string, string> | undefined;
1714
+ snapshotExpiration?: number | undefined;
1715
+ keepLastSnapshots?: {
1716
+ count: number;
1717
+ expiration?: number | undefined;
1718
+ deleteEvicted?: boolean | undefined;
1719
+ } | undefined;
1720
+ };
1721
+ routes?: {
1722
+ url: string;
1723
+ subdomain: string;
1724
+ port: number;
1725
+ }[] | undefined;
1726
+ }>>;
1727
+ }
1728
+ //#endregion
1729
+ export { APIClient, WithFetchOptions };
1730
+ //# sourceMappingURL=api-client.d.ts.map