@promptbook/node 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/node",
-    "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,70 @@
     ],
     "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",
+        "backend",
+        "book-language",
+        "browser",
+        "chatbot",
+        "content-generation",
+        "conversational-ai",
+        "cross-platform",
+        "cross-provider",
+        "developer-tools",
+        "embeddings",
+        "function-calling",
+        "generative-ai",
+        "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",
+        "server-side",
+        "task-automation",
+        "template",
         "text-generation",
-        "ai-agents",
-        "LLMOps"
+        "text-processing",
+        "typescript",
+        "unified-interface",
+        "vendor-agnostic",
+        "workflow",
+        "workflow-engine"
     ],
     "license": "BUSL-1.1",
     "bugs": {
@@ -74,7 +93,7 @@
     "module": "./esm/index.es.js",
     "typings": "./esm/typings/src/_packages/node.index.d.ts",
     "peerDependencies": {
-        "@promptbook/core": "0.98.0-9"
+        "@promptbook/core": "0.99.0-0"
     },
     "dependencies": {
         "colors": "1.4.0",

package/umd/index.umd.js

@@ -46,7 +46,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
@@ -10194,6 +10194,46 @@
      * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
      */
 
+    /**
+     * Detects if the code is running in a browser environment in main thread (Not in a web worker)
+     *
+     * Note: `$` is used to indicate that this function is not a pure function - it looks at the global object to determine the environment
+     *
+     * @public exported from `@promptbook/utils`
+     */
+    const $isRunningInBrowser = new Function(`
+    try {
+        return this === window;
+    } catch (e) {
+        return false;
+    }
+`);
+    /**
+     * TODO: [🎺]
+     */
+
+    /**
+     * Detects if the code is running in a web worker
+     *
+     * Note: `$` is used to indicate that this function is not a pure function - it looks at the global object to determine the environment
+     *
+     * @public exported from `@promptbook/utils`
+     */
+    const $isRunningInWebWorker = new Function(`
+    try {
+        if (typeof WorkerGlobalScope !== 'undefined' && self instanceof WorkerGlobalScope) {
+            return true;
+        } else {
+            return false;
+        }
+    } catch (e) {
+        return false;
+    }
+`);
+    /**
+     * TODO: [🎺]
+     */
+
     /**
      * Creates LLM execution tools from provided configuration objects
      *
@@ -10214,9 +10254,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:
@@ -10343,24 +10384,6 @@
      * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
      */
 
-    /**
-     * Detects if the code is running in a browser environment in main thread (Not in a web worker)
-     *
-     * Note: `$` is used to indicate that this function is not a pure function - it looks at the global object to determine the environment
-     *
-     * @public exported from `@promptbook/utils`
-     */
-    new Function(`
-    try {
-        return this === window;
-    } catch (e) {
-        return false;
-    }
-`);
-    /**
-     * TODO: [🎺]
-     */
-
     /**
      * Detects if the code is running in jest environment
      *
@@ -10379,28 +10402,6 @@
      * TODO: [🎺]
      */
 
-    /**
-     * Detects if the code is running in a web worker
-     *
-     * Note: `$` is used to indicate that this function is not a pure function - it looks at the global object to determine the environment
-     *
-     * @public exported from `@promptbook/utils`
-     */
-    new Function(`
-    try {
-        if (typeof WorkerGlobalScope !== 'undefined' && self instanceof WorkerGlobalScope) {
-            return true;
-        } else {
-            return false;
-        }
-    } catch (e) {
-        return false;
-    }
-`);
-    /**
-     * TODO: [🎺]
-     */
-
     /**
      * Makes first letter of a string uppercase
      *