@promptbook/wizard 0.98.0-9 → 0.99.0-0

package/esm/typings/src/config.d.ts

@@ -138,6 +138,9 @@ export declare 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_...`
  */
 export declare const CONNECTION_TIMEOUT_MS: number;
@@ -147,6 +150,13 @@ export declare const CONNECTION_TIMEOUT_MS: number;
  * @private within the repository - too low-level in comparison with other `MAX_...`
  */
 export declare const CONNECTION_RETRIES_LIMIT = 5;
+/**
+ * Timeout specifically for OAuth authentication flows in milliseconds
+ * OAuth flows typically require more time due to user interaction and redirects
+ *
+ * @private within the repository - too low-level in comparison with other `MAX_...`
+ */
+export declare const OAUTH_TIMEOUT_MS: number;
 /**
  * Short time interval to prevent race conditions in milliseconds
  *

package/esm/typings/src/remote-server/connection-improvements.test.d.ts

@@ -0,0 +1 @@
+export {};

package/esm/typings/src/remote-server/utils/connectionProgress.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Connection progress utilities for better user experience during authentication
+ */
+/**
+ * Connection status types for better progress indication
+ *
+ * @private
+ */
+export type ConnectionStatus = 'connecting' | 'authenticating' | 'connected' | 'disconnected' | 'error' | 'timeout';
+/**
+ * Progress callback function type for connection status updates
+ *
+ * @private
+ */
+export type ConnectionProgressCallback = (status: ConnectionStatus, message?: string) => void;
+/**
+ * Enhanced connection options with progress reporting
+ *
+ * @private
+ */
+export interface ConnectionProgressOptions {
+    onProgress?: ConnectionProgressCallback;
+    enableProgressReporting?: boolean;
+}
+/**
+ * Default progress messages for different connection states
+ *
+ * @private
+ */
+export declare const DEFAULT_PROGRESS_MESSAGES: {
+    readonly connecting: "Connecting to Promptbook server...";
+    readonly authenticating: "Authenticating with social provider (Facebook, Google, etc.)...";
+    readonly connected: "Successfully connected to Promptbook server";
+    readonly disconnected: "Disconnected from Promptbook server";
+    readonly error: "Connection failed";
+    readonly timeout: "Connection timed out - this may happen during social login flows";
+};
+/**
+ * Creates a progress reporter for connection status
+ * This can be used by frontend applications to show connection progress
+ *
+ * @private
+ */
+export declare function createConnectionProgressReporter(callback?: ConnectionProgressCallback): ConnectionProgressCallback;
+/**
+ * Timeout constants with descriptions for different connection types
+ *
+ * @private
+ */
+export declare const CONNECTION_TIMEOUTS: {
+    /** Standard timeout for regular connections */
+    readonly STANDARD: number;
+    /** Extended timeout for OAuth flows that require user interaction */
+    readonly OAUTH: number;
+    /** Short timeout for quick health checks */
+    readonly HEALTH_CHECK: number;
+};
+/**
+ * Helper function to get appropriate timeout based on connection type
+ *
+ * @private
+ */
+export declare function getConnectionTimeout(type: 'standard' | 'oauth' | 'health_check'): number;
+/**
+ * Creates a timeout wrapper with progress reporting
+ *
+ * @private
+ */
+export declare function createTimeoutWithProgress(timeoutMs: number, onProgress?: ConnectionProgressCallback): Promise<never>;
+/**
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ */

package/esm/typings/src/version.d.ts

@@ -15,7 +15,7 @@ export declare const BOOK_LANGUAGE_VERSION: string_semantic_version;
 export declare const PROMPTBOOK_ENGINE_VERSION: string_promptbook_version;
 /**
  * Represents the version string of the Promptbook engine.
- * It follows semantic versioning (e.g., `0.98.0-8`).
+ * It follows semantic versioning (e.g., `0.98.0`).
  *
  * @generated
  */

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@promptbook/wizard",
-    "version": "0.98.0-9",
+    "version": "0.99.0-0",
     "description": "Promptbook: Run AI apps in plain human language across multiple models and platforms",
     "private": false,
     "sideEffects": false,
@@ -15,51 +15,72 @@
     ],
     "keywords": [
         "ai",
-        "llm",
-        "prompt",
-        "template",
+        "ai-agents",
+        "ai-application-framework",
+        "ai-assistant",
+        "ai-automation",
+        "ai-development",
+        "ai-framework",
+        "ai-ops",
+        "ai-orchestration",
+        "ai-pipeline",
+        "ai-platform",
+        "ai-scripting",
+        "ai-sdk",
+        "ai-workflow",
+        "api-integration",
+        "automation-framework",
+        "book-language",
+        "browser",
+        "chatbot",
+        "configuration",
+        "content-generation",
+        "conversational-ai",
+        "cross-platform",
+        "cross-provider",
+        "developer-tools",
+        "embeddings",
+        "function-calling",
+        "generative-ai",
+        "getting-started",
+        "human-readable",
+        "javascript",
+        "knowledge-base",
         "language-model",
-        "chatgpt",
-        "autogpt",
+        "large-language-models",
+        "llm",
+        "llmops",
         "machine-learning",
+        "markdown-dsl",
+        "mlops",
+        "model-agnostic",
+        "multi-model",
+        "multimodal",
+        "natural-language",
         "natural-language-processing",
         "nlp",
-        "openai",
-        "o3",
-        "o3-mini",
-        "deepseek",
-        "gpt-3",
-        "gpt-4",
-        "gpt-4o",
-        "gpt-4o-mini",
-        "o1",
-        "o1-mini",
-        "o1-preview",
-        "anthropic",
-        "claude",
-        "claude-3",
-        "claude-3-opus",
-        "claude-3-sonnet",
-        "claude-3-haiku",
-        "gemini",
-        "gemini-pro",
-        "gemini-flash",
-        "mixtral",
-        "mistral",
-        "ollama",
-        "ai-orchestration",
+        "nodejs",
+        "orchestration",
+        "pipeline",
+        "plain-english",
+        "prompt",
+        "prompt-chaining",
         "prompt-engineering",
-        "llmops",
-        "multimodal",
-        "reasoning",
+        "prompt-management",
+        "prompt-template",
         "rag",
-        "embeddings",
-        "function-calling",
-        "large-language-models",
-        "ai-application-framework",
+        "reasoning",
+        "setup",
+        "task-automation",
+        "template",
         "text-generation",
-        "ai-agents",
-        "LLMOps"
+        "text-processing",
+        "typescript",
+        "unified-interface",
+        "vendor-agnostic",
+        "wizard",
+        "workflow",
+        "workflow-engine"
     ],
     "license": "BUSL-1.1",
     "bugs": {
@@ -74,7 +95,7 @@
     "module": "./esm/index.es.js",
     "typings": "./esm/typings/src/_packages/wizard.index.d.ts",
     "peerDependencies": {
-        "@promptbook/core": "0.98.0-9"
+        "@promptbook/core": "0.99.0-0"
     },
     "dependencies": {
         "@ai-sdk/deepseek": "0.1.6",

package/umd/index.umd.js

@@ -49,7 +49,7 @@
      * @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
@@ -203,9 +203,12 @@
     /**
      * 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
@@ -1397,13 +1400,39 @@
                 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);
+            });
         });
     }
 
@@ -1449,8 +1478,33 @@
          * 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
         }
@@ -5124,6 +5178,7 @@
                 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,
@@ -12141,9 +12196,10 @@
                 .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__default["default"]((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: