@promptbook/cli 0.86.0-8 → 0.86.5

package/README.md

@@ -5,8 +5,8 @@
 
 
 
-[![NPM Version of ![Promptbook logo - cube with letters P and B](./other/design/logo-h1.png) Promptbook](https://badge.fury.io/js/promptbook.svg)](https://www.npmjs.com/package/promptbook)
-[![Quality of package ![Promptbook logo - cube with letters P and B](./other/design/logo-h1.png) Promptbook](https://packagequality.com/shield/promptbook.svg)](https://packagequality.com/#?package=promptbook)
+[![NPM Version of ![Promptbook logo - cube with letters P and B](./design/logo-h1.png) Promptbook](https://badge.fury.io/js/promptbook.svg)](https://www.npmjs.com/package/promptbook)
+[![Quality of package ![Promptbook logo - cube with letters P and B](./design/logo-h1.png) Promptbook](https://packagequality.com/shield/promptbook.svg)](https://packagequality.com/#?package=promptbook)
 [![Known Vulnerabilities](https://snyk.io/test/github/webgptorg/promptbook/badge.svg)](https://snyk.io/test/github/webgptorg/promptbook)
 [![Issues](https://img.shields.io/github/issues/webgptorg/promptbook.svg?style=flat)](https://github.com/webgptorg/promptbook/issues)
 
@@ -17,18 +17,12 @@
 ## 🌟 New Features
 
 -   📂 We have plugin for [VSCode](https://github.com/webgptorg/book-extension) to support `.book` file extension
+-   🐳 Available [Docker image](https://hub.docker.com/r/hejny/promptbook/)
 -   💫 Support of [`o3-mini` model by OpenAI](https://openai.com/index/openai-o3-mini/)
 -   🐋 **Support of [DeepSeek models](https://www.npmjs.com/package/@promptbook/deepseek)**
--   💙 Working [the **Book** language v1.0.0](https://github.com/webgptorg/book)
--   🖤 Run books from CLI - `npx ptbk run path/to/your/book`
--   📚 Support of `.docx`, `.doc` and `.pdf` documents as knowledge
 
 
 
-<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/cli`
 
 - Promptbooks are [divided into several](#-packages) packages, all are published from [single monorepo](https://github.com/webgptorg/promptbook).
@@ -114,6 +108,8 @@ Rest of the documentation is common for **entire promptbook ecosystem**:
 
 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.
@@ -171,34 +167,41 @@ We also have a community of developers and users of **Promptbook**:
 -   [Landing page `ptbk.io`](https://ptbk.io)
 -   [Github discussions](https://github.com/webgptorg/promptbook/discussions)
 -   [LinkedIn `Promptbook`](https://linkedin.com/company/promptbook)
--   [Facebook `Promptbook`](https://www.facebook.com/61560776453536)
+-   [Facebook `Promptbook`](https://www.facebook.com/61560776453536) 
 
 And **Promptbook.studio** branded socials:
 
+
+
 -   [Instagram `@promptbook.studio`](https://www.instagram.com/promptbook.studio/)
 
+
+
 And **Promptujeme** sub-brand:
 
-_/Subbrand for Czech clients/_
+*/Subbrand for Czech clients/*
+
+
 
 -   [Promptujeme.cz](https://www.promptujeme.cz/)
 -   [Facebook `Promptujeme`](https://www.facebook.com/promptujeme/)
 
+
 And **Promptbook.city** branded socials:
 
-_/Sub-brand for images and graphics generated via Promptbook prompting/_
+*/Sub-brand for images and graphics generated via Promptbook prompting/*
 
 -   [Instagram `@promptbook.city`](https://www.instagram.com/promptbook.city/)
--   [Facebook `Promptbook City`](https://www.facebook.com/61565718625569)
+-   [Facebook `Promptbook City`](https://www.facebook.com/61565718625569) 
 
 
 
-## 💙 Book language _(for prompt-engineer)_
 
 
 
+## 💙 The Book language
+
 
-## 💙 The blueprint of book language
 
 Following is the documentation and blueprint of the Book language.
 
@@ -207,6 +210,11 @@ Following is the documentation and blueprint of the Book language.
 ```markdown
 # 🌟 My first Book
 
+-   BOOK VERSION 1.0.0
+-   URL https://promptbook.studio/my-first-book/
+
+# Write an article
+
 -   PERSONA Jane, marketing specialist with prior experience in writing articles about technology and artificial intelligence
 -   KNOWLEDGE https://ptbk.io
 -   KNOWLEDGE ./promptbook.pdf
@@ -219,59 +227,31 @@ Following is the documentation and blueprint of the Book language.
 -> {article}
 ```
 
-### Goals and principles of book language
-
-File is designed to be easy to read and write. It is strict subset of markdown. It is designed to be understandable by both humans and machines and without specific knowledge of the language.
-
-It has file with `.book.md` or `.book` extension with `UTF-8` non BOM encoding.
-
-As it is source code, it can leverage all the features of version control systems like git and does not suffer from the problems of binary formats, proprietary formats, or no-code solutions.
-
-But unlike programming languages, it is designed to be understandable by non-programmers and non-technical people.
-
-### Structure
-
-Book is divided into sections. Each section starts with heading. The language itself is not sensitive to the type of heading _(`h1`, `h2`, `h3`, ...)_ but it is recommended to use `h1` for header section and `h2` for other sections.
-
-### Header
-
-Header is the first section of the book. It contains metadata about the pipeline. It is recommended to use `h1` heading for header section but it is not required.
-
-### Parameter
+### **What:** Workflows, Tasks and Parameters
 
-Foo bar
+-   [PARAMETER](https://github.com/webgptorg/promptbook/blob/main/documents/commands/PARAMETER.md)
 
-#### Parameter names
+### **Who:** Personas
 
-Reserved words:
+-   [PERSONA](https://github.com/webgptorg/promptbook/blob/main/documents/commands/PERSONA.md)
 
--   _each command_ like `PERSONA`, `EXPECT`, `KNOWLEDGE`, etc.
--   `content`
--   `context`
--   `knowledge`
--   `examples`
--   `modelName`
--   `currentDate`
+### **How:** Knowledge, Instruments and Actions
 
-#### Parameter notation
+-   [KNOWLEDGE](https://github.com/webgptorg/promptbook/blob/main/documents/commands/KNOWLEDGE.md)
+-   [INSTRUMENT](https://github.com/webgptorg/promptbook/blob/main/documents/commands/INSTRUMENT.md)
+-   [ACTION](https://github.com/webgptorg/promptbook/blob/main/documents/commands/ACTION.md)
 
-### Task
+### General principles of book language
 
-### Task type
+Book language is based on markdown. It is subset of markdown. It is designed to be easy to read and write. It is designed to be understandable by both humans and machines and without specific knowledge of the language.
 
-Todo todo
+The file has `.book` extension. It uses `UTF-8` non BOM encoding.
 
-### Command
+Book has two variants: flat - which is just a prompt with no structure, and full - which has a structure with tasks, commands and prompts.
 
-Todo todo
-
-### Block
-
-Todo todo
-
-### Return parameter
+As it is source code, it can leverage all the features of version control systems like git and does not suffer from the problems of binary formats, proprietary formats, or no-code solutions.
 
-### Examples
+But unlike programming languages, it is designed to be understandable by non-programmers and non-technical people.
 
 
 
@@ -317,6 +297,7 @@ Or you can install them separately:
 -   **[@promptbook/templates](https://www.npmjs.com/package/@promptbook/templates)** - Usefull templates and examples of books which can be used as a starting point
 -   **[@promptbook/types](https://www.npmjs.com/package/@promptbook/types)** - Just typescript types used in the library
 -   ⭐ **[@promptbook/cli](https://www.npmjs.com/package/@promptbook/cli)** - Command line interface utilities for promptbooks
+-   🐋 **[Docker image](https://hub.docker.com/r/hejny/promptbook/)** - Promptbook server
 
 
 
@@ -325,6 +306,11 @@ Or you can install them separately:
 
 ## 📚 Dictionary
 
+
+
+
+
+
 ### 📚 Dictionary
 
 The following glossary is used to clarify certain concepts:
@@ -340,6 +326,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
@@ -400,6 +388,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
@@ -479,7 +469,7 @@ See [TODO.md](./TODO.md)
 <div style="display: flex; align-items: center; gap: 20px;">
 
   <a href="https://promptbook.studio/">
-    <img src="./other/design/promptbook-studio-logo.png" alt="Partner 3" height="100">
+    <img src="./design/promptbook-studio-logo.png" alt="Partner 3" height="100">
   </a>
 
   <a href="https://technologickainkubace.org/en/about-technology-incubation/about-the-project/">

package/esm/index.es.js

@@ -8,6 +8,7 @@ import hexEncoder from 'crypto-js/enc-hex';
 import sha256 from 'crypto-js/sha256';
 import * as dotenv from 'dotenv';
 import { spawn } from 'child_process';
+import JSZip from 'jszip';
 import { format } from 'prettier';
 import parserHtml from 'prettier/parser-html';
 import { BehaviorSubject } from 'rxjs';
@@ -43,7 +44,7 @@ var BOOK_LANGUAGE_VERSION = '1.0.0';
  * @generated
  * @see https://github.com/webgptorg/promptbook
  */
-var PROMPTBOOK_ENGINE_VERSION = '0.86.0-7';
+var PROMPTBOOK_ENGINE_VERSION = '0.86.5';
 /**
  * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
  * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -549,6 +550,7 @@ function $initializeHelloCommand(program) {
     var _this = this;
     var helloCommand = program.command('hello');
     helloCommand.description(spaceTrim("\n            Just command for testing\n        "));
+    helloCommand.alias('hi');
     helloCommand.argument('[name]', 'Your name', 'Paul');
     helloCommand.option('-g, --greeting <greeting>', "Greeting", 'Hello');
     helloCommand.action(function (name, _a) {
@@ -2922,6 +2924,8 @@ function $initializeListModelsCommand(program) {
     var _this = this;
     var listModelsCommand = program.command('list-models');
     listModelsCommand.description(spaceTrim("\n            List all available and configured LLM models\n        "));
+    listModelsCommand.alias('models');
+    listModelsCommand.alias('llm');
     listModelsCommand.action(function () { return __awaiter(_this, void 0, void 0, function () {
         var llm;
         return __generator(this, function (_a) {
@@ -3607,6 +3611,7 @@ function $initializeListScrapersCommand(program) {
     var _this = this;
     var listModelsCommand = program.command('list-scrapers');
     listModelsCommand.description(spaceTrim("\n            List all available and configured scrapers and executables\n        "));
+    listModelsCommand.alias('scrapers');
     listModelsCommand.action(function () { return __awaiter(_this, void 0, void 0, function () {
         var scrapers, executables;
         return __generator(this, function (_a) {
@@ -3798,7 +3803,7 @@ function capitalize(word) {
  * Converts promptbook in JSON format to string format
  *
  * @deprecated TODO: [🥍][🧠] Backup original files in `PipelineJson` same as in Promptbook.studio
- * @param pipelineJson Promptbook in JSON format (.book.json)
+ * @param pipelineJson Promptbook in JSON format (.bookc)
  * @returns Promptbook in string format (.book.md)
  * @public exported from `@promptbook/core`
  */
@@ -10744,7 +10749,7 @@ function flattenMarkdown(markdown) {
  * Note: This function acts as compilation process
  *
  * @param pipelineString {Promptbook} in string markdown format (.book.md)
- * @returns {Promptbook} compiled in JSON format (.book.json)
+ * @returns {Promptbook} compiled in JSON format (.bookc)
  * @throws {ParseError} if the promptbook string is not valid
  * @public exported from `@promptbook/core`
  */
@@ -11212,7 +11217,7 @@ function parsePipeline(pipelineString) {
  * @param pipelineString {Promptbook} in string markdown format (.book.md)
  * @param tools - Tools for the preparation and scraping - if not provided together with `llm`, the preparation will be skipped
  * @param options - Options and tools for the compilation
- * @returns {Promptbook} compiled in JSON format (.book.json)
+ * @returns {Promptbook} compiled in JSON format (.bookc)
  * @throws {ParseError} if the promptbook string is not valid
  * @public exported from `@promptbook/core`
  */
@@ -12006,7 +12011,7 @@ function createCollectionFromDirectory(rootPath, tools, options) {
                     }
                     madeLibraryFilePath = join(rootPath, "".concat(DEFAULT_PIPELINE_COLLECTION_BASE_FILENAME
                     // <- TODO: [🦒] Allow to override (pass different value into the function)
-                    , ".json"));
+                    , ".bookc"));
                     return [4 /*yield*/, isFileExisting(madeLibraryFilePath, tools.fs)];
                 case 3:
                     if (!(_f.sent())) ;
@@ -12028,13 +12033,13 @@ function createCollectionFromDirectory(rootPath, tools, options) {
                                     return [4 /*yield*/, listAllFiles(rootPath, isRecursive, tools.fs)];
                                 case 1:
                                     fileNames = _b.sent();
-                                    // Note: First load all `.book.json` and then `.book` / `.book` files
-                                    //       `.book.json` can be prepared so it is faster to load
+                                    // Note: First load compiled `.bookc` files and then source `.book` files
+                                    //       `.bookc` are already compiled and can be used faster
                                     fileNames.sort(function (a, b) {
-                                        if (a.endsWith('.json') && (b.endsWith('.book') || b.endsWith('.book'))) {
+                                        if ((a.endsWith('.bookc') || a.endsWith('.book.json')) && (b.endsWith('.book') || b.endsWith('.book.md'))) {
                                             return -1;
                                         }
-                                        if ((a.endsWith('.book') || a.endsWith('.book')) && b.endsWith('.json')) {
+                                        if ((a.endsWith('.book') || a.endsWith('.book.md')) && (b.endsWith('.bookc') || b.endsWith('.book.json'))) {
                                             return 1;
                                         }
                                         return 0;
@@ -12051,7 +12056,7 @@ function createCollectionFromDirectory(rootPath, tools, options) {
                                                 case 1:
                                                     _f.trys.push([1, 8, , 9]);
                                                     pipeline = null;
-                                                    if (!(fileName.endsWith('.book') || fileName.endsWith('.book'))) return [3 /*break*/, 4];
+                                                    if (!(fileName.endsWith('.book') || fileName.endsWith('.book.md'))) return [3 /*break*/, 4];
                                                     _c = validatePipelineString;
                                                     return [4 /*yield*/, readFile(fileName, 'utf-8')];
                                                 case 2:
@@ -12064,7 +12069,7 @@ function createCollectionFromDirectory(rootPath, tools, options) {
                                                     pipeline = __assign(__assign({}, pipeline), { sourceFile: sourceFile });
                                                     return [3 /*break*/, 7];
                                                 case 4:
-                                                    if (!fileName.endsWith('.book.json')) return [3 /*break*/, 6];
+                                                    if (!(fileName.endsWith('.bookc') || fileName.endsWith('.book.json'))) return [3 /*break*/, 6];
                                                     _e = (_d = JSON).parse;
                                                     return [4 /*yield*/, readFile(fileName, 'utf-8')];
                                                 case 5:
@@ -12269,13 +12274,16 @@ function $initializeMakeCommand(program) {
     var _this = this;
     var makeCommand = program.command('make');
     makeCommand.description(spaceTrim("\n            Makes a new pipeline collection in given folder\n        "));
+    makeCommand.alias('compile');
+    makeCommand.alias('prepare');
+    makeCommand.alias('build');
     // TODO: [🧅] DRY command arguments
     makeCommand.argument('[path]', 
     // <- TODO: [🧟‍♂️] Unite path to promptbook collection argument
     'Path to promptbook collection directory', DEFAULT_BOOKS_DIRNAME);
     makeCommand.option('--project-name', "Name of the project for whom collection is", 'Untitled Promptbook project');
     makeCommand.option('--root-url <url>', "Root URL of all pipelines to make", undefined);
-    makeCommand.option('-f, --format <format>', spaceTrim("\n            Output format of builded collection \"javascript\", \"typescript\" or \"json\"\n\n            Note: You can use multiple formats separated by comma\n        "), 'javascript' /* <- Note: [🏳‍🌈] */);
+    makeCommand.option('-f, --format <format>', spaceTrim("\n            Output format of builded collection \"bookc\", \"javascript\", \"typescript\" or \"json\"\n\n            Note: You can use multiple formats separated by comma\n        "), 'bookc' /* <- Note: [🏳‍🌈] */);
     makeCommand.option('--no-validation', "Do not validate logic of pipelines in collection", true);
     makeCommand.option('--validation', "Types of validations separated by comma (options \"logic\",\"imports\")", 'logic,imports');
     makeCommand.option('-r, --reload', "Call LLM models even if same prompt with result is in the cache", false);
@@ -12285,7 +12293,7 @@ function $initializeMakeCommand(program) {
     makeCommand.action(function (path, _a) {
         var projectName = _a.projectName, rootUrl = _a.rootUrl, format = _a.format, functionName = _a.functionName, validation = _a.validation, isCacheReloaded = _a.reload, isVerbose = _a.verbose, output = _a.output;
         return __awaiter(_this, void 0, void 0, function () {
-            var formats, validations, prepareAndScrapeOptions, fs, llm, executables, tools, collection, pipelinesUrls, validations_1, validations_1_1, validation_1, pipelinesUrls_1, pipelinesUrls_1_1, pipelineUrl, pipeline, e_1_1, e_2_1, collectionJson, collectionJsonString, collectionJsonItems, saveFile;
+            var formats, validations, prepareAndScrapeOptions, fs, llm, executables, tools, collection, pipelinesUrls, validations_1, validations_1_1, validation_1, pipelinesUrls_1, pipelinesUrls_1_1, pipelineUrl, pipeline, e_1_1, e_2_1, collectionJson, collectionJsonString, collectionJsonItems, saveFile, bookcBundle;
             var _b, e_2, _c, e_1, _d;
             var _this = this;
             return __generator(this, function (_e) {
@@ -12421,7 +12429,7 @@ function $initializeMakeCommand(program) {
                             return spaceTrim(collectionJsonString.substring(1, collectionJsonString.length - 1));
                         })();
                         saveFile = function (extension, content) { return __awaiter(_this, void 0, void 0, function () {
-                            var filename;
+                            var filename, data;
                             return __generator(this, function (_a) {
                                 switch (_a.label) {
                                     case 0:
@@ -12434,36 +12442,55 @@ function $initializeMakeCommand(program) {
                                         return [4 /*yield*/, mkdir(dirname(filename), { recursive: true })];
                                     case 1:
                                         _a.sent();
+                                        if (!(typeof content === 'string')) return [3 /*break*/, 3];
                                         return [4 /*yield*/, writeFile(filename, content, 'utf-8')];
                                     case 2:
                                         _a.sent();
+                                        return [3 /*break*/, 6];
+                                    case 3: return [4 /*yield*/, content.generateAsync({ type: 'nodebuffer', streamFiles: true })];
+                                    case 4:
+                                        data = _a.sent();
+                                        return [4 /*yield*/, writeFile(filename, data)];
+                                    case 5:
+                                        _a.sent();
+                                        _a.label = 6;
+                                    case 6:
                                         // Note: Log despite of verbose mode
                                         console.info(colors.green("Made ".concat(filename.split('\\').join('/'))));
                                         return [2 /*return*/];
                                 }
                             });
                         }); };
-                        if (!formats.includes('json')) return [3 /*break*/, 22];
-                        formats = formats.filter(function (format) { return format !== 'json'; });
-                        return [4 /*yield*/, saveFile('json', collectionJsonString)];
+                        if (!formats.includes('bookc')) return [3 /*break*/, 22];
+                        formats = formats.filter(function (format) { return format !== 'bookc'; });
+                        bookcBundle = new JSZip();
+                        bookcBundle.file('index.book.json', collectionJsonString);
+                        return [4 /*yield*/, saveFile('bookc', bookcBundle)];
                     case 21:
                         _e.sent();
                         _e.label = 22;
                     case 22:
-                        if (!(formats.includes('javascript') || formats.includes('js'))) return [3 /*break*/, 24];
-                        formats = formats.filter(function (format) { return format !== 'javascript' && format !== 'js'; });
-                        return [4 /*yield*/, saveFile('js', spaceTrim(function (block) { return "\n                            // ".concat(block(GENERATOR_WARNING_BY_PROMPTBOOK_CLI), "\n\n                            import { createCollectionFromJson } from '@promptbook/core';\n\n                            /**\n                             * Pipeline collection for ").concat(projectName, "\n                             *\n                             * ").concat(block(GENERATOR_WARNING_BY_PROMPTBOOK_CLI), "\n                             *\n                             * @generated\n                             * @private internal cache for `").concat(functionName, "`\n                             */\n                            let pipelineCollection = null;\n\n\n                            /**\n                             * Get pipeline collection for ").concat(projectName, "\n                             *\n                             * ").concat(block(GENERATOR_WARNING_BY_PROMPTBOOK_CLI), "\n                             *\n                             * @generated\n                             * @returns {PipelineCollection} Library of promptbooks for ").concat(projectName, "\n                             */\n                            export function ").concat(functionName, "(){\n                                if(pipelineCollection===null){\n                                    pipelineCollection = createCollectionFromJson(\n                                        ").concat(block(collectionJsonItems), "\n                                    );\n                                }\n\n                                return pipelineCollection;\n                            }\n                        "); }))];
+                        if (!formats.includes('json')) return [3 /*break*/, 24];
+                        formats = formats.filter(function (format) { return format !== 'json'; });
+                        return [4 /*yield*/, saveFile('json', collectionJsonString)];
                     case 23:
-                        (_e.sent()) + '\n';
+                        _e.sent();
                         _e.label = 24;
                     case 24:
-                        if (!(formats.includes('typescript') || formats.includes('ts'))) return [3 /*break*/, 26];
-                        formats = formats.filter(function (format) { return format !== 'typescript' && format !== 'ts'; });
-                        return [4 /*yield*/, saveFile('ts', spaceTrim(function (block) { return "\n                            // ".concat(block(GENERATOR_WARNING_BY_PROMPTBOOK_CLI), "\n\n                            import { createCollectionFromJson } from '@promptbook/core';\n                            import type { PipelineCollection } from '@promptbook/types';\n\n                            /**\n                             * Pipeline collection for ").concat(projectName, "\n                             *\n                             * ").concat(block(GENERATOR_WARNING_BY_PROMPTBOOK_CLI), "\n                             *\n                             * @private internal cache for `").concat(functionName, "`\n                             * @generated\n                             */\n                            let pipelineCollection: null | PipelineCollection = null;\n\n\n                            /**\n                             * Get pipeline collection for ").concat(projectName, "\n                             *\n                             * ").concat(block(GENERATOR_WARNING_BY_PROMPTBOOK_CLI), "\n                             *\n                             * @generated\n                             * @returns {PipelineCollection} Library of promptbooks for ").concat(projectName, "\n                             */\n                            export function ").concat(functionName, "(): PipelineCollection{\n                                if(pipelineCollection===null){\n\n                                    // TODO: !!6 Use book string literal notation\n                                    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n                                    pipelineCollection = (createCollectionFromJson as (..._: any) => PipelineCollection)(\n                                        ").concat(block(collectionJsonItems), "\n                                    );\n                                }\n\n                                return pipelineCollection;\n                            }\n                        "); }) + '\n')];
+                        if (!(formats.includes('javascript') || formats.includes('js'))) return [3 /*break*/, 26];
+                        formats = formats.filter(function (format) { return format !== 'javascript' && format !== 'js'; });
+                        return [4 /*yield*/, saveFile('js', spaceTrim(function (block) { return "\n                            // ".concat(block(GENERATOR_WARNING_BY_PROMPTBOOK_CLI), "\n\n                            import { createCollectionFromJson } from '@promptbook/core';\n\n                            /**\n                             * Pipeline collection for ").concat(projectName, "\n                             *\n                             * ").concat(block(GENERATOR_WARNING_BY_PROMPTBOOK_CLI), "\n                             *\n                             * @generated\n                             * @private internal cache for `").concat(functionName, "`\n                             */\n                            let pipelineCollection = null;\n\n\n                            /**\n                             * Get pipeline collection for ").concat(projectName, "\n                             *\n                             * ").concat(block(GENERATOR_WARNING_BY_PROMPTBOOK_CLI), "\n                             *\n                             * @generated\n                             * @returns {PipelineCollection} Library of promptbooks for ").concat(projectName, "\n                             */\n                            export function ").concat(functionName, "(){\n                                if(pipelineCollection===null){\n                                    pipelineCollection = createCollectionFromJson(\n                                        ").concat(block(collectionJsonItems), "\n                                    );\n                                }\n\n                                return pipelineCollection;\n                            }\n                        "); }))];
                     case 25:
-                        _e.sent();
+                        (_e.sent()) + '\n';
                         _e.label = 26;
                     case 26:
+                        if (!(formats.includes('typescript') || formats.includes('ts'))) return [3 /*break*/, 28];
+                        formats = formats.filter(function (format) { return format !== 'typescript' && format !== 'ts'; });
+                        return [4 /*yield*/, saveFile('ts', spaceTrim(function (block) { return "\n                            // ".concat(block(GENERATOR_WARNING_BY_PROMPTBOOK_CLI), "\n\n                            import { createCollectionFromJson } from '@promptbook/core';\n                            import type { PipelineCollection } from '@promptbook/types';\n\n                            /**\n                             * Pipeline collection for ").concat(projectName, "\n                             *\n                             * ").concat(block(GENERATOR_WARNING_BY_PROMPTBOOK_CLI), "\n                             *\n                             * @private internal cache for `").concat(functionName, "`\n                             * @generated\n                             */\n                            let pipelineCollection: null | PipelineCollection = null;\n\n\n                            /**\n                             * Get pipeline collection for ").concat(projectName, "\n                             *\n                             * ").concat(block(GENERATOR_WARNING_BY_PROMPTBOOK_CLI), "\n                             *\n                             * @generated\n                             * @returns {PipelineCollection} Library of promptbooks for ").concat(projectName, "\n                             */\n                            export function ").concat(functionName, "(): PipelineCollection{\n                                if(pipelineCollection===null){\n\n                                    // TODO: !!6 Use book string literal notation\n                                    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n                                    pipelineCollection = (createCollectionFromJson as (..._: any) => PipelineCollection)(\n                                        ").concat(block(collectionJsonItems), "\n                                    );\n                                }\n\n                                return pipelineCollection;\n                            }\n                        "); }) + '\n')];
+                    case 27:
+                        _e.sent();
+                        _e.label = 28;
+                    case 28:
                         if (formats.length > 0) {
                             console.warn(colors.yellow("Format ".concat(formats.join(' and '), " is not supported")));
                         }
@@ -13266,6 +13293,7 @@ function $initializeRunCommand(program) {
     var _this = this;
     var runCommand = program.command('run', { isDefault: true });
     runCommand.description(spaceTrim("\n            Runs a pipeline\n        "));
+    runCommand.alias('execute');
     // TODO: [🧅] DRY command arguments
     runCommand.argument('[pipelineSource]', 'Path to book file OR URL to book file, if not provided it will be asked');
     runCommand.option('-r, --reload', "Call LLM models even if same prompt with result is in the cache", false);
@@ -13281,6 +13309,10 @@ function $initializeRunCommand(program) {
             switch (_m.label) {
                 case 0:
                     isCacheReloaded = options.reload, isInteractive = options.interactive, isFormfactorUsed = options.formfactor, json = options.json, isVerbose = options.verbose, saveReport = options.saveReport;
+                    if (pipelineSource.includes('-') && normalizeToKebabCase(pipelineSource) === pipelineSource) {
+                        console.error(colors.red("\"\"".concat(pipelineSource, "\" is not a valid command or book. See 'ptbk --help'.")));
+                        return [2 /*return*/, process.exit(1)];
+                    }
                     if (saveReport && !saveReport.endsWith('.json') && !saveReport.endsWith('.md')) {
                         console.error(colors.red("Report file must be .json or .md"));
                         return [2 /*return*/, process.exit(1)];
@@ -14072,6 +14104,7 @@ function $initializeStartServerCommand(program) {
     startServerCommand.option('-r, --reload', "Call LLM models even if same prompt with result is in the cache", false);
     startServerCommand.option('-v, --verbose', "Is output verbose", false);
     startServerCommand.description(spaceTrim("\n            Starts a remote server to execute books\n        "));
+    startServerCommand.alias('server');
     startServerCommand.action(function (path, _a) {
         var portRaw = _a.port, rawUrl = _a.url, isAnonymousModeAllowed = _a.allowAnonymous, isCacheReloaded = _a.reload, isVerbose = _a.verbose;
         return __awaiter(_this, void 0, void 0, function () {
@@ -14169,7 +14202,7 @@ function $initializeStartServerCommand(program) {
 function $initializeTestCommand(program) {
     var _this = this;
     var testCommand = program.command('test');
-    testCommand.description(spaceTrim("\n            Iterates over `.book.md` and `.book.json` and checks if they are parsable and logically valid\n      "));
+    testCommand.description(spaceTrim("\n            Iterates over `.book.md` and `.bookc` and checks if they are parsable and logically valid\n      "));
     testCommand.argument('<filesGlob>', 
     // <- TODO: [🧟‍♂️] Unite path to promptbook collection argument
     'Pipelines to test as glob pattern');
@@ -14234,7 +14267,7 @@ function $initializeTestCommand(program) {
                         }
                         _g.label = 10;
                     case 10:
-                        if (!filename.endsWith('.book.json')) return [3 /*break*/, 12];
+                        if (!filename.endsWith('.bookc')) return [3 /*break*/, 12];
                         _d = (_c = JSON).parse;
                         return [4 /*yield*/, readFile(filename, 'utf-8')];
                     case 11: