\n ${escapeHtml$1(citation.id)}\n ${escapeHtml$1(citation.source)}\n
\n ${excerpt}\n ${urlLink}\n \n
\n\n `),\n };\n const reportUrl = new URL(`https://github.com/webgptorg/promptbook/issues/new`);\n reportUrl.searchParams.set('labels', 'bug');\n reportUrl.searchParams.set('assignees', ADMIN_GITHUB_NAME);\n reportUrl.searchParams.set('title', report.title);\n reportUrl.searchParams.set('body', report.body);\n return reportUrl;\n }\n\n /**\n * This error type indicates that the error should not happen and its last check before crashing with some other error\n *\n * @public exported from `@promptbook/core`\n */\n class UnexpectedError extends Error {\n constructor(message) {\n super(spaceTrim$1.spaceTrim((block) => `\n ${block(message)}\n\n Note: This error should not happen.\n It's probably a bug in the pipeline collection\n\n Please report issue:\n ${block(getErrorReportUrl(new Error(message)).href)}\n\n Or contact us on ${ADMIN_EMAIL}\n\n `));\n this.name = 'UnexpectedError';\n Object.setPrototypeOf(this, UnexpectedError.prototype);\n }\n }\n\n /**\n * This error type indicates that somewhere in the code non-Error object was thrown and it was wrapped into the `WrappedError`\n *\n * @public exported from `@promptbook/core`\n */\n class WrappedError extends Error {\n constructor(whatWasThrown) {\n const tag = `[๐คฎ]`;\n console.error(tag, whatWasThrown);\n super(spaceTrim$1.spaceTrim(`\n Non-Error object was thrown\n\n Note: Look for ${tag} in the console for more details\n Please report issue on ${ADMIN_EMAIL}\n `));\n this.name = 'WrappedError';\n Object.setPrototypeOf(this, WrappedError.prototype);\n }\n }\n\n /**\n * Helper used in catch blocks to assert that the error is an instance of `Error`\n *\n * @param whatWasThrown Any object that was thrown\n * @returns Nothing if the error is an instance of `Error`\n * @throws `WrappedError` or `UnexpectedError` if the error is not standard\n *\n * @private within the repository\n */\n function assertsError(whatWasThrown) {\n // Case 1: Handle error which was rethrown as `WrappedError`\n if (whatWasThrown instanceof WrappedError) {\n const wrappedError = whatWasThrown;\n throw wrappedError;\n }\n // Case 2: Handle unexpected errors\n if (whatWasThrown instanceof UnexpectedError) {\n const unexpectedError = whatWasThrown;\n throw unexpectedError;\n }\n // Case 3: Handle standard errors - keep them up to consumer\n if (whatWasThrown instanceof Error) {\n return;\n }\n // Case 4: Handle non-standard errors - wrap them into `WrappedError` and throw\n throw new WrappedError(whatWasThrown);\n }\n\n /**\n * Format either small or big number\n *\n * @public exported from `@promptbook/utils`\n */\n function numberToString(value) {\n if (value === 0) {\n return '0';\n }\n else if (Number.isNaN(value)) {\n return VALUE_STRINGS.nan;\n }\n else if (value === Infinity) {\n return VALUE_STRINGS.infinity;\n }\n else if (value === -Infinity) {\n return VALUE_STRINGS.negativeInfinity;\n }\n for (let exponent = 0; exponent < 15; exponent++) {\n const factor = 10 ** exponent;\n const valueRounded = Math.round(value * factor) / factor;\n if (Math.abs(value - valueRounded) / value < SMALL_NUMBER) {\n return valueRounded.toFixed(exponent);\n }\n }\n return value.toString();\n }\n\n /**\n * Function `valueToString` will convert the given value to string\n * This is useful and used in the `templateParameters` function\n *\n * Note: This function is not just calling `toString` method\n * It's more complex and can handle this conversion specifically for LLM models\n * See `VALUE_STRINGS`\n *\n * Note: There are 2 similar functions\n * - `valueToString` converts value to string for LLM models as human-readable string\n * - `asSerializable` converts value to string to preserve full information to be able to convert it back\n *\n * @public exported from `@promptbook/utils`\n */\n function valueToString(value) {\n try {\n if (value === '') {\n return VALUE_STRINGS.empty;\n }\n else if (value === null) {\n return VALUE_STRINGS.null;\n }\n else if (value === undefined) {\n return VALUE_STRINGS.undefined;\n }\n else if (typeof value === 'string') {\n return value;\n }\n else if (typeof value === 'number') {\n return numberToString(value);\n }\n else if (value instanceof Date) {\n return value.toISOString();\n }\n else {\n try {\n return JSON.stringify(value);\n }\n catch (error) {\n if (error instanceof TypeError && error.message.includes('circular structure')) {\n return VALUE_STRINGS.circular;\n }\n throw error;\n }\n }\n }\n catch (error) {\n assertsError(error);\n console.error(error);\n return VALUE_STRINGS.unserializable;\n }\n }\n\n /**\n * Computes SHA-256 hash of the given object\n *\n * @public exported from `@promptbook/utils`\n */\n function computeHash(value) {\n return cryptoJs.SHA256(hexEncoder__default[\"default\"].parse(spaceTrim__default[\"default\"](valueToString(value)))).toString( /* hex */);\n }\n /**\n * TODO: [๐ฅฌ][๐ฅฌ] Use this ACRY\n */\n\n /**\n * Computes SHA-256 hash of the agent source\n *\n * @public exported from `@promptbook/core`\n */\n function computeAgentHash(agentSource) {\n return computeHash(agentSource);\n }\n\n /**\n * Orders JSON object by keys\n *\n * @returns The same type of object as the input re-ordered\n * @public exported from `@promptbook/utils`\n */\n function orderJson(options) {\n const { value, order } = options;\n const orderedValue = {\n ...(order === undefined ? {} : Object.fromEntries(order.map((key) => [key, undefined]))),\n ...value,\n };\n return orderedValue;\n }\n\n /**\n * Freezes the given object and all its nested objects recursively\n *\n * Note: `$` is used to indicate that this function is not a pure function - it mutates given object\n * Note: This function mutates the object and returns the original (but mutated-deep-freezed) object\n *\n * @returns The same object as the input, but deeply frozen\n * @public exported from `@promptbook/utils`\n */\n function $deepFreeze(objectValue) {\n if (Array.isArray(objectValue)) {\n return Object.freeze(objectValue.map((item) => $deepFreeze(item)));\n }\n const propertyNames = Object.getOwnPropertyNames(objectValue);\n for (const propertyName of propertyNames) {\n const value = objectValue[propertyName];\n if (value && typeof value === 'object') {\n $deepFreeze(value);\n }\n }\n Object.freeze(objectValue);\n return objectValue;\n }\n /**\n * TODO: [๐ง ] Is there a way how to meaningfully test this utility\n */\n\n /**\n * Checks if the value is [๐] serializable as JSON\n * If not, throws an UnexpectedError with a rich error message and tracking\n *\n * - Almost all primitives are serializable BUT:\n * - `undefined` is not serializable\n * - `NaN` is not serializable\n * - Objects and arrays are serializable if all their properties are serializable\n * - Functions are not serializable\n * - Circular references are not serializable\n * - `Date` objects are not serializable\n * - `Map` and `Set` objects are not serializable\n * - `RegExp` objects are not serializable\n * - `Error` objects are not serializable\n * - `Symbol` objects are not serializable\n * - And much more...\n *\n * @throws UnexpectedError if the value is not serializable as JSON\n * @public exported from `@promptbook/utils`\n */\n function checkSerializableAsJson(options) {\n const { value, name, message } = options;\n if (value === undefined) {\n throw new UnexpectedError(`${name} is undefined`);\n }\n else if (value === null) {\n return;\n }\n else if (typeof value === 'boolean') {\n return;\n }\n else if (typeof value === 'number' && !isNaN(value)) {\n return;\n }\n else if (typeof value === 'string') {\n return;\n }\n else if (typeof value === 'symbol') {\n throw new UnexpectedError(`${name} is symbol`);\n }\n else if (typeof value === 'function') {\n throw new UnexpectedError(`${name} is function`);\n }\n else if (typeof value === 'object' && Array.isArray(value)) {\n for (let i = 0; i < value.length; i++) {\n checkSerializableAsJson({ name: `${name}[${i}]`, value: value[i], message });\n }\n }\n else if (typeof value === 'object') {\n if (value instanceof Date) {\n throw new UnexpectedError(spaceTrim__default[\"default\"]((block) => `\n \\`${name}\\` is Date\n\n Use \\`string_date_iso8601\\` instead\n\n Additional message for \\`${name}\\`:\n ${block(message || '(nothing)')}\n `));\n }\n else if (value instanceof Map) {\n throw new UnexpectedError(`${name} is Map`);\n }\n else if (value instanceof Set) {\n throw new UnexpectedError(`${name} is Set`);\n }\n else if (value instanceof RegExp) {\n throw new UnexpectedError(`${name} is RegExp`);\n }\n else if (value instanceof Error) {\n throw new UnexpectedError(spaceTrim__default[\"default\"]((block) => `\n \\`${name}\\` is unserialized Error\n\n Use function \\`serializeError\\`\n\n Additional message for \\`${name}\\`:\n ${block(message || '(nothing)')}\n\n `));\n }\n else {\n for (const [subName, subValue] of Object.entries(value)) {\n if (subValue === undefined) {\n // Note: undefined in object is serializable - it is just omitted\n continue;\n }\n checkSerializableAsJson({ name: `${name}.${subName}`, value: subValue, message });\n }\n try {\n JSON.stringify(value); // <- TODO: [0]\n }\n catch (error) {\n assertsError(error);\n throw new UnexpectedError(spaceTrim__default[\"default\"]((block) => `\n \\`${name}\\` is not serializable\n\n ${block(error.stack || error.message)}\n\n Additional message for \\`${name}\\`:\n ${block(message || '(nothing)')}\n `));\n }\n /*\n TODO: [0] Is there some more elegant way to check circular references?\n const seen = new Set();\n const stack = [{ value }];\n while (stack.length > 0) {\n const { value } = stack.pop()!;\n if (typeof value === 'object' && value !== null) {\n if (seen.has(value)) {\n throw new UnexpectedError(`${name} has circular reference`);\n }\n seen.add(value);\n if (Array.isArray(value)) {\n stack.push(...value.map((value) => ({ value })));\n } else {\n stack.push(...Object.values(value).map((value) => ({ value })));\n }\n }\n }\n */\n return;\n }\n }\n else {\n throw new UnexpectedError(spaceTrim__default[\"default\"]((block) => `\n \\`${name}\\` is unknown type\n\n Additional message for \\`${name}\\`:\n ${block(message || '(nothing)')}\n `));\n }\n }\n /**\n * TODO: Can be return type more type-safe? like `asserts options.value is JsonValue`\n * TODO: [๐ง ][main] !!3 In-memory cache of same values to prevent multiple checks\n * Note: [๐ ] This is how `checkSerializableAsJson` + `isSerializableAsJson` together can just retun true/false or rich error message\n */\n\n /**\n * Creates a deep clone of the given object\n *\n * Note: [๐] This function is idempotent.\n * Note: This method only works for objects that are fully serializable to JSON and do not contain functions, Dates, or special types.\n *\n * @param objectValue The object to clone.\n * @returns A deep, writable clone of the input object.\n * @public exported from `@promptbook/utils`\n */\n function deepClone(objectValue) {\n return JSON.parse(JSON.stringify(objectValue));\n /*\n TODO: [๐ง ] Is there a better implementation?\n > const propertyNames = Object.getOwnPropertyNames(objectValue);\n > for (const propertyName of propertyNames) {\n > const value = (objectValue as chococake)[propertyName];\n > if (value && typeof value === 'object') {\n > deepClone(value);\n > }\n > }\n > return Object.assign({}, objectValue);\n */\n }\n /**\n * TODO: [๐ง ] Is there a way how to meaningfully test this utility\n */\n\n /**\n * Utility to export a JSON object from a function\n *\n * 1) Checks if the value is serializable as JSON\n * 2) Makes a deep clone of the object\n * 2) Orders the object properties\n * 2) Deeply freezes the cloned object\n *\n * Note: This function does not mutates the given object\n *\n * @returns The same type of object as the input but read-only and re-ordered\n * @public exported from `@promptbook/utils`\n */\n function exportJson(options) {\n const { name, value, order, message } = options;\n checkSerializableAsJson({ name, value, message });\n const orderedValue = \n // TODO: Fix error \"Type instantiation is excessively deep and possibly infinite.\"\n // eslint-disable-next-line @typescript-eslint/ban-ts-comment\n // @ts-ignore\n order === undefined\n ? deepClone(value)\n : orderJson({\n value: value,\n // <- Note: checkSerializableAsJson asserts that the value is serializable as JSON\n order: order,\n });\n $deepFreeze(orderedValue);\n return orderedValue;\n }\n /**\n * TODO: [๐ง ] Is there a way how to meaningfully test this utility\n */\n\n // <- TODO: Maybe do better levels of trust\n /**\n * How is the model provider important?\n *\n * @public exported from `@promptbook/core`\n */\n const MODEL_ORDERS = {\n /**\n * Top-tier models, e.g. OpenAI, Anthropic,...\n */\n TOP_TIER: 333,\n /**\n * Mid-tier models, e.g. Llama, Mistral, etc.\n */\n NORMAL: 100,\n /**\n * Low-tier models, e.g. Phi, Tiny, etc.\n */\n LOW_TIER: 0,\n };\n /**\n * Order of keys in the pipeline JSON\n *\n * @public exported from `@promptbook/core`\n */\n const ORDER_OF_PIPELINE_JSON = [\n // Note: [๐] In this order will be pipeline serialized\n 'title',\n 'pipelineUrl',\n 'bookVersion',\n 'description',\n 'formfactorName',\n 'parameters',\n 'tasks',\n 'personas',\n 'preparations',\n 'knowledgeSources',\n 'knowledgePieces',\n 'sources', // <- TODO: [๐ง ] Where should the `sources` be\n ];\n /**\n * Nonce which is used for replacing things in strings\n *\n * @private within the repository\n */\n const REPLACING_NONCE = 'ptbkauk42kV2dzao34faw7FudQUHYPtW';\n /**\n * Nonce which is used as string which is not occurring in normal text\n *\n * @private within the repository\n */\n const SALT_NONCE = 'ptbkghhewbvruets21t54et5';\n /**\n * Placeholder value indicating a parameter is missing its value.\n *\n * @private within the repository\n */\n const RESERVED_PARAMETER_MISSING_VALUE = 'MISSING-' + REPLACING_NONCE;\n /**\n * Placeholder value indicating a parameter is restricted and cannot be used directly.\n *\n * @private within the repository\n */\n const RESERVED_PARAMETER_RESTRICTED = 'RESTRICTED-' + REPLACING_NONCE;\n /**\n * The names of the parameters that are reserved for special purposes\n *\n * @public exported from `@promptbook/core`\n */\n const RESERVED_PARAMETER_NAMES = exportJson({\n name: 'RESERVED_PARAMETER_NAMES',\n message: `The names of the parameters that are reserved for special purposes`,\n value: [\n 'content',\n 'context',\n 'knowledge',\n 'examples',\n 'modelName',\n 'currentDate',\n // <- TODO: list here all command names\n // <- TODO: Add more like 'date', 'modelName',...\n // <- TODO: Add [emoji] + instructions ACRY when adding new reserved parameter\n ],\n });\n /**\n * Prompt parameter that toggles whether the agent runs self-learning after each chat.\n *\n * @public exported from `@promptbook/core`\n */\n const PROMPT_PARAMETER_SELF_LEARNING_ENABLED = 'selfLearningEnabled';\n /**\n * Limits for IDs, names, and other strings\n *\n * @public exported from `@promptbook/core`\n */\n const LIMITS = {\n /**\n * Minimum length of a name (e.g. agent name, persona name)\n */\n NAME_MIN_LENGTH: 3,\n /**\n * Recommended maximum length of a name\n */\n NAME_MAX_LENGTH: 20,\n /**\n * Maximum length of a short description or a hash\n */\n SHORT_TEXT_MAX_LENGTH: 30,\n /**\n * Gone\n */\n GONE: 410,\n /**\n * Gateway timeout\n */\n GATEWAY_TIMEOUT: 504,\n /**\n * Too many requests\n */\n TOO_MANY_REQUESTS: 429,\n /**\n * Maximum length of a file path segment\n */\n FILE_PATH_SEGMENT_MAX_LENGTH: 8,\n /**\n * Default length of a short name (e.g. for default agent names)\n */\n SHORT_NAME_LENGTH: 6,\n };\n /**\n * Note: [๐] Ignore a discrepancy between file name and entity name\n */\n\n /**\n * Tests if given string is valid file path.\n *\n * Note: This does not check if the file exists only if the path is valid\n * @public exported from `@promptbook/utils`\n */\n function isValidFilePath(filename) {\n if (typeof filename !== 'string') {\n return false;\n }\n if (filename.split(/\\r?\\n/).length > 1) {\n return false;\n }\n // Normalize slashes early so heuristics can detect path-like inputs\n const filenameSlashes = filename.replace(/\\\\/g, '/');\n // Reject strings that look like sentences (informational text)\n // Heuristic: contains multiple spaces and ends with a period, or contains typical sentence punctuation\n // But skip this heuristic if the string looks like a path (contains '/' or starts with a drive letter)\n if (filename.trim().length > 60 && // long enough to be a sentence\n /[.!?]/.test(filename) && // contains sentence punctuation\n filename.split(' ').length > 8 && // has many words\n !/\\/|^[A-Z]:/i.test(filenameSlashes) // do NOT treat as sentence if looks like a path\n ) {\n return false;\n }\n // Absolute Unix path: /hello.txt\n if (/^(\\/)/i.test(filenameSlashes)) {\n // console.log(filename, 'Absolute Unix path: /hello.txt');\n return true;\n }\n // Absolute Windows path: C:/ or C:\\ (allow spaces and multiple dots in filename)\n if (/^[A-Z]:\\/.+$/i.test(filenameSlashes)) {\n // console.log(filename, 'Absolute Windows path: /hello.txt');\n return true;\n }\n // Relative path: ./hello.txt\n if (/^(\\.\\.?\\/)+/i.test(filenameSlashes)) {\n // console.log(filename, 'Relative path: ./hello.txt');\n return true;\n }\n // Allow paths like foo/hello\n if (/^[^/]+\\/[^/]+/i.test(filenameSlashes)) {\n // console.log(filename, 'Allow paths like foo/hello');\n return true;\n }\n // Allow paths like hello.book\n if (/^[^/]+\\.[^/]+$/i.test(filenameSlashes)) {\n // console.log(filename, 'Allow paths like hello.book');\n return true;\n }\n return false;\n }\n /**\n * TODO: [๐] Implement for MacOs\n */\n\n const defaultDiacriticsRemovalMap = [\n {\n base: 'A',\n letters: '\\u0041\\u24B6\\uFF21\\u00C0\\u00C1\\u00C2\\u1EA6\\u1EA4\\u1EAA\\u1EA8\\u00C3\\u0100\\u0102\\u1EB0\\u1EAE\\u1EB4\\u1EB2\\u0226\\u01E0\\u00C4\\u01DE\\u1EA2\\u00C5\\u01FA\\u01CD\\u0200\\u0202\\u1EA0\\u1EAC\\u1EB6\\u1E00\\u0104\\u023A\\u2C6F',\n },\n { base: 'AA', letters: '\\uA732' },\n { base: 'AE', letters: '\\u00C6\\u01FC\\u01E2' },\n { base: 'AO', letters: '\\uA734' },\n { base: 'AU', letters: '\\uA736' },\n { base: 'AV', letters: '\\uA738\\uA73A' },\n { base: 'AY', letters: '\\uA73C' },\n {\n base: 'B',\n letters: '\\u0042\\u24B7\\uFF22\\u1E02\\u1E04\\u1E06\\u0243\\u0182\\u0181',\n },\n {\n base: 'C',\n letters: '\\u0043\\u24B8\\uFF23\\u0106\\u0108\\u010A\\u010C\\u00C7\\u1E08\\u0187\\u023B\\uA73E',\n },\n {\n base: 'D',\n letters: '\\u0044\\u24B9\\uFF24\\u1E0A\\u010E\\u1E0C\\u1E10\\u1E12\\u1E0E\\u0110\\u018B\\u018A\\u0189\\uA779\\u00D0',\n },\n { base: 'DZ', letters: '\\u01F1\\u01C4' },\n { base: 'Dz', letters: '\\u01F2\\u01C5' },\n {\n base: 'E',\n letters: '\\u0045\\u24BA\\uFF25\\u00C8\\u00C9\\u00CA\\u1EC0\\u1EBE\\u1EC4\\u1EC2\\u1EBC\\u0112\\u1E14\\u1E16\\u0114\\u0116\\u00CB\\u1EBA\\u011A\\u0204\\u0206\\u1EB8\\u1EC6\\u0228\\u1E1C\\u0118\\u1E18\\u1E1A\\u0190\\u018E',\n },\n { base: 'F', letters: '\\u0046\\u24BB\\uFF26\\u1E1E\\u0191\\uA77B' },\n {\n base: 'G',\n letters: '\\u0047\\u24BC\\uFF27\\u01F4\\u011C\\u1E20\\u011E\\u0120\\u01E6\\u0122\\u01E4\\u0193\\uA7A0\\uA77D\\uA77E',\n },\n {\n base: 'H',\n letters: '\\u0048\\u24BD\\uFF28\\u0124\\u1E22\\u1E26\\u021E\\u1E24\\u1E28\\u1E2A\\u0126\\u2C67\\u2C75\\uA78D',\n },\n {\n base: 'I',\n letters: '\\u0049\\u24BE\\uFF29\\u00CC\\u00CD\\u00CE\\u0128\\u012A\\u012C\\u0130\\u00CF\\u1E2E\\u1EC8\\u01CF\\u0208\\u020A\\u1ECA\\u012E\\u1E2C\\u0197',\n },\n { base: 'J', letters: '\\u004A\\u24BF\\uFF2A\\u0134\\u0248' },\n {\n base: 'K',\n letters: '\\u004B\\u24C0\\uFF2B\\u1E30\\u01E8\\u1E32\\u0136\\u1E34\\u0198\\u2C69\\uA740\\uA742\\uA744\\uA7A2',\n },\n {\n base: 'L',\n letters: '\\u004C\\u24C1\\uFF2C\\u013F\\u0139\\u013D\\u1E36\\u1E38\\u013B\\u1E3C\\u1E3A\\u0141\\u023D\\u2C62\\u2C60\\uA748\\uA746\\uA780',\n },\n { base: 'LJ', letters: '\\u01C7' },\n { base: 'Lj', letters: '\\u01C8' },\n { base: 'M', letters: '\\u004D\\u24C2\\uFF2D\\u1E3E\\u1E40\\u1E42\\u2C6E\\u019C' },\n {\n base: 'N',\n letters: '\\u004E\\u24C3\\uFF2E\\u01F8\\u0143\\u00D1\\u1E44\\u0147\\u1E46\\u0145\\u1E4A\\u1E48\\u0220\\u019D\\uA790\\uA7A4',\n },\n { base: 'NJ', letters: '\\u01CA' },\n { base: 'Nj', letters: '\\u01CB' },\n {\n base: 'O',\n letters: '\\u004F\\u24C4\\uFF2F\\u00D2\\u00D3\\u00D4\\u1ED2\\u1ED0\\u1ED6\\u1ED4\\u00D5\\u1E4C\\u022C\\u1E4E\\u014C\\u1E50\\u1E52\\u014E\\u022E\\u0230\\u00D6\\u022A\\u1ECE\\u0150\\u01D1\\u020C\\u020E\\u01A0\\u1EDC\\u1EDA\\u1EE0\\u1EDE\\u1EE2\\u1ECC\\u1ED8\\u01EA\\u01EC\\u00D8\\u01FE\\u0186\\u019F\\uA74A\\uA74C',\n },\n { base: 'OI', letters: '\\u01A2' },\n { base: 'OO', letters: '\\uA74E' },\n { base: 'OU', letters: '\\u0222' },\n { base: 'OE', letters: '\\u008C\\u0152' },\n { base: 'oe', letters: '\\u009C\\u0153' },\n {\n base: 'P',\n letters: '\\u0050\\u24C5\\uFF30\\u1E54\\u1E56\\u01A4\\u2C63\\uA750\\uA752\\uA754',\n },\n { base: 'Q', letters: '\\u0051\\u24C6\\uFF31\\uA756\\uA758\\u024A' },\n {\n base: 'R',\n letters: '\\u0052\\u24C7\\uFF32\\u0154\\u1E58\\u0158\\u0210\\u0212\\u1E5A\\u1E5C\\u0156\\u1E5E\\u024C\\u2C64\\uA75A\\uA7A6\\uA782',\n },\n {\n base: 'S',\n letters: '\\u0053\\u24C8\\uFF33\\u1E9E\\u015A\\u1E64\\u015C\\u1E60\\u0160\\u1E66\\u1E62\\u1E68\\u0218\\u015E\\u2C7E\\uA7A8\\uA784',\n },\n {\n base: 'T',\n letters: '\\u0054\\u24C9\\uFF34\\u1E6A\\u0164\\u1E6C\\u021A\\u0162\\u1E70\\u1E6E\\u0166\\u01AC\\u01AE\\u023E\\uA786',\n },\n { base: 'TZ', letters: '\\uA728' },\n {\n base: 'U',\n letters: '\\u0055\\u24CA\\uFF35\\u00D9\\u00DA\\u00DB\\u0168\\u1E78\\u016A\\u1E7A\\u016C\\u00DC\\u01DB\\u01D7\\u01D5\\u01D9\\u1EE6\\u016E\\u0170\\u01D3\\u0214\\u0216\\u01AF\\u1EEA\\u1EE8\\u1EEE\\u1EEC\\u1EF0\\u1EE4\\u1E72\\u0172\\u1E76\\u1E74\\u0244',\n },\n { base: 'V', letters: '\\u0056\\u24CB\\uFF36\\u1E7C\\u1E7E\\u01B2\\uA75E\\u0245' },\n { base: 'VY', letters: '\\uA760' },\n {\n base: 'W',\n letters: '\\u0057\\u24CC\\uFF37\\u1E80\\u1E82\\u0174\\u1E86\\u1E84\\u1E88\\u2C72',\n },\n { base: 'X', letters: '\\u0058\\u24CD\\uFF38\\u1E8A\\u1E8C' },\n {\n base: 'Y',\n letters: '\\u0059\\u24CE\\uFF39\\u1EF2\\u00DD\\u0176\\u1EF8\\u0232\\u1E8E\\u0178\\u1EF6\\u1EF4\\u01B3\\u024E\\u1EFE',\n },\n {\n base: 'Z',\n letters: '\\u005A\\u24CF\\uFF3A\\u0179\\u1E90\\u017B\\u017D\\u1E92\\u1E94\\u01B5\\u0224\\u2C7F\\u2C6B\\uA762',\n },\n {\n base: 'a',\n letters: '\\u0061\\u24D0\\uFF41\\u1E9A\\u00E0\\u00E1\\u00E2\\u1EA7\\u1EA5\\u1EAB\\u1EA9\\u00E3\\u0101\\u0103\\u1EB1\\u1EAF\\u1EB5\\u1EB3\\u0227\\u01E1\\u00E4\\u01DF\\u1EA3\\u00E5\\u01FB\\u01CE\\u0201\\u0203\\u1EA1\\u1EAD\\u1EB7\\u1E01\\u0105\\u2C65\\u0250',\n },\n { base: 'aa', letters: '\\uA733' },\n { base: 'ae', letters: '\\u00E6\\u01FD\\u01E3' },\n { base: 'ao', letters: '\\uA735' },\n { base: 'au', letters: '\\uA737' },\n { base: 'av', letters: '\\uA739\\uA73B' },\n { base: 'ay', letters: '\\uA73D' },\n {\n base: 'b',\n letters: '\\u0062\\u24D1\\uFF42\\u1E03\\u1E05\\u1E07\\u0180\\u0183\\u0253',\n },\n {\n base: 'c',\n letters: '\\u0063\\u24D2\\uFF43\\u0107\\u0109\\u010B\\u010D\\u00E7\\u1E09\\u0188\\u023C\\uA73F\\u2184',\n },\n {\n base: 'd',\n letters: '\\u0064\\u24D3\\uFF44\\u1E0B\\u010F\\u1E0D\\u1E11\\u1E13\\u1E0F\\u0111\\u018C\\u0256\\u0257\\uA77A',\n },\n { base: 'dz', letters: '\\u01F3\\u01C6' },\n {\n base: 'e',\n letters: '\\u0065\\u24D4\\uFF45\\u00E8\\u00E9\\u00EA\\u1EC1\\u1EBF\\u1EC5\\u1EC3\\u1EBD\\u0113\\u1E15\\u1E17\\u0115\\u0117\\u00EB\\u1EBB\\u011B\\u0205\\u0207\\u1EB9\\u1EC7\\u0229\\u1E1D\\u0119\\u1E19\\u1E1B\\u0247\\u025B\\u01DD',\n },\n { base: 'f', letters: '\\u0066\\u24D5\\uFF46\\u1E1F\\u0192\\uA77C' },\n {\n base: 'g',\n letters: '\\u0067\\u24D6\\uFF47\\u01F5\\u011D\\u1E21\\u011F\\u0121\\u01E7\\u0123\\u01E5\\u0260\\uA7A1\\u1D79\\uA77F',\n },\n {\n base: 'h',\n letters: '\\u0068\\u24D7\\uFF48\\u0125\\u1E23\\u1E27\\u021F\\u1E25\\u1E29\\u1E2B\\u1E96\\u0127\\u2C68\\u2C76\\u0265',\n },\n { base: 'hv', letters: '\\u0195' },\n {\n base: 'i',\n letters: '\\u0069\\u24D8\\uFF49\\u00EC\\u00ED\\u00EE\\u0129\\u012B\\u012D\\u00EF\\u1E2F\\u1EC9\\u01D0\\u0209\\u020B\\u1ECB\\u012F\\u1E2D\\u0268\\u0131',\n },\n { base: 'j', letters: '\\u006A\\u24D9\\uFF4A\\u0135\\u01F0\\u0249' },\n {\n base: 'k',\n letters: '\\u006B\\u24DA\\uFF4B\\u1E31\\u01E9\\u1E33\\u0137\\u1E35\\u0199\\u2C6A\\uA741\\uA743\\uA745\\uA7A3',\n },\n {\n base: 'l',\n letters: '\\u006C\\u24DB\\uFF4C\\u0140\\u013A\\u013E\\u1E37\\u1E39\\u013C\\u1E3D\\u1E3B\\u017F\\u0142\\u019A\\u026B\\u2C61\\uA749\\uA781\\uA747',\n },\n { base: 'lj', letters: '\\u01C9' },\n { base: 'm', letters: '\\u006D\\u24DC\\uFF4D\\u1E3F\\u1E41\\u1E43\\u0271\\u026F' },\n {\n base: 'n',\n letters: '\\u006E\\u24DD\\uFF4E\\u01F9\\u0144\\u00F1\\u1E45\\u0148\\u1E47\\u0146\\u1E4B\\u1E49\\u019E\\u0272\\u0149\\uA791\\uA7A5',\n },\n { base: 'nj', letters: '\\u01CC' },\n {\n base: 'o',\n letters: '\\u006F\\u24DE\\uFF4F\\u00F2\\u00F3\\u00F4\\u1ED3\\u1ED1\\u1ED7\\u1ED5\\u00F5\\u1E4D\\u022D\\u1E4F\\u014D\\u1E51\\u1E53\\u014F\\u022F\\u0231\\u00F6\\u022B\\u1ECF\\u0151\\u01D2\\u020D\\u020F\\u01A1\\u1EDD\\u1EDB\\u1EE1\\u1EDF\\u1EE3\\u1ECD\\u1ED9\\u01EB\\u01ED\\u00F8\\u01FF\\u0254\\uA74B\\uA74D\\u0275',\n },\n { base: 'oi', letters: '\\u01A3' },\n { base: 'ou', letters: '\\u0223' },\n { base: 'oo', letters: '\\uA74F' },\n {\n base: 'p',\n letters: '\\u0070\\u24DF\\uFF50\\u1E55\\u1E57\\u01A5\\u1D7D\\uA751\\uA753\\uA755',\n },\n { base: 'q', letters: '\\u0071\\u24E0\\uFF51\\u024B\\uA757\\uA759' },\n {\n base: 'r',\n letters: '\\u0072\\u24E1\\uFF52\\u0155\\u1E59\\u0159\\u0211\\u0213\\u1E5B\\u1E5D\\u0157\\u1E5F\\u024D\\u027D\\uA75B\\uA7A7\\uA783',\n },\n {\n base: 's',\n letters: '\\u0073\\u24E2\\uFF53\\u00DF\\u015B\\u1E65\\u015D\\u1E61\\u0161\\u1E67\\u1E63\\u1E69\\u0219\\u015F\\u023F\\uA7A9\\uA785\\u1E9B',\n },\n {\n base: 't',\n letters: '\\u0074\\u24E3\\uFF54\\u1E6B\\u1E97\\u0165\\u1E6D\\u021B\\u0163\\u1E71\\u1E6F\\u0167\\u01AD\\u0288\\u2C66\\uA787',\n },\n { base: 'tz', letters: '\\uA729' },\n {\n base: 'u',\n letters: '\\u0075\\u24E4\\uFF55\\u00F9\\u00FA\\u00FB\\u0169\\u1E79\\u016B\\u1E7B\\u016D\\u00FC\\u01DC\\u01D8\\u01D6\\u01DA\\u1EE7\\u016F\\u0171\\u01D4\\u0215\\u0217\\u01B0\\u1EEB\\u1EE9\\u1EEF\\u1EED\\u1EF1\\u1EE5\\u1E73\\u0173\\u1E77\\u1E75\\u0289',\n },\n { base: 'v', letters: '\\u0076\\u24E5\\uFF56\\u1E7D\\u1E7F\\u028B\\uA75F\\u028C' },\n { base: 'vy', letters: '\\uA761' },\n {\n base: 'w',\n letters: '\\u0077\\u24E6\\uFF57\\u1E81\\u1E83\\u0175\\u1E87\\u1E85\\u1E98\\u1E89\\u2C73',\n },\n { base: 'x', letters: '\\u0078\\u24E7\\uFF58\\u1E8B\\u1E8D' },\n {\n base: 'y',\n letters: '\\u0079\\u24E8\\uFF59\\u1EF3\\u00FD\\u0177\\u1EF9\\u0233\\u1E8F\\u00FF\\u1EF7\\u1E99\\u1EF5\\u01B4\\u024F\\u1EFF',\n },\n {\n base: 'z',\n letters: '\\u007A\\u24E9\\uFF5A\\u017A\\u1E91\\u017C\\u017E\\u1E93\\u1E95\\u01B6\\u0225\\u0240\\u2C6C\\uA763',\n },\n ];\n /**\n * Map of letters from diacritic variant to diacritless variant\n * Contains lowercase and uppercase separatelly\n *\n * > \"รก\" => \"a\"\n * > \"ฤ\" => \"e\"\n * > \"ฤ\" => \"A\"\n * > ...\n *\n * @public exported from `@promptbook/utils`\n */\n const DIACRITIC_VARIANTS_LETTERS = {};\n // tslint:disable-next-line: prefer-for-of\n for (let i = 0; i < defaultDiacriticsRemovalMap.length; i++) {\n const letters = defaultDiacriticsRemovalMap[i].letters;\n // tslint:disable-next-line: prefer-for-of\n for (let j = 0; j < letters.length; j++) {\n DIACRITIC_VARIANTS_LETTERS[letters[j]] = defaultDiacriticsRemovalMap[i].base;\n }\n }\n // <- TODO: [๐] Put to maker function to save execution time if not needed\n /*\n @see https://stackoverflow.com/questions/990904/remove-accents-diacritics-in-a-string-in-javascript\n Licensed under the Apache License, Version 2.0 (the \"License\");\n you may not use this file except in compliance with the License.\n You may obtain a copy of the License at\n\n http://www.apache.org/licenses/LICENSE-2.0\n\n Unless required by applicable law or agreed to in writing, software\n distributed under the License is distributed on an \"AS IS\" BASIS,\n WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n See the License for the specific language governing permissions and\n limitations under the License.\n */\n\n /**\n * Removes diacritic marks (accents) from characters in a string.\n *\n * Note: [๐] This function is idempotent.\n *\n * @param input The string containing diacritics to be normalized.\n * @returns The string with diacritics removed or normalized.\n * @public exported from `@promptbook/utils`\n */\n function removeDiacritics(input) {\n /*eslint no-control-regex: \"off\"*/\n return input.replace(/[^\\u0000-\\u007E]/g, (character) => {\n return DIACRITIC_VARIANTS_LETTERS[character] || character;\n });\n }\n /**\n * TODO: [ะ] Variant for cyrillic (and in general non-latin) letters\n */\n\n /**\n * Converts a given text to kebab-case format.\n *\n * Note: [๐] This function is idempotent.\n *\n * @param text The text to be converted.\n * @returns The kebab-case formatted string.\n * @example 'hello-world'\n * @example 'i-love-promptbook'\n * @public exported from `@promptbook/utils`\n */\n function normalizeToKebabCase(text) {\n text = removeDiacritics(text);\n let charType;\n let lastCharType = 'OTHER';\n let normalizedName = '';\n for (const char of text) {\n let normalizedChar;\n if (/^[a-z]$/.test(char)) {\n charType = 'LOWERCASE';\n normalizedChar = char;\n }\n else if (/^[A-Z]$/.test(char)) {\n charType = 'UPPERCASE';\n normalizedChar = char.toLowerCase();\n }\n else if (/^[0-9]$/.test(char)) {\n charType = 'NUMBER';\n normalizedChar = char;\n }\n else {\n charType = 'OTHER';\n normalizedChar = '-';\n }\n if (charType !== lastCharType &&\n !(lastCharType === 'UPPERCASE' && charType === 'LOWERCASE') &&\n !(lastCharType === 'NUMBER') &&\n !(charType === 'NUMBER')) {\n normalizedName += '-';\n }\n normalizedName += normalizedChar;\n lastCharType = charType;\n }\n normalizedName = normalizedName.split(/-+/g).join('-');\n normalizedName = normalizedName.split(/-?\\/-?/g).join('/');\n normalizedName = normalizedName.replace(/^-/, '');\n normalizedName = normalizedName.replace(/-$/, '');\n return normalizedName;\n }\n /**\n * Note: [๐] Ignore a discrepancy between file name and entity name\n */\n\n /**\n * Removes emojis from a string and fix whitespaces\n *\n * Note: [๐] This function is idempotent.\n *\n * @param text with emojis\n * @returns text without emojis\n * @public exported from `@promptbook/utils`\n */\n function removeEmojis(text) {\n // Replace emojis (and also ZWJ sequence) with hyphens\n text = text.replace(/(\\p{Extended_Pictographic})\\p{Modifier_Symbol}/gu, '$1');\n text = text.replace(/(\\p{Extended_Pictographic})[\\u{FE00}-\\u{FE0F}]/gu, '$1');\n text = text.replace(/(\\p{Extended_Pictographic})(\\u{200D}\\p{Extended_Pictographic})*/gu, '$1');\n text = text.replace(/\\p{Extended_Pictographic}/gu, '');\n return text;\n }\n\n /**\n * Converts a title string into a normalized name.\n *\n * Note: [๐] This function is idempotent.\n *\n * @param value The title string to be converted to a name.\n * @returns A normalized name derived from the input title.\n * @example 'Hello World!' -> 'hello-world'\n * @public exported from `@promptbook/utils`\n */\n function titleToName(value) {\n if (isValidUrl(value)) {\n value = value.replace(/^https?:\\/\\//, '');\n value = value.replace(/\\.html$/, '');\n }\n else if (isValidFilePath(value)) {\n value = path.basename(value);\n // Note: Keeping extension in the name\n }\n value = value.split('/').join('-');\n value = removeEmojis(value);\n value = normalizeToKebabCase(value);\n // TODO: [๐ง ] Maybe warn or add some padding to short name which are not good identifiers\n return value;\n }\n\n /**\n * This error indicates problems parsing the format value\n *\n * For example, when the format value is not a valid JSON or CSV\n * This is not thrown directly but in extended classes\n *\n * @public exported from `@promptbook/core`\n */\n class AbstractFormatError extends Error {\n // Note: To allow instanceof do not put here error `name`\n // public readonly name = 'AbstractFormatError';\n constructor(message) {\n super(message);\n Object.setPrototypeOf(this, AbstractFormatError.prototype);\n }\n }\n\n /**\n * This error indicates problem with parsing of CSV\n *\n * @public exported from `@promptbook/core`\n */\n class CsvFormatError extends AbstractFormatError {\n constructor(message) {\n super(message);\n this.name = 'CsvFormatError';\n Object.setPrototypeOf(this, CsvFormatError.prototype);\n }\n }\n\n /**\n * AuthenticationError is thrown from login function which is dependency of remote server\n *\n * @public exported from `@promptbook/core`\n */\n class AuthenticationError extends Error {\n constructor(message) {\n super(message);\n this.name = 'AuthenticationError';\n Object.setPrototypeOf(this, AuthenticationError.prototype);\n }\n }\n\n /**\n * This error indicates that the pipeline collection cannot be properly loaded\n *\n * @public exported from `@promptbook/core`\n */\n class CollectionError extends Error {\n constructor(message) {\n super(message);\n this.name = 'CollectionError';\n Object.setPrototypeOf(this, CollectionError.prototype);\n }\n }\n\n /**\n * Signals that the requested operation could not be completed because the target already exists.\n *\n * @public exported from `@promptbook/core`\n */\n class ConflictError extends Error {\n constructor(message) {\n super(message);\n this.name = 'ConflictError';\n Object.setPrototypeOf(this, ConflictError.prototype);\n }\n }\n\n /**\n * This error indicates error from the database\n *\n * @public exported from `@promptbook/core`\n */\n class DatabaseError extends Error {\n constructor(message) {\n super(message);\n this.name = 'DatabaseError';\n Object.setPrototypeOf(this, DatabaseError.prototype);\n }\n }\n /**\n * TODO: [๐ฑโ๐] Explain that NotFoundError ([๐ฑโ๐] and other specific errors) has priority over DatabaseError in some contexts\n */\n\n /**\n * This error type indicates that you try to use a feature that is not available in the current environment\n *\n * @public exported from `@promptbook/core`\n */\n class EnvironmentMismatchError extends Error {\n constructor(message) {\n super(message);\n this.name = 'EnvironmentMismatchError';\n Object.setPrototypeOf(this, EnvironmentMismatchError.prototype);\n }\n }\n\n /**\n * This error occurs when some expectation is not met in the execution of the pipeline\n *\n * @public exported from `@promptbook/core`\n * Note: Do not throw this error, its reserved for `checkExpectations` and `createPipelineExecutor` and public ONLY to be serializable through remote server\n * Note: Always thrown in `checkExpectations` and catched in `createPipelineExecutor` and rethrown as `PipelineExecutionError`\n * Note: This is a kindof subtype of PipelineExecutionError\n */\n class ExpectError extends Error {\n constructor(message) {\n super(message);\n this.name = 'ExpectError';\n Object.setPrototypeOf(this, ExpectError.prototype);\n }\n }\n\n /**\n * This error indicates that the promptbook can not retrieve knowledge from external sources\n *\n * @public exported from `@promptbook/core`\n */\n class KnowledgeScrapeError extends Error {\n constructor(message) {\n super(message);\n this.name = 'KnowledgeScrapeError';\n Object.setPrototypeOf(this, KnowledgeScrapeError.prototype);\n }\n }\n\n /**\n * This error type indicates that some limit was reached\n *\n * @public exported from `@promptbook/core`\n */\n class LimitReachedError extends Error {\n constructor(message) {\n super(message);\n this.name = 'LimitReachedError';\n Object.setPrototypeOf(this, LimitReachedError.prototype);\n }\n }\n\n /**\n * This error type indicates that some tools are missing for pipeline execution or preparation\n *\n * @public exported from `@promptbook/core`\n */\n class MissingToolsError extends Error {\n constructor(message) {\n super(spaceTrim$1.spaceTrim((block) => `\n ${block(message)}\n\n Note: You have probably forgot to provide some tools for pipeline execution or preparation\n\n `));\n this.name = 'MissingToolsError';\n Object.setPrototypeOf(this, MissingToolsError.prototype);\n }\n }\n\n /**\n * This error indicates that promptbook operation is not allowed\n *\n * @public exported from `@promptbook/core`\n */\n class NotAllowed extends Error {\n constructor(message) {\n super(message);\n this.name = 'NotAllowed';\n Object.setPrototypeOf(this, NotAllowed.prototype);\n }\n }\n\n /**\n * This error indicates that promptbook not found in the collection\n *\n * @public exported from `@promptbook/core`\n */\n class NotFoundError extends Error {\n constructor(message) {\n super(message);\n this.name = 'NotFoundError';\n Object.setPrototypeOf(this, NotFoundError.prototype);\n }\n }\n\n /**\n * This error type indicates that some part of the code is not implemented yet\n *\n * @public exported from `@promptbook/core`\n */\n class NotYetImplementedError extends Error {\n constructor(message) {\n super(spaceTrim$1.spaceTrim((block) => `\n ${block(message)}\n\n Note: This feature is not implemented yet but it will be soon.\n\n If you want speed up the implementation or just read more, look here:\n https://github.com/webgptorg/promptbook\n\n Or contact us on pavol@ptbk.io\n\n `));\n this.name = 'NotYetImplementedError';\n Object.setPrototypeOf(this, NotYetImplementedError.prototype);\n }\n }\n\n /**\n * This error indicates that the promptbook in a markdown format cannot be parsed into a valid promptbook object\n *\n * @public exported from `@promptbook/core`\n */\n class ParseError extends Error {\n constructor(message) {\n super(message);\n this.name = 'ParseError';\n Object.setPrototypeOf(this, ParseError.prototype);\n }\n }\n /**\n * TODO: Maybe split `ParseError` and `ApplyError`\n */\n\n /**\n * Generates random token\n *\n * Note: `$` is used to indicate that this function is not a pure function - it is not deterministic\n * Note: This function is cryptographically secure (it uses crypto.randomBytes internally)\n *\n * @private internal helper function\n * @returns secure random token\n */\n function $randomToken(randomness) {\n return crypto$1.randomBytes(randomness).toString('hex');\n }\n /**\n * TODO: [๐คถ] Maybe export through `@promptbook/utils` or `@promptbook/random` package\n * TODO: Maybe use nanoid instead https://github.com/ai/nanoid\n */\n\n /**\n * This error indicates errors during the execution of the pipeline\n *\n * @public exported from `@promptbook/core`\n */\n class PipelineExecutionError extends Error {\n constructor(message) {\n // Added id parameter\n super(message);\n this.name = 'PipelineExecutionError';\n // TODO: [๐] DRY - Maybe $randomId\n this.id = `error-${$randomToken(8 /* <- TODO: To global config + Use Base58 to avoid similar char conflicts */)}`;\n Object.setPrototypeOf(this, PipelineExecutionError.prototype);\n }\n }\n /**\n * TODO: [๐ง ][๐] Add id to all errors\n */\n\n /**\n * This error indicates that the promptbook object has valid syntax (=can be parsed) but contains logical errors (like circular dependencies)\n *\n * @public exported from `@promptbook/core`\n */\n class PipelineLogicError extends Error {\n constructor(message) {\n super(message);\n this.name = 'PipelineLogicError';\n Object.setPrototypeOf(this, PipelineLogicError.prototype);\n }\n }\n\n /**\n * This error indicates errors in referencing promptbooks between each other\n *\n * @public exported from `@promptbook/core`\n */\n class PipelineUrlError extends Error {\n constructor(message) {\n super(message);\n this.name = 'PipelineUrlError';\n Object.setPrototypeOf(this, PipelineUrlError.prototype);\n }\n }\n\n /**\n * Error thrown when a fetch request fails\n *\n * @public exported from `@promptbook/core`\n */\n class PromptbookFetchError extends Error {\n constructor(message) {\n super(message);\n this.name = 'PromptbookFetchError';\n Object.setPrototypeOf(this, PromptbookFetchError.prototype);\n }\n }\n\n /**\n * Index of all custom errors\n *\n * @public exported from `@promptbook/core`\n */\n const PROMPTBOOK_ERRORS = {\n AbstractFormatError,\n CsvFormatError,\n CollectionError,\n EnvironmentMismatchError,\n ExpectError,\n KnowledgeScrapeError,\n LimitReachedError,\n MissingToolsError,\n NotFoundError,\n NotYetImplementedError,\n ParseError,\n PipelineExecutionError,\n PipelineLogicError,\n PipelineUrlError,\n AuthenticationError,\n PromptbookFetchError,\n UnexpectedError,\n WrappedError,\n NotAllowed,\n DatabaseError,\n ConflictError,\n // TODO: [๐ช]> VersionMismatchError,\n };\n /**\n * Index of all javascript errors\n *\n * @private for internal usage\n */\n const COMMON_JAVASCRIPT_ERRORS = {\n Error,\n EvalError,\n RangeError,\n ReferenceError,\n SyntaxError,\n TypeError,\n URIError,\n AggregateError,\n /*\n Note: Not widely supported\n > InternalError,\n > ModuleError,\n > HeapError,\n > WebAssemblyCompileError,\n > WebAssemblyRuntimeError,\n */\n };\n /**\n * Index of all errors\n *\n * @private for internal usage\n */\n const ALL_ERRORS = {\n ...PROMPTBOOK_ERRORS,\n ...COMMON_JAVASCRIPT_ERRORS,\n };\n /**\n * Note: [๐] Ignore a discrepancy between file name and entity name\n */\n\n /**\n * Deserializes the error object\n *\n * @public exported from `@promptbook/utils`\n */\n function deserializeError(error, isStackAddedToMessage = true) {\n const { name, stack, id } = error; // Added id\n let { message } = error;\n let ErrorClass = ALL_ERRORS[error.name];\n if (ErrorClass === undefined) {\n ErrorClass = Error;\n message = `${name}: ${message}`;\n }\n if (isStackAddedToMessage && stack !== undefined && stack !== '') {\n message = spaceTrim__default[\"default\"]((block) => `\n ${block(message)}\n\n Original stack trace:\n ${block(stack || '')}\n `);\n }\n const deserializedError = new ErrorClass(message);\n deserializedError.id = id; // Assign id to the error object\n return deserializedError;\n }\n\n /**\n * Serializes an error into a [๐] JSON-serializable object\n *\n * @public exported from `@promptbook/utils`\n */\n function serializeError(error) {\n const { name, message, stack } = error;\n const { id } = error;\n if (!Object.keys(ALL_ERRORS).includes(name)) {\n console.error(spaceTrim__default[\"default\"]((block) => `\n\n Cannot serialize error with name \"${name}\"\n\n Authors of Promptbook probably forgot to add this error into the list of errors:\n https://github.com/webgptorg/promptbook/blob/main/src/errors/0-index.ts\n\n\n ${block(stack || message)}\n\n `));\n }\n return {\n name: name,\n message,\n stack,\n id, // Include id in the serialized object\n };\n }\n\n /**\n * Async version of Array.forEach\n *\n * @param array - Array to iterate over\n * @param options - Options for the function\n * @param callbackfunction - Function to call for each item\n * @public exported from `@promptbook/utils`\n * @deprecated [๐ช] Use queues instead\n */\n async function forEachAsync(array, options, callbackfunction) {\n const { maxParallelCount = Infinity } = options;\n let index = 0;\n let runningTasks = [];\n const tasks = [];\n for (const item of array) {\n const currentIndex = index++;\n const task = callbackfunction(item, currentIndex, array);\n tasks.push(task);\n runningTasks.push(task);\n /* not await */ Promise.resolve(task).then(() => {\n runningTasks = runningTasks.filter((runningTask) => runningTask !== task);\n });\n if (maxParallelCount < runningTasks.length) {\n await Promise.race(runningTasks);\n }\n }\n await Promise.all(tasks);\n }\n\n /**\n * Function to check if a string is valid CSV\n *\n * @param value The string to check\n * @returns `true` if the string is a valid CSV string, false otherwise\n *\n * @public exported from `@promptbook/utils`\n */\n function isValidCsvString(value) {\n try {\n // A simple check for CSV format: at least one comma and no invalid characters\n if (value.includes(',') && /^[\\w\\s,\"']+$/.test(value)) {\n return true;\n }\n return false;\n }\n catch (error) {\n assertsError(error);\n return false;\n }\n }\n\n /**\n * Function isValidJsonString will tell you if the string is valid JSON or not\n *\n * @param value The string to check\n * @returns `true` if the string is a valid JSON string, false otherwise\n *\n * @public exported from `@promptbook/utils`\n */\n function isValidJsonString(value /* <- [๐จโโ๏ธ] */) {\n try {\n JSON.parse(value);\n return true;\n }\n catch (error) {\n assertsError(error);\n if (error.message.includes('Unexpected token')) {\n return false;\n }\n return false;\n }\n }\n\n /**\n * Converts a JavaScript Object Notation (JSON) string into an object.\n *\n * Note: This is wrapper around `JSON.parse()` with better error and type handling\n *\n * @public exported from `@promptbook/utils`\n */\n function jsonParse(value) {\n if (value === undefined) {\n throw new Error(`Can not parse JSON from undefined value.`);\n }\n else if (typeof value !== 'string') {\n console.error('Can not parse JSON from non-string value.', { text: value });\n throw new Error(spaceTrim__default[\"default\"](`\n Can not parse JSON from non-string value.\n\n The value type: ${typeof value}\n See more in console.\n `));\n }\n try {\n return JSON.parse(value);\n }\n catch (error) {\n if (!(error instanceof Error)) {\n throw error;\n }\n throw new Error(spaceTrim__default[\"default\"]((block) => `\n ${block(error.message)}\n\n The expected JSON text:\n ${block(value)}\n `));\n }\n }\n\n /**\n * Function to check if a string is valid XML\n *\n * @param value\n * @returns `true` if the string is a valid XML string, false otherwise\n *\n * @public exported from `@promptbook/utils`\n */\n function isValidXmlString(value) {\n try {\n const parser = new DOMParser();\n const parsedDocument = parser.parseFromString(value, 'application/xml');\n const parserError = parsedDocument.getElementsByTagName('parsererror');\n if (parserError.length > 0) {\n return false;\n }\n return true;\n }\n catch (error) {\n assertsError(error);\n return false;\n }\n }\n\n /**\n * Replaces parameters in template with values from parameters object\n *\n * Note: This function is not places strings into string,\n * It's more complex and can handle this operation specifically for LLM models\n *\n * @param template the template with parameters in {curly} braces\n * @param parameters the object with parameters\n * @returns the template with replaced parameters\n * @throws {PipelineExecutionError} if parameter is not defined, not closed, or not opened\n * @public exported from `@promptbook/utils`\n */\n function templateParameters(template, parameters) {\n for (const [parameterName, parameterValue] of Object.entries(parameters)) {\n if (parameterValue === RESERVED_PARAMETER_MISSING_VALUE) {\n throw new UnexpectedError(`Parameter \\`{${parameterName}}\\` has missing value`);\n }\n else if (parameterValue === RESERVED_PARAMETER_RESTRICTED) {\n // TODO: [๐ต]\n throw new UnexpectedError(`Parameter \\`{${parameterName}}\\` is restricted to use`);\n }\n }\n let replacedTemplates = template;\n let match;\n let loopLimit = LOOP_LIMIT;\n while ((match = /^(?Stack trace:
\n\n ## Stack trace:\n\n \\`\\`\\`stacktrace\n ${block(error.stack || '(empty)')}\n \\`\\`\\`\n${escapeHtml$1(paragraph).replace(/\\n/g, '
')}
${escapeHtml$1(citation.excerpt)}
` : '';\n const urlLink = citation.url\n ? `Open source`\n : '';\n return spaceTrim__default[\"default\"](`\n${avatarMarkup}
\n \n
\n \n \n \n
\n \n ${escapeHtml$1(visuals.displayName)}\n ${escapeHtml$1(upperSender)}\n
\n ${timestamp ? `` : ''}\n ${formatMessageContent(message.content)}
\n ${durationLabel\n ? `Responded in ${escapeHtml$1(durationLabel)}
`\n : ''}\n ${attachments}\n ${citations}\n No messages yet. Send a note to capture this chat.
';\n return spaceTrim__default[\"default\"](`\n \n \n \n \n \n \n \n \n \n \n \n
\n \n \n `);\n },\n mimeType: 'text/html',\n fileExtension: 'html',\n };\n /**\n * TODO: Enhance branding\n */\n\n /**\n * JSON export plugin (full metadata)\n *\n * @public exported from `@promptbook/components`\n */\n const jsonSaveFormatDefinition = {\n formatName: 'json',\n label: 'Json',\n getContent: ({ messages }) => JSON.stringify(messages, null, 2),\n mimeType: 'application/json',\n fileExtension: 'json',\n };\n\n /**\n * Markdown export plugin\n *\n * @public exported from `@promptbook/components`\n */\n const mdSaveFormatDefinition = {\n formatName: 'md',\n label: 'Markdown',\n getContent: ({ messages }) => spaceTrim$1.spaceTrim(`\n ${messages\n .map((message) => spaceTrim$1.spaceTrim(`\n **${message.sender}:**\n\n > ${message.content.replace(/\\n/g, '\\n> ')}\n `))\n .join('\\n\\n---\\n\\n')}\n\n ---\n\n _Exported from [Promptbook](https://ptbk.io)_\n `),\n mimeType: 'text/markdown',\n fileExtension: 'md',\n };\n\n /**\n * Builds display-ready timestamp and duration labels for a chat message.\n *\n * @private utility of `\n
\n Chat export
\nConversation with ${safeTitle}
\n${escapeHtml$1(heroSubtitle)}
\n\n ${statCards\n .map((stat) => spaceTrim__default[\"default\"](`\n
\n \n ${escapeHtml$1(stat.value)}\n ${escapeHtml$1(stat.label)}\n
\n `))\n .join('')}\n \n ![\"\"](\"${HERO_ILLUSTRATION_URL}\")
\n ![\"Promptbook](\"${BRAND_MARK_URL}\")
\n
\n \n
\n \n \n
\n \n Captured messages, ready to share
\n