ptbk 0.86.0-8 → 0.86.5

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 +48 -54
  2. package/package.json +3 -3
package/README.md CHANGED
@@ -5,8 +5,8 @@
5
5
 
6
6
 
7
7
 
8
- [![NPM Version of ![Promptbook logo - cube with letters P and B](./other/design/logo-h1.png) Promptbook](https://badge.fury.io/js/promptbook.svg)](https://www.npmjs.com/package/promptbook)
9
- [![Quality of package ![Promptbook logo - cube with letters P and B](./other/design/logo-h1.png) Promptbook](https://packagequality.com/shield/promptbook.svg)](https://packagequality.com/#?package=promptbook)
8
+ [![NPM Version of ![Promptbook logo - cube with letters P and B](./design/logo-h1.png) Promptbook](https://badge.fury.io/js/promptbook.svg)](https://www.npmjs.com/package/promptbook)
9
+ [![Quality of package ![Promptbook logo - cube with letters P and B](./design/logo-h1.png) Promptbook](https://packagequality.com/shield/promptbook.svg)](https://packagequality.com/#?package=promptbook)
10
10
  [![Known Vulnerabilities](https://snyk.io/test/github/webgptorg/promptbook/badge.svg)](https://snyk.io/test/github/webgptorg/promptbook)
11
11
  [![Issues](https://img.shields.io/github/issues/webgptorg/promptbook.svg?style=flat)](https://github.com/webgptorg/promptbook/issues)
12
12
 
@@ -17,11 +17,9 @@
17
17
  ## 🌟 New Features
18
18
 
19
19
  - 📂 We have plugin for [VSCode](https://github.com/webgptorg/book-extension) to support `.book` file extension
20
+ - 🐳 Available [Docker image](https://hub.docker.com/r/hejny/promptbook/)
20
21
  - 💫 Support of [`o3-mini` model by OpenAI](https://openai.com/index/openai-o3-mini/)
21
22
  - 🐋 **Support of [DeepSeek models](https://www.npmjs.com/package/@promptbook/deepseek)**
22
- - 💙 Working [the **Book** language v1.0.0](https://github.com/webgptorg/book)
23
- - 🖤 Run books from CLI - `npx ptbk run path/to/your/book`
24
- - 📚 Support of `.docx`, `.doc` and `.pdf` documents as knowledge
25
23
 
26
24
 
27
25
 
@@ -36,6 +34,8 @@
36
34
 
37
35
  During the computer revolution, we have seen [multiple generations of computer languages](https://github.com/webgptorg/promptbook/discussions/180), from the physical rewiring of the vacuum tubes through low-level machine code to the high-level languages like Python or JavaScript. And now, we're on the edge of the **next revolution**!
38
36
 
37
+
38
+
39
39
  It's a revolution of writing software in **plain human language** that is understandable and executable by both humans and machines – and it's going to change everything!
40
40
 
41
41
  The incredible growth in power of microprocessors and the Moore's Law have been the driving force behind the ever-more powerful languages, and it's been an amazing journey! Similarly, the large language models (like GPT or Claude) are the next big thing in language technology, and they're set to transform the way we interact with computers.
@@ -93,34 +93,41 @@ We also have a community of developers and users of **Promptbook**:
93
93
  - [Landing page `ptbk.io`](https://ptbk.io)
94
94
  - [Github discussions](https://github.com/webgptorg/promptbook/discussions)
95
95
  - [LinkedIn `Promptbook`](https://linkedin.com/company/promptbook)
96
- - [Facebook `Promptbook`](https://www.facebook.com/61560776453536)
96
+ - [Facebook `Promptbook`](https://www.facebook.com/61560776453536)
97
97
 
98
98
  And **Promptbook.studio** branded socials:
99
99
 
100
+
101
+
100
102
  - [Instagram `@promptbook.studio`](https://www.instagram.com/promptbook.studio/)
101
103
 
104
+
105
+
102
106
  And **Promptujeme** sub-brand:
103
107
 
104
- _/Subbrand for Czech clients/_
108
+ */Subbrand for Czech clients/*
109
+
110
+
105
111
 
106
112
  - [Promptujeme.cz](https://www.promptujeme.cz/)
107
113
  - [Facebook `Promptujeme`](https://www.facebook.com/promptujeme/)
108
114
 
115
+
109
116
  And **Promptbook.city** branded socials:
110
117
 
111
- _/Sub-brand for images and graphics generated via Promptbook prompting/_
118
+ */Sub-brand for images and graphics generated via Promptbook prompting/*
112
119
 
113
120
  - [Instagram `@promptbook.city`](https://www.instagram.com/promptbook.city/)
114
- - [Facebook `Promptbook City`](https://www.facebook.com/61565718625569)
121
+ - [Facebook `Promptbook City`](https://www.facebook.com/61565718625569)
122
+
115
123
 
116
124
 
117
125
 
118
- ## 💙 Book language _(for prompt-engineer)_
119
126
 
120
127
 
128
+ ## 💙 The Book language
121
129
 
122
130
 
123
- ## 💙 The blueprint of book language
124
131
 
125
132
  Following is the documentation and blueprint of the Book language.
126
133
 
@@ -129,6 +136,11 @@ Following is the documentation and blueprint of the Book language.
129
136
  ```markdown
130
137
  # 🌟 My first Book
131
138
 
139
+ - BOOK VERSION 1.0.0
140
+ - URL https://promptbook.studio/my-first-book/
141
+
142
+ # Write an article
143
+
132
144
  - PERSONA Jane, marketing specialist with prior experience in writing articles about technology and artificial intelligence
133
145
  - KNOWLEDGE https://ptbk.io
134
146
  - KNOWLEDGE ./promptbook.pdf
@@ -141,59 +153,31 @@ Following is the documentation and blueprint of the Book language.
141
153
  -> {article}
142
154
  ```
143
155
 
144
- ### Goals and principles of book language
145
-
146
- 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.
147
-
148
- It has file with `.book.md` or `.book` extension with `UTF-8` non BOM encoding.
149
-
150
- 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.
151
-
152
- But unlike programming languages, it is designed to be understandable by non-programmers and non-technical people.
153
-
154
- ### Structure
156
+ ### **What:** Workflows, Tasks and Parameters
155
157
 
156
- 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.
158
+ - [PARAMETER](https://github.com/webgptorg/promptbook/blob/main/documents/commands/PARAMETER.md)
157
159
 
158
- ### Header
160
+ ### **Who:** Personas
159
161
 
160
- 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.
162
+ - [PERSONA](https://github.com/webgptorg/promptbook/blob/main/documents/commands/PERSONA.md)
161
163
 
162
- ### Parameter
164
+ ### **How:** Knowledge, Instruments and Actions
163
165
 
164
- Foo bar
166
+ - [KNOWLEDGE](https://github.com/webgptorg/promptbook/blob/main/documents/commands/KNOWLEDGE.md)
167
+ - [INSTRUMENT](https://github.com/webgptorg/promptbook/blob/main/documents/commands/INSTRUMENT.md)
168
+ - [ACTION](https://github.com/webgptorg/promptbook/blob/main/documents/commands/ACTION.md)
165
169
 
166
- #### Parameter names
170
+ ### General principles of book language
167
171
 
168
- Reserved words:
172
+ Book language is based on markdown. It is subset of markdown. It is designed to be easy to read and write. It is designed to be understandable by both humans and machines and without specific knowledge of the language.
169
173
 
170
- - _each command_ like `PERSONA`, `EXPECT`, `KNOWLEDGE`, etc.
171
- - `content`
172
- - `context`
173
- - `knowledge`
174
- - `examples`
175
- - `modelName`
176
- - `currentDate`
174
+ The file has `.book` extension. It uses `UTF-8` non BOM encoding.
177
175
 
178
- #### Parameter notation
176
+ Book has two variants: flat - which is just a prompt with no structure, and full - which has a structure with tasks, commands and prompts.
179
177
 
180
- ### Task
181
-
182
- ### Task type
183
-
184
- Todo todo
185
-
186
- ### Command
187
-
188
- Todo todo
189
-
190
- ### Block
191
-
192
- Todo todo
193
-
194
- ### Return parameter
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.
195
179
 
196
- ### Examples
180
+ But unlike programming languages, it is designed to be understandable by non-programmers and non-technical people.
197
181
 
198
182
 
199
183
 
@@ -239,6 +223,7 @@ Or you can install them separately:
239
223
  - **[@promptbook/templates](https://www.npmjs.com/package/@promptbook/templates)** - Usefull templates and examples of books which can be used as a starting point
240
224
  - **[@promptbook/types](https://www.npmjs.com/package/@promptbook/types)** - Just typescript types used in the library
241
225
  - ⭐ **[@promptbook/cli](https://www.npmjs.com/package/@promptbook/cli)** - Command line interface utilities for promptbooks
226
+ - 🐋 **[Docker image](https://hub.docker.com/r/hejny/promptbook/)** - Promptbook server
242
227
 
243
228
 
244
229
 
@@ -247,6 +232,11 @@ Or you can install them separately:
247
232
 
248
233
  ## 📚 Dictionary
249
234
 
235
+
236
+
237
+
238
+
239
+
250
240
  ### 📚 Dictionary
251
241
 
252
242
  The following glossary is used to clarify certain concepts:
@@ -262,6 +252,8 @@ The following glossary is used to clarify certain concepts:
262
252
  - **Retrieval-augmented generation** is a machine learning paradigm where a model generates text by retrieving relevant information from a large database of text. This approach combines the benefits of generative models and retrieval models.
263
253
  - **Longtail** refers to non-common or rare events, items, or entities that are not well-represented in the training data of machine learning models. Longtail items are often challenging for models to predict accurately.
264
254
 
255
+
256
+
265
257
  _Note: Thos section is not complete dictionary, more list of general AI / LLM terms that has connection with Promptbook_
266
258
 
267
259
  #### Promptbook core
@@ -322,6 +314,8 @@ _Note: Thos section is not complete dictionary, more list of general AI / LLM te
322
314
  - [👮 Agent adversary expectations](https://github.com/webgptorg/promptbook/discussions/39)
323
315
  - [view more](https://github.com/webgptorg/promptbook/discussions/categories/concepts)
324
316
 
317
+
318
+
325
319
  ### Terms specific to Promptbook TypeScript implementation
326
320
 
327
321
  - Anonymous mode
@@ -401,7 +395,7 @@ See [TODO.md](./TODO.md)
401
395
  <div style="display: flex; align-items: center; gap: 20px;">
402
396
 
403
397
  <a href="https://promptbook.studio/">
404
- <img src="./other/design/promptbook-studio-logo.png" alt="Partner 3" height="100">
398
+ <img src="./design/promptbook-studio-logo.png" alt="Partner 3" height="100">
405
399
  </a>
406
400
 
407
401
  <a href="https://technologickainkubace.org/en/about-technology-incubation/about-the-project/">
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "ptbk",
3
- "version": "0.86.0-8",
3
+ "version": "0.86.5",
4
4
  "description": "It's time for a paradigm shift. The future of software in plain English, French or Latin",
5
5
  "private": false,
6
6
  "sideEffects": false,
@@ -44,10 +44,10 @@
44
44
  },
45
45
  "homepage": "https://ptbk.io/",
46
46
  "peerDependencies": {
47
- "@promptbook/core": "0.86.0-8"
47
+ "@promptbook/core": "0.86.5"
48
48
  },
49
49
  "dependencies": {
50
- "promptbook": "0.86.0-8"
50
+ "promptbook": "0.86.5"
51
51
  },
52
52
  "bin": {
53
53
  "ptbk": "bin/promptbook-cli-proxy.js"