@promptbook/node 0.84.0 → 0.85.0-1

package/README.md

@@ -24,6 +24,10 @@
 
 
 
+<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/node`
 
 - Promptbooks are [divided into several](#-packages) packages, all are published from [single monorepo](https://github.com/webgptorg/promptbook).

package/esm/index.es.js

@@ -1,16 +1,18 @@
 import colors from 'colors';
-import { stat, access, constants, readFile, writeFile, readdir, mkdir, unlink } from 'fs/promises';
-import { basename, join, dirname } from 'path';
+import { stat, access, constants, readFile, writeFile, readdir, mkdir, unlink } from 'node:fs/promises';
+import { basename, join, dirname } from 'node:path';
 import spaceTrim, { spaceTrim as spaceTrim$1 } from 'spacetrim';
 import { format } from 'prettier';
 import parserHtml from 'prettier/parser-html';
+import { BehaviorSubject, concat, from } from 'rxjs';
+import { randomBytes } from 'crypto';
 import { forTime } from 'waitasecond';
 import { unparse, parse } from 'papaparse';
 import hexEncoder from 'crypto-js/enc-hex';
 import sha256 from 'crypto-js/sha256';
 import { SHA256 } from 'crypto-js';
 import { lookup, extension } from 'mime-types';
-import { spawn } from 'child_process';
+import { spawn } from 'node:child_process';
 import * as dotenv from 'dotenv';
 
 // ⚠️ WARNING: This code has been generated so that any manual changes will be overwritten
@@ -27,7 +29,7 @@ var BOOK_LANGUAGE_VERSION = '1.0.0';
  * @generated
  * @see https://github.com/webgptorg/promptbook
  */
-var PROMPTBOOK_ENGINE_VERSION = '0.84.0-21';
+var PROMPTBOOK_ENGINE_VERSION = '0.85.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
@@ -1710,6 +1712,58 @@ var MissingToolsError = /** @class */ (function (_super) {
     return MissingToolsError;
 }(Error));
 
+/**
+ * Determine if the pipeline is fully prepared
+ *
+ * @see https://github.com/webgptorg/promptbook/discussions/196
+ *
+ * @public exported from `@promptbook/core`
+ */
+function isPipelinePrepared(pipeline) {
+    // Note: Ignoring `pipeline.preparations` @@@
+    // Note: Ignoring `pipeline.knowledgePieces` @@@
+    if (pipeline.title === undefined || pipeline.title === '' || pipeline.title === DEFAULT_BOOK_TITLE) {
+        return false;
+    }
+    if (!pipeline.personas.every(function (persona) { return persona.modelRequirements !== undefined; })) {
+        return false;
+    }
+    if (!pipeline.knowledgeSources.every(function (knowledgeSource) { return knowledgeSource.preparationIds !== undefined; })) {
+        return false;
+    }
+    /*
+    TODO: [🧠][🍫] `tasks` can not be determined if they are fully prepared SO ignoring them
+    > if (!pipeline.tasks.every(({ preparedContent }) => preparedContent === undefined)) {
+    >     return false;
+    > }
+    */
+    return true;
+}
+/**
+ * TODO: [🔃][main] If the pipeline was prepared with different version or different set of models, prepare it once again
+ * TODO: [🐠] Maybe base this on `makeValidator`
+ * TODO: [🧊] Pipeline can be partially prepared, this should return true ONLY if fully prepared
+ * TODO: [🧿] Maybe do same process with same granularity and subfinctions as `preparePipeline`
+ *     - [🏍] ? Is context in each task
+ *     - [♨] Are examples prepared
+ *     - [♨] Are tasks prepared
+ */
+
+/**
+ * Generates random token
+ *
+ * Note: This function is cryptographically secure (it uses crypto.randomBytes internally)
+ *
+ * @private internal helper function
+ * @returns secure random token
+ */
+function $randomToken(randomness) {
+    return randomBytes(randomness).toString('hex');
+}
+/**
+ * TODO: Maybe use nanoid instead https://github.com/ai/nanoid
+ */
+
 /**
  * This error indicates errors during the execution of the pipeline
  *
@@ -1943,9 +1997,9 @@ function deserializeError(error) {
  *
  * @param executionResult - The partial result of the Promptbook execution
  * @throws {PipelineExecutionError} If the execution is not successful or if multiple errors occurred
- * @public exported from `@promptbook/core`
+ * @private internal helper function of `asPromise` method of `ExecutionTask`
  */
-function assertsExecutionSuccessful(executionResult) {
+function assertsTaskSuccessful(executionResult) {
     var e_1, _a;
     var isSuccessful = executionResult.isSuccessful, errors = executionResult.errors, warnings = executionResult.warnings;
     try {
@@ -1980,47 +2034,72 @@ function assertsExecutionSuccessful(executionResult) {
     }
 }
 /**
- * TODO: [🐚] This function should be removed OR changed OR be completely rewritten
  * TODO: [🧠] Can this return type be better typed than void
  */
 
 /**
- * Determine if the pipeline is fully prepared
- *
- * @see https://github.com/webgptorg/promptbook/discussions/196
+ * Helper to create a new task
  *
- * @public exported from `@promptbook/core`
+ * @private internal helper function
  */
-function isPipelinePrepared(pipeline) {
-    // Note: Ignoring `pipeline.preparations` @@@
-    // Note: Ignoring `pipeline.knowledgePieces` @@@
-    if (pipeline.title === undefined || pipeline.title === '' || pipeline.title === DEFAULT_BOOK_TITLE) {
-        return false;
-    }
-    if (!pipeline.personas.every(function (persona) { return persona.modelRequirements !== undefined; })) {
-        return false;
-    }
-    if (!pipeline.knowledgeSources.every(function (knowledgeSource) { return knowledgeSource.preparationIds !== undefined; })) {
-        return false;
+function createTask(options) {
+    var taskType = options.taskType, taskProcessCallback = options.taskProcessCallback;
+    var taskId = "".concat(taskType.toLowerCase(), "-").concat($randomToken(256 /* <- TODO: !!! To global config */));
+    var partialResultSubject = new BehaviorSubject({});
+    var finalResultPromise = /* not await */ taskProcessCallback(function (newOngoingResult) {
+        partialResultSubject.next(newOngoingResult);
+    });
+    function asPromise(options) {
+        return __awaiter(this, void 0, void 0, function () {
+            var _a, isCrashedOnError, finalResult;
+            return __generator(this, function (_b) {
+                switch (_b.label) {
+                    case 0:
+                        _a = (options || {}).isCrashedOnError, isCrashedOnError = _a === void 0 ? true : _a;
+                        return [4 /*yield*/, finalResultPromise];
+                    case 1:
+                        finalResult = _b.sent();
+                        if (isCrashedOnError) {
+                            assertsTaskSuccessful(finalResult);
+                        }
+                        return [2 /*return*/, finalResult];
+                }
+            });
+        });
     }
-    /*
-    TODO: [🧠][🍫] `tasks` can not be determined if they are fully prepared SO ignoring them
-    > if (!pipeline.tasks.every(({ preparedContent }) => preparedContent === undefined)) {
-    >     return false;
-    > }
-    */
-    return true;
+    return {
+        taskType: taskType,
+        taskId: taskId,
+        asPromise: asPromise,
+        asObservable: function () {
+            return concat(partialResultSubject.asObservable(), from(asPromise({
+                isCrashedOnError: true,
+            })));
+        },
+    };
 }
 /**
- * TODO: [🔃][main] If the pipeline was prepared with different version or different set of models, prepare it once again
- * TODO: [🐠] Maybe base this on `makeValidator`
- * TODO: [🧊] Pipeline can be partially prepared, this should return true ONLY if fully prepared
- * TODO: [🧿] Maybe do same process with same granularity and subfinctions as `preparePipeline`
- *     - [🏍] ? Is context in each task
- *     - [♨] Are examples prepared
- *     - [♨] Are tasks prepared
+ * TODO: Maybe allow to terminate the task and add getter `isFinished` or `status`
+ * TODO: [🐚] Split into more files and make `PrepareTask` & `RemoteTask` + split the function
  */
 
+/**
+ * Serializes an error into a [🚉] JSON-serializable object
+ *
+ * @public exported from `@promptbook/utils`
+ */
+function serializeError(error) {
+    var name = error.name, message = error.message, stack = error.stack;
+    if (!Object.keys(ALL_ERRORS).includes(name)) {
+        console.error(spaceTrim(function (block) { return "\n          \n                    Cannot serialize error with name \"".concat(name, "\"\n\n                    ").concat(block(stack || message), "\n                \n                "); }));
+    }
+    return {
+        name: name,
+        message: message,
+        stack: stack,
+    };
+}
+
 /**
  * Format either small or big number
  *
@@ -2096,23 +2175,6 @@ function valueToString(value) {
     }
 }
 
-/**
- * Serializes an error into a [🚉] JSON-serializable object
- *
- * @public exported from `@promptbook/utils`
- */
-function serializeError(error) {
-    var name = error.name, message = error.message, stack = error.stack;
-    if (!Object.keys(ALL_ERRORS).includes(name)) {
-        console.error(spaceTrim(function (block) { return "\n          \n                    Cannot serialize error with name \"".concat(name, "\"\n\n                    ").concat(block(stack || message), "\n                \n                "); }));
-    }
-    return {
-        name: name,
-        message: message,
-        stack: stack,
-    };
-}
-
 /**
  * Represents the usage with no resources consumed
  *
@@ -4260,27 +4322,20 @@ function getReservedParametersForTask(options) {
  */
 function executeTask(options) {
     return __awaiter(this, void 0, void 0, function () {
-        var currentTask, preparedPipeline, parametersToPass, tools, onProgress, $executionReport, pipelineIdentification, maxExecutionAttempts, maxParallelCount, csvSettings, isVerbose, rootDirname, cacheDirname, intermediateFilesStrategy, isAutoInstalled, isNotPreparedWarningSupressed, name, title, priority, usedParameterNames, dependentParameterNames, definedParameters, _a, _b, _c, definedParameterNames, parameters, _loop_1, _d, _e, parameterName, maxAttempts, jokerParameterNames, preparedContent, resultString;
-        var e_1, _f, _g;
-        return __generator(this, function (_h) {
-            switch (_h.label) {
+        var currentTask, preparedPipeline, parametersToPass, tools, onProgress, $executionReport, pipelineIdentification, maxExecutionAttempts, maxParallelCount, csvSettings, isVerbose, rootDirname, cacheDirname, intermediateFilesStrategy, isAutoInstalled, isNotPreparedWarningSupressed, priority, usedParameterNames, dependentParameterNames, definedParameters, _a, _b, _c, definedParameterNames, parameters, _loop_1, _d, _e, parameterName, maxAttempts, jokerParameterNames, preparedContent, resultString;
+        var _f, e_1, _g, _h, _j;
+        return __generator(this, function (_k) {
+            switch (_k.label) {
                 case 0:
                     currentTask = options.currentTask, preparedPipeline = options.preparedPipeline, parametersToPass = options.parametersToPass, tools = options.tools, onProgress = options.onProgress, $executionReport = options.$executionReport, pipelineIdentification = options.pipelineIdentification, maxExecutionAttempts = options.maxExecutionAttempts, maxParallelCount = options.maxParallelCount, csvSettings = options.csvSettings, isVerbose = options.isVerbose, rootDirname = options.rootDirname, cacheDirname = options.cacheDirname, intermediateFilesStrategy = options.intermediateFilesStrategy, isAutoInstalled = options.isAutoInstalled, isNotPreparedWarningSupressed = options.isNotPreparedWarningSupressed;
-                    name = "pipeline-executor-frame-".concat(currentTask.name);
-                    title = currentTask.title;
                     priority = preparedPipeline.tasks.length - preparedPipeline.tasks.indexOf(currentTask);
                     return [4 /*yield*/, onProgress({
-                            name: name,
-                            title: title,
-                            isStarted: false,
-                            isDone: false,
-                            taskType: currentTask.taskType,
-                            parameterName: currentTask.resultingParameterName,
-                            parameterValue: null,
-                            // <- [🍸]
+                            outputParameters: (_f = {},
+                                _f[currentTask.resultingParameterName] = '',
+                                _f),
                         })];
                 case 1:
-                    _h.sent();
+                    _k.sent();
                     usedParameterNames = extractParameterNamesFromTask(currentTask);
                     dependentParameterNames = new Set(currentTask.dependentParameterNames);
                     // TODO: [👩🏾‍🤝‍👩🏻] Use here `mapAvailableToExpectedParameters`
@@ -4299,7 +4354,7 @@ function executeTask(options) {
                             pipelineIdentification: pipelineIdentification,
                         })];
                 case 2:
-                    definedParameters = _b.apply(_a, [__assign.apply(void 0, [__assign.apply(void 0, _c.concat([(_h.sent())])), parametersToPass])]);
+                    definedParameters = _b.apply(_a, [__assign.apply(void 0, [__assign.apply(void 0, _c.concat([(_k.sent())])), parametersToPass])]);
                     definedParameterNames = new Set(Object.keys(definedParameters));
                     parameters = {};
                     _loop_1 = function (parameterName) {
@@ -4327,7 +4382,7 @@ function executeTask(options) {
                     catch (e_1_1) { e_1 = { error: e_1_1 }; }
                     finally {
                         try {
-                            if (_e && !_e.done && (_f = _d.return)) _f.call(_d);
+                            if (_e && !_e.done && (_g = _d.return)) _g.call(_d);
                         }
                         finally { if (e_1) throw e_1.error; }
                     }
@@ -4358,24 +4413,19 @@ function executeTask(options) {
                             isNotPreparedWarningSupressed: isNotPreparedWarningSupressed,
                         })];
                 case 3:
-                    resultString = _h.sent();
+                    resultString = _k.sent();
                     return [4 /*yield*/, onProgress({
-                            name: name,
-                            title: title,
-                            isStarted: true,
-                            isDone: true,
-                            taskType: currentTask.taskType,
-                            parameterName: currentTask.resultingParameterName,
-                            parameterValue: resultString,
-                            // <- [🍸]
+                            outputParameters: (_h = {},
+                                _h[currentTask.resultingParameterName] = resultString,
+                                _h),
                         })];
                 case 4:
-                    _h.sent();
-                    return [2 /*return*/, Object.freeze((_g = {},
-                            _g[currentTask.resultingParameterName] = 
+                    _k.sent();
+                    return [2 /*return*/, Object.freeze((_j = {},
+                            _j[currentTask.resultingParameterName] = 
                             // <- Note: [👩‍👩‍👧] No need to detect parameter collision here because pipeline checks logic consistency during construction
                             resultString,
-                            _g))];
+                            _j))];
             }
         });
     });
@@ -4383,9 +4433,6 @@ function executeTask(options) {
 /**
  * TODO: [🤹‍♂️]
  */
-/**
- * TODO: [🐚] Change onProgress to object that represents the running execution, can be subscribed via RxJS to and also awaited
- */
 
 /**
  * @@@
@@ -4647,15 +4694,15 @@ function executePipeline(options) {
                                     return [3 /*break*/, 4];
                                 case 3:
                                     unresovedTasks_1 = unresovedTasks_1.filter(function (task) { return task !== currentTask; });
-                                    work_1 = executeTask(__assign(__assign({}, options), { currentTask: currentTask, preparedPipeline: preparedPipeline, parametersToPass: parametersToPass, tools: tools, onProgress: function (progress) {
+                                    work_1 = executeTask(__assign(__assign({}, options), { currentTask: currentTask, preparedPipeline: preparedPipeline, parametersToPass: parametersToPass, tools: tools, onProgress: function (newOngoingResult) {
                                             if (isReturned) {
-                                                throw new UnexpectedError(spaceTrim$1(function (block) { return "\n                                        Can not call `onProgress` after pipeline execution is finished\n\n                                        ".concat(block(pipelineIdentification), "\n\n                                        ").concat(block(JSON.stringify(progress, null, 4)
+                                                throw new UnexpectedError(spaceTrim$1(function (block) { return "\n                                        Can not call `onProgress` after pipeline execution is finished\n\n                                        ".concat(block(pipelineIdentification), "\n\n                                        ").concat(block(JSON.stringify(newOngoingResult, null, 4)
                                                     .split('\n')
                                                     .map(function (line) { return "> ".concat(line); })
                                                     .join('\n')), "\n                                    "); }));
                                             }
                                             if (onProgress) {
-                                                onProgress(progress);
+                                                onProgress(newOngoingResult);
                                             }
                                         }, $executionReport: executionReport, pipelineIdentification: spaceTrim$1(function (block) { return "\n                            ".concat(block(pipelineIdentification), "\n                            Task name: ").concat(currentTask.name, "\n                            Task title: ").concat(currentTask.title, "\n                        "); }) }))
                                         .then(function (newParametersToPass) {
@@ -4758,9 +4805,6 @@ function executePipeline(options) {
         });
     });
 }
-/**
- * TODO: [🐚] Change onProgress to object that represents the running execution, can be subscribed via RxJS to and also awaited
- */
 
 /**
  * Creates executor function from pipeline and execution tools.
@@ -4792,7 +4836,7 @@ function createPipelineExecutor(options) {
         console.warn(spaceTrim$1(function (block) { return "\n                    Pipeline is not prepared\n\n                    ".concat(block(pipelineIdentification), "\n\n                    It will be prepared ad-hoc before the first execution and **returned as `preparedPipeline` in `PipelineExecutorResult`**\n                    But it is recommended to prepare the pipeline during collection preparation\n\n                    @see more at https://ptbk.io/prepare-pipeline\n                "); }));
     }
     var runCount = 0;
-    var pipelineExecutor = function (inputParameters, onProgress) { return __awaiter(_this, void 0, void 0, function () {
+    var pipelineExecutorWithCallback = function (inputParameters, onProgress) { return __awaiter(_this, void 0, void 0, function () {
         return __generator(this, function (_a) {
             runCount++;
             return [2 /*return*/, /* not await */ executePipeline({
@@ -4817,11 +4861,23 @@ function createPipelineExecutor(options) {
                 })];
         });
     }); };
+    var pipelineExecutor = function (inputParameters) {
+        return createTask({
+            taskType: 'EXECUTION',
+            taskProcessCallback: function (updateOngoingResult) {
+                var _this = this;
+                return pipelineExecutorWithCallback(inputParameters, function (newOngoingResult) { return __awaiter(_this, void 0, void 0, function () {
+                    return __generator(this, function (_a) {
+                        updateOngoingResult(newOngoingResult);
+                        return [2 /*return*/];
+                    });
+                }); });
+            },
+        });
+    };
+    //        <- TODO: Make types such as there is no need to do `as` for `createTask`
     return pipelineExecutor;
 }
-/**
- * TODO: [🐚] Change onProgress to object that represents the running execution, can be subscribed via RxJS to and also awaited
- */
 
 /**
  * Async version of Array.forEach
@@ -5026,10 +5082,9 @@ function preparePersona(personaDescription, tools, options) {
                         return modelName;
                     })
                         .join(',');
-                    return [4 /*yield*/, preparePersonaExecutor({ availableModelNames: availableModelNames, personaDescription: personaDescription })];
+                    return [4 /*yield*/, preparePersonaExecutor({ availableModelNames: availableModelNames, personaDescription: personaDescription }).asPromise()];
                 case 3:
                     result = _d.sent();
-                    assertsExecutionSuccessful(result);
                     outputParameters = result.outputParameters;
                     modelRequirementsRaw = outputParameters.modelRequirements;
                     modelRequirements = JSON.parse(modelRequirementsRaw);
@@ -5974,10 +6029,9 @@ function preparePipeline(pipeline, tools, options) {
                                 var content = _a.content;
                                 return content;
                             }).join('\n\n'),
-                        })];
+                        }).asPromise()];
                 case 2:
                     result = _e.sent();
-                    assertsExecutionSuccessful(result);
                     outputParameters = result.outputParameters;
                     titleRaw = outputParameters.title;
                     if (isVerbose) {
@@ -9555,7 +9609,7 @@ function compilePipeline(pipelineString, tools, options) {
  */
 var $isRunningInNode = new Function("\n    try {\n        return this === global;\n    } catch (e) {\n        return false;\n    }\n");
 /**
- * TODO: [☑]
+ * TODO: [🎺]
  */
 
 /**
@@ -10494,7 +10548,7 @@ function $provideScrapersForNode(tools, options) {
  */
 new Function("\n    try {\n        return this === window;\n    } catch (e) {\n        return false;\n    }\n");
 /**
- * TODO: [☑]
+ * TODO: [🎺]
  */
 
 /**
@@ -10506,7 +10560,7 @@ new Function("\n    try {\n        return this === window;\n    } catch (e) {\n
  */
 new Function("\n    try {\n        return process.env.JEST_WORKER_ID !== undefined;\n    } catch (e) {\n        return false;\n    }\n");
 /**
- * TODO: [☑]
+ * TODO: [🎺]
  */
 
 /**
@@ -10518,7 +10572,7 @@ new Function("\n    try {\n        return process.env.JEST_WORKER_ID !== undefin
  */
 new Function("\n    try {\n        if (typeof WorkerGlobalScope !== 'undefined' && self instanceof WorkerGlobalScope) {\n            return true;\n        } else {\n            return false;\n        }\n    } catch (e) {\n        return false;\n    }\n");
 /**
- * TODO: [☑]
+ * TODO: [🎺]
  */
 
 /**