@promptbook/types 0.74.0-5 → 0.74.0-6

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.
Files changed (2) hide show
  1. package/README.md +60 -14
  2. package/package.json +2 -2
package/README.md CHANGED
@@ -77,8 +77,6 @@ Rest of the documentation is common for **entire promptbook ecosystem**:
77
77
 
78
78
  ## 🤍 The Promptbook Whitepaper
79
79
 
80
-
81
-
82
80
  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.
83
81
 
84
82
  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:
@@ -147,23 +145,17 @@ Promptbook project is ecosystem of multiple projects and tools, following is a l
147
145
 
148
146
  ## 💙 Book language _(for prompt-engineer)_
149
147
 
150
- 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.
151
-
152
148
 
153
149
 
154
- ```markdown
155
- # 🌟 My first Book
156
150
 
157
- - INPUT PARAMETER {subject}
158
- - OUTPUT PARAMETER {article}
151
+ ## 💙 The blueprint of book language
159
152
 
160
- ## Sample subject
153
+ Following is the documentation and blueprint of the Book language.
161
154
 
162
- > Promptbook
155
+ ### Example
163
156
 
164
- -> {subject}
165
-
166
- ## Write an article
157
+ ```markdown
158
+ # 🌟 My first Book
167
159
 
168
160
  - PERSONA Jane, marketing specialist with prior experience in writing articles about technology and artificial intelligence
169
161
  - KNOWLEDGE https://ptbk.io
@@ -172,11 +164,65 @@ Promptbook [pipelines](https://github.com/webgptorg/promptbook/discussions/64) a
172
164
  - EXPECT MAX 1 Paragraph
173
165
 
174
166
  > 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.
175
- > Look specifically at the impact of {subject} on the AI industry.
167
+ > Look specifically at the impact of Promptbook on the AI industry.
176
168
 
177
169
  -> {article}
178
170
  ```
179
171
 
172
+ ### Goals and principles of book language
173
+
174
+ 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.
175
+
176
+ It has file with `.ptbk.md` or `.book` extension with `UTF-8` non BOM encoding.
177
+
178
+ 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.
179
+
180
+ But unlike programming languages, it is designed to be understandable by non-programmers and non-technical people.
181
+
182
+ ### Structure
183
+
184
+ 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.
185
+
186
+ ### Header
187
+
188
+ 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.
189
+
190
+ ### Parameter
191
+
192
+ Foo bar
193
+
194
+ #### Parameter names
195
+
196
+ Reserved words:
197
+
198
+ - _each command_ like `PERSONA`, `EXPECT`, `KNOWLEDGE`, etc.
199
+ - `content`
200
+ - `context`
201
+ - `knowledge`
202
+ - `examples`
203
+ - `modelName`
204
+ - `currentDate`
205
+
206
+ #### Parameter notation
207
+
208
+ ### Template
209
+
210
+ Todo todo
211
+
212
+ ### Command
213
+
214
+ Todo todo
215
+
216
+ ### Block
217
+
218
+ Todo todo
219
+
220
+ ### Return parameter
221
+
222
+ ### Examples
223
+
224
+
225
+
180
226
  ## 📦 Packages _(for developers)_
181
227
 
182
228
  This library is divided into several packages, all are published from [single monorepo](https://github.com/webgptorg/promptbook).
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@promptbook/types",
3
- "version": "0.74.0-5",
3
+ "version": "0.74.0-6",
4
4
  "description": "Supercharge your use of large language models",
5
5
  "private": false,
6
6
  "sideEffects": false,
@@ -51,6 +51,6 @@
51
51
  ],
52
52
  "typings": "./esm/typings/src/_packages/types.index.d.ts",
53
53
  "peerDependencies": {
54
- "@promptbook/core": "0.74.0-5"
54
+ "@promptbook/core": "0.74.0-6"
55
55
  }
56
56
  }