@promptbook/cli 0.80.0-1 → 0.81.0-5

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

@@ -34,9 +34,6 @@ import { pipelineJsonToString } from '../conversion/pipelineJsonToString';
 import { precompilePipeline } from '../conversion/precompilePipeline';
 import { prettifyPipelineString } from '../conversion/prettify/prettifyPipelineString';
 import { extractParameterNamesFromTask } from '../conversion/utils/extractParameterNamesFromTask';
-import { removePipelineCommand } from '../conversion/utils/removePipelineCommand';
-import { renamePipelineParameter } from '../conversion/utils/renamePipelineParameter';
-import { stringifyPipelineJson } from '../conversion/utils/stringifyPipelineJson';
 import { validatePipeline } from '../conversion/validation/validatePipeline';
 import { CallbackInterfaceTools } from '../dialogs/callback/CallbackInterfaceTools';
 import type { CallbackInterfaceToolsOptions } from '../dialogs/callback/CallbackInterfaceToolsOptions';
@@ -155,9 +152,6 @@ export { pipelineJsonToString };
 export { precompilePipeline };
 export { prettifyPipelineString };
 export { extractParameterNamesFromTask };
-export { removePipelineCommand };
-export { renamePipelineParameter };
-export { stringifyPipelineJson };
 export { validatePipeline };
 export { CallbackInterfaceTools };
 export type { CallbackInterfaceToolsOptions };

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

@@ -0,0 +1,10 @@
+import { BOOK_LANGUAGE_VERSION, PROMPTBOOK_ENGINE_VERSION } from '../version';
+import type { PipelineEditableSerialized } from '../utils/editable/types/PipelineEditableSerialized';
+import { removePipelineCommand } from '../utils/editable/utils/removePipelineCommand';
+import { renamePipelineParameter } from '../utils/editable/utils/renamePipelineParameter';
+import { stringifyPipelineJson } from '../utils/editable/utils/stringifyPipelineJson';
+export { BOOK_LANGUAGE_VERSION, PROMPTBOOK_ENGINE_VERSION };
+export type { PipelineEditableSerialized };
+export { removePipelineCommand };
+export { renamePipelineParameter };
+export { stringifyPipelineJson };

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

@@ -0,0 +1,4 @@
+import { BOOK_LANGUAGE_VERSION, PROMPTBOOK_ENGINE_VERSION } from '../version';
+import { getBookTemplate } from '../utils/getBookTemplate';
+export { BOOK_LANGUAGE_VERSION, PROMPTBOOK_ENGINE_VERSION };
+export { getBookTemplate };

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

@@ -30,6 +30,7 @@ import type { LlmExecutionTools } from '../execution/LlmExecutionTools';
 import type { LlmExecutionToolsConstructor } from '../execution/LlmExecutionToolsConstructor';
 import type { PipelineExecutor } from '../execution/PipelineExecutor';
 import type { PipelineExecutorResult } from '../execution/PipelineExecutorResult';
+import type { PromptbookFetch } from '../execution/PromptbookFetch';
 import type { PromptResult } from '../execution/PromptResult';
 import type { CompletionPromptResult } from '../execution/PromptResult';
 import type { ChatPromptResult } from '../execution/PromptResult';
@@ -241,6 +242,7 @@ import type { number_gigabytes } from '../types/typeAliases';
 import type { number_terabytes } from '../types/typeAliases';
 import type { Registered } from '../utils/$Register';
 import type { Registration } from '../utils/$Register';
+import type { PipelineEditableSerialized } from '../utils/editable/types/PipelineEditableSerialized';
 import type { ExecCommandOptions } from '../utils/execCommand/ExecCommandOptions';
 import type { ExecCommandOptionsAdvanced } from '../utils/execCommand/ExecCommandOptions';
 import type { FromtoItems } from '../utils/FromtoItems';
@@ -292,6 +294,7 @@ export type { LlmExecutionTools };
 export type { LlmExecutionToolsConstructor };
 export type { PipelineExecutor };
 export type { PipelineExecutorResult };
+export type { PromptbookFetch };
 export type { PromptResult };
 export type { CompletionPromptResult };
 export type { ChatPromptResult };
@@ -503,6 +506,7 @@ export type { number_gigabytes };
 export type { number_terabytes };
 export type { Registered };
 export type { Registration };
+export type { PipelineEditableSerialized };
 export type { ExecCommandOptions };
 export type { ExecCommandOptionsAdvanced };
 export type { FromtoItems };

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

@@ -46,7 +46,7 @@ import { searchKeywords } from '../utils/normalization/searchKeywords';
 import { titleToName } from '../utils/normalization/titleToName';
 import { spaceTrim } from '../utils/organization/spaceTrim';
 import { extractParameterNames } from '../utils/parameters/extractParameterNames';
-import { replaceParameters } from '../utils/parameters/replaceParameters';
+import { templateParameters } from '../utils/parameters/templateParameters';
 import { parseNumber } from '../utils/parseNumber';
 import { $randomSeed } from '../utils/random/$randomSeed';
 import { removeEmojis } from '../utils/removeEmojis';
@@ -121,7 +121,7 @@ export { searchKeywords };
 export { titleToName };
 export { spaceTrim };
 export { extractParameterNames };
-export { replaceParameters };
+export { templateParameters };
 export { parseNumber };
 export { $randomSeed };
 export { removeEmojis };

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

@@ -3,6 +3,7 @@ import type { Arrayable } from '../types/Arrayable';
 import type { Executables } from './Executables';
 import type { FilesystemTools } from './FilesystemTools';
 import type { LlmExecutionTools } from './LlmExecutionTools';
+import type { PromptbookFetch } from './PromptbookFetch';
 import type { ScriptExecutionTools } from './ScriptExecutionTools';
 import type { UserInterfaceTools } from './UserInterfaceTools';
 /**
@@ -27,6 +28,12 @@ export type ExecutionTools = {
      * @default undefined - If not provided, no filesystem operations will be possible
      */
     readonly fs?: FilesystemTools;
+    /**
+     * Fetch function for fetching resources
+     *
+     * @default `fetch` - If not provided, the built-in `fetch' function is used with a lightweight error handling wrapper.
+     */
+    readonly fetch?: PromptbookFetch;
     /**
      * Scrapers for extracting knowledge from external sources
      *

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

@@ -0,0 +1,5 @@
+import type { string_url } from '../types/typeAliases';
+/**
+ * Fetch function for fetching data from the internet used in scraping
+ */
+export type PromptbookFetch = (url: string_url, init?: RequestInit) => Promise<Response>;

package/esm/typings/src/execution/PromptbookFetch.test-type.d.ts

@@ -0,0 +1,5 @@
+export {};
+/**
+ * Note: [⚪] This should never be in any released package
+ * TODO: Is this a good pattern to do type testing?
+ */

package/esm/typings/src/expectations/drafts/isDomainNameFree.d.ts

@@ -1,8 +1,9 @@
+import type { PromptbookFetch } from '../../execution/PromptbookFetch';
 import type { string_name } from '../../types/typeAliases';
 /**
  * @private still in development
  */
-export declare function isDomainNameFree(name: string_name): Promise<boolean>;
+export declare function isDomainNameFree(name: string_name, fetch: PromptbookFetch): Promise<boolean>;
 /**
  * TODO: [🍓][🧠] Test and implement `isDomainNameFree`
  * TODO: Export via some (and probably new) NPM package

package/esm/typings/src/expectations/drafts/isGithubNameFree.d.ts

@@ -1,8 +1,9 @@
+import type { PromptbookFetch } from '../../execution/PromptbookFetch';
 import type { string_name } from '../../types/typeAliases';
 /**
  * @private still in development
  */
-export declare function isGithubNameFree(name: string_name): Promise<boolean>;
+export declare function isGithubNameFree(name: string_name, fetch: PromptbookFetch): Promise<boolean>;
 /**
  * TODO: [🍓][🧠] Test and implement `isGithubNameFree`
  * TODO: Export via some (and probably new) NPM package

package/esm/typings/src/scrapers/_common/utils/makeKnowledgeSourceHandler.d.ts

@@ -8,4 +8,4 @@ import type { ScraperSourceHandler } from '../Scraper';
  *
  * @public exported from `@promptbook/core`
  */
-export declare function makeKnowledgeSourceHandler(knowledgeSource: SetOptional<KnowledgeSourceJson, 'name'>, tools: Pick<ExecutionTools, 'fs'>, options?: Pick<PrepareAndScrapeOptions, 'rootDirname' | 'isVerbose'>): Promise<ScraperSourceHandler>;
+export declare function makeKnowledgeSourceHandler(knowledgeSource: SetOptional<KnowledgeSourceJson, 'name'>, tools: Pick<ExecutionTools, 'fs' | 'fetch'>, options?: Pick<PrepareAndScrapeOptions, 'rootDirname' | 'isVerbose'>): Promise<ScraperSourceHandler>;

package/esm/typings/src/scrapers/_common/utils/scraperFetch.d.ts

@@ -0,0 +1,7 @@
+import type { PromptbookFetch } from '../../../execution/PromptbookFetch';
+/**
+ * The built-in `fetch' function with a lightweight error handling wrapper as default fetch function used in Promptbook scrapers
+ *
+ * @private as default `fetch` function used in Promptbook scrapers
+ */
+export declare const scraperFetch: PromptbookFetch;

package/esm/typings/src/utils/editable/types/PipelineEditableSerialized.d.ts

@@ -0,0 +1,42 @@
+import type { ErrorJson } from '../../../errors/utils/ErrorJson';
+import type { PipelineJson } from '../../../pipeline/PipelineJson/PipelineJson';
+import type { string_date_iso8601 } from '../../../types/typeAliases';
+import type { string_pipeline_url } from '../../../types/typeAliases';
+import type { PipelineString } from '../../../pipeline/PipelineString';
+/**
+ * Represents a single pipeline in PromptbookStudio
+ *
+ * This is simple extension of PipelineJson with additional metadata
+ * Note: There are two similar entities:
+ *       1) Type (interface) `PipelineEditableSerialized` which represents just data in database
+ *       2) Class `PipelineEditable` which implements `PipelineEditableSerialized` and adds error handling and editing capabilities
+ *
+ * @public exported from `@promptbook/editable`
+ */
+export type PipelineEditableSerialized = PipelineJson & {
+    /**
+     * When was the pipeline created
+     */
+    readonly createdAt: string_date_iso8601;
+    /**
+     * When was the pipeline last modified
+     */
+    readonly updatedAt: string_date_iso8601 | null;
+    /**
+     * Unique identifier of the pipeline
+     *
+     * Note: In PromptbookStudio it is required
+     */
+    readonly pipelineUrl: string_pipeline_url;
+    /**
+     * Backup of the pipeline string
+     *
+     * Note: This is present ONLY if pipelineString can not be automatically converted into json (i.e. compilePipeline throws an error)
+     *       In other words, this is just a BACKUP of pipeline which will be deleted whener pipeline is valid again
+     */
+    readonly pipelineString: PipelineString | string | null;
+    /**
+     * Known errors to transfer to new PipelineEditable
+     */
+    readonly knownErrors: Array<ErrorJson>;
+};

package/esm/typings/src/{conversion → utils/editable}/utils/removePipelineCommand.d.ts

@@ -1,5 +1,5 @@
-import type { CommandType } from '../../commands/_common/types/CommandType';
-import type { PipelineString } from '../../pipeline/PipelineString';
+import type { CommandType } from '../../../commands/_common/types/CommandType';
+import type { PipelineString } from '../../../pipeline/PipelineString';
 /**
  * Options for `removePipelineCommand`
  */
@@ -16,7 +16,7 @@ type RemovePipelineCommandOptions = {
 /**
  * Function `removePipelineCommand` will remove one command from pipeline string
  *
- * @public exported from `@promptbook/core` <- Note: [👖] This utility is so tightly interconnected with the Promptbook that it is not exported as util but in core
+ * @public exported from `@promptbook/editable`
  */
 export declare function removePipelineCommand(options: RemovePipelineCommandOptions): PipelineString;
 export {};

package/esm/typings/src/{conversion → utils/editable}/utils/renamePipelineParameter.d.ts

@@ -1,5 +1,5 @@
-import type { PipelineJson } from '../../pipeline/PipelineJson/PipelineJson';
-import type { string_name } from '../../types/typeAliases';
+import type { PipelineJson } from '../../../pipeline/PipelineJson/PipelineJson';
+import type { string_name } from '../../../types/typeAliases';
 type RenameParameterOptions = {
     /**
      * Pipeline to search and replace for parameters
@@ -20,7 +20,7 @@ type RenameParameterOptions = {
  * 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/core` <- Note: [👖] This utility is so tightly interconnected with the Promptbook that it is not exported as util but in core
+ * @public exported from `@promptbook/editable`
  */
 export declare function renamePipelineParameter(options: RenameParameterOptions): PipelineJson;
 export {};

package/esm/typings/src/{conversion → utils/editable}/utils/stringifyPipelineJson.d.ts

@@ -1,11 +1,11 @@
-import type { string_json } from '../../types/typeAliases';
+import type { string_json } from '../../../types/typeAliases';
 /**
  * Stringify the PipelineJson with proper formatting
  *
  * Note: [0] It can be used for more JSON types like whole collection of pipelines, single knowledge piece, etc.
  * Note: In contrast to JSON.stringify, this function ensures that **embedding index** is on single line
  *
- * @public exported from `@promptbook/core`
+ * @public exported from `@promptbook/editable`
  */
 export declare function stringifyPipelineJson<TType>(pipeline: TType): string_json<TType>;
 /**

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

@@ -0,0 +1,12 @@
+import type { PipelineJson } from '../pipeline/PipelineJson/PipelineJson';
+import type { string_formfactor_name } from '../formfactors/_common/string_formfactor_name';
+/**
+ * Get template for new book
+ *
+ * @public exported from `@promptbook/templates`
+ */
+export declare function getBookTemplate(formfactorName: string_formfactor_name): PipelineJson | null;
+/**
+ * TODO: [🧠] Which is the best place for this function
+ * TODO: `book string template notation
+ */

package/esm/typings/src/utils/parameters/{replaceParameters.d.ts → templateParameters.d.ts}

@@ -9,4 +9,4 @@ import type { string_template } from '../../types/typeAliases';
  * @throws {PipelineExecutionError} if parameter is not defined, not closed, or not opened
  * @public exported from `@promptbook/utils`
  */
-export declare function replaceParameters(template: string_template, parameters: Parameters): string;
+export declare function templateParameters(template: string_template, parameters: Parameters): string;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@promptbook/cli",
-    "version": "0.80.0-1",
+    "version": "0.81.0-5",
     "description": "It's time for a paradigm shift. The future of software in plain English, French or Latin",
     "--note-0": "    <- [🐊]",
     "private": false,

package/umd/index.umd.js

@@ -49,7 +49,7 @@
      *
      * @see https://github.com/webgptorg/promptbook
      */
-    var PROMPTBOOK_ENGINE_VERSION = '0.80.0-0';
+    var PROMPTBOOK_ENGINE_VERSION = '0.81.0-4';
     /**
      * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
      * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -500,6 +500,40 @@
      * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
      */
 
+    /**
+     * Make error report URL for the given error
+     *
+     * @private !!!!!!
+     */
+    function getErrorReportUrl(error) {
+        var report = {
+            title: "\uD83D\uDC1C Error report from ".concat(NAME),
+            body: spaceTrim__default["default"](function (block) { return "\n\n\n            `".concat(error.name || 'Error', "` has occurred in the [").concat(NAME, "], please look into it @").concat(ADMIN_GITHUB_NAME, ".\n\n            ```\n            ").concat(block(error.message || '(no error message)'), "\n            ```\n\n\n            ## More info:\n\n            - **Promptbook engine version:** ").concat(PROMPTBOOK_ENGINE_VERSION, "\n            - **Book language version:** ").concat(BOOK_LANGUAGE_VERSION, "\n            - **Time:** ").concat(new Date().toISOString(), "\n\n            <details>\n            <summary>Stack trace:</summary>\n\n            ## Stack trace:\n\n            ```stacktrace\n            ").concat(block(error.stack || '(empty)'), "\n            ```\n            </details>\n\n        "); }),
+        };
+        var reportUrl = new URL("https://github.com/webgptorg/promptbook/issues/new");
+        reportUrl.searchParams.set('labels', 'bug');
+        reportUrl.searchParams.set('assignees', ADMIN_GITHUB_NAME);
+        reportUrl.searchParams.set('title', report.title);
+        reportUrl.searchParams.set('body', report.body);
+        return reportUrl;
+    }
+
+    /**
+     * This error type indicates that the error should not happen and its last check before crashing with some other error
+     *
+     * @public exported from `@promptbook/core`
+     */
+    var UnexpectedError = /** @class */ (function (_super) {
+        __extends(UnexpectedError, _super);
+        function UnexpectedError(message) {
+            var _this = _super.call(this, spaceTrim.spaceTrim(function (block) { return "\n                    ".concat(block(message), "\n\n                    Note: This error should not happen.\n                    It's probbably a bug in the pipeline collection\n\n                    Please report issue:\n                    ").concat(block(getErrorReportUrl(new Error(message)).href), "\n\n                    Or contact us on ").concat(ADMIN_EMAIL, "\n\n                "); })) || this;
+            _this.name = 'UnexpectedError';
+            Object.setPrototypeOf(_this, UnexpectedError.prototype);
+            return _this;
+        }
+        return UnexpectedError;
+    }(Error));
+
     /**
      * Orders JSON object by keys
      *
@@ -550,40 +584,6 @@
      * TODO: [🧠] Is there a way how to meaningfully test this utility
      */
 
-    /**
-     * Make error report URL for the given error
-     *
-     * @private !!!!!!
-     */
-    function getErrorReportUrl(error) {
-        var report = {
-            title: "\uD83D\uDC1C Error report from ".concat(NAME),
-            body: spaceTrim__default["default"](function (block) { return "\n\n\n            `".concat(error.name || 'Error', "` has occurred in the [").concat(NAME, "], please look into it @").concat(ADMIN_GITHUB_NAME, ".\n\n            ```\n            ").concat(block(error.message || '(no error message)'), "\n            ```\n\n\n            ## More info:\n\n            - **Promptbook engine version:** ").concat(PROMPTBOOK_ENGINE_VERSION, "\n            - **Book language version:** ").concat(BOOK_LANGUAGE_VERSION, "\n            - **Time:** ").concat(new Date().toISOString(), "\n\n            <details>\n            <summary>Stack trace:</summary>\n\n            ## Stack trace:\n\n            ```stacktrace\n            ").concat(block(error.stack || '(empty)'), "\n            ```\n            </details>\n\n        "); }),
-        };
-        var reportUrl = new URL("https://github.com/webgptorg/promptbook/issues/new");
-        reportUrl.searchParams.set('labels', 'bug');
-        reportUrl.searchParams.set('assignees', ADMIN_GITHUB_NAME);
-        reportUrl.searchParams.set('title', report.title);
-        reportUrl.searchParams.set('body', report.body);
-        return reportUrl;
-    }
-
-    /**
-     * This error type indicates that the error should not happen and its last check before crashing with some other error
-     *
-     * @public exported from `@promptbook/core`
-     */
-    var UnexpectedError = /** @class */ (function (_super) {
-        __extends(UnexpectedError, _super);
-        function UnexpectedError(message) {
-            var _this = _super.call(this, spaceTrim.spaceTrim(function (block) { return "\n                    ".concat(block(message), "\n\n                    Note: This error should not happen.\n                    It's probbably a bug in the pipeline collection\n\n                    Please report issue:\n                    ").concat(block(getErrorReportUrl(new Error(message)).href), "\n\n                    Or contact us on ").concat(ADMIN_EMAIL, "\n\n                "); })) || this;
-            _this.name = 'UnexpectedError';
-            Object.setPrototypeOf(_this, UnexpectedError.prototype);
-            return _this;
-        }
-        return UnexpectedError;
-    }(Error));
-
     /**
      * Checks if the value is [🚉] serializable as JSON
      * If not, throws an UnexpectedError with a rich error message and tracking
@@ -866,7 +866,7 @@
      * Note: [0] It can be used for more JSON types like whole collection of pipelines, single knowledge piece, etc.
      * Note: In contrast to JSON.stringify, this function ensures that **embedding index** is on single line
      *
-     * @public exported from `@promptbook/core`
+     * @public exported from `@promptbook/editable`
      */
     function stringifyPipelineJson(pipeline) {
         if (!isSerializableAsJson(pipeline)) {
@@ -4602,7 +4602,7 @@
      * @throws {PipelineExecutionError} if parameter is not defined, not closed, or not opened
      * @public exported from `@promptbook/utils`
      */
-    function replaceParameters(template, parameters) {
+    function templateParameters(template, parameters) {
         var e_1, _a;
         try {
             for (var _b = __values(Object.entries(parameters)), _c = _b.next(); !_c.done; _c = _b.next()) {
@@ -4628,7 +4628,7 @@
         var loopLimit = LOOP_LIMIT;
         var _loop_1 = function () {
             if (loopLimit-- < 0) {
-                throw new LimitReachedError('Loop limit reached during parameters replacement in `replaceParameters`');
+                throw new LimitReachedError('Loop limit reached during parameters replacement in `templateParameters`');
             }
             var precol = match.groups.precol;
             var parameterName = match.groups.parameterName;
@@ -4880,7 +4880,7 @@
                                         }
                                         return [3 /*break*/, 24];
                                     case 2:
-                                        $ongoingTaskResult.$resultString = replaceParameters(preparedContent, parameters);
+                                        $ongoingTaskResult.$resultString = templateParameters(preparedContent, parameters);
                                         return [3 /*break*/, 25];
                                     case 3:
                                         modelRequirements = __assign(__assign({ modelVariant: 'CHAT' }, (preparedPipeline.defaultModelRequirements || {})), (task.modelRequirements || {}));
@@ -5003,8 +5003,8 @@
                                         _j = $ongoingTaskResult;
                                         return [4 /*yield*/, tools.userInterface.promptDialog($deepFreeze({
                                                 promptTitle: task.title,
-                                                promptMessage: replaceParameters(task.description || '', parameters),
-                                                defaultValue: replaceParameters(preparedContent, parameters),
+                                                promptMessage: templateParameters(task.description || '', parameters),
+                                                defaultValue: templateParameters(preparedContent, parameters),
                                                 // TODO: [🧠] !! Figure out how to define placeholder in .book.md file
                                                 placeholder: undefined,
                                                 priority: priority,
@@ -5128,7 +5128,7 @@
                                         if (!isJokerAttempt &&
                                             task.taskType === 'PROMPT_TASK' &&
                                             $ongoingTaskResult.$prompt
-                                        //    <- Note:  [2] When some expected parameter is not defined, error will occur in replaceParameters
+                                        //    <- Note:  [2] When some expected parameter is not defined, error will occur in templateParameters
                                         //              In that case we don’t want to make a report about it because it’s not a llm execution error
                                         ) {
                                             // TODO: [🧠] Maybe put other taskTypes into report
@@ -6192,6 +6192,30 @@
         return match ? match[1].toLowerCase() : null;
     }
 
+    /**
+     * The built-in `fetch' function with a lightweight error handling wrapper as default fetch function used in Promptbook scrapers
+     *
+     * @private as default `fetch` function used in Promptbook scrapers
+     */
+    var scraperFetch = function (url, init) { return __awaiter(void 0, void 0, void 0, function () {
+        var error_1;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    _a.trys.push([0, 2, , 3]);
+                    return [4 /*yield*/, fetch(url, init)];
+                case 1: return [2 /*return*/, _a.sent()];
+                case 2:
+                    error_1 = _a.sent();
+                    if (!(error_1 instanceof Error)) {
+                        throw error_1;
+                    }
+                    throw new KnowledgeScrapeError(spaceTrim__default["default"](function (block) { return "\n                    Can not fetch \"".concat(url, "\"\n\n                    Fetch error:\n                    ").concat(block(error_1.message), "\n\n                "); }));
+                case 3: return [2 /*return*/];
+            }
+        });
+    }); };
+
     /**
      * @@@
      *
@@ -6200,13 +6224,14 @@
     function makeKnowledgeSourceHandler(knowledgeSource, tools, options) {
         var _a;
         return __awaiter(this, void 0, void 0, function () {
-            var sourceContent, name, _b, _c, rootDirname, url, response_1, mimeType, filename_1, fileExtension, mimeType;
-            return __generator(this, function (_e) {
-                switch (_e.label) {
+            var _b, fetch, sourceContent, name, _c, _d, rootDirname, url, response_1, mimeType, filename_1, fileExtension, mimeType;
+            return __generator(this, function (_f) {
+                switch (_f.label) {
                     case 0:
+                        _b = tools.fetch, fetch = _b === void 0 ? scraperFetch : _b;
                         sourceContent = knowledgeSource.sourceContent;
                         name = knowledgeSource.name;
-                        _b = options || {}, _c = _b.rootDirname, rootDirname = _c === void 0 ? null : _c, _b.isVerbose;
+                        _c = options || {}, _d = _c.rootDirname, rootDirname = _d === void 0 ? null : _d, _c.isVerbose;
                         if (!name) {
                             name = sourceContentToName(sourceContent);
                         }
@@ -6214,7 +6239,7 @@
                         url = sourceContent;
                         return [4 /*yield*/, fetch(url)];
                     case 1:
-                        response_1 = _e.sent();
+                        response_1 = _f.sent();
                         mimeType = ((_a = response_1.headers.get('content-type')) === null || _a === void 0 ? void 0 : _a.split(';')[0]) || 'text/html';
                         return [2 /*return*/, {
                                 source: name,
@@ -6271,7 +6296,7 @@
                         mimeType = extensionToMimeType(fileExtension || '');
                         return [4 /*yield*/, isFileExisting(filename_1, tools.fs)];
                     case 3:
-                        if (!(_e.sent())) {
+                        if (!(_f.sent())) {
                             throw new NotFoundError(spaceTrim__default["default"](function (block) { return "\n                          Can not make source handler for file which does not exist:\n\n                          File:\n                          ".concat(block(filename_1), "\n                      "); }));
                         }
                         // TODO: [🧠][😿] Test security file - file is scoped to the project (BUT maybe do this in `filesystemTools`)
@@ -13198,7 +13223,7 @@
                                 throw new PipelineExecutionError('Use callChatModel only for CHAT variant');
                             }
                             modelName = modelRequirements.modelName || this.getDefaultChatModel().modelName;
-                            rawPromptContent = replaceParameters(content, __assign(__assign({}, parameters), { modelName: modelName }));
+                            rawPromptContent = templateParameters(content, __assign(__assign({}, parameters), { modelName: modelName }));
                             rawRequest = {
                                 model: modelRequirements.modelName || this.getDefaultChatModel().modelName,
                                 max_tokens: modelRequirements.maxTokens || 4096,
@@ -14004,7 +14029,7 @@
                                 // <- TODO: [🈁] Use `seed` here AND/OR use is `isDeterministic` for entire execution tools
                                 // <- Note: [🧆]
                             };
-                            rawPromptContent = replaceParameters(content, __assign(__assign({}, parameters), { modelName: modelName }));
+                            rawPromptContent = templateParameters(content, __assign(__assign({}, parameters), { modelName: modelName }));
                             messages = __spreadArray(__spreadArray([], __read((modelRequirements.systemMessage === undefined
                                 ? []
                                 : [
@@ -14119,7 +14144,7 @@
                                 console.info(colors__default["default"].bgWhite('content'), JSON.stringify(content, null, 4));
                                 console.info(colors__default["default"].bgWhite('parameters'), JSON.stringify(parameters, null, 4));
                             }
-                            rawPromptContent = replaceParameters(content, __assign(__assign({}, parameters), { modelName: modelName }));
+                            rawPromptContent = templateParameters(content, __assign(__assign({}, parameters), { modelName: modelName }));
                             rawRequest = [
                                 modelName,
                                 [rawPromptContent],
@@ -14387,7 +14412,7 @@
                                 return [4 /*yield*/, vercelProvider.chat(modelName, __assign({ user: (userId === null || userId === void 0 ? void 0 : userId.toString()) || undefined }, additionalChatSettings))];
                             case 1:
                                 model = _b.sent();
-                                rawPromptContent = replaceParameters(content, __assign(__assign({}, parameters), { modelName: modelName }));
+                                rawPromptContent = templateParameters(content, __assign(__assign({}, parameters), { modelName: modelName }));
                                 rawRequest = {
                                     // <- TODO: [☂]
                                     inputFormat: 'messages',
@@ -14784,7 +14809,7 @@
                                     type: 'json_object',
                                 };
                             }
-                            rawPromptContent = replaceParameters(content, __assign(__assign({}, parameters), { modelName: modelName }));
+                            rawPromptContent = templateParameters(content, __assign(__assign({}, parameters), { modelName: modelName }));
                             rawRequest = __assign(__assign({}, modelSettings), { messages: __spreadArray(__spreadArray([], __read((modelRequirements.systemMessage === undefined
                                     ? []
                                     : [
@@ -14880,7 +14905,7 @@
                                 // <- TODO: [🈁] Use `seed` here AND/OR use is `isDeterministic` for entire execution tools
                                 // <- Note: [🧆]
                             };
-                            rawPromptContent = replaceParameters(content, __assign(__assign({}, parameters), { modelName: modelName }));
+                            rawPromptContent = templateParameters(content, __assign(__assign({}, parameters), { modelName: modelName }));
                             rawRequest = __assign(__assign({}, modelSettings), { prompt: rawPromptContent, user: (_a = this.options.userId) === null || _a === void 0 ? void 0 : _a.toString() });
                             start = $getCurrentDate();
                             if (this.options.isVerbose) {
@@ -14952,7 +14977,7 @@
                                 throw new PipelineExecutionError('Use embed only for EMBEDDING variant');
                             }
                             modelName = modelRequirements.modelName || this.getDefaultEmbeddingModel().modelName;
-                            rawPromptContent = replaceParameters(content, __assign(__assign({}, parameters), { modelName: modelName }));
+                            rawPromptContent = templateParameters(content, __assign(__assign({}, parameters), { modelName: modelName }));
                             rawRequest = {
                                 input: rawPromptContent,
                                 model: modelName,
@@ -15122,7 +15147,7 @@
                                 }
                                 finally { if (e_1) throw e_1.error; }
                             }
-                            rawPromptContent = replaceParameters(content, __assign(__assign({}, parameters), { modelName: 'assistant' }));
+                            rawPromptContent = templateParameters(content, __assign(__assign({}, parameters), { modelName: 'assistant' }));
                             rawRequest = {
                                 // TODO: [👨‍👨‍👧‍👧] ...modelSettings,
                                 // TODO: [👨‍👨‍👧‍👧][🧠] What about system message for assistants, does it make sence - combination of OpenAI assistants with Promptbook Personas