@promptbook/cli 0.82.0 → 0.83.0

package/umd/index.umd.js

@@ -51,7 +51,7 @@
      * @generated
      * @see https://github.com/webgptorg/promptbook
      */
-    var PROMPTBOOK_ENGINE_VERSION = '0.82.0-3';
+    var PROMPTBOOK_ENGINE_VERSION = '0.82.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
@@ -6402,15 +6402,15 @@
     /**
      * Creates unique name for the source
      *
-     * @private within the repository
+     * @public exported from `@promptbook/editable`
      */
-    function sourceContentToName(sourceContent) {
-        var hash = cryptoJs.SHA256(hexEncoder__default["default"].parse(JSON.stringify(sourceContent)))
+    function knowledgeSourceContentToName(knowledgeSourceContent) {
+        var hash = cryptoJs.SHA256(hexEncoder__default["default"].parse(JSON.stringify(knowledgeSourceContent)))
             //    <- TODO: [🥬] Encapsulate sha256 to some private utility function
             .toString( /* hex */)
             .substring(0, 20);
         //    <- TODO: [🥬] Make some system for hashes and ids of promptbook
-        var semanticName = normalizeToKebabCase(sourceContent.substring(0, 20));
+        var semanticName = normalizeToKebabCase(knowledgeSourceContent.substring(0, 20));
         var pieces = ['source', semanticName, hash].filter(function (piece) { return piece !== ''; });
         var name = pieces.join('-').split('--').join('-');
         // <- TODO: Use MAX_FILENAME_LENGTH
@@ -6474,19 +6474,19 @@
     function makeKnowledgeSourceHandler(knowledgeSource, tools, options) {
         var _a;
         return __awaiter(this, void 0, void 0, function () {
-            var _b, fetch, sourceContent, name, _c, _d, rootDirname, url, response_1, mimeType, filename_1, fileExtension, mimeType;
+            var _b, fetch, knowledgeSourceContent, name, _c, _d, rootDirname, url, response_1, mimeType, filename_1, fileExtension, mimeType;
             return __generator(this, function (_f) {
                 switch (_f.label) {
                     case 0:
                         _b = tools.fetch, fetch = _b === void 0 ? scraperFetch : _b;
-                        sourceContent = knowledgeSource.sourceContent;
+                        knowledgeSourceContent = knowledgeSource.knowledgeSourceContent;
                         name = knowledgeSource.name;
                         _c = options || {}, _d = _c.rootDirname, rootDirname = _d === void 0 ? null : _d, _c.isVerbose;
                         if (!name) {
-                            name = sourceContentToName(sourceContent);
+                            name = knowledgeSourceContentToName(knowledgeSourceContent);
                         }
-                        if (!isValidUrl(sourceContent)) return [3 /*break*/, 2];
-                        url = sourceContent;
+                        if (!isValidUrl(knowledgeSourceContent)) return [3 /*break*/, 2];
+                        url = knowledgeSourceContent;
                         return [4 /*yield*/, fetch(url)];
                     case 1:
                         response_1 = _f.sent();
@@ -6532,7 +6532,7 @@
                                 },
                             }];
                     case 2:
-                        if (!isValidFilePath(sourceContent)) return [3 /*break*/, 4];
+                        if (!isValidFilePath(knowledgeSourceContent)) return [3 /*break*/, 4];
                         if (tools.fs === undefined) {
                             throw new EnvironmentMismatchError('Can not import file knowledge without filesystem tools');
                             //          <- TODO: [🧠] What is the best error type here`
@@ -6541,13 +6541,13 @@
                             throw new EnvironmentMismatchError('Can not import file knowledge in non-file pipeline');
                             //          <- TODO: [🧠] What is the best error type here`
                         }
-                        filename_1 = path.join(rootDirname, sourceContent).split('\\').join('/');
+                        filename_1 = path.join(rootDirname, knowledgeSourceContent).split('\\').join('/');
                         fileExtension = getFileExtension(filename_1);
                         mimeType = extensionToMimeType(fileExtension || '');
                         return [4 /*yield*/, isFileExisting(filename_1, tools.fs)];
                     case 3:
                         if (!(_f.sent())) {
-                            throw new NotFoundError(spaceTrim__default["default"](function (block) { return "\n                          Can not make source handler for file which does not exist:\n\n                          File:\n                          ".concat(block(sourceContent), "\n\n                          Full file path:\n                          ").concat(block(filename_1), "\n                      "); }));
+                            throw new NotFoundError(spaceTrim__default["default"](function (block) { return "\n                          Can not make source handler for file which does not exist:\n\n                          File:\n                          ".concat(block(knowledgeSourceContent), "\n\n                          Full file path:\n                          ").concat(block(filename_1), "\n                      "); }));
                         }
                         // TODO: [🧠][😿] Test security file - file is scoped to the project (BUT maybe do this in `filesystemTools`)
                         return [2 /*return*/, {
@@ -6598,7 +6598,7 @@
                             url: null,
                             mimeType: 'text/markdown',
                             asText: function () {
-                                return knowledgeSource.sourceContent;
+                                return knowledgeSource.knowledgeSourceContent;
                             },
                             asJson: function () {
                                 throw new UnexpectedError('Did not expect that `markdownScraper` would need to get the content `asJson`');
@@ -6660,7 +6660,7 @@
                                                                 partialPieces = __spreadArray([], __read(partialPiecesUnchecked), false);
                                                                 return [2 /*return*/, "break"];
                                                             }
-                                                            console.warn(spaceTrim__default["default"](function (block) { return "\n                        Cannot scrape knowledge from source despite the scraper `".concat(scraper.metadata.className, "` supports the mime type \"").concat(sourceHandler.mimeType, "\".\n\n                        The source:\n                        ").concat(block(knowledgeSource.sourceContent
+                                                            console.warn(spaceTrim__default["default"](function (block) { return "\n                        Cannot scrape knowledge from source despite the scraper `".concat(scraper.metadata.className, "` supports the mime type \"").concat(sourceHandler.mimeType, "\".\n\n                        The source:\n                        ").concat(block(knowledgeSource.knowledgeSourceContent
                                                                 .split('\n')
                                                                 .map(function (line) { return "> ".concat(line); })
                                                                 .join('\n')), "\n\n                        ").concat(block($registeredScrapersMessage(scrapers)), "\n\n\n                    "); }));
@@ -6698,7 +6698,7 @@
                                             return [7 /*endfinally*/];
                                         case 9:
                                             if (partialPieces === null) {
-                                                throw new KnowledgeScrapeError(spaceTrim__default["default"](function (block) { return "\n                        Cannot scrape knowledge\n\n                        The source:\n                        > ".concat(block(knowledgeSource.sourceContent
+                                                throw new KnowledgeScrapeError(spaceTrim__default["default"](function (block) { return "\n                        Cannot scrape knowledge\n\n                        The source:\n                        > ".concat(block(knowledgeSource.knowledgeSourceContent
                                                     .split('\n')
                                                     .map(function (line) { return "> ".concat(line); })
                                                     .join('\n')), "\n\n                        No scraper found for the mime type \"").concat(sourceHandler.mimeType, "\"\n\n                        ").concat(block($registeredScrapersMessage(scrapers)), "\n\n\n                    "); }));
@@ -6969,7 +6969,7 @@
      * Parses the knowledge command
      *
      * @see `documentationUrl` for more details
-     * @private within the commands folder
+     * @public exported from `@promptbook/editable`
      */
     var knowledgeCommandParser = {
         /**
@@ -7005,23 +7005,25 @@
          */
         parse: function (input) {
             var args = input.args;
-            var sourceContent = spaceTrim__default["default"](args[0] || '');
-            if (sourceContent === '') {
+            var knowledgeSourceContent = spaceTrim__default["default"](args[0] || '');
+            if (knowledgeSourceContent === '') {
                 throw new ParseError("Source is not defined");
             }
             // TODO: [main] !!4 Following checks should be applied every link in the `sourceContent`
-            if (sourceContent.startsWith('http://')) {
+            if (knowledgeSourceContent.startsWith('http://')) {
                 throw new ParseError("Source is not secure");
             }
-            if (!(isValidFilePath(sourceContent) || isValidUrl(sourceContent))) {
+            if (!(isValidFilePath(knowledgeSourceContent) || isValidUrl(knowledgeSourceContent))) {
                 throw new ParseError("Source not valid");
             }
-            if (sourceContent.startsWith('../') || sourceContent.startsWith('/') || /^[A-Z]:[\\/]+/i.test(sourceContent)) {
+            if (knowledgeSourceContent.startsWith('../') ||
+                knowledgeSourceContent.startsWith('/') ||
+                /^[A-Z]:[\\/]+/i.test(knowledgeSourceContent)) {
                 throw new ParseError("Source cannot be outside of the .book.md folder");
             }
             return {
                 type: 'KNOWLEDGE',
-                sourceContent: sourceContent,
+                knowledgeSourceContent: knowledgeSourceContent,
             };
         },
         /**
@@ -7030,10 +7032,10 @@
          * Note: `$` is used to indicate that this function mutates given `pipelineJson`
          */
         $applyToPipelineJson: function (command, $pipelineJson) {
-            var sourceContent = command.sourceContent;
+            var knowledgeSourceContent = command.knowledgeSourceContent;
             $pipelineJson.knowledgeSources.push({
-                name: sourceContentToName(sourceContent),
-                sourceContent: sourceContent,
+                name: knowledgeSourceContentToName(knowledgeSourceContent),
+                knowledgeSourceContent: knowledgeSourceContent,
             });
         },
         /**
@@ -7061,7 +7063,7 @@
      * Parses the section command
      *
      * @see `documentationUrl` for more details
-     * @private within the commands folder
+     * @public exported from `@promptbook/editable`
      */
     var sectionCommandParser = {
         /**
@@ -7192,7 +7194,7 @@
             if (command.taskType === 'KNOWLEDGE') {
                 knowledgeCommandParser.$applyToPipelineJson({
                     type: 'KNOWLEDGE',
-                    sourceContent: $taskJson.content, // <- TODO: [🐝][main] !!3 Work with KNOWLEDGE which not referring to the source file or website, but its content itself
+                    knowledgeSourceContent: $taskJson.content, // <- TODO: [🐝][main] !!3 Work with KNOWLEDGE which not referring to the source file or website, but its content itself
                 }, $pipelineJson);
                 $taskJson.isTask = false;
                 return;
@@ -7337,7 +7339,7 @@
      * Parses the BOOK_VERSION command
      *
      * @see `documentationUrl` for more details
-     * @private within the commands folder
+     * @public exported from `@promptbook/editable`
      */
     var bookVersionCommandParser = {
         /**
@@ -7492,7 +7494,7 @@
      * Parses the expect command
      *
      * @see `documentationUrl` for more details
-     * @private within the commands folder
+     * @public exported from `@promptbook/editable`
      */
     var expectCommandParser = {
         /**
@@ -7808,7 +7810,7 @@
      * Note: @@@ This command is used as foreach for new commands - it should NOT be used in any `.book.md` file
      *
      * @see `documentationUrl` for more details
-     * @private within the commands folder
+     * @public exported from `@promptbook/editable`
      */
     var foreachCommandParser = {
         /**
@@ -7962,7 +7964,7 @@
      * Parses the format command
      *
      * @see `documentationUrl` for more details
-     * @private within the commands folder
+     * @public exported from `@promptbook/editable`
      */
     var formatCommandParser = {
         /**
@@ -8259,7 +8261,7 @@
      * Note: @@@ This command is used as formfactor for new commands - it should NOT be used in any `.book.md` file
      *
      * @see `documentationUrl` for more details
-     * @private within the commands folder
+     * @public exported from `@promptbook/editable`
      */
     var formfactorCommandParser = {
         /**
@@ -8348,7 +8350,7 @@
      * Parses the joker command
      *
      * @see `documentationUrl` for more details
-     * @private within the commands folder
+     * @public exported from `@promptbook/editable`
      */
     var jokerCommandParser = {
         /**
@@ -8425,7 +8427,8 @@
      * Parses the model command
      *
      * @see `documentationUrl` for more details
-     * @private within the commands folder
+     * @deprecated Option to manually set the model requirements is not recommended to use, use `PERSONA` instead
+     * @public exported from `@promptbook/editable`
      */
     var modelCommandParser = {
         /**
@@ -8569,7 +8572,7 @@
      * Parses the parameter command
      *
      * @see `documentationUrl` for more details
-     * @private within the commands folder
+     * @public exported from `@promptbook/editable`
      */
     var parameterCommandParser = {
         /**
@@ -8674,7 +8677,7 @@
      * Parses the persona command
      *
      * @see `documentationUrl` for more details
-     * @private within the commands folder
+     * @public exported from `@promptbook/editable`
      */
     var personaCommandParser = {
         /**
@@ -8809,7 +8812,7 @@
      * Parses the postprocess command
      *
      * @see `documentationUrl` for more details
-     * @private within the commands folder
+     * @public exported from `@promptbook/editable`
      */
     var postprocessCommandParser = {
         /**
@@ -8887,7 +8890,7 @@
      * Parses the url command
      *
      * @see `documentationUrl` for more details
-     * @private within the commands folder
+     * @public exported from `@promptbook/editable`
      */
     var urlCommandParser = {
         /**
@@ -8988,7 +8991,7 @@
      * Parses the action command
      *
      * @see `documentationUrl` for more details
-     * @private within the commands folder
+     * @public exported from `@promptbook/editable`
      */
     var actionCommandParser = {
         /**
@@ -9054,7 +9057,7 @@
      * Parses the instrument command
      *
      * @see `documentationUrl` for more details
-     * @private within the commands folder
+     * @public exported from `@promptbook/editable`
      */
     var instrumentCommandParser = {
         /**
@@ -9119,7 +9122,7 @@
     /**
      * All available command parsers
      *
-     * @private internal index of `parseCommand`
+     * @public exported from `@promptbook/editable`
      */
     var COMMANDS = [
         sectionCommandParser,
@@ -9150,7 +9153,7 @@
      * @returns the parser for the command
      * @throws {UnexpectedError} if the parser is not found
      *
-     * @private within the compilePipeline
+     * @public exported from `@promptbook/editable`
      */
     function getParserForCommand(command) {
         var commandParser = COMMANDS.find(function (commandParser) { return commandParser.name === command.type; });
@@ -9186,7 +9189,7 @@
      * @returns parsed command object
      * @throws {ParseError} if the command is invalid
      *
-     * @private within the compilePipeline
+     * @public exported from `@promptbook/editable`
      */
     function parseCommand(raw, usagePlace) {
         if (raw.includes('\n') || raw.includes('\r')) {