@promptbook/google 0.105.0-3 → 0.105.0-4

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
@@ -251,19 +251,20 @@ Rest of the documentation is common for **entire promptbook ecosystem**:
251
251
 
252
252
  ## 📖 The Book Whitepaper
253
253
 
254
- For most business applications nowadays, the biggest challenge isn't about the raw capabilities of AI models. Large language models like GPT-5 or Claude-4.1 are extremely capable.
254
+ Nowadays, the biggest challenge for most business applications isn't the raw capabilities of AI models. Large language models such as GPT-5.2 and Claude-4.5 are incredibly capable.
255
255
 
256
- The main challenge is to narrow it down, constrain it, set the proper **context, rules, knowledge, and personality**. There are a lot of tools which can do exactly this. On one side, there are no-code platforms which can launch your agent in seconds. On the other side, there are heavy frameworks like Langchain or Semantic Kernel, which can give you deep control.
256
+ The main challenge lies in **managing the context**, providing rules and knowledge, and narrowing the personality.
257
257
 
258
- Promptbook takes the best from both worlds. You are defining your AI behavior by simple **books**, which are very explicit. They are automatically enforced, but they are very easy to understand, very easy to write, and very reliable and portable.
258
+ In Promptbook, you can define your context **using simple Books** that are very explicit, easy to understand and write, reliable, and highly portable.
259
259
 
260
260
  <table style="border: 1px solid #777; border-radius: 10px;"><tr><td>
261
261
 
262
- **<ins>Paul Smith & Associés</ins>**<br/>
262
+ **<ins>Paul Smith</ins>**<br/>
263
263
  <br/>
264
264
  **PERSONA** You are a company lawyer.<br/>
265
265
  Your job is to provide legal advice and support to the company and its employees.<br/>
266
- You are knowledgeable, professional, and detail-oriented.<br/>
266
+ **RULE** You are knowledgeable, professional, and detail-oriented.<br/>
267
+ TEAM You are part of the legal team of Paul Smith & Associés, you discuss with {Emily White}, the head of the compliance department. {George Brown} is expert in corporate law and {Sophia Black} is expert in labor law.<br/>
267
268
 
268
269
  </td></tr></table>
269
270
 
@@ -273,7 +274,9 @@ You are knowledgeable, professional, and detail-oriented.<br/>
273
274
 
274
275
  We have created a language called **Book**, which allows you to write AI agents in their native language and create your own AI persona. Book provides a guide to define all the traits and commitments.
275
276
 
276
- You can look at it as prompting (or writing a system message), but decorated by **commitments**.
277
+ You can look at it as "prompting" _(or writing a system message)_, but decorated by **commitments**.
278
+
279
+ **Commitments** are special syntax elements that define contracts between you and the AI agent. They are transformed by Promptbook Engine into low-level parameters like which model to use, its temperature, system message, RAG index, MCP servers, and many other parameters. For some commitments _(for example `RULE` commitment)_ Promptbook Engine can even create adversary agents and extra checks to enforce the rules.
277
280
 
278
281
  #### `Persona` commitment
279
282
 
@@ -284,8 +287,6 @@ Personas define the character of your AI persona, its role, and how it should in
284
287
  **<ins>Paul Smith & Associés</ins>**<br/>
285
288
  <br/>
286
289
  **PERSONA** You are a company lawyer.<br/>
287
- Your job is to provide legal advice and support to the company and its employees.<br/>
288
- You are knowledgeable, professional, and detail-oriented.<br/>
289
290
 
290
291
  </td></tr></table>
291
292
 
@@ -305,7 +306,7 @@ Promptbook Engine will automatically enforce this knowledge during interactions.
305
306
  Your job is to provide legal advice and support to the company and its employees.<br/>
306
307
  You are knowledgeable, professional, and detail-oriented.<br/>
307
308
  <br/>
308
- **KNOWLEDGE** https://company.com/company-policies.pdf<br/>
309
+ **KNOWLEDGE** https://company.com/company-policies.pdf<br/>
309
310
  **KNOWLEDGE** https://company.com/internal-documents/employee-handbook.docx<br/>
310
311
 
311
312
  </td></tr></table>
@@ -327,14 +328,14 @@ You are knowledgeable, professional, and detail-oriented.<br/>
327
328
  **RULE** Always ensure compliance with laws and regulations.<br/>
328
329
  **RULE** Never provide legal advice outside your area of expertise.<br/>
329
330
  **RULE** Never provide legal advice about criminal law.<br/>
330
- **KNOWLEDGE** https://company.com/company-policies.pdf<br/>
331
+ **KNOWLEDGE** https://company.com/company-policies.pdf<br/>
331
332
  **KNOWLEDGE** https://company.com/internal-documents/employee-handbook.docx<br/>
332
333
 
333
334
  </td></tr></table>
334
335
 
335
- #### `Action` commitment
336
+ #### `Team` commitment
336
337
 
337
- Action Commitment allows you to define specific actions that the AI can take during interactions. This can include things like posting on a social media platform, sending emails, creating calendar events, or interacting with your internal systems.
338
+ Team commitment allows you to define the team structure and advisory fellow members the AI can consult with. This allows the AI to simulate collaboration and consultation with other experts, enhancing the quality of its responses.
338
339
 
339
340
  <table style="border: 1px solid #777; border-radius: 10px;"><tr><td>
340
341
 
@@ -347,81 +348,36 @@ You are knowledgeable, professional, and detail-oriented.<br/>
347
348
  **RULE** Always ensure compliance with laws and regulations.<br/>
348
349
  **RULE** Never provide legal advice outside your area of expertise.<br/>
349
350
  **RULE** Never provide legal advice about criminal law.<br/>
350
- **KNOWLEDGE** https://company.com/company-policies.pdf<br/>
351
+ **KNOWLEDGE** https://company.com/company-policies.pdf<br/>
351
352
  **KNOWLEDGE** https://company.com/internal-documents/employee-handbook.docx<br/>
352
- **ACTION** When a user asks about an issue that could be treated as a crime, notify legal@company.com.<br/>
353
+ TEAM You are part of the legal team of Paul Smith & Associés, you discuss with {Emily White}, the head of the compliance department. {George Brown} is expert in corporate law and {Sophia Black} is expert in labor law.<br/>
353
354
 
354
355
  </td></tr></table>
355
356
 
356
- [Read more about the language](./BLUEPRINT.md)
357
-
358
- <div style="page-break-after: always;"></div>
359
-
360
- ### Where to use your AI agent in book
361
-
362
- Books can be useful in various applications and scenarios. Here are some examples:
363
-
364
- #### Chat apps:
365
357
 
366
- Create your own chat shopping assistant and place it in your eShop.
367
- You will be able to answer customer questions, help them find products, and provide personalized recommendations. Everything is tightly controlled by the book you have written.
368
358
 
369
- #### Reply Agent:
359
+ ### Promptbook Ecosystem
370
360
 
371
- Create your own AI agent, which will look at your emails and reply to them. It can even create drafts for you to review before sending.
361
+ !!!@@@
372
362
 
373
- #### Coding Agent:
374
-
375
- Do you love Vibecoding, but the AI code is not always aligned with your coding style and architecture, rules, security, etc.? Create your own coding agent to help enforce your specific coding standards and practices.
376
-
377
- This can be integrated to almost any Vibecoding platform, like GitHub Copilot, Amazon CodeWhisperer, Cursor, Cline, Kilocode, Roocode,...
378
-
379
- They will work the same as you are used to, but with your specific rules written in book.
380
-
381
- #### Internal Expertise
382
-
383
- Do you have an app written in TypeScript, Python, C#, Java, or any other language, and you are integrating the AI.
384
-
385
- You can avoid struggle with choosing the best model, its settings like temperature, max tokens, etc., by writing a book agent and using it as your AI expertise.
386
-
387
- Doesn't matter if you do automations, data analysis, customer support, sentiment analysis, classification, or any other task. Your AI agent will be tailored to your specific needs and requirements.
388
-
389
- Even works in no-code platforms!
390
-
391
- <div style="page-break-after: always;"></div>
363
+ #### Promptbook Server
392
364
 
393
- ### How to create your AI agent in book
365
+ !!!@@@
394
366
 
395
- Now you want to use it. There are several ways how to write your first book:
367
+ #### Promptbook Engine
396
368
 
397
- #### From scratch with help from Paul
369
+ !!!@@@
398
370
 
399
- We have written ai asistant in book who can help you with writing your first book.
400
371
 
401
- #### Your AI twin
402
372
 
403
- Copy your own behavior, personality, and knowledge into book and create your AI twin. It can help you with your work, personal life, or any other task.
404
373
 
405
- #### AI persona workpool
406
374
 
407
- Or you can pick from our library of pre-written books for various roles and tasks. You can find books for customer support, coding, marketing, sales, HR, legal, and many other roles.
408
375
 
409
376
 
410
377
 
411
378
 
412
379
 
413
380
 
414
- ## 🚀 Get started
415
-
416
- Take a look at the simple starter kit with books integrated into the **Hello World** sample applications:
417
-
418
- - [Hello Book](https://github.com/webgptorg/hello-world)
419
- - [Hello Book in Node.js](https://github.com/webgptorg/hello-world-node-js)
420
- - [Hello Book in Next.js](https://github.com/webgptorg/hello-world-next-js)
421
-
422
-
423
-
424
-
425
381
 
426
382
 
427
383
  ## 💜 The Promptbook Project
@@ -437,33 +393,32 @@ Promptbook project is ecosystem of multiple projects and tools, following is a l
437
393
  </thead>
438
394
  <tbody>
439
395
  <tr>
440
- <td><a href="https://github.com/webgptorg/book">Book language</a></td>
396
+ <td><a href="https://gallery.ptbk.io/">Agents Server</a></td>
441
397
  <td>
442
- Book is a human-understandable markup language for writing AI applications such as chatbots, knowledge bases, agents, avarars, translators, automations and more.
443
- <hr>
444
- There is also <a href="https://github.com/webgptorg/book-extension">a plugin for VSCode</a> to support <code>.book</code> file extension
398
+ Place where you "AI agents live". It allows to create, manage, deploy, and interact with AI agents created in Book language.
445
399
  </td>
446
400
  </tr>
447
401
  <tr>
448
- <td><a href="https://github.com/webgptorg/promptbook">Promptbook Engine</a></td>
402
+ <td><a href="https://github.com/webgptorg/book">Book language</a></td>
449
403
  <td>
450
- Promptbook engine can run applications written in Book language. It is released as <a href="https://www.npmjs.com/package/@promptbook/core#-packages-for-developers">multiple NPM packages</a> and <a href="https://hub.docker.com/r/hejny/promptbook">Docker HUB</a>
404
+ Human-friendly, high-level language that abstracts away low-level details of AI. It allows to focus on personality, behavior, knowledge, and rules of AI agents rather than on models, parameters, and prompt engineering.
405
+ <hr>
406
+ There is also <a href="https://github.com/webgptorg/book-extension">a plugin for VSCode</a> to support <code>.book</code> file extension
451
407
  </td>
452
408
  </tr>
453
409
  <tr>
454
- <td><a href="https://promptbook.studio">Promptbook Studio</a></td>
410
+ <td><a href="https://github.com/webgptorg/promptbook">Promptbook Engine</a></td>
455
411
  <td>
456
- Promptbook.studio is a web-based editor and runner for book applications. It is still in the experimental MVP stage.
412
+ Promptbook engine can run AI agents based on Book language.
413
+ It is released as <a href="https://www.npmjs.com/package/@promptbook/core#-packages-for-developers">multiple NPM packages</a> and <a href="https://hub.docker.com/r/hejny/promptbook">Promptbook Agent Server as Docker Package</a>
414
+ Agent Server is based on Promptbook Engine.
457
415
  </td>
458
416
  </tr>
417
+
459
418
  </tbody>
460
419
  </table>
461
420
 
462
- Hello world examples:
463
421
 
464
- - [Hello world](https://github.com/webgptorg/hello-world)
465
- - [Hello world in Node.js](https://github.com/webgptorg/hello-world-node-js)
466
- - [Hello world in Next.js](https://github.com/webgptorg/hello-world-next-js)
467
422
 
468
423
  ### 🌐 Community & Social Media
469
424
 
@@ -521,6 +476,8 @@ Join our growing community of developers and users:
521
476
 
522
477
 
523
478
 
479
+
480
+
524
481
  ## 📚 Documentation
525
482
 
526
483
  See detailed guides and API reference in the [docs](https://github.com/webgptorg/promptbook/discussions/categories/concepts) or [online](https://discord.gg/x3QWNaa89N).
@@ -597,6 +554,8 @@ The following glossary is used to clarify certain concepts:
597
554
 
598
555
  _Note: This section is not a complete dictionary, more list of general AI / LLM terms that has connection with Promptbook_
599
556
 
557
+
558
+
600
559
  ### 💯 Core concepts
601
560
 
602
561
  - [📚 Collection of pipelines](https://github.com/webgptorg/promptbook/discussions/65)
package/esm/index.es.js CHANGED
@@ -16,7 +16,7 @@ const BOOK_LANGUAGE_VERSION = '2.0.0';
16
16
  * @generated
17
17
  * @see https://github.com/webgptorg/promptbook
18
18
  */
19
- const PROMPTBOOK_ENGINE_VERSION = '0.105.0-3';
19
+ const PROMPTBOOK_ENGINE_VERSION = '0.105.0-4';
20
20
  /**
21
21
  * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
22
22
  * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -15,7 +15,7 @@ export declare const BOOK_LANGUAGE_VERSION: string_semantic_version;
15
15
  export declare const PROMPTBOOK_ENGINE_VERSION: string_promptbook_version;
16
16
  /**
17
17
  * Represents the version string of the Promptbook engine.
18
- * It follows semantic versioning (e.g., `0.105.0-2`).
18
+ * It follows semantic versioning (e.g., `0.105.0-3`).
19
19
  *
20
20
  * @generated
21
21
  */
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@promptbook/google",
3
- "version": "0.105.0-3",
3
+ "version": "0.105.0-4",
4
4
  "description": "Promptbook: Turn your company's scattered knowledge into AI ready books",
5
5
  "private": false,
6
6
  "sideEffects": false,
@@ -95,7 +95,7 @@
95
95
  "module": "./esm/index.es.js",
96
96
  "typings": "./esm/typings/src/_packages/google.index.d.ts",
97
97
  "peerDependencies": {
98
- "@promptbook/core": "0.105.0-3"
98
+ "@promptbook/core": "0.105.0-4"
99
99
  },
100
100
  "dependencies": {
101
101
  "@ai-sdk/google": "1.0.17",
package/umd/index.umd.js CHANGED
@@ -23,7 +23,7 @@
23
23
  * @generated
24
24
  * @see https://github.com/webgptorg/promptbook
25
25
  */
26
- const PROMPTBOOK_ENGINE_VERSION = '0.105.0-3';
26
+ const PROMPTBOOK_ENGINE_VERSION = '0.105.0-4';
27
27
  /**
28
28
  * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
29
29
  * Note: [💞] Ignore a discrepancy between file name and entity name