@promptbook/remote-server 0.72.0-9 → 0.72.0

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

@@ -7,20 +7,21 @@ import { createSubcollection } from '../collection/constructors/createSubcollect
 import type { TemplateType } from '../commands/TEMPLATE/TemplateTypes';
 import { TemplateTypes } from '../commands/TEMPLATE/TemplateTypes';
 import { CLAIM } from '../config';
-import { MAX_PARALLEL_COUNT } from '../config';
-import { MAX_EXECUTION_ATTEMPTS } from '../config';
 import { MAX_FILENAME_LENGTH } from '../config';
-import { MAX_KNOWLEDGE_SOURCES_SCRAPING_DEPTH } from '../config';
-import { MAX_KNOWLEDGE_SOURCES_SCRAPING_TOTAL } from '../config';
-import { EXECUTIONS_CACHE_DIRNAME } from '../config';
-import { SCRAPE_CACHE_DIRNAME } from '../config';
-import { PIPELINE_COLLECTION_BASE_FILENAME } from '../config';
+import { DEFAULT_INTERMEDIATE_FILES_STRATEGY } from '../config';
+import { DEFAULT_MAX_PARALLEL_COUNT } from '../config';
+import { DEFAULT_MAX_EXECUTION_ATTEMPTS } from '../config';
+import { DEFAULT_MAX_KNOWLEDGE_SOURCES_SCRAPING_DEPTH } from '../config';
+import { DEFAULT_MAX_KNOWLEDGE_SOURCES_SCRAPING_TOTAL } from '../config';
+import { DEFAULT_EXECUTIONS_CACHE_DIRNAME } from '../config';
+import { DEFAULT_SCRAPE_CACHE_DIRNAME } from '../config';
+import { DEFAULT_PIPELINE_COLLECTION_BASE_FILENAME } from '../config';
 import { RESERVED_PARAMETER_NAMES } from '../config';
 import { DEFAULT_REMOTE_URL } from '../config';
 import { DEFAULT_REMOTE_URL_PATH } from '../config';
 import { DEFAULT_CSV_SETTINGS } from '../config';
-import { IS_VERBOSE } from '../config';
-import { IS_AUTO_INSTALLED } from '../config';
+import { DEFAULT_IS_VERBOSE } from '../config';
+import { DEFAULT_IS_AUTO_INSTALLED } from '../config';
 import { pipelineJsonToString } from '../conversion/pipelineJsonToString';
 import { pipelineStringToJson } from '../conversion/pipelineStringToJson';
 import { pipelineStringToJsonSync } from '../conversion/pipelineStringToJsonSync';
@@ -66,6 +67,7 @@ import { limitTotalUsage } from '../llm-providers/_common/utils/count-total-usag
 import { _AnthropicClaudeMetadataRegistration } from '../llm-providers/anthropic-claude/register-configuration';
 import { _AzureOpenAiMetadataRegistration } from '../llm-providers/azure-openai/register-configuration';
 import { joinLlmExecutionTools } from '../llm-providers/multiple/joinLlmExecutionTools';
+import { MultipleLlmExecutionTools } from '../llm-providers/multiple/MultipleLlmExecutionTools';
 import { _OpenAiMetadataRegistration } from '../llm-providers/openai/register-configuration';
 import { _OpenAiAssistantMetadataRegistration } from '../llm-providers/openai/register-configuration';
 import { preparePersona } from '../personas/preparePersona';
@@ -76,6 +78,7 @@ import { unpreparePipeline } from '../prepare/unpreparePipeline';
 import { prepareKnowledgePieces } from '../scrapers/_common/prepareKnowledgePieces';
 import { $scrapersMetadataRegister } from '../scrapers/_common/register/$scrapersMetadataRegister';
 import { $scrapersRegister } from '../scrapers/_common/register/$scrapersRegister';
+import { makeKnowledgeSourceHandler } from '../scrapers/_common/utils/makeKnowledgeSourceHandler';
 import { _LegacyDocumentScraperMetadataRegistration } from '../scrapers/document-legacy/register-metadata';
 import { _DocumentScraperMetadataRegistration } from '../scrapers/document/register-metadata';
 import { _MarkdownScraperMetadataRegistration } from '../scrapers/markdown/register-metadata';
@@ -97,20 +100,21 @@ export { createSubcollection };
 export type { TemplateType };
 export { TemplateTypes };
 export { CLAIM };
-export { MAX_PARALLEL_COUNT };
-export { MAX_EXECUTION_ATTEMPTS };
 export { MAX_FILENAME_LENGTH };
-export { MAX_KNOWLEDGE_SOURCES_SCRAPING_DEPTH };
-export { MAX_KNOWLEDGE_SOURCES_SCRAPING_TOTAL };
-export { EXECUTIONS_CACHE_DIRNAME };
-export { SCRAPE_CACHE_DIRNAME };
-export { PIPELINE_COLLECTION_BASE_FILENAME };
+export { DEFAULT_INTERMEDIATE_FILES_STRATEGY };
+export { DEFAULT_MAX_PARALLEL_COUNT };
+export { DEFAULT_MAX_EXECUTION_ATTEMPTS };
+export { DEFAULT_MAX_KNOWLEDGE_SOURCES_SCRAPING_DEPTH };
+export { DEFAULT_MAX_KNOWLEDGE_SOURCES_SCRAPING_TOTAL };
+export { DEFAULT_EXECUTIONS_CACHE_DIRNAME };
+export { DEFAULT_SCRAPE_CACHE_DIRNAME };
+export { DEFAULT_PIPELINE_COLLECTION_BASE_FILENAME };
 export { RESERVED_PARAMETER_NAMES };
 export { DEFAULT_REMOTE_URL };
 export { DEFAULT_REMOTE_URL_PATH };
 export { DEFAULT_CSV_SETTINGS };
-export { IS_VERBOSE };
-export { IS_AUTO_INSTALLED };
+export { DEFAULT_IS_VERBOSE };
+export { DEFAULT_IS_AUTO_INSTALLED };
 export { pipelineJsonToString };
 export { pipelineStringToJson };
 export { pipelineStringToJsonSync };
@@ -156,6 +160,7 @@ export { limitTotalUsage };
 export { _AnthropicClaudeMetadataRegistration };
 export { _AzureOpenAiMetadataRegistration };
 export { joinLlmExecutionTools };
+export { MultipleLlmExecutionTools };
 export { _OpenAiMetadataRegistration };
 export { _OpenAiAssistantMetadataRegistration };
 export { preparePersona };
@@ -166,6 +171,7 @@ export { unpreparePipeline };
 export { prepareKnowledgePieces };
 export { $scrapersMetadataRegister };
 export { $scrapersRegister };
+export { makeKnowledgeSourceHandler };
 export { _LegacyDocumentScraperMetadataRegistration };
 export { _DocumentScraperMetadataRegistration };
 export { _MarkdownScraperMetadataRegistration };

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

@@ -1,5 +1,6 @@
 import { PROMPTBOOK_VERSION } from '../version';
 import { createCollectionFromDirectory } from '../collection/constructors/createCollectionFromDirectory';
+import { $provideExecutablesForNode } from '../executables/$provideExecutablesForNode';
 import { $provideExecutionToolsForNode } from '../execution/utils/$provideExecutionToolsForNode';
 import { $provideLlmToolsConfigurationFromEnv } from '../llm-providers/_common/register/$provideLlmToolsConfigurationFromEnv';
 import { $provideLlmToolsFromEnv } from '../llm-providers/_common/register/$provideLlmToolsFromEnv';
@@ -10,6 +11,7 @@ import { $execCommand } from '../utils/execCommand/$execCommand';
 import { $execCommands } from '../utils/execCommand/$execCommands';
 export { PROMPTBOOK_VERSION };
 export { createCollectionFromDirectory };
+export { $provideExecutablesForNode };
 export { $provideExecutionToolsForNode };
 export { $provideLlmToolsConfigurationFromEnv };
 export { $provideLlmToolsFromEnv };

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

@@ -14,11 +14,12 @@ 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 { LocateAppOptions } from '../executables/locateApp';
 import type { AvailableModel } from '../execution/AvailableModel';
 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 { Executables } from '../execution/Executables';
 import type { ExecutionTools } from '../execution/ExecutionTools';
 import type { FilesystemTools } from '../execution/FilesystemTools';
 import type { LlmExecutionTools } from '../execution/LlmExecutionTools';
@@ -49,7 +50,6 @@ import type { AnthropicClaudeExecutionToolsDirectOptions } from '../llm-provider
 import type { AnthropicClaudeExecutionToolsProxiedOptions } from '../llm-providers/anthropic-claude/AnthropicClaudeExecutionToolsOptions';
 import type { AzureOpenAiExecutionToolsOptions } from '../llm-providers/azure-openai/AzureOpenAiExecutionToolsOptions';
 import type { LangtailExecutionToolsOptions } from '../llm-providers/langtail/LangtailExecutionToolsOptions';
-import type { MultipleLlmExecutionTools } from '../llm-providers/multiple/MultipleLlmExecutionTools';
 import type { OpenAiAssistantExecutionToolsOptions } from '../llm-providers/openai/OpenAiAssistantExecutionToolsOptions';
 import type { OpenAiExecutionToolsOptions } from '../llm-providers/openai/OpenAiExecutionToolsOptions';
 import type { PromptbookServer_Error } from '../llm-providers/remote/interfaces/PromptbookServer_Error';
@@ -66,6 +66,7 @@ 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 { 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';
@@ -81,6 +82,7 @@ import type { ExecutionPromptReportJson } from '../types/execution-report/Execut
 import type { ExecutionReportJson } from '../types/execution-report/ExecutionReportJson';
 import type { ExecutionReportString } from '../types/execution-report/ExecutionReportString';
 import type { ExecutionReportStringOptions } from '../types/execution-report/ExecutionReportStringOptions';
+import type { IntermediateFilesStrategy } from '../types/IntermediateFilesStrategy';
 import type { ModelRequirements } from '../types/ModelRequirements';
 import type { CompletionModelRequirements } from '../types/ModelRequirements';
 import type { ChatModelRequirements } from '../types/ModelRequirements';
@@ -162,13 +164,13 @@ 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';
@@ -191,6 +193,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';
@@ -223,13 +226,13 @@ 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 { ExecCommandOptions } from '../utils/execCommand/ExecCommandOptions';
+import type { ExecCommandOptionsAdvanced } from '../utils/execCommand/ExecCommandOptions';
 import type { FromtoItems } from '../utils/FromtoItems';
 import type { CodeBlock } from '../utils/markdown/extractAllBlocksFromMarkdown';
 import type { MarkdownSection } from '../utils/markdown/parseMarkdownSection';
 import type { string_keyword } from '../utils/normalization/IKeywords';
-import type { IKeywords } from '../utils/normalization/IKeywords';
+import type { Keywords } from '../utils/normalization/IKeywords';
 import type { string_kebab_case } from '../utils/normalization/normalize-to-kebab-case';
 import type { string_camelCase } from '../utils/normalization/normalizeTo_camelCase';
 import type { string_PascalCase } from '../utils/normalization/normalizeTo_PascalCase';
@@ -255,11 +258,12 @@ export type { PrettifyOptions };
 export type { renderPipelineMermaidOptions };
 export type { CallbackInterfaceToolsOptions };
 export type { ErrorJson };
+export type { LocateAppOptions };
 export type { AvailableModel };
 export type { CommonToolsOptions };
 export type { CreatePipelineExecutorOptions };
-export type { CreatePipelineExecutorSettings };
 export type { EmbeddingVector };
+export type { Executables };
 export type { ExecutionTools };
 export type { FilesystemTools };
 export type { LlmExecutionTools };
@@ -290,7 +294,6 @@ export type { AnthropicClaudeExecutionToolsDirectOptions };
 export type { AnthropicClaudeExecutionToolsProxiedOptions };
 export type { AzureOpenAiExecutionToolsOptions };
 export type { LangtailExecutionToolsOptions };
-export type { MultipleLlmExecutionTools };
 export type { OpenAiAssistantExecutionToolsOptions };
 export type { OpenAiExecutionToolsOptions };
 export type { PromptbookServer_Error };
@@ -307,6 +310,7 @@ export type { RemoteLlmExecutionToolsOptions };
 export type { RemoteServerOptions };
 export type { AnonymousRemoteServerOptions };
 export type { CollectionRemoteServerOptions };
+export type { CollectionRemoteServerClientOptions };
 export type { PrepareAndScrapeOptions };
 export type { Converter };
 export type { ScraperAndConverterMetadata };
@@ -322,6 +326,7 @@ export type { ExecutionPromptReportJson };
 export type { ExecutionReportJson };
 export type { ExecutionReportString };
 export type { ExecutionReportStringOptions };
+export type { IntermediateFilesStrategy };
 export type { ModelRequirements };
 export type { CompletionModelRequirements };
 export type { ChatModelRequirements };
@@ -403,13 +408,13 @@ 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 };
@@ -432,6 +437,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 };
@@ -464,13 +470,13 @@ export type { number_gigabytes };
 export type { number_terabytes };
 export type { Registered };
 export type { Registration };
-export type { IExecCommandOptions };
-export type { IExecCommandOptionsAdvanced };
+export type { ExecCommandOptions };
+export type { ExecCommandOptionsAdvanced };
 export type { FromtoItems };
 export type { CodeBlock };
 export type { MarkdownSection };
 export type { string_keyword };
-export type { IKeywords };
+export type { Keywords };
 export type { string_kebab_case };
 export type { string_camelCase };
 export type { string_PascalCase };

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

@@ -24,7 +24,7 @@ import { capitalize } from '../utils/normalization/capitalize';
 import { decapitalize } from '../utils/normalization/decapitalize';
 import { DIACRITIC_VARIANTS_LETTERS } from '../utils/normalization/DIACRITIC_VARIANTS_LETTERS';
 import type { string_keyword } from '../utils/normalization/IKeywords';
-import type { IKeywords } from '../utils/normalization/IKeywords';
+import type { Keywords } from '../utils/normalization/IKeywords';
 import { isValidKeyword } from '../utils/normalization/isValidKeyword';
 import { nameToUriPart } from '../utils/normalization/nameToUriPart';
 import { nameToUriParts } from '../utils/normalization/nameToUriParts';
@@ -95,7 +95,7 @@ export { capitalize };
 export { decapitalize };
 export { DIACRITIC_VARIANTS_LETTERS };
 export type { string_keyword };
-export type { IKeywords };
+export type { Keywords };
 export { isValidKeyword };
 export { nameToUriPart };
 export { nameToUriParts };

package/esm/typings/src/collection/PipelineCollection.d.ts

@@ -11,7 +11,7 @@ export type PipelineCollection = {
     /**
      * Gets all pipelines in the collection
      */
-    listPipelines(): Promisable<Array<string_pipeline_url>>;
+    listPipelines(): Promisable<ReadonlyArray<string_pipeline_url>>;
     /**
      * Gets pipeline by its URL
      *

package/esm/typings/src/collection/SimplePipelineCollection.d.ts

@@ -19,11 +19,11 @@ export declare class SimplePipelineCollection implements PipelineCollection {
      * Note: During the construction logic of all pipelines are validated
      * Note: It is not recommended to use this constructor directly, use `createCollectionFromJson` *(or other variant)* instead
      */
-    constructor(...pipelines: Array<PipelineJson>);
+    constructor(...pipelines: ReadonlyArray<PipelineJson>);
     /**
      * Gets all pipelines in the collection
      */
-    listPipelines(): Array<string_pipeline_url>;
+    listPipelines(): ReadonlyArray<string_pipeline_url>;
     /**
      * Gets pipeline by its URL
      *

package/esm/typings/src/collection/collectionToJson.d.ts

@@ -7,7 +7,7 @@ import type { PipelineCollection } from './PipelineCollection';
  *
  * @public exported from `@promptbook/core`
  */
-export declare function collectionToJson(collection: PipelineCollection): Promise<Array<PipelineJson>>;
+export declare function collectionToJson(collection: PipelineCollection): Promise<ReadonlyArray<PipelineJson>>;
 /**
  * TODO: [🧠] Maybe clear `sourceFile` or clear when exposing through API or remote server
  */

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

@@ -10,4 +10,4 @@ import type { PipelineCollection } from '../PipelineCollection';
  * @returns PipelineCollection
  * @public exported from `@promptbook/core`
  */
-export declare function createCollectionFromJson(...promptbooks: Array<PipelineJson>): PipelineCollection;
+export declare function createCollectionFromJson(...promptbooks: ReadonlyArray<PipelineJson>): PipelineCollection;

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

@@ -20,4 +20,4 @@ import type { PipelineCollection } from '../PipelineCollection';
  * @deprecated Do not use, it will became internal tool for other constructor functions
  * @public exported from `@promptbook/core`
  */
-export declare function createCollectionFromPromise(promptbookSourcesPromiseOrFactory: Promise<Array<PipelineJson>> | (() => Promise<Array<PipelineJson>>)): PipelineCollection;
+export declare function createCollectionFromPromise(promptbookSourcesPromiseOrFactory: Promise<ReadonlyArray<PipelineJson>> | (() => Promise<ReadonlyArray<PipelineJson>>)): PipelineCollection;

package/esm/typings/src/commands/_common/types/CommandParser.d.ts

@@ -40,11 +40,11 @@ export type CommonCommandParser<TCommand extends CommandBase> = {
     /**
      * @@@
      */
-    readonly aliasNames?: Array<string_name & string_SCREAMING_CASE>;
+    readonly aliasNames?: ReadonlyArray<string_name & string_SCREAMING_CASE>;
     /**
      * @@@
      */
-    readonly deprecatedNames?: Array<string_name & string_SCREAMING_CASE>;
+    readonly deprecatedNames?: ReadonlyArray<string_name & string_SCREAMING_CASE>;
     /**
      * @@@
      */
@@ -56,7 +56,7 @@ export type CommonCommandParser<TCommand extends CommandBase> = {
     /**
      * @@@
      */
-    readonly examples: Array<string_markdown_text>;
+    readonly examples: ReadonlyArray<string_markdown_text>;
     /**
      * @throws {ParseError} if the parsing fails
      */
@@ -95,7 +95,7 @@ export type PipelineHeadCommandParser<TCommand extends CommandBase> = CommonComm
      *
      * Note: This is used in `pipelineJsonToString` utility
      */
-    takeFromPipelineJson(pipelineJson: PipelineJson): Array<TCommand>;
+    takeFromPipelineJson(pipelineJson: PipelineJson): ReadonlyArray<TCommand>;
 };
 /**
  * @@@
@@ -120,7 +120,7 @@ export type PipelineTemplateCommandParser<TCommand extends CommandBase> = Common
      *
      * Note: This is used in `pipelineJsonToString` utility
      */
-    takeFromTemplateJson($templateJson: $TemplateJson): Array<TCommand>;
+    takeFromTemplateJson($templateJson: $TemplateJson): ReadonlyArray<TCommand>;
 };
 /**
  * @@@

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

@@ -1,4 +1,5 @@
 import type { CsvSettings } from './formats/csv/CsvSettings';
+import type { IntermediateFilesStrategy } from './types/IntermediateFilesStrategy';
 /**
  * Warning message for the generated sections and files files
  *
@@ -12,7 +13,7 @@ export declare const GENERATOR_WARNING = "\u26A0\uFE0F WARNING: This code has be
  *
  * @public exported from `@promptbook/core`
  */
-export declare const CLAIM = "Supercharge LLM models with Promptbook";
+export declare const CLAIM = "Build responsible, controlled and transparent applications on top of LLM models!";
 /**
  * Warning message for the generated sections and files files
  *
@@ -50,37 +51,43 @@ export declare const CONNECTION_RETRIES_LIMIT = 5;
  */
 export declare const IMMEDIATE_TIME = 10;
 /**
- * The maximum number of (LLM) tasks running in parallel
+ * The maximum length of the (generated) filename
  *
  * @public exported from `@promptbook/core`
  */
-export declare const MAX_PARALLEL_COUNT = 5;
+export declare const MAX_FILENAME_LENGTH = 30;
 /**
- * The maximum number of attempts to execute LLM task before giving up
+ * Strategy for caching the intermediate results for knowledge sources
  *
  * @public exported from `@promptbook/core`
  */
-export declare const MAX_EXECUTION_ATTEMPTS = 3;
+export declare const DEFAULT_INTERMEDIATE_FILES_STRATEGY: IntermediateFilesStrategy;
 /**
- * The maximum length of the (generated) filename
+ * The maximum number of (LLM) tasks running in parallel
  *
  * @public exported from `@promptbook/core`
  */
-export declare const MAX_FILENAME_LENGTH = 30;
+export declare const DEFAULT_MAX_PARALLEL_COUNT = 5;
+/**
+ * The maximum number of attempts to execute LLM task before giving up
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare const DEFAULT_MAX_EXECUTION_ATTEMPTS = 3;
 /**
  * @@@
  * TODO: [🐝][main] !!! Use
  *
  * @public exported from `@promptbook/core`
  */
-export declare const MAX_KNOWLEDGE_SOURCES_SCRAPING_DEPTH = 3;
+export declare const DEFAULT_MAX_KNOWLEDGE_SOURCES_SCRAPING_DEPTH = 3;
 /**
  * @@@
  * TODO: [🐝][main] !!! Use
  *
  * @public exported from `@promptbook/core`
  */
-export declare const MAX_KNOWLEDGE_SOURCES_SCRAPING_TOTAL = 200;
+export declare const DEFAULT_MAX_KNOWLEDGE_SOURCES_SCRAPING_TOTAL = 200;
 /**
  * Where to store the cache of executions for promptbook CLI
  *
@@ -88,7 +95,7 @@ export declare const MAX_KNOWLEDGE_SOURCES_SCRAPING_TOTAL = 200;
  *
  * @public exported from `@promptbook/core`
  */
-export declare const EXECUTIONS_CACHE_DIRNAME = "/.promptbook/executions-cache";
+export declare const DEFAULT_EXECUTIONS_CACHE_DIRNAME = "/.promptbook/executions-cache";
 /**
  * Where to store the scrape cache
  *
@@ -96,13 +103,13 @@ export declare const EXECUTIONS_CACHE_DIRNAME = "/.promptbook/executions-cache";
  *
  * @public exported from `@promptbook/core`
  */
-export declare const SCRAPE_CACHE_DIRNAME = "/.promptbook/scrape-cache";
+export declare const DEFAULT_SCRAPE_CACHE_DIRNAME = "/.promptbook/scrape-cache";
 /**
  * The name of the builded pipeline collection made by CLI `ptbk make` and for lookup in `createCollectionFromDirectory`
  *
  * @public exported from `@promptbook/core`
  */
-export declare const PIPELINE_COLLECTION_BASE_FILENAME = "index";
+export declare const DEFAULT_PIPELINE_COLLECTION_BASE_FILENAME = "index";
 /**
  * Nonce which is used for replacing things in strings
  *
@@ -159,13 +166,13 @@ export declare const DEFAULT_CSV_SETTINGS: CsvSettings;
  *
  * @public exported from `@promptbook/core`
  */
-export declare const IS_VERBOSE = false;
+export declare const DEFAULT_IS_VERBOSE = false;
 /**
  * @@@
  *
  * @public exported from `@promptbook/core`
  */
-export declare const IS_AUTO_INSTALLED = false;
+export declare const DEFAULT_IS_AUTO_INSTALLED = false;
 /**
  * @@@
  *

package/esm/typings/src/executables/$provideExecutablesForNode.d.ts

@@ -0,0 +1,12 @@
+import type { Executables } from '../execution/Executables';
+import type { PrepareAndScrapeOptions } from '../prepare/PrepareAndScrapeOptions';
+/**
+ * @@@
+ *
+ * @public exported from `@promptbook/node`
+ */
+export declare function $provideExecutablesForNode(options?: PrepareAndScrapeOptions): Promise<Executables>;
+/**
+ * TODO: [🧠] Allow to override the executables without need to call `locatePandoc` / `locateLibreoffice` in case of provided
+ * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
+ */

package/esm/typings/src/executables/apps/locateLibreoffice.d.ts

@@ -0,0 +1,11 @@
+import type { string_executable_path } from '../../types/typeAliases';
+/**
+ * @@@
+ *
+ * @private within the repository
+ */
+export declare function locateLibreoffice(): Promise<string_executable_path | null>;
+/**
+ * TODO: [🧠][♿] Maybe export through `@promptbook/node` OR `@promptbook/legacy-documents`
+ * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
+ */

package/esm/typings/src/executables/apps/locatePandoc.d.ts

@@ -0,0 +1,11 @@
+import type { string_executable_path } from '../../types/typeAliases';
+/**
+ * @@@
+ *
+ * @private within the repository
+ */
+export declare function locatePandoc(): Promise<string_executable_path | null>;
+/**
+ * TODO: [🧠][♿] Maybe export through `@promptbook/node` OR `@promptbook/documents`
+ * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
+ */

package/esm/typings/src/executables/locateApp.d.ts

@@ -0,0 +1,33 @@
+import type { RequireAtLeastOne } from 'type-fest';
+import type { string_executable_path } from '../types/typeAliases';
+/**
+ * Options for locating any application
+ */
+export interface LocateAppOptions {
+    /**
+     * Name of the application
+     */
+    appName: string;
+    /**
+     * Name of the executable on Linux
+     */
+    linuxWhich?: string;
+    /**
+     * Path suffix on Windows
+     */
+    windowsSuffix?: string;
+    /**
+     * Name of the application on macOS
+     */
+    macOsName?: string;
+}
+/**
+ * Locates an application on the system
+ *
+ * @private within the repository
+ */
+export declare function locateApp(options: RequireAtLeastOne<LocateAppOptions, 'linuxWhich' | 'windowsSuffix' | 'macOsName'>): Promise<string_executable_path | null>;
+/**
+ * TODO: [🧠][♿] Maybe export through `@promptbook/node`
+ * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
+ */

package/esm/typings/src/executables/locateApp.test.d.ts

@@ -0,0 +1 @@
+export {};

package/esm/typings/src/executables/platforms/locateAppOnLinux.d.ts

@@ -0,0 +1,12 @@
+import type { string_executable_path } from '../../types/typeAliases';
+import type { LocateAppOptions } from '../locateApp';
+/**
+ * @@@
+ *
+ * @private within the repository
+ */
+export declare function locateAppOnLinux({ appName, linuxWhich, }: Pick<Required<LocateAppOptions>, 'appName' | 'linuxWhich'>): Promise<string_executable_path | null>;
+/**
+ * TODO: [🧠][♿] Maybe export through `@promptbook/node`
+ * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
+ */

package/esm/typings/src/executables/platforms/locateAppOnMacOs.d.ts

@@ -0,0 +1,12 @@
+import type { string_executable_path } from '../../types/typeAliases';
+import type { LocateAppOptions } from '../locateApp';
+/**
+ * @@@
+ *
+ * @private within the repository
+ */
+export declare function locateAppOnMacOs({ appName, macOsName, }: Pick<Required<LocateAppOptions>, 'appName' | 'macOsName'>): Promise<string_executable_path | null>;
+/**
+ * TODO: [🧠][♿] Maybe export through `@promptbook/node`
+ * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
+ */

package/esm/typings/src/executables/platforms/locateAppOnWindows.d.ts

@@ -0,0 +1,12 @@
+import type { string_executable_path } from '../../types/typeAliases';
+import type { LocateAppOptions } from '../locateApp';
+/**
+ * @@@
+ *
+ * @private within the repository
+ */
+export declare function locateAppOnWindows({ appName, windowsSuffix, }: Pick<Required<LocateAppOptions>, 'appName' | 'windowsSuffix'>): Promise<string_executable_path | null>;
+/**
+ * TODO: [🧠][♿] Maybe export through `@promptbook/node`
+ * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
+ */

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

@@ -1,7 +1,7 @@
 /**
  * Represents a vector in an latent space of the embedding model
  */
-export type EmbeddingVector = Array<number>;
+export type EmbeddingVector = ReadonlyArray<number>;
 /**
  * TODO: Figure out how to use NPM package xyzt
  *       Not using IVectorData due to HUGE dimensionality

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

@@ -0,0 +1,18 @@
+import type { string_executable_path } from '../types/typeAliases';
+/**
+ * Paths to the external programs executables
+ */
+export type Executables = {
+    /**
+     * Path to the `pandoc` executable
+     *
+     * @example 'C:/Users/me/AppData/Local/Pandoc/pandoc.exe'
+     */
+    pandocPath?: string_executable_path;
+    /**
+     * Path to the LibreOffice executable
+     *
+     * @example 'C:/Program Files/LibreOffice/program/swriter.exe'
+     */
+    libreOfficePath?: string_executable_path;
+};