@promptbook/node 0.75.0-0 → 0.75.0-1

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

@@ -59,9 +59,12 @@ import { CsvFormatDefinition } from '../formats/csv/CsvFormatDefinition';
 import { CsvFormatError } from '../formats/csv/CsvFormatError';
 import { MANDATORY_CSV_SETTINGS } from '../formats/csv/CsvSettings';
 import { TextFormatDefinition } from '../formats/text/TextFormatDefinition';
+import { BoilerplateFormfactorDefinition } from '../formfactors/_boilerplate/BoilerplateFormfactorDefinition';
 import { ChatFormfactorDefinition } from '../formfactors/chat/ChatFormfactorDefinition';
 import { GenericFormfactorDefinition } from '../formfactors/generic/GenericFormfactorDefinition';
 import { FORMFACTOR_DEFINITIONS } from '../formfactors/index';
+import { SheetsFormfactorDefinition } from '../formfactors/sheets/SheetsFormfactorDefinition';
+import { TranslatorFormfactorDefinition } from '../formfactors/translator/TranslatorFormfactorDefinition';
 import { $llmToolsMetadataRegister } from '../llm-providers/_common/register/$llmToolsMetadataRegister';
 import { $llmToolsRegister } from '../llm-providers/_common/register/$llmToolsRegister';
 import { createLlmToolsFromConfiguration } from '../llm-providers/_common/register/createLlmToolsFromConfiguration';
@@ -75,6 +78,7 @@ import { MultipleLlmExecutionTools } from '../llm-providers/multiple/MultipleLlm
 import { _OpenAiMetadataRegistration } from '../llm-providers/openai/register-configuration';
 import { _OpenAiAssistantMetadataRegistration } from '../llm-providers/openai/register-configuration';
 import { preparePersona } from '../personas/preparePersona';
+import { GENERIC_PIPELINE_INTERFACE } from '../pipeline/pipeline-interface/constants';
 import { getPipelineInterface } from '../pipeline/pipeline-interface/getPipelineInterface';
 import { isPipelineImplementingInterface } from '../pipeline/pipeline-interface/isPipelineImplementingInterface';
 import { isPipelineInterfacesEqual } from '../pipeline/pipeline-interface/isPipelineInterfacesEqual';
@@ -160,9 +164,12 @@ export { CsvFormatDefinition };
 export { CsvFormatError };
 export { MANDATORY_CSV_SETTINGS };
 export { TextFormatDefinition };
+export { BoilerplateFormfactorDefinition };
 export { ChatFormfactorDefinition };
 export { GenericFormfactorDefinition };
 export { FORMFACTOR_DEFINITIONS };
+export { SheetsFormfactorDefinition };
+export { TranslatorFormfactorDefinition };
 export { $llmToolsMetadataRegister };
 export { $llmToolsRegister };
 export { createLlmToolsFromConfiguration };
@@ -176,6 +183,7 @@ export { MultipleLlmExecutionTools };
 export { _OpenAiMetadataRegistration };
 export { _OpenAiAssistantMetadataRegistration };
 export { preparePersona };
+export { GENERIC_PIPELINE_INTERFACE };
 export { getPipelineInterface };
 export { isPipelineImplementingInterface };
 export { isPipelineInterfacesEqual };

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

@@ -12,8 +12,8 @@ import { $currentDate } from '../utils/$currentDate';
 import { $isRunningInBrowser } from '../utils/environment/$isRunningInBrowser';
 import { $isRunningInNode } from '../utils/environment/$isRunningInNode';
 import { $isRunningInWebWorker } from '../utils/environment/$isRunningInWebWorker';
-import { CHARACTERS_PER_STANDARD_LINE } from '../utils/expectation-counters/config';
-import { LINES_PER_STANDARD_PAGE } from '../utils/expectation-counters/config';
+import { CHARACTERS_PER_STANDARD_LINE } from '../utils/expectation-counters/constants';
+import { LINES_PER_STANDARD_PAGE } from '../utils/expectation-counters/constants';
 import { countCharacters } from '../utils/expectation-counters/countCharacters';
 import { countLines } from '../utils/expectation-counters/countLines';
 import { countPages } from '../utils/expectation-counters/countPages';

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

@@ -192,5 +192,6 @@ export declare const IS_PIPELINE_LOGIC_VALIDATED: boolean;
  */
 export declare const IS_COST_PREVENTED: boolean;
 /**
+ * TODO: Extract `constants.ts` from `config.ts`
  * TODO: [🧠][🧜‍♂️] Maybe join remoteUrl and path into single value
  */

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

@@ -0,0 +1,14 @@
+/**
+ * Boilerplate is form of app that @@@
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare const BoilerplateFormfactorDefinition: {
+    readonly name: "BOILERPLATE";
+    readonly description: "@@@";
+    readonly documentationUrl: "https://github.com/webgptorg/promptbook/discussions/@@";
+    readonly pipelineInterface: {
+        readonly inputParameterNames: readonly [];
+        readonly outputParameterNames: readonly [];
+    };
+};

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

@@ -1,7 +1,8 @@
-import type { string_SCREAMING_CASE } from '../../utils/normalization/normalizeTo_SCREAMING_CASE';
+import type { PipelineInterface } from '../../pipeline/pipeline-interface/PipelineInterface';
 import type { string_markdown_text } from '../../types/typeAliases';
 import type { string_name } from '../../types/typeAliases';
 import type { string_promptbook_documentation_url } from '../../types/typeAliases';
+import type { string_SCREAMING_CASE } from '../../utils/normalization/normalizeTo_SCREAMING_CASE';
 /**
  * @@@
  */
@@ -26,4 +27,8 @@ export type AbstractFormfactorDefinition = {
      * @@@
      */
     readonly documentationUrl: string_promptbook_documentation_url;
+    /**
+     * @@@
+     */
+    readonly pipelineInterface: PipelineInterface;
 };

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

@@ -1,4 +1,4 @@
-import type { FORMFACTOR_DEFINITIONS } from '../index';
+import { FORMFACTOR_DEFINITIONS } from '../index';
 /**
  * @@@
  */

package/esm/typings/src/formfactors/chat/ChatFormfactorDefinition.d.ts

@@ -4,7 +4,12 @@
  * @public exported from `@promptbook/core`
  */
 export declare const ChatFormfactorDefinition: {
-    readonly name: "CHAT";
+    readonly name: "CHATBOT";
+    readonly aliasNames: readonly ["CHAT"];
     readonly description: "@@@";
     readonly documentationUrl: "https://github.com/webgptorg/promptbook/discussions/@@";
+    readonly pipelineInterface: {
+        readonly inputParameterNames: readonly ["previousTitle", "previousConversationSummary", "userMessage"];
+        readonly outputParameterNames: readonly ["title", "conversationSummary", "chatbotResponse"];
+    };
 };

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

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

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

@@ -7,8 +7,33 @@ export declare const FORMFACTOR_DEFINITIONS: readonly [{
     readonly name: "GENERIC";
     readonly description: "@@@";
     readonly documentationUrl: "https://github.com/webgptorg/promptbook/discussions/@@";
+    readonly pipelineInterface: {
+        readonly inputParameterNames: readonly [];
+        readonly outputParameterNames: readonly [];
+    };
 }, {
-    readonly name: "CHAT";
+    readonly name: "CHATBOT";
+    readonly aliasNames: readonly ["CHAT"];
     readonly description: "@@@";
     readonly documentationUrl: "https://github.com/webgptorg/promptbook/discussions/@@";
+    readonly pipelineInterface: {
+        readonly inputParameterNames: readonly ["previousTitle", "previousConversationSummary", "userMessage"];
+        readonly outputParameterNames: readonly ["title", "conversationSummary", "chatbotResponse"];
+    };
+}, {
+    readonly name: "TRANSLATOR";
+    readonly description: "@@@";
+    readonly documentationUrl: "https://github.com/webgptorg/promptbook/discussions/@@";
+    readonly pipelineInterface: {
+        readonly inputParameterNames: readonly ["inputMessage"];
+        readonly outputParameterNames: readonly ["outputMessage"];
+    };
+}, {
+    readonly name: "SHEETS";
+    readonly description: "@@@";
+    readonly documentationUrl: "https://github.com/webgptorg/promptbook/discussions/@@";
+    readonly pipelineInterface: {
+        readonly inputParameterNames: readonly ["inputSheet"];
+        readonly outputParameterNames: readonly ["outputSheet"];
+    };
 }];

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

@@ -0,0 +1,14 @@
+/**
+ * Sheets is form of app that @@@
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare const SheetsFormfactorDefinition: {
+    readonly name: "SHEETS";
+    readonly description: "@@@";
+    readonly documentationUrl: "https://github.com/webgptorg/promptbook/discussions/@@";
+    readonly pipelineInterface: {
+        readonly inputParameterNames: readonly ["inputSheet"];
+        readonly outputParameterNames: readonly ["outputSheet"];
+    };
+};

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

@@ -0,0 +1,14 @@
+/**
+ * Translator is form of app that @@@
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare const TranslatorFormfactorDefinition: {
+    readonly name: "TRANSLATOR";
+    readonly description: "@@@";
+    readonly documentationUrl: "https://github.com/webgptorg/promptbook/discussions/@@";
+    readonly pipelineInterface: {
+        readonly inputParameterNames: readonly ["inputMessage"];
+        readonly outputParameterNames: readonly ["outputMessage"];
+    };
+};

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

@@ -8,13 +8,13 @@ export type PipelineInterface = {
      *
      * Note: Sorted alphabetically
      */
-    inputParameterNames: Array<string_parameter_name>;
+    readonly inputParameterNames: ReadonlyArray<string_parameter_name>;
     /**
      * @@@
      *
      * Note: Sorted alphabetically
      */
-    outputParameterNames: Array<string_parameter_name>;
+    readonly outputParameterNames: ReadonlyArray<string_parameter_name>;
 };
 /**
  * TODO: !!!!!! Change inputParameterNames to inputParameters<InputParameter>

package/esm/typings/src/pipeline/pipeline-interface/constants.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @@@
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare const GENERIC_PIPELINE_INTERFACE: {
+    readonly inputParameterNames: readonly [];
+    readonly outputParameterNames: readonly [];
+};

package/esm/typings/src/utils/expectation-counters/{config.d.ts → constants.d.ts}

@@ -10,3 +10,6 @@ export declare const CHARACTERS_PER_STANDARD_LINE = 63;
  * @public exported from `@promptbook/utils`
  */
 export declare const LINES_PER_STANDARD_PAGE = 44;
+/**
+ * TODO: [🧠] Should be this `constants.ts` or `config.ts`?
+ */

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@promptbook/node",
-    "version": "0.75.0-0",
+    "version": "0.75.0-1",
     "description": "Supercharge your use of large language models",
     "private": false,
     "sideEffects": false,
@@ -53,7 +53,7 @@
     "module": "./esm/index.es.js",
     "typings": "./esm/typings/src/_packages/node.index.d.ts",
     "peerDependencies": {
-        "@promptbook/core": "0.75.0-0"
+        "@promptbook/core": "0.75.0-1"
     },
     "dependencies": {
         "colors": "1.4.0",

package/umd/index.umd.js

@@ -43,7 +43,7 @@
      *
      * @see https://github.com/webgptorg/promptbook
      */
-    var PROMPTBOOK_ENGINE_VERSION = '0.74.0-13';
+    var PROMPTBOOK_ENGINE_VERSION = '0.75.0-0';
     /**
      * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
      */
@@ -487,6 +487,7 @@
     // Note: In normal situations, we check the pipeline logic:
     true);
     /**
+     * TODO: Extract `constants.ts` from `config.ts`
      * TODO: [🧠][🧜‍♂️] Maybe join remoteUrl and path into single value
      */
 
@@ -1297,8 +1298,8 @@
                             else if (errors.length > 1) {
                                 throw new PipelineExecutionError(
                                 // TODO: Tell which execution tools failed like
-                                //     1) OpenAI throw PipelineExecutionError: Parameter {knowledge} is not defined
-                                //     2) AnthropicClaude throw PipelineExecutionError: Parameter {knowledge} is not defined
+                                //     1) OpenAI throw PipelineExecutionError: Parameter `{knowledge}` is not defined
+                                //     2) AnthropicClaude throw PipelineExecutionError: Parameter `{knowledge}` is not defined
                                 //     3) ...
                                 spaceTrim__default["default"](function (block) { return "\n                          All execution tools failed:\n\n                          ".concat(block(errors
                                     .map(function (error, i) { return "".concat(i + 1, ") **").concat(error.name || 'Error', ":** ").concat(error.message); })
@@ -1633,18 +1634,18 @@
         }
         var _loop_1 = function (parameter) {
             if (parameter.isInput && parameter.isOutput) {
-                throw new PipelineLogicError(spaceTrim.spaceTrim(function (block) { return "\n\n                        Parameter {".concat(parameter.name, "} can not be both input and output\n\n                        ").concat(block(pipelineIdentification), "\n                    "); }));
+                throw new PipelineLogicError(spaceTrim.spaceTrim(function (block) { return "\n\n                        Parameter `{".concat(parameter.name, "}` can not be both input and output\n\n                        ").concat(block(pipelineIdentification), "\n                    "); }));
             }
             // Note: Testing that parameter is either intermediate or output BUT not created and unused
             if (!parameter.isInput &&
                 !parameter.isOutput &&
                 !pipeline.templates.some(function (template) { return template.dependentParameterNames.includes(parameter.name); })) {
-                throw new PipelineLogicError(spaceTrim.spaceTrim(function (block) { return "\n                        Parameter {".concat(parameter.name, "} is created but not used\n\n                        You can declare {").concat(parameter.name, "} as output parameter by adding in the header:\n                        - OUTPUT PARAMETER `{").concat(parameter.name, "}` ").concat(parameter.description || '', "\n\n                        ").concat(block(pipelineIdentification), "\n\n                    "); }));
+                throw new PipelineLogicError(spaceTrim.spaceTrim(function (block) { return "\n                        Parameter `{".concat(parameter.name, "}` is created but not used\n\n                        You can declare {").concat(parameter.name, "} as output parameter by adding in the header:\n                        - OUTPUT PARAMETER `{").concat(parameter.name, "}` ").concat(parameter.description || '', "\n\n                        ").concat(block(pipelineIdentification), "\n\n                    "); }));
             }
             // Note: Testing that parameter is either input or result of some template
             if (!parameter.isInput &&
                 !pipeline.templates.some(function (template) { return template.resultingParameterName === parameter.name; })) {
-                throw new PipelineLogicError(spaceTrim.spaceTrim(function (block) { return "\n                        Parameter {".concat(parameter.name, "} is declared but not defined\n\n                        You can do one of these:\n                        1) Remove declaration of {").concat(parameter.name, "}\n                        2) Add template that results in -> {").concat(parameter.name, "}\n\n                        ").concat(block(pipelineIdentification), "\n                    "); }));
+                throw new PipelineLogicError(spaceTrim.spaceTrim(function (block) { return "\n                        Parameter `{".concat(parameter.name, "}` is declared but not defined\n\n                        You can do one of these:\n                        1) Remove declaration of `{").concat(parameter.name, "}`\n                        2) Add template that results in `-> {").concat(parameter.name, "}`\n\n                        ").concat(block(pipelineIdentification), "\n                    "); }));
             }
         };
         try {
@@ -1672,7 +1673,7 @@
         var _loop_2 = function (template) {
             var e_4, _h, e_5, _j;
             if (definedParameters.has(template.resultingParameterName)) {
-                throw new PipelineLogicError(spaceTrim.spaceTrim(function (block) { return "\n                        Parameter {".concat(template.resultingParameterName, "} is defined multiple times\n\n                        ").concat(block(pipelineIdentification), "\n                    "); }));
+                throw new PipelineLogicError(spaceTrim.spaceTrim(function (block) { return "\n                        Parameter `{".concat(template.resultingParameterName, "}` is defined multiple times\n\n                        ").concat(block(pipelineIdentification), "\n                    "); }));
             }
             if (RESERVED_PARAMETER_NAMES.includes(template.resultingParameterName)) {
                 throw new PipelineLogicError(spaceTrim.spaceTrim(function (block) { return "\n                        Parameter name {".concat(template.resultingParameterName, "} is reserved, please use different name\n\n                        ").concat(block(pipelineIdentification), "\n                    "); }));
@@ -1685,7 +1686,7 @@
                 }
                 var _loop_4 = function (joker) {
                     if (!template.dependentParameterNames.includes(joker)) {
-                        throw new PipelineLogicError(spaceTrim.spaceTrim(function (block) { return "\n                                Parameter {".concat(joker, "} is used for {").concat(template.resultingParameterName, "} as joker but not in `dependentParameterNames`\n\n                                ").concat(block(pipelineIdentification), "\n                            "); }));
+                        throw new PipelineLogicError(spaceTrim.spaceTrim(function (block) { return "\n                                Parameter `{".concat(joker, "}` is used for {").concat(template.resultingParameterName, "} as joker but not in `dependentParameterNames`\n\n                                ").concat(block(pipelineIdentification), "\n                            "); }));
                     }
                 };
                 try {
@@ -1780,14 +1781,24 @@
             if (currentlyResovedTemplates.length === 0) {
                 throw new PipelineLogicError(
                 // TODO: [🐎] DRY
-                spaceTrim.spaceTrim(function (block) { return "\n\n                        Can not resolve some parameters:\n                        Either you are using a parameter that is not defined, or there are some circular dependencies.\n\n                        ".concat(block(pipelineIdentification), "\n\n                        Can not resolve:\n                        ").concat(block(unresovedTemplates
+                spaceTrim.spaceTrim(function (block) { return "\n\n                        Can not resolve some parameters:\n                        Either you are using a parameter that is not defined, or there are some circular dependencies.\n\n                        ".concat(block(pipelineIdentification), "\n\n                        **Can not resolve:**\n                        ").concat(block(unresovedTemplates
                     .map(function (_a) {
                     var resultingParameterName = _a.resultingParameterName, dependentParameterNames = _a.dependentParameterNames;
-                    return "- Parameter {".concat(resultingParameterName, "} which depends on ").concat(dependentParameterNames
-                        .map(function (dependentParameterName) { return "{".concat(dependentParameterName, "}"); })
+                    return "- Parameter `{".concat(resultingParameterName, "}` which depends on ").concat(dependentParameterNames
+                        .map(function (dependentParameterName) { return "`{".concat(dependentParameterName, "}`"); })
                         .join(' and '));
                 })
-                    .join('\n')), "\n\n                        Resolved:\n                        ").concat(block(resovedParameters.map(function (name) { return "- Parameter {".concat(name, "}"); }).join('\n')), "\n\n\n                    "); }));
+                    .join('\n')), "\n\n                        **Resolved:**\n                        ").concat(block(resovedParameters
+                    .filter(function (name) {
+                    return !RESERVED_PARAMETER_NAMES.includes(name);
+                })
+                    .map(function (name) { return "- Parameter `{".concat(name, "}`"); })
+                    .join('\n')), "\n\n\n                        **Reserved (which are available):**\n                        ").concat(block(resovedParameters
+                    .filter(function (name) {
+                    return RESERVED_PARAMETER_NAMES.includes(name);
+                })
+                    .map(function (name) { return "- Parameter `{".concat(name, "}`"); })
+                    .join('\n')), "\n\n\n                    "); }));
             }
             resovedParameters = __spreadArray(__spreadArray([], __read(resovedParameters), false), __read(currentlyResovedTemplates.map(function (_a) {
                 var resultingParameterName = _a.resultingParameterName;
@@ -1798,6 +1809,7 @@
         while (unresovedTemplates.length > 0) {
             _loop_3();
         }
+        // TODO: !!!!!! Test that pipeline interface implements declared formfactor interface
     }
     /**
      * TODO: !! [🧞‍♀️] Do not allow joker + foreach
@@ -2933,11 +2945,11 @@
             for (var _b = __values(Object.entries(parameters)), _c = _b.next(); !_c.done; _c = _b.next()) {
                 var _d = __read(_c.value, 2), parameterName = _d[0], parameterValue = _d[1];
                 if (parameterValue === RESERVED_PARAMETER_MISSING_VALUE) {
-                    throw new UnexpectedError("Parameter {".concat(parameterName, "} has missing value"));
+                    throw new UnexpectedError("Parameter `{".concat(parameterName, "}` has missing value"));
                 }
                 else if (parameterValue === RESERVED_PARAMETER_RESTRICTED) {
                     // TODO: [🍵]
-                    throw new UnexpectedError("Parameter {".concat(parameterName, "} is restricted to use"));
+                    throw new UnexpectedError("Parameter `{".concat(parameterName, "}` is restricted to use"));
                 }
             }
         }
@@ -2964,11 +2976,11 @@
                 throw new PipelineExecutionError('Parameter is already opened or not closed');
             }
             if (parameters[parameterName] === undefined) {
-                throw new PipelineExecutionError("Parameter {".concat(parameterName, "} is not defined"));
+                throw new PipelineExecutionError("Parameter `{".concat(parameterName, "}` is not defined"));
             }
             var parameterValue = parameters[parameterName];
             if (parameterValue === undefined) {
-                throw new PipelineExecutionError("Parameter {".concat(parameterName, "} is not defined"));
+                throw new PipelineExecutionError("Parameter `{".concat(parameterName, "}` is not defined"));
             }
             parameterValue = parameterValue.toString();
             if (parameterValue.includes('\n') && /^\s*\W{0,3}\s*$/.test(precol)) {
@@ -3024,6 +3036,9 @@
      * @public exported from `@promptbook/utils`
      */
     var LINES_PER_STANDARD_PAGE = 44;
+    /**
+     * TODO: [🧠] Should be this `constants.ts` or `config.ts`?
+     */
 
     /**
      * Counts number of lines in the text
@@ -4016,7 +4031,7 @@
                             else if (!definedParameterNames.has(parameterName) && usedParameterNames.has(parameterName)) {
                                 // Houston, we have a problem
                                 // Note: Checking part is also done in `validatePipeline`, but it’s good to doublecheck
-                                throw new UnexpectedError(spaceTrim.spaceTrim(function (block) { return "\n                        Parameter {".concat(parameterName, "} is NOT defined\n                        BUT used in template \"").concat(currentTemplate.title || currentTemplate.name, "\"\n\n                        This should be catched in `validatePipeline`\n\n                        ").concat(block(pipelineIdentification), "\n\n                    "); }));
+                                throw new UnexpectedError(spaceTrim.spaceTrim(function (block) { return "\n                        Parameter `{".concat(parameterName, "}` is NOT defined\n                        BUT used in template \"").concat(currentTemplate.title || currentTemplate.name, "\"\n\n                        This should be catched in `validatePipeline`\n\n                        ").concat(block(pipelineIdentification), "\n\n                    "); }));
                             }
                         };
                         try {
@@ -4095,7 +4110,7 @@
         var _loop_1 = function (parameter) {
             if (parametersToPass[parameter.name] === undefined) {
                 // [4]
-                $warnings.push(new PipelineExecutionError(spaceTrim.spaceTrim(function (block) { return "\n                            Parameter {".concat(parameter.name, "} should be an output parameter, but it was not generated during pipeline execution\n\n                            ").concat(block(pipelineIdentification), "\n                        "); })));
+                $warnings.push(new PipelineExecutionError(spaceTrim.spaceTrim(function (block) { return "\n                            Parameter `{".concat(parameter.name, "}` should be an output parameter, but it was not generated during pipeline execution\n\n                            ").concat(block(pipelineIdentification), "\n                        "); })));
                 return "continue";
             }
             outputParameters[parameter.name] = parametersToPass[parameter.name] || '';
@@ -4182,7 +4197,7 @@
                     case 6: return [2 /*return*/, $asDeeplyFrozenSerializableJson("Unuccessful PipelineExecutorResult (with missing parameter {".concat(parameter.name, "}) PipelineExecutorResult"), {
                             isSuccessful: false,
                             errors: __spreadArray([
-                                new PipelineExecutionError("Parameter {".concat(parameter.name, "} is required as an input parameter"))
+                                new PipelineExecutionError("Parameter `{".concat(parameter.name, "}` is required as an input parameter"))
                             ], __read(errors), false).map(serializeError),
                             warnings: [],
                             executionReport: executionReport,
@@ -4230,7 +4245,7 @@
                                     case 3: return [2 /*return*/, { value: $asDeeplyFrozenSerializableJson(spaceTrim.spaceTrim(function (block) { return "\n                        Unuccessful PipelineExecutorResult (with extra parameter {".concat(parameter.name, "}) PipelineExecutorResult\n\n                        ").concat(block(pipelineIdentification), "\n                    "); }), {
                                                 isSuccessful: false,
                                                 errors: __spreadArray([
-                                                    new PipelineExecutionError(spaceTrim.spaceTrim(function (block) { return "\n                                    Parameter {".concat(parameter.name, "} is passed as input parameter but it is not input\n\n                                    ").concat(block(pipelineIdentification), "\n                                "); }))
+                                                    new PipelineExecutionError(spaceTrim.spaceTrim(function (block) { return "\n                                    Parameter `{".concat(parameter.name, "}` is passed as input parameter but it is not input\n\n                                    ").concat(block(pipelineIdentification), "\n                                "); }))
                                                 ], __read(errors), false).map(serializeError),
                                                 warnings: warnings.map(serializeError),
                                                 executionReport: executionReport,
@@ -4304,14 +4319,24 @@
                                         if (!(!currentTemplate && resolving_1.length === 0)) return [3 /*break*/, 1];
                                         throw new UnexpectedError(
                                         // TODO: [🐎] DRY
-                                        spaceTrim.spaceTrim(function (block) { return "\n                            Can not resolve some parameters:\n\n                            ".concat(block(pipelineIdentification), "\n\n                            Can not resolve:\n                            ").concat(block(unresovedTemplates_1
+                                        spaceTrim.spaceTrim(function (block) { return "\n                            Can not resolve some parameters:\n\n                            ".concat(block(pipelineIdentification), "\n\n                            **Can not resolve:**\n                            ").concat(block(unresovedTemplates_1
                                             .map(function (_a) {
                                             var resultingParameterName = _a.resultingParameterName, dependentParameterNames = _a.dependentParameterNames;
-                                            return "- Parameter {".concat(resultingParameterName, "} which depends on ").concat(dependentParameterNames
-                                                .map(function (dependentParameterName) { return "{".concat(dependentParameterName, "}"); })
+                                            return "- Parameter `{".concat(resultingParameterName, "}` which depends on ").concat(dependentParameterNames
+                                                .map(function (dependentParameterName) { return "`{".concat(dependentParameterName, "}`"); })
                                                 .join(' and '));
                                         })
-                                            .join('\n')), "\n\n                            Resolved:\n                            ").concat(block(resovedParameterNames_1.map(function (name) { return "- Parameter {".concat(name, "}"); }).join('\n')), "\n\n                            Note: This should be catched in `validatePipeline`\n                        "); }));
+                                            .join('\n')), "\n\n                            **Resolved:**\n                            ").concat(block(resovedParameterNames_1
+                                            .filter(function (name) {
+                                            return !RESERVED_PARAMETER_NAMES.includes(name);
+                                        })
+                                            .map(function (name) { return "- Parameter `{".concat(name, "}`"); })
+                                            .join('\n')), "\n\n                            **Reserved (which are available):**\n                            ").concat(block(resovedParameterNames_1
+                                            .filter(function (name) {
+                                            return RESERVED_PARAMETER_NAMES.includes(name);
+                                        })
+                                            .map(function (name) { return "- Parameter `{".concat(name, "}`"); })
+                                            .join('\n')), "\n\n                            *Note: This should be catched in `validatePipeline`*\n                        "); }));
                                     case 1:
                                         if (!!currentTemplate) return [3 /*break*/, 3];
                                         /* [🤹‍♂️] */ return [4 /*yield*/, Promise.race(resolving_1)];
@@ -6528,9 +6553,35 @@
      * @public exported from `@promptbook/core`
      */
     var ChatFormfactorDefinition = {
-        name: 'CHAT',
+        name: 'CHATBOT',
+        aliasNames: ['CHAT'],
         description: "@@@",
         documentationUrl: "https://github.com/webgptorg/promptbook/discussions/@@",
+        pipelineInterface: {
+            inputParameterNames: ['previousTitle', 'previousConversationSummary', 'userMessage'],
+            outputParameterNames: ['title', 'conversationSummary', 'chatbotResponse'],
+            /*
+            <- TODO: !!!!!! Change to
+
+            -   INPUT PARAMETER `{previousTitle}` Previous title of the conversation
+            -   INPUT PARAMETER `{previousConversationSummary}` Previous conversation summary
+            -   INPUT PARAMETER `{userMessage}` User message
+            -   OUTPUT PARAMETER `{title}` Title of the conversation
+            -   OUTPUT PARAMETER `{conversationSummary}` Summary of the conversation
+            -   OUTPUT PARAMETER `{chatbotResponse}` Chatbot response
+
+            */
+        },
+    };
+
+    /**
+     * @@@
+     *
+     * @public exported from `@promptbook/core`
+     */
+    var GENERIC_PIPELINE_INTERFACE = {
+        inputParameterNames: [],
+        outputParameterNames: [],
     };
 
     /**
@@ -6542,6 +6593,37 @@
         name: 'GENERIC',
         description: "@@@",
         documentationUrl: "https://github.com/webgptorg/promptbook/discussions/@@",
+        pipelineInterface: GENERIC_PIPELINE_INTERFACE,
+    };
+
+    /**
+     * Sheets is form of app that @@@
+     *
+     * @public exported from `@promptbook/core`
+     */
+    var SheetsFormfactorDefinition = {
+        name: 'SHEETS',
+        description: "@@@",
+        documentationUrl: "https://github.com/webgptorg/promptbook/discussions/@@",
+        pipelineInterface: {
+            inputParameterNames: ['inputSheet'],
+            outputParameterNames: ['outputSheet'],
+        },
+    };
+
+    /**
+     * Translator is form of app that @@@
+     *
+     * @public exported from `@promptbook/core`
+     */
+    var TranslatorFormfactorDefinition = {
+        name: 'TRANSLATOR',
+        description: "@@@",
+        documentationUrl: "https://github.com/webgptorg/promptbook/discussions/@@",
+        pipelineInterface: {
+            inputParameterNames: ['inputMessage'],
+            outputParameterNames: ['outputMessage'],
+        },
     };
 
     /**
@@ -6549,7 +6631,12 @@
      *
      * @public exported from `@promptbook/core`
      */
-    var FORMFACTOR_DEFINITIONS = [GenericFormfactorDefinition, ChatFormfactorDefinition];
+    var FORMFACTOR_DEFINITIONS = [
+        GenericFormfactorDefinition,
+        ChatFormfactorDefinition,
+        TranslatorFormfactorDefinition,
+        SheetsFormfactorDefinition,
+    ];
 
     /**
      * Parses the formfactor command
@@ -6584,7 +6671,7 @@
         /**
          * Example usages of the FORMFACTOR command
          */
-        examples: ['FORMFACTOR Chat', 'FORMFACTOR Generic'],
+        examples: ['FORMFACTOR Chatbot', 'FF Chat'],
         /**
          * Parses the FORMFACTOR command
          */
@@ -6593,16 +6680,19 @@
             if (args.length !== 1) {
                 throw new ParseError("FORMFACTOR command requires exactly one argument");
             }
-            var formfactorName = args[0].toUpperCase();
-            if (!FORMFACTOR_DEFINITIONS.some(function (definition) { return definition.name === formfactorName; })) {
-                throw new ParseError(spaceTrim__default["default"](function (block) { return "\n                        Unknown formfactor name \"".concat(formfactorName, "\"\n\n                        Available formfactors:\n                        ").concat(block(FORMFACTOR_DEFINITIONS.map(function (_a) {
+            var formfactorNameCandidate = args[0].toUpperCase();
+            var formfactor = FORMFACTOR_DEFINITIONS.find(function (definition) {
+                return __spreadArray([definition.name], __read(__assign({ aliasNames: [] }, definition).aliasNames), false).includes(formfactorNameCandidate);
+            });
+            if (formfactor === undefined) {
+                throw new ParseError(spaceTrim__default["default"](function (block) { return "\n                        Unknown formfactor name \"".concat(formfactorNameCandidate, "\"\n\n                        Available formfactors:\n                        ").concat(block(FORMFACTOR_DEFINITIONS.map(function (_a) {
                     var name = _a.name;
                     return "- ".concat(name);
                 }).join('\n')), "\n                    "); }));
             }
             return {
                 type: 'FORMFACTOR',
-                formfactorName: formfactorName,
+                formfactorName: formfactor.name,
             };
         },
         /**
@@ -6902,7 +6992,7 @@
             // <- TODO: When [🥶] fixed, change to:
             //        >   const parameterDescriptionRaw = rawArgs.split(parameterNameRaw).join('').trim();
             if (parameterDescriptionRaw && parameterDescriptionRaw.match(/\{(?<embeddedParameterName>[a-z0-9_]+)\}/im)) {
-                throw new ParseError(spaceTrim__default["default"](function (block) { return "\n                        Parameter {".concat(parameterNameRaw, "} can not contain another parameter in description\n\n                        The description:\n                        ").concat(block(parameterDescriptionRaw), "\n                    "); }));
+                throw new ParseError(spaceTrim__default["default"](function (block) { return "\n                        Parameter `{".concat(parameterNameRaw, "}` can not contain another parameter in description\n\n                        The description:\n                        ").concat(block(parameterDescriptionRaw), "\n                    "); }));
             }
             var isInput = normalized.startsWith('INPUT');
             var isOutput = normalized.startsWith('OUTPUT');
@@ -7948,7 +8038,7 @@
                 existingParameter.description &&
                 existingParameter.description !== parameterDescription &&
                 parameterDescription) {
-                throw new ParseError(spaceTrim.spaceTrim(function (block) { return "\n                        Parameter {".concat(parameterName, "} is defined multiple times with different description:\n\n                        ").concat(block(getPipelineIdentification()), "\n\n                        First definition:\n                        ").concat(block(existingParameter.description || '[undefined]'), "\n\n                        Second definition:\n                        ").concat(block(parameterDescription || '[undefined]'), "\n                    "); }));
+                throw new ParseError(spaceTrim.spaceTrim(function (block) { return "\n                        Parameter `{".concat(parameterName, "}` is defined multiple times with different description:\n\n                        ").concat(block(getPipelineIdentification()), "\n\n                        First definition:\n                        ").concat(block(existingParameter.description || '[undefined]'), "\n\n                        Second definition:\n                        ").concat(block(parameterDescription || '[undefined]'), "\n                    "); }));
             }
             if (existingParameter) {
                 if (parameterDescription) {
@@ -9333,10 +9423,10 @@
                                 /*
                                 Note: Remapping error
                                       From: [PipelineUrlError: thing is not defined],
-                                      To:   [PipelineExecutionError: Parameter {thing} is not defined],
+                                      To:   [PipelineExecutionError: Parameter `{thing}` is not defined],
                                 */
                                 if (!statementToEvaluate.includes(undefinedName_1 + '(')) {
-                                    throw new PipelineExecutionError(spaceTrim__default["default"](function (block) { return "\n\n                                Parameter {".concat(undefinedName_1, "} is not defined\n\n                                This happen during evaluation of the javascript, which has access to the following parameters as javascript variables:\n\n                                ").concat(block(Object.keys(parameters)
+                                    throw new PipelineExecutionError(spaceTrim__default["default"](function (block) { return "\n\n                                Parameter `{".concat(undefinedName_1, "}` is not defined\n\n                                This happen during evaluation of the javascript, which has access to the following parameters as javascript variables:\n\n                                ").concat(block(Object.keys(parameters)
                                         .map(function (key) { return "  - ".concat(key, "\n"); })
                                         .join('')), "\n\n                                The script is:\n                                ```javascript\n                                ").concat(block(script), "\n                                ```\n\n                                Original error message:\n                                ").concat(block(error_1.message), "\n\n\n                            "); }));
                                 }