@promptbook/legacy-documents 0.71.0-16 → 0.72.0-10

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

@@ -5,7 +5,9 @@ import { _AnthropicClaudeRegistration } from '../llm-providers/anthropic-claude/
 import { _AzureOpenAiMetadataRegistration } from '../llm-providers/azure-openai/register-configuration';
 import { _AzureOpenAiRegistration } from '../llm-providers/azure-openai/register-constructor';
 import { _OpenAiMetadataRegistration } from '../llm-providers/openai/register-configuration';
+import { _OpenAiAssistantMetadataRegistration } from '../llm-providers/openai/register-configuration';
 import { _OpenAiRegistration } from '../llm-providers/openai/register-constructor';
+import { _OpenAiAssistantRegistration } from '../llm-providers/openai/register-constructor';
 import { _LegacyDocumentScraperRegistration } from '../scrapers/document-legacy/register-constructor';
 import { _LegacyDocumentScraperMetadataRegistration } from '../scrapers/document-legacy/register-metadata';
 import { _DocumentScraperRegistration } from '../scrapers/document/register-constructor';
@@ -23,7 +25,9 @@ export { _AnthropicClaudeRegistration };
 export { _AzureOpenAiMetadataRegistration };
 export { _AzureOpenAiRegistration };
 export { _OpenAiMetadataRegistration };
+export { _OpenAiAssistantMetadataRegistration };
 export { _OpenAiRegistration };
+export { _OpenAiAssistantRegistration };
 export { _LegacyDocumentScraperRegistration };
 export { _LegacyDocumentScraperMetadataRegistration };
 export { _DocumentScraperRegistration };

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

@@ -47,9 +47,10 @@ import { UnexpectedError } from '../errors/UnexpectedError';
 import { assertsExecutionSuccessful } from '../execution/assertsExecutionSuccessful';
 import { createPipelineExecutor } from '../execution/createPipelineExecutor/00-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 { CsvFormatDefinition } from '../formats/csv/CsvFormatDefinition';
@@ -66,6 +67,7 @@ import { _AnthropicClaudeMetadataRegistration } from '../llm-providers/anthropic
 import { _AzureOpenAiMetadataRegistration } from '../llm-providers/azure-openai/register-configuration';
 import { joinLlmExecutionTools } from '../llm-providers/multiple/joinLlmExecutionTools';
 import { _OpenAiMetadataRegistration } from '../llm-providers/openai/register-configuration';
+import { _OpenAiAssistantMetadataRegistration } from '../llm-providers/openai/register-configuration';
 import { preparePersona } from '../personas/preparePersona';
 import { isPipelinePrepared } from '../prepare/isPipelinePrepared';
 import { preparePipeline } from '../prepare/preparePipeline';
@@ -135,9 +137,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 { CsvFormatDefinition };
@@ -154,6 +157,7 @@ export { _AnthropicClaudeMetadataRegistration };
 export { _AzureOpenAiMetadataRegistration };
 export { joinLlmExecutionTools };
 export { _OpenAiMetadataRegistration };
+export { _OpenAiAssistantMetadataRegistration };
 export { preparePersona };
 export { isPipelinePrepared };
 export { preparePipeline };

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

@@ -1,12 +1,20 @@
 import { PROMPTBOOK_VERSION } from '../version';
+import { createOpenAiAssistantExecutionTools } from '../llm-providers/openai/createOpenAiAssistantExecutionTools';
 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';
+import { _OpenAiAssistantRegistration } from '../llm-providers/openai/register-constructor';
 export { PROMPTBOOK_VERSION };
+export { createOpenAiAssistantExecutionTools };
 export { createOpenAiExecutionTools };
 export { OPENAI_MODELS };
+export { OpenAiAssistantExecutionTools };
+export type { OpenAiAssistantExecutionToolsOptions };
 export { OpenAiExecutionTools };
 export type { OpenAiExecutionToolsOptions };
 export { _OpenAiRegistration };
+export { _OpenAiAssistantRegistration };

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

@@ -50,6 +50,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';
@@ -65,6 +66,7 @@ import type { RemoteLlmExecutionToolsOptions } from '../llm-providers/remote/int
 import type { RemoteServerOptions } from '../llm-providers/remote/interfaces/RemoteServerOptions';
 import type { AnonymousRemoteServerOptions } from '../llm-providers/remote/interfaces/RemoteServerOptions';
 import type { CollectionRemoteServerOptions } from '../llm-providers/remote/interfaces/RemoteServerOptions';
+import type { CollectionRemoteServerClientOptions } from '../llm-providers/remote/interfaces/RemoteServerOptions';
 import type { PrepareAndScrapeOptions } from '../prepare/PrepareAndScrapeOptions';
 import type { Converter } from '../scrapers/_common/Converter';
 import type { ScraperAndConverterMetadata } from '../scrapers/_common/register/ScraperAndConverterMetadata';
@@ -161,13 +163,13 @@ import type { string_url_image } from '../types/typeAliases';
 import type { string_executable_path } from '../types/typeAliases';
 import type { string_uri } from '../types/typeAliases';
 import type { string_uri_part } from '../types/typeAliases';
-import type { string_uriid } from '../types/typeAliases';
 import type { string_hostname } from '../types/typeAliases';
 import type { string_host } from '../types/typeAliases';
 import type { string_protocol } from '../types/typeAliases';
 import type { string_email } from '../types/typeAliases';
 import type { string_emails } from '../types/typeAliases';
 import type { string_uuid } from '../types/typeAliases';
+import type { string_app_id } from '../types/typeAliases';
 import type { string_user_id } from '../types/typeAliases';
 import type { string_sha256 } from '../types/typeAliases';
 import type { string_semantic_version } from '../types/typeAliases';
@@ -190,6 +192,7 @@ import type { string_translate_name_not_normalized } from '../types/typeAliases'
 import type { string_translate_language } from '../types/typeAliases';
 import type { string_javascript_name } from '../types/typeAliases';
 import type { string_postprocessing_function_name } from '../types/typeAliases';
+import type { id } from '../types/typeAliases';
 import type { string_token } from '../types/typeAliases';
 import type { string_license_token } from '../types/typeAliases';
 import type { string_password } from '../types/typeAliases';
@@ -290,6 +293,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 };
@@ -305,6 +309,7 @@ export type { RemoteLlmExecutionToolsOptions };
 export type { RemoteServerOptions };
 export type { AnonymousRemoteServerOptions };
 export type { CollectionRemoteServerOptions };
+export type { CollectionRemoteServerClientOptions };
 export type { PrepareAndScrapeOptions };
 export type { Converter };
 export type { ScraperAndConverterMetadata };
@@ -401,13 +406,13 @@ export type { string_url_image };
 export type { string_executable_path };
 export type { string_uri };
 export type { string_uri_part };
-export type { string_uriid };
 export type { string_hostname };
 export type { string_host };
 export type { string_protocol };
 export type { string_email };
 export type { string_emails };
 export type { string_uuid };
+export type { string_app_id };
 export type { string_user_id };
 export type { string_sha256 };
 export type { string_semantic_version };
@@ -430,6 +435,7 @@ export type { string_translate_name_not_normalized };
 export type { string_translate_language };
 export type { string_javascript_name };
 export type { string_postprocessing_function_name };
+export type { id };
 export type { string_token };
 export type { string_license_token };
 export type { string_password };

package/esm/typings/src/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/dialogs/simple-prompt/SimplePromptInterfaceTools.d.ts

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

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/llm-providers/anthropic-claude/AnthropicClaudeExecutionTools.d.ts

@@ -14,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.
      */

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

@@ -25,7 +25,7 @@ export type AnthropicClaudeExecutionToolsDirectOptions = CommonToolsOptions & Cl
  */
 export type AnthropicClaudeExecutionToolsProxiedOptions = CommonToolsOptions & ClientOptions & {
     isProxied: true;
-} & Pick<RemoteLlmExecutionToolsOptions, 'remoteUrl' | 'path'>;
+} & Pick<RemoteLlmExecutionToolsOptions<undefined>, 'remoteUrl' | 'path'>;
 /**
- * TODO: [🧠][🤺] Detecting `user`
+ * TODO: [🧠][🤺] Pass `userId`
  */

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

@@ -14,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.
      */

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

@@ -1,6 +1,7 @@
 import type { CommonToolsOptions } from '../../execution/CommonToolsOptions';
 import type { string_name } from '../../types/typeAliases';
 import type { string_token } from '../../types/typeAliases';
+import type { string_user_id } from '../../types/typeAliases';
 /**
  * Options for `AzureOpenAiExecutionTools`
  *
@@ -32,5 +33,5 @@ export type AzureOpenAiExecutionToolsOptions = CommonToolsOptions & {
      *
      * @see https://platform.openai.com/docs/guides/safety-best-practices/end-user-ids (document from OpenAI not Azure, but same concept)
      */
-    readonly user?: string_token;
+    readonly userId: string_user_id | null;
 };

package/esm/typings/src/llm-providers/langtail/LangtailExecutionTools.d.ts

@@ -14,4 +14,4 @@ export declare class LangtailExecutionTools extends OpenAiExecutionTools impleme
 }
 /**
  * TODO: [🧠][🈁] Maybe use `isDeterministic` from options
- */ 
+ */

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: CommonToolsOptions;
     constructor(options?: CommonToolsOptions);
     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: CommonToolsOptions;
     constructor(options?: CommonToolsOptions);
     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

@@ -8,6 +8,8 @@ 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 { string_token } from '../../types/typeAliases';
+import { OpenAiAssistantExecutionTools } from './OpenAiAssistantExecutionTools';
 import type { OpenAiExecutionToolsOptions } from './OpenAiExecutionToolsOptions';
 /**
  * Execution Tools for calling OpenAI API
@@ -15,7 +17,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.
      */
@@ -25,10 +27,17 @@ export declare class OpenAiExecutionTools implements LlmExecutionTools {
      *
      * @param options which are relevant are directly passed to the OpenAI client
      */
-    constructor(options?: OpenAiExecutionToolsOptions);
+    constructor(options: OpenAiExecutionToolsOptions);
     get title(): string_title & string_markdown_text;
     get description(): string_markdown;
     getClient(): Promise<OpenAI>;
+    /**
+     * Create (sub)tools for calling OpenAI API Assistants
+     *
+     * @param assistantId Which assistant to use
+     * @returns Tools for calling OpenAI API Assistants with same token
+     */
+    createAssistantSubtools(assistantId: string_token): OpenAiAssistantExecutionTools;
     /**
      * Check the `options` passed to `constructor`
      */

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

@@ -1,6 +1,6 @@
 import type { ClientOptions } from 'openai';
 import type { CommonToolsOptions } from '../../execution/CommonToolsOptions';
-import type { string_token } from '../../types/typeAliases';
+import type { string_user_id } from '../../types/typeAliases';
 /**
  * Options for `OpenAiExecutionTools`
  *
@@ -16,5 +16,5 @@ export type OpenAiExecutionToolsOptions = CommonToolsOptions & ClientOptions & {
      *
      * @see https://platform.openai.com/docs/guides/safety-best-practices/end-user-ids
      */
-    user?: string_token;
+    userId: string_user_id | null;
 };

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

@@ -0,0 +1,15 @@
+import { OpenAiAssistantExecutionTools } from './OpenAiAssistantExecutionTools';
+import type { OpenAiAssistantExecutionToolsOptions } from './OpenAiAssistantExecutionToolsOptions';
+/**
+ * Execution Tools for calling OpenAI API
+ *
+ * @public exported from `@promptbook/openai`
+ */
+export declare const createOpenAiAssistantExecutionTools: ((options: OpenAiAssistantExecutionToolsOptions) => OpenAiAssistantExecutionTools) & {
+    packageName: string;
+    className: string;
+};
+/**
+ * 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/openai/register-configuration.d.ts

@@ -8,3 +8,12 @@ import type { Registration } from '../../utils/$Register';
  * @public exported from `@promptbook/cli`
  */
 export declare const _OpenAiMetadataRegistration: Registration;
+/**
+ * @@@ registration1 of default configuration for Open AI
+ *
+ * Note: [🏐] Configurations registrations are done in @@@ BUT constructor @@@
+ *
+ * @public exported from `@promptbook/core`
+ * @public exported from `@promptbook/cli`
+ */
+export declare const _OpenAiAssistantMetadataRegistration: Registration;

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

@@ -8,6 +8,15 @@ import type { Registration } from '../../utils/$Register';
  * @public exported from `@promptbook/cli`
  */
 export declare const _OpenAiRegistration: Registration;
+/**
+ * @@@ registration2
+ *
+ * Note: [🏐] Configurations registrations are done in @@@ BUT constructor @@@
+ *
+ * @public exported from `@promptbook/openai`
+ * @public exported from `@promptbook/cli`
+ */
+export declare const _OpenAiAssistantRegistration: Registration;
 /**
  * TODO: [🎶] Naming "constructor" vs "creator" vs "factory"
  */

package/esm/typings/src/llm-providers/remote/RemoteLlmExecutionTools.d.ts

@@ -19,9 +19,9 @@ import type { RemoteLlmExecutionToolsOptions } from './interfaces/RemoteLlmExecu
  * @see https://github.com/webgptorg/promptbook#remote-server
  * @public exported from `@promptbook/remote-client`
  */
-export declare class RemoteLlmExecutionTools implements LlmExecutionTools {
-    private readonly options;
-    constructor(options: RemoteLlmExecutionToolsOptions);
+export declare class RemoteLlmExecutionTools<TCustomOptions = undefined> implements LlmExecutionTools {
+    protected readonly options: RemoteLlmExecutionToolsOptions<TCustomOptions>;
+    constructor(options: RemoteLlmExecutionToolsOptions<TCustomOptions>);
     get title(): string_title & string_markdown_text;
     get description(): string_markdown;
     /**