@promptbook/remote-server 0.84.0-9 → 0.85.0-0

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

@@ -4,6 +4,8 @@ import { _AnthropicClaudeMetadataRegistration } from '../llm-providers/anthropic
 import { _AnthropicClaudeRegistration } from '../llm-providers/anthropic-claude/register-constructor';
 import { _AzureOpenAiMetadataRegistration } from '../llm-providers/azure-openai/register-configuration';
 import { _AzureOpenAiRegistration } from '../llm-providers/azure-openai/register-constructor';
+import { _DeepseekMetadataRegistration } from '../llm-providers/deepseek/register-configuration';
+import { _DeepseekRegistration } from '../llm-providers/deepseek/register-constructor';
 import { _GoogleMetadataRegistration } from '../llm-providers/google/register-configuration';
 import { _GoogleRegistration } from '../llm-providers/google/register-constructor';
 import { _OpenAiMetadataRegistration } from '../llm-providers/openai/register-configuration';
@@ -30,6 +32,8 @@ export { _AnthropicClaudeMetadataRegistration };
 export { _AnthropicClaudeRegistration };
 export { _AzureOpenAiMetadataRegistration };
 export { _AzureOpenAiRegistration };
+export { _DeepseekMetadataRegistration };
+export { _DeepseekRegistration };
 export { _GoogleMetadataRegistration };
 export { _GoogleRegistration };
 export { _OpenAiMetadataRegistration };

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

@@ -12,6 +12,9 @@ import { LOGO_LIGHT_SRC } from '../config';
 import { LOGO_DARK_SRC } from '../config';
 import { DEFAULT_BOOK_TITLE } from '../config';
 import { DEFAULT_TASK_TITLE } from '../config';
+import { DEFAULT_PROMPT_TASK_TITLE } from '../config';
+import { DEFAULT_BOOK_OUTPUT_PARAMETER_NAME } from '../config';
+import { DEFAULT_MAX_FILE_SIZE } from '../config';
 import { MAX_FILENAME_LENGTH } from '../config';
 import { DEFAULT_INTERMEDIATE_FILES_STRATEGY } from '../config';
 import { DEFAULT_MAX_PARALLEL_COUNT } from '../config';
@@ -19,7 +22,8 @@ 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_BOOKS_DIRNAME } from '../config';
-import { DEFAULT_EXECUTIONS_CACHE_DIRNAME } from '../config';
+import { DEFAULT_DOWNLOAD_CACHE_DIRNAME } from '../config';
+import { DEFAULT_EXECUTION_CACHE_DIRNAME } from '../config';
 import { DEFAULT_SCRAPE_CACHE_DIRNAME } from '../config';
 import { DEFAULT_PIPELINE_COLLECTION_BASE_FILENAME } from '../config';
 import { DEFAULT_REMOTE_URL } from '../config';
@@ -55,7 +59,6 @@ import { PipelineExecutionError } from '../errors/PipelineExecutionError';
 import { PipelineLogicError } from '../errors/PipelineLogicError';
 import { PipelineUrlError } from '../errors/PipelineUrlError';
 import { UnexpectedError } from '../errors/UnexpectedError';
-import { assertsExecutionSuccessful } from '../execution/assertsExecutionSuccessful';
 import { createPipelineExecutor } from '../execution/createPipelineExecutor/00-createPipelineExecutor';
 import { embeddingVectorToString } from '../execution/embeddingVectorToString';
 import { executionReportJsonToString } from '../execution/execution-report/executionReportJsonToString';
@@ -88,6 +91,7 @@ import { countTotalUsage } from '../llm-providers/_common/utils/count-total-usag
 import { limitTotalUsage } from '../llm-providers/_common/utils/count-total-usage/limitTotalUsage';
 import { _AnthropicClaudeMetadataRegistration } from '../llm-providers/anthropic-claude/register-configuration';
 import { _AzureOpenAiMetadataRegistration } from '../llm-providers/azure-openai/register-configuration';
+import { _DeepseekMetadataRegistration } from '../llm-providers/deepseek/register-configuration';
 import { _GoogleMetadataRegistration } from '../llm-providers/google/register-configuration';
 import { joinLlmExecutionTools } from '../llm-providers/multiple/joinLlmExecutionTools';
 import { MultipleLlmExecutionTools } from '../llm-providers/multiple/MultipleLlmExecutionTools';
@@ -138,6 +142,9 @@ export { LOGO_LIGHT_SRC };
 export { LOGO_DARK_SRC };
 export { DEFAULT_BOOK_TITLE };
 export { DEFAULT_TASK_TITLE };
+export { DEFAULT_PROMPT_TASK_TITLE };
+export { DEFAULT_BOOK_OUTPUT_PARAMETER_NAME };
+export { DEFAULT_MAX_FILE_SIZE };
 export { MAX_FILENAME_LENGTH };
 export { DEFAULT_INTERMEDIATE_FILES_STRATEGY };
 export { DEFAULT_MAX_PARALLEL_COUNT };
@@ -145,7 +152,8 @@ export { DEFAULT_MAX_EXECUTION_ATTEMPTS };
 export { DEFAULT_MAX_KNOWLEDGE_SOURCES_SCRAPING_DEPTH };
 export { DEFAULT_MAX_KNOWLEDGE_SOURCES_SCRAPING_TOTAL };
 export { DEFAULT_BOOKS_DIRNAME };
-export { DEFAULT_EXECUTIONS_CACHE_DIRNAME };
+export { DEFAULT_DOWNLOAD_CACHE_DIRNAME };
+export { DEFAULT_EXECUTION_CACHE_DIRNAME };
 export { DEFAULT_SCRAPE_CACHE_DIRNAME };
 export { DEFAULT_PIPELINE_COLLECTION_BASE_FILENAME };
 export { DEFAULT_REMOTE_URL };
@@ -181,7 +189,6 @@ export { PipelineExecutionError };
 export { PipelineLogicError };
 export { PipelineUrlError };
 export { UnexpectedError };
-export { assertsExecutionSuccessful };
 export { createPipelineExecutor };
 export { embeddingVectorToString };
 export { executionReportJsonToString };
@@ -214,6 +221,7 @@ export { countTotalUsage };
 export { limitTotalUsage };
 export { _AnthropicClaudeMetadataRegistration };
 export { _AzureOpenAiMetadataRegistration };
+export { _DeepseekMetadataRegistration };
 export { _GoogleMetadataRegistration };
 export { joinLlmExecutionTools };
 export { MultipleLlmExecutionTools };

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

@@ -0,0 +1,8 @@
+import { BOOK_LANGUAGE_VERSION, PROMPTBOOK_ENGINE_VERSION } from '../version';
+import { createDeepseekExecutionTools } from '../llm-providers/deepseek/createDeepseekExecutionTools';
+import type { DeepseekExecutionToolsOptions } from '../llm-providers/deepseek/DeepseekExecutionToolsOptions';
+import { _DeepseekRegistration } from '../llm-providers/deepseek/register-constructor';
+export { BOOK_LANGUAGE_VERSION, PROMPTBOOK_ENGINE_VERSION };
+export { createDeepseekExecutionTools };
+export type { DeepseekExecutionToolsOptions };
+export { _DeepseekRegistration };

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

@@ -28,6 +28,7 @@ import type { renderPipelineMermaidOptions } from '../conversion/prettify/render
 import type { CallbackInterfaceToolsOptions } from '../dialogs/callback/CallbackInterfaceToolsOptions';
 import type { ErrorJson } from '../errors/utils/ErrorJson';
 import type { LocateAppOptions } from '../executables/locateApp';
+import type { AbstractTaskResult } from '../execution/AbstractTaskResult';
 import type { AvailableModel } from '../execution/AvailableModel';
 import type { CommonToolsOptions } from '../execution/CommonToolsOptions';
 import type { CreatePipelineExecutorOptions } from '../execution/createPipelineExecutor/00-CreatePipelineExecutorOptions';
@@ -37,6 +38,10 @@ import type { ExecutionPromptReportJson } from '../execution/execution-report/Ex
 import type { ExecutionReportJson } from '../execution/execution-report/ExecutionReportJson';
 import type { ExecutionReportString } from '../execution/execution-report/ExecutionReportString';
 import type { ExecutionReportStringOptions } from '../execution/execution-report/ExecutionReportStringOptions';
+import type { ExecutionTask } from '../execution/ExecutionTask';
+import type { PreparationTask } from '../execution/ExecutionTask';
+import type { AbstractTask } from '../execution/ExecutionTask';
+import type { Task } from '../execution/ExecutionTask';
 import type { ExecutionTools } from '../execution/ExecutionTools';
 import type { FilesystemTools } from '../execution/FilesystemTools';
 import type { LlmExecutionTools } from '../execution/LlmExecutionTools';
@@ -70,6 +75,7 @@ import type { AnthropicClaudeExecutionToolsOptions } from '../llm-providers/anth
 import type { AnthropicClaudeExecutionToolsDirectOptions } from '../llm-providers/anthropic-claude/AnthropicClaudeExecutionToolsOptions';
 import type { AnthropicClaudeExecutionToolsProxiedOptions } from '../llm-providers/anthropic-claude/AnthropicClaudeExecutionToolsOptions';
 import type { AzureOpenAiExecutionToolsOptions } from '../llm-providers/azure-openai/AzureOpenAiExecutionToolsOptions';
+import type { DeepseekExecutionToolsOptions } from '../llm-providers/deepseek/DeepseekExecutionToolsOptions';
 import type { GoogleExecutionToolsOptions } from '../llm-providers/google/GoogleExecutionToolsOptions';
 import type { OpenAiAssistantExecutionToolsOptions } from '../llm-providers/openai/OpenAiAssistantExecutionToolsOptions';
 import type { OpenAiExecutionToolsOptions } from '../llm-providers/openai/OpenAiExecutionToolsOptions';
@@ -132,7 +138,6 @@ import type { ChatPrompt } from '../types/Prompt';
 import type { EmbeddingPrompt } from '../types/Prompt';
 import type { ScriptLanguage } from '../types/ScriptLanguage';
 import type { SectionType } from '../types/SectionType';
-import type { TaskProgress } from '../types/TaskProgress';
 import type { TaskType } from '../types/TaskType';
 import type { string_char_emoji } from '../types/typeAliasEmoji';
 import type { string_business_category_name } from '../types/typeAliases';
@@ -220,6 +225,7 @@ 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 { task_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';
@@ -233,6 +239,7 @@ import type { number_tokens } from '../types/typeAliases';
 import type { number_positive } from '../types/typeAliases';
 import type { number_negative } from '../types/typeAliases';
 import type { number_integer } from '../types/typeAliases';
+import type { number_port } from '../types/typeAliases';
 import type { number_percent } from '../types/typeAliases';
 import type { number_model_temperature } from '../types/typeAliases';
 import type { number_seed } from '../types/typeAliases';
@@ -302,6 +309,7 @@ export type { renderPipelineMermaidOptions };
 export type { CallbackInterfaceToolsOptions };
 export type { ErrorJson };
 export type { LocateAppOptions };
+export type { AbstractTaskResult };
 export type { AvailableModel };
 export type { CommonToolsOptions };
 export type { CreatePipelineExecutorOptions };
@@ -311,6 +319,10 @@ export type { ExecutionPromptReportJson };
 export type { ExecutionReportJson };
 export type { ExecutionReportString };
 export type { ExecutionReportStringOptions };
+export type { ExecutionTask };
+export type { PreparationTask };
+export type { AbstractTask };
+export type { Task };
 export type { ExecutionTools };
 export type { FilesystemTools };
 export type { LlmExecutionTools };
@@ -344,6 +356,7 @@ export type { AnthropicClaudeExecutionToolsOptions };
 export type { AnthropicClaudeExecutionToolsDirectOptions };
 export type { AnthropicClaudeExecutionToolsProxiedOptions };
 export type { AzureOpenAiExecutionToolsOptions };
+export type { DeepseekExecutionToolsOptions };
 export type { GoogleExecutionToolsOptions };
 export type { OpenAiAssistantExecutionToolsOptions };
 export type { OpenAiExecutionToolsOptions };
@@ -406,7 +419,6 @@ export type { ChatPrompt };
 export type { EmbeddingPrompt };
 export type { ScriptLanguage };
 export type { SectionType };
-export type { TaskProgress };
 export type { TaskType };
 export type { string_char_emoji };
 export type { string_business_category_name };
@@ -494,6 +506,7 @@ export type { string_translate_language };
 export type { string_javascript_name };
 export type { string_postprocessing_function_name };
 export type { id };
+export type { task_id };
 export type { string_token };
 export type { string_license_token };
 export type { string_password };
@@ -507,6 +520,7 @@ export type { number_tokens };
 export type { number_positive };
 export type { number_negative };
 export type { number_integer };
+export type { number_port };
 export type { number_percent };
 export type { number_model_temperature };
 export type { number_seed };

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

@@ -8,6 +8,7 @@ import { serializeError } from '../errors/utils/serializeError';
 import { forEachAsync } from '../execution/utils/forEachAsync';
 import { isValidJsonString } from '../formats/json/utils/isValidJsonString';
 import { prompt } from '../pipeline/prompt-notation';
+import { promptTemplate } from '../pipeline/prompt-notation';
 import { $getCurrentDate } from '../utils/$getCurrentDate';
 import { $isRunningInBrowser } from '../utils/environment/$isRunningInBrowser';
 import { $isRunningInJest } from '../utils/environment/$isRunningInJest';
@@ -53,7 +54,6 @@ import { numberToString } from '../utils/parameters/numberToString';
 import { templateParameters } from '../utils/parameters/templateParameters';
 import { valueToString } from '../utils/parameters/valueToString';
 import { parseNumber } from '../utils/parseNumber';
-import { $randomSeed } from '../utils/random/$randomSeed';
 import { removeEmojis } from '../utils/removeEmojis';
 import { removeQuotes } from '../utils/removeQuotes';
 import { $deepFreeze } from '../utils/serialization/$deepFreeze';
@@ -89,6 +89,7 @@ export { serializeError };
 export { forEachAsync };
 export { isValidJsonString };
 export { prompt };
+export { promptTemplate };
 export { $getCurrentDate };
 export { $isRunningInBrowser };
 export { $isRunningInJest };
@@ -134,7 +135,6 @@ export { numberToString };
 export { templateParameters };
 export { valueToString };
 export { parseNumber };
-export { $randomSeed };
 export { removeEmojis };
 export { removeQuotes };
 export { $deepFreeze };

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

@@ -3,6 +3,8 @@ import { _AnthropicClaudeMetadataRegistration } from '../llm-providers/anthropic
 import { _AnthropicClaudeRegistration } from '../llm-providers/anthropic-claude/register-constructor';
 import { _AzureOpenAiMetadataRegistration } from '../llm-providers/azure-openai/register-configuration';
 import { _AzureOpenAiRegistration } from '../llm-providers/azure-openai/register-constructor';
+import { _DeepseekMetadataRegistration } from '../llm-providers/deepseek/register-configuration';
+import { _DeepseekRegistration } from '../llm-providers/deepseek/register-constructor';
 import { _GoogleMetadataRegistration } from '../llm-providers/google/register-configuration';
 import { _GoogleRegistration } from '../llm-providers/google/register-constructor';
 import { _OpenAiMetadataRegistration } from '../llm-providers/openai/register-configuration';
@@ -29,6 +31,8 @@ export { _AnthropicClaudeMetadataRegistration };
 export { _AnthropicClaudeRegistration };
 export { _AzureOpenAiMetadataRegistration };
 export { _AzureOpenAiRegistration };
+export { _DeepseekMetadataRegistration };
+export { _DeepseekRegistration };
 export { _GoogleMetadataRegistration };
 export { _GoogleRegistration };
 export { _OpenAiMetadataRegistration };

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

@@ -0,0 +1,13 @@
+import type { Command as Program } from 'commander';
+/**
+ * Initializes `boilerplate` command for Promptbook CLI utilities
+ *
+ * Note: `$` is used to indicate that this function is not a pure function - it registers a command in the CLI
+ *
+ * @private internal function of `promptbookCli`
+ */
+export declare function $initializeBoilerplateCommand(program: Program): void;
+/**
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ * Note: [🟡] Code in this file should never be published outside of `@promptbook/cli`
+ */

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

@@ -2,10 +2,13 @@ import type { Command as Program } from 'commander';
 /**
  * Initializes `about` command for Promptbook CLI utilities
  *
+ * Note: `$` is used to indicate that this function is not a pure function - it registers a command in the CLI
+ *
  * @private internal function of `promptbookCli`
  */
-export declare function initializeAboutCommand(program: Program): void;
+export declare function $initializeAboutCommand(program: Program): void;
 /**
+ * TODO: !!! Test this in `deno`
  * TODO: [🗽] Unite branding and make single place for it
  * Note: [💞] Ignore a discrepancy between file name and entity name
  * Note: [🟡] Code in this file should never be published outside of `@promptbook/cli`

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

@@ -2,9 +2,11 @@ import type { Command as Program } from 'commander';
 /**
  * Initializes testing `hello` command for Promptbook CLI utilities
  *
+ * Note: `$` is used to indicate that this function is not a pure function - it registers a command in the CLI
+ *
  * @private internal function of `promptbookCli`
  */
-export declare function initializeHelloCommand(program: Program): void;
+export declare function $initializeHelloCommand(program: Program): void;
 /**
  * TODO: [🧠][🐣] Make here some easter egg with generated hello greeting via LLM models
  * Note: [💞] Ignore a discrepancy between file name and entity name

package/esm/typings/src/cli/cli-commands/list-models.d.ts

@@ -2,9 +2,11 @@ import type { Command as Program } from 'commander';
 /**
  * Initializes `list-models` command for Promptbook CLI utilities
  *
+ * Note: `$` is used to indicate that this function is not a pure function - it registers a command in the CLI
+ *
  * @private internal function of `promptbookCli`
  */
-export declare function initializeListModelsCommand(program: Program): void;
+export declare function $initializeListModelsCommand(program: Program): void;
 /**
  * Note: [💞] Ignore a discrepancy between file name and entity name
  * Note: [🟡] Code in this file should never be published outside of `@promptbook/cli`

package/esm/typings/src/cli/cli-commands/list-scrapers.d.ts

@@ -0,0 +1,13 @@
+import type { Command as Program } from 'commander';
+/**
+ * Initializes `list-scrapers` command for Promptbook CLI utilities
+ *
+ * Note: `$` is used to indicate that this function is not a pure function - it registers a command in the CLI
+ *
+ * @private internal function of `promptbookCli`
+ */
+export declare function $initializeListScrapersCommand(program: Program): void;
+/**
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ * Note: [🟡] Code in this file should never be published outside of `@promptbook/cli`
+ */

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

@@ -2,9 +2,11 @@ import type { Command as Program } from 'commander';
 /**
  * Initializes `make` command for Promptbook CLI utilities
  *
+ * Note: `$` is used to indicate that this function is not a pure function - it registers a command in the CLI
+ *
  * @private internal function of `promptbookCli`
  */
-export declare function initializeMakeCommand(program: Program): void;
+export declare function $initializeMakeCommand(program: Program): void;
 /**
  * TODO: [🥃][main] !!3 Allow `ptbk make` without configuring any llm tools
  * TODO: [0] DRY Javascript and typescript - Maybe make ONLY typescript and for javascript just remove types

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

@@ -2,9 +2,11 @@ import type { Command as Program } from 'commander';
 /**
  * Initializes `prettify` command for Promptbook CLI utilities
  *
+ * Note: `$` is used to indicate that this function is not a pure function - it registers a command in the CLI
+ *
  * @private internal function of `promptbookCli`
  */
-export declare function initializePrettifyCommand(program: Program): void;
+export declare function $initializePrettifyCommand(program: Program): void;
 /**
  * TODO: [😶] Unite floder listing
  * Note: [💞] Ignore a discrepancy between file name and entity name

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

@@ -2,9 +2,11 @@ import type { Command as Program } from 'commander';
 /**
  * Initializes `run` command for Promptbook CLI utilities
  *
+ * Note: `$` is used to indicate that this function is not a pure function - it registers a command in the CLI
+ *
  * @private internal function of `promptbookCli`
  */
-export declare function initializeRunCommand(program: Program): void;
+export declare function $initializeRunCommand(program: Program): void;
 /**
  * TODO: !!5 Catch and wrap all errors from CLI
  * TODO: [🧠] Pass `maxExecutionAttempts`, `csvSettings`

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

@@ -1,5 +1,5 @@
-import type { PipelineJson } from '../../pipeline/PipelineJson/PipelineJson';
 import type { PipelineExecutor } from '../../execution/PipelineExecutor';
+import type { PipelineJson } from '../../pipeline/PipelineJson/PipelineJson';
 /**
  * Options for running the interactive chatbot
  */

package/esm/typings/src/cli/cli-commands/start-server.d.ts

@@ -0,0 +1,13 @@
+import type { Command as Program } from 'commander';
+/**
+ * Initializes `start-server` command for Promptbook CLI utilities
+ *
+ * Note: `$` is used to indicate that this function is not a pure function - it registers a command in the CLI
+ *
+ * @private internal function of `promptbookCli`
+ */
+export declare function $initializeStartServerCommand(program: Program): void;
+/**
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ * Note: [🟡] Code in this file should never be published outside of `@promptbook/cli`
+ */

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

@@ -2,9 +2,11 @@ import type { Command as Program } from 'commander';
 /**
  * Initializes `test` command for Promptbook CLI utilities
  *
+ * Note: `$` is used to indicate that this function is not a pure function - it registers a command in the CLI
+ *
  * @private internal function of `promptbookCli`
  */
-export declare function initializeTestCommand(program: Program): void;
+export declare function $initializeTestCommand(program: Program): void;
 /**
  * TODO: [😶] Unite floder listing
  * Note: [💞] Ignore a discrepancy between file name and entity name

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

@@ -65,6 +65,24 @@ export declare const DEFAULT_BOOK_TITLE = "\u2728 Untitled Book";
  * @public exported from `@promptbook/core`
  */
 export declare const DEFAULT_TASK_TITLE = "Task";
+/**
+ * When the title of the prompt task is not provided, the default title is used
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare const DEFAULT_PROMPT_TASK_TITLE = "Prompt";
+/**
+ * When the pipeline is flat and no name of return parameter is provided, this name is used
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare const DEFAULT_BOOK_OUTPUT_PARAMETER_NAME = "result";
+/**
+ * Maximum file size limit
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare const DEFAULT_MAX_FILE_SIZE: number;
 /**
  * Warning message for the generated sections and files files
  *
@@ -166,6 +184,14 @@ export declare const DEFAULT_MAX_KNOWLEDGE_SOURCES_SCRAPING_TOTAL = 200;
  * @public exported from `@promptbook/core`
  */
 export declare const DEFAULT_BOOKS_DIRNAME = "./books";
+/**
+ * Where to store the temporary downloads
+ *
+ * Note: When the folder does not exist, it is created recursively
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare const DEFAULT_DOWNLOAD_CACHE_DIRNAME = "./.promptbook/download-cache";
 /**
  * Where to store the cache of executions for promptbook CLI
  *
@@ -173,7 +199,7 @@ export declare const DEFAULT_BOOKS_DIRNAME = "./books";
  *
  * @public exported from `@promptbook/core`
  */
-export declare const DEFAULT_EXECUTIONS_CACHE_DIRNAME = "./.promptbook/executions-cache";
+export declare const DEFAULT_EXECUTION_CACHE_DIRNAME = "./.promptbook/execution-cache";
 /**
  * Where to store the scrape cache
  *

package/esm/typings/src/conversion/compilePipelineOnRemoteServer.d.ts

@@ -17,5 +17,5 @@ import type { RemoteClientOptions } from '../remote-server/types/RemoteClientOpt
  */
 export declare function compilePipelineOnRemoteServer<TCustomOptions = undefined>(pipelineString: PipelineString, options: RemoteClientOptions<TCustomOptions>): Promise<PipelineJson>;
 /**
- * TODO: !!!! Do not return Promise<PipelineJson> But PreparePipelineTask
+ * TODO: [🐚] Do not return `Promise<PipelineJson>` But `PreparationTask`
  */

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

@@ -0,0 +1,25 @@
+import { ReadonlyDeep } from 'type-fest';
+import type { ErrorJson } from '../errors/utils/ErrorJson';
+/**
+ * @@@
+ *
+ * Note: [🚉] This is fully serializable as JSON
+ */
+export type AbstractTaskResult = {
+    /**
+     * Whether the execution was successful, details are aviable in `executionReport`
+     */
+    readonly isSuccessful: boolean;
+    /**
+     * Errors that occured during the execution, details are aviable in `executionReport`
+     */
+    readonly errors: ReadonlyDeep<ReadonlyArray<ErrorJson>>;
+    /**
+     * Warnings that occured during the execution, details are aviable in `executionReport`
+     */
+    readonly warnings: ReadonlyDeep<ReadonlyArray<ErrorJson>>;
+};
+/**
+ * TODO: [🧠] Should this file be in /execution or /types folder?
+ * TODO: [🧠] Maybe constrain `ErrorJson` -> `ErrorJson & { name: 'PipelineExecutionError' | 'Error' }`
+ */

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

@@ -0,0 +1,71 @@
+import type { Observable } from 'rxjs';
+import { PartialDeep } from 'type-fest';
+import type { string_SCREAMING_CASE } from '../utils/normalization/normalizeTo_SCREAMING_CASE';
+import type { task_id } from '../types/typeAliases';
+import type { AbstractTaskResult } from './AbstractTaskResult';
+import type { PipelineExecutorResult } from './PipelineExecutorResult';
+/**
+ * Options for creating a new task
+ */
+type CreateTaskOptions<TTaskResult extends AbstractTaskResult> = {
+    /**
+     * The type of task to create
+     */
+    readonly taskType: AbstractTask<TTaskResult>['taskType'];
+    /**
+     * Callback that processes the task and updates the ongoing result
+     * @param ongoingResult The partial result of the task processing
+     * @returns The final task result
+     */
+    taskProcessCallback(updateOngoingResult: (newOngoingResult: PartialDeep<TTaskResult>) => void): Promise<TTaskResult>;
+};
+/**
+ * Helper to create a new task
+ *
+ * @private internal helper function
+ */
+export declare function createTask<TTaskResult extends AbstractTaskResult>(options: CreateTaskOptions<TTaskResult>): AbstractTask<TTaskResult>;
+/**
+ * Represents a task that executes a pipeline
+ */
+export type ExecutionTask = AbstractTask<PipelineExecutorResult> & {
+    readonly taskType: 'EXECUTION';
+    readonly taskId: `execution-${task_id}`;
+};
+/**
+ * Represents a task that prepares a pipeline
+ * @deprecated TODO: [🐚] Currently unused - use
+ */
+export type PreparationTask = AbstractTask<PipelineExecutorResult> & {
+    readonly taskType: 'PREPARATION';
+    readonly taskId: `preparation-${task_id}`;
+};
+/**
+ * Base interface for all task types
+ */
+export type AbstractTask<TTaskResult extends AbstractTaskResult> = {
+    /**
+     * Type of the task
+     */
+    readonly taskType: string_SCREAMING_CASE;
+    /**
+     * Unique identifier for the task
+     */
+    readonly taskId: task_id;
+    /**
+     * Gets a promise that resolves with the task result
+     */
+    asPromise(options?: {
+        readonly isCrashedOnError?: boolean;
+    }): Promise<TTaskResult>;
+    /**
+     * Gets an observable stream of partial task results
+     */
+    asObservable(): Observable<PartialDeep<TTaskResult>>;
+};
+export type Task = ExecutionTask | PreparationTask;
+export {};
+/**
+ * TODO: Maybe allow to terminate the task and add getter `isFinished` or `status`
+ * TODO: [🐚] Split into more files and make `PrepareTask` & `RemoteTask` + split the function
+ */

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

@@ -3,7 +3,7 @@ import type fs from 'fs/promises';
 /**
  * Container for all the tools needed to manipulate with filesystem
  */
-export type FilesystemTools = Pick<typeof fs, 'access' | 'constants' | 'readFile' | 'writeFile' | 'stat' | 'readdir'>;
+export type FilesystemTools = Pick<typeof fs, 'access' | 'constants' | 'readFile' | 'writeFile' | 'stat' | 'readdir' | 'mkdir'>;
 /**
  * TODO: Implement destroyable pattern to free resources
  */

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

@@ -1,7 +1,5 @@
-import type { Promisable } from 'type-fest';
-import type { TaskProgress } from '../types/TaskProgress';
 import type { InputParameters } from '../types/typeAliases';
-import type { PipelineExecutorResult } from './PipelineExecutorResult';
+import type { ExecutionTask } from './ExecutionTask';
 /**
  * Executor is a simple async function that takes INPUT  PARAMETERs and returns result parameters _(along with all intermediate parameters and INPUT  PARAMETERs = it extends input object)_.
  * Executor is made by combining execution tools and pipeline collection.
@@ -11,9 +9,8 @@ import type { PipelineExecutorResult } from './PipelineExecutorResult';
  * @see https://github.com/webgptorg/promptbook#executor
  */
 export type PipelineExecutor = {
-    (inputParameters: InputParameters, onProgress?: (taskProgress: TaskProgress) => Promisable<void>): Promise<PipelineExecutorResult>;
+    (inputParameters: InputParameters): ExecutionTask;
 };
 /**
- * TODO: [🐚] Change onProgress to object that represents the running execution, can be subscribed via RxJS to and also awaited
  * TODO: [🧠] Should this file be in /execution or /types folder?
  */

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

@@ -1,7 +1,7 @@
 import { ReadonlyDeep } from 'type-fest';
-import type { ErrorJson } from '../errors/utils/ErrorJson';
 import type { PipelineJson } from '../pipeline/PipelineJson/PipelineJson';
 import type { Parameters } from '../types/typeAliases';
+import type { AbstractTaskResult } from './AbstractTaskResult';
 import type { ExecutionReportJson } from './execution-report/ExecutionReportJson';
 import type { PromptResultUsage } from './PromptResultUsage';
 /**
@@ -9,29 +9,17 @@ import type { PromptResultUsage } from './PromptResultUsage';
  *
  * Note: [🚉] This is fully serializable as JSON
  */
-export type PipelineExecutorResult = {
+export type PipelineExecutorResult = AbstractTaskResult & {
     /**
      * Result parameters of the execution
      *
      * Note: If the execution was not successful, there are only some of the result parameters
      */
     readonly outputParameters: Readonly<Parameters>;
-    /**
-     * Whether the execution was successful, details are aviable in `executionReport`
-     */
-    readonly isSuccessful: boolean;
     /**
      * Added usage of whole execution, detailed usage is aviable in `executionReport`
      */
     readonly usage: ReadonlyDeep<PromptResultUsage>;
-    /**
-     * Errors that occured during the execution, details are aviable in `executionReport`
-     */
-    readonly errors: ReadonlyDeep<ReadonlyArray<ErrorJson>>;
-    /**
-     * Warnings that occured during the execution, details are aviable in `executionReport`
-     */
-    readonly warnings: ReadonlyDeep<ReadonlyArray<ErrorJson>>;
     /**
      * The report of the execution with all details
      */
@@ -46,5 +34,4 @@ export type PipelineExecutorResult = {
 };
 /**
  * TODO: [🧠] Should this file be in /execution or /types folder?
- * TODO: [🧠] Maybe constrain `ErrorJson` -> `ErrorJson & { name: 'PipelineExecutionError' | 'Error' }`
  */

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

@@ -1,5 +1,12 @@
 import type { string_url } from '../types/typeAliases';
 /**
- * Fetch function for fetching data from the internet used in scraping
+ * Fetch function used in Promptbook engine
+ *
+ * In most cases it is just native `fetch` function with a lightweight error handling wrapper
+ * But it can be replaced with any other fetch function, polyfill, custom implementation, security layer, etc.
+ *
+ * It is used in theese places:
+ * - Fetching knowledge sources
+ * - Callbacks from remote server ([👩🏾‍🤝‍🧑🏾] Not yet implemented)
  */
 export type PromptbookFetch = (url: string_url, init?: RequestInit) => Promise<Response>;