@promptbook/types 0.103.0-2 → 0.103.0-20

package/README.md

@@ -315,7 +315,6 @@ The main challenge is to narrow it down, constrain it, set the proper **context,
 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.
 
 
-
 <img
     alt="Paul Smith & Associés Book"
     src="https://promptbook.studio/embed/book-preview.png?book=Paul%20Smith%20%26%20Associ%C3%A9s%0A%20%20%20%20%20%20%7C%20PERSONA%20You%20are%20a%20company%20lawyer.%0A%20%20%20%20%20%20%7C%20Your%20job%20is%20to%20provide%20legal%20advice%20and%20support%20to%20the%20company%20and%20its%20employees.%0A%20%20%20%20%20%20%7C%20You%20are%20knowledgeable%2C%20professional%2C%20and%20detail-oriented.&width=800&height=450&nonce=0"
@@ -334,7 +333,6 @@ You can look at it as prompting (or writing a system message), but decorated by
 Personas define the character of your AI persona, its role, and how it should interact with users. It sets the tone and style of communication.
 
 
-
 <img
     alt="Paul Smith & Associés Book"
     src="https://promptbook.studio/embed/book-preview.png?book=Paul%20Smith%20%26%20Associ%C3%A9s%0A%20%20%20%20%20%20%7C%20PERSONA%20You%20are%20a%20company%20lawyer.%0A%20%20%20%20%20%20%7C%20Your%20job%20is%20to%20provide%20legal%20advice%20and%20support%20to%20the%20company%20and%20its%20employees.%0A%20%20%20%20%20%20%7C%20You%20are%20knowledgeable%2C%20professional%2C%20and%20detail-oriented.&width=800&height=450&nonce=0"
@@ -349,7 +347,6 @@ This can include domain-specific knowledge, company policies, or any other relev
 Promptbook Engine will automatically enforce this knowledge during interactions. When the knowledge is short enough, it will be included in the prompt. When it is too long, it will be stored in vector databases and RAG retrieved when needed. But you don't need to care about it.
 
 
-
 <img
     alt="Paul Smith & Associés Book"
     src="https://promptbook.studio/embed/book-preview.png?book=Paul%20Smith%20%26%20Associ%C3%A9s%0A%20%20%20%20%20%20%7C%20PERSONA%20You%20are%20a%20company%20lawyer.%0A%20%20%20%20%20%20%7C%20Your%20job%20is%20to%20provide%20legal%20advice%20and%20support%20to%20the%20company%20and%20its%20employees.%0A%20%20%20%20%20%20%7C%20You%20are%20knowledgeable%2C%20professional%2C%20and%20detail-oriented.%0A%20%20%20%20%20%20%7C%20KNOWLEDGE%20%20https%3A%2F%2Fcompany.com%2Fcompany-policies.pdf%0A%20%20%20%20%20%20%7C%20KNOWLEDGE%20https%3A%2F%2Fcompany.com%2Finternal-documents%2Femployee-handbook.docx&width=800&height=450&nonce=0"
@@ -362,7 +359,6 @@ Rules will enforce specific behaviors or constraints on the AI's responses. This
 Depending on rule strictness, Promptbook will either propagate it to the prompt or use other techniques, like adversary agent, to enforce it.
 
 
-
 <img
     alt="Paul Smith & Associés Book"
     src="https://promptbook.studio/embed/book-preview.png?book=Paul%20Smith%20%26%20Associ%C3%A9s%0A%20%20%20%20%20%20%7C%20PERSONA%20You%20are%20a%20company%20lawyer.%0A%20%20%20%20%20%20%7C%20Your%20job%20is%20to%20provide%20legal%20advice%20and%20support%20to%20the%20company%20and%20its%20employees.%0A%20%20%20%20%20%20%7C%20You%20are%20knowledgeable%2C%20professional%2C%20and%20detail-oriented.%0A%20%20%20%20%20%20%7C%20RULE%20Always%20ensure%20compliance%20with%20laws%20and%20regulations.%0A%20%20%20%20%20%20%7C%20RULE%20Never%20provide%20legal%20advice%20outside%20your%20area%20of%20expertise.%0A%20%20%20%20%20%20%7C%20RULE%20Never%20provide%20legal%20advice%20about%20criminal%20law.%0A%20%20%20%20%20%20%7C%20KNOWLEDGE%20%20https%3A%2F%2Fcompany.com%2Fcompany-policies.pdf%0A%20%20%20%20%20%20%7C%20KNOWLEDGE%20https%3A%2F%2Fcompany.com%2Finternal-documents%2Femployee-handbook.docx&width=800&height=450&nonce=0"
@@ -373,7 +369,6 @@ Depending on rule strictness, Promptbook will either propagate it to the prompt
 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.
 
 
-
 <img
     alt="Paul Smith & Associés Book"
     src="https://promptbook.studio/embed/book-preview.png?book=Paul%20Smith%20%26%20Associ%C3%A9s%0A%20%20%20%20%20%20%7C%20PERSONA%20You%20are%20a%20company%20lawyer.%0A%20%20%20%20%20%20%7C%20Your%20job%20is%20to%20provide%20legal%20advice%20and%20support%20to%20the%20company%20and%20its%20employees.%0A%20%20%20%20%20%20%7C%20You%20are%20knowledgeable%2C%20professional%2C%20and%20detail-oriented.%0A%20%20%20%20%20%20%7C%20RULE%20Always%20ensure%20compliance%20with%20laws%20and%20regulations.%0A%20%20%20%20%20%20%7C%20RULE%20Never%20provide%20legal%20advice%20outside%20your%20area%20of%20expertise.%0A%20%20%20%20%20%20%7C%20RULE%20Never%20provide%20legal%20advice%20about%20criminal%20law.%0A%20%20%20%20%20%20%7C%20KNOWLEDGE%20%20https%3A%2F%2Fcompany.com%2Fcompany-policies.pdf%0A%20%20%20%20%20%20%7C%20KNOWLEDGE%20https%3A%2F%2Fcompany.com%2Finternal-documents%2Femployee-handbook.docx%0A%20%20%20%20%20%20%7C%20ACTION%20When%20a%20user%20asks%20about%20an%20issue%20that%20could%20be%20treated%20as%20a%20crime%2C%20notify%20legal%40company.com.&width=800&height=450&nonce=0"
@@ -424,10 +419,14 @@ Now you want to use it. There are several ways how to write your first book:
 
 We have written ai asistant in book who can help you with writing your first book.
 
+
+
 #### Your AI twin
 
 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.
 
+
+
 #### AI persona workpool
 
 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.
@@ -545,209 +544,7 @@ Join our growing community of developers and users:
 
 
 
-## 📘 Book Language Blueprint
-
-<blockquote style="color:#FFE600">
-⚠ This file is a work in progress and may be incomplete or inaccurate.
-</blockquote>
-
----
-
-Book is a simple format do define AI apps and agents. It is the source code the soul of AI apps and agents.. It's purpose is to avoid ambiguous UIs with multiple fields and low-level ways like programming in langchain.
-
-Book is defined in file with `.book` extension
-
-### Examples
-
-
-
-<img
-    alt="Write an article about {topic} Book"
-    src="https://promptbook.studio/embed/book-preview.png?book=Write%20an%20article%20about%20%7Btopic%7D%0A%20%20%20%20%20%20%7C%20PERSONA%20Jane%2C%20marketing%20specialist%20with%20prior%20experience%20in%20tech%20and%20AI%20writing%0A%20%20%20%20%20%20%7C%20KNOWLEDGE%20https%3A%2F%2Fwikipedia.org%2F%0A%20%20%20%20%20%20%7C%20KNOWLEDGE%20.%2Fjournalist-ethics.pdf%0A%20%20%20%20%20%20%7C%20EXPECT%201%20Sentence%20-%205%20Pages%0A%20%20%20%20%20%20%7C%20RESULT%20%7Barticle%7D&width=800&height=450&nonce=0"
-/>
-
----
-
-
-
-<img
-    alt="Make post on LinkedIn based on @Input. Book"
-    src="https://promptbook.studio/embed/book-preview.png?book=Make%20post%20on%20LinkedIn%20based%20on%20%40Input.%0A%20%20%20%20%20%20%7C%20PERSONA%20%40Jane%2C%20an%20experienced%20copywriter%20and%20HR%20expert%0A%20%20%20%20%20%20%7C%20KNOWLEDGE%20cetin.cz%0A%20%20%20%20%20%20%7C%20KNOWLEDGE%20linkedin.com%2Fcompany%2Fcetin%2F&width=800&height=450&nonce=0"
-/>
-
----
-
-
-
-<img
-    alt="Odpověz na Email Book"
-    src="https://promptbook.studio/embed/book-preview.png?book=Odpov%C4%9Bz%20na%20Email%0A%20%20%20%20%20%20%7C%20%7BEmail%20content%7D%0A%20%20%20%20%20%20%7C%20PERSONA%20%40Pavol%20-%20pavolhejny.com%0A%20%20%20%20%20%20%7C%20KNOWLEDGE%20.%2Finstructions.pdf%0A%20%20%20%20%20%20%7C%20STYLE%20Professional%20tone%20of%20voice&width=800&height=450&nonce=0"
-/>
-
----
-
-
-
-<img
-    alt="Analyzuj {Případ}. Book"
-    src="https://promptbook.studio/embed/book-preview.png?book=Analyzuj%20%7BP%C5%99%C3%ADpad%7D.%0A%20%20%20%20%20%20%7C%20%7BDetaily%7D%0A%20%20%20%20%20%20%7C%20PERSONA%20%40Ji%C5%99%C3%AD%2C%20pr%C3%A1vn%C3%ADk%2C%20kter%C3%BD%20nikdy%20neode%C5%A1le%20informace%20o%20klientech%20mimo%20EU%0A%20%20%20%20%20%20%7C%20KNOWLEDGE%20%7B89%2F2012%20Sb.%20Ob%C4%8Dansk%C3%BD%20z%C3%A1kon%C3%ADk%7D&width=800&height=450&nonce=0"
-/>
-
-iframe:
-
-<iframe frameborder="0" style="width:100%;height:455px;" src="https://viewer.diagrams.net/?tags=%7B%7D&lightbox=1&highlight=0000ff&edit=_blank&layers=1&nav=1&title=#R%3Cmxfile%20scale%3D%221%22%20border%3D%220%22%20disableSvgWarning%3D%22true%22%20linkTarget%3D%22_blank%22%3E%3Cdiagram%20name%3D%22Page-1%22%20id%3D%22zo4WBBcyATChdUDADUly%22%3E7ZxtU%2BM2EMc%2FjWfaF2b8kMTwEkKOu%2Fa468BM77ViK4mKLLmy8nSfvitbihPiNEAaIHTfYHm1luzVT7vG%2F5l4cT9f3ChSTG5lRrkXBdnCi6%2B9KAo7YQ8OxrK0liBKastYsczaGsM9%2B0mdo7VOWUbLDUctJdes2DSmUgia6g0bUUrON91Gkm%2FOWpCxnTFoDPcp4XTL7QfL9KS2nnfXvD9TNp64mcPA9uTEOVtDOSGZnK%2BZ4oEX95WUum7liz7lJnouLvV1n3b0rm5MUaGfcoFdiRnhU%2Ftsf1KlGTwqWPtSaMIEVfZe9dIFoJyznBMBZ1fzCdP0viCp6ZrDgoNtonMOZyE07fgwKF3svMdw9eTADJU51WoJLvYCP7qw0bK8JPZ03sQ%2B7lnbZC3ukQs7ses9Xo3dhAQaNirtEbrYipAX9TjMcFUWRDSOvb%2BnZtGuMpmWPhOaKkG4b0j1R2EcdbNO6iej0cgfhufQGiaJnw7PaXIRJT2adpsBoDW2x2qaYiP0zovDuvjuYS%2FDs%2FgcjDlRYyZ8LQtjiwrd2IZSa5k35vX5goypzcG12n0%2F9rG3b2kEuPhltVkvwWE1UVB1jEjO%2BLLugmtIbkCxV95JuD0JHbdSyMedXtQ3Owd6ypqyq2pnc6nqwdR4%2BEtQO7nDr7XTkKQPYyWnIvPX%2FLUionT0rW5vRhQjcBTTnCqW1q5Cqhx2wrYXJaX2SQntPY6EVyBok63%2B1bGQJdNM7huP5vIvtu0zs5sW5mNjO8aQlNRQUntU29SvImiCwUlR2nUqFC2pmtFHUNSLfkseqPGRpYaDNAv%2FlYkHmn0RdorM2R0fsKFqRN4%2FNhe1Uxh060YUJi9AZ%2B52IRgSYBCh2gOV1wm%2BiGKqT5AYTDRHYuJsDwxgLl5WGTtRGHW3imOntTgGH7A2ht34YGgxxT0T5z8Gd%2Fffv11iWURmnlMWfzP%2FU50eMFgVj4VEFdBqwemigMhQkVZv3KkslnMFY6qq35g%2B3zmvfS9WB9TSoLddSwMspZgWj7cHfv%2F2%2FcfXwfXN4DSLKebGI3GRUs3EWfoTkx0muw8D9TGSXYjJ7uS54NVHV5PvIN9En%2BAvrP7StEwWNGLG87NgxmbI1P%2BYKbfoQ9VCyw6IWpjZcn6kFWq6MPY1TdA%2ByDWnI9PjHvDSmnOWZXyXtFgtOTWSW7CabI%2B62GtXF62Y2HmimBg64yFiohOw37XeGjod20bIf2qI%2FhO9NQxRcH3%2FL4eYlFFwxS%2FLpwIVCq7IBAqur4Usfjh5A5xRcEVmUHDFqoiCK5ZSTIsH7QEUXJGLNi5QcMVk9%2BGgRsEVuWjjAgVXZAoFV%2B9FgmsYtOuLb6K4RieouK504tdRXGNUXN%2F%2F2yFmZVRc8dPyqUCFiisygYrrayGLX07eAGdUXJEZVFyxKqLiiqUU0%2BJBewAVV%2BSijQtUXDHZfTioUXFFLtq4QMUVmULF1XuZ4hq9meIKp83PFVd9N82vPseDfwA%3D%3C%2Fdiagram%3E%3C%2Fmxfile%3E"></iframe>
-
-books.svg
-
-![Books](./books/diagram/books.svg)
-
-books.png
-
-![Books](./books/diagram/books.png)
-
-### Basic Commitments:
-
-Book is composed of commitments, which are the building blocks of the book. Each commitment defines a specific task or action to be performed by the AI agent. The commitments are defined in a structured format, allowing for easy parsing and execution.
-
-#### `PERSONA`
-
-defines basic contour of
-
-> PERSONA @Joe Average man with
-
-also the PERSONA is
-
-Describes
-
-#### `RULE` or `RULES`
-
-defines
-
-#### `STYLE`
-
-xxx
 
-#### `SAMPLE`
-
-xxx
-
-#### `KNOWLEDGE`
-
-xxx
-
-#### `EXPECT`
-
-xxx
-
-#### `FORMAT`
-
-xxx
-
-#### `JOKER`
-
-xxx
-
-#### `MODEL`
-
-xxx
-
-#### `ACTION`
-
-xxx
-
-#### `META`
-
-### Names
-
-each commitment is
-
-`PERSONA`
-
-Variable names
-
-### Types
-
-### Miscellaneous aspects of Book language
-
-#### Named vs Anonymous commitments
-
-#### Single line vs multiline
-
-#### Bookish vs Non-bookish definitions
-
----
-
-## **\_\_\_\_**
-
-Great context and prompt can make or break you AI app. In last few years we have came from simple one-shot prompts. When you want to add conplexity you have finetunned the model or add better orchestration. But with really large large language models the context seems to be a king.
-
-The Book is the language to describe and define your AI app. Its like a shem for a Golem, book is the shem and model is the golem.
-
-
-
-<img
-    alt="Franz Kafka Book"
-    src="https://promptbook.studio/embed/book-preview.png?book=Franz%20Kafka%0A%20%20%20%20%20%20%7C%20PERSONA%20Franz%20Kafka%2C%20a%20writer%20who%20is%20interested%20in%20the%20human%20condition%20and%20the%20absurdity%20of%20life%2C%20speaks%20German%20and%20Czech%20and%20English%0A%20%20%20%20%20%20%7C%20STYLE%20%7Bkafka.com%2Fthe-castle%7D%0A%20%20%20%20%20%20%7C%20STYLE%20%7Bkafka.com%2Fthe-trial.pdf%7D%0A%20%20%20%20%20%20%7C%20STYLE%20%7Bkafka.com%2Fmetamorphosis.docx%7D%0A%20%20%20%20%20%20%7C%20KNOWLEDGE%20Franz%20Kafka%20has%20a%20deep%20understanding%20of%20existentialism%2C%20surrealism%2C%20and%20the%20human%20psyche%0A%20%20%20%20%20%20%7C%20GOAL%20Write%20a%20short%20story%20that%20explores%20the%20themes%20of%20alienation%2C%20bureaucracy%2C%20and%20the%20absurd%0A%20%20%20%20%20%20%7C%20ACTION%20%7Bmcp&width=800&height=450&nonce=0"
-/>
-
-## Who, what and how?
-
-To write a good prompt and the book you will be answering 3 main questions
-
--   **Who** is working on the task, is it a team or an individual? What is the role of the person in the team? What is the background of the person? What is the motivation of the person to work on this task?
-    You rather want `Paul, an typescript developer who prefers SOLID code` not `gemini-2`
--   **What**
--   **How**
-
-each commitment (described bellow) is connected with one of theese 3 questions.
-
-### Commitments
-
-Commitment is one piece of book, you can imagine it as one paragraph of book.
-
-Each commitment starts in a new line with commitment name, its usually in UPPERCASE and follows a contents of that commitment. Contents of the commithemt is defined in natural language.
-
-Commitments are chained one after another, in general commitments which are written later are more important and redefines things defined earlier.
-
-Each commitment falls into one or more of cathegory who, what or how
-
-Here are some basic commintemts:
-
--   `PERSONA` tells **who** is working on the task
--   `KNOWLEDGE` describes **what** knowledge the person has
--   `GOAL` describes **what** is the goal of the task
--   `ACTION` describes **what** actions can be done
--   `RULE` describes **what** rules should be followed
--   `STYLE` describes **how** the output should be presented
-
-### Variables and references
-
-When the prompt should be to be useful it should have some fixed static part and some variable dynamic part
-
-
-
-<img
-    alt="Untitled Book"
-    src="https://promptbook.studio/embed/book-preview.png?book=&width=800&height=450&nonce=0"
-/>
-
-### Imports
-
-### Layering
-
-### Book defined in book
-
-###
-
-Book vs:
-
--   Why just dont pick the right model
--   Orchestration frameworks - Langchain, Google Agent ..., Semantic Kernel,...
--   Finetunning
--   Temperature, top_t, top_k,... etc.
--   System message
--   MCP server
--   function calling
 
 
 
@@ -827,6 +624,8 @@ The following glossary is used to clarify certain concepts:
 
 _Note: This section is not a complete dictionary, more list of general AI / LLM terms that has connection with Promptbook_
 
+
+
 ### 💯 Core concepts
 
 -   [📚 Collection of pipelines](https://github.com/webgptorg/promptbook/discussions/65)

package/esm/typings/src/_packages/browser.index.d.ts

@@ -4,9 +4,15 @@ import { $provideScrapersForBrowser } from '../scrapers/_common/register/$provid
 import { getIndexedDbStorage } from '../storage/local-storage/getIndexedDbStorage';
 import { getLocalStorage } from '../storage/local-storage/getLocalStorage';
 import { getSessionStorage } from '../storage/local-storage/getSessionStorage';
+import { $induceBookDownload } from '../utils/files/$induceBookDownload';
+import { $induceFileDownload } from '../utils/files/$induceFileDownload';
+import { ObjectUrl } from '../utils/files/ObjectUrl';
 export { BOOK_LANGUAGE_VERSION, PROMPTBOOK_ENGINE_VERSION };
 export { SimplePromptInterfaceTools };
 export { $provideScrapersForBrowser };
 export { getIndexedDbStorage };
 export { getLocalStorage };
 export { getSessionStorage };
+export { $induceBookDownload };
+export { $induceFileDownload };
+export { ObjectUrl };

package/esm/typings/src/_packages/components.index.d.ts

@@ -7,6 +7,7 @@ import type { AvatarProfileProps } from '../book-components/AvatarProfile/Avatar
 import { AvatarProfile } from '../book-components/AvatarProfile/AvatarProfile/AvatarProfile';
 import type { AvatarProfileFromSourceProps } from '../book-components/AvatarProfile/AvatarProfile/AvatarProfileFromSource';
 import { AvatarProfileFromSource } from '../book-components/AvatarProfile/AvatarProfile/AvatarProfileFromSource';
+import { DEFAULT_BOOK_EDITOR_HEIGHT } from '../book-components/BookEditor/BookEditor';
 import type { BookEditorProps } from '../book-components/BookEditor/BookEditor';
 import { BookEditor } from '../book-components/BookEditor/BookEditor';
 import { DEFAULT_BOOK_FONT_CLASS } from '../book-components/BookEditor/config';
@@ -61,6 +62,7 @@ export type { AvatarProfileProps };
 export { AvatarProfile };
 export type { AvatarProfileFromSourceProps };
 export { AvatarProfileFromSource };
+export { DEFAULT_BOOK_EDITOR_HEIGHT };
 export type { BookEditorProps };
 export { BookEditor };
 export { DEFAULT_BOOK_FONT_CLASS };

package/esm/typings/src/_packages/core.index.d.ts

@@ -1,6 +1,8 @@
 import { BOOK_LANGUAGE_VERSION, PROMPTBOOK_ENGINE_VERSION } from '../version';
 import { createAgentModelRequirements } from '../book-2.0/agent-source/createAgentModelRequirements';
 import { createAgentModelRequirementsWithCommitments } from '../book-2.0/agent-source/createAgentModelRequirementsWithCommitments';
+import { PADDING_LINES } from '../book-2.0/agent-source/padBook';
+import { padBook } from '../book-2.0/agent-source/padBook';
 import { parseAgentSource } from '../book-2.0/agent-source/parseAgentSource';
 import { parseParameters } from '../book-2.0/agent-source/parseParameters';
 import { isValidBook } from '../book-2.0/agent-source/string_book';
@@ -24,6 +26,7 @@ import { ADMIN_EMAIL } from '../config';
 import { ADMIN_GITHUB_NAME } from '../config';
 import { CLAIM } from '../config';
 import { PROMPTBOOK_COLOR } from '../config';
+import { PROMPTBOOK_SYNTAX_COLORS } from '../config';
 import { PROMPTBOOK_CHAT_COLOR } from '../config';
 import { USER_CHAT_COLOR } from '../config';
 import { DEFAULT_BOOK_TITLE } from '../config';
@@ -176,6 +179,8 @@ import { REMOTE_SERVER_URLS } from '../../servers';
 export { BOOK_LANGUAGE_VERSION, PROMPTBOOK_ENGINE_VERSION };
 export { createAgentModelRequirements };
 export { createAgentModelRequirementsWithCommitments };
+export { PADDING_LINES };
+export { padBook };
 export { parseAgentSource };
 export { parseParameters };
 export { isValidBook };
@@ -199,6 +204,7 @@ export { ADMIN_EMAIL };
 export { ADMIN_GITHUB_NAME };
 export { CLAIM };
 export { PROMPTBOOK_COLOR };
+export { PROMPTBOOK_SYNTAX_COLORS };
 export { PROMPTBOOK_CHAT_COLOR };
 export { USER_CHAT_COLOR };
 export { DEFAULT_BOOK_TITLE };

package/esm/typings/src/book-2.0/agent-source/padBook.d.ts

@@ -0,0 +1,16 @@
+import { string_book } from './string_book';
+/**
+ *  Number of padding lines to add at the end of the book content
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare const PADDING_LINES = 11;
+/**
+ * A function that adds padding to the book content
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare function padBook(content: string_book): string_book;
+/**
+ * TODO: [🧠] Maybe export
+ */

package/esm/typings/src/book-components/AvatarProfile/AvatarProfile/AvatarProfile.d.ts

@@ -1,4 +1,5 @@
 import type { AgentBasicInformation } from '../../../book-2.0/agent-source/AgentBasicInformation';
+import type { string_book } from '../../../book-2.0/agent-source/string_book';
 import type { string_css_class } from '../../../types/typeAliases';
 /**
  * Props of `AvatarProfile`
@@ -10,6 +11,10 @@ export type AvatarProfileProps = {
      * Agent to be shown
      */
     readonly agent: AgentBasicInformation;
+    /**
+     * The source of the agent, which will be displayed in the BookEditor.
+     */
+    readonly agentSource: string_book;
     /**
      * Optional CSS class name which will be added to root <div> element
      */

package/esm/typings/src/book-components/AvatarProfile/AvatarProfile/AvatarProfileTooltip.d.ts

@@ -0,0 +1,15 @@
+/// <reference types="react" />
+import type { string_book } from '../../../book-2.0/agent-source/string_book';
+type AvatarProfileTooltipProps = {
+    agentSource: string_book;
+    position: {
+        top: number;
+        left: number;
+    };
+};
+/**
+ *
+ * @private internal subcomponent of `<Chat>` component
+ */
+export declare const AvatarProfileTooltip: import("react").ForwardRefExoticComponent<AvatarProfileTooltipProps & import("react").RefAttributes<HTMLDivElement>>;
+export {};

package/esm/typings/src/book-components/BookEditor/BookEditor.d.ts

@@ -1,13 +1,25 @@
 import type { CSSProperties } from 'react';
 import type { Promisable } from 'type-fest';
-import type { string_book } from '../../book-2.0/agent-source/string_book';
-import type { string_knowledge_source_content } from '../../types/typeAliases';
+import { type string_book } from '../../book-2.0/agent-source/string_book';
+import type { number_percent, number_positive, string_css_value, string_knowledge_source_content } from '../../types/typeAliases';
+/**
+ * Default height of the book editor
+ *
+ * Note: This height is computed based on the number of lines in the default book + padding multiplied by an estimated line height.
+ *
+ * @public exported from `@promptbook/components`
+ */
+export declare const DEFAULT_BOOK_EDITOR_HEIGHT: number;
 /**
  * Props of `BookEditor`
  *
  * @public exported from `@promptbook/components`
  */
 export type BookEditorProps = {
+    /**
+     * The source of the agent to be displayed in the editor.
+     */
+    readonly agentSource?: string_book;
     /**
      * Additional CSS classes to apply to the editor container.
      */
@@ -17,10 +29,21 @@ export type BookEditorProps = {
      */
     readonly style?: CSSProperties;
     /**
-     * CSS className for a font (e.g. from next/font) to style the editor text.
-     * If omitted, defaults to system serif fonts.
+     * Height of the `BookEditor` component
+     *
+     * - You can use any valid CSS value, e.g., `500px`, `100%`, `50vh`, etc.
+     * - If not set, the default height is `DEFAULT_BOOK_EDITOR_HEIGHT`.
+     * - If set to `null`, the height should be controlled entirely via `className` or `style`, otherwise the editor will have zero height.
+     *
+     * @default `DEFAULT_BOOK_EDITOR_HEIGHT`
+     */
+    readonly height?: string_css_value | null;
+    /**
+     * Zoom level of the editor
+     *
+     * @default 1 (100%)
      */
-    readonly fontClassName?: string;
+    readonly zoom?: number_percent & number_positive;
     /**
      * The book which is being edited.
      */
@@ -42,10 +65,45 @@ export type BookEditorProps = {
      */
     readonly isBorderRadiusDisabled?: boolean;
     /**
-     * If true, shows the footer with book title and version information.
-     * By default, the footer is hidden.
+     * If true, the editor is in read-only mode
+     *
+     * @default false
+     */
+    readonly isReadonly?: boolean;
+    /**
+     * Optional translations for the component
+     */
+    readonly translations?: {
+        /**
+         * Message to show when trying to edit a readonly editor
+         *
+         * @default "You cannot edit this book"
+         */
+        readonly readonlyMessage?: string;
+    };
+    /**
+     * If true, shows the download button in the action bar.
+     * By default, the download button is shown.
+     */
+    readonly isDownloadButtonShown?: boolean;
+    /**
+     * If true, shows the about button in the action bar.
+     * By default, the about button is shown.
+     */
+    readonly isAboutButtonShown?: boolean;
+    /**
+     * If defined, the editor will be synced with other editors with the same sync configuration.
      */
-    readonly isFooterShown?: boolean;
+    readonly sync?: {
+        /**
+         * The URL of the y-websocket server.
+         */
+        readonly serverUrl: string;
+        /**
+         * The name of the room to join.
+         */
+        readonly roomName: string;
+    };
 };
 /**
  * Renders a book editor

package/esm/typings/src/book-components/BookEditor/BookEditorActionbar.d.ts

@@ -0,0 +1,11 @@
+type BookEditorActionbarProps = {
+    value: string | undefined;
+    isDownloadButtonShown?: boolean;
+    isAboutButtonShown?: boolean;
+};
+/**
+ *
+ * @private Internal component used by `BookEditor`
+ */
+export declare function BookEditorActionbar(props: BookEditorActionbarProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/esm/typings/src/book-components/BookEditor/BookEditorMonaco.d.ts

@@ -0,0 +1,5 @@
+import type { BookEditorProps } from './BookEditor';
+/**
+ * @private Internal component used by `BookEditor`
+ */
+export declare function BookEditorMonaco(props: BookEditorProps): import("react/jsx-runtime").JSX.Element;

package/esm/typings/src/book-components/BookEditor/config.d.ts

@@ -3,6 +3,7 @@
  * In Next.js environments, you can override this by importing the font directly
  *
  * @public exported from `@promptbook/components`
+ * @deprecated !!! Remove
  */
 export declare const DEFAULT_BOOK_FONT_CLASS: any;
 /**

package/esm/typings/src/book-components/Chat/types/ChatParticipant.d.ts

@@ -1,5 +1,6 @@
 import type { id, string_color, string_person_fullname, string_url_image } from '../../../types/typeAliases';
 import { Color } from '../../../utils/color/Color';
+import type { string_book } from '../../../book-2.0/agent-source/string_book';
 /**
  * A participant in the chat
  *
@@ -26,6 +27,10 @@ export type ChatParticipant = {
      * Color associated with the participant
      */
     color?: string_color | Color;
+    /**
+     * Agent source for avatar profile
+     */
+    agentSource?: string_book;
 };
 /**
  * TODO: [🕛] Unite `AgentBasicInformation`, `ChatParticipant`, `LlmExecutionTools` +  `LlmToolsMetadata`

package/esm/typings/src/book-components/_common/Dropdown/Dropdown.d.ts

@@ -0,0 +1,15 @@
+import { JSX } from 'react';
+type DropdownProps = {
+    actions: Array<{
+        icon: JSX.Element;
+        name: string;
+        onClick: () => void;
+    }>;
+};
+/**
+ * @@@
+ *
+ * @private internal subcomponent used by various components
+ */
+export declare function Dropdown({ actions }: DropdownProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/esm/typings/src/book-components/_common/Modal/Modal.d.ts

@@ -0,0 +1,13 @@
+import { ReactNode } from 'react';
+/**
+ *
+ * @private internal subcomponent used by various components
+ */
+export declare function Modal({ children, onClose, className, }: {
+    children: ReactNode;
+    onClose: () => void;
+    className?: string;
+}): import("react").ReactPortal;
+/**
+ * TODO: !!!! Use this also for feedback modal in Chat component - Make modals DRY
+ */

package/esm/typings/src/book-components/_common/react-utils/classNames.d.ts

@@ -4,4 +4,4 @@ import type { string_css_class } from '../../../types/typeAliases';
  *
  * @private within the `@promptbook/components`
  */
-export declare function classNames(...classes: Array<string_css_class | undefined | false | null>): string_css_class;
+export declare function classNames(...classes: Array<string_css_class | undefined | false | null | 0>): string_css_class;

package/esm/typings/src/book-components/icons/AboutIcon.d.ts

@@ -0,0 +1,9 @@
+import { SVGProps } from 'react';
+/**
+ * @@@
+ *
+ * @private internal subcomponent used by various components
+ */
+export declare function AboutIcon(props: SVGProps<SVGSVGElement> & {
+    size?: number;
+}): import("react/jsx-runtime").JSX.Element;

package/esm/typings/src/book-components/icons/DownloadIcon.d.ts

@@ -0,0 +1,9 @@
+import { SVGProps } from 'react';
+/**
+ * @@@
+ *
+ * @private internal subcomponent used by various components
+ */
+export declare function DownloadIcon(props: SVGProps<SVGSVGElement> & {
+    size?: number;
+}): import("react/jsx-runtime").JSX.Element;

package/esm/typings/src/book-components/icons/MenuIcon.d.ts

@@ -0,0 +1,12 @@
+import { SVGProps } from 'react';
+/**
+ * @@@
+ *
+ * @private internal subcomponent used by various components
+ */
+export declare function MenuIcon(props: SVGProps<SVGSVGElement> & {
+    size?: number;
+}): import("react/jsx-runtime").JSX.Element;
+/**
+ * TODO: !!! Mark all components to not be used outside of browser
+ */

package/esm/typings/src/cli/cli-commands/_boilerplate.d.ts

@@ -1,4 +1,5 @@
 import type { Command as Program } from 'commander';
+import { $side_effect } from '../../utils/organization/$side_effect';
 /**
  * Initializes `boilerplate` command for Promptbook CLI utilities
  *
@@ -6,7 +7,7 @@ import type { Command as Program } from 'commander';
  *
  * @private internal function of `promptbookCli`
  */
-export declare function $initializeBoilerplateCommand(program: Program): void;
+export declare function $initializeBoilerplateCommand(program: Program): $side_effect;
 /**
  * Note: [💞] Ignore a discrepancy between file name and entity name
  * Note: [🟡] Code in this file should never be published outside of `@promptbook/cli`

package/esm/typings/src/cli/cli-commands/about.d.ts

@@ -1,4 +1,5 @@
 import type { Command as Program } from 'commander';
+import { $side_effect } from '../../utils/organization/$side_effect';
 /**
  * Initializes `about` command for Promptbook CLI utilities
  *
@@ -6,7 +7,7 @@ import type { Command as Program } from 'commander';
  *
  * @private internal function of `promptbookCli`
  */
-export declare function $initializeAboutCommand(program: Program): void;
+export declare function $initializeAboutCommand(program: Program): $side_effect;
 /**
  * TODO: [🗽] Unite branding and make single place for it
  * Note: [💞] Ignore a discrepancy between file name and entity name

package/esm/typings/src/cli/cli-commands/hello.d.ts

@@ -1,4 +1,5 @@
 import type { Command as Program } from 'commander';
+import { $side_effect } from '../../utils/organization/$side_effect';
 /**
  * Initializes testing `hello` command for Promptbook CLI utilities
  *
@@ -6,7 +7,7 @@ import type { Command as Program } from 'commander';
  *
  * @private internal function of `promptbookCli`
  */
-export declare function $initializeHelloCommand(program: Program): void;
+export declare function $initializeHelloCommand(program: Program): $side_effect;
 /**
  * TODO: [🧠][🐣] Make here some easter egg with generated hello greeting via LLM models
  * Note: [💞] Ignore a discrepancy between file name and entity name