codai-sdk 0.54.1 → 0.55.0

package/dist/index.js

@@ -5066,7 +5066,11 @@ var Sandboxes = class {
 		this.http = http;
 		this.files = new SandboxFiles(http);
 	}
-	/** `POST /v1/sandboxes` — start a sandbox (`ttl_seconds` 60–86400, default 3600; `egress` none by default). */
+	/**
+	* `POST /v1/sandboxes` — start a sandbox (`ttl_seconds` 60–86400, default 3600; `egress` none by default).
+	* `backend: 'v2'` (closed canary) starts a long-lived pod with memory snapshots and accepts `template`
+	* `codai-base` | `brivio-acte` | `desktop`; its reply may carry `restored`.
+	*/
 	create(input = {}, opts = {}) {
 		return this.http.json("/v1/sandboxes", {
 			method: "POST",
@@ -5143,6 +5147,77 @@ var Sandboxes = class {
 			signal: opts.signal
 		});
 	}
+	/**
+	* `POST /v1/sandboxes/{id}/run_code` (v2) — run Python in the persistent kernel; globals survive between
+	* calls, pause/resume and forks. The last expression comes back as `result`.
+	*/
+	runCode(id, input, opts = {}) {
+		return this.http.json(`${base(id)}/run_code`, {
+			method: "POST",
+			body: {
+				code: input.code,
+				...input.timeoutSeconds !== void 0 ? { timeout_seconds: input.timeoutSeconds } : {}
+			},
+			timeoutMs: execTimeoutMs(input.timeoutSeconds),
+			noRetry: true,
+			ext: opts.ext,
+			signal: opts.signal
+		});
+	}
+	/** `POST /v1/sandboxes/{id}/kernel/reset` (v2) — restart the kernel; globals are lost, files kept. */
+	async resetKernel(id, opts = {}) {
+		await this.http.json(`${base(id)}/kernel/reset`, {
+			method: "POST",
+			ext: opts.ext,
+			signal: opts.signal
+		});
+	}
+	/** `POST /v1/sandboxes/{id}/pause` (v2) — memory snapshot, then stop the pod (status `paused`). */
+	pause(id, opts = {}) {
+		return this.http.json(`${base(id)}/pause`, {
+			method: "POST",
+			timeoutMs: LIFECYCLE_TIMEOUT_MS,
+			noRetry: true,
+			ext: opts.ext,
+			signal: opts.signal
+		});
+	}
+	/** `POST /v1/sandboxes/{id}/resume` (v2) — restore a paused sandbox; `restored: false` = cold start. */
+	resume(id, opts = {}) {
+		return this.http.json(`${base(id)}/resume`, {
+			method: "POST",
+			timeoutMs: LIFECYCLE_TIMEOUT_MS,
+			noRetry: true,
+			ext: opts.ext,
+			signal: opts.signal
+		});
+	}
+	/** `POST /v1/sandboxes/{id}/fork` (v2) — start 1–5 copies of a running sandbox from a memory snapshot. */
+	fork(id, input, opts = {}) {
+		return this.http.json(`${base(id)}/fork`, {
+			method: "POST",
+			body: {
+				count: input.count,
+				...input.ttlSeconds !== void 0 ? { ttl_seconds: input.ttlSeconds } : {}
+			},
+			timeoutMs: LIFECYCLE_TIMEOUT_MS,
+			noRetry: true,
+			ext: opts.ext,
+			signal: opts.signal
+		});
+	}
+	/** `POST /v1/sandboxes/{id}/preview` (v2) — signed HTTPS URL on `*.sbx.codai.ro` for a port (≤ 1 h). */
+	preview(id, input, opts = {}) {
+		return this.http.json(`${base(id)}/preview`, {
+			method: "POST",
+			body: {
+				port: input.port,
+				...input.ttlSeconds !== void 0 ? { ttl_seconds: input.ttlSeconds } : {}
+			},
+			ext: opts.ext,
+			signal: opts.signal
+		});
+	}
 	/** `DELETE /v1/sandboxes/{id}` — destroy the sandbox and its workspace (204). */
 	async delete(id, opts = {}) {
 		await this.http.request(base(id), {
@@ -5167,6 +5242,8 @@ var Sandboxes = class {
 		});
 	}
 };
+/** Pause / resume / fork wait for a snapshot or a pod start (server caps: 180 s snapshot, 240 s start). */
+const LIFECYCLE_TIMEOUT_MS = 48e4;
 /** Client timeout for a blocking exec: the server limit plus a margin for restore and upload. */
 function execTimeoutMs(timeoutSeconds) {
 	return ((timeoutSeconds ?? 120) + 60) * 1e3;
@@ -5991,6 +6068,12 @@ const OPERATION_METHODS = {
 	snapshotSandbox: "sandboxes.snapshot",
 	deleteSandbox: "sandboxes.delete",
 	runSandbox: "sandboxes.run",
+	runSandboxCode: "sandboxes.runCode",
+	resetSandboxKernel: "sandboxes.resetKernel",
+	pauseSandbox: "sandboxes.pause",
+	resumeSandbox: "sandboxes.resume",
+	forkSandbox: "sandboxes.fork",
+	previewSandbox: "sandboxes.preview",
 	createSession: "sessions.create",
 	listSessions: "sessions.list",
 	getSession: "sessions.get",
@@ -6319,6 +6402,7 @@ var CodaiApps = class {
 *   client.projects.*                           client.environments.* (members, ports, secrets)
 *   client.sandboxes.create / .list / .retrieve / .exec / .execStream / .files.put / .files.get / .files.list
 *     / .artifacts / .snapshot / .delete / .run (agent sandboxes, beta: isolated gVisor workspaces, no network by default)
+*     / .runCode / .resetKernel / .pause / .resume / .fork / .preview (backend v2, closed canary)
 *   client.verify.agentOutputKey / .agentOutput (EXPERIMENTAL HIDE-signed agent outputs)
 *   client.feedback / client.phoneModels
 *   client.resolve.* (verified bug fixes on https://resolve.codai.ro — resolve.yaml; .list / .iterate page your jobs)