@promptbook/node 0.112.0-34 → 0.112.0-35

package/umd/src/commitments/_common/getAllCommitmentTypes.d.ts

@@ -1,6 +1,7 @@
 import type { BookCommitment } from '../_base/BookCommitment';
 /**
  * Gets all available commitment types
+ *
  * @returns Array of all commitment types
  *
  * @public exported from `@promptbook/core`

package/umd/src/commitments/_common/getAllCommitmentsToolFunctionsForNode.d.ts

@@ -7,7 +7,3 @@ import { type CommitmentToolFunctions } from './commitmentToolFunctions';
  * @public exported from `@promptbook/node`
  */
 export declare function getAllCommitmentsToolFunctionsForNode(): CommitmentToolFunctions;
-/**
- * Note: [??] Code in this file should never be never released in packages that could be imported into browser environment
- * TODO: [??] Unite `xxxForServer` and `xxxForNode` naming
- */

package/umd/src/commitments/_common/getCommitmentDefinition.d.ts

@@ -2,6 +2,7 @@ import type { BookCommitment } from '../_base/BookCommitment';
 import type { CommitmentDefinition } from '../_base/CommitmentDefinition';
 /**
  * Gets a commitment definition by its type
+ *
  * @param type The commitment type to look up
  * @returns The commitment definition or null if not found
  *

package/umd/src/commitments/_common/isCommitmentSupported.d.ts

@@ -1,6 +1,7 @@
 import type { BookCommitment } from '../_base/BookCommitment';
 /**
  * Checks if a commitment type is supported
+ *
  * @param type The commitment type to check
  * @returns True if the commitment type is supported
  *

package/umd/src/commitments/_common/toolExecutionEnvelope.d.ts

@@ -17,6 +17,3 @@ export declare function parseToolExecutionEnvelope(rawValue: unknown): {
     assistantMessage: string;
     toolResult: TODO_any;
 } | null;
-/**
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */

package/umd/src/commitments/_common/toolRuntimeContext.d.ts

@@ -144,6 +144,7 @@ export declare function serializeToolRuntimeContext(context: ToolRuntimeContext)
  *
  * @param listener - Listener notified about tool progress.
  * @returns Hidden token used to route progress updates.
+ *
  * @private internal runtime wiring for commitment tools
  */
 export declare function registerToolCallProgressListener(listener: ToolCallProgressListener): string;
@@ -151,6 +152,7 @@ export declare function registerToolCallProgressListener(listener: ToolCallProgr
  * Unregisters one in-memory progress listener.
  *
  * @param token - Token previously created by `registerToolCallProgressListener`.
+ *
  * @private internal runtime wiring for commitment tools
  */
 export declare function unregisterToolCallProgressListener(token: string): void;
@@ -160,10 +162,8 @@ export declare function unregisterToolCallProgressListener(token: string): void;
  * @param args - Raw tool arguments including hidden runtime keys.
  * @param update - Incremental progress update.
  * @returns `true` when a listener was found and notified.
+ *
  * @private internal runtime wiring for commitment tools
  */
 export declare function emitToolCallProgressFromToolArgs(args: Record<string, TODO_any>, update: ToolCallProgressUpdate): boolean;
 export {};
-/**
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */

package/umd/src/commitments/index.d.ts

@@ -60,7 +60,3 @@ import { NotYetImplementedCommitmentDefinition } from './_base/NotYetImplemented
  * @private Use functions to access commitments instead of this array directly
  */
 export declare const COMMITMENT_REGISTRY: readonly [PersonaCommitmentDefinition, PersonaCommitmentDefinition, KnowledgeCommitmentDefinition, MemoryCommitmentDefinition, MemoryCommitmentDefinition, StyleCommitmentDefinition, StyleCommitmentDefinition, RuleCommitmentDefinition, RuleCommitmentDefinition, LanguageCommitmentDefinition, LanguageCommitmentDefinition, WritingSampleCommitmentDefinition, WritingRulesCommitmentDefinition, SampleCommitmentDefinition, SampleCommitmentDefinition, FormatCommitmentDefinition, FormatCommitmentDefinition, TemplateCommitmentDefinition, TemplateCommitmentDefinition, FromCommitmentDefinition, ImportCommitmentDefinition, ImportCommitmentDefinition, ModelCommitmentDefinition, ModelCommitmentDefinition, ActionCommitmentDefinition, ActionCommitmentDefinition, ComponentCommitmentDefinition, MetaImageCommitmentDefinition, MetaColorCommitmentDefinition, MetaFontCommitmentDefinition, MetaLinkCommitmentDefinition, MetaDomainCommitmentDefinition, MetaDisclaimerCommitmentDefinition, MetaInputPlaceholderCommitmentDefinition, MetaCommitmentDefinition, MetaVoiceCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, GoalCommitmentDefinition, GoalCommitmentDefinition, InitialMessageCommitmentDefinition, UserMessageCommitmentDefinition, InternalMessageCommitmentDefinition, AgentMessageCommitmentDefinition, MessageSuffixCommitmentDefinition, MessageCommitmentDefinition, MessageCommitmentDefinition, ScenarioCommitmentDefinition, ScenarioCommitmentDefinition, DeleteCommitmentDefinition, DeleteCommitmentDefinition, DeleteCommitmentDefinition, DeleteCommitmentDefinition, DictionaryCommitmentDefinition, OpenCommitmentDefinition, ClosedCommitmentDefinition, TeamCommitmentDefinition, UseBrowserCommitmentDefinition, UseSearchEngineCommitmentDefinition, UseSpawnCommitmentDefinition, UseTimeoutCommitmentDefinition, UseTimeCommitmentDefinition, UseUserLocationCommitmentDefinition, UseCalendarCommitmentDefinition, UseEmailCommitmentDefinition, UsePopupCommitmentDefinition, UseImageGeneratorCommitmentDefinition, UseMcpCommitmentDefinition, UsePrivacyCommitmentDefinition, UseProjectCommitmentDefinition, UseCommitmentDefinition, NotYetImplementedCommitmentDefinition<"EXPECT">, NotYetImplementedCommitmentDefinition<"BEHAVIOUR">, NotYetImplementedCommitmentDefinition<"BEHAVIOURS">, NotYetImplementedCommitmentDefinition<"AVOID">, NotYetImplementedCommitmentDefinition<"AVOIDANCE">, NotYetImplementedCommitmentDefinition<"CONTEXT">];
-/**
- * TODO: [🧠] Maybe create through standardized $register
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */

package/umd/src/config.test.d.ts

@@ -1,4 +1 @@
 export {};
-/**
- * TODO: [🧠] Maybe more elegant how to prevent accidental costs
- */

package/umd/src/constants/streaming.d.ts

@@ -15,6 +15,3 @@ export declare const CHAT_STREAM_KEEP_ALIVE_TOKEN = "STREAM_KEEP_ALIVE";
  * @private internal streaming helper for Promptbook chat connections
  */
 export declare const CHAT_STREAM_KEEP_ALIVE_INTERVAL_MS = 25000;
-/**
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */

package/umd/src/constants.d.ts

@@ -206,6 +206,3 @@ export declare const HTTP_STATUS_CODES: {
     readonly GATEWAY_TIMEOUT: 504;
     readonly TOO_MANY_REQUESTS: 429;
 };
-/**
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */

package/umd/src/conversion/archive/loadArchive.d.ts

@@ -11,4 +11,3 @@ import type { string_filename } from '../../types/typeAliases';
  * @private utility of Promptbook
  */
 export declare function loadArchive(filePath: string_filename, fs: FilesystemTools): Promise<ReadonlyArray<PipelineJson>>;
-/** Note: [🟢] Code for Node archive helper [loadArchive](src/conversion/archive/loadArchive.ts) should never be published into packages that could be imported into browser environment */

package/umd/src/conversion/archive/saveArchive.d.ts

@@ -11,8 +11,3 @@ import type { string_filename } from '../../types/typeAliases';
  * @private utility of Promptbook
  */
 export declare function saveArchive(filePath: string_filename, collectionJson: ReadonlyArray<PipelineJson>, fs: FilesystemTools): Promise<void>;
-/** Note: [🟢] Code for Node archive helper [saveArchive](src/conversion/archive/saveArchive.ts) should never be published into packages that could be imported into browser environment */
-/**
- * TODO: Add metadata to zip
- * TODO: Compression level and other zip options from config
- */

package/umd/src/conversion/compilePipeline.d.ts

@@ -5,21 +5,16 @@ import type { PrepareAndScrapeOptions } from '../prepare/PrepareAndScrapeOptions
 /**
  * Compile pipeline from string (markdown) format to JSON format
  *
- * @see https://github.com/webgptorg/promptbook/discussions/196
- *
  * Note: This function does not validate logic of the pipeline only the parsing
  * Note: This function acts as compilation process
  *
+ * @see https://github.com/webgptorg/promptbook/discussions/196
  * @param pipelineString {Promptbook} in string markdown format (.book.md)
  * @param tools - Tools for the preparation and scraping - if not provided together with `llm`, the preparation will be skipped
  * @param options - Options and tools for the compilation
  * @returns {Promptbook} compiled in JSON format (.bookc)
  * @throws {ParseError} if the promptbook string is not valid
+ *
  * @public exported from `@promptbook/core`
  */
 export declare function compilePipeline(pipelineString: PipelineString, tools?: Pick<ExecutionTools, 'llm' | 'fs' | 'scrapers'>, options?: PrepareAndScrapeOptions): Promise<PipelineJson>;
-/**
- * TODO: [🏏] Leverage the batch API and build queues @see https://platform.openai.com/docs/guides/batch
- * TODO: [🛠] Actions, instruments (and maybe knowledge) => Functions and tools
- * TODO: [🧠] Should be in generated JSON file GENERATOR_WARNING
- */

package/umd/src/conversion/compilePipelineOnRemoteServer.d.ts

@@ -4,18 +4,15 @@ import type { RemoteClientOptions } from '../remote-server/types/RemoteClientOpt
 /**
  * Compile pipeline from string (markdown) format to JSON format
  *
- * @see https://github.com/webgptorg/promptbook/discussions/196
- *
  * Note: This function does not validate logic of the pipeline only the parsing
  * Note: This function acts as compilation process
  *
+ * @see https://github.com/webgptorg/promptbook/discussions/196
  * @param pipelineString {Promptbook} in string markdown format (.book.md)
  * @param options - Configuration of the remote server
  * @returns {Promptbook} compiled in JSON format (.bookc)
  * @throws {ParseError} if the promptbook string is not valid
+ *
  * @public exported from `@promptbook/remote-client`
  */
 export declare function compilePipelineOnRemoteServer<TCustomOptions = undefined>(pipelineString: PipelineString, options: RemoteClientOptions<TCustomOptions>): Promise<PipelineJson>;
-/**
- * TODO: [🐚] Do not return `Promise<PipelineJson>` But `PreparationTask`
- */

package/umd/src/conversion/parsePipeline.d.ts

@@ -14,17 +14,7 @@ import type { PipelineString } from '../pipeline/PipelineString';
  * @param pipelineString {Promptbook} in string markdown format (.book.md)
  * @returns {Promptbook} compiled in JSON format (.bookc)
  * @throws {ParseError} if the promptbook string is not valid
+ *
  * @public exported from `@promptbook/core`
  */
 export declare function parsePipeline(pipelineString: PipelineString): PipelineJson;
-/**
- * TODO: [🧠] Maybe more things here can be refactored as high-level abstractions
- * TODO: [main] !!4 Warn if used only sync version
- * TODO: [🚞] Report here line/column of error
- * TODO: Use spaceTrim more effectively
- * TODO: [🧠] Parameter flags - isInput, isOutput, isInternal
- * TODO: [🥞] Not optimal parsing because `splitMarkdownIntoSections` is executed twice with same string, once through `flattenMarkdown` and second directly here
- * TODO: [♈] Probably move expectations from tasks to parameters
- * TODO: [🛠] Actions, instruments (and maybe knowledge) => Functions and tools
- * TODO: [🍙] Make some standard order of json properties
- */

package/umd/src/conversion/pipelineJsonToString.d.ts

@@ -6,13 +6,7 @@ import type { PipelineString } from '../pipeline/PipelineString';
  * @deprecated TODO: [🥍][🧠] Backup original files in `PipelineJson` same as in Promptbook.studio
  * @param pipelineJson Promptbook in JSON format (.bookc)
  * @returns Promptbook in string format (.book.md)
+ *
  * @public exported from `@promptbook/core`
  */
 export declare function pipelineJsonToString(pipelineJson: PipelineJson): PipelineString;
-/**
- * TODO: [🛋] Implement new features and commands into `pipelineJsonToString` + `taskParameterJsonToString` , use `stringifyCommand`
- * TODO: [🧠] Is there a way to auto-detect missing features in pipelineJsonToString
- * TODO: [🏛] Maybe make some markdown builder
- * TODO: [🏛] Escape all
- * TODO: [🧠] Should be in generated .book.md file GENERATOR_WARNING
- */

package/umd/src/conversion/prettify/prettifyPipelineString.d.ts

@@ -6,7 +6,3 @@ import type { PrettifyOptions } from './PrettifyOptions';
  * @public exported from `@promptbook/core`
  */
 export declare function prettifyPipelineString(pipelineString: PipelineString, options: PrettifyOptions): Promise<PipelineString>;
-/**
- * TODO: Maybe use some Mermaid package instead of string templating
- * TODO: [🕌] When more than 2 functionalities, split into separate functions
- */

package/umd/src/conversion/prettify/renderPipelineMermaidOptions.d.ts

@@ -21,10 +21,3 @@ export type renderPipelineMermaidOptions = {
  * @public exported from `@promptbook/utils`
  */
 export declare function renderPromptbookMermaid(pipelineJson: PipelineJson, options?: renderPipelineMermaidOptions): string;
-/**
- * TODO: [🧠] FOREACH in mermaid graph
- * TODO: [🧠] Knowledge in mermaid graph
- * TODO: [🧠] Personas in mermaid graph
- * TODO: Maybe use some Mermaid package instead of string templating
- * TODO: [🕌] When more than 2 functionalities, split into separate functions
- */

package/umd/src/conversion/utils/extractParameterNamesFromTask.d.ts

@@ -7,9 +7,7 @@ import type { string_parameter_name } from '../../types/typeAliases';
  * @param task the task with used parameters
  * @returns the set of parameter names
  * @throws {ParseError} if the script is invalid
+ *
  * @public exported from `@promptbook/core` <- Note: [👖] This utility is so tightly interconnected with the Promptbook that it is not exported as util but in core
  */
 export declare function extractParameterNamesFromTask(task: ReadonlyDeep<Pick<TaskJson, 'title' | 'description' | 'taskType' | 'content' | 'preparedContent' | 'jokerParameterNames' | 'foreach'>>): Set<string_parameter_name>;
-/**
- * TODO: [🔣] If script require contentLanguage
- */

package/umd/src/conversion/validation/_importPipeline.d.ts

@@ -7,9 +7,15 @@ import type { PipelineString } from '../../pipeline/PipelineString';
  * Note: Using sync version is 💩 in the production code, but it's ok here in tests
  *
  * @param path - The path to the file relative to examples/pipelines directory
+ *
  * @private internal function of tests
  */
 export declare function importPipelineWithoutPreparation(path: `${string}.book`): Promise<PipelineString>;
+/**
+ * Imports pipeline without preparation.
+ *
+ * @private internal utility of `_importPipeline`
+ */
 export declare function importPipelineWithoutPreparation(path: `${string}.bookc`): Promise<PipelineJson>;
 /**
  * Import the pipeline.bookc file as parsed JSON
@@ -17,5 +23,3 @@ export declare function importPipelineWithoutPreparation(path: `${string}.bookc`
  * @private internal function of tests
  */
 export declare function importPipelineJson(path: `${string}.bookc`): Promise<PipelineJson>;
-/** Note: [⚫] Code for private pipeline import shim [_importPipeline](src/conversion/validation/_importPipeline.ts) should never be published in any package */
-/** Note: [💞] Ignore a discrepancy between file name and entity name */

package/umd/src/conversion/validation/pipelineStringToJson-parseErrors.test.d.ts

@@ -1,4 +1 @@
 export {};
-/**
- * TODO: [🚏] DRY
- */

package/umd/src/conversion/validation/validatePipeline-logicErrors.test.d.ts

@@ -1,4 +1 @@
 export {};
-/**
- * TODO: [🚏] DRY
- */

package/umd/src/conversion/validation/validatePipeline.d.ts

@@ -14,10 +14,13 @@ import type { PipelineJson } from '../../pipeline/PipelineJson/PipelineJson';
  * @param pipeline valid or invalid PipelineJson
  * @returns the same pipeline if it is logically valid
  * @throws {PipelineLogicError} on logical error in the pipeline
+ *
  * @public exported from `@promptbook/core`
  */
 export declare function validatePipeline(pipeline: PipelineJson): PipelineJson;
 /**
+ * Validates pipeline inner function.
+ *
  * @private internal function for `validatePipeline`
  */
 export declare function validatePipeline_InnerFunction(pipeline: PipelineJson): void;
@@ -33,12 +36,3 @@ export declare function validatePipeline_InnerFunction(pipeline: PipelineJson):
  *     >  * -   ...
  *     >  ex port function validatePipeline(promptbook: really_unknown): asserts promptbook is PipelineJson {
  */
-/**
- * TODO: [🧳][main] !!4 Validate that all examples match expectations
- * TODO: [🧳][🐝][main] !!4 Validate that knowledge is valid (non-void)
- * TODO: [🧳][main] !!4 Validate that persona can be used only with CHAT variant
- * TODO: [🧳][main] !!4 Validate that parameter with reserved name not used RESERVED_PARAMETER_NAMES
- * TODO: [🧳][main] !!4 Validate that reserved parameter is not used as joker
- * TODO: [🧠] Validation not only logic itself but imports around - files and websites and rerefenced pipelines exists
- * TODO: [🛠] Actions, instruments (and maybe knowledge) => Functions and tools
- */

package/umd/src/conversion/validation/validatePipeline.test.d.ts

@@ -1,4 +1 @@
 export {};
-/**
- * TODO: [🚏] DRY
- */

package/umd/src/dialogs/simple-prompt/SimplePromptInterfaceTools.d.ts

@@ -5,7 +5,7 @@ import type { UserInterfaceToolsPromptDialogOptions } from '../../execution/User
  * Wrapper around `window.prompt` synchronous function that interacts with the user via browser prompt
  *
  * Warning: It is used for testing and mocking
- *          **NOT intended to use in the production** due to its synchronous nature.
+ * **NOT intended to use in the production** due to its synchronous nature.
  *
  * @public exported from `@promptbook/browser`
  */
@@ -17,4 +17,3 @@ export declare class SimplePromptInterfaceTools implements UserInterfaceTools {
      */
     promptDialog(options: UserInterfaceToolsPromptDialogOptions): Promise<string>;
 }
-/** Note: [🔵] Code for browser dialog helper [SimplePromptInterfaceTools](src/dialogs/simple-prompt/SimplePromptInterfaceTools.ts) should never be published outside of `@promptbook/browser` */

package/umd/src/errors/0-BoilerplateError.d.ts

@@ -7,6 +7,3 @@ export declare class BoilerplateError extends Error {
     readonly name = "BoilerplateError";
     constructor(message: string);
 }
-/**
- * TODO: @@ Do not forget to add the error into `0-index.ts` ERRORS
- */

package/umd/src/errors/0-index.d.ts

@@ -98,6 +98,3 @@ export declare const ALL_ERRORS: {
     readonly DatabaseError: typeof DatabaseError;
     readonly ConflictError: typeof ConflictError;
 };
-/**
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */

package/umd/src/errors/DatabaseError.d.ts

@@ -7,6 +7,3 @@ export declare class DatabaseError extends Error {
     readonly name = "DatabaseError";
     constructor(message: string);
 }
-/**
- * TODO: [🐱‍🚀] Explain that NotFoundError ([🐱‍🚀] and other specific errors) has priority over DatabaseError in some contexts
- */

package/umd/src/errors/ExpectError.d.ts

@@ -1,10 +1,11 @@
 /**
  * This error occurs when some expectation is not met in the execution of the pipeline
  *
- * @public exported from `@promptbook/core`
  * Note: Do not throw this error, its reserved for `checkExpectations` and `createPipelineExecutor` and public ONLY to be serializable through remote server
  * Note: Always thrown in `checkExpectations` and catched in `createPipelineExecutor` and rethrown as `PipelineExecutionError`
  * Note: This is a kindof subtype of PipelineExecutionError
+ *
+ * @public exported from `@promptbook/core`
  */
 export declare class ExpectError extends Error {
     readonly name = "ExpectError";

package/umd/src/errors/ParseError.d.ts

@@ -7,6 +7,3 @@ export declare class ParseError extends Error {
     readonly name = "ParseError";
     constructor(message: string);
 }
-/**
- * TODO: Maybe split `ParseError` and `ApplyError`
- */

package/umd/src/errors/PipelineExecutionError.d.ts

@@ -9,6 +9,3 @@ export declare class PipelineExecutionError extends Error {
     readonly id?: task_id;
     constructor(message: string);
 }
-/**
- * TODO: [🧠][🌂] Add id to all errors
- */

package/umd/src/executables/$provideExecutablesForNode.d.ts

@@ -6,8 +6,3 @@ import type { PrepareAndScrapeOptions } from '../prepare/PrepareAndScrapeOptions
  * @public exported from `@promptbook/node`
  */
 export declare function $provideExecutablesForNode(options?: PrepareAndScrapeOptions): Promise<Executables>;
-/** Note: [🟢] Code for Node executable locator [$provideExecutablesForNode](src/executables/$provideExecutablesForNode.ts) should never be published into packages that could be imported into browser environment */
-/**
- * TODO: [🧠] Allow to override the executables without need to call `locatePandoc` / `locateLibreoffice` in case of provided
- * TODO: [🏓] Unite `xxxForServer` and `xxxForNode` naming
- */

package/umd/src/executables/apps/locateLibreoffice.d.ts

@@ -6,5 +6,3 @@ import type { string_executable_path } from '../../types/typeAliases';
  * @private within the repository
  */
 export declare function locateLibreoffice(): Promise<string_executable_path | null>;
-/** Note: [🟢] Code for Node executable locator [locateLibreoffice](src/executables/apps/locateLibreoffice.ts) should never be published into packages that could be imported into browser environment */
-/** TODO: [🧠][♿] Maybe export through `@promptbook/node` OR `@promptbook/legacy-documents` */

package/umd/src/executables/apps/locatePandoc.d.ts

@@ -6,5 +6,3 @@ import type { string_executable_path } from '../../types/typeAliases';
  * @private within the repository
  */
 export declare function locatePandoc(): Promise<string_executable_path | null>;
-/** Note: [🟢] Code for Node executable locator [locatePandoc](src/executables/apps/locatePandoc.ts) should never be published into packages that could be imported into browser environment */
-/** TODO: [🧠][♿] Maybe export through `@promptbook/node` OR `@promptbook/documents` */

package/umd/src/executables/browsers/locateBrowser.d.ts

@@ -1,7 +1,6 @@
 import type { string_executable_path } from '../../types/typeAliases';
 /**
  * @@@
- *
  * @param browser It can be "default", "chrome", "firefox", "safari", "ie", "msie", "edge" or "msedge" or executable path to the browser
  * @returns executable path to browser
  *

package/umd/src/executables/browsers/locateDefaultSystemBrowser.d.ts

@@ -1,7 +1,6 @@
 import type { string_executable_path } from '../../types/typeAliases';
 /**
  * @@@
- *
  * @param browser It can be "default", "chrome", "firefox", "safari", "ie", "msie", "edge" or "msedge" or executable path to the browser
  * @returns executable path to browser
  *

package/umd/src/executables/locateApp.d.ts

@@ -27,5 +27,3 @@ export type LocateAppOptions = {
  * @private within the repository
  */
 export declare function locateApp(options: RequireAtLeastOne<LocateAppOptions, 'linuxWhich' | 'windowsSuffix' | 'macOsName'>): Promise<string_executable_path | null>;
-/** Note: [🟢] Code for Node executable locator [locateApp](src/executables/locateApp.ts) should never be published into packages that could be imported into browser environment */
-/** TODO: [🧠][♿] Maybe export through `@promptbook/node` */

package/umd/src/executables/platforms/locateAppOnLinux.d.ts

@@ -7,5 +7,3 @@ import type { LocateAppOptions } from '../locateApp';
  * @private within the repository
  */
 export declare function locateAppOnLinux({ linuxWhich, }: Pick<Required<LocateAppOptions>, 'linuxWhich'>): Promise<string_executable_path | null>;
-/** Note: [🟢] Code for Node executable locator [locateAppOnLinux](src/executables/platforms/locateAppOnLinux.ts) should never be published into packages that could be imported into browser environment */
-/** TODO: [🧠][♿] Maybe export through `@promptbook/node` */

package/umd/src/executables/platforms/locateAppOnMacOs.d.ts

@@ -7,5 +7,3 @@ import type { LocateAppOptions } from '../locateApp';
  * @private within the repository
  */
 export declare function locateAppOnMacOs({ macOsName, }: Pick<Required<LocateAppOptions>, 'macOsName'>): Promise<string_executable_path | null>;
-/** Note: [🟢] Code for Node executable locator [locateAppOnMacOs](src/executables/platforms/locateAppOnMacOs.ts) should never be published into packages that could be imported into browser environment */
-/** TODO: [🧠][♿] Maybe export through `@promptbook/node` */

package/umd/src/executables/platforms/locateAppOnWindows.d.ts

@@ -7,5 +7,3 @@ import type { LocateAppOptions } from '../locateApp';
  * @private within the repository
  */
 export declare function locateAppOnWindows({ appName, windowsSuffix, }: Pick<Required<LocateAppOptions>, 'appName' | 'windowsSuffix'>): Promise<string_executable_path | null>;
-/** Note: [🟢] Code for Node executable locator [locateAppOnWindows](src/executables/platforms/locateAppOnWindows.ts) should never be published into packages that could be imported into browser environment */
-/** TODO: [🧠][♿] Maybe export through `@promptbook/node` */

package/umd/src/execution/AbstractTaskResult.d.ts

@@ -19,7 +19,3 @@ export type AbstractTaskResult = {
      */
     readonly warnings: ReadonlyDeep<ReadonlyArray<ErrorJson>>;
 };
-/**
- * TODO: [🧠] Should this file be in /execution or /types folder?
- * TODO: [🧠] Maybe constrain `ErrorJson` -> `ErrorJson & { name: 'PipelineExecutionError' | 'Error' }`
- */

package/umd/src/execution/AvailableModel.d.ts

@@ -46,7 +46,3 @@ export type AvailableModel = {
      */
     readonly isDeprecated?: boolean;
 };
-/**
- * TODO: [🕛] Extend this from sth like `AgentBasicInformation` / `ModelBasicInformation`
- * TODO: [🧠] Maybe rename to something else - like `ModelInformation` or `ModelMetadata`
- */

package/umd/src/execution/CommonToolsOptions.d.ts

@@ -21,8 +21,3 @@ export type CommonToolsOptions = {
      */
     readonly maxRequestsPerMinute?: number;
 };
-/**
- * TODO: [🧠][🤺] Maybe allow overriding of `userId` for each prompt
- * TODO: [🈁] Maybe add here `isDeterministic`
- * TODO: [🧠][💙] Distinct between options passed into ExecutionTools and to ExecutionTools.execute
- */

package/umd/src/execution/ExecutionTask.d.ts

@@ -50,6 +50,7 @@ export type ExecutionTask = AbstractTask<PipelineExecutorResult> & {
 };
 /**
  * Represents a task that prepares a pipeline
+ *
  * @deprecated TODO: [🐚] Currently unused - use
  */
 export type PreparationTask = AbstractTask<PipelineExecutorResult> & {
@@ -146,9 +147,8 @@ export type AbstractTask<TTaskResult extends AbstractTaskResult> = {
      */
     readonly ptbkNonce?: chococake;
 };
-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
+ * Type describing task.
  */
+export type Task = ExecutionTask | PreparationTask;
+export {};

package/umd/src/execution/FilesystemTools.d.ts

@@ -4,6 +4,3 @@ 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' | 'mkdir' | 'watch'>;
-/**
- * TODO: Implement destroyable pattern to free resources
- */

package/umd/src/execution/LlmExecutionTools.d.ts

@@ -30,6 +30,9 @@ export type CallChatModelStreamOptions = {
      */
     readonly signal?: AbortSignal;
 };
+/**
+ * Type describing Llm execution tools.
+ */
 export type LlmExecutionTools = {
     /**
      * Title of the model provider
@@ -93,12 +96,3 @@ export type LlmExecutionTools = {
      */
     callEmbeddingModel?(prompt: Prompt): Promise<EmbeddingPromptResult>;
 };
-/**
- * TODO: [🕛] Extend this from sth class -  like `AgentBasicInformation` / `ModelBasicInformation``
- * TODO: [🍚] Implement destroyable pattern to free resources
- * TODO: [🏳] Add `callTranslationModel`
- * TODO: [🧠] Emulation of one type of model with another one - emuate chat with completion; emulate translation with chat
- * TODO: [🍓][♐] Some heuristic to pick the best model in listed models
- * TODO: [🧠] Should or should not there be a word "GPT" in both callCompletionModel and callChatModel
- * TODO: [🧠][🪐] Should be common things like types, utils in folder containing A,B,C,.. or else outside this listing folder?
- */

package/umd/src/execution/LlmExecutionToolsConstructor.d.ts

@@ -6,6 +6,3 @@ import type { LlmExecutionTools } from './LlmExecutionTools';
  * Combines registration metadata with a factory function for creating LLM tool instances.
  */
 export type LlmExecutionToolsConstructor = Registered & ((options: TODO_any) => LlmExecutionTools);
-/**
- * TODO: [🎶] Naming "constructor" vs "creator" vs "factory"
- */

package/umd/src/execution/PipelineExecutor.d.ts

@@ -11,6 +11,3 @@ import type { ExecutionTask } from './ExecutionTask';
 export type PipelineExecutor = {
     (inputParameters: InputParameters): ExecutionTask;
 };
-/**
- * TODO: [🧠] Should this file be in /execution or /types folder?
- */

package/umd/src/execution/PipelineExecutorResult.d.ts

@@ -34,6 +34,3 @@ export type PipelineExecutorResult = AbstractTaskResult & {
      */
     readonly preparedPipeline: ReadonlyDeep<PipelineJson>;
 };
-/**
- * TODO: [🧠] Should this file be in /execution or /types folder?
- */

package/umd/src/execution/PromptResult.d.ts

@@ -18,7 +18,7 @@ export type PromptResult = CompletionPromptResult | ChatPromptResult | ImageProm
  */
 export type CompletionPromptResult = CommonPromptResult;
 /**
- *Chat prompt result
+ * Chat prompt result
  *
  * Note: [🚉] This is fully serializable as JSON
  */
@@ -101,11 +101,3 @@ export type CommonPromptResult = {
      */
     readonly rawResponse: TODO_object;
 };
-/**
- * TODO: [🧠] Maybe timing more accurate then seconds?
- * TODO: [🧠] Should here be link to the prompt?
- * TODO: [🧠] Maybe type `rawResponse` properly - not onject but OpenAI.result.whatever
- * TODO: [🧠] Maybe remove redundant raw.choices.text
- * TODO: Log raw even if prompt failed - log the raw error
- * TODO: [🏳] Add `TranslationPromptResult`
- */

package/umd/src/execution/PromptbookFetch.test-type.d.ts

@@ -1,5 +1 @@
 export {};
-/**
- * Note: [⚪] This should never be in any released package
- * TODO: Is this a good pattern to do type testing?
- */

package/umd/src/execution/ScriptExecutionTools.d.ts

@@ -33,7 +33,3 @@ export type ScriptExecutionToolsExecuteOptions = {
      */
     readonly script: string_script;
 };
-/**
- * TODO: [🧠][💙] Distinct between options passed into ExecutionTools and to ExecutionTools.execute
- * TODO: [🧠][🪐] Should be common things like types, utils in folder containing A,B,C,.. or else outside this listing folder?
- */

package/umd/src/execution/Usage.d.ts

@@ -32,6 +32,3 @@ export type Usage = {
  * Note: [🚉] This is fully serializable as JSON
  */
 export type UsageCounts = Record<`${KebabCase<'TOKENS' | ExpectationUnit>}Count`, UncertainNumber>;
-/**
- * TODO: [🍙] Make some standard order of json properties
- */

package/umd/src/execution/UserInterfaceTools.d.ts

@@ -14,6 +14,9 @@ export type UserInterfaceTools = {
      */
     promptDialog(options: UserInterfaceToolsPromptDialogOptions): Promise<string>;
 };
+/**
+ * Options for user interface tools prompt dialog.
+ */
 export type UserInterfaceToolsPromptDialogOptions = {
     /**
      * Prompt title