@promptbook/markdown-utils 0.92.0-23 → 0.92.0-25

package/esm/typings/src/_packages/core.index.d.ts

@@ -122,7 +122,6 @@ import { EXPECTATION_UNITS } from '../pipeline/PipelineJson/Expectations';
 import { validatePipelineString } from '../pipeline/validatePipelineString';
 import { isPipelinePrepared } from '../prepare/isPipelinePrepared';
 import { preparePipeline } from '../prepare/preparePipeline';
-import { prepareTasks } from '../prepare/prepareTasks';
 import { unpreparePipeline } from '../prepare/unpreparePipeline';
 import { identificationToPromptbookToken } from '../remote-server/socket-types/_subtypes/identificationToPromptbookToken';
 import { promptbookTokenToIdentification } from '../remote-server/socket-types/_subtypes/promptbookTokenToIdentification';
@@ -270,7 +269,6 @@ export { EXPECTATION_UNITS };
 export { validatePipelineString };
 export { isPipelinePrepared };
 export { preparePipeline };
-export { prepareTasks };
 export { unpreparePipeline };
 export { identificationToPromptbookToken };
 export { promptbookTokenToIdentification };

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

@@ -4,8 +4,6 @@ import type { Prompt } from '../types/Prompt';
 import type { string_pipeline_url } from '../types/typeAliases';
 /**
  * Collection that groups together pipelines, knowledge, personas, tools and actions
- *
- * @see @@@ https://github.com/webgptorg/pipeline#pipeline-collection
  */
 export type PipelineCollection = {
     /**

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

@@ -14,7 +14,7 @@ export declare class SimplePipelineCollection implements PipelineCollection {
     /**
      * Constructs a pipeline collection from pipelines
      *
-     * @param 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

package/esm/typings/src/commands/FORMFACTOR/formfactorCommandParser.d.ts

@@ -3,7 +3,7 @@ import type { FormfactorCommand } from './FormfactorCommand';
 /**
  * Parses the formfactor command
  *
- * Note: @@@ This command is used as formfactor for new commands - it should NOT be used in any `.book` file
+ * Note: This command is used as a formfactor for new commands and defines the app type format - it should NOT be used in any `.book` file
  *
  * @see `documentationUrl` for more details
  * @public exported from `@promptbook/editable`

package/esm/typings/src/commands/_common/types/CommandParser.d.ts

@@ -8,7 +8,8 @@ import type { string_SCREAMING_CASE } from '../../../utils/normalization/normali
 import type { ___and___ } from '../../../utils/organization/___and___';
 import type { CommandUsagePlace } from './CommandUsagePlaces';
 /**
- * @@@
+ * Base type for all command objects.
+ * Requires a `type` property which is a SCREAMING_CASE string.
  *
  * @private just abstract helper for command parsers
  */
@@ -16,47 +17,48 @@ export type CommandBase = {
     type: string_name & string_SCREAMING_CASE;
 };
 /**
- * @@@
+ * Represents a parser for a specific command used within a Promptbook pipeline.
+ * It can parse commands used in the pipeline head, tasks, or both.
  *
  * @public exported from `@promptbook/editable`
  */
 export type CommandParser<TCommand extends CommandBase> = PipelineHeadCommandParser<TCommand> | PipelineTaskCommandParser<TCommand> | PipelineBothCommandParser<TCommand>;
 /**
- * @@@
+ * Common properties shared by all command parsers.
  *
  * @private just abstract the common properties of the command parsers
  */
 export type CommonCommandParser<TCommand extends CommandBase> = {
     /**
-     * @@@
+     * The unique SCREAMING_CASE name of the command (e.g., 'MODEL', 'PARAMETER').
      */
     readonly name: string_name & string_SCREAMING_CASE;
     /**
-     * @@@
+     * Indicates if the command can be used in the pipeline's head section.
      */
     readonly isUsedInPipelineHead: boolean;
     /**
-     * @@@
+     * Indicates if the command can be used within a pipeline task.
      */
     readonly isUsedInPipelineTask: boolean;
     /**
-     * @@@
+     * Optional alternative names (aliases) for the command, also in SCREAMING_CASE.
      */
     readonly aliasNames?: ReadonlyArray<string_name & string_SCREAMING_CASE>;
     /**
-     * @@@
+     * Optional list of deprecated names for the command, used for backward compatibility.
      */
     readonly deprecatedNames?: ReadonlyArray<string_name & string_SCREAMING_CASE>;
     /**
-     * @@@
+     * A brief description of the command's purpose, supporting simple Markdown.
      */
     readonly description: string_markdown_text;
     /**
-     * @@@
+     * A URL pointing to the command's documentation.
      */
     readonly documentationUrl: string_promptbook_documentation_url;
     /**
-     * @@@
+     * Examples demonstrating the usage of the command in Markdown format.
      */
     readonly examples: ReadonlyArray<string_markdown_text>;
     /**
@@ -72,23 +74,23 @@ export type CommonCommandParser<TCommand extends CommandBase> = {
     stringify(command: TCommand): string_markdown_text;
 };
 /**
- * @@@
+ * Represents a command parser that can be used in both the pipeline head and tasks.
  *
  * @public exported from `@promptbook/editable`
  */
 export type PipelineBothCommandParser<TCommand extends CommandBase> = ___and___ & Omit<PipelineHeadCommandParser<TCommand>, 'isUsedInPipelineTask'> & Omit<PipelineTaskCommandParser<TCommand>, 'isUsedInPipelineHead'>;
 /**
- * @@@
+ * Represents a command parser specifically for the pipeline head section.
  *
  * @public exported from `@promptbook/editable`
  */
 export type PipelineHeadCommandParser<TCommand extends CommandBase> = CommonCommandParser<TCommand> & {
     /**
-     * @@@
+     * Always true for pipeline head commands.
      */
     readonly isUsedInPipelineHead: true;
     /**
-     * @@@
+     * Always false for pipeline head commands.
      */
     readonly isUsedInPipelineTask: false;
     /**
@@ -106,17 +108,17 @@ export type PipelineHeadCommandParser<TCommand extends CommandBase> = CommonComm
     takeFromPipelineJson(pipelineJson: PipelineJson): ReadonlyArray<TCommand>;
 };
 /**
- * @@@
+ * Represents a command parser specifically for pipeline tasks.
  *
  * @public exported from `@promptbook/editable`
  */
 export type PipelineTaskCommandParser<TCommand extends CommandBase> = CommonCommandParser<TCommand> & {
     /**
-     * @@@
+     * Always false for pipeline task commands.
      */
     readonly isUsedInPipelineHead: false;
     /**
-     * @@@
+     * Always true for pipeline task commands.
      */
     readonly isUsedInPipelineTask: true;
     /**
@@ -133,58 +135,64 @@ export type PipelineTaskCommandParser<TCommand extends CommandBase> = CommonComm
     takeFromTaskJson($taskJson: $TaskJson): ReadonlyArray<TCommand>;
 };
 /**
- * @@@
+ * Represents a mutable TaskJson object, used internally by command parsers during application.
  *
- * Note: `$` is used to indicate that purpose of this type is to mutate the given object
+ * Note: `$` prefix indicates the object is intended for mutation.
  *
  * @private internal helper for command parsers
  */
 export type $TaskJson = {
+    /**
+     * Flag indicating if the section type (e.g., `SIMPLE_TEMPLATE`) has been set for this task.
+     */
     isSectionTypeSet: boolean;
+    /**
+     * Flag indicating if this object represents a task (as opposed to other sections like parameters).
+     */
     isTask: boolean;
 } & Partial<WritableDeep<TaskJson>>;
 /**
- * @@@
+ * Represents a mutable PipelineJson object, used internally by command parsers during application.
  *
- *  Note: `$` is used to indicate that purpose of this type is to mutate the given object
+ * Note: `$` prefix indicates the object is intended for mutation.
  *
  * @private internal helper for command parsers
  */
 export type $PipelineJson = WritableDeep<SetOptional<PipelineJson, 'formfactorName'>>;
 /**
- * @@@
+ * Input object provided to the `parse` method of a CommandParser.
  */
 export type CommandParserInput = {
     /**
-     * @@@
+     * Specifies where the command is being used (pipeline head or task).
      *
      * @example 'PIPELINE_HEAD'
      * @example 'PIPELINE_TASK'
      */
     readonly usagePlace: CommandUsagePlace;
     /**
-     * @@@
+     * The raw, unprocessed line containing the command and its arguments.
      *
      * @example 'promptbook version 0.62.0'
      * @example 'FOREACH Text Line `{customers}` -> `{customer}`'
      */
     readonly raw: string_markdown_text;
     /**
-     * @@@
+     * The arguments part of the raw command line, after the command name.
      *
      * @example '0.62.0'
      * @example 'List Line `{customers}` -> `{customer}`'
      */
     readonly rawArgs: string_markdown_text;
     /**
-     * @@@
+     * The normalized, SCREAMING_CASE representation of the command and its core arguments.
      *
      * @example 'PROMPTBOOK_ENGINE_VERSION_0_62_0'
      * @example 'FOREACH_LIST_LINE_CUSTOMERS_CUSTOMER'
      */
     readonly normalized: string_name & string_SCREAMING_CASE;
     /**
-     * @@@
+     * An array of arguments extracted from the line where the command is used.
      *
      * @example [ '0.62.0' ]
      * @example [ 'List', 'Line', '{customers}', '', '{customer}' ]

package/esm/typings/src/config.d.ts

@@ -69,19 +69,23 @@ export declare const DEFAULT_BOOK_OUTPUT_PARAMETER_NAME = "result";
  */
 export declare const DEFAULT_MAX_FILE_SIZE: number;
 /**
- * @@@
+ * Threshold value that determines when a dataset is considered "big"
+ * and may require special handling or optimizations
+ *
+ * For example, when error occurs in one item of the big dataset, it will not fail the whole pipeline
  *
  * @public exported from `@promptbook/core`
  */
 export declare const BIG_DATASET_TRESHOLD = 50;
 /**
- * @@@
+ * Placeholder text used to represent a placeholder value of failed operation
  *
  * @public exported from `@promptbook/core`
  */
-export declare const FAILED_VALUE_PLACEHOLDER = "!";
+export declare const FAILED_VALUE_PLACEHOLDER = "!?";
 /**
- * @@@
+ * Placeholder text used to represent operations or values that are still in progress
+ * or awaiting completion in UI displays and logging
  *
  * @public exported from `@promptbook/core`
  */

package/esm/typings/src/constants.d.ts

@@ -13,13 +13,13 @@ export declare const ORDER_OF_PIPELINE_JSON: ExportJsonOptions<PipelineJson>['or
  */
 export declare const REPLACING_NONCE = "ptbkauk42kV2dzao34faw7FudQUHYPtW";
 /**
- * @@@
+ * Placeholder value indicating a parameter is missing its value.
  *
  * @private within the repository
  */
 export declare const RESERVED_PARAMETER_MISSING_VALUE: string;
 /**
- * @@@
+ * Placeholder value indicating a parameter is restricted and cannot be used directly.
  *
  * @private within the repository
  */

package/esm/typings/src/errors/0-BoilerplateError.d.ts

@@ -1,5 +1,5 @@
 /**
- * This error indicates @@@
+ * This error indicates @@
  *
  * @public exported from `@promptbook/core`
  */
@@ -8,5 +8,5 @@ export declare class BoilerplateError extends Error {
     constructor(message: string);
 }
 /**
- * TODO: @@@ Do not forget to add the error into `0-index.ts` ERRORS
+ * TODO: @@ Do not forget to add the error into `0-index.ts` ERRORS
  */

package/esm/typings/src/execution/CommonToolsOptions.d.ts

@@ -1,6 +1,6 @@
 import type { string_user_id } from '../types/typeAliases';
 /**
- * @@@
+ * Common options shared across various execution tools.
  *
  * Note: Keep it public to allow people to make their own execution tools
  */
@@ -17,8 +17,8 @@ export type CommonToolsOptions = {
      */
     readonly isVerbose?: boolean;
     /**
-    * Maximum number of requests per minute
-    */
+     * Maximum number of requests per minute
+     */
     readonly maxRequestsPerMinute?: number;
 };
 /**

package/esm/typings/src/formats/_common/FormatSubvalueParser.d.ts

@@ -32,32 +32,32 @@ export type FormatSubvalueParser<TValue extends string, TSettings extends empty_
  */
 export type FormatSubvalueParserMapValuesOptions<TValue extends string, TSettings extends empty_object> = {
     /**
-     * @@@
+     * The input string value to parse for subvalues
      */
     readonly value: TValue;
     /**
-     * @@@
+     * The name of the output parameter where the processed value will be stored
      */
     readonly outputParameterName: string_parameter_name;
     /**
-     * @@@
+     * Format-specific settings that control how subvalues are parsed or processed
      */
     readonly settings: TSettings;
     /**
-     * @@@
+     * Callback function that processes each subvalue and returns the transformed value
      *
-     * @param subvalues @@@
+     * @param subvalues Object containing the extracted subvalues
      * @param index Current index of the subvalue which is being mapped
      * @param length Full length of the subvalues
-     * @param number @@@
-     * @returns @@@
+     * @param number Total number of subvalues to process
+     * @returns Transformed value after processing
      */
     mapCallback(subvalues: Parameters, index: number, length: number): Promisable<TValue>;
     /**
-     * @@@
+     * Progress callback that receives partial results during processing
      *
-     * @param partialResultString @@@
-     * @returns @@@
+     * @param partialResultString The current partial result as processing progresses
+     * @returns Promise or void to continue execution
      */
     onProgress(partialResultString: TValue): Promisable<void>;
 };

package/esm/typings/src/formfactors/_boilerplate/BoilerplateFormfactorDefinition.d.ts

@@ -1,11 +1,12 @@
 /**
- * Boilerplate is form of app that @@@
+ * Boilerplate is form of app that serves as a template structure for creating other formfactors
+ * and should not be used directly in production.
  *
  * @public exported from `@promptbook/core`
  */
 export declare const BoilerplateFormfactorDefinition: {
     readonly name: "BOILERPLATE";
-    readonly description: "@@@";
+    readonly description: "A template structure for creating new formfactors, providing the base architecture and interfaces that should be implemented.";
     readonly documentationUrl: "https://github.com/webgptorg/promptbook/discussions/@@";
     readonly pipelineInterface: {
         readonly inputParameters: readonly [];

package/esm/typings/src/formfactors/_common/string_formfactor_name.d.ts

@@ -1,5 +1,6 @@
 import type { FormfactorDefinition } from './FormfactorDefinition';
 /**
- * @@@
+ * A type alias representing the name of a formfactor, used for type checking and validation
+ * in the formfactor registry and selection processes
  */
 export type string_formfactor_name = FormfactorDefinition['name'];

package/esm/typings/src/formfactors/index.d.ts

@@ -71,7 +71,7 @@ export declare const FORMFACTOR_DEFINITIONS: readonly [{
 }, {
     readonly name: "SHEETS";
     readonly aliasNames: readonly ["SHEETS", "SHEET"];
-    readonly description: "@@@";
+    readonly description: "A formfactor for processing spreadsheet-like data in CSV format, enabling AI transformations on tabular data";
     readonly documentationUrl: "https://github.com/webgptorg/promptbook/discussions/176";
     readonly pipelineInterface: {
         readonly inputParameters: readonly [{

package/esm/typings/src/formfactors/sheets/SheetsFormfactorDefinition.d.ts

@@ -1,12 +1,13 @@
 /**
- * Sheets is form of app that @@@
+ * Sheets is form of app that processes tabular data in CSV format, allowing transformation
+ * and analysis of structured data through AI-powered operations
  *
  * @public exported from `@promptbook/core`
  */
 export declare const SheetsFormfactorDefinition: {
     readonly name: "SHEETS";
     readonly aliasNames: readonly ["SHEETS", "SHEET"];
-    readonly description: "@@@";
+    readonly description: "A formfactor for processing spreadsheet-like data in CSV format, enabling AI transformations on tabular data";
     readonly documentationUrl: "https://github.com/webgptorg/promptbook/discussions/176";
     readonly pipelineInterface: {
         readonly inputParameters: readonly [{

package/esm/typings/src/llm-providers/_common/register/$llmToolsMetadataRegister.d.ts

@@ -1,13 +1,13 @@
 import { $Register } from '../../../utils/$Register';
 import type { LlmToolsMetadata } from './LlmToolsMetadata';
 /**
- * @@@
+ * Register for LLM tools metadata.
  *
  * Note: `$` is used to indicate that this interacts with the global scope
- * @singleton Only one instance of each register is created per build, but thare can be more @@@
+ * @singleton Only one instance of each register is created per build, but there can be more instances across different builds or environments.
  * @public exported from `@promptbook/core`
  */
 export declare const $llmToolsMetadataRegister: $Register<LlmToolsMetadata>;
 /**
  * TODO: [®] DRY Register logic
- */ 
+ */

package/esm/typings/src/llm-providers/_common/register/$llmToolsRegister.d.ts

@@ -1,13 +1,13 @@
 import type { LlmExecutionToolsConstructor } from '../../../execution/LlmExecutionToolsConstructor';
 import { $Register } from '../../../utils/$Register';
 /**
- * @@@
+ * Register for LLM tools.
  *
  * Note: `$` is used to indicate that this interacts with the global scope
- * @singleton Only one instance of each register is created per build, but thare can be more @@@
+ * @singleton Only one instance of each register is created per build, but there can be more instances across different builds or environments.
  * @public exported from `@promptbook/core`
  */
 export declare const $llmToolsRegister: $Register<LlmExecutionToolsConstructor>;
 /**
  * TODO: [®] DRY Register logic
- */ 
+ */

package/esm/typings/src/llm-providers/_common/register/$provideLlmToolsConfigurationFromEnv.d.ts

@@ -1,8 +1,7 @@
 import type { LlmToolsConfiguration } from './LlmToolsConfiguration';
 /**
- * @@@
+ * Provides LLM tools configuration by reading environment variables.
  *
- * @@@ .env
  * Note: `$` is used to indicate that this function is not a pure function - it uses filesystem to access `.env` file
  *
  * It looks for environment variables:
@@ -10,10 +9,11 @@ import type { LlmToolsConfiguration } from './LlmToolsConfiguration';
  * - `process.env.ANTHROPIC_CLAUDE_API_KEY`
  * - ...
  *
- * @returns @@@
+ * @see Environment variables documentation or .env file for required variables.
+ * @returns A promise that resolves to the LLM tools configuration, or null if configuration is incomplete or missing.
  * @public exported from `@promptbook/node`
  */
 export declare function $provideLlmToolsConfigurationFromEnv(): Promise<LlmToolsConfiguration>;
 /**
  * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
- */
+ */ 

package/esm/typings/src/llm-providers/_common/utils/cache/CacheItem.d.ts

@@ -3,23 +3,23 @@ import type { Prompt } from '../../../../types/Prompt';
 import type { string_date_iso8601 } from '../../../../types/typeAliases';
 import type { string_promptbook_version } from '../../../../version';
 /**
- * @@@
+ * Represents a single item stored in the LLM cache.
  */
 export type CacheItem = {
     /**
-     * @@@
+     * The date and time when the cache item was created, in ISO 8601 format.
      */
     date: string_date_iso8601;
     /**
-     * @@@
+     * The version of the Promptbook library used when this cache item was created.
      */
     promptbookVersion?: string_promptbook_version;
     /**
-     * @@@
+     * The prompt that was sent to the LLM.
      */
     prompt: Prompt;
     /**
-     * @@@
+     * The response received from the LLM.
      */
     promptResult: PromptResult;
 };

package/esm/typings/src/llm-providers/_common/utils/cache/CacheLlmToolsOptions.d.ts

@@ -1,17 +1,19 @@
 import type { PromptbookStorage } from '../../../../storage/_common/PromptbookStorage';
 import type { CacheItem } from './CacheItem';
 /**
- * @@@
+ * Options for configuring caching behavior for LlmExecutionTools.
  */
 export type CacheLlmToolsOptions = {
     /**
-     * @@@
+     * The cache provider instance to use for storing and retrieving cached data.
      *
      * @default MemoryStorage
      */
     storage: PromptbookStorage<CacheItem>;
     /**
-     * @@@
+     * When set to `true`, the cache will be reloaded regardless of whether the data is already present in the cache.
+     * This can be useful for debugging or when you want to ensure that the latest data is always fetched.
+     * Data will ne still saved to the cache.
      *
      * @default false
      */

package/esm/typings/src/llm-providers/_common/utils/cache/cacheLlmTools.d.ts

@@ -13,7 +13,7 @@ export declare function cacheLlmTools<TLlmTools extends LlmExecutionTools>(llmTo
 /**
  * TODO: [🧠][💸] Maybe make some common abstraction `interceptLlmTools` and use here (or use javascript Proxy?)
  * TODO: [🧠] Is there some meaningfull way how to test this util
- * TODO: [👷‍♂️] @@@ Manual about construction of llmTools
- *            @@@ write discussion about this and storages
- *            @@@ write how to combine multiple interceptors
+ * TODO: [👷‍♂️] Comprehensive manual about construction of llmTools
+ *            Detailed explanation about caching strategies and appropriate storage selection for different use cases
+ *            Examples of how to combine multiple interceptors for advanced caching, logging, and usage tracking
  */

package/esm/typings/src/llm-providers/_common/utils/count-total-usage/limitTotalUsage.d.ts

@@ -4,24 +4,24 @@ import type { PromptbookStorage } from '../../../../storage/_common/PromptbookSt
 import type { TODO_any } from '../../../../utils/organization/TODO_any';
 import type { LlmExecutionToolsWithTotalUsage } from './LlmExecutionToolsWithTotalUsage';
 /**
- * Options for `limitTotalUsage`
+ * Options for the `limitTotalUsage` function.
  */
 type LimitTotalUsageOptions = {
     /**
-     * @@@
+     * The usage limits to apply.
      *
      * @default ZERO_USAGE
      */
     maxTotalUsage: Usage;
     /**
-     * @@@
+     * The storage mechanism to use for tracking usage across multiple executions or instances.
      *
-     * @default MemoryStorage
+     * @default MemoryStorage which will not persist when the process ends
      */
     storage: PromptbookStorage<TODO_any>;
 };
 /**
- * @@@
+ * Wraps LlmExecutionTools to limit the total usage based on provided limits.
  *
  * @public exported from `@promptbook/core`
  */

package/esm/typings/src/other/templates/getBookTemplates.d.ts

@@ -3,14 +3,14 @@ import type { string_formfactor_name } from '../../formfactors/_common/string_fo
 import type { PipelineJson } from '../../pipeline/PipelineJson/PipelineJson';
 import type { NonEmptyReadonlyArray } from '../../types/NonEmptyArray';
 /**
- * @@@
+ * Internal cache for the `getBookTemplates` function, storing retrieved pipelines.
  *
  * @singleton
  * @private internal cache of `getBookTemplate`
  */
 export declare let pipelines: Array<SetRequired<PipelineJson, 'pipelineUrl'>> | null;
 /**
- * Get template for new book
+ * Retrieves a collection of Promptbook templates.
  *
  * @param formfactorName - optional filter for FORMFACTOR - get only pipelines for this formfactor
  * @returns list of pipelines

package/esm/typings/src/pipeline/PipelineInterface/PipelineInterface.d.ts

@@ -1,20 +1,20 @@
 import type { InputParameterJson } from '../PipelineJson/ParameterJson';
 import type { OutputParameterJson } from '../PipelineJson/ParameterJson';
 /**
- * @@@
+ * Defines the interface of a Promptbook pipeline, specifying its input and output parameters.
  *
  * Note: [🚉] This is fully serializable as JSON
  * @see https://github.com/webgptorg/promptbook/discussions/171
  */
 export type PipelineInterface = {
     /**
-     * @@@
+     * Input parameters required by the pipeline.
      *
      * Note: Sorted alphabetically
      */
     readonly inputParameters: ReadonlyArray<InputParameterJson>;
     /**
-     * @@@
+     * Output parameters produced by the pipeline.
      *
      * Note: Sorted alphabetically
      */

package/esm/typings/src/pipeline/PipelineInterface/constants.d.ts

@@ -1,5 +1,5 @@
 /**
- * @@@
+ * Pipeline interface which is equivalent to `any`
  *
  * @see https://github.com/webgptorg/promptbook/discussions/171
  *

package/esm/typings/src/pipeline/PipelineInterface/getPipelineInterface.d.ts

@@ -1,7 +1,7 @@
 import type { PipelineJson } from '../PipelineJson/PipelineJson';
 import type { PipelineInterface } from './PipelineInterface';
 /**
- * @@@
+ * Extracts the interface (input and output parameters) from a pipeline.
  *
  * @deprecated https://github.com/webgptorg/promptbook/pull/186
  * @see https://github.com/webgptorg/promptbook/discussions/171