@promptbook/node 0.66.0 → 0.67.0-1

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

@@ -27,15 +27,15 @@ import { stringifyPipelineJson } from '../conversion/utils/stringifyPipelineJson
 import { validatePipeline } from '../conversion/validation/validatePipeline';
 import { CollectionError } from '../errors/CollectionError';
 import { EnvironmentMismatchError } from '../errors/EnvironmentMismatchError';
+import { ERRORS } from '../errors/index';
 import { LimitReachedError } from '../errors/LimitReachedError';
 import { NotFoundError } from '../errors/NotFoundError';
 import { NotYetImplementedError } from '../errors/NotYetImplementedError';
 import { ParsingError } from '../errors/ParsingError';
 import { PipelineExecutionError } from '../errors/PipelineExecutionError';
 import { PipelineLogicError } from '../errors/PipelineLogicError';
-import { ReferenceError } from '../errors/ReferenceError';
+import { PipelineUrlError } from '../errors/PipelineUrlError';
 import { UnexpectedError } from '../errors/UnexpectedError';
-import { VersionMismatchError } from '../errors/VersionMismatchError';
 import { assertsExecutionSuccessful } from '../execution/assertsExecutionSuccessful';
 import { createPipelineExecutor } from '../execution/createPipelineExecutor';
 import { embeddingVectorToString } from '../execution/embeddingVectorToString';
@@ -99,15 +99,15 @@ export { stringifyPipelineJson };
 export { validatePipeline };
 export { CollectionError };
 export { EnvironmentMismatchError };
+export { ERRORS };
 export { LimitReachedError };
 export { NotFoundError };
 export { NotYetImplementedError };
 export { ParsingError };
 export { PipelineExecutionError };
 export { PipelineLogicError };
-export { ReferenceError };
+export { PipelineUrlError };
 export { UnexpectedError };
-export { VersionMismatchError };
 export { assertsExecutionSuccessful };
 export { createPipelineExecutor };
 export { embeddingVectorToString };

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

@@ -10,6 +10,7 @@ import type { ExpectFormatCommand } from '../commands/EXPECT/ExpectFormatCommand
 import type { PipelineStringToJsonOptions } from '../conversion/pipelineStringToJson';
 import type { PrettifyOptions } from '../conversion/prettify/PrettifyOptions';
 import type { renderPipelineMermaidOptions } from '../conversion/prettify/renderPipelineMermaidOptions';
+import type { ErrorJson } from '../errors/utils/ErrorJson';
 import type { AvailableModel } from '../execution/AvailableModel';
 import type { CommonExecutionToolsOptions } from '../execution/CommonExecutionToolsOptions';
 import type { EmbeddingVector } from '../execution/EmbeddingVector';
@@ -17,7 +18,7 @@ import type { ExecutionTools } from '../execution/ExecutionTools';
 import type { LlmExecutionTools } from '../execution/LlmExecutionTools';
 import type { LlmExecutionToolsConstructor } from '../execution/LlmExecutionToolsConstructor';
 import type { PipelineExecutor } from '../execution/PipelineExecutor';
-import type { PipelineExecutorResult } from '../execution/PipelineExecutor';
+import type { PipelineExecutorResult } from '../execution/PipelineExecutorResult';
 import type { PromptResult } from '../execution/PromptResult';
 import type { CompletionPromptResult } from '../execution/PromptResult';
 import type { ChatPromptResult } from '../execution/PromptResult';
@@ -63,6 +64,7 @@ import type { JavascriptExecutionToolsOptions } from '../scripting/javascript/Ja
 import type { PostprocessingFunction } from '../scripting/javascript/JavascriptExecutionToolsOptions';
 import type { PromptbookStorage } from '../storage/_common/PromptbookStorage';
 import type { FilesStorageOptions } from '../storage/files-storage/FilesStorageOptions';
+import type { ExecutionPromptReportJson } from '../types/execution-report/ExecutionPromptReportJson';
 import type { ExecutionReportJson } from '../types/execution-report/ExecutionReportJson';
 import type { ExecutionReportString } from '../types/execution-report/ExecutionReportString';
 import type { ExecutionReportStringOptions } from '../types/execution-report/ExecutionReportStringOptions';
@@ -177,6 +179,7 @@ import type { string_translate_name } from '../types/typeAliases';
 import type { string_translate_name_not_normalized } from '../types/typeAliases';
 import type { string_translate_language } from '../types/typeAliases';
 import type { string_javascript_name } from '../types/typeAliases';
+import type { string_postprocessing_function_name } from '../types/typeAliases';
 import type { string_token } from '../types/typeAliases';
 import type { string_license_token } from '../types/typeAliases';
 import type { string_password } from '../types/typeAliases';
@@ -233,6 +236,7 @@ export type { ExpectFormatCommand };
 export type { PipelineStringToJsonOptions };
 export type { PrettifyOptions };
 export type { renderPipelineMermaidOptions };
+export type { ErrorJson };
 export type { AvailableModel };
 export type { CommonExecutionToolsOptions };
 export type { EmbeddingVector };
@@ -286,6 +290,7 @@ export type { JavascriptExecutionToolsOptions };
 export type { PostprocessingFunction };
 export type { PromptbookStorage };
 export type { FilesStorageOptions };
+export type { ExecutionPromptReportJson };
 export type { ExecutionReportJson };
 export type { ExecutionReportString };
 export type { ExecutionReportStringOptions };
@@ -400,6 +405,7 @@ export type { string_translate_name };
 export type { string_translate_name_not_normalized };
 export type { string_translate_language };
 export type { string_javascript_name };
+export type { string_postprocessing_function_name };
 export type { string_token };
 export type { string_license_token };
 export type { string_password };

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

@@ -4,14 +4,12 @@ import { extractParameterNamesFromPromptTemplate } from '../conversion/utils/ext
 import { extractVariables } from '../conversion/utils/extractVariables';
 import { renameParameter } from '../conversion/utils/renameParameter';
 import { titleToName } from '../conversion/utils/titleToName';
+import { deserializeError } from '../errors/utils/deserializeError';
+import { serializeError } from '../errors/utils/serializeError';
 import { forEachAsync } from '../execution/utils/forEachAsync';
 import { isValidJsonString } from '../formats/json/utils/isValidJsonString';
 import { extractBlock } from '../postprocessing/utils/extractBlock';
 import { $currentDate } from '../utils/$currentDate';
-import { clonePipeline } from '../utils/clonePipeline';
-import { deepClone } from '../utils/deepClone';
-import { $deepFreeze } from '../utils/deepFreeze';
-import { $getGlobalScope } from '../utils/environment/$getGlobalScope';
 import { $isRunningInBrowser } from '../utils/environment/$isRunningInBrowser';
 import { $isRunningInNode } from '../utils/environment/$isRunningInNode';
 import { $isRunningInWebWorker } from '../utils/environment/$isRunningInWebWorker';
@@ -51,6 +49,11 @@ import { $randomSeed } from '../utils/random/$randomSeed';
 import { removeEmojis } from '../utils/removeEmojis';
 import { removeQuotes } from '../utils/removeQuotes';
 import { replaceParameters } from '../utils/replaceParameters';
+import { $deepFreeze } from '../utils/serialization/$deepFreeze';
+import { checkSerializableAsJson } from '../utils/serialization/checkSerializableAsJson';
+import { clonePipeline } from '../utils/serialization/clonePipeline';
+import { deepClone } from '../utils/serialization/deepClone';
+import { isSerializableAsJson } from '../utils/serialization/isSerializableAsJson';
 import { difference } from '../utils/sets/difference';
 import { intersection } from '../utils/sets/intersection';
 import { union } from '../utils/sets/union';
@@ -73,14 +76,12 @@ export { extractParameterNamesFromPromptTemplate };
 export { extractVariables };
 export { renameParameter };
 export { titleToName };
+export { deserializeError };
+export { serializeError };
 export { forEachAsync };
 export { isValidJsonString };
 export { extractBlock };
 export { $currentDate };
-export { clonePipeline };
-export { deepClone };
-export { $deepFreeze };
-export { $getGlobalScope };
 export { $isRunningInBrowser };
 export { $isRunningInNode };
 export { $isRunningInWebWorker };
@@ -120,6 +121,11 @@ export { $randomSeed };
 export { removeEmojis };
 export { removeQuotes };
 export { replaceParameters };
+export { $deepFreeze };
+export { checkSerializableAsJson };
+export { clonePipeline };
+export { deepClone };
+export { isSerializableAsJson };
 export { difference };
 export { intersection };
 export { union };

package/esm/typings/src/commands/EXPECT/ExpectFormatCommand.d.ts

@@ -1,5 +1,7 @@
 /**
  * Represents a command that expects a specific format.
+ *
+ * Note: [🚉] This is fully serializable as JSON
  */
 export type ExpectFormatCommand = {
     readonly type: 'EXPECT_FORMAT';

package/esm/typings/src/errors/{ReferenceError.d.ts → PipelineUrlError.d.ts}

@@ -3,7 +3,7 @@
  *
  * @public exported from `@promptbook/core`
  */
-export declare class ReferenceError extends Error {
-    readonly name = "ReferenceError";
+export declare class PipelineUrlError extends Error {
+    readonly name = "PipelineUrlError";
     constructor(message: string);
 }

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

@@ -0,0 +1,27 @@
+import { CollectionError } from './CollectionError';
+import { EnvironmentMismatchError } from './EnvironmentMismatchError';
+import { LimitReachedError } from './LimitReachedError';
+import { NotFoundError } from './NotFoundError';
+import { NotYetImplementedError } from './NotYetImplementedError';
+import { ParsingError } from './ParsingError';
+import { PipelineExecutionError } from './PipelineExecutionError';
+import { PipelineLogicError } from './PipelineLogicError';
+import { PipelineUrlError } from './PipelineUrlError';
+import { UnexpectedError } from './UnexpectedError';
+/**
+ * Index of all custom errors
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare const ERRORS: {
+    readonly CollectionError: typeof CollectionError;
+    readonly EnvironmentMismatchError: typeof EnvironmentMismatchError;
+    readonly LimitReachedError: typeof LimitReachedError;
+    readonly NotFoundError: typeof NotFoundError;
+    readonly NotYetImplementedError: typeof NotYetImplementedError;
+    readonly ParsingError: typeof ParsingError;
+    readonly PipelineExecutionError: typeof PipelineExecutionError;
+    readonly PipelineLogicError: typeof PipelineLogicError;
+    readonly PipelineUrlError: typeof PipelineUrlError;
+    readonly UnexpectedError: typeof UnexpectedError;
+};

package/esm/typings/src/errors/utils/ErrorJson.d.ts

@@ -0,0 +1,20 @@
+import type { ERRORS } from '../index';
+/**
+ * Represents a serialized error or custom Promptbook error
+ *
+ * Note: [🚉] This is fully serializable as JSON
+ */
+export type ErrorJson = {
+    /**
+     * The type of the error
+     */
+    readonly name: keyof typeof ERRORS | 'Error';
+    /**
+     * The message of the error
+     */
+    readonly message: string;
+    /**
+     * The stack trace of the error
+     */
+    readonly stack?: string;
+};

package/esm/typings/src/errors/utils/deserializeError.d.ts

@@ -0,0 +1,7 @@
+import type { ErrorJson } from './ErrorJson';
+/**
+ * Deserializes the error object
+ *
+ * @public exported from `@promptbook/utils`
+ */
+export declare function deserializeError(error: ErrorJson): Error;

package/esm/typings/src/errors/utils/deserializeError.test.d.ts

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

package/esm/typings/src/errors/utils/serializeError.d.ts

@@ -0,0 +1,7 @@
+import type { ErrorJson } from './ErrorJson';
+/**
+ * Serializes an error into a [🚉] JSON-serializable object
+ *
+ * @public exported from `@promptbook/utils`
+ */
+export declare function serializeError(error: Error): ErrorJson;

package/esm/typings/src/errors/utils/serializeError.test.d.ts

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

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

@@ -11,7 +11,7 @@ export type ExecutionTools = {
     /**
      * Tools for executing prompts to large language models like GPT-4
      *
-     * Tip: Combine multiple LLM execution tools - use array of LlmExecutionTools instead of single LlmExecutionTools
+     * Tip: Use `createLlmToolsFromEnv()` to use all available LLM providers you configured
      * @see https://github.com/webgptorg/promptbook/?tab=readme-ov-file#llm-execution-tools
      */
     llm?: Arrayable<LlmExecutionTools>;
@@ -20,7 +20,10 @@ export type ExecutionTools = {
      *
      * Note: You can pass multiple ScriptExecutionTools, they will be tried one by one until one of them supports the script
      *       If none of them supports the script, an error is thrown
+     * Tip: Use here `new JavascriptExecutionTools()`
+     *
      * @see https://github.com/webgptorg/promptbook/?tab=readme-ov-file#script-execution-tools
+     * @default [] - If not provided, no script execution will be possible
      */
     script?: Arrayable<ScriptExecutionTools>;
     /**

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

@@ -1,64 +1,18 @@
 import type { Promisable } from 'type-fest';
-import type { PipelineJson } from '../types/PipelineJson/PipelineJson';
-import { PipelineExecutionError } from '../errors/PipelineExecutionError';
 import type { TaskProgress } from '../types/TaskProgress';
-import type { ExecutionReportJson } from '../types/execution-report/ExecutionReportJson';
 import type { Parameters } from '../types/typeAliases';
-import type { PromptResultUsage } from './PromptResultUsage';
+import type { PipelineExecutorResult } from './PipelineExecutorResult';
 /**
  * Executor is a simple async function that takes INPUT  PARAMETERs and returns result parameters _(along with all intermediate parameters and INPUT  PARAMETERs = it extends input object)_.
  * Executor is made by combining execution tools and pipeline collection.
  *
  * It can be created with `createPipelineExecutor` function.
  *
- * @@@ almost-JSON (what about errors)
- *
  * @see https://github.com/webgptorg/promptbook#executor
  */
 export type PipelineExecutor = {
     (inputParameters: Parameters, onProgress?: (taskProgress: TaskProgress) => Promisable<void>): Promise<PipelineExecutorResult>;
 };
-/**
- * @@@
- *
- * @@@ almost-JSON (what about errors)
- */
-export type PipelineExecutorResult = {
-    /**
-     * Result parameters of the execution
-     *
-     * Note: If the execution was not successful, there are only some of the result parameters
-     */
-    readonly outputParameters: Parameters;
-    /**
-     * Whether the execution was successful, details are aviable in `executionReport`
-     */
-    readonly isSuccessful: boolean;
-    /**
-     * Added usage of whole execution, detailed usage is aviable in `executionReport`
-     */
-    readonly usage: PromptResultUsage;
-    /**
-     * Errors that occured during the execution, details are aviable in `executionReport`
-     */
-    readonly errors: Array<PipelineExecutionError | Error>;
-    /**
-     * Warnings that occured during the execution, details are aviable in `executionReport`
-     */
-    readonly warnings: Array<PipelineExecutionError | Error>;
-    /**
-     * The report of the execution with all details
-     */
-    readonly executionReport: ExecutionReportJson;
-    /**
-     * The prepared pipeline that was used for the execution
-     *
-     * Note: If you called `createPipelineExecutor` with fully prepared pipeline, this is the same object as this pipeline
-     *       If you passed not fully prepared pipeline, this is same pipeline but fully prepared
-     */
-    readonly preparedPipeline: PipelineJson;
-};
 /**
  * TODO: [🧠] Should this file be in /execution or /types folder?
- * TODO: [💷] `assertsExecutionSuccessful` should be the method of `PipelineExecutor` result - BUT maybe NOT?
  */

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

@@ -0,0 +1,49 @@
+import type { ExecutionReportJson } from '../types/execution-report/ExecutionReportJson';
+import type { Parameters } from '../types/typeAliases';
+import type { PipelineJson } from '../types/PipelineJson/PipelineJson';
+import type { ErrorJson } from '../errors/utils/ErrorJson';
+import type { PromptResultUsage } from './PromptResultUsage';
+/**
+ * @@@
+ *
+ * Note: [🚉] This is fully serializable as JSON
+ */
+export type PipelineExecutorResult = {
+    /**
+     * Result parameters of the execution
+     *
+     * Note: If the execution was not successful, there are only some of the result parameters
+     */
+    readonly outputParameters: Parameters;
+    /**
+     * Whether the execution was successful, details are aviable in `executionReport`
+     */
+    readonly isSuccessful: boolean;
+    /**
+     * Added usage of whole execution, detailed usage is aviable in `executionReport`
+     */
+    readonly usage: PromptResultUsage;
+    /**
+     * Errors that occured during the execution, details are aviable in `executionReport`
+     */
+    readonly errors: Array<ErrorJson>;
+    /**
+     * Warnings that occured during the execution, details are aviable in `executionReport`
+     */
+    readonly warnings: Array<ErrorJson>;
+    /**
+     * The report of the execution with all details
+     */
+    readonly executionReport: ExecutionReportJson;
+    /**
+     * The prepared pipeline that was used for the execution
+     *
+     * Note: If you called `createPipelineExecutor` with fully prepared pipeline, this is the same object as this pipeline
+     *       If you passed not fully prepared pipeline, this is same pipeline but fully prepared
+     */
+    readonly preparedPipeline: PipelineJson;
+};
+/**
+ * TODO: [🧠] Should this file be in /execution or /types folder?
+ * TODO: [🧠] Maybe constrain `ErrorJson` -> `ErrorJson & { name: 'PipelineExecutionError' | 'Error' }`
+ */

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

@@ -15,19 +15,19 @@ export type PromptResult = CompletionPromptResult | ChatPromptResult | Embedding
  * Completion prompt result
  *
  * Note:It contains only the newly generated text NOT the whole completion
- * Note: This is fully serializable as JSON
+ * Note: [🚉] This is fully serializable as JSON
  */
 export type CompletionPromptResult = CommonPromptResult;
 /**
  *Chat prompt result
  *
- * Note: This is fully serializable as JSON
+ * Note: [🚉] This is fully serializable as JSON
  */
 export type ChatPromptResult = CommonPromptResult & {};
 /**
  * Embedding prompt  result
  *
- * Note: This is fully serializable as JSON
+ * Note: [🚉] This is fully serializable as JSON
  */
 export type EmbeddingPromptResult = Omit<CommonPromptResult, 'content'> & {
     /**
@@ -38,7 +38,7 @@ export type EmbeddingPromptResult = Omit<CommonPromptResult, 'content'> & {
 /**
  * Common properties for all prompt results
  *
- * Note: This is fully serializable as JSON
+ * Note: [🚉] This is fully serializable as JSON
  */
 export type CommonPromptResult = {
     /**

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

@@ -3,6 +3,8 @@ import type { ExpectationUnit } from '../types/PipelineJson/Expectations';
 import type { UncertainNumber } from './UncertainNumber';
 /**
  * Usage statistics for one or many prompt results
+ *
+ * Note: [🚉] This is fully serializable as JSON
  */
 export type PromptResultUsage = {
     /**
@@ -22,6 +24,8 @@ export type PromptResultUsage = {
 };
 /**
  * Record of all possible measurable units
+ *
+ * Note: [🚉] This is fully serializable as JSON
  */
 export type PromptResultUsageCounts = Record<`${KebabCase<'TOKENS' | ExpectationUnit>}Count`, UncertainNumber>;
 /**

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

@@ -3,6 +3,7 @@ import type { number_usd } from '../types/typeAliases';
 /**
  * Number which can be uncertain
  *
+ * Note: [🚉] This is fully serializable as JSON
  * Note: If the value is completelly unknown, the value 0 and isUncertain is true
  * Note: Not using NaN or null because it looses the value which is better to be uncertain then not to be at all
  */

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

@@ -1,8 +1,8 @@
 import type { PipelineExecutor } from './PipelineExecutor';
 /**
- * Asserts that the execution of a promptnook is successful
+ * Asserts that the execution of a Promptbook is successful
  *
- * @param executionResult - The partial result of the promptnook execution
+ * @param executionResult - The partial result of the Promptbook execution
  * @throws {PipelineExecutionError} If the execution is not successful or if multiple errors occurred
  * @public exported from `@promptbook/core`
  */

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

@@ -25,5 +25,4 @@ export type CacheItem = {
 };
 /**
  * TODO: [🧠] Should be this exported alongsite `cacheLlmTools` through `@promptbook/utils` OR through `@promptbook/types`
- * TODO: [🛫] `prompt` is NOT fully serializable as JSON, it contains functions which are not serializable, fix it
  */

package/esm/typings/src/llm-providers/mocked/$fakeTextToExpectations.d.ts

@@ -1,5 +1,5 @@
-import type { PostprocessingFunction } from '../../scripting/javascript/JavascriptExecutionToolsOptions';
 import type { Expectations } from '../../types/PipelineJson/Expectations';
+import type { string_postprocessing_function_name } from '../../types/typeAliases';
 /**
  * Gets the expectations and creates a fake text that meets the expectations
  *
@@ -9,7 +9,7 @@ import type { Expectations } from '../../types/PipelineJson/Expectations';
  *
  * @private internal utility for MockedFackedLlmExecutionTools
  */
-export declare function $fakeTextToExpectations(expectations: Expectations, postprocessing?: Array<PostprocessingFunction>): Promise<string>;
+export declare function $fakeTextToExpectations(expectations: Expectations, postprocessingFunctionNames?: Array<string_postprocessing_function_name>): Promise<string>;
 /**
  * TODO: [💝] Unite object for expecting amount and format - use here also a format
  */

package/esm/typings/src/llm-providers/mocked/MockedFackedLlmExecutionTools.d.ts

@@ -29,15 +29,15 @@ export declare class MockedFackedLlmExecutionTools implements LlmExecutionTools
     /**
      * Fakes chat model
      */
-    callChatModel(prompt: Pick<Prompt, 'content' | 'parameters' | 'modelRequirements' | 'expectations' | 'postprocessing'>): Promise<ChatPromptResult & CompletionPromptResult>;
+    callChatModel(prompt: Pick<Prompt, 'content' | 'parameters' | 'modelRequirements' | 'expectations' | 'postprocessingFunctionNames'>): Promise<ChatPromptResult & CompletionPromptResult>;
     /**
      * Fakes completion model
      */
-    callCompletionModel(prompt: Pick<Prompt, 'content' | 'parameters' | 'modelRequirements' | 'expectations' | 'postprocessing'>): Promise<CompletionPromptResult>;
+    callCompletionModel(prompt: Pick<Prompt, 'content' | 'parameters' | 'modelRequirements' | 'expectations' | 'postprocessingFunctionNames'>): Promise<CompletionPromptResult>;
     /**
      * Fakes embedding model
      */
-    callEmbeddingModel(prompt: Pick<Prompt, 'content' | 'parameters' | 'modelRequirements' | 'expectations' | 'postprocessing'>): Promise<EmbeddingPromptResult>;
+    callEmbeddingModel(prompt: Pick<Prompt, 'content' | 'parameters' | 'modelRequirements' | 'expectations' | 'postprocessingFunctionNames'>): Promise<EmbeddingPromptResult>;
 }
 /**
  * TODO: [🧠][🈁] Maybe use `isDeterministic` from options

package/esm/typings/src/llm-providers/remote/RemoteLlmExecutionTools.d.ts

@@ -54,6 +54,7 @@ export declare class RemoteLlmExecutionTools implements LlmExecutionTools {
     private callCommonModel;
 }
 /**
+ * TODO: Maybe use `$asDeeplyFrozenSerializableJson`
  * TODO: [🧠][🛍] Maybe not `isAnonymous: boolean` BUT `mode: 'ANONYMOUS'|'COLLECTION'`
  * TODO: [🍓] Allow to list compatible models with each variant
  * TODO: [🗯] RemoteLlmExecutionTools should extend Destroyable and implement IDestroyable

package/esm/typings/src/llm-providers/remote/interfaces/PromptbookServer_Error.d.ts

@@ -1,11 +1,7 @@
+import type { ErrorJson } from '../../../errors/utils/ErrorJson';
 /**
  * Socket.io error for remote text generation
  *
  * This is sent from server to client when error occurs and stops the process
  */
-export type PromptbookServer_Error = {
-    /**
-     * The error message which caused the error
-     */
-    readonly errorMessage: string;
-};
+export type PromptbookServer_Error = ErrorJson;

package/esm/typings/src/llm-providers/remote/startRemoteServer.d.ts

@@ -11,6 +11,7 @@ import type { RemoteServerOptions } from './interfaces/RemoteServerOptions';
  */
 export declare function startRemoteServer(options: RemoteServerOptions): IDestroyable;
 /**
+ * TODO: Maybe use `$asDeeplyFrozenSerializableJson`
  * TODO: [🧠][🛍] Maybe not `isAnonymous: boolean` BUT `mode: 'ANONYMOUS'|'COLLECTION'`
  * TODO: [⚖] Expose the collection to be able to connect to same collection via createCollectionFromUrl
  * TODO: Handle progress - support streaming

package/esm/typings/src/personas/preparePersona.d.ts

@@ -9,6 +9,7 @@ import type { string_persona_description } from '../types/typeAliases';
  */
 export declare function preparePersona(personaDescription: string_persona_description, options: PrepareOptions): Promise<PersonaPreparedJson['modelRequirements']>;
 /**
+ * TODO: [🔃] !!!!! If the persona was prepared with different version or different set of models, prepare it once again
  * TODO: [🏢] !! Check validity of `modelName` in pipeline
  * TODO: [🏢] !! Check validity of `systemMessage` in pipeline
  * TODO: [🏢] !! Check validity of `temperature` in pipeline

package/esm/typings/src/prepare/isPipelinePrepared.d.ts

@@ -6,6 +6,7 @@ import type { PipelineJson } from '../types/PipelineJson/PipelineJson';
  */
 export declare function isPipelinePrepared(pipeline: PipelineJson): boolean;
 /**
+ * TODO: [🔃] !!!!! If the pipeline was prepared with different version or different set of models, prepare it once again
  * TODO: [🐠] Maybe base this on `makeValidator`
  * TODO: [🧊] Pipeline can be partially prepared, this should return true ONLY if fully prepared
  * TODO: [🧿] Maybe do same process with same granularity and subfinctions as `preparePipeline`

package/esm/typings/src/scripting/javascript/JavascriptExecutionToolsOptions.d.ts

@@ -1,6 +1,6 @@
 import type { Promisable } from 'type-fest';
 import type { CommonExecutionToolsOptions } from '../../execution/CommonExecutionToolsOptions';
-import type { string_javascript_name } from '../../types/typeAliases';
+import type { string_postprocessing_function_name } from '../../types/typeAliases';
 /**
  * Options for `JavascriptExecutionTools`
  */
@@ -15,7 +15,7 @@ export type JavascriptExecutionToolsOptions = CommonExecutionToolsOptions & {
      * Note: There are also some built-in functions available:
      *      @see ./JavascriptEvalExecutionTools.ts
      */
-    functions?: Record<string_javascript_name, PostprocessingFunction>;
+    functions?: Record<string_postprocessing_function_name, PostprocessingFunction>;
 };
 /**
  * Function that can be used to postprocess the output of the LLM

package/esm/typings/src/storage/_common/PromptbookStorage.d.ts

@@ -20,5 +20,5 @@ export type PromptbookStorage<TItem> = {
     removeItem(key: string): Promisable<void>;
 };
 /**
- * TODO: [🧠][🛫] Constrain `TItem` to JSON-serializable objects only
+ * TODO: [💺] Constrain `TItem` to [🚉] JSON-serializable objects only in type level
  */

package/esm/typings/src/types/ModelRequirements.d.ts

@@ -7,14 +7,14 @@ import type { string_system_message } from './typeAliases';
  * Abstract way to specify the LLM.
  * It does not specify the LLM with concrete version itself, only the requirements for the LLM.
  *
- * Note: This is fully serializable as JSON
+ * Note: [🚉] This is fully serializable as JSON
  * @see https://github.com/webgptorg/promptbook#model-requirements
  */
 export type ModelRequirements = CompletionModelRequirements | ChatModelRequirements | EmbeddingModelRequirements;
 /**
  * Model requirements for the completion variant
  *
- * Note: This is fully serializable as JSON
+ * Note: [🚉] This is fully serializable as JSON
  */
 export type CompletionModelRequirements = CommonModelRequirements & {
     /**
@@ -25,7 +25,7 @@ export type CompletionModelRequirements = CommonModelRequirements & {
 /**
  * Model requirements for the chat variant
  *
- * Note: This is fully serializable as JSON
+ * Note: [🚉] This is fully serializable as JSON
  */
 export type ChatModelRequirements = CommonModelRequirements & {
     /**
@@ -40,7 +40,7 @@ export type ChatModelRequirements = CommonModelRequirements & {
 /**
  * Model requirements for the embedding variant
  *
- * Note: This is fully serializable as JSON
+ * Note: [🚉] This is fully serializable as JSON
  */
 export type EmbeddingModelRequirements = CommonModelRequirements & {
     /**
@@ -51,7 +51,7 @@ export type EmbeddingModelRequirements = CommonModelRequirements & {
 /**
  * Common properties for all model requirements variants
  *
- * Note: This is fully serializable as JSON
+ * Note: [🚉] This is fully serializable as JSON
  */
 export type CommonModelRequirements = {
     /**

package/esm/typings/src/types/PipelineJson/Expectations.d.ts

@@ -7,7 +7,7 @@ import type { number_positive } from '../typeAliases';
  * For example 5 words, 3 sentences, 2 paragraphs, ...
  *
  * Note: Expectations are performed after all postprocessing steps
- *
+ * Note: [🚉] This is fully serializable as JSON
  * @see https://github.com/webgptorg/promptbook/discussions/30
  */
 export type Expectations = Partial<Record<Lowercase<ExpectationUnit>, {
@@ -17,6 +17,7 @@ export type Expectations = Partial<Record<Lowercase<ExpectationUnit>, {
 /**
  * Unit of text measurement
  *
+ * Note: [🚉] This is fully serializable as JSON
  * @see https://github.com/webgptorg/promptbook/discussions/30
  */
 export type ExpectationUnit = TupleToUnion<typeof EXPECTATION_UNITS>;
@@ -30,6 +31,7 @@ export declare const EXPECTATION_UNITS: readonly ["CHARACTERS", "WORDS", "SENTEN
 /**
  * Amount of text measurement
  *
+ * Note: [🚉] This is fully serializable as JSON
  * @see https://github.com/webgptorg/promptbook/discussions/30
  */
 export type ExpectationAmount = number_integer & (number_positive | 0);