@promptbook/wizard 0.113.0-9 → 0.114.0-0

package/esm/src/collection/agent-collection/constructors/agent-collection-in-supabase/buildAgentNameOrPermanentIdFilter.test.d.ts

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

package/esm/src/commitments/META/META.d.ts

@@ -11,6 +11,7 @@ import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
  * - META TITLE: Sets the agent's display title
  * - META DESCRIPTION: Sets the agent's description
  * - META INPUT PLACEHOLDER: Sets chat input placeholder text
+ * - META THINKING MESSAGE: Adds custom thinking placeholder variants
  * - META [ANYTHING]: Any other meta information in uppercase format
  *
  * These commitments are special because they don't affect the system message,
@@ -26,6 +27,7 @@ import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
  * META TITLE Professional Assistant
  * META DESCRIPTION An AI assistant specialized in business tasks
  * META INPUT PLACEHOLDER Write a message...
+ * META THINKING MESSAGE Thinking...
  * META AUTHOR John Doe
  * META VERSION 1.0
  * ```

package/esm/src/commitments/META_THINKING_MESSAGE/META_THINKING_MESSAGE.d.ts

@@ -0,0 +1,26 @@
+import type { AgentModelRequirements } from '../../book-2.0/agent-source/AgentModelRequirements';
+import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
+/**
+ * META THINKING MESSAGE commitment definition.
+ *
+ * The `META THINKING MESSAGE` commitment adds one custom thinking placeholder
+ * variant used by chat UIs while an agent is composing a reply.
+ *
+ * @private Metadata-only commitment used by Agents Server chat UIs.
+ */
+export declare class MetaThinkingMessageCommitmentDefinition extends BaseCommitmentDefinition<'META THINKING MESSAGE'> {
+    constructor();
+    /**
+     * Short one-line description of META THINKING MESSAGE.
+     */
+    get description(): string;
+    /**
+     * Icon for this commitment.
+     */
+    get icon(): string;
+    /**
+     * Markdown documentation for META THINKING MESSAGE commitment.
+     */
+    get documentation(): string;
+    applyToAgentModelRequirements(requirements: AgentModelRequirements, content: string): AgentModelRequirements;
+}

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

@@ -25,6 +25,7 @@ import { MetaFontCommitmentDefinition } from './META_FONT/META_FONT';
 import { MetaImageCommitmentDefinition } from './META_IMAGE/META_IMAGE';
 import { MetaInputPlaceholderCommitmentDefinition } from './META_INPUT_PLACEHOLDER/META_INPUT_PLACEHOLDER';
 import { MetaLinkCommitmentDefinition } from './META_LINK/META_LINK';
+import { MetaThinkingMessageCommitmentDefinition } from './META_THINKING_MESSAGE/META_THINKING_MESSAGE';
 import { MetaVisibilityCommitmentDefinition } from './META_VISIBILITY/META_VISIBILITY';
 import { MetaVoiceCommitmentDefinition } from './META_VOICE/META_VOICE';
 import { ModelCommitmentDefinition } from './MODEL/MODEL';
@@ -62,4 +63,4 @@ 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, LanguageCommitmentDefinition, LanguageCommitmentDefinition, WritingSampleCommitmentDefinition, WritingRulesCommitmentDefinition, SampleCommitmentDefinition, SampleCommitmentDefinition, FormatCommitmentDefinition, FormatCommitmentDefinition, TemplateCommitmentDefinition, TemplateCommitmentDefinition, FromCommitmentDefinition, ImportCommitmentDefinition, ImportCommitmentDefinition, ModelCommitmentDefinition, ModelCommitmentDefinition, ActionCommitmentDefinition, ActionCommitmentDefinition, ComponentCommitmentDefinition, MetaAvatarCommitmentDefinition, MetaAvatarCommitmentDefinition, MetaImageCommitmentDefinition, MetaColorCommitmentDefinition, MetaFontCommitmentDefinition, MetaLinkCommitmentDefinition, MetaDomainCommitmentDefinition, MetaDisclaimerCommitmentDefinition, MetaInputPlaceholderCommitmentDefinition, MetaVisibilityCommitmentDefinition, MetaCommitmentDefinition, MetaVoiceCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, GoalCommitmentDefinition, GoalCommitmentDefinition, InitialMessageCommitmentDefinition, UserMessageCommitmentDefinition, InternalMessageCommitmentDefinition, AgentMessageCommitmentDefinition, MessageSuffixCommitmentDefinition, MessageCommitmentDefinition, MessageCommitmentDefinition, WalletCommitmentDefinition, WalletCommitmentDefinition, ScenarioCommitmentDefinition, ScenarioCommitmentDefinition, DeleteCommitmentDefinition, DeleteCommitmentDefinition, DeleteCommitmentDefinition, DeleteCommitmentDefinition, DictionaryCommitmentDefinition, OpenCommitmentDefinition, ClosedCommitmentDefinition, TeamCommitmentDefinition, UseBrowserCommitmentDefinition, UseDeepSearchCommitmentDefinition, UseSearchEngineCommitmentDefinition, UseSpawnCommitmentDefinition, UseTimeoutCommitmentDefinition, UseTimeCommitmentDefinition, UseUserLocationCommitmentDefinition, UseCalendarCommitmentDefinition, UseEmailCommitmentDefinition, UsePopupCommitmentDefinition, UseImageGeneratorCommitmentDefinition, UseMcpCommitmentDefinition, UsePrivacyCommitmentDefinition, UseProjectCommitmentDefinition, 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, LanguageCommitmentDefinition, LanguageCommitmentDefinition, WritingSampleCommitmentDefinition, WritingRulesCommitmentDefinition, SampleCommitmentDefinition, SampleCommitmentDefinition, FormatCommitmentDefinition, FormatCommitmentDefinition, TemplateCommitmentDefinition, TemplateCommitmentDefinition, FromCommitmentDefinition, ImportCommitmentDefinition, ImportCommitmentDefinition, ModelCommitmentDefinition, ModelCommitmentDefinition, ActionCommitmentDefinition, ActionCommitmentDefinition, ComponentCommitmentDefinition, MetaAvatarCommitmentDefinition, MetaAvatarCommitmentDefinition, MetaImageCommitmentDefinition, MetaColorCommitmentDefinition, MetaFontCommitmentDefinition, MetaLinkCommitmentDefinition, MetaDomainCommitmentDefinition, MetaDisclaimerCommitmentDefinition, MetaInputPlaceholderCommitmentDefinition, MetaThinkingMessageCommitmentDefinition, MetaVisibilityCommitmentDefinition, MetaCommitmentDefinition, MetaVoiceCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, GoalCommitmentDefinition, GoalCommitmentDefinition, InitialMessageCommitmentDefinition, UserMessageCommitmentDefinition, InternalMessageCommitmentDefinition, AgentMessageCommitmentDefinition, MessageSuffixCommitmentDefinition, MessageCommitmentDefinition, MessageCommitmentDefinition, WalletCommitmentDefinition, WalletCommitmentDefinition, ScenarioCommitmentDefinition, ScenarioCommitmentDefinition, DeleteCommitmentDefinition, DeleteCommitmentDefinition, DeleteCommitmentDefinition, DeleteCommitmentDefinition, DictionaryCommitmentDefinition, OpenCommitmentDefinition, ClosedCommitmentDefinition, TeamCommitmentDefinition, UseBrowserCommitmentDefinition, UseDeepSearchCommitmentDefinition, UseSearchEngineCommitmentDefinition, UseSpawnCommitmentDefinition, UseTimeoutCommitmentDefinition, UseTimeCommitmentDefinition, UseUserLocationCommitmentDefinition, UseCalendarCommitmentDefinition, UseEmailCommitmentDefinition, UsePopupCommitmentDefinition, UseImageGeneratorCommitmentDefinition, UseMcpCommitmentDefinition, UsePrivacyCommitmentDefinition, UseProjectCommitmentDefinition, NotYetImplementedCommitmentDefinition<"EXPECT">, NotYetImplementedCommitmentDefinition<"BEHAVIOUR">, NotYetImplementedCommitmentDefinition<"BEHAVIOURS">, NotYetImplementedCommitmentDefinition<"AVOID">, NotYetImplementedCommitmentDefinition<"AVOIDANCE">, NotYetImplementedCommitmentDefinition<"CONTEXT">];

package/esm/src/execution/utils/formatUsagePrice.d.ts

@@ -0,0 +1,12 @@
+import type { Usage } from '../Usage';
+/**
+ * Formats usage price for display in prompt status lines and task details.
+ * Examples:
+ * - "$0.12" (certain)
+ * - "~$3.05" (uncertain)
+ * - "$0.00" (zero cost)
+ * - "<$0.01" (tiny non-zero cost)
+ *
+ * @private internal utility of the prompt runners and the Agents Server task details
+ */
+export declare function formatUsagePrice(usage: Usage): string;

package/esm/src/execution/utils/formatUsagePrice.test.d.ts

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

package/esm/src/utils/agent-message-runtime/agentMessageRuntimePaths.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Temporary subdirectory used for agent-message runner shell scripts.
+ *
+ * @private internal constant of agent-message runtime paths
+ */
+export declare const AGENT_MESSAGE_SCRIPT_DIRECTORY_NAME = "agent-messages";
+/**
+ * Builds the temporary shell script path used by one queued agent-message harness run.
+ *
+ * @param projectPath - Local agent project path containing the message queue.
+ * @param sourceFileName - Queued message filename used to name the temporary shell script.
+ * @returns Temporary shell script path.
+ * @private internal utility of agent-message runners
+ */
+export declare function buildAgentMessageScriptPathFromFileName(projectPath: string, sourceFileName: string): string;
+/**
+ * Builds the live runtime log path used by one queued agent-message harness run.
+ *
+ * @param projectPath - Local agent project path containing the message queue.
+ * @param sourceFileName - Queued message filename used to name the temporary shell script.
+ * @returns Temporary live runtime log path.
+ * @private internal utility of agent-message runners
+ */
+export declare function buildAgentMessageRuntimeLogPathFromFileName(projectPath: string, sourceFileName: string): string;

package/esm/src/utils/agent-message-runtime/resolveAgentMessageRuntimeActivity.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Resolves the latest user-friendly activity snippet from a coding-harness runtime log.
+ *
+ * The Agents Server local agent runner streams the answering harness output (for example
+ * Claude Code `--output-format stream-json`) into a live runtime log file next to the queued
+ * message. This helper extracts the most recent natural-language assistant narration so the
+ * durable chat can show what the agent is doing right now instead of a generic thinking
+ * placeholder. Only plain assistant text is surfaced; raw tool payloads, JSON envelopes and
+ * other technical details are intentionally ignored, and harnesses that do not stream
+ * structured text simply resolve to `null` so the caller keeps its existing behavior.
+ *
+ * @param logText - Raw runtime log content.
+ * @returns Latest human-readable activity snippet, or `null` when none can be resolved.
+ * @private internal utility of the agent-message runtime
+ */
+export declare function resolveAgentMessageRuntimeActivity(logText: string | null | undefined): string | null;

package/esm/src/utils/agent-message-runtime/resolveAgentMessageRuntimeActivity.test.d.ts

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

package/esm/src/utils/agents/terminalAgentAvatarVisual.d.ts

@@ -0,0 +1,104 @@
+import type { CreateCanvasForAsciiArt } from '../../avatars/renderAvatarVisualAsciiArt';
+import type { AvatarVisualId } from '../../avatars/types/AvatarVisualDefinition';
+import type { string_book } from '../../book-2.0/agent-source/string_book';
+import type { AsciiArtColorDepth } from '../ascii-art/convertImageDataToAsciiArt';
+/**
+ * Output width of the terminal agent avatar visual in character cells.
+ *
+ * @private shared helper for terminal avatar rendering
+ */
+export declare const TERMINAL_AGENT_AVATAR_VISUAL_COLUMNS = 48;
+/**
+ * Output height of the terminal agent avatar visual in character cells.
+ *
+ * @private shared helper for terminal avatar rendering
+ */
+export declare const TERMINAL_AGENT_AVATAR_VISUAL_ROWS = 12;
+/**
+ * Refresh cadence used while a terminal agent avatar visual is animated.
+ *
+ * @private shared helper for terminal avatar rendering
+ */
+export declare const TERMINAL_AGENT_AVATAR_VISUAL_REFRESH_INTERVAL_MS = 300;
+/**
+ * Centers ANSI-colored terminal avatar lines within one terminal frame.
+ *
+ * @param lines ANSI-colored avatar lines.
+ * @param frameColumns Available frame width in terminal character cells.
+ * @returns Avatar lines with leading terminal spaces added.
+ *
+ * @private shared helper for terminal avatar rendering
+ */
+export declare function centerTerminalAgentAvatarVisualLines(lines: ReadonlyArray<string>, frameColumns: number): ReadonlyArray<string>;
+/**
+ * Options passed when rendering one animated terminal avatar frame.
+ *
+ * @private shared helper for terminal avatar rendering
+ */
+export type TerminalAgentAvatarVisualFrameOptions = {
+    /**
+     * Current animation time forwarded to the shared avatar renderer.
+     */
+    readonly animationTimeMs: number;
+};
+/**
+ * Runtime renderer for an agent avatar visual shown in a terminal.
+ *
+ * @private shared helper for terminal avatar rendering
+ */
+export type TerminalAgentAvatarVisual = {
+    /**
+     * Whether the selected built-in visual changes over time.
+     */
+    readonly isAnimated: boolean;
+    /**
+     * Renders one ANSI ASCII-art frame for the current terminal timestamp.
+     */
+    readonly renderFrame: (options: TerminalAgentAvatarVisualFrameOptions) => ReadonlyArray<string>;
+};
+/**
+ * Options for creating a terminal avatar visual renderer from an agent book source.
+ *
+ * @private shared helper for terminal avatar rendering
+ */
+export type CreateTerminalAgentAvatarVisualOptions = {
+    /**
+     * Source of the agent book whose metadata controls avatar identity.
+     */
+    readonly agentSource: string_book;
+    /**
+     * Built-in avatar visual used when the agent does not declare `META AVATAR` or `META VISUAL`.
+     */
+    readonly defaultAvatarVisualId?: AvatarVisualId;
+    /**
+     * Color depth of the emitted ANSI escape codes.
+     */
+    readonly colorDepth?: AsciiArtColorDepth;
+    /**
+     * Platform-specific canvas factory used to rasterize the visual.
+     */
+    readonly createCanvas: CreateCanvasForAsciiArt;
+};
+/**
+ * Resolves the built-in avatar visual selected for terminal rendering of one agent source.
+ *
+ * @param agentSource Source of the agent book.
+ * @param defaultAvatarVisualId Built-in fallback used when the source does not declare an avatar visual.
+ * @returns Supported built-in avatar visual id.
+ *
+ * @private shared helper for terminal avatar rendering
+ */
+export declare function resolveTerminalAgentAvatarVisualId(agentSource: string_book, defaultAvatarVisualId?: AvatarVisualId): AvatarVisualId;
+/**
+ * Creates an ANSI ASCII-art avatar renderer for terminal UIs.
+ *
+ * The agent's avatar visual is resolved the same way as on the website: `META AVATAR`
+ * / `META VISUAL` wins, then the provided fallback visual, then the shared default visual.
+ * The terminal variant uses a transparent horizontal canvas instead of the website's framed square surface.
+ *
+ * @param options Agent source, canvas factory, and optional terminal color settings.
+ * @returns Runtime terminal avatar visual renderer.
+ *
+ * @private shared helper for terminal avatar rendering
+ */
+export declare function createTerminalAgentAvatarVisual(options: CreateTerminalAgentAvatarVisualOptions): TerminalAgentAvatarVisual;

package/esm/src/utils/agents/terminalAgentAvatarVisual.test.d.ts

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

package/esm/src/utils/html/escapeHtml.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Escapes text so it can be safely inserted into HTML markup or an HTML attribute.
+ *
+ * @param value - Plain text value.
+ * @returns HTML-safe text.
+ *
+ * @private internal utility for building standalone HTML documents
+ */
+export declare function escapeHtml(value: string): string;

package/esm/src/utils/markdown/shiftMarkdownHeadingLevels.d.ts

@@ -0,0 +1,15 @@
+import type { string_markdown } from '../../types/string_markdown';
+/**
+ * Moves every heading of a markdown document deeper into the hierarchy.
+ *
+ * This is needed when an independent markdown document is embedded under an
+ * existing heading, so that the merged document keeps one consistent outline.
+ * Headings inside fenced code blocks are left untouched.
+ *
+ * @param markdown - Markdown document to shift.
+ * @param headingLevelShift - How many levels the headings should move down.
+ * @returns Markdown with shifted headings.
+ *
+ * @private internal utility for composing markdown documents
+ */
+export declare function shiftMarkdownHeadingLevels(markdown: string_markdown, headingLevelShift: number): string_markdown;

package/esm/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.113.0-8`).
+ * It follows semantic versioning (e.g., `0.113.1-0`).
  *
  * @generated
  */

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@promptbook/wizard",
-    "version": "0.113.0-9",
+    "version": "0.114.0-0",
     "description": "Promptbook: Create persistent AI agents that turn your company's scattered knowledge into action",
     "private": false,
     "sideEffects": false,
@@ -99,7 +99,7 @@
     "types": "./esm/src/_packages/wizard.index.d.ts",
     "typings": "./esm/src/_packages/wizard.index.d.ts",
     "peerDependencies": {
-        "@promptbook/core": "0.113.0-9"
+        "@promptbook/core": "0.114.0-0"
     },
     "dependencies": {
         "@ai-sdk/deepseek": "0.1.17",

package/umd/index.umd.js

@@ -52,7 +52,7 @@
      * @generated
      * @see https://github.com/webgptorg/promptbook
      */
-    const PROMPTBOOK_ENGINE_VERSION = '0.113.0-9';
+    const PROMPTBOOK_ENGINE_VERSION = '0.114.0-0';
     /**
      * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
      * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -20779,6 +20779,7 @@
      * - META TITLE: Sets the agent's display title
      * - META DESCRIPTION: Sets the agent's description
      * - META INPUT PLACEHOLDER: Sets chat input placeholder text
+     * - META THINKING MESSAGE: Adds custom thinking placeholder variants
      * - META [ANYTHING]: Any other meta information in uppercase format
      *
      * These commitments are special because they don't affect the system message,
@@ -20794,6 +20795,7 @@
      * META TITLE Professional Assistant
      * META DESCRIPTION An AI assistant specialized in business tasks
      * META INPUT PLACEHOLDER Write a message...
+     * META THINKING MESSAGE Thinking...
      * META AUTHOR John Doe
      * META VERSION 1.0
      * ```
@@ -20834,6 +20836,7 @@
             - **META TITLE** - Sets the agent's display title
             - **META DESCRIPTION** - Sets the agent's description
             - **META INPUT PLACEHOLDER** - Sets chat input placeholder text
+            - **META THINKING MESSAGE** - Adds custom thinking placeholder variants
             - **META [ANYTHING]** - Any other meta information in uppercase format
 
             ## Key aspects
@@ -20842,6 +20845,7 @@
             - Used for visual representation and attribution in user interfaces
             - Multiple META commitments of different types can be used
             - Multiple META LINK commitments can be used for different social profiles
+            - Multiple META THINKING MESSAGE commitments can be used for different thinking placeholder variants
             - If multiple META commitments of the same type are specified, the last one takes precedence (except for LINK)
 
             ## Examples
@@ -27640,6 +27644,68 @@
     }
     // Note: [💞] Ignore a discrepancy between file name and entity name
 
+    /**
+     * META THINKING MESSAGE commitment definition.
+     *
+     * The `META THINKING MESSAGE` commitment adds one custom thinking placeholder
+     * variant used by chat UIs while an agent is composing a reply.
+     *
+     * @private Metadata-only commitment used by Agents Server chat UIs.
+     */
+    class MetaThinkingMessageCommitmentDefinition extends BaseCommitmentDefinition {
+        constructor() {
+            super('META THINKING MESSAGE');
+        }
+        /**
+         * Short one-line description of META THINKING MESSAGE.
+         */
+        get description() {
+            return 'Add a custom thinking placeholder shown while the agent replies.';
+        }
+        /**
+         * Icon for this commitment.
+         */
+        get icon() {
+            return '💭';
+        }
+        /**
+         * Markdown documentation for META THINKING MESSAGE commitment.
+         */
+        get documentation() {
+            return _spaceTrim.spaceTrim(`
+            # META THINKING MESSAGE
+
+            Adds one custom placeholder variant shown while the agent is composing a reply.
+
+            ## Key aspects
+
+            - Does not modify model behavior, system message, or tools.
+            - Multiple \`META THINKING MESSAGE\` commitments define multiple variants.
+            - Chat UIs randomly rotate between the configured variants while the reply is running.
+            - When no non-empty variants are configured, the server-level \`THINKING_MESSAGES\` metadata is used.
+            - Supports multiline markdown content.
+
+            ## Example
+
+            \`\`\`book
+            Helpful Assistant
+
+            META THINKING MESSAGE Thinking...
+            META THINKING MESSAGE Processing...
+            META THINKING MESSAGE
+
+            Doing
+            extra **hard** work
+            \`\`\`
+        `);
+        }
+        applyToAgentModelRequirements(requirements, content) {
+            // META THINKING MESSAGE is metadata only and does not alter model requirements.
+            return requirements;
+        }
+    }
+    // Note: [💞] Ignore a discrepancy between file name and entity name
+
     /**
      * META VISIBILITY commitment definition.
      *
@@ -29718,6 +29784,7 @@
               1. **One-shot URL fetching**: Simple function to fetch and scrape URL content (active)
               2. **Running browser**: For complex tasks like scrolling, clicking, form filling, etc. (runtime-dependent)
             - The actual browser tool usage is handled by the agent runtime
+            - On the Agents Server, every agent browses in its own persistent isolated browser profile, so cookies and logged-in sessions survive across chats (the profile is linked from the agent wallet)
             - Allows the agent to fetch current information from websites and documents
             - Useful for research tasks, fact-checking, and accessing dynamic content
             - Supports various content types including HTML pages and PDF documents
@@ -36215,6 +36282,7 @@
         new MetaDomainCommitmentDefinition(),
         new MetaDisclaimerCommitmentDefinition(),
         new MetaInputPlaceholderCommitmentDefinition(),
+        new MetaThinkingMessageCommitmentDefinition(),
         new MetaVisibilityCommitmentDefinition(),
         new MetaCommitmentDefinition(),
         new MetaVoiceCommitmentDefinition(),
@@ -37566,6 +37634,7 @@
         'META DESCRIPTION': applyMetaDescriptionContent,
         'META DISCLAIMER': applyMetaDisclaimerContent,
         'META INPUT PLACEHOLDER': applyMetaInputPlaceholderContent,
+        'META THINKING MESSAGE': applyMetaThinkingMessageContent,
         'MESSAGE SUFFIX': applyMessageSuffixContent,
         'META COLOR': applyMetaColorContent,
         'META FONT': applyMetaFontContent,
@@ -37656,6 +37725,16 @@
     function applyMetaInputPlaceholderContent(state, content) {
         state.meta.inputPlaceholder = _spaceTrim.spaceTrim(content);
     }
+    /**
+     * Applies one META THINKING MESSAGE content block into the custom thinking-message variants.
+     */
+    function applyMetaThinkingMessageContent(state, content) {
+        const thinkingMessage = _spaceTrim.spaceTrim(content);
+        if (!thinkingMessage) {
+            return;
+        }
+        state.thinkingMessages = [...(state.thinkingMessages || []), thinkingMessage];
+    }
     /**
      * Applies MESSAGE SUFFIX content into the canonical `meta.messageSuffix` field.
      */
@@ -38024,6 +38103,7 @@
             capabilities: [],
             samples: [],
             knowledgeSources: [],
+            thinkingMessages: [],
             pendingUserMessage: null,
             knownKnowledgeSourceUrls: new Set(),
         };
@@ -38036,6 +38116,7 @@
             capabilities: state.capabilities,
             samples: state.samples,
             knowledgeSources: state.knowledgeSources,
+            thinkingMessages: state.thinkingMessages,
         };
     }
     /**
@@ -38075,6 +38156,7 @@
             permanentId: parsedProfile.meta.id,
             personaDescription,
             initialMessage,
+            thinkingMessages: parsedProfile.thinkingMessages,
             meta: parsedProfile.meta,
             links: parsedProfile.links,
             parameters: parseParameters(agentSource),
@@ -41004,7 +41086,7 @@
      *
      * @private within the repository
      */
-    function locateApp(options) {
+    async function locateApp(options) {
         if (!$isRunningInNode()) {
             throw new EnvironmentMismatchError('Locating apps works only in Node.js environment');
         }