@promptbook/openai 0.35.1 → 0.36.2

package/esm/typings/types/execution-report/ExecutionReportJson.d.ts

@@ -1,6 +1,6 @@
 import type { PromptResult } from '../../execution/PromptResult';
 import type { Prompt } from '../Prompt';
-import type { string_ptbk_url, string_version } from '../typeAliases';
+import type { string_promptbook_url, string_version } from '../typeAliases';
 /**
  * ExecutionReport is result of executing one promptbook
  * It is kind of a variant of the promptbook usefull for debugging, logging and transparency for users.
@@ -13,23 +13,23 @@ import type { string_ptbk_url, string_version } from '../typeAliases';
  */
 export type ExecutionReportJson = {
     /**
-     * Unique identifier of the ptp from ptp which was executed
+     * Unique identifier of the promptbook from promptbook which was executed
      */
-    readonly ptbkUrl?: string_ptbk_url;
+    readonly promptbookUrl?: string_promptbook_url;
     /**
-     * Title of from ptp which was executed
+     * Title of from promptbook which was executed
      */
     readonly title?: string;
     /**
-     * Version from ptp which was executed
+     * Version from promptbook which was executed
      */
-    readonly ptbkUsedVersion: string_version;
+    readonly promptbookUsedVersion: string_version;
     /**
-     * Version from ptp which was requested by promptbook
+     * Version from promptbook which was requested by promptbook
      */
-    readonly ptbkRequestedVersion?: string_version;
+    readonly promptbookRequestedVersion?: string_version;
     /**
-     * Description of the ptp which was executed
+     * Description of the promptbook which was executed
      */
     readonly description?: string;
     /**
@@ -39,7 +39,7 @@ export type ExecutionReportJson = {
         /**
          * The prompt wich was executed
          */
-        prompt: Omit<Prompt, 'ptbkUrl' | 'parameters'>;
+        prompt: Omit<Prompt, 'promptbookUrl' | 'parameters'>;
         /**
          * Result of the prompt execution (if not failed during LLM execution)
          */

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

@@ -179,15 +179,15 @@ export type string_url = string;
 /**
  * Semantic helper
  *
- * For example `"https://ptbk.webgpt.com/cs/write-website-content.ptbk.md@v2.4.15"`
+ * For example `"https://promptbook.webgpt.com/cs/write-website-content.ptbk.md@v2.4.15"`
  */
-export type string_ptbk_url = string;
+export type string_promptbook_url = string;
 /**
  * Semantic helper
  *
- * For example `"https://ptbk.webgpt.com/cs/write-website-content.ptbk.md@v2.4.15#keywords"`
+ * For example `"https://promptbook.webgpt.com/cs/write-website-content.ptbk.md@v2.4.15#keywords"`
  */
-export type string_ptbk_url_with_hashtemplate = string;
+export type string_promptbook_url_with_hashtemplate = string;
 /**
  * Semantic helper
  *

package/esm/typings/utils/expectation-counters/countCharacters.d.ts

@@ -1,4 +1,4 @@
-import type { ExpectationAmount } from '../../types/PromptTemplatePipelineJson/PromptTemplateJson';
+import type { ExpectationAmount } from '../../types/PromptbookJson/PromptTemplateJson';
 /**
  * Counts number of characters in the text
  */

package/esm/typings/utils/expectation-counters/countLines.d.ts

@@ -1,4 +1,4 @@
-import type { ExpectationAmount } from '../../types/PromptTemplatePipelineJson/PromptTemplateJson';
+import type { ExpectationAmount } from '../../types/PromptbookJson/PromptTemplateJson';
 /**
  * Counts number of lines in the text
  */

package/esm/typings/utils/expectation-counters/countPages.d.ts

@@ -1,4 +1,4 @@
-import type { ExpectationAmount } from '../../types/PromptTemplatePipelineJson/PromptTemplateJson';
+import type { ExpectationAmount } from '../../types/PromptbookJson/PromptTemplateJson';
 /**
  * Counts number of pages in the text
  */

package/esm/typings/utils/expectation-counters/countParagraphs.d.ts

@@ -1,4 +1,4 @@
-import type { ExpectationAmount } from '../../types/PromptTemplatePipelineJson/PromptTemplateJson';
+import type { ExpectationAmount } from '../../types/PromptbookJson/PromptTemplateJson';
 /**
  * Counts number of paragraphs in the text
  */

package/esm/typings/utils/expectation-counters/countSentences.d.ts

@@ -1,4 +1,4 @@
-import type { ExpectationAmount } from '../../types/PromptTemplatePipelineJson/PromptTemplateJson';
+import type { ExpectationAmount } from '../../types/PromptbookJson/PromptTemplateJson';
 /**
  * Counts number of sentences in the text
  */

package/esm/typings/utils/expectation-counters/countWords.d.ts

@@ -1,4 +1,4 @@
-import type { ExpectationAmount } from '../../types/PromptTemplatePipelineJson/PromptTemplateJson';
+import type { ExpectationAmount } from '../../types/PromptbookJson/PromptTemplateJson';
 /**
  * Counts number of words in the text
  */

package/esm/typings/utils/expectation-counters/index.d.ts

@@ -1,4 +1,4 @@
-import type { ExpectationAmount, ExpectationUnit } from '../../types/PromptTemplatePipelineJson/PromptTemplateJson';
+import type { ExpectationAmount, ExpectationUnit } from '../../types/PromptbookJson/PromptTemplateJson';
 /**
  * Index of all counter functions
  */

package/esm/typings/utils/isRunningInWhatever.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Detects if the code is running in a browser environment in main thread (Not in a web worker)
+ */
+export declare const isRunningInBrowser: Function;
+/**
+ * Detects if the code is running in a Node.js environment
+ */
+export declare const isRunningInNode: Function;
+/**
+ * Detects if the code is running in a web worker
+ */
+export declare const isRunningInWebWorker: Function;

package/esm/typings/version.d.ts

@@ -2,4 +2,4 @@ import type { string_version } from './types/typeAliases';
 /**
  * The version of the Promptbook library
  */
-export declare const PTBK_VERSION: string_version;
+export declare const PROMPTBOOK_VERSION: string_version;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@promptbook/openai",
-    "version": "0.35.1",
+    "version": "0.36.2",
     "description": "Library to supercharge your use of large language models",
     "private": false,
     "sideEffects": false,
@@ -37,7 +37,7 @@
         "openai": "4.2.0"
     },
     "peerDependencies": {
-        "@promptbook/core": "0.35.1"
+        "@promptbook/core": "0.36.2"
     },
     "main": "./umd/index.umd.js",
     "module": "./esm/index.es.js",

package/umd/index.umd.js

@@ -101,7 +101,7 @@
                 completion: 0.002,
             },
             'gpt-4-0613': {
-                // TODO: !!! Not sure if this is correct
+                // TODO: Not sure if this is correct
                 prompt: 0.01,
                 completion: 0.03,
             },

package/umd/typings/_packages/core.index.d.ts

@@ -1,16 +1,16 @@
-import { PromptTemplatePipelineLibrary } from '../classes/PromptTemplatePipelineLibrary';
-import { PTBK_VERSION } from '../version';
-import { promptTemplatePipelineStringToJson } from '../conversion/promptTemplatePipelineStringToJson';
-import { validatePromptTemplatePipelineJson } from '../conversion/validatePromptTemplatePipelineJson';
-import { createPtpExecutor } from '../execution/createPtpExecutor';
+import { PromptbookLibrary } from '../classes/PromptbookLibrary';
+import { promptbookStringToJson } from '../conversion/promptbookStringToJson';
+import { validatePromptbookJson } from '../conversion/validatePromptbookJson';
+import { createPromptbookExecutor } from '../execution/createPromptbookExecutor';
 import { MockedEchoNaturalExecutionTools } from '../execution/plugins/natural-execution-tools/mocked/MockedEchoNaturalExecutionTools';
 import { CallbackInterfaceTools } from '../execution/plugins/user-interface-execution-tools/callback/CallbackInterfaceTools';
 import { CallbackInterfaceToolsOptions } from '../execution/plugins/user-interface-execution-tools/callback/CallbackInterfaceToolsOptions';
 import { SimplePromptInterfaceTools } from '../execution/plugins/user-interface-execution-tools/simple-prompt/SimplePromptInterfaceTools';
 import { ExecutionTypes } from '../types/ExecutionTypes';
-export { ExecutionTypes, PTBK_VERSION, PromptTemplatePipelineLibrary };
+import { PROMPTBOOK_VERSION } from '../version';
+export { ExecutionTypes, PROMPTBOOK_VERSION, PromptbookLibrary };
 export { SimplePromptInterfaceTools };
-export { promptTemplatePipelineStringToJson, validatePromptTemplatePipelineJson };
+export { promptbookStringToJson, validatePromptbookJson };
 export { MockedEchoNaturalExecutionTools };
-export { createPtpExecutor };
+export { createPromptbookExecutor };
 export { CallbackInterfaceTools, CallbackInterfaceToolsOptions };

package/umd/typings/_packages/remote-server.index.d.ts

@@ -1,3 +1,3 @@
 import { RemoteServerOptions } from '../execution/plugins/natural-execution-tools/remote/interfaces/RemoteServerOptions';
-import { runRemoteServer } from '../execution/plugins/natural-execution-tools/remote/runRemoteServer';
-export { RemoteServerOptions, runRemoteServer };
+import { startRemoteServer } from '../execution/plugins/natural-execution-tools/remote/startRemoteServer';
+export { RemoteServerOptions, startRemoteServer };

package/umd/typings/_packages/types.index.d.ts

@@ -2,24 +2,24 @@ import type { CommonExecutionToolsOptions } from '../execution/CommonExecutionTo
 import type { ExecutionTools } from '../execution/ExecutionTools';
 import type { NaturalExecutionTools } from '../execution/NaturalExecutionTools';
 import type { PromptChatResult, PromptCommonResult, PromptCompletionResult, PromptResult } from '../execution/PromptResult';
-import type { PtpExecutor } from '../execution/PtpExecutor';
+import type { PromptbookExecutor } from '../execution/PromptbookExecutor';
 import type { ScriptExecutionTools, ScriptExecutionToolsExecuteOptions } from '../execution/ScriptExecutionTools';
 import type { UserInterfaceTools, UserInterfaceToolsPromptDialogOptions } from '../execution/UserInterfaceTools';
 import type { ExecutionType } from '../types/ExecutionTypes';
 import type { ModelRequirements, ModelVariant } from '../types/ModelRequirements';
 import type { Parameters } from '../types/Parameters';
 import type { Prompt } from '../types/Prompt';
-import type { EXPECTATION_UNITS, ExpectationAmount, ExpectationUnit, PromptTemplateJson } from '../types/PromptTemplatePipelineJson/PromptTemplateJson';
-import type { PromptTemplateParameterJson } from '../types/PromptTemplatePipelineJson/PromptTemplateParameterJson';
-import type { PromptTemplatePipelineJson } from '../types/PromptTemplatePipelineJson/PromptTemplatePipelineJson';
-import type { PromptTemplatePipelineString } from '../types/PromptTemplatePipelineString';
+import type { EXPECTATION_UNITS, ExpectationAmount, ExpectationUnit, PromptTemplateJson } from '../types/PromptbookJson/PromptTemplateJson';
+import type { PromptTemplateParameterJson } from '../types/PromptbookJson/PromptTemplateParameterJson';
+import type { PromptbookJson } from '../types/PromptbookJson/PromptbookJson';
+import type { PromptbookString } from '../types/PromptbookString';
 import type { ScriptLanguage } from '../types/ScriptLanguage';
 import type { TaskProgress } from '../types/TaskProgress';
 import type { ExecutionReportJson } from '../types/execution-report/ExecutionReportJson';
 import type { string_char_emoji } from '../types/typeAliasEmoji';
-import type { ILicense, IPersonProfile, IRepository, client_id, number_bytes, number_days, number_gigabytes, number_hours, number_integer, number_kilobytes, number_likeness, number_megabytes, number_miliseconds, number_minutes, number_months, number_negative, number_percent, number_positive, number_seconds, number_terabytes, number_weeks, number_years, string_attribute, string_attribute_value_scope, string_business_category_name, string_char, string_chat_prompt, string_color, string_completion_prompt, string_css, string_css_class, string_css_property, string_css_selector, string_css_value, string_data_url, string_domain, string_email, string_file_absolute_path, string_file_extension, string_file_path, string_file_relative_path, string_filename, string_folder_absolute_path, string_folder_path, string_folder_relative_path, string_host, string_hostname, string_href, string_html, string_javascript, string_javascript_name, string_license, string_license_token, string_markdown, string_markdown_text, string_mime_type, string_mime_type_with_wildcard, string_model_name, string_name, string_page, string_password, string_person_fullname, string_person_profile, string_pgp_key, string_prompt, string_protocol, string_ptbk_url, string_ptbk_url_with_hashtemplate, string_script, string_sha256, string_ssh_key, string_svg, string_tdl, string_template, string_text_prompt, string_title, string_token, string_translate_language, string_translate_name, string_translate_name_not_normalized, string_uri, string_uri_part, string_uriid, string_url, string_url_image, string_version, string_version_dependency, string_xml } from '../types/typeAliases';
+import type { client_id, string_char, string_chat_prompt, string_completion_prompt, string_data_url, string_domain, string_email, string_file_absolute_path, string_file_extension, string_file_path, string_file_relative_path, string_filename, string_folder_absolute_path, string_folder_path, string_folder_relative_path, string_host, string_hostname, string_href, string_html, string_javascript, string_javascript_name, string_license, string_markdown, string_markdown_text, string_mime_type, string_mime_type_with_wildcard, string_model_name, string_name, string_person_fullname, string_prompt, string_promptbook_url, string_promptbook_url_with_hashtemplate, string_script, string_sha256, string_tdl, string_template, string_text_prompt, string_title, string_token, string_translate_language, string_uri, string_uri_part, string_url, string_url_image, string_version } from '../types/typeAliases';
 import { FromtoItems } from '../utils/FromtoItems';
-export { CommonExecutionToolsOptions, EXPECTATION_UNITS, ExecutionReportJson, ExecutionTools, ExecutionType, ExpectationAmount, ExpectationUnit, FromtoItems, ILicense, IPersonProfile, IRepository, ModelRequirements, ModelVariant, NaturalExecutionTools, Parameters, Prompt, PromptChatResult, PromptCommonResult, PromptCompletionResult, PromptResult, PromptTemplateJson, PromptTemplateParameterJson, PromptTemplatePipelineJson, PromptTemplatePipelineString, PtpExecutor, ScriptExecutionTools, ScriptExecutionToolsExecuteOptions, ScriptLanguage, TaskProgress, UserInterfaceTools, UserInterfaceToolsPromptDialogOptions, client_id, number_bytes, number_days, number_gigabytes, number_hours, number_integer, number_kilobytes, number_likeness, number_megabytes, number_miliseconds, number_minutes, number_months, number_negative, number_percent, number_positive, number_seconds, number_terabytes, number_weeks, number_years, string_attribute, string_attribute_value_scope, string_business_category_name, string_char, string_char_emoji, string_chat_prompt, string_color, string_completion_prompt, string_css, string_css_class, string_css_property, string_css_selector, string_css_value, string_data_url, string_domain, string_email, string_file_absolute_path, string_file_extension, string_file_path, string_file_relative_path, string_filename, string_folder_absolute_path, string_folder_path, string_folder_relative_path, string_host, string_hostname, string_href, string_html, string_javascript, string_javascript_name, string_license, string_license_token, string_markdown, string_markdown_text, string_mime_type, string_mime_type_with_wildcard, string_model_name, string_name, string_page, string_password, string_person_fullname, string_person_profile, string_pgp_key, string_prompt, string_protocol, string_ptbk_url, string_ptbk_url_with_hashtemplate, string_script, string_sha256, string_ssh_key, string_svg, string_tdl, string_template, string_text_prompt, string_title, string_token, string_translate_language, string_translate_name, string_translate_name_not_normalized, string_uri, string_uri_part, string_uriid, string_url, string_url_image, string_version, string_version_dependency, string_xml, };
+export { CommonExecutionToolsOptions, EXPECTATION_UNITS, ExecutionReportJson, ExecutionTools, ExecutionType, ExpectationAmount, ExpectationUnit, FromtoItems, ModelRequirements, ModelVariant, NaturalExecutionTools, Parameters, Prompt, PromptChatResult, PromptCommonResult, PromptCompletionResult, PromptResult, PromptTemplateJson, PromptTemplateParameterJson, PromptbookExecutor, PromptbookJson, PromptbookString, ScriptExecutionTools, ScriptExecutionToolsExecuteOptions, ScriptLanguage, TaskProgress, UserInterfaceTools, UserInterfaceToolsPromptDialogOptions, client_id, string_char, string_char_emoji, string_chat_prompt, string_completion_prompt, string_data_url, string_domain, string_email, string_file_absolute_path, string_file_extension, string_file_path, string_file_relative_path, string_filename, string_folder_absolute_path, string_folder_path, string_folder_relative_path, string_host, string_hostname, string_href, string_html, string_javascript, string_javascript_name, string_license, string_markdown, string_markdown_text, string_mime_type, string_mime_type_with_wildcard, string_model_name, string_name, string_person_fullname, string_prompt, string_promptbook_url, string_promptbook_url_with_hashtemplate, string_script, string_sha256, string_tdl, string_template, string_text_prompt, string_title, string_token, string_translate_language, string_uri, string_uri_part, string_url, string_url_image, string_version, };
 /**
- * TODO: !!! Filter out all the types that are not used in the library
+ * TODO: Delete type aliases that are not exported here
  */

package/umd/typings/classes/PromptbookLibrary.d.ts

@@ -0,0 +1,61 @@
+import { string_name } from '.././types/typeAliases';
+import { CreatePromptbookExecutorSettings } from '../execution/createPromptbookExecutor';
+import { ExecutionTools } from '../execution/ExecutionTools';
+import { PromptbookExecutor } from '../execution/PromptbookExecutor';
+import { Prompt } from '../types/Prompt';
+import { PromptbookJson } from '../types/PromptbookJson/PromptbookJson';
+import { PromptbookString } from '../types/PromptbookString';
+/**
+ * Library of promptbooks that groups together promptbooks for an application. This is a very thin wrapper around the Array / Set of promptbooks.
+ *
+ * Promptbook library is a useful helper in execution, it can be shared between execution and consumer parts of the app and make common knowledge about promptbooks.
+ *
+ * It allows to create executor functions from promptbooks in the library.
+ *
+ * @see https://github.com/webgptorg/promptbook#prompt-template-pipeline-library
+ */
+export declare class PromptbookLibrary {
+    private readonly options;
+    /**
+     * Constructs Promptbook from any sources
+     *
+     * Note: During the construction syntax and logic of all sources are validated
+     * Note: You can combine .ptbk.md and .ptbk.json files BUT it is not recommended
+     *
+     * @param promptbookSources contents of .ptbk.md or .ptbk.json files
+     * @param settings settings for creating executor functions
+     * @returns PromptbookLibrary
+     */
+    static fromSources(promptbookSources: Record<string_name, PromptbookJson | PromptbookString>, settings?: Partial<CreatePromptbookExecutorSettings>): PromptbookLibrary;
+    private constructor();
+    /**
+     * Gets all promptbooks in the library
+     */
+    get promptbookNames(): Array<string_name>;
+    /**
+     * Gets promptbook by name
+     */
+    getPromptbookByName(name: string_name): PromptbookJson;
+    /**
+     * Checks whether prompt is in the library
+     */
+    isPromptInLibrary(prompt: Prompt): boolean;
+    /**
+     * Gets executor function for given promptbook
+     */
+    createExecutor(name: string_name, tools: ExecutionTools): PromptbookExecutor;
+}
+/**
+ * TODO: [🈴] Identify promptbooks by url `promptbookUrls` + `getPromptbookByUrl`
+ * TODO: !! [👐][🧠] Split of Promptbook,PromptbookLibrary between interface and class
+ * TODO: !! [👐] Make promptbooks private WHEN split between interface and class
+ * TODO: [🧠] Maybe isPromptInLibrary should be separate utility function
+ * TODO: [🧠] Maybe createExecutor should be separate utility function
+ * TODO: Static method fromDirectory
+ * TODO: [🤜] Add generic type for entry and result parameters
+ * TODO: [🧠] Is it better to promptbookLibrary.executePromptbook('writeXyz',{...}) OR promptbookLibrary.createExecutor('writeXyz')({...}) OR createExecutor(promptbookLibrary.getPromptbook('writeXyz'))
+ * TODO: [🧠] Formarly (before commit 62229afce7668a5b85077cc18becf798b583bf8d) there were two classes PromptbookLibrary+PromptbookLibraryExecutor (maybe it was better?)
+ * TODO: [🧠] Is it better to pass tools into getExecutor or into constructor
+ *             Maybe it is not a good idea to cache executors when they are can be created with different tools
+ * TODO: [👧] Strongly type the executors to avoid need of remove nullables whtn noUncheckedIndexedAccess in tsconfig.json
+ */

package/umd/typings/conversion/_importPromptbook.d.ts

@@ -0,0 +1,12 @@
+import { PromptbookJson } from '../types/PromptbookJson/PromptbookJson';
+import { PromptbookString } from '../types/PromptbookString';
+/**
+ * Import the text 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
+ *
+ * @private
+ */
+export declare function importPromptbook(path: `${string}.ptbk.md`): PromptbookString;
+export declare function importPromptbook(path: `${string}.ptbk.json`): PromptbookJson;

package/umd/typings/conversion/promptbookStringToJson.d.ts

@@ -0,0 +1,13 @@
+import { PromptbookJson } from '../types/PromptbookJson/PromptbookJson';
+import { PromptbookString } from '../types/PromptbookString';
+/**
+ * Parse promptbook from string format to JSON format
+ *
+ * Note: This function does not validate logic of the pipeline only the syntax
+ */
+export declare function promptbookStringToJson(promptbookString: PromptbookString): PromptbookJson;
+/**
+ * TODO: Report here line/column of error
+ * TODO: Use spaceTrim more effectively
+ * TODO: [🧠] Parameter flags - isInput, isOutput, isInternal
+ */

package/umd/typings/conversion/validatePromptbookJson.d.ts

@@ -0,0 +1,26 @@
+import type { PromptbookJson } from '../types/PromptbookJson/PromptbookJson';
+/**
+ * Validates PromptbookJson 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 promptbook valid or invalid PromptbookJson
+ * @throws {Error} if invalid
+ */
+export declare function validatePromptbookJson(promptbook: PromptbookJson): void;
+/**
+ * TODO: [🧠] Work with promptbookVersion
+ * TODO: Use here some json-schema, Zod or something similar and change it to:
+ *     > /**
+ *     >  * Validates PromptbookJson if it is logically valid.
+ *     >  *
+ *     >  * It checks:
+ *     >  * -   it has a valid structure
+ *     >  * -   ...
+ *     >  ex port function validatePromptbookJson(promptbook: unknown): asserts promptbook is PromptbookJson {
+ */

package/{esm/typings/execution/PtpExecutor.d.ts → umd/typings/execution/PromptbookExecutor.d.ts}

@@ -1,18 +1,18 @@
 import type { Promisable } from 'type-fest';
-import type { string_name } from '.././types/typeAliases';
 import type { TaskProgress } from '../types/TaskProgress';
 import type { ExecutionReportJson } from '../types/execution-report/ExecutionReportJson';
+import type { string_name } from '../types/typeAliases';
 /**
  * Executor is a simple async function that takes INPUT  PARAMETERs and returns result parameters _(along with all intermediate parameters and INPUT  PARAMETERs = it extends input object)_.
- * Executor is made by combining execution tools and prompt template pipeline library.
+ * Executor is made by combining execution tools and promptbook library.
  *
  * It can be done in two ways:
- * -   From `PromptTemplatePipelineLibrary.getExecutor` method
- * -   `createPtpExecutor` utility function
+ * -   From `PromptbookLibrary.getExecutor` method
+ * -   `createPromptbookExecutor` utility function
  *
  * @see https://github.com/webgptorg/promptbook#executor
  */
-export interface PtpExecutor {
+export interface PromptbookExecutor {
     (inputParameters: Record<string_name, string>, onProgress: (taskProgress: TaskProgress) => Promisable<void>): Promise<{
         /**
          * Whether the execution was successful

package/umd/typings/execution/assertsExecutionSuccessful.d.ts

@@ -1,11 +1,11 @@
-import type { PtpExecutor } from './PtpExecutor';
+import type { PromptbookExecutor } from './PromptbookExecutor';
 /**
  * Asserts that the execution of a promptnook is successful
  *
  * @param executionResult - The partial result of the promptnook execution
  * @throws Error - If the execution is not successful or if multiple errors occurred
  */
-export declare function assertsExecutionSuccessful(executionResult: Pick<Awaited<ReturnType<PtpExecutor>>, 'isSuccessful' | 'errors'>): void;
+export declare function assertsExecutionSuccessful(executionResult: Pick<Awaited<ReturnType<PromptbookExecutor>>, 'isSuccessful' | 'errors'>): void;
 /**
  * TODO: [🧠] Can this return type be better typed than void
  */

package/umd/typings/execution/createPromptbookExecutor.d.ts

@@ -0,0 +1,40 @@
+import { PromptbookJson } from '../_packages/types.index';
+import { ExecutionTools } from './ExecutionTools';
+import { PromptbookExecutor } from './PromptbookExecutor';
+export interface CreatePromptbookExecutorSettings {
+    /**
+     * When executor does not satisfy expectations it will be retried this amount of times
+     *
+     * @default 3
+     */
+    readonly maxExecutionAttempts: number;
+}
+/**
+ * Options for creating a promptbook executor
+ */
+interface CreatePromptbookExecutorOptions {
+    /**
+     * The promptbook to be executed
+     */
+    readonly promptbook: PromptbookJson;
+    /**
+     * The execution tools to be used during the execution of the PROMPTBOOK
+     */
+    readonly tools: ExecutionTools;
+    /**
+     * Optional settings for the PROMPTBOOK executor
+     */
+    readonly settings?: Partial<CreatePromptbookExecutorSettings>;
+}
+/**
+ * Creates executor function from promptbook and execution tools.
+ *
+ * Note: Consider using getExecutor method of the library instead of using this function
+ */
+export declare function createPromptbookExecutor(options: CreatePromptbookExecutorOptions): PromptbookExecutor;
+export {};
+/**
+ * TODO: [🧠] When not meet expectations in PROMPT_DIALOG, make some way to tell the user
+ * TODO: [👧] Strongly type the executors to avoid need of remove nullables whtn noUncheckedIndexedAccess in tsconfig.json
+ * Note: CreatePromptbookExecutorOptions are just connected to PromptbookExecutor so do not extract to types folder
+ */

package/umd/typings/execution/plugins/natural-execution-tools/mocked/joker.test.d.ts

@@ -1,4 +1,4 @@
 export {};
 /**
- * TODO: [🧠] What should be name of this test "MockedEchoExecutionTools.test.ts" or "createPtpExecutor.test.ts"
+ * TODO: [🧠] What should be name of this test "MockedEchoExecutionTools.test.ts" or "createPromptbookExecutor.test.ts"
  */

package/umd/typings/execution/plugins/natural-execution-tools/mocked/mocked-chat.test.d.ts

@@ -1,4 +1,4 @@
 export {};
 /**
- * TODO: [🧠] What should be name of this test "MockedEchoExecutionTools.test.ts" or "createPtpExecutor.test.ts"
+ * TODO: [🧠] What should be name of this test "MockedEchoExecutionTools.test.ts" or "createPromptbookExecutor.test.ts"
  */

package/umd/typings/execution/plugins/natural-execution-tools/mocked/mocked-completion.test.d.ts

@@ -1,4 +1,4 @@
 export {};
 /**
- * TODO: [🧠] What should be name of this test "MockedEchoExecutionTools.test.ts" or "createPtpExecutor.test.ts"
+ * TODO: [🧠] What should be name of this test "MockedEchoExecutionTools.test.ts" or "createPromptbookExecutor.test.ts"
  */

package/umd/typings/execution/plugins/natural-execution-tools/remote/RemoteNaturalExecutionToolsOptions.d.ts

@@ -5,7 +5,7 @@ import { CommonExecutionToolsOptions } from '../../../CommonExecutionToolsOption
  */
 export interface RemoteNaturalExecutionToolsOptions extends CommonExecutionToolsOptions {
     /**
-     * URL of the remote PTP server
+     * URL of the remote PROMPTBOOK server
      * On this server will be connected to the socket.io server
      */
     readonly remoteUrl: URL;

package/umd/typings/execution/plugins/natural-execution-tools/remote/interfaces/{Ptps_Error.d.ts → Promptbook_Server_Error.d.ts}

@@ -3,7 +3,7 @@
  *
  * This is sent from server to client when error occurs and stops the process
  */
-export interface Ptps_Error {
+export interface Promptbook_Server_Error {
     /**
      * The error message which caused the error
      */

package/umd/typings/execution/plugins/natural-execution-tools/remote/interfaces/{Ptps_Progress.d.ts → Promptbook_Server_Progress.d.ts}

@@ -4,7 +4,7 @@ import { TaskProgress } from '../../../../../types/TaskProgress';
  *
  * This is sent from server to client arbitrarily and may be sent multiple times
  */
-export interface Ptps_Progress {
+export interface Promptbook_Server_Progress {
     /**
      * The progress of text generation
      */

package/umd/typings/execution/plugins/natural-execution-tools/remote/interfaces/{Ptps_Request.d.ts → Promptbook_Server_Request.d.ts}

@@ -1,11 +1,11 @@
-import type { client_id } from '../../../../.././types/typeAliases';
+import type { client_id } from '../../../../../types/typeAliases';
 import type { Prompt } from '../../../../../types/Prompt';
 /**
  * Socket.io progress for remote text generation
  *
  * This is a request from client to server
  */
-export interface Ptps_Request {
+export interface Promptbook_Server_Request {
     /**
      * Client responsible for the requests
      */

package/umd/typings/execution/plugins/natural-execution-tools/remote/interfaces/{Ptps_Response.d.ts → Promptbook_Server_Response.d.ts}

@@ -1,10 +1,10 @@
-import { PromptResult } from '../../../../../execution/PromptResult';
+import { PromptResult } from '../../../../PromptResult';
 /**
  * Socket.io error for remote text generation
  *
  * This is sent from server to client when the generated text is completed
  */
-export interface Ptps_Response {
+export interface Promptbook_Server_Response {
     /**
      * The result of the prompt
      */

package/umd/typings/execution/plugins/natural-execution-tools/remote/interfaces/RemoteServerOptions.d.ts

@@ -1,4 +1,4 @@
-import type { PromptTemplatePipelineLibrary } from '../../../../../classes/PromptTemplatePipelineLibrary';
+import type { PromptbookLibrary } from '../../../../../classes/PromptbookLibrary';
 import type { client_id, string_uri } from '../../../../../types/typeAliases';
 import type { CommonExecutionToolsOptions } from '../../../../CommonExecutionToolsOptions';
 import type { NaturalExecutionTools } from '../../../../NaturalExecutionTools';
@@ -15,11 +15,11 @@ export interface RemoteServerOptions extends CommonExecutionToolsOptions {
      */
     readonly path: string_uri;
     /**
-     * Prompt template pipeline library to use
+     * Promptbook library to use
      *
      * This is used to checkl validity of the prompt to prevent DDoS
      */
-    readonly ptbkLibrary: PromptTemplatePipelineLibrary;
+    readonly library: PromptbookLibrary;
     /**
      * Creates natural execution tools for each client
      */

package/{esm/typings/execution/plugins/natural-execution-tools/remote/runRemoteServer.d.ts → umd/typings/execution/plugins/natural-execution-tools/remote/startRemoteServer.d.ts}

@@ -1,3 +1,4 @@
+import type { IDestroyable } from 'destroyable';
 import { RemoteServerOptions } from './interfaces/RemoteServerOptions';
 /**
  * Remote server is a proxy server that uses its execution tools internally and exposes the executor interface externally.
@@ -7,9 +8,8 @@ import { RemoteServerOptions } from './interfaces/RemoteServerOptions';
  *
  * @see https://github.com/webgptorg/promptbook#remote-server
  */
-export declare function runRemoteServer(options: RemoteServerOptions): void;
+export declare function startRemoteServer(options: RemoteServerOptions): IDestroyable;
 /**
- * TODO: !!! This should be name runRemoteServer OR startRemoteServer and return Destroyable OR Promise<Destroyable>
  * TODO: Handle progress - support streaming
  * TODO: [🤹‍♂️] Do not hang up immediately but wait until client closes OR timeout
  * TODO: [🤹‍♂️] Timeout on chat to free up resources

package/umd/typings/types/Command.d.ts

@@ -1,31 +1,31 @@
 import type { string_markdown_text, string_name, string_version } from '.././types/typeAliases';
 import type { ExecutionType } from './ExecutionTypes';
 import type { ModelRequirements } from './ModelRequirements';
-import type { ExpectationAmount, ExpectationUnit } from './PromptTemplatePipelineJson/PromptTemplateJson';
+import type { ExpectationAmount, ExpectationUnit } from './PromptbookJson/PromptTemplateJson';
 /**
  * Command is one piece of the prompt template which adds some logic to the prompt template or the whole pipeline.
  * It is parsed from the markdown from ul/ol items - one command per one item.
  */
-export type Command = PtbkUrlCommand | PtbkVersionCommand | ExecuteCommand | ModelCommand | JokerCommand | ParameterCommand | PostprocessCommand | ExpectCommand;
+export type Command = PromptbookUrlCommand | PromptbookVersionCommand | ExecuteCommand | ModelCommand | JokerCommand | ParameterCommand | PostprocessCommand | ExpectCommand;
 /**
- * PtpVersion command tells which version is .ptp file using
+ * PromptbookVersion command tells which version is .promptbook file using
  *
  * - It is used for backward compatibility
- * - It is defined per whole .ptp file in the header
+ * - It is defined per whole .promptbook file in the header
  */
-export interface PtbkUrlCommand {
-    readonly type: 'PTBK_URL';
-    readonly ptbkUrl: URL;
+export interface PromptbookUrlCommand {
+    readonly type: 'PROMPTBOOK_URL';
+    readonly promptbookUrl: URL;
 }
 /**
- * PtpVersion command tells which version is .ptp file using
+ * PromptbookVersion command tells which version is .promptbook file using
  *
  * - It is used for backward compatibility
- * - It is defined per whole .ptp file in the header
+ * - It is defined per whole .promptbook file in the header
  */
-export interface PtbkVersionCommand {
-    readonly type: 'PTBK_VERSION';
-    readonly ptbkVersion: string_version;
+export interface PromptbookVersionCommand {
+    readonly type: 'PROMPTBOOK_VERSION';
+    readonly promptbookVersion: string_version;
 }
 /**
  * Execute command tells how to execute the section