@promptbook/core 0.103.0-4 → 0.103.0-40

package/umd/index.umd.js

@@ -1,8 +1,8 @@
 (function (global, factory) {
-    typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports, require('spacetrim'), require('crypto'), require('rxjs'), require('waitasecond'), require('crypto-js/enc-hex'), require('crypto-js/sha256'), require('path'), require('crypto-js'), require('mime-types'), require('papaparse'), require('moment'), require('colors')) :
-    typeof define === 'function' && define.amd ? define(['exports', 'spacetrim', 'crypto', 'rxjs', 'waitasecond', 'crypto-js/enc-hex', 'crypto-js/sha256', 'path', 'crypto-js', 'mime-types', 'papaparse', 'moment', 'colors'], factory) :
-    (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global["promptbook-core"] = {}, global.spaceTrim, global.crypto, global.rxjs, global.waitasecond, global.hexEncoder, global.sha256, global.path, global.cryptoJs, global.mimeTypes, global.papaparse, global.moment, global.colors));
-})(this, (function (exports, spaceTrim, crypto, rxjs, waitasecond, hexEncoder, sha256, path, cryptoJs, mimeTypes, papaparse, moment, colors) { 'use strict';
+    typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports, require('spacetrim'), require('crypto'), require('rxjs'), require('waitasecond'), require('crypto-js/enc-hex'), require('crypto-js/sha256'), require('path'), require('crypto-js'), require('mime-types'), require('papaparse'), require('moment'), require('colors'), require('bottleneck'), require('openai')) :
+    typeof define === 'function' && define.amd ? define(['exports', 'spacetrim', 'crypto', 'rxjs', 'waitasecond', 'crypto-js/enc-hex', 'crypto-js/sha256', 'path', 'crypto-js', 'mime-types', 'papaparse', 'moment', 'colors', 'bottleneck', 'openai'], factory) :
+    (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global["promptbook-core"] = {}, global.spaceTrim, global.crypto, global.rxjs, global.waitasecond, global.hexEncoder, global.sha256, global.path, global.cryptoJs, global.mimeTypes, global.papaparse, global.moment, global.colors, global.Bottleneck, global.OpenAI));
+})(this, (function (exports, spaceTrim, crypto, rxjs, waitasecond, hexEncoder, sha256, path, cryptoJs, mimeTypes, papaparse, moment, colors, Bottleneck, OpenAI) { 'use strict';
 
     function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e : { 'default': e }; }
 
@@ -11,6 +11,8 @@
     var sha256__default = /*#__PURE__*/_interopDefaultLegacy(sha256);
     var moment__default = /*#__PURE__*/_interopDefaultLegacy(moment);
     var colors__default = /*#__PURE__*/_interopDefaultLegacy(colors);
+    var Bottleneck__default = /*#__PURE__*/_interopDefaultLegacy(Bottleneck);
+    var OpenAI__default = /*#__PURE__*/_interopDefaultLegacy(OpenAI);
 
     // ⚠️ WARNING: This code has been generated so that any manual changes will be overwritten
     /**
@@ -26,13 +28,13 @@
      * @generated
      * @see https://github.com/webgptorg/promptbook
      */
-    const PROMPTBOOK_ENGINE_VERSION = '0.103.0-4';
+    const PROMPTBOOK_ENGINE_VERSION = '0.103.0-40';
     /**
      * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
      * Note: [💞] Ignore a discrepancy between file name and entity name
      */
 
-    var PipelineCollection = [{title:"Prepare Knowledge from Markdown",pipelineUrl:"https://promptbook.studio/promptbook/prepare-knowledge-from-markdown.book",formfactorName:"GENERIC",parameters:[{name:"knowledgeContent",description:"Markdown document content",isInput:true,isOutput:false},{name:"knowledgePieces",description:"The knowledge JSON object",isInput:false,isOutput:true}],tasks:[{taskType:"PROMPT_TASK",name:"knowledge",title:"Knowledge",content:"You are experienced data researcher, extract the important knowledge from the document.\n\n# Rules\n\n-   Make pieces of information concise, clear, and easy to understand\n-   One piece of information should be approximately 1 paragraph\n-   Divide the paragraphs by markdown horizontal lines ---\n-   Omit irrelevant information\n-   Group redundant information\n-   Write just extracted information, nothing else\n\n# The document\n\nTake information from this document:\n\n> {knowledgeContent}",resultingParameterName:"knowledgePieces",dependentParameterNames:["knowledgeContent"]}],personas:[],preparations:[],knowledgeSources:[],knowledgePieces:[],sources:[{type:"BOOK",path:null,content:"# Prepare Knowledge from Markdown\n\n-   PIPELINE URL `https://promptbook.studio/promptbook/prepare-knowledge-from-markdown.book`\n-   INPUT PARAMETER `{knowledgeContent}` Markdown document content\n-   OUTPUT PARAMETER `{knowledgePieces}` The knowledge JSON object\n\n## Knowledge\n\n<!-- TODO: [🍆] -FORMAT JSON -->\n\n```markdown\nYou are experienced data researcher, extract the important knowledge from the document.\n\n# Rules\n\n-   Make pieces of information concise, clear, and easy to understand\n-   One piece of information should be approximately 1 paragraph\n-   Divide the paragraphs by markdown horizontal lines ---\n-   Omit irrelevant information\n-   Group redundant information\n-   Write just extracted information, nothing else\n\n# The document\n\nTake information from this document:\n\n> {knowledgeContent}\n```\n\n`-> {knowledgePieces}`\n"}],sourceFile:"./books/prepare-knowledge-from-markdown.book"},{title:"Prepare Keywords",pipelineUrl:"https://promptbook.studio/promptbook/prepare-knowledge-keywords.book",formfactorName:"GENERIC",parameters:[{name:"knowledgePieceContent",description:"The content",isInput:true,isOutput:false},{name:"keywords",description:"Keywords separated by comma",isInput:false,isOutput:true}],tasks:[{taskType:"PROMPT_TASK",name:"knowledge",title:"Knowledge",content:"You are experienced data researcher, detect the important keywords in the document.\n\n# Rules\n\n-   Write just keywords separated by comma\n\n# The document\n\nTake information from this document:\n\n> {knowledgePieceContent}",resultingParameterName:"keywords",dependentParameterNames:["knowledgePieceContent"]}],personas:[],preparations:[],knowledgeSources:[],knowledgePieces:[],sources:[{type:"BOOK",path:null,content:"# Prepare Keywords\n\n-   PIPELINE URL `https://promptbook.studio/promptbook/prepare-knowledge-keywords.book`\n-   INPUT PARAMETER `{knowledgePieceContent}` The content\n-   OUTPUT PARAMETER `{keywords}` Keywords separated by comma\n\n## Knowledge\n\n<!-- TODO: [🍆] -FORMAT JSON -->\n\n```markdown\nYou are experienced data researcher, detect the important keywords in the document.\n\n# Rules\n\n-   Write just keywords separated by comma\n\n# The document\n\nTake information from this document:\n\n> {knowledgePieceContent}\n```\n\n`-> {keywords}`\n"}],sourceFile:"./books/prepare-knowledge-keywords.book"},{title:"Prepare Knowledge-piece Title",pipelineUrl:"https://promptbook.studio/promptbook/prepare-knowledge-title.book",formfactorName:"GENERIC",parameters:[{name:"knowledgePieceContent",description:"The content",isInput:true,isOutput:false},{name:"title",description:"The title of the document",isInput:false,isOutput:true}],tasks:[{taskType:"PROMPT_TASK",name:"knowledge",title:"Knowledge",content:"You are experienced content creator, write best title for the document.\n\n# Rules\n\n-   Write just title, nothing else\n-   Write maximum 5 words for the title\n\n# The document\n\n> {knowledgePieceContent}",resultingParameterName:"title",expectations:{words:{min:1,max:8}},dependentParameterNames:["knowledgePieceContent"]}],personas:[],preparations:[],knowledgeSources:[],knowledgePieces:[],sources:[{type:"BOOK",path:null,content:"# Prepare Knowledge-piece Title\n\n-   PIPELINE URL `https://promptbook.studio/promptbook/prepare-knowledge-title.book`\n-   INPUT PARAMETER `{knowledgePieceContent}` The content\n-   OUTPUT PARAMETER `{title}` The title of the document\n\n## Knowledge\n\n-   EXPECT MIN 1 WORD\n-   EXPECT MAX 8 WORDS\n\n```markdown\nYou are experienced content creator, write best title for the document.\n\n# Rules\n\n-   Write just title, nothing else\n-   Write maximum 5 words for the title\n\n# The document\n\n> {knowledgePieceContent}\n```\n\n`-> {title}`\n"}],sourceFile:"./books/prepare-knowledge-title.book"},{title:"Prepare Persona",pipelineUrl:"https://promptbook.studio/promptbook/prepare-persona.book",formfactorName:"GENERIC",parameters:[{name:"availableModels",description:"List of available model names together with their descriptions as JSON",isInput:true,isOutput:false},{name:"personaDescription",description:"Description of the persona",isInput:true,isOutput:false},{name:"modelsRequirements",description:"Specific requirements for the model",isInput:false,isOutput:true}],tasks:[{taskType:"PROMPT_TASK",name:"make-model-requirements",title:"Make modelRequirements",content:"You are an experienced AI engineer, you need to find the best models for virtual assistants:\n\n## Example\n\n```json\n[\n  {\n  \"modelName\": \"gpt-4o\",\n  \"systemMessage\": \"You are experienced AI engineer and helpful assistant.\",\n  \"temperature\": 0.7\n  },\n  {\n    \"modelName\": \"claude-3-5-sonnet\",\n    \"systemMessage\": \"You are a friendly and knowledgeable chatbot.\",\n    \"temperature\": 0.5\n  }\n]\n```\n\n## Instructions\n\n-   Your output format is JSON array\n-   Sort best-fitting models first\n-   Omit any models that are not suitable\n-   Write just the JSON, no other text should be present\n-   Array contain items with following keys:\n    -   `modelName`: The name of the model to use\n    -   `systemMessage`: The system message to provide context to the model\n    -   `temperature`: The sampling temperature to use\n\n### Key `modelName`\n\nHere are the available models:\n\n```json\n{availableModels}\n```\n\n### Key `systemMessage`\n\nThe system message is used to communicate instructions or provide context to the model at the beginning of a conversation. It is displayed in a different format compared to user messages, helping the model understand its role in the conversation. The system message typically guides the model's behavior, sets the tone, or specifies desired output from the model. By utilizing the system message effectively, users can steer the model towards generating more accurate and relevant responses.\n\nFor example:\n\n> You are an experienced AI engineer and helpful assistant.\n\n> You are a friendly and knowledgeable chatbot.\n\n### Key `temperature`\n\nThe sampling temperature, between 0 and 1. Higher values like 0.8 will make the output more random, while lower values like 0.2 will make it more focused and deterministic. If set to 0, the model will use log probability to automatically increase the temperature until certain thresholds are hit.\n\nYou can pick a value between 0 and 2. For example:\n\n-   `0.1`: Low temperature, extremely conservative and deterministic\n-   `0.5`: Medium temperature, balanced between conservative and creative\n-   `1.0`: High temperature, creative and bit random\n-   `1.5`: Very high temperature, extremely creative and often chaotic and unpredictable\n-   `2.0`: Maximum temperature, completely random and unpredictable, for some extreme creative use cases\n\n# The assistant\n\nTake this description of the persona:\n\n> {personaDescription}",resultingParameterName:"modelsRequirements",format:"JSON",dependentParameterNames:["availableModels","personaDescription"]}],personas:[],preparations:[],knowledgeSources:[],knowledgePieces:[],sources:[{type:"BOOK",path:null,content:"# Prepare Persona\n\n-   PIPELINE URL `https://promptbook.studio/promptbook/prepare-persona.book`\n-   INPUT PARAMETER `{availableModels}` List of available model names together with their descriptions as JSON\n-   INPUT PARAMETER `{personaDescription}` Description of the persona\n-   OUTPUT PARAMETER `{modelsRequirements}` Specific requirements for the model\n\n## Make modelRequirements\n\n-   FORMAT JSON\n\n```markdown\nYou are an experienced AI engineer, you need to find the best models for virtual assistants:\n\n## Example\n\n\\`\\`\\`json\n[\n  {\n  \"modelName\": \"gpt-4o\",\n  \"systemMessage\": \"You are experienced AI engineer and helpful assistant.\",\n  \"temperature\": 0.7\n  },\n  {\n    \"modelName\": \"claude-3-5-sonnet\",\n    \"systemMessage\": \"You are a friendly and knowledgeable chatbot.\",\n    \"temperature\": 0.5\n  }\n]\n\\`\\`\\`\n\n## Instructions\n\n-   Your output format is JSON array\n-   Sort best-fitting models first\n-   Omit any models that are not suitable\n-   Write just the JSON, no other text should be present\n-   Array contain items with following keys:\n    -   `modelName`: The name of the model to use\n    -   `systemMessage`: The system message to provide context to the model\n    -   `temperature`: The sampling temperature to use\n\n### Key `modelName`\n\nHere are the available models:\n\n\\`\\`\\`json\n{availableModels}\n\\`\\`\\`\n\n### Key `systemMessage`\n\nThe system message is used to communicate instructions or provide context to the model at the beginning of a conversation. It is displayed in a different format compared to user messages, helping the model understand its role in the conversation. The system message typically guides the model's behavior, sets the tone, or specifies desired output from the model. By utilizing the system message effectively, users can steer the model towards generating more accurate and relevant responses.\n\nFor example:\n\n> You are an experienced AI engineer and helpful assistant.\n\n> You are a friendly and knowledgeable chatbot.\n\n### Key `temperature`\n\nThe sampling temperature, between 0 and 1. Higher values like 0.8 will make the output more random, while lower values like 0.2 will make it more focused and deterministic. If set to 0, the model will use log probability to automatically increase the temperature until certain thresholds are hit.\n\nYou can pick a value between 0 and 2. For example:\n\n-   `0.1`: Low temperature, extremely conservative and deterministic\n-   `0.5`: Medium temperature, balanced between conservative and creative\n-   `1.0`: High temperature, creative and bit random\n-   `1.5`: Very high temperature, extremely creative and often chaotic and unpredictable\n-   `2.0`: Maximum temperature, completely random and unpredictable, for some extreme creative use cases\n\n# The assistant\n\nTake this description of the persona:\n\n> {personaDescription}\n```\n\n`-> {modelsRequirements}`\n"}],sourceFile:"./books/prepare-persona.book"},{title:"Prepare Title",pipelineUrl:"https://promptbook.studio/promptbook/prepare-title.book",formfactorName:"GENERIC",parameters:[{name:"book",description:"The book to prepare the title for",isInput:true,isOutput:false},{name:"title",description:"Best title for the book",isInput:false,isOutput:true}],tasks:[{taskType:"PROMPT_TASK",name:"make-title",title:"Make title",content:"Make best title for given text which describes the workflow:\n\n## Rules\n\n-   Write just title, nothing else\n-   Title should be concise and clear - Write maximum ideally 2 words, maximum 5 words\n-   Title starts with emoticon\n-   Title should not mention the input and output of the workflow but the main purpose of the workflow\n    _For example, not \"✍ Convert Knowledge-piece to title\" but \"✍ Title\"_\n\n## The workflow\n\n> {book}",resultingParameterName:"title",expectations:{words:{min:1,max:8},lines:{min:1,max:1}},dependentParameterNames:["book"]}],personas:[],preparations:[],knowledgeSources:[],knowledgePieces:[],sources:[{type:"BOOK",path:null,content:"# Prepare Title\n\n-   PIPELINE URL `https://promptbook.studio/promptbook/prepare-title.book`\n-   INPUT PARAMETER `{book}` The book to prepare the title for\n-   OUTPUT PARAMETER `{title}` Best title for the book\n\n## Make title\n\n-   EXPECT MIN 1 Word\n-   EXPECT MAX 8 Words\n-   EXPECT EXACTLY 1 Line\n\n```markdown\nMake best title for given text which describes the workflow:\n\n## Rules\n\n-   Write just title, nothing else\n-   Title should be concise and clear - Write maximum ideally 2 words, maximum 5 words\n-   Title starts with emoticon\n-   Title should not mention the input and output of the workflow but the main purpose of the workflow\n    _For example, not \"✍ Convert Knowledge-piece to title\" but \"✍ Title\"_\n\n## The workflow\n\n> {book}\n```\n\n`-> {title}`\n"}],sourceFile:"./books/prepare-title.book"},{title:"📊 Curriculum Audit",pipelineUrl:"https://promptbook.studio/promptbook//examples/lsvp-asistent.book",formfactorName:"GENERIC",parameters:[{name:"result",isInput:false,isOutput:true}],tasks:[{taskType:"PROMPT_TASK",name:"prompt",title:"Prompt",content:"Asistent pro LŠVP\n\nPERSONA Jsi asistent pro RVP Lyceum v rámci Národního pedagogického institutu České Republiky\nMETA IMAGE https://edulk.cz/getFile/id:475818/type:large/02%20zna%C4%8Dka%20npi.jpg\nRULE Pokud jsi nejsi jistý, napiš nevím\nKNOWLEDGE ./241129_Lyceum_final.pdf\nCONTEXT Obecně dokážeš řešit libovolné ŠVP, aktuálně řešíš {Školní vzdělávací program LYCEUM}\nRULE Z {Porovnání RVP a ŠVP - postup} je nejdůležitější fáze 3\nKNOWLEDGE {Školní vzdělávací program LYCEUM}  ./ŠVP Lyceum - Finance v digitální době.pdf\nKNOWLEDGE @Slovník\n\n**Interní slovník - RVP/ŠVP**\n\n**RVP**\n\nRámcový vzdělávací program pro obor vzdělání Lyceum je dokument na národní úrovni, který formuluje požadavky na školní vzdělávací programy ve formě především očekávaných výsledků učení, kterých mají žáci absolvováním tohoto programu na dané škole dosáhnout.\n\n**ŠVP**\n\nŠkolní vzdělávací program pro obor vzdělání Lyceum je dokument každé jednotlivé školy, který popisuje v jakých vyučovacích předmětech/ vzdělávacích modulech a v jakých ročnících budou požadované očekávané výsledky učení naplněny. Zároveň formuluje další očekávané výsledky učení, které naplňují disponibilní část vyučovacího času určeného RVP pro tento obor vzdělání.\n\n**Očekávaný výsledek učení (OVU)**\n\nVyjadřuje jednotlivý požadavek na to, co mají žáci umět na konci vzdělávacího programu, tzn. jejich požadované kompetence. Je vyjádřen formulací, která je uvozena činnostním slovesem a dále obsahuje předmět této činnosti. Formulace je konkretizována resp. doplněna zpravidla formou odrážek vymezením dílčích znalostí, dovedností, postojů, jejichž splnění je předpokladem dosažení OVU jako celku.\n\n_Příklad:_\n\n<div class=\"joplin-table-wrapper\"><table><tbody><tr><th><p><strong>Žák/žákyně řídí realizaci jednoduchého projektu</strong></p></th></tr><tr><td><ul><li>naplánuje aktivity projektu</li></ul></td></tr><tr><td><ul><li>navrhne rozpočet projektu vzhledem k navrženým aktivitám</li></ul></td></tr><tr><td><ul><li>stanoví základní ukazatele a sleduje jejich naplňování</li></ul></td></tr><tr><td><ul><li>vede projektový tým</li></ul></td></tr><tr><td><ul><li>uvede, jak by řešil krizové situace v projektu</li></ul></td></tr><tr><td><ul><li>vyhodnotí úspěšnost projektu</li></ul></td></tr></tbody></table></div>\n\n**Vzdělávací oblasti**\n\nOčekávané výsledky učení jsou v **_RVP členěny do 4 vzdělávacích oblastí_**, které tvoří společný všeobecně vzdělávací základ:\n\n- Osobnostní rozvoj, vzdělávání ke zdraví, bezpečí a produktivnímu pracovnímu životu (kariéře)\n- Komunikační a jazykové vzdělávání\n- Aplikované vzdělávání STEM (Science, Technology, Engeneering, Math), tj. přírodní vědy, informatika, technika, matematika\n- Prakticky orientované vzdělávání společenskovědní a humanitní\n\nKaždá vzdělávací oblast se dále člení na okruhy, v jejichž rámci jsou OVU samostatně číslované.\n\n<div class=\"joplin-table-wrapper\"><table><tbody><tr><th rowspan=\"21\"><ul><li>Prakticky orientované vzdělávání společenskovědní a humanitní</li></ul></th><th rowspan=\"21\"><p><strong>Člověk, ekonomie a podnikání</strong></p></th><th rowspan=\"7\"><p><strong>1</strong></p></th><th><p><strong>zpracuje podklady související s podnikáním</strong></p></th></tr><tr><td><p>připraví podnikatelský záměr</p></td></tr><tr><td><p>sestaví zakladatelský rozpočet</p></td></tr><tr><td><p>zkalkuluje cenu zboží nebo služby</p></td></tr><tr><td><p>vysvětlí na příkladu základní povinnosti podnikatele vůči státu a zaměstnancům</p></td></tr><tr><td><p>vede daňovou evidenci</p></td></tr><tr><td><p>vysvětlí na příkladech etiku v podnikání</p></td></tr><tr><td rowspan=\"7\"><p><strong>2</strong></p></td><td><p><strong>řídí realizaci jednoduchého projektu</strong></p></td></tr><tr><td><p>naplánuje aktivity projektu</p></td></tr><tr><td><p>navrhne rozpočet projektu vzhledem k navrženým aktivitám</p></td></tr><tr><td><p>stanoví základní ukazatele a sleduje jejich naplňování</p></td></tr><tr><td><p>vede projektový tým</p></td></tr><tr><td><p>uvede, jak by řešil krizové situace v projektu</p></td></tr><tr><td><p>vyhodnotí úspěšnost projektu</p></td></tr><tr><td rowspan=\"7\"><p><strong>3</strong></p></td><td><p><strong>aplikuje ekonomické teorie v osobním a profesním životě</strong></p></td></tr><tr><td><p>vysvětlí základní ekonomické otázky</p></td></tr><tr><td><p>vysvětí stanovení rovnovážné ceny na dokonalém i nedokonalém trhu</p></td></tr><tr><td><p>charakterizuje výrobní faktory a vysvětlí hranici produkčních možností a náklady obětované příležitosti</p></td></tr><tr><td><p>uvede nejdůležitější makroekonomické pojmy a vliv jejich výše na kvalitu života a podnikání v daném státě</p></td></tr><tr><td><p>vysvětlí podstatu inflace a její důsledky na finanční situaci obyvatel a na příkladu ukáže jak se bránit jejím nepříznivým důsledkům</p></td></tr><tr><td><p>uvede hlavní výhody a nevýhody mezinárodního obchodu a vliv ochranářských opatření na ekonomickou situaci dané země</p></td></tr><tr><td></td><td></td><td><p><strong>4</strong></p></td><td><p>Atd.</p></td></tr></tbody></table></div>\n\n**Vyučovací předmět / vzdělávací modul**\n\nOčekávané výsledky učení jsou v **ŠVP** členěny do vyučovacích předmětů nebo vzdělávacích modulů, které jsou dále zařazeny do jednoho nebo více ročníků 4letého studia. Vyučovací předmět / vzdělávací modul tvoří vyučovací jednotku, kde jsou očekávané výsledky učení dále rozpracovány pro potřeby výuky podle následující šablony\n\n| **A. VSTUPNÍ ČÁST** |\n| --- |\n| **1\\. Název** |\n| **2\\. Kód** (kódy by měly být navázány na obory vzdělání a výsledky učení) |\n| **2a) Kategorie vzdělání** - v případě, že nebude součástí kódu |\n| **3\\. Typ vyučovací jednotky** (modul, předmět, stáž apod.) |\n| **4\\. Délka** (počet hodin - dělitelný čtyřmi (optimální modul 16, 32 hodin = týden výuky) |\n| **5\\. Platnost** (datum, od kterého platí) |\n| **6\\. Vstupní předpoklady** (vymezení požadované úrovně vstupních vědomostí a dovedností, které jsou předpokladem úspěšného studia) |\n|     |\n| **B. JÁDRO VYUČOVACÍ JEDNOTKY** |\n| **1\\. Charakteristika** (stručná anotace popisující obecné cíle a pojetí) |\n| **2\\. Očekávané výsledky učení a jejich indikátory (převzaté z RVP nebo dále konkretizované)** |\n| **3\\. Podpora rozvoje klíčových kompetencí a základních gramotností** (které klíčové kompetence jsou v rozvíjeny) |\n| **4\\. Obsah vzdělávání** (rozpis učiva) |\n| **5\\. Vzdělávací strategie** (strategie výuky, resp. učební činnosti žáků, které jsou doporučené pro dosažení výsledků) |\n|     |\n| **C. VÝSTUPNÍ ČÁST** |\n| **1\\. Způsob ověřování dosažených výsledků** (ve vazbě na jednotlivé výsledky učení) |\n| **2\\. Kritéria hodnocení** (co znamená splnění výsledků učení, kdy je splněna celá vyučovací jednotka, kritéria pro známky, příp. procentuální, slovní hodnocení) |\n| **3\\. Doporučená studijní literatura, odkazy na ilustrační zdroje** |\n| **4\\. Poznámky** |\n\n**Soulad OVU RVP a ŠVP**\n\nTento soulad je předmětem zjišťování. Soulad nastává, jestliže jsou očekávané výsledky učení z jednotlivých vzdělávacích oblastí RVP **obsaženy** ve vyučovacích předmětech/ vzdělávacích modulech ŠVP jednotlivých škol, tzn. že v ŠVP se objevuje jejich formulace buď v doslovném nebo podobném znění v jednom nebo více vyučovacích předmětech/ vzdělávacích modulech.\n\n_Příklad souladu:_\n\nRVP ŠVP - komunikace a marketing (SŠ obchodní Č.\n\n| **2** | **řídí realizaci jednoduchého projektu** |\n| --- | --- |\n| naplánuje aktivity projektu |\n| navrhne rozpočet projektu vzhledem k navrženým aktivitám |\n| stanoví základní ukazatele a sleduje jejich naplňování |\n| vede projektový tým |\n| uvede, jak by řešil krizové situace v projektu |\n| vyhodnotí úspěšnost projektu |\n\nKNOWLEDGE  {Porovnání RVP a ŠVP - postup}\n\n\n# AUDITNÍ PROTOKOL ŠVP-RVP\n\n# (POPIS KONTROLNÍHO ALGORITMU)\n\nMetodika je určena pro **Kvantifikaci Shody** školního vzdělávacího programu (ŠVP) s Rámcovým vzdělávacím programem (RVP).\n\n## FÁZE 1: VALIDACE DOKUMENTACE\n\n**Cíl:** Ověřit platnost, aktuálnost a strukturu zdrojových dokumentů.\n\n- **RVP Verifikace:** Otevřít aktuální verzi RVP (např. RVP ZV/G/SOŠ).\n- **Typová shoda:** Ověřit, že RVP se vztahuje k danému typu školy.\n- **ŠVP Dimenze:** Identifikovat a izolovat relevantní části ŠVP: Profil absolventa, Klíčové kompetence (KK), Vzdělávací oblasti (VO), případně Učební plán (UP).\n- **Verzování:** Potvrdit, že obě verze (RVP a ŠVP) jsou nejnovější a platné (včetně dodatků RVP).\n\n## FÁZE 2: DATABÁZOVÉ MAPOVÁNÍ VÝSTUPŮ (MASTER MATICE)\n\n**Cíl:** Vytvořit systémovou databázi pro křížové porovnání všech povinných komponent RVP se ŠVP.\n\n- **Dekompozice RVP:** Rozložit RVP na základní povinné komponenty: Klíčové kompetence, Vzdělávací oblasti a obory, Očekávané výstupy (OVU), Průřezová témata (PT).\n- **Přiřazovací mapa:** Vytvořit hlavní kontrolní matici (Master Matice) pro záznam vazeb.\n\n| Oblast RVP | Výstup RVP (OVU) | Odpovídající Část ŠVP (Předmět/Ročník) | Konkrétní Tématický Celek v ŠVP | Stav Shody (Protokol) |\n| --- | --- | --- | --- | --- |\n| ... | ... | ... | ... | ... |\n| --- | --- | --- | --- | --- |\n\n## FÁZE 3: ALGORITMICKÁ KONTROLA POKRYTÍ A HLOUBKY\n\n**Cíl:** Posoudit, zda každý povinný výstup RVP je adekvátně reflektován v obsahu ŠVP, a přidělit bodovou hodnotu pro kvantifikaci.\n\n- **Audit OVU:** Projít každý jednotlivý Očekávaný výstup (OVU) z RVP.\n- **Kódování stavu a bodování:** U každého OVU v matici označit stav pokrytí dle následujícího schématu:\n\n| Kód (Protokol) | Popis (Kvalitativní zjištění) | Bodová hodnota (Kvantifikace) |\n| --- | --- | --- |\n| ✅   | Plná shoda (Výstup pokryt v plném rozsahu, odpovídající úrovni RVP) | 1,0 |\n| --- | --- | --- |\n| ⚠️  | Částečná shoda (Formální pokrytí, omezený rozsah, chybná návaznost) | 0,5 |\n| --- | --- | --- |\n| ❌   | Absence (Výstup zcela chybí v obsahu ŠVP) | 0,0 |\n| --- | --- | --- |\n\n- **Defektologie ŠVP:** Identifikovat a zaznamenat deficity ŠVP: Chybějící výstupy (❌), Sémantické překryvy, Přetížení obsahu.\n- **Kvalitativní posun:** Ověřit, zda je formulace výstupů v ŠVP **aktivní, měřitelná a v souladu** s úrovní RVP.\n\n## FÁZE 4: STRUKTURÁLNÍ VERIFIKACE NÁVAZNOSTI (VERTIKÁLA/HORIZONTÁLA)\n\n**Cíl:** Zkontrolovat logickou posloupnost a provázanost učiva v rámci ŠVP.\n\n- **Vertikální Kontrola:** Ověřit posloupnost OVU a učiva uvnitř jednoho předmětu/oblasti (postup od jednodušších ke složitějším konceptům napříč ročníky).\n- **Horizontální Kontrola:** Zkontrolovat logické provázání napříč vzdělávacími oblastmi a předměty (např. fyzika ↔ matematika).\n- **PT Integrace:** Audit reálné integrace Průřezových témat (PT) do konkrétních částí obsahu, metod a projektů.\n\n## FÁZE 5: ANALÝZA ŠKOLNÍ PROFILACE A ROZŠÍŘENÍ RVP\n\n**Cíl:** Validovat, že profilace školy je **v souladu** s RVP a nejedná se o **rozpor**.\n\n- **Nekonfliktnost:** Porovnat definovaný Profil absolventa školy s Klíčovými kompetencemi RVP. Profil ŠVP musí RVP rozvíjet, nikoli mu odporovat.\n- **Modularita:** Zkontrolovat, zda volitelné předměty a rozšiřující moduly logicky navazují na vzdělávací oblasti RVP.\n- **Implementace specializace:** Popisně uvést, jak je školní profilace (např. STEM zaměření, projektová výuka) integrována do OVU a kompetencí definovaných RVP.\n\n## FÁZE 6: GENERÁTOR ZÁVĚREČNÉ ZPRÁVY A KVANTIFIKACE\n\n**Cíl:** Syntetizovat výsledky, kvantifikovat soulad a generovat závazné návrhy na korekce.\n\n### 6.1 Kvantifikace Souladu\n\nVypočítat Index shody (IS) na základě bodového hodnocení (Fáze 3):\n\n### 6.2 Interpretace Indexu Shody (IS)\n\nKlasifikace souladu pro standardizované vyhodnocení:\n\n| Interval IS | Klasifikace souladu | Popis |\n| --- | --- | --- |\n| 95-100 % | Výborný soulad | ŠVP plně odpovídá RVP, pouze stylistické nebo formální rozdíly. |\n| --- | --- | --- |\n| 85-94 % | Dobrá shoda | ŠVP pokrývá všechny klíčové výstupy, menší korekce nutné. |\n| --- | --- | --- |\n| 70-84 % | Částečná shoda | Významné nedostatky v některých oblastech, nutná revize obsahu. |\n| --- | --- | --- |\n| < 70 % | Kritická neshoda | ŠVP neplní rámcové požadavky, ohrožuje legislativní soulad. |\n| --- | --- | --- |\n\n### 6.3 Doplňkové Indexy\n\nVypočítat následující doplňkové indexy pro detailní kvalitativní analýzu:\n\n- **Index kompetenčního souladu (IKS):** Poměr pokrytí klíčových kompetencí RVP v ŠVP.\n- **Index průřezové integrace (IPI):** Míra reálné integrace průřezových témat do výuky.\n- **Index hloubky pokrytí (IHP):** Procento výstupů, které jsou v ŠVP rozvedeny na konkrétní výukové cíle (měřitelné, aktivní formulace).\n- **Index profilové rozšiřitelnosti (IPR):** Kolik rozšiřujících nebo profilových výstupů přesahuje rámec RVP, aniž by narušily jeho strukturu.\n\n### 6.4 Vizuální výstupy\n\nZajistit generování následujících vizualizací pro Závěrečnou zprávu:\n\n- Graf pokrytí po vzdělávacích oblastech (Sloupcový graf IS pro VO).\n- Pavoukový diagram Klíčových kompetencí (RVP vs. ŠVP).\n- Mapa defektů (Vizualizace ❌ a ⚠️ výstupů).\n\n### 6.5 Struktura Závěrečné Zprávy\n\nZpráva musí být strukturována dle standardizovaného formátu:\n\n| Oddíl | Obsah |\n| --- | --- |\n| A. Identifikace | Název školy, IZO, typ školy, datum revize, zpracovatel, verze ŠVP a RVP. |\n| --- | --- |\n| B. Shrnutí výsledků | Celkový Index Shody (IS), hlavní závěry a doporučení. |\n| --- | --- |\n| C. Kvantitativní analýza | Přehled IS v % dle kategorií OVU / VO / kompetencí. |\n| --- | --- |\n| D. Kvalitativní analýza | Slovní zhodnocení kvality souladu (formulace, obtížnost, integrace PT). |\n| --- | --- |\n| E. Rizikové oblasti | Přehled nalezených defektů (chybějící OVU, přetížení, formální shoda). |\n| --- | --- |\n| F. Návrhy opatření (Korekční plán) | Přesné návrhy změn - **Co, Kde, Kdo** má upravit, včetně termínu. |\n| --- | --- |\n| G. Přílohy | Master Matice (Fáze 2-3), revizní tabulka, výstupní grafy a metriky. |\n| --- | --- |\n\n\n\n\n.",resultingParameterName:"result",dependentParameterNames:[]}],personas:[],preparations:[{id:1,promptbookVersion:"0.103.0-3",usage:{price:{value:0},input:{tokensCount:{value:0},charactersCount:{value:0},wordsCount:{value:0},sentencesCount:{value:0},linesCount:{value:0},paragraphsCount:{value:0},pagesCount:{value:0}},output:{tokensCount:{value:0},charactersCount:{value:0},wordsCount:{value:0},sentencesCount:{value:0},linesCount:{value:0},paragraphsCount:{value:0},pagesCount:{value:0}}}}],knowledgeSources:[],knowledgePieces:[],sources:[{type:"BOOK",path:null,content:"Asistent pro LŠVP\n\nPERSONA Jsi asistent pro RVP Lyceum v rámci Národního pedagogického institutu České Republiky\nMETA IMAGE https://edulk.cz/getFile/id:475818/type:large/02%20zna%C4%8Dka%20npi.jpg\nRULE Pokud jsi nejsi jistý, napiš nevím\nKNOWLEDGE ./241129_Lyceum_final.pdf\nCONTEXT Obecně dokážeš řešit libovolné ŠVP, aktuálně řešíš {Školní vzdělávací program LYCEUM}\nRULE Z {Porovnání RVP a ŠVP - postup} je nejdůležitější fáze 3\nKNOWLEDGE {Školní vzdělávací program LYCEUM}  ./ŠVP Lyceum - Finance v digitální době.pdf\nKNOWLEDGE @Slovník\n\n**Interní slovník - RVP/ŠVP**\n\n**RVP**\n\nRámcový vzdělávací program pro obor vzdělání Lyceum je dokument na národní úrovni, který formuluje požadavky na školní vzdělávací programy ve formě především očekávaných výsledků učení, kterých mají žáci absolvováním tohoto programu na dané škole dosáhnout.\n\n**ŠVP**\n\nŠkolní vzdělávací program pro obor vzdělání Lyceum je dokument každé jednotlivé školy, který popisuje v jakých vyučovacích předmětech/ vzdělávacích modulech a v jakých ročnících budou požadované očekávané výsledky učení naplněny. Zároveň formuluje další očekávané výsledky učení, které naplňují disponibilní část vyučovacího času určeného RVP pro tento obor vzdělání.\n\n**Očekávaný výsledek učení (OVU)**\n\nVyjadřuje jednotlivý požadavek na to, co mají žáci umět na konci vzdělávacího programu, tzn. jejich požadované kompetence. Je vyjádřen formulací, která je uvozena činnostním slovesem a dále obsahuje předmět této činnosti. Formulace je konkretizována resp. doplněna zpravidla formou odrážek vymezením dílčích znalostí, dovedností, postojů, jejichž splnění je předpokladem dosažení OVU jako celku.\n\n_Příklad:_\n\n<div class=\"joplin-table-wrapper\"><table><tbody><tr><th><p><strong>Žák/žákyně řídí realizaci jednoduchého projektu</strong></p></th></tr><tr><td><ul><li>naplánuje aktivity projektu</li></ul></td></tr><tr><td><ul><li>navrhne rozpočet projektu vzhledem k navrženým aktivitám</li></ul></td></tr><tr><td><ul><li>stanoví základní ukazatele a sleduje jejich naplňování</li></ul></td></tr><tr><td><ul><li>vede projektový tým</li></ul></td></tr><tr><td><ul><li>uvede, jak by řešil krizové situace v projektu</li></ul></td></tr><tr><td><ul><li>vyhodnotí úspěšnost projektu</li></ul></td></tr></tbody></table></div>\n\n**Vzdělávací oblasti**\n\nOčekávané výsledky učení jsou v **_RVP členěny do 4 vzdělávacích oblastí_**, které tvoří společný všeobecně vzdělávací základ:\n\n- Osobnostní rozvoj, vzdělávání ke zdraví, bezpečí a produktivnímu pracovnímu životu (kariéře)\n- Komunikační a jazykové vzdělávání\n- Aplikované vzdělávání STEM (Science, Technology, Engeneering, Math), tj. přírodní vědy, informatika, technika, matematika\n- Prakticky orientované vzdělávání společenskovědní a humanitní\n\nKaždá vzdělávací oblast se dále člení na okruhy, v jejichž rámci jsou OVU samostatně číslované.\n\n<div class=\"joplin-table-wrapper\"><table><tbody><tr><th rowspan=\"21\"><ul><li>Prakticky orientované vzdělávání společenskovědní a humanitní</li></ul></th><th rowspan=\"21\"><p><strong>Člověk, ekonomie a podnikání</strong></p></th><th rowspan=\"7\"><p><strong>1</strong></p></th><th><p><strong>zpracuje podklady související s podnikáním</strong></p></th></tr><tr><td><p>připraví podnikatelský záměr</p></td></tr><tr><td><p>sestaví zakladatelský rozpočet</p></td></tr><tr><td><p>zkalkuluje cenu zboží nebo služby</p></td></tr><tr><td><p>vysvětlí na příkladu základní povinnosti podnikatele vůči státu a zaměstnancům</p></td></tr><tr><td><p>vede daňovou evidenci</p></td></tr><tr><td><p>vysvětlí na příkladech etiku v podnikání</p></td></tr><tr><td rowspan=\"7\"><p><strong>2</strong></p></td><td><p><strong>řídí realizaci jednoduchého projektu</strong></p></td></tr><tr><td><p>naplánuje aktivity projektu</p></td></tr><tr><td><p>navrhne rozpočet projektu vzhledem k navrženým aktivitám</p></td></tr><tr><td><p>stanoví základní ukazatele a sleduje jejich naplňování</p></td></tr><tr><td><p>vede projektový tým</p></td></tr><tr><td><p>uvede, jak by řešil krizové situace v projektu</p></td></tr><tr><td><p>vyhodnotí úspěšnost projektu</p></td></tr><tr><td rowspan=\"7\"><p><strong>3</strong></p></td><td><p><strong>aplikuje ekonomické teorie v osobním a profesním životě</strong></p></td></tr><tr><td><p>vysvětlí základní ekonomické otázky</p></td></tr><tr><td><p>vysvětí stanovení rovnovážné ceny na dokonalém i nedokonalém trhu</p></td></tr><tr><td><p>charakterizuje výrobní faktory a vysvětlí hranici produkčních možností a náklady obětované příležitosti</p></td></tr><tr><td><p>uvede nejdůležitější makroekonomické pojmy a vliv jejich výše na kvalitu života a podnikání v daném státě</p></td></tr><tr><td><p>vysvětlí podstatu inflace a její důsledky na finanční situaci obyvatel a na příkladu ukáže jak se bránit jejím nepříznivým důsledkům</p></td></tr><tr><td><p>uvede hlavní výhody a nevýhody mezinárodního obchodu a vliv ochranářských opatření na ekonomickou situaci dané země</p></td></tr><tr><td></td><td></td><td><p><strong>4</strong></p></td><td><p>Atd.</p></td></tr></tbody></table></div>\n\n**Vyučovací předmět / vzdělávací modul**\n\nOčekávané výsledky učení jsou v **ŠVP** členěny do vyučovacích předmětů nebo vzdělávacích modulů, které jsou dále zařazeny do jednoho nebo více ročníků 4letého studia. Vyučovací předmět / vzdělávací modul tvoří vyučovací jednotku, kde jsou očekávané výsledky učení dále rozpracovány pro potřeby výuky podle následující šablony\n\n| **A. VSTUPNÍ ČÁST** |\n| --- |\n| **1\\. Název** |\n| **2\\. Kód** (kódy by měly být navázány na obory vzdělání a výsledky učení) |\n| **2a) Kategorie vzdělání** - v případě, že nebude součástí kódu |\n| **3\\. Typ vyučovací jednotky** (modul, předmět, stáž apod.) |\n| **4\\. Délka** (počet hodin - dělitelný čtyřmi (optimální modul 16, 32 hodin = týden výuky) |\n| **5\\. Platnost** (datum, od kterého platí) |\n| **6\\. Vstupní předpoklady** (vymezení požadované úrovně vstupních vědomostí a dovedností, které jsou předpokladem úspěšného studia) |\n|     |\n| **B. JÁDRO VYUČOVACÍ JEDNOTKY** |\n| **1\\. Charakteristika** (stručná anotace popisující obecné cíle a pojetí) |\n| **2\\. Očekávané výsledky učení a jejich indikátory (převzaté z RVP nebo dále konkretizované)** |\n| **3\\. Podpora rozvoje klíčových kompetencí a základních gramotností** (které klíčové kompetence jsou v rozvíjeny) |\n| **4\\. Obsah vzdělávání** (rozpis učiva) |\n| **5\\. Vzdělávací strategie** (strategie výuky, resp. učební činnosti žáků, které jsou doporučené pro dosažení výsledků) |\n|     |\n| **C. VÝSTUPNÍ ČÁST** |\n| **1\\. Způsob ověřování dosažených výsledků** (ve vazbě na jednotlivé výsledky učení) |\n| **2\\. Kritéria hodnocení** (co znamená splnění výsledků učení, kdy je splněna celá vyučovací jednotka, kritéria pro známky, příp. procentuální, slovní hodnocení) |\n| **3\\. Doporučená studijní literatura, odkazy na ilustrační zdroje** |\n| **4\\. Poznámky** |\n\n**Soulad OVU RVP a ŠVP**\n\nTento soulad je předmětem zjišťování. Soulad nastává, jestliže jsou očekávané výsledky učení z jednotlivých vzdělávacích oblastí RVP **obsaženy** ve vyučovacích předmětech/ vzdělávacích modulech ŠVP jednotlivých škol, tzn. že v ŠVP se objevuje jejich formulace buď v doslovném nebo podobném znění v jednom nebo více vyučovacích předmětech/ vzdělávacích modulech.\n\n_Příklad souladu:_\n\nRVP ŠVP - komunikace a marketing (SŠ obchodní Č.\n\n| **2** | **řídí realizaci jednoduchého projektu** |\n| --- | --- |\n| naplánuje aktivity projektu |\n| navrhne rozpočet projektu vzhledem k navrženým aktivitám |\n| stanoví základní ukazatele a sleduje jejich naplňování |\n| vede projektový tým |\n| uvede, jak by řešil krizové situace v projektu |\n| vyhodnotí úspěšnost projektu |\n\nKNOWLEDGE  {Porovnání RVP a ŠVP - postup}\n\n\n# AUDITNÍ PROTOKOL ŠVP-RVP\n\n# (POPIS KONTROLNÍHO ALGORITMU)\n\nMetodika je určena pro **Kvantifikaci Shody** školního vzdělávacího programu (ŠVP) s Rámcovým vzdělávacím programem (RVP).\n\n## FÁZE 1: VALIDACE DOKUMENTACE\n\n**Cíl:** Ověřit platnost, aktuálnost a strukturu zdrojových dokumentů.\n\n- **RVP Verifikace:** Otevřít aktuální verzi RVP (např. RVP ZV/G/SOŠ).\n- **Typová shoda:** Ověřit, že RVP se vztahuje k danému typu školy.\n- **ŠVP Dimenze:** Identifikovat a izolovat relevantní části ŠVP: Profil absolventa, Klíčové kompetence (KK), Vzdělávací oblasti (VO), případně Učební plán (UP).\n- **Verzování:** Potvrdit, že obě verze (RVP a ŠVP) jsou nejnovější a platné (včetně dodatků RVP).\n\n## FÁZE 2: DATABÁZOVÉ MAPOVÁNÍ VÝSTUPŮ (MASTER MATICE)\n\n**Cíl:** Vytvořit systémovou databázi pro křížové porovnání všech povinných komponent RVP se ŠVP.\n\n- **Dekompozice RVP:** Rozložit RVP na základní povinné komponenty: Klíčové kompetence, Vzdělávací oblasti a obory, Očekávané výstupy (OVU), Průřezová témata (PT).\n- **Přiřazovací mapa:** Vytvořit hlavní kontrolní matici (Master Matice) pro záznam vazeb.\n\n| Oblast RVP | Výstup RVP (OVU) | Odpovídající Část ŠVP (Předmět/Ročník) | Konkrétní Tématický Celek v ŠVP | Stav Shody (Protokol) |\n| --- | --- | --- | --- | --- |\n| ... | ... | ... | ... | ... |\n| --- | --- | --- | --- | --- |\n\n## FÁZE 3: ALGORITMICKÁ KONTROLA POKRYTÍ A HLOUBKY\n\n**Cíl:** Posoudit, zda každý povinný výstup RVP je adekvátně reflektován v obsahu ŠVP, a přidělit bodovou hodnotu pro kvantifikaci.\n\n- **Audit OVU:** Projít každý jednotlivý Očekávaný výstup (OVU) z RVP.\n- **Kódování stavu a bodování:** U každého OVU v matici označit stav pokrytí dle následujícího schématu:\n\n| Kód (Protokol) | Popis (Kvalitativní zjištění) | Bodová hodnota (Kvantifikace) |\n| --- | --- | --- |\n| ✅   | Plná shoda (Výstup pokryt v plném rozsahu, odpovídající úrovni RVP) | 1,0 |\n| --- | --- | --- |\n| ⚠️  | Částečná shoda (Formální pokrytí, omezený rozsah, chybná návaznost) | 0,5 |\n| --- | --- | --- |\n| ❌   | Absence (Výstup zcela chybí v obsahu ŠVP) | 0,0 |\n| --- | --- | --- |\n\n- **Defektologie ŠVP:** Identifikovat a zaznamenat deficity ŠVP: Chybějící výstupy (❌), Sémantické překryvy, Přetížení obsahu.\n- **Kvalitativní posun:** Ověřit, zda je formulace výstupů v ŠVP **aktivní, měřitelná a v souladu** s úrovní RVP.\n\n## FÁZE 4: STRUKTURÁLNÍ VERIFIKACE NÁVAZNOSTI (VERTIKÁLA/HORIZONTÁLA)\n\n**Cíl:** Zkontrolovat logickou posloupnost a provázanost učiva v rámci ŠVP.\n\n- **Vertikální Kontrola:** Ověřit posloupnost OVU a učiva uvnitř jednoho předmětu/oblasti (postup od jednodušších ke složitějším konceptům napříč ročníky).\n- **Horizontální Kontrola:** Zkontrolovat logické provázání napříč vzdělávacími oblastmi a předměty (např. fyzika ↔ matematika).\n- **PT Integrace:** Audit reálné integrace Průřezových témat (PT) do konkrétních částí obsahu, metod a projektů.\n\n## FÁZE 5: ANALÝZA ŠKOLNÍ PROFILACE A ROZŠÍŘENÍ RVP\n\n**Cíl:** Validovat, že profilace školy je **v souladu** s RVP a nejedná se o **rozpor**.\n\n- **Nekonfliktnost:** Porovnat definovaný Profil absolventa školy s Klíčovými kompetencemi RVP. Profil ŠVP musí RVP rozvíjet, nikoli mu odporovat.\n- **Modularita:** Zkontrolovat, zda volitelné předměty a rozšiřující moduly logicky navazují na vzdělávací oblasti RVP.\n- **Implementace specializace:** Popisně uvést, jak je školní profilace (např. STEM zaměření, projektová výuka) integrována do OVU a kompetencí definovaných RVP.\n\n## FÁZE 6: GENERÁTOR ZÁVĚREČNÉ ZPRÁVY A KVANTIFIKACE\n\n**Cíl:** Syntetizovat výsledky, kvantifikovat soulad a generovat závazné návrhy na korekce.\n\n### 6.1 Kvantifikace Souladu\n\nVypočítat Index shody (IS) na základě bodového hodnocení (Fáze 3):\n\n### 6.2 Interpretace Indexu Shody (IS)\n\nKlasifikace souladu pro standardizované vyhodnocení:\n\n| Interval IS | Klasifikace souladu | Popis |\n| --- | --- | --- |\n| 95-100 % | Výborný soulad | ŠVP plně odpovídá RVP, pouze stylistické nebo formální rozdíly. |\n| --- | --- | --- |\n| 85-94 % | Dobrá shoda | ŠVP pokrývá všechny klíčové výstupy, menší korekce nutné. |\n| --- | --- | --- |\n| 70-84 % | Částečná shoda | Významné nedostatky v některých oblastech, nutná revize obsahu. |\n| --- | --- | --- |\n| < 70 % | Kritická neshoda | ŠVP neplní rámcové požadavky, ohrožuje legislativní soulad. |\n| --- | --- | --- |\n\n### 6.3 Doplňkové Indexy\n\nVypočítat následující doplňkové indexy pro detailní kvalitativní analýzu:\n\n- **Index kompetenčního souladu (IKS):** Poměr pokrytí klíčových kompetencí RVP v ŠVP.\n- **Index průřezové integrace (IPI):** Míra reálné integrace průřezových témat do výuky.\n- **Index hloubky pokrytí (IHP):** Procento výstupů, které jsou v ŠVP rozvedeny na konkrétní výukové cíle (měřitelné, aktivní formulace).\n- **Index profilové rozšiřitelnosti (IPR):** Kolik rozšiřujících nebo profilových výstupů přesahuje rámec RVP, aniž by narušily jeho strukturu.\n\n### 6.4 Vizuální výstupy\n\nZajistit generování následujících vizualizací pro Závěrečnou zprávu:\n\n- Graf pokrytí po vzdělávacích oblastech (Sloupcový graf IS pro VO).\n- Pavoukový diagram Klíčových kompetencí (RVP vs. ŠVP).\n- Mapa defektů (Vizualizace ❌ a ⚠️ výstupů).\n\n### 6.5 Struktura Závěrečné Zprávy\n\nZpráva musí být strukturována dle standardizovaného formátu:\n\n| Oddíl | Obsah |\n| --- | --- |\n| A. Identifikace | Název školy, IZO, typ školy, datum revize, zpracovatel, verze ŠVP a RVP. |\n| --- | --- |\n| B. Shrnutí výsledků | Celkový Index Shody (IS), hlavní závěry a doporučení. |\n| --- | --- |\n| C. Kvantitativní analýza | Přehled IS v % dle kategorií OVU / VO / kompetencí. |\n| --- | --- |\n| D. Kvalitativní analýza | Slovní zhodnocení kvality souladu (formulace, obtížnost, integrace PT). |\n| --- | --- |\n| E. Rizikové oblasti | Přehled nalezených defektů (chybějící OVU, přetížení, formální shoda). |\n| --- | --- |\n| F. Návrhy opatření (Korekční plán) | Přesné návrhy změn - **Co, Kde, Kdo** má upravit, včetně termínu. |\n| --- | --- |\n| G. Přílohy | Master Matice (Fáze 2-3), revizní tabulka, výstupní grafy a metriky. |\n| --- | --- |\n\n\n\n\n.\n"}],sourceFile:"./books/examples/lsvp-asistent.book"}];
+    var PipelineCollection = [{title:"Prepare Knowledge from Markdown",pipelineUrl:"https://promptbook.studio/promptbook/prepare-knowledge-from-markdown.book",formfactorName:"GENERIC",parameters:[{name:"knowledgeContent",description:"Markdown document content",isInput:true,isOutput:false},{name:"knowledgePieces",description:"The knowledge JSON object",isInput:false,isOutput:true}],tasks:[{taskType:"PROMPT_TASK",name:"knowledge",title:"Knowledge",content:"You are experienced data researcher, extract the important knowledge from the document.\n\n# Rules\n\n-   Make pieces of information concise, clear, and easy to understand\n-   One piece of information should be approximately 1 paragraph\n-   Divide the paragraphs by markdown horizontal lines ---\n-   Omit irrelevant information\n-   Group redundant information\n-   Write just extracted information, nothing else\n\n# The document\n\nTake information from this document:\n\n> {knowledgeContent}",resultingParameterName:"knowledgePieces",dependentParameterNames:["knowledgeContent"]}],personas:[],preparations:[],knowledgeSources:[],knowledgePieces:[],sources:[{type:"BOOK",path:null,content:"# Prepare Knowledge from Markdown\n\n-   PIPELINE URL `https://promptbook.studio/promptbook/prepare-knowledge-from-markdown.book`\n-   INPUT PARAMETER `{knowledgeContent}` Markdown document content\n-   OUTPUT PARAMETER `{knowledgePieces}` The knowledge JSON object\n\n## Knowledge\n\n<!-- TODO: [🍆] -FORMAT JSON -->\n\n```markdown\nYou are experienced data researcher, extract the important knowledge from the document.\n\n# Rules\n\n-   Make pieces of information concise, clear, and easy to understand\n-   One piece of information should be approximately 1 paragraph\n-   Divide the paragraphs by markdown horizontal lines ---\n-   Omit irrelevant information\n-   Group redundant information\n-   Write just extracted information, nothing else\n\n# The document\n\nTake information from this document:\n\n> {knowledgeContent}\n```\n\n`-> {knowledgePieces}`\n"}],sourceFile:"./books/prepare-knowledge-from-markdown.book"},{title:"Prepare Keywords",pipelineUrl:"https://promptbook.studio/promptbook/prepare-knowledge-keywords.book",formfactorName:"GENERIC",parameters:[{name:"knowledgePieceContent",description:"The content",isInput:true,isOutput:false},{name:"keywords",description:"Keywords separated by comma",isInput:false,isOutput:true}],tasks:[{taskType:"PROMPT_TASK",name:"knowledge",title:"Knowledge",content:"You are experienced data researcher, detect the important keywords in the document.\n\n# Rules\n\n-   Write just keywords separated by comma\n\n# The document\n\nTake information from this document:\n\n> {knowledgePieceContent}",resultingParameterName:"keywords",dependentParameterNames:["knowledgePieceContent"]}],personas:[],preparations:[],knowledgeSources:[],knowledgePieces:[],sources:[{type:"BOOK",path:null,content:"# Prepare Keywords\n\n-   PIPELINE URL `https://promptbook.studio/promptbook/prepare-knowledge-keywords.book`\n-   INPUT PARAMETER `{knowledgePieceContent}` The content\n-   OUTPUT PARAMETER `{keywords}` Keywords separated by comma\n\n## Knowledge\n\n<!-- TODO: [🍆] -FORMAT JSON -->\n\n```markdown\nYou are experienced data researcher, detect the important keywords in the document.\n\n# Rules\n\n-   Write just keywords separated by comma\n\n# The document\n\nTake information from this document:\n\n> {knowledgePieceContent}\n```\n\n`-> {keywords}`\n"}],sourceFile:"./books/prepare-knowledge-keywords.book"},{title:"Prepare Knowledge-piece Title",pipelineUrl:"https://promptbook.studio/promptbook/prepare-knowledge-title.book",formfactorName:"GENERIC",parameters:[{name:"knowledgePieceContent",description:"The content",isInput:true,isOutput:false},{name:"title",description:"The title of the document",isInput:false,isOutput:true}],tasks:[{taskType:"PROMPT_TASK",name:"knowledge",title:"Knowledge",content:"You are experienced content creator, write best title for the document.\n\n# Rules\n\n-   Write just title, nothing else\n-   Write maximum 5 words for the title\n\n# The document\n\n> {knowledgePieceContent}",resultingParameterName:"title",expectations:{words:{min:1,max:8}},dependentParameterNames:["knowledgePieceContent"]}],personas:[],preparations:[],knowledgeSources:[],knowledgePieces:[],sources:[{type:"BOOK",path:null,content:"# Prepare Knowledge-piece Title\n\n-   PIPELINE URL `https://promptbook.studio/promptbook/prepare-knowledge-title.book`\n-   INPUT PARAMETER `{knowledgePieceContent}` The content\n-   OUTPUT PARAMETER `{title}` The title of the document\n\n## Knowledge\n\n-   EXPECT MIN 1 WORD\n-   EXPECT MAX 8 WORDS\n\n```markdown\nYou are experienced content creator, write best title for the document.\n\n# Rules\n\n-   Write just title, nothing else\n-   Write maximum 5 words for the title\n\n# The document\n\n> {knowledgePieceContent}\n```\n\n`-> {title}`\n"}],sourceFile:"./books/prepare-knowledge-title.book"},{title:"Prepare Persona",pipelineUrl:"https://promptbook.studio/promptbook/prepare-persona.book",formfactorName:"GENERIC",parameters:[{name:"availableModels",description:"List of available model names together with their descriptions as JSON",isInput:true,isOutput:false},{name:"personaDescription",description:"Description of the persona",isInput:true,isOutput:false},{name:"modelsRequirements",description:"Specific requirements for the model",isInput:false,isOutput:true}],tasks:[{taskType:"PROMPT_TASK",name:"make-model-requirements",title:"Make modelRequirements",content:"You are an experienced AI engineer, you need to find the best models for virtual assistants:\n\n## Example\n\n```json\n[\n  {\n  \"modelName\": \"gpt-4o\",\n  \"systemMessage\": \"You are experienced AI engineer and helpful assistant.\",\n  \"temperature\": 0.7\n  },\n  {\n    \"modelName\": \"claude-3-5-sonnet\",\n    \"systemMessage\": \"You are a friendly and knowledgeable chatbot.\",\n    \"temperature\": 0.5\n  }\n]\n```\n\n## Instructions\n\n-   Your output format is JSON array\n-   Sort best-fitting models first\n-   Omit any models that are not suitable\n-   Write just the JSON, no other text should be present\n-   Array contain items with following keys:\n    -   `modelName`: The name of the model to use\n    -   `systemMessage`: The system message to provide context to the model\n    -   `temperature`: The sampling temperature to use\n\n### Key `modelName`\n\nHere are the available models:\n\n```json\n{availableModels}\n```\n\n### Key `systemMessage`\n\nThe system message is used to communicate instructions or provide context to the model at the beginning of a conversation. It is displayed in a different format compared to user messages, helping the model understand its role in the conversation. The system message typically guides the model's behavior, sets the tone, or specifies desired output from the model. By utilizing the system message effectively, users can steer the model towards generating more accurate and relevant responses.\n\nFor example:\n\n> You are an experienced AI engineer and helpful assistant.\n\n> You are a friendly and knowledgeable chatbot.\n\n### Key `temperature`\n\nThe sampling temperature, between 0 and 1. Higher values like 0.8 will make the output more random, while lower values like 0.2 will make it more focused and deterministic. If set to 0, the model will use log probability to automatically increase the temperature until certain thresholds are hit.\n\nYou can pick a value between 0 and 2. For example:\n\n-   `0.1`: Low temperature, extremely conservative and deterministic\n-   `0.5`: Medium temperature, balanced between conservative and creative\n-   `1.0`: High temperature, creative and bit random\n-   `1.5`: Very high temperature, extremely creative and often chaotic and unpredictable\n-   `2.0`: Maximum temperature, completely random and unpredictable, for some extreme creative use cases\n\n# The assistant\n\nTake this description of the persona:\n\n> {personaDescription}",resultingParameterName:"modelsRequirements",format:"JSON",dependentParameterNames:["availableModels","personaDescription"]}],personas:[],preparations:[],knowledgeSources:[],knowledgePieces:[],sources:[{type:"BOOK",path:null,content:"# Prepare Persona\n\n-   PIPELINE URL `https://promptbook.studio/promptbook/prepare-persona.book`\n-   INPUT PARAMETER `{availableModels}` List of available model names together with their descriptions as JSON\n-   INPUT PARAMETER `{personaDescription}` Description of the persona\n-   OUTPUT PARAMETER `{modelsRequirements}` Specific requirements for the model\n\n## Make modelRequirements\n\n-   FORMAT JSON\n\n```markdown\nYou are an experienced AI engineer, you need to find the best models for virtual assistants:\n\n## Example\n\n\\`\\`\\`json\n[\n  {\n  \"modelName\": \"gpt-4o\",\n  \"systemMessage\": \"You are experienced AI engineer and helpful assistant.\",\n  \"temperature\": 0.7\n  },\n  {\n    \"modelName\": \"claude-3-5-sonnet\",\n    \"systemMessage\": \"You are a friendly and knowledgeable chatbot.\",\n    \"temperature\": 0.5\n  }\n]\n\\`\\`\\`\n\n## Instructions\n\n-   Your output format is JSON array\n-   Sort best-fitting models first\n-   Omit any models that are not suitable\n-   Write just the JSON, no other text should be present\n-   Array contain items with following keys:\n    -   `modelName`: The name of the model to use\n    -   `systemMessage`: The system message to provide context to the model\n    -   `temperature`: The sampling temperature to use\n\n### Key `modelName`\n\nHere are the available models:\n\n\\`\\`\\`json\n{availableModels}\n\\`\\`\\`\n\n### Key `systemMessage`\n\nThe system message is used to communicate instructions or provide context to the model at the beginning of a conversation. It is displayed in a different format compared to user messages, helping the model understand its role in the conversation. The system message typically guides the model's behavior, sets the tone, or specifies desired output from the model. By utilizing the system message effectively, users can steer the model towards generating more accurate and relevant responses.\n\nFor example:\n\n> You are an experienced AI engineer and helpful assistant.\n\n> You are a friendly and knowledgeable chatbot.\n\n### Key `temperature`\n\nThe sampling temperature, between 0 and 1. Higher values like 0.8 will make the output more random, while lower values like 0.2 will make it more focused and deterministic. If set to 0, the model will use log probability to automatically increase the temperature until certain thresholds are hit.\n\nYou can pick a value between 0 and 2. For example:\n\n-   `0.1`: Low temperature, extremely conservative and deterministic\n-   `0.5`: Medium temperature, balanced between conservative and creative\n-   `1.0`: High temperature, creative and bit random\n-   `1.5`: Very high temperature, extremely creative and often chaotic and unpredictable\n-   `2.0`: Maximum temperature, completely random and unpredictable, for some extreme creative use cases\n\n# The assistant\n\nTake this description of the persona:\n\n> {personaDescription}\n```\n\n`-> {modelsRequirements}`\n"}],sourceFile:"./books/prepare-persona.book"},{title:"Prepare Title",pipelineUrl:"https://promptbook.studio/promptbook/prepare-title.book",formfactorName:"GENERIC",parameters:[{name:"book",description:"The book to prepare the title for",isInput:true,isOutput:false},{name:"title",description:"Best title for the book",isInput:false,isOutput:true}],tasks:[{taskType:"PROMPT_TASK",name:"make-title",title:"Make title",content:"Make best title for given text which describes the workflow:\n\n## Rules\n\n-   Write just title, nothing else\n-   Title should be concise and clear - Write maximum ideally 2 words, maximum 5 words\n-   Title starts with emoticon\n-   Title should not mention the input and output of the workflow but the main purpose of the workflow\n    _For example, not \"✍ Convert Knowledge-piece to title\" but \"✍ Title\"_\n\n## The workflow\n\n> {book}",resultingParameterName:"title",expectations:{words:{min:1,max:8},lines:{min:1,max:1}},dependentParameterNames:["book"]}],personas:[],preparations:[],knowledgeSources:[],knowledgePieces:[],sources:[{type:"BOOK",path:null,content:"# Prepare Title\n\n-   PIPELINE URL `https://promptbook.studio/promptbook/prepare-title.book`\n-   INPUT PARAMETER `{book}` The book to prepare the title for\n-   OUTPUT PARAMETER `{title}` Best title for the book\n\n## Make title\n\n-   EXPECT MIN 1 Word\n-   EXPECT MAX 8 Words\n-   EXPECT EXACTLY 1 Line\n\n```markdown\nMake best title for given text which describes the workflow:\n\n## Rules\n\n-   Write just title, nothing else\n-   Title should be concise and clear - Write maximum ideally 2 words, maximum 5 words\n-   Title starts with emoticon\n-   Title should not mention the input and output of the workflow but the main purpose of the workflow\n    _For example, not \"✍ Convert Knowledge-piece to title\" but \"✍ Title\"_\n\n## The workflow\n\n> {book}\n```\n\n`-> {title}`\n"}],sourceFile:"./books/prepare-title.book"}];
 
     /**
      * Checks if value is valid email
@@ -1134,15 +1136,30 @@
      * @public exported from `@promptbook/core`
      */
     const PROMPTBOOK_COLOR = Color.fromHex('#79EAFD');
-    // <- TODO: [🧠] Using `Color` here increases the package size approx 3kb, maybe remove it
+    // <- TODO: [🧠][🈵] Using `Color` here increases the package size approx 3kb, maybe remove it
     /**
-     * Dark color of the Promptbook
+     * Colors for syntax highlighting in the `<BookEditor/>`
+     *
+     * TODO: [🗽] Unite branding and make single place for it
+     *
+     * @public exported from `@promptbook/core`
+     */
+    const PROMPTBOOK_SYNTAX_COLORS = {
+        TITLE: Color.fromHex('#244EA8'),
+        LINE: Color.fromHex('#eeeeee'),
+        COMMITMENT: Color.fromHex('#DA0F78'),
+        PARAMETER: Color.fromHex('#8e44ad'),
+    };
+    // <- TODO: [🧠][🈵] Using `Color` here increases the package size approx 3kb, maybe remove it
+    /**
+     * Chat color of the Promptbook (in chat)
      *
      * TODO: [🗽] Unite branding and make single place for it
      *
      * @public exported from `@promptbook/core`
      */
     const PROMPTBOOK_CHAT_COLOR = PROMPTBOOK_COLOR.then(lighten(0.1)).then(saturate(0.9)).then(grayscale(0.9));
+    // <- TODO: [🧠][🈵] Using `Color` and `lighten`, `saturate`,... here increases the package size approx 3kb, maybe remove it
     /**
      * Color of the user (in chat)
      *
@@ -1151,6 +1168,7 @@
      * @public exported from `@promptbook/core`
      */
     const USER_CHAT_COLOR = Color.fromHex('#1D4ED8');
+    // <- TODO: [🧠][🈵] Using `Color` here increases the package size approx 3kb, maybe remove it
     /**
      * When the title is not provided, the default title is used
      *
@@ -1231,6 +1249,13 @@
      * @public exported from `@promptbook/utils`
      */
     const SMALL_NUMBER = 0.001;
+    // <- TODO: [⏳] Standardize timeouts, Make DEFAULT_TIMEOUT_MS as global constant
+    /**
+     * How many times to retry the connections
+     *
+     * @private within the repository - too low-level in comparison with other `MAX_...`
+     */
+    const CONNECTION_RETRIES_LIMIT = 5;
     /**
      * Short time interval to prevent race conditions in milliseconds
      *
@@ -1286,6 +1311,14 @@
      */
     const DEFAULT_BOOKS_DIRNAME = './books';
     // <- TODO: [🕝] Make also `BOOKS_DIRNAME_ALTERNATIVES`
+    /**
+     * Where to store your agents (also book files)
+     * This is kind of a "src" for your books
+     *
+     * @public exported from `@promptbook/core`
+     */
+    const DEFAULT_AGENTS_DIRNAME = './agents';
+    // <- TODO: [🕝] Make also `AGENTS_DIRNAME_ALTERNATIVES`
     // TODO: Just `.promptbook` in config, hardcode subfolders like `download-cache` or `execution-cache`
     /**
      * Where to store the temporary downloads
@@ -1333,7 +1366,7 @@
     ex-port const WIZARD_APP_ID: string_app_id = 'wizard';
     */
     /**
-     * The name of the builded pipeline collection made by CLI `ptbk make` and for lookup in `createCollectionFromDirectory`
+     * The name of the builded pipeline collection made by CLI `ptbk make` and for lookup in `createPipelineCollectionFromDirectory`
      *
      * @public exported from `@promptbook/core`
      */
@@ -2068,6 +2101,12 @@
      * @private within the repository
      */
     const REPLACING_NONCE = 'ptbkauk42kV2dzao34faw7FudQUHYPtW';
+    /**
+     * Nonce which is used as string which is not occurring in normal text
+     *
+     * @private within the repository
+     */
+    const SALT_NONCE = 'ptbkghhewbvruets21t54et5';
     /**
      * Placeholder value indicating a parameter is missing its value.
      *
@@ -2567,7 +2606,7 @@
      * Library of pipelines that groups together pipelines for an application.
      * This implementation is a very thin wrapper around the Array / Map of pipelines.
      *
-     * @private internal function of `createCollectionFromJson`, use `createCollectionFromJson` instead
+     * @private internal function of `createPipelineCollectionFromJson`, use `createPipelineCollectionFromJson` instead
      * @see https://github.com/webgptorg/pipeline#pipeline-collection
      */
     class SimplePipelineCollection {
@@ -2577,7 +2616,7 @@
          * @param pipelines Array of pipeline JSON objects to include in the collection
          *
          * Note: During the construction logic of all pipelines are validated
-         * Note: It is not recommended to use this constructor directly, use `createCollectionFromJson` *(or other variant)* instead
+         * Note: It is not recommended to use this constructor directly, use `createPipelineCollectionFromJson` *(or other variant)* instead
          */
         constructor(...pipelines) {
             this.collection = new Map();
@@ -2665,16 +2704,16 @@
     }
 
     /**
-     * Creates PipelineCollection from array of PipelineJson or PipelineString
+     * Creates `PipelineCollection` from array of PipelineJson or PipelineString
      *
-     * Note: Functions `collectionToJson` and `createCollectionFromJson` are complementary
+     * Note: Functions `pipelineCollectionToJson` and `createPipelineCollectionFromJson` are complementary
      * Note: Syntax, parsing, and logic consistency checks are performed on all sources during build
      *
      * @param promptbookSources
      * @returns PipelineCollection
      * @public exported from `@promptbook/core`
      */
-    function createCollectionFromJson(...promptbooks) {
+    function createPipelineCollectionFromJson(...promptbooks) {
         return new SimplePipelineCollection(...promptbooks);
     }
 
@@ -2847,6 +2886,19 @@
         }
     }
 
+    /**
+     * This error indicates that promptbook operation is not allowed
+     *
+     * @public exported from `@promptbook/core`
+     */
+    class NotAllowed extends Error {
+        constructor(message) {
+            super(message);
+            this.name = 'NotAllowed';
+            Object.setPrototypeOf(this, NotAllowed.prototype);
+        }
+    }
+
     /**
      * This error type indicates that some part of the code is not implemented yet
      *
@@ -2941,6 +2993,7 @@
         PromptbookFetchError,
         UnexpectedError,
         WrappedError,
+        NotAllowed,
         // TODO: [🪑]> VersionMismatchError,
     };
     /**
@@ -3156,6 +3209,7 @@
         let updatedAt = createdAt;
         const errors = [];
         const warnings = [];
+        const llmCalls = [];
         let currentValue = {};
         let customTldr = null;
         const partialResultSubject = new rxjs.Subject();
@@ -3171,6 +3225,9 @@
         }, (tldrInfo) => {
             customTldr = tldrInfo;
             updatedAt = new Date();
+        }, (llmCall) => {
+            llmCalls.push(llmCall);
+            updatedAt = new Date();
         });
         finalResultPromise
             .catch((error) => {
@@ -3293,7 +3350,7 @@
                 }
                 return {
                     percent: percent,
-                    message,
+                    message: message + ' (!!!fallback)',
                 };
             },
             get createdAt() {
@@ -3316,6 +3373,10 @@
                 return warnings;
                 // <- Note: [1] --||--
             },
+            get llmCalls() {
+                return [...llmCalls, { foo: '!!! bar' }];
+                // <- Note: [1] --||--
+            },
             get currentValue() {
                 return currentValue;
                 // <- Note: [1] --||--
@@ -4933,7 +4994,7 @@
         let title = pipeline.title;
         if (title === undefined || title === '' || title === DEFAULT_BOOK_TITLE) {
             // TODO: [🌼] In future use `ptbk make` and made getPipelineCollection
-            const collection = createCollectionFromJson(...PipelineCollection);
+            const collection = createPipelineCollectionFromJson(...PipelineCollection);
             const prepareTitleExecutor = createPipelineExecutor({
                 pipeline: await collection.getPipelineByUrl('https://promptbook.studio/promptbook/prepare-title.book'),
                 tools,
@@ -5716,6 +5777,18 @@
         return replacedTemplates;
     }
 
+    /**
+     * Logs an LLM call with the given report.
+     *
+     * @private internal utility of `createPipelineExecutor`
+     */
+    function logLlmCall(logLlmCall, report) {
+        logLlmCall({
+            modelName: 'model' /* <- TODO: How to get model name from the report */,
+            report,
+        });
+    }
+
     /**
      * Extracts all code blocks from markdown.
      *
@@ -5862,10 +5935,13 @@
      * @public exported from `@promptbook/utils`
      */
     function countLines(text) {
+        if (text === '') {
+            return 0;
+        }
         text = text.replace('\r\n', '\n');
         text = text.replace('\r', '\n');
         const lines = text.split('\n');
-        return lines.reduce((count, line) => count + Math.ceil(line.length / CHARACTERS_PER_STANDARD_LINE), 0);
+        return lines.reduce((count, line) => count + Math.max(Math.ceil(line.length / CHARACTERS_PER_STANDARD_LINE), 1), 0);
     }
     /**
      * TODO: [🥴] Implement counting in formats - like JSON, CSV, XML,...
@@ -6080,7 +6156,7 @@
      */
     async function executeAttempts(options) {
         const { jokerParameterNames, priority, maxAttempts, // <- Note: [💂]
-        preparedContent, parameters, task, preparedPipeline, tools, $executionReport, pipelineIdentification, maxExecutionAttempts, onProgress, } = options;
+        preparedContent, parameters, task, preparedPipeline, tools, $executionReport, pipelineIdentification, maxExecutionAttempts, onProgress, logLlmCall: logLlmCall$1, } = options;
         const $ongoingTaskResult = {
             $result: null,
             $resultString: null,
@@ -6328,14 +6404,10 @@
                 });
             }
             finally {
-                if (!isJokerAttempt &&
-                    task.taskType === 'PROMPT_TASK' &&
-                    $ongoingTaskResult.$prompt
-                //    <- Note:  [2] When some expected parameter is not defined, error will occur in templateParameters
-                //              In that case we don’t want to make a report about it because it’s not a llm execution error
-                ) {
-                    // TODO: [🧠] Maybe put other taskTypes into report
-                    $executionReport.promptExecutions.push({
+                if (!isJokerAttempt && task.taskType === 'PROMPT_TASK' && $ongoingTaskResult.$prompt) {
+                    // Note:  [2] When some expected parameter is not defined, error will occur in templateParameters
+                    //        In that case we don’t want to make a report about it because it’s not a llm execution error
+                    const executionPromptReport = {
                         prompt: {
                             ...$ongoingTaskResult.$prompt,
                             // <- TODO: [🧠] How to pick everyhing except `pipelineUrl`
@@ -6344,7 +6416,11 @@
                         error: $ongoingTaskResult.$expectError === null
                             ? undefined
                             : serializeError($ongoingTaskResult.$expectError),
-                    });
+                    };
+                    $executionReport.promptExecutions.push(executionPromptReport);
+                    if (logLlmCall$1) {
+                        logLlmCall(logLlmCall$1, executionPromptReport);
+                    }
                 }
             }
             if ($ongoingTaskResult.$expectError !== null && attemptIndex === maxAttempts - 1) {
@@ -6409,9 +6485,9 @@
      * @private internal utility of `createPipelineExecutor`
      */
     async function executeFormatSubvalues(options) {
-        const { task, jokerParameterNames, parameters, priority, csvSettings, onProgress, pipelineIdentification } = options;
+        const { task, jokerParameterNames, parameters, priority, csvSettings, onProgress, logLlmCall, pipelineIdentification, } = options;
         if (task.foreach === undefined) {
-            return /* not await */ executeAttempts(options);
+            return /* not await */ executeAttempts({ ...options, logLlmCall });
         }
         if (jokerParameterNames.length !== 0) {
             throw new UnexpectedError(spaceTrim__default["default"]((block) => `
@@ -6712,7 +6788,7 @@
      * @private internal utility of `createPipelineExecutor`
      */
     async function executeTask(options) {
-        const { currentTask, preparedPipeline, parametersToPass, tools, onProgress, $executionReport, pipelineIdentification, maxExecutionAttempts, maxParallelCount, csvSettings, isVerbose, rootDirname, cacheDirname, intermediateFilesStrategy, isAutoInstalled, isNotPreparedWarningSuppressed, } = options;
+        const { currentTask, preparedPipeline, parametersToPass, tools, onProgress, logLlmCall, $executionReport, pipelineIdentification, maxExecutionAttempts, maxParallelCount, csvSettings, isVerbose, rootDirname, cacheDirname, intermediateFilesStrategy, isAutoInstalled, isNotPreparedWarningSuppressed, } = options;
         const priority = preparedPipeline.tasks.length - preparedPipeline.tasks.indexOf(currentTask);
         // Note: Check consistency of used and dependent parameters which was also done in `validatePipeline`, but it’s good to doublecheck
         const usedParameterNames = extractParameterNamesFromTask(currentTask);
@@ -6791,6 +6867,7 @@
             tools,
             $executionReport,
             onProgress,
+            logLlmCall,
             pipelineIdentification,
             maxExecutionAttempts,
             maxParallelCount,
@@ -6834,6 +6911,29 @@
                 $warnings.push(new PipelineExecutionError(spaceTrim.spaceTrim((block) => `
                             Parameter \`{${parameter.name}}\` should be an output parameter, but it was not generated during pipeline execution
 
+                            Note: This is a warning which happened after the pipeline was executed, and \`{${parameter.name}}\` was not for some reason defined in output parameters
+
+                            All parameters:
+                            ${block(preparedPipeline.parameters
+                .map(({ name, isInput, isOutput, description }) => {
+                let line = `\`{${name}}\``;
+                if (isInput) {
+                    line += ' `[input parameter]`';
+                }
+                if (isOutput) {
+                    line += ' `[output parameter]`';
+                }
+                if (parametersToPass[name] === undefined) {
+                    line += ` <- Warning: Should be in the output but its not |`;
+                }
+                if (description) {
+                    line += ` ${description}`;
+                }
+                return line;
+            })
+                .map((line, index) => `${index + 1}) ${line}`)
+                .join('\n'))}
+
                             ${block(pipelineIdentification)}
                         `)));
                 continue;
@@ -6854,7 +6954,7 @@
      * @private internal utility of `createPipelineExecutor`
      */
     async function executePipeline(options) {
-        const { inputParameters, tools, onProgress, pipeline, setPreparedPipeline, pipelineIdentification, maxParallelCount, rootDirname, isVerbose, } = options;
+        const { inputParameters, tools, onProgress, logLlmCall, pipeline, setPreparedPipeline, pipelineIdentification, maxParallelCount, rootDirname, isVerbose, } = options;
         let { preparedPipeline } = options;
         if (preparedPipeline === undefined) {
             preparedPipeline = await preparePipeline(pipeline, tools, {
@@ -7032,6 +7132,7 @@
                                 onProgress(newOngoingResult);
                             }
                         },
+                        logLlmCall,
                         $executionReport: executionReport,
                         pipelineIdentification: spaceTrim.spaceTrim((block) => `
                             ${block(pipelineIdentification)}
@@ -7155,7 +7256,7 @@
             // <- TODO: [🏮] Some standard way how to transform errors into warnings and how to handle non-critical fails during the tasks
         }
         let runCount = 0;
-        const pipelineExecutorWithCallback = async (inputParameters, onProgress) => {
+        const pipelineExecutorWithCallback = async (inputParameters, onProgress, logLlmCall) => {
             runCount++;
             return /* not await */ executePipeline({
                 pipeline,
@@ -7166,6 +7267,7 @@
                 inputParameters,
                 tools,
                 onProgress,
+                logLlmCall,
                 pipelineIdentification: spaceTrim.spaceTrim((block) => `
                     ${block(pipelineIdentification)}
                     ${runCount === 1 ? '' : `Run #${runCount}`}
@@ -7281,7 +7383,7 @@
             throw new MissingToolsError('LLM tools are required for preparing persona');
         }
         // TODO: [🌼] In future use `ptbk make` and made getPipelineCollection
-        const collection = createCollectionFromJson(...PipelineCollection);
+        const collection = createPipelineCollectionFromJson(...PipelineCollection);
         const preparePersonaExecutor = createPipelineExecutor({
             pipeline: await collection.getPipelineByUrl('https://promptbook.studio/promptbook/prepare-persona.book'),
             tools,
@@ -7347,7 +7449,8 @@
     function createEmptyAgentModelRequirements() {
         return {
             systemMessage: '',
-            modelName: 'gpt-5',
+            // modelName: 'gpt-5',
+            modelName: 'gemini-2.5-flash-lite',
             temperature: 0.7,
             topP: 0.9,
             topK: 50,
@@ -9765,6 +9868,46 @@
         return mcpServers;
     }
 
+    /**
+     *  Number of padding lines to add at the end of the book content
+     *
+     * @public exported from `@promptbook/core`
+     */
+    const PADDING_LINES = 11;
+    /**
+     * A function that adds padding to the book content
+     *
+     * @public exported from `@promptbook/core`
+     */
+    function padBook(content) {
+        if (!content) {
+            return '\n'.repeat(PADDING_LINES);
+        }
+        const lines = content.split('\n');
+        let trailingEmptyLines = 0;
+        for (let i = lines.length - 1; i >= 0; i--) {
+            const line = lines[i];
+            if (line === undefined) {
+                // Note: This should not happen in reality, but it's here to satisfy TypeScript's noUncheckedIndexedAccess option
+                continue;
+            }
+            if (line.trim() === '') {
+                trailingEmptyLines++;
+            }
+            else {
+                break;
+            }
+        }
+        if (trailingEmptyLines >= PADDING_LINES) {
+            return content;
+        }
+        const linesToAdd = PADDING_LINES - trailingEmptyLines;
+        return (content + '\n'.repeat(linesToAdd));
+    }
+    /**
+     * TODO: [🧠] Maybe export
+     */
+
     /**
      * Type guard to check if a string is a valid agent source
      *
@@ -9792,49 +9935,38 @@
      *
      * @public exported from `@promptbook/core`
      */
-    const DEFAULT_BOOK = validateBook(spaceTrim__default["default"](`
-        AI Avatar
+    const DEFAULT_BOOK = padBook(validateBook(spaceTrim__default["default"](`
+            AI Avatar
 
-        PERSONA A friendly AI assistant that helps you with your tasks
-    `));
+            PERSONA A friendly AI assistant that helps you with your tasks
+        `)));
+    // <- Note: Not using book`...` notation to avoid strange error in jest unit tests `TypeError: (0 , book_notation_1.book) is not a function`
+    // <- TODO: !!! GENESIS_BOOK
+    //                  <- !!! Buttons into genesis book
+    // <- TODO: !!! createBookBoilerplate and deprecate `DEFAULT_BOOK`
 
     /**
-     * Converts PipelineCollection to serialized JSON
-     *
-     * Note: Functions `collectionToJson` and `createCollectionFromJson` are complementary
+     * Constructs `PipelineCollection` from async sources
      *
-     * @public exported from `@promptbook/core`
-     */
-    async function collectionToJson(collection) {
-        const pipelineUrls = await collection.listPipelines();
-        const promptbooks = await Promise.all(pipelineUrls.map((url) => collection.getPipelineByUrl(url)));
-        return promptbooks;
-    }
-    /**
-     * TODO: [🧠] Maybe clear `sourceFile` or clear when exposing through API or remote server
-     */
-
-    /**
-     * Constructs Promptbook from async sources
      * It can be one of the following:
      * - Promise of array of PipelineJson or PipelineString
      * - Factory function that returns Promise of array of PipelineJson or PipelineString
      *
      * Note: This is useful as internal tool for other constructor functions like
-     *       `createCollectionFromUrl` or `createCollectionFromDirectory`
+     *       `createPipelineCollectionFromUrl` or `createPipelineCollectionFromDirectory`
      *       Consider using those functions instead of this one
      *
      * Note: The function does NOT return promise it returns the collection directly which waits for the sources to be resolved
      *       when error occurs in given promise or factory function, it is thrown during `listPipelines` or `getPipelineByUrl` call
      *
-     * Note: Consider using  `createCollectionFromDirectory` or `createCollectionFromUrl`
+     * Note: Consider using  `createPipelineCollectionFromDirectory` or `createPipelineCollectionFromUrl`
      *
      * @param promptbookSourcesPromiseOrFactory
      * @returns PipelineCollection
      * @deprecated Do not use, it will became internal tool for other constructor functions
      * @public exported from `@promptbook/core`
      */
-    function createCollectionFromPromise(promptbookSourcesPromiseOrFactory) {
+    function createPipelineCollectionFromPromise(promptbookSourcesPromiseOrFactory) {
         let collection = null;
         async function load() {
             if (collection !== null) {
@@ -9845,7 +9977,7 @@
                 promptbookSourcesPromiseOrFactory = promptbookSourcesPromiseOrFactory();
             }
             const promptbookSources = await promptbookSourcesPromiseOrFactory;
-            collection = createCollectionFromJson(...promptbookSources);
+            collection = createPipelineCollectionFromJson(...promptbookSources);
         }
         async function listPipelines() {
             await load();
@@ -9871,9 +10003,9 @@
      * @returns PipelineCollection
      * @public exported from `@promptbook/core`
      */
-    async function createCollectionFromUrl(url, options) {
+    async function createPipelineCollectionFromUrl(url, options) {
         const { isVerbose = exports.DEFAULT_IS_VERBOSE, isLazyLoaded = false } = options || {};
-        const collection = createCollectionFromPromise(async () => {
+        const collection = createPipelineCollectionFromPromise(async () => {
             if (isVerbose) {
                 console.info(`Creating pipeline collection from url ${url.toString()}`);
             }
@@ -9886,14 +10018,14 @@
         // TODO: [main] !!3 [🏳‍🌈] Allow variant with .json .js and .ts files
         // TODO: [🧠][🏳‍🌈] .js and .ts files should create getter function of the collection
         // TODO: Look at WebGPT "📖 Make Promptbook collection" and https://webgpt.cz/_books.json
-        // TODO: Implement via createCollectionFromPromise
+        // TODO: Implement via createPipelineCollectionFromPromise
     }
     /**
      * TODO: [main] !!4 [🧠] Library precompilation and do not mix markdown and json promptbooks
      */
 
     /**
-     * Creates PipelineCollection as a subset of another PipelineCollection
+     * Creates `PipelineCollection` as a subset of another `PipelineCollection`
      *
      * Note: You can use any type of collection as a parent collection - local, remote, etc.
      * Note: This is just a thin wrapper / proxy around the parent collection
@@ -9902,7 +10034,7 @@
      * @returns PipelineCollection
      * @public exported from `@promptbook/core`
      */
-    function createSubcollection(collection, predicate) {
+    function createPipelineSubcollection(collection, predicate) {
         async function listPipelines() {
             let promptbooks = await collection.listPipelines();
             promptbooks = promptbooks.filter(predicate);
@@ -9936,6 +10068,22 @@
         };
     }
 
+    /**
+     * Converts PipelineCollection to serialized JSON
+     *
+     * Note: Functions `pipelineCollectionToJson` and `createPipelineCollectionFromJson` are complementary
+     *
+     * @public exported from `@promptbook/core`
+     */
+    async function pipelineCollectionToJson(collection) {
+        const pipelineUrls = await collection.listPipelines();
+        const promptbooks = await Promise.all(pipelineUrls.map((url) => collection.getPipelineByUrl(url)));
+        return promptbooks;
+    }
+    /**
+     * TODO: [🧠] Maybe clear `sourceFile` or clear when exposing through API or remote server
+     */
+
     /**
      * All available task types
      *
@@ -12691,6 +12839,7 @@
         if (!isFlatPipeline(pipelineString)) {
             return pipelineString;
         }
+        pipelineString = spaceTrim__default["default"](pipelineString);
         const pipelineStringLines = pipelineString.split('\n');
         const potentialReturnStatement = pipelineStringLines.pop();
         let returnStatement;
@@ -12725,7 +12874,7 @@
                 ${returnStatement}
             `));
         // <- TODO: Maybe use book` notation
-        return pipelineString;
+        return padBook(pipelineString);
     }
     /**
      * TODO: Unit test
@@ -14198,10 +14347,10 @@
             var _a, _b;
             const isMetadataAviailable = $llmToolsMetadataRegister
                 .list()
-                .find(({ packageName, className }) => metadata.packageName === packageName && metadata.className === className);
+                .some(({ packageName, className }) => metadata.packageName === packageName && metadata.className === className);
             const isInstalled = $llmToolsRegister
                 .list()
-                .find(({ packageName, className }) => metadata.packageName === packageName && metadata.className === className);
+                .some(({ packageName, className }) => metadata.packageName === packageName && metadata.className === className);
             const isFullyConfigured = ((_a = metadata.envVariables) === null || _a === void 0 ? void 0 : _a.every((envVariableName) => env[envVariableName] !== undefined)) || false;
             const isPartiallyConfigured = ((_b = metadata.envVariables) === null || _b === void 0 ? void 0 : _b.some((envVariableName) => env[envVariableName] !== undefined)) || false;
             // <- Note: [🗨]
@@ -14618,6 +14767,98 @@
      * TODO: [👷‍♂️] @@@ Manual about construction of llmTools
      */
 
+    /**
+     * Restricts an Updatable to a (2) BehaviorSubject variant
+     *
+     * @see Updatable
+     * @private internal utility <- TODO: [🧠] Maybe export from `@promptbook/types`
+     */
+    function asUpdatableSubject(value) {
+        if (value instanceof rxjs.BehaviorSubject) {
+            return value;
+        }
+        else if (Array.isArray(value)) {
+            if (value.length !== 2) {
+                throw new TypeError('`asUpdatableSubject`: Invalid tuple length, expected 2 elements');
+            }
+            if (typeof value[1] !== 'function') {
+                throw new TypeError('`asUpdatableSubject`: Invalid tuple, expected second element to be a function');
+            }
+            const [theValue, setValue] = value;
+            const subject = new rxjs.BehaviorSubject(theValue);
+            subject.subscribe((newValue) => {
+                setValue(newValue);
+            });
+            return subject;
+        }
+        else {
+            return new rxjs.BehaviorSubject(value);
+        }
+    }
+    /**
+     * TODO: [🧠] Maybe `BehaviorSubject` is too heavy for this use case, maybe just tuple `[value,setValue]` is enough
+     */
+
+    /**
+     * Represents one AI Agent
+     *
+     * Note: [🦖] There are several different things in Promptbook:
+     * - `Agent` - which represents an AI Agent with its source, memories, actions, etc. Agent is a higher-level abstraction which is internally using:
+     * - `LlmExecutionTools` - which wraps one or more LLM models and provides an interface to execute them
+     * - `AgentLlmExecutionTools` - which is a specific implementation of `LlmExecutionTools` that wraps another LlmExecutionTools and applies agent-specific system prompts and requirements
+     * - `OpenAiAssistantExecutionTools` - which is a specific implementation of `LlmExecutionTools` for OpenAI models with assistant capabilities, recommended for usage in `Agent` or `AgentLlmExecutionTools`
+     *
+     * @public exported from `@promptbook/core`
+     */
+    class Agent {
+        /**
+         * Not used in Agent, always returns empty array
+         */
+        get parameters() {
+            return [
+            /* [😰] */
+            ];
+        }
+        constructor(options) {
+            this.options = options;
+            /**
+             * Name of the agent
+             */
+            this.agentName = null;
+            /**
+             * Description of the agent
+             */
+            this.personaDescription = null;
+            /**
+             * Metadata like image or color
+             */
+            this.meta = {};
+            this.agentSource = asUpdatableSubject(options.agentSource);
+            this.agentSource.subscribe((source) => {
+                const { agentName, personaDescription, meta } = parseAgentSource(source);
+                this.agentName = agentName;
+                this.personaDescription = personaDescription;
+                this.meta = { ...this.meta, ...meta };
+            });
+        }
+        /**
+         * Creates LlmExecutionTools which exposes the agent as a model
+         */
+        getLlmExecutionTools() {
+            const llmTools = new AgentLlmExecutionTools({
+                llmTools: getSingleLlmExecutionTools(this.options.executionTools.llm),
+                agentSource: this.agentSource.value, // <- TODO: !!!! Allow to pass BehaviorSubject<string_book> OR refresh llmExecutionTools.callChat on agentSource change
+            });
+            // TODO: !!!! Add `Agent` simple "mocked" learning by appending to agent source
+            // TODO: !!!! Add `Agent` learning by promptbookAgent
+            return llmTools;
+        }
+    }
+    /**
+     * TODO: [🧠][😰]Agent is not working with the parameters, should it be?
+     * TODO: !!! Agent on remote server
+     */
+
     /**
      * Change ellipsis character to three dots `…` -> `...`
      *
@@ -14758,126 +14999,1864 @@
      */
 
     /**
-     * Execution Tools for calling LLM models with a predefined agent "soul"
-     * This wraps underlying LLM execution tools and applies agent-specific system prompts and requirements
+     * Helper of usage compute
      *
-     * @public exported from `@promptbook/core`
+     * @param content the content of prompt or response
+     * @returns part of UsageCounts
+     *
+     * @private internal utility of LlmExecutionTools
      */
-    class AgentLlmExecutionTools {
-        /**
-         * Creates new AgentLlmExecutionTools
-         *
-         * @param llmTools The underlying LLM execution tools to wrap
-         * @param agentSource The agent source string that defines the agent's behavior
-         */
-        constructor(llmTools, agentSource) {
-            this.llmTools = llmTools;
-            this.agentSource = agentSource;
-            /**
-             * Cached model requirements to avoid re-parsing the agent source
-             */
-            this._cachedModelRequirements = null;
-            /**
-             * Cached parsed agent information
-             */
-            this._cachedAgentInfo = null;
-        }
-        /**
-         * Get cached or parse agent information
-         */
-        getAgentInfo() {
-            if (this._cachedAgentInfo === null) {
-                this._cachedAgentInfo = parseAgentSource(this.agentSource);
-            }
-            return this._cachedAgentInfo;
-        }
-        /**
-         * Get cached or create agent model requirements
-         */
-        async getAgentModelRequirements() {
-            if (this._cachedModelRequirements === null) {
-                // Get available models from underlying LLM tools for best model selection
-                const availableModels = await this.llmTools.listModels();
-                this._cachedModelRequirements = await createAgentModelRequirements(this.agentSource, undefined, // Let the function pick the best model
-                availableModels);
-            }
-            return this._cachedModelRequirements;
-        }
-        get title() {
-            const agentInfo = this.getAgentInfo();
-            return (agentInfo.agentName || 'Agent');
-        }
-        get description() {
-            const agentInfo = this.getAgentInfo();
-            return agentInfo.personaDescription || 'AI Agent with predefined personality and behavior';
-        }
-        get profile() {
-            const agentInfo = this.getAgentInfo();
-            if (!agentInfo.agentName) {
-                return undefined;
-            }
-            return {
-                name: agentInfo.agentName.toUpperCase().replace(/\s+/g, '_'),
-                fullname: agentInfo.agentName,
-                color: agentInfo.meta.color || '#6366f1',
-                avatarSrc: agentInfo.meta.image,
-            };
-        }
-        checkConfiguration() {
-            // Check underlying tools configuration
-            return this.llmTools.checkConfiguration();
+    function computeUsageCounts(content) {
+        return {
+            charactersCount: { value: countCharacters(content) },
+            wordsCount: { value: countWords(content) },
+            sentencesCount: { value: countSentences(content) },
+            linesCount: { value: countLines(content) },
+            paragraphsCount: { value: countParagraphs(content) },
+            pagesCount: { value: countPages(content) },
+        };
+    }
+
+    /**
+     * Make UncertainNumber
+     *
+     * @param value value of the uncertain number, if `NaN` or `undefined`, it will be set to 0 and `isUncertain=true`
+     * @param isUncertain if `true`, the value is uncertain, otherwise depends on the value
+     *
+     * @private utility for initializating UncertainNumber
+     */
+    function uncertainNumber(value, isUncertain) {
+        if (value === null || value === undefined || Number.isNaN(value)) {
+            return UNCERTAIN_ZERO_VALUE;
         }
-        /**
-         * Returns a virtual model name representing the agent behavior
-         */
-        get modelName() {
-            const hash = cryptoJs.SHA256(hexEncoder__default["default"].parse(this.agentSource))
-                //    <- TODO: [🥬] Encapsulate sha256 to some private utility function
-                .toString( /* hex */);
-            //    <- TODO: [🥬] Make some system for hashes and ids of promptbook
-            const agentId = hash.substring(0, 10);
-            //                    <- TODO: [🥬] Make some system for hashes and ids of promptbook
-            return (normalizeToKebabCase(this.title) + '-' + agentId);
+        if (isUncertain === true) {
+            return { value, isUncertain };
         }
-        listModels() {
-            return [
-                {
-                    modelName: this.modelName,
-                    modelVariant: 'CHAT',
-                    modelTitle: `${this.title} (Agent Chat Default)`,
-                    modelDescription: `Chat model with agent behavior: ${this.description}`,
+        return { value };
+    }
+
+    /**
+     * Create price per one token based on the string value found on openai page
+     *
+     * @private within the repository, used only as internal helper for `OPENAI_MODELS`
+     */
+    function pricing(value) {
+        const [price, tokens] = value.split(' / ');
+        return parseFloat(price.replace('$', '')) / parseFloat(tokens.replace('M tokens', '')) / 1000000;
+    }
+
+    /**
+     * List of available OpenAI models with pricing
+     *
+     * Note: Synced with official API docs at 2025-08-20
+     *
+     * @see https://platform.openai.com/docs/models/
+     * @see https://openai.com/api/pricing/
+     * @public exported from `@promptbook/openai`
+     */
+    const OPENAI_MODELS = exportJson({
+        name: 'OPENAI_MODELS',
+        value: [
+            /**/
+            {
+                modelVariant: 'CHAT',
+                modelTitle: 'gpt-5',
+                modelName: 'gpt-5',
+                modelDescription: "OpenAI's most advanced language model with unprecedented reasoning capabilities and 200K context window. Features revolutionary improvements in complex problem-solving, scientific reasoning, and creative tasks. Demonstrates human-level performance across diverse domains with enhanced safety measures and alignment. Represents the next generation of AI with superior understanding, nuanced responses, and advanced multimodal capabilities.",
+                pricing: {
+                    prompt: pricing(`$1.25 / 1M tokens`),
+                    output: pricing(`$10.00 / 1M tokens`),
                 },
-                // <- Note: We only list a single "virtual" agent model here as this wrapper only supports chat prompts
-            ];
-        }
-        /**
-         * Calls the chat model with agent-specific system prompt and requirements
-         */
-        async callChatModel(prompt) {
-            if (!this.llmTools.callChatModel) {
-                throw new Error('Underlying LLM execution tools do not support chat model calls');
-            }
-            // Ensure we're working with a chat prompt
+            },
+            /**/
+            /**/
+            {
+                modelVariant: 'CHAT',
+                modelTitle: 'gpt-5-mini',
+                modelName: 'gpt-5-mini',
+                modelDescription: 'A faster, cost-efficient version of GPT-5 for well-defined tasks with 200K context window. Maintains core GPT-5 capabilities while offering 5x faster inference and significantly lower costs. Features enhanced instruction following and reduced latency for production applications requiring quick responses with high quality.',
+                pricing: {
+                    prompt: pricing(`$0.25 / 1M tokens`),
+                    output: pricing(`$2.00 / 1M tokens`),
+                },
+            },
+            /**/
+            /**/
+            {
+                modelVariant: 'CHAT',
+                modelTitle: 'gpt-5-nano',
+                modelName: 'gpt-5-nano',
+                modelDescription: 'The fastest, most cost-efficient version of GPT-5 with 200K context window. Optimized for summarization, classification, and simple reasoning tasks. Features 10x faster inference than base GPT-5 while maintaining good quality for straightforward applications. Ideal for high-volume, cost-sensitive deployments.',
+                pricing: {
+                    prompt: pricing(`$0.05 / 1M tokens`),
+                    output: pricing(`$0.40 / 1M tokens`),
+                },
+            },
+            /**/
+            /**/
+            {
+                modelVariant: 'CHAT',
+                modelTitle: 'gpt-4.1',
+                modelName: 'gpt-4.1',
+                modelDescription: 'Smartest non-reasoning model with 128K context window. Enhanced version of GPT-4 with improved instruction following, better factual accuracy, and reduced hallucinations. Features advanced function calling capabilities and superior performance on coding tasks. Ideal for applications requiring high intelligence without reasoning overhead.',
+                pricing: {
+                    prompt: pricing(`$3.00 / 1M tokens`),
+                    output: pricing(`$12.00 / 1M tokens`),
+                },
+            },
+            /**/
+            /**/
+            {
+                modelVariant: 'CHAT',
+                modelTitle: 'gpt-4.1-mini',
+                modelName: 'gpt-4.1-mini',
+                modelDescription: 'Smaller, faster version of GPT-4.1 with 128K context window. Balances intelligence and efficiency with 3x faster inference than base GPT-4.1. Maintains strong capabilities across text generation, reasoning, and coding while offering better cost-performance ratio for most applications.',
+                pricing: {
+                    prompt: pricing(`$0.80 / 1M tokens`),
+                    output: pricing(`$3.20 / 1M tokens`),
+                },
+            },
+            /**/
+            /**/
+            {
+                modelVariant: 'CHAT',
+                modelTitle: 'gpt-4.1-nano',
+                modelName: 'gpt-4.1-nano',
+                modelDescription: 'Fastest, most cost-efficient version of GPT-4.1 with 128K context window. Optimized for high-throughput applications requiring good quality at minimal cost. Features 5x faster inference than GPT-4.1 while maintaining adequate performance for most general-purpose tasks.',
+                pricing: {
+                    prompt: pricing(`$0.20 / 1M tokens`),
+                    output: pricing(`$0.80 / 1M tokens`),
+                },
+            },
+            /**/
+            /**/
+            {
+                modelVariant: 'CHAT',
+                modelTitle: 'o3',
+                modelName: 'o3',
+                modelDescription: 'Advanced reasoning model with 128K context window specializing in complex logical, mathematical, and analytical tasks. Successor to o1 with enhanced step-by-step problem-solving capabilities and superior performance on STEM-focused problems. Ideal for professional applications requiring deep analytical thinking and precise reasoning.',
+                pricing: {
+                    prompt: pricing(`$15.00 / 1M tokens`),
+                    output: pricing(`$60.00 / 1M tokens`),
+                },
+            },
+            /**/
+            /**/
+            {
+                modelVariant: 'CHAT',
+                modelTitle: 'o3-pro',
+                modelName: 'o3-pro',
+                modelDescription: 'Enhanced version of o3 with more compute allocated for better responses on the most challenging problems. Features extended reasoning time and improved accuracy on complex analytical tasks. Designed for applications where maximum reasoning quality is more important than response speed.',
+                pricing: {
+                    prompt: pricing(`$30.00 / 1M tokens`),
+                    output: pricing(`$120.00 / 1M tokens`),
+                },
+            },
+            /**/
+            /**/
+            {
+                modelVariant: 'CHAT',
+                modelTitle: 'o4-mini',
+                modelName: 'o4-mini',
+                modelDescription: 'Fast, cost-efficient reasoning model with 128K context window. Successor to o1-mini with improved analytical capabilities while maintaining speed advantages. Features enhanced mathematical reasoning and logical problem-solving at significantly lower cost than full reasoning models.',
+                pricing: {
+                    prompt: pricing(`$4.00 / 1M tokens`),
+                    output: pricing(`$16.00 / 1M tokens`),
+                },
+            },
+            /**/
+            /**/
+            {
+                modelVariant: 'CHAT',
+                modelTitle: 'o3-deep-research',
+                modelName: 'o3-deep-research',
+                modelDescription: 'Most powerful deep research model with 128K context window. Specialized for comprehensive research tasks, literature analysis, and complex information synthesis. Features advanced citation capabilities and enhanced factual accuracy for academic and professional research applications.',
+                pricing: {
+                    prompt: pricing(`$25.00 / 1M tokens`),
+                    output: pricing(`$100.00 / 1M tokens`),
+                },
+            },
+            /**/
+            /**/
+            {
+                modelVariant: 'CHAT',
+                modelTitle: 'o4-mini-deep-research',
+                modelName: 'o4-mini-deep-research',
+                modelDescription: 'Faster, more affordable deep research model with 128K context window. Balances research capabilities with cost efficiency, offering good performance on literature review, fact-checking, and information synthesis tasks at a more accessible price point.',
+                pricing: {
+                    prompt: pricing(`$12.00 / 1M tokens`),
+                    output: pricing(`$48.00 / 1M tokens`),
+                },
+            },
+            /**/
+            /*/
+              {
+                  modelTitle: 'dall-e-3',
+                  modelName: 'dall-e-3',
+              },
+              /**/
+            /*/
+              {
+                  modelTitle: 'whisper-1',
+                  modelName: 'whisper-1',
+              },
+            /**/
+            /**/
+            {
+                modelVariant: 'COMPLETION',
+                modelTitle: 'davinci-002',
+                modelName: 'davinci-002',
+                modelDescription: 'Legacy completion model with 4K token context window. Excels at complex text generation, creative writing, and detailed content creation with strong contextual understanding. Optimized for instructions requiring nuanced outputs and extended reasoning. Suitable for applications needing high-quality text generation without conversation management.',
+                pricing: {
+                    prompt: pricing(`$2.00 / 1M tokens`),
+                    output: pricing(`$2.00 / 1M tokens`),
+                },
+            },
+            /**/
+            /*/
+          {
+              modelTitle: 'dall-e-2',
+              modelName: 'dall-e-2',
+          },
+          /**/
+            /**/
+            {
+                modelVariant: 'CHAT',
+                modelTitle: 'gpt-3.5-turbo-16k',
+                modelName: 'gpt-3.5-turbo-16k',
+                modelDescription: 'Extended context GPT-3.5 Turbo with 16K token window. Maintains core capabilities of standard 3.5 Turbo while supporting longer conversations and documents. Features good balance of performance and cost for applications requiring more context than standard 4K models. Effective for document analysis, extended conversations, and multi-step reasoning tasks.',
+                pricing: {
+                    prompt: pricing(`$3.00 / 1M tokens`),
+                    output: pricing(`$4.00 / 1M tokens`),
+                },
+            },
+            /**/
+            /*/
+          {
+              modelTitle: 'tts-1-hd-1106',
+              modelName: 'tts-1-hd-1106',
+          },
+          /**/
+            /*/
+          {
+              modelTitle: 'tts-1-hd',
+              modelName: 'tts-1-hd',
+          },
+          /**/
+            /**/
+            {
+                modelVariant: 'CHAT',
+                modelTitle: 'gpt-4',
+                modelName: 'gpt-4',
+                modelDescription: 'Powerful language model with 8K context window featuring sophisticated reasoning, instruction-following, and knowledge capabilities. Demonstrates strong performance on complex tasks requiring deep understanding and multi-step reasoning. Excels at code generation, logical analysis, and nuanced content creation. Suitable for advanced applications requiring high-quality outputs.',
+                pricing: {
+                    prompt: pricing(`$30.00 / 1M tokens`),
+                    output: pricing(`$60.00 / 1M tokens`),
+                },
+            },
+            /**/
+            /**/
+            {
+                modelVariant: 'CHAT',
+                modelTitle: 'gpt-4-32k',
+                modelName: 'gpt-4-32k',
+                modelDescription: 'Extended context version of GPT-4 with 32K token window. Maintains all capabilities of standard GPT-4 while supporting analysis of very lengthy documents, code bases, and conversations. Features enhanced ability to maintain context over long interactions and process detailed information from large inputs. Ideal for document analysis, legal review, and complex problem-solving.',
+                pricing: {
+                    prompt: pricing(`$60.00 / 1M tokens`),
+                    output: pricing(`$120.00 / 1M tokens`),
+                },
+            },
+            /**/
+            /*/
+            {
+                modelVariant: 'CHAT',
+                modelTitle: 'gpt-4-0613',
+                modelName: 'gpt-4-0613',
+                pricing: {
+                    prompt: computeUsage(` / 1M tokens`),
+                    output: computeUsage(` / 1M tokens`),
+                },
+            },
+            /**/
+            /**/
+            {
+                modelVariant: 'CHAT',
+                modelTitle: 'gpt-4-turbo-2024-04-09',
+                modelName: 'gpt-4-turbo-2024-04-09',
+                modelDescription: 'Latest stable GPT-4 Turbo from April 2024 with 128K context window. Features enhanced reasoning chains, improved factual accuracy with 40% reduction in hallucinations, and better instruction following compared to earlier versions. Includes advanced function calling capabilities and knowledge up to April 2024. Provides optimal performance for enterprise applications requiring reliability.',
+                pricing: {
+                    prompt: pricing(`$10.00 / 1M tokens`),
+                    output: pricing(`$30.00 / 1M tokens`),
+                },
+            },
+            /**/
+            /**/
+            {
+                modelVariant: 'CHAT',
+                modelTitle: 'gpt-3.5-turbo-1106',
+                modelName: 'gpt-3.5-turbo-1106',
+                modelDescription: 'November 2023 version of GPT-3.5 Turbo with 16K token context window. Features improved instruction following, more consistent output formatting, and enhanced function calling capabilities. Includes knowledge cutoff from April 2023. Suitable for applications requiring good performance at lower cost than GPT-4 models.',
+                pricing: {
+                    prompt: pricing(`$1.00 / 1M tokens`),
+                    output: pricing(`$2.00 / 1M tokens`),
+                },
+            },
+            /**/
+            /**/
+            {
+                modelVariant: 'CHAT',
+                modelTitle: 'gpt-4-turbo',
+                modelName: 'gpt-4-turbo',
+                modelDescription: 'More capable and cost-efficient version of GPT-4 with 128K token context window. Features improved instruction following, advanced function calling capabilities, and better performance on coding tasks. Maintains superior reasoning and knowledge while offering substantial cost reduction compared to base GPT-4. Ideal for complex applications requiring extensive context processing.',
+                pricing: {
+                    prompt: pricing(`$10.00 / 1M tokens`),
+                    output: pricing(`$30.00 / 1M tokens`),
+                },
+            },
+            /**/
+            /**/
+            {
+                modelVariant: 'COMPLETION',
+                modelTitle: 'gpt-3.5-turbo-instruct-0914',
+                modelName: 'gpt-3.5-turbo-instruct-0914',
+                modelDescription: 'September 2023 version of GPT-3.5 Turbo Instruct with 4K context window. Optimized for completion-style instruction following with deterministic responses. Better suited than chat models for applications requiring specific formatted outputs without conversation management. Knowledge cutoff from September 2021.',
+                pricing: {
+                    prompt: pricing(`$1.50  / 1M tokens`),
+                    output: pricing(`$2.00 / 1M tokens`),
+                },
+            },
+            /**/
+            /**/
+            {
+                modelVariant: 'COMPLETION',
+                modelTitle: 'gpt-3.5-turbo-instruct',
+                modelName: 'gpt-3.5-turbo-instruct',
+                modelDescription: 'Optimized version of GPT-3.5 for completion-style API with 4K token context window. Features strong instruction following with single-turn design rather than multi-turn conversation. Provides more consistent, deterministic outputs compared to chat models. Well-suited for templated content generation and structured text transformation tasks.',
+                pricing: {
+                    prompt: pricing(`$1.50  / 1M tokens`),
+                    output: pricing(`$2.00 / 1M tokens`),
+                },
+            },
+            /**/
+            /*/
+          {
+              modelTitle: 'tts-1',
+              modelName: 'tts-1',
+          },
+          /**/
+            /**/
+            {
+                modelVariant: 'CHAT',
+                modelTitle: 'gpt-3.5-turbo',
+                modelName: 'gpt-3.5-turbo',
+                modelDescription: 'Latest version of GPT-3.5 Turbo with 4K token default context window (16K available). Features continually improved performance with enhanced instruction following and reduced hallucinations. Offers excellent balance between capability and cost efficiency. Suitable for most general-purpose applications requiring good AI capabilities at reasonable cost.',
+                pricing: {
+                    prompt: pricing(`$0.50 / 1M tokens`),
+                    output: pricing(`$1.50 / 1M tokens`),
+                },
+            },
+            /**/
+            /**/
+            {
+                modelVariant: 'CHAT',
+                modelTitle: 'gpt-3.5-turbo-0301',
+                modelName: 'gpt-3.5-turbo-0301',
+                modelDescription: 'March 2023 version of GPT-3.5 Turbo with 4K token context window. Legacy model maintained for backward compatibility with specific application behaviors. Features solid conversational abilities and basic instruction following. Knowledge cutoff from September 2021. Suitable for applications explicitly designed for this version.',
+                pricing: {
+                    prompt: pricing(`$1.50 / 1M tokens`),
+                    output: pricing(`$2.00 / 1M tokens`),
+                },
+            },
+            /**/
+            /**/
+            {
+                modelVariant: 'COMPLETION',
+                modelTitle: 'babbage-002',
+                modelName: 'babbage-002',
+                modelDescription: 'Efficient legacy completion model with 4K context window balancing performance and speed. Features moderate reasoning capabilities with focus on straightforward text generation tasks. Significantly more efficient than davinci models while maintaining adequate quality for many applications. Suitable for high-volume, cost-sensitive text generation needs.',
+                pricing: {
+                    prompt: pricing(`$0.40 / 1M tokens`),
+                    output: pricing(`$0.40 / 1M tokens`),
+                },
+            },
+            /**/
+            /**/
+            {
+                modelVariant: 'CHAT',
+                modelTitle: 'gpt-4-1106-preview',
+                modelName: 'gpt-4-1106-preview',
+                modelDescription: 'November 2023 preview version of GPT-4 Turbo with 128K token context window. Features improved instruction following, better function calling capabilities, and enhanced reasoning. Includes knowledge cutoff from April 2023. Suitable for complex applications requiring extensive document understanding and sophisticated interactions.',
+                pricing: {
+                    prompt: pricing(`$10.00 / 1M tokens`),
+                    output: pricing(`$30.00 / 1M tokens`),
+                },
+            },
+            /**/
+            /**/
+            {
+                modelVariant: 'CHAT',
+                modelTitle: 'gpt-4-0125-preview',
+                modelName: 'gpt-4-0125-preview',
+                modelDescription: 'January 2024 preview version of GPT-4 Turbo with 128K token context window. Features improved reasoning capabilities, enhanced tool use, and more reliable function calling. Includes knowledge cutoff from October 2023. Offers better performance on complex logical tasks and more consistent outputs than previous preview versions.',
+                pricing: {
+                    prompt: pricing(`$10.00 / 1M tokens`),
+                    output: pricing(`$30.00 / 1M tokens`),
+                },
+            },
+            /**/
+            /*/
+          {
+              modelTitle: 'tts-1-1106',
+              modelName: 'tts-1-1106',
+          },
+          /**/
+            /**/
+            {
+                modelVariant: 'CHAT',
+                modelTitle: 'gpt-3.5-turbo-0125',
+                modelName: 'gpt-3.5-turbo-0125',
+                modelDescription: 'January 2024 version of GPT-3.5 Turbo with 16K token context window. Features improved reasoning capabilities, better instruction adherence, and reduced hallucinations compared to previous versions. Includes knowledge cutoff from September 2021. Provides good performance for most general applications at reasonable cost.',
+                pricing: {
+                    prompt: pricing(`$0.50 / 1M tokens`),
+                    output: pricing(`$1.50  / 1M tokens`),
+                },
+            },
+            /**/
+            /**/
+            {
+                modelVariant: 'CHAT',
+                modelTitle: 'gpt-4-turbo-preview',
+                modelName: 'gpt-4-turbo-preview',
+                modelDescription: 'Preview version of GPT-4 Turbo with 128K token context window that points to the latest development model. Features cutting-edge improvements to instruction following, knowledge representation, and tool use capabilities. Provides access to newest features but may have occasional behavior changes. Best for non-critical applications wanting latest capabilities.',
+                pricing: {
+                    prompt: pricing(`$10.00 / 1M tokens`),
+                    output: pricing(`$30.00 / 1M tokens`),
+                },
+            },
+            /**/
+            /**/
+            {
+                modelVariant: 'EMBEDDING',
+                modelTitle: 'text-embedding-3-large',
+                modelName: 'text-embedding-3-large',
+                modelDescription: "OpenAI's most capable text embedding model generating 3072-dimensional vectors. Designed for high-quality embeddings for complex similarity tasks, clustering, and information retrieval. Features enhanced cross-lingual capabilities and significantly improved performance on retrieval and classification benchmarks. Ideal for sophisticated RAG systems and semantic search applications.",
+                pricing: {
+                    prompt: pricing(`$0.13 / 1M tokens`),
+                    output: 0,
+                },
+            },
+            /**/
+            /**/
+            {
+                modelVariant: 'EMBEDDING',
+                modelTitle: 'text-embedding-3-small',
+                modelName: 'text-embedding-3-small',
+                modelDescription: 'Cost-effective embedding model generating 1536-dimensional vectors. Balances quality and efficiency for simpler tasks while maintaining good performance on text similarity and retrieval applications. Offers 20% better quality than ada-002 at significantly lower cost. Ideal for production embedding applications with cost constraints.',
+                pricing: {
+                    prompt: pricing(`$0.02 / 1M tokens`),
+                    output: 0,
+                },
+            },
+            /**/
+            /**/
+            {
+                modelVariant: 'CHAT',
+                modelTitle: 'gpt-3.5-turbo-0613',
+                modelName: 'gpt-3.5-turbo-0613',
+                modelDescription: "June 2023 version of GPT-3.5 Turbo with 4K token context window. Features function calling capabilities for structured data extraction and API interaction. Includes knowledge cutoff from September 2021. Maintained for applications specifically designed for this version's behaviors and capabilities.",
+                pricing: {
+                    prompt: pricing(`$1.50 / 1M tokens`),
+                    output: pricing(`$2.00 / 1M tokens`),
+                },
+            },
+            /**/
+            /**/
+            {
+                modelVariant: 'EMBEDDING',
+                modelTitle: 'text-embedding-ada-002',
+                modelName: 'text-embedding-ada-002',
+                modelDescription: 'Legacy text embedding model generating 1536-dimensional vectors suitable for text similarity and retrieval applications. Processes up to 8K tokens per request with consistent embedding quality. While superseded by newer embedding-3 models, still maintains adequate performance for many semantic search and classification tasks.',
+                pricing: {
+                    prompt: pricing(`$0.1 / 1M tokens`),
+                    output: 0,
+                },
+            },
+            /**/
+            /*/
+          {
+              modelVariant: 'CHAT',
+              modelTitle: 'gpt-4-1106-vision-preview',
+              modelName: 'gpt-4-1106-vision-preview',
+          },
+          /**/
+            /*/
+          {
+              modelVariant: 'CHAT',
+              modelTitle: 'gpt-4-vision-preview',
+              modelName: 'gpt-4-vision-preview',
+              pricing: {
+                  prompt: computeUsage(`$10.00 / 1M tokens`),
+                  output: computeUsage(`$30.00 / 1M tokens`),
+              },
+          },
+          /**/
+            /**/
+            {
+                modelVariant: 'CHAT',
+                modelTitle: 'gpt-4o-2024-05-13',
+                modelName: 'gpt-4o-2024-05-13',
+                modelDescription: 'May 2024 version of GPT-4o with 128K context window. Features enhanced multimodal capabilities including superior image understanding (up to 20MP), audio processing, and improved reasoning. Optimized for 2x lower latency than GPT-4 Turbo while maintaining high performance. Includes knowledge up to October 2023. Ideal for production applications requiring reliable multimodal capabilities.',
+                pricing: {
+                    prompt: pricing(`$5.00 / 1M tokens`),
+                    output: pricing(`$15.00 / 1M tokens`),
+                },
+            },
+            /**/
+            /**/
+            {
+                modelVariant: 'CHAT',
+                modelTitle: 'gpt-4o',
+                modelName: 'gpt-4o',
+                modelDescription: "OpenAI's most advanced general-purpose multimodal model with 128K context window. Optimized for balanced performance, speed, and cost with 2x faster responses than GPT-4 Turbo. Features excellent vision processing, audio understanding, reasoning, and text generation quality. Represents optimal balance of capability and efficiency for most advanced applications.",
+                pricing: {
+                    prompt: pricing(`$5.00 / 1M tokens`),
+                    output: pricing(`$15.00 / 1M tokens`),
+                },
+            },
+            /**/
+            /**/
+            {
+                modelVariant: 'CHAT',
+                modelTitle: 'gpt-4o-mini',
+                modelName: 'gpt-4o-mini',
+                modelDescription: 'Smaller, more cost-effective version of GPT-4o with 128K context window. Maintains impressive capabilities across text, vision, and audio tasks while operating at significantly lower cost. Features 3x faster inference than GPT-4o with good performance on general tasks. Excellent for applications requiring good quality multimodal capabilities at scale.',
+                pricing: {
+                    prompt: pricing(`$0.15 / 1M tokens`),
+                    output: pricing(`$0.60 / 1M tokens`),
+                },
+            },
+            /**/
+            /**/
+            {
+                modelVariant: 'CHAT',
+                modelTitle: 'o1-preview',
+                modelName: 'o1-preview',
+                modelDescription: 'Advanced reasoning model with 128K context window specializing in complex logical, mathematical, and analytical tasks. Features exceptional step-by-step problem-solving capabilities, advanced mathematical and scientific reasoning, and superior performance on STEM-focused problems. Significantly outperforms GPT-4 on quantitative reasoning benchmarks. Ideal for professional and specialized applications.',
+                pricing: {
+                    prompt: pricing(`$15.00 / 1M tokens`),
+                    output: pricing(`$60.00 / 1M tokens`),
+                },
+            },
+            /**/
+            /**/
+            {
+                modelVariant: 'CHAT',
+                modelTitle: 'o1-preview-2024-09-12',
+                modelName: 'o1-preview-2024-09-12',
+                modelDescription: 'September 2024 version of O1 preview with 128K context window. Features specialized reasoning capabilities with 30% improvement on mathematical and scientific accuracy over previous versions. Includes enhanced support for formal logic, statistical analysis, and technical domains. Optimized for professional applications requiring precise analytical thinking and rigorous methodologies.',
+                pricing: {
+                    prompt: pricing(`$15.00 / 1M tokens`),
+                    output: pricing(`$60.00 / 1M tokens`),
+                },
+            },
+            /**/
+            /**/
+            {
+                modelVariant: 'CHAT',
+                modelTitle: 'o1-mini',
+                modelName: 'o1-mini',
+                modelDescription: 'Smaller, cost-effective version of the O1 model with 128K context window. Maintains strong analytical reasoning abilities while reducing computational requirements by 70%. Features good performance on mathematical, logical, and scientific tasks at significantly lower cost than full O1. Excellent for everyday analytical applications that benefit from reasoning focus.',
+                pricing: {
+                    prompt: pricing(`$3.00 / 1M tokens`),
+                    output: pricing(`$12.00 / 1M tokens`),
+                },
+            },
+            /**/
+            /**/
+            {
+                modelVariant: 'CHAT',
+                modelTitle: 'o1',
+                modelName: 'o1',
+                modelDescription: "OpenAI's advanced reasoning model with 128K context window focusing on logical problem-solving and analytical thinking. Features exceptional performance on quantitative tasks, step-by-step deduction, and complex technical problems. Maintains 95%+ of o1-preview capabilities with production-ready stability. Ideal for scientific computing, financial analysis, and professional applications.",
+                pricing: {
+                    prompt: pricing(`$15.00 / 1M tokens`),
+                    output: pricing(`$60.00 / 1M tokens`),
+                },
+            },
+            /**/
+            /**/
+            {
+                modelVariant: 'CHAT',
+                modelTitle: 'o3-mini',
+                modelName: 'o3-mini',
+                modelDescription: 'Cost-effective reasoning model with 128K context window optimized for academic and scientific problem-solving. Features efficient performance on STEM tasks with specialized capabilities in mathematics, physics, chemistry, and computer science. Offers 80% of O1 performance on technical domains at significantly lower cost. Ideal for educational applications and research support.',
+                pricing: {
+                    prompt: pricing(`$3.00 / 1M tokens`),
+                    output: pricing(`$12.00 / 1M tokens`),
+                },
+            },
+            /**/
+            /**/
+            {
+                modelVariant: 'CHAT',
+                modelTitle: 'o1-mini-2024-09-12',
+                modelName: 'o1-mini-2024-09-12',
+                modelDescription: "September 2024 version of O1-mini with 128K context window featuring balanced reasoning capabilities and cost-efficiency. Includes 25% improvement in mathematical accuracy and enhanced performance on coding tasks compared to previous versions. Maintains efficient resource utilization while delivering improved results for analytical applications that don't require the full O1 model.",
+                pricing: {
+                    prompt: pricing(`$3.00 / 1M tokens`),
+                    output: pricing(`$12.00 / 1M tokens`),
+                },
+            },
+            /**/
+            /**/
+            {
+                modelVariant: 'CHAT',
+                modelTitle: 'gpt-3.5-turbo-16k-0613',
+                modelName: 'gpt-3.5-turbo-16k-0613',
+                modelDescription: "June 2023 version of GPT-3.5 Turbo with extended 16K token context window. Features good handling of longer conversations and documents with improved memory management across extended contexts. Includes knowledge cutoff from September 2021. Maintained for applications specifically designed for this version's behaviors and capabilities.",
+                pricing: {
+                    prompt: pricing(`$3.00 / 1M tokens`),
+                    output: pricing(`$4.00 / 1M tokens`),
+                },
+            },
+            /**/
+            // <- [🕕]
+        ],
+    });
+    /**
+     * Note: [🤖] Add models of new variant
+     * TODO: [🧠] Some mechanism to propagate unsureness
+     * TODO: [🎰] Some mechanism to auto-update available models
+     * TODO: [🎰][👮‍♀️] Make this list dynamic - dynamically can be listed modelNames but not modelVariant, legacy status, context length and pricing
+     * TODO: [🧠][👮‍♀️] Put here more info like description, isVision, trainingDateCutoff, languages, strengths (	Top-level performance, intelligence, fluency, and understanding), contextWindow,...
+     * @see https://platform.openai.com/docs/models/gpt-4-turbo-and-gpt-4
+     * @see https://openai.com/api/pricing/
+     * @see /other/playground/playground.ts
+     * TODO: [🍓][💩] Make better
+     * TODO: Change model titles to human eg: "gpt-4-turbo-2024-04-09" -> "GPT-4 Turbo (2024-04-09)"
+     * TODO: [🚸] Not all models are compatible with JSON mode, add this information here and use it
+     * Note: [💞] Ignore a discrepancy between file name and entity name
+     */
+
+    /**
+     * Computes the usage of the OpenAI API based on the response from OpenAI
+     *
+     * @param promptContent The content of the prompt
+     * @param resultContent The content of the result (for embedding prompts or failed prompts pass empty string)
+     * @param rawResponse The raw response from OpenAI API
+     * @throws {PipelineExecutionError} If the usage is not defined in the response from OpenAI
+     * @private internal utility of `OpenAiExecutionTools`
+     */
+    function computeOpenAiUsage(promptContent, // <- Note: Intentionally using [] to access type properties to bring jsdoc from Prompt/PromptResult to consumer
+    resultContent, rawResponse) {
+        var _a, _b;
+        if (rawResponse.usage === undefined) {
+            throw new PipelineExecutionError('The usage is not defined in the response from OpenAI');
+        }
+        if (((_a = rawResponse.usage) === null || _a === void 0 ? void 0 : _a.prompt_tokens) === undefined) {
+            throw new PipelineExecutionError('In OpenAI response `usage.prompt_tokens` not defined');
+        }
+        const inputTokens = rawResponse.usage.prompt_tokens;
+        const outputTokens = ((_b = rawResponse.usage) === null || _b === void 0 ? void 0 : _b.completion_tokens) || 0;
+        let isUncertain = false;
+        let modelInfo = OPENAI_MODELS.find((model) => model.modelName === rawResponse.model);
+        if (modelInfo === undefined) {
+            // Note: Model is not in the list of known models, fallback to the family of the models and mark price as uncertain
+            modelInfo = OPENAI_MODELS.find((model) => (rawResponse.model || SALT_NONCE).startsWith(model.modelName));
+            if (modelInfo !== undefined) {
+                isUncertain = true;
+            }
+        }
+        let price;
+        if (modelInfo === undefined || modelInfo.pricing === undefined) {
+            price = uncertainNumber();
+        }
+        else {
+            price = uncertainNumber(inputTokens * modelInfo.pricing.prompt + outputTokens * modelInfo.pricing.output, isUncertain);
+        }
+        return {
+            price,
+            input: {
+                tokensCount: uncertainNumber(rawResponse.usage.prompt_tokens),
+                ...computeUsageCounts(promptContent),
+            },
+            output: {
+                tokensCount: uncertainNumber(outputTokens),
+                ...computeUsageCounts(resultContent),
+            },
+        };
+    }
+    /**
+     * TODO: [🤝] DRY Maybe some common abstraction between `computeOpenAiUsage` and `computeAnthropicClaudeUsage`
+     */
+
+    /**
+     * Parses an OpenAI error message to identify which parameter is unsupported
+     *
+     * @param errorMessage The error message from OpenAI API
+     * @returns The parameter name that is unsupported, or null if not an unsupported parameter error
+     * @private utility of LLM Tools
+     */
+    function parseUnsupportedParameterError(errorMessage) {
+        // Pattern to match "Unsupported value: 'parameter' does not support ..."
+        const unsupportedValueMatch = errorMessage.match(/Unsupported value:\s*'([^']+)'\s*does not support/i);
+        if (unsupportedValueMatch === null || unsupportedValueMatch === void 0 ? void 0 : unsupportedValueMatch[1]) {
+            return unsupportedValueMatch[1];
+        }
+        // Pattern to match "'parameter' of type ... is not supported with this model"
+        const parameterTypeMatch = errorMessage.match(/'([^']+)'\s*of type.*is not supported with this model/i);
+        if (parameterTypeMatch === null || parameterTypeMatch === void 0 ? void 0 : parameterTypeMatch[1]) {
+            return parameterTypeMatch[1];
+        }
+        return null;
+    }
+    /**
+     * Creates a copy of model requirements with the specified parameter removed
+     *
+     * @param modelRequirements Original model requirements
+     * @param unsupportedParameter The parameter to remove
+     * @returns New model requirements without the unsupported parameter
+     * @private utility of LLM Tools
+     */
+    function removeUnsupportedModelRequirement(modelRequirements, unsupportedParameter) {
+        const newRequirements = { ...modelRequirements };
+        // Map of parameter names that might appear in error messages to ModelRequirements properties
+        const parameterMap = {
+            temperature: 'temperature',
+            max_tokens: 'maxTokens',
+            maxTokens: 'maxTokens',
+            seed: 'seed',
+        };
+        const propertyToRemove = parameterMap[unsupportedParameter];
+        if (propertyToRemove && propertyToRemove in newRequirements) {
+            delete newRequirements[propertyToRemove];
+        }
+        return newRequirements;
+    }
+    /**
+     * Checks if an error is an "Unsupported value" error from OpenAI
+     * @param error The error to check
+     * @returns true if this is an unsupported parameter error
+     * @private utility of LLM Tools
+     */
+    function isUnsupportedParameterError(error) {
+        const errorMessage = error.message.toLowerCase();
+        return (errorMessage.includes('unsupported value:') ||
+            errorMessage.includes('is not supported with this model') ||
+            errorMessage.includes('does not support'));
+    }
+
+    /**
+     * Execution Tools for calling OpenAI API or other OpenAI compatible provider
+     *
+     * @public exported from `@promptbook/openai`
+     */
+    class OpenAiCompatibleExecutionTools {
+        // Removed retriedUnsupportedParameters and attemptHistory instance fields
+        /**
+         * Creates OpenAI compatible Execution Tools.
+         *
+         * @param options which are relevant are directly passed to the OpenAI compatible client
+         */
+        constructor(options) {
+            this.options = options;
+            /**
+             * OpenAI API client.
+             */
+            this.client = null;
+            // TODO: Allow configuring rate limits via options
+            this.limiter = new Bottleneck__default["default"]({
+                minTime: 60000 / (this.options.maxRequestsPerMinute || DEFAULT_MAX_REQUESTS_PER_MINUTE),
+            });
+        }
+        async getClient() {
+            if (this.client === null) {
+                // Note: Passing only OpenAI relevant options to OpenAI constructor
+                const openAiOptions = { ...this.options };
+                delete openAiOptions.isVerbose;
+                delete openAiOptions.userId;
+                // Enhanced configuration for better ECONNRESET handling
+                const enhancedOptions = {
+                    ...openAiOptions,
+                    timeout: API_REQUEST_TIMEOUT,
+                    maxRetries: CONNECTION_RETRIES_LIMIT,
+                    defaultHeaders: {
+                        Connection: 'keep-alive',
+                        'Keep-Alive': 'timeout=30, max=100',
+                        ...openAiOptions.defaultHeaders,
+                    },
+                };
+                this.client = new OpenAI__default["default"](enhancedOptions);
+            }
+            return this.client;
+        }
+        /**
+         * Check the `options` passed to `constructor`
+         */
+        async checkConfiguration() {
+            await this.getClient();
+            // TODO: [🎍] Do here a real check that API is online, working and API key is correct
+        }
+        /**
+         * List all available OpenAI compatible models that can be used
+         */
+        async listModels() {
+            const client = await this.getClient();
+            const rawModelsList = await client.models.list();
+            const availableModels = rawModelsList.data
+                .sort((a, b) => (a.created > b.created ? 1 : -1))
+                .map((modelFromApi) => {
+                const modelFromList = this.HARDCODED_MODELS.find(({ modelName }) => modelName === modelFromApi.id ||
+                    modelName.startsWith(modelFromApi.id) ||
+                    modelFromApi.id.startsWith(modelName));
+                if (modelFromList !== undefined) {
+                    return modelFromList;
+                }
+                return {
+                    modelVariant: 'CHAT',
+                    modelTitle: modelFromApi.id,
+                    modelName: modelFromApi.id,
+                    modelDescription: '',
+                };
+            });
+            return availableModels;
+        }
+        /**
+         * Calls OpenAI compatible API to use a chat model.
+         */
+        async callChatModel(prompt) {
+            // Deep clone prompt and modelRequirements to avoid mutation across calls
+            const clonedPrompt = JSON.parse(JSON.stringify(prompt));
+            // Use local Set for retried parameters to ensure independence and thread safety
+            const retriedUnsupportedParameters = new Set();
+            return this.callChatModelWithRetry(clonedPrompt, clonedPrompt.modelRequirements, [], retriedUnsupportedParameters);
+        }
+        /**
+         * Internal method that handles parameter retry for chat model calls
+         */
+        async callChatModelWithRetry(prompt, currentModelRequirements, attemptStack = [], retriedUnsupportedParameters = new Set()) {
+            var _a;
+            if (this.options.isVerbose) {
+                console.info(`💬 ${this.title} callChatModel call`, { prompt, currentModelRequirements });
+            }
+            const { content, parameters, format } = prompt;
+            const client = await this.getClient();
+            // TODO: [☂] Use here more modelRequirements
+            if (currentModelRequirements.modelVariant !== 'CHAT') {
+                throw new PipelineExecutionError('Use callChatModel only for CHAT variant');
+            }
+            const modelName = currentModelRequirements.modelName || this.getDefaultChatModel().modelName;
+            const modelSettings = {
+                model: modelName,
+                max_tokens: currentModelRequirements.maxTokens,
+                temperature: currentModelRequirements.temperature,
+                // <- TODO: [🈁] Use `seed` here AND/OR use is `isDeterministic` for entire execution tools
+                // <- Note: [🧆]
+            }; // <- TODO: [💩] Guard here types better
+            if (format === 'JSON') {
+                modelSettings.response_format = {
+                    type: 'json_object',
+                };
+            }
+            // <- TODO: [🚸] Not all models are compatible with JSON mode
+            //        > 'response_format' of type 'json_object' is not supported with this model.
+            const rawPromptContent = templateParameters(content, { ...parameters, modelName });
+            // Convert thread to OpenAI format if present
+            let threadMessages = [];
+            if ('thread' in prompt && Array.isArray(prompt.thread)) {
+                threadMessages = prompt.thread.map((msg) => ({
+                    role: msg.role === 'assistant' ? 'assistant' : 'user',
+                    content: msg.content,
+                }));
+            }
+            const rawRequest = {
+                ...modelSettings,
+                messages: [
+                    ...(currentModelRequirements.systemMessage === undefined
+                        ? []
+                        : [
+                            {
+                                role: 'system',
+                                content: currentModelRequirements.systemMessage,
+                            },
+                        ]),
+                    ...threadMessages,
+                    {
+                        role: 'user',
+                        content: rawPromptContent,
+                    },
+                ],
+                user: (_a = this.options.userId) === null || _a === void 0 ? void 0 : _a.toString(),
+            };
+            const start = $getCurrentDate();
+            if (this.options.isVerbose) {
+                console.info(colors__default["default"].bgWhite('rawRequest'), JSON.stringify(rawRequest, null, 4));
+            }
+            try {
+                const rawResponse = await this.limiter
+                    .schedule(() => this.makeRequestWithNetworkRetry(() => client.chat.completions.create(rawRequest)))
+                    .catch((error) => {
+                    assertsError(error);
+                    if (this.options.isVerbose) {
+                        console.info(colors__default["default"].bgRed('error'), error);
+                    }
+                    throw error;
+                });
+                if (this.options.isVerbose) {
+                    console.info(colors__default["default"].bgWhite('rawResponse'), JSON.stringify(rawResponse, null, 4));
+                }
+                const complete = $getCurrentDate();
+                if (!rawResponse.choices[0]) {
+                    throw new PipelineExecutionError(`No choises from ${this.title}`);
+                }
+                if (rawResponse.choices.length > 1) {
+                    // TODO: This should be maybe only warning
+                    throw new PipelineExecutionError(`More than one choise from ${this.title}`);
+                }
+                const resultContent = rawResponse.choices[0].message.content;
+                const usage = this.computeUsage(content || '', resultContent || '', rawResponse);
+                if (resultContent === null) {
+                    throw new PipelineExecutionError(`No response message from ${this.title}`);
+                }
+                return exportJson({
+                    name: 'promptResult',
+                    message: `Result of \`OpenAiCompatibleExecutionTools.callChatModel\``,
+                    order: [],
+                    value: {
+                        content: resultContent,
+                        modelName: rawResponse.model || modelName,
+                        timing: {
+                            start,
+                            complete,
+                        },
+                        usage,
+                        rawPromptContent,
+                        rawRequest,
+                        rawResponse,
+                        // <- [🗯]
+                    },
+                });
+            }
+            catch (error) {
+                assertsError(error);
+                // Check if this is an unsupported parameter error
+                if (!isUnsupportedParameterError(error)) {
+                    // If we have attemptStack, include it in the error message
+                    if (attemptStack.length > 0) {
+                        throw new PipelineExecutionError(`All attempts failed. Attempt history:\n` +
+                            attemptStack
+                                .map((a, i) => `  ${i + 1}. Model: ${a.modelName}` +
+                                (a.unsupportedParameter ? `, Stripped: ${a.unsupportedParameter}` : '') +
+                                `, Error: ${a.errorMessage}` +
+                                (a.stripped ? ' (stripped and retried)' : ''))
+                                .join('\n') +
+                            `\nFinal error: ${error.message}`);
+                    }
+                    throw error;
+                }
+                // Parse which parameter is unsupported
+                const unsupportedParameter = parseUnsupportedParameterError(error.message);
+                if (!unsupportedParameter) {
+                    if (this.options.isVerbose) {
+                        console.warn(colors__default["default"].bgYellow('Warning'), 'Could not parse unsupported parameter from error:', error.message);
+                    }
+                    throw error;
+                }
+                // Create a unique key for this model + parameter combination to prevent infinite loops
+                const retryKey = `${modelName}-${unsupportedParameter}`;
+                if (retriedUnsupportedParameters.has(retryKey)) {
+                    // Already retried this parameter, throw the error with attemptStack
+                    attemptStack.push({
+                        modelName,
+                        unsupportedParameter,
+                        errorMessage: error.message,
+                        stripped: true,
+                    });
+                    throw new PipelineExecutionError(`All attempts failed. Attempt history:\n` +
+                        attemptStack
+                            .map((a, i) => `  ${i + 1}. Model: ${a.modelName}` +
+                            (a.unsupportedParameter ? `, Stripped: ${a.unsupportedParameter}` : '') +
+                            `, Error: ${a.errorMessage}` +
+                            (a.stripped ? ' (stripped and retried)' : ''))
+                            .join('\n') +
+                        `\nFinal error: ${error.message}`);
+                }
+                // Mark this parameter as retried
+                retriedUnsupportedParameters.add(retryKey);
+                // Log warning in verbose mode
+                if (this.options.isVerbose) {
+                    console.warn(colors__default["default"].bgYellow('Warning'), `Removing unsupported parameter '${unsupportedParameter}' for model '${modelName}' and retrying request`);
+                }
+                // Add to attemptStack
+                attemptStack.push({
+                    modelName,
+                    unsupportedParameter,
+                    errorMessage: error.message,
+                    stripped: true,
+                });
+                // Remove the unsupported parameter and retry
+                const modifiedModelRequirements = removeUnsupportedModelRequirement(currentModelRequirements, unsupportedParameter);
+                return this.callChatModelWithRetry(prompt, modifiedModelRequirements, attemptStack, retriedUnsupportedParameters);
+            }
+        }
+        /**
+         * Calls OpenAI API to use a complete model.
+         */
+        async callCompletionModel(prompt) {
+            // Deep clone prompt and modelRequirements to avoid mutation across calls
+            const clonedPrompt = JSON.parse(JSON.stringify(prompt));
+            const retriedUnsupportedParameters = new Set();
+            return this.callCompletionModelWithRetry(clonedPrompt, clonedPrompt.modelRequirements, [], retriedUnsupportedParameters);
+        }
+        /**
+         * Internal method that handles parameter retry for completion model calls
+         */
+        async callCompletionModelWithRetry(prompt, currentModelRequirements, attemptStack = [], retriedUnsupportedParameters = new Set()) {
+            var _a;
+            if (this.options.isVerbose) {
+                console.info(`🖋 ${this.title} callCompletionModel call`, { prompt, currentModelRequirements });
+            }
+            const { content, parameters } = prompt;
+            const client = await this.getClient();
+            // TODO: [☂] Use here more modelRequirements
+            if (currentModelRequirements.modelVariant !== 'COMPLETION') {
+                throw new PipelineExecutionError('Use callCompletionModel only for COMPLETION variant');
+            }
+            const modelName = currentModelRequirements.modelName || this.getDefaultCompletionModel().modelName;
+            const modelSettings = {
+                model: modelName,
+                max_tokens: currentModelRequirements.maxTokens,
+                temperature: currentModelRequirements.temperature,
+            };
+            const rawPromptContent = templateParameters(content, { ...parameters, modelName });
+            const rawRequest = {
+                ...modelSettings,
+                prompt: rawPromptContent,
+                user: (_a = this.options.userId) === null || _a === void 0 ? void 0 : _a.toString(),
+            };
+            const start = $getCurrentDate();
+            if (this.options.isVerbose) {
+                console.info(colors__default["default"].bgWhite('rawRequest'), JSON.stringify(rawRequest, null, 4));
+            }
+            try {
+                const rawResponse = await this.limiter
+                    .schedule(() => this.makeRequestWithNetworkRetry(() => client.completions.create(rawRequest)))
+                    .catch((error) => {
+                    assertsError(error);
+                    if (this.options.isVerbose) {
+                        console.info(colors__default["default"].bgRed('error'), error);
+                    }
+                    throw error;
+                });
+                if (this.options.isVerbose) {
+                    console.info(colors__default["default"].bgWhite('rawResponse'), JSON.stringify(rawResponse, null, 4));
+                }
+                const complete = $getCurrentDate();
+                if (!rawResponse.choices[0]) {
+                    throw new PipelineExecutionError(`No choises from ${this.title}`);
+                }
+                if (rawResponse.choices.length > 1) {
+                    throw new PipelineExecutionError(`More than one choise from ${this.title}`);
+                }
+                const resultContent = rawResponse.choices[0].text;
+                const usage = this.computeUsage(content || '', resultContent || '', rawResponse);
+                return exportJson({
+                    name: 'promptResult',
+                    message: `Result of \`OpenAiCompatibleExecutionTools.callCompletionModel\``,
+                    order: [],
+                    value: {
+                        content: resultContent,
+                        modelName: rawResponse.model || modelName,
+                        timing: {
+                            start,
+                            complete,
+                        },
+                        usage,
+                        rawPromptContent,
+                        rawRequest,
+                        rawResponse,
+                    },
+                });
+            }
+            catch (error) {
+                assertsError(error);
+                if (!isUnsupportedParameterError(error)) {
+                    if (attemptStack.length > 0) {
+                        throw new PipelineExecutionError(`All attempts failed. Attempt history:\n` +
+                            attemptStack
+                                .map((a, i) => `  ${i + 1}. Model: ${a.modelName}` +
+                                (a.unsupportedParameter ? `, Stripped: ${a.unsupportedParameter}` : '') +
+                                `, Error: ${a.errorMessage}` +
+                                (a.stripped ? ' (stripped and retried)' : ''))
+                                .join('\n') +
+                            `\nFinal error: ${error.message}`);
+                    }
+                    throw error;
+                }
+                const unsupportedParameter = parseUnsupportedParameterError(error.message);
+                if (!unsupportedParameter) {
+                    if (this.options.isVerbose) {
+                        console.warn(colors__default["default"].bgYellow('Warning'), 'Could not parse unsupported parameter from error:', error.message);
+                    }
+                    throw error;
+                }
+                const retryKey = `${modelName}-${unsupportedParameter}`;
+                if (retriedUnsupportedParameters.has(retryKey)) {
+                    attemptStack.push({
+                        modelName,
+                        unsupportedParameter,
+                        errorMessage: error.message,
+                        stripped: true,
+                    });
+                    throw new PipelineExecutionError(`All attempts failed. Attempt history:\n` +
+                        attemptStack
+                            .map((a, i) => `  ${i + 1}. Model: ${a.modelName}` +
+                            (a.unsupportedParameter ? `, Stripped: ${a.unsupportedParameter}` : '') +
+                            `, Error: ${a.errorMessage}` +
+                            (a.stripped ? ' (stripped and retried)' : ''))
+                            .join('\n') +
+                        `\nFinal error: ${error.message}`);
+                }
+                retriedUnsupportedParameters.add(retryKey);
+                if (this.options.isVerbose) {
+                    console.warn(colors__default["default"].bgYellow('Warning'), `Removing unsupported parameter '${unsupportedParameter}' for model '${modelName}' and retrying request`);
+                }
+                attemptStack.push({
+                    modelName,
+                    unsupportedParameter,
+                    errorMessage: error.message,
+                    stripped: true,
+                });
+                const modifiedModelRequirements = removeUnsupportedModelRequirement(currentModelRequirements, unsupportedParameter);
+                return this.callCompletionModelWithRetry(prompt, modifiedModelRequirements, attemptStack, retriedUnsupportedParameters);
+            }
+        }
+        /**
+         * Calls OpenAI compatible API to use a embedding model
+         */
+        async callEmbeddingModel(prompt) {
+            // Deep clone prompt and modelRequirements to avoid mutation across calls
+            const clonedPrompt = JSON.parse(JSON.stringify(prompt));
+            const retriedUnsupportedParameters = new Set();
+            return this.callEmbeddingModelWithRetry(clonedPrompt, clonedPrompt.modelRequirements, [], retriedUnsupportedParameters);
+        }
+        /**
+         * Internal method that handles parameter retry for embedding model calls
+         */
+        async callEmbeddingModelWithRetry(prompt, currentModelRequirements, attemptStack = [], retriedUnsupportedParameters = new Set()) {
+            if (this.options.isVerbose) {
+                console.info(`🖋 ${this.title} embedding call`, { prompt, currentModelRequirements });
+            }
+            const { content, parameters } = prompt;
+            const client = await this.getClient();
+            if (currentModelRequirements.modelVariant !== 'EMBEDDING') {
+                throw new PipelineExecutionError('Use embed only for EMBEDDING variant');
+            }
+            const modelName = currentModelRequirements.modelName || this.getDefaultEmbeddingModel().modelName;
+            const rawPromptContent = templateParameters(content, { ...parameters, modelName });
+            const rawRequest = {
+                input: rawPromptContent,
+                model: modelName,
+            };
+            const start = $getCurrentDate();
+            if (this.options.isVerbose) {
+                console.info(colors__default["default"].bgWhite('rawRequest'), JSON.stringify(rawRequest, null, 4));
+            }
+            try {
+                const rawResponse = await this.limiter
+                    .schedule(() => this.makeRequestWithNetworkRetry(() => client.embeddings.create(rawRequest)))
+                    .catch((error) => {
+                    assertsError(error);
+                    if (this.options.isVerbose) {
+                        console.info(colors__default["default"].bgRed('error'), error);
+                    }
+                    throw error;
+                });
+                if (this.options.isVerbose) {
+                    console.info(colors__default["default"].bgWhite('rawResponse'), JSON.stringify(rawResponse, null, 4));
+                }
+                const complete = $getCurrentDate();
+                if (rawResponse.data.length !== 1) {
+                    throw new PipelineExecutionError(`Expected exactly 1 data item in response, got ${rawResponse.data.length}`);
+                }
+                const resultContent = rawResponse.data[0].embedding;
+                const usage = this.computeUsage(content || '', '', rawResponse);
+                return exportJson({
+                    name: 'promptResult',
+                    message: `Result of \`OpenAiCompatibleExecutionTools.callEmbeddingModel\``,
+                    order: [],
+                    value: {
+                        content: resultContent,
+                        modelName: rawResponse.model || modelName,
+                        timing: {
+                            start,
+                            complete,
+                        },
+                        usage,
+                        rawPromptContent,
+                        rawRequest,
+                        rawResponse,
+                    },
+                });
+            }
+            catch (error) {
+                assertsError(error);
+                if (!isUnsupportedParameterError(error)) {
+                    if (attemptStack.length > 0) {
+                        throw new PipelineExecutionError(`All attempts failed. Attempt history:\n` +
+                            attemptStack
+                                .map((a, i) => `  ${i + 1}. Model: ${a.modelName}` +
+                                (a.unsupportedParameter ? `, Stripped: ${a.unsupportedParameter}` : '') +
+                                `, Error: ${a.errorMessage}` +
+                                (a.stripped ? ' (stripped and retried)' : ''))
+                                .join('\n') +
+                            `\nFinal error: ${error.message}`);
+                    }
+                    throw error;
+                }
+                const unsupportedParameter = parseUnsupportedParameterError(error.message);
+                if (!unsupportedParameter) {
+                    if (this.options.isVerbose) {
+                        console.warn(colors__default["default"].bgYellow('Warning'), 'Could not parse unsupported parameter from error:', error.message);
+                    }
+                    throw error;
+                }
+                const retryKey = `${modelName}-${unsupportedParameter}`;
+                if (retriedUnsupportedParameters.has(retryKey)) {
+                    attemptStack.push({
+                        modelName,
+                        unsupportedParameter,
+                        errorMessage: error.message,
+                        stripped: true,
+                    });
+                    throw new PipelineExecutionError(`All attempts failed. Attempt history:\n` +
+                        attemptStack
+                            .map((a, i) => `  ${i + 1}. Model: ${a.modelName}` +
+                            (a.unsupportedParameter ? `, Stripped: ${a.unsupportedParameter}` : '') +
+                            `, Error: ${a.errorMessage}` +
+                            (a.stripped ? ' (stripped and retried)' : ''))
+                            .join('\n') +
+                        `\nFinal error: ${error.message}`);
+                }
+                retriedUnsupportedParameters.add(retryKey);
+                if (this.options.isVerbose) {
+                    console.warn(colors__default["default"].bgYellow('Warning'), `Removing unsupported parameter '${unsupportedParameter}' for model '${modelName}' and retrying request`);
+                }
+                attemptStack.push({
+                    modelName,
+                    unsupportedParameter,
+                    errorMessage: error.message,
+                    stripped: true,
+                });
+                const modifiedModelRequirements = removeUnsupportedModelRequirement(currentModelRequirements, unsupportedParameter);
+                return this.callEmbeddingModelWithRetry(prompt, modifiedModelRequirements, attemptStack, retriedUnsupportedParameters);
+            }
+        }
+        // <- Note: [🤖] callXxxModel
+        /**
+         * Get the model that should be used as default
+         */
+        getDefaultModel(defaultModelName) {
+            // Note: Match exact or prefix for model families
+            const model = this.HARDCODED_MODELS.find(({ modelName }) => modelName === defaultModelName || modelName.startsWith(defaultModelName));
+            if (model === undefined) {
+                throw new PipelineExecutionError(spaceTrim__default["default"]((block) => `
+                            Cannot find model in ${this.title} models with name "${defaultModelName}" which should be used as default.
+
+                            Available models:
+                            ${block(this.HARDCODED_MODELS.map(({ modelName }) => `- "${modelName}"`).join('\n'))}
+
+                            Model "${defaultModelName}" is probably not available anymore, not installed, inaccessible or misconfigured.
+
+                        `));
+            }
+            return model;
+        }
+        // <- Note: [🤖] getDefaultXxxModel
+        /**
+         * Makes a request with retry logic for network errors like ECONNRESET
+         */
+        async makeRequestWithNetworkRetry(requestFn) {
+            let lastError;
+            for (let attempt = 1; attempt <= CONNECTION_RETRIES_LIMIT; attempt++) {
+                try {
+                    return await requestFn();
+                }
+                catch (error) {
+                    assertsError(error);
+                    lastError = error;
+                    // Check if this is a retryable network error
+                    const isRetryableError = this.isRetryableNetworkError(error);
+                    if (!isRetryableError || attempt === CONNECTION_RETRIES_LIMIT) {
+                        if (this.options.isVerbose && this.isRetryableNetworkError(error)) {
+                            console.info(colors__default["default"].bgRed('Final network error after retries'), `Attempt ${attempt}/${CONNECTION_RETRIES_LIMIT}:`, error);
+                        }
+                        throw error;
+                    }
+                    // Calculate exponential backoff delay
+                    const baseDelay = 1000; // 1 second
+                    const backoffDelay = baseDelay * Math.pow(2, attempt - 1);
+                    const jitterDelay = Math.random() * 500; // Add some randomness
+                    const totalDelay = backoffDelay + jitterDelay;
+                    if (this.options.isVerbose) {
+                        console.info(colors__default["default"].bgYellow('Retrying network request'), `Attempt ${attempt}/${CONNECTION_RETRIES_LIMIT}, waiting ${Math.round(totalDelay)}ms:`, error.message);
+                    }
+                    // Wait before retrying
+                    await new Promise((resolve) => setTimeout(resolve, totalDelay));
+                }
+            }
+            throw lastError;
+        }
+        /**
+         * Determines if an error is retryable (network-related errors)
+         */
+        isRetryableNetworkError(error) {
+            const errorMessage = error.message.toLowerCase();
+            const errorCode = error.code;
+            // Network connection errors that should be retried
+            const retryableErrors = [
+                'econnreset',
+                'enotfound',
+                'econnrefused',
+                'etimedout',
+                'socket hang up',
+                'network error',
+                'fetch failed',
+                'connection reset',
+                'connection refused',
+                'timeout',
+            ];
+            // Check error message
+            if (retryableErrors.some((retryableError) => errorMessage.includes(retryableError))) {
+                return true;
+            }
+            // Check error code
+            if (errorCode && retryableErrors.includes(errorCode.toLowerCase())) {
+                return true;
+            }
+            // Check for specific HTTP status codes that are retryable
+            const errorWithStatus = error;
+            const httpStatus = errorWithStatus.status || errorWithStatus.statusCode;
+            if (httpStatus && [429, 500, 502, 503, 504].includes(httpStatus)) {
+                return true;
+            }
+            return false;
+        }
+    }
+    /**
+     * TODO: [🛄] Some way how to re-wrap the errors from `OpenAiCompatibleExecutionTools`
+     * TODO: [🛄] Maybe make custom `OpenAiCompatibleError`
+     * TODO: [🧠][🈁] Maybe use `isDeterministic` from options
+     * TODO: [🧠][🌰] Allow to pass `title` for tracking purposes
+     * TODO: [🧠][🦢] Make reverse adapter from LlmExecutionTools to OpenAI-compatible:
+     */
+
+    /**
+     * Profile for OpenAI provider
+     */
+    const OPENAI_PROVIDER_PROFILE = {
+        name: 'OPENAI',
+        fullname: 'OpenAI GPT',
+        color: '#10a37f',
+    };
+    /**
+     * Execution Tools for calling OpenAI API
+     *
+     * @public exported from `@promptbook/openai`
+     */
+    class OpenAiExecutionTools extends OpenAiCompatibleExecutionTools {
+        constructor() {
+            super(...arguments);
+            /**
+             * Computes the usage of the OpenAI API based on the response from OpenAI
+             */
+            this.computeUsage = computeOpenAiUsage;
+            // <- Note: [🤖] getDefaultXxxModel
+        }
+        /* <- TODO: [🍚] `, Destroyable` */
+        get title() {
+            return 'OpenAI';
+        }
+        get description() {
+            return 'Use all models provided by OpenAI';
+        }
+        get profile() {
+            return OPENAI_PROVIDER_PROFILE;
+        }
+        /*
+        Note: Commenting this out to avoid circular dependency
+        /**
+         * Create (sub)tools for calling OpenAI API Assistants
+         *
+         * @param assistantId Which assistant to use
+         * @returns Tools for calling OpenAI API Assistants with same token
+         * /
+        public createAssistantSubtools(assistantId: string_token): OpenAiAssistantExecutionTools {
+            return new OpenAiAssistantExecutionTools({ ...this.options, assistantId });
+        }
+        */
+        /**
+         * List all available models (non dynamically)
+         *
+         * Note: Purpose of this is to provide more information about models than standard listing from API
+         */
+        get HARDCODED_MODELS() {
+            return OPENAI_MODELS;
+        }
+        /**
+         * Default model for chat variant.
+         */
+        getDefaultChatModel() {
+            return this.getDefaultModel('gpt-5');
+        }
+        /**
+         * Default model for completion variant.
+         */
+        getDefaultCompletionModel() {
+            return this.getDefaultModel('gpt-3.5-turbo-instruct');
+        }
+        /**
+         * Default model for completion variant.
+         */
+        getDefaultEmbeddingModel() {
+            return this.getDefaultModel('text-embedding-3-large');
+        }
+    }
+
+    /**
+     * Execution Tools for calling OpenAI API Assistants
+     *
+     * This is useful for calling OpenAI API with a single assistant, for more wide usage use `OpenAiExecutionTools`.
+     *
+     * Note: [🦖] There are several different things in Promptbook:
+     * - `Agent` - which represents an AI Agent with its source, memories, actions, etc. Agent is a higher-level abstraction which is internally using:
+     * - `LlmExecutionTools` - which wraps one or more LLM models and provides an interface to execute them
+     * - `AgentLlmExecutionTools` - which is a specific implementation of `LlmExecutionTools` that wraps another LlmExecutionTools and applies agent-specific system prompts and requirements
+     * - `OpenAiAssistantExecutionTools` - which is a specific implementation of `LlmExecutionTools` for OpenAI models with assistant capabilities, recommended for usage in `Agent` or `AgentLlmExecutionTools`
+     *
+     * @public exported from `@promptbook/openai`
+     */
+    class OpenAiAssistantExecutionTools extends OpenAiExecutionTools {
+        /**
+         * Creates OpenAI Execution Tools.
+         *
+         * @param options which are relevant are directly passed to the OpenAI client
+         */
+        constructor(options) {
+            var _a;
+            if (options.isProxied) {
+                throw new NotYetImplementedError(`Proxy mode is not yet implemented for OpenAI assistants`);
+            }
+            super(options);
+            this.isCreatingNewAssistantsAllowed = false;
+            this.assistantId = options.assistantId;
+            this.isCreatingNewAssistantsAllowed = (_a = options.isCreatingNewAssistantsAllowed) !== null && _a !== void 0 ? _a : false;
+            if (this.assistantId === null && !this.isCreatingNewAssistantsAllowed) {
+                throw new NotAllowed(`Assistant ID is null and creating new assistants is not allowed - this configuration does not make sense`);
+            }
+            // <- TODO: !!! `OpenAiAssistantExecutionToolsOptions` - Allow `assistantId: null` together with `isCreatingNewAssistantsAllowed: true`
+            // TODO: [👱] Make limiter same as in `OpenAiExecutionTools`
+        }
+        get title() {
+            return 'OpenAI Assistant';
+        }
+        get description() {
+            return 'Use single assistant provided by OpenAI';
+        }
+        /**
+         * Calls OpenAI API to use a chat model.
+         */
+        async callChatModel(prompt) {
+            var _a, _b, _c;
+            if (this.options.isVerbose) {
+                console.info('💬 OpenAI callChatModel call', { prompt });
+            }
+            const { content, parameters, modelRequirements /*, format*/ } = prompt;
+            const client = await this.getClient();
+            // TODO: [☂] Use here more modelRequirements
+            if (modelRequirements.modelVariant !== 'CHAT') {
+                throw new PipelineExecutionError('Use callChatModel only for CHAT variant');
+            }
+            // TODO: [👨‍👨‍👧‍👧] Remove:
+            for (const key of ['maxTokens', 'modelName', 'seed', 'temperature']) {
+                if (modelRequirements[key] !== undefined) {
+                    throw new NotYetImplementedError(`In \`OpenAiAssistantExecutionTools\` you cannot specify \`${key}\``);
+                }
+            }
+            /*
+            TODO: [👨‍👨‍👧‍👧] Implement all of this for Assistants
+            const modelName = modelRequirements.modelName || this.getDefaultChatModel().modelName;
+            const modelSettings = {
+                model: modelName,
+
+                temperature: modelRequirements.temperature,
+
+                // <- TODO: [🈁] Use `seed` here AND/OR use is `isDeterministic` for entire execution tools
+                // <- Note: [🧆]
+            } as OpenAI.Chat.Completions.CompletionCreateParamsNonStreaming; // <- TODO: Guard here types better
+
+            if (format === 'JSON') {
+                modelSettings.response_format = {
+                    type: 'json_object',
+                };
+            }
+            */
+            // <- TODO: [🚸] Not all models are compatible with JSON mode
+            //        > 'response_format' of type 'json_object' is not supported with this model.
+            const rawPromptContent = templateParameters(content, {
+                ...parameters,
+                modelName: 'assistant',
+                //          <- [🧠] What is the best value here
+            });
+            const rawRequest = {
+                // TODO: [👨‍👨‍👧‍👧] ...modelSettings,
+                // TODO: [👨‍👨‍👧‍👧][🧠] What about system message for assistants, does it make sense - combination of OpenAI assistants with Promptbook Personas
+                assistant_id: this.assistantId,
+                thread: {
+                    messages: 'thread' in prompt &&
+                        Array.isArray(prompt.thread)
+                        ? prompt.thread.map((msg) => ({
+                            role: msg.role === 'assistant' ? 'assistant' : 'user',
+                            content: msg.content,
+                        }))
+                        : [{ role: 'user', content: rawPromptContent }],
+                },
+                // <- TODO: Add user identification here> user: this.options.user,
+            };
+            const start = $getCurrentDate();
+            let complete;
+            if (this.options.isVerbose) {
+                console.info(colors__default["default"].bgWhite('rawRequest'), JSON.stringify(rawRequest, null, 4));
+            }
+            const stream = await client.beta.threads.createAndRunStream(rawRequest);
+            stream.on('connect', () => {
+                if (this.options.isVerbose) {
+                    console.info('connect', stream.currentEvent);
+                }
+            });
+            stream.on('messageDelta', (messageDelta) => {
+                var _a;
+                if (this.options.isVerbose &&
+                    messageDelta &&
+                    messageDelta.content &&
+                    messageDelta.content[0] &&
+                    messageDelta.content[0].type === 'text') {
+                    console.info('messageDelta', (_a = messageDelta.content[0].text) === null || _a === void 0 ? void 0 : _a.value);
+                }
+                // <- TODO: [🐚] Make streaming and running tasks working
+            });
+            stream.on('messageCreated', (message) => {
+                if (this.options.isVerbose) {
+                    console.info('messageCreated', message);
+                }
+            });
+            stream.on('messageDone', (message) => {
+                if (this.options.isVerbose) {
+                    console.info('messageDone', message);
+                }
+            });
+            const rawResponse = await stream.finalMessages();
+            if (this.options.isVerbose) {
+                console.info(colors__default["default"].bgWhite('rawResponse'), JSON.stringify(rawResponse, null, 4));
+            }
+            if (rawResponse.length !== 1) {
+                throw new PipelineExecutionError(`There is NOT 1 BUT ${rawResponse.length} finalMessages from OpenAI`);
+            }
+            if (rawResponse[0].content.length !== 1) {
+                throw new PipelineExecutionError(`There is NOT 1 BUT ${rawResponse[0].content.length} finalMessages content from OpenAI`);
+            }
+            if (((_a = rawResponse[0].content[0]) === null || _a === void 0 ? void 0 : _a.type) !== 'text') {
+                throw new PipelineExecutionError(`There is NOT 'text' BUT ${(_b = rawResponse[0].content[0]) === null || _b === void 0 ? void 0 : _b.type} finalMessages content type from OpenAI`);
+            }
+            const resultContent = (_c = rawResponse[0].content[0]) === null || _c === void 0 ? void 0 : _c.text.value;
+            //                                                     <- TODO: [🧠] There are also annotations, maybe use them
+            // eslint-disable-next-line prefer-const
+            complete = $getCurrentDate();
+            const usage = UNCERTAIN_USAGE;
+            // <- TODO: [🥘] Compute real usage for assistant
+            //       ?> const usage = computeOpenAiUsage(content, resultContent || '', rawResponse);
+            if (resultContent === null) {
+                throw new PipelineExecutionError('No response message from OpenAI');
+            }
+            return exportJson({
+                name: 'promptResult',
+                message: `Result of \`OpenAiAssistantExecutionTools.callChatModel\``,
+                order: [],
+                value: {
+                    content: resultContent,
+                    modelName: 'assistant',
+                    // <- TODO: [🥘] Detect used model in assistant
+                    //       ?> model: rawResponse.model || modelName,
+                    timing: {
+                        start,
+                        complete,
+                    },
+                    usage,
+                    rawPromptContent,
+                    rawRequest,
+                    rawResponse,
+                    // <- [🗯]
+                },
+            });
+        }
+        async playground() {
+            const client = await this.getClient();
+            // List all assistants
+            const assistants = await client.beta.assistants.list();
+            console.log('!!! Assistants:', assistants);
+            // Get details of a specific assistant
+            const assistantId = 'asst_MO8fhZf4dGloCfXSHeLcIik0';
+            const assistant = await client.beta.assistants.retrieve(assistantId);
+            console.log('!!! Assistant Details:', assistant);
+            // Update an assistant
+            const updatedAssistant = await client.beta.assistants.update(assistantId, {
+                name: assistant.name + '(M)',
+                description: 'Updated description via Promptbook',
+                metadata: {
+                    [Math.random().toString(36).substring(2, 15)]: new Date().toISOString(),
+                },
+            });
+            console.log('!!! Updated Assistant:', updatedAssistant);
+            await waitasecond.forEver();
+        }
+        async createNewAssistant(options) {
+            if (!this.isCreatingNewAssistantsAllowed) {
+                throw new NotAllowed(`Creating new assistants is not allowed. Set \`isCreatingNewAssistantsAllowed: true\` in options to enable this feature.`);
+            }
+            await this.playground();
+            const { name, instructions } = options;
+            const client = await this.getClient();
+            /*
+            TODO: !!!
+            async function downloadFile(url: string, folder = './tmp'): Promise<string> {
+                const filename = path.basename(url.split('?')[0]);
+                const filepath = path.join(folder, filename);
+
+                if (!fs.existsSync(folder)) fs.mkdirSync(folder);
+
+                const res = await fetch(url);
+                if (!res.ok) throw new Error(`Download error: ${url}`);
+                const buffer = await res.arrayBuffer();
+                fs.writeFileSync(filepath, Buffer.from(buffer));
+                console.log(`📥 File downloaded: ${filename}`);
+
+                return filepath;
+            }
+
+            async function uploadFileToOpenAI(filepath: string) {
+                const file = await client.files.create({
+                    file: fs.createReadStream(filepath),
+                    purpose: 'assistants',
+                });
+                console.log(`⬆️  File uploaded to OpenAI: ${file.filename} (${file.id})`);
+                return file;
+            }
+
+            // 🌐 URL addresses of files to upload
+            const fileUrls = [
+                'https://raw.githubusercontent.com/vercel/next.js/canary/packages/next/README.md',
+                'https://raw.githubusercontent.com/openai/openai-cookbook/main/examples/How_to_call_the_Assistants_API_with_Node.js.ipynb',
+            ];
+
+            // 1️⃣ Download files from URL
+            const localFiles = [];
+            for (const url of fileUrls) {
+                const filepath = await downloadFile(url);
+                localFiles.push(filepath);
+            }
+
+            // 2️⃣ Upload files to OpenAI
+            const uploadedFiles = [];
+            for (const filepath of localFiles) {
+                const file = await uploadFileToOpenAI(filepath);
+                uploadedFiles.push(file.id);
+            }
+            */
+            alert('!!!! Creating new OpenAI assistant');
+            // 3️⃣ Create assistant with uploaded files
+            const assistant = await client.beta.assistants.create({
+                name,
+                description: 'Assistant created via Promptbook',
+                model: 'gpt-4o',
+                instructions,
+                tools: [/* TODO: [🧠] Maybe add { type: 'code_interpreter' }, */ { type: 'file_search' }],
+                // !!!! file_ids: uploadedFiles,
+            });
+            console.log(`✅ Assistant created: ${assistant.id}`);
+            // TODO: !!!! Try listing existing assistants
+            // TODO: !!!! Try marking existing assistants by DISCRIMINANT
+            // TODO: !!!! Allow to update and reconnect to existing assistants
+            return new OpenAiAssistantExecutionTools({
+                ...this.options,
+                isCreatingNewAssistantsAllowed: false,
+                assistantId: assistant.id,
+            });
+        }
+        /**
+         * Discriminant for type guards
+         */
+        get discriminant() {
+            return DISCRIMINANT;
+        }
+        /**
+         * Type guard to check if given `LlmExecutionTools` are instanceof `OpenAiAssistantExecutionTools`
+         *
+         * Note: This is useful when you can possibly have multiple versions of `@promptbook/openai` installed
+         */
+        static isOpenAiAssistantExecutionTools(llmExecutionTools) {
+            return llmExecutionTools.discriminant === DISCRIMINANT;
+        }
+    }
+    /**
+     * Discriminant for type guards
+     *
+     * @private const of `OpenAiAssistantExecutionTools`
+     */
+    const DISCRIMINANT = 'OPEN_AI_ASSISTANT_V1';
+    /**
+     * TODO: [🧠][🧙‍♂️] Maybe there can be some wizard for those who want to use just OpenAI
+     * TODO: Maybe make custom OpenAiError
+     * TODO: [🧠][🈁] Maybe use `isDeterministic` from options
+     * TODO: [🧠][🌰] Allow to pass `title` for tracking purposes
+     */
+
+    /**
+     * Execution Tools for calling LLM models with a predefined agent "soul"
+     * This wraps underlying LLM execution tools and applies agent-specific system prompts and requirements
+     *
+     * Note: [🦖] There are several different things in Promptbook:
+     * - `Agent` - which represents an AI Agent with its source, memories, actions, etc. Agent is a higher-level abstraction which is internally using:
+     * - `LlmExecutionTools` - which wraps one or more LLM models and provides an interface to execute them
+     * - `AgentLlmExecutionTools` - which is a specific implementation of `LlmExecutionTools` that wraps another LlmExecutionTools and applies agent-specific system prompts and requirements
+     * - `OpenAiAssistantExecutionTools` - which is a specific implementation of `LlmExecutionTools` for OpenAI models with assistant capabilities, recommended for usage in `Agent` or `AgentLlmExecutionTools`
+     *
+     * @public exported from `@promptbook/core`
+     */
+    class AgentLlmExecutionTools {
+        /**
+         * Creates new AgentLlmExecutionTools
+         *
+         * @param llmTools The underlying LLM execution tools to wrap
+         * @param agentSource The agent source string that defines the agent's behavior
+         */
+        constructor(options) {
+            this.options = options;
+            /**
+             * Cached model requirements to avoid re-parsing the agent source
+             */
+            this._cachedModelRequirements = null;
+            /**
+             * Cached parsed agent information
+             */
+            this._cachedAgentInfo = null;
+        }
+        /**
+         * Get cached or parse agent information
+         */
+        getAgentInfo() {
+            if (this._cachedAgentInfo === null) {
+                this._cachedAgentInfo = parseAgentSource(this.options.agentSource);
+            }
+            return this._cachedAgentInfo;
+        }
+        /**
+         * Get cached or create agent model requirements
+         */
+        async getAgentModelRequirements() {
+            if (this._cachedModelRequirements === null) {
+                // Get available models from underlying LLM tools for best model selection
+                const availableModels = await this.options.llmTools.listModels();
+                this._cachedModelRequirements = await createAgentModelRequirements(this.options.agentSource, undefined, // Let the function pick the best model
+                availableModels);
+            }
+            return this._cachedModelRequirements;
+        }
+        get title() {
+            const agentInfo = this.getAgentInfo();
+            return (agentInfo.agentName || 'Agent');
+        }
+        get description() {
+            const agentInfo = this.getAgentInfo();
+            return agentInfo.personaDescription || 'AI Agent with predefined personality and behavior';
+        }
+        get profile() {
+            const agentInfo = this.getAgentInfo();
+            if (!agentInfo.agentName) {
+                return undefined;
+            }
+            return {
+                name: agentInfo.agentName.toUpperCase().replace(/\s+/g, '_'),
+                fullname: agentInfo.agentName,
+                color: agentInfo.meta.color || '#6366f1',
+                avatarSrc: agentInfo.meta.image,
+            };
+        }
+        checkConfiguration() {
+            // Check underlying tools configuration
+            return this.options.llmTools.checkConfiguration();
+        }
+        /**
+         * Returns a virtual model name representing the agent behavior
+         */
+        get modelName() {
+            const hash = cryptoJs.SHA256(hexEncoder__default["default"].parse(this.options.agentSource))
+                //    <- TODO: [🥬] Encapsulate sha256 to some private utility function
+                .toString( /* hex */);
+            //    <- TODO: [🥬] Make some system for hashes and ids of promptbook
+            const agentId = hash.substring(0, 10);
+            //                    <- TODO: [🥬] Make some system for hashes and ids of promptbook
+            return (normalizeToKebabCase(this.title) + '-' + agentId);
+        }
+        listModels() {
+            return [
+                {
+                    modelName: this.modelName,
+                    modelVariant: 'CHAT',
+                    modelTitle: `${this.title} (Agent Chat Default)`,
+                    modelDescription: `Chat model with agent behavior: ${this.description}`,
+                },
+                // <- Note: We only list a single "virtual" agent model here as this wrapper only supports chat prompts
+            ];
+        }
+        /**
+         * Calls the chat model with agent-specific system prompt and requirements
+         */
+        async callChatModel(prompt) {
+            if (!this.options.llmTools.callChatModel) {
+                throw new Error('Underlying LLM execution tools do not support chat model calls');
+            }
+            // Ensure we're working with a chat prompt
             if (prompt.modelRequirements.modelVariant !== 'CHAT') {
                 throw new Error('AgentLlmExecutionTools only supports chat prompts');
             }
-            const chatPrompt = prompt;
-            // Get agent model requirements (cached with best model selection)
             const modelRequirements = await this.getAgentModelRequirements();
-            // Create modified chat prompt with agent system message
-            const modifiedChatPrompt = {
-                ...chatPrompt,
-                modelRequirements: {
-                    ...chatPrompt.modelRequirements,
-                    ...modelRequirements,
-                    // Prepend agent system message to existing system message
-                    systemMessage: modelRequirements.systemMessage +
-                        (chatPrompt.modelRequirements.systemMessage
-                            ? `\n\n${chatPrompt.modelRequirements.systemMessage}`
-                            : ''),
-                },
-            };
-            const underlyingLlmResult = await this.llmTools.callChatModel(modifiedChatPrompt);
+            const chatPrompt = prompt;
+            let underlyingLlmResult;
+            if (OpenAiAssistantExecutionTools.isOpenAiAssistantExecutionTools(this.options.llmTools)) {
+                // <- TODO: !!! Check also `isCreatingNewAssistantsAllowed` and warn about it
+                const assistant = await this.options.llmTools.createNewAssistant({
+                    name: this.title,
+                    instructions: modelRequirements.systemMessage,
+                });
+                // <- TODO: !!! Cache the assistant in prepareCache
+                underlyingLlmResult = await assistant.callChatModel(chatPrompt);
+            }
+            else {
+                // Create modified chat prompt with agent system message
+                const modifiedChatPrompt = {
+                    ...chatPrompt,
+                    modelRequirements: {
+                        ...chatPrompt.modelRequirements,
+                        ...modelRequirements,
+                        // Prepend agent system message to existing system message
+                        systemMessage: modelRequirements.systemMessage +
+                            (chatPrompt.modelRequirements.systemMessage
+                                ? `\n\n${chatPrompt.modelRequirements.systemMessage}`
+                                : ''),
+                    },
+                };
+                underlyingLlmResult = await this.options.llmTools.callChatModel(modifiedChatPrompt);
+            }
             let content = underlyingLlmResult.content;
             // Note: Cleanup the AI artifacts from the content
             content = humanizeAiText(content);
@@ -14902,15 +16881,11 @@
      * @public exported from `@promptbook/core`
      */
     const createAgentLlmExecutionTools = Object.assign((options) => {
-        return new AgentLlmExecutionTools(options.llmTools, options.agentSource);
+        return new AgentLlmExecutionTools(options);
     }, {
         packageName: '@promptbook/core',
         className: 'AgentLlmExecutionTools',
     });
-    /**
-     * TODO: [🧠] Consider adding validation for agent source format
-     * TODO: [🧠] Consider adding options for caching behavior
-     */
 
     /**
      * Metadata for Agent LLM execution tools
@@ -15541,7 +17516,7 @@
                 \`
             `));
         }
-        return bookString;
+        return padBook(bookString);
     }
     /**
      * TODO: [🧠][🈴] Where is the best location for this file
@@ -15871,6 +17846,308 @@
         }
     }
 
+    /**
+     * Register for book transpilers.
+     *
+     * Note: `$` is used to indicate that this interacts with the global scope
+     * @singleton Only one instance of each register is created per build, but there can be more instances across different builds or environments.
+     * @see https://github.com/webgptorg/promptbook/issues/249
+     *
+     * @public exported from `@promptbook/core`
+     */
+    const $bookTranspilersRegister = new $Register('book_transpilers');
+    /**
+     * TODO: [®] DRY Register logic
+     */
+
+    /**
+     * Converts a book into a 1:1 formatted markdown
+     *
+     * @public exported from `@promptbook/core`
+     */
+    const FormattedBookInMarkdownTranspiler = {
+        name: 'formatted-book-in-markdown',
+        title: 'Formatted Book in Markdown',
+        packageName: '@promptbook/core',
+        className: 'FormattedBookInMarkdownTranspiler',
+        transpileBook(book, tools, options) {
+            let lines = book.trim( /* <- Note: Not using `spaceTrim` because its not needed */).split('\n');
+            if (lines[0]) {
+                lines[0] = `**<ins>${lines[0]}</ins>**`;
+            }
+            for (let i = 1; i < lines.length; i++) {
+                let line = lines[i];
+                line = line === null || line === void 0 ? void 0 : line.split('PERSONA').join('**PERSONA**');
+                line = line === null || line === void 0 ? void 0 : line.split('RULE').join('**RULE**');
+                line = line === null || line === void 0 ? void 0 : line.split('META').join('**META**');
+                line = line === null || line === void 0 ? void 0 : line.split('KNOWLEDGE').join('**KNOWLEDGE**');
+                line = line === null || line === void 0 ? void 0 : line.split('ACTION').join('**ACTION**');
+                // <- TODO: !!! Unhardcode these commitments
+                lines[i] = line;
+            }
+            // lines = lines.map((line) => `> ${line}`);
+            lines = lines.map((line) => `${line}<br/>`);
+            return lines.join('\n');
+        },
+    };
+
+    /**
+     * Transpiler to Javascript code using OpenAI SDK.
+     *
+     * @public exported from `@promptbook/core`
+     */
+    const OpenAiSdkTranspiler = {
+        name: 'openai-sdk',
+        title: 'OpenAI SDK',
+        packageName: '@promptbook/core',
+        className: 'OpenAiSdkTranspiler',
+        async transpileBook(book, tools, options) {
+            const { agentName } = await parseAgentSource(book);
+            const modelRequirements = await createAgentModelRequirements(book);
+            const { commitments } = parseAgentSourceWithCommitments(book);
+            const knowledgeCommitments = commitments.filter((commitment) => commitment.type === 'KNOWLEDGE');
+            const directKnowledge = knowledgeCommitments
+                .map((commitment) => commitment.content.trim())
+                .filter((content) => {
+                try {
+                    new URL(content);
+                    return false;
+                }
+                catch (_a) {
+                    return true;
+                }
+            });
+            const knowledgeSources = knowledgeCommitments
+                .map((commitment) => commitment.content.trim())
+                .filter((content) => {
+                try {
+                    new URL(content);
+                    return true;
+                }
+                catch (_a) {
+                    return false;
+                }
+            });
+            const KNOWLEDGE_THRESHOLD = 1000;
+            if (directKnowledge.join('\n').length > KNOWLEDGE_THRESHOLD || knowledgeSources.length > 0) {
+                return spaceTrim__default["default"]((block) => `
+                    #!/usr/bin/env node
+
+                    import * as dotenv from 'dotenv';
+                    dotenv.config({ path: '.env' });
+
+                    import { spaceTrim } from '@promptbook/utils';
+                    import OpenAI from 'openai';
+                    import readline from 'readline';
+                    import { Document, VectorStoreIndex, SimpleDirectoryReader } from 'llamaindex';
+
+                    // ---- CONFIG ----
+                    const client = new OpenAI({
+                        apiKey: process.env.OPENAI_API_KEY,
+                    });
+
+                    // ---- KNOWLEDGE ----
+                    const knowledge = ${block(JSON.stringify(directKnowledge, null, 4) /* <- TODO: Use here Promptbook stringify */)};
+                    const knowledgeSources = ${block(JSON.stringify(knowledgeSources, null, 4) /* <- TODO: Use here Promptbook stringify */)};
+                    let index;
+
+                    async function setupKnowledge() {
+                        const documents = knowledge.map((text) => new Document({ text }));
+
+                        for (const source of knowledgeSources) {
+                            try {
+                                // Note: SimpleDirectoryReader is a bit of a misnomer, it can read single files
+                                const reader = new SimpleDirectoryReader();
+                                const sourceDocuments = await reader.loadData(source);
+                                documents.push(...sourceDocuments);
+                            } catch (error) {
+                                console.error(\`Error loading knowledge from \${source}:\`, error);
+                            }
+                        }
+
+                        if (documents.length > 0) {
+                            index = await VectorStoreIndex.fromDocuments(documents);
+                            console.log('🧠 Knowledge base prepared.');
+                        }
+                    }
+
+                    // ---- CLI SETUP ----
+                    const rl = readline.createInterface({
+                        input: process.stdin,
+                        output: process.stdout,
+                    });
+
+                    const chatHistory = [
+                        {
+                            role: 'system',
+                            content: spaceTrim(\`
+                                ${block(modelRequirements.systemMessage)}
+                            \`),
+                        },
+                    ];
+
+                    async function ask(question) {
+                        let context = '';
+                        if (index) {
+                            const retriever = index.asRetriever();
+                            const relevantNodes = await retriever.retrieve(question);
+                            context = relevantNodes.map((node) => node.getContent()).join('\\n\\n');
+                        }
+
+                        const userMessage = spaceTrim(\`
+                            ${block(spaceTrim__default["default"](`
+                                    Here is some additional context to help you answer the question:
+                                    \${context}
+
+                                    ---
+
+                                    My question is:
+                                    \${question}
+                                `))}
+                        \`);
+
+
+                        chatHistory.push({ role: 'user', content: userMessage });
+
+                        const response = await client.chat.completions.create({
+                            model: 'gpt-4o',
+                            messages: chatHistory,
+                            temperature: ${modelRequirements.temperature},
+                        });
+
+                        const answer = response.choices[0].message.content;
+                        console.log('\\n🧠 ${agentName}:', answer, '\\n');
+
+                        chatHistory.push({ role: 'assistant', content: answer });
+                        promptUser();
+                    }
+
+                    function promptUser() {
+                        rl.question('💬 You: ', (input) => {
+                            if (input.trim().toLowerCase() === 'exit') {
+                                console.log('👋 Bye!');
+                                rl.close();
+                                return;
+                            }
+                            ask(input);
+                        });
+                    }
+
+                    (async () => {
+                        await setupKnowledge();
+                        console.log("🤖 Chat with ${agentName} (type 'exit' to quit)\\n");
+                        promptUser();
+                    })();
+                `);
+            }
+            const source = spaceTrim__default["default"]((block) => `
+
+                #!/usr/bin/env node
+
+                import * as dotenv from 'dotenv';
+
+                dotenv.config({ path: '.env' });
+
+                import { spaceTrim } from '@promptbook/utils';
+                import OpenAI from 'openai';
+                import readline from 'readline';
+
+                // ---- CONFIG ----
+                const client = new OpenAI({
+                    apiKey: process.env.OPENAI_API_KEY,
+                });
+
+                // ---- CLI SETUP ----
+                const rl = readline.createInterface({
+                    input: process.stdin,
+                    output: process.stdout,
+                });
+
+                const chatHistory = [
+                    {
+                        role: 'system',
+                        content: spaceTrim(\`
+                            ${block(modelRequirements.systemMessage)}
+                        \`),
+                    },
+                ];
+
+                async function ask(question) {
+                    chatHistory.push({ role: 'user', content: question });
+
+                    const response = await client.chat.completions.create({
+                        model: 'gpt-4o',
+                        messages: chatHistory,
+                        temperature: ${modelRequirements.temperature},
+                    });
+
+                    const answer = response.choices[0].message.content;
+                    console.log('\\n🧠 ${agentName}:', answer, '\\n');
+
+                    chatHistory.push({ role: 'assistant', content: answer });
+                    promptUser();
+                }
+
+                function promptUser() {
+                    rl.question('💬 You: ', (input) => {
+                        if (input.trim().toLowerCase() === 'exit') {
+                            console.log('👋 Bye!');
+                            rl.close();
+                            return;
+                        }
+                        ask(input);
+                    });
+                }
+
+                console.log("🤖 Chat with ${agentName} (type 'exit' to quit)\\n");
+                promptUser();
+
+            `);
+            return source;
+        },
+    };
+
+    /**
+     * Provide information about Promptbook, engine version, book language version, servers, ...
+     *
+     * @param options Which information to include
+     * @returns  Information about Promptbook in markdown format
+     *
+     * @public exported from `@promptbook/core`
+     */
+    function aboutPromptbookInformation(options) {
+        const { isServersInfoIncluded = true } = options || {};
+        const fullInfoPieces = [];
+        const basicInfo = spaceTrim__default["default"](`
+
+            # ${NAME}
+
+            ${CLAIM}
+
+            - [Promptbook engine version \`${PROMPTBOOK_ENGINE_VERSION}\`](https://github.com/webgptorg/promptbook)
+            - [Book language version \`${BOOK_LANGUAGE_VERSION}\`](https://github.com/webgptorg/book)
+
+        `);
+        fullInfoPieces.push(basicInfo);
+        if (isServersInfoIncluded) {
+            const serversInfo = spaceTrim__default["default"]((block) => `
+
+                ## Servers
+
+                ${block(REMOTE_SERVER_URLS.map(({ title, urls, isAnonymousModeAllowed, description }, index) => `${index + 1}. ${title} ${description}
+                        ${isAnonymousModeAllowed ? '🐱‍💻 ' : ''} ${urls.join(', ')}
+                    `).join('\n'))}
+            `);
+            fullInfoPieces.push(serversInfo);
+        }
+        const fullInfo = spaceTrim__default["default"](fullInfoPieces.join('\n\n'));
+        return fullInfo;
+    }
+    /**
+     * TODO: [🗽] Unite branding and make single place for it
+     */
+
+    exports.$bookTranspilersRegister = $bookTranspilersRegister;
     exports.$llmToolsMetadataRegister = $llmToolsMetadataRegister;
     exports.$llmToolsRegister = $llmToolsRegister;
     exports.$scrapersMetadataRegister = $scrapersMetadataRegister;
@@ -15879,6 +18156,7 @@
     exports.ADMIN_GITHUB_NAME = ADMIN_GITHUB_NAME;
     exports.API_REQUEST_TIMEOUT = API_REQUEST_TIMEOUT;
     exports.AbstractFormatError = AbstractFormatError;
+    exports.Agent = Agent;
     exports.AgentLlmExecutionTools = AgentLlmExecutionTools;
     exports.AuthenticationError = AuthenticationError;
     exports.BIG_DATASET_TRESHOLD = BIG_DATASET_TRESHOLD;
@@ -15894,6 +18172,7 @@
     exports.CompletionFormfactorDefinition = CompletionFormfactorDefinition;
     exports.CsvFormatError = CsvFormatError;
     exports.CsvFormatParser = CsvFormatParser;
+    exports.DEFAULT_AGENTS_DIRNAME = DEFAULT_AGENTS_DIRNAME;
     exports.DEFAULT_BOOK = DEFAULT_BOOK;
     exports.DEFAULT_BOOKS_DIRNAME = DEFAULT_BOOKS_DIRNAME;
     exports.DEFAULT_BOOK_OUTPUT_PARAMETER_NAME = DEFAULT_BOOK_OUTPUT_PARAMETER_NAME;
@@ -15922,6 +18201,7 @@
     exports.ExpectError = ExpectError;
     exports.FAILED_VALUE_PLACEHOLDER = FAILED_VALUE_PLACEHOLDER;
     exports.FORMFACTOR_DEFINITIONS = FORMFACTOR_DEFINITIONS;
+    exports.FormattedBookInMarkdownTranspiler = FormattedBookInMarkdownTranspiler;
     exports.GENERIC_PIPELINE_INTERFACE = GENERIC_PIPELINE_INTERFACE;
     exports.GeneratorFormfactorDefinition = GeneratorFormfactorDefinition;
     exports.GenericFormfactorDefinition = GenericFormfactorDefinition;
@@ -15939,10 +18219,13 @@
     exports.MultipleLlmExecutionTools = MultipleLlmExecutionTools;
     exports.NAME = NAME;
     exports.NonTaskSectionTypes = NonTaskSectionTypes;
+    exports.NotAllowed = NotAllowed;
     exports.NotFoundError = NotFoundError;
     exports.NotYetImplementedCommitmentDefinition = NotYetImplementedCommitmentDefinition;
     exports.NotYetImplementedError = NotYetImplementedError;
     exports.ORDER_OF_PIPELINE_JSON = ORDER_OF_PIPELINE_JSON;
+    exports.OpenAiSdkTranspiler = OpenAiSdkTranspiler;
+    exports.PADDING_LINES = PADDING_LINES;
     exports.PENDING_VALUE_PLACEHOLDER = PENDING_VALUE_PLACEHOLDER;
     exports.PLAYGROUND_APP_ID = PLAYGROUND_APP_ID;
     exports.PROMPTBOOK_CHAT_COLOR = PROMPTBOOK_CHAT_COLOR;
@@ -15950,6 +18233,7 @@
     exports.PROMPTBOOK_ENGINE_VERSION = PROMPTBOOK_ENGINE_VERSION;
     exports.PROMPTBOOK_ERRORS = PROMPTBOOK_ERRORS;
     exports.PROMPTBOOK_LOGO_URL = PROMPTBOOK_LOGO_URL;
+    exports.PROMPTBOOK_SYNTAX_COLORS = PROMPTBOOK_SYNTAX_COLORS;
     exports.ParseError = ParseError;
     exports.PipelineExecutionError = PipelineExecutionError;
     exports.PipelineLogicError = PipelineLogicError;
@@ -15988,10 +18272,10 @@
     exports._OpenAiMetadataRegistration = _OpenAiMetadataRegistration;
     exports._PdfScraperMetadataRegistration = _PdfScraperMetadataRegistration;
     exports._WebsiteScraperMetadataRegistration = _WebsiteScraperMetadataRegistration;
+    exports.aboutPromptbookInformation = aboutPromptbookInformation;
     exports.addUsage = addUsage;
     exports.book = book;
     exports.cacheLlmTools = cacheLlmTools;
-    exports.collectionToJson = collectionToJson;
     exports.compilePipeline = compilePipeline;
     exports.computeCosineSimilarity = computeCosineSimilarity;
     exports.countUsage = countUsage;
@@ -15999,13 +18283,13 @@
     exports.createAgentModelRequirements = createAgentModelRequirements;
     exports.createAgentModelRequirementsWithCommitments = createAgentModelRequirementsWithCommitments;
     exports.createBasicAgentModelRequirements = createBasicAgentModelRequirements;
-    exports.createCollectionFromJson = createCollectionFromJson;
-    exports.createCollectionFromPromise = createCollectionFromPromise;
-    exports.createCollectionFromUrl = createCollectionFromUrl;
     exports.createEmptyAgentModelRequirements = createEmptyAgentModelRequirements;
     exports.createLlmToolsFromConfiguration = createLlmToolsFromConfiguration;
+    exports.createPipelineCollectionFromJson = createPipelineCollectionFromJson;
+    exports.createPipelineCollectionFromPromise = createPipelineCollectionFromPromise;
+    exports.createPipelineCollectionFromUrl = createPipelineCollectionFromUrl;
     exports.createPipelineExecutor = createPipelineExecutor;
-    exports.createSubcollection = createSubcollection;
+    exports.createPipelineSubcollection = createPipelineSubcollection;
     exports.embeddingVectorToString = embeddingVectorToString;
     exports.executionReportJsonToString = executionReportJsonToString;
     exports.extractParameterNamesFromTask = extractParameterNamesFromTask;
@@ -16028,9 +18312,11 @@
     exports.limitTotalUsage = limitTotalUsage;
     exports.makeKnowledgeSourceHandler = makeKnowledgeSourceHandler;
     exports.migratePipeline = migratePipeline;
+    exports.padBook = padBook;
     exports.parseAgentSource = parseAgentSource;
     exports.parseParameters = parseParameters;
     exports.parsePipeline = parsePipeline;
+    exports.pipelineCollectionToJson = pipelineCollectionToJson;
     exports.pipelineJsonToString = pipelineJsonToString;
     exports.prepareKnowledgePieces = prepareKnowledgePieces;
     exports.preparePersona = preparePersona;