@promptbook/remote-server 0.71.0-0 → 0.72.0-0

package/esm/typings/src/execution/PipelineExecutorResult.d.ts

@@ -1,8 +1,7 @@
-import { ReadonlyDeep } from 'type-fest';
-import type { ErrorJson } from '../errors/utils/ErrorJson';
 import type { ExecutionReportJson } from '../types/execution-report/ExecutionReportJson';
-import type { PipelineJson } from '../types/PipelineJson/PipelineJson';
 import type { Parameters } from '../types/typeAliases';
+import type { PipelineJson } from '../types/PipelineJson/PipelineJson';
+import type { ErrorJson } from '../errors/utils/ErrorJson';
 import type { PromptResultUsage } from './PromptResultUsage';
 /**
  * @@@
@@ -15,7 +14,7 @@ export type PipelineExecutorResult = {
      *
      * Note: If the execution was not successful, there are only some of the result parameters
      */
-    readonly outputParameters: Readonly<Parameters>;
+    readonly outputParameters: Parameters;
     /**
      * Whether the execution was successful, details are aviable in `executionReport`
      */
@@ -23,26 +22,26 @@ export type PipelineExecutorResult = {
     /**
      * Added usage of whole execution, detailed usage is aviable in `executionReport`
      */
-    readonly usage: ReadonlyDeep<PromptResultUsage>;
+    readonly usage: PromptResultUsage;
     /**
      * Errors that occured during the execution, details are aviable in `executionReport`
      */
-    readonly errors: ReadonlyDeep<Array<ErrorJson>>;
+    readonly errors: Array<ErrorJson>;
     /**
      * Warnings that occured during the execution, details are aviable in `executionReport`
      */
-    readonly warnings: ReadonlyDeep<Array<ErrorJson>>;
+    readonly warnings: Array<ErrorJson>;
     /**
      * The report of the execution with all details
      */
-    readonly executionReport: ReadonlyDeep<ExecutionReportJson>;
+    readonly executionReport: ExecutionReportJson;
     /**
      * The prepared pipeline that was used for the execution
      *
      * Note: If you called `createPipelineExecutor` with fully prepared pipeline, this is the same object as this pipeline
      *       If you passed not fully prepared pipeline, this is same pipeline but fully prepared
      */
-    readonly preparedPipeline: ReadonlyDeep<PipelineJson>;
+    readonly preparedPipeline: PipelineJson;
 };
 /**
  * TODO: [🧠] Should this file be in /execution or /types folder?

package/esm/typings/src/execution/createPipelineExecutor.d.ts

@@ -0,0 +1,72 @@
+import type { PipelineJson } from '../types/PipelineJson/PipelineJson';
+import type { ExecutionTools } from './ExecutionTools';
+import type { PipelineExecutor } from './PipelineExecutor';
+type CreatePipelineExecutorSettings = {
+    /**
+     * When executor does not satisfy expectations it will be retried this amount of times
+     *
+     * @default MAX_EXECUTION_ATTEMPTS
+     */
+    readonly maxExecutionAttempts?: number;
+    /**
+     * Maximum number of tasks running in parallel
+     *
+     * @default MAX_PARALLEL_COUNT
+     */
+    readonly maxParallelCount?: number;
+    /**
+     * If true, the preparation logs additional information
+     *
+     * @default false
+     */
+    readonly isVerbose?: boolean;
+    /**
+     * If you pass fully prepared pipeline, this does not matter
+     *
+     * Otherwise:
+     * If false or not set, warning is shown when pipeline is not prepared
+     * If true, warning is suppressed
+     *
+     * @default false
+     */
+    readonly isNotPreparedWarningSupressed?: boolean;
+};
+/**
+ * Options for `createPipelineExecutor`
+ */
+interface CreatePipelineExecutorOptions {
+    /**
+     * The pipeline to be executed
+     */
+    readonly pipeline: PipelineJson;
+    /**
+     * The execution tools to be used during the execution of the pipeline
+     */
+    readonly tools: ExecutionTools;
+    /**
+     * Optional settings for the pipeline executor
+     */
+    readonly settings?: Partial<CreatePipelineExecutorSettings>;
+}
+/**
+ * Creates executor function from pipeline and execution tools.
+ *
+ * @returns The executor function
+ * @throws {PipelineLogicError} on logical error in the pipeline
+ * @public exported from `@promptbook/core`
+ */
+export declare function createPipelineExecutor(options: CreatePipelineExecutorOptions): PipelineExecutor;
+export {};
+/**
+ * TODO:[main] !!! Identify not only pipeline BUT exact template ${block(pipelineIdentification)}
+ * TODO: Use isVerbose here (not only pass to `preparePipeline`)
+ * TODO: [🧠][🌳] Use here `countTotalUsage` and put preparation and prepared pipiline to report
+ * TODO: [🪂] Use maxParallelCount here (not only pass to `preparePipeline`)
+ * TODO: [♈] Probbably move expectations from templates to parameters
+ * TODO: [🧠] When not meet expectations in DIALOG_TEMPLATE, make some way to tell the user
+ * TODO: [👧] Strongly type the executors to avoid need of remove nullables whtn noUncheckedIndexedAccess in tsconfig.json
+ * Note: CreatePipelineExecutorOptions are just connected to PipelineExecutor so do not extract to types folder
+ * TODO: [🧠][3] transparent = (report intermediate parameters) / opaque execution = (report only output parameters) progress reporting mode
+ * TODO: [🛠] Actions, instruments (and maybe knowledge) => Functions and tools
+ * TODO: [🧠][💷] `assertsExecutionSuccessful` should be the method of `PipelineExecutor` result BUT maybe NOT to preserve pure JSON object
+ */

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

@@ -7,7 +7,7 @@ interface LindatAutomaticTranslatorOptions extends TranslatorOptions {
  * @private still in development [🏳]
  */
 export declare class LindatAutomaticTranslator implements AutomaticTranslator {
-    private readonly options;
+    protected readonly options: LindatAutomaticTranslatorOptions;
     constructor(options: LindatAutomaticTranslatorOptions);
     translate(message: string): Promise<string>;
 }

package/esm/typings/src/execution/utils/addUsage.d.ts

@@ -1,60 +1,4 @@
 import type { PromptResultUsage } from '../PromptResultUsage';
-/**
- * @@@
- *
- * @public exported from `@promptbook/core`
- */
-export declare const ZERO_USAGE: import("type-fest/source/readonly-deep").ReadonlyObjectDeep<{
-    readonly price: {
-        readonly value: 0;
-    };
-    readonly input: {
-        readonly tokensCount: {
-            readonly value: 0;
-        };
-        readonly charactersCount: {
-            readonly value: 0;
-        };
-        readonly wordsCount: {
-            readonly value: 0;
-        };
-        readonly sentencesCount: {
-            readonly value: 0;
-        };
-        readonly linesCount: {
-            readonly value: 0;
-        };
-        readonly paragraphsCount: {
-            readonly value: 0;
-        };
-        readonly pagesCount: {
-            readonly value: 0;
-        };
-    };
-    readonly output: {
-        readonly tokensCount: {
-            readonly value: 0;
-        };
-        readonly charactersCount: {
-            readonly value: 0;
-        };
-        readonly wordsCount: {
-            readonly value: 0;
-        };
-        readonly sentencesCount: {
-            readonly value: 0;
-        };
-        readonly linesCount: {
-            readonly value: 0;
-        };
-        readonly paragraphsCount: {
-            readonly value: 0;
-        };
-        readonly pagesCount: {
-            readonly value: 0;
-        };
-    };
-}>;
 /**
  * Function `addUsage` will add multiple usages into one
  *

package/esm/typings/src/execution/utils/checkExpectations.d.ts

@@ -24,6 +24,4 @@ export declare function checkExpectations(expectations: Expectations, value: str
 export declare function isPassingExpectations(expectations: Expectations, value: string): boolean;
 /**
  * TODO: [💝] Unite object for expecting amount and format
- * TODO: [🧠][🤠] This should be part of `TextFormatDefinition`
- * Note: [💝] and [🤠] are interconnected together
  */

package/esm/typings/src/execution/utils/usage-constants.d.ts

@@ -0,0 +1,127 @@
+/**
+ * Represents the usage with no resources consumed
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare const ZERO_USAGE: import("type-fest/source/readonly-deep").ReadonlyObjectDeep<{
+    readonly price: {
+        readonly value: 0;
+    };
+    readonly input: {
+        readonly tokensCount: {
+            readonly value: 0;
+        };
+        readonly charactersCount: {
+            readonly value: 0;
+        };
+        readonly wordsCount: {
+            readonly value: 0;
+        };
+        readonly sentencesCount: {
+            readonly value: 0;
+        };
+        readonly linesCount: {
+            readonly value: 0;
+        };
+        readonly paragraphsCount: {
+            readonly value: 0;
+        };
+        readonly pagesCount: {
+            readonly value: 0;
+        };
+    };
+    readonly output: {
+        readonly tokensCount: {
+            readonly value: 0;
+        };
+        readonly charactersCount: {
+            readonly value: 0;
+        };
+        readonly wordsCount: {
+            readonly value: 0;
+        };
+        readonly sentencesCount: {
+            readonly value: 0;
+        };
+        readonly linesCount: {
+            readonly value: 0;
+        };
+        readonly paragraphsCount: {
+            readonly value: 0;
+        };
+        readonly pagesCount: {
+            readonly value: 0;
+        };
+    };
+}>;
+/**
+ * Represents the usage with unknown resources consumed
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare const UNCERTAIN_USAGE: import("type-fest/source/readonly-deep").ReadonlyObjectDeep<{
+    readonly price: {
+        readonly value: 0;
+        readonly isUncertain: true;
+    };
+    readonly input: {
+        readonly tokensCount: {
+            readonly value: 0;
+            readonly isUncertain: true;
+        };
+        readonly charactersCount: {
+            readonly value: 0;
+            readonly isUncertain: true;
+        };
+        readonly wordsCount: {
+            readonly value: 0;
+            readonly isUncertain: true;
+        };
+        readonly sentencesCount: {
+            readonly value: 0;
+            readonly isUncertain: true;
+        };
+        readonly linesCount: {
+            readonly value: 0;
+            readonly isUncertain: true;
+        };
+        readonly paragraphsCount: {
+            readonly value: 0;
+            readonly isUncertain: true;
+        };
+        readonly pagesCount: {
+            readonly value: 0;
+            readonly isUncertain: true;
+        };
+    };
+    readonly output: {
+        readonly tokensCount: {
+            readonly value: 0;
+            readonly isUncertain: true;
+        };
+        readonly charactersCount: {
+            readonly value: 0;
+            readonly isUncertain: true;
+        };
+        readonly wordsCount: {
+            readonly value: 0;
+            readonly isUncertain: true;
+        };
+        readonly sentencesCount: {
+            readonly value: 0;
+            readonly isUncertain: true;
+        };
+        readonly linesCount: {
+            readonly value: 0;
+            readonly isUncertain: true;
+        };
+        readonly paragraphsCount: {
+            readonly value: 0;
+            readonly isUncertain: true;
+        };
+        readonly pagesCount: {
+            readonly value: 0;
+            readonly isUncertain: true;
+        };
+    };
+}>;

package/esm/typings/src/execution/utils/usageToHuman.d.ts

@@ -7,10 +7,11 @@ import type { PromptResultUsage } from '../PromptResultUsage';
  */
 export declare function usageToHuman(usage: PromptResultUsage): string_markdown;
 /**
- * TODO: [🍓][🧞‍♂️] Use "$1" not "1 USD"
- * TODO: [🍓][🧞‍♂️] Use markdown formatting like "Cost approximately **$1**"
- * TODO: [🍓][🧞‍♂️] Report in minutes, seconds, days NOT 0.1 hours
+ * TODO: Use "$1" not "1 USD"
+ * TODO: Use markdown formatting like "Cost approximately **$1**"
+ * TODO: Report in minutes, seconds, days NOT 0.1 hours
  * TODO: [🧠] Maybe make from `uncertainNumberToHuman` separate exported utility
+ * TODO: When negligible usage, report "Negligible" or just don't report it
  * TODO: [🧠] Maybe use "~" instead of "approximately"
  * TODO: [🏛] Maybe make some markdown builder
  */

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

@@ -1,27 +1,22 @@
 import type { string_mime_type } from '../../types/typeAliases';
 import type { string_name } from '../../types/typeAliases';
-import type { string_SCREAMING_CASE } from '../../utils/normalization/normalizeTo_SCREAMING_CASE';
-import type { empty_object } from '../../utils/organization/empty_object';
-import type { FormatSubvalueDefinition } from './FormatSubvalueDefinition';
 /**
  * A format definition is a set of functions that define how to validate, heal and convert response from LLM
  *
- * @@@ Describe setting vs schema
- *
  * @see https://github.com/webgptorg/promptbook/discussions/36
  * @private still in development [🏢]
  */
-export type FormatDefinition<TValue extends TPartialValue, TPartialValue extends string, TSettings extends empty_object, TSchema extends empty_object> = {
+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 formatName: string_name & string_SCREAMING_CASE;
+    readonly name: string_name;
     /**
-     * Aliases for the `formatName`
+     * Aliases for the name
      */
-    readonly aliases?: Array<string_name & string_SCREAMING_CASE>;
+    readonly aliases?: Array<string_name>;
     /**
      * The mime type of the format (if any)
      *
@@ -34,7 +29,7 @@ export type FormatDefinition<TValue extends TPartialValue, TPartialValue extends
      * @param value The value to check, for example "{\"foo\": true}"
      * @param schema Optional schema to do extra validation
      */
-    isValid(value: string, settings?: TSettings, schema?: TSchema): value is TValue;
+    isValid(value: string, schema?: TSchema): value is TValue;
     /**
      * Check if a first part of a value is valid
      *
@@ -43,7 +38,7 @@ export type FormatDefinition<TValue extends TPartialValue, TPartialValue extends
      * @param partialValue Partial value to check, for example "{\"foo\": t"
      * @param schema Optional schema to do extra validation
      */
-    canBeValid(partialValue: string, settings?: TSettings, schema?: TSchema): partialValue is TPartialValue;
+    canBeValid(partialValue: string, schema?: TSchema): partialValue is TPartialValue;
     /**
      * Heal a value to make it valid if possible
      *
@@ -54,11 +49,17 @@ export type FormatDefinition<TValue extends TPartialValue, TPartialValue extends
      * @param scheme
      * @throws {Error} If the value cannot be healed
      */
-    heal(value: string, settings?: TSettings, scheme?: TSchema): TValue;
+    heal(value: string, scheme?: TSchema): TValue;
     /**
-     * @@@
+     * Parses just the values and removes structural information
+     *
+     * Note: This is useful when you want to combine format expectations with counting words, characters,...
+     *
+     * @param value The value to check, for example "{\"name\": "John Smith"}"
+     * @param schema Optional schema
+     * @example "{\"name\": "John Smith"}" -> ["John Smith"]
      */
-    readonly subvalueDefinitions: Array<FormatSubvalueDefinition<TValue, TSettings>>;
+    extractValues(value: string, schema?: TSchema): Array<string>;
 };
 /**
  * TODO: [♏] Add some prepare hook to modify prompt according to the format

package/esm/typings/src/formats/csv/{CsvFormatDefinition.d.ts → ListFormatDefinition.d.ts}

@@ -1,17 +1,14 @@
-import type { TODO_any } from '../../utils/organization/TODO_any';
 import type { FormatDefinition } from '../_common/FormatDefinition';
-import type { CsvSettings } from './CsvSettings';
 /**
  * Definition for CSV spreadsheet
  *
- * @public exported from `@promptbook/core`
- *                          <- TODO: [🏢] Export from package `@promptbook/csv`
+ * @private still in development [🏢]
  */
-export declare const CsvFormatDefinition: FormatDefinition<string, string, CsvSettings, TODO_any>;
+export declare const CsvFormatDefinition: FormatDefinition<string, string, object>;
 /**
  * TODO: [🍓] In `CsvFormatDefinition` implement simple `isValid`
  * TODO: [🍓] In `CsvFormatDefinition` implement partial `canBeValid`
  * TODO: [🍓] In `CsvFormatDefinition` implement `heal
- * TODO: [🍓] In `CsvFormatDefinition` implement `subvalueDefinitions`
+ * TODO: [🍓] In `CsvFormatDefinition` implement `extractValues`
  * TODO: [🏢] Allow to expect something inside CSV objects and other formats
  */

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

@@ -3,4 +3,4 @@
  *
  * @private internal index of `...` <- TODO [🏢]
  */
-export declare const FORMAT_DEFINITIONS: readonly [import("./_common/FormatDefinition").FormatDefinition<string, string, any, any>, import("./_common/FormatDefinition").FormatDefinition<string, string, any, any>, import("./_common/FormatDefinition").FormatDefinition<string, string, any, any>, import("./_common/FormatDefinition").FormatDefinition<string, string, import("./csv/CsvSettings").CsvSettings, any>];
+export declare const FORMAT_DEFINITIONS: import("./_common/FormatDefinition").FormatDefinition<string, string, object>[];

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

@@ -1,19 +1,18 @@
-import type { TODO_any } from '../../utils/organization/TODO_any';
 import type { FormatDefinition } from '../_common/FormatDefinition';
 /**
  * Definition for JSON format
  *
  * @private still in development [🏢]
  */
-export declare const JsonFormatDefinition: FormatDefinition<string, string, TODO_any, TODO_any>;
+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 Settings and Schema
+ * TODO: [1] Make type for JSON Schema
  * TODO: [🧠] What to use for validating JSONs - JSON Schema, ZoD, typescript types/interfaces,...?
  * TODO: [🍓] In `JsonFormatDefinition` implement simple `isValid`
  * TODO: [🍓] In `JsonFormatDefinition` implement partial `canBeValid`
  * TODO: [🍓] In `JsonFormatDefinition` implement `heal
- * TODO: [🍓] In `JsonFormatDefinition` implement `subvalueDefinitions`
+ * TODO: [🍓] In `JsonFormatDefinition` implement `extractValues`
  * TODO: [🏢] Allow to expect something inside JSON objects and other formats
  */

package/esm/typings/src/formats/list/ListFormatDefinition.d.ts

@@ -0,0 +1,16 @@
+import type { FormatDefinition } from '../_common/FormatDefinition';
+/**
+ * Definition for list of multiple items
+ *
+ * Note: list is just a string with multiple lines or multiple items separated by comma
+ *
+ * @private still in development [🏢]
+ */
+export declare const ListFormatDefinition: FormatDefinition<string, string, object>;
+/**
+ * TODO: [🍓] In `ListFormatDefinition` implement simple `isValid`
+ * TODO: [🍓] In `ListFormatDefinition` implement partial `canBeValid`
+ * TODO: [🍓] In `ListFormatDefinition` implement `heal
+ * TODO: [🍓] In `ListFormatDefinition` implement `extractValues`
+ * TODO: [🏢] Allow to expect something inside each item of list and other formats
+ */

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

@@ -1,19 +1,18 @@
-import type { TODO_any } from '../../utils/organization/TODO_any';
 import type { FormatDefinition } from '../_common/FormatDefinition';
 /**
  * Definition for XML format
  *
  * @private still in development [🏢]
  */
-export declare const XmlFormatDefinition: FormatDefinition<string, string, TODO_any, TODO_any>;
+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 Settings and Schema
+ * TODO: [1] Make type for XML Schema
  * TODO: [🧠] What to use for validating XMLs - XSD,...
  * TODO: [🍓] In `XmlFormatDefinition` implement simple `isValid`
  * TODO: [🍓] In `XmlFormatDefinition` implement partial `canBeValid`
  * TODO: [🍓] In `XmlFormatDefinition` implement `heal
- * TODO: [🍓] In `XmlFormatDefinition` implement `subvalueDefinitions`
+ * TODO: [🍓] In `XmlFormatDefinition` implement `extractValues`
  * TODO: [🏢] Allow to expect something inside XML and other formats
  */

package/esm/typings/src/knowledge/dialogs/callback/CallbackInterfaceTools.d.ts

@@ -8,7 +8,7 @@ import type { CallbackInterfaceToolsOptions } from './CallbackInterfaceToolsOpti
  * @public exported from `@promptbook/core`
  */
 export declare class CallbackInterfaceTools implements UserInterfaceTools {
-    private readonly options;
+    protected readonly options: CallbackInterfaceToolsOptions;
     constructor(options: CallbackInterfaceToolsOptions);
     /**
      * Trigger the custom callback function

package/esm/typings/src/knowledge/dialogs/simple-prompt/SimplePromptInterfaceTools.d.ts

@@ -10,7 +10,7 @@ import type { UserInterfaceToolsPromptDialogOptions } from '../../../execution/U
  * @public exported from `@promptbook/browser`
  */
 export declare class SimplePromptInterfaceTools implements UserInterfaceTools {
-    private readonly options;
+    protected readonly options: CommonExecutionToolsOptions;
     constructor(options?: CommonExecutionToolsOptions);
     /**
      * Trigger window.DIALOG TEMPLATE

package/esm/typings/src/llm-providers/anthropic-claude/AnthropicClaudeExecutionTools.d.ts

@@ -1,3 +1,4 @@
+import Anthropic from '@anthropic-ai/sdk';
 import type { AvailableModel } from '../../execution/AvailableModel';
 import type { LlmExecutionTools } from '../../execution/LlmExecutionTools';
 import type { ChatPromptResult } from '../../execution/PromptResult';
@@ -13,7 +14,7 @@ import type { AnthropicClaudeExecutionToolsDirectOptions } from './AnthropicClau
  * @deprecated use `createAnthropicClaudeExecutionTools` instead
  */
 export declare class AnthropicClaudeExecutionTools implements LlmExecutionTools {
-    private readonly options;
+    protected readonly options: AnthropicClaudeExecutionToolsDirectOptions;
     /**
      * Anthropic Claude API client.
      */
@@ -26,7 +27,7 @@ export declare class AnthropicClaudeExecutionTools implements LlmExecutionTools
     constructor(options?: AnthropicClaudeExecutionToolsDirectOptions);
     get title(): string_title & string_markdown_text;
     get description(): string_markdown;
-    private getClient;
+    getClient(): Promise<Anthropic>;
     /**
      * Check the `options` passed to `constructor`
      */

package/esm/typings/src/llm-providers/azure-openai/AzureOpenAiExecutionTools.d.ts

@@ -1,3 +1,4 @@
+import { OpenAIClient } from '@azure/openai';
 import type { AvailableModel } from '../../execution/AvailableModel';
 import type { LlmExecutionTools } from '../../execution/LlmExecutionTools';
 import type { ChatPromptResult } from '../../execution/PromptResult';
@@ -13,7 +14,7 @@ import type { AzureOpenAiExecutionToolsOptions } from './AzureOpenAiExecutionToo
  * @public exported from `@promptbook/azure-openai`
  */
 export declare class AzureOpenAiExecutionTools implements LlmExecutionTools {
-    private readonly options;
+    protected readonly options: AzureOpenAiExecutionToolsOptions;
     /**
      * OpenAI Azure API client.
      */
@@ -26,7 +27,7 @@ export declare class AzureOpenAiExecutionTools implements LlmExecutionTools {
     constructor(options: AzureOpenAiExecutionToolsOptions);
     get title(): string_title & string_markdown_text;
     get description(): string_markdown;
-    private getClient;
+    getClient(): Promise<OpenAIClient>;
     /**
      * Check the `options` passed to `constructor`
      */

package/esm/typings/src/llm-providers/mocked/MockedEchoLlmExecutionTools.d.ts

@@ -13,7 +13,7 @@ import type { string_title } from '../../types/typeAliases';
  * @public exported from `@promptbook/fake-llm`
  */
 export declare class MockedEchoLlmExecutionTools implements LlmExecutionTools {
-    private readonly options;
+    protected readonly options: CommonExecutionToolsOptions;
     constructor(options?: CommonExecutionToolsOptions);
     get title(): string_title & string_markdown_text;
     get description(): string_markdown;

package/esm/typings/src/llm-providers/mocked/MockedFackedLlmExecutionTools.d.ts

@@ -14,7 +14,7 @@ import type { string_title } from '../../types/typeAliases';
  * @public exported from `@promptbook/fake-llm`
  */
 export declare class MockedFackedLlmExecutionTools implements LlmExecutionTools {
-    private readonly options;
+    protected readonly options: CommonExecutionToolsOptions;
     constructor(options?: CommonExecutionToolsOptions);
     get title(): string_title & string_markdown_text;
     get description(): string_markdown;

package/esm/typings/src/llm-providers/openai/OpenAiAssistantExecutionTools.d.ts

@@ -0,0 +1,37 @@
+import type { LlmExecutionTools } from '../../execution/LlmExecutionTools';
+import type { ChatPromptResult } from '../../execution/PromptResult';
+import type { Prompt } from '../../types/Prompt';
+import type { string_markdown } from '../../types/typeAliases';
+import type { string_markdown_text } from '../../types/typeAliases';
+import type { string_title } from '../../types/typeAliases';
+import type { OpenAiAssistantExecutionToolsOptions } from './OpenAiAssistantExecutionToolsOptions';
+import { OpenAiExecutionTools } from './OpenAiExecutionTools';
+/**
+ * Execution Tools for calling OpenAI API Assistants
+ *
+ * This is usefull for calling OpenAI API with a single assistant, for more wide usage use `OpenAiExecutionTools`.
+ *
+ * @public exported from `@promptbook/openai`
+ */
+export declare class OpenAiAssistantExecutionTools extends OpenAiExecutionTools implements LlmExecutionTools {
+    private readonly assistantId?;
+    /**
+     * Creates OpenAI Execution Tools.
+     *
+     * @param options which are relevant are directly passed to the OpenAI client
+     */
+    constructor(options?: OpenAiAssistantExecutionToolsOptions);
+    get title(): string_title & string_markdown_text;
+    get description(): string_markdown;
+    /**
+     * Calls OpenAI API to use a chat model.
+     */
+    callChatModel(prompt: Pick<Prompt, 'content' | 'parameters' | 'modelRequirements' | 'format'>): Promise<ChatPromptResult>;
+}
+/**
+ * TODO: !!!!!! DO not use colors - can be used in browser
+ * TODO: [🧠][🧙‍♂️] Maybe there can be some wizzard for thoose who want to use just OpenAI
+ * TODO: Maybe make custom OpenAiError
+ * TODO: [🧠][🈁] Maybe use `isDeterministic` from options
+ * TODO: [🧠][🌰] Allow to pass `title` for tracking purposes
+ */

package/esm/typings/src/llm-providers/openai/OpenAiAssistantExecutionToolsOptions.d.ts

@@ -0,0 +1,14 @@
+import type { ClientOptions } from 'openai';
+import type { string_token } from '../../types/typeAliases';
+import type { OpenAiExecutionToolsOptions } from './OpenAiExecutionToolsOptions';
+/**
+ * Options for `OpenAiAssistantExecutionTools`
+ *
+ * @public exported from `@promptbook/openai`
+ */
+export type OpenAiAssistantExecutionToolsOptions = OpenAiExecutionToolsOptions & ClientOptions & {
+    /**
+     * Which assistant to use
+     */
+    assistantId?: string_token;
+};