@promptbook/javascript 0.88.0-1

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

@@ -0,0 +1,30 @@
+import type { PipelineJson } from '../pipeline/PipelineJson/PipelineJson';
+import type { PipelineString } from '../pipeline/PipelineString';
+/**
+ * Compile pipeline from string (markdown) format to JSON format synchronously
+ *
+ * Note: There are 3 similar functions:
+ * - `compilePipeline` **(preferred)** - which propperly compiles the promptbook and use embedding for external knowledge
+ * - `parsePipeline` - 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 parsing
+ * Note: This function acts as compilation process
+ *
+ * @param pipelineString {Promptbook} in string markdown format (.book.md)
+ * @returns {Promptbook} compiled in JSON format (.bookc)
+ * @throws {ParseError} if the promptbook string is not valid
+ * @public exported from `@promptbook/core`
+ */
+export declare function parsePipeline(pipelineString: PipelineString): PipelineJson;
+/**
+ * TODO: [🧠] Maybe more things here can be refactored as high-level abstractions
+ * TODO: [main] !!4 Warn if used only sync version
+ * TODO: [🚞] Report here line/column of error
+ * TODO: Use spaceTrim more effectively
+ * TODO: [🧠] Parameter flags - isInput, isOutput, isInternal
+ * TODO: [🥞] Not optimal parsing because `splitMarkdownIntoSections` is executed twice with same string, once through `flattenMarkdown` and second directly here
+ * TODO: [♈] Probbably move expectations from tasks to parameters
+ * TODO: [🛠] Actions, instruments (and maybe knowledge) => Functions and tools
+ * TODO: [🍙] Make some standard order of json properties
+ */

package/esm/typings/src/conversion/parsePipeline.test.d.ts

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

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

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

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

@@ -0,0 +1,13 @@
+/**
+ * Options for `prettifyPipelineString` function
+ */
+export type PrettifyOptions = {
+    /***
+     * If true, adds Mermaid graph to the Promptbook string
+     */
+    readonly isGraphAdded?: boolean;
+    /**
+     * If true, the string is prettifyed as markdown
+     */
+    readonly isPrettifyed?: boolean;
+};

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

@@ -0,0 +1,12 @@
+import type { PipelineString } from '../../pipeline/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>;
+/**
+ * TODO: Maybe use some Mermaid package instead of string templating
+ * TODO: [🕌] When more than 2 functionalities, split into separate functions
+ */

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

@@ -0,0 +1,30 @@
+import type { PipelineJson } from '../../pipeline/PipelineJson/PipelineJson';
+import type { TaskJson } from '../../pipeline/PipelineJson/TaskJson';
+import type { string_href } from '../../types/typeAliases';
+/**
+ * Addtional options for rendering Mermaid graph
+ */
+export type renderPipelineMermaidOptions = {
+    /**
+     * Callback for creating from task graph node
+     */
+    linkTask?(task: TaskJson): {
+        href: string_href;
+        title: string;
+    } | null;
+};
+/**
+ * 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;
+/**
+ * TODO: [🧠] FOREACH in mermaid graph
+ * TODO: [🧠] Knowledge in mermaid graph
+ * TODO: [🧠] Personas in mermaid graph
+ * TODO: Maybe use some Mermaid package instead of string templating
+ * TODO: [🕌] When more than 2 functionalities, split into separate functions
+ */

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

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

package/esm/typings/src/conversion/utils/extractParameterNamesFromTask.test.d.ts

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

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

@@ -0,0 +1,23 @@
+import type { PipelineJson } from '../../pipeline/PipelineJson/PipelineJson';
+import type { PipelineString } from '../../pipeline/PipelineString';
+/**
+ * Import the pipeline.book or pipeline.bookc file
+ *
+ * Note: Using here custom import to work in jest tests
+ * Note: Using sync version is 💩 in the production code, but it's ok here in tests
+ *
+ * @param path - The path to the file relative to examples/pipelines directory
+ * @private internal function of tests
+ */
+export declare function importPipelineWithoutPreparation(path: `${string}.book`): Promise<PipelineString>;
+export declare function importPipelineWithoutPreparation(path: `${string}.bookc`): Promise<PipelineJson>;
+/**
+ * Import the pipeline.bookc file as parsed JSON
+ *
+ * @private internal function of tests
+ */
+export declare function importPipelineJson(path: `${string}.bookc`): Promise<PipelineJson>;
+/**
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ * Note: [⚫] Code in this file should never be published in any package
+ */

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

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

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

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

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

@@ -0,0 +1,42 @@
+import type { PipelineJson } from '../../pipeline/PipelineJson/PipelineJson';
+/**
+ * Validates PipelineJson if it is logically valid
+ *
+ * It checks:
+ * -   if it has correct parameters dependency
+ *
+ * It does NOT check:
+ * -   if it is valid json
+ * -   if it is meaningful
+ *
+ * @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;
+/**
+ * @private internal function for `validatePipeline`
+ */
+export declare function validatePipeline_InnerFunction(pipeline: PipelineJson): void;
+/**
+ * TODO: [🧞‍♀️] Do not allow joker + foreach
+ * TODO: [🧠] Work with promptbookVersion
+ * TODO: Use here some json-schema, Zod or something similar and change it to:
+ *     > /**
+ *     >  * Validates PipelineJson if it is logically valid.
+ *     >  *
+ *     >  * It checks:
+ *     >  * -   it has a valid structure
+ *     >  * -   ...
+ *     >  ex port function validatePipeline(promptbook: really_unknown): asserts promptbook is PipelineJson {
+ */
+/**
+ * TODO: [🧳][main] !!4 Validate that all examples match expectations
+ * TODO: [🧳][🐝][main] !!4 Validate that knowledge is valid (non-void)
+ * TODO: [🧳][main] !!4 Validate that persona can be used only with CHAT variant
+ * TODO: [🧳][main] !!4 Validate that parameter with reserved name not used RESERVED_PARAMETER_NAMES
+ * TODO: [🧳][main] !!4 Validate that reserved parameter is not used as joker
+ * TODO: [🧠] Validation not only logic itself but imports around - files and websites and rerefenced pipelines exists
+ * TODO: [🛠] Actions, instruments (and maybe knowledge) => Functions and tools
+ */

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

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

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

@@ -0,0 +1,17 @@
+import type { UserInterfaceTools } from '../../execution/UserInterfaceTools';
+import type { UserInterfaceToolsPromptDialogOptions } from '../../execution/UserInterfaceTools';
+import type { CallbackInterfaceToolsOptions } from './CallbackInterfaceToolsOptions';
+/**
+ * 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 {
+    protected readonly options: CallbackInterfaceToolsOptions;
+    constructor(options: CallbackInterfaceToolsOptions);
+    /**
+     * Trigger the custom callback function
+     */
+    promptDialog(options: UserInterfaceToolsPromptDialogOptions): Promise<string>;
+}

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

@@ -0,0 +1,14 @@
+import type { Promisable } from 'type-fest';
+import type { CommonToolsOptions } from '../../execution/CommonToolsOptions';
+import type { UserInterfaceToolsPromptDialogOptions } from '../../execution/UserInterfaceTools';
+/**
+ * Options for `CallbackInterfaceTools`
+ *
+ * @public exported from `@promptbook/core`
+ */
+export type CallbackInterfaceToolsOptions = CommonToolsOptions & {
+    /**
+     * The callback function to be called when promptDialog is called
+     */
+    callback(prompt: UserInterfaceToolsPromptDialogOptions): Promisable<string>;
+};

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

@@ -0,0 +1,22 @@
+import type { CommonToolsOptions } from '../../execution/CommonToolsOptions';
+import type { UserInterfaceTools } from '../../execution/UserInterfaceTools';
+import type { UserInterfaceToolsPromptDialogOptions } from '../../execution/UserInterfaceTools';
+/**
+ * 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.
+ *
+ * @public exported from `@promptbook/browser`
+ */
+export declare class SimplePromptInterfaceTools implements UserInterfaceTools {
+    protected readonly options: CommonToolsOptions;
+    constructor(options?: CommonToolsOptions);
+    /**
+     * Trigger window.prompt dialog
+     */
+    promptDialog(options: UserInterfaceToolsPromptDialogOptions): Promise<string>;
+}
+/**
+ * Note: [🔵] Code in this file should never be published outside of `@promptbook/browser`
+ */

package/esm/typings/src/dialogs/user-interface-execution-tools.test.d.ts

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

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

@@ -0,0 +1,12 @@
+/**
+ * This error indicates @@@
+ *
+ * @public exported from `@promptbook/core`
+ */
+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/esm/typings/src/errors/0-index.d.ts

@@ -0,0 +1,85 @@
+import { CsvFormatError } from '../formats/csv/CsvFormatError';
+import { AbstractFormatError } from './AbstractFormatError';
+import { CollectionError } from './CollectionError';
+import { EnvironmentMismatchError } from './EnvironmentMismatchError';
+import { ExpectError } from './ExpectError';
+import { KnowledgeScrapeError } from './KnowledgeScrapeError';
+import { LimitReachedError } from './LimitReachedError';
+import { MissingToolsError } from './MissingToolsError';
+import { NotFoundError } from './NotFoundError';
+import { NotYetImplementedError } from './NotYetImplementedError';
+import { ParseError } from './ParseError';
+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 PROMPTBOOK_ERRORS: {
+    readonly AbstractFormatError: typeof AbstractFormatError;
+    readonly CsvFormatError: typeof CsvFormatError;
+    readonly CollectionError: typeof CollectionError;
+    readonly EnvironmentMismatchError: typeof EnvironmentMismatchError;
+    readonly ExpectError: typeof ExpectError;
+    readonly KnowledgeScrapeError: typeof KnowledgeScrapeError;
+    readonly LimitReachedError: typeof LimitReachedError;
+    readonly MissingToolsError: typeof MissingToolsError;
+    readonly NotFoundError: typeof NotFoundError;
+    readonly NotYetImplementedError: typeof NotYetImplementedError;
+    readonly ParseError: typeof ParseError;
+    readonly PipelineExecutionError: typeof PipelineExecutionError;
+    readonly PipelineLogicError: typeof PipelineLogicError;
+    readonly PipelineUrlError: typeof PipelineUrlError;
+    readonly UnexpectedError: typeof UnexpectedError;
+};
+/**
+ * Index of all javascript errors
+ *
+ * @private for internal usage
+ */
+export declare const COMMON_JAVASCRIPT_ERRORS: {
+    readonly Error: ErrorConstructor;
+    readonly EvalError: EvalErrorConstructor;
+    readonly RangeError: RangeErrorConstructor;
+    readonly ReferenceError: ReferenceErrorConstructor;
+    readonly SyntaxError: SyntaxErrorConstructor;
+    readonly TypeError: TypeErrorConstructor;
+    readonly URIError: URIErrorConstructor;
+    readonly AggregateError: AggregateErrorConstructor;
+};
+/**
+ * Index of all errors
+ *
+ * @private for internal usage
+ */
+export declare const ALL_ERRORS: {
+    readonly Error: ErrorConstructor;
+    readonly EvalError: EvalErrorConstructor;
+    readonly RangeError: RangeErrorConstructor;
+    readonly ReferenceError: ReferenceErrorConstructor;
+    readonly SyntaxError: SyntaxErrorConstructor;
+    readonly TypeError: TypeErrorConstructor;
+    readonly URIError: URIErrorConstructor;
+    readonly AggregateError: AggregateErrorConstructor;
+    readonly AbstractFormatError: typeof AbstractFormatError;
+    readonly CsvFormatError: typeof CsvFormatError;
+    readonly CollectionError: typeof CollectionError;
+    readonly EnvironmentMismatchError: typeof EnvironmentMismatchError;
+    readonly ExpectError: typeof ExpectError;
+    readonly KnowledgeScrapeError: typeof KnowledgeScrapeError;
+    readonly LimitReachedError: typeof LimitReachedError;
+    readonly MissingToolsError: typeof MissingToolsError;
+    readonly NotFoundError: typeof NotFoundError;
+    readonly NotYetImplementedError: typeof NotYetImplementedError;
+    readonly ParseError: typeof ParseError;
+    readonly PipelineExecutionError: typeof PipelineExecutionError;
+    readonly PipelineLogicError: typeof PipelineLogicError;
+    readonly PipelineUrlError: typeof PipelineUrlError;
+    readonly UnexpectedError: typeof UnexpectedError;
+};
+/**
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ */

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

@@ -0,0 +1,11 @@
+/**
+ * This error indicates problems parsing the format value
+ *
+ * For example, when the format value is not a valid JSON or CSV
+ * This is not thrown directly but in extended classes
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare class AbstractFormatError extends Error {
+    constructor(message: string);
+}

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

@@ -0,0 +1,9 @@
+/**
+ * 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";
+    constructor(message: string);
+}

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

@@ -0,0 +1,9 @@
+/**
+ * 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";
+    constructor(message: string);
+}

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

@@ -0,0 +1,12 @@
+/**
+ * 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
+ */
+export declare class ExpectError extends Error {
+    readonly name = "ExpectError";
+    constructor(message: string);
+}

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

@@ -0,0 +1,9 @@
+/**
+ * This error indicates that the promptbook can not retrieve knowledge from external sources
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare class KnowledgeScrapeError extends Error {
+    readonly name = "KnowledgeScrapeError";
+    constructor(message: string);
+}

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

@@ -0,0 +1,9 @@
+/**
+ * This error type indicates that some limit was reached
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare class LimitReachedError extends Error {
+    readonly name = "LimitReachedError";
+    constructor(message: string);
+}

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

@@ -0,0 +1,9 @@
+/**
+ * This error type indicates that some tools are missing for pipeline execution or preparation
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare class MissingToolsError extends Error {
+    readonly name = "MissingToolsError";
+    constructor(message: string);
+}

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

@@ -0,0 +1,9 @@
+/**
+ * This error indicates that promptbook not found in the collection
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare class NotFoundError extends Error {
+    readonly name = "NotFoundError";
+    constructor(message: string);
+}

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

@@ -0,0 +1,9 @@
+/**
+ * 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";
+    constructor(message: string);
+}

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

@@ -0,0 +1,12 @@
+/**
+ * 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 ParseError extends Error {
+    readonly name = "ParseError";
+    constructor(message: string);
+}
+/**
+ * TODO: Maybe split `ParseError` and `ApplyError`
+ */

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

@@ -0,0 +1,9 @@
+/**
+ * This error indicates errors during the execution of the pipeline
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare class PipelineExecutionError extends Error {
+    readonly name = "PipelineExecutionError";
+    constructor(message: string);
+}

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

@@ -0,0 +1,9 @@
+/**
+ * This error indicates that the promptbook object has valid syntax (=can be parsed) but contains logical errors (like circular dependencies)
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare class PipelineLogicError extends Error {
+    readonly name = "PipelineLogicError";
+    constructor(message: string);
+}

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

@@ -0,0 +1,9 @@
+/**
+ * This error indicates errors in referencing promptbooks between each other
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare class PipelineUrlError extends Error {
+    readonly name = "PipelineUrlError";
+    constructor(message: string);
+}

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

@@ -0,0 +1,9 @@
+/**
+ * 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";
+    constructor(message: string);
+}

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

@@ -0,0 +1,20 @@
+import type { ALL_ERRORS } from '../0-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 ALL_ERRORS;
+    /**
+     * 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/getErrorReportUrl.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Make error report URL for the given error
+ *
+ * @private private within the repository
+ */
+export declare function getErrorReportUrl(error: Error): URL;

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/executables/$provideExecutablesForNode.d.ts

@@ -0,0 +1,12 @@
+import type { Executables } from '../execution/Executables';
+import type { PrepareAndScrapeOptions } from '../prepare/PrepareAndScrapeOptions';
+/**
+ * @@@
+ *
+ * @public exported from `@promptbook/node`
+ */
+export declare function $provideExecutablesForNode(options?: PrepareAndScrapeOptions): Promise<Executables>;
+/**
+ * TODO: [🧠] Allow to override the executables without need to call `locatePandoc` / `locateLibreoffice` in case of provided
+ * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
+ */

package/esm/typings/src/executables/apps/locateLibreoffice.d.ts

@@ -0,0 +1,11 @@
+import type { string_executable_path } from '../../types/typeAliases';
+/**
+ * @@@
+ *
+ * @private within the repository
+ */
+export declare function locateLibreoffice(): Promise<string_executable_path | null>;
+/**
+ * TODO: [🧠][♿] Maybe export through `@promptbook/node` OR `@promptbook/legacy-documents`
+ * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
+ */

package/esm/typings/src/executables/apps/locateLibreoffice.test.d.ts

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

package/esm/typings/src/executables/apps/locatePandoc.d.ts

@@ -0,0 +1,11 @@
+import type { string_executable_path } from '../../types/typeAliases';
+/**
+ * @@@
+ *
+ * @private within the repository
+ */
+export declare function locatePandoc(): Promise<string_executable_path | null>;
+/**
+ * TODO: [🧠][♿] Maybe export through `@promptbook/node` OR `@promptbook/documents`
+ * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
+ */

package/esm/typings/src/executables/apps/locatePandoc.test.d.ts

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