@promptbook/javascript 0.101.0-2 → 0.101.0-4

package/README.md

@@ -48,8 +48,53 @@ npm i ptbk
 npm install @promptbook/javascript
 ```
 
-Engine for executing JavaScript code inside a promptbook.
-It is used for executing scripts in `SCRIPT` tasks.
+JavaScript execution engine for Promptbook, providing secure JavaScript code execution within promptbook pipelines and script tasks.
+
+## 🎯 Purpose and Motivation
+
+This package provides a secure JavaScript execution environment for Promptbook pipelines. It enables the execution of JavaScript code in `SCRIPT` tasks, allowing for complex data transformations, calculations, and logic within promptbook workflows while maintaining security and isolation.
+
+## 🔧 High-Level Functionality
+
+The package provides JavaScript execution capabilities:
+
+-   **Script Task Execution**: Execute JavaScript code within promptbook `SCRIPT` tasks
+-   **Variable Extraction**: Analyze JavaScript code to extract variable dependencies
+-   **Postprocessing Functions**: Built-in JavaScript functions for common postprocessing tasks
+-   **Secure Execution**: Safe execution environment with proper isolation
+-   **Multiple Execution Modes**: Support for different JavaScript execution strategies
+
+## ✨ Key Features
+
+-   🔒 **Secure Execution** - Safe JavaScript execution with proper sandboxing
+-   📝 **Script Tasks** - Execute JavaScript code within promptbook pipelines
+-   🔧 **Variable Analysis** - Extract variable dependencies from JavaScript code
+-   📊 **Postprocessing Functions** - Built-in functions for common data transformations
+-   ⚡ **Multiple Execution Modes** - Different execution strategies for various use cases
+-   🛡️ **Error Handling** - Comprehensive error handling for script execution
+-   🎯 **Pipeline Integration** - Seamless integration with promptbook execution flow
+
+## 📦 Exported Entities
+
+### Version Information
+
+-   `BOOK_LANGUAGE_VERSION` - Current book language version
+-   `PROMPTBOOK_ENGINE_VERSION` - Current engine version
+
+### Execution Tools
+
+-   `JavascriptEvalExecutionTools` - JavaScript execution tools using eval
+-   `JavascriptExecutionTools` - Standard JavaScript execution tools
+
+### Postprocessing
+
+-   `POSTPROCESSING_FUNCTIONS` - Built-in postprocessing functions for JavaScript
+
+### Utilities
+
+-   `extractVariablesFromJavascript` - Extract variable dependencies from JavaScript code
+
+> 💡 This package provides JavaScript execution for promptbook applications. For the core functionality, see [@promptbook/core](#-packages) or install all packages with `npm i ptbk`
 
 
 ---

package/esm/index.es.js

@@ -16,7 +16,7 @@ const BOOK_LANGUAGE_VERSION = '1.0.0';
  * @generated
  * @see https://github.com/webgptorg/promptbook
  */
-const PROMPTBOOK_ENGINE_VERSION = '0.101.0-2';
+const PROMPTBOOK_ENGINE_VERSION = '0.101.0-4';
 /**
  * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
  * Note: [💞] Ignore a discrepancy between file name and entity name

package/esm/typings/src/book-components/Chat/Chat/ChatProps.d.ts

@@ -119,4 +119,24 @@ export type ChatProps = {
      * Keys should match ChatMessage.from values (e.g., 'USER', 'AGENT_{id}', etc.)
      */
     readonly participants?: ReadonlyArray<ChatParticipant>;
+    /**
+     * Optional callback for handling user feedback on messages
+     * When provided, star rating buttons (1-5 stars) will be displayed next to each message
+     *
+     * @param feedback - Object containing the feedback data
+     * @param feedback.message - The message being rated
+     * @param feedback.rating - Star rating from 1 to 5
+     * @param feedback.textRating - Optional text feedback/note from user
+     * @param feedback.chatThread - Complete chat thread as string
+     * @param feedback.expectedAnswer - Optional expected answer provided by user
+     * @param feedback.url - Current page URL where feedback was given
+     */
+    onFeedback?(feedback: {
+        message: ChatMessage;
+        rating: number;
+        textRating: string;
+        chatThread: string;
+        expectedAnswer: string | null;
+        url: string;
+    }): Promisable<void>;
 };

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.101.0-1`).
+ * It follows semantic versioning (e.g., `0.101.0-3`).
  *
  * @generated
  */

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@promptbook/javascript",
-    "version": "0.101.0-2",
+    "version": "0.101.0-4",
     "description": "Promptbook: Run AI apps in plain human language across multiple models and platforms",
     "private": false,
     "sideEffects": false,
@@ -94,7 +94,7 @@
     "module": "./esm/index.es.js",
     "typings": "./esm/typings/src/_packages/javascript.index.d.ts",
     "peerDependencies": {
-        "@promptbook/core": "0.101.0-2"
+        "@promptbook/core": "0.101.0-4"
     },
     "dependencies": {
         "crypto": "1.0.1",

package/umd/index.umd.js

@@ -22,7 +22,7 @@
      * @generated
      * @see https://github.com/webgptorg/promptbook
      */
-    const PROMPTBOOK_ENGINE_VERSION = '0.101.0-2';
+    const PROMPTBOOK_ENGINE_VERSION = '0.101.0-4';
     /**
      * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
      * Note: [💞] Ignore a discrepancy between file name and entity name