@promptbook/remote-client 0.44.0 → 0.45.0

package/README.md

@@ -310,7 +310,7 @@ This library is divided into several packages, all are published from [single mo
 <!--[🔠]-->
 
 -   **[@promptbook/core](https://www.npmjs.com/package/@promptbook/core)** - Core of the library, it contains the main logic for promptbooks
--   **[@promptbook/utils](https://www.npmjs.com/package/@promptbook/utils)** - Utility functions used in the library but also useful for individual use in preprocessing and postprocessing LLM inputs and outputs
+- ⭐ **[@promptbook/utils](https://www.npmjs.com/package/@promptbook/utils)** - Utility functions used in the library but also useful for individual use in preprocessing and postprocessing LLM inputs and outputs
 -   _(Not finished)_ **[@promptbook/wizzard](https://www.npmjs.com/package/@promptbook/wizzard)** - Wizard for creating+running promptbooks in single line
 -   **[@promptbook/execute-javascript](https://www.npmjs.com/package/@promptbook/execute-javascript)** - Execution tools for javascript inside promptbooks
 -   **[@promptbook/openai](https://www.npmjs.com/package/@promptbook/openai)** - Execution tools for OpenAI API, wrapper around OpenAI SDK

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

@@ -1,5 +1,5 @@
-import { PromptbookJson } from '../types/PromptbookJson/PromptbookJson';
-import { PromptbookString } from '../types/PromptbookString';
+import type { PromptbookJson } from '../types/PromptbookJson/PromptbookJson';
+import type { PromptbookString } from '../types/PromptbookString';
 /**
  * Parse promptbook from string format to JSON format
  *

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

@@ -1,6 +1,6 @@
-import { NaturalExecutionTools } from './NaturalExecutionTools';
-import { ScriptExecutionTools } from './ScriptExecutionTools';
-import { UserInterfaceTools } from './UserInterfaceTools';
+import type { NaturalExecutionTools } from './NaturalExecutionTools';
+import type { ScriptExecutionTools } from './ScriptExecutionTools';
+import type { UserInterfaceTools } from './UserInterfaceTools';
 /**
  * All the tools needed to execute prompts (template pipelines).
  *

package/esm/typings/execution/NaturalExecutionTools.d.ts

@@ -1,5 +1,5 @@
-import { Prompt } from '../types/Prompt';
-import { PromptChatResult, PromptCompletionResult } from './PromptResult';
+import type { Prompt } from '../types/Prompt';
+import type { PromptChatResult, PromptCompletionResult } from './PromptResult';
 /**
  * Vontainer for all the tools needed to execute prompts to large language models like GPT-4
  * On its interface it exposes common methods for prompt execution.

package/esm/typings/execution/ScriptExecutionTools.d.ts

@@ -1,5 +1,5 @@
-import { string_name, string_script } from '.././types/typeAliases';
-import { ScriptLanguage } from '../types/ScriptLanguage';
+import type { string_name, string_script } from '.././types/typeAliases';
+import type { ScriptLanguage } from '../types/ScriptLanguage';
 /**
  * Represents all the tools needed to EXECUTE SCRIPTs
  *

package/esm/typings/execution/UserInterfaceTools.d.ts

@@ -1,4 +1,4 @@
-import { number_integer, number_positive } from '../types/typeAliases';
+import type { number_integer, number_positive } from '../types/typeAliases';
 /**
  * Represents all the tools needed to interact with the user.
  *

package/esm/typings/execution/plugins/natural-execution-tools/langtail/LangtailExecutionTools.d.ts

@@ -0,0 +1,10 @@
+import type { NaturalExecutionTools } from '../../../NaturalExecutionTools';
+import { OpenAiExecutionTools } from '../openai/OpenAiExecutionTools';
+/**
+ * Execution Tools for calling OpenAI API.
+ */
+export declare class LangtailExecutionTools extends OpenAiExecutionTools implements NaturalExecutionTools {
+}
+/**
+ * TODO: !!! Make lib which exports this
+ */

package/esm/typings/execution/plugins/natural-execution-tools/openai/OpenAiExecutionTools.d.ts

@@ -11,6 +11,11 @@ export declare class OpenAiExecutionTools implements NaturalExecutionTools {
      * OpenAI API client.
      */
     private readonly openai;
+    /**
+     * Creates OpenAI Execution Tools.
+     *
+     * @param options which are relevant are directly passed to the OpenAI client
+     */
     constructor(options: OpenAiExecutionToolsOptions);
     /**
      * Calls OpenAI API to use a chat model.

package/esm/typings/execution/plugins/natural-execution-tools/openai/OpenAiExecutionToolsOptions.d.ts

@@ -1,13 +1,13 @@
-import { string_token } from '../../../.././types/typeAliases';
-import { CommonExecutionToolsOptions } from '../../../CommonExecutionToolsOptions';
+import type { ClientOptions } from 'openai';
+import type { string_token } from '../../../.././types/typeAliases';
+import type { CommonExecutionToolsOptions } from '../../../CommonExecutionToolsOptions';
 /**
  * Options for OpenAiExecutionTools
+ *
+ * This extends OpenAI's `ClientOptions` with are directly passed to the OpenAI client.
+ * Rest is used by the `OpenAiExecutionTools`.
  */
-export type OpenAiExecutionToolsOptions = CommonExecutionToolsOptions & {
-    /**
-     * OpenAI API key
-     */
-    openAiApiKey: string_token;
+export type OpenAiExecutionToolsOptions = CommonExecutionToolsOptions & ClientOptions & {
     /**
      * A unique identifier representing your end-user, which can help OpenAI to monitor
      * and detect abuse. [Learn more](/docs/guides/safety-best-practices/end-user-ids).

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

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

package/esm/typings/execution/plugins/user-interface-execution-tools/callback/CallbackInterfaceToolsOptions.d.ts

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

package/esm/typings/execution/translation/automatic-translate/automatic-translators/AutomaticTranslator.d.ts

@@ -1,4 +1,4 @@
-import { Promisable } from 'type-fest';
+import type { Promisable } from 'type-fest';
 export type AutomaticTranslator = {
     translate(message: string): Promisable<string>;
 };

package/esm/typings/library/PromptbookLibrary.d.ts

@@ -1,4 +1,4 @@
-import { Promisable } from 'type-fest';
+import type { Promisable } from 'type-fest';
 import type { Prompt } from '../types/Prompt';
 import type { PromptbookJson } from '../types/PromptbookJson/PromptbookJson';
 import type { string_promptbook_url } from '../types/typeAliases';

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

@@ -1,4 +1,4 @@
-import { TupleToUnion } from 'type-fest';
+import type { TupleToUnion } from 'type-fest';
 /**
  * Execution type describes the way how the block is executed
  *

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

@@ -1,4 +1,4 @@
-import { string_model_name } from './typeAliases';
+import type { string_model_name } from './typeAliases';
 export declare const MODEL_VARIANTS: readonly ["COMPLETION", "CHAT"];
 /**
  * Model variant describes the very general type of the model

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

@@ -1,5 +1,5 @@
 import type { string_name, string_prompt, string_promptbook_url_with_hashtemplate, string_title } from '.././types/typeAliases';
-import { PostprocessingFunction } from '../execution/plugins/script-execution-tools/javascript/JavascriptExecutionToolsOptions';
+import type { PostprocessingFunction } from '../execution/plugins/script-execution-tools/javascript/JavascriptExecutionToolsOptions';
 import type { ModelRequirements } from './ModelRequirements';
 import type { Expectations } from './PromptbookJson/PromptTemplateJson';
 /**

package/esm/typings/types/PromptbookJson/PromptTemplateJson.d.ts

@@ -1,8 +1,8 @@
-import { ExpectFormatCommand } from '../Command';
-import { ExecutionType } from '../ExecutionTypes';
-import { ModelRequirements } from '../ModelRequirements';
-import { ScriptLanguage } from '../ScriptLanguage';
-import { number_integer, number_positive_or_zero, string_javascript, string_javascript_name, string_markdown, string_name, string_prompt, string_template } from '../typeAliases';
+import type { ExpectFormatCommand } from '../Command';
+import type { ExecutionType } from '../ExecutionTypes';
+import type { ModelRequirements } from '../ModelRequirements';
+import type { ScriptLanguage } from '../ScriptLanguage';
+import type { number_integer, number_positive_or_zero, string_javascript, string_javascript_name, string_markdown, string_name, string_prompt, string_template } from '../typeAliases';
 /**
  * Describes one prompt template in the promptbook
  */

package/esm/typings/types/PromptbookJson/PromptTemplateParameterJson.d.ts

@@ -1,4 +1,4 @@
-import { string_name } from '../typeAliases';
+import type { string_name } from '../typeAliases';
 /**
  * Describes one parameter of the promptbook
  */

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

@@ -1,6 +1,6 @@
-import { string_promptbook_url, string_version } from '../typeAliases';
-import { PromptTemplateJson } from './PromptTemplateJson';
-import { PromptTemplateParameterJson } from './PromptTemplateParameterJson';
+import type { string_promptbook_url, string_version } from '../typeAliases';
+import type { PromptTemplateJson } from './PromptTemplateJson';
+import type { PromptTemplateParameterJson } from './PromptTemplateParameterJson';
 /**
  * Promptbook is the **core concept of this library**.
  * It represents a series of prompt templates chained together to form a pipeline / one big prompt template with input and result parameters.

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

@@ -1,4 +1,4 @@
-import { TupleToUnion } from 'type-fest';
+import type { TupleToUnion } from 'type-fest';
 /**
  * Supported script languages
  */

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

@@ -1,5 +1,5 @@
-import { ExecutionType } from './ExecutionTypes';
-import { string_markdown_text, string_name } from './typeAliases';
+import type { ExecutionType } from './ExecutionTypes';
+import type { string_markdown_text, string_name } from './typeAliases';
 /**
  * TaskProgress represents the progress of a Promptbook execution.
  */

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

@@ -1,4 +1,4 @@
-import { number_percent } from '../typeAliases';
+import type { number_percent } from '../typeAliases';
 /**
  * Options for generating an execution report string
  */

package/esm/typings/utils/markdown/extractAllBlocksFromMarkdown.d.ts

@@ -1,4 +1,4 @@
-import { string_markdown } from '../../types/typeAliases';
+import type { string_markdown } from '../../types/typeAliases';
 /**
  * Single code block inside markdown.
  */

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@promptbook/remote-client",
-    "version": "0.44.0",
+    "version": "0.45.0",
     "description": "Library to supercharge your use of large language models",
     "private": false,
     "sideEffects": false,
@@ -37,7 +37,7 @@
         "socket.io-client": "4.7.2"
     },
     "peerDependencies": {
-        "@promptbook/core": "0.44.0"
+        "@promptbook/core": "0.45.0"
     },
     "main": "./umd/index.umd.js",
     "module": "./esm/index.es.js",

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

@@ -1,5 +1,5 @@
-import { PromptbookJson } from '../types/PromptbookJson/PromptbookJson';
-import { PromptbookString } from '../types/PromptbookString';
+import type { PromptbookJson } from '../types/PromptbookJson/PromptbookJson';
+import type { PromptbookString } from '../types/PromptbookString';
 /**
  * Parse promptbook from string format to JSON format
  *

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

@@ -1,6 +1,6 @@
-import { NaturalExecutionTools } from './NaturalExecutionTools';
-import { ScriptExecutionTools } from './ScriptExecutionTools';
-import { UserInterfaceTools } from './UserInterfaceTools';
+import type { NaturalExecutionTools } from './NaturalExecutionTools';
+import type { ScriptExecutionTools } from './ScriptExecutionTools';
+import type { UserInterfaceTools } from './UserInterfaceTools';
 /**
  * All the tools needed to execute prompts (template pipelines).
  *

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

@@ -1,5 +1,5 @@
-import { Prompt } from '../types/Prompt';
-import { PromptChatResult, PromptCompletionResult } from './PromptResult';
+import type { Prompt } from '../types/Prompt';
+import type { PromptChatResult, PromptCompletionResult } from './PromptResult';
 /**
  * Vontainer for all the tools needed to execute prompts to large language models like GPT-4
  * On its interface it exposes common methods for prompt execution.

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

@@ -1,5 +1,5 @@
-import { string_name, string_script } from '.././types/typeAliases';
-import { ScriptLanguage } from '../types/ScriptLanguage';
+import type { string_name, string_script } from '.././types/typeAliases';
+import type { ScriptLanguage } from '../types/ScriptLanguage';
 /**
  * Represents all the tools needed to EXECUTE SCRIPTs
  *

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

@@ -1,4 +1,4 @@
-import { number_integer, number_positive } from '../types/typeAliases';
+import type { number_integer, number_positive } from '../types/typeAliases';
 /**
  * Represents all the tools needed to interact with the user.
  *

package/umd/typings/execution/plugins/natural-execution-tools/langtail/LangtailExecutionTools.d.ts

@@ -0,0 +1,10 @@
+import type { NaturalExecutionTools } from '../../../NaturalExecutionTools';
+import { OpenAiExecutionTools } from '../openai/OpenAiExecutionTools';
+/**
+ * Execution Tools for calling OpenAI API.
+ */
+export declare class LangtailExecutionTools extends OpenAiExecutionTools implements NaturalExecutionTools {
+}
+/**
+ * TODO: !!! Make lib which exports this
+ */

package/umd/typings/execution/plugins/natural-execution-tools/openai/OpenAiExecutionTools.d.ts

@@ -11,6 +11,11 @@ export declare class OpenAiExecutionTools implements NaturalExecutionTools {
      * OpenAI API client.
      */
     private readonly openai;
+    /**
+     * Creates OpenAI Execution Tools.
+     *
+     * @param options which are relevant are directly passed to the OpenAI client
+     */
     constructor(options: OpenAiExecutionToolsOptions);
     /**
      * Calls OpenAI API to use a chat model.

package/umd/typings/execution/plugins/natural-execution-tools/openai/OpenAiExecutionToolsOptions.d.ts

@@ -1,13 +1,13 @@
-import { string_token } from '../../../.././types/typeAliases';
-import { CommonExecutionToolsOptions } from '../../../CommonExecutionToolsOptions';
+import type { ClientOptions } from 'openai';
+import type { string_token } from '../../../.././types/typeAliases';
+import type { CommonExecutionToolsOptions } from '../../../CommonExecutionToolsOptions';
 /**
  * Options for OpenAiExecutionTools
+ *
+ * This extends OpenAI's `ClientOptions` with are directly passed to the OpenAI client.
+ * Rest is used by the `OpenAiExecutionTools`.
  */
-export type OpenAiExecutionToolsOptions = CommonExecutionToolsOptions & {
-    /**
-     * OpenAI API key
-     */
-    openAiApiKey: string_token;
+export type OpenAiExecutionToolsOptions = CommonExecutionToolsOptions & ClientOptions & {
     /**
      * A unique identifier representing your end-user, which can help OpenAI to monitor
      * and detect abuse. [Learn more](/docs/guides/safety-best-practices/end-user-ids).

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

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

package/umd/typings/execution/plugins/user-interface-execution-tools/callback/CallbackInterfaceToolsOptions.d.ts

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

package/umd/typings/execution/translation/automatic-translate/automatic-translators/AutomaticTranslator.d.ts

@@ -1,4 +1,4 @@
-import { Promisable } from 'type-fest';
+import type { Promisable } from 'type-fest';
 export type AutomaticTranslator = {
     translate(message: string): Promisable<string>;
 };

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

@@ -1,4 +1,4 @@
-import { Promisable } from 'type-fest';
+import type { Promisable } from 'type-fest';
 import type { Prompt } from '../types/Prompt';
 import type { PromptbookJson } from '../types/PromptbookJson/PromptbookJson';
 import type { string_promptbook_url } from '../types/typeAliases';

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

@@ -1,4 +1,4 @@
-import { TupleToUnion } from 'type-fest';
+import type { TupleToUnion } from 'type-fest';
 /**
  * Execution type describes the way how the block is executed
  *

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

@@ -1,4 +1,4 @@
-import { string_model_name } from './typeAliases';
+import type { string_model_name } from './typeAliases';
 export declare const MODEL_VARIANTS: readonly ["COMPLETION", "CHAT"];
 /**
  * Model variant describes the very general type of the model

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

@@ -1,5 +1,5 @@
 import type { string_name, string_prompt, string_promptbook_url_with_hashtemplate, string_title } from '.././types/typeAliases';
-import { PostprocessingFunction } from '../execution/plugins/script-execution-tools/javascript/JavascriptExecutionToolsOptions';
+import type { PostprocessingFunction } from '../execution/plugins/script-execution-tools/javascript/JavascriptExecutionToolsOptions';
 import type { ModelRequirements } from './ModelRequirements';
 import type { Expectations } from './PromptbookJson/PromptTemplateJson';
 /**

package/umd/typings/types/PromptbookJson/PromptTemplateJson.d.ts

@@ -1,8 +1,8 @@
-import { ExpectFormatCommand } from '../Command';
-import { ExecutionType } from '../ExecutionTypes';
-import { ModelRequirements } from '../ModelRequirements';
-import { ScriptLanguage } from '../ScriptLanguage';
-import { number_integer, number_positive_or_zero, string_javascript, string_javascript_name, string_markdown, string_name, string_prompt, string_template } from '../typeAliases';
+import type { ExpectFormatCommand } from '../Command';
+import type { ExecutionType } from '../ExecutionTypes';
+import type { ModelRequirements } from '../ModelRequirements';
+import type { ScriptLanguage } from '../ScriptLanguage';
+import type { number_integer, number_positive_or_zero, string_javascript, string_javascript_name, string_markdown, string_name, string_prompt, string_template } from '../typeAliases';
 /**
  * Describes one prompt template in the promptbook
  */

package/umd/typings/types/PromptbookJson/PromptTemplateParameterJson.d.ts

@@ -1,4 +1,4 @@
-import { string_name } from '../typeAliases';
+import type { string_name } from '../typeAliases';
 /**
  * Describes one parameter of the promptbook
  */

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

@@ -1,6 +1,6 @@
-import { string_promptbook_url, string_version } from '../typeAliases';
-import { PromptTemplateJson } from './PromptTemplateJson';
-import { PromptTemplateParameterJson } from './PromptTemplateParameterJson';
+import type { string_promptbook_url, string_version } from '../typeAliases';
+import type { PromptTemplateJson } from './PromptTemplateJson';
+import type { PromptTemplateParameterJson } from './PromptTemplateParameterJson';
 /**
  * Promptbook is the **core concept of this library**.
  * It represents a series of prompt templates chained together to form a pipeline / one big prompt template with input and result parameters.

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

@@ -1,4 +1,4 @@
-import { TupleToUnion } from 'type-fest';
+import type { TupleToUnion } from 'type-fest';
 /**
  * Supported script languages
  */

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

@@ -1,5 +1,5 @@
-import { ExecutionType } from './ExecutionTypes';
-import { string_markdown_text, string_name } from './typeAliases';
+import type { ExecutionType } from './ExecutionTypes';
+import type { string_markdown_text, string_name } from './typeAliases';
 /**
  * TaskProgress represents the progress of a Promptbook execution.
  */

package/umd/typings/types/execution-report/ExecutionReportStringOptions.d.ts

@@ -1,4 +1,4 @@
-import { number_percent } from '../typeAliases';
+import type { number_percent } from '../typeAliases';
 /**
  * Options for generating an execution report string
  */

package/umd/typings/utils/markdown/extractAllBlocksFromMarkdown.d.ts

@@ -1,4 +1,4 @@
-import { string_markdown } from '../../types/typeAliases';
+import type { string_markdown } from '../../types/typeAliases';
 /**
  * Single code block inside markdown.
  */