@promptbook/wizard 0.98.0-9 → 0.99.0-0

package/esm/index.es.js

@@ -38,7 +38,7 @@ const BOOK_LANGUAGE_VERSION = '1.0.0';
  * @generated
  * @see https://github.com/webgptorg/promptbook
  */
-const PROMPTBOOK_ENGINE_VERSION = '0.98.0-9';
+const PROMPTBOOK_ENGINE_VERSION = '0.99.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
@@ -192,9 +192,12 @@ const SMALL_NUMBER = 0.001;
 /**
  * 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
@@ -1386,13 +1389,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);
+        });
     });
 }
 
@@ -1438,8 +1467,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
     }
@@ -5113,6 +5167,7 @@ const _OpenAiCompatibleMetadataRegistration = $llmToolsMetadataRegister.register
             options: {
                 apiKey: 'sk-',
                 baseURL: 'https://api.openai.com/v1',
+                defaultModelName: 'gpt-4-turbo',
                 isProxied: false,
                 remoteServerUrl: DEFAULT_REMOTE_SERVER_URL,
                 maxRequestsPerMinute: DEFAULT_MAX_REQUESTS_PER_MINUTE,
@@ -12130,9 +12185,10 @@ function createLlmToolsFromConfiguration(configuration, options = {}) {
             .list()
             .find(({ packageName, className }) => llmConfiguration.packageName === packageName && llmConfiguration.className === className);
         if (registeredItem === undefined) {
-            console.log('!!! $llmToolsRegister.list()', $llmToolsRegister.list());
+            // console.log('$llmToolsRegister.list()', $llmToolsRegister.list());
             throw new Error(spaceTrim((block) => `
                         There is no constructor for LLM provider \`${llmConfiguration.className}\` from \`${llmConfiguration.packageName}\`
+                        Running in ${!$isRunningInBrowser() ? '' : 'browser environment'}${!$isRunningInNode() ? '' : 'node environment'}${!$isRunningInWebWorker() ? '' : 'worker environment'}
 
                         You have probably forgotten install and import the provider package.
                         To fix this issue, you can: