codai-sdk 0.64.0 → 0.65.0

package/dist/index.d.ts

@@ -37193,9 +37193,12 @@ export declare class Sandboxes {
   readonly files: SandboxFiles;
   constructor(http: HttpClient);
   /**
-   * `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`.
+   * `POST /v1/sandboxes` — start a sandbox (`ttl_seconds` default 3600, max 86400 on v1 / 604800 on v2;
+   * `egress` none by default, or a `pypi`/`npm` preset / allowlist on both backends).
+   * `backend` defaults to `'v2'`: a long-lived pod with memory snapshots, Node 24 + npm, `template`
+   * `codai-base` | `brivio-acte` | `desktop`; its reply may carry `restored`. When `backend` is omitted and v2
+   * is unavailable for the key the gateway falls back to `'v1'` (check `backend` on the reply).
+   * Errors: 429 `sandbox_concurrency_limit` (3 per key, 5 running v2 per user), 503 `sandbox_capacity` (retry).
    */
   create(input?: SandboxCreateInput, opts?: CallOpts$6): Promise<Sandbox>;
   /** `GET /v1/sandboxes` — your sandboxes, newest first, optionally one `status`. */
@@ -37216,7 +37219,7 @@ export declare class Sandboxes {
   execStream(id: string, input: SandboxExecInput, opts?: IdemOpts): AsyncGenerator<SandboxExecEvent, void, undefined>;
   /** `GET /v1/sandboxes/{id}/artifacts` — collect `/workspace/out` (scanned, signed 1 h links). */
   artifacts(id: string, opts?: CallOpts$6): Promise<SandboxArtifactList>;
-  /** `POST /v1/sandboxes/{id}/snapshot` — store a compressed copy of the workspace. */
+  /** `POST /v1/sandboxes/{id}/snapshot` (v1 only; v2 answers 409 `not_supported_on_v2`) — store a compressed copy of the workspace. */
   snapshot(id: string, input?: SandboxSnapshotInput, opts?: CallOpts$6): Promise<SandboxSnapshot>;
   /**
    * `POST /v1/sandboxes/{id}/run_code` (v2) — run Python in the persistent kernel; globals survive between
@@ -37225,7 +37228,10 @@ export declare class Sandboxes {
   runCode(id: string, input: SandboxRunCodeInput, opts?: CallOpts$6): Promise<SandboxRunCodeResult>;
   /** `POST /v1/sandboxes/{id}/kernel/reset` (v2) — restart the kernel; globals are lost, files kept. */
   resetKernel(id: string, opts?: CallOpts$6): Promise<void>;
-  /** `POST /v1/sandboxes/{id}/pause` (v2) — memory snapshot, then stop the pod (status `paused`). */
+  /**
+   * `POST /v1/sandboxes/{id}/pause` (v2) — memory snapshot, then stop the pod (status `paused`).
+   * At most 10 paused v2 sandboxes per user (429 `sandbox_paused_limit`).
+   */
   pause(id: string, opts?: CallOpts$6): Promise<Sandbox>;
   /** `POST /v1/sandboxes/{id}/resume` (v2) — restore a paused sandbox; `restored: false` = cold start. */
   resume(id: string, opts?: CallOpts$6): Promise<SandboxResumed>;
@@ -38003,7 +38009,7 @@ export declare class Codai {
   readonly orgs: Orgs;
   readonly projects: Projects;
   readonly environments: Environments;
-  /** Agent sandboxes (beta) — isolated gVisor workspaces: `sandboxes.create/exec/execStream/files/artifacts/run`. */
+  /** Agent sandboxes (backend v2 by default) — isolated gVisor workspaces: `sandboxes.create/exec/execStream/files/artifacts/run`. */
   readonly sandboxes: Sandboxes;
   /** EXPERIMENTAL (HIDE, unaudited): verify signed agent outputs. Provenance only. */
   readonly verify: Verify;

package/dist/index.js

@@ -5317,8 +5317,9 @@ var Memory = class {
 //#endregion
 //#region src/resources/sandboxes.ts
 /**
-* `/v1/sandboxes` — agent sandboxes (beta): isolated gVisor containers with a persistent
-* `/workspace`, no network by default, artifacts from `/workspace/out` as scanned, signed links.
+* `/v1/sandboxes` — agent sandboxes: isolated gVisor containers with a persistent `/workspace`, no network
+* by default, artifacts from `/workspace/out` as scanned, signed links. Backend `v2` (default) = long-lived
+* GKE pod with pause/resume, fork, a persistent kernel and preview URLs; `v1` = Cloud Run, on request.
 */
 const base = (id) => `/v1/sandboxes/${encodeURIComponent(id)}`;
 /** Encode each segment of a workspace path, keeping the slashes. */
@@ -5369,9 +5370,12 @@ var Sandboxes = class {
 		this.files = new SandboxFiles(http);
 	}
 	/**
-	* `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`.
+	* `POST /v1/sandboxes` — start a sandbox (`ttl_seconds` default 3600, max 86400 on v1 / 604800 on v2;
+	* `egress` none by default, or a `pypi`/`npm` preset / allowlist on both backends).
+	* `backend` defaults to `'v2'`: a long-lived pod with memory snapshots, Node 24 + npm, `template`
+	* `codai-base` | `brivio-acte` | `desktop`; its reply may carry `restored`. When `backend` is omitted and v2
+	* is unavailable for the key the gateway falls back to `'v1'` (check `backend` on the reply).
+	* Errors: 429 `sandbox_concurrency_limit` (3 per key, 5 running v2 per user), 503 `sandbox_capacity` (retry).
 	*/
 	create(input = {}, opts = {}) {
 		return this.http.json("/v1/sandboxes", {
@@ -5440,7 +5444,7 @@ var Sandboxes = class {
 			signal: opts.signal
 		});
 	}
-	/** `POST /v1/sandboxes/{id}/snapshot` — store a compressed copy of the workspace. */
+	/** `POST /v1/sandboxes/{id}/snapshot` (v1 only; v2 answers 409 `not_supported_on_v2`) — store a compressed copy of the workspace. */
 	snapshot(id, input = {}, opts = {}) {
 		return this.http.json(`${base(id)}/snapshot`, {
 			method: "POST",
@@ -5474,7 +5478,10 @@ var Sandboxes = class {
 			signal: opts.signal
 		});
 	}
-	/** `POST /v1/sandboxes/{id}/pause` (v2) — memory snapshot, then stop the pod (status `paused`). */
+	/**
+	* `POST /v1/sandboxes/{id}/pause` (v2) — memory snapshot, then stop the pod (status `paused`).
+	* At most 10 paused v2 sandboxes per user (429 `sandbox_paused_limit`).
+	*/
 	pause(id, opts = {}) {
 		return this.http.json(`${base(id)}/pause`, {
 			method: "POST",
@@ -6826,8 +6833,8 @@ var CodaiApps = class {
 *   client.usage.get / client.keys.list / .setTags (own usage breakdown + API keys)
 *   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)
+*     / .artifacts / .snapshot / .delete / .run (agent sandboxes: isolated gVisor workspaces, no network by default)
+*     / .runCode / .resetKernel / .pause / .resume / .fork / .preview (backend v2, the default; .snapshot is v1 only)
 *   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)
@@ -6921,7 +6928,7 @@ var Codai = class {
 	orgs;
 	projects;
 	environments;
-	/** Agent sandboxes (beta) — isolated gVisor workspaces: `sandboxes.create/exec/execStream/files/artifacts/run`. */
+	/** Agent sandboxes (backend v2 by default) — isolated gVisor workspaces: `sandboxes.create/exec/execStream/files/artifacts/run`. */
 	sandboxes;
 	/** EXPERIMENTAL (HIDE, unaudited): verify signed agent outputs. Provenance only. */
 	verify;