@promptbook/javascript 0.112.0-34 → 0.112.0-35

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

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

@@ -6,9 +6,7 @@ import type { PipelineExecutorResult } from './PipelineExecutorResult';
  *
  * @param executionResult - The partial result of the Promptbook execution
  * @throws {PipelineExecutionError} If the execution is not successful or if multiple errors occurred
+ *
  * @private internal helper function of `asPromise` method of `ExecutionTask`
  */
 export declare function assertsTaskSuccessful(executionResult: Pick<PipelineExecutorResult, 'isSuccessful' | 'errors' | 'warnings'>): void;
-/**
- * TODO: [🧠] Can this return type be better typed than void
- */

package/umd/src/execution/createPipelineExecutor/00-createPipelineExecutor.d.ts

@@ -5,6 +5,7 @@ import type { CreatePipelineExecutorOptions } from './00-CreatePipelineExecutorO
  *
  * @returns The executor function
  * @throws {PipelineLogicError} on logical error in the pipeline
+ *
  * @public exported from `@promptbook/core`
  */
 export declare function createPipelineExecutor(options: CreatePipelineExecutorOptions): PipelineExecutor;

package/umd/src/execution/createPipelineExecutor/20-executeTask.d.ts

@@ -51,6 +51,3 @@ type executeSingleTaskOptions = Required<CreatePipelineExecutorOptions> & {
  */
 export declare function executeTask(options: executeSingleTaskOptions): Promise<Readonly<Parameters>>;
 export {};
-/**
- * TODO: [🤹‍♂️]
- */

package/umd/src/execution/createPipelineExecutor/40-executeAttempts.d.ts

@@ -71,9 +71,7 @@ export type ExecuteAttemptsOptions = Required<Omit<CreatePipelineExecutorOptions
  *
  * @param options - The options for execution, including task, parameters, pipeline, and configuration.
  * @returns The result string of the executed task.
+ *
  * @private internal utility of `createPipelineExecutor`
  */
 export declare function executeAttempts(options: ExecuteAttemptsOptions): Promise<TODO_string>;
-/**
- * TODO: Break into smaller functions
- */

package/umd/src/execution/createPipelineExecutor/getContextForTask.d.ts

@@ -9,6 +9,7 @@ import type { string_parameter_value } from '../../types/typeAliases';
  *
  * @param task - The task for which the context is being generated. This should be a deeply immutable TaskJson object.
  * @returns The context as a string, formatted as markdown and parameter value.
+ *
  * @private internal utility of `createPipelineExecutor`
  */
 export declare function getContextForTask(task: ReadonlyDeep<TaskJson>): Promise<string_parameter_value & string_markdown>;

package/umd/src/execution/createPipelineExecutor/getKnowledgeForTask.d.ts

@@ -34,7 +34,3 @@ type GetKnowledgeForTaskOptions = {
  */
 export declare function getKnowledgeForTask(options: GetKnowledgeForTaskOptions): Promise<string_parameter_value & string_markdown>;
 export {};
-/**
- * TODO: [♨] Implement Better - use keyword search
- * TODO: [♨] Examples of values
- */

package/umd/src/execution/createPipelineExecutor/knowledgePiecesToString.d.ts

@@ -1,6 +1,5 @@
 import type { KnowledgePiecePreparedJson } from '../../pipeline/PipelineJson/KnowledgePieceJson';
 /**
- *
  * @param knowledgePieces
  * @returns
  *

package/umd/src/execution/execution-report/ExecutionReportJson.d.ts

@@ -11,6 +11,7 @@ import type { ExecutionPromptReportJson } from './ExecutionPromptReportJson';
  * -   _(this)_ **JSON** format
  *
  * Note: [🚉] This is fully serializable as JSON
+ *
  * @see https://github.com/webgptorg/promptbook#execution-report
  */
 export type ExecutionReportJson = {

package/umd/src/execution/execution-report/ExecutionReportString.d.ts

@@ -11,6 +11,3 @@
 export type ExecutionReportString = string & {
     readonly _type: 'ExecutionReportString';
 };
-/**
- * TODO: [💩] Better validation or remove branded type and make it just string
- */

package/umd/src/execution/execution-report/executionReportJsonToString.d.ts

@@ -8,8 +8,3 @@ import type { ExecutionReportStringOptions } from './ExecutionReportStringOption
  * @public exported from `@promptbook/core`
  */
 export declare function executionReportJsonToString(executionReportJson: ReadonlyDeep<ExecutionReportJson>, options?: Partial<ExecutionReportStringOptions>): ExecutionReportString;
-/**
- * TODO: Add mermaid chart for every report
- * TODO: [🧠] Allow to filter out some parts of the report by options
- * TODO: [🧠] Should be in generated file GENERATOR_WARNING
- */

package/umd/src/execution/translation/automatic-translate/automatic-translators/AutomaticTranslator.d.ts

@@ -1,6 +1,8 @@
 import type { Promisable } from 'type-fest';
 /**
- * @private still in development [🏳]
+ * Still in development [🏳].
+ *
+ * @private
  */
 export type AutomaticTranslator = {
     translate(message: string): Promisable<string>;

package/umd/src/execution/translation/automatic-translate/automatic-translators/FakeAutomaticTranslator.d.ts

@@ -1,6 +1,8 @@
 import type { AutomaticTranslator } from './AutomaticTranslator';
 /**
- * @private still in development [🏳]
+ * Still in development [🏳].
+ *
+ * @private
  */
 export declare class FakeAutomaticTranslator implements AutomaticTranslator {
     constructor();

package/umd/src/execution/translation/automatic-translate/automatic-translators/TranslatorOptions.d.ts

@@ -1,5 +1,7 @@
 /**
- * @private still in development [🏳]
+ * Still in development [🏳].
+ *
+ * @private
  */
 export type TranslatorOptions = {
     readonly from?: string;

package/umd/src/execution/translation/automatic-translate/automatic-translators/utils/extractMultiplicatedOccurrence.d.ts

@@ -1,8 +1,10 @@
 /**
+ * Extracts multiplicated occurrence.
  *
  * @param message
  * @returns
  * @throws {PipelineExecutionError}
+ *
  * @private still in development [🏳]
  */
 export declare function extractMultiplicatedOccurrence(message: string): string;

package/umd/src/execution/translation/automatic-translate/translateMessages.d.ts

@@ -1,10 +1,10 @@
 import type { AutomaticTranslator } from './automatic-translators/AutomaticTranslator';
 import type { TranslatorOptions } from './automatic-translators/TranslatorOptions';
 /**
- * @private still in development [🏳]
+ * Still in development [🏳].
+ *
+ * @private
  */
 export declare function translateMessages({ automaticTranslator, from, to, }: {
     automaticTranslator: AutomaticTranslator;
 } & TranslatorOptions): Promise<void>;
-/** Note: [🟢] Code for Node translation helper [translateMessages](src/execution/translation/automatic-translate/translateMessages.ts) should never be published into packages that could be imported into browser environment */
-/** TODO: [😶] Unite folder listing */

package/umd/src/execution/utils/$provideExecutionToolsForNode.d.ts

@@ -2,11 +2,9 @@ import type { PrepareAndScrapeOptions } from '../../prepare/PrepareAndScrapeOpti
 import type { ExecutionTools } from '../ExecutionTools';
 /**
  * Note: There is unfortunately no equivalent for this function in the browser environment
- *       because it is not possible automatically detect configured LLM providers
- *       you need to provide them manually BUT you can help by utilities like `$provideScrapersForBrowser`
+ * because it is not possible automatically detect configured LLM providers
+ * you need to provide them manually BUT you can help by utilities like `$provideScrapersForBrowser`
  *
  * @public exported from `@promptbook/node`
  */
 export declare function $provideExecutionToolsForNode(options?: PrepareAndScrapeOptions): Promise<ExecutionTools>;
-/** Note: [🟢] Code for Node execution helper [$provideExecutionToolsForNode](src/execution/utils/$provideExecutionToolsForNode.ts) should never be published into packages that could be imported into browser environment */
-/** TODO: [🏓] Unite `xxxForServer` and `xxxForNode` naming */

package/umd/src/execution/utils/checkExpectations.d.ts

@@ -8,6 +8,7 @@ import type { Expectations } from '../../pipeline/PipelineJson/Expectations';
  *
  * @throws {ExpectError} if the expectations are not met
  * @returns {void} Nothing
+ *
  * @private internal function of `createPipelineExecutor`
  */
 export declare function checkExpectations(expectations: Expectations, value: string): void;
@@ -19,11 +20,7 @@ export declare function checkExpectations(expectations: Expectations, value: str
  * - `isPassingExpectations` which returns a boolean
  *
  * @returns {boolean} True if the expectations are met
+ *
  * @public exported from `@promptbook/core`
  */
 export declare function isPassingExpectations(expectations: Expectations, value: string): boolean;
-/**
- * TODO: [💝] Unite object for expecting amount and format
- * TODO: [🧠][🤠] This should be part of `TextFormatParser`
- * Note: [💝] and [🤠] are interconnected together
- */

package/umd/src/execution/utils/forEachAsync.d.ts

@@ -1,4 +1,7 @@
 import type { Promisable } from 'type-fest';
+/**
+ * Options for for each async.
+ */
 type ForEachAsyncOptions = {
     /**
      * Maximum number of tasks running in parallel
@@ -13,8 +16,9 @@ type ForEachAsyncOptions = {
  * @param array - Array to iterate over
  * @param options - Options for the function
  * @param callbackfunction - Function to call for each item
- * @public exported from `@promptbook/utils`
  * @deprecated [🪂] Use queues instead
+ *
+ * @public exported from `@promptbook/utils`
  */
 export declare function forEachAsync<TItem>(array: ReadonlyArray<TItem>, options: ForEachAsyncOptions, callbackfunction: (value: TItem, index: number, array: ReadonlyArray<TItem>) => Promisable<void>): Promise<void>;
 export {};

package/umd/src/execution/utils/usage-constants.d.ts

@@ -22,6 +22,3 @@ export declare const ZERO_USAGE: any;
  * @public exported from `@promptbook/core`
  */
 export declare const UNCERTAIN_USAGE: any;
-/**
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */

package/umd/src/execution/utils/usageToHuman.d.ts

@@ -17,11 +17,3 @@ type PartialUsage = Partial<Usage> & {
  */
 export declare function usageToHuman(usage: PartialUsage): string_markdown;
 export {};
-/**
- * TODO: [🍓][🧞‍♂️] Use "$1" not "1 USD"
- * TODO: [🍓][🧞‍♂️] Use markdown formatting like "Cost approximately **$1**"
- * TODO: [🍓][🧞‍♂️] Report in minutes, seconds, days NOT 0.1 hours
- * TODO: [🧠] Maybe make from `uncertainNumberToHuman` separate exported utility
- * TODO: [🧠] Maybe use "~" instead of "approximately"
- * TODO: [🏛] Maybe make some markdown builder
- */

package/umd/src/execution/utils/validatePromptResult.d.ts

@@ -50,6 +50,7 @@ export type ValidatePromptResultResult = {
  *
  * @param options - The validation options including result string, expectations, and format
  * @returns Validation result with processed string and validity status
+ *
  * @private internal function of `createPipelineExecutor` and `cacheLlmTools`
  */
 export declare function validatePromptResult(options: ValidatePromptResultOptions): ValidatePromptResultResult;

package/umd/src/file-security-checkers/virustotal/VirusTotalFileSecurityChecker.d.ts

@@ -5,6 +5,7 @@ import type { FileSecurityCheckResult } from '../FileSecurityCheckResult';
  * File security checker that uses VirusTotal API.
  *
  * @see https://developers.virustotal.com/reference/overview
+ *
  * @public exported from `@promptbook/core`
  */
 export declare class VirusTotalFileSecurityChecker implements FileSecurityChecker {

package/umd/src/formats/_common/FormatParser.d.ts

@@ -6,11 +6,12 @@ import type { FormatSubvalueParser } from './FormatSubvalueParser';
 /**
  * A format definition is a set of functions that define how to validate, heal and convert response from LLM.
  *
- * @remarks
  * - "settings" are runtime options that affect parsing (e.g., delimiter for CSV).
  * - "schema" is a structural definition or contract for the data (e.g., expected fields in JSON).
  *
+ * @remarks
  * @see https://github.com/webgptorg/promptbook/discussions/36
+ *
  * @private still in development [🏢]
  */
 export type FormatParser<TValue extends TPartialValue, TPartialValue extends string, TSettings extends empty_object, TSchema extends empty_object> = {
@@ -62,11 +63,3 @@ export type FormatParser<TValue extends TPartialValue, TPartialValue extends str
      */
     readonly subvalueParsers: ReadonlyArray<FormatSubvalueParser<TValue, TSettings>>;
 };
-/**
- * TODO: [♏] Add some prepare hook to modify prompt according to the format
- * TODO: [🍓]`name` and `aliases` should be UPPERCASE only and interpreted as case-insensitive (via normalization)
- * TODO: [🍓][👨‍⚖️] Compute TPartialValue dynamically - PartialString<TValue>
- * TODO: [🍓][🧠] Should execution tools be available to heal, canBeValid and isValid?
- * TODO: [🍓][🧠] llm Provider Bindings
- * TODO: [🍓][🔼] Export via some package
- */

package/umd/src/formats/_common/FormatSubvalueParser.d.ts

@@ -61,6 +61,3 @@ export type FormatSubvalueParserMapValuesOptions<TValue extends string, TSetting
      */
     onProgress(partialResultString: TValue): Promisable<void>;
 };
-/**
- * Note: [👩🏾‍🤝‍🧑🏽]
- */

package/umd/src/formats/csv/CsvFormatParser.d.ts

@@ -4,14 +4,8 @@ import type { CsvSettings } from './CsvSettings';
 /**
  * Definition for CSV spreadsheet
  *
+ * TODO: [🏢] Export from package `@promptbook/csv`
+ *
  * @public exported from `@promptbook/core`
- *                          <- TODO: [🏢] Export from package `@promptbook/csv`
  */
 export declare const CsvFormatParser: FormatParser<string, string, CsvSettings, TODO_any>;
-/**
- * TODO: [🍓] In `CsvFormatParser` implement simple `isValid`
- * TODO: [🍓] In `CsvFormatParser` implement partial `canBeValid`
- * TODO: [🍓] In `CsvFormatParser` implement `heal
- * TODO: [🍓] In `CsvFormatParser` implement `subvalueParsers`
- * TODO: [🏢] Allow to expect something inside CSV objects and other formats
- */

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

@@ -4,6 +4,3 @@
  * @private internal index of `...` <- TODO [🏢]
  */
 export declare const FORMAT_DEFINITIONS: readonly [import("./_common/FormatParser").FormatParser<string, string, any, any>, import("./_common/FormatParser").FormatParser<string, string, any, any>, import("./_common/FormatParser").FormatParser<string, string, any, any>, import("./_common/FormatParser").FormatParser<string, string, import("./csv/CsvSettings").CsvSettings, any>];
-/**
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */