computesdk 1.8.2 → 1.8.4

package/dist/index.d.mts

@@ -1,3 +1,5 @@
+import * as _computesdk_client from '@computesdk/client';
+
 /**
  * Sandbox Types
  *
@@ -200,6 +202,86 @@ interface TypedSandbox<TProvider extends Provider$1> extends Omit<Sandbox<Extrac
     /** Get the native provider sandbox instance with proper typing */
     getInstance(): ExtractProviderSandboxType<TProvider>;
 }
+/**
+ * Enhanced sandbox type that includes ComputeClient features
+ *
+ * When a sandbox is created with an API key/JWT, it gets wrapped with ComputeClient
+ * which adds powerful features like WebSocket terminals, file watchers, and signals.
+ *
+ * @example
+ * ```typescript
+ * const sandbox = await compute.sandbox.create();
+ *
+ * // ComputeClient features (only available when API key is configured)
+ * const terminal = await sandbox.createTerminal();
+ * const watcher = await sandbox.createWatcher('/home/project');
+ * const signals = await sandbox.startSignals();
+ *
+ * // Original sandbox features still work
+ * await sandbox.runCommand('ls');
+ * const instance = sandbox.getInstance();
+ * ```
+ */
+type ComputeEnhancedSandbox<TSandbox = any> = Sandbox<TSandbox> & {
+    /** The original provider sandbox instance */
+    __originalSandbox: Sandbox<TSandbox>;
+    /** Create a persistent terminal session with WebSocket integration */
+    createTerminal(shell?: string, encoding?: 'raw' | 'base64'): Promise<_computesdk_client.Terminal>;
+    /** Create a file watcher with real-time change notifications */
+    createWatcher(path: string, options?: {
+        includeContent?: boolean;
+        ignored?: string[];
+        encoding?: 'raw' | 'base64';
+    }): Promise<_computesdk_client.FileWatcher>;
+    /** Start the signal service for port and error monitoring */
+    startSignals(): Promise<_computesdk_client.SignalService>;
+    /** Execute a one-off command without creating a persistent terminal */
+    execute(options: {
+        command: string;
+        shell?: string;
+    }): Promise<any>;
+    /** List all active terminals */
+    listTerminals(): Promise<any[]>;
+    /** Get terminal by ID */
+    getTerminal(id: string): Promise<any>;
+    /** List all active file watchers */
+    listWatchers(): Promise<any>;
+    /** Get file watcher by ID */
+    getWatcher(id: string): Promise<any>;
+    /** Get signal service status */
+    getSignalStatus(): Promise<any>;
+    /** Create a session token (requires access token) */
+    createSessionToken(options?: {
+        description?: string;
+        expiresIn?: number;
+    }): Promise<any>;
+    /** List all session tokens (requires access token) */
+    listSessionTokens(): Promise<any>;
+    /** Get session token details (requires access token) */
+    getSessionToken(tokenId: string): Promise<any>;
+    /** Revoke a session token (requires access token) */
+    revokeSessionToken(tokenId: string): Promise<void>;
+    /** Create a magic link for browser authentication (requires access token) */
+    createMagicLink(options?: {
+        redirectUrl?: string;
+    }): Promise<any>;
+    /** Check authentication status */
+    getAuthStatus(): Promise<any>;
+    /** Get authentication information */
+    getAuthInfo(): Promise<any>;
+    /** Set authentication token manually */
+    setToken(token: string): void;
+    /** Get current authentication token */
+    getToken(): string | null;
+    /** Get current sandbox URL */
+    getSandboxUrl(): string;
+    /** Disconnect WebSocket connection */
+    disconnect(): Promise<void>;
+};
+/**
+ * Typed enhanced sandbox that preserves both provider typing and ComputeClient features
+ */
+type TypedEnhancedSandbox<TProvider extends Provider$1> = ComputeEnhancedSandbox<ExtractProviderSandboxType<TProvider>> & Omit<TypedSandbox<TProvider>, keyof Sandbox>;
 
 /**
  * Common options for creating snapshots
@@ -299,7 +381,9 @@ interface ComputeConfig<TProvider extends Provider = Provider> {
     provider?: TProvider;
     /** API key for compute CLI authentication */
     apiKey?: string;
-    /** JWT token for compute CLI authentication */
+    /** Access token for compute CLI authentication */
+    accessToken?: string;
+    /** @deprecated Use accessToken instead. Kept for backwards compatibility */
     jwt?: string;
 }
 /**
@@ -341,17 +425,18 @@ interface ComputeAPI {
 }
 /**
  * Typed Compute API interface that preserves provider type information
+ * When auth (apiKey/accessToken) is configured, returns enhanced sandboxes with ComputeClient features
  */
-interface TypedComputeAPI<TProvider extends Provider> extends Omit<ComputeAPI, 'sandbox' | 'setConfig'> {
+interface TypedComputeAPI<TProvider extends Provider, TIsEnhanced extends boolean = boolean> extends Omit<ComputeAPI, 'sandbox' | 'setConfig'> {
     /** Configuration management that returns typed compute instance */
     setConfig<T extends Provider>(config: ComputeConfig<T>): TypedComputeAPI<T>;
     sandbox: {
         /** Create a sandbox from the configured provider with proper typing */
-        create(params?: Omit<CreateSandboxParamsWithOptionalProvider, 'provider'>): Promise<TypedSandbox<TProvider>>;
+        create(params?: Omit<CreateSandboxParamsWithOptionalProvider, 'provider'>): Promise<TIsEnhanced extends true ? TypedEnhancedSandbox<TProvider> : TypedSandbox<TProvider>>;
         /** Get an existing sandbox by ID from the configured provider with proper typing */
-        getById(sandboxId: string): Promise<TypedSandbox<TProvider> | null>;
+        getById(sandboxId: string): Promise<TIsEnhanced extends true ? TypedEnhancedSandbox<TProvider> : TypedSandbox<TProvider> | null>;
         /** List all active sandboxes from the configured provider with proper typing */
-        list(): Promise<TypedSandbox<TProvider>[]>;
+        list(): Promise<TIsEnhanced extends true ? TypedEnhancedSandbox<TProvider>[] : TypedSandbox<TProvider>[]>;
         /** Destroy a sandbox via the configured provider */
         destroy(sandboxId: string): Promise<void>;
     };
@@ -375,15 +460,33 @@ declare const compute: ComputeAPI;
  * import { e2b } from '@computesdk/e2b'
  * import { createCompute } from 'computesdk'
  *
+ * // With API key (automatically gets access token from license server)
  * const compute = createCompute({
  *   defaultProvider: e2b({ apiKey: 'your-key' }),
+ *   apiKey: 'computesdk_live_...' // Returns enhanced sandboxes
+ * });
+ *
+ * // Or with direct access token
+ * const compute2 = createCompute({
+ *   defaultProvider: e2b({ apiKey: 'your-key' }),
+ *   accessToken: 'your-access-token' // Returns enhanced sandboxes
  * });
  *
  * const sandbox = await compute.sandbox.create();
  * const instance = sandbox.getInstance(); // ✅ Properly typed E2B Sandbox!
+ * await sandbox.createTerminal(); // ✅ Enhanced sandbox features!
  * ```
  */
-declare function createCompute<TProvider extends Provider>(config: ComputeConfig<TProvider>): TypedComputeAPI<TProvider>;
+declare function createCompute<TProvider extends Provider>(config: ComputeConfig<TProvider> & {
+    apiKey: string;
+}): TypedComputeAPI<TProvider, true>;
+declare function createCompute<TProvider extends Provider>(config: ComputeConfig<TProvider> & {
+    accessToken: string;
+}): TypedComputeAPI<TProvider, true>;
+declare function createCompute<TProvider extends Provider>(config: ComputeConfig<TProvider> & {
+    jwt: string;
+}): TypedComputeAPI<TProvider, true>;
+declare function createCompute<TProvider extends Provider>(config: ComputeConfig<TProvider>): TypedComputeAPI<TProvider, false>;
 
 /**
  * Simplified Request Handler for Web Framework Integration
@@ -525,4 +628,4 @@ interface ProviderConfig<TSandbox = any, TConfig = any, TTemplate = any, TSnapsh
  */
 declare function createProvider<TSandbox, TConfig = any, TTemplate = any, TSnapshot = any>(providerConfig: ProviderConfig<TSandbox, TConfig, TTemplate, TSnapshot>): (config: TConfig) => Provider<TSandbox, TTemplate, TSnapshot>;
 
-export { CommandExitError, type ComputeAPI, type ComputeConfig, type ComputeRequest, type ComputeResponse, type CreateSandboxOptions, type CreateSandboxParams, type CreateSandboxParamsWithOptionalProvider, type CreateSnapshotOptions, type CreateTemplateOptions, type ExecutionResult, type ExtractSandboxInstanceType, type FileEntry, type HandleComputeRequestParams, type ListSnapshotsOptions, type ListTemplatesOptions, type Provider, type ProviderConfig, type ProviderSandboxManager, type ProviderSandboxTypeMap, type ProviderSnapshotManager, type ProviderTemplateManager, type RunCommandOptions, type Runtime, type Sandbox, type SandboxFileSystem, type SandboxInfo, type SandboxMethods, type SandboxStatus, type SnapshotMethods, type TemplateMethods, type TypedComputeAPI, type TypedSandbox, compute, createBackgroundCommand, createCompute, createProvider, handleComputeRequest, isCommandExitError };
+export { CommandExitError, type ComputeAPI, type ComputeConfig, type ComputeEnhancedSandbox, type ComputeRequest, type ComputeResponse, type CreateSandboxOptions, type CreateSandboxParams, type CreateSandboxParamsWithOptionalProvider, type CreateSnapshotOptions, type CreateTemplateOptions, type ExecutionResult, type ExtractSandboxInstanceType, type FileEntry, type HandleComputeRequestParams, type ListSnapshotsOptions, type ListTemplatesOptions, type Provider, type ProviderConfig, type ProviderSandboxManager, type ProviderSandboxTypeMap, type ProviderSnapshotManager, type ProviderTemplateManager, type RunCommandOptions, type Runtime, type Sandbox, type SandboxFileSystem, type SandboxInfo, type SandboxMethods, type SandboxStatus, type SnapshotMethods, type TemplateMethods, type TypedComputeAPI, type TypedEnhancedSandbox, type TypedSandbox, compute, createBackgroundCommand, createCompute, createProvider, handleComputeRequest, isCommandExitError };

package/dist/index.d.ts

@@ -1,3 +1,5 @@
+import * as _computesdk_client from '@computesdk/client';
+
 /**
  * Sandbox Types
  *
@@ -200,6 +202,86 @@ interface TypedSandbox<TProvider extends Provider$1> extends Omit<Sandbox<Extrac
     /** Get the native provider sandbox instance with proper typing */
     getInstance(): ExtractProviderSandboxType<TProvider>;
 }
+/**
+ * Enhanced sandbox type that includes ComputeClient features
+ *
+ * When a sandbox is created with an API key/JWT, it gets wrapped with ComputeClient
+ * which adds powerful features like WebSocket terminals, file watchers, and signals.
+ *
+ * @example
+ * ```typescript
+ * const sandbox = await compute.sandbox.create();
+ *
+ * // ComputeClient features (only available when API key is configured)
+ * const terminal = await sandbox.createTerminal();
+ * const watcher = await sandbox.createWatcher('/home/project');
+ * const signals = await sandbox.startSignals();
+ *
+ * // Original sandbox features still work
+ * await sandbox.runCommand('ls');
+ * const instance = sandbox.getInstance();
+ * ```
+ */
+type ComputeEnhancedSandbox<TSandbox = any> = Sandbox<TSandbox> & {
+    /** The original provider sandbox instance */
+    __originalSandbox: Sandbox<TSandbox>;
+    /** Create a persistent terminal session with WebSocket integration */
+    createTerminal(shell?: string, encoding?: 'raw' | 'base64'): Promise<_computesdk_client.Terminal>;
+    /** Create a file watcher with real-time change notifications */
+    createWatcher(path: string, options?: {
+        includeContent?: boolean;
+        ignored?: string[];
+        encoding?: 'raw' | 'base64';
+    }): Promise<_computesdk_client.FileWatcher>;
+    /** Start the signal service for port and error monitoring */
+    startSignals(): Promise<_computesdk_client.SignalService>;
+    /** Execute a one-off command without creating a persistent terminal */
+    execute(options: {
+        command: string;
+        shell?: string;
+    }): Promise<any>;
+    /** List all active terminals */
+    listTerminals(): Promise<any[]>;
+    /** Get terminal by ID */
+    getTerminal(id: string): Promise<any>;
+    /** List all active file watchers */
+    listWatchers(): Promise<any>;
+    /** Get file watcher by ID */
+    getWatcher(id: string): Promise<any>;
+    /** Get signal service status */
+    getSignalStatus(): Promise<any>;
+    /** Create a session token (requires access token) */
+    createSessionToken(options?: {
+        description?: string;
+        expiresIn?: number;
+    }): Promise<any>;
+    /** List all session tokens (requires access token) */
+    listSessionTokens(): Promise<any>;
+    /** Get session token details (requires access token) */
+    getSessionToken(tokenId: string): Promise<any>;
+    /** Revoke a session token (requires access token) */
+    revokeSessionToken(tokenId: string): Promise<void>;
+    /** Create a magic link for browser authentication (requires access token) */
+    createMagicLink(options?: {
+        redirectUrl?: string;
+    }): Promise<any>;
+    /** Check authentication status */
+    getAuthStatus(): Promise<any>;
+    /** Get authentication information */
+    getAuthInfo(): Promise<any>;
+    /** Set authentication token manually */
+    setToken(token: string): void;
+    /** Get current authentication token */
+    getToken(): string | null;
+    /** Get current sandbox URL */
+    getSandboxUrl(): string;
+    /** Disconnect WebSocket connection */
+    disconnect(): Promise<void>;
+};
+/**
+ * Typed enhanced sandbox that preserves both provider typing and ComputeClient features
+ */
+type TypedEnhancedSandbox<TProvider extends Provider$1> = ComputeEnhancedSandbox<ExtractProviderSandboxType<TProvider>> & Omit<TypedSandbox<TProvider>, keyof Sandbox>;
 
 /**
  * Common options for creating snapshots
@@ -299,7 +381,9 @@ interface ComputeConfig<TProvider extends Provider = Provider> {
     provider?: TProvider;
     /** API key for compute CLI authentication */
     apiKey?: string;
-    /** JWT token for compute CLI authentication */
+    /** Access token for compute CLI authentication */
+    accessToken?: string;
+    /** @deprecated Use accessToken instead. Kept for backwards compatibility */
     jwt?: string;
 }
 /**
@@ -341,17 +425,18 @@ interface ComputeAPI {
 }
 /**
  * Typed Compute API interface that preserves provider type information
+ * When auth (apiKey/accessToken) is configured, returns enhanced sandboxes with ComputeClient features
  */
-interface TypedComputeAPI<TProvider extends Provider> extends Omit<ComputeAPI, 'sandbox' | 'setConfig'> {
+interface TypedComputeAPI<TProvider extends Provider, TIsEnhanced extends boolean = boolean> extends Omit<ComputeAPI, 'sandbox' | 'setConfig'> {
     /** Configuration management that returns typed compute instance */
     setConfig<T extends Provider>(config: ComputeConfig<T>): TypedComputeAPI<T>;
     sandbox: {
         /** Create a sandbox from the configured provider with proper typing */
-        create(params?: Omit<CreateSandboxParamsWithOptionalProvider, 'provider'>): Promise<TypedSandbox<TProvider>>;
+        create(params?: Omit<CreateSandboxParamsWithOptionalProvider, 'provider'>): Promise<TIsEnhanced extends true ? TypedEnhancedSandbox<TProvider> : TypedSandbox<TProvider>>;
         /** Get an existing sandbox by ID from the configured provider with proper typing */
-        getById(sandboxId: string): Promise<TypedSandbox<TProvider> | null>;
+        getById(sandboxId: string): Promise<TIsEnhanced extends true ? TypedEnhancedSandbox<TProvider> : TypedSandbox<TProvider> | null>;
         /** List all active sandboxes from the configured provider with proper typing */
-        list(): Promise<TypedSandbox<TProvider>[]>;
+        list(): Promise<TIsEnhanced extends true ? TypedEnhancedSandbox<TProvider>[] : TypedSandbox<TProvider>[]>;
         /** Destroy a sandbox via the configured provider */
         destroy(sandboxId: string): Promise<void>;
     };
@@ -375,15 +460,33 @@ declare const compute: ComputeAPI;
  * import { e2b } from '@computesdk/e2b'
  * import { createCompute } from 'computesdk'
  *
+ * // With API key (automatically gets access token from license server)
  * const compute = createCompute({
  *   defaultProvider: e2b({ apiKey: 'your-key' }),
+ *   apiKey: 'computesdk_live_...' // Returns enhanced sandboxes
+ * });
+ *
+ * // Or with direct access token
+ * const compute2 = createCompute({
+ *   defaultProvider: e2b({ apiKey: 'your-key' }),
+ *   accessToken: 'your-access-token' // Returns enhanced sandboxes
  * });
  *
  * const sandbox = await compute.sandbox.create();
  * const instance = sandbox.getInstance(); // ✅ Properly typed E2B Sandbox!
+ * await sandbox.createTerminal(); // ✅ Enhanced sandbox features!
  * ```
  */
-declare function createCompute<TProvider extends Provider>(config: ComputeConfig<TProvider>): TypedComputeAPI<TProvider>;
+declare function createCompute<TProvider extends Provider>(config: ComputeConfig<TProvider> & {
+    apiKey: string;
+}): TypedComputeAPI<TProvider, true>;
+declare function createCompute<TProvider extends Provider>(config: ComputeConfig<TProvider> & {
+    accessToken: string;
+}): TypedComputeAPI<TProvider, true>;
+declare function createCompute<TProvider extends Provider>(config: ComputeConfig<TProvider> & {
+    jwt: string;
+}): TypedComputeAPI<TProvider, true>;
+declare function createCompute<TProvider extends Provider>(config: ComputeConfig<TProvider>): TypedComputeAPI<TProvider, false>;
 
 /**
  * Simplified Request Handler for Web Framework Integration
@@ -525,4 +628,4 @@ interface ProviderConfig<TSandbox = any, TConfig = any, TTemplate = any, TSnapsh
  */
 declare function createProvider<TSandbox, TConfig = any, TTemplate = any, TSnapshot = any>(providerConfig: ProviderConfig<TSandbox, TConfig, TTemplate, TSnapshot>): (config: TConfig) => Provider<TSandbox, TTemplate, TSnapshot>;
 
-export { CommandExitError, type ComputeAPI, type ComputeConfig, type ComputeRequest, type ComputeResponse, type CreateSandboxOptions, type CreateSandboxParams, type CreateSandboxParamsWithOptionalProvider, type CreateSnapshotOptions, type CreateTemplateOptions, type ExecutionResult, type ExtractSandboxInstanceType, type FileEntry, type HandleComputeRequestParams, type ListSnapshotsOptions, type ListTemplatesOptions, type Provider, type ProviderConfig, type ProviderSandboxManager, type ProviderSandboxTypeMap, type ProviderSnapshotManager, type ProviderTemplateManager, type RunCommandOptions, type Runtime, type Sandbox, type SandboxFileSystem, type SandboxInfo, type SandboxMethods, type SandboxStatus, type SnapshotMethods, type TemplateMethods, type TypedComputeAPI, type TypedSandbox, compute, createBackgroundCommand, createCompute, createProvider, handleComputeRequest, isCommandExitError };
+export { CommandExitError, type ComputeAPI, type ComputeConfig, type ComputeEnhancedSandbox, type ComputeRequest, type ComputeResponse, type CreateSandboxOptions, type CreateSandboxParams, type CreateSandboxParamsWithOptionalProvider, type CreateSnapshotOptions, type CreateTemplateOptions, type ExecutionResult, type ExtractSandboxInstanceType, type FileEntry, type HandleComputeRequestParams, type ListSnapshotsOptions, type ListTemplatesOptions, type Provider, type ProviderConfig, type ProviderSandboxManager, type ProviderSandboxTypeMap, type ProviderSnapshotManager, type ProviderTemplateManager, type RunCommandOptions, type Runtime, type Sandbox, type SandboxFileSystem, type SandboxInfo, type SandboxMethods, type SandboxStatus, type SnapshotMethods, type TemplateMethods, type TypedComputeAPI, type TypedEnhancedSandbox, type TypedSandbox, compute, createBackgroundCommand, createCompute, createProvider, handleComputeRequest, isCommandExitError };

package/dist/index.js

@@ -61,7 +61,7 @@ async function authorizeApiKey(apiKey) {
     }
     const data = await response.json();
     if (!data.access_token) {
-      throw new Error("No JWT token received from license server");
+      throw new Error("No access token received from license server");
     }
     if (!data.sandbox_url) {
       throw new Error("No sandbox_url received from license server");
@@ -70,7 +70,7 @@ async function authorizeApiKey(apiKey) {
       throw new Error("No preview_url received from license server");
     }
     return {
-      jwt: data.access_token,
+      access_token: data.access_token,
       sandbox_url: data.sandbox_url,
       preview_url: data.preview_url
     };
@@ -82,15 +82,15 @@ async function installComputeInSandbox(sandbox, config) {
   try {
     console.log("Installing and starting compute CLI in sandbox...");
     let authResponse = null;
-    let jwt = config?.jwt;
-    if (config?.apiKey && !jwt) {
-      console.log("Authorizing API key and getting JWT token...");
+    let accessToken = config?.accessToken;
+    if (config?.apiKey && !accessToken) {
+      console.log("Authorizing API key and getting access token...");
       authResponse = await authorizeApiKey(config.apiKey);
-      jwt = authResponse.jwt;
+      accessToken = authResponse.access_token;
     }
     let installCommand = "curl -fsSL https://computesdk.com/install.sh | sh";
-    if (jwt) {
-      installCommand = `curl -fsSL https://computesdk.com/install.sh | sh -s -- --jwt ${jwt}`;
+    if (accessToken) {
+      installCommand = `curl -fsSL https://computesdk.com/install.sh | sh -s -- --access-token ${accessToken}`;
     }
     const result = await sandbox.runCommand("sh", ["-c", installCommand]);
     if (result.exitCode !== 0) {
@@ -105,7 +105,6 @@ async function installComputeInSandbox(sandbox, config) {
 var ComputeManager = class {
   constructor() {
     this.config = null;
-    this.typedState = { isTyped: false, provider: null };
     this.computeAuth = {};
     this.sandbox = {
       /**
@@ -132,18 +131,7 @@ var ComputeManager = class {
         const options = params?.options;
         const sandbox = await provider.sandbox.create(options);
         const authResponse = await installComputeInSandbox(sandbox, this.computeAuth);
-        let finalSandbox = sandbox;
-        if (authResponse) {
-          finalSandbox = new import_client.ComputeClient({
-            sandboxUrl: authResponse.sandbox_url,
-            sandboxId: sandbox.sandboxId,
-            provider: sandbox.provider,
-            token: authResponse.jwt
-          });
-        }
-        if (this.typedState.isTyped && (!params || !("provider" in params && params.provider))) {
-          return finalSandbox;
-        }
+        const finalSandbox = authResponse ? this.wrapWithComputeClient(sandbox, authResponse) : sandbox;
         return finalSandbox;
       },
       /**
@@ -152,11 +140,7 @@ var ComputeManager = class {
       getById: async (providerOrSandboxId, sandboxId) => {
         if (typeof providerOrSandboxId === "string") {
           const provider = this.getDefaultProvider();
-          const sandbox = await provider.sandbox.getById(providerOrSandboxId);
-          if (this.typedState.isTyped && sandbox) {
-            return sandbox;
-          }
-          return sandbox;
+          return await provider.sandbox.getById(providerOrSandboxId);
         } else {
           if (!sandboxId) {
             throw new Error("sandboxId is required when provider is specified");
@@ -169,11 +153,7 @@ var ComputeManager = class {
        */
       list: async (provider) => {
         const actualProvider = provider || this.getDefaultProvider();
-        const sandboxes = await actualProvider.sandbox.list();
-        if (this.typedState.isTyped && !provider) {
-          return sandboxes;
-        }
-        return sandboxes;
+        return await actualProvider.sandbox.list();
       },
       /**
        * Destroy a sandbox via a provider (or default provider if configured)
@@ -202,19 +182,16 @@ var ComputeManager = class {
       console.warn("Both defaultProvider and provider specified in setConfig. Using defaultProvider. The provider key is deprecated, please use defaultProvider instead.");
     }
     const actualProvider = config.defaultProvider || config.provider;
+    const accessToken = config.accessToken || config.jwt;
     this.config = {
       provider: actualProvider,
       defaultProvider: actualProvider,
       apiKey: config.apiKey,
-      jwt: config.jwt
+      accessToken
     };
     this.computeAuth = {
       apiKey: config.apiKey,
-      jwt: config.jwt
-    };
-    this.typedState = {
-      isTyped: true,
-      provider: actualProvider
+      accessToken
     };
   }
   /**
@@ -241,6 +218,26 @@ var ComputeManager = class {
     }
     return provider;
   }
+  /**
+   * Wrap a provider sandbox with ComputeClient while preserving the original sandbox
+   * This adds powerful features like WebSocket terminals, file watchers, and signals
+   */
+  wrapWithComputeClient(originalSandbox, authResponse) {
+    const client = new import_client.ComputeClient({
+      sandboxUrl: authResponse.sandbox_url,
+      sandboxId: originalSandbox.sandboxId,
+      provider: originalSandbox.provider,
+      token: authResponse.access_token
+    });
+    const wrappedSandbox = Object.assign(client, {
+      __originalSandbox: originalSandbox,
+      // Override getInstance to return the original provider's instance
+      getInstance: () => originalSandbox.getInstance(),
+      // Override getProvider to return the original provider
+      getProvider: () => originalSandbox.getProvider()
+    });
+    return wrappedSandbox;
+  }
   // Future: compute.blob.*, compute.database.*, compute.git.* will be added here
   // blob = new BlobManager();
   // database = new DatabaseManager();  
@@ -250,20 +247,18 @@ var compute = new ComputeManager();
 function createCompute(config) {
   const manager = new ComputeManager();
   const actualProvider = config.defaultProvider || config.provider;
+  const accessToken = config.accessToken || config.jwt;
   manager["config"] = {
     provider: actualProvider,
     defaultProvider: actualProvider,
     apiKey: config.apiKey,
-    jwt: config.jwt
-  };
-  manager["typedState"] = {
-    isTyped: true,
-    provider: actualProvider
+    accessToken
   };
   manager["computeAuth"] = {
     apiKey: config.apiKey,
-    jwt: config.jwt
+    accessToken
   };
+  const isEnhanced = !!(config.apiKey || config.accessToken || config.jwt);
   return {
     setConfig: (cfg) => createCompute(cfg),
     getConfig: () => manager.getConfig(),
@@ -271,14 +266,24 @@ function createCompute(config) {
     sandbox: {
       create: async (params) => {
         const sandbox = await manager.sandbox.create(params);
+        if (isEnhanced) {
+          return sandbox;
+        }
         return sandbox;
       },
       getById: async (sandboxId) => {
         const sandbox = await manager.sandbox.getById(sandboxId);
-        return sandbox ? sandbox : null;
+        if (!sandbox) return null;
+        if (isEnhanced) {
+          return sandbox;
+        }
+        return sandbox;
       },
       list: async () => {
         const sandboxes = await manager.sandbox.list();
+        if (isEnhanced) {
+          return sandboxes;
+        }
         return sandboxes;
       },
       destroy: async (sandboxId) => {