@promptbook/remote-client 0.98.0 → 0.100.0-0

package/README.md

@@ -25,6 +25,10 @@ Write AI applications using plain human language across multiple models and plat
 
 
 
+<blockquote style="color: #ff8811">
+    <b>⚠ Warning:</b> This is a pre-release version of the library. It is not yet ready for production use. Please look at <a href="https://www.npmjs.com/package/@promptbook/core?activeTab=versions">latest stable release</a>.
+</blockquote>
+
 ## 📦 Package `@promptbook/remote-client`
 
 - Promptbooks are [divided into several](#-packages) packages, all are published from [single monorepo](https://github.com/webgptorg/promptbook).

package/esm/index.es.js

@@ -20,7 +20,7 @@ const BOOK_LANGUAGE_VERSION = '1.0.0';
  * @generated
  * @see https://github.com/webgptorg/promptbook
  */
-const PROMPTBOOK_ENGINE_VERSION = '0.98.0';
+const PROMPTBOOK_ENGINE_VERSION = '0.100.0-0';
 /**
  * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
  * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -349,9 +349,12 @@ const LOOP_LIMIT = 1000;
 /**
  * Timeout for the connections in milliseconds
  *
+ * Note: Increased from 7 seconds to 30 seconds to accommodate OAuth flows
+ * like Facebook login which may require user interaction and redirects
+ *
  * @private within the repository - too low-level in comparison with other `MAX_...`
  */
-const CONNECTION_TIMEOUT_MS = 7 * 1000;
+const CONNECTION_TIMEOUT_MS = 30 * 1000;
 // <- TODO: [⏳] Standardize timeouts, Make DEFAULT_TIMEOUT_MS as global constant
 /**
  * How many times to retry the connections
@@ -617,13 +620,39 @@ async function createRemoteClient(options) {
             transports: ['polling', 'websocket' /*, <- TODO: [🌬] Allow to pass `transports`, add 'webtransport' */],
         });
         // console.log('Connecting to', this.options.remoteServerUrl.href, { socket });
+        let isResolved = false;
         socket.on('connect', () => {
-            resolve(socket);
+            if (!isResolved) {
+                isResolved = true;
+                resolve(socket);
+            }
+        });
+        socket.on('connect_error', (error) => {
+            if (!isResolved) {
+                isResolved = true;
+                reject(new Error(`Failed to connect to ${remoteServerUrl}: ${error.message || error}`));
+            }
+        });
+        socket.on('disconnect', (reason) => {
+            if (!isResolved) {
+                isResolved = true;
+                reject(new Error(`Connection to ${remoteServerUrl} was disconnected: ${reason}`));
+            }
         });
-        // TODO: [💩] Better timeout handling
-        setTimeout(() => {
-            reject(new Error(`Timeout while connecting to ${remoteServerUrl}`));
+        // Better timeout handling with more descriptive error message
+        const timeoutId = setTimeout(() => {
+            if (!isResolved) {
+                isResolved = true;
+                socket.disconnect();
+                reject(new Error(`Connection timeout after ${CONNECTION_TIMEOUT_MS / 1000} seconds while connecting to ${remoteServerUrl}. ` +
+                    `This may indicate network issues or the server may be experiencing high load. ` +
+                    `For authentication flows like social login, ensure sufficient time is allowed for user interaction.`));
+            }
         }, CONNECTION_TIMEOUT_MS);
+        // Clean up timeout if connection succeeds
+        socket.on('connect', () => {
+            clearTimeout(timeoutId);
+        });
     });
 }
 
@@ -5629,8 +5658,33 @@ class RemoteLlmExecutionTools {
      * Check the configuration of all execution tools
      */
     async checkConfiguration() {
-        const socket = await createRemoteClient(this.options);
-        socket.disconnect();
+        try {
+            const socket = await createRemoteClient(this.options);
+            socket.disconnect();
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                // Provide user-friendly error messages for common connection issues
+                if (error.message.includes('timeout') || error.message.includes('Timeout')) {
+                    throw new Error(`Connection to Promptbook server timed out. This may happen during authentication flows like Facebook login. ` +
+                        `Please ensure: 1) Server is running at ${this.options.remoteServerUrl}, ` +
+                        `2) Network connection is stable, 3) Authentication process is completed within the timeout period. ` +
+                        `Original error: ${error.message}`);
+                }
+                if (error.message.includes('connect') || error.message.includes('ECONNREFUSED')) {
+                    throw new Error(`Cannot connect to Promptbook server at ${this.options.remoteServerUrl}. ` +
+                        `Please check if the server is running and accessible. ` +
+                        `Original error: ${error.message}`);
+                }
+                if (error.message.includes('authentication') || error.message.includes('auth')) {
+                    throw new Error(`Authentication failed when connecting to Promptbook server. ` +
+                        `This may happen if social login (like Facebook) was not completed properly. ` +
+                        `Please retry the authentication process. ` +
+                        `Original error: ${error.message}`);
+                }
+            }
+            throw error; // Re-throw if not a recognized error pattern
+        }
         // TODO: [main] !!3 Check version of the remote server and compatibility
         // TODO: [🎍] Send checkConfiguration
     }