@promptbook/utils 0.101.0-20 → 0.101.0-21

package/esm/index.es.js

@@ -16,7 +16,7 @@ const BOOK_LANGUAGE_VERSION = '1.0.0';
  * @generated
  * @see https://github.com/webgptorg/promptbook
  */
-const PROMPTBOOK_ENGINE_VERSION = '0.101.0-20';
+const PROMPTBOOK_ENGINE_VERSION = '0.101.0-21';
 /**
  * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
  * Note: [💞] Ignore a discrepancy between file name and entity name

package/esm/typings/src/book-2.0/commitments/ACTION/ACTION.d.ts

@@ -27,18 +27,6 @@ export declare class ActionCommitmentDefinition extends BaseCommitmentDefinition
     get documentation(): string;
     applyToAgentModelRequirements(requirements: AgentModelRequirements, content: string): AgentModelRequirements;
 }
-/**
- * Singleton instance of the ACTION commitment definition
- *
- * @private [🪔] Maybe export the commitments through some package
- */
-export declare const ActionCommitment: ActionCommitmentDefinition;
-/**
- * Singleton instance of the ACTIONS commitment definition
- *
- * @private [🪔] Maybe export the commitments through some package
- */
-export declare const ActionsCommitment: ActionCommitmentDefinition;
 /**
  * Note: [💞] Ignore a discrepancy between file name and entity name
  */

package/esm/typings/src/book-2.0/commitments/DELETE/DELETE.d.ts

@@ -30,30 +30,6 @@ export declare class DeleteCommitmentDefinition extends BaseCommitmentDefinition
     get documentation(): string;
     applyToAgentModelRequirements(requirements: AgentModelRequirements, content: string): AgentModelRequirements;
 }
-/**
- * Singleton instances of the DELETE commitment definitions with aliases
- *
- * @private [🪔] Maybe export the commitments through some package
- */
-export declare const DeleteCommitment: DeleteCommitmentDefinition;
-/**
- * Singleton instances of the DELETE commitment definitions with aliases
- *
- * @private [🪔] Maybe export the commitments through some package
- */
-export declare const CancelCommitment: DeleteCommitmentDefinition;
-/**
- * Singleton instances of the DELETE commitment definitions with aliases
- *
- * @private [🪔] Maybe export the commitments through some package
- */
-export declare const DiscardCommitment: DeleteCommitmentDefinition;
-/**
- * Singleton instances of the DELETE commitment definitions with aliases
- *
- * @private [🪔] Maybe export the commitments through some package
- */
-export declare const RemoveCommitment: DeleteCommitmentDefinition;
 /**
  * Note: [💞] Ignore a discrepancy between file name and entity name
  */

package/esm/typings/src/book-2.0/commitments/FORMAT/FORMAT.d.ts

@@ -28,18 +28,6 @@ export declare class FormatCommitmentDefinition extends BaseCommitmentDefinition
     get documentation(): string;
     applyToAgentModelRequirements(requirements: AgentModelRequirements, content: string): AgentModelRequirements;
 }
-/**
- * Singleton instance of the FORMAT commitment definition
- *
- * @private [🪔] Maybe export the commitments through some package
- */
-export declare const FormatCommitment: FormatCommitmentDefinition;
-/**
- * Singleton instance of the FORMATS commitment definition
- *
- * @private [🪔] Maybe export the commitments through some package
- */
-export declare const FormatsCommitment: FormatCommitmentDefinition;
 /**
  * Note: [💞] Ignore a discrepancy between file name and entity name
  */

package/esm/typings/src/book-2.0/commitments/GOAL/GOAL.d.ts

@@ -28,18 +28,6 @@ export declare class GoalCommitmentDefinition extends BaseCommitmentDefinition<'
     get documentation(): string;
     applyToAgentModelRequirements(requirements: AgentModelRequirements, content: string): AgentModelRequirements;
 }
-/**
- * Singleton instance of the GOAL commitment definition
- *
- * @private [🪔] Maybe export the commitments through some package
- */
-export declare const GoalCommitment: GoalCommitmentDefinition;
-/**
- * Singleton instance of the GOALS commitment definition
- *
- * @private [🪔] Maybe export the commitments through some package
- */
-export declare const GoalsCommitment: GoalCommitmentDefinition;
 /**
  * Note: [💞] Ignore a discrepancy between file name and entity name
  */

package/esm/typings/src/book-2.0/commitments/KNOWLEDGE/KNOWLEDGE.d.ts

@@ -34,12 +34,6 @@ export declare class KnowledgeCommitmentDefinition extends BaseCommitmentDefinit
      */
     private isUrl;
 }
-/**
- * Singleton instance of the KNOWLEDGE commitment definition !!!!
- *
- * @private [🪔] Maybe export the commitments through some package
- */
-export declare const KnowledgeCommitment: KnowledgeCommitmentDefinition;
 /**
  * Note: [💞] Ignore a discrepancy between file name and entity name
  */

package/esm/typings/src/book-2.0/commitments/MEMORY/MEMORY.d.ts

@@ -29,18 +29,6 @@ export declare class MemoryCommitmentDefinition extends BaseCommitmentDefinition
     get documentation(): string;
     applyToAgentModelRequirements(requirements: AgentModelRequirements, content: string): AgentModelRequirements;
 }
-/**
- * Singleton instance of the MEMORY commitment definition
- *
- * @private [🪔] Maybe export the commitments through some package
- */
-export declare const MemoryCommitment: MemoryCommitmentDefinition;
-/**
- * Singleton instance of the MEMORIES commitment definition
- *
- * @private [🪔] Maybe export the commitments through some package
- */
-export declare const MemoriesCommitment: MemoryCommitmentDefinition;
 /**
  * Note: [💞] Ignore a discrepancy between file name and entity name
  */

package/esm/typings/src/book-2.0/commitments/MESSAGE/MESSAGE.d.ts

@@ -30,18 +30,6 @@ export declare class MessageCommitmentDefinition extends BaseCommitmentDefinitio
     get documentation(): string;
     applyToAgentModelRequirements(requirements: AgentModelRequirements, content: string): AgentModelRequirements;
 }
-/**
- * Singleton instance of the MESSAGE commitment definition
- *
- * @private [🪔] Maybe export the commitments through some package
- */
-export declare const MessageCommitment: MessageCommitmentDefinition;
-/**
- * Singleton instance of the MESSAGES commitment definition
- *
- * @private [🪔] Maybe export the commitments through some package
- */
-export declare const MessagesCommitment: MessageCommitmentDefinition;
 /**
  * Note: [💞] Ignore a discrepancy between file name and entity name
  */

package/esm/typings/src/book-2.0/commitments/META/META.d.ts

@@ -51,12 +51,6 @@ export declare class MetaCommitmentDefinition extends BaseCommitmentDefinition<`
      */
     isKnownMetaType(metaType: string): boolean;
 }
-/**
- * Singleton instance of the META commitment definition
- *
- * @private [🪔] Maybe export the commitments through some package
- */
-export declare const MetaCommitment: MetaCommitmentDefinition;
 /**
  * Note: [💞] Ignore a discrepancy between file name and entity name
  */

package/esm/typings/src/book-2.0/commitments/META_IMAGE/META_IMAGE.d.ts

@@ -33,12 +33,6 @@ export declare class MetaImageCommitmentDefinition extends BaseCommitmentDefinit
      */
     extractProfileImageUrl(content: string): string | null;
 }
-/**
- * Singleton instance of the META IMAGE commitment definition
- *
- * @private [🪔] Maybe export the commitments through some package
- */
-export declare const MetaImageCommitment: MetaImageCommitmentDefinition;
 /**
  * Note: [💞] Ignore a discrepancy between file name and entity name
  */

package/esm/typings/src/book-2.0/commitments/META_LINK/META_LINK.d.ts

@@ -45,12 +45,6 @@ export declare class MetaLinkCommitmentDefinition extends BaseCommitmentDefiniti
      */
     isValidUrl(content: string): boolean;
 }
-/**
- * Singleton instance of the META LINK commitment definition
- *
- * @private [🪔] Maybe export the commitments through some package
- */
-export declare const MetaLinkCommitment: MetaLinkCommitmentDefinition;
 /**
  * Note: [💞] Ignore a discrepancy between file name and entity name
  */

package/esm/typings/src/book-2.0/commitments/MODEL/MODEL.d.ts

@@ -49,18 +49,6 @@ export declare class ModelCommitmentDefinition extends BaseCommitmentDefinition<
      */
     private parseLegacyFormat;
 }
-/**
- * Singleton instance of the MODEL commitment definition
- *
- * @private [🪔] Maybe export the commitments through some package
- */
-export declare const ModelCommitment: ModelCommitmentDefinition;
-/**
- * Singleton instance of the MODELS commitment definition
- *
- * @private [🪔] Maybe export the commitments through some package
- */
-export declare const ModelsCommitment: ModelCommitmentDefinition;
 /**
  * Note: [💞] Ignore a discrepancy between file name and entity name
  */

package/esm/typings/src/book-2.0/commitments/NOTE/NOTE.d.ts

@@ -38,30 +38,6 @@ export declare class NoteCommitmentDefinition extends BaseCommitmentDefinition<'
     get documentation(): string;
     applyToAgentModelRequirements(requirements: AgentModelRequirements, content: string): AgentModelRequirements;
 }
-/**
- * Singleton instance of the NOTE commitment definition
- *
- * @private [🪔] Maybe export the commitments through some package
- */
-export declare const NoteCommitment: NoteCommitmentDefinition;
-/**
- * Singleton instance of the NOTES commitment definition
- *
- * @private [🪔] Maybe export the commitments through some package
- */
-export declare const NotesCommitment: NoteCommitmentDefinition;
-/**
- * Singleton instance of the COMMENT commitment definition
- *
- * @private [🪔] Maybe export the commitments through some package
- */
-export declare const CommentCommitment: NoteCommitmentDefinition;
-/**
- * Singleton instance of the NONCE commitment definition
- *
- * @private [🪔] Maybe export the commitments through some package
- */
-export declare const NonceCommitment: NoteCommitmentDefinition;
 /**
  * [💞] Ignore a discrepancy between file name and entity name
  */

package/esm/typings/src/book-2.0/commitments/PERSONA/PERSONA.d.ts

@@ -35,18 +35,6 @@ export declare class PersonaCommitmentDefinition extends BaseCommitmentDefinitio
     get documentation(): string;
     applyToAgentModelRequirements(requirements: AgentModelRequirements, content: string): AgentModelRequirements;
 }
-/**
- * Singleton instance of the PERSONA commitment definition
- *
- * @private [🪔] Maybe export the commitments through some package
- */
-export declare const PersonaCommitment: PersonaCommitmentDefinition;
-/**
- * Singleton instance of the PERSONAE commitment definition
- *
- * @private [🪔] Maybe export the commitments through some package
- */
-export declare const PersonaeCommitment: PersonaCommitmentDefinition;
 /**
  * Note: [💞] Ignore a discrepancy between file name and entity name
  */

package/esm/typings/src/book-2.0/commitments/RULE/RULE.d.ts

@@ -27,18 +27,6 @@ export declare class RuleCommitmentDefinition extends BaseCommitmentDefinition<'
     get documentation(): string;
     applyToAgentModelRequirements(requirements: AgentModelRequirements, content: string): AgentModelRequirements;
 }
-/**
- * Singleton instances of the RULE commitment definitions
- *
- * @private [🪔] Maybe export the commitments through some package
- */
-export declare const RuleCommitment: RuleCommitmentDefinition;
-/**
- * Singleton instances of the RULE commitment definitions
- *
- * @private [🪔] Maybe export the commitments through some package
- */
-export declare const RulesCommitment: RuleCommitmentDefinition;
 /**
  * Note: [💞] Ignore a discrepancy between file name and entity name
  */

package/esm/typings/src/book-2.0/commitments/SAMPLE/SAMPLE.d.ts

@@ -27,18 +27,6 @@ export declare class SampleCommitmentDefinition extends BaseCommitmentDefinition
     get documentation(): string;
     applyToAgentModelRequirements(requirements: AgentModelRequirements, content: string): AgentModelRequirements;
 }
-/**
- * Singleton instances of the SAMPLE commitment definitions
- *
- * @private [🪔] Maybe export the commitments through some package
- */
-export declare const SampleCommitment: SampleCommitmentDefinition;
-/**
- * Singleton instances of the SAMPLE commitment definitions
- *
- * @private [🪔] Maybe export the commitments through some package
- */
-export declare const ExampleCommitment: SampleCommitmentDefinition;
 /**
  * Note: [💞] Ignore a discrepancy between file name and entity name
  */

package/esm/typings/src/book-2.0/commitments/SCENARIO/SCENARIO.d.ts

@@ -29,18 +29,6 @@ export declare class ScenarioCommitmentDefinition extends BaseCommitmentDefiniti
     get documentation(): string;
     applyToAgentModelRequirements(requirements: AgentModelRequirements, content: string): AgentModelRequirements;
 }
-/**
- * Singleton instance of the SCENARIO commitment definition
- *
- * @private [🪔] Maybe export the commitments through some package
- */
-export declare const ScenarioCommitment: ScenarioCommitmentDefinition;
-/**
- * Singleton instance of the SCENARIOS commitment definition
- *
- * @private [🪔] Maybe export the commitments through some package
- */
-export declare const ScenariosCommitment: ScenarioCommitmentDefinition;
 /**
  * Note: [💞] Ignore a discrepancy between file name and entity name
  */

package/esm/typings/src/book-2.0/commitments/STYLE/STYLE.d.ts

@@ -27,18 +27,6 @@ export declare class StyleCommitmentDefinition extends BaseCommitmentDefinition<
     get documentation(): string;
     applyToAgentModelRequirements(requirements: AgentModelRequirements, content: string): AgentModelRequirements;
 }
-/**
- * Singleton instance of the STYLE commitment definition
- *
- * @private [🪔] Maybe export the commitments through some package
- */
-export declare const StyleCommitment: StyleCommitmentDefinition;
-/**
- * Singleton instance of the STYLES commitment definition
- *
- * @private [🪔] Maybe export the commitments through some package
- */
-export declare const StylesCommitment: StyleCommitmentDefinition;
 /**
  * [💞] Ignore a discrepancy between file name and entity name
  */

package/esm/typings/src/book-2.0/commitments/_base/createEmptyAgentModelRequirements.d.ts

@@ -15,5 +15,5 @@ export declare function createEmptyAgentModelRequirements(): AgentModelRequireme
  */
 export declare function createBasicAgentModelRequirements(agentName: string | null): AgentModelRequirements;
 /**
- * TODO: !!! Deduplicate `AgentModelRequirements` and `ModelRequirements` model requirements
+ * TODO: [🐤] Deduplicate `AgentModelRequirements` and `ModelRequirements` model requirements
  */

package/esm/typings/src/book-components/AvatarProfile/AvatarChip/AvatarChip.d.ts

@@ -33,3 +33,6 @@ export type AvatarChipProps = {
  * @public exported from `@promptbook/components`
  */
 export declare function AvatarChip(props: AvatarChipProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * TODO: [☁️] Export component prop types only to `@promptbook/components` (not `@promptbook/types`)
+ */

package/esm/typings/src/book-components/AvatarProfile/AvatarProfile/AvatarProfile.d.ts

@@ -21,3 +21,6 @@ export type AvatarProfileProps = {
  * @public exported from `@promptbook/components`
  */
 export declare function AvatarProfile(props: AvatarProfileProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * TODO: [☁️] Export component prop types only to `@promptbook/components` (not `@promptbook/types`)
+ */

package/esm/typings/src/book-components/BookEditor/BookEditor.d.ts

@@ -53,3 +53,6 @@ export type BookEditorProps = {
  * @public exported from `@promptbook/components`
  */
 export declare function BookEditor(props: BookEditorProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * TODO: [☁️] Export component prop types only to `@promptbook/components` (not `@promptbook/types`)
+ */

package/esm/typings/src/book-components/BookEditor/BookEditorInner.d.ts

@@ -1,19 +1,5 @@
-import { Promisable } from 'type-fest';
-import type { string_book } from '../../book-2.0/agent-source/string_book';
+import { BookEditorProps } from './BookEditor';
 /**
  * @private util of `<BookEditor />`
  */
-export type BookEditorInnerProps = {
-    className?: string;
-    fontClassName?: string;
-    value?: string_book;
-    onChange?(value: string_book): void;
-    onFileUpload?(file: File): Promisable<string>;
-    isVerbose?: boolean;
-    isBorderRadiusDisabled?: boolean;
-    isFooterShown?: boolean;
-};
-/**
- * @private util of `<BookEditor />`
- */
-export declare function BookEditorInner(props: BookEditorInnerProps): import("react/jsx-runtime").JSX.Element;
+export declare function BookEditorInner(props: BookEditorProps): import("react/jsx-runtime").JSX.Element;

package/esm/typings/src/book-components/Chat/Chat/ChatProps.d.ts

@@ -146,3 +146,6 @@ export type ChatProps = {
         url: string;
     }): Promisable<void>;
 };
+/**
+ * TODO: [☁️] Export component prop types only to `@promptbook/components` (not `@promptbook/types`)
+ */ 

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

@@ -1,6 +1,4 @@
-import type { string_date_iso8601 } from '../types/typeAliases';
-import type { string_model_name } from '../types/typeAliases';
-import type { string_prompt } from '../types/typeAliases';
+import type { string_date_iso8601, string_model_name, string_prompt } from '../types/typeAliases';
 import type { TODO_object } from '../utils/organization/TODO_object';
 import type { EmbeddingVector } from './EmbeddingVector';
 import type { Usage } from './Usage';
@@ -44,7 +42,7 @@ export type EmbeddingPromptResult = Omit<CommonPromptResult, 'content'> & {
  */
 export type CommonPromptResult = {
     /**
-     * Exact text response from the model
+     * Text response from the model
      */
     readonly content: string;
     /**

package/esm/typings/src/llm-providers/_multiple/MultipleLlmExecutionTools.d.ts

@@ -1,3 +1,4 @@
+import type { ChatParticipant } from '../../book-components/Chat/types/ChatParticipant';
 import type { AvailableModel } from '../../execution/AvailableModel';
 import type { LlmExecutionTools } from '../../execution/LlmExecutionTools';
 import type { ChatPromptResult, CompletionPromptResult, EmbeddingPromptResult, PromptResult } from '../../execution/PromptResult';
@@ -20,11 +21,7 @@ export declare class MultipleLlmExecutionTools implements LlmExecutionTools {
      */
     constructor(title: string_title & string_markdown_text, ...llmExecutionTools: ReadonlyArray<LlmExecutionTools>);
     get description(): string_markdown;
-    get profile(): {
-        name: string;
-        fullname: string;
-        color: string;
-    };
+    get profile(): ChatParticipant;
     /**
      * Check the configuration of all execution tools
      */

package/esm/typings/src/llm-providers/agent/AgentLlmExecutionTools.d.ts

@@ -5,7 +5,7 @@ import type { AvailableModel } from '../../execution/AvailableModel';
 import type { LlmExecutionTools } from '../../execution/LlmExecutionTools';
 import type { ChatPromptResult } from '../../execution/PromptResult';
 import type { Prompt } from '../../types/Prompt';
-import type { string_markdown, string_markdown_text, string_title } from '../../types/typeAliases';
+import type { string_markdown, string_markdown_text, string_model_name, string_title } from '../../types/typeAliases';
 /**
  * Execution Tools for calling LLM models with a predefined agent "soul"
  * This wraps underlying LLM execution tools and applies agent-specific system prompts and requirements
@@ -42,6 +42,10 @@ export declare class AgentLlmExecutionTools implements LlmExecutionTools {
     get description(): string_markdown;
     get profile(): ChatParticipant | undefined;
     checkConfiguration(): Promisable<void>;
+    /**
+     * Returns a virtual model name representing the agent behavior
+     */
+    get modelName(): string_model_name;
     listModels(): Promisable<ReadonlyArray<AvailableModel>>;
     /**
      * Calls the chat model with agent-specific system prompt and requirements
@@ -50,5 +54,5 @@ export declare class AgentLlmExecutionTools implements LlmExecutionTools {
 }
 /**
  * TODO: [🍚] Implement Destroyable pattern to free resources
- * TODO: !!!! adding parameter substitution support
+ * TODO: [🧠] Adding parameter substitution support (here or should be responsibility of the underlying LLM Tools)
  */

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

@@ -1,11 +1,10 @@
 import Anthropic from '@anthropic-ai/sdk';
+import type { ChatParticipant } from '../../book-components/Chat/types/ChatParticipant';
 import type { AvailableModel } from '../../execution/AvailableModel';
 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 { string_markdown, string_markdown_text, string_title } from '../../types/typeAliases';
 import type { AnthropicClaudeExecutionToolsNonProxiedOptions } from './AnthropicClaudeExecutionToolsOptions';
 /**
  * Execution Tools for calling Anthropic Claude API.
@@ -28,11 +27,7 @@ export declare class AnthropicClaudeExecutionTools implements LlmExecutionTools
     constructor(options?: AnthropicClaudeExecutionToolsNonProxiedOptions);
     get title(): string_title & string_markdown_text;
     get description(): string_markdown;
-    get profile(): {
-        name: string;
-        fullname: string;
-        color: string;
-    };
+    get profile(): ChatParticipant;
     getClient(): Promise<Anthropic>;
     /**
      * Check the `options` passed to `constructor`

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

@@ -1,12 +1,10 @@
 import { OpenAIClient } from '@azure/openai';
+import type { ChatParticipant } from '../../book-components/Chat/types/ChatParticipant';
 import type { AvailableModel } from '../../execution/AvailableModel';
 import type { LlmExecutionTools } from '../../execution/LlmExecutionTools';
-import type { ChatPromptResult } from '../../execution/PromptResult';
-import type { CompletionPromptResult } from '../../execution/PromptResult';
+import type { ChatPromptResult, CompletionPromptResult } 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 { string_markdown, string_markdown_text, string_title } from '../../types/typeAliases';
 import type { AzureOpenAiExecutionToolsOptions } from './AzureOpenAiExecutionToolsOptions';
 /**
  * Execution Tools for calling Azure OpenAI API.
@@ -31,6 +29,7 @@ export declare class AzureOpenAiExecutionTools implements LlmExecutionTools {
     constructor(options: AzureOpenAiExecutionToolsOptions);
     get title(): string_title & string_markdown_text;
     get description(): string_markdown;
+    get profile(): ChatParticipant;
     getClient(): Promise<OpenAIClient>;
     /**
      * Check the `options` passed to `constructor`

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

@@ -1,3 +1,4 @@
+import type { ChatParticipant } from '../../book-components/Chat/types/ChatParticipant';
 import type { AvailableModel } from '../../execution/AvailableModel';
 import type { CommonToolsOptions } from '../../execution/CommonToolsOptions';
 import type { LlmExecutionTools } from '../../execution/LlmExecutionTools';
@@ -14,11 +15,7 @@ export declare class MockedEchoLlmExecutionTools implements LlmExecutionTools {
     constructor(options?: CommonToolsOptions);
     get title(): string_title & string_markdown_text;
     get description(): string_markdown;
-    get profile(): {
-        name: string;
-        fullname: string;
-        color: string;
-    };
+    get profile(): ChatParticipant;
     /**
      * Does nothing, just to implement the interface
      */

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

@@ -1,3 +1,4 @@
+import type { ChatParticipant } from '../../book-components/Chat/types/ChatParticipant';
 import type { AvailableModel } from '../../execution/AvailableModel';
 import type { CommonToolsOptions } from '../../execution/CommonToolsOptions';
 import type { LlmExecutionTools } from '../../execution/LlmExecutionTools';
@@ -14,6 +15,7 @@ export declare class MockedFackedLlmExecutionTools implements LlmExecutionTools
     constructor(options?: CommonToolsOptions);
     get title(): string_title & string_markdown_text;
     get description(): string_markdown;
+    get profile(): ChatParticipant;
     /**
      * Does nothing, just to implement the interface
      */

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

@@ -0,0 +1,4 @@
+export {};
+/**
+ * TODO: [🧠] What should be name of this test "MockedEchoExecutionTools.test.ts" or "createPipelineExecutor.test.ts"
+ */

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

@@ -0,0 +1,5 @@
+export {};
+/**
+ * TODO: [🧠] What should be name of this test "MockedEchoExecutionTools.test.ts" or "createPipelineExecutor.test.ts"
+ * Note: [🤖] For each new model variant consider adding new testing unit like "faked-completion.test.ts", "mocked-chat.test.ts" and "mocked-completion.test.ts"
+ */

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

@@ -0,0 +1,4 @@
+export {};
+/**
+ * TODO: [🧠] What should be name of this test "MockedEchoExecutionTools.test.ts" or "createPipelineExecutor.test.ts"
+ */

package/esm/typings/src/llm-providers/ollama/OllamaExecutionTools.d.ts

@@ -1,9 +1,8 @@
+import type { ChatParticipant } from '../../book-components/Chat/types/ChatParticipant';
 import type { AvailableModel } from '../../execution/AvailableModel';
 import type { LlmExecutionTools } from '../../execution/LlmExecutionTools';
 import type { Usage } from '../../execution/Usage';
-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_markdown, string_markdown_text, string_title } from '../../types/typeAliases';
 import { computeOpenAiUsage } from '../openai/computeOpenAiUsage';
 import { OpenAiCompatibleExecutionTools } from '../openai/OpenAiCompatibleExecutionTools';
 import type { OllamaExecutionToolsOptions } from './OllamaExecutionToolsOptions';
@@ -16,6 +15,7 @@ export declare class OllamaExecutionTools extends OpenAiCompatibleExecutionTools
     constructor(ollamaOptions: OllamaExecutionToolsOptions);
     get title(): string_title & string_markdown_text;
     get description(): string_markdown;
+    get profile(): ChatParticipant;
     /**
      * List all available models (non dynamically)
      *

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

@@ -103,4 +103,5 @@ export declare abstract class OpenAiCompatibleExecutionTools implements LlmExecu
  * TODO: [🛄] Maybe make custom `OpenAiCompatibleError`
  * TODO: [🧠][🈁] Maybe use `isDeterministic` from options
  * TODO: [🧠][🌰] Allow to pass `title` for tracking purposes
+ * TODO: [🧠][🦢] Make reverse adapter from LlmExecutionTools to OpenAI-compatible:
  */

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

@@ -1,8 +1,7 @@
+import type { ChatParticipant } from '../../book-components/Chat/types/ChatParticipant';
 import type { AvailableModel } from '../../execution/AvailableModel';
 import type { LlmExecutionTools } from '../../execution/LlmExecutionTools';
-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_markdown, string_markdown_text, string_title } from '../../types/typeAliases';
 import { computeOpenAiUsage } from './computeOpenAiUsage';
 import { OpenAiCompatibleExecutionTools } from './OpenAiCompatibleExecutionTools';
 /**
@@ -13,11 +12,7 @@ import { OpenAiCompatibleExecutionTools } from './OpenAiCompatibleExecutionTools
 export declare class OpenAiExecutionTools extends OpenAiCompatibleExecutionTools implements LlmExecutionTools {
     get title(): string_title & string_markdown_text;
     get description(): string_markdown;
-    get profile(): {
-        name: string;
-        fullname: string;
-        color: string;
-    };
+    get profile(): ChatParticipant;
     /**
      * List all available models (non dynamically)
      *

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

@@ -1,15 +1,10 @@
+import type { ChatParticipant } from '../../book-components/Chat/types/ChatParticipant';
 import type { AvailableModel } from '../../execution/AvailableModel';
 import type { LlmExecutionTools } from '../../execution/LlmExecutionTools';
-import type { ChatPromptResult } from '../../execution/PromptResult';
-import type { CompletionPromptResult } from '../../execution/PromptResult';
-import type { EmbeddingPromptResult } from '../../execution/PromptResult';
+import type { ChatPromptResult, CompletionPromptResult, EmbeddingPromptResult } from '../../execution/PromptResult';
 import type { RemoteClientOptions } from '../../remote-server/types/RemoteClientOptions';
-import type { ChatPrompt } from '../../types/Prompt';
-import type { CompletionPrompt } from '../../types/Prompt';
-import type { EmbeddingPrompt } 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 { ChatPrompt, CompletionPrompt, EmbeddingPrompt } from '../../types/Prompt';
+import type { string_markdown, string_markdown_text, string_title } from '../../types/typeAliases';
 /**
  * Remote server is a proxy server that uses its execution tools internally and exposes the executor interface externally.
  *
@@ -24,11 +19,7 @@ export declare class RemoteLlmExecutionTools<TCustomOptions = undefined> impleme
     constructor(options: RemoteClientOptions<TCustomOptions>);
     get title(): string_title & string_markdown_text;
     get description(): string_markdown;
-    get profile(): {
-        name: string;
-        fullname: string;
-        color: string;
-    };
+    get profile(): ChatParticipant;
     /**
      * Check the configuration of all execution tools
      */

package/esm/typings/src/scripting/_test/postprocessing.test.d.ts

@@ -0,0 +1 @@
+export {};

package/esm/typings/src/utils/markdown/humanizeAiText.d.ts

@@ -10,5 +10,4 @@ import { string_markdown } from '../../types/typeAliases';
 export declare function humanizeAiText(aiText: string_markdown): string_markdown;
 /**
  * TODO: [🧠] Maybe this should be exported from `@promptbook/utils` not `@promptbook/markdown-utils`
- * TODO: [🅾️] !!! Use this across the project where AI text is involved
  */

package/esm/typings/src/utils/markdown/promptbookifyAiText.d.ts

@@ -2,11 +2,11 @@ import { string_markdown } from '../../types/typeAliases';
 /**
  * Function `promptbookifyAiText` will slightly modify the text so we know it was processed by Promptbook
  *
+ * Note: [🔂] This function is idempotent.
+ *
  * @public exported from `@promptbook/markdown-utils`
  */
 export declare function promptbookifyAiText(text: string_markdown): string_markdown;
 /**
- * TODO: !!!!! Make the function idempotent and add "Note: [🔂] This function is idempotent."
- * TODO: [🅾️]!!! Use this across the project where AI text is involved
  * TODO: [🧠][✌️] Make some Promptbook-native token system
  */

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

@@ -15,7 +15,7 @@ export declare const BOOK_LANGUAGE_VERSION: string_semantic_version;
 export declare const PROMPTBOOK_ENGINE_VERSION: string_promptbook_version;
 /**
  * Represents the version string of the Promptbook engine.
- * It follows semantic versioning (e.g., `0.101.0-19`).
+ * It follows semantic versioning (e.g., `0.101.0-20`).
  *
  * @generated
  */

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@promptbook/utils",
-    "version": "0.101.0-20",
+    "version": "0.101.0-21",
     "description": "Promptbook: Run AI apps in plain human language across multiple models and platforms",
     "private": false,
     "sideEffects": false,

package/umd/index.umd.js

@@ -22,7 +22,7 @@
      * @generated
      * @see https://github.com/webgptorg/promptbook
      */
-    const PROMPTBOOK_ENGINE_VERSION = '0.101.0-20';
+    const PROMPTBOOK_ENGINE_VERSION = '0.101.0-21';
     /**
      * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
      * Note: [💞] Ignore a discrepancy between file name and entity name

package/esm/typings/src/book-components/Chat/examples/ChatMarkdownDemo.d.ts

@@ -1,16 +0,0 @@
-/**
- * Demo component showing Chat with markdown rendering capabilities
- *
- * This example demonstrates various markdown features supported by the Chat component:
- * - Headers
- * - Bold and italic text
- * - Code blocks and inline code
- * - Lists (ordered and unordered)
- * - Links
- * - Blockquotes
- * - Tables
- * - Strikethrough text
- *
- * @private temporary for testing purposes
- */
-export declare function ChatMarkdownDemo(): import("react/jsx-runtime").JSX.Element;

package/esm/typings/src/expectations/drafts/isDomainNameFree.d.ts

@@ -1,10 +0,0 @@
-import type { PromptbookFetch } from '../../execution/PromptbookFetch';
-import type { string_name } from '../../types/typeAliases';
-/**
- * @private still in development
- */
-export declare function isDomainNameFree(name: string_name, fetch: PromptbookFetch): Promise<boolean>;
-/**
- * TODO: [🍓][🧠] Test and implement `isDomainNameFree`
- * TODO: Export via some (and probably new) NPM package
- */

package/esm/typings/src/expectations/drafts/isGithubNameFree.d.ts

@@ -1,10 +0,0 @@
-import type { PromptbookFetch } from '../../execution/PromptbookFetch';
-import type { string_name } from '../../types/typeAliases';
-/**
- * @private still in development
- */
-export declare function isGithubNameFree(name: string_name, fetch: PromptbookFetch): Promise<boolean>;
-/**
- * TODO: [🍓][🧠] Test and implement `isGithubNameFree`
- * TODO: Export via some (and probably new) NPM package
- */

package/esm/typings/src/llm-providers/_common/profiles/llmProviderProfiles.d.ts

@@ -1,81 +0,0 @@
-import type { ChatParticipant } from '../../../book-components/Chat/types/ChatParticipant';
-/**
- * Predefined profiles for LLM providers to maintain consistency across the application
- * These profiles represent each provider as a virtual persona in chat interfaces
- *
- * @private !!!!
- */
-export declare const LLM_PROVIDER_PROFILES: {
-    readonly OPENAI: {
-        name: string;
-        fullname: string;
-        color: string;
-    };
-    readonly ANTHROPIC: {
-        name: string;
-        fullname: string;
-        color: string;
-    };
-    readonly AZURE_OPENAI: {
-        name: string;
-        fullname: string;
-        color: string;
-    };
-    readonly GOOGLE: {
-        name: string;
-        fullname: string;
-        color: string;
-    };
-    readonly DEEPSEEK: {
-        name: string;
-        fullname: string;
-        color: string;
-    };
-    readonly OLLAMA: {
-        name: string;
-        fullname: string;
-        color: string;
-    };
-    readonly REMOTE: {
-        name: string;
-        fullname: string;
-        color: string;
-    };
-    readonly MOCKED_ECHO: {
-        name: string;
-        fullname: string;
-        color: string;
-    };
-    readonly MOCKED_FAKE: {
-        name: string;
-        fullname: string;
-        color: string;
-    };
-    readonly VERCEL: {
-        name: string;
-        fullname: string;
-        color: string;
-    };
-    readonly MULTIPLE: {
-        name: string;
-        fullname: string;
-        color: string;
-    };
-};
-/**
- * Helper function to get a profile by provider name with fallback
- *
- * @private !!!!
- */
-export declare function getLlmProviderProfile(providerKey: keyof typeof LLM_PROVIDER_PROFILES): ChatParticipant;
-/**
- * Creates a custom profile based on a provider profile but with custom properties
- *
- * @private !!!!
- */
-export declare function createCustomLlmProfile(baseProfile: ChatParticipant, overrides: Partial<ChatParticipant>): ChatParticipant;
-/**
- * TODO: Refactor this - each profile must be alongside the provider definition
- * TODO: [🕛] Unite `AgentBasicInformation`, `ChatParticipant`, `LlmExecutionTools` +  `LlmToolsMetadata`
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */