@promptbook/editable 0.101.0-8 → 0.101.0

package/esm/typings/src/book-2.0/agent-source/createAgentModelRequirements.d.ts

@@ -1,36 +1,18 @@
+import type { AvailableModel } from '../../execution/AvailableModel';
+import { LlmExecutionTools } from '../../execution/LlmExecutionTools';
 import type { string_model_name } from '../../types/typeAliases';
 import type { AgentModelRequirements } from './AgentModelRequirements';
 import type { string_book } from './string_book';
 /**
  * Creates model requirements for an agent based on its source
- * Results are cached to improve performance for repeated calls with the same agentSource and modelName
  *
  * There are 2 similar functions:
  * - `parseAgentSource` which is a lightweight parser for agent source, it parses basic information and its purpose is to be quick and synchronous. The commitments there are hardcoded.
- * - `createAgentModelRequirements` which is an asynchronous function that creates model requirements it applies each commitment one by one and works asynchronously.
+ * - `createAgentModelRequirements` which is an asynchronous function that creates model requirements it applies each commitment one by one and works asynchronous.
  *
  * @public exported from `@promptbook/core`
  */
-export declare function createAgentModelRequirements(agentSource: string_book, modelName?: string_model_name): Promise<AgentModelRequirements>;
-/**
- * Clears the cache for createAgentModelRequirements
- * Useful when agent sources are updated and cached results should be invalidated
- *
- * @private
- */
-export declare function clearAgentModelRequirementsCache(): void;
-/**
- * Removes cache entries for a specific agent source (all model variants)
- * @param agentSource The agent source to remove from cache
- * @private
- */
-export declare function invalidateAgentModelRequirementsCache(agentSource: string_book): void;
-/**
- * Gets the current cache size (for debugging/monitoring)
- *
- * @private
- */
-export declare function getAgentModelRequirementsCacheSize(): number;
+export declare function createAgentModelRequirements(agentSource: string_book, modelName?: string_model_name, availableModels?: readonly AvailableModel[], llmTools?: LlmExecutionTools): Promise<AgentModelRequirements>;
 /**
  * Extracts MCP servers from agent source
  *

package/esm/typings/src/book-2.0/agent-source/createAgentModelRequirementsWithCommitments.d.ts

@@ -6,31 +6,6 @@ import type { string_book } from './string_book';
  * This function uses a reduce-like pattern where each commitment applies its changes
  * to build the final requirements starting from a basic empty model
  *
- * @private - TODO: [🧠] Maybe should be public?
+ * @public exported from `@promptbook/core`
  */
 export declare function createAgentModelRequirementsWithCommitments(agentSource: string_book, modelName?: string_model_name): Promise<AgentModelRequirements>;
-/**
- * Cached version of createAgentModelRequirementsWithCommitments
- * This maintains the same caching behavior as the original function
- *
- * @private
- */
-export declare function createAgentModelRequirementsWithCommitmentsCached(agentSource: string_book, modelName?: string_model_name): Promise<AgentModelRequirements>;
-/**
- * Clears the cache for createAgentModelRequirementsWithCommitments
- *
- * @private
- */
-export declare function clearAgentModelRequirementsWithCommitmentsCache(): void;
-/**
- * Removes cache entries for a specific agent source
- *
- * @private
- */
-export declare function invalidateAgentModelRequirementsWithCommitmentsCache(agentSource: string_book): void;
-/**
- * Gets the current cache size
- *
- * @private
- */
-export declare function getAgentModelRequirementsWithCommitmentsCacheSize(): number;

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

@@ -15,8 +15,8 @@ import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
  *
  * @private [🪔] Maybe export the commitments through some package
  */
-export declare class ActionCommitmentDefinition extends BaseCommitmentDefinition<'ACTION'> {
-    constructor();
+export declare class ActionCommitmentDefinition extends BaseCommitmentDefinition<'ACTION' | 'ACTIONS'> {
+    constructor(type?: 'ACTION' | 'ACTIONS');
     /**
      * Short one-line description of ACTION.
      */
@@ -27,12 +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;
 /**
  * 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

@@ -16,8 +16,8 @@ import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
  *
  * @private [🪔] Maybe export the commitments through some package
  */
-export declare class FormatCommitmentDefinition extends BaseCommitmentDefinition<'FORMAT'> {
-    constructor();
+export declare class FormatCommitmentDefinition extends BaseCommitmentDefinition<'FORMAT' | 'FORMATS'> {
+    constructor(type?: 'FORMAT' | 'FORMATS');
     /**
      * Short one-line description of FORMAT.
      */
@@ -28,12 +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;
 /**
  * Note: [💞] Ignore a discrepancy between file name and entity name
  */

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

@@ -16,8 +16,8 @@ import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
  *
  * @private [🪔] Maybe export the commitments through some package
  */
-export declare class GoalCommitmentDefinition extends BaseCommitmentDefinition<'GOAL'> {
-    constructor();
+export declare class GoalCommitmentDefinition extends BaseCommitmentDefinition<'GOAL' | 'GOALS'> {
+    constructor(type?: 'GOAL' | 'GOALS');
     /**
      * Short one-line description of GOAL.
      */
@@ -28,12 +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;
 /**
  * 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

@@ -17,8 +17,8 @@ import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
  *
  * @private [🪔] Maybe export the commitments through some package
  */
-export declare class MemoryCommitmentDefinition extends BaseCommitmentDefinition<'MEMORY'> {
-    constructor();
+export declare class MemoryCommitmentDefinition extends BaseCommitmentDefinition<'MEMORY' | 'MEMORIES'> {
+    constructor(type?: 'MEMORY' | 'MEMORIES');
     /**
      * Short one-line description of MEMORY.
      */
@@ -29,12 +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;
 /**
  * Note: [💞] Ignore a discrepancy between file name and entity name
  */

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

@@ -18,8 +18,8 @@ import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
  *
  * @private [🪔] Maybe export the commitments through some package
  */
-export declare class MessageCommitmentDefinition extends BaseCommitmentDefinition<'MESSAGE'> {
-    constructor();
+export declare class MessageCommitmentDefinition extends BaseCommitmentDefinition<'MESSAGE' | 'MESSAGES'> {
+    constructor(type?: 'MESSAGE' | 'MESSAGES');
     /**
      * Short one-line description of MESSAGE.
      */
@@ -30,12 +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;
 /**
  * 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

@@ -4,20 +4,29 @@ import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
  * MODEL commitment definition
  *
  * The MODEL commitment specifies which AI model to use and can also set
- * model-specific parameters like temperature, topP, and topK.
+ * model-specific parameters like temperature, topP, topK, and maxTokens.
  *
- * Example usage in agent source:
+ * Supports multiple syntax variations:
  *
+ * Single-line format:
  * ```book
  * MODEL gpt-4
  * MODEL claude-3-opus temperature=0.3
  * MODEL gpt-3.5-turbo temperature=0.8 topP=0.9
  * ```
  *
+ * Multi-line named parameter format:
+ * ```book
+ * MODEL NAME gpt-4
+ * MODEL TEMPERATURE 0.7
+ * MODEL TOP_P 0.9
+ * MODEL MAX_TOKENS 2048
+ * ```
+ *
  * @private [🪔] Maybe export the commitments through some package
  */
-export declare class ModelCommitmentDefinition extends BaseCommitmentDefinition<'MODEL'> {
-    constructor();
+export declare class ModelCommitmentDefinition extends BaseCommitmentDefinition<'MODEL' | 'MODELS'> {
+    constructor(type?: 'MODEL' | 'MODELS');
     /**
      * Short one-line description of MODEL.
      */
@@ -27,13 +36,19 @@ export declare class ModelCommitmentDefinition extends BaseCommitmentDefinition<
      */
     get documentation(): string;
     applyToAgentModelRequirements(requirements: AgentModelRequirements, content: string): AgentModelRequirements;
+    /**
+     * Check if the first part is a known named parameter
+     */
+    private isNamedParameter;
+    /**
+     * Parse the new named parameter format: "MODEL TEMPERATURE 0.7"
+     */
+    private parseNamedParameter;
+    /**
+     * Parse the legacy format: "MODEL gpt-4 temperature=0.3 topP=0.9"
+     */
+    private parseLegacyFormat;
 }
-/**
- * Singleton instance of the MODEL commitment definition
- *
- * @private [🪔] Maybe export the commitments through some package
- */
-export declare const ModelCommitment: ModelCommitmentDefinition;
 /**
  * Note: [💞] Ignore a discrepancy between file name and entity name
  */

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

@@ -26,8 +26,8 @@ import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
  *
  * @private [🪔] Maybe export the commitments through some package
  */
-export declare class NoteCommitmentDefinition extends BaseCommitmentDefinition<'NOTE'> {
-    constructor();
+export declare class NoteCommitmentDefinition extends BaseCommitmentDefinition<'NOTE' | 'NOTES' | 'COMMENT' | 'NONCE'> {
+    constructor(type?: 'NOTE' | 'NOTES' | 'COMMENT' | 'NONCE');
     /**
      * Short one-line description of NOTE.
      */
@@ -38,12 +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;
 /**
  * [💞] Ignore a discrepancy between file name and entity name
  */

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

@@ -23,8 +23,8 @@ import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
  *
  * @private [🪔] Maybe export the commitments through some package
  */
-export declare class PersonaCommitmentDefinition extends BaseCommitmentDefinition<'PERSONA'> {
-    constructor();
+export declare class PersonaCommitmentDefinition extends BaseCommitmentDefinition<'PERSONA' | 'PERSONAE'> {
+    constructor(type?: 'PERSONA' | 'PERSONAE');
     /**
      * Short one-line description of PERSONA.
      */
@@ -35,12 +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;
 /**
  * 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

@@ -17,8 +17,8 @@ import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
  *
  * @private [🪔] Maybe export the commitments through some package
  */
-export declare class ScenarioCommitmentDefinition extends BaseCommitmentDefinition<'SCENARIO'> {
-    constructor();
+export declare class ScenarioCommitmentDefinition extends BaseCommitmentDefinition<'SCENARIO' | 'SCENARIOS'> {
+    constructor(type?: 'SCENARIO' | 'SCENARIOS');
     /**
      * Short one-line description of SCENARIO.
      */
@@ -29,12 +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;
 /**
  * Note: [💞] Ignore a discrepancy between file name and entity name
  */

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

@@ -15,8 +15,8 @@ import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
  *
  * @private [🪔] Maybe export the commitments through some package
  */
-export declare class StyleCommitmentDefinition extends BaseCommitmentDefinition<'STYLE'> {
-    constructor();
+export declare class StyleCommitmentDefinition extends BaseCommitmentDefinition<'STYLE' | 'STYLES'> {
+    constructor(type?: 'STYLE' | 'STYLES');
     /**
      * Short one-line description of STYLE.
      */
@@ -27,12 +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;
 /**
  * [💞] 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-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`)
+ */