@promptbook/color 0.100.0-48

package/esm/typings/src/book-components/Chat/utils/ExportFormat.d.ts

@@ -0,0 +1,4 @@
+/**
+ * @private utility of `<Chat/>` component
+ */
+export type ExportFormat = 'pdf' | 'txt' | 'md' | 'html' | 'json';

package/esm/typings/src/book-components/Chat/utils/addUtmParamsToUrl.d.ts

@@ -0,0 +1,7 @@
+import type { ExportFormat } from './ExportFormat';
+/**
+ * Utility: add UTM parameters to a URL for tracking
+ *
+ * @private utility of `<Chat/>` component
+ */
+export declare function addUtmParamsToUrl(baseUrl: string, format: ExportFormat): string;

package/esm/typings/src/book-components/Chat/utils/createShortLinkForChat.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Create a short link for chat sharing.
+ * Simplified version without Supabase dependency.
+ *
+ * @private utility of `<Chat/>` component
+ */
+export declare function createShortLinkForChat(utmUrl: string): Promise<string>;

package/esm/typings/src/book-components/Chat/utils/downloadFile.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Downloads a file with the given content and filename
+ *
+ * @private utility of `<Chat/>` component
+ */
+export declare function downloadFile(content: string, filename: string, mimeType: string): void;

package/esm/typings/src/book-components/Chat/utils/exportChatHistory.d.ts

@@ -0,0 +1,9 @@
+import type { ChatMessage } from '../interfaces/ChatMessage';
+import type { ChatParticipant } from '../interfaces/ChatParticipant';
+import type { ExportFormat } from './ExportFormat';
+/**
+ * Exports chat messages in the specified format
+ *
+ * @private utility of `<Chat/>` component
+ */
+export declare function exportChatHistory(messages: ChatMessage[], format: ExportFormat, headerMarkdown?: string, participants?: ReadonlyArray<ChatParticipant>): Promise<void>;

package/esm/typings/src/book-components/Chat/utils/generatePdfContent.d.ts

@@ -0,0 +1,8 @@
+import type { ChatMessage } from '../interfaces/ChatMessage';
+import type { ChatParticipant } from '../interfaces/ChatParticipant';
+/**
+ * Generates PDF content using HTML and triggers print dialog
+ *
+ * @private utility of `<Chat/>` component
+ */
+export declare function generatePdfContent(messages: ChatMessage[], shareUrl: string, qrDataUrl?: string | null, headerMarkdown?: string, participants?: ReadonlyArray<ChatParticipant>): void;

package/esm/typings/src/book-components/Chat/utils/generateQrDataUrl.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Utility: generate a QR code data URL for a given text
+ * Simplified version without QR code library dependency
+ *
+ * @private utility of `<Chat/>` component
+ */
+export declare function generateQrDataUrl(text: string): Promise<string | null>;

package/esm/typings/src/book-components/Chat/utils/getPromptbookBranding.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Generates Promptbook branding header for exported files
+ *
+ * @private utility of `<Chat/>` component
+ */
+export declare function getPromptbookBranding(shareUrl: string): string;

package/esm/typings/src/book-components/Chat/utils/messagesToHtml.d.ts

@@ -0,0 +1,8 @@
+import type { ChatMessage } from '../interfaces/ChatMessage';
+import type { ChatParticipant } from '../interfaces/ChatParticipant';
+/**
+ * Converts chat messages to HTML format
+ *
+ * @private utility of `<Chat/>` component
+ */
+export declare function messagesToHtml(messages: ChatMessage[], shareUrl: string, qrDataUrl?: string | null, headerMarkdown?: string, participants?: ReadonlyArray<ChatParticipant>): string;

package/esm/typings/src/book-components/Chat/utils/messagesToJson.d.ts

@@ -0,0 +1,7 @@
+import type { ChatMessage } from '../interfaces/ChatMessage';
+/**
+ * Converts chat messages to JSON format
+ *
+ * @private utility of `<Chat/>` component
+ */
+export declare function messagesToJson(messages: ChatMessage[], shareUrl: string): string;

package/esm/typings/src/book-components/Chat/utils/messagesToMarkdown.d.ts

@@ -0,0 +1,8 @@
+import type { ChatMessage } from '../interfaces/ChatMessage';
+import type { ChatParticipant } from '../interfaces/ChatParticipant';
+/**
+ * Converts chat messages to Markdown format
+ *
+ * @private utility of `<Chat/>` component
+ */
+export declare function messagesToMarkdown(messages: ChatMessage[], shareUrl: string, qrDataUrl?: string | null, headerMarkdown?: string, participants?: ReadonlyArray<ChatParticipant>): string;

package/esm/typings/src/book-components/Chat/utils/messagesToText.d.ts

@@ -0,0 +1,8 @@
+import type { ChatMessage } from '../interfaces/ChatMessage';
+import type { ChatParticipant } from '../interfaces/ChatParticipant';
+/**
+ * Converts chat messages to plain text format
+ *
+ * @private utility of `<Chat/>` component
+ */
+export declare function messagesToText(messages: ChatMessage[], shareUrl: string, headerMarkdown?: string, participants?: ReadonlyArray<ChatParticipant>): string;

package/esm/typings/src/book-components/_common/react-utils/classNames.d.ts

@@ -0,0 +1,7 @@
+import type { string_css_class } from '../../../types/typeAliases';
+/**
+ * Utility function for joining multiple truthy class names into one string
+ *
+ * @private within the `@promptbook/components`
+ */
+export declare function classNames(...classes: Array<string_css_class | undefined | false | null>): string_css_class;

package/esm/typings/src/book-components/_common/react-utils/collectCssTextsForClass.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Collect matching CSS texts from document stylesheets for a given class.
+ * This will skip cross-origin stylesheets (they throw when accessed).
+ *
+ * @private within the promptbook components <- TODO: Maybe make promptbook util from this
+ */
+export declare function collectCssTextsForClass(className: string): string[];

package/esm/typings/src/book-components/_common/react-utils/escapeHtml.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Escape HTML to safely render user text inside a <pre> with dangerouslySetInnerHTML.
+ *
+ * @private within the promptbook components <- TODO: Maybe make promptbook util from this
+ */
+export declare function escapeHtml(input: string): string;

package/esm/typings/src/book-components/_common/react-utils/escapeRegex.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Escape text for safe use inside a RegExp pattern.
+ *
+ * @private within the promptbook components <- TODO: Maybe make promptbook util from this
+ */
+export declare function escapeRegex(input: string): string;

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

@@ -0,0 +1,14 @@
+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;
+/**
+ * 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/common/handleActionErrors.d.ts

@@ -0,0 +1,11 @@
+import type { Command as Program } from 'commander';
+type actionCallbackFunction = Parameters<Program['action']>[0];
+/**
+ * Wraps action to handle error console logging and exit process with error code
+ *
+ * @param action Action to be wrapped in error handling
+ * @returns Wrapped action
+ * @private internal helper function for CLI commands
+ */
+export declare function handleActionErrors(action: actionCallbackFunction): actionCallbackFunction;
+export {};

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

@@ -0,0 +1,14 @@
+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;
+/**
+ * TODO: [🧠][🐣] Make here some easter egg with generated hello greeting via LLM models
+ * 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-models.d.ts

@@ -0,0 +1,13 @@
+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;
+/**
+ * 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/login.d.ts

@@ -0,0 +1,14 @@
+import type { Command as Program } from 'commander';
+/**
+ * Initializes `login` 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 $initializeLoginCommand(program: Program): void;
+/**
+ * TODO: Implement non-interactive login
+ * 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

@@ -0,0 +1,16 @@
+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;
+/**
+ * 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
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ * 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

@@ -0,0 +1,15 @@
+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;
+/**
+ * TODO: [😶] Unite folder listing
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ * 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/run.d.ts

@@ -0,0 +1,17 @@
+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;
+/**
+ * TODO: !!5 Catch and wrap all errors from CLI
+ * TODO: [🧠] Pass `maxExecutionAttempts`, `csvSettings`
+ * TODO: [🥃][main] !!3 Allow `ptbk run` without configuring any llm tools
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ * 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/runInteractiveChatbot.d.ts

@@ -0,0 +1,32 @@
+import type { PipelineExecutor } from '../../execution/PipelineExecutor';
+import type { PipelineJson } from '../../pipeline/PipelineJson/PipelineJson';
+/**
+ * Options for running the interactive chatbot
+ */
+type RunInteractiveChatbotOptions = {
+    /**
+     * Prepared pipeline to run
+     */
+    pipeline: PipelineJson;
+    /**
+     * Prepared pipeline executor
+     */
+    pipelineExecutor: PipelineExecutor;
+    /**
+     * Whether to show verbose output
+     */
+    isVerbose: boolean;
+};
+/**
+ * Run the interactive chatbot in CLI
+ *
+ * @returns Never-ending promise or process exit
+ * @private internal function of `promptbookCli` and `initializeRunCommand`
+ */
+export declare function runInteractiveChatbot(options: RunInteractiveChatbotOptions): Promise<void | never>;
+export {};
+/**
+ * TODO: Saving reports from the chatbot conversation
+ * TODO: [⛲️] This is the right place to start implementing INK
+ * Note: [🟡] Code in this file should never be published outside of `@promptbook/cli`
+ */

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

@@ -0,0 +1,16 @@
+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;
+/**
+ * TODO: [😶] Unite folder listing
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ * 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/common/$addGlobalOptionsToCommand.d.ts

@@ -0,0 +1,7 @@
+import { Command } from 'commander';
+/**
+ * Note: `$` is used to indicate that this function is not a pure function - it registers an option in the CLI
+ *
+ * @private utility of CLI
+ */
+export declare function $addGlobalOptionsToCommand(command: Command): void;

package/esm/typings/src/cli/common/$provideLlmToolsForCli.d.ts

@@ -0,0 +1,28 @@
+import type { CacheLlmToolsOptions } from '../../llm-providers/_common/utils/cache/CacheLlmToolsOptions';
+import type { LlmExecutionToolsWithTotalUsage } from '../../llm-providers/_common/utils/count-total-usage/LlmExecutionToolsWithTotalUsage';
+import type { string_promptbook_server_url } from '../../types/typeAliases';
+type ProvideLlmToolsForCliOptions = Pick<CacheLlmToolsOptions, 'isCacheReloaded'> & {
+    /**
+     * If true, user will be always prompted for login
+     *
+     * Note: This is used in `ptbk login` command
+     */
+    isLoginloaded?: true;
+    /**
+     * CLI options
+     */
+    cliOptions: {
+        verbose: boolean;
+        interactive: boolean;
+        provider: 'BYOK' | 'BRING_YOUR_OWN_KEYS' | 'REMOTE_SERVER' | 'RS' | string;
+        remoteServerUrl: string_promptbook_server_url;
+    };
+};
+/**
+ * @private utility of CLI
+ */
+export declare function $provideLlmToolsForCli(options: ProvideLlmToolsForCliOptions): Promise<{
+    strategy: 'BRING_YOUR_OWN_KEYS' | 'REMOTE_SERVER';
+    llm: LlmExecutionToolsWithTotalUsage;
+}>;
+export {};

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

@@ -0,0 +1,16 @@
+import { promptbookCli } from './promptbookCli';
+/**
+ * Note: [🔺] Purpose of this file is to export CLI for production environment
+ */
+/**
+ * Hidden utilities which should not be used by external consumers.
+ *
+ * @public exported from `@promptbook/cli`
+ */
+export declare const _CLI: {
+    _initialize_promptbookCli: typeof promptbookCli;
+};
+/**
+ * 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/promptbookCli.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Runs CLI utilities of Promptbook package
+ *
+ * @private within the `@promptbook/cli`
+ */
+export declare function promptbookCli(): Promise<void>;
+/**
+ * TODO: [🧠] Maybe `run` command the default, instead of `ptbk run ./foo.book` -> `ptbk ./foo.book`
+ * TODO: [🥠] Do not export, its just for CLI script
+ * TODO: [🕌] When more functionalities, rename
+ * Note: 11:11
+ * Note: [🟡] Code in this file should never be published outside of `@promptbook/cli`
+ */

package/esm/typings/src/cli/test/ptbk.d.ts

@@ -0,0 +1,5 @@
+#!/usr/bin/env ts-node
+/**
+ * Note: [🔺] Purpose of this file is to test and use the current CLI in development environment
+ */
+import '../../_packages/cli.index';

package/esm/typings/src/cli/test/ptbk.test.d.ts

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

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

@@ -0,0 +1,25 @@
+import type { Promisable } from 'type-fest';
+import type { PipelineJson } from '../pipeline/PipelineJson/PipelineJson';
+import type { Prompt } from '../types/Prompt';
+import type { string_pipeline_url } from '../types/typeAliases';
+/**
+ * Collection that groups together pipelines, knowledge, personas, tools and actions
+ */
+export type PipelineCollection = {
+    /**
+     * Gets all pipelines in the collection
+     */
+    listPipelines(): Promisable<ReadonlyArray<string_pipeline_url>>;
+    /**
+     * Gets pipeline by its URL
+     *
+     * Note: This is not a direct fetching from the URL, but a lookup in the collection
+     */
+    getPipelineByUrl(url: string_pipeline_url): Promisable<PipelineJson>;
+    /**
+     * Checks whether given prompt was defined in any pipeline in the collection
+     *
+     * @deprecated Make better mechanism for skimming the remote server
+     */
+    isResponsibleForPrompt(prompt: Prompt): Promisable<boolean>;
+};

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

@@ -0,0 +1,37 @@
+import type { PipelineJson } from '../pipeline/PipelineJson/PipelineJson';
+import type { Prompt } from '../types/Prompt';
+import type { string_pipeline_url } from '../types/typeAliases';
+import type { PipelineCollection } from './PipelineCollection';
+/**
+ * Library of pipelines that groups together pipelines for an application.
+ * This implementation is a very thin wrapper around the Array / Map of pipelines.
+ *
+ * @private internal function of `createCollectionFromJson`, use `createCollectionFromJson` instead
+ * @see https://github.com/webgptorg/pipeline#pipeline-collection
+ */
+export declare class SimplePipelineCollection implements PipelineCollection {
+    private collection;
+    /**
+     * Constructs a pipeline collection from pipelines
+     *
+     * @param pipelines Array of pipeline JSON objects to include in the collection
+     *
+     * 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: ReadonlyArray<PipelineJson>);
+    /**
+     * Gets all pipelines in the collection
+     */
+    listPipelines(): ReadonlyArray<string_pipeline_url>;
+    /**
+     * Gets pipeline by its URL
+     *
+     * Note: This is not a direct fetching from the URL, but a lookup in the collection
+     */
+    getPipelineByUrl(url: string_pipeline_url): PipelineJson;
+    /**
+     * Checks whether given prompt was defined in any pipeline in the collection
+     */
+    isResponsibleForPrompt(prompt: Prompt): boolean;
+}

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

@@ -0,0 +1,13 @@
+import type { PipelineJson } from '../pipeline/PipelineJson/PipelineJson';
+import type { PipelineCollection } from './PipelineCollection';
+/**
+ * Converts PipelineCollection to serialized JSON
+ *
+ * Note: Functions `collectionToJson` and `createCollectionFromJson` are complementary
+ *
+ * @public exported from `@promptbook/core`
+ */
+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/collectionToJson.test.d.ts

@@ -0,0 +1,7 @@
+export {};
+/**
+ * Note: [🐠] For example here URL https://example.com/pipeline.book is not valid
+ *       because it is on private network BUT its very hard to debug because
+ *       there is no error message and false return (the error) happen deep in:
+ *       `isValidPipelineUrl` -> `isValidPipelineUrl` -> `isUrlOnPrivateNetwork`
+ */

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

@@ -0,0 +1,65 @@
+import type { ExecutionTools } from '../../execution/ExecutionTools';
+import type { PrepareAndScrapeOptions } from '../../prepare/PrepareAndScrapeOptions';
+import type { string_dirname } from '../../types/typeAliases';
+import type { string_pipeline_root_url } from '../../types/typeAliases';
+import type { PipelineCollection } from '../PipelineCollection';
+/**
+ * Options for `createCollectionFromDirectory` function
+ *
+ * Note: `rootDirname` is not needed because it is the folder in which `.book` or `.book` file is located
+ *       This is not same as `path` which is the first argument of `createCollectionFromDirectory` - it can be a subfolder
+ */
+type CreatePipelineCollectionFromDirectoryOptions = Omit<PrepareAndScrapeOptions, 'rootDirname'> & {
+    /**
+     * If true, the directory is searched recursively for pipelines
+     *
+     * @default true
+     */
+    isRecursive?: boolean;
+    /**
+     * If true, the collection creation outputs information about each file it reads
+     *
+     * @default false
+     */
+    isVerbose?: boolean;
+    /**
+     * This will be used as a root URL for all pipelines in the collection
+     *
+     * It has 2 purposes:
+     * 1) Every pipeline in the collection is checked if it is a child of `rootUrl`
+     * 2) If the pipeline does not have a URL, it is created from the `rootUrl` and path to the pipeline
+     *
+     * @default false
+     */
+    rootUrl?: string_pipeline_root_url;
+    /**
+     * If true, directory will be scanned only when needed not during the construction
+     *
+     * @default false
+     */
+    isLazyLoaded?: boolean;
+    /**
+     * If true, whole collection creation crashes on error in any pipeline
+     * If true and isLazyLoaded is true, the error is thrown on first access to the pipeline
+     *
+     * @default true
+     */
+    isCrashedOnError?: boolean;
+};
+/**
+ * Constructs Pipeline from given directory
+ *
+ * Note: Works only in Node.js environment because it reads the file system
+ *
+ * @param rootPath - path to the directory with pipelines
+ * @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(rootPath: string_dirname, tools?: Pick<ExecutionTools, 'llm' | 'fs' | 'scrapers'>, options?: CreatePipelineCollectionFromDirectoryOptions): Promise<PipelineCollection>;
+export {};
+/**
+ * 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/createCollectionFromDirectory.test.d.ts

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

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

@@ -0,0 +1,13 @@
+import type { PipelineJson } from '../../pipeline/PipelineJson/PipelineJson';
+import type { PipelineCollection } from '../PipelineCollection';
+/**
+ * Creates PipelineCollection from array of PipelineJson or PipelineString
+ *
+ * Note: Functions `collectionToJson` and `createCollectionFromJson` are complementary
+ * Note: Syntax, parsing, and logic consistency checks are performed on all sources during build
+ *
+ * @param promptbookSources
+ * @returns PipelineCollection
+ * @public exported from `@promptbook/core`
+ */
+export declare function createCollectionFromJson(...promptbooks: ReadonlyArray<PipelineJson>): PipelineCollection;

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

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