@promptbook/wizard 0.111.0-4 → 0.112.0-100

package/esm/src/pipeline/PipelineJson/PersonaJson.d.ts

@@ -0,0 +1,44 @@
+import type { ChatModelRequirements } from '../../types/ModelRequirements';
+import type { number_id } from '../../types/number_id';
+import type { string_name } from '../../types/string_name';
+import type { string_persona_description } from '../../types/string_persona_description';
+/**
+ * Defines a persona in the pipeline
+ *
+ * Note: [🚉] This is fully serializable as JSON
+ *
+ * @see https://github.com/webgptorg/promptbook/discussions/22
+ */
+export type PersonaJson = {
+    /**
+     * Name of the persona
+     * - It must be unique across the pipeline
+     * - It should start uppercase and can contain letters and numbers
+     */
+    readonly name: string_name;
+    /**
+     * Description of persona
+     */
+    readonly description: string_persona_description;
+};
+/**
+ * Defines a persona in the pipeline after it has been prepared
+ *
+ * Note: [🚉] This is fully serializable as JSON
+ *
+ * @see https://github.com/webgptorg/promptbook/discussions/22
+ */
+export type PersonaPreparedJson = PersonaJson & {
+    /**
+     * Models requirements for the persona
+     *
+     * Sorted by relevance, best-fitting models is first
+     *
+     * Note: The model must be CHAT variant to be usable through persona
+     */
+    readonly modelsRequirements: Array<ChatModelRequirements>;
+    /**
+     * List of preparation ids that were used to prepare this persona
+     */
+    readonly preparationIds: ReadonlyArray<number_id>;
+};

package/esm/src/pipeline/PipelineJson/PipelineJson.d.ts

@@ -0,0 +1,110 @@
+import type { string_formfactor_name } from '../../formfactors/_common/string_formfactor_name';
+import type { ModelRequirements } from '../../types/ModelRequirements';
+import type { string_filename, string_relative_filename } from '../../types/string_filename';
+import type { string_markdown_text } from '../../types/string_markdown';
+import type { string_pipeline_url } from '../../types/string_pipeline_url';
+import type { string_semantic_version } from '../../types/string_sha256';
+import type { PipelineString } from '../PipelineString';
+import type { KnowledgePiecePreparedJson } from './KnowledgePieceJson';
+import type { KnowledgeSourceJson, KnowledgeSourcePreparedJson } from './KnowledgeSourceJson';
+import type { ParameterJson } from './ParameterJson';
+import type { PersonaJson, PersonaPreparedJson } from './PersonaJson';
+import type { PreparationJson } from './PreparationJson';
+import type { TaskJson } from './TaskJson';
+/**
+ * Represents a Promptbook pipeline defined in JSON format.
+ * It represents a series of tasks chained together to form a pipeline / one big task with input and result parameters.
+ *
+ * Note: [🚉] This is fully serializable as JSON
+ *
+ * @see The main Promptbook documentation for more details: https://github.com/webgptorg/promptbook#promptbook
+ */
+export type PipelineJson = {
+    /**
+     * Unique identifier of the pipeline
+     *
+     * Note: It must be unique across all pipeline collections
+     * Note: It must use HTTPs URL
+     * Tip: You can do versioning in the URL
+     *      For example: https://promptbook.studio/webgpt/write-website-content-cs.book@1.0.0
+     * Warning: Do not hash part of the URL, hash part is used for identification of the task in the pipeline
+     */
+    readonly pipelineUrl?: string_pipeline_url;
+    /**
+     * Internal helper for tracking the source `.book` file of the pipeline
+     */
+    readonly sourceFile?: string_filename;
+    /**
+     * Title of the promptbook
+     * -It can use simple markdown formatting like **bold**, *italic*, [link](https://example.com), ... BUT not code blocks and structure
+     */
+    readonly title: string_markdown_text;
+    /**
+     * Version of the Book language
+     *
+     * @see https://github.com/webgptorg/book
+     */
+    readonly bookVersion?: string_semantic_version;
+    /**
+     * Description of the promptbook
+     * It can use multiple paragraphs of simple markdown formatting like **bold**, *italic*, [link](https://example.com), ... BUT not code blocks and structure
+     */
+    readonly description?: string_markdown_text;
+    /**
+     * Name of the formfactor that the pipeline is shaped for
+     */
+    readonly formfactorName: string_formfactor_name;
+    /**
+     * Set of variables that are used across the pipeline
+     */
+    readonly parameters: Array<ParameterJson>;
+    /**
+     * Default model requirements for the model for all `tasks`
+     */
+    readonly defaultModelRequirements?: Partial<ModelRequirements>;
+    /**
+     * Sequence of tasks that are chained together to form a pipeline
+     */
+    readonly tasks: Array<TaskJson>;
+    /**
+     * Set of information that are used as external knowledge in the pipeline
+     *
+     * @see https://github.com/webgptorg/promptbook/discussions/41
+     */
+    readonly knowledgeSources: Array<KnowledgeSourceJson | KnowledgeSourcePreparedJson>;
+    /**
+     * Set of information that are used as external knowledge in the pipeline
+     *
+     * @see https://github.com/webgptorg/promptbook/discussions/41
+     */
+    readonly knowledgePieces: Array<KnowledgePiecePreparedJson>;
+    /**
+     * List of prepared virtual personas that are used in the pipeline
+     *
+     * @see https://github.com/webgptorg/promptbook/discussions/22
+     */
+    readonly personas: Array<PersonaJson | PersonaPreparedJson>;
+    /**
+     * List of prepared virtual personas that are used in the pipeline
+     *
+     * @see https://github.com/webgptorg/promptbook/discussions/78
+     */
+    readonly preparations: Array<PreparationJson>;
+    /**
+     * Backup of the original book source
+     */
+    readonly sources: ReadonlyArray<{
+        type: 'BOOK';
+        path: string_relative_filename | null;
+        content: PipelineString;
+    }>;
+};
+/**
+ * TODO: [🌪] Make type for deprecated pipelines
+ * TODO: [🛳] Default PERSONA for the pipeline `defaultPersonaName` (same as `defaultModelRequirements`)
+ * TODO: [🍙] Make some standard order of json properties
+ * TODO: [🧠] Maybe wrap all {parameterNames} in brackets for example { "resultingParameterName": "{foo}" }
+ * Note: [💼] There was a proposal for multiple types of promptbook objects 78816ff33e2705ee1a187aa2eb8affd976d4ea1a
+ *       But then immediately reverted back to the single type
+ *       With knowledge as part of the promptbook and collection just as a collection of promptbooks
+ */

package/esm/src/pipeline/PipelineJson/PreparationJson.d.ts

@@ -0,0 +1,20 @@
+import type { Usage } from '../../execution/Usage';
+import type { number_id } from '../../types/number_id';
+import type { string_promptbook_version } from '../../version';
+/**
+ * JSON shape for preparation.
+ */
+export type PreparationJson = {
+    /**
+     * Incremental ID of the preparation
+     */
+    readonly id: number_id;
+    /**
+     * Version of the promptbook used for the preparation
+     */
+    readonly promptbookVersion: string_promptbook_version;
+    /**
+     * Usage of the prompt execution
+     */
+    readonly usage: Usage;
+};

package/esm/src/pipeline/PipelineJson/PromptTaskJson.d.ts

@@ -0,0 +1,26 @@
+import type { ModelRequirements } from '../../types/ModelRequirements';
+import type { string_name } from '../../types/string_name';
+import type { CommonTaskJson } from './CommonTaskJson';
+/**
+ * Task for prompt to LLM
+ *
+ * Note: [🚉] This is fully serializable as JSON
+ */
+export type PromptTaskJson = CommonTaskJson & {
+    readonly taskType: 'PROMPT_TASK';
+    /**
+     * Name of the persona who will be responding to this prompt
+     */
+    readonly personaName?: string_name;
+    /**
+     * Requirements for the model
+     * - This is required only for taskType PROMPT_TASK
+     */
+    readonly modelRequirements?: Partial<ModelRequirements>;
+};
+/**
+ * TODO: [👙][🧠] Maybe add `knowledge`, `actions` and `instruments` to be available granularly for each task
+ *       @see https://github.com/webgptorg/promptbook/discussions/79
+ * TODO: [💕][🧠] Just selecting gpt3 or gpt4 level of model
+ * TODO: [🍙] Make some standard order of json properties
+ */

package/esm/src/pipeline/PipelineJson/ScriptTaskJson.d.ts

@@ -0,0 +1,17 @@
+import type { ScriptLanguage } from '../../types/ScriptLanguage';
+import type { CommonTaskJson } from './CommonTaskJson';
+/**
+ * Task for script execution
+ *
+ * Note: [🚉] This is fully serializable as JSON
+ *
+ * @see https://github.com/webgptorg/promptbook/discussions/77
+ */
+export type ScriptTaskJson = CommonTaskJson & {
+    readonly taskType: 'SCRIPT_TASK';
+    /**
+     * Language of the script
+     * - This is required only for taskType SCRIPT
+     */
+    readonly contentLanguage?: ScriptLanguage;
+};

package/esm/src/pipeline/PipelineJson/SimpleTaskJson.d.ts

@@ -0,0 +1,11 @@
+import type { CommonTaskJson } from './CommonTaskJson';
+/**
+ * Task for simple concatenation of strings
+ *
+ * Note: [🚉] This is fully serializable as JSON
+ *
+ * @see https://github.com/webgptorg/promptbook/discussions/17
+ */
+export type SimpleTaskJson = CommonTaskJson & {
+    readonly taskType: 'SIMPLE_TASK';
+};

package/esm/src/pipeline/book-notation.d.ts

@@ -0,0 +1,17 @@
+import type { string_book } from '../book-2.0/agent-source/string_book';
+import type { PipelineString } from './PipelineString';
+/**
+ * Tag function for notating a pipeline with a book\`...\ notation as template literal
+ *
+ * Note: There are 3 similar functions:
+ * 1) `prompt` for notating single prompt exported from `@promptbook/utils`
+ * 2) `promptTemplate` alias for `prompt`
+ * 3) `book` for notating and validating entire books exported from `@promptbook/utils`
+ *
+ * @param strings The static string parts of the template literal
+ * @param values The dynamic values embedded within the template literal used as data
+ * @returns the pipeline string
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare function book(strings: TemplateStringsArray, ...values: Array<string>): string_book & PipelineString;

package/esm/src/pipeline/isValidPipelineString.d.ts

@@ -0,0 +1,11 @@
+import type { PipelineString } from './PipelineString';
+/**
+ * Function `isValidPipelineString` will validate the if the string is a valid pipeline string
+ * It does not check if the string is fully logically correct, but if it is a string that can be a pipeline string or the string looks completely different.
+ *
+ * @param {string} pipelineString the candidate for a pipeline string
+ * @returns {boolean} if the string is a valid pipeline string
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare function isValidPipelineString(pipelineString: string): pipelineString is PipelineString;

package/esm/src/pipeline/prompt-notation/helpers/ParameterEscaping.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Normalizes a JSON string so it can be safely rendered without double escaping.
+ *
+ * @param value Candidate JSON string.
+ *
+ * @private function of ParameterEscaping
+ */
+declare function normalizeJsonString(value: string): string | null;
+/**
+ * Hides brackets in a string to avoid confusion with template parameters.
+ *
+ * @param value Input string with literal brackets.
+ *
+ * @private function of ParameterEscaping
+ */
+declare function hideBrackets(value: string): string;
+/**
+ * Restores hidden brackets.
+ *
+ * @param value String with hidden brackets.
+ *
+ * @private function of ParameterEscaping
+ */
+declare function restoreBrackets(value: string): string;
+/**
+ * Decides whether a parameter can be inlined safely.
+ *
+ * @param value Parameter rendered as string.
+ *
+ * @private function of ParameterEscaping
+ */
+declare function shouldInlineParameterValue(value: string): boolean;
+/**
+ * Escapes prompt parameter content to avoid breaking the template structure.
+ *
+ * @param value Parameter value to escape.
+ * @param options Escape options for additional characters.
+ *
+ * @private function of ParameterEscaping
+ */
+declare function escapePromptParameterValue(value: string, options: {
+    includeBraces: boolean;
+}): string;
+/**
+ * Collection of utilities that keep prompt parameters safe during interpolation.
+ *
+ * @private helper of prompt notation
+ */
+export declare const ParameterEscaping: {
+    normalizeJsonString: typeof normalizeJsonString;
+    hideBrackets: typeof hideBrackets;
+    restoreBrackets: typeof restoreBrackets;
+    shouldInlineParameterValue: typeof shouldInlineParameterValue;
+    escapePromptParameterValue: typeof escapePromptParameterValue;
+};
+export {};

package/esm/src/pipeline/prompt-notation/helpers/ParameterNaming.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Builds placeholder names while avoiding collisions with parameter content.
+ *
+ * @param values Parameter values to scan for conflicting tokens.
+ *
+ * @private function of ParameterNaming
+ */
+declare function buildParameterNames(values: string[]): string[];
+/**
+ * Provides naming utilities for prompt parameters.
+ *
+ * @private helper of prompt notation
+ */
+export declare const ParameterNaming: {
+    buildParameterNames: typeof buildParameterNames;
+};
+export {};

package/esm/src/pipeline/prompt-notation/helpers/ParameterSection.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Represents a structured parameter entry.
+ *
+ * @private type of ParameterSection
+ */
+type StructuredParameterEntry = {
+    name: string;
+    value: string;
+    jsonValue: string | null;
+};
+/**
+ * Formats the placeholder used in the prompt body for a parameter.
+ *
+ * @param name Parameter placeholder name.
+ *
+ * @private function of ParameterSection
+ */
+declare function formatParameterPlaceholder(name: string): string;
+/**
+ * Builds the structured parameters section appended to the prompt.
+ *
+ * @param items Parameter entries to include.
+ *
+ * @private function of ParameterSection
+ */
+declare function buildParametersSection(items: StructuredParameterEntry[]): string;
+/**
+ * Provides helpers for rendering structured parameter placeholders.
+ *
+ * @private helper of prompt notation
+ */
+export declare const ParameterSection: {
+    formatParameterPlaceholder: typeof formatParameterPlaceholder;
+    buildParametersSection: typeof buildParametersSection;
+};
+export {};

package/esm/src/pipeline/prompt-notation.d.ts

@@ -0,0 +1,53 @@
+import type { string_prompt } from '../types/string_prompt';
+import type { really_unknown } from '../utils/organization/really_unknown';
+/**
+ * Prompt string wrapper to retain prompt context across interpolations.
+ *
+ * @public exported from `@promptbook/utils`
+ */
+export declare class PromptString extends String {
+    /**
+     * @param value Prompt content.
+     */
+    constructor(value: string_prompt);
+    /**
+     * Returns the prompt as a primitive string.
+     */
+    toString(): string_prompt;
+    /**
+     * Returns the prompt as a primitive string for implicit coercion.
+     */
+    valueOf(): string_prompt;
+    /**
+     * Ensures template literal coercion returns the raw string.
+     */
+    [Symbol.toPrimitive](): string_prompt;
+}
+/**
+ * Tag function for notating a prompt as template literal
+ *
+ * Note: There are 3 similar functions:
+ * 1) `prompt` for notating single prompt exported from `@promptbook/utils`
+ * 2) `promptTemplate` alias for `prompt`
+ * 3) `book` for notating and validating entire books exported from `@promptbook/utils`
+ *
+ * @param strings
+ * @param values
+ * @returns prompt content wrapped as a PromptString
+ *
+ * @public exported from `@promptbook/utils`
+ */
+export declare function prompt(strings: TemplateStringsArray, ...values: Array<really_unknown>): PromptString;
+/**
+ * Tag function for notating a prompt as template literal
+ *
+ * Note: There are 3 similar functions:
+ * 1) `prompt` for notating single prompt exported from `@promptbook/utils`
+ * 2) `promptTemplate` alias for `prompt`
+ * 3) `book` for notating and validating entire books exported from `@promptbook/utils`
+ *
+ * @alias prompt
+ *
+ * @public exported from `@promptbook/utils`
+ */
+export declare const promptTemplate: typeof prompt;

package/esm/src/pipeline/validatePipelineString.d.ts

@@ -0,0 +1,14 @@
+import type { PipelineString } from './PipelineString';
+/**
+ * Function `validatePipelineString` will validate the if the string is a valid pipeline string
+ * It does not check if the string is fully logically correct, but if it is a string that can be a pipeline string or the string looks completely different.
+ *
+ * Note: [🔂] This function is idempotent.
+ *
+ * @param {string} pipelineString the candidate for a pipeline string
+ * @returns {PipelineString} the same string as input, but validated as valid
+ * @throws {ParseError} if the string is not a valid pipeline string
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare function validatePipelineString(pipelineString: string): PipelineString;

package/esm/src/playground/permanent/_boilerplate.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env ts-node
+export {};

package/esm/src/playground/permanent/agent-with-browser-playground.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env ts-node
+export {};

package/esm/src/playground/permanent/error-handling-playground.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env ts-node
+export {};

package/esm/src/playground/playground.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env ts-node
+export {};
+/** Note: [⚫] Code for archived playground [_playground-boilerplate.ts](src/playground/backup/_playground-boilerplate.ts.txt) should never be published in any package */

package/esm/src/postprocessing/utils/extractBlock.d.ts

@@ -0,0 +1,17 @@
+import type { string_markdown } from '../../types/string_markdown';
+/**
+ * Extracts code block from markdown.
+ *
+ * - When there are multiple or no code blocks the function throws a `ParseError`
+ *
+ * Note: There are multiple similar function:
+ * - `extractBlock` just extracts the content of the code block which is also used as build-in function for postprocessing
+ * - `extractJsonBlock` extracts exactly one valid JSON code block
+ * - `extractOneBlockFromMarkdown` extracts exactly one code block with language of the code block
+ * - `extractAllBlocksFromMarkdown` extracts all code blocks with language of the code block
+ *
+ * @throws {ParseError} if there is not exactly one code block in the markdown
+ *
+ * @public exported from `@promptbook/markdown-utils`
+ */
+export declare function extractBlock(markdown: string_markdown): string;

package/esm/src/postprocessing/utils/extractJsonBlock.d.ts

@@ -0,0 +1,21 @@
+import type { string_json, string_markdown } from '../../types/string_markdown';
+import type { really_unknown } from '../../utils/organization/really_unknown';
+/**
+ * Extracts  extracts exactly one valid JSON code block
+ *
+ * - When given string is a valid JSON as it is, it just returns it
+ * - When there is no JSON code block the function throws a `ParseError`
+ * - When there are multiple JSON code blocks the function throws a `ParseError`
+ *
+ * Note: It is not important if marked as ```json BUT if it is VALID JSON
+ * Note: There are multiple similar function:
+ * - `extractBlock` just extracts the content of the code block which is also used as build-in function for postprocessing
+ * - `extractJsonBlock` extracts exactly one valid JSON code block
+ * - `extractOneBlockFromMarkdown` extracts exactly one code block with language of the code block
+ * - `extractAllBlocksFromMarkdown` extracts all code blocks with language of the code block
+ *
+ * @throws {ParseError} if there is no valid JSON block in the markdown
+ *
+ * @public exported from `@promptbook/markdown-utils`
+ */
+export declare function extractJsonBlock(markdown: string_markdown): string_json<really_unknown>;

package/esm/src/prepare/PrepareAndScrapeOptions.d.ts

@@ -0,0 +1,48 @@
+import type { IntermediateFilesStrategy } from '../types/IntermediateFilesStrategy';
+import type { string_dirname } from '../types/string_filename';
+/**
+ * Options for preparation of the pipeline
+ */
+export type PrepareAndScrapeOptions = {
+    /**
+     * Path to the root folder of the pipeline
+     *
+     * Note: When the pipeline is not created from files, it is `null`
+     * Note: This folder must exist (=it is not created recursively)
+     *
+     * @default null or `process.cwd()` when created via `$provide...` function in node
+     */
+    readonly rootDirname?: string_dirname | null;
+    /**
+     * Path to the cache folder
+     *
+     * Note: When the folder does not exist, it is created recursively
+     *
+     * @default DEFAULT_SCRAPE_CACHE_DIRNAME
+     */
+    readonly cacheDirname?: string_dirname;
+    /**
+     * Strategy for caching the intermediate results for knowledge source
+     *
+     * @default DEFAULT_INTERMEDIATE_FILES_STRATEGY
+     */
+    readonly intermediateFilesStrategy?: IntermediateFilesStrategy;
+    /**
+     * Maximum number of tasks running in parallel
+     *
+     * @default DEFAULT_MAX_PARALLEL_COUNT
+     */
+    readonly maxParallelCount?: number;
+    /**
+     * If true, the missing software is automatically installed
+     *
+     * @default DEFAULT_IS_AUTO_INSTALLED
+     */
+    readonly isAutoInstalled?: boolean;
+    /**
+     * If true, the preparation logs additional information
+     *
+     * @default DEFAULT_IS_VERBOSE
+     */
+    readonly isVerbose?: boolean;
+};

package/esm/src/prepare/preparePipeline.d.ts

@@ -0,0 +1,23 @@
+import type { ExecutionTools } from '../execution/ExecutionTools';
+import type { PipelineJson } from '../pipeline/PipelineJson/PipelineJson';
+import type { PrepareAndScrapeOptions } from './PrepareAndScrapeOptions';
+/**
+ * Prepare pipeline locally
+ *
+ * Note: This function does not validate logic of the pipeline
+ * Note: This function acts as part of compilation process
+ * Note: When the pipeline is already prepared, it returns the same pipeline
+ *
+ * @see https://github.com/webgptorg/promptbook/discussions/196
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare function preparePipeline(pipeline: PipelineJson, tools: Pick<ExecutionTools, 'llm' | 'fs' | 'scrapers'>, options: PrepareAndScrapeOptions): Promise<PipelineJson>;
+/**
+ * TODO: Write tests for `preparePipeline` and `preparePipelineOnRemoteServer`
+ * TODO: [🏏] Leverage the batch API and build queues @see https://platform.openai.com/docs/guides/batch
+ * TODO: [🧊] In future one preparation can take data from previous preparation and save tokens and time
+ * TODO: [🛠] Actions, instruments (and maybe knowledge) => Functions and tools
+ * TODO: [🧠][♏] Maybe if expecting JSON (In Anthropic Claude and other models without non-json) and its not specified in prompt content, append the instructions
+ *       @see https://docs.anthropic.com/en/docs/test-and-evaluate/strengthen-guardrails/increase-consistency#specify-the-desired-output-format
+ */

package/esm/src/prepare/preparePipelineOnRemoteServer.d.ts

@@ -0,0 +1,14 @@
+import type { PipelineJson } from '../pipeline/PipelineJson/PipelineJson';
+import type { RemoteClientOptions } from '../remote-server/types/RemoteClientOptions';
+/**
+ * Prepare pipeline on remote server
+ *
+ * Note: This function does not validate logic of the pipeline
+ * Note: This function acts as part of compilation process
+ * Note: When the pipeline is already prepared, it returns the same pipeline
+ *
+ * @see https://github.com/webgptorg/promptbook/discussions/196
+ *
+ * @public exported from `@promptbook/remote-client`
+ */
+export declare function preparePipelineOnRemoteServer<TCustomOptions = undefined>(pipeline: PipelineJson, options: RemoteClientOptions<TCustomOptions>): Promise<PipelineJson>;

package/esm/src/prepare/prepareTasks.d.ts

@@ -0,0 +1,32 @@
+import type { ExecutionTools } from '../execution/ExecutionTools';
+import type { PipelineJson } from '../pipeline/PipelineJson/PipelineJson';
+import type { TaskJson } from '../pipeline/PipelineJson/TaskJson';
+import type { PrepareAndScrapeOptions } from './PrepareAndScrapeOptions';
+/**
+ * Type describing prepare task input.
+ */
+type PrepareTaskInput = Pick<PipelineJson, 'tasks' | 'parameters'> & {
+    /**
+     * The number of knowledge pieces available for the pipeline.
+     */
+    readonly knowledgePiecesCount: number;
+};
+/**
+ * Type describing prepared tasks.
+ */
+type PreparedTasks = {
+    /**
+     * The sequence of tasks after preparation.
+     */
+    readonly tasksPrepared: ReadonlyArray<TaskJson>;
+};
+/**
+ * Prepares tasks by adding knowledge to the prompt and ensuring all necessary parameters are included.
+ *
+ * @param tasks Sequence of tasks that are chained together to form a pipeline
+ * @returns A promise that resolves to the prepared tasks.
+ *
+ * @private internal utility of `preparePipeline`
+ */
+export declare function prepareTasks(pipeline: PrepareTaskInput, tools: Pick<ExecutionTools, 'llm' | 'fs' | 'scrapers'>, options: PrepareAndScrapeOptions): Promise<PreparedTasks>;
+export {};

package/esm/src/prepare/unpreparePipeline.d.ts

@@ -0,0 +1,9 @@
+import type { PipelineJson } from '../pipeline/PipelineJson/PipelineJson';
+/**
+ * Unprepare just strips the preparation data of the pipeline
+ *
+ * @deprecated In future version this function will be removed or deprecated
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare function unpreparePipeline(pipeline: PipelineJson): PipelineJson;

package/esm/src/remote-server/RemoteServer.d.ts

@@ -0,0 +1,26 @@
+/// <reference types="node" />
+import type { IDestroyable } from 'destroyable';
+import express from 'express';
+import http from 'http';
+import { DefaultEventsMap, Server } from 'socket.io';
+import type { TODO_any } from '../utils/organization/TODO_any';
+import type { TODO_narrow } from '../utils/organization/TODO_narrow';
+/**
+ * Type describing remote server.
+ */
+export type RemoteServer = IDestroyable & {
+    /**
+     * HTTP server instance
+     */
+    readonly httpServer: http.Server<TODO_any>;
+    /**
+     * Express application instance
+     *
+     * Note: This is useful for adding custom routes
+     */
+    readonly expressApp: express.Express;
+    /**
+     * Socket.io server instance
+     */
+    readonly socketIoServer: Server<TODO_narrow<DefaultEventsMap>, TODO_narrow<DefaultEventsMap>, TODO_narrow<DefaultEventsMap>, TODO_any>;
+};