@promptbook/openai 0.62.1 → 0.63.0-1

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

@@ -4,6 +4,8 @@ import type { PipelineCollection } from './PipelineCollection';
  * Converts PipelineCollection to serialized JSON
  *
  * Note: Functions `collectionToJson` and `createCollectionFromJson` are complementary
+ *
+ * @public exported from `@promptbook/core`
  */
 export declare function collectionToJson(collection: PipelineCollection): Promise<Array<PipelineJson>>;
 /**

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

@@ -39,6 +39,7 @@ type CreatePipelineCollectionFromDirectoryOptions = PipelineStringToJsonOptions
  * @param path - path to the directory with pipelines
  * @param options - Misc options for the collection
  * @returns PipelineCollection
+ * @public exported from `@promptbook/node`
  */
 export declare function createCollectionFromDirectory(path: string_folder_path, options?: CreatePipelineCollectionFromDirectoryOptions): Promise<PipelineCollection>;
 export {};

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

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

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

@@ -18,5 +18,6 @@ import type { PipelineCollection } from '../PipelineCollection';
  * @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 createCollectionFromPromise(promptbookSourcesPromiseOrFactory: Promise<Array<PipelineJson>> | (() => Promise<Array<PipelineJson>>)): PipelineCollection;

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

@@ -19,8 +19,8 @@ type CreatePipelineCollectionFromUrlyOptions = {
 };
 /**
  * Constructs Promptbook from remote Promptbase URL
-
  * @returns PipelineCollection
+ * @public exported from `@promptbook/core`
  */
 export declare function createCollectionFromUrl(url: string_url | URL, options: CreatePipelineCollectionFromUrlyOptions): Promise<PipelineCollection>;
 export {};

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

@@ -8,5 +8,6 @@ import type { PipelineCollection } from '../PipelineCollection';
  *
  * @param promptbookSources
  * @returns PipelineCollection
+ * @public exported from `@promptbook/core`
  */
 export declare function createSubcollection(collection: PipelineCollection, predicate: (url: string_pipeline_url) => boolean): PipelineCollection;

package/esm/typings/src/commands/BLOCK/BlockTypes.d.ts

@@ -3,11 +3,13 @@ import type { TupleToUnion } from 'type-fest';
  * Block type describes the way how the block is blockd
  *
  * @see https://github.com/webgptorg/promptbook#block-type
+ * @public exported from `@promptbook/core`
  */
 export type BlockType = TupleToUnion<typeof BlockTypes>;
 /**
  * Block type describes the way how the block is blockd
  *
  * @see https://github.com/webgptorg/promptbook#block-type
+ * @public exported from `@promptbook/core`
  */
 export declare const BlockTypes: readonly ["PROMPT_TEMPLATE", "SIMPLE_TEMPLATE", "SCRIPT", "PROMPT_DIALOG", "SAMPLE", "KNOWLEDGE", "INSTRUMENT", "ACTION"];

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

@@ -1,39 +1,57 @@
 /**
  * The maximum number of iterations for a loops
+ *
+ * @private within the repository - too low-level in comparison to other `MAX_...`
  */
 export declare const LOOP_LIMIT = 1000;
 /**
  * The maximum number of iterations for a loops which adds characters one by one
+ *
+ * @private within the repository - too low-level in comparison to other `MAX_...`
  */
 export declare const CHARACTER_LOOP_LIMIT = 100000;
 /**
  * The maximum number of (LLM) tasks running in parallel
+ *
+ * @public exported from `@promptbook/core`
  */
 export declare const MAX_PARALLEL_COUNT = 5;
 /**
  * The maximum number of attempts to execute LLM task before giving up
+ *
+ * @public exported from `@promptbook/core`
  */
 export declare const MAX_EXECUTION_ATTEMPTS = 3;
 /**
  * The maximum length of the (generated) filename
+ *
+ * @public exported from `@promptbook/core`
  */
 export declare const MAX_FILENAME_LENGTH = 30;
 /**
  * @@@
  * TODO: [🐝] !!! Use
+ *
+ * @public exported from `@promptbook/core`
  */
 export declare const MAX_KNOWLEDGE_SOURCES_SCRAPING_DEPTH = 3;
 /**
  * @@@
  * TODO: [🐝] !!! Use
+ *
+ * @public exported from `@promptbook/core`
  */
 export declare const MAX_KNOWLEDGE_SOURCES_SCRAPING_TOTAL = 200;
 /**
  * Where to store the cache of executions for promptbook CLI
+ *
+ * @public exported from `@promptbook/core`
  */
 export declare const EXECUTIONS_CACHE_DIRNAME = "/.promptbook/executions-cache";
 /**
  * The name of the builded pipeline collection made by CLI `ptbk make` and for lookup in `createCollectionFromDirectory`
+ *
+ * @public exported from `@promptbook/core`
  */
 export declare const PIPELINE_COLLECTION_BASE_FILENAME = "index";
 /**
@@ -42,20 +60,28 @@ export declare const PIPELINE_COLLECTION_BASE_FILENAME = "index";
 export declare const REPLACING_NONCE = "u$k42k%!V2zo34w7Fu#@QUHYPW";
 /**
  * The names of the parameters that are reserved for special purposes
+ *
+ * @public exported from `@promptbook/core`
  */
 export declare const RESERVED_PARAMETER_NAMES: readonly ["content", "context", "knowledge", "samples", "modelName", "currentDate"];
 /**
  * @@@
+ *
+ * @private within the repository
  */
 export declare const RESERVED_PARAMETER_MISSING_VALUE: string;
 /**
  * @@@
+ *
+ * @private within the repository
  */
 export declare const RESERVED_PARAMETER_RESTRICTED: string;
 /**
  * @@@
+ *
+ * @private within the repository
  */
 export declare const DEBUG_ALLOW_PAYED_TESTING: boolean;
 /**
- * TODO: [🔼] Export all to core
+ * TODO: !!!!!! Check that all @private contains some normalized explanation
  */

package/esm/typings/src/conversion/pipelineJsonToString.d.ts

@@ -5,6 +5,7 @@ import type { PipelineString } from '../types/PipelineString';
  *
  * @param pipelineJson Promptbook in JSON format (.ptbk.json)
  * @returns Promptbook in string format (.ptbk.md)
+ * @public exported from `@promptbook/core`
  */
 export declare function pipelineJsonToString(pipelineJson: PipelineJson): PipelineString;
 /**

package/esm/typings/src/conversion/pipelineStringToJson.d.ts

@@ -3,6 +3,8 @@ import type { PipelineJson } from '../types/PipelineJson/PipelineJson';
 import type { PipelineString } from '../types/PipelineString';
 /**
  * Options for `pipelineStringToJson`
+ *
+ * @public exported from `@promptbook/core`
  */
 export type PipelineStringToJsonOptions = {
     /**
@@ -20,13 +22,14 @@ export type PipelineStringToJsonOptions = {
  * - `pipelineStringToJsonSync` - use only if you need to compile promptbook synchronously and it contains NO external knowledge
  * - `preparePipeline` - just one step in the compilation process
  *
+ * Note: This function does not validate logic of the pipeline only the syntax
+ * Note: This function acts as compilation process
+ *
  * @param pipelineString {Promptbook} in string markdown format (.ptbk.md)
  * @param options - Options and tools for the compilation
  * @returns {Promptbook} compiled in JSON format (.ptbk.json)
  * @throws {ParsingError} if the promptbook string is not valid
- *
- * Note: This function does not validate logic of the pipeline only the syntax
- * Note: This function acts as compilation process
+ * @public exported from `@promptbook/core`
  */
 export declare function pipelineStringToJson(pipelineString: PipelineString, options?: PipelineStringToJsonOptions): Promise<PipelineJson>;
 /**

package/esm/typings/src/conversion/pipelineStringToJsonSync.d.ts

@@ -8,12 +8,13 @@ import type { PipelineString } from '../types/PipelineString';
  * - `pipelineStringToJsonSync` - use only if you need to compile promptbook synchronously and it contains NO external knowledge
  * - `preparePipeline` - just one step in the compilation process
  *
+ * Note: This function does not validate logic of the pipeline only the syntax
+ * Note: This function acts as compilation process
+ *
  * @param pipelineString {Promptbook} in string markdown format (.ptbk.md)
  * @returns {Promptbook} compiled in JSON format (.ptbk.json)
  * @throws {ParsingError} if the promptbook string is not valid
- *
- * Note: This function does not validate logic of the pipeline only the syntax
- * Note: This function acts as compilation process
+ * @public exported from `@promptbook/core`
  */
 export declare function pipelineStringToJsonSync(pipelineString: PipelineString): PipelineJson;
 /**

package/esm/typings/src/conversion/prettify/prettifyPipelineString.d.ts

@@ -2,6 +2,8 @@ import type { PipelineString } from '../../types/PipelineString';
 import type { PrettifyOptions } from './PrettifyOptions';
 /**
  * Prettyfies Promptbook string and adds Mermaid graph
+ *
+ * @public exported from `@promptbook/core`
  */
 export declare function prettifyPipelineString(pipelineString: PipelineString, options: PrettifyOptions): Promise<PipelineString>;
 /**

package/esm/typings/src/conversion/prettify/renderPipelineMermaidOptions.d.ts

@@ -17,6 +17,8 @@ export type renderPipelineMermaidOptions = {
  * Creates a Mermaid graph based on the promptbook
  *
  * Note: The result is not wrapped in a Markdown code block
+ *
+ * @public exported from `@promptbook/utils`
  */
 export declare function renderPromptbookMermaid(pipelineJson: PipelineJson, options?: renderPipelineMermaidOptions): string;
 /**

package/esm/typings/src/conversion/utils/extractParameterNamesFromPromptTemplate.d.ts

@@ -6,6 +6,7 @@ import type { string_parameter_name } from '../../types/typeAliases';
  * @param promptTemplate the template with used parameters
  * @returns the set of parameter names
  * @throws {ParsingError} if the script is invalid
+ * @public exported from `@promptbook/utils`
  */
 export declare function extractParameterNamesFromPromptTemplate(promptTemplate: Pick<PromptTemplateJson, 'title' | 'description' | 'blockType' | 'content' | 'preparedContent' | 'jokerParameterNames'>): Set<string_parameter_name>;
 /**

package/esm/typings/src/conversion/utils/extractVariables.d.ts

@@ -6,6 +6,7 @@ import type { string_javascript_name } from '../../types/typeAliases';
  * @param script from which to extract the variables
  * @returns the list of variable names
  * @throws {ParsingError} if the script is invalid
+ * @public exported from `@promptbook/utils`
  */
 export declare function extractVariables(script: string_javascript): Set<string_javascript_name>;
 /**

package/esm/typings/src/conversion/utils/renameParameter.d.ts

@@ -20,6 +20,7 @@ type RenameParameterOptions = {
  * In other words, it will find all parameters that are not used in the prompt template itseld and all its dependencies
  *
  * @throws {PipelineLogicError} If the new parameter name is already used in the pipeline
+ * @public exported from `@promptbook/utils`
  */
 export declare function renameParameter(options: RenameParameterOptions): PipelineJson;
 export {};

package/esm/typings/src/conversion/utils/stringifyPipelineJson.d.ts

@@ -4,6 +4,8 @@ import type { string_json } from '../../types/typeAliases';
  *
  * Note: [0] It can be used for more JSON types like whole collection of pipelines, single knowledge piece, etc.
  * Note: In contrast to JSON.stringify, this function ensures that **embedding index** is on single line
+ *
+ * @public exported from `@promptbook/core`
  */
 export declare function stringifyPipelineJson<TType>(pipeline: TType): string_json<TType>;
 /**

package/esm/typings/src/conversion/utils/titleToName.d.ts

@@ -1,4 +1,9 @@
 /**
- * Function normalizes title to name which can be used as identifier
+ * @@@
+ *
+ * @param value @@@
+ * @returns @@@
+ * @example @@@
+ * @public exported from `@promptbook/utils`
  */
 export declare function titleToName(value: string): string;

package/esm/typings/src/conversion/validation/validatePipeline.d.ts

@@ -12,6 +12,7 @@ import type { PipelineJson } from '../../types/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;
 /**

package/esm/typings/src/errors/CollectionError.d.ts

@@ -1,5 +1,7 @@
 /**
  * This error indicates that the pipeline collection cannot be propperly loaded
+ *
+ * @public exported from `@promptbook/core`
  */
 export declare class CollectionError extends Error {
     readonly name = "CollectionError";

package/esm/typings/src/errors/EnvironmentMismatchError.d.ts

@@ -1,5 +1,7 @@
 /**
  * This error type indicates that you try to use a feature that is not available in the current environment
+ *
+ * @public exported from `@promptbook/core`
  */
 export declare class EnvironmentMismatchError extends Error {
     readonly name = "EnvironmentMismatchError";

package/esm/typings/src/errors/LimitReachedError.d.ts

@@ -1,5 +1,7 @@
 /**
  * This error type indicates that some limit was reached
+ *
+ * @public exported from `@promptbook/core`
  */
 export declare class LimitReachedError extends Error {
     readonly name = "LimitReachedError";

package/esm/typings/src/errors/NotFoundError.d.ts

@@ -1,5 +1,7 @@
 /**
  * This error indicates that promptbook not found in the collection
+ *
+ * @public exported from `@promptbook/core`
  */
 export declare class NotFoundError extends Error {
     readonly name = "NotFoundError";

package/esm/typings/src/errors/NotYetImplementedError.d.ts

@@ -1,5 +1,7 @@
 /**
  * This error type indicates that some part of the code is not implemented yet
+ *
+ * @public exported from `@promptbook/core`
  */
 export declare class NotYetImplementedError extends Error {
     readonly name = "NotYetImplementedError";

package/esm/typings/src/errors/ParsingError.d.ts

@@ -1,5 +1,7 @@
 /**
  * This error indicates that the promptbook in a markdown format cannot be parsed into a valid promptbook object
+ *
+ * @public exported from `@promptbook/core`
  */
 export declare class ParsingError extends Error {
     readonly name = "ParsingError";

package/esm/typings/src/errors/PipelineExecutionError.d.ts

@@ -1,5 +1,7 @@
 /**
  * This error indicates errors during the execution of the pipeline
+ *
+ * @public exported from `@promptbook/core`
  */
 export declare class PipelineExecutionError extends Error {
     readonly name = "PipelineExecutionError";

package/esm/typings/src/errors/PipelineLogicError.d.ts

@@ -1,5 +1,7 @@
 /**
  * This error indicates that the promptbook object has valid syntax but contains logical errors (like circular dependencies)
+ *
+ * @public exported from `@promptbook/core`
  */
 export declare class PipelineLogicError extends Error {
     readonly name = "PipelineLogicError";

package/esm/typings/src/errors/ReferenceError.d.ts

@@ -1,5 +1,7 @@
 /**
  * This error indicates errors in referencing promptbooks between each other
+ *
+ * @public exported from `@promptbook/core`
  */
 export declare class ReferenceError extends Error {
     readonly name = "ReferenceError";

package/esm/typings/src/errors/UnexpectedError.d.ts

@@ -1,5 +1,7 @@
 /**
  * This error type indicates that the error should not happen and its last check before crashing with some other error
+ *
+ * @public exported from `@promptbook/core`
  */
 export declare class UnexpectedError extends Error {
     readonly name = "UnexpectedError";

package/esm/typings/src/errors/VersionMismatchError.d.ts

@@ -1,6 +1,8 @@
 import type { string_semantic_version } from '../types/typeAliases';
 /**
  * This error type indicates that the version of the pipeline is not matching the expected version
+ *
+ * @public exported from `@promptbook/core`
  */
 export declare class VersionMismatchError extends Error {
     readonly name = "UnexpectedError";

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

@@ -4,6 +4,7 @@ import type { PipelineExecutor } from './PipelineExecutor';
  *
  * @param executionResult - The partial result of the promptnook execution
  * @throws {PipelineExecutionError} If the execution is not successful or if multiple errors occurred
+ * @public exported from `@promptbook/core`
  */
 export declare function assertsExecutionSuccessful(executionResult: Pick<Awaited<ReturnType<PipelineExecutor>>, 'isSuccessful' | 'errors'>): void;
 /**

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

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

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

@@ -1,5 +1,7 @@
 import type { EmbeddingVector } from './EmbeddingVector';
 /**
  * Pretty print an embedding vector for logging
+ *
+ * @public exported from `@promptbook/core`
  */
 export declare function embeddingVectorToString(embeddingVector: EmbeddingVector): string;

package/esm/typings/src/execution/utils/addUsage.d.ts

@@ -2,7 +2,7 @@ import type { PromptResultUsage } from '../PromptResultUsage';
 /**
  * @@@
  *
- * TODO: [🔼] Export with addUsage
+ * @public exported from `@promptbook/core`
  */
 export declare const ZERO_USAGE: import("type-fest/source/readonly-deep").ReadonlyObjectDeep<{
     readonly price: {
@@ -59,5 +59,7 @@ export declare const ZERO_USAGE: import("type-fest/source/readonly-deep").Readon
  * Function `addUsage` will add multiple usages into one
  *
  * Note: If you provide 0 values, it returns ZERO_USAGE
+ *
+ * @public exported from `@promptbook/core`
  */
 export declare function addUsage(...usageItems: Array<PromptResultUsage>): PromptResultUsage;

package/esm/typings/src/execution/utils/checkExpectations.d.ts

@@ -8,6 +8,7 @@ import type { Expectations } from '../../types/PipelineJson/Expectations';
  *
  * @throws {ExpectError} if the expectations are not met
  * @returns {void} Nothing
+ * @public exported from `@promptbook/core`
  */
 export declare function checkExpectations(expectations: Expectations, value: string): void;
 /**
@@ -18,6 +19,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;
 /**

package/esm/typings/src/execution/utils/forEachAsync.d.ts

@@ -13,6 +13,7 @@ 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`
  */
 export declare function forEachAsync<TItem>(array: Array<TItem>, options: ForEachAsyncOptions, callbackfunction: (value: TItem, index: number, array: Array<TItem>) => Promisable<void>): Promise<void>;
 export {};

package/esm/typings/src/execution/utils/usageToHuman.d.ts

@@ -2,6 +2,8 @@ import type { string_markdown } from '../../types/typeAliases';
 import type { PromptResultUsage } from '../PromptResultUsage';
 /**
  * Function `usageToHuman` will take usage and convert it to human readable report
+ *
+ * @public exported from `@promptbook/core`
  */
 export declare function usageToHuman(usage: PromptResultUsage): string_markdown;
 /**

package/esm/typings/src/execution/utils/usageToWorktime.d.ts

@@ -6,5 +6,7 @@ import type { UncertainNumber } from '../UncertainNumber';
  * Note: This is an estimate based of theese sources:
  * - https://jecas.cz/doba-cteni
  * - https://www.originalnitonery.cz/blog/psani-vsemi-deseti-se-muzete-naucit-i-sami-doma
+ *
+ * @public exported from `@promptbook/core`
  */
 export declare function usageToWorktime(usage: PromptResultUsage): UncertainNumber;

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

@@ -4,6 +4,7 @@ import type { string_name } from '../../types/typeAliases';
  * A format definition is a set of functions that define how to validate, heal and convert response from LLM
  *
  * @see https://github.com/webgptorg/promptbook/discussions/36
+ * @private still an internal experimental
  */
 export type FormatDefinition<TValue extends TPartialValue, TPartialValue extends string, TSchema extends object> = {
     /**
@@ -66,4 +67,4 @@ export type FormatDefinition<TValue extends TPartialValue, TPartialValue extends
  * TODO: [🍓][🧠] Should execution tools be aviable to heal, canBeValid and isValid?
  * TODO: [🍓][🧠] llm Provider Bindings
  * TODO: [🍓][🔼] Export via some package
- */ 
+ */

package/esm/typings/src/formats/json/utils/isValidJsonString.d.ts

@@ -1,4 +1,6 @@
 /**
  * Function isValidJsonString will tell you if the string is valid JSON or not
+ *
+ * @public exported from `@promptbook/utils`
  */
 export declare function isValidJsonString(value: string): boolean;

package/esm/typings/src/knowledge/dialogs/callback/CallbackInterfaceTools.d.ts

@@ -4,6 +4,8 @@ import type { CallbackInterfaceToolsOptions } from './CallbackInterfaceToolsOpti
 /**
  * Delagates the user interaction to a async callback function
  * You need to provide your own implementation of this callback function and its bind to UI.
+ *
+ * @public exported from `@promptbook/core`
  */
 export declare class CallbackInterfaceTools implements UserInterfaceTools {
     private readonly options;

package/esm/typings/src/knowledge/dialogs/callback/CallbackInterfaceToolsOptions.d.ts

@@ -3,6 +3,8 @@ import type { CommonExecutionToolsOptions } from '../../../execution/CommonExecu
 import type { UserInterfaceToolsPromptDialogOptions } from '../../../execution/UserInterfaceTools';
 /**
  * Options for `CallbackInterfaceTools`
+ *
+ * @public exported from `@promptbook/core`
  */
 export type CallbackInterfaceToolsOptions = CommonExecutionToolsOptions & {
     /**

package/esm/typings/src/knowledge/dialogs/simple-prompt/SimplePromptInterfaceTools.d.ts

@@ -6,6 +6,8 @@ import type { UserInterfaceToolsPromptDialogOptions } from '../../../execution/U
  *
  * Warning: It is used for testing and mocking
  *          **NOT intended to use in the production** due to its synchronous nature.
+ *
+ * @public exported from `@promptbook/core`
  */
 export declare class SimplePromptInterfaceTools implements UserInterfaceTools {
     private readonly options;
@@ -17,4 +19,4 @@ export declare class SimplePromptInterfaceTools implements UserInterfaceTools {
 }
 /**
  * Note: [🔵] This code should never be published outside of `@promptbook/browser`
- */ 
+ */

package/esm/typings/src/knowledge/prepare-knowledge/_common/Scraper.d.ts

@@ -7,6 +7,11 @@ import type { string_mime_type } from '../../../types/typeAliases';
 import type { string_mime_type_with_wildcard } from '../../../types/typeAliases';
 import type { string_promptbook_documentation_url } from '../../../types/typeAliases';
 import type { really_unknown } from '../../../utils/organization/really_unknown';
+/**
+ * @@@
+ *
+ * @private still an internal experimental
+ */
 export type Scraper = {
     readonly description: string_markdown_text;
     readonly documentationUrl: string_promptbook_documentation_url;
@@ -14,6 +19,11 @@ export type Scraper = {
     readonly mimeTypes: Array<string_mime_type_with_wildcard>;
     scrape(source: ScraperSourceOptions): Promisable<string_markdown>;
 };
+/**
+ * @@@
+ *
+ * @private still an internal experimental
+ */
 export type ScraperSourceOptions = {
     readonly source: string_knowledge_source_link;
     readonly mimeType: string_mime_type;

package/esm/typings/src/knowledge/prepare-knowledge/_common/prepareKnowledgePieces.d.ts

@@ -5,10 +5,10 @@ import type { KnowledgeSourceJson } from '../../../types/PipelineJson/KnowledgeS
  * Prepares the knowle
  *
  * @see https://github.com/webgptorg/promptbook/discussions/41
+ * @public exported from `@promptbook/core`
  */
 export declare function prepareKnowledgePieces(knowledgeSources: Array<KnowledgeSourceJson>, options: PrepareOptions): Promise<Array<Omit<KnowledgePiecePreparedJson, 'preparationIds'>>>;
 /**
- * TODO: [🐝][🔼] !!! Export via `@promptbook/core`
  * TODO: [🧊] In future one preparation can take data from previous preparation and save tokens and time
  *       Put `knowledgePieces` into `PrepareKnowledgeOptions`
  * TODO: [🪂] More than max things can run in parallel by acident [1,[2a,2b,_],[3a,3b,_]]

package/esm/typings/src/knowledge/prepare-knowledge/markdown/prepareKnowledgeFromMarkdown.d.ts

@@ -3,6 +3,8 @@ import type { KnowledgePiecePreparedJson } from '../../../types/PipelineJson/Kno
 import type { string_markdown } from '../../../types/typeAliases';
 /**
  * @@@
+ *
+ * @public exported from `@promptbook/core`
  */
 export declare function prepareKnowledgeFromMarkdown(knowledgeContent: string_markdown, options: PrepareOptions): Promise<Array<Omit<KnowledgePiecePreparedJson, 'sources' | 'preparationIds'>>>;
 /**

package/esm/typings/src/llm-providers/_common/createLlmToolsFromEnv.d.ts

@@ -1,4 +1,7 @@
 import type { LlmExecutionTools } from '../../execution/LlmExecutionTools';
+/**
+ * @privxxate <- TODO: !!!!!! Warn that not private or exported
+ */
 export type CreateLlmToolsFromEnvOptions = {
     /**
      * This will will be passed to the created `LlmExecutionTools`
@@ -19,11 +22,11 @@ export type CreateLlmToolsFromEnvOptions = {
  * - `process.env.ANTHROPIC_CLAUDE_API_KEY`
  *
  * @returns @@@
+ * @public exported from `@promptbook/node`
  */
 export declare function createLlmToolsFromEnv(options?: CreateLlmToolsFromEnvOptions): LlmExecutionTools;
 /**
  * TODO: [🍜] Use `createLlmToolsFromConfiguration`
- * TODO: [🔼] !!! Export via `@promptbook/node`
  * TODO: @@@ write discussion about this - wizzard
  * TODO: Add Azure
  * TODO: [🧠] Which name is better `createLlmToolsFromEnv` or `createLlmToolsFromEnvironment`?

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

@@ -7,10 +7,10 @@ import type { CacheLlmToolsOptions } from './CacheLlmToolsOptions';
  *
  * @param llmTools LLM tools to be intercepted with usage counting, it can contain extra methods like `totalUsage`
  * @returns LLM tools with same functionality with added total cost counting
+ * @public exported from `@promptbook/core`
  */
 export declare function cacheLlmTools<TLlmTools extends LlmExecutionTools>(llmTools: TLlmTools, options?: Partial<CacheLlmToolsOptions>): TLlmTools;
 /**
- * TODO: [🔼] !!! Export via `@promptbook/core`
  * 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

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

@@ -5,10 +5,10 @@ import type { LlmExecutionToolsWithTotalUsage } from './LlmExecutionToolsWithTot
  *
  * @param llmTools LLM tools to be intercepted with usage counting
  * @returns LLM tools with same functionality with added total cost counting
+ * @public exported from `@promptbook/core`
  */
 export declare function countTotalUsage(llmTools: LlmExecutionTools): LlmExecutionToolsWithTotalUsage;
 /**
- * TODO: [🔼] !!! Export via `@promptbookcore/`
  * 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: [🧠][🌯] Maybe a way how to hide ability to `get totalUsage`