@promptbook/types 0.44.0 → 0.46.0-0

package/README.md

@@ -32,6 +32,8 @@ import { promptbookStringToJson } from '@promptbook/core';
 const promptbook: PromptbookJson = promptbookStringToJson(...);
 ```
 
+_Note: `@promptbook/types` does not export brand-specific types like `OpenAiExecutionToolsOptions`, `ClaudeExecutionToolsOptions`, `LangchainExecutionToolsOptions`,... etc._
+
 
 ---
 
@@ -313,15 +315,26 @@ _Note: We are using [postprocessing functions](#postprocessing-functions) like `
 
 ## 📦 Packages
 
-This library is divided into several packages, all are published from [single monorepo](https://github.com/webgptorg/promptbook):
+This library is divided into several packages, all are published from [single monorepo](https://github.com/webgptorg/promptbook).
+You can install all of them at once:
+
+```bash
+npm i ptbk
+```
+
+Or you can install them separately:
 
 <!--[🔠]-->
 
+<!--   Add all new -->
+
 -   **[@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
+-   **[@promptbook/langtail](https://www.npmjs.com/package/@promptbook/langtail)** - Execution tools for Langtail API, wrapper around Langtail SDK
+-   **[@promptbook/mock](https://www.npmjs.com/package/@promptbook/mock)** - Mocked execution tools for testing the library and saving the tokens
 -   **[@promptbook/remote-client](https://www.npmjs.com/package/@promptbook/remote-client)** - Remote client for remote execution of promptbooks
 -   **[@promptbook/remote-server](https://www.npmjs.com/package/@promptbook/remote-server)** - Remote server for remote execution of promptbooks
 -   **[@promptbook/types](https://www.npmjs.com/package/@promptbook/types)** - Just typescript types used in the library

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

@@ -1,8 +1,6 @@
 import { promptbookStringToJson } from '../conversion/promptbookStringToJson';
 import { validatePromptbookJson } from '../conversion/validation/validatePromptbookJson';
 import { createPromptbookExecutor } from '../execution/createPromptbookExecutor';
-import { MockedEchoNaturalExecutionTools } from '../execution/plugins/natural-execution-tools/mocked/MockedEchoNaturalExecutionTools';
-import { MockedFackedNaturalExecutionTools } from '../execution/plugins/natural-execution-tools/mocked/MockedFackedNaturalExecutionTools';
 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';
@@ -16,6 +14,5 @@ export { ExecutionTypes, PROMPTBOOK_VERSION };
 export { createPromptbookLibraryFromPromise, createPromptbookLibraryFromSources, createPromptbookSublibrary, SimplePromptbookLibrary, };
 export { SimplePromptInterfaceTools };
 export { promptbookStringToJson, validatePromptbookJson };
-export { MockedEchoNaturalExecutionTools, MockedFackedNaturalExecutionTools };
 export { createPromptbookExecutor };
 export { CallbackInterfaceTools, CallbackInterfaceToolsOptions };

package/esm/typings/_packages/langtail.index.d.ts

@@ -0,0 +1,3 @@
+import { LangtailExecutionTools } from '../execution/plugins/natural-execution-tools/langtail/LangtailExecutionTools';
+import { LangtailExecutionToolsOptions } from '../execution/plugins/natural-execution-tools/langtail/LangtailExecutionToolsOptions';
+export { LangtailExecutionTools, LangtailExecutionToolsOptions };

package/esm/typings/_packages/mock.index.d.ts

@@ -0,0 +1,6 @@
+import { MockedEchoNaturalExecutionTools } from '../execution/plugins/natural-execution-tools/mocked/MockedEchoNaturalExecutionTools';
+import { MockedFackedNaturalExecutionTools } from '../execution/plugins/natural-execution-tools/mocked/MockedFackedNaturalExecutionTools';
+export { MockedEchoNaturalExecutionTools, MockedFackedNaturalExecutionTools };
+/**
+ * TODO: [🚏] FakeLLM
+ */

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/langtail/LangtailExecutionToolsOptions.d.ts

@@ -0,0 +1,11 @@
+import type { OpenAiExecutionToolsOptions } from '../openai/OpenAiExecutionToolsOptions';
+/**
+ * Options for LangtailExecutionTools
+ *
+ * This extends OpenAI's `ClientOptions` with are directly passed to the OpenAI client.
+ * Rest is used by the `OpenAiExecutionTools`.
+ */
+export type LangtailExecutionToolsOptions = OpenAiExecutionToolsOptions;
+/**
+ * TODO: !!! Use or remove
+ */

package/esm/typings/execution/plugins/natural-execution-tools/mocked/fakeTextToExpectations.d.ts

@@ -10,6 +10,6 @@ import { PostprocessingFunction } from '../../script-execution-tools/javascript/
  */
 export declare function $fakeTextToExpectations(expectations: Expectations, postprocessing?: Array<PostprocessingFunction>): Promise<string>;
 /**
- * TODO: Implement better - create FakeLLM from this
+ * TODO: [🚏] Implement better - create FakeLLM from this
  * TODO: [💝] Unite object for expecting amount and format - use here also a format
  */

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/types",
-    "version": "0.44.0",
+    "version": "0.46.0-0",
     "description": "Library to supercharge your use of large language models",
     "private": false,
     "sideEffects": false,
@@ -35,7 +35,7 @@
     "homepage": "https://www.npmjs.com/package/@promptbook/core",
     "dependencies": {},
     "peerDependencies": {
-        "@promptbook/core": "0.44.0"
+        "@promptbook/core": "0.46.0-0"
     },
     "main": "./umd/index.umd.js",
     "module": "./esm/index.es.js",

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

@@ -1,8 +1,6 @@
 import { promptbookStringToJson } from '../conversion/promptbookStringToJson';
 import { validatePromptbookJson } from '../conversion/validation/validatePromptbookJson';
 import { createPromptbookExecutor } from '../execution/createPromptbookExecutor';
-import { MockedEchoNaturalExecutionTools } from '../execution/plugins/natural-execution-tools/mocked/MockedEchoNaturalExecutionTools';
-import { MockedFackedNaturalExecutionTools } from '../execution/plugins/natural-execution-tools/mocked/MockedFackedNaturalExecutionTools';
 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';
@@ -16,6 +14,5 @@ export { ExecutionTypes, PROMPTBOOK_VERSION };
 export { createPromptbookLibraryFromPromise, createPromptbookLibraryFromSources, createPromptbookSublibrary, SimplePromptbookLibrary, };
 export { SimplePromptInterfaceTools };
 export { promptbookStringToJson, validatePromptbookJson };
-export { MockedEchoNaturalExecutionTools, MockedFackedNaturalExecutionTools };
 export { createPromptbookExecutor };
 export { CallbackInterfaceTools, CallbackInterfaceToolsOptions };

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

@@ -0,0 +1,3 @@
+import { LangtailExecutionTools } from '../execution/plugins/natural-execution-tools/langtail/LangtailExecutionTools';
+import { LangtailExecutionToolsOptions } from '../execution/plugins/natural-execution-tools/langtail/LangtailExecutionToolsOptions';
+export { LangtailExecutionTools, LangtailExecutionToolsOptions };

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

@@ -0,0 +1,6 @@
+import { MockedEchoNaturalExecutionTools } from '../execution/plugins/natural-execution-tools/mocked/MockedEchoNaturalExecutionTools';
+import { MockedFackedNaturalExecutionTools } from '../execution/plugins/natural-execution-tools/mocked/MockedFackedNaturalExecutionTools';
+export { MockedEchoNaturalExecutionTools, MockedFackedNaturalExecutionTools };
+/**
+ * TODO: [🚏] FakeLLM
+ */

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/langtail/LangtailExecutionToolsOptions.d.ts

@@ -0,0 +1,11 @@
+import type { OpenAiExecutionToolsOptions } from '../openai/OpenAiExecutionToolsOptions';
+/**
+ * Options for LangtailExecutionTools
+ *
+ * This extends OpenAI's `ClientOptions` with are directly passed to the OpenAI client.
+ * Rest is used by the `OpenAiExecutionTools`.
+ */
+export type LangtailExecutionToolsOptions = OpenAiExecutionToolsOptions;
+/**
+ * TODO: !!! Use or remove
+ */

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

@@ -10,6 +10,6 @@ import { PostprocessingFunction } from '../../script-execution-tools/javascript/
  */
 export declare function $fakeTextToExpectations(expectations: Expectations, postprocessing?: Array<PostprocessingFunction>): Promise<string>;
 /**
- * TODO: Implement better - create FakeLLM from this
+ * TODO: [🚏] Implement better - create FakeLLM from this
  * TODO: [💝] Unite object for expecting amount and format - use here also a format
  */

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.
  */