@promptbook/types 0.75.0-2 → 0.75.1

package/README.md

@@ -2,8 +2,6 @@
 
 # ![Promptbook logo - cube with letters P and B](./other/design/logo-h1.png) Promptbook
 
-Build responsible, controlled and transparent applications on top of LLM models!
-
 
 
 
@@ -25,10 +23,6 @@ Build responsible, controlled and transparent applications on top of LLM models!
 
 
 
-<blockquote style="color: #ff8811">
-    <b>⚠ Warning:</b> This is a pre-release version of the library. It is not yet ready for production use. Please look at <a href="https://www.npmjs.com/package/@promptbook/core?activeTab=versions">latest stable release</a>.
-</blockquote>
-
 ## 📦 Package `@promptbook/types`
 
 - Promptbooks are [divided into several](#-packages) packages, all are published from [single monorepo](https://github.com/webgptorg/promptbook).
@@ -76,28 +70,33 @@ _Note: `@promptbook/types` does not export brand-specific types like `OpenAiExec
 
 Rest of the documentation is common for **entire promptbook ecosystem**:
 
-## 🤍 The Promptbook Whitepaper
 
-If you have a simple, single prompt for ChatGPT, GPT-4, Anthropic Claude, Google Gemini, Llama 3, or whatever, it doesn't matter how you integrate it. Whether it's calling a REST API directly, using the SDK, hardcoding the prompt into the source code, or importing a text file, the process remains the same.
 
-But often you will struggle with the **limitations of LLMs**, such as **hallucinations, off-topic responses, poor quality output, language and prompt drift, word repetition repetition repetition repetition or misuse, lack of context, or just plain w𝒆𝐢rd resp0nses**. When this happens, you generally have three options:
 
-1. **Fine-tune** the model to your specifications or even train your own.
-2. **Prompt-engineer** the prompt to the best shape you can achieve.
-3. Orchestrate **multiple prompts** in a [pipeline](https://github.com/webgptorg/promptbook/discussions/64) to get the best result.
+## 🤍 The Book Abstract
+
+**It's time for a paradigm shift! The future of software is in plain English, French or Latin.**
+
+During the computer revolution, we have seen [multiple generations of computer languages](https://github.com/webgptorg/promptbook/discussions/180), from the physical rewiring of the vacuum tubes through low-level machine code to the high-level languages like Python or JavaScript. And now, we're on the edge of the **next revolution**!
+
+It's a revolution of writing software in plain human language that is understandable and executable by both humans and machines – and it's going to change everything!
+
+The incredible growth in power of microprocessors and the Moore's Law have been the driving force behind the ever-more powerful languages, and it's been an amazing journey! Similarly, the large language models (like GPT or Claude) are the next big thing in language technology, and they're set to transform the way we interact with computers.
 
-In all of these situations, but especially in 3., the **✨ Promptbook can make your life waaaaaaaaaay easier**.
+This shift is going to happen, whether we are ready for it or not. Our mission is to make it excellently, not just good.
 
--   [**Separates concerns**](https://github.com/webgptorg/promptbook/discussions/32) between prompt-engineer and programmer, between code files and prompt files, and between prompts and their execution logic. For this purpose, it introduces a new language called [the **💙 Book**](https://github.com/webgptorg/book).
--   Book allows you to **focus on the business** logic without having to write code or deal with the technicalities of LLMs.
--   **Forget** about **low-level details** like choosing the right model, tokens, context size, `temperature`, `top-k`, `top-p`, or kernel sampling. **Just write your intent** and [**persona**](https://github.com/webgptorg/promptbook/discussions/22) who should be responsible for the task and let the library do the rest.
--   We have built-in **orchestration** of [pipeline](https://github.com/webgptorg/promptbook/discussions/64) execution and many tools to make the process easier, more reliable, and more efficient, such as caching, [compilation+preparation](https://github.com/webgptorg/promptbook/discussions/78), [just-in-time fine-tuning](https://github.com/webgptorg/promptbook/discussions/33), [expectation-aware generation](https://github.com/webgptorg/promptbook/discussions/37), [agent adversary expectations](https://github.com/webgptorg/promptbook/discussions/39), and more.
--   Sometimes even the best prompts with the best framework like Promptbook `:)` can't avoid the problems. In this case, the library has built-in **[anomaly detection](https://github.com/webgptorg/promptbook/discussions/40) and logging** to help you find and fix the problems.
--   Versioning is build in. You can test multiple **A/B versions** of pipelines and see which one works best.
--   Promptbook is designed to use [**RAG** (Retrieval-Augmented Generation)](https://github.com/webgptorg/promptbook/discussions/41) and other advanced techniques to bring the context of your business to generic LLM. You can use **knowledge** to improve the quality of the output.
+**Join us in this journey!**
 
 
 
+## 🚀 Get started
+
+Take a look at the simple starter kit with books integrated into the **Hello World** sample applications:
+
+-   [Hello Book](https://github.com/webgptorg/hello-world)
+-   [Hello Book in Node.js](https://github.com/webgptorg/hello-world-node-js)
+-   [Hello Book in Next.js](https://github.com/webgptorg/hello-world-next-js)
+
 
 
 
@@ -116,7 +115,7 @@ Promptbook project is ecosystem of multiple projects and tools, following is a l
   <tbody>
     <tr>
       <td>Core</td>
-      <td>Promptbook core is a description and documentation of basic innerworkings how should be Promptbook implemented and defines which fetures must be descriable by book language</td>
+      <td>Promptbook Core is a description and documentation of the basic concepts, ideas and inner workings of how Promptbook should be implemented, and defines what features must be describable by book language.</td>
       <td rowspan=2>https://ptbk.io<br/>https://github.com/webgptorg/book</td>
     </tr>
     <tr>
@@ -127,17 +126,23 @@ Promptbook project is ecosystem of multiple projects and tools, following is a l
     </tr>
     <tr>
       <td>Promptbook typescript project</td>
-      <td>Implementation of Promptbook in TypeScript published into multiple packages to NPM</td>
+      <td>Promptbook implementation in TypeScript released as multiple NPM packages</td>
       <td>https://github.com/webgptorg/promptbook + Multiple packages on NPM</td>
     </tr>
     <tr>
       <td>Promptbook studio</td>
-      <td>No-code studio to write book without need to write even the markdown</td>
-      <td rowspan=2>https://promptbook.studio<br/>https://github.com/hejny/promptbook-studio</td>
-    </tr>
-    <tr>
-      <td>Promptbook miniapps</td>
-      <td>Builder of LLM miniapps from book notation</td>
+      <td>Studio to write Books and instantly publish them as miniapps</td>
+      <td>
+        https://promptbook.studio<br/>
+        https://github.com/hejny/promptbook-studio</td>
+      </tr><tr>
+      <td>Hello World</td>
+      <td>Simple starter kit with Books integrated into the sample applications</td>
+       <td>
+          https://github.com/webgptorg/hello-world<br/>
+          https://github.com/webgptorg/hello-world-node-js<br/>
+          https://github.com/webgptorg/hello-world-next-js
+       </td>
     </tr>
   </tbody>
 </table>
@@ -206,7 +211,9 @@ Reserved words:
 
 #### Parameter notation
 
-### Template
+### Task
+
+### Task type
 
 Todo todo
 
@@ -267,6 +274,11 @@ Or you can install them separately:
 
 ## 📚 Dictionary
 
+
+
+
+
+
 ### 📚 Dictionary
 
 The following glossary is used to clarify certain concepts:
@@ -282,6 +294,8 @@ The following glossary is used to clarify certain concepts:
 -   **Retrieval-augmented generation** is a machine learning paradigm where a model generates text by retrieving relevant information from a large database of text. This approach combines the benefits of generative models and retrieval models.
 -   **Longtail** refers to non-common or rare events, items, or entities that are not well-represented in the training data of machine learning models. Longtail items are often challenging for models to predict accurately.
 
+
+
 _Note: Thos section is not complete dictionary, more list of general AI / LLM terms that has connection with Promptbook_
 
 #### Promptbook core
@@ -318,7 +332,7 @@ _Note: Thos section is not complete dictionary, more list of general AI / LLM te
 
 -   [📚 Collection of pipelines](https://github.com/webgptorg/promptbook/discussions/65)
 -   [📯 Pipeline](https://github.com/webgptorg/promptbook/discussions/64)
--   [🎺 Pipeline templates](https://github.com/webgptorg/promptbook/discussions/88)
+-   [🙇‍♂️ Tasks and pipeline sections](https://github.com/webgptorg/promptbook/discussions/88)
 -   [🤼 Personas](https://github.com/webgptorg/promptbook/discussions/22)
 -   [⭕ Parameters](https://github.com/webgptorg/promptbook/discussions/83)
 -   [🚀 Pipeline execution](https://github.com/webgptorg/promptbook/discussions/84)
@@ -342,6 +356,8 @@ _Note: Thos section is not complete dictionary, more list of general AI / LLM te
 -   [👮 Agent adversary expectations](https://github.com/webgptorg/promptbook/discussions/39)
 -   [view more](https://github.com/webgptorg/promptbook/discussions/categories/concepts)
 
+
+
 ### Terms specific to Promptbook TypeScript implementation
 
 -   Anonymous mode

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

@@ -4,9 +4,10 @@ import { createCollectionFromJson } from '../collection/constructors/createColle
 import { createCollectionFromPromise } from '../collection/constructors/createCollectionFromPromise';
 import { createCollectionFromUrl } from '../collection/constructors/createCollectionFromUrl';
 import { createSubcollection } from '../collection/constructors/createSubcollection';
-import type { SectionType } from '../commands/SECTION/SectionType';
-import { SectionTypes } from '../commands/SECTION/SectionType';
+import { NAME } from '../config';
 import { CLAIM } from '../config';
+import { LOGO_LIGHT_SRC } from '../config';
+import { LOGO_DARK_SRC } from '../config';
 import { DEFAULT_TITLE } from '../config';
 import { MAX_FILENAME_LENGTH } from '../config';
 import { DEFAULT_INTERMEDIATE_FILES_STRATEGY } from '../config';
@@ -14,6 +15,7 @@ import { DEFAULT_MAX_PARALLEL_COUNT } from '../config';
 import { DEFAULT_MAX_EXECUTION_ATTEMPTS } from '../config';
 import { DEFAULT_MAX_KNOWLEDGE_SOURCES_SCRAPING_DEPTH } from '../config';
 import { DEFAULT_MAX_KNOWLEDGE_SOURCES_SCRAPING_TOTAL } from '../config';
+import { DEFAULT_BOOKS_DIRNAME } from '../config';
 import { DEFAULT_EXECUTIONS_CACHE_DIRNAME } from '../config';
 import { DEFAULT_SCRAPE_CACHE_DIRNAME } from '../config';
 import { DEFAULT_PIPELINE_COLLECTION_BASE_FILENAME } from '../config';
@@ -64,6 +66,7 @@ import { MANDATORY_CSV_SETTINGS } from '../formats/csv/CsvSettings';
 import { TextFormatDefinition } from '../formats/text/TextFormatDefinition';
 import { BoilerplateFormfactorDefinition } from '../formfactors/_boilerplate/BoilerplateFormfactorDefinition';
 import { ChatbotFormfactorDefinition } from '../formfactors/chatbot/ChatbotFormfactorDefinition';
+import { GeneratorFormfactorDefinition } from '../formfactors/generator/GeneratorFormfactorDefinition';
 import { GenericFormfactorDefinition } from '../formfactors/generic/GenericFormfactorDefinition';
 import { FORMFACTOR_DEFINITIONS } from '../formfactors/index';
 import { MatcherFormfactorDefinition } from '../formfactors/matcher/MatcherFormfactorDefinition';
@@ -104,15 +107,19 @@ import { BlackholeStorage } from '../storage/blackhole/BlackholeStorage';
 import { MemoryStorage } from '../storage/memory/MemoryStorage';
 import { PrefixStorage } from '../storage/utils/PrefixStorage';
 import { MODEL_VARIANTS } from '../types/ModelVariant';
+import { NonTaskSectionTypes } from '../types/SectionType';
+import { SectionTypes } from '../types/SectionType';
+import { TaskTypes } from '../types/TaskType';
 export { BOOK_LANGUAGE_VERSION, PROMPTBOOK_ENGINE_VERSION };
 export { collectionToJson };
 export { createCollectionFromJson };
 export { createCollectionFromPromise };
 export { createCollectionFromUrl };
 export { createSubcollection };
-export type { SectionType };
-export { SectionTypes };
+export { NAME };
 export { CLAIM };
+export { LOGO_LIGHT_SRC };
+export { LOGO_DARK_SRC };
 export { DEFAULT_TITLE };
 export { MAX_FILENAME_LENGTH };
 export { DEFAULT_INTERMEDIATE_FILES_STRATEGY };
@@ -120,6 +127,7 @@ export { DEFAULT_MAX_PARALLEL_COUNT };
 export { DEFAULT_MAX_EXECUTION_ATTEMPTS };
 export { DEFAULT_MAX_KNOWLEDGE_SOURCES_SCRAPING_DEPTH };
 export { DEFAULT_MAX_KNOWLEDGE_SOURCES_SCRAPING_TOTAL };
+export { DEFAULT_BOOKS_DIRNAME };
 export { DEFAULT_EXECUTIONS_CACHE_DIRNAME };
 export { DEFAULT_SCRAPE_CACHE_DIRNAME };
 export { DEFAULT_PIPELINE_COLLECTION_BASE_FILENAME };
@@ -170,6 +178,7 @@ export { MANDATORY_CSV_SETTINGS };
 export { TextFormatDefinition };
 export { BoilerplateFormfactorDefinition };
 export { ChatbotFormfactorDefinition };
+export { GeneratorFormfactorDefinition };
 export { GenericFormfactorDefinition };
 export { FORMFACTOR_DEFINITIONS };
 export { MatcherFormfactorDefinition };
@@ -210,3 +219,6 @@ export { BlackholeStorage };
 export { MemoryStorage };
 export { PrefixStorage };
 export { MODEL_VARIANTS };
+export { NonTaskSectionTypes };
+export { SectionTypes };
+export { TaskTypes };

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

@@ -9,7 +9,6 @@ import type { CommandUsagePlace } from '../commands/_common/types/CommandUsagePl
 import type { ExpectCommand } from '../commands/EXPECT/ExpectCommand';
 import type { ForeachJson } from '../commands/FOREACH/ForeachJson';
 import type { FormatCommand } from '../commands/FORMAT/FormatCommand';
-import type { SectionType } from '../commands/SECTION/SectionType';
 import type { PrettifyOptions } from '../conversion/prettify/PrettifyOptions';
 import type { renderPipelineMermaidOptions } from '../conversion/prettify/renderPipelineMermaidOptions';
 import type { CallbackInterfaceToolsOptions } from '../dialogs/callback/CallbackInterfaceToolsOptions';
@@ -76,6 +75,7 @@ import type { CollectionRemoteServerOptions } from '../llm-providers/remote/inte
 import type { CollectionRemoteServerClientOptions } from '../llm-providers/remote/interfaces/RemoteServerOptions';
 import type { IsPipelineImplementingInterfaceOptions } from '../pipeline/PipelineInterface/isPipelineImplementingInterface';
 import type { PipelineInterface } from '../pipeline/PipelineInterface/PipelineInterface';
+import type { CommonTaskJson } from '../pipeline/PipelineJson/CommonTaskJson';
 import type { DialogTaskJson } from '../pipeline/PipelineJson/DialogTaskJson';
 import type { Expectations } from '../pipeline/PipelineJson/Expectations';
 import type { ExpectationUnit } from '../pipeline/PipelineJson/Expectations';
@@ -96,7 +96,6 @@ import type { PromptTaskJson } from '../pipeline/PipelineJson/PromptTaskJson';
 import type { ScriptTaskJson } from '../pipeline/PipelineJson/ScriptTaskJson';
 import type { SimpleTaskJson } from '../pipeline/PipelineJson/SimpleTaskJson';
 import type { TaskJson } from '../pipeline/PipelineJson/TaskJson';
-import type { TaskJsonCommon } from '../pipeline/PipelineJson/TaskJsonCommon';
 import type { PipelineString } from '../pipeline/PipelineString';
 import type { PrepareAndScrapeOptions } from '../prepare/PrepareAndScrapeOptions';
 import type { Converter } from '../scrapers/_common/Converter';
@@ -120,7 +119,9 @@ import type { CompletionPrompt } from '../types/Prompt';
 import type { ChatPrompt } from '../types/Prompt';
 import type { EmbeddingPrompt } from '../types/Prompt';
 import type { ScriptLanguage } from '../types/ScriptLanguage';
+import type { SectionType } from '../types/SectionType';
 import type { TaskProgress } from '../types/TaskProgress';
+import type { TaskType } from '../types/TaskType';
 import type { string_char_emoji } from '../types/typeAliasEmoji';
 import type { string_business_category_name } from '../types/typeAliases';
 import type { string_model_name } from '../types/typeAliases';
@@ -165,7 +166,7 @@ import type { string_css_selector } from '../types/typeAliases';
 import type { string_url } from '../types/typeAliases';
 import type { string_base_url } from '../types/typeAliases';
 import type { string_pipeline_url } from '../types/typeAliases';
-import type { string_pipeline_url_with_hashtemplate } from '../types/typeAliases';
+import type { string_pipeline_url_with_task_hash } from '../types/typeAliases';
 import type { string_data_url } from '../types/typeAliases';
 import type { string_base64 } from '../types/typeAliases';
 import type { string_href } from '../types/typeAliases';
@@ -262,7 +263,6 @@ export type { CommandUsagePlace };
 export type { ExpectCommand };
 export type { ForeachJson };
 export type { FormatCommand };
-export type { SectionType };
 export type { PrettifyOptions };
 export type { renderPipelineMermaidOptions };
 export type { CallbackInterfaceToolsOptions };
@@ -329,6 +329,7 @@ export type { CollectionRemoteServerOptions };
 export type { CollectionRemoteServerClientOptions };
 export type { IsPipelineImplementingInterfaceOptions };
 export type { PipelineInterface };
+export type { CommonTaskJson };
 export type { DialogTaskJson };
 export type { Expectations };
 export type { ExpectationUnit };
@@ -349,7 +350,6 @@ export type { PromptTaskJson };
 export type { ScriptTaskJson };
 export type { SimpleTaskJson };
 export type { TaskJson };
-export type { TaskJsonCommon };
 export type { PipelineString };
 export type { PrepareAndScrapeOptions };
 export type { Converter };
@@ -373,7 +373,9 @@ export type { CompletionPrompt };
 export type { ChatPrompt };
 export type { EmbeddingPrompt };
 export type { ScriptLanguage };
+export type { SectionType };
 export type { TaskProgress };
+export type { TaskType };
 export type { string_char_emoji };
 export type { string_business_category_name };
 export type { string_model_name };
@@ -418,7 +420,7 @@ export type { string_css_selector };
 export type { string_url };
 export type { string_base_url };
 export type { string_pipeline_url };
-export type { string_pipeline_url_with_hashtemplate };
+export type { string_pipeline_url_with_task_hash };
 export type { string_data_url };
 export type { string_base64 };
 export type { string_href };

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

@@ -44,6 +44,7 @@ import { parseKeywords } from '../utils/normalization/parseKeywords';
 import { parseKeywordsFromString } from '../utils/normalization/parseKeywordsFromString';
 import { removeDiacritics } from '../utils/normalization/removeDiacritics';
 import { searchKeywords } from '../utils/normalization/searchKeywords';
+import { spaceTrim } from '../utils/organization/spaceTrim';
 import { extractParameterNames } from '../utils/parameters/extractParameterNames';
 import { replaceParameters } from '../utils/parameters/replaceParameters';
 import { parseNumber } from '../utils/parseNumber';
@@ -117,6 +118,7 @@ export { parseKeywords };
 export { parseKeywordsFromString };
 export { removeDiacritics };
 export { searchKeywords };
+export { spaceTrim };
 export { extractParameterNames };
 export { replaceParameters };
 export { parseNumber };

package/esm/typings/src/commands/EXPECT/ExpectCommand.d.ts

@@ -1,7 +1,7 @@
 import type { ExpectationAmount } from '../../pipeline/PipelineJson/Expectations';
 import type { ExpectationUnit } from '../../pipeline/PipelineJson/Expectations';
 /**
- * Expect amount command describes the desired output of the template (after post-processing)
+ * Expect amount command describes the desired output of the task (after post-processing)
  * It can set limits for the maximum/minimum length of the output, measured in characters, words, sentences, paragraphs,...
  *
  * Note: LLMs work with tokens, not characters, but in Promptbooks we want to use some human-recognisable and cross-model interoperable units.

package/esm/typings/src/commands/SECTION/SectionCommand.d.ts

@@ -1,4 +1,4 @@
-import type { SectionType } from './SectionType';
+import type { SectionType } from '../../types/SectionType';
 /**
  * Parsed SECTION command
  *

package/esm/typings/src/commands/_common/types/CommandParser.d.ts

@@ -99,8 +99,6 @@ export type PipelineHeadCommandParser<TCommand extends CommandBase> = CommonComm
 };
 /**
  * @@@
- *
- * TODO: !!!!!! Rename to PipelineTaskCommandParser, applyToTaskJson, TaskJson, isUsedInPipelineTask,...
  */
 export type PipelineTaskCommandParser<TCommand extends CommandBase> = CommonCommandParser<TCommand> & {
     /**

package/esm/typings/src/config.d.ts

@@ -1,11 +1,20 @@
 import type { CsvSettings } from './formats/csv/CsvSettings';
 import type { IntermediateFilesStrategy } from './types/IntermediateFilesStrategy';
+import type { string_url_image } from './types/typeAliases';
 /**
  * Warning message for the generated sections and files files
  *
  * @private within the repository
  */
 export declare const GENERATOR_WARNING = "\u26A0\uFE0F WARNING: This code has been generated so that any manual changes will be overwritten";
+/**
+ * Name for the Promptbook
+ *
+ * TODO: [🗽] Unite branding and make single place for it
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare const NAME = "Promptbook";
 /**
  * Claim for the Promptbook
  *
@@ -14,6 +23,22 @@ export declare const GENERATOR_WARNING = "\u26A0\uFE0F WARNING: This code has be
  * @public exported from `@promptbook/core`
  */
 export declare const CLAIM = "It's time for a paradigm shift. The future of software in plain English, French or Latin";
+/**
+ * Logo for the light theme
+ *
+ * TODO: [🗽] Unite branding and make single place for it
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare const LOGO_LIGHT_SRC: string_url_image;
+/**
+ * Logo for the dark theme
+ *
+ * TODO: [🗽] Unite branding and make single place for it
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare const LOGO_DARK_SRC: string_url_image;
 /**
  * When the title is not provided, the default title is used
  *
@@ -94,6 +119,13 @@ export declare const DEFAULT_MAX_KNOWLEDGE_SOURCES_SCRAPING_DEPTH = 3;
  * @public exported from `@promptbook/core`
  */
 export declare const DEFAULT_MAX_KNOWLEDGE_SOURCES_SCRAPING_TOTAL = 200;
+/**
+ * Where to store your books
+ * This is kind of a "src" for your books
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare const DEFAULT_BOOKS_DIRNAME = "./books";
 /**
  * Where to store the cache of executions for promptbook CLI
  *
@@ -101,7 +133,7 @@ export declare const DEFAULT_MAX_KNOWLEDGE_SOURCES_SCRAPING_TOTAL = 200;
  *
  * @public exported from `@promptbook/core`
  */
-export declare const DEFAULT_EXECUTIONS_CACHE_DIRNAME = "/.promptbook/executions-cache";
+export declare const DEFAULT_EXECUTIONS_CACHE_DIRNAME = "./.promptbook/executions-cache";
 /**
  * Where to store the scrape cache
  *
@@ -109,7 +141,7 @@ export declare const DEFAULT_EXECUTIONS_CACHE_DIRNAME = "/.promptbook/executions
  *
  * @public exported from `@promptbook/core`
  */
-export declare const DEFAULT_SCRAPE_CACHE_DIRNAME = "/.promptbook/scrape-cache";
+export declare const DEFAULT_SCRAPE_CACHE_DIRNAME = "./.promptbook/scrape-cache";
 /**
  * The name of the builded pipeline collection made by CLI `ptbk make` and for lookup in `createCollectionFromDirectory`
  *

package/esm/typings/src/conversion/pipelineJsonToString.d.ts

@@ -9,7 +9,7 @@ import type { PipelineString } from '../pipeline/PipelineString';
  */
 export declare function pipelineJsonToString(pipelineJson: PipelineJson): PipelineString;
 /**
- * TODO: [🛋] Implement new features and commands into `pipelineJsonToString` + `templateParameterJsonToString` , use `stringifyCommand`
+ * TODO: [🛋] Implement new features and commands into `pipelineJsonToString` + `taskParameterJsonToString` , use `stringifyCommand`
  * TODO: [🧠] Is there a way to auto-detect missing features in pipelineJsonToString
  * TODO: [🏛] Maybe make some markdown builder
  * TODO: [🏛] Escape all

package/esm/typings/src/conversion/prettify/renderPipelineMermaidOptions.d.ts

@@ -6,9 +6,9 @@ import type { string_href } from '../../types/typeAliases';
  */
 export type renderPipelineMermaidOptions = {
     /**
-     * Callback for creating from template graph node
+     * Callback for creating from task graph node
      */
-    linkTemplate?(template: TaskJson): {
+    linkTask?(task: TaskJson): {
         href: string_href;
         title: string;
     } | null;

package/esm/typings/src/conversion/utils/extractParameterNamesFromTask.d.ts

@@ -2,14 +2,14 @@ import type { ReadonlyDeep } from 'type-fest';
 import type { TaskJson } from '../../pipeline/PipelineJson/TaskJson';
 import type { string_parameter_name } from '../../types/typeAliases';
 /**
- * Parses the template and returns the set of all used parameters
+ * Parses the task and returns the set of all used parameters
  *
- * @param template the template with used parameters
+ * @param task the task with used parameters
  * @returns the set of parameter names
  * @throws {ParseError} if the script is invalid
  * @public exported from `@promptbook/utils`
  */
-export declare function extractParameterNamesFromTask(template: ReadonlyDeep<Pick<TaskJson, 'title' | 'description' | 'taskType' | 'content' | 'preparedContent' | 'jokerParameterNames' | 'foreach'>>): Set<string_parameter_name>;
+export declare function extractParameterNamesFromTask(task: ReadonlyDeep<Pick<TaskJson, 'title' | 'description' | 'taskType' | 'content' | 'preparedContent' | 'jokerParameterNames' | 'foreach'>>): Set<string_parameter_name>;
 /**
  * TODO: [🔣] If script require contentLanguage
  */

package/esm/typings/src/conversion/utils/renameParameter.d.ts

@@ -16,8 +16,8 @@ type RenameParameterOptions = {
     readonly newParameterName: string_name;
 };
 /**
- * Function `renameParameter` will find all usable parameters for given template
- * In other words, it will find all parameters that are not used in the template itseld and all its dependencies
+ * Function `renameParameter` will find all usable parameters for given task
+ * In other words, it will find all parameters that are not used in the task itseld and all its dependencies
  *
  * @throws {PipelineLogicError} If the new parameter name is already used in the pipeline
  * @public exported from `@promptbook/utils`

package/esm/typings/src/dialogs/simple-prompt/SimplePromptInterfaceTools.d.ts

@@ -13,7 +13,7 @@ export declare class SimplePromptInterfaceTools implements UserInterfaceTools {
     protected readonly options: CommonToolsOptions;
     constructor(options?: CommonToolsOptions);
     /**
-     * Trigger window.DIALOG TEMPLATE
+     * Trigger window.prompt dialog
      */
     promptDialog(options: UserInterfaceToolsPromptDialogOptions): Promise<string>;
 }

package/esm/typings/src/execution/ScriptExecutionTools.d.ts

@@ -2,7 +2,7 @@ import type { ScriptLanguage } from '../types/ScriptLanguage';
 import type { Parameters } from '../types/typeAliases';
 import type { string_script } from '../types/typeAliases';
 /**
- * Represents all the tools needed to execute SCRIPT TEMPLATE
+ * Represents all the tools needed to execute `SCRIPT` tasks
  *
  * @see https://github.com/webgptorg/promptbook#script-execution-tools
  */

package/esm/typings/src/formfactors/_boilerplate/BoilerplateFormfactorDefinition.d.ts

@@ -8,7 +8,7 @@ export declare const BoilerplateFormfactorDefinition: {
     readonly description: "@@@";
     readonly documentationUrl: "https://github.com/webgptorg/promptbook/discussions/@@";
     readonly pipelineInterface: {
-        readonly inputParameterNames: readonly [];
-        readonly outputParameterNames: readonly [];
+        readonly inputParameters: readonly [];
+        readonly outputParameters: readonly [];
     };
 };

package/esm/typings/src/formfactors/_common/AbstractFormfactorDefinition.d.ts

@@ -35,3 +35,6 @@ export type AbstractFormfactorDefinition = {
      */
     readonly pipelineInterface: PipelineInterface;
 };
+/**
+ * TODO: [🧠][🤓] How to pass optional parameters - for example summary in FORMFACTOR Translator
+ */

package/esm/typings/src/formfactors/chatbot/ChatbotFormfactorDefinition.d.ts

@@ -9,7 +9,37 @@ export declare const ChatbotFormfactorDefinition: {
     readonly description: "@@@";
     readonly documentationUrl: "https://github.com/webgptorg/promptbook/discussions/174";
     readonly pipelineInterface: {
-        readonly inputParameterNames: readonly ["previousTitle", "previousConversationSummary", "userMessage"];
-        readonly outputParameterNames: readonly ["title", "conversationSummary", "chatbotResponse"];
+        readonly inputParameters: readonly [{
+            readonly name: "previousTitle";
+            readonly description: "Previous title of the conversation";
+            readonly isInput: true;
+            readonly isOutput: false;
+        }, {
+            readonly name: "previousConversationSummary";
+            readonly description: "Previous conversation summary";
+            readonly isInput: true;
+            readonly isOutput: false;
+        }, {
+            readonly name: "userMessage";
+            readonly description: "User message";
+            readonly isInput: true;
+            readonly isOutput: false;
+        }];
+        readonly outputParameters: readonly [{
+            readonly name: "title";
+            readonly description: "Title of the conversation";
+            readonly isInput: false;
+            readonly isOutput: true;
+        }, {
+            readonly name: "conversationSummary";
+            readonly description: "Summary of the conversation";
+            readonly isInput: false;
+            readonly isOutput: true;
+        }, {
+            readonly name: "chatbotResponse";
+            readonly description: "Chatbot response";
+            readonly isInput: false;
+            readonly isOutput: true;
+        }];
     };
 };

package/esm/typings/src/formfactors/generator/GeneratorFormfactorDefinition.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Generator is form of app that @@@
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare const GeneratorFormfactorDefinition: {
+    readonly name: "GENERATOR";
+    readonly description: "@@@";
+    readonly documentationUrl: "https://github.com/webgptorg/promptbook/discussions/184";
+    readonly pipelineInterface: {
+        readonly inputParameters: readonly [];
+        readonly outputParameters: readonly [];
+    };
+};

package/esm/typings/src/formfactors/generic/GenericFormfactorDefinition.d.ts

@@ -8,7 +8,7 @@ export declare const GenericFormfactorDefinition: {
     readonly description: "@@@";
     readonly documentationUrl: "https://github.com/webgptorg/promptbook/discussions/173";
     readonly pipelineInterface: {
-        readonly inputParameterNames: readonly [];
-        readonly outputParameterNames: readonly [];
+        readonly inputParameters: readonly [];
+        readonly outputParameters: readonly [];
     };
 };

package/esm/typings/src/formfactors/index.d.ts

@@ -8,8 +8,8 @@ export declare const FORMFACTOR_DEFINITIONS: readonly [{
     readonly description: "@@@";
     readonly documentationUrl: "https://github.com/webgptorg/promptbook/discussions/173";
     readonly pipelineInterface: {
-        readonly inputParameterNames: readonly [];
-        readonly outputParameterNames: readonly [];
+        readonly inputParameters: readonly [];
+        readonly outputParameters: readonly [];
     };
 }, {
     readonly name: "CHATBOT";
@@ -17,32 +17,94 @@ export declare const FORMFACTOR_DEFINITIONS: readonly [{
     readonly description: "@@@";
     readonly documentationUrl: "https://github.com/webgptorg/promptbook/discussions/174";
     readonly pipelineInterface: {
-        readonly inputParameterNames: readonly ["previousTitle", "previousConversationSummary", "userMessage"];
-        readonly outputParameterNames: readonly ["title", "conversationSummary", "chatbotResponse"];
+        readonly inputParameters: readonly [{
+            readonly name: "previousTitle";
+            readonly description: "Previous title of the conversation"; /**
+             * All available formfactor definitions
+             *
+             * @public exported from `@promptbook/core`
+             */
+            readonly isInput: true;
+            readonly isOutput: false;
+        }, {
+            readonly name: "previousConversationSummary";
+            readonly description: "Previous conversation summary";
+            readonly isInput: true;
+            readonly isOutput: false;
+        }, {
+            readonly name: "userMessage";
+            readonly description: "User message";
+            readonly isInput: true;
+            readonly isOutput: false;
+        }];
+        readonly outputParameters: readonly [{
+            readonly name: "title";
+            readonly description: "Title of the conversation";
+            readonly isInput: false;
+            readonly isOutput: true;
+        }, {
+            readonly name: "conversationSummary";
+            readonly description: "Summary of the conversation";
+            readonly isInput: false;
+            readonly isOutput: true;
+        }, {
+            readonly name: "chatbotResponse";
+            readonly description: "Chatbot response";
+            readonly isInput: false;
+            readonly isOutput: true;
+        }];
     };
 }, {
     readonly name: "TRANSLATOR";
     readonly description: "@@@";
     readonly documentationUrl: "https://github.com/webgptorg/promptbook/discussions/175";
     readonly pipelineInterface: {
-        readonly inputParameterNames: readonly ["inputMessage"];
-        readonly outputParameterNames: readonly ["outputMessage"];
+        readonly inputParameters: readonly [{
+            readonly name: "inputMessage";
+            readonly description: "Input message to be translated";
+            readonly isInput: true;
+            readonly isOutput: false;
+        }];
+        readonly outputParameters: readonly [{
+            readonly name: "outputMessage";
+            readonly description: "Translated output message";
+            readonly isInput: false;
+            readonly isOutput: true;
+        }];
     };
 }, {
     readonly name: "SHEETS";
     readonly description: "@@@";
     readonly documentationUrl: "https://github.com/webgptorg/promptbook/discussions/176";
     readonly pipelineInterface: {
-        readonly inputParameterNames: readonly ["inputSheet"];
-        readonly outputParameterNames: readonly ["outputSheet"];
+        readonly inputParameters: readonly [{
+            readonly name: "inputSheet";
+            readonly description: "Input sheet to be processed as csv";
+            readonly isInput: true;
+            readonly isOutput: false;
+        }];
+        readonly outputParameters: readonly [{
+            readonly name: "outputSheet";
+            readonly description: "Output sheet as csv";
+            readonly isInput: false;
+            readonly isOutput: true;
+        }];
     };
 }, {
     readonly name: "EXPERIMENTAL_MATCHER";
     readonly description: "@@@";
     readonly documentationUrl: "https://github.com/webgptorg/promptbook/discussions/177";
     readonly pipelineInterface: {
-        readonly inputParameterNames: readonly [];
-        readonly outputParameterNames: readonly [];
+        readonly inputParameters: readonly [];
+        readonly outputParameters: readonly [];
+    };
+}, {
+    readonly name: "GENERATOR";
+    readonly description: "@@@";
+    readonly documentationUrl: "https://github.com/webgptorg/promptbook/discussions/184";
+    readonly pipelineInterface: {
+        readonly inputParameters: readonly [];
+        readonly outputParameters: readonly [];
     };
 }];
 /**

package/esm/typings/src/formfactors/matcher/MatcherFormfactorDefinition.d.ts

@@ -8,7 +8,7 @@ export declare const MatcherFormfactorDefinition: {
     readonly description: "@@@";
     readonly documentationUrl: "https://github.com/webgptorg/promptbook/discussions/177";
     readonly pipelineInterface: {
-        readonly inputParameterNames: readonly [];
-        readonly outputParameterNames: readonly [];
+        readonly inputParameters: readonly [];
+        readonly outputParameters: readonly [];
     };
 };

package/esm/typings/src/formfactors/sheets/SheetsFormfactorDefinition.d.ts

@@ -8,7 +8,17 @@ export declare const SheetsFormfactorDefinition: {
     readonly description: "@@@";
     readonly documentationUrl: "https://github.com/webgptorg/promptbook/discussions/176";
     readonly pipelineInterface: {
-        readonly inputParameterNames: readonly ["inputSheet"];
-        readonly outputParameterNames: readonly ["outputSheet"];
+        readonly inputParameters: readonly [{
+            readonly name: "inputSheet";
+            readonly description: "Input sheet to be processed as csv";
+            readonly isInput: true;
+            readonly isOutput: false;
+        }];
+        readonly outputParameters: readonly [{
+            readonly name: "outputSheet";
+            readonly description: "Output sheet as csv";
+            readonly isInput: false;
+            readonly isOutput: true;
+        }];
     };
 };

package/esm/typings/src/formfactors/translator/TranslatorFormfactorDefinition.d.ts

@@ -8,7 +8,17 @@ export declare const TranslatorFormfactorDefinition: {
     readonly description: "@@@";
     readonly documentationUrl: "https://github.com/webgptorg/promptbook/discussions/175";
     readonly pipelineInterface: {
-        readonly inputParameterNames: readonly ["inputMessage"];
-        readonly outputParameterNames: readonly ["outputMessage"];
+        readonly inputParameters: readonly [{
+            readonly name: "inputMessage";
+            readonly description: "Input message to be translated";
+            readonly isInput: true;
+            readonly isOutput: false;
+        }];
+        readonly outputParameters: readonly [{
+            readonly name: "outputMessage";
+            readonly description: "Translated output message";
+            readonly isInput: false;
+            readonly isOutput: true;
+        }];
     };
 };

package/esm/typings/src/pipeline/PipelineInterface/PipelineInterface.d.ts

@@ -1,4 +1,5 @@
-import type { string_parameter_name } from '../../types/typeAliases';
+import type { InputParameterJson } from '../PipelineJson/ParameterJson';
+import type { OutputParameterJson } from '../PipelineJson/ParameterJson';
 /**
  * @@@
  *
@@ -11,15 +12,15 @@ export type PipelineInterface = {
      *
      * Note: Sorted alphabetically
      */
-    readonly inputParameterNames: ReadonlyArray<string_parameter_name>;
+    readonly inputParameters: ReadonlyArray<InputParameterJson>;
     /**
      * @@@
      *
      * Note: Sorted alphabetically
      */
-    readonly outputParameterNames: ReadonlyArray<string_parameter_name>;
+    readonly outputParameters: ReadonlyArray<OutputParameterJson>;
 };
 /**
- * TODO: !!!!!! Change inputParameterNames to inputParameters<InputParameter>
+ * TODO: [🧠][🤓] How to pass optional parameters - for example summary in FORMFACTOR Translator
  * TODO: [🧠] Better name than `PipelineInterface` to avoid confusion with typescript `interface`
  */

package/esm/typings/src/pipeline/PipelineInterface/constants.d.ts

@@ -6,8 +6,8 @@
  * @public exported from `@promptbook/core`
  */
 export declare const GENERIC_PIPELINE_INTERFACE: {
-    readonly inputParameterNames: readonly [];
-    readonly outputParameterNames: readonly [];
+    readonly inputParameters: readonly [];
+    readonly outputParameters: readonly [];
 };
 /**
  * Note: [💞] Ignore a discrepancy between file name and entity name

package/esm/typings/src/pipeline/PipelineJson/{TaskJsonCommon.d.ts → CommonTaskJson.d.ts}

@@ -1,6 +1,6 @@
 import type { ForeachJson } from '../../commands/FOREACH/ForeachJson';
 import type { FormatCommand } from '../../commands/FORMAT/FormatCommand';
-import type { SectionType } from '../../commands/SECTION/SectionType';
+import type { SectionType } from '../../types/SectionType';
 import type { string_javascript } from '../../types/typeAliases';
 import type { string_markdown } from '../../types/typeAliases';
 import type { string_markdown_text } from '../../types/typeAliases';
@@ -13,32 +13,32 @@ import type { Expectations } from './Expectations';
 /**
  * Common properties of all tasks
  */
-export type TaskJsonCommon = {
+export type CommonTaskJson = {
     /**
-     * Name of the template
+     * Name of the task
      * - It must be unique across the pipeline
      * - It should start uppercase and can contain letters and numbers
-     * - The pipelineUrl together with hash and name are used to identify the template in the pipeline
+     * - The pipelineUrl together with hash and name are used to identify the task in the pipeline
      */
     readonly name: string_name;
     /**
-     * Title of the template
+     * Title of the task
      * It can use simple markdown formatting like **bold**, *italic*, [link](https://example.com), ... BUT not code blocks and structure
      */
     readonly title: string;
     /**
-     * Description of the template
+     * Description of the task
      * It can use multiple paragraphs of simple markdown formatting like **bold**, *italic*, [link](https://example.com), ... BUT not code blocks and structure
      */
     readonly description?: string_markdown_text;
     /**
-     * List of parameter names that are used in the template and must be defined before the template is executed
+     * List of parameter names that are used in the task and must be defined before the task is executed
      *
      * Note: Joker is one of the dependent parameters
      */
     readonly dependentParameterNames: Array<string_parameter_name>;
     /**
-     * If theese parameters meet the expectations requirements, they are used instead of executing this template
+     * If theese parameters meet the expectations requirements, they are used instead of executing this task
      *
      * @see https://github.com/webgptorg/promptbook/discussions/66
      */
@@ -49,17 +49,17 @@ export type TaskJsonCommon = {
     readonly foreach?: ForeachJson;
     /**
      * Type of the execution
-     * This determines if the template is send to LLM, user or some scripting evaluation
+     * This determines if the task is send to LLM, user or some scripting evaluation
      */
     readonly taskType: SectionType;
     /**
-     * Content of the template with {placeholders} for parameters
+     * Content of the task with {placeholders} for parameters
      *
      * @@@ content vs preparedContent
      */
     readonly content: (string_prompt | string_javascript | string_markdown) & string_template;
     /**
-     * @@@ Content of the template with {placeholders} for parameters
+     * @@@ Content of the task with {placeholders} for parameters
      *
      * @@@ content vs preparedContent
      *
@@ -67,7 +67,7 @@ export type TaskJsonCommon = {
      */
     readonly preparedContent?: (string_prompt | string_javascript | string_markdown) & string_template;
     /**
-     * List of postprocessing steps that are executed after the template
+     * List of postprocessing steps that are executed after the task
      *
      * @see https://github.com/webgptorg/promptbook/discussions/31
      */
@@ -90,7 +90,7 @@ export type TaskJsonCommon = {
      */
     readonly format?: FormatCommand['format'];
     /**
-     * Name of the parameter that is the result of the template
+     * Name of the parameter that is the result of the task
      */
     readonly resultingParameterName: string_name;
 };

package/esm/typings/src/pipeline/PipelineJson/DialogTaskJson.d.ts

@@ -1,11 +1,11 @@
-import type { TaskJsonCommon } from './TaskJsonCommon';
+import type { CommonTaskJson } from './CommonTaskJson';
 /**
  * Task for prompt to user
  *
  * Note: [🚉] This is fully serializable as JSON
  * @see https://github.com/webgptorg/promptbook/discussions/76
  */
-export type DialogTaskJson = TaskJsonCommon & {
+export type DialogTaskJson = CommonTaskJson & {
     readonly taskType: 'DIALOG_TASK';
 };
 /**

package/esm/typings/src/pipeline/PipelineJson/ParameterJson.d.ts

@@ -90,6 +90,8 @@ export type CommonParameterJson = {
     readonly exampleValues?: Array<string_parameter_value>;
 };
 /**
+ * TODO: [🧠][🛴][♈] Maybe add type + expectations into the intefrace, like "a person name"
+ *       [🛴] @see https://github.com/webgptorg/promptbook/discussions/53
  * TODO: [🧠] Should be here registered subparameters from foreach or not?
  * TODO: [♈] Probbably move expectations from tasks to parameters
  * TODO: [🍙] Make some standard order of json properties

package/esm/typings/src/pipeline/PipelineJson/PersonaJson.d.ts

@@ -11,7 +11,7 @@ import type { string_persona_description } from '../../types/typeAliases';
  */
 export type PersonaJson = {
     /**
-     * Name of the template
+     * Name of the persona
      * - It must be unique across the pipeline
      * - It should start uppercase and can contain letters and numbers
      */

package/esm/typings/src/pipeline/PipelineJson/PipelineJson.d.ts

@@ -14,7 +14,7 @@ import type { PreparationJson } from './PreparationJson';
 import type { TaskJson } from './TaskJson';
 /**
  * Promptbook is the **core concept of this package**.
- * It represents a series of tasks chained together to form a pipeline / one big template with input and result parameters.
+ * It represents a series of tasks chained together to form a pipeline / one big task with input and result parameters.
  *
  * Note: [🚉] This is fully serializable as JSON
  *
@@ -28,7 +28,7 @@ export type PipelineJson = {
      * Note: It must use HTTPs URL
      * Tip: You can do versioning in the URL
      *      For example: https://promptbook.studio/webgpt/write-website-content-cs.book.md@1.0.0
-     * Warning: Do not hash part of the URL, hash part is used for identification of the template in the pipeline
+     * Warning: Do not hash part of the URL, hash part is used for identification of the task in the pipeline
      */
     readonly pipelineUrl?: string_pipeline_url;
     /**

package/esm/typings/src/pipeline/PipelineJson/PromptTaskJson.d.ts

@@ -1,12 +1,12 @@
 import type { ModelRequirements } from '../../types/ModelRequirements';
 import type { string_name } from '../../types/typeAliases';
-import type { TaskJsonCommon } from './TaskJsonCommon';
+import type { CommonTaskJson } from './CommonTaskJson';
 /**
  * Task for prompt to LLM
  *
  * Note: [🚉] This is fully serializable as JSON
  */
-export type PromptTaskJson = TaskJsonCommon & {
+export type PromptTaskJson = CommonTaskJson & {
     readonly taskType: 'PROMPT_TASK';
     /**
      * Name of the persona who will be responding to this prompt

package/esm/typings/src/pipeline/PipelineJson/ScriptTaskJson.d.ts

@@ -1,12 +1,12 @@
 import type { ScriptLanguage } from '../../types/ScriptLanguage';
-import type { TaskJsonCommon } from './TaskJsonCommon';
+import type { CommonTaskJson } from './CommonTaskJson';
 /**
  * Task for script execution
  *
  * Note: [🚉] This is fully serializable as JSON
  * @see https://github.com/webgptorg/promptbook/discussions/77
  */
-export type ScriptTaskJson = TaskJsonCommon & {
+export type ScriptTaskJson = CommonTaskJson & {
     readonly taskType: 'SCRIPT_TASK';
     /**
      * Language of the script

package/esm/typings/src/pipeline/PipelineJson/SimpleTaskJson.d.ts

@@ -1,11 +1,11 @@
-import type { TaskJsonCommon } from './TaskJsonCommon';
+import type { CommonTaskJson } from './CommonTaskJson';
 /**
  * Task for simple concatenation of strings
  *
  * Note: [🚉] This is fully serializable as JSON
  * @see https://github.com/webgptorg/promptbook/discussions/17
  */
-export type SimpleTaskJson = TaskJsonCommon & {
+export type SimpleTaskJson = CommonTaskJson & {
     readonly taskType: 'SIMPLE_TASK';
 };
 /**

package/esm/typings/src/pipeline/PipelineJson/TaskJson.d.ts

@@ -4,7 +4,7 @@ import type { PromptTaskJson } from './PromptTaskJson';
 import type { ScriptTaskJson } from './ScriptTaskJson';
 import type { SimpleTaskJson } from './SimpleTaskJson';
 /**
- * Describes one (prompt) template in the promptbook
+ * Describes one (prompt) task in the pipeline
  *
  * Note: [🚉] This is fully serializable as JSON
  */

package/esm/typings/src/pipeline/PipelineString.d.ts

@@ -1,6 +1,6 @@
 /**
  * Promptbook is the **core concept of this package**.
- * It represents a series of tasks chained together to form a pipeline / one big template with input and result parameters.
+ * It represents a series of tasks chained together to form a pipeline / one big task with input and result parameters.
  *
  * @see @@@ https://github.com/webgptorg/promptbook#promptbook
  */

package/esm/typings/src/prepare/isPipelinePrepared.d.ts

@@ -10,7 +10,7 @@ export declare function isPipelinePrepared(pipeline: PipelineJson): boolean;
  * TODO: [🐠] Maybe base this on `makeValidator`
  * TODO: [🧊] Pipeline can be partially prepared, this should return true ONLY if fully prepared
  * TODO: [🧿] Maybe do same process with same granularity and subfinctions as `preparePipeline`
- *     - [🏍] ? Is context in each template
+ *     - [🏍] ? Is context in each task
  *     - [♨] Are examples prepared
  *     - [♨] Are tasks prepared
  */

package/esm/typings/src/prepare/prepareTasks.d.ts

@@ -2,13 +2,13 @@ import type { ExecutionTools } from '../execution/ExecutionTools';
 import type { PipelineJson } from '../pipeline/PipelineJson/PipelineJson';
 import type { TaskJson } from '../pipeline/PipelineJson/TaskJson';
 import type { PrepareAndScrapeOptions } from './PrepareAndScrapeOptions';
-type PrepareTemplateInput = Pick<PipelineJson, 'tasks' | 'parameters'> & {
+type PrepareTaskInput = Pick<PipelineJson, 'tasks' | 'parameters'> & {
     /**
      * @@@
      */
     readonly knowledgePiecesCount: number;
 };
-type PreparedTemplates = {
+type PreparedTasks = {
     /**
      * @@@ Sequence of tasks that are chained together to form a pipeline
      */
@@ -19,11 +19,11 @@ type PreparedTemplates = {
  *
  * @public exported from `@promptbook/core`
  */
-export declare function prepareTasks(pipeline: PrepareTemplateInput, tools: Pick<ExecutionTools, 'llm' | 'fs' | 'scrapers'>, options: PrepareAndScrapeOptions): Promise<PreparedTemplates>;
+export declare function prepareTasks(pipeline: PrepareTaskInput, tools: Pick<ExecutionTools, 'llm' | 'fs' | 'scrapers'>, options: PrepareAndScrapeOptions): Promise<PreparedTasks>;
 export {};
 /**
- * TODO: [🧠] Add context to each template (if missing)
- * TODO: [🧠] What is better name `prepareTemplate` or `prepareTemplateAndParameters`
+ * TODO: [🧠] Add context to each task (if missing)
+ * TODO: [🧠] What is better name `prepareTask` or `prepareTaskAndParameters`
  * TODO: [♨][main] !!! Prepare index the examples and maybe tasks
  * TODO: Write tests for `preparePipeline`
  * TODO: [🏏] Leverage the batch API and build queues @see https://platform.openai.com/docs/guides/batch

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

@@ -5,7 +5,7 @@ import type { CompletionModelRequirements } from './ModelRequirements';
 import type { EmbeddingModelRequirements } from './ModelRequirements';
 import type { ModelRequirements } from './ModelRequirements';
 import type { Parameters } from './typeAliases';
-import type { string_pipeline_url_with_hashtemplate } from './typeAliases';
+import type { string_pipeline_url_with_task_hash } from './typeAliases';
 import type { string_postprocessing_function_name } from './typeAliases';
 import type { string_prompt } from './typeAliases';
 import type { string_template } from './typeAliases';
@@ -93,11 +93,11 @@ export type CommonPrompt = {
      */
     readonly format?: FormatCommand['format'];
     /**
-     * Unique identifier of the pipeline with specific template name as hash
+     * Unique identifier of the pipeline with specific task name as hash
      *
      * @example https://promptbook.studio/webgpt/write-website-content-cs.book.md#keywords
      */
-    readonly pipelineUrl?: string_pipeline_url_with_hashtemplate;
+    readonly pipelineUrl?: string_pipeline_url_with_task_hash;
     /**
      * Parameters used in the `content`
      */

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

@@ -0,0 +1,21 @@
+import type { TupleToUnion } from 'type-fest';
+/**
+ * Type of the section
+ */
+export type SectionType = TupleToUnion<typeof SectionTypes>;
+/**
+ * All available sections which are not tasks
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare const NonTaskSectionTypes: readonly ["EXAMPLE", "KNOWLEDGE", "INSTRUMENT", "ACTION"];
+/**
+ * All available section types
+ *
+ * There is is distinction between task types and section types
+ * - Every section in markdown has its SectionType
+ * - Some sections are tasks but other can be non-task sections
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare const SectionTypes: readonly [...("PROMPT_TASK" | "SIMPLE_TASK" | "SCRIPT_TASK" | "DIALOG_TASK")[], "EXAMPLE", "KNOWLEDGE", "INSTRUMENT", "ACTION"];

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

@@ -1,4 +1,4 @@
-import type { SectionType } from '../commands/SECTION/SectionType';
+import type { SectionType } from './SectionType';
 import type { string_markdown_text } from './typeAliases';
 import type { string_name } from './typeAliases';
 /**

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

@@ -0,0 +1,15 @@
+import type { TupleToUnion } from 'type-fest';
+/**
+ * Type of the task
+ */
+export type TaskType = TupleToUnion<typeof TaskTypes>;
+/**
+ * All available task types
+ *
+ * There is is distinction between task types and section types
+ * - Every section in markdown has its SectionType
+ * - Some sections are tasks but other can be non-task sections
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare const TaskTypes: readonly ["PROMPT", "SIMPLE", "SCRIPT", "DIALOG"];

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

@@ -306,7 +306,7 @@ export type string_pipeline_url = string;
  *
  * For example `"https://promptbook.studio/webgpt/write-website-content-cs.book.md#keywords"`
  */
-export type string_pipeline_url_with_hashtemplate = string;
+export type string_pipeline_url_with_task_hash = string;
 /**
  * Semantic helper
  *

package/esm/typings/src/utils/organization/TODO_remove_as.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Organizational helper to better mark the place is used as but should not be
+ *
+ * @private within the repository
+ */
+export type TODO_remove_as<T> = T;

package/esm/typings/src/utils/organization/spaceTrim.d.ts

@@ -0,0 +1,11 @@
+import { spaceTrim as spaceTrimReexported } from 'spacetrim';
+/**
+ * Trims string from all 4 sides
+ *
+ * Note: This is a re-exported function from the `spacetrim` package which is
+ *       Developed by same author @hejny as this package
+ *
+ * @public exported from `@promptbook/utils`
+ * @see https://github.com/hejny/spacetrim#usage
+ */
+export declare const spaceTrim: typeof spaceTrimReexported;

package/esm/typings/src/utils/parameters/extractParameterNames.d.ts

@@ -3,7 +3,7 @@ import type { string_template } from '../../types/typeAliases';
 /**
  * Parses the task and returns the list of all parameter names
  *
- * @param template the task with parameters in {curly} braces
+ * @param template the string template with parameters in {curly} braces
  * @returns the list of parameter names
  * @public exported from `@promptbook/utils`
  */

package/esm/typings/src/version.d.ts

@@ -15,4 +15,4 @@ export type string_promptbook_version = string_semantic_version;
 /**
  * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
  * Note: [💞] Ignore a discrepancy between file name and entity name
- */
+ */ 

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@promptbook/types",
-    "version": "0.75.0-2",
+    "version": "0.75.1",
     "description": "It's time for a paradigm shift. The future of software in plain English, French or Latin",
     "--note-0": "    <- [🐊]",
     "private": false,
@@ -52,6 +52,6 @@
     ],
     "typings": "./esm/typings/src/_packages/types.index.d.ts",
     "peerDependencies": {
-        "@promptbook/core": "0.75.0-2"
+        "@promptbook/core": "0.75.1"
     }
 }

package/esm/typings/src/commands/SECTION/SectionType.d.ts

@@ -1,13 +0,0 @@
-import type { TupleToUnion } from 'type-fest';
-/**
- * Section type describes the way how the section is sectiond
- *
- * @public exported from `@promptbook/core`
- */
-export type SectionType = TupleToUnion<typeof SectionTypes>;
-/**
- * Section type describes the way how the section is sectiond
- *
- * @public exported from `@promptbook/core`
- */
-export declare const SectionTypes: readonly ["PROMPT_TASK", "SIMPLE_TASK", "SCRIPT_TASK", "DIALOG_TASK", "EXAMPLE", "KNOWLEDGE", "INSTRUMENT", "ACTION"];