@promptbook/cli 0.103.0-52 → 0.103.0-53

package/esm/typings/servers.d.ts

@@ -28,8 +28,15 @@ type ServerConfiguration = {
  * @public exported from `@promptbook/core`
  */
 export declare const REMOTE_SERVER_URLS: Array<ServerConfiguration>;
+/**
+ * Remote servers that are auto-federated by the Agents Server.
+ *
+ * These servers are always added in addition to the `FEDERATED_SERVERS` metadata.
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare const AUTO_FEDERATED_AGENT_SERVER_URLS: Array<string_promptbook_server_url>;
 export {};
 /**
- * TODO: [🐱‍🚀] Auto-federated server from url in here
  * Note: [💞] Ignore a discrepancy between file name and entity name
  */

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

@@ -45,6 +45,7 @@ import type { MessageButton } from '../book-components/Chat/utils/parseMessageBu
 import { parseMessageButtons } from '../book-components/Chat/utils/parseMessageButtons';
 import { ArrowIcon } from '../book-components/icons/ArrowIcon';
 import { AttachmentIcon } from '../book-components/icons/AttachmentIcon';
+import { MicIcon } from '../book-components/icons/MicIcon';
 import { PauseIcon } from '../book-components/icons/PauseIcon';
 import { PlayIcon } from '../book-components/icons/PlayIcon';
 import { ResetIcon } from '../book-components/icons/ResetIcon';
@@ -104,6 +105,7 @@ export type { MessageButton };
 export { parseMessageButtons };
 export { ArrowIcon };
 export { AttachmentIcon };
+export { MicIcon };
 export { PauseIcon };
 export { PlayIcon };
 export { ResetIcon };

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

@@ -25,6 +25,8 @@ import { getCommitmentDefinition } from '../commitments/index';
 import { getAllCommitmentDefinitions } from '../commitments/index';
 import { getAllCommitmentTypes } from '../commitments/index';
 import { isCommitmentSupported } from '../commitments/index';
+import type { GroupedCommitmentDefinition } from '../commitments/index';
+import { getGroupedCommitmentDefinitions } from '../commitments/index';
 import { NAME } from '../config';
 import { ADMIN_EMAIL } from '../config';
 import { ADMIN_GITHUB_NAME } from '../config';
@@ -190,6 +192,7 @@ import { TaskTypes } from '../types/TaskType';
 import { aboutPromptbookInformation } from '../utils/misc/aboutPromptbookInformation';
 import { $generateBookBoilerplate } from '../utils/random/$generateBookBoilerplate';
 import { REMOTE_SERVER_URLS } from '../../servers';
+import { AUTO_FEDERATED_AGENT_SERVER_URLS } from '../../servers';
 export { BOOK_LANGUAGE_VERSION, PROMPTBOOK_ENGINE_VERSION };
 export { computeAgentHash };
 export { createAgentModelRequirements };
@@ -217,6 +220,8 @@ export { getCommitmentDefinition };
 export { getAllCommitmentDefinitions };
 export { getAllCommitmentTypes };
 export { isCommitmentSupported };
+export type { GroupedCommitmentDefinition };
+export { getGroupedCommitmentDefinitions };
 export { NAME };
 export { ADMIN_EMAIL };
 export { ADMIN_GITHUB_NAME };
@@ -382,3 +387,4 @@ export { TaskTypes };
 export { aboutPromptbookInformation };
 export { $generateBookBoilerplate };
 export { REMOTE_SERVER_URLS };
+export { AUTO_FEDERATED_AGENT_SERVER_URLS };

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

@@ -57,6 +57,7 @@ import type { InstrumentCommand } from '../commands/X_INSTRUMENT/InstrumentComma
 import type { BookCommitment } from '../commitments/_base/BookCommitment';
 import type { CommitmentDefinition } from '../commitments/_base/CommitmentDefinition';
 import type { ParsedCommitment } from '../commitments/_base/ParsedCommitment';
+import type { GroupedCommitmentDefinition } from '../commitments/index';
 import type { PrettifyOptions } from '../conversion/prettify/PrettifyOptions';
 import type { renderPipelineMermaidOptions } from '../conversion/prettify/renderPipelineMermaidOptions';
 import type { CallbackInterfaceToolsOptions } from '../dialogs/callback/CallbackInterfaceToolsOptions';
@@ -414,6 +415,7 @@ export type { InstrumentCommand };
 export type { BookCommitment };
 export type { CommitmentDefinition };
 export type { ParsedCommitment };
+export type { GroupedCommitmentDefinition };
 export type { PrettifyOptions };
 export type { renderPipelineMermaidOptions };
 export type { CallbackInterfaceToolsOptions };

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

@@ -40,6 +40,7 @@ import { nameToUriPart } from '../utils/normalization/nameToUriPart';
 import { nameToUriParts } from '../utils/normalization/nameToUriParts';
 import type { string_kebab_case } from '../utils/normalization/normalize-to-kebab-case';
 import { normalizeToKebabCase } from '../utils/normalization/normalize-to-kebab-case';
+import { normalizeMessageText } from '../utils/normalization/normalizeMessageText';
 import type { string_camelCase } from '../utils/normalization/normalizeTo_camelCase';
 import { normalizeTo_camelCase } from '../utils/normalization/normalizeTo_camelCase';
 import type { string_PascalCase } from '../utils/normalization/normalizeTo_PascalCase';
@@ -127,6 +128,7 @@ export { nameToUriPart };
 export { nameToUriParts };
 export type { string_kebab_case };
 export { normalizeToKebabCase };
+export { normalizeMessageText };
 export type { string_camelCase };
 export { normalizeTo_camelCase };
 export type { string_PascalCase };

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

@@ -22,6 +22,13 @@ export type AgentModelRequirements = {
      * Optional list of knowledge source links that the agent can use
      */
     readonly knowledgeSources?: ReadonlyArray<string_knowledge_source_link>;
+    /**
+     * List of sample conversations (question/answer pairs)
+     */
+    readonly samples?: ReadonlyArray<{
+        question: string;
+        answer: string;
+    }>;
     /**
      * Temperature for the agent's responses, controlling randomness
      */

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

@@ -44,6 +44,10 @@ export type ChatProps = {
      * Determines whether the voice recognition button is rendered
      */
     readonly isVoiceRecognitionButtonShown?: boolean;
+    /**
+     * Optional callback to trigger voice input
+     */
+    onVoiceInput?(): void;
     /**
      * The language code to use for voice recognition
      */

package/esm/typings/src/book-components/_common/HamburgerMenu/HamburgerMenu.d.ts

@@ -0,0 +1,12 @@
+type HamburgerMenuProps = {
+    isOpen: boolean;
+    onClick?: () => void;
+    className?: string;
+};
+/**
+ * @@@
+ *
+ * @private Internal component
+ */
+export declare function HamburgerMenu({ isOpen, onClick, className }: HamburgerMenuProps): import("react/jsx-runtime").JSX.Element;
+export {};

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

@@ -0,0 +1,8 @@
+/**
+ * Shows simple microphone icon
+ *
+ * @public exported from `@promptbook/components`
+ */
+export declare const MicIcon: ({ size }: {
+    size: number;
+}) => import("react/jsx-runtime").JSX.Element;

package/esm/typings/src/collection/agent-collection/constructors/agent-collection-in-supabase/AgentCollectionInSupabase.d.ts

@@ -43,6 +43,23 @@ export declare class AgentCollectionInSupabase {
      * Deletes an agent from the collection
      */
     deleteAgent(agentName: string_agent_name): Promise<void>;
+    /**
+     * List history of an agent
+     */
+    listAgentHistory(agentName: string_agent_name): Promise<ReadonlyArray<{
+        id: number;
+        createdAt: string;
+        agentHash: string;
+        promptbookEngineVersion: string;
+    }>>;
+    /**
+     * List agents that are in history but not in the active agents list
+     */
+    listDeletedAgents(): Promise<ReadonlyArray<string_agent_name>>;
+    /**
+     * Restore an agent from history
+     */
+    restoreAgent(historyId: number): Promise<void>;
     /**
      * Get the Supabase table name with prefix
      *

package/esm/typings/src/commitments/MESSAGE/AgentMessageCommitmentDefinition.d.ts

@@ -0,0 +1,28 @@
+import type { AgentModelRequirements } from '../../book-2.0/agent-source/AgentModelRequirements';
+import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
+/**
+ * AGENT MESSAGE commitment definition
+ *
+ * The AGENT MESSAGE commitment defines a message from the agent in the conversation history.
+ * It is used to pre-fill the chat with a conversation history or to provide few-shot examples.
+ *
+ * Example usage in agent source:
+ *
+ * ```book
+ * AGENT MESSAGE What seems to be the issue?
+ * ```
+ *
+ * @private [🪔] Maybe export the commitments through some package
+ */
+export declare class AgentMessageCommitmentDefinition extends BaseCommitmentDefinition<'AGENT MESSAGE'> {
+    constructor();
+    /**
+     * Short one-line description of AGENT MESSAGE.
+     */
+    get description(): string;
+    /**
+     * Markdown documentation for AGENT MESSAGE commitment.
+     */
+    get documentation(): string;
+    applyToAgentModelRequirements(requirements: AgentModelRequirements, content: string): AgentModelRequirements;
+}

package/esm/typings/src/commitments/MESSAGE/UserMessageCommitmentDefinition.d.ts

@@ -0,0 +1,28 @@
+import type { AgentModelRequirements } from '../../book-2.0/agent-source/AgentModelRequirements';
+import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
+/**
+ * USER MESSAGE commitment definition
+ *
+ * The USER MESSAGE commitment defines a message from the user in the conversation history.
+ * It is used to pre-fill the chat with a conversation history or to provide few-shot examples.
+ *
+ * Example usage in agent source:
+ *
+ * ```book
+ * USER MESSAGE Hello, I have a problem.
+ * ```
+ *
+ * @private [🪔] Maybe export the commitments through some package
+ */
+export declare class UserMessageCommitmentDefinition extends BaseCommitmentDefinition<'USER MESSAGE'> {
+    constructor();
+    /**
+     * Short one-line description of USER MESSAGE.
+     */
+    get description(): string;
+    /**
+     * Markdown documentation for USER MESSAGE commitment.
+     */
+    get documentation(): string;
+    applyToAgentModelRequirements(requirements: AgentModelRequirements, content: string): AgentModelRequirements;
+}

package/esm/typings/src/commitments/index.d.ts

@@ -6,8 +6,10 @@ import { FormatCommitmentDefinition } from './FORMAT/FORMAT';
 import { GoalCommitmentDefinition } from './GOAL/GOAL';
 import { KnowledgeCommitmentDefinition } from './KNOWLEDGE/KNOWLEDGE';
 import { MemoryCommitmentDefinition } from './MEMORY/MEMORY';
+import { AgentMessageCommitmentDefinition } from './MESSAGE/AgentMessageCommitmentDefinition';
 import { InitialMessageCommitmentDefinition } from './MESSAGE/InitialMessageCommitmentDefinition';
 import { MessageCommitmentDefinition } from './MESSAGE/MESSAGE';
+import { UserMessageCommitmentDefinition } from './MESSAGE/UserMessageCommitmentDefinition';
 import { MetaCommitmentDefinition } from './META/META';
 import { MetaColorCommitmentDefinition } from './META_COLOR/META_COLOR';
 import { MetaImageCommitmentDefinition } from './META_IMAGE/META_IMAGE';
@@ -26,7 +28,7 @@ import { NotYetImplementedCommitmentDefinition } from './_base/NotYetImplemented
  *
  * @private Use functions to access commitments instead of this array directly
  */
-export declare const COMMITMENT_REGISTRY: readonly [PersonaCommitmentDefinition, PersonaCommitmentDefinition, KnowledgeCommitmentDefinition, MemoryCommitmentDefinition, MemoryCommitmentDefinition, StyleCommitmentDefinition, StyleCommitmentDefinition, RuleCommitmentDefinition, RuleCommitmentDefinition, SampleCommitmentDefinition, SampleCommitmentDefinition, FormatCommitmentDefinition, FormatCommitmentDefinition, ModelCommitmentDefinition, ModelCommitmentDefinition, ActionCommitmentDefinition, ActionCommitmentDefinition, MetaImageCommitmentDefinition, MetaColorCommitmentDefinition, MetaCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, GoalCommitmentDefinition, GoalCommitmentDefinition, InitialMessageCommitmentDefinition, MessageCommitmentDefinition, MessageCommitmentDefinition, ScenarioCommitmentDefinition, ScenarioCommitmentDefinition, DeleteCommitmentDefinition, DeleteCommitmentDefinition, DeleteCommitmentDefinition, DeleteCommitmentDefinition, NotYetImplementedCommitmentDefinition<"EXPECT">, NotYetImplementedCommitmentDefinition<"BEHAVIOUR">, NotYetImplementedCommitmentDefinition<"BEHAVIOURS">, NotYetImplementedCommitmentDefinition<"AVOID">, NotYetImplementedCommitmentDefinition<"AVOIDANCE">, 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, MetaImageCommitmentDefinition, MetaColorCommitmentDefinition, MetaCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, GoalCommitmentDefinition, GoalCommitmentDefinition, InitialMessageCommitmentDefinition, UserMessageCommitmentDefinition, AgentMessageCommitmentDefinition, 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
@@ -57,6 +59,23 @@ export declare function getAllCommitmentTypes(): ReadonlyArray<BookCommitment>;
  * @public exported from `@promptbook/core`
  */
 export declare function isCommitmentSupported(type: BookCommitment): boolean;
+/**
+ * Grouped commitment definition
+ *
+ * @public exported from `@promptbook/core`
+ */
+export type GroupedCommitmentDefinition = {
+    primary: CommitmentDefinition;
+    aliases: string[];
+};
+/**
+ * Gets all commitment definitions grouped by their aliases
+ *
+ * @returns Array of grouped commitment definitions
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare function getGroupedCommitmentDefinitions(): ReadonlyArray<GroupedCommitmentDefinition>;
 /**
  * TODO: [🧠] Maybe create through standardized $register
  * Note: [💞] Ignore a discrepancy between file name and entity name

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

@@ -57,6 +57,15 @@ export type LlmExecutionTools = {
      * Calls a chat model with streaming
      */
     callChatModelStream?(prompt: Prompt, onProgress: (chunk: ChatPromptResult) => void): Promise<ChatPromptResult>;
+    /**
+     * Calls a voice chat model
+     */
+    callVoiceChatModel?(audio: Blob, prompt: Prompt): Promise<{
+        text: string;
+        audio: Blob;
+        userMessage?: string;
+        agentMessage?: string;
+    }>;
     /**
      * Calls a completion model
      */

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

@@ -1,4 +1,5 @@
 import type { Promisable } from 'type-fest';
+import type { AgentModelRequirements } from '../../book-2.0/agent-source/AgentModelRequirements';
 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';
@@ -54,7 +55,7 @@ export declare class AgentLlmExecutionTools implements LlmExecutionTools {
     /**
      * Get cached or create agent model requirements
      */
-    private getAgentModelRequirements;
+    protected getAgentModelRequirements(): Promise<AgentModelRequirements>;
     get title(): string_title & string_markdown_text;
     get description(): string_markdown;
     get profile(): ChatParticipant | undefined;

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

@@ -23,6 +23,7 @@ export declare class RemoteAgent extends Agent {
     private agentUrl;
     private _remoteAgentName;
     private _remoteAgentHash;
+    private _isVoiceCallingEnabled;
     private constructor();
     get agentName(): string_agent_name;
     get agentHash(): string_agent_hash;
@@ -31,8 +32,16 @@ export declare class RemoteAgent extends Agent {
      */
     callChatModel(prompt: Prompt): Promise<ChatPromptResult>;
     /**
-     * Calls the agent on agents remote server with streaming
+     * Calls the agent on agents remote server with voice
+     * [✨✷] Only available when voice calling is enabled on the server
+     * Returns undefined if voice calling is disabled
      */
+    get callVoiceChatModel(): ((audio: Blob, prompt: Prompt) => Promise<{
+        text: string;
+        audio: Blob;
+        userMessage?: string;
+        agentMessage?: string;
+    }>) | undefined;
     callChatModelStream(prompt: Prompt, onProgress: (chunk: ChatPromptResult) => void): Promise<ChatPromptResult>;
 }
 /**

package/esm/typings/src/utils/normalization/normalizeMessageText.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Normalizes message text for comparison
+ *
+ * @param text The message text to normalize
+ * @returns The normalized message text
+ *
+ * @public exported from `@promptbook/utils`
+ */
+export declare function normalizeMessageText(text: string): string;

package/esm/typings/src/utils/normalization/normalizeMessageText.test.d.ts

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

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.103.0-51`).
+ * It follows semantic versioning (e.g., `0.103.0-52`).
  *
  * @generated
  */

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@promptbook/cli",
-    "version": "0.103.0-52",
+    "version": "0.103.0-53",
     "description": "Promptbook: Turn your company's scattered knowledge into AI ready books",
     "private": false,
     "sideEffects": false,

package/umd/index.umd.js

@@ -56,12 +56,23 @@
      * @generated
      * @see https://github.com/webgptorg/promptbook
      */
-    const PROMPTBOOK_ENGINE_VERSION = '0.103.0-52';
+    const PROMPTBOOK_ENGINE_VERSION = '0.103.0-53';
     /**
      * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
      * Note: [💞] Ignore a discrepancy between file name and entity name
      */
 
+    /**
+     * Core Promptbook server configuration.
+     *
+     * This server is also used for auto-federation in the Agents Server.
+     */
+    const CORE_SERVER = {
+        title: 'Promptbook Core',
+        description: `Core Promptbook server used for auto-federation`,
+        owner: 'AI Web, LLC <legal@ptbk.io> (https://www.ptbk.io/)',
+        urls: ['https://core.ptbk.io/'],
+    };
     /**
      * Available remote servers for the Promptbook
      *
@@ -83,6 +94,7 @@
             owner: 'AI Web, LLC <legal@ptbk.io> (https://www.ptbk.io/)',
             urls: ['https://s6.ptbk.io/'],
         },
+        CORE_SERVER,
         /*
         Note: Working on older version of Promptbook and not supported anymore
         {
@@ -95,7 +107,6 @@
         */
     ];
     /**
-     * TODO: [🐱‍🚀] Auto-federated server from url in here
      * Note: [💞] Ignore a discrepancy between file name and entity name
      */
 
@@ -20690,12 +20701,15 @@
                             fileStreams.push(file);
                         }
                         else {
+                            /*
+                            TODO: [🐱‍🚀] Resolve problem with browser environment
                             // Assume it's a local file path
                             // Note: This will work in Node.js environment
                             // For browser environments, this would need different handling
                             const fs = await import('fs');
                             const fileStream = fs.createReadStream(source);
                             fileStreams.push(fileStream);
+                            */
                         }
                     }
                     catch (error) {
@@ -20784,12 +20798,15 @@
                             fileStreams.push(file);
                         }
                         else {
+                            /*
+                            TODO: [🐱‍🚀] Resolve problem with browser environment
                             // Assume it's a local file path
                             // Note: This will work in Node.js environment
                             // For browser environments, this would need different handling
                             const fs = await import('fs');
                             const fileStream = fs.createReadStream(source);
                             fileStreams.push(fileStream);
+                            */
                         }
                     }
                     catch (error) {
@@ -23068,6 +23085,77 @@
      * Note: [💞] Ignore a discrepancy between file name and entity name
      */
 
+    /**
+     * AGENT MESSAGE commitment definition
+     *
+     * The AGENT MESSAGE commitment defines a message from the agent in the conversation history.
+     * It is used to pre-fill the chat with a conversation history or to provide few-shot examples.
+     *
+     * Example usage in agent source:
+     *
+     * ```book
+     * AGENT MESSAGE What seems to be the issue?
+     * ```
+     *
+     * @private [🪔] Maybe export the commitments through some package
+     */
+    class AgentMessageCommitmentDefinition extends BaseCommitmentDefinition {
+        constructor() {
+            super('AGENT MESSAGE');
+        }
+        /**
+         * Short one-line description of AGENT MESSAGE.
+         */
+        get description() {
+            return 'Defines a **message from the agent** in the conversation history.';
+        }
+        /**
+         * Markdown documentation for AGENT MESSAGE commitment.
+         */
+        get documentation() {
+            return spaceTrim.spaceTrim(`
+            # ${this.type}
+
+            Defines a message from the agent in the conversation history. This is used to pre-fill the chat with a conversation history or to provide few-shot examples.
+
+            ## Key aspects
+
+            - Represents a message sent by the agent.
+            - Used for setting up conversation context.
+            - Can be used in conjunction with USER MESSAGE.
+
+            ## Examples
+
+            \`\`\`book
+            Conversation History
+
+            USER MESSAGE Hello, I have a problem.
+            AGENT MESSAGE What seems to be the issue?
+            USER MESSAGE My computer is not starting.
+            \`\`\`
+        `);
+        }
+        applyToAgentModelRequirements(requirements, content) {
+            // AGENT MESSAGE is for UI display purposes / conversation history construction
+            // and typically doesn't need to be added to the system prompt or model requirements directly.
+            // It is extracted separately for the chat interface.
+            var _a;
+            const pendingUserMessage = (_a = requirements.metadata) === null || _a === void 0 ? void 0 : _a.pendingUserMessage;
+            if (pendingUserMessage) {
+                const newSample = { question: pendingUserMessage, answer: content };
+                const newSamples = [...(requirements.samples || []), newSample];
+                const newMetadata = { ...requirements.metadata };
+                delete newMetadata.pendingUserMessage;
+                return {
+                    ...requirements,
+                    samples: newSamples,
+                    metadata: newMetadata,
+                };
+            }
+            return requirements;
+        }
+    }
+
     /**
      * INITIAL MESSAGE commitment definition
      *
@@ -23232,6 +23320,67 @@
      * Note: [💞] Ignore a discrepancy between file name and entity name
      */
 
+    /**
+     * USER MESSAGE commitment definition
+     *
+     * The USER MESSAGE commitment defines a message from the user in the conversation history.
+     * It is used to pre-fill the chat with a conversation history or to provide few-shot examples.
+     *
+     * Example usage in agent source:
+     *
+     * ```book
+     * USER MESSAGE Hello, I have a problem.
+     * ```
+     *
+     * @private [🪔] Maybe export the commitments through some package
+     */
+    class UserMessageCommitmentDefinition extends BaseCommitmentDefinition {
+        constructor() {
+            super('USER MESSAGE');
+        }
+        /**
+         * Short one-line description of USER MESSAGE.
+         */
+        get description() {
+            return 'Defines a **message from the user** in the conversation history.';
+        }
+        /**
+         * Markdown documentation for USER MESSAGE commitment.
+         */
+        get documentation() {
+            return spaceTrim.spaceTrim(`
+            # ${this.type}
+
+            Defines a message from the user in the conversation history. This is used to pre-fill the chat with a conversation history or to provide few-shot examples.
+
+            ## Key aspects
+
+            - Represents a message sent by the user.
+            - Used for setting up conversation context.
+            - Can be used in conjunction with AGENT MESSAGE.
+
+            ## Examples
+
+            \`\`\`book
+            Conversation History
+
+            USER MESSAGE Hello, I have a problem.
+            AGENT MESSAGE What seems to be the issue?
+            USER MESSAGE My computer is not starting.
+            \`\`\`
+        `);
+        }
+        applyToAgentModelRequirements(requirements, content) {
+            return {
+                ...requirements,
+                metadata: {
+                    ...requirements.metadata,
+                    pendingUserMessage: content,
+                },
+            };
+        }
+    }
+
     /**
      * META commitment definition
      *
@@ -24445,6 +24594,8 @@
         new GoalCommitmentDefinition('GOAL'),
         new GoalCommitmentDefinition('GOALS'),
         new InitialMessageCommitmentDefinition(),
+        new UserMessageCommitmentDefinition(),
+        new AgentMessageCommitmentDefinition(),
         new MessageCommitmentDefinition('MESSAGE'),
         new MessageCommitmentDefinition('MESSAGES'),
         new ScenarioCommitmentDefinition('SCENARIO'),