@promptbook/markdown-utils 0.74.0-5 → 0.74.0-7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -52,8 +52,6 @@ Rest of the documentation is common for **entire promptbook ecosystem**:
52
52
 
53
53
  ## 🤍 The Promptbook Whitepaper
54
54
 
55
-
56
-
57
55
  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.
58
56
 
59
57
  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:
@@ -122,23 +120,17 @@ Promptbook project is ecosystem of multiple projects and tools, following is a l
122
120
 
123
121
  ## 💙 Book language _(for prompt-engineer)_
124
122
 
125
- 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.
126
-
127
123
 
128
124
 
129
- ```markdown
130
- # 🌟 My first Book
131
125
 
132
- - INPUT PARAMETER {subject}
133
- - OUTPUT PARAMETER {article}
126
+ ## 💙 The blueprint of book language
134
127
 
135
- ## Sample subject
128
+ Following is the documentation and blueprint of the Book language.
136
129
 
137
- > Promptbook
130
+ ### Example
138
131
 
139
- -> {subject}
140
-
141
- ## Write an article
132
+ ```markdown
133
+ # 🌟 My first Book
142
134
 
143
135
  - PERSONA Jane, marketing specialist with prior experience in writing articles about technology and artificial intelligence
144
136
  - KNOWLEDGE https://ptbk.io
@@ -147,11 +139,65 @@ Promptbook [pipelines](https://github.com/webgptorg/promptbook/discussions/64) a
147
139
  - EXPECT MAX 1 Paragraph
148
140
 
149
141
  > 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.
150
- > Look specifically at the impact of {subject} on the AI industry.
142
+ > Look specifically at the impact of Promptbook on the AI industry.
151
143
 
152
144
  -> {article}
153
145
  ```
154
146
 
147
+ ### Goals and principles of book language
148
+
149
+ 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.
150
+
151
+ It has file with `.ptbk.md` or `.book` extension with `UTF-8` non BOM encoding.
152
+
153
+ 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.
154
+
155
+ But unlike programming languages, it is designed to be understandable by non-programmers and non-technical people.
156
+
157
+ ### Structure
158
+
159
+ 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.
160
+
161
+ ### Header
162
+
163
+ 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.
164
+
165
+ ### Parameter
166
+
167
+ Foo bar
168
+
169
+ #### Parameter names
170
+
171
+ Reserved words:
172
+
173
+ - _each command_ like `PERSONA`, `EXPECT`, `KNOWLEDGE`, etc.
174
+ - `content`
175
+ - `context`
176
+ - `knowledge`
177
+ - `examples`
178
+ - `modelName`
179
+ - `currentDate`
180
+
181
+ #### Parameter notation
182
+
183
+ ### Template
184
+
185
+ Todo todo
186
+
187
+ ### Command
188
+
189
+ Todo todo
190
+
191
+ ### Block
192
+
193
+ Todo todo
194
+
195
+ ### Return parameter
196
+
197
+ ### Examples
198
+
199
+
200
+
155
201
  ## 📦 Packages _(for developers)_
156
202
 
157
203
  This library is divided into several packages, all are published from [single monorepo](https://github.com/webgptorg/promptbook).
package/esm/index.es.js CHANGED
@@ -20,7 +20,7 @@ var BOOK_LANGUAGE_VERSION = '1.0.0';
20
20
  *
21
21
  * @see https://github.com/webgptorg/promptbook
22
22
  */
23
- var PROMPTBOOK_ENGINE_VERSION = '0.74.0-4';
23
+ var PROMPTBOOK_ENGINE_VERSION = '0.74.0-6';
24
24
  /**
25
25
  * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
26
26
  */
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@promptbook/markdown-utils",
3
- "version": "0.74.0-5",
3
+ "version": "0.74.0-7",
4
4
  "description": "Supercharge your use of large language models",
5
5
  "private": false,
6
6
  "sideEffects": false,
package/umd/index.umd.js CHANGED
@@ -22,7 +22,7 @@
22
22
  *
23
23
  * @see https://github.com/webgptorg/promptbook
24
24
  */
25
- var PROMPTBOOK_ENGINE_VERSION = '0.74.0-4';
25
+ var PROMPTBOOK_ENGINE_VERSION = '0.74.0-6';
26
26
  /**
27
27
  * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
28
28
  */