@promptbook/cli 0.113.0-9 → 0.114.0-1

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/cli",
-    "version": "0.113.0-9",
+    "version": "0.114.0-1",
     "description": "Promptbook: Create persistent AI agents that turn your company's scattered knowledge into action",
     "private": false,
     "sideEffects": false,
@@ -151,7 +151,6 @@
         "@modelcontextprotocol/sdk": "1.24.3",
         "@monaco-editor/react": "4.7.0",
         "@node-saml/node-saml": "^5.1.0",
-        "@playwright/test": "^1.58.2",
         "@prisma/studio-core": "0.27.3",
         "@sendgrid/mail": "8.1.6",
         "@sentry/nextjs": "^10.57.0",
@@ -180,9 +179,7 @@
         "monaco-editor": "0.54.0",
         "node-gzip": "1.1.2",
         "nodemailer": "^7.0.13",
-        "pixel-agents": "^1.0.2",
         "qrcode": "1.5.4",
-        "reactflow": "11.11.4",
         "swagger-ui-react": "5.31.2",
         "turndown": "7.2.4",
         "web-push": "^3.6.7",

package/src/_packages/components.index.ts

@@ -74,6 +74,10 @@ import type { ChatParticipant } from '../book-components/Chat/types/ChatParticip
 import type { CitationLabelResolver } from '../book-components/Chat/types/CitationLabelResolver';
 import type { MessageButton } from '../book-components/Chat/utils/parseMessageButtons';
 import { parseMessageButtons } from '../book-components/Chat/utils/parseMessageButtons';
+import type { MarkdownInlineReference } from '../book-components/Chat/utils/renderMarkdown';
+import type { MarkdownInlineReferenceMenuStatus } from '../book-components/Chat/utils/renderMarkdown';
+import type { MarkdownInlineReferenceMenuOption } from '../book-components/Chat/utils/renderMarkdown';
+import type { MarkdownInlineReferenceMenu } from '../book-components/Chat/utils/renderMarkdown';
 import { ArrowIcon } from '../book-components/icons/ArrowIcon';
 import { MicIcon } from '../book-components/icons/MicIcon';
 import { PauseIcon } from '../book-components/icons/PauseIcon';
@@ -165,6 +169,10 @@ export type { ChatParticipant };
 export type { CitationLabelResolver };
 export type { MessageButton };
 export { parseMessageButtons };
+export type { MarkdownInlineReference };
+export type { MarkdownInlineReferenceMenuStatus };
+export type { MarkdownInlineReferenceMenuOption };
+export type { MarkdownInlineReferenceMenu };
 export { ArrowIcon };
 export { MicIcon };
 export { PauseIcon };

package/src/_packages/core.index.ts

@@ -25,6 +25,8 @@ import { parseParameters } from '../book-2.0/agent-source/parseParameters';
 import { isValidBook } from '../book-2.0/agent-source/string_book';
 import { validateBook } from '../book-2.0/agent-source/string_book';
 import { DEFAULT_BOOK } from '../book-2.0/agent-source/string_book';
+import type { BookLanguageDocumentationAgent } from '../book-2.0/book-language-documentation/createStandaloneBookLanguageMarkdown';
+import type { CreateStandaloneBookLanguageMarkdownOptions } from '../book-2.0/book-language-documentation/createStandaloneBookLanguageMarkdown';
 import { createStandaloneBookLanguageMarkdown } from '../book-2.0/book-language-documentation/createStandaloneBookLanguageMarkdown';
 import { generatePlaceholderAgentProfileImageUrl } from '../book-2.0/utils/generatePlaceholderAgentProfileImageUrl';
 import { Book } from '../book-3.0/Book';
@@ -267,6 +269,8 @@ export { parseParameters };
 export { isValidBook };
 export { validateBook };
 export { DEFAULT_BOOK };
+export type { BookLanguageDocumentationAgent };
+export type { CreateStandaloneBookLanguageMarkdownOptions };
 export { createStandaloneBookLanguageMarkdown };
 export { generatePlaceholderAgentProfileImageUrl };
 export { Book };

package/src/_packages/types.index.ts

@@ -8,6 +8,8 @@ import type { AgentModelRequirements } from '../book-2.0/agent-source/AgentModel
 import type { AgentVisibility } from '../book-2.0/agent-source/agentSourceVisibility';
 import type { CreateAgentModelRequirementsOptions } from '../book-2.0/agent-source/CreateAgentModelRequirementsOptions';
 import type { string_book } from '../book-2.0/agent-source/string_book';
+import type { BookLanguageDocumentationAgent } from '../book-2.0/book-language-documentation/createStandaloneBookLanguageMarkdown';
+import type { CreateStandaloneBookLanguageMarkdownOptions } from '../book-2.0/book-language-documentation/createStandaloneBookLanguageMarkdown';
 import type { BookNodeAgentSource } from '../book-3.0/BookNodeAgentSource';
 import type { BookNodeAgentSourceOptions } from '../book-3.0/BookNodeAgentSource';
 import type { CliAgentHarness } from '../book-3.0/CliAgent';
@@ -62,6 +64,10 @@ import type { ChatParticipant } from '../book-components/Chat/types/ChatParticip
 import type { CitationLabelResolver } from '../book-components/Chat/types/CitationLabelResolver';
 import type { ParsedCitation } from '../book-components/Chat/utils/parseCitationsFromContent';
 import type { MessageButton } from '../book-components/Chat/utils/parseMessageButtons';
+import type { MarkdownInlineReference } from '../book-components/Chat/utils/renderMarkdown';
+import type { MarkdownInlineReferenceMenuStatus } from '../book-components/Chat/utils/renderMarkdown';
+import type { MarkdownInlineReferenceMenuOption } from '../book-components/Chat/utils/renderMarkdown';
+import type { MarkdownInlineReferenceMenu } from '../book-components/Chat/utils/renderMarkdown';
 import type { TeamToolResult } from '../book-components/Chat/utils/toolCallParsing/TeamToolResult';
 import type { QrCodeOptions } from '../book-components/Qr/useQrCode';
 import type { AgentCollection } from '../collection/agent-collection/AgentCollection';
@@ -453,6 +459,8 @@ export type { AgentModelRequirements };
 export type { AgentVisibility };
 export type { CreateAgentModelRequirementsOptions };
 export type { string_book };
+export type { BookLanguageDocumentationAgent };
+export type { CreateStandaloneBookLanguageMarkdownOptions };
 export type { BookNodeAgentSource };
 export type { BookNodeAgentSourceOptions };
 export type { CliAgentHarness };
@@ -507,6 +515,10 @@ export type { ChatParticipant };
 export type { CitationLabelResolver };
 export type { ParsedCitation };
 export type { MessageButton };
+export type { MarkdownInlineReference };
+export type { MarkdownInlineReferenceMenuStatus };
+export type { MarkdownInlineReferenceMenuOption };
+export type { MarkdownInlineReferenceMenu };
 export type { TeamToolResult };
 export type { QrCodeOptions };
 export type { AgentCollection };

package/src/avatars/Avatar.tsx

@@ -2,8 +2,19 @@
 
 import { useEffect, useMemo, useRef, useState } from 'react';
 import { retainAvatarAnimationListener } from './avatarAnimationScheduler';
-import { createAvatarDefinitionKey, createAvatarInteractionRuntimeState, createIdleAvatarInteractionState, resolveAvatarPointerTarget, stepAvatarInteractionRuntimeState } from './avatarInteractionUtils';
-import { getAvatarPointerSnapshot, getAvatarPointerSnapshotVersion, getAvatarViewportLayoutVersion, retainAvatarPointerTracking } from './avatarPointerTracking';
+import {
+    createAvatarDefinitionKey,
+    createAvatarInteractionRuntimeState,
+    createIdleAvatarInteractionState,
+    resolveAvatarPointerTarget,
+    stepAvatarInteractionRuntimeState,
+} from './avatarInteractionUtils';
+import {
+    getAvatarPointerSnapshot,
+    getAvatarPointerSnapshotVersion,
+    getAvatarViewportLayoutVersion,
+    retainAvatarPointerTracking,
+} from './avatarPointerTracking';
 import { DEFAULT_AVATAR_SIZE } from './avatarRenderingUtils';
 import { observeAvatarVisibility } from './avatarVisibilityTracking';
 import { renderAvatarVisual, resolveAvatarRenderDefinition } from './renderAvatarVisual';

package/src/avatars/renderAvatarVisual.ts

@@ -1,7 +1,18 @@
 import { createIdleAvatarInteractionState } from './avatarInteractionUtils';
-import { createAvatarPalette, createAvatarRandomFactory, normalizeAvatarDefinition, prepareAvatarCanvas } from './avatarRenderingUtils';
+import {
+    createAvatarPalette,
+    createAvatarRandomFactory,
+    normalizeAvatarDefinition,
+    prepareAvatarCanvas,
+} from './avatarRenderingUtils';
 import type { AvatarDefinition } from './types/AvatarDefinition';
-import type { AvatarPalette, AvatarSurfaceStyle, AvatarVisualDefinition, AvatarVisualId, RenderAvatarVisualOptions } from './types/AvatarVisualDefinition';
+import type {
+    AvatarPalette,
+    AvatarSurfaceStyle,
+    AvatarVisualDefinition,
+    AvatarVisualId,
+    RenderAvatarVisualOptions,
+} from './types/AvatarVisualDefinition';
 import { getAvatarVisualById } from './visuals/avatarVisualRegistry';
 
 /**

package/src/avatars/visuals/asciiOctopusAvatarVisual.ts

@@ -3,7 +3,12 @@
 import { drawAvatarFrame } from '../avatarRenderingUtils';
 import type { AvatarPalette, AvatarVisualDefinition } from '../types/AvatarVisualDefinition';
 import type { OrganicTentacleRibbonPoint } from './octopusAvatarVisualShared';
-import { createOrganicOctopusBodyPoints, createOrganicOctopusTentacleShapes, resolveOrganicEyeMotion, sampleOrganicTentacleRibbonPoints } from './octopusAvatarVisualShared';
+import {
+    createOrganicOctopusBodyPoints,
+    createOrganicOctopusTentacleShapes,
+    resolveOrganicEyeMotion,
+    sampleOrganicTentacleRibbonPoints,
+} from './octopusAvatarVisualShared';
 
 /**
  * Glyph ramp used for the main octopus body fill.

package/src/avatars/visuals/octopus2AvatarVisual.ts

@@ -2,7 +2,11 @@
 
 import { drawAvatarFrame } from '../avatarRenderingUtils';
 import type { AvatarPalette, AvatarVisualDefinition } from '../types/AvatarVisualDefinition';
-import { createOrganicOctopusBodyPoints, resolveOrganicEyeMotion, traceSmoothClosedPath } from './octopusAvatarVisualShared';
+import {
+    createOrganicOctopusBodyPoints,
+    resolveOrganicEyeMotion,
+    traceSmoothClosedPath,
+} from './octopusAvatarVisualShared';
 
 /**
  * Octopus2 avatar visual.

package/src/avatars/visuals/octopus3AvatarVisual.ts

@@ -3,7 +3,14 @@
 import { drawAvatarFrame } from '../avatarRenderingUtils';
 import type { AvatarPalette, AvatarVisualDefinition } from '../types/AvatarVisualDefinition';
 import type { OrganicTentacleShape } from './octopusAvatarVisualShared';
-import { createOrganicOctopusBodyPoints, createOrganicOctopusTentacleShapes, getCubicBezierPoint, resolveOrganicEyeMotion, sampleOrganicTentacleRibbonPoints, traceSmoothClosedPath } from './octopusAvatarVisualShared';
+import {
+    createOrganicOctopusBodyPoints,
+    createOrganicOctopusTentacleShapes,
+    getCubicBezierPoint,
+    resolveOrganicEyeMotion,
+    sampleOrganicTentacleRibbonPoints,
+    traceSmoothClosedPath,
+} from './octopusAvatarVisualShared';
 
 /**
  * Deterministic morphology knobs that keep `Octopus3` recognizable while widening seeded body, face, and tentacle variety.

package/src/avatars/visuals/octopus3d2AvatarVisual.ts

@@ -3,7 +3,16 @@
 import { drawAvatarFrame } from '../avatarRenderingUtils';
 import type { AvatarPalette, AvatarVisualDefinition } from '../types/AvatarVisualDefinition';
 import type { Point3D, ProjectedPoint } from './avatar3dProjectionShared';
-import { clampNumber, crossProduct3D, dotProduct3D, getProjectedQuadPerimeter, normalizeVector3, projectScenePoint, subtractPoint3D, transformScenePoint } from './avatar3dProjectionShared';
+import {
+    clampNumber,
+    crossProduct3D,
+    dotProduct3D,
+    getProjectedQuadPerimeter,
+    normalizeVector3,
+    projectScenePoint,
+    subtractPoint3D,
+    transformScenePoint,
+} from './avatar3dProjectionShared';
 import type { Octopus3MorphologyProfile } from './octopus3AvatarVisual';
 import { createOctopus3MorphologyProfile } from './octopus3AvatarVisual';
 import { drawProjectedOrganicEye, drawProjectedOrganicMouth, drawProjectedQuad } from './octopus3dAvatarVisualShared';

package/src/avatars/visuals/octopus3d3AvatarVisual.ts

@@ -3,7 +3,16 @@
 import { drawAvatarFrame } from '../avatarRenderingUtils';
 import type { AvatarPalette, AvatarVisualDefinition } from '../types/AvatarVisualDefinition';
 import type { Point3D, ProjectedPoint } from './avatar3dProjectionShared';
-import { clampNumber, crossProduct3D, dotProduct3D, getProjectedQuadPerimeter, normalizeVector3, projectScenePoint, subtractPoint3D, transformScenePoint } from './avatar3dProjectionShared';
+import {
+    clampNumber,
+    crossProduct3D,
+    dotProduct3D,
+    getProjectedQuadPerimeter,
+    normalizeVector3,
+    projectScenePoint,
+    subtractPoint3D,
+    transformScenePoint,
+} from './avatar3dProjectionShared';
 import type { Octopus3MorphologyProfile } from './octopus3AvatarVisual';
 import { createOctopus3MorphologyProfile } from './octopus3AvatarVisual';
 import { drawProjectedOrganicEye, drawProjectedOrganicMouth, drawProjectedQuad } from './octopus3dAvatarVisualShared';

package/src/avatars/visuals/octopus3d4AvatarVisual.ts

@@ -3,7 +3,16 @@
 import { drawAvatarFrame } from '../avatarRenderingUtils';
 import type { AvatarPalette, AvatarVisualDefinition } from '../types/AvatarVisualDefinition';
 import type { Point3D, ProjectedPoint } from './avatar3dProjectionShared';
-import { clampNumber, crossProduct3D, dotProduct3D, getProjectedQuadPerimeter, normalizeVector3, projectScenePoint, subtractPoint3D, transformScenePoint } from './avatar3dProjectionShared';
+import {
+    clampNumber,
+    crossProduct3D,
+    dotProduct3D,
+    getProjectedQuadPerimeter,
+    normalizeVector3,
+    projectScenePoint,
+    subtractPoint3D,
+    transformScenePoint,
+} from './avatar3dProjectionShared';
 import type { Octopus3MorphologyProfile } from './octopus3AvatarVisual';
 import { createOctopus3MorphologyProfile } from './octopus3AvatarVisual';
 import { drawProjectedOrganicEye, drawProjectedOrganicMouth, drawProjectedQuad } from './octopus3dAvatarVisualShared';

package/src/book-2.0/agent-source/AgentBasicInformation.ts

@@ -114,6 +114,14 @@ export type AgentBasicInformation = {
      */
     initialMessage: string | null;
 
+    /**
+     * Optional custom thinking placeholder variants shown while this agent is composing a reply.
+     *
+     * This is derived from `META THINKING MESSAGE` commitments.
+     * Multiple commitments are preserved as multiple variants.
+     */
+    thinkingMessages?: Array<string>;
+
     /**
      * Metadata commitments parsed from META lines
      * Each META commitment has the format "META TYPE content"

package/src/book-2.0/agent-source/parseAgentSource/ParsedAgentProfile.ts

@@ -7,5 +7,5 @@ import type { AgentBasicInformation } from '../AgentBasicInformation';
  */
 export type ParsedAgentProfile = Pick<
     AgentBasicInformation,
-    'meta' | 'links' | 'capabilities' | 'samples' | 'knowledgeSources'
+    'meta' | 'links' | 'capabilities' | 'samples' | 'knowledgeSources' | 'thinkingMessages'
 >;

package/src/book-2.0/agent-source/parseAgentSource/applyMetaCommitment.ts

@@ -23,6 +23,7 @@ const META_COMMITMENT_APPLIERS: Readonly<Record<string, MetaCommitmentApplier |
     'META DESCRIPTION': applyMetaDescriptionContent,
     'META DISCLAIMER': applyMetaDisclaimerContent,
     'META INPUT PLACEHOLDER': applyMetaInputPlaceholderContent,
+    'META THINKING MESSAGE': applyMetaThinkingMessageContent,
     'MESSAGE SUFFIX': applyMessageSuffixContent,
     'META COLOR': applyMetaColorContent,
     'META FONT': applyMetaFontContent,
@@ -129,6 +130,18 @@ function applyMetaInputPlaceholderContent(state: ParseAgentSourceState, content:
     state.meta.inputPlaceholder = spaceTrim(content);
 }
 
+/**
+ * Applies one META THINKING MESSAGE content block into the custom thinking-message variants.
+ */
+function applyMetaThinkingMessageContent(state: ParseAgentSourceState, content: string): void {
+    const thinkingMessage = spaceTrim(content);
+    if (!thinkingMessage) {
+        return;
+    }
+
+    state.thinkingMessages = [...(state.thinkingMessages || []), thinkingMessage];
+}
+
 /**
  * Applies MESSAGE SUFFIX content into the canonical `meta.messageSuffix` field.
  */

package/src/book-2.0/agent-source/parseAgentSource/extractParsedAgentProfile.ts

@@ -17,6 +17,7 @@ export function extractParsedAgentProfile(commitments: ReadonlyArray<ParsedCommi
         capabilities: [],
         samples: [],
         knowledgeSources: [],
+        thinkingMessages: [],
         pendingUserMessage: null,
         knownKnowledgeSourceUrls: new Set<string>(),
     };
@@ -31,6 +32,7 @@ export function extractParsedAgentProfile(commitments: ReadonlyArray<ParsedCommi
         capabilities: state.capabilities,
         samples: state.samples,
         knowledgeSources: state.knowledgeSources,
+        thinkingMessages: state.thinkingMessages,
     };
 }
 

package/src/book-2.0/agent-source/parseAgentSource.ts

@@ -34,6 +34,7 @@ export function parseAgentSource(agentSource: string_book): AgentBasicInformatio
         permanentId: parsedProfile.meta.id,
         personaDescription,
         initialMessage,
+        thinkingMessages: parsedProfile.thinkingMessages,
         meta: parsedProfile.meta,
         links: parsedProfile.links,
         parameters: parseParameters(agentSource),

package/src/book-2.0/book-language-documentation/BookLanguageDocumentationExample.ts

@@ -1,31 +1,20 @@
 /**
  * One end-to-end Book language example used in standalone documentation.
  *
+ * Only the language-neutral Book source lives here. Title, goal, and
+ * walkthrough are translated and therefore kept in
+ * `BookLanguageManualDictionary.exampleTexts`.
+ *
  * @private internal utility of `createStandaloneBookLanguageMarkdown`
  */
 export type BookLanguageDocumentationExample = {
     /**
-     * Stable identifier used for markdown anchors.
+     * Stable identifier used for markdown anchors and translation lookup.
      */
     readonly id: string;
 
-    /**
-     * Human-readable example title.
-     */
-    readonly title: string;
-
-    /**
-     * Goal of the example in one short sentence.
-     */
-    readonly goal: string;
-
     /**
      * Full Book source shown to readers.
      */
     readonly source: string;
-
-    /**
-     * Step-by-step walkthrough of how the source works.
-     */
-    readonly walkthrough: ReadonlyArray<string>;
 };