@promptbook/core 0.70.0-1 → 0.72.0-0

package/esm/typings/promptbook-collection/index.d.ts

@@ -1,7 +1,6 @@
 declare const _default: ({
     title: string;
     pipelineUrl: string;
-    promptbookVersion: string;
     parameters: {
         name: string;
         description: string;
@@ -24,7 +23,6 @@ declare const _default: ({
 } | {
     title: string;
     pipelineUrl: string;
-    promptbookVersion: string;
     parameters: {
         name: string;
         description: string;
@@ -53,7 +51,6 @@ declare const _default: ({
 } | {
     title: string;
     pipelineUrl: string;
-    promptbookVersion: string;
     parameters: {
         name: string;
         description: string;

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

@@ -40,9 +40,10 @@ import { UnexpectedError } from '../errors/UnexpectedError';
 import { assertsExecutionSuccessful } from '../execution/assertsExecutionSuccessful';
 import { createPipelineExecutor } from '../execution/createPipelineExecutor';
 import { embeddingVectorToString } from '../execution/embeddingVectorToString';
-import { ZERO_USAGE } from '../execution/utils/addUsage';
 import { addUsage } from '../execution/utils/addUsage';
 import { isPassingExpectations } from '../execution/utils/checkExpectations';
+import { ZERO_USAGE } from '../execution/utils/usage-constants';
+import { UNCERTAIN_USAGE } from '../execution/utils/usage-constants';
 import { usageToHuman } from '../execution/utils/usageToHuman';
 import { usageToWorktime } from '../execution/utils/usageToWorktime';
 import { CallbackInterfaceTools } from '../knowledge/dialogs/callback/CallbackInterfaceTools';
@@ -113,9 +114,10 @@ export { UnexpectedError };
 export { assertsExecutionSuccessful };
 export { createPipelineExecutor };
 export { embeddingVectorToString };
-export { ZERO_USAGE };
 export { addUsage };
 export { isPassingExpectations };
+export { ZERO_USAGE };
+export { UNCERTAIN_USAGE };
 export { usageToHuman };
 export { usageToWorktime };
 export { CallbackInterfaceTools };

package/esm/typings/src/_packages/openai.index.d.ts

@@ -1,12 +1,16 @@
 import { PROMPTBOOK_VERSION } from '../version';
 import { createOpenAiExecutionTools } from '../llm-providers/openai/createOpenAiExecutionTools';
 import { OPENAI_MODELS } from '../llm-providers/openai/openai-models';
+import { OpenAiAssistantExecutionTools } from '../llm-providers/openai/OpenAiAssistantExecutionTools';
+import type { OpenAiAssistantExecutionToolsOptions } from '../llm-providers/openai/OpenAiAssistantExecutionToolsOptions';
 import { OpenAiExecutionTools } from '../llm-providers/openai/OpenAiExecutionTools';
 import type { OpenAiExecutionToolsOptions } from '../llm-providers/openai/OpenAiExecutionToolsOptions';
 import { _OpenAiRegistration } from '../llm-providers/openai/register-constructor';
 export { PROMPTBOOK_VERSION };
 export { createOpenAiExecutionTools };
 export { OPENAI_MODELS };
+export { OpenAiAssistantExecutionTools };
+export type { OpenAiAssistantExecutionToolsOptions };
 export { OpenAiExecutionTools };
 export type { OpenAiExecutionToolsOptions };
 export { _OpenAiRegistration };

package/esm/typings/src/_packages/types.index.d.ts

@@ -45,6 +45,7 @@ import type { AnthropicClaudeExecutionToolsProxiedOptions } from '../llm-provide
 import type { AzureOpenAiExecutionToolsOptions } from '../llm-providers/azure-openai/AzureOpenAiExecutionToolsOptions';
 import type { LangtailExecutionToolsOptions } from '../llm-providers/langtail/LangtailExecutionToolsOptions';
 import type { MultipleLlmExecutionTools } from '../llm-providers/multiple/MultipleLlmExecutionTools';
+import type { OpenAiAssistantExecutionToolsOptions } from '../llm-providers/openai/OpenAiAssistantExecutionToolsOptions';
 import type { OpenAiExecutionToolsOptions } from '../llm-providers/openai/OpenAiExecutionToolsOptions';
 import type { PromptbookServer_Error } from '../llm-providers/remote/interfaces/PromptbookServer_Error';
 import type { PromptbookServer_ListModels_Request } from '../llm-providers/remote/interfaces/PromptbookServer_ListModels_Request';
@@ -270,6 +271,7 @@ export type { AnthropicClaudeExecutionToolsProxiedOptions };
 export type { AzureOpenAiExecutionToolsOptions };
 export type { LangtailExecutionToolsOptions };
 export type { MultipleLlmExecutionTools };
+export type { OpenAiAssistantExecutionToolsOptions };
 export type { OpenAiExecutionToolsOptions };
 export type { PromptbookServer_Error };
 export type { PromptbookServer_ListModels_Request };

package/esm/typings/src/cli/cli-commands/make.d.ts

@@ -6,7 +6,7 @@ import type { Command as Program } from 'commander';
  */
 export declare function initializeMakeCommand(program: Program): void;
 /**
- * TODO: [🥃] !!! Allow `ptbk make` without configuring any llm tools
+ * TODO: [🥃][main] !!! Allow `ptbk make` without configuring any llm tools
  * TODO: Maybe remove this command - "about" command should be enough?
  * TODO: [0] DRY Javascript and typescript - Maybe make ONLY typescript and for javascript just remove types
  * Note: [🟡] This code should never be published outside of `@promptbook/cli`

package/esm/typings/src/collection/constructors/createCollectionFromUrl.d.ts

@@ -25,5 +25,5 @@ type CreatePipelineCollectionFromUrlyOptions = {
 export declare function createCollectionFromUrl(url: string_url | URL, options: CreatePipelineCollectionFromUrlyOptions): Promise<PipelineCollection>;
 export {};
 /**
- * TODO: !!!! [🧠] Library precompilation and do not mix markdown and json promptbooks
+ * TODO:[main] !!!! [🧠] Library precompilation and do not mix markdown and json promptbooks
  */

package/esm/typings/src/commands/FOREACH/ForeachCommand.d.ts

@@ -1,14 +1,9 @@
-import type { string_parameter_name } from '../../types/typeAliases';
-import type { TODO_string } from '../../utils/organization/TODO_string';
 /**
- * Parsed FOREACH command <- Write [🍭] !!!!!!
+ * Parsed FOREACH command <- Write [🍭]
  *
  * @see ./foreachCommandParser.ts for more details
  * @private within the commands folder
  */
 export type ForeachCommand = {
     readonly type: 'FOREACH';
-    formatName: TODO_string;
-    cellName: TODO_string;
-    parameterName: string_parameter_name;
 };

package/esm/typings/src/commands/FOREACH/foreachCommandParser.d.ts

@@ -10,6 +10,5 @@ import type { ForeachCommand } from './ForeachCommand';
  */
 export declare const foreachCommandParser: PipelineTemplateCommandParser<ForeachCommand>;
 /**
- * TODO: !!!!!! Comment console logs
- * TODO: [🍭] !!!!!! Make .ptbk.md file with examples of the FOREACH command and also with wrong parsing and logic
+ * TODO: [🍭] Make .ptbk.md file with examples of the FOREACH command and also with wrong parsing and logic
  */

package/esm/typings/src/commands/_common/types/CommandParser.d.ts

@@ -147,39 +147,24 @@ export type $PipelineJson = WritableDeep<PipelineJson>;
 export type CommandParserInput = {
     /**
      * @@@
-     *
-     * @example 'PIPELINE_HEAD'
-     * @example 'PIPELINE_TEMPLATE'
      */
     readonly usagePlace: CommandUsagePlace;
     /**
      * @@@
-     *
-     * @example 'promptbook version 0.62.0'
-     * @example 'FOREACH List Line -> `{customer}`'
      */
     readonly raw: string_markdown_text;
     /**
      * @@@
-     *
-     * @example '0.62.0'
-     * @example 'List Line -> `{customer}`'
      */
     readonly rawArgs: string_markdown_text;
     /**
      * @@@
-     *
-     * @example 'PROMPTBOOK_VERSION_0_62_0'
-     * @example 'FOREACH_LIST_LINE_CUSTOMER'
      */
     readonly normalized: string_name & string_SCREAMING_CASE;
     /**
      * @@@
-     *
-     * @example [ '0.62.0' ]
-     * @example [ 'List', 'Line', '', '{customer}' ]
      */
-    readonly args: Array<string_name>;
+    readonly args: Array<string_name & string_SCREAMING_CASE>;
 };
 /**
  * TODO: [♓️] Add order here

package/esm/typings/src/config.d.ts

@@ -68,14 +68,14 @@ export declare const MAX_EXECUTION_ATTEMPTS = 3;
 export declare const MAX_FILENAME_LENGTH = 30;
 /**
  * @@@
- * TODO: [🐝] !!! Use
+ * TODO: [🐝][main] !!! Use
  *
  * @public exported from `@promptbook/core`
  */
 export declare const MAX_KNOWLEDGE_SOURCES_SCRAPING_DEPTH = 3;
 /**
  * @@@
- * TODO: [🐝] !!! Use
+ * TODO: [🐝][main] !!! Use
  *
  * @public exported from `@promptbook/core`
  */

package/esm/typings/src/conversion/pipelineStringToJsonSync.d.ts

@@ -18,7 +18,7 @@ import type { PipelineString } from '../types/PipelineString';
  */
 export declare function pipelineStringToJsonSync(pipelineString: PipelineString): PipelineJson;
 /**
- * TODO: !!!! Warn if used only sync version
+ * TODO:[main] !!!! Warn if used only sync version
  * TODO: [🚞] Report here line/column of error
  * TODO: Use spaceTrim more effectively
  * TODO: [🧠] Parameter flags - isInput, isOutput, isInternal

package/esm/typings/src/conversion/validation/validatePipeline.d.ts

@@ -27,11 +27,11 @@ export declare function validatePipeline(pipeline: PipelineJson): PipelineJson;
  *     >  ex port function validatePipeline(promptbook: really_unknown): asserts promptbook is PipelineJson {
  */
 /**
- * TODO: [🐣] !!!! Validate that all samples match expectations
- * TODO: [🐣][🐝] !!!! Validate that knowledge is valid (non-void)
- * TODO: [🐣] !!!! Validate that persona can be used only with CHAT variant
- * TODO: [🐣] !!!! Validate that parameter with reserved name not used RESERVED_PARAMETER_NAMES
- * TODO: [🐣] !!!! Validate that reserved parameter is not used as joker
+ * TODO: [🐣][main] !!!! Validate that all samples match expectations
+ * TODO: [🐣][🐝][main] !!!! Validate that knowledge is valid (non-void)
+ * TODO: [🐣][main] !!!! Validate that persona can be used only with CHAT variant
+ * TODO: [🐣][main] !!!! Validate that parameter with reserved name not used RESERVED_PARAMETER_NAMES
+ * TODO: [🐣][main] !!!! Validate that reserved parameter is not used as joker
  * TODO: [🧠] Validation not only logic itself but imports around - files and websites and rerefenced pipelines exists
  * TODO: [🛠] Actions, instruments (and maybe knowledge) => Functions and tools
  */

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

@@ -58,7 +58,7 @@ interface CreatePipelineExecutorOptions {
 export declare function createPipelineExecutor(options: CreatePipelineExecutorOptions): PipelineExecutor;
 export {};
 /**
- * TODO: !!! Identify not only pipeline BUT exact template ${block(pipelineIdentification)}
+ * 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`)

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/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/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/knowledge/prepare-knowledge/markdown/prepareKnowledgeFromMarkdown.d.ts

@@ -8,7 +8,7 @@ import type { string_markdown } from '../../../types/typeAliases';
  */
 export declare function prepareKnowledgeFromMarkdown(knowledgeContent: string_markdown, options: PrepareOptions): Promise<Array<Omit<KnowledgePiecePreparedJson, 'sources' | 'preparationIds'>>>;
 /**
- * TODO: [🐝][🔼] !!! Export via `@promptbook/markdown`
+ * TODO: [🐝][🔼][main] !!! Export via `@promptbook/markdown`
  * TODO: [🪂] Do it in parallel 11:11
  * Note: No need to aggregate usage here, it is done by intercepting the llmTools
  */

package/esm/typings/src/knowledge/prepare-knowledge/pdf/prepareKnowledgeFromPdf.d.ts

@@ -8,7 +8,7 @@ import type { string_base64 } from '../../../types/typeAliases';
  */
 export declare function prepareKnowledgeFromPdf(content: string_base64, options: PrepareOptions): Promise<Array<Omit<KnowledgePiecePreparedJson, 'sources' | 'preparationIds'>>>;
 /**
- * TODO: [🐝][🔼] !!! Export via `@promptbook/pdf`
+ * TODO: [🐝][🔼][main] !!! Export via `@promptbook/pdf`
  * TODO: [🧺] In future, content can be alse File or Blob BUT for now for wider compatibility its only base64
  *       @see https://stackoverflow.com/questions/14653349/node-js-cant-create-blobs
  * TODO: [🪂] Do it in parallel

package/esm/typings/src/llm-providers/_common/utils/cache/CacheItem.d.ts

@@ -13,7 +13,7 @@ export type CacheItem = {
     /**
      * @@@
      */
-    promptbookVersion: string_promptbook_version;
+    promptbookVersion?: string_promptbook_version;
     /**
      * @@@
      */

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/anthropic-claude/anthropic-claude-models.d.ts

@@ -16,7 +16,7 @@ export declare const ANTHROPIC_CLAUDE_MODELS: Array<AvailableModel & {
 }>;
 /**
  * Note: [🤖] Add models of new variant
- * TODO: [🧠] !!! Add embedding models OR Anthropic has only chat+completion models?
+ * TODO: [🧠][main] !!! Add embedding models OR Anthropic has only chat+completion models?
  * TODO: [🧠] Some mechanism to propagate unsureness
  * TODO: [🧠][👮‍♀️] Put here more info like description, isVision, trainingDateCutoff, languages, strengths (	Top-level performance, intelligence, fluency, and understanding), contextWindow,...
  * TODO: [🎰] Some mechanism to auto-update available models

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

@@ -11,8 +11,8 @@ export declare const createAnthropicClaudeExecutionTools: ((options: AnthropicCl
     className: string;
 };
 /**
- * TODO: [🧠] !!!! Make anonymous this with all LLM providers
- * TODO: [🧠][🧱] !!!! Maybe change all `new AnthropicClaudeExecutionTools` -> `createAnthropicClaudeExecutionTools` in manual
+ * TODO: [🧠][main] !!!! Make anonymous this with all LLM providers
+ * TODO: [🧠][🧱][main] !!!! Maybe change all `new AnthropicClaudeExecutionTools` -> `createAnthropicClaudeExecutionTools` in manual
  * TODO: [🧠] Maybe auto-detect usage in browser and determine default value of `isProxied`
  * TODO: [🦺] Is there some way how to put `packageName` and `className` on top and function definition on bottom?
  * TODO: [🎶] Naming "constructor" vs "creator" vs "factory"

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

@@ -1,6 +1,6 @@
 #!/usr/bin/env ts-node
 export {};
 /**
- * TODO: !!! Playground with WebGPT / Promptbook.studio anonymous server
- * TODO: !!! Test here that `systemMessage`, `temperature` and `seed` are working correctly
+ * TODO:[main] !!! Playground with WebGPT / Promptbook.studio anonymous server
+ * TODO:[main] !!! Test here that `systemMessage`, `temperature` and `seed` are working correctly
  */

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;
+};

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

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