@deepraxis/sdk 0.1.0-dev.c01abef → 0.1.0-dev.c0c05d8

package/dist/generated/sdk.gen.d.ts

@@ -2059,19 +2059,19 @@ export declare const getSandboxV1Sandboxes: <ThrowOnError extends boolean = fals
 /**
  * Create sandbox (v2)
  *
- * Start an isolated environment using a templateID from templates.list, then retain sandboxID for lifecycle calls. Unlike E2B, templateID resolves to your ready Environment or a public Base; omit it to use the default base template (`base`), as the E2B SDK does. timeout is seconds from creation and defaults to 300. envVars supplies environment variables and metadata stores your string labels. All system communication is secured; use the returned envdAccessToken for files and commands through the envd data plane, not the management methods. Never print that token.
+ * Create a sandbox from the template. All system communication with the sandbox is secured.
  */
 export declare const postSandboxV1Sandboxes: <ThrowOnError extends boolean = false>(options: Options<PostSandboxV1SandboxesData, ThrowOnError>) => RequestResult<PostSandboxV1SandboxesResponses, PostSandboxV1SandboxesErrors, ThrowOnError>;
 /**
  * Sandbox metrics
  *
- * Read CPU, memory and disk usage over the requested interval; start and end are Unix seconds. Unlike E2B, light sandboxes do not provide metrics; check the returned capabilities before requesting them.
+ * Read CPU, memory and disk usage samples of a sandbox over a time window. Use it to size a sandbox or find out why it is slow. start and end are Unix timestamps in seconds; without them the recent samples are returned. An unknown id answers 404.
  */
 export declare const getSandboxV1SandboxesBySandboxIdMetrics: <ThrowOnError extends boolean = false>(options: Options<GetSandboxV1SandboxesBySandboxIdMetricsData, ThrowOnError>) => RequestResult<GetSandboxV1SandboxesBySandboxIdMetricsResponses, GetSandboxV1SandboxesBySandboxIdMetricsErrors, ThrowOnError>;
 /**
  * Pause sandbox
  *
- * Suspend a running sandbox for later connection; use delete to discard it instead. Unlike E2B, light sandboxes preserve disk rather than memory, and persistent sandboxes can resume on data-plane traffic even when autoResume is false. Inspect paused state with the management retrieve operation to avoid waking the sandbox. Explicitly ephemeral sandboxes cannot pause. memory defaults to true, but only a memory-capable sandbox preserves running processes; memory=false saves disk state and resumes with a cold boot. Success returns 204; connect resumes the saved sandbox.
+ * Pause a running sandbox, keeping its files and memory so that connectSandbox can resume it later. Use it to stop paying for compute without losing state; to discard the sandbox use killSandbox. Success answers 204. A sandbox that is not running answers 409.
  */
 export declare const postSandboxV1SandboxesBySandboxIdPause: <ThrowOnError extends boolean = false>(options: Options<PostSandboxV1SandboxesBySandboxIdPauseData, ThrowOnError>) => RequestResult<PostSandboxV1SandboxesBySandboxIdPauseResponses, PostSandboxV1SandboxesBySandboxIdPauseErrors, ThrowOnError>;
 /**
@@ -2083,13 +2083,13 @@ export declare const postSandboxV1SandboxesBySandboxIdTimeout: <ThrowOnError ext
 /**
  * Connect sandbox (v2)
  *
- * Reconnect to an existing sandbox and resume it if paused. The optional timeout is seconds from now and defaults to 300; a later existing deadline is preserved. A running sandbox returns 200 and a resumed sandbox returns 201. Read sandboxID, domain and envdAccessToken from the response for subsequent data-plane access; never treat connecting as executing a command.
+ * Returns sandbox details. If the sandbox is paused, it will be resumed. TTL is only extended. The request body is optional; an omitted timeout defaults to 300 seconds.
  */
 export declare const postSandboxV1SandboxesBySandboxIdConnect: <ThrowOnError extends boolean = false>(options: Options<PostSandboxV1SandboxesBySandboxIdConnectData, ThrowOnError>) => RequestResult<PostSandboxV1SandboxesBySandboxIdConnectResponses, PostSandboxV1SandboxesBySandboxIdConnectErrors, ThrowOnError>;
 /**
  * List templates (v2)
  *
- * Choose a templateID before creating a sandbox. Unlike E2B, this catalog lists your ready Environments and public Bases; use a returned ID or alias; `base` is the default template that create uses when templateID is omitted. Page through results using nextToken.
+ * List the templates you can create sandboxes from. Use it to pick the template id or alias for createSandbox. `base` is the default template that createSandbox uses when templateID is omitted. limit is 1 to 100 (default 100); send the cursor from the response back as nextToken to continue.
  */
 export declare const getSandboxV1Templates: <ThrowOnError extends boolean = false>(options?: Options<GetSandboxV1TemplatesData, ThrowOnError>) => RequestResult<GetSandboxV1TemplatesResponses, GetSandboxV1TemplatesErrors, ThrowOnError>;
 /**

package/dist/generated/sdk.gen.js

@@ -5953,7 +5953,7 @@ export const getSandboxV1Sandboxes = (options) => (options?.client ?? client).ge
 /**
  * Create sandbox (v2)
  *
- * Start an isolated environment using a templateID from templates.list, then retain sandboxID for lifecycle calls. Unlike E2B, templateID resolves to your ready Environment or a public Base; omit it to use the default base template (`base`), as the E2B SDK does. timeout is seconds from creation and defaults to 300. envVars supplies environment variables and metadata stores your string labels. All system communication is secured; use the returned envdAccessToken for files and commands through the envd data plane, not the management methods. Never print that token.
+ * Create a sandbox from the template. All system communication with the sandbox is secured.
  */
 export const postSandboxV1Sandboxes = (options) => (options.client ?? client).post({
     security: [
@@ -5994,7 +5994,7 @@ export const postSandboxV1Sandboxes = (options) => (options.client ?? client).po
 /**
  * Sandbox metrics
  *
- * Read CPU, memory and disk usage over the requested interval; start and end are Unix seconds. Unlike E2B, light sandboxes do not provide metrics; check the returned capabilities before requesting them.
+ * Read CPU, memory and disk usage samples of a sandbox over a time window. Use it to size a sandbox or find out why it is slow. start and end are Unix timestamps in seconds; without them the recent samples are returned. An unknown id answers 404.
  */
 export const getSandboxV1SandboxesBySandboxIdMetrics = (options) => (options.client ?? client).get({
     security: [
@@ -6031,7 +6031,7 @@ export const getSandboxV1SandboxesBySandboxIdMetrics = (options) => (options.cli
 /**
  * Pause sandbox
  *
- * Suspend a running sandbox for later connection; use delete to discard it instead. Unlike E2B, light sandboxes preserve disk rather than memory, and persistent sandboxes can resume on data-plane traffic even when autoResume is false. Inspect paused state with the management retrieve operation to avoid waking the sandbox. Explicitly ephemeral sandboxes cannot pause. memory defaults to true, but only a memory-capable sandbox preserves running processes; memory=false saves disk state and resumes with a cold boot. Success returns 204; connect resumes the saved sandbox.
+ * Pause a running sandbox, keeping its files and memory so that connectSandbox can resume it later. Use it to stop paying for compute without losing state; to discard the sandbox use killSandbox. Success answers 204. A sandbox that is not running answers 409.
  */
 export const postSandboxV1SandboxesBySandboxIdPause = (options) => (options.client ?? client).post({
     security: [
@@ -6113,7 +6113,7 @@ export const postSandboxV1SandboxesBySandboxIdTimeout = (options) => (options.cl
 /**
  * Connect sandbox (v2)
  *
- * Reconnect to an existing sandbox and resume it if paused. The optional timeout is seconds from now and defaults to 300; a later existing deadline is preserved. A running sandbox returns 200 and a resumed sandbox returns 201. Read sandboxID, domain and envdAccessToken from the response for subsequent data-plane access; never treat connecting as executing a command.
+ * Returns sandbox details. If the sandbox is paused, it will be resumed. TTL is only extended. The request body is optional; an omitted timeout defaults to 300 seconds.
  */
 export const postSandboxV1SandboxesBySandboxIdConnect = (options) => (options.client ?? client).post({
     security: [
@@ -6154,7 +6154,7 @@ export const postSandboxV1SandboxesBySandboxIdConnect = (options) => (options.cl
 /**
  * List templates (v2)
  *
- * Choose a templateID before creating a sandbox. Unlike E2B, this catalog lists your ready Environments and public Bases; use a returned ID or alias; `base` is the default template that create uses when templateID is omitted. Page through results using nextToken.
+ * List the templates you can create sandboxes from. Use it to pick the template id or alias for createSandbox. `base` is the default template that createSandbox uses when templateID is omitted. limit is 1 to 100 (default 100); send the cursor from the response back as nextToken to continue.
  */
 export const getSandboxV1Templates = (options) => (options?.client ?? client).get({
     security: [

package/dist/generated/types.gen.d.ts

@@ -3912,7 +3912,7 @@ export type SandboxSandboxDetail = {
      */
     allowInternetAccess?: boolean;
     /**
-     * Domain returned for sandbox traffic. Build an HTTP service URL as https://<port>-<sandboxID>.<domain> using the returned values, without replacing or stripping the sandboxID suffix.
+     * Base domain where the sandbox traffic is accessible
      */
     domain?: string;
     cpuCount: SandboxCpuCount;
@@ -11867,7 +11867,7 @@ export type MediaMediaEventPage = MediaPage & {
  */
 export type SandboxNewSandboxV2 = {
     /**
-     * Template ID or alias from templates.list; resolves to your ready Environment first, then a public Base. Omit it to use the default base template (`base`).
+     * Identifier of the required template
      */
     templateID: string;
     /**
@@ -11929,7 +11929,7 @@ export type SandboxSandbox = {
      */
     trafficAccessToken?: string;
     /**
-     * Domain returned for sandbox traffic. Build an HTTP service URL as https://<port>-<sandboxID>.<domain> using the returned values, without replacing or stripping the sandboxID suffix.
+     * Base domain where the sandbox traffic is accessible
      */
     domain?: string;
 };
@@ -17213,7 +17213,7 @@ export type SandboxSandboxNetworkConfig = {
      */
     maskRequestHost?: string;
     /**
-     * Unlike E2B, network.httpsPorts is rejected; omit it and serve plaintext HTTP inside the sandbox. The public port URL still uses HTTPS. The upstream field denotes HTTPS-speaking internal ports, permits self-signed certificates and excludes envd port 49983.
+     * Unlike E2B, network.httpsPorts is rejected; omit it when creating a sandbox.
      */
     httpsPorts?: Array<number>;
     /**

package/dist/operations.generated.d.ts

@@ -9851,7 +9851,7 @@ export declare const operations: readonly [{
     readonly resource: "sandbox.sandboxes";
     readonly method: "create";
     readonly summary: "Create sandbox (v2)";
-    readonly description: "Start an isolated environment using a templateID from templates.list, then retain sandboxID for lifecycle calls. Unlike E2B, templateID resolves to your ready Environment or a public Base; omit it to use the default base template (`base`), as the E2B SDK does. timeout is seconds from creation and defaults to 300. envVars supplies environment variables and metadata stores your string labels. All system communication is secured; use the returned envdAccessToken for files and commands through the envd data plane, not the management methods. Never print that token.";
+    readonly description: "Create a sandbox from the template. All system communication with the sandbox is secured.";
     readonly http: "POST";
     readonly path: "/sandbox/v1/sandboxes";
     readonly streaming: "no";
@@ -9864,7 +9864,7 @@ export declare const operations: readonly [{
             readonly name: "templateID";
             readonly type: "string";
             readonly required: true;
-            readonly description: "Template ID or alias from templates.list; resolves to your ready Environment first, then a public Base. Omit it to use the default base template (`base`).";
+            readonly description: "Identifier of the required template";
         }, {
             readonly name: "timeout";
             readonly type: "integer";
@@ -9978,7 +9978,7 @@ export declare const operations: readonly [{
     readonly resource: "sandbox.sandboxes";
     readonly method: "connect";
     readonly summary: "Connect sandbox (v2)";
-    readonly description: "Reconnect to an existing sandbox and resume it if paused. The optional timeout is seconds from now and defaults to 300; a later existing deadline is preserved. A running sandbox returns 200 and a resumed sandbox returns 201. Read sandboxID, domain and envdAccessToken from the response for subsequent data-plane access; never treat connecting as executing a command.";
+    readonly description: "Returns sandbox details. If the sandbox is paused, it will be resumed. TTL is only extended. The request body is optional; an omitted timeout defaults to 300 seconds.";
     readonly http: "POST";
     readonly path: "/sandbox/v1/sandboxes/{sandboxID}/connect";
     readonly streaming: "no";
@@ -10099,7 +10099,7 @@ export declare const operations: readonly [{
     readonly resource: "sandbox.sandboxes.metrics";
     readonly method: "list";
     readonly summary: "Sandbox metrics";
-    readonly description: "Read CPU, memory and disk usage over the requested interval; start and end are Unix seconds. Unlike E2B, light sandboxes do not provide metrics; check the returned capabilities before requesting them.";
+    readonly description: "Read CPU, memory and disk usage samples of a sandbox over a time window. Use it to size a sandbox or find out why it is slow. start and end are Unix timestamps in seconds; without them the recent samples are returned. An unknown id answers 404.";
     readonly http: "GET";
     readonly path: "/sandbox/v1/sandboxes/{sandboxID}/metrics";
     readonly streaming: "no";
@@ -10168,7 +10168,7 @@ export declare const operations: readonly [{
     readonly resource: "sandbox.sandboxes";
     readonly method: "pause";
     readonly summary: "Pause sandbox";
-    readonly description: "Suspend a running sandbox for later connection; use delete to discard it instead. Unlike E2B, light sandboxes preserve disk rather than memory, and persistent sandboxes can resume on data-plane traffic even when autoResume is false. Inspect paused state with the management retrieve operation to avoid waking the sandbox. Explicitly ephemeral sandboxes cannot pause. memory defaults to true, but only a memory-capable sandbox preserves running processes; memory=false saves disk state and resumes with a cold boot. Success returns 204; connect resumes the saved sandbox.";
+    readonly description: "Pause a running sandbox, keeping its files and memory so that connectSandbox can resume it later. Use it to stop paying for compute without losing state; to discard the sandbox use killSandbox. Success answers 204. A sandbox that is not running answers 409.";
     readonly http: "POST";
     readonly path: "/sandbox/v1/sandboxes/{sandboxID}/pause";
     readonly streaming: "no";
@@ -10484,7 +10484,7 @@ export declare const operations: readonly [{
     readonly resource: "sandbox.templates";
     readonly method: "list";
     readonly summary: "List templates (v2)";
-    readonly description: "Choose a templateID before creating a sandbox. Unlike E2B, this catalog lists your ready Environments and public Bases; use a returned ID or alias; `base` is the default template that create uses when templateID is omitted. Page through results using nextToken.";
+    readonly description: "List the templates you can create sandboxes from. Use it to pick the template id or alias for createSandbox. `base` is the default template that createSandbox uses when templateID is omitted. limit is 1 to 100 (default 100); send the cursor from the response back as nextToken to continue.";
     readonly http: "GET";
     readonly path: "/sandbox/v1/templates";
     readonly streaming: "no";

package/dist/operations.generated.js

@@ -12297,7 +12297,7 @@ export const operations = [
         "resource": "sandbox.sandboxes",
         "method": "create",
         "summary": "Create sandbox (v2)",
-        "description": "Start an isolated environment using a templateID from templates.list, then retain sandboxID for lifecycle calls. Unlike E2B, templateID resolves to your ready Environment or a public Base; omit it to use the default base template (`base`), as the E2B SDK does. timeout is seconds from creation and defaults to 300. envVars supplies environment variables and metadata stores your string labels. All system communication is secured; use the returned envdAccessToken for files and commands through the envd data plane, not the management methods. Never print that token.",
+        "description": "Create a sandbox from the template. All system communication with the sandbox is secured.",
         "http": "POST",
         "path": "/sandbox/v1/sandboxes",
         "streaming": "no",
@@ -12311,7 +12311,7 @@ export const operations = [
                     "name": "templateID",
                     "type": "string",
                     "required": true,
-                    "description": "Template ID or alias from templates.list; resolves to your ready Environment first, then a public Base. Omit it to use the default base template (`base`)."
+                    "description": "Identifier of the required template"
                 },
                 {
                     "name": "timeout",
@@ -12449,7 +12449,7 @@ export const operations = [
         "resource": "sandbox.sandboxes",
         "method": "connect",
         "summary": "Connect sandbox (v2)",
-        "description": "Reconnect to an existing sandbox and resume it if paused. The optional timeout is seconds from now and defaults to 300; a later existing deadline is preserved. A running sandbox returns 200 and a resumed sandbox returns 201. Read sandboxID, domain and envdAccessToken from the response for subsequent data-plane access; never treat connecting as executing a command.",
+        "description": "Returns sandbox details. If the sandbox is paused, it will be resumed. TTL is only extended. The request body is optional; an omitted timeout defaults to 300 seconds.",
         "http": "POST",
         "path": "/sandbox/v1/sandboxes/{sandboxID}/connect",
         "streaming": "no",
@@ -12608,7 +12608,7 @@ export const operations = [
         "resource": "sandbox.sandboxes.metrics",
         "method": "list",
         "summary": "Sandbox metrics",
-        "description": "Read CPU, memory and disk usage over the requested interval; start and end are Unix seconds. Unlike E2B, light sandboxes do not provide metrics; check the returned capabilities before requesting them.",
+        "description": "Read CPU, memory and disk usage samples of a sandbox over a time window. Use it to size a sandbox or find out why it is slow. start and end are Unix timestamps in seconds; without them the recent samples are returned. An unknown id answers 404.",
         "http": "GET",
         "path": "/sandbox/v1/sandboxes/{sandboxID}/metrics",
         "streaming": "no",
@@ -12692,7 +12692,7 @@ export const operations = [
         "resource": "sandbox.sandboxes",
         "method": "pause",
         "summary": "Pause sandbox",
-        "description": "Suspend a running sandbox for later connection; use delete to discard it instead. Unlike E2B, light sandboxes preserve disk rather than memory, and persistent sandboxes can resume on data-plane traffic even when autoResume is false. Inspect paused state with the management retrieve operation to avoid waking the sandbox. Explicitly ephemeral sandboxes cannot pause. memory defaults to true, but only a memory-capable sandbox preserves running processes; memory=false saves disk state and resumes with a cold boot. Success returns 204; connect resumes the saved sandbox.",
+        "description": "Pause a running sandbox, keeping its files and memory so that connectSandbox can resume it later. Use it to stop paying for compute without losing state; to discard the sandbox use killSandbox. Success answers 204. A sandbox that is not running answers 409.",
         "http": "POST",
         "path": "/sandbox/v1/sandboxes/{sandboxID}/pause",
         "streaming": "no",
@@ -13084,7 +13084,7 @@ export const operations = [
         "resource": "sandbox.templates",
         "method": "list",
         "summary": "List templates (v2)",
-        "description": "Choose a templateID before creating a sandbox. Unlike E2B, this catalog lists your ready Environments and public Bases; use a returned ID or alias; `base` is the default template that create uses when templateID is omitted. Page through results using nextToken.",
+        "description": "List the templates you can create sandboxes from. Use it to pick the template id or alias for createSandbox. `base` is the default template that createSandbox uses when templateID is omitted. limit is 1 to 100 (default 100); send the cursor from the response back as nextToken to continue.",
         "http": "GET",
         "path": "/sandbox/v1/templates",
         "streaming": "no",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deepraxis/sdk",
-  "version": "0.1.0-dev.c01abef",
+  "version": "0.1.0-dev.c0c05d8",
   "type": "module",
   "sideEffects": false,
   "exports": {