computesdk 2.4.0 → 2.5.1

package/dist/index.d.mts

@@ -89,6 +89,19 @@ interface RunCommandOptions {
     timeout?: number;
     background?: boolean;
 }
+/**
+ * Snapshot information
+ */
+interface Snapshot {
+    /** Unique identifier for the snapshot */
+    id: string;
+    /** Provider hosting the snapshot */
+    provider: string;
+    /** When the snapshot was created */
+    createdAt: Date;
+    /** Additional provider-specific metadata */
+    metadata?: Record<string, any>;
+}
 /**
  * Filesystem operations interface
  */
@@ -3833,7 +3846,7 @@ declare const PROVIDER_AUTH: {
     readonly daytona: readonly [readonly ["DAYTONA_API_KEY"]];
     readonly vercel: readonly [readonly ["VERCEL_OIDC_TOKEN"], readonly ["VERCEL_TOKEN", "VERCEL_TEAM_ID", "VERCEL_PROJECT_ID"]];
     readonly runloop: readonly [readonly ["RUNLOOP_API_KEY"]];
-    readonly cloudflare: readonly [readonly ["CLOUDFLARE_API_TOKEN", "CLOUDFLARE_ACCOUNT_ID"]];
+    readonly cloudflare: readonly [readonly ["CLOUDFLARE_SANDBOX_URL", "CLOUDFLARE_SANDBOX_SECRET"], readonly ["CLOUDFLARE_API_TOKEN", "CLOUDFLARE_ACCOUNT_ID"]];
     readonly codesandbox: readonly [readonly ["CSB_API_KEY"]];
     readonly blaxel: readonly [readonly ["BL_API_KEY", "BL_WORKSPACE"]];
     readonly namespace: readonly [readonly ["NSC_TOKEN"], readonly ["NSC_TOKEN_FILE"]];
@@ -4101,6 +4114,36 @@ declare class ComputeManager {
          */
         extendTimeout: (sandboxId: string, options?: ExtendTimeoutOptions) => Promise<void>;
     };
+    snapshot: {
+        /**
+         * Create a snapshot from a running sandbox
+         *
+         * @param sandboxId ID of the sandbox to snapshot
+         * @param options Snapshot options (name, metadata)
+         */
+        create: (sandboxId: string, options?: {
+            name?: string;
+            metadata?: Record<string, any>;
+        }) => Promise<{
+            id: string;
+            provider: string;
+            createdAt: Date;
+            metadata?: Record<string, any>;
+        }>;
+        /**
+         * List all snapshots
+         */
+        list: () => Promise<Array<{
+            id: string;
+            provider: string;
+            createdAt: Date;
+            metadata?: Record<string, any>;
+        }>>;
+        /**
+         * Delete a snapshot
+         */
+        delete: (snapshotId: string) => Promise<void>;
+    };
 }
 /**
  * Callable compute interface - dual nature as both singleton and factory
@@ -4190,7 +4233,7 @@ declare function autoConfigureCompute(): GatewayConfig | null;
 /**
  * Default gateway URL for sandbox lifecycle operations
  */
-declare const GATEWAY_URL = "https://gateway.computesdk.com";
+declare const TRIBUTARY_URL = "https://tributary.edge.computesdk.com";
 /**
  * Provider detection priority order
  * When multiple provider credentials are detected, use the first one in this list
@@ -4218,4 +4261,4 @@ declare const PROVIDER_ENV_VARS: {
     readonly 'just-bash': readonly [];
 };
 
-export { type CallableCompute, type CodeResult$1 as CodeResult, CommandExitError, type CommandResult$1 as CommandResult, type CreateSandboxOptions$1 as CreateSandboxOptions, type ExplicitComputeConfig, type FileEntry, FileWatcher, GATEWAY_URL, Sandbox as GatewaySandbox, MessageType, PROVIDER_AUTH, PROVIDER_DASHBOARD_URLS, PROVIDER_ENV_MAP, PROVIDER_ENV_VARS, PROVIDER_HEADERS, PROVIDER_NAMES, PROVIDER_PRIORITY, type ProviderName, type ProviderSandboxInfo, type RunCommandOptions, type Runtime, Sandbox, type SandboxFileSystem, type SandboxInfo$1 as SandboxInfo, type Sandbox$1 as SandboxInterface, type SandboxStatus, type SetupOverlayConfig, type SetupPayload, SignalService, TerminalInstance, type WebSocketConstructor, autoConfigureCompute, buildProviderHeaders, buildSetupPayload, compute, decodeBinaryMessage, detectProvider, encodeBinaryMessage, encodeSetupPayload, getMissingEnvVars, getProviderConfigFromEnv, getProviderHeaders, isCommandExitError, isGatewayModeEnabled, isProviderAuthComplete, isValidProvider };
+export { type CallableCompute, type CodeResult$1 as CodeResult, CommandExitError, type CommandResult$1 as CommandResult, type CreateSandboxOptions$1 as CreateSandboxOptions, type ExplicitComputeConfig, type FileEntry, FileWatcher, Sandbox as GatewaySandbox, MessageType, PROVIDER_AUTH, PROVIDER_DASHBOARD_URLS, PROVIDER_ENV_MAP, PROVIDER_ENV_VARS, PROVIDER_HEADERS, PROVIDER_NAMES, PROVIDER_PRIORITY, type ProviderName, type ProviderSandboxInfo, type RunCommandOptions, type Runtime, Sandbox, type SandboxFileSystem, type SandboxInfo$1 as SandboxInfo, type Sandbox$1 as SandboxInterface, type SandboxStatus, type SetupOverlayConfig, type SetupPayload, SignalService, type Snapshot, TRIBUTARY_URL, TerminalInstance, type WebSocketConstructor, autoConfigureCompute, buildProviderHeaders, buildSetupPayload, compute, decodeBinaryMessage, detectProvider, encodeBinaryMessage, encodeSetupPayload, getMissingEnvVars, getProviderConfigFromEnv, getProviderHeaders, isCommandExitError, isGatewayModeEnabled, isProviderAuthComplete, isValidProvider };

package/dist/index.d.ts

@@ -89,6 +89,19 @@ interface RunCommandOptions {
     timeout?: number;
     background?: boolean;
 }
+/**
+ * Snapshot information
+ */
+interface Snapshot {
+    /** Unique identifier for the snapshot */
+    id: string;
+    /** Provider hosting the snapshot */
+    provider: string;
+    /** When the snapshot was created */
+    createdAt: Date;
+    /** Additional provider-specific metadata */
+    metadata?: Record<string, any>;
+}
 /**
  * Filesystem operations interface
  */
@@ -3833,7 +3846,7 @@ declare const PROVIDER_AUTH: {
     readonly daytona: readonly [readonly ["DAYTONA_API_KEY"]];
     readonly vercel: readonly [readonly ["VERCEL_OIDC_TOKEN"], readonly ["VERCEL_TOKEN", "VERCEL_TEAM_ID", "VERCEL_PROJECT_ID"]];
     readonly runloop: readonly [readonly ["RUNLOOP_API_KEY"]];
-    readonly cloudflare: readonly [readonly ["CLOUDFLARE_API_TOKEN", "CLOUDFLARE_ACCOUNT_ID"]];
+    readonly cloudflare: readonly [readonly ["CLOUDFLARE_SANDBOX_URL", "CLOUDFLARE_SANDBOX_SECRET"], readonly ["CLOUDFLARE_API_TOKEN", "CLOUDFLARE_ACCOUNT_ID"]];
     readonly codesandbox: readonly [readonly ["CSB_API_KEY"]];
     readonly blaxel: readonly [readonly ["BL_API_KEY", "BL_WORKSPACE"]];
     readonly namespace: readonly [readonly ["NSC_TOKEN"], readonly ["NSC_TOKEN_FILE"]];
@@ -4101,6 +4114,36 @@ declare class ComputeManager {
          */
         extendTimeout: (sandboxId: string, options?: ExtendTimeoutOptions) => Promise<void>;
     };
+    snapshot: {
+        /**
+         * Create a snapshot from a running sandbox
+         *
+         * @param sandboxId ID of the sandbox to snapshot
+         * @param options Snapshot options (name, metadata)
+         */
+        create: (sandboxId: string, options?: {
+            name?: string;
+            metadata?: Record<string, any>;
+        }) => Promise<{
+            id: string;
+            provider: string;
+            createdAt: Date;
+            metadata?: Record<string, any>;
+        }>;
+        /**
+         * List all snapshots
+         */
+        list: () => Promise<Array<{
+            id: string;
+            provider: string;
+            createdAt: Date;
+            metadata?: Record<string, any>;
+        }>>;
+        /**
+         * Delete a snapshot
+         */
+        delete: (snapshotId: string) => Promise<void>;
+    };
 }
 /**
  * Callable compute interface - dual nature as both singleton and factory
@@ -4190,7 +4233,7 @@ declare function autoConfigureCompute(): GatewayConfig | null;
 /**
  * Default gateway URL for sandbox lifecycle operations
  */
-declare const GATEWAY_URL = "https://gateway.computesdk.com";
+declare const TRIBUTARY_URL = "https://tributary.edge.computesdk.com";
 /**
  * Provider detection priority order
  * When multiple provider credentials are detected, use the first one in this list
@@ -4218,4 +4261,4 @@ declare const PROVIDER_ENV_VARS: {
     readonly 'just-bash': readonly [];
 };
 
-export { type CallableCompute, type CodeResult$1 as CodeResult, CommandExitError, type CommandResult$1 as CommandResult, type CreateSandboxOptions$1 as CreateSandboxOptions, type ExplicitComputeConfig, type FileEntry, FileWatcher, GATEWAY_URL, Sandbox as GatewaySandbox, MessageType, PROVIDER_AUTH, PROVIDER_DASHBOARD_URLS, PROVIDER_ENV_MAP, PROVIDER_ENV_VARS, PROVIDER_HEADERS, PROVIDER_NAMES, PROVIDER_PRIORITY, type ProviderName, type ProviderSandboxInfo, type RunCommandOptions, type Runtime, Sandbox, type SandboxFileSystem, type SandboxInfo$1 as SandboxInfo, type Sandbox$1 as SandboxInterface, type SandboxStatus, type SetupOverlayConfig, type SetupPayload, SignalService, TerminalInstance, type WebSocketConstructor, autoConfigureCompute, buildProviderHeaders, buildSetupPayload, compute, decodeBinaryMessage, detectProvider, encodeBinaryMessage, encodeSetupPayload, getMissingEnvVars, getProviderConfigFromEnv, getProviderHeaders, isCommandExitError, isGatewayModeEnabled, isProviderAuthComplete, isValidProvider };
+export { type CallableCompute, type CodeResult$1 as CodeResult, CommandExitError, type CommandResult$1 as CommandResult, type CreateSandboxOptions$1 as CreateSandboxOptions, type ExplicitComputeConfig, type FileEntry, FileWatcher, Sandbox as GatewaySandbox, MessageType, PROVIDER_AUTH, PROVIDER_DASHBOARD_URLS, PROVIDER_ENV_MAP, PROVIDER_ENV_VARS, PROVIDER_HEADERS, PROVIDER_NAMES, PROVIDER_PRIORITY, type ProviderName, type ProviderSandboxInfo, type RunCommandOptions, type Runtime, Sandbox, type SandboxFileSystem, type SandboxInfo$1 as SandboxInfo, type Sandbox$1 as SandboxInterface, type SandboxStatus, type SetupOverlayConfig, type SetupPayload, SignalService, type Snapshot, TRIBUTARY_URL, TerminalInstance, type WebSocketConstructor, autoConfigureCompute, buildProviderHeaders, buildSetupPayload, compute, decodeBinaryMessage, detectProvider, encodeBinaryMessage, encodeSetupPayload, getMissingEnvVars, getProviderConfigFromEnv, getProviderHeaders, isCommandExitError, isGatewayModeEnabled, isProviderAuthComplete, isValidProvider };

package/dist/index.js

@@ -22,7 +22,6 @@ var index_exports = {};
 __export(index_exports, {
   CommandExitError: () => CommandExitError,
   FileWatcher: () => FileWatcher,
-  GATEWAY_URL: () => GATEWAY_URL,
   GatewaySandbox: () => Sandbox,
   MessageType: () => MessageType,
   PROVIDER_AUTH: () => PROVIDER_AUTH,
@@ -34,6 +33,7 @@ __export(index_exports, {
   PROVIDER_PRIORITY: () => PROVIDER_PRIORITY,
   Sandbox: () => Sandbox,
   SignalService: () => SignalService,
+  TRIBUTARY_URL: () => TRIBUTARY_URL,
   TerminalInstance: () => TerminalInstance,
   autoConfigureCompute: () => autoConfigureCompute,
   buildProviderHeaders: () => buildProviderHeaders,
@@ -3641,7 +3641,10 @@ var PROVIDER_AUTH = {
     ["VERCEL_TOKEN", "VERCEL_TEAM_ID", "VERCEL_PROJECT_ID"]
   ],
   runloop: [["RUNLOOP_API_KEY"]],
-  cloudflare: [["CLOUDFLARE_API_TOKEN", "CLOUDFLARE_ACCOUNT_ID"]],
+  cloudflare: [
+    ["CLOUDFLARE_SANDBOX_URL", "CLOUDFLARE_SANDBOX_SECRET"],
+    ["CLOUDFLARE_API_TOKEN", "CLOUDFLARE_ACCOUNT_ID"]
+  ],
   codesandbox: [["CSB_API_KEY"]],
   blaxel: [["BL_API_KEY", "BL_WORKSPACE"]],
   namespace: [["NSC_TOKEN"], ["NSC_TOKEN_FILE"]],
@@ -3681,6 +3684,8 @@ var PROVIDER_HEADERS = {
     apiKey: "X-Runloop-API-Key"
   },
   cloudflare: {
+    sandboxUrl: "X-Cloudflare-Sandbox-Url",
+    sandboxSecret: "X-Cloudflare-Sandbox-Secret",
     apiToken: "X-Cloudflare-API-Token",
     accountId: "X-Cloudflare-Account-Id"
   },
@@ -3736,6 +3741,8 @@ var PROVIDER_ENV_MAP = {
     RUNLOOP_API_KEY: "apiKey"
   },
   cloudflare: {
+    CLOUDFLARE_SANDBOX_URL: "sandboxUrl",
+    CLOUDFLARE_SANDBOX_SECRET: "sandboxSecret",
     CLOUDFLARE_API_TOKEN: "apiToken",
     CLOUDFLARE_ACCOUNT_ID: "accountId"
   },
@@ -3834,7 +3841,7 @@ function getMissingEnvVars(provider) {
 }
 
 // src/constants.ts
-var GATEWAY_URL = "https://gateway.computesdk.com";
+var TRIBUTARY_URL = "https://tributary.edge.computesdk.com";
 var PROVIDER_PRIORITY = [
   "e2b",
   "railway",
@@ -4065,7 +4072,7 @@ Or set COMPUTESDK_PROVIDER to specify explicitly:
 Docs: https://computesdk.com/docs/quickstart`
     );
   }
-  const gatewayUrl = process.env.COMPUTESDK_GATEWAY_URL || GATEWAY_URL;
+  const gatewayUrl = process.env.COMPUTESDK_TRIBUTARY_URL || TRIBUTARY_URL;
   const computesdkApiKey = process.env.COMPUTESDK_API_KEY;
   const providerHeaders = getProviderHeaders(provider);
   try {
@@ -4075,7 +4082,7 @@ Docs: https://computesdk.com/docs/quickstart`
       `Invalid gateway URL: "${gatewayUrl}"
 
 The URL must be a valid HTTP/HTTPS URL.
-Check your COMPUTESDK_GATEWAY_URL environment variable.`
+Check your COMPUTESDK_TRIBUTARY_URL environment variable.`
     );
   }
   if (process.env.COMPUTESDK_DEBUG) {
@@ -4171,7 +4178,7 @@ Get your API key at: https://computesdk.com/dashboard`
   const providerHeaders = buildProviderHeaders2(config);
   return {
     apiKey: computesdkApiKey,
-    gatewayUrl: config.gatewayUrl || process.env.COMPUTESDK_GATEWAY_URL || GATEWAY_URL,
+    gatewayUrl: config.gatewayUrl || process.env.COMPUTESDK_TRIBUTARY_URL || TRIBUTARY_URL,
     provider: config.provider,
     providerHeaders,
     requestTimeoutMs: config.requestTimeoutMs,
@@ -4221,7 +4228,7 @@ Troubleshooting:
 }
 
 // src/compute.ts
-async function gatewayFetch(url, config, options = {}) {
+async function tributaryFetch(url, config, options = {}) {
   const timeout = config.requestTimeoutMs ?? 3e4;
   const controller = new AbortController();
   const timeoutId = setTimeout(() => controller.abort(), timeout);
@@ -4268,7 +4275,7 @@ async function waitForSandboxStatus(config, endpoint, body, options = {}) {
   const startTime = Date.now();
   let currentDelay = initialDelayMs;
   while (Date.now() - startTime < maxWaitMs) {
-    const result = await gatewayFetch(endpoint, config, {
+    const result = await tributaryFetch(endpoint, config, {
       method: "POST",
       body: JSON.stringify(body)
     });
@@ -4319,7 +4326,7 @@ var ComputeManager = class {
        */
       create: async (options) => {
         const config = this.getGatewayConfig();
-        const result = await gatewayFetch(`${config.gatewayUrl}/v1/sandboxes`, config, {
+        const result = await tributaryFetch(`${config.gatewayUrl}/v1/sandboxes`, config, {
           method: "POST",
           body: JSON.stringify(options || {})
         });
@@ -4341,7 +4348,7 @@ var ComputeManager = class {
           },
           WebSocket: config.WebSocket || globalThis.WebSocket,
           destroyHandler: async () => {
-            await gatewayFetch(`${config.gatewayUrl}/v1/sandboxes/${sandboxId}`, config, {
+            await tributaryFetch(`${config.gatewayUrl}/v1/sandboxes/${sandboxId}`, config, {
               method: "DELETE"
             });
           }
@@ -4354,7 +4361,7 @@ var ComputeManager = class {
        */
       getById: async (sandboxId) => {
         const config = this.getGatewayConfig();
-        const result = await gatewayFetch(`${config.gatewayUrl}/v1/sandboxes/${sandboxId}`, config);
+        const result = await tributaryFetch(`${config.gatewayUrl}/v1/sandboxes/${sandboxId}`, config);
         if (!result.success || !result.data) {
           return null;
         }
@@ -4367,7 +4374,7 @@ var ComputeManager = class {
           metadata,
           WebSocket: config.WebSocket || globalThis.WebSocket,
           destroyHandler: async () => {
-            await gatewayFetch(`${config.gatewayUrl}/v1/sandboxes/${sandboxId}`, config, {
+            await tributaryFetch(`${config.gatewayUrl}/v1/sandboxes/${sandboxId}`, config, {
               method: "DELETE"
             });
           }
@@ -4388,7 +4395,7 @@ var ComputeManager = class {
        */
       destroy: async (sandboxId) => {
         const config = this.getGatewayConfig();
-        await gatewayFetch(`${config.gatewayUrl}/v1/sandboxes/${sandboxId}`, config, {
+        await tributaryFetch(`${config.gatewayUrl}/v1/sandboxes/${sandboxId}`, config, {
           method: "DELETE"
         });
       },
@@ -4423,7 +4430,7 @@ var ComputeManager = class {
           },
           WebSocket: config.WebSocket || globalThis.WebSocket,
           destroyHandler: async () => {
-            await gatewayFetch(`${config.gatewayUrl}/v1/sandboxes/${sandboxId}`, config, {
+            await tributaryFetch(`${config.gatewayUrl}/v1/sandboxes/${sandboxId}`, config, {
               method: "DELETE"
             });
           }
@@ -4460,7 +4467,7 @@ var ComputeManager = class {
           },
           WebSocket: config.WebSocket || globalThis.WebSocket,
           destroyHandler: async () => {
-            await gatewayFetch(`${config.gatewayUrl}/v1/sandboxes/${sandboxId}`, config, {
+            await tributaryFetch(`${config.gatewayUrl}/v1/sandboxes/${sandboxId}`, config, {
               method: "DELETE"
             });
           }
@@ -4474,12 +4481,57 @@ var ComputeManager = class {
       extendTimeout: async (sandboxId, options) => {
         const config = this.getGatewayConfig();
         const duration = options?.duration ?? 9e5;
-        await gatewayFetch(`${config.gatewayUrl}/v1/sandboxes/${sandboxId}/extend`, config, {
+        await tributaryFetch(`${config.gatewayUrl}/v1/sandboxes/${sandboxId}/extend`, config, {
           method: "POST",
           body: JSON.stringify({ duration })
         });
       }
     };
+    this.snapshot = {
+      /**
+       * Create a snapshot from a running sandbox
+       * 
+       * @param sandboxId ID of the sandbox to snapshot
+       * @param options Snapshot options (name, metadata)
+       */
+      create: async (sandboxId, options) => {
+        const config = this.getGatewayConfig();
+        const result = await tributaryFetch(`${config.gatewayUrl}/v1/snapshots`, config, {
+          method: "POST",
+          body: JSON.stringify({ sandboxId, ...options })
+        });
+        if (!result.success || !result.data) {
+          throw new Error(`Gateway returned invalid response`);
+        }
+        return {
+          ...result.data,
+          createdAt: new Date(result.data.createdAt)
+        };
+      },
+      /**
+       * List all snapshots
+       */
+      list: async () => {
+        const config = this.getGatewayConfig();
+        const result = await tributaryFetch(`${config.gatewayUrl}/v1/snapshots`, config);
+        if (!result.success || !result.data) {
+          return [];
+        }
+        return result.data.map((s) => ({
+          ...s,
+          createdAt: new Date(s.createdAt)
+        }));
+      },
+      /**
+       * Delete a snapshot
+       */
+      delete: async (snapshotId) => {
+        const config = this.getGatewayConfig();
+        await tributaryFetch(`${config.gatewayUrl}/v1/snapshots/${snapshotId}`, config, {
+          method: "DELETE"
+        });
+      }
+    };
   }
   /**
    * Lazy auto-configure from environment if not explicitly configured
@@ -4561,7 +4613,6 @@ var compute = new Proxy(
 0 && (module.exports = {
   CommandExitError,
   FileWatcher,
-  GATEWAY_URL,
   GatewaySandbox,
   MessageType,
   PROVIDER_AUTH,
@@ -4573,6 +4624,7 @@ var compute = new Proxy(
   PROVIDER_PRIORITY,
   Sandbox,
   SignalService,
+  TRIBUTARY_URL,
   TerminalInstance,
   autoConfigureCompute,
   buildProviderHeaders,