@promptbook/documents 0.112.0-11 → 0.112.0-111

package/umd/src/cli/cli-commands/hello.d.ts

@@ -8,8 +8,3 @@ import type { $side_effect } from '../../utils/organization/$side_effect';
  * @private internal function of `promptbookCli`
  */
 export declare function $initializeHelloCommand(program: Program): $side_effect;
-/**
- * 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/umd/src/cli/cli-commands/list-models.d.ts

@@ -8,7 +8,3 @@ import type { $side_effect } from '../../utils/organization/$side_effect';
  * @private internal function of `promptbookCli`
  */
 export declare function $initializeListModelsCommand(program: Program): $side_effect;
-/**
- * Note: [💞] Ignore a discrepancy between file name and entity name
- * Note: [🟡] Code in this file should never be published outside of `@promptbook/cli`
- */

package/umd/src/cli/cli-commands/list-scrapers.d.ts

@@ -8,7 +8,3 @@ import type { $side_effect } from '../../utils/organization/$side_effect';
  * @private internal function of `promptbookCli`
  */
 export declare function $initializeListScrapersCommand(program: Program): $side_effect;
-/**
- * Note: [💞] Ignore a discrepancy between file name and entity name
- * Note: [🟡] Code in this file should never be published outside of `@promptbook/cli`
- */

package/umd/src/cli/cli-commands/login.d.ts

@@ -8,8 +8,3 @@ import type { $side_effect } from '../../utils/organization/$side_effect';
  * @private internal function of `promptbookCli`
  */
 export declare function $initializeLoginCommand(program: Program): $side_effect;
-/**
- * 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/umd/src/cli/cli-commands/make.d.ts

@@ -8,10 +8,10 @@ import type { $side_effect } from '../../utils/organization/$side_effect';
  * @private internal function of `promptbookCli`
  */
 export declare function $initializeMakeCommand(program: Program): $side_effect;
+/** Note: [🟡] Code for CLI command [make](src/cli/cli-commands/make.ts) should never be published outside of `@promptbook/cli` */
 /**
  * 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/umd/src/cli/cli-commands/prettify.d.ts

@@ -8,9 +8,3 @@ import type { $side_effect } from '../../utils/organization/$side_effect';
  * @private internal function of `promptbookCli`
  */
 export declare function $initializePrettifyCommand(program: Program): $side_effect;
-/**
- * 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/umd/src/cli/cli-commands/run/prepareRunCommandResources.d.ts

@@ -0,0 +1,20 @@
+import type { PipelineExecutor } from '../../../execution/PipelineExecutor';
+import type { PipelineJson } from '../../../pipeline/PipelineJson/PipelineJson';
+import type { PrepareAndScrapeOptions } from '../../../prepare/PrepareAndScrapeOptions';
+import type { RunCommandCliOptions } from './runCommandAction';
+/**
+ * Prepares the tools, pipeline, and executor required to run one `ptbk run` invocation.
+ *
+ * @private internal utility of `$initializeRunCommand`
+ */
+export declare function prepareRunCommandResources(options: {
+    readonly pipelineSource?: string;
+    readonly cliOptions: RunCommandCliOptions;
+    readonly prepareAndScrapeOptions: Pick<PrepareAndScrapeOptions, 'isVerbose'> & {
+        readonly isCacheReloaded: boolean;
+    };
+    readonly logStage: (stage: string) => void;
+}): Promise<{
+    readonly pipeline: PipelineJson;
+    readonly pipelineExecutor: PipelineExecutor;
+}>;

package/umd/src/cli/cli-commands/run/resolveRunInputParameters.d.ts

@@ -0,0 +1,12 @@
+import type { PipelineJson } from '../../../pipeline/PipelineJson/PipelineJson';
+import type { string_parameter_name, string_parameter_value } from '../../../types/string_name';
+/**
+ * Resolves all missing input parameters while keeping the current interactive and non-interactive behavior.
+ *
+ * @private internal utility of `$initializeRunCommand`
+ */
+export declare function resolveRunInputParameters(options: {
+    readonly pipeline: PipelineJson;
+    readonly inputParameters: Record<string_parameter_name, string_parameter_value>;
+    readonly isInteractive: boolean;
+}): Promise<Record<string_parameter_name, string_parameter_value>>;

package/umd/src/cli/cli-commands/run/runCommandAction.d.ts

@@ -0,0 +1,21 @@
+/**
+ * CLI options consumed by the `run` command action.
+ *
+ * @private internal utility of `$initializeRunCommand`
+ */
+export type RunCommandCliOptions = {
+    readonly reload: boolean;
+    readonly interactive: boolean;
+    readonly formfactor: boolean;
+    readonly json?: string;
+    readonly verbose: boolean;
+    readonly saveReport?: string;
+    readonly provider: string;
+    readonly remoteServerUrl: string;
+};
+/**
+ * Runs the whole `ptbk run` flow as a top-down orchestration of focused steps.
+ *
+ * @private internal utility of `$initializeRunCommand`
+ */
+export declare function runCommandAction(pipelineSource: string | undefined, cliOptions: RunCommandCliOptions): Promise<void | never>;

package/umd/src/cli/cli-commands/run/runPipelineExecution.d.ts

@@ -0,0 +1,14 @@
+import type { PipelineExecutor } from '../../../execution/PipelineExecutor';
+import type { string_parameter_name, string_parameter_value } from '../../../types/string_name';
+/**
+ * Executes the pipeline, persists any requested report, and prints the final CLI output.
+ *
+ * @private internal utility of `$initializeRunCommand`
+ */
+export declare function runPipelineExecution(options: {
+    readonly pipelineExecutor: PipelineExecutor;
+    readonly inputParameters: Record<string_parameter_name, string_parameter_value>;
+    readonly isVerbose: boolean;
+    readonly json?: string;
+    readonly saveReport?: string;
+}): Promise<void>;

package/umd/src/cli/cli-commands/run.d.ts

@@ -1,4 +1,4 @@
-import type { Command as Program } from 'commander';
+import { Command as Program } from 'commander';
 import type { $side_effect } from '../../utils/organization/$side_effect';
 /**
  * Initializes `run` command for Promptbook CLI utilities
@@ -8,11 +8,3 @@ import type { $side_effect } from '../../utils/organization/$side_effect';
  * @private internal function of `promptbookCli`
  */
 export declare function $initializeRunCommand(program: Program): $side_effect;
-/**
- * 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/umd/src/cli/cli-commands/runInteractiveChatbot.d.ts

@@ -21,12 +21,8 @@ type RunInteractiveChatbotOptions = {
  * 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/umd/src/cli/cli-commands/start-agents-server.d.ts

@@ -8,7 +8,3 @@ import type { $side_effect } from '../../utils/organization/$side_effect';
  * @private internal function of `promptbookCli`
  */
 export declare function $initializeStartAgentsServerCommand(program: Program): $side_effect;
-/**
- * Note: [💞] Ignore a discrepancy between file name and entity name
- * Note: [🟡] Code in this file should never be published outside of `@promptbook/cli`
- */

package/umd/src/cli/cli-commands/start-pipelines-server.d.ts

@@ -8,8 +8,3 @@ import type { $side_effect } from '../../utils/organization/$side_effect';
  * @private internal function of `promptbookCli`
  */
 export declare function $initializeStartPipelinesServerCommand(program: Program): $side_effect;
-/**
- * TODO: [🕋] Use here `aboutPromptbookInformation`
- * Note: [💞] Ignore a discrepancy between file name and entity name
- * Note: [🟡] Code in this file should never be published outside of `@promptbook/cli`
- */

package/umd/src/cli/cli-commands/test-command.d.ts

@@ -8,10 +8,3 @@ import type { $side_effect } from '../../utils/organization/$side_effect';
  * @private internal function of `promptbookCli`
  */
 export declare function $initializeTestCommand(program: Program): $side_effect;
-/**
- * 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/umd/src/cli/common/$deprecateCliCommand.d.ts

@@ -0,0 +1,8 @@
+import { Command } from 'commander';
+import type { $side_effect } from '../../utils/organization/$side_effect';
+/**
+ * Marks one CLI command as deprecated while keeping it available for existing callers.
+ *
+ * @private utility of CLI
+ */
+export declare function $deprecateCliCommand(command: Command, deprecationMessage: string): $side_effect;

package/umd/src/cli/common/$deprecateCliCommand.test.d.ts

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

package/umd/src/cli/common/$provideLlmToolsForCli.d.ts

@@ -1,6 +1,9 @@
 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';
+import type { string_promptbook_server_url } from '../../types/string_promptbook_server_url';
+/**
+ * Options for provide Llm tools for Cli.
+ */
 type ProvideLlmToolsForCliOptions = Pick<CacheLlmToolsOptions, 'isCacheReloaded'> & {
     /**
      * If true, user will be always prompted for login
@@ -19,6 +22,8 @@ type ProvideLlmToolsForCliOptions = Pick<CacheLlmToolsOptions, 'isCacheReloaded'
     };
 };
 /**
+ * Handles provide Llm tools for Cli.
+ *
  * @private utility of CLI
  */
 export declare function $provideLlmToolsForCli(options: ProvideLlmToolsForCliOptions): Promise<{

package/umd/src/cli/main.d.ts

@@ -1,4 +1,4 @@
-import { promptbookCli } from './promptbookCli';
+import { $runPromptbookCli } from './$runPromptbookCli';
 /**
  * Note: [🔺] Purpose of this file is to export CLI for production environment
  */
@@ -8,9 +8,5 @@ import { promptbookCli } from './promptbookCli';
  * @public exported from `@promptbook/cli`
  */
 export declare const _CLI: {
-    _initialize_promptbookCli: typeof promptbookCli;
+    _initialize_promptbookCli: typeof $runPromptbookCli;
 };
-/**
- * Note: [💞] Ignore a discrepancy between file name and entity name
- * Note: [🟡] Code in this file should never be published outside of `@promptbook/cli`
- */

package/umd/src/cli/other/install.test.d.ts

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

package/umd/src/cli/other/vpsInstall.test.d.ts

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

package/umd/src/cli/promptbookCli.d.ts

@@ -4,10 +4,3 @@
  * @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/umd/src/cli/test/ptbk.d.ts

@@ -2,4 +2,4 @@
 /**
  * Note: [🔺] Purpose of this file is to test and use the current CLI in development environment
  */
-import '../../_packages/cli.index';
+export {};

package/umd/src/collection/agent-collection/AgentCollection.d.ts

@@ -7,6 +7,3 @@ import type { AgentCollectionInSupabase } from './constructors/agent-collection-
  * - `PipelineCollection` - which groups together *(deprecated)* pipelines
  */
 export type AgentCollection = AgentCollectionInSupabase;
-/**
- * TODO: [🧠][🚙] `AgentXxx` vs `AgentsXxx` naming convention
- */

package/umd/src/collection/agent-collection/constructors/agent-collection-in-supabase/AgentCollectionInSupabase.d.ts

@@ -1,26 +1,14 @@
 import type { SupabaseClient } from '@supabase/supabase-js';
 import type { AgentBasicInformation } from '../../../../book-2.0/agent-source/AgentBasicInformation';
 import type { string_book } from '../../../../book-2.0/agent-source/string_book';
-import type { string_agent_name, string_agent_permanent_id } from '../../../../types/typeAliases';
-import { AgentCollectionInSupabaseOptions } from './AgentCollectionInSupabaseOptions';
+import type { string_agent_name, string_agent_permanent_id } from '../../../../types/string_agent_name';
+import type { AgentCollectionInSupabaseOptions } from './AgentCollectionInSupabaseOptions';
 import type { AgentsDatabaseSchema } from './AgentsDatabaseSchema';
+import type { CreateAgentPersistenceRecordsOptions } from './createAgentPersistenceRecords';
 /**
  * Options for creating a new agent entry.
  */
-type CreateAgentOptions = {
-    /**
-     * Visibility for the new agent.
-     */
-    readonly visibility?: 'PRIVATE' | 'UNLISTED' | 'PUBLIC';
-    /**
-     * Folder identifier to assign the new agent to.
-     */
-    readonly folderId?: number | null;
-    /**
-     * Sort order for the agent within its parent folder.
-     */
-    readonly sortOrder?: number;
-};
+type CreateAgentOptions = CreateAgentPersistenceRecordsOptions;
 /**
  * Optional controls for persisting one source update.
  */
@@ -56,8 +44,9 @@ type AgentHistorySnapshot = AgentHistoryMetadata & {
  *
  * Note: This object can work both from Node.js and browser environment depending on the Supabase client provided.
  *
+ * TODO: [🐱‍🚀] Move to `@promptbook/supabase` package
+ *
  * @public exported from `@promptbook/core`
- * <- TODO: [🐱‍🚀] Move to `@promptbook/supabase` package
  */
 export declare class AgentCollectionInSupabase {
     private readonly supabaseClient;
@@ -71,6 +60,28 @@ export declare class AgentCollectionInSupabase {
      * Gets all agents in the collection
      */
     listAgents(): Promise<ReadonlyArray<AgentBasicInformation>>;
+    /**
+     * Finds one active agent profile by its human-readable name or permanent id.
+     *
+     * This keeps route-level lookups from loading the whole agent collection when only
+     * one canonical route identifier is needed.
+     *
+     * @param agentNameOrPermanentId - Agent name or stable permanent identifier.
+     * @returns Matching active agent profile or `null` when not found.
+     *
+     * @public exported from `@promptbook/core`
+     */
+    findAgentBasicInformation(agentNameOrPermanentId: string_agent_name | string_agent_permanent_id): Promise<AgentBasicInformation | null>;
+    /**
+     * Converts one database row into public agent information.
+     *
+     * @param row - Database row carrying the persisted profile snapshot.
+     * @param isVerbose - Whether profile-name mismatches should be logged.
+     * @returns Agent profile with canonical database name and permanent id.
+     *
+     * @private internal helper of `AgentCollectionInSupabase`
+     */
+    private mapAgentBasicInformationRow;
     /**
      * Retrieves the permanent ID of an agent by its name or permanent ID.
      */
@@ -141,8 +152,3 @@ export declare class AgentCollectionInSupabase {
     private listAgentHistoryInternal;
 }
 export {};
-/**
- * TODO: [🐱‍🚀] Implement it here correctly and update JSDoc comments here, and on interface + other implementations
- * TODO: Write unit test
- * TODO: [🧠][🚙] `AgentXxx` vs `AgentsXxx` naming convention
- */

package/umd/src/collection/agent-collection/constructors/agent-collection-in-supabase/AgentCollectionInSupabaseOptions.d.ts

@@ -1,5 +1,8 @@
 import type { CommonToolsOptions } from '../../../../execution/CommonToolsOptions';
 import type { PrepareAndScrapeOptions } from '../../../../prepare/PrepareAndScrapeOptions';
+/**
+ * Options for agent collection in supabase.
+ */
 export type AgentCollectionInSupabaseOptions = PrepareAndScrapeOptions & CommonToolsOptions & {
     /**
      * The Supabase tables prefix to use

package/umd/src/collection/agent-collection/constructors/agent-collection-in-supabase/createAgentPersistenceRecords.d.ts

@@ -0,0 +1,40 @@
+import type { AgentBasicInformation } from '../../../../book-2.0/agent-source/AgentBasicInformation';
+import type { string_book } from '../../../../book-2.0/agent-source/string_book';
+import type { CreateAgentInput } from '../../CreateAgentInput';
+import type { AgentsDatabaseSchema } from './AgentsDatabaseSchema';
+/**
+ * Optional persistence overrides for one new agent row.
+ *
+ * @private shared persistence helper for `AgentCollectionInSupabase`
+ */
+export type CreateAgentPersistenceRecordsOptions = Omit<CreateAgentInput, 'source'>;
+/**
+ * Prepared insert rows and returned profile for one newly persisted agent.
+ *
+ * @private shared persistence helper for `AgentCollectionInSupabase`
+ */
+export type CreateAgentPersistenceRecordsResult = {
+    /**
+     * Parsed created agent profile including the resolved permanent id.
+     */
+    readonly createdAgent: AgentBasicInformation & Required<Pick<AgentBasicInformation, 'permanentId'>>;
+    /**
+     * Insert row for the `Agent` table.
+     */
+    readonly agentInsertRecord: AgentsDatabaseSchema['public']['Tables']['Agent']['Insert'];
+    /**
+     * Insert row for the `AgentHistory` table.
+     */
+    readonly agentHistoryInsertRecord: AgentsDatabaseSchema['public']['Tables']['AgentHistory']['Insert'];
+};
+/**
+ * Builds normalized insert rows for a newly created persisted agent.
+ *
+ * @param agentSource - Source content of the agent.
+ * @param options - Optional folder placement, ordering, and visibility overrides.
+ * @param createdAt - Shared creation timestamp used across all persisted rows.
+ * @returns Insert rows and the created agent profile.
+ *
+ * @private shared persistence helper for `AgentCollectionInSupabase`
+ */
+export declare function createAgentPersistenceRecords(agentSource: string_book, options?: CreateAgentPersistenceRecordsOptions, createdAt?: string): CreateAgentPersistenceRecordsResult;

package/umd/src/collection/agent-collection/constructors/agent-collection-in-supabase/createAgentPersistenceRecords.test.d.ts

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

package/umd/src/collection/agent-collection/constructors/agent-collection-in-supabase/prepareAgentSourceForPersistence.d.ts

@@ -1,6 +1,6 @@
 import type { AgentBasicInformation } from '../../../../book-2.0/agent-source/AgentBasicInformation';
 import type { string_book } from '../../../../book-2.0/agent-source/string_book';
-import type { string_agent_permanent_id } from '../../../../types/typeAliases';
+import type { string_agent_permanent_id } from '../../../../types/string_agent_name';
 /**
  * Prepared agent source payload ready for database persistence.
  *

package/umd/src/collection/pipeline-collection/PipelineCollection.d.ts

@@ -1,7 +1,7 @@
 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';
+import type { string_pipeline_url } from '../../types/string_pipeline_url';
 /**
  * Collection that groups together pipelines, knowledge, personas, tools and actions
  *

package/umd/src/collection/pipeline-collection/SimplePipelineCollection.d.ts

@@ -1,13 +1,14 @@
 import type { PipelineJson } from '../../pipeline/PipelineJson/PipelineJson';
 import type { Prompt } from '../../types/Prompt';
-import type { string_pipeline_url } from '../../types/typeAliases';
+import type { string_pipeline_url } from '../../types/string_pipeline_url';
 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 `createPipelineCollectionFromJson`, use `createPipelineCollectionFromJson` instead
  * @see https://github.com/webgptorg/pipeline#pipeline-collection
+ *
+ * @private internal function of `createPipelineCollectionFromJson`, use `createPipelineCollectionFromJson` instead
  */
 export declare class SimplePipelineCollection implements PipelineCollection {
     private collection;

package/umd/src/collection/pipeline-collection/constructors/createPipelineCollectionFromDirectory.d.ts

@@ -1,12 +1,13 @@
 import type { ExecutionTools } from '../../../execution/ExecutionTools';
 import type { PrepareAndScrapeOptions } from '../../../prepare/PrepareAndScrapeOptions';
-import type { string_dirname, string_pipeline_root_url } from '../../../types/typeAliases';
+import type { string_dirname } from '../../../types/string_filename';
+import type { string_pipeline_root_url } from '../../../types/string_pipeline_root_url';
 import type { PipelineCollection } from '../PipelineCollection';
 /**
  * Options for `createPipelineCollectionFromDirectory` 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 `createPipelineCollectionFromDirectory` - it can be a subfolder
+ * This is not same as `path` which is the first argument of `createPipelineCollectionFromDirectory` - it can be a subfolder
  */
 type CreatePipelineCollectionFromDirectoryOptions = Omit<PrepareAndScrapeOptions, 'rootDirname'> & {
     /**
@@ -43,6 +44,12 @@ type CreatePipelineCollectionFromDirectoryOptions = Omit<PrepareAndScrapeOptions
      */
     isCrashedOnError?: boolean;
 };
+/**
+ * Tools used by `createPipelineCollectionFromDirectory`.
+ *
+ * @private internal function of `createPipelineCollectionFromDirectory`
+ */
+type CreatePipelineCollectionFromDirectoryTools = Pick<ExecutionTools, 'llm' | 'fs' | 'scrapers'>;
 /**
  * Constructs `PipelineCollection` from given directory
  *
@@ -52,11 +59,8 @@ type CreatePipelineCollectionFromDirectoryOptions = Omit<PrepareAndScrapeOptions
  * @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 createPipelineCollectionFromDirectory(rootPath: string_dirname, tools?: Pick<ExecutionTools, 'llm' | 'fs' | 'scrapers'>, options?: CreatePipelineCollectionFromDirectoryOptions): Promise<PipelineCollection>;
+export declare function createPipelineCollectionFromDirectory(rootPath: string_dirname, tools?: CreatePipelineCollectionFromDirectoryTools, 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/umd/src/collection/pipeline-collection/constructors/createPipelineCollectionFromJson.d.ts

@@ -8,6 +8,7 @@ import type { PipelineCollection } from '../PipelineCollection';
  *
  * @param promptbookSources
  * @returns PipelineCollection
+ *
  * @public exported from `@promptbook/core`
  */
 export declare function createPipelineCollectionFromJson(...promptbooks: ReadonlyArray<PipelineJson>): PipelineCollection;

package/umd/src/collection/pipeline-collection/constructors/createPipelineCollectionFromPromise.d.ts

@@ -8,17 +8,18 @@ import type { PipelineCollection } from '../PipelineCollection';
  * - Factory function that returns Promise of array of PipelineJson or PipelineString
  *
  * Note: This is useful as internal tool for other constructor functions like
- *       `createPipelineCollectionFromUrl` or `createPipelineCollectionFromDirectory`
- *       Consider using those functions instead of this one
+ * `createPipelineCollectionFromUrl` or `createPipelineCollectionFromDirectory`
+ * Consider using those functions instead of this one
  *
  * Note: The function does NOT return promise it returns the collection directly which waits for the sources to be resolved
- *       when error occurs in given promise or factory function, it is thrown during `listPipelines` or `getPipelineByUrl` call
+ * when error occurs in given promise or factory function, it is thrown during `listPipelines` or `getPipelineByUrl` call
  *
  * Note: Consider using  `createPipelineCollectionFromDirectory` or `createPipelineCollectionFromUrl`
  *
  * @param promptbookSourcesPromiseOrFactory
  * @returns PipelineCollection
  * @deprecated Do not use, it will became internal tool for other constructor functions
+ *
  * @public exported from `@promptbook/core`
  */
 export declare function createPipelineCollectionFromPromise(promptbookSourcesPromiseOrFactory: Promise<ReadonlyArray<PipelineJson>> | (() => Promise<ReadonlyArray<PipelineJson>>)): PipelineCollection;

package/umd/src/collection/pipeline-collection/constructors/createPipelineCollectionFromUrl.d.ts

@@ -1,4 +1,4 @@
-import type { string_url } from '../../../types/typeAliases';
+import type { string_url } from '../../../types/string_url';
 import type { PipelineCollection } from '../PipelineCollection';
 /**
  * Options for `createPipelineCollectionFromDirectory` function
@@ -19,11 +19,10 @@ type CreatePipelineCollectionFromUrlyOptions = {
 };
 /**
  * Constructs Promptbook from remote Promptbase URL
+ *
  * @returns PipelineCollection
+ *
  * @public exported from `@promptbook/core`
  */
 export declare function createPipelineCollectionFromUrl(url: string_url | URL, options: CreatePipelineCollectionFromUrlyOptions): Promise<PipelineCollection>;
 export {};
-/**
- * TODO: [main] !!4 [🧠] Library precompilation and do not mix markdown and json promptbooks
- */

package/umd/src/collection/pipeline-collection/constructors/createPipelineSubcollection.d.ts

@@ -1,4 +1,4 @@
-import type { string_pipeline_url } from '../../../types/typeAliases';
+import type { string_pipeline_url } from '../../../types/string_pipeline_url';
 import type { PipelineCollection } from '../PipelineCollection';
 /**
  * Creates `PipelineCollection` as a subset of another `PipelineCollection`
@@ -8,6 +8,7 @@ import type { PipelineCollection } from '../PipelineCollection';
  *
  * @param promptbookSources
  * @returns PipelineCollection
+ *
  * @public exported from `@promptbook/core`
  */
 export declare function createPipelineSubcollection(collection: PipelineCollection, predicate: (url: string_pipeline_url) => boolean): PipelineCollection;

package/umd/src/collection/pipeline-collection/pipelineCollectionToJson.d.ts

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

package/umd/src/commands/BOOK_VERSION/BookVersionCommand.d.ts

@@ -1,8 +1,9 @@
-import type { string_semantic_version } from '../../types/typeAliases';
+import type { string_semantic_version } from '../../types/string_sha256';
 /**
  * Parsed BOOK_VERSION command
  *
  * @see ./bookVersionCommandParser.ts for more details
+ *
  * @public exported from `@promptbook/editable`
  */
 export type BookVersionCommand = {

package/umd/src/commands/BOOK_VERSION/bookVersionCommandParser.d.ts

@@ -4,6 +4,7 @@ import type { BookVersionCommand } from './BookVersionCommand';
  * Parses the BOOK_VERSION command
  *
  * @see `documentationUrl` for more details
+ *
  * @public exported from `@promptbook/editable`
  */
 export declare const bookVersionCommandParser: PipelineHeadCommandParser<BookVersionCommand>;

package/umd/src/commands/EXPECT/ExpectCommand.d.ts

@@ -12,6 +12,3 @@ export type ExpectCommand = {
     readonly unit: ExpectationUnit;
     readonly amount: ExpectationAmount;
 };
-/**
- * TODO: [🍋] Allow to `EXPECT` relative amounts like `EXPECT MAX 130% {foo} Words`
- */

package/umd/src/commands/EXPECT/expectCommandParser.d.ts

@@ -1,11 +1,12 @@
 import type { PipelineTaskCommandParser } from '../_common/types/CommandParser';
 import type { ExpectCommand } from './ExpectCommand';
 /**
-import { WrappedError } from '../../errors/WrappedError';
-import { assertsError } from '../../errors/assertsError';
+ * import { WrappedError } from '../../errors/WrappedError';
+ * import { assertsError } from '../../errors/assertsError';
  * Parses the expect command
  *
  * @see `documentationUrl` for more details
+ *
  * @public exported from `@promptbook/editable`
  */
 export declare const expectCommandParser: PipelineTaskCommandParser<ExpectCommand>;

package/umd/src/commands/FOREACH/ForeachCommand.d.ts

@@ -3,6 +3,7 @@ import type { ForeachJson } from './ForeachJson';
  * Parsed FOREACH command which is used to iterate over a table of values
  *
  * @see ./foreachCommandParser.ts for more details
+ *
  * @public exported from `@promptbook/editable`
  */
 export type ForeachCommand = {