@promptbook/remote-server 0.72.0-0 → 0.72.0-10

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

@@ -7,16 +7,20 @@ import type { PipelineTemplateCommandParser } from '../commands/_common/types/Co
 import type { CommandParserInput } from '../commands/_common/types/CommandParser';
 import type { CommandUsagePlace } from '../commands/_common/types/CommandUsagePlaces';
 import type { ExpectCommand } from '../commands/EXPECT/ExpectCommand';
+import type { ForeachJson } from '../commands/FOREACH/ForeachJson';
 import type { FormatCommand } from '../commands/FORMAT/FormatCommand';
 import type { TemplateType } from '../commands/TEMPLATE/TemplateTypes';
-import type { PipelineStringToJsonOptions } from '../conversion/pipelineStringToJson';
 import type { PrettifyOptions } from '../conversion/prettify/PrettifyOptions';
 import type { renderPipelineMermaidOptions } from '../conversion/prettify/renderPipelineMermaidOptions';
+import type { CallbackInterfaceToolsOptions } from '../dialogs/callback/CallbackInterfaceToolsOptions';
 import type { ErrorJson } from '../errors/utils/ErrorJson';
 import type { AvailableModel } from '../execution/AvailableModel';
-import type { CommonExecutionToolsOptions } from '../execution/CommonExecutionToolsOptions';
+import type { CommonToolsOptions } from '../execution/CommonToolsOptions';
+import type { CreatePipelineExecutorOptions } from '../execution/createPipelineExecutor/00-CreatePipelineExecutorOptions';
+import type { CreatePipelineExecutorSettings } from '../execution/createPipelineExecutor/00-CreatePipelineExecutorSettings';
 import type { EmbeddingVector } from '../execution/EmbeddingVector';
 import type { ExecutionTools } from '../execution/ExecutionTools';
+import type { FilesystemTools } from '../execution/FilesystemTools';
 import type { LlmExecutionTools } from '../execution/LlmExecutionTools';
 import type { LlmExecutionToolsConstructor } from '../execution/LlmExecutionToolsConstructor';
 import type { PipelineExecutor } from '../execution/PipelineExecutor';
@@ -32,10 +36,11 @@ import type { ScriptExecutionToolsExecuteOptions } from '../execution/ScriptExec
 import type { UncertainNumber } from '../execution/UncertainNumber';
 import type { UserInterfaceTools } from '../execution/UserInterfaceTools';
 import type { UserInterfaceToolsPromptDialogOptions } from '../execution/UserInterfaceTools';
-import type { CallbackInterfaceToolsOptions } from '../knowledge/dialogs/callback/CallbackInterfaceToolsOptions';
-import type { LlmToolsConfiguration } from '../llm-providers/_common/LlmToolsConfiguration';
-import type { LlmToolsMetadata } from '../llm-providers/_common/LlmToolsMetadata';
-import type { LlmToolsOptions } from '../llm-providers/_common/LlmToolsOptions';
+import type { FormatSubvalueDefinition } from '../formats/_common/FormatSubvalueDefinition';
+import type { CsvSettings } from '../formats/csv/CsvSettings';
+import type { LlmToolsConfiguration } from '../llm-providers/_common/register/LlmToolsConfiguration';
+import type { LlmToolsMetadata } from '../llm-providers/_common/register/LlmToolsMetadata';
+import type { LlmToolsOptions } from '../llm-providers/_common/register/LlmToolsOptions';
 import type { CacheItem } from '../llm-providers/_common/utils/cache/CacheItem';
 import type { CacheLlmToolsOptions } from '../llm-providers/_common/utils/cache/CacheLlmToolsOptions';
 import type { LlmExecutionToolsWithTotalUsage } from '../llm-providers/_common/utils/count-total-usage/LlmExecutionToolsWithTotalUsage';
@@ -61,11 +66,18 @@ import type { RemoteLlmExecutionToolsOptions } from '../llm-providers/remote/int
 import type { RemoteServerOptions } from '../llm-providers/remote/interfaces/RemoteServerOptions';
 import type { AnonymousRemoteServerOptions } from '../llm-providers/remote/interfaces/RemoteServerOptions';
 import type { CollectionRemoteServerOptions } from '../llm-providers/remote/interfaces/RemoteServerOptions';
-import type { PrepareOptions } from '../prepare/PrepareOptions';
+import type { CollectionRemoteServerClientOptions } from '../llm-providers/remote/interfaces/RemoteServerOptions';
+import type { PrepareAndScrapeOptions } from '../prepare/PrepareAndScrapeOptions';
+import type { Converter } from '../scrapers/_common/Converter';
+import type { ScraperAndConverterMetadata } from '../scrapers/_common/register/ScraperAndConverterMetadata';
+import type { ScraperConstructor } from '../scrapers/_common/register/ScraperConstructor';
+import type { Scraper } from '../scrapers/_common/Scraper';
+import type { ScraperSourceHandler } from '../scrapers/_common/Scraper';
+import type { ScraperIntermediateSource } from '../scrapers/_common/ScraperIntermediateSource';
 import type { JavascriptExecutionToolsOptions } from '../scripting/javascript/JavascriptExecutionToolsOptions';
 import type { PostprocessingFunction } from '../scripting/javascript/JavascriptExecutionToolsOptions';
 import type { PromptbookStorage } from '../storage/_common/PromptbookStorage';
-import type { FilesStorageOptions } from '../storage/files-storage/FilesStorageOptions';
+import type { FileCacheStorageOptions } from '../storage/file-cache-storage/FileCacheStorageOptions';
 import type { ExecutionPromptReportJson } from '../types/execution-report/ExecutionPromptReportJson';
 import type { ExecutionReportJson } from '../types/execution-report/ExecutionReportJson';
 import type { ExecutionReportString } from '../types/execution-report/ExecutionReportString';
@@ -148,27 +160,27 @@ import type { string_data_url } from '../types/typeAliases';
 import type { string_base64 } from '../types/typeAliases';
 import type { string_href } from '../types/typeAliases';
 import type { string_url_image } from '../types/typeAliases';
+import type { string_executable_path } from '../types/typeAliases';
 import type { string_uri } from '../types/typeAliases';
 import type { string_uri_part } from '../types/typeAliases';
-import type { string_uriid } from '../types/typeAliases';
 import type { string_hostname } from '../types/typeAliases';
 import type { string_host } from '../types/typeAliases';
 import type { string_protocol } from '../types/typeAliases';
 import type { string_email } from '../types/typeAliases';
 import type { string_emails } from '../types/typeAliases';
 import type { string_uuid } from '../types/typeAliases';
+import type { string_app_id } from '../types/typeAliases';
 import type { string_user_id } from '../types/typeAliases';
 import type { string_sha256 } from '../types/typeAliases';
 import type { string_semantic_version } from '../types/typeAliases';
 import type { string_version_dependency } from '../types/typeAliases';
 import type { string_file_extension } from '../types/typeAliases';
-import type { string_file_absolute_path } from '../types/typeAliases';
-import type { string_file_relative_path } from '../types/typeAliases';
-import type { string_file_path } from '../types/typeAliases';
-import type { string_folder_absolute_path } from '../types/typeAliases';
-import type { string_folder_relative_path } from '../types/typeAliases';
-import type { string_folder_path } from '../types/typeAliases';
+import type { string_absolute_filename } from '../types/typeAliases';
+import type { string_relative_filename } from '../types/typeAliases';
 import type { string_filename } from '../types/typeAliases';
+import type { string_absolute_dirname } from '../types/typeAliases';
+import type { string_relative_dirname } from '../types/typeAliases';
+import type { string_dirname } from '../types/typeAliases';
 import type { string_person_fullname } from '../types/typeAliases';
 import type { string_person_profile } from '../types/typeAliases';
 import type { string_license } from '../types/typeAliases';
@@ -180,6 +192,7 @@ import type { string_translate_name_not_normalized } from '../types/typeAliases'
 import type { string_translate_language } from '../types/typeAliases';
 import type { string_javascript_name } from '../types/typeAliases';
 import type { string_postprocessing_function_name } from '../types/typeAliases';
+import type { id } from '../types/typeAliases';
 import type { string_token } from '../types/typeAliases';
 import type { string_license_token } from '../types/typeAliases';
 import type { string_password } from '../types/typeAliases';
@@ -211,6 +224,9 @@ import type { number_megabytes } from '../types/typeAliases';
 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 { IExecCommandOptions } from '../utils/execCommand/IExecCommandOptions';
+import type { IExecCommandOptionsAdvanced } from '../utils/execCommand/IExecCommandOptions';
 import type { FromtoItems } from '../utils/FromtoItems';
 import type { CodeBlock } from '../utils/markdown/extractAllBlocksFromMarkdown';
 import type { MarkdownSection } from '../utils/markdown/parseMarkdownSection';
@@ -221,6 +237,7 @@ import type { string_camelCase } from '../utils/normalization/normalizeTo_camelC
 import type { string_PascalCase } from '../utils/normalization/normalizeTo_PascalCase';
 import type { string_SCREAMING_CASE } from '../utils/normalization/normalizeTo_SCREAMING_CASE';
 import type { string_snake_case } from '../utils/normalization/normalizeTo_snake_case';
+import type { empty_object } from '../utils/organization/empty_object';
 import type { really_any } from '../utils/organization/really_any';
 import type { TODO_any } from '../utils/organization/TODO_any';
 import type { string_promptbook_version } from '../version';
@@ -233,16 +250,20 @@ export type { PipelineTemplateCommandParser };
 export type { CommandParserInput };
 export type { CommandUsagePlace };
 export type { ExpectCommand };
+export type { ForeachJson };
 export type { FormatCommand };
 export type { TemplateType };
-export type { PipelineStringToJsonOptions };
 export type { PrettifyOptions };
 export type { renderPipelineMermaidOptions };
+export type { CallbackInterfaceToolsOptions };
 export type { ErrorJson };
 export type { AvailableModel };
-export type { CommonExecutionToolsOptions };
+export type { CommonToolsOptions };
+export type { CreatePipelineExecutorOptions };
+export type { CreatePipelineExecutorSettings };
 export type { EmbeddingVector };
 export type { ExecutionTools };
+export type { FilesystemTools };
 export type { LlmExecutionTools };
 export type { LlmExecutionToolsConstructor };
 export type { PipelineExecutor };
@@ -258,7 +279,8 @@ export type { ScriptExecutionToolsExecuteOptions };
 export type { UncertainNumber };
 export type { UserInterfaceTools };
 export type { UserInterfaceToolsPromptDialogOptions };
-export type { CallbackInterfaceToolsOptions };
+export type { FormatSubvalueDefinition };
+export type { CsvSettings };
 export type { LlmToolsConfiguration };
 export type { LlmToolsMetadata };
 export type { LlmToolsOptions };
@@ -287,11 +309,18 @@ export type { RemoteLlmExecutionToolsOptions };
 export type { RemoteServerOptions };
 export type { AnonymousRemoteServerOptions };
 export type { CollectionRemoteServerOptions };
-export type { PrepareOptions };
+export type { CollectionRemoteServerClientOptions };
+export type { PrepareAndScrapeOptions };
+export type { Converter };
+export type { ScraperAndConverterMetadata };
+export type { ScraperConstructor };
+export type { Scraper };
+export type { ScraperSourceHandler };
+export type { ScraperIntermediateSource };
 export type { JavascriptExecutionToolsOptions };
 export type { PostprocessingFunction };
 export type { PromptbookStorage };
-export type { FilesStorageOptions };
+export type { FileCacheStorageOptions };
 export type { ExecutionPromptReportJson };
 export type { ExecutionReportJson };
 export type { ExecutionReportString };
@@ -374,27 +403,27 @@ export type { string_data_url };
 export type { string_base64 };
 export type { string_href };
 export type { string_url_image };
+export type { string_executable_path };
 export type { string_uri };
 export type { string_uri_part };
-export type { string_uriid };
 export type { string_hostname };
 export type { string_host };
 export type { string_protocol };
 export type { string_email };
 export type { string_emails };
 export type { string_uuid };
+export type { string_app_id };
 export type { string_user_id };
 export type { string_sha256 };
 export type { string_semantic_version };
 export type { string_version_dependency };
 export type { string_file_extension };
-export type { string_file_absolute_path };
-export type { string_file_relative_path };
-export type { string_file_path };
-export type { string_folder_absolute_path };
-export type { string_folder_relative_path };
-export type { string_folder_path };
+export type { string_absolute_filename };
+export type { string_relative_filename };
 export type { string_filename };
+export type { string_absolute_dirname };
+export type { string_relative_dirname };
+export type { string_dirname };
 export type { string_person_fullname };
 export type { string_person_profile };
 export type { string_license };
@@ -406,6 +435,7 @@ export type { string_translate_name_not_normalized };
 export type { string_translate_language };
 export type { string_javascript_name };
 export type { string_postprocessing_function_name };
+export type { id };
 export type { string_token };
 export type { string_license_token };
 export type { string_password };
@@ -437,6 +467,9 @@ export type { number_megabytes };
 export type { number_gigabytes };
 export type { number_terabytes };
 export type { Registered };
+export type { Registration };
+export type { IExecCommandOptions };
+export type { IExecCommandOptionsAdvanced };
 export type { FromtoItems };
 export type { CodeBlock };
 export type { MarkdownSection };
@@ -447,6 +480,7 @@ export type { string_camelCase };
 export type { string_PascalCase };
 export type { string_SCREAMING_CASE };
 export type { string_snake_case };
+export type { empty_object };
 export type { really_any };
 export type { TODO_any };
 export type { string_promptbook_version };

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

@@ -20,7 +20,6 @@ import { splitIntoSentences } from '../utils/expectation-counters/countSentences
 import { countSentences } from '../utils/expectation-counters/countSentences';
 import { countWords } from '../utils/expectation-counters/countWords';
 import { CountUtils } from '../utils/expectation-counters/index';
-import { extractParameterNames } from '../utils/extractParameterNames';
 import { capitalize } from '../utils/normalization/capitalize';
 import { decapitalize } from '../utils/normalization/decapitalize';
 import { DIACRITIC_VARIANTS_LETTERS } from '../utils/normalization/DIACRITIC_VARIANTS_LETTERS';
@@ -43,11 +42,12 @@ import { parseKeywords } from '../utils/normalization/parseKeywords';
 import { parseKeywordsFromString } from '../utils/normalization/parseKeywordsFromString';
 import { removeDiacritics } from '../utils/normalization/removeDiacritics';
 import { searchKeywords } from '../utils/normalization/searchKeywords';
+import { extractParameterNames } from '../utils/parameters/extractParameterNames';
+import { replaceParameters } from '../utils/parameters/replaceParameters';
 import { parseNumber } from '../utils/parseNumber';
 import { $randomSeed } from '../utils/random/$randomSeed';
 import { removeEmojis } from '../utils/removeEmojis';
 import { removeQuotes } from '../utils/removeQuotes';
-import { replaceParameters } from '../utils/replaceParameters';
 import { $deepFreeze } from '../utils/serialization/$deepFreeze';
 import { checkSerializableAsJson } from '../utils/serialization/checkSerializableAsJson';
 import { clonePipeline } from '../utils/serialization/clonePipeline';
@@ -91,7 +91,6 @@ export { splitIntoSentences };
 export { countSentences };
 export { countWords };
 export { CountUtils };
-export { extractParameterNames };
 export { capitalize };
 export { decapitalize };
 export { DIACRITIC_VARIANTS_LETTERS };
@@ -114,11 +113,12 @@ export { parseKeywords };
 export { parseKeywordsFromString };
 export { removeDiacritics };
 export { searchKeywords };
+export { extractParameterNames };
+export { replaceParameters };
 export { parseNumber };
 export { $randomSeed };
 export { removeEmojis };
 export { removeQuotes };
-export { replaceParameters };
 export { $deepFreeze };
 export { checkSerializableAsJson };
 export { clonePipeline };

package/esm/typings/src/_packages/website-crawler.index.d.ts

@@ -0,0 +1,8 @@
+import { PROMPTBOOK_VERSION } from '../version';
+import { createWebsiteScraper } from '../scrapers/website/createWebsiteScraper';
+import { _WebsiteScraperRegistration } from '../scrapers/website/register-constructor';
+import { WebsiteScraper } from '../scrapers/website/WebsiteScraper';
+export { PROMPTBOOK_VERSION };
+export { createWebsiteScraper };
+export { _WebsiteScraperRegistration };
+export { WebsiteScraper };

package/esm/typings/src/cli/cli-commands/about.d.ts

@@ -7,5 +7,5 @@ import type { Command as Program } from 'commander';
 export declare function initializeAboutCommand(program: Program): void;
 /**
  * TODO: [🗽] Unite branding and make single place for it
- * Note: [🟡] This code should never be published outside of `@promptbook/cli`
+ * Note: [🟡] Code in this file should never be published outside of `@promptbook/cli`
  */

package/esm/typings/src/cli/cli-commands/hello.d.ts

@@ -6,5 +6,6 @@ import type { Command as Program } from 'commander';
  */
 export declare function initializeHelloCommand(program: Program): void;
 /**
- * Note: [🟡] This code should never be published outside of `@promptbook/cli`
+ * TODO: [🧠][🐣] Make here some easter egg with generated hello greeting via LLM models
+ * Note: [🟡] Code in this file should never be published outside of `@promptbook/cli`
  */

package/esm/typings/src/cli/cli-commands/make.d.ts

@@ -9,6 +9,6 @@ export declare function initializeMakeCommand(program: Program): void;
  * TODO: [🥃][main] !!! Allow `ptbk make` without configuring any llm tools
  * TODO: Maybe remove this command - "about" command should be enough?
  * TODO: [0] DRY Javascript and typescript - Maybe make ONLY typescript and for javascript just remove types
- * Note: [🟡] This code should never be published outside of `@promptbook/cli`
+ * Note: [🟡] Code in this file should never be published outside of `@promptbook/cli`
  * TODO: [🖇] What about symlinks? Maybe flag --follow-symlinks
  */

package/esm/typings/src/cli/cli-commands/prettify.d.ts

@@ -6,6 +6,7 @@ import type { Command as Program } from 'commander';
  */
 export declare function initializePrettifyCommand(program: Program): void;
 /**
- * Note: [🟡] This code should never be published outside of `@promptbook/cli`
+ * TODO: [😶] Unite floder listing
+ * Note: [🟡] Code in this file should never be published outside of `@promptbook/cli`
  * TODO: [🖇] What about symlinks? Maybe flag --follow-symlinks
  */

package/esm/typings/src/cli/cli-commands/test-command.d.ts

@@ -0,0 +1,13 @@
+import type { Command as Program } from 'commander';
+/**
+ * Initializes `test` command for Promptbook CLI utilities
+ *
+ * @private internal function of `promptbookCli`
+ */
+export declare function initializeTestCommand(program: Program): void;
+/**
+ * TODO: [😶] Unite floder listing
+ * Note: [🟡] Code in this file should never be published outside of `@promptbook/cli`
+ * TODO: [🖇] What about symlinks? Maybe flag --follow-symlinks
+ * Note: This is named "test-command.ts" to avoid name collision with jest unit test files
+ */

package/esm/typings/src/cli/main.d.ts

@@ -8,5 +8,5 @@ export declare const _CLI: {
     _initialize: typeof promptbookCli;
 };
 /**
- * Note: [🟡] This code should never be published outside of `@promptbook/cli`
+ * Note: [🟡] Code in this file should never be published outside of `@promptbook/cli`
  */

package/esm/typings/src/cli/promptbookCli.d.ts

@@ -8,5 +8,5 @@ export declare function promptbookCli(): Promise<void>;
  * TODO: [🥠] Do not export, its just for CLI script
  * TODO: [🕌] When more functionalities, rename
  * Note: 11:11
- * Note: [🟡] This code should never be published outside of `@promptbook/cli`
+ * Note: [🟡] Code in this file should never be published outside of `@promptbook/cli`
  */

package/esm/typings/src/collection/constructors/createCollectionFromDirectory.d.ts

@@ -1,10 +1,14 @@
-import type { PipelineStringToJsonOptions } from '../../conversion/pipelineStringToJson';
-import type { string_folder_path } from '../../types/typeAliases';
+import type { ExecutionTools } from '../../execution/ExecutionTools';
+import type { PrepareAndScrapeOptions } from '../../prepare/PrepareAndScrapeOptions';
+import type { string_dirname } from '../../types/typeAliases';
 import type { PipelineCollection } from '../PipelineCollection';
 /**
  * Options for `createCollectionFromDirectory` function
+ *
+ * Note: `rootDirname` is not needed because it is the folder in which `.ptbk.md` file is located
+ *       This is not same as `path` which is the first argument of `createCollectionFromDirectory` - it can be a subfolder
  */
-type CreatePipelineCollectionFromDirectoryOptions = PipelineStringToJsonOptions & {
+type CreatePipelineCollectionFromDirectoryOptions = Omit<PrepareAndScrapeOptions, 'rootDirname'> & {
     /**
      * If true, the directory is searched recursively for pipelines
      *
@@ -37,13 +41,14 @@ type CreatePipelineCollectionFromDirectoryOptions = PipelineStringToJsonOptions
  * Note: Works only in Node.js environment because it reads the file system
  *
  * @param path - path to the directory with pipelines
- * @param options - Misc options for the collection
+ * @param tools - Execution tools to be used for pipeline preparation if needed - If not provided, `$provideExecutionToolsForNode` will be used
+ * @param options - Options for the collection creation
  * @returns PipelineCollection
  * @public exported from `@promptbook/node`
  */
-export declare function createCollectionFromDirectory(path: string_folder_path, options?: CreatePipelineCollectionFromDirectoryOptions): Promise<PipelineCollection>;
+export declare function createCollectionFromDirectory(path: string_dirname, tools?: Pick<ExecutionTools, 'llm' | 'fs' | 'scrapers'>, options?: CreatePipelineCollectionFromDirectoryOptions): Promise<PipelineCollection>;
 export {};
 /**
- * Note: [🟢] This code should never be published outside of `@promptbook/node` and `@promptbook/cli` and `@promptbook/cli`
  * TODO: [🖇] What about symlinks? Maybe option isSymlinksFollowed
+ * TODO: Maybe move from `@promptbook/node` to `@promptbook/core` as we removes direct dependency on `fs`
  */

package/esm/typings/src/collection/constructors/createCollectionFromUrl.d.ts

@@ -25,5 +25,5 @@ type CreatePipelineCollectionFromUrlyOptions = {
 export declare function createCollectionFromUrl(url: string_url | URL, options: CreatePipelineCollectionFromUrlyOptions): Promise<PipelineCollection>;
 export {};
 /**
- * TODO:[main] !!!! [🧠] Library precompilation and do not mix markdown and json promptbooks
+ * TODO: [main] !!!! [🧠] Library precompilation and do not mix markdown and json promptbooks
  */

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

@@ -3,7 +3,7 @@ import type { ExpectCommand } from './ExpectCommand';
 /**
  * Parses the expect command
  *
- * @see ./EXPECT-README.md for more details
+ * @see `documentationUrl` for more details
  * @private within the commands folder
  */
 export declare const expectCommandParser: PipelineTemplateCommandParser<ExpectCommand>;

package/esm/typings/src/commands/FOREACH/ForeachCommand.d.ts

@@ -1,9 +1,10 @@
+import type { ForeachJson } from './ForeachJson';
 /**
- * Parsed FOREACH command <- Write [🍭]
+ * Parsed FOREACH command which is used to iterate over a table of values
  *
  * @see ./foreachCommandParser.ts for more details
  * @private within the commands folder
  */
 export type ForeachCommand = {
     readonly type: 'FOREACH';
-};
+} & ForeachJson;

package/esm/typings/src/commands/FOREACH/ForeachJson.d.ts

@@ -0,0 +1,27 @@
+import type { string_parameter_name } from '../../types/typeAliases';
+import type { TODO_string } from '../../utils/organization/TODO_string';
+/**
+ * @@@
+ */
+export type ForeachJson = {
+    /**
+     * @@@
+     */
+    readonly formatName: TODO_string;
+    /**
+     * @@@
+     */
+    readonly subformatName: TODO_string;
+    /**
+     * @@@
+     */
+    readonly parameterName: string_parameter_name;
+    /**
+     * @@@
+     */
+    readonly inputSubparameterNames: Array<string_parameter_name>;
+    /**
+     * @@@
+     */
+    readonly outputSubparameterName: string_parameter_name;
+};

package/esm/typings/src/commands/FOREACH/foreachCommandParser.d.ts

@@ -5,10 +5,10 @@ import type { ForeachCommand } from './ForeachCommand';
  *
  * Note: @@@ This command is used as foreach for new commands - it should NOT be used in any `.ptbk.md` file
  *
- * @see ./FOREACH-README.md for more details <- TODO: @@@ Write theese README files OR remove this link + add annotation here (to all commands)
+ * @see `documentationUrl` for more details
  * @private within the commands folder
  */
 export declare const foreachCommandParser: PipelineTemplateCommandParser<ForeachCommand>;
 /**
- * TODO: [🍭] Make .ptbk.md file with examples of the FOREACH command and also with wrong parsing and logic
+ * TODO: [🍭] Make .ptbk.md file with examples of the FOREACH with wrong parsing and logic
  */

package/esm/typings/src/commands/FORMAT/formatCommandParser.d.ts

@@ -3,7 +3,7 @@ import type { FormatCommand } from './FormatCommand';
 /**
  * Parses the format command
  *
- * @see ./FORMAT-README.md for more details
+ * @see `documentationUrl` for more details
  * @private within the commands folder
  */
 export declare const formatCommandParser: PipelineTemplateCommandParser<FormatCommand>;

package/esm/typings/src/commands/JOKER/jokerCommandParser.d.ts

@@ -3,7 +3,7 @@ import type { JokerCommand } from './JokerCommand';
 /**
  * Parses the joker command
  *
- * @see ./JOKER-README.md for more details
+ * @see `documentationUrl` for more details
  * @private within the commands folder
  */
 export declare const jokerCommandParser: PipelineTemplateCommandParser<JokerCommand>;

package/esm/typings/src/commands/KNOWLEDGE/knowledgeCommandParser.d.ts

@@ -3,7 +3,7 @@ import type { KnowledgeCommand } from './KnowledgeCommand';
 /**
  * Parses the knowledge command
  *
- * @see ./KNOWLEDGE-README.md for more details
+ * @see `documentationUrl` for more details
  * @private within the commands folder
  */
 export declare const knowledgeCommandParser: PipelineHeadCommandParser<KnowledgeCommand>;

package/esm/typings/src/commands/KNOWLEDGE/utils/sourceContentToName.d.ts

@@ -0,0 +1,11 @@
+import type { string_knowledge_source_content } from '../../../types/typeAliases';
+import type { string_name } from '../../../types/typeAliases';
+/**
+ * Creates unique name for the source
+ *
+ * @private within the repository
+ */
+export declare function sourceContentToName(sourceContent: string_knowledge_source_content): string_name;
+/**
+ * TODO: [🐱‍🐉][🧠] Make some smart crop NOT source-i-m-pavol-a-develop-... BUT source-i-m-pavol-a-developer-...
+ */

package/esm/typings/src/commands/KNOWLEDGE/utils/sourceContentToName.test.d.ts

@@ -0,0 +1,4 @@
+export {};
+/**
+ * TODO: [🐱‍🐉][🧠] Make some smart crop NOT source-i-m-pavol-a-develop-... BUT source-i-m-pavol-a-developer-...
+ */

package/esm/typings/src/commands/MODEL/modelCommandParser.d.ts

@@ -3,7 +3,7 @@ import type { ModelCommand } from './ModelCommand';
 /**
  * Parses the model command
  *
- * @see ./MODEL-README.md for more details
+ * @see `documentationUrl` for more details
  * @private within the commands folder
  */
 export declare const modelCommandParser: PipelineBothCommandParser<ModelCommand>;

package/esm/typings/src/commands/PARAMETER/parameterCommandParser.d.ts

@@ -3,7 +3,7 @@ import type { ParameterCommand } from './ParameterCommand';
 /**
  * Parses the parameter command
  *
- * @see ./PARAMETER-README.md for more details
+ * @see `documentationUrl` for more details
  * @private within the commands folder
  */
 export declare const parameterCommandParser: PipelineBothCommandParser<ParameterCommand>;

package/esm/typings/src/commands/PERSONA/personaCommandParser.d.ts

@@ -3,7 +3,7 @@ import type { PersonaCommand } from './PersonaCommand';
 /**
  * Parses the persona command
  *
- * @see ./PERSONA-README.md for more details
+ * @see `documentationUrl` for more details
  * @private within the commands folder
  */
 export declare const personaCommandParser: PipelineBothCommandParser<PersonaCommand>;

package/esm/typings/src/commands/POSTPROCESS/postprocessCommandParser.d.ts

@@ -3,7 +3,7 @@ import type { PostprocessCommand } from './PostprocessCommand';
 /**
  * Parses the postprocess command
  *
- * @see ./POSTPROCESS-README.md for more details
+ * @see `documentationUrl` for more details
  * @private within the commands folder
  */
 export declare const postprocessCommandParser: PipelineTemplateCommandParser<PostprocessCommand>;

package/esm/typings/src/commands/PROMPTBOOK_VERSION/promptbookVersionCommandParser.d.ts

@@ -3,7 +3,7 @@ import type { PromptbookVersionCommand } from './PromptbookVersionCommand';
 /**
  * Parses the PROMPTBOOK_VERSION command
  *
- * @see ./PROMPTBOOK_VERSION-README.md for more details
+ * @see `documentationUrl` for more details
  * @private within the commands folder
  */
 export declare const promptbookVersionCommandParser: PipelineHeadCommandParser<PromptbookVersionCommand>;

package/esm/typings/src/commands/TEMPLATE/templateCommandParser.d.ts

@@ -3,7 +3,7 @@ import type { TemplateCommand } from './TemplateCommand';
 /**
  * Parses the template command
  *
- * @see ./TEMPLATE-README.md for more details
+ * @see `documentationUrl` for more details
  * @private within the commands folder
  */
 export declare const templateCommandParser: PipelineTemplateCommandParser<TemplateCommand>;

package/esm/typings/src/commands/URL/urlCommandParser.d.ts

@@ -3,7 +3,7 @@ import type { UrlCommand } from './UrlCommand';
 /**
  * Parses the url command
  *
- * @see ./URL-README.md for more details
+ * @see `documentationUrl` for more details
  * @private within the commands folder
  */
 export declare const urlCommandParser: PipelineHeadCommandParser<UrlCommand>;

package/esm/typings/src/commands/X_ACTION/actionCommandParser.d.ts

@@ -3,7 +3,7 @@ import type { ActionCommand } from './ActionCommand';
 /**
  * Parses the action command
  *
- * @see ./ACTION-README.md for more details
+ * @see `documentationUrl` for more details
  * @private within the commands folder
  */
 export declare const actionCommandParser: PipelineHeadCommandParser<ActionCommand>;

package/esm/typings/src/commands/X_INSTRUMENT/instrumentCommandParser.d.ts

@@ -3,7 +3,7 @@ import type { InstrumentCommand } from './InstrumentCommand';
 /**
  * Parses the instrument command
  *
- * @see ./INSTRUMENT-README.md for more details
+ * @see `documentationUrl` for more details
  * @private within the commands folder
  */
 export declare const instrumentCommandParser: PipelineHeadCommandParser<InstrumentCommand>;

package/esm/typings/src/commands/_BOILERPLATE/boilerplateCommandParser.d.ts

@@ -5,7 +5,7 @@ import type { BoilerplateCommand } from './BoilerplateCommand';
  *
  * Note: @@@ This command is used as boilerplate for new commands - it should NOT be used in any `.ptbk.md` file
  *
- * @see ./BOILERPLATE-README.md for more details <- TODO: @@@ Write theese README files OR remove this link + add annotation here (to all commands)
+ * @see `documentationUrl` for more details
  * @private within the commands folder
  */
 export declare const boilerplateCommandParser: PipelineBothCommandParser<BoilerplateCommand>;