@promptbook/wizard 0.101.0-8 → 0.101.0

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

@@ -23,7 +23,7 @@ import { NotYetImplementedCommitmentDefinition } from './_base/NotYetImplemented
  *
  * @private Use functions to access commitments instead of this array directly
  */
-export declare const COMMITMENT_REGISTRY: readonly [PersonaCommitmentDefinition, KnowledgeCommitmentDefinition, MemoryCommitmentDefinition, StyleCommitmentDefinition, RuleCommitmentDefinition, RuleCommitmentDefinition, SampleCommitmentDefinition, SampleCommitmentDefinition, FormatCommitmentDefinition, ModelCommitmentDefinition, ActionCommitmentDefinition, MetaCommitmentDefinition, NoteCommitmentDefinition, GoalCommitmentDefinition, MessageCommitmentDefinition, ScenarioCommitmentDefinition, DeleteCommitmentDefinition, DeleteCommitmentDefinition, DeleteCommitmentDefinition, DeleteCommitmentDefinition, NotYetImplementedCommitmentDefinition<"EXPECT">, NotYetImplementedCommitmentDefinition<"SCENARIOS">, NotYetImplementedCommitmentDefinition<"BEHAVIOUR">, NotYetImplementedCommitmentDefinition<"BEHAVIOURS">, NotYetImplementedCommitmentDefinition<"AVOID">, NotYetImplementedCommitmentDefinition<"AVOIDANCE">, NotYetImplementedCommitmentDefinition<"GOALS">, NotYetImplementedCommitmentDefinition<"CONTEXT">];
+export declare const COMMITMENT_REGISTRY: readonly [PersonaCommitmentDefinition, PersonaCommitmentDefinition, KnowledgeCommitmentDefinition, MemoryCommitmentDefinition, MemoryCommitmentDefinition, StyleCommitmentDefinition, StyleCommitmentDefinition, RuleCommitmentDefinition, RuleCommitmentDefinition, SampleCommitmentDefinition, SampleCommitmentDefinition, FormatCommitmentDefinition, FormatCommitmentDefinition, ModelCommitmentDefinition, ModelCommitmentDefinition, ActionCommitmentDefinition, ActionCommitmentDefinition, MetaCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, GoalCommitmentDefinition, GoalCommitmentDefinition, MessageCommitmentDefinition, MessageCommitmentDefinition, ScenarioCommitmentDefinition, ScenarioCommitmentDefinition, DeleteCommitmentDefinition, DeleteCommitmentDefinition, DeleteCommitmentDefinition, DeleteCommitmentDefinition, NotYetImplementedCommitmentDefinition<"EXPECT">, NotYetImplementedCommitmentDefinition<"BEHAVIOUR">, NotYetImplementedCommitmentDefinition<"BEHAVIOURS">, NotYetImplementedCommitmentDefinition<"AVOID">, NotYetImplementedCommitmentDefinition<"AVOIDANCE">, NotYetImplementedCommitmentDefinition<"CONTEXT">];
 /**
  * Gets a commitment definition by its type
  * @param type The commitment type to look up

package/esm/typings/src/book-2.0/utils/generatePlaceholderAgentProfileImageUrl.d.ts

@@ -8,3 +8,6 @@ import { string_agent_name, string_url_image } from '../../types/typeAliases';
  * @public exported from `@promptbook/core`
  */
 export declare function generatePlaceholderAgentProfileImageUrl(agentName?: string_agent_name): string_url_image;
+/**
+ * TODO: [🤹] Figure out best placeholder image generator https://i.pravatar.cc/1000?u=568
+ */

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

@@ -9,7 +9,7 @@ export type AvatarChipProps = {
     /**
      * Avatar to be shown
      */
-    readonly avatarBasicInformation: AgentBasicInformation;
+    readonly avatarBasicInformation: Omit<AgentBasicInformation, 'parameters'>;
     /**
      * Whether this chip is a template avatar
      */
@@ -21,7 +21,7 @@ export type AvatarChipProps = {
     /**
      * Called when chip is clicked
      */
-    readonly onSelect?: (avatar: AgentBasicInformation) => void;
+    readonly onSelect?: (avatar: Omit<AgentBasicInformation, 'parameters'>) => void;
     /**
      * Whether this chip is selected
      */
@@ -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/AvatarProfile/AvatarProfile/MockedChat.d.ts

@@ -31,11 +31,28 @@ export type MockedChatDelayConfig = {
  *
  * @public exported from `@promptbook/components`
  */
-export type MockedChatProps = ChatProps & {
+export type MockedChatProps = Omit<ChatProps, 'onReset' | /*'onMessage' | */ 'onUseTemplate' | 'isVoiceRecognitionButtonShown'> & {
+    /**
+     * Whether the chat can be reset via the "New chat" button.
+     *
+     * When true (default), the reset button is shown and clicking it restarts the simulated flow.
+     * When false, the reset button is hidden (read-only simulation without manual restart).
+     *
+     * @default true
+     */
+    isResettable?: boolean;
     /**
      * Optional delays configuration for emulating typing behavior
      */
     delayConfig?: MockedChatDelayConfig;
+    /**
+     * When true, shows Pause/Resume control and allows pausing the simulated flow.
+     * Pausing finishes the currently typing message first (transitions via PAUSING state),
+     * then prevents new messages from starting until resumed.
+     *
+     * @default true
+     */
+    isPausable?: boolean;
 };
 /**
  * MockedChat component that shows the same chat as Chat but emulates ongoing discussion

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

@@ -41,6 +41,11 @@ export type BookEditorProps = {
      * If true, disables border radius making the editor have sharp corners
      */
     readonly isBorderRadiusDisabled?: boolean;
+    /**
+     * If true, shows the footer with book title and version information.
+     * By default, the footer is hidden.
+     */
+    readonly isFooterShown?: boolean;
 };
 /**
  * Renders a book editor
@@ -48,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,18 +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;
-};
-/**
- * @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

@@ -66,6 +66,12 @@ export type ChatProps = {
      * If not provided, the chat bar will not be rendered
      */
     readonly children?: ReactNode;
+    /**
+     * Extra action buttons/elements rendered in the actions toolbar
+     * (next to reset / template buttons). Keeps consumers DRY when
+     * adding feature–specific controls (e.g. Pause / Resume in MockedChat).
+     */
+    readonly extraActions?: ReactNode;
     /**
      * Optional CSS class name which will be added to root <div/> element
      */
@@ -140,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/book-components/Chat/LlmChat/LlmChatProps.d.ts

@@ -2,6 +2,7 @@ import type { LlmExecutionTools } from '../../../execution/LlmExecutionTools';
 import type { ChatProps } from '../Chat/ChatProps';
 import type { ChatMessage } from '../types/ChatMessage';
 import type { ChatParticipant } from '../types/ChatParticipant';
+import type { SendMessageToLlmChatFunction } from '../hooks/useSendMessageToLlmChat';
 /**
  * Props for LlmChat component, derived from ChatProps but with LLM-specific modifications
  *
@@ -17,8 +18,20 @@ export type LlmChatProps = Omit<ChatProps, 'messages' | 'onMessage' | 'onChange'
      * When provided, the conversation will be saved and restored from localStorage
      */
     readonly persistenceKey?: string;
+    /**
+     * Optional initial messages to pre-populate the chat.
+     * - They can include both USER and ASSISTANT messages.
+     * - They are only used when there is no persisted conversation (persistence takes precedence).
+     * - They are not automatically persisted until the user sends a new message.
+     */
+    readonly initialMessages?: ReadonlyArray<ChatMessage>;
     /**
      * Called when the chat state changes (messages, participants, etc.)
      */
     onChange?(messages: ReadonlyArray<ChatMessage>, participants: ReadonlyArray<ChatParticipant>): void;
+    /**
+     * Optional external sendMessage function produced by useSendMessageToLlmChat hook.
+     * When provided, LlmChat will attach its internal handler to it (no React context needed).
+     */
+    readonly sendMessage?: SendMessageToLlmChatFunction;
 };

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

@@ -0,0 +1,2 @@
+export * from './useChatAutoScroll';
+export * from './useSendMessageToLlmChat';

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

@@ -0,0 +1,41 @@
+/**
+ * Configuration for the auto-scroll behavior
+ */
+export type ChatAutoScrollConfig = {
+    /**
+     * Threshold in pixels from bottom to consider as "at bottom"
+     * @default 100
+     */
+    bottomThreshold?: number;
+    /**
+     * Whether to use smooth scrolling
+     * @default true
+     */
+    smoothScroll?: boolean;
+    /**
+     * Delay before checking scroll position after new messages (in milliseconds)
+     * @default 100
+     */
+    scrollCheckDelay?: number;
+};
+/**
+ * Hook for managing auto-scroll behavior in chat components
+ *
+ * This hook provides:
+ * - Automatic scrolling to bottom when new messages arrive (if user is already at bottom)
+ * - Detection of when user scrolls away from bottom
+ * - Scroll-to-bottom functionality with smooth animation
+ * - Mobile-optimized scrolling behavior
+ *
+ * @public exported from `@promptbook/components`
+ */
+export declare function useChatAutoScroll(config?: ChatAutoScrollConfig): {
+    isAutoScrolling: boolean;
+    chatMessagesRef: (element: HTMLDivElement | null) => void;
+    handleScroll: (event: React.UIEvent<HTMLDivElement>) => void;
+    handleMessagesChange: () => void;
+    scrollToBottom: () => void;
+    enableAutoScroll: () => void;
+    disableAutoScroll: () => void;
+    isMobile: boolean;
+};

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

@@ -0,0 +1,44 @@
+/**
+ * Function type for sending a message to LlmChat.
+ *
+ * Implementation detail: The returned function is "attachable".
+ * LlmChat will call the internal `_attach` method (if present) to bind
+ * its real message handler. Messages sent before attachment are queued
+ * and flushed after attachment.
+ *
+ * @public exported from `@promptbook/components`
+ */
+export type SendMessageToLlmChatFunction = {
+    /**
+     * Send a message to the bound LlmChat instance (or queue it until attached).
+     */
+    (message: string): void;
+    /**
+     * Internal method used by the <LlmChat/> component to attach its handler.
+     * Not intended for consumer usage.
+     *
+     * @internal
+     */
+    _attach?: (handler: (message: string) => Promise<void> | void) => void;
+};
+/**
+ * Hook to create a sendMessage function for an <LlmChat/> component WITHOUT needing any React Context.
+ *
+ * Usage pattern:
+ * ```tsx
+ * const sendMessage = useSendMessageToLlmChat();
+ * return (
+ *   <>
+ *     <button onClick={() => sendMessage('Hello!')}>Hello</button>
+ *     <LlmChat llmTools={llmTools} sendMessage={sendMessage} />
+ *   </>
+ * );
+ * ```
+ *
+ * - No provider wrapping needed.
+ * - Safe to call before the <LlmChat/> mounts (messages will be queued).
+ * - Keeps DRY by letting <LlmChat/> reuse its internal `handleMessage` logic.
+ *
+ * @public exported from `@promptbook/components`
+ */
+export declare function useSendMessageToLlmChat(): SendMessageToLlmChatFunction;

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

@@ -0,0 +1,22 @@
+/**
+ * Represents a parsed message button from markdown
+ *
+ * @public exported from `@promptbook/components`
+ */
+export type MessageButton = {
+    text: string;
+    message: string;
+};
+/**
+ * Parses markdown buttons in the format [Button Text](?message=Message%20to%20send)
+ * Returns both the content without buttons and the extracted buttons
+ *
+ * @param content The markdown content that may contain buttons
+ * @returns Object with contentWithoutButtons and buttons array
+ *
+ * @public exported from `@promptbook/components`
+ */
+export declare function parseMessageButtons(content: string): {
+    contentWithoutButtons: string;
+    buttons: MessageButton[];
+};

package/esm/typings/src/book-components/icons/PauseIcon.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Pause icon (two vertical bars)
+ *
+ * @public exported from `@promptbook/components`
+ */
+export declare const PauseIcon: ({ size }: {
+    size?: number | undefined;
+}) => import("react/jsx-runtime").JSX.Element;

package/esm/typings/src/book-components/icons/PlayIcon.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Play icon (triangle) used for resume action
+ *
+ * @public exported from `@promptbook/components`
+ */
+export declare const PlayIcon: ({ size }: {
+    size?: number | undefined;
+}) => import("react/jsx-runtime").JSX.Element;

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/execution/createPipelineExecutor/40-executeAttempts.d.ts

@@ -1,8 +1,7 @@
 import type { PartialDeep, Promisable, ReadonlyDeep, WritableDeep } from 'type-fest';
 import type { PipelineJson } from '../../pipeline/PipelineJson/PipelineJson';
 import type { TaskJson } from '../../pipeline/PipelineJson/TaskJson';
-import type { Parameters } from '../../types/typeAliases';
-import type { string_parameter_name } from '../../types/typeAliases';
+import type { Parameters, string_parameter_name } from '../../types/typeAliases';
 import type { TODO_string } from '../../utils/organization/TODO_string';
 import type { ExecutionReportJson } from '../execution-report/ExecutionReportJson';
 import type { PipelineExecutorResult } from '../PipelineExecutorResult';

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

@@ -1,9 +1,7 @@
 import type { ReadonlyDeep } from 'type-fest';
 import type { PipelineJson } from '../../pipeline/PipelineJson/PipelineJson';
 import type { TaskJson } from '../../pipeline/PipelineJson/TaskJson';
-import type { Parameters } from '../../types/typeAliases';
-import type { string_markdown } from '../../types/typeAliases';
-import type { string_parameter_value } from '../../types/typeAliases';
+import type { Parameters, string_markdown, string_parameter_value } from '../../types/typeAliases';
 import type { ExecutionTools } from '../ExecutionTools';
 /**
  * Options for retrieving relevant knowledge for a specific task during pipeline execution.

package/esm/typings/src/formats/csv/CsvFormatError.d.ts

@@ -1,4 +1,4 @@
-import { AbstractFormatError } from "../../errors/AbstractFormatError";
+import { AbstractFormatError } from '../../errors/AbstractFormatError';
 /**
  * This error indicates problem with parsing of CSV
  *

package/esm/typings/src/llm-providers/_common/register/$provideLlmToolsConfigurationFromEnv.d.ts

@@ -16,4 +16,4 @@ import type { LlmToolsConfiguration } from './LlmToolsConfiguration';
 export declare function $provideLlmToolsConfigurationFromEnv(): Promise<LlmToolsConfiguration>;
 /**
  * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
- */ 
+ */

package/esm/typings/src/llm-providers/_common/register/$provideLlmToolsForTestingAndScriptsAndPlayground.d.ts

@@ -24,4 +24,4 @@ export {};
  * TODO: [👷‍♂️] @@@ Manual about construction of llmTools
  * TODO: This should be maybe not under `_common` but under `utils-internal` / `utils/internal`
  * TODO: [®] DRY Register logi
- */ 
+ */

package/esm/typings/src/llm-providers/_common/register/$provideLlmToolsForWizardOrCli.d.ts

@@ -1,7 +1,6 @@
 import { Promisable } from 'type-fest';
 import type { Identification } from '../../../remote-server/socket-types/_subtypes/Identification';
-import type { string_app_id } from '../../../types/typeAliases';
-import type { string_url } from '../../../types/typeAliases';
+import type { string_app_id, string_url } from '../../../types/typeAliases';
 import type { really_any } from '../../../utils/organization/really_any';
 import type { CacheLlmToolsOptions } from '../utils/cache/CacheLlmToolsOptions';
 import type { LlmExecutionToolsWithTotalUsage } from '../utils/count-total-usage/LlmExecutionToolsWithTotalUsage';

package/esm/typings/src/llm-providers/_common/register/createLlmToolsFromConfiguration.d.ts

@@ -1,4 +1,4 @@
-import type { string_user_id } from '../../../types/typeAliases';
+import type { string_markdown_text, string_mime_type_with_wildcard, string_user_id } from '../../../types/typeAliases';
 import { MultipleLlmExecutionTools } from '../../_multiple/MultipleLlmExecutionTools';
 import type { LlmToolsConfiguration } from './LlmToolsConfiguration';
 /**
@@ -7,12 +7,18 @@ import type { LlmToolsConfiguration } from './LlmToolsConfiguration';
  * @private internal type for `$provideLlmToolsFromEnv` and `$provideLlmToolsForTestingAndScriptsAndPlayground`
  */
 export type CreateLlmToolsFromConfigurationOptions = {
+    /**
+     * Title of the LLM tools
+     *
+     * @default 'LLM Tools from Configuration'
+     */
+    readonly title?: string_mime_type_with_wildcard & string_markdown_text;
     /**
      * This will will be passed to the created `LlmExecutionTools`
      *
      * @default false
      */
-    isVerbose?: boolean;
+    readonly isVerbose?: boolean;
     /**
      * Identifier of the end user
      *

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

@@ -0,0 +1,25 @@
+import type { ModelRequirements } from '../../../types/ModelRequirements';
+/**
+ * Parses an OpenAI error message to identify which parameter is unsupported
+ *
+ * @param errorMessage The error message from OpenAI API
+ * @returns The parameter name that is unsupported, or null if not an unsupported parameter error
+ * @private utility of LLM Tools
+ */
+export declare function parseUnsupportedParameterError(errorMessage: string): string | null;
+/**
+ * Creates a copy of model requirements with the specified parameter removed
+ *
+ * @param modelRequirements Original model requirements
+ * @param unsupportedParameter The parameter to remove
+ * @returns New model requirements without the unsupported parameter
+ * @private utility of LLM Tools
+ */
+export declare function removeUnsupportedModelRequirement(modelRequirements: ModelRequirements, unsupportedParameter: string): ModelRequirements;
+/**
+ * Checks if an error is an "Unsupported value" error from OpenAI
+ * @param error The error to check
+ * @returns true if this is an unsupported parameter error
+ * @private utility of LLM Tools
+ */
+export declare function isUnsupportedParameterError(error: Error): boolean;

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

@@ -1,16 +1,9 @@
+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 { PromptResult } from '../../execution/PromptResult';
-import type { ChatPrompt } from '../../types/Prompt';
-import type { CompletionPrompt } from '../../types/Prompt';
-import type { EmbeddingPrompt } from '../../types/Prompt';
-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 { ChatPromptResult, CompletionPromptResult, EmbeddingPromptResult, PromptResult } from '../../execution/PromptResult';
+import type { ChatPrompt, CompletionPrompt, EmbeddingPrompt, Prompt } from '../../types/Prompt';
+import type { string_markdown, string_markdown_text, string_title } from '../../types/typeAliases';
 /**
  * Multiple LLM Execution Tools is a proxy server that uses multiple execution tools internally and exposes the executor interface externally.
  *
@@ -18,6 +11,7 @@ import type { string_title } from '../../types/typeAliases';
  * @public exported from `@promptbook/core`
  */
 export declare class MultipleLlmExecutionTools implements LlmExecutionTools {
+    readonly title: string_title & string_markdown_text;
     /**
      * Array of execution tools in order of priority
      */
@@ -25,14 +19,9 @@ export declare class MultipleLlmExecutionTools implements LlmExecutionTools {
     /**
      * Gets array of execution tools in order of priority
      */
-    constructor(...llmExecutionTools: ReadonlyArray<LlmExecutionTools>);
-    get title(): string_title & string_markdown_text;
+    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/_multiple/getSingleLlmExecutionTools.d.ts

@@ -0,0 +1,11 @@
+import type { LlmExecutionTools } from '../../execution/LlmExecutionTools';
+import { MultipleLlmExecutionTools } from './MultipleLlmExecutionTools';
+/**
+ * Just returns the given `LlmExecutionTools` or joins multiple into one
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare function getSingleLlmExecutionTools(oneOrMoreLlmExecutionTools: undefined | LlmExecutionTools | ReadonlyArray<LlmExecutionTools>): LlmExecutionTools | MultipleLlmExecutionTools;
+/**
+ * TODO: [👷‍♂️] @@@ Manual about construction of llmTools
+ */

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

@@ -1,4 +1,5 @@
 import type { LlmExecutionTools } from '../../execution/LlmExecutionTools';
+import { string_markdown_text, string_title } from '../../types/typeAliases';
 import { MultipleLlmExecutionTools } from './MultipleLlmExecutionTools';
 /**
  * Joins multiple LLM Execution Tools into one
@@ -15,7 +16,7 @@ import { MultipleLlmExecutionTools } from './MultipleLlmExecutionTools';
  *
  * @public exported from `@promptbook/core`
  */
-export declare function joinLlmExecutionTools(...llmExecutionTools: ReadonlyArray<LlmExecutionTools>): MultipleLlmExecutionTools;
+export declare function joinLlmExecutionTools(title: string_title & string_markdown_text, ...llmExecutionTools: ReadonlyArray<LlmExecutionTools>): MultipleLlmExecutionTools;
 /**
  * TODO: [👷‍♂️] @@@ Manual about construction of llmTools
  */

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

@@ -0,0 +1,58 @@
+import type { Promisable } from 'type-fest';
+import type { string_book } from '../../book-2.0/agent-source/string_book';
+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, 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
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare class AgentLlmExecutionTools implements LlmExecutionTools {
+    private readonly llmTools;
+    private readonly agentSource;
+    /**
+     * Cached model requirements to avoid re-parsing the agent source
+     */
+    private _cachedModelRequirements;
+    /**
+     * Cached parsed agent information
+     */
+    private _cachedAgentInfo;
+    /**
+     * Creates new AgentLlmExecutionTools
+     *
+     * @param llmTools The underlying LLM execution tools to wrap
+     * @param agentSource The agent source string that defines the agent's behavior
+     */
+    constructor(llmTools: LlmExecutionTools, agentSource: string_book);
+    /**
+     * Get cached or parse agent information
+     */
+    private getAgentInfo;
+    /**
+     * Get cached or create agent model requirements
+     */
+    private getAgentModelRequirements;
+    get title(): string_title & string_markdown_text;
+    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
+     */
+    callChatModel(prompt: Prompt): Promise<ChatPromptResult>;
+}
+/**
+ * TODO: [🍚] Implement Destroyable pattern to free resources
+ * TODO: [🧠] Adding parameter substitution support (here or should be responsibility of the underlying LLM Tools)
+ */

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

@@ -0,0 +1,29 @@
+import type { string_book } from '../../book-2.0/agent-source/string_book';
+import type { LlmExecutionTools } from '../../execution/LlmExecutionTools';
+import { AgentLlmExecutionTools } from './AgentLlmExecutionTools';
+/**
+ * Options for creating AgentLlmExecutionTools
+ */
+export type CreateAgentLlmExecutionToolsOptions = {
+    /**
+     * The underlying LLM execution tools to wrap
+     */
+    llmTools: LlmExecutionTools;
+    /**
+     * The agent source string that defines the agent's behavior
+     */
+    agentSource: string_book;
+};
+/**
+ * Creates new AgentLlmExecutionTools that wrap underlying LLM tools with agent-specific behavior
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare const createAgentLlmExecutionTools: ((options: CreateAgentLlmExecutionToolsOptions) => AgentLlmExecutionTools) & {
+    packageName: string;
+    className: string;
+};
+/**
+ * TODO: [🧠] Consider adding validation for agent source format
+ * TODO: [🧠] Consider adding options for caching behavior
+ */

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

@@ -0,0 +1,8 @@
+#!/usr/bin/env ts-node
+export {};
+/**
+ * TODO: [🧠] Add more complex agent scenarios
+ * TODO: [🧠] Add parameter substitution demo
+ * TODO: [🧠] Add multi-turn conversation demo
+ * Note: [⚫] Code in this file should never be published in any package
+ */

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

@@ -0,0 +1,11 @@
+/**
+ * Metadata for Agent LLM execution tools
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare const _AgentMetadata: import("../../utils/$Register").Registration;
+/**
+ * TODO: [🧠] Consider adding a special trust level for AgentLlmExecutionTools
+ * TODO: [🎶] Naming "constructor" vs "creator" vs "factory"
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ */

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

@@ -0,0 +1,13 @@
+import type { Registration } from '../../utils/$Register';
+/**
+ * Registration of Agent LLM provider
+ *
+ * Warning: This is not useful for the end user, it is just a side effect of the mechanism that handles all available LLM tools
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare const _AgentRegistration: Registration;
+/**
+ * TODO: [🎶] Naming "constructor" vs "creator" vs "factory"
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ */