@promptbook/markdown-utils 0.75.0-2 → 0.75.1

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