@promptbook/utils 0.57.2 → 0.58.0

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

@@ -0,0 +1,53 @@
+import type { string_mime_type } from '../../types/typeAliases';
+import type { string_name } from '../../types/typeAliases';
+/**
+ * A format definition is a set of functions that define how to validate, heal and convert response from LLM
+ *
+ * @see https://github.com/webgptorg/promptbook/discussions/36
+ */
+export type FormatDefinition<TValue extends TPartialValue, TPartialValue extends string, TSchema extends object> = {
+    /**
+     * The name of the format used in .ptbk.md files
+     *
+     * @sample "JSON"
+     */
+    readonly name: string_name;
+    /**
+     * The mime type of the format (if any)
+     *
+     * @sample "application/json"
+     */
+    readonly mimeType?: string_mime_type;
+    /**
+     * Check if a value is fully valid
+     *
+     * @param value The value to check, for example "{\"foo\": true}"
+     * @param schema Optional schema to do extra validation
+     */
+    isValid(value: string, schema?: TSchema): value is TValue;
+    /**
+     * Check if a first part of a value is valid
+     *
+     * @see https://github.com/webgptorg/promptbook/discussions/37
+     *
+     * @param partialValue Partial value to check, for example "{\"foo\": t"
+     * @param schema Optional schema to do extra validation
+     */
+    canBeValid(partialValue: string, schema?: TSchema): partialValue is TPartialValue;
+    /**
+     * Heal a value to make it valid if possible
+     *
+     * Note: This make sense in context of LLMs that often returns slightly invalid values
+     * @see https://github.com/webgptorg/promptbook/discussions/31
+     *
+     * @param value The value to heal, for example "{foo: true}"
+     * @param scheme
+     * @throws {Error} If the value cannot be healed
+     */
+    heal(value: string, scheme?: TSchema): TValue;
+};
+/**
+ * TODO: [👨‍⚖️] Compute TPartialValue dynamically - PartialString<TValue>
+ * TODO: [🧠] Should execution tools be aviable to heal, canBeValid and isValid?
+ * TODO: [🧠] llm Provider Bindings
+ */

package/esm/typings/formats/index.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Definitions for all formats supported by Promptbook
+ */
+export declare const FORMAT_DEFINITIONS: import("./_common/FormatDefinition").FormatDefinition<string, string, object>[];

package/esm/typings/formats/json/JsonFormatDefinition.d.ts

@@ -0,0 +1,11 @@
+import type { FormatDefinition } from '../_common/FormatDefinition';
+/**
+ * Definition for JSON format
+ */
+export declare const JsonFormatDefinition: FormatDefinition<string, string, object>;
+/**
+ * TODO: [🧠] Maybe propper instance of object
+ * TODO: [0] Make string_serialized_json
+ * TODO: [1] Make type for JSON Schema
+ * TODO: [🧠] What to use for validating JSONs - JSON Schema, ZoD, typescript types/interfaces,...?
+ */

package/esm/typings/formats/xml/XmlFormatDefinition.d.ts

@@ -0,0 +1,11 @@
+import type { FormatDefinition } from '../_common/FormatDefinition';
+/**
+ * Definition for XML format
+ */
+export declare const XmlFormatDefinition: FormatDefinition<string, string, object>;
+/**
+ * TODO: [🧠] Maybe propper instance of object
+ * TODO: [0] Make string_serialized_xml
+ * TODO: [1] Make type for XML Schema
+ * TODO: [🧠] What to use for validating XMLs - XSD,...
+ */

package/{umd/typings/execution/plugins/user-interface-execution-tools → esm/typings/knowledgebase/dialogs}/callback/CallbackInterfaceTools.d.ts

@@ -1,5 +1,5 @@
-import type { UserInterfaceTools } from '../../../UserInterfaceTools';
-import type { UserInterfaceToolsPromptDialogOptions } from '../../../UserInterfaceTools';
+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

package/esm/typings/{execution/plugins/user-interface-execution-tools → knowledgebase/dialogs}/callback/CallbackInterfaceToolsOptions.d.ts

@@ -1,6 +1,6 @@
 import type { Promisable } from 'type-fest';
-import type { CommonExecutionToolsOptions } from '../../../CommonExecutionToolsOptions';
-import type { UserInterfaceToolsPromptDialogOptions } from '../../../UserInterfaceTools';
+import type { CommonExecutionToolsOptions } from '../../../execution/CommonExecutionToolsOptions';
+import type { UserInterfaceToolsPromptDialogOptions } from '../../../execution/UserInterfaceTools';
 /**
  * Options for CallbackInterfaceTools
  */

package/esm/typings/{execution/plugins/user-interface-execution-tools → knowledgebase/dialogs}/simple-prompt/SimplePromptInterfaceTools.d.ts

@@ -1,6 +1,6 @@
-import type { CommonExecutionToolsOptions } from '../../../CommonExecutionToolsOptions';
-import type { UserInterfaceTools } from '../../../UserInterfaceTools';
-import type { UserInterfaceToolsPromptDialogOptions } from '../../../UserInterfaceTools';
+import type { CommonExecutionToolsOptions } from '../../../execution/CommonExecutionToolsOptions';
+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
  *

package/esm/typings/{execution/plugins/llm-execution-tools → llm-providers}/anthropic-claude/AnthropicClaudeExecutionTools.d.ts

@@ -1,8 +1,8 @@
-import type { Prompt } from '../../../../types/Prompt';
-import type { AvailableModel } from '../../../LlmExecutionTools';
-import type { LlmExecutionTools } from '../../../LlmExecutionTools';
-import type { PromptChatResult } from '../../../PromptResult';
-import type { PromptCompletionResult } from '../../../PromptResult';
+import type { AvailableModel } from '../../execution/LlmExecutionTools';
+import type { LlmExecutionTools } from '../../execution/LlmExecutionTools';
+import type { PromptChatResult } from '../../execution/PromptResult';
+import type { PromptCompletionResult } from '../../execution/PromptResult';
+import type { Prompt } from '../../types/Prompt';
 import type { AnthropicClaudeExecutionToolsOptions } from './AnthropicClaudeExecutionToolsOptions';
 /**
  * Execution Tools for calling Anthropic Claude API.

package/{umd/typings/execution/plugins/llm-execution-tools → esm/typings/llm-providers}/anthropic-claude/AnthropicClaudeExecutionToolsOptions.d.ts

@@ -1,5 +1,5 @@
 import type { ClientOptions } from '@anthropic-ai/sdk';
-import type { CommonExecutionToolsOptions } from '../../../CommonExecutionToolsOptions';
+import type { CommonExecutionToolsOptions } from '../../execution/CommonExecutionToolsOptions';
 /**
  * Options for AnthropicClaudeExecutionTools
  *

package/{umd/typings/execution/plugins/llm-execution-tools → esm/typings/llm-providers}/anthropic-claude/anthropic-claude-models.d.ts

@@ -1,5 +1,5 @@
-import type { number_usd } from '../../../../types/typeAliases';
-import type { AvailableModel } from '../../../LlmExecutionTools';
+import type { AvailableModel } from '../../execution/LlmExecutionTools';
+import type { number_usd } from '../../types/typeAliases';
 /**
  * List of available Anthropic Claude models with pricing
  *

package/{umd/typings/execution/plugins/llm-execution-tools → esm/typings/llm-providers}/azure-openai/AzureOpenAiExecutionTools.d.ts

@@ -1,8 +1,8 @@
-import type { Prompt } from '../../../../types/Prompt';
-import type { AvailableModel } from '../../../LlmExecutionTools';
-import type { LlmExecutionTools } from '../../../LlmExecutionTools';
-import type { PromptChatResult } from '../../../PromptResult';
-import type { PromptCompletionResult } from '../../../PromptResult';
+import type { AvailableModel } from '../../execution/LlmExecutionTools';
+import type { LlmExecutionTools } from '../../execution/LlmExecutionTools';
+import type { PromptChatResult } from '../../execution/PromptResult';
+import type { PromptCompletionResult } from '../../execution/PromptResult';
+import type { Prompt } from '../../types/Prompt';
 import type { AzureOpenAiExecutionToolsOptions } from './AzureOpenAiExecutionToolsOptions';
 /**
  * Execution Tools for calling Azure OpenAI API.

package/{umd/typings/execution/plugins/llm-execution-tools → esm/typings/llm-providers}/azure-openai/AzureOpenAiExecutionToolsOptions.d.ts

@@ -1,6 +1,6 @@
-import type { string_name } from '../../../../types/typeAliases';
-import type { string_token } from '../../../../types/typeAliases';
-import type { CommonExecutionToolsOptions } from '../../../CommonExecutionToolsOptions';
+import type { CommonExecutionToolsOptions } from '../../execution/CommonExecutionToolsOptions';
+import type { string_name } from '../../types/typeAliases';
+import type { string_token } from '../../types/typeAliases';
 /**
  * Options for AzureOpenAiExecutionTools
  *

package/esm/typings/{execution/plugins/llm-execution-tools → llm-providers}/langtail/LangtailExecutionTools.d.ts

@@ -1,4 +1,4 @@
-import type { LlmExecutionTools } from '../../../LlmExecutionTools';
+import type { LlmExecutionTools } from '../../execution/LlmExecutionTools';
 import { OpenAiExecutionTools } from '../openai/OpenAiExecutionTools';
 /**
  * Execution Tools for calling OpenAI API.

package/{umd/typings/execution/plugins/llm-execution-tools → esm/typings/llm-providers}/mocked/MockedEchoLlmExecutionTools.d.ts

@@ -1,9 +1,9 @@
-import type { Prompt } from '../../../../types/Prompt';
-import type { CommonExecutionToolsOptions } from '../../../CommonExecutionToolsOptions';
-import type { AvailableModel } from '../../../LlmExecutionTools';
-import type { LlmExecutionTools } from '../../../LlmExecutionTools';
-import type { PromptChatResult } from '../../../PromptResult';
-import type { PromptCompletionResult } from '../../../PromptResult';
+import type { CommonExecutionToolsOptions } from '../../execution/CommonExecutionToolsOptions';
+import type { AvailableModel } from '../../execution/LlmExecutionTools';
+import type { LlmExecutionTools } from '../../execution/LlmExecutionTools';
+import type { PromptChatResult } from '../../execution/PromptResult';
+import type { PromptCompletionResult } from '../../execution/PromptResult';
+import type { Prompt } from '../../types/Prompt';
 /**
  * Mocked execution Tools for just echoing the requests for testing purposes.
  */

package/{umd/typings/execution/plugins/llm-execution-tools → esm/typings/llm-providers}/mocked/MockedFackedLlmExecutionTools.d.ts

@@ -1,9 +1,9 @@
-import type { Prompt } from '../../../../types/Prompt';
-import type { CommonExecutionToolsOptions } from '../../../CommonExecutionToolsOptions';
-import type { AvailableModel } from '../../../LlmExecutionTools';
-import type { LlmExecutionTools } from '../../../LlmExecutionTools';
-import type { PromptChatResult } from '../../../PromptResult';
-import type { PromptCompletionResult } from '../../../PromptResult';
+import type { CommonExecutionToolsOptions } from '../../execution/CommonExecutionToolsOptions';
+import type { AvailableModel } from '../../execution/LlmExecutionTools';
+import type { LlmExecutionTools } from '../../execution/LlmExecutionTools';
+import type { PromptChatResult } from '../../execution/PromptResult';
+import type { PromptCompletionResult } from '../../execution/PromptResult';
+import type { Prompt } from '../../types/Prompt';
 /**
  * Mocked execution Tools for just faking expected responses for testing purposes
  */

package/esm/typings/{execution/plugins/llm-execution-tools → llm-providers}/mocked/fakeTextToExpectations.d.ts

@@ -1,5 +1,5 @@
-import type { Expectations } from '../../../../types/PromptbookJson/PromptTemplateJson';
-import type { PostprocessingFunction } from '../../script-execution-tools/javascript/JavascriptExecutionToolsOptions';
+import type { PostprocessingFunction } from '../../scripting/javascript/JavascriptExecutionToolsOptions';
+import type { Expectations } from '../../types/PromptbookJson/PromptTemplateJson';
 /**
  * Gets the expectations and creates a fake text that meets the expectations
  *

package/{umd/typings/execution/plugins/llm-execution-tools → esm/typings/llm-providers}/multiple/MultipleLlmExecutionTools.d.ts

@@ -1,8 +1,8 @@
-import type { Prompt } from '../../../../types/Prompt';
-import type { AvailableModel } from '../../../LlmExecutionTools';
-import type { LlmExecutionTools } from '../../../LlmExecutionTools';
-import type { PromptChatResult } from '../../../PromptResult';
-import type { PromptCompletionResult } from '../../../PromptResult';
+import type { AvailableModel } from '../../execution/LlmExecutionTools';
+import type { LlmExecutionTools } from '../../execution/LlmExecutionTools';
+import type { PromptChatResult } from '../../execution/PromptResult';
+import type { PromptCompletionResult } from '../../execution/PromptResult';
+import type { Prompt } from '../../types/Prompt';
 /**
  * Multiple LLM Execution Tools is a proxy server that uses multiple execution tools internally and exposes the executor interface externally.
  *

package/{umd/typings/execution/plugins/llm-execution-tools → esm/typings/llm-providers}/multiple/MultipleLlmExecutionToolsOptions.d.ts

@@ -1,6 +1,6 @@
-import type { client_id } from '../../../../types/typeAliases';
-import type { string_uri } from '../../../../types/typeAliases';
-import type { CommonExecutionToolsOptions } from '../../../CommonExecutionToolsOptions';
+import type { CommonExecutionToolsOptions } from '../../execution/CommonExecutionToolsOptions';
+import type { client_id } from '../../types/typeAliases';
+import type { string_uri } from '../../types/typeAliases';
 /**
  * Options for MultipleLlmExecutionTools
  */

package/{umd/typings/execution/plugins/llm-execution-tools → esm/typings/llm-providers}/openai/OpenAiExecutionTools.d.ts

@@ -1,8 +1,8 @@
-import type { Prompt } from '../../../../types/Prompt';
-import type { AvailableModel } from '../../../LlmExecutionTools';
-import type { LlmExecutionTools } from '../../../LlmExecutionTools';
-import type { PromptChatResult } from '../../../PromptResult';
-import type { PromptCompletionResult } from '../../../PromptResult';
+import type { AvailableModel } from '../../execution/LlmExecutionTools';
+import type { LlmExecutionTools } from '../../execution/LlmExecutionTools';
+import type { PromptChatResult } from '../../execution/PromptResult';
+import type { PromptCompletionResult } from '../../execution/PromptResult';
+import type { Prompt } from '../../types/Prompt';
 import type { OpenAiExecutionToolsOptions } from './OpenAiExecutionToolsOptions';
 /**
  * Execution Tools for calling OpenAI API.

package/{umd/typings/execution/plugins/llm-execution-tools → esm/typings/llm-providers}/openai/OpenAiExecutionToolsOptions.d.ts

@@ -1,6 +1,6 @@
 import type { ClientOptions } from 'openai';
-import type { string_token } from '../../../../types/typeAliases';
-import type { CommonExecutionToolsOptions } from '../../../CommonExecutionToolsOptions';
+import type { CommonExecutionToolsOptions } from '../../execution/CommonExecutionToolsOptions';
+import type { string_token } from '../../types/typeAliases';
 /**
  * Options for OpenAiExecutionTools
  *

package/esm/typings/{execution/plugins/llm-execution-tools → llm-providers}/openai/computeOpenaiUsage.d.ts

@@ -1,7 +1,7 @@
 import type OpenAI from 'openai';
-import type { Prompt } from '../../../../types/Prompt';
-import type { PromptResult } from '../../../PromptResult';
-import type { PromptResultUsage } from '../../../PromptResult';
+import type { PromptResult } from '../../execution/PromptResult';
+import type { PromptResultUsage } from '../../execution/PromptResult';
+import type { Prompt } from '../../types/Prompt';
 /**
  * Computes the usage of the OpenAI API based on the response from OpenAI
  *

package/{umd/typings/execution/plugins/llm-execution-tools → esm/typings/llm-providers}/openai/openai-models.d.ts

@@ -1,5 +1,5 @@
-import type { number_usd } from '../../../../types/typeAliases';
-import type { AvailableModel } from '../../../LlmExecutionTools';
+import type { AvailableModel } from '../../execution/LlmExecutionTools';
+import type { number_usd } from '../../types/typeAliases';
 /**
  * List of available OpenAI models with pricing
  *

package/esm/typings/{execution/plugins/llm-execution-tools → llm-providers}/remote/RemoteLlmExecutionTools.d.ts

@@ -1,8 +1,8 @@
-import type { Prompt } from '../../../../types/Prompt';
-import type { AvailableModel } from '../../../LlmExecutionTools';
-import type { LlmExecutionTools } from '../../../LlmExecutionTools';
-import type { PromptChatResult } from '../../../PromptResult';
-import type { PromptCompletionResult } from '../../../PromptResult';
+import type { AvailableModel } from '../../execution/LlmExecutionTools';
+import type { LlmExecutionTools } from '../../execution/LlmExecutionTools';
+import type { PromptChatResult } from '../../execution/PromptResult';
+import type { PromptCompletionResult } from '../../execution/PromptResult';
+import type { Prompt } from '../../types/Prompt';
 import type { RemoteLlmExecutionToolsOptions } from './RemoteLlmExecutionToolsOptions';
 /**
  * Remote server is a proxy server that uses its execution tools internally and exposes the executor interface externally.

package/{umd/typings/execution/plugins/llm-execution-tools → esm/typings/llm-providers}/remote/RemoteLlmExecutionToolsOptions.d.ts

@@ -1,6 +1,6 @@
-import type { client_id } from '../../../../types/typeAliases';
-import type { string_uri } from '../../../../types/typeAliases';
-import type { CommonExecutionToolsOptions } from '../../../CommonExecutionToolsOptions';
+import type { CommonExecutionToolsOptions } from '../../execution/CommonExecutionToolsOptions';
+import type { client_id } from '../../types/typeAliases';
+import type { string_uri } from '../../types/typeAliases';
 /**
  * Options for RemoteLlmExecutionTools
  */

package/esm/typings/{execution/plugins/llm-execution-tools → llm-providers}/remote/interfaces/Promptbook_Server_Progress.d.ts

@@ -1,4 +1,4 @@
-import type { TaskProgress } from '../../../../../types/TaskProgress';
+import type { TaskProgress } from '../../../types/TaskProgress';
 /**
  * Socket.io progress for remote text generation
  *

package/{umd/typings/execution/plugins/llm-execution-tools → esm/typings/llm-providers}/remote/interfaces/Promptbook_Server_Request.d.ts

@@ -1,5 +1,5 @@
-import type { client_id } from '../../../../../types/typeAliases';
-import type { Prompt } from '../../../../../types/Prompt';
+import type { Prompt } from '../../../types/Prompt';
+import type { client_id } from '../../../types/typeAliases';
 /**
  * Socket.io progress for remote text generation
  *

package/esm/typings/{execution/plugins/llm-execution-tools → llm-providers}/remote/interfaces/Promptbook_Server_Response.d.ts

@@ -1,4 +1,4 @@
-import type { PromptResult } from '../../../../PromptResult';
+import type { PromptResult } from '../../../execution/PromptResult';
 /**
  * Socket.io error for remote text generation
  *

package/{umd/typings/execution/plugins/llm-execution-tools → esm/typings/llm-providers}/remote/interfaces/RemoteServerOptions.d.ts

@@ -1,8 +1,8 @@
-import type { PromptbookLibrary } from '../../../../../library/PromptbookLibrary';
-import type { client_id } from '../../../../../types/typeAliases';
-import type { string_uri } from '../../../../../types/typeAliases';
-import type { CommonExecutionToolsOptions } from '../../../../CommonExecutionToolsOptions';
-import type { LlmExecutionTools } from '../../../../LlmExecutionTools';
+import type { CommonExecutionToolsOptions } from '../../../execution/CommonExecutionToolsOptions';
+import type { LlmExecutionTools } from '../../../execution/LlmExecutionTools';
+import type { PromptbookLibrary } from '../../../library/PromptbookLibrary';
+import type { client_id } from '../../../types/typeAliases';
+import type { string_uri } from '../../../types/typeAliases';
 export type RemoteServerOptions = CommonExecutionToolsOptions & {
     /**
      * Port on which the server will listen

package/esm/typings/scripting/_test/script-execution-errors.test.d.ts

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

package/esm/typings/scripting/_test/script-execution-tools.test.d.ts

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

package/esm/typings/{execution/plugins/script-execution-tools → scripting}/javascript/JavascriptEvalExecutionTools.d.ts

@@ -1,5 +1,5 @@
-import { ScriptExecutionTools, ScriptExecutionToolsExecuteOptions } from '../../../ScriptExecutionTools';
-import { JavascriptExecutionToolsOptions } from './JavascriptExecutionToolsOptions';
+import type { ScriptExecutionTools, ScriptExecutionToolsExecuteOptions } from '../../execution/ScriptExecutionTools';
+import type { JavascriptExecutionToolsOptions } from './JavascriptExecutionToolsOptions';
 /**
  * ScriptExecutionTools for JavaScript implemented via eval
  *

package/esm/typings/{execution/plugins/script-execution-tools → scripting}/javascript/JavascriptExecutionToolsOptions.d.ts

@@ -1,6 +1,6 @@
 import type { Promisable } from 'type-fest';
-import type { string_javascript_name } from '../../../../types/typeAliases';
-import type { CommonExecutionToolsOptions } from '../../../CommonExecutionToolsOptions';
+import type { CommonExecutionToolsOptions } from '../../execution/CommonExecutionToolsOptions';
+import type { string_javascript_name } from '../../types/typeAliases';
 /**
  * Options for javascript execution
  */

package/{umd/typings/execution/plugins/script-execution-tools → esm/typings/scripting}/python/PythonExecutionTools.d.ts

@@ -1,6 +1,6 @@
-import type { CommonExecutionToolsOptions } from '../../../CommonExecutionToolsOptions';
-import type { ScriptExecutionTools } from '../../../ScriptExecutionTools';
-import type { ScriptExecutionToolsExecuteOptions } from '../../../ScriptExecutionTools';
+import type { CommonExecutionToolsOptions } from '../../execution/CommonExecutionToolsOptions';
+import type { ScriptExecutionTools } from '../../execution/ScriptExecutionTools';
+import type { ScriptExecutionToolsExecuteOptions } from '../../execution/ScriptExecutionTools';
 /**
  * ScriptExecutionTools for Python
  *

package/esm/typings/{execution/plugins/script-execution-tools → scripting}/typescript/TypescriptExecutionTools.d.ts

@@ -1,6 +1,6 @@
-import type { CommonExecutionToolsOptions } from '../../../CommonExecutionToolsOptions';
-import type { ScriptExecutionTools } from '../../../ScriptExecutionTools';
-import type { ScriptExecutionToolsExecuteOptions } from '../../../ScriptExecutionTools';
+import type { CommonExecutionToolsOptions } from '../../execution/CommonExecutionToolsOptions';
+import type { ScriptExecutionTools } from '../../execution/ScriptExecutionTools';
+import type { ScriptExecutionToolsExecuteOptions } from '../../execution/ScriptExecutionTools';
 /**
  * ScriptExecutionTools for TypeScript
  *

package/esm/typings/types/Prompt.d.ts

@@ -1,4 +1,4 @@
-import type { PostprocessingFunction } from '../execution/plugins/script-execution-tools/javascript/JavascriptExecutionToolsOptions';
+import type { PostprocessingFunction } from '../scripting/javascript/JavascriptExecutionToolsOptions';
 import type { ExpectFormatCommand } from './Command';
 import type { ModelRequirements } from './ModelRequirements';
 import type { Expectations } from './PromptbookJson/PromptTemplateJson';

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@promptbook/utils",
-    "version": "0.57.2",
+    "version": "0.58.0",
     "description": "Library to supercharge your use of large language models",
     "private": false,
     "sideEffects": false,

package/umd/index.umd.js

@@ -1008,6 +1008,25 @@
         return replacedTemplate;
     }
 
+    /**
+     * Function isValidJsonString will tell you if the string is valid JSON or not
+     */
+    function isValidJsonString(value /* <-[👨‍⚖️] */) {
+        try {
+            JSON.parse(value);
+            return true;
+        }
+        catch (error) {
+            if (!(error instanceof Error)) {
+                throw error;
+            }
+            if (error.message.includes('Unexpected token')) {
+                return false;
+            }
+            return false;
+        }
+    }
+
     /**
      * Counts number of characters in the text
      */
@@ -1082,25 +1101,6 @@
         PAGES: countPages,
     };
 
-    /**
-     * Function isValidJsonString will tell you if the string is valid JSON or not
-     */
-    function isValidJsonString(value) {
-        try {
-            JSON.parse(value);
-            return true;
-        }
-        catch (error) {
-            if (!(error instanceof Error)) {
-                throw error;
-            }
-            if (error.message.includes('Unexpected token')) {
-                return false;
-            }
-            return false;
-        }
-    }
-
     /**
      * Makes first letter of a string uppercase
      *
@@ -1695,7 +1695,7 @@
     /**
      * The version of the Promptbook library
      */
-    var PROMPTBOOK_VERSION = '0.57.1';
+    var PROMPTBOOK_VERSION = '0.57.2';
 
     // @promptbook/utils
     // And the normalization (originally n12 library) utilities: