@promptbook/core 0.63.0-2 → 0.63.0-4

package/esm/typings/src/llm-providers/anthropic-claude/anthropic-claude-models.d.ts

@@ -6,6 +6,7 @@ import type { number_usd } from '../../types/typeAliases';
  * Note: Done at 2024-05-25
  *
  * @see https://docs.anthropic.com/en/docs/models-overview
+ * @public exported from `@promptbook/anthropic-claude`
  */
 export declare const ANTHROPIC_CLAUDE_MODELS: Array<AvailableModel & {
     pricing?: {

package/esm/typings/src/llm-providers/mocked/fakeTextToExpectations.d.ts

@@ -6,7 +6,7 @@ import type { Expectations } from '../../types/PipelineJson/Expectations';
  * Note: You can provide postprocessing functions to modify the text before checking the expectations
  *       The result will be the text BEFORE the postprocessing
  *
- * @private internal util for MockedFackedLlmExecutionTools
+ * @private internal utility for MockedFackedLlmExecutionTools
  */
 export declare function $fakeTextToExpectations(expectations: Expectations, postprocessing?: Array<PostprocessingFunction>): Promise<string>;
 /**

package/esm/typings/src/llm-providers/multiple/MultipleLlmExecutionTools.d.ts

@@ -12,7 +12,7 @@ import type { string_title } from '../../types/typeAliases';
 /**
  * Multiple LLM Execution Tools is a proxy server that uses multiple execution tools internally and exposes the executor interface externally.
  *
- * @private Internal utility of `joinLlmExecutionTools`
+ * @private internal utility of `joinLlmExecutionTools`
  */
 export declare class MultipleLlmExecutionTools implements LlmExecutionTools {
     /**

package/esm/typings/src/llm-providers/openai/computeOpenaiUsage.d.ts

@@ -8,7 +8,7 @@ import type { Prompt } from '../../types/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 util of `OpenAiExecutionTools`
+ * @private internal utility of `OpenAiExecutionTools`
  */
 export declare function computeOpenaiUsage(promptContent: Prompt['content'], // <- Note: Intentionally using [] to access type properties to bring jsdoc from Prompt/PromptResult to consumer
 resultContent: string, rawResponse: Pick<OpenAI.Chat.Completions.ChatCompletion | OpenAI.Completions.Completion | OpenAI.Embeddings.CreateEmbeddingResponse, 'model' | 'usage'>): PromptResultUsage;

package/esm/typings/src/scripting/javascript/utils/preserve.d.ts

@@ -5,6 +5,7 @@ import type { really_any } from '../../../utils/organization/really_any';
  *
  * @param value any function to preserve
  * @returns nothing
+ * @private internal function of `JavascriptExecutionTools` and `JavascriptEvalExecutionTools`
  */
 export declare function preserve(func: (...params: Array<really_any>) => unknown): void;
 /**

package/esm/typings/src/scripting/javascript/utils/unknownToString.d.ts

@@ -3,6 +3,6 @@ import type { really_unknown } from '../../../utils/organization/really_unknown'
  * Converts anything to string that can be used for debugging and logging
  *
  * @param value String value for logging
- * @private Internal util
+ * @private internal util
  */
 export declare function unknownToString(value: really_unknown): string;

package/esm/typings/src/scripting/python/PythonExecutionTools.d.ts

@@ -5,6 +5,8 @@ import type { ScriptExecutionToolsExecuteOptions } from '../../execution/ScriptE
  * ScriptExecutionTools for Python
  *
  * Warning: This is not implemented yet
+ *
+ * @private still in development
  */
 export declare class PythonExecutionTools implements ScriptExecutionTools {
     private readonly options;

package/esm/typings/src/scripting/typescript/TypescriptExecutionTools.d.ts

@@ -5,6 +5,8 @@ import type { ScriptExecutionToolsExecuteOptions } from '../../execution/ScriptE
  * ScriptExecutionTools for TypeScript
  *
  * Warning: This is not implemented yet
+ *
+ * @private still in development
  */
 export declare class TypescriptExecutionTools implements ScriptExecutionTools {
     private readonly options;

package/esm/typings/src/storage/files-storage/FilesStorage.d.ts

@@ -27,5 +27,5 @@ export declare class FilesStorage<TItem> implements PromptbookStorage<TItem> {
 }
 /**
  * TODO: [🌗] Maybe some checkers, not all valid JSONs are desired and valid values
- * Note: [🟢] This code should never be published outside of `@promptbook/node`
+ * Note: [🟢] This code should never be published outside of `@promptbook/node` and `@promptbook/cli` and `@promptbook/cli`
  */

package/esm/typings/src/types/Arrayable.d.ts

@@ -5,6 +5,6 @@
  * 2) Undefined represents empty array
  * 3) Array represents itself
  *
- * @private Internal utility type
+ * @private internal type
  */
 export type Arrayable<TItem> = TItem | Array<TItem> | undefined;

package/esm/typings/src/types/ModelVariant.d.ts

@@ -1,9 +1,4 @@
-/**
- * @@@
- *
- * @private for `ModelVariant` and `modelCommandParser`
- */
-export declare const MODEL_VARIANTS: readonly ["COMPLETION", "CHAT", "EMBEDDING"];
+import type { TupleToUnion } from 'type-fest';
 /**
  * Model variant describes the very general type of the model
  *
@@ -11,4 +6,10 @@ export declare const MODEL_VARIANTS: readonly ["COMPLETION", "CHAT", "EMBEDDING"
  * - **COMPLETION** - model that takes prompt and writes the rest of the text
  * - **CHAT** - model that takes prompt and previous messages and returns response
  */
-export type ModelVariant = typeof MODEL_VARIANTS[number];
+export type ModelVariant = TupleToUnion<typeof MODEL_VARIANTS>;
+/**
+ * @@@
+ *
+ * @private internal base for `ModelVariant` and `modelCommandParser`
+ */
+export declare const MODEL_VARIANTS: readonly ["COMPLETION", "CHAT", "EMBEDDING"];

package/esm/typings/src/types/PipelineJson/Expectations.d.ts

@@ -1,3 +1,4 @@
+import type { TupleToUnion } from 'type-fest';
 import type { number_integer } from '../typeAliases';
 import type { number_positive } from '../typeAliases';
 /**
@@ -6,6 +7,7 @@ import type { number_positive } from '../typeAliases';
  * For example 5 words, 3 sentences, 2 paragraphs, ...
  *
  * Note: Expectations are performed after all postprocessing steps
+ *
  * @see https://github.com/webgptorg/promptbook/discussions/30
  */
 export type Expectations = Partial<Record<Lowercase<ExpectationUnit>, {
@@ -13,17 +15,21 @@ export type Expectations = Partial<Record<Lowercase<ExpectationUnit>, {
     readonly max?: ExpectationAmount;
 }>>;
 /**
- * Units of text measurement
+ * Unit of text measurement
+ *
  * @see https://github.com/webgptorg/promptbook/discussions/30
  */
-export declare const EXPECTATION_UNITS: readonly ["CHARACTERS", "WORDS", "SENTENCES", "LINES", "PARAGRAPHS", "PAGES"];
+export type ExpectationUnit = TupleToUnion<typeof EXPECTATION_UNITS>;
 /**
- * Unit of text measurement
+ * Units of text measurement
+ *
  * @see https://github.com/webgptorg/promptbook/discussions/30
+ * @private internal base for `ExpectationUnit`
  */
-export type ExpectationUnit = typeof EXPECTATION_UNITS[number];
+export declare const EXPECTATION_UNITS: readonly ["CHARACTERS", "WORDS", "SENTENCES", "LINES", "PARAGRAPHS", "PAGES"];
 /**
  * Amount of text measurement
+ *
  * @see https://github.com/webgptorg/promptbook/discussions/30
  */
 export type ExpectationAmount = number_integer & (number_positive | 0);

package/esm/typings/src/types/ScriptLanguage.d.ts

@@ -1,9 +1,11 @@
 import type { TupleToUnion } from 'type-fest';
-/**
- * Supported script languages
- */
-export declare const SUPPORTED_SCRIPT_LANGUAGES: readonly ["javascript", "typescript", "python"];
 /**
  * Script language
  */
 export type ScriptLanguage = TupleToUnion<typeof SUPPORTED_SCRIPT_LANGUAGES>;
+/**
+ * Supported script languages
+ *
+ * @private internal base for `ScriptLanguage`
+ */
+export declare const SUPPORTED_SCRIPT_LANGUAGES: readonly ["javascript", "typescript", "python"];

package/esm/typings/src/types/execution-report/executionReportJsonToString.d.ts

@@ -10,4 +10,5 @@ export declare function executionReportJsonToString(executionReportJson: Executi
 /**
  * TODO: Add mermaid chart for every report
  * TODO: [🧠] Allow to filter out some parts of the report by options
+ * TODO: [🧠] Should be in generated file GENERATOR_WARNING
  */

package/esm/typings/src/types/typeAliases.d.ts

@@ -1,3 +1,4 @@
+import type { TupleToUnion } from 'type-fest';
 import { RESERVED_PARAMETER_NAMES } from '../config';
 /**
  * Semantic helper
@@ -111,7 +112,7 @@ export type Parameters = Exclude<Record<string_parameter_name, string_parameter_
  *
  * For example `"context"`
  */
-export type string_reserved_parameter_name = typeof RESERVED_PARAMETER_NAMES[number];
+export type string_reserved_parameter_name = TupleToUnion<typeof RESERVED_PARAMETER_NAMES>;
 /**
  * @@@
  */

package/esm/typings/src/utils/arrayableToArray.d.ts

@@ -6,6 +6,6 @@ import type { Arrayable } from '../types/Arrayable';
  * 2) Undefined returns empty array
  * 3) Array returns itself
  *
- * @private Internal utility
+ * @private internal utility
  */
 export declare function arrayableToArray<TItem>(input?: Arrayable<TItem>): Array<TItem>;

package/esm/typings/src/utils/deepFreeze.d.ts

@@ -2,19 +2,20 @@ import type { ReadonlyDeep } from 'type-fest';
 /**
  * @@@
  *
- * @returns The same object as the input, but deeply frozen
- *
  * Note: This function mutates the object and returns the original (but mutated-deep-freezed) object
+ *
+ * @returns The same object as the input, but deeply frozen
+ * @public exported from `@promptbook/utils`
  */
 export declare function deepFreeze<TObject>(objectValue: TObject): ReadonlyDeep<TObject>;
 /**
  * @@@
  * @@@
  *
- * @returns The same object as the input, but deeply frozen
- * @public exported from `@promptbook/utils`
- *
  * Note: This function mutates the object and returns the original (but mutated-deep-freezed) object
+ *
+ * @returns The same object as the input, but deeply frozen
+ * @private this is in comparison to `deepFreeze` a more specific utility and maybe not very good practice to use without specific reason and considerations
  */
 export declare function deepFreezeWithSameType<TObject>(objectValue: TObject): TObject;
 /**

package/esm/typings/src/utils/files/listAllFiles.d.ts

@@ -0,0 +1,14 @@
+import type { string_file_path } from '../../types/typeAliases';
+import type { string_folder_path } from '../../types/typeAliases';
+/**
+ * Reads all files in the directory
+ *
+ * @param path
+ * @param isRecursive
+ * @returns List of all files in the directory
+ * @private internal function of `createCollectionFromDirectory`
+ */
+export declare function listAllFiles(path: string_folder_path, isRecursive: boolean): Promise<Array<string_file_path>>;
+/**
+ * Note: [🟢] This code should never be published outside of `@promptbook/node` and `@promptbook/cli` and `@promptbook/cli`
+ */

package/esm/typings/src/utils/getCurrentIsoDate.d.ts

@@ -2,6 +2,6 @@ import type { string_date_iso8601 } from '../types/typeAliases';
 /**
  * Get current date in ISO 8601 format
  *
- * @private This is internal util of the promptbook
+ * @private internal utility
  */
 export declare function getCurrentIsoDate(): string_date_iso8601;

package/esm/typings/src/utils/markdown/extractOneBlockFromMarkdown.d.ts

@@ -16,5 +16,5 @@ import type { CodeBlock } from './extractAllBlocksFromMarkdown';
  */
 export declare function extractOneBlockFromMarkdown(markdown: string_markdown): CodeBlock;
 /***
- * TODO: [🍓][🌻] Decide of this is internal util, external util OR validator/postprocessor
+ * TODO: [🍓][🌻] Decide of this is internal utility, external util OR validator/postprocessor
  */

package/esm/typings/src/utils/normalization/normalizeWhitespaces.d.ts

@@ -1,4 +1,6 @@
 /**
- * Take every whitespace (space, new line, tab) and replace it with a single space.
+ * Take every whitespace (space, new line, tab) and replace it with a single space
+ *
+ * @public exported from `@promptbook/utils`
  */
 export declare function normalizeWhitespaces(sentence: string): string;

package/esm/typings/src/utils/validators/email/isValidEmail.d.ts

@@ -2,5 +2,7 @@ import type { string_email } from '../../../types/typeAliases';
 import type { really_unknown } from '../../organization/really_unknown';
 /**
  * Checks if value is valid email
+ *
+ * @public exported from `@promptbook/utils`
  */
 export declare function isValidEmail(email: really_unknown): email is string_email;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@promptbook/core",
-    "version": "0.63.0-2",
+    "version": "0.63.0-4",
     "description": "Supercharge your use of large language models",
     "private": false,
     "sideEffects": false,

package/umd/index.umd.js

@@ -15,7 +15,7 @@
     /**
      * The version of the Promptbook library
      */
-    var PROMPTBOOK_VERSION = '0.63.0-1';
+    var PROMPTBOOK_VERSION = '0.63.0-3';
     // TODO: !!!! List here all the versions and annotate + put into script
 
     /*! *****************************************************************************
@@ -393,7 +393,7 @@
         return pipelineString;
     }
     /**
-     * @private internal util of pipelineJsonToString
+     * @private internal utility of `pipelineJsonToString`
      */
     function promptTemplateParameterJsonToString(promptTemplateParameterJson) {
         var name = promptTemplateParameterJson.name, description = promptTemplateParameterJson.description;
@@ -408,14 +408,16 @@
      * TODO: [🧠] Is there a way to auto-detect missing features in pipelineJsonToString
      * TODO: [🏛] Maybe make some markdown builder
      * TODO: [🏛] Escape all
+     * TODO: [🧠] Should be in generated .ptbk.md file GENERATOR_WARNING
      */
 
     /**
      * @@@
      *
-     * @returns The same object as the input, but deeply frozen
-     *
      * Note: This function mutates the object and returns the original (but mutated-deep-freezed) object
+     *
+     * @returns The same object as the input, but deeply frozen
+     * @public exported from `@promptbook/utils`
      */
     function deepFreeze(objectValue) {
         var e_1, _a;
@@ -442,10 +444,10 @@
      * @@@
      * @@@
      *
-     * @returns The same object as the input, but deeply frozen
-     * @public exported from `@promptbook/utils`
-     *
      * Note: This function mutates the object and returns the original (but mutated-deep-freezed) object
+     *
+     * @returns The same object as the input, but deeply frozen
+     * @private this is in comparison to `deepFreeze` a more specific utility and maybe not very good practice to use without specific reason and considerations
      */
     function deepFreezeWithSameType(objectValue) {
         return deepFreeze(objectValue);
@@ -474,10 +476,16 @@
         return value;
     }
 
+    /**
+     * Warning message for the generated sections and files files
+     *
+     * @private within the repository
+     */
+    var GENERATOR_WARNING = "\u26A0\uFE0F WARNING: This section has been generated so that any manual changes will be overwritten";
     /**
      * The maximum number of iterations for a loops
      *
-     * @private within the repository - too low-level in comparison to other `MAX_...`
+     * @private within the repository - too low-level in comparison with other `MAX_...`
      */
     var LOOP_LIMIT = 1000;
     /**
@@ -526,6 +534,8 @@
     var PIPELINE_COLLECTION_BASE_FILENAME = "index";
     /**
      * Nonce which is used for replacing things in strings
+     *
+     * @private within the repository
      */
     var REPLACING_NONCE = 'u$k42k%!V2zo34w7Fu#@QUHYPW';
     /**
@@ -555,13 +565,15 @@
      * @private within the repository
      */
     var RESERVED_PARAMETER_RESTRICTED = 'RESTRICTED-' + REPLACING_NONCE;
-    /*
-    TODO: !!! Just testing false-negative detection of [🟡][🟢][🔵][⚪] leak
-    */
-    // [🟡][🟢][🔵][⚪]
     /**
-     * TODO: !!!!!! Check that all @private contains some normalized explanation
+     * The thresholds for the relative time in the `moment` NPM package.
+     *
+     * @see https://momentjscom.readthedocs.io/en/latest/moment/07-customization/13-relative-time-threshold/
+     * @private within the repository - too low-level in comparison with other constants
      */
+    var MOMENT_ARG_THRESHOLDS = {
+        ss: 3, // <- least number of seconds to be counted in seconds, minus 1. Must be set after setting the `s` unit or without setting the `s` unit.
+    };
 
     /**
      * This error indicates that the promptbook in a markdown format cannot be parsed into a valid promptbook object
@@ -1095,7 +1107,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 use `createCollectionFromJson` instead
+     * @private internal function of `createCollectionFromJson`, use `createCollectionFromJson` instead
      * @see https://github.com/webgptorg/pipeline#pipeline-collection
      */
     var SimplePipelineCollection = /** @class */ (function () {
@@ -1104,7 +1116,6 @@
          *
          * @param pipelines @@@
          *
-         * @private Use instead `createCollectionFromJson`
          * 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
          */
@@ -1613,7 +1624,7 @@
         });
     }
 
-    var PipelineCollection = [{title:"Prepare Knowledge from Markdown",pipelineUrl:"https://promptbook.studio/promptbook/prepare-knowledge-from-markdown.ptbk.md",promptbookVersion:"0.63.0-1",parameters:[{name:"knowledgeContent",description:"Markdown document content",isInput:true,isOutput:false},{name:"knowledgePieces",description:"The knowledge JSON object",isInput:false,isOutput:true}],promptTemplates:[{blockType:"PROMPT_TEMPLATE",name:"knowledge",title:"Knowledge",modelRequirements:{modelVariant:"CHAT",modelName:"claude-3-opus-20240229"},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}",dependentParameterNames:["knowledgeContent"],resultingParameterName:"knowledgePieces"}],knowledgeSources:[],knowledgePieces:[],personas:[],preparations:[{id:1,promptbookVersion:"0.63.0-1",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}}}}],sourceFile:"./promptbook-collection/prepare-knowledge-from-markdown.ptbk.md"},{title:"Prepare Keywords",pipelineUrl:"https://promptbook.studio/promptbook/prepare-knowledge-keywords.ptbk.md",promptbookVersion:"0.63.0-1",parameters:[{name:"knowledgePieceContent",description:"The content",isInput:true,isOutput:false},{name:"keywords",description:"Keywords separated by comma",isInput:false,isOutput:true}],promptTemplates:[{blockType:"PROMPT_TEMPLATE",name:"knowledge",title:"Knowledge",modelRequirements:{modelVariant:"CHAT",modelName:"claude-3-opus-20240229"},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}",dependentParameterNames:["knowledgePieceContent"],resultingParameterName:"keywords"}],knowledgeSources:[],knowledgePieces:[],personas:[],preparations:[{id:1,promptbookVersion:"0.63.0-1",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}}}}],sourceFile:"./promptbook-collection/prepare-knowledge-keywords.ptbk.md"},{title:"Prepare Title",pipelineUrl:"https://promptbook.studio/promptbook/prepare-knowledge-title.ptbk.md",promptbookVersion:"0.63.0-1",parameters:[{name:"knowledgePieceContent",description:"The content",isInput:true,isOutput:false},{name:"title",description:"The title of the document",isInput:false,isOutput:true}],promptTemplates:[{blockType:"PROMPT_TEMPLATE",name:"knowledge",title:"Knowledge",modelRequirements:{modelVariant:"CHAT",modelName:"claude-3-opus-20240229"},content:"You are experienced content creator, write best title for the document.\n\n# Rules\n\n-   Write just title, nothing else\n-   Title should be concise and clear\n-   Write maximum 5 words for the title\n\n# The document\n\n> {knowledgePieceContent}",expectations:{words:{min:1,max:8}},dependentParameterNames:["knowledgePieceContent"],resultingParameterName:"title"}],knowledgeSources:[],knowledgePieces:[],personas:[],preparations:[{id:1,promptbookVersion:"0.63.0-1",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}}}}],sourceFile:"./promptbook-collection/prepare-knowledge-title.ptbk.md"},{title:"Prepare Keywords",pipelineUrl:"https://promptbook.studio/promptbook/prepare-persona.ptbk.md",promptbookVersion:"0.63.0-1",parameters:[{name:"availableModelNames",description:"List of available model names separated by comma (,)",isInput:true,isOutput:false},{name:"personaDescription",description:"Description of the persona",isInput:true,isOutput:false},{name:"modelRequirements",description:"Specific requirements for the model",isInput:false,isOutput:true}],promptTemplates:[{blockType:"PROMPT_TEMPLATE",name:"make-model-requirements",title:"Make modelRequirements",modelRequirements:{modelVariant:"CHAT",modelName:"gpt-4-turbo"},content:"You are experienced AI engineer, you need to create virtual assistant.\nWrite\n\n## Sample\n\n```json\n{\n\"modelName\": \"gpt-4o\",\n\"systemMessage\": \"You are experienced AI engineer and helpfull assistant.\",\n\"temperature\": 0.7\n}\n```\n\n## Instructions\n\n### Option `modelName`\n\nPick from the following models:\n\n-   {availableModelNames}\n\n### Option `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### Option `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}",expectFormat:"JSON",dependentParameterNames:["availableModelNames","personaDescription"],resultingParameterName:"modelRequirements"}],knowledgeSources:[],knowledgePieces:[],personas:[],preparations:[{id:1,promptbookVersion:"0.63.0-1",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}}}}],sourceFile:"./promptbook-collection/prepare-persona.ptbk.md"}];
+    var PipelineCollection = [{title:"Prepare Knowledge from Markdown",pipelineUrl:"https://promptbook.studio/promptbook/prepare-knowledge-from-markdown.ptbk.md",promptbookVersion:"0.63.0-3",parameters:[{name:"knowledgeContent",description:"Markdown document content",isInput:true,isOutput:false},{name:"knowledgePieces",description:"The knowledge JSON object",isInput:false,isOutput:true}],promptTemplates:[{blockType:"PROMPT_TEMPLATE",name:"knowledge",title:"Knowledge",modelRequirements:{modelVariant:"CHAT",modelName:"claude-3-opus-20240229"},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}",dependentParameterNames:["knowledgeContent"],resultingParameterName:"knowledgePieces"}],knowledgeSources:[],knowledgePieces:[],personas:[],preparations:[{id:1,promptbookVersion:"0.63.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}}}}],sourceFile:"./promptbook-collection/prepare-knowledge-from-markdown.ptbk.md"},{title:"Prepare Keywords",pipelineUrl:"https://promptbook.studio/promptbook/prepare-knowledge-keywords.ptbk.md",promptbookVersion:"0.63.0-3",parameters:[{name:"knowledgePieceContent",description:"The content",isInput:true,isOutput:false},{name:"keywords",description:"Keywords separated by comma",isInput:false,isOutput:true}],promptTemplates:[{blockType:"PROMPT_TEMPLATE",name:"knowledge",title:"Knowledge",modelRequirements:{modelVariant:"CHAT",modelName:"claude-3-opus-20240229"},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}",dependentParameterNames:["knowledgePieceContent"],resultingParameterName:"keywords"}],knowledgeSources:[],knowledgePieces:[],personas:[],preparations:[{id:1,promptbookVersion:"0.63.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}}}}],sourceFile:"./promptbook-collection/prepare-knowledge-keywords.ptbk.md"},{title:"Prepare Title",pipelineUrl:"https://promptbook.studio/promptbook/prepare-knowledge-title.ptbk.md",promptbookVersion:"0.63.0-3",parameters:[{name:"knowledgePieceContent",description:"The content",isInput:true,isOutput:false},{name:"title",description:"The title of the document",isInput:false,isOutput:true}],promptTemplates:[{blockType:"PROMPT_TEMPLATE",name:"knowledge",title:"Knowledge",modelRequirements:{modelVariant:"CHAT",modelName:"claude-3-opus-20240229"},content:"You are experienced content creator, write best title for the document.\n\n# Rules\n\n-   Write just title, nothing else\n-   Title should be concise and clear\n-   Write maximum 5 words for the title\n\n# The document\n\n> {knowledgePieceContent}",expectations:{words:{min:1,max:8}},dependentParameterNames:["knowledgePieceContent"],resultingParameterName:"title"}],knowledgeSources:[],knowledgePieces:[],personas:[],preparations:[{id:1,promptbookVersion:"0.63.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}}}}],sourceFile:"./promptbook-collection/prepare-knowledge-title.ptbk.md"},{title:"Prepare Keywords",pipelineUrl:"https://promptbook.studio/promptbook/prepare-persona.ptbk.md",promptbookVersion:"0.63.0-3",parameters:[{name:"availableModelNames",description:"List of available model names separated by comma (,)",isInput:true,isOutput:false},{name:"personaDescription",description:"Description of the persona",isInput:true,isOutput:false},{name:"modelRequirements",description:"Specific requirements for the model",isInput:false,isOutput:true}],promptTemplates:[{blockType:"PROMPT_TEMPLATE",name:"make-model-requirements",title:"Make modelRequirements",modelRequirements:{modelVariant:"CHAT",modelName:"gpt-4-turbo"},content:"You are experienced AI engineer, you need to create virtual assistant.\nWrite\n\n## Sample\n\n```json\n{\n\"modelName\": \"gpt-4o\",\n\"systemMessage\": \"You are experienced AI engineer and helpfull assistant.\",\n\"temperature\": 0.7\n}\n```\n\n## Instructions\n\n### Option `modelName`\n\nPick from the following models:\n\n-   {availableModelNames}\n\n### Option `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### Option `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}",expectFormat:"JSON",dependentParameterNames:["availableModelNames","personaDescription"],resultingParameterName:"modelRequirements"}],knowledgeSources:[],knowledgePieces:[],personas:[],preparations:[{id:1,promptbookVersion:"0.63.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}}}}],sourceFile:"./promptbook-collection/prepare-persona.ptbk.md"}];
 
     var defaultDiacriticsRemovalMap = [
         {
@@ -2137,7 +2148,8 @@
     /**
      * This error occurs when some expectation is not met in the execution of the pipeline
      *
-     * @private Always catched and rethrown as `PipelineExecutionError`
+     * @private error of `checkExpectations` and `createPipelineExecutor`
+     * Note: Always thrown in `checkExpectations` and catched in `createPipelineExecutor` and rethrown as `PipelineExecutionError`
      * Note: This is a kindof subtype of PipelineExecutionError
      */
     var ExpectError = /** @class */ (function (_super) {
@@ -2175,7 +2187,7 @@
     /**
      * Multiple LLM Execution Tools is a proxy server that uses multiple execution tools internally and exposes the executor interface externally.
      *
-     * @private Internal utility of `joinLlmExecutionTools`
+     * @private internal utility of `joinLlmExecutionTools`
      */
     var MultipleLlmExecutionTools = /** @class */ (function () {
         /**
@@ -2458,7 +2470,7 @@
      * 2) Undefined returns empty array
      * 3) Array returns itself
      *
-     * @private Internal utility
+     * @private internal utility
      */
     function arrayableToArray(input) {
         if (input === undefined) {
@@ -2756,7 +2768,7 @@
      *
      * @throws {ExpectError} if the expectations are not met
      * @returns {void} Nothing
-     * @public exported from `@promptbook/core`
+     * @private internal function of `createPipelineExecutor`
      */
     function checkExpectations(expectations, value) {
         var e_1, _a;
@@ -4441,7 +4453,9 @@
 
     /**
      * Units of text measurement
+     *
      * @see https://github.com/webgptorg/promptbook/discussions/30
+     * @private internal base for `ExpectationUnit`
      */
     var EXPECTATION_UNITS = ['CHARACTERS', 'WORDS', 'SENTENCES', 'LINES', 'PARAGRAPHS', 'PAGES'];
     /**
@@ -4681,7 +4695,7 @@
     /**
      * @@@
      *
-     * @private for `ModelVariant` and `modelCommandParser`
+     * @private internal base for `ModelVariant` and `modelCommandParser`
      */
     var MODEL_VARIANTS = ['COMPLETION', 'CHAT', 'EMBEDDING' /* <- TODO [🏳] */ /* <- [🤖] */];
 
@@ -5146,11 +5160,12 @@
     };
     /**
      * TODO: [💐] Implement BOILERPLATE command into `pipelineStringToJsonSync` function
-     * Note: [⚪] This should never be in any released package
      */
 
     /**
      * All available command parsers
+     *
+     * @private internal index of `parseCommand`
      */
     var COMMANDS = [
         blockCommandParser,
@@ -5320,6 +5335,8 @@
 
     /**
      * Supported script languages
+     *
+     * @private internal base for `ScriptLanguage`
      */
     var SUPPORTED_SCRIPT_LANGUAGES = ['javascript', 'typescript', 'python'];
 
@@ -5460,7 +5477,7 @@
         return codeBlocks[0];
     }
     /***
-     * TODO: [🍓][🌻] Decide of this is internal util, external util OR validator/postprocessor
+     * TODO: [🍓][🌻] Decide of this is internal utility, external util OR validator/postprocessor
      */
 
     /**
@@ -6059,6 +6076,7 @@
     /**
      * TODO: [🏏] Leverage the batch API and build queues @see https://platform.openai.com/docs/guides/batch
      * TODO: [🛠] Actions, instruments (and maybe knowledge) => Functions and tools
+     * TODO: [🧠] Should be in generated JSON file GENERATOR_WARNING
      */
 
     /**
@@ -6068,7 +6086,7 @@
      */
     function addAutoGeneratedSection(content, options) {
         var sectionName = options.sectionName, sectionContent = options.sectionContent;
-        var warningLine = "<!-- \u26A0\uFE0F WARNING: This section was auto-generated -->";
+        var warningLine = "<!-- ".concat(GENERATOR_WARNING, " -->");
         var sectionRegex = new RegExp("<!--".concat(sectionName, "-->([\\s\\S]*?)<!--/").concat(sectionName, "-->"), 'g');
         var sectionMatch = content.match(sectionRegex);
         if (sectionMatch) {
@@ -6412,43 +6430,6 @@
         return CallbackInterfaceTools;
     }());
 
-    /**
-     * Wrapper around `window.prompt` synchronous function that interacts with the user via browser prompt
-     *
-     * Warning: It is used for testing and mocking
-     *          **NOT intended to use in the production** due to its synchronous nature.
-     *
-     * @public exported from `@promptbook/core`
-     */
-    var SimplePromptInterfaceTools = /** @class */ (function () {
-        function SimplePromptInterfaceTools(options) {
-            if (options === void 0) { options = {}; }
-            this.options = options;
-        }
-        /**
-         * Trigger window.PROMPT DIALOG
-         */
-        SimplePromptInterfaceTools.prototype.promptDialog = function (options) {
-            return __awaiter(this, void 0, void 0, function () {
-                var answer;
-                return __generator(this, function (_a) {
-                    answer = window.prompt(spaceTrim.spaceTrim(function (block) { return "\n                    ".concat(block(options.promptTitle), "\n\n                    ").concat(block(options.promptMessage), "\n                "); }));
-                    if (this.options.isVerbose) {
-                        console.info(spaceTrim.spaceTrim(function (block) { return "\n                        \uD83D\uDCD6 ".concat(block(options.promptTitle), "\n                        \uD83D\uDC64 ").concat(block(answer || '🚫 User cancelled prompt'), "\n                    "); }));
-                    }
-                    if (answer === null) {
-                        throw new PipelineExecutionError('User cancelled prompt');
-                    }
-                    return [2 /*return*/, answer];
-                });
-            });
-        };
-        return SimplePromptInterfaceTools;
-    }());
-    /**
-     * Note: [🔵] This code should never be published outside of `@promptbook/browser`
-     */
-
     /**
      * Stores
      *
@@ -6815,15 +6796,6 @@
         chartsWidth: 36,
     };
 
-    /**
-     * The thresholds for the relative time in the `moment` NPM package.
-     *
-     * @see https://momentjscom.readthedocs.io/en/latest/moment/07-customization/13-relative-time-threshold/
-     */
-    var MOMENT_ARG_THRESHOLDS = {
-        ss: 3, // <- least number of seconds to be counted in seconds, minus 1. Must be set after setting the `s` unit or without setting the `s` unit.
-    };
-
     /**
      * Count the duration of working time
      *
@@ -7028,6 +7000,7 @@
     /**
      * TODO: Add mermaid chart for every report
      * TODO: [🧠] Allow to filter out some parts of the report by options
+     * TODO: [🧠] Should be in generated file GENERATOR_WARNING
      */
 
     exports.BlockTypes = BlockTypes;
@@ -7053,14 +7026,12 @@
     exports.PrefixStorage = PrefixStorage;
     exports.RESERVED_PARAMETER_NAMES = RESERVED_PARAMETER_NAMES;
     exports.ReferenceError = ReferenceError$1;
-    exports.SimplePromptInterfaceTools = SimplePromptInterfaceTools;
     exports.UnexpectedError = UnexpectedError;
     exports.VersionMismatchError = VersionMismatchError;
     exports.ZERO_USAGE = ZERO_USAGE;
     exports.addUsage = addUsage;
     exports.assertsExecutionSuccessful = assertsExecutionSuccessful;
     exports.cacheLlmTools = cacheLlmTools;
-    exports.checkExpectations = checkExpectations;
     exports.collectionToJson = collectionToJson;
     exports.countTotalUsage = countTotalUsage;
     exports.createCollectionFromJson = createCollectionFromJson;