@promptbook/node 0.74.0-5 → 0.74.0-7

package/README.md

@@ -56,8 +56,6 @@ Rest of the documentation is common for **entire promptbook ecosystem**:
 
 ## 🤍 The Promptbook Whitepaper
 
-
-
 If you have a simple, single prompt for ChatGPT, GPT-4, Anthropic Claude, Google Gemini, Llama 3, or whatever, it doesn't matter how you integrate it. Whether it's calling a REST API directly, using the SDK, hardcoding the prompt into the source code, or importing a text file, the process remains the same.
 
 But often you will struggle with the **limitations of LLMs**, such as **hallucinations, off-topic responses, poor quality output, language and prompt drift, word repetition repetition repetition repetition or misuse, lack of context, or just plain w𝒆𝐢rd resp0nses**. When this happens, you generally have three options:
@@ -126,23 +124,17 @@ Promptbook project is ecosystem of multiple projects and tools, following is a l
 
 ## 💙 Book language _(for prompt-engineer)_
 
-Promptbook [pipelines](https://github.com/webgptorg/promptbook/discussions/64) are written in markdown-like language called [Book](https://github.com/webgptorg/book). It is designed to be understandable by non-programmers and non-technical people.
-
 
 
-```markdown
-# 🌟 My first Book
 
--   INPUT PARAMETER {subject}
--   OUTPUT PARAMETER {article}
+## 💙 The blueprint of book language
 
-## Sample subject
+Following is the documentation and blueprint of the Book language.
 
-> Promptbook
+### Example
 
--> {subject}
-
-## Write an article
+```markdown
+# 🌟 My first Book
 
 -   PERSONA Jane, marketing specialist with prior experience in writing articles about technology and artificial intelligence
 -   KNOWLEDGE https://ptbk.io
@@ -151,11 +143,65 @@ Promptbook [pipelines](https://github.com/webgptorg/promptbook/discussions/64) a
 -   EXPECT MAX 1 Paragraph
 
 > Write an article about the future of artificial intelligence in the next 10 years and how metalanguages will change the way AI is used in the world.
-> Look specifically at the impact of {subject} on the AI industry.
+> Look specifically at the impact of Promptbook on the AI industry.
 
 -> {article}
 ```
 
+### Goals and principles of book language
+
+File is designed to be easy to read and write. It is strict subset of markdown. It is designed to be understandable by both humans and machines and without specific knowledge of the language.
+
+It has file with `.ptbk.md` or `.book` extension with `UTF-8` non BOM encoding.
+
+As it is source code, it can leverage all the features of version control systems like git and does not suffer from the problems of binary formats, proprietary formats, or no-code solutions.
+
+But unlike programming languages, it is designed to be understandable by non-programmers and non-technical people.
+
+### Structure
+
+Book is divided into sections. Each section starts with heading. The language itself is not sensitive to the type of heading _(`h1`, `h2`, `h3`, ...)_ but it is recommended to use `h1` for header section and `h2` for other sections.
+
+### Header
+
+Header is the first section of the book. It contains metadata about the pipeline. It is recommended to use `h1` heading for header section but it is not required.
+
+### Parameter
+
+Foo bar
+
+#### Parameter names
+
+Reserved words:
+
+-   _each command_ like `PERSONA`, `EXPECT`, `KNOWLEDGE`, etc.
+-   `content`
+-   `context`
+-   `knowledge`
+-   `examples`
+-   `modelName`
+-   `currentDate`
+
+#### Parameter notation
+
+### Template
+
+Todo todo
+
+### Command
+
+Todo todo
+
+### Block
+
+Todo todo
+
+### Return parameter
+
+### Examples
+
+
+
 ## 📦 Packages _(for developers)_
 
 This library is divided into several packages, all are published from [single monorepo](https://github.com/webgptorg/promptbook).

package/esm/index.es.js

@@ -26,7 +26,7 @@ var BOOK_LANGUAGE_VERSION = '1.0.0';
  *
  * @see https://github.com/webgptorg/promptbook
  */
-var PROMPTBOOK_ENGINE_VERSION = '0.74.0-4';
+var PROMPTBOOK_ENGINE_VERSION = '0.74.0-6';
 /**
  * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
  */
@@ -7758,11 +7758,18 @@ function pipelineStringToJsonSync(pipelineString) {
     }
     // =============================================================
     // Note: 1️⃣ Parsing of the markdown into object
+    if (pipelineString.startsWith('#!')) {
+        var _c = __read(pipelineString.split('\n')), shebangLine_1 = _c[0], restLines = _c.slice(1);
+        if (!(shebangLine_1 || '').includes('ptbk')) {
+            throw new ParseError(spaceTrim(function (block) { return "\n                        It seems that you try to parse a book file which has non-standard shebang line for book files:\n                        Shebang line must contain 'ptbk'\n\n                        You have:\n                        ".concat(block(shebangLine_1 || '(empty line)'), "\n\n                        It should look like this:\n                        #!/usr/bin/env ptbk\n\n                        ").concat(block(getPipelineIdentification()), "\n                    "); }));
+        }
+        pipelineString = restLines.join('\n');
+    }
     pipelineString = removeContentComments(pipelineString);
     pipelineString = flattenMarkdown(pipelineString) /* <- Note: [🥞] */;
     pipelineString = pipelineString.replaceAll(/`\{(?<parameterName>[a-z0-9_]+)\}`/gi, '{$<parameterName>}');
     pipelineString = pipelineString.replaceAll(/`->\s+\{(?<parameterName>[a-z0-9_]+)\}`/gi, '-> {$<parameterName>}');
-    var _c = __read(splitMarkdownIntoSections(pipelineString).map(parseMarkdownSection)), pipelineHead = _c[0], pipelineSections = _c.slice(1); /* <- Note: [🥞] */
+    var _d = __read(splitMarkdownIntoSections(pipelineString).map(parseMarkdownSection)), pipelineHead = _d[0], pipelineSections = _d.slice(1); /* <- Note: [🥞] */
     if (pipelineHead === undefined) {
         throw new UnexpectedError(spaceTrim(function (block) { return "\n                    Pipeline head is not defined\n\n                    ".concat(block(getPipelineIdentification()), "\n\n                    This should never happen, because the pipeline already flattened\n                "); }));
     }
@@ -7852,10 +7859,10 @@ function pipelineStringToJsonSync(pipelineString) {
         finally { if (e_1) throw e_1.error; }
     }
     var _loop_2 = function (section) {
-        var e_3, _d;
+        var e_3, _e;
         // TODO: Parse template description (the content out of the codeblock and lists)
         var listItems_2 = extractAllListItemsFromMarkdown(section.content);
-        var _e = extractOneBlockFromMarkdown(section.content), language = _e.language, content = _e.content;
+        var _f = extractOneBlockFromMarkdown(section.content), language = _f.language, content = _f.content;
         // TODO: [🎾][1] DRY description
         var description_1 = section.content;
         // Note: Remove codeblocks - TODO: [🎾]
@@ -7920,14 +7927,14 @@ function pipelineStringToJsonSync(pipelineString) {
         try {
             // TODO [♓️] List commands and before apply order them to achieve order-agnostic commands
             for (var commands_1 = (e_3 = void 0, __values(commands)), commands_1_1 = commands_1.next(); !commands_1_1.done; commands_1_1 = commands_1.next()) {
-                var _f = commands_1_1.value, listItem = _f.listItem, command = _f.command;
+                var _g = commands_1_1.value, listItem = _g.listItem, command = _g.command;
                 _loop_3(listItem, command);
             }
         }
         catch (e_3_1) { e_3 = { error: e_3_1 }; }
         finally {
             try {
-                if (commands_1_1 && !commands_1_1.done && (_d = commands_1.return)) _d.call(commands_1);
+                if (commands_1_1 && !commands_1_1.done && (_e = commands_1.return)) _e.call(commands_1);
             }
             finally { if (e_3) throw e_3.error; }
         }
@@ -9797,12 +9804,9 @@ function $execCommandNormalizeOptions(options) {
     })
         .filter(function (arg) { return arg !== ''; });
     if (_.length > 1) {
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
         _a = __read(_), command = _a[0], args = _a.slice(1);
     }
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
     if (options.args) {
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
         args = __spreadArray(__spreadArray([], __read(args), false), __read(options.args), false);
     }
     var humanReadableCommand = !['npx', 'npm'].includes(command) ? command : args[0];