@promptbook/remote-client 0.112.0-48 → 0.112.0-50

package/esm/index.es.js

@@ -20,7 +20,7 @@ const BOOK_LANGUAGE_VERSION = '2.0.0';
  * @generated
  * @see https://github.com/webgptorg/promptbook
  */
-const PROMPTBOOK_ENGINE_VERSION = '0.112.0-48';
+const PROMPTBOOK_ENGINE_VERSION = '0.112.0-50';
 /**
  * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
  * Note: [💞] Ignore a discrepancy between file name and entity name

package/esm/src/avatars/avatarAnimationScheduler.d.ts

@@ -0,0 +1,16 @@
+/**
+ * One callback registered in the shared avatar animation scheduler.
+ *
+ * @private utility of the avatar rendering system
+ */
+type AvatarAnimationListener = (now: number) => void;
+/**
+ * Registers one avatar animation callback in the shared animation loop.
+ *
+ * @param avatarAnimationListener Frame callback invoked on every animation frame.
+ * @returns Cleanup function that unregisters the callback.
+ *
+ * @private utility of the avatar rendering system
+ */
+export declare function retainAvatarAnimationListener(avatarAnimationListener: AvatarAnimationListener): () => void;
+export {};

package/esm/src/avatars/avatarPointerTracking.d.ts

@@ -15,3 +15,19 @@ export declare function retainAvatarPointerTracking(): () => void;
  * @private utility of the avatar rendering system
  */
 export declare function getAvatarPointerSnapshot(): AvatarPointerSnapshot | null;
+/**
+ * Returns the current pointer snapshot version.
+ *
+ * @returns Monotonic pointer snapshot version.
+ *
+ * @private utility of the avatar rendering system
+ */
+export declare function getAvatarPointerSnapshotVersion(): number;
+/**
+ * Returns the current viewport-layout version used to invalidate cached avatar bounds.
+ *
+ * @returns Monotonic viewport-layout version.
+ *
+ * @private utility of the avatar rendering system
+ */
+export declare function getAvatarViewportLayoutVersion(): number;

package/esm/src/avatars/avatarVisibilityTracking.d.ts

@@ -0,0 +1,17 @@
+/**
+ * One callback observing the viewport visibility of an avatar canvas.
+ *
+ * @private utility of the avatar rendering system
+ */
+type AvatarVisibilityListener = (isVisible: boolean) => void;
+/**
+ * Observes one avatar element and notifies the caller when it enters or leaves the viewport.
+ *
+ * @param element Observed avatar element.
+ * @param avatarVisibilityListener Listener notified with the current visibility state.
+ * @returns Cleanup function that stops observing the element.
+ *
+ * @private utility of the avatar rendering system
+ */
+export declare function observeAvatarVisibility(element: Element, avatarVisibilityListener: AvatarVisibilityListener): () => void;
+export {};

package/esm/src/avatars/renderAvatarVisual.d.ts

@@ -1,9 +1,37 @@
 import type { RenderAvatarVisualOptions } from './types/AvatarVisualDefinition';
+import type { AvatarDefinition } from './types/AvatarDefinition';
+import type { AvatarPalette, AvatarSurfaceStyle, AvatarVisualDefinition, AvatarVisualId } from './types/AvatarVisualDefinition';
+/**
+ * Stable render data derived once from the avatar definition, surface, and visual id.
+ *
+ * @private shared helper for canvas avatar rendering
+ */
+export type ResolvedAvatarRenderDefinition = {
+    readonly avatarDefinition: AvatarDefinition;
+    readonly avatarVisual: AvatarVisualDefinition;
+    readonly surface: AvatarSurfaceStyle;
+    readonly palette: AvatarPalette;
+    readonly createRandom: (salt: string) => () => number;
+};
+/**
+ * Resolves the stable avatar render inputs reused across multiple frames.
+ *
+ * @param options Avatar identity and visual selection.
+ * @returns Stable render data ready to be used by `renderAvatarVisual`.
+ *
+ * @private shared helper for canvas avatar rendering
+ */
+export declare function resolveAvatarRenderDefinition(options: {
+    readonly avatarDefinition: AvatarDefinition;
+    readonly visualId: AvatarVisualId;
+    readonly surface?: AvatarSurfaceStyle;
+}): ResolvedAvatarRenderDefinition;
 /**
  * Renders one deterministic avatar frame into the provided canvas.
  *
  * @param options Rendering options.
+ * @param resolvedAvatarRenderDefinition Optional stable render data reused between frames.
  *
  * @private shared helper for canvas avatar rendering
  */
-export declare function renderAvatarVisual(options: RenderAvatarVisualOptions): void;
+export declare function renderAvatarVisual(options: RenderAvatarVisualOptions, resolvedAvatarRenderDefinition?: ResolvedAvatarRenderDefinition): void;

package/esm/src/avatars/visuals/octopus3AvatarVisual.d.ts

@@ -1,4 +1,76 @@
 import type { AvatarVisualDefinition } from '../types/AvatarVisualDefinition';
+/**
+ * Deterministic morphology knobs that keep `Octopus3` recognizable while widening seeded body, face, and tentacle variety.
+ *
+ * @private helper of `octopus3AvatarVisual`
+ */
+export type Octopus3MorphologyProfile = {
+    readonly bodyFamily: 'lantern' | 'drifter' | 'rounded';
+    readonly faceFamily: 'watchful' | 'sleepy' | 'mischief';
+    readonly body: {
+        readonly centerXJitterRatio: number;
+        readonly centerYRatio: number;
+        readonly bodyRadiusRatio: number;
+        readonly horizontalStretch: number;
+        readonly verticalStretch: number;
+        readonly mantleLiftRatio: number;
+        readonly lowerDropRatio: number;
+        readonly tentacleDepthRatio: number;
+        readonly wobbleAmplitudeRatio: number;
+        readonly lobeCount: number;
+        readonly pointCount: number;
+        readonly shadowWidthRatio: number;
+        readonly shadowHeightRatio: number;
+        readonly crownHighlightWidthRatio: number;
+        readonly crownHighlightHeightRatio: number;
+        readonly crownHighlightYOffsetRatio: number;
+    };
+    readonly tentacles: {
+        readonly count: number;
+        readonly flowLengthScale: number;
+        readonly lateralReachScale: number;
+        readonly tipReachScale: number;
+        readonly baseWidthScale: number;
+        readonly tipWidthScale: number;
+        readonly rootSpreadScale: number;
+        readonly startYOffsetScale: number;
+        readonly swayScale: number;
+    };
+    readonly face: {
+        readonly eyeSpacingRatio: number;
+        readonly eyeCenterYOffsetRatio: number;
+        readonly eyeRadiusXRatio: number;
+        readonly eyeHeightRatio: number;
+        readonly eyeRotationRange: number;
+        readonly eyeTiltBias: number;
+        readonly mouthWidthRatio: number;
+        readonly mouthYOffsetRatio: number;
+        readonly mouthCurveDepthRatio: number;
+        readonly mouthCenterOffsetRatio: number;
+        readonly mouthCornerTiltRatio: number;
+        readonly eyeStyle: {
+            readonly irisScale: number;
+            readonly pupilWidthScale: number;
+            readonly pupilHeightScale: number;
+            readonly upperLidArchRatio: number;
+            readonly upperLidInsetRatio: number;
+            readonly lowerLidOpacity: number;
+        };
+    };
+    readonly details: {
+        readonly mantleCurrentCount: number;
+        readonly mantleNodeCount: number;
+    };
+};
+/**
+ * Builds one deterministic morphology profile for `Octopus3`.
+ *
+ * @param createRandom Seeded random factory scoped to the current avatar.
+ * @returns Stable morphology profile.
+ *
+ * @private helper of `octopus3AvatarVisual`
+ */
+export declare function createOctopus3MorphologyProfile(createRandom: (salt: string) => () => number): Octopus3MorphologyProfile;
 /**
  * Octopus3 avatar visual.
  *

package/esm/src/avatars/visuals/octopus3AvatarVisual.test.d.ts

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

package/esm/src/avatars/visuals/octopusAvatarVisualShared.d.ts

@@ -61,6 +61,22 @@ type CreateOrganicOctopusTentacleShapesOptions = {
     readonly timeMs: number;
     readonly saltPrefix: string;
     readonly bodyPoints?: ReadonlyArray<Point>;
+    readonly variation?: OrganicTentacleVariationOptions;
+};
+/**
+ * Opt-in shape multipliers that let one visual broaden or tighten the shared tentacle generator.
+ *
+ * @private shared geometry helper of `octopus3AvatarVisual` and `asciiOctopusAvatarVisual`
+ */
+type OrganicTentacleVariationOptions = {
+    readonly flowLengthScale?: number;
+    readonly lateralReachScale?: number;
+    readonly tipReachScale?: number;
+    readonly baseWidthScale?: number;
+    readonly tipWidthScale?: number;
+    readonly rootSpreadScale?: number;
+    readonly startYOffsetScale?: number;
+    readonly swayScale?: number;
 };
 /**
  * One sampled ribbon point on an organic octopus tentacle.

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

@@ -90,6 +90,15 @@ export type BookEditorProps = {
      * Optional CSS style which will be added to root <div/> element
      */
     readonly style?: CSSProperties;
+    /**
+     * Resolved visual theme used for the editor wrapper and Monaco instance.
+     *
+     * Host applications should pass the final light/dark theme instead of relying on
+     * browser media-query inference inside `<BookEditor/>`.
+     *
+     * @default 'LIGHT'
+     */
+    readonly theme?: 'LIGHT' | 'DARK';
     /**
      * Height of the `BookEditor` component
      *

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

@@ -3,11 +3,18 @@ import type { editor } from 'monaco-editor';
  * Type describing monaco editor.
  */
 type MonacoEditor = typeof import('monaco-editor');
+/**
+ * Resolved visual theme supported by the Book editor.
+ *
+ * @private function of BookEditorMonaco
+ */
+type BookEditorTheme = 'LIGHT' | 'DARK';
 /**
  * Props for use book editor monaco language.
  */
 type UseBookEditorMonacoLanguageProps = {
     readonly monaco: MonacoEditor | null;
+    readonly theme: BookEditorTheme;
 };
 /**
  * Ensures the BookEditor Monaco language, tokenizer, links and completion providers are
@@ -15,7 +22,7 @@ type UseBookEditorMonacoLanguageProps = {
  *
  * @private function of BookEditorMonaco
  */
-export declare function ensureBookEditorMonacoLanguage(monaco: MonacoEditor): void;
+export declare function ensureBookEditorMonacoLanguage(monaco: MonacoEditor, theme?: BookEditorTheme): void;
 /**
  * Props required to enforce Book Monaco language/theme on one mounted editor.
  *
@@ -24,6 +31,7 @@ export declare function ensureBookEditorMonacoLanguage(monaco: MonacoEditor): vo
 type EnsureBookEditorMonacoLanguageForEditorProps = {
     readonly monaco: MonacoEditor;
     readonly monacoEditor: editor.IStandaloneCodeEditor;
+    readonly theme?: BookEditorTheme;
 };
 /**
  * Ensures the mounted Monaco editor model uses Book language and Book theme.
@@ -41,5 +49,5 @@ export declare function ensureBookEditorMonacoLanguageForEditor(props: EnsureBoo
  *
  * @private function of BookEditorMonaco
  */
-export declare function useBookEditorMonacoLanguage({ monaco }: UseBookEditorMonacoLanguageProps): void;
+export declare function useBookEditorMonacoLanguage({ monaco, theme }: UseBookEditorMonacoLanguageProps): void;
 export {};

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

@@ -7,11 +7,12 @@ type UseBookEditorMonacoStylesProps = {
     readonly scaledContentPaddingLeft: number;
     readonly scaledVerticalLineLeft: number;
     readonly zoomLevel: number;
+    readonly theme: 'LIGHT' | 'DARK';
 };
 /**
  * Injects notebook-inspired styling that is unique per `BookEditorMonaco` instance.
  *
  * @private function of BookEditorMonaco
  */
-export declare function useBookEditorMonacoStyles({ instanceClass, scaledLineHeight, scaledContentPaddingLeft, scaledVerticalLineLeft, zoomLevel, }: UseBookEditorMonacoStylesProps): void;
+export declare function useBookEditorMonacoStyles({ instanceClass, scaledLineHeight, scaledContentPaddingLeft, scaledVerticalLineLeft, zoomLevel, theme, }: UseBookEditorMonacoStylesProps): void;
 export {};

package/esm/src/book-components/Chat/Chat/ChatMessageRichContent.d.ts

@@ -23,6 +23,10 @@ export type ChatMessageRichContentProps = {
      * Optional callback for creating a new agent from a book code block.
      */
     readonly onCreateAgent?: (bookContent: string) => void;
+    /**
+     * Resolved theme used by nested code blocks and editors.
+     */
+    readonly mode: 'LIGHT' | 'DARK';
 };
 /**
  * Renders markdown, code blocks, maps, and generated-image placeholders for one message.

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

@@ -4,10 +4,10 @@ import { Color } from '../../../_packages/color.index';
 import { SpeechRecognition } from '../../../types/SpeechRecognition';
 import type { string_href } from '../../../types/typeAliases';
 import { string_color } from '../../../types/typeAliases';
+import type { AgentChipData } from '../AgentChip/AgentChip';
 import type { string_chat_format_name } from '../save/_common/string_chat_format_name';
 import type { ChatMessage } from '../types/ChatMessage';
 import type { ChatParticipant } from '../types/ChatParticipant';
-import type { AgentChipData } from '../AgentChip/AgentChip';
 /**
  * Response data returned by the optional `onFeedback` handler.
  *
@@ -749,9 +749,18 @@ export type ChatProps = {
      */
     readonly visualMode?: ChatVisualMode;
     /**
-     * Visual style of the chat component
+     * Resolved visual theme used for chat surfaces, modals, and embedded Monaco viewers.
+     *
+     * Host applications should pass the final light/dark theme here instead of leaving
+     * `<Chat/>` to infer anything from the document.
+     *
+     * @default 'LIGHT'
+     */
+    readonly theme?: 'LIGHT' | 'DARK';
+    /**
+     * Layout of the chat component
      */
-    readonly visual: 'STANDALONE' | 'FULL_PAGE';
+    readonly layout: 'STANDALONE' | 'FULL_PAGE';
     /**
      * Optional array of effect configurations for chat animations
      * When provided, enables visual effects (confetti, hearts, etc.) based on emojis in messages

package/esm/src/book-components/Chat/Chat/ChatToolCallModal.d.ts

@@ -11,6 +11,7 @@ import type { ChatParticipant } from '../types/ChatParticipant';
 export type ChatToolCallModalProps = {
     isOpen: boolean;
     toolCall: NonNullable<ChatMessage['toolCalls']>[number] | null;
+    mode?: 'LIGHT' | 'DARK';
     /**
      * Stable identity of the selected tool call.
      *

package/esm/src/book-components/Chat/Chat/ChatToolCallModalContent.d.ts

@@ -26,6 +26,7 @@ type ChatToolCallModalContentProps = {
     readonly focusedToolCall: ToolCallModalToolCall;
     readonly isAdvancedView: boolean;
     readonly locale?: string;
+    readonly mode: 'LIGHT' | 'DARK';
     readonly onClearSelectedTeamToolCall: () => void;
     readonly onRequestAdvancedView: () => void;
     readonly onSelectTeamToolCall: (toolCall: TransitiveToolCall) => void;
@@ -42,5 +43,5 @@ type ChatToolCallModalContentProps = {
  *
  * @private component of `ChatToolCallModal`
  */
-export declare function ChatToolCallModalContent({ agentParticipant, availableTools, buttonColor, chatUiTranslations, focusedToolCall, isAdvancedView, locale, onClearSelectedTeamToolCall, onRequestAdvancedView, onSelectTeamToolCall, selectedTeamToolCall, teamProfiles, teamResult, teamToolCallSummary, toolCall, toolCallDate, toolTitles, }: ChatToolCallModalContentProps): ReactElement;
+export declare function ChatToolCallModalContent({ agentParticipant, availableTools, buttonColor, chatUiTranslations, focusedToolCall, isAdvancedView, locale, mode, onClearSelectedTeamToolCall, onRequestAdvancedView, onSelectTeamToolCall, selectedTeamToolCall, teamProfiles, teamResult, teamToolCallSummary, toolCall, toolCallDate, toolTitles, }: ChatToolCallModalContentProps): ReactElement;
 export {};

package/esm/src/book-components/Chat/Chat/renderAdvancedToolCallDetails.d.ts

@@ -18,6 +18,10 @@ type AdvancedToolCallDetailsOptions = {
      * Optional list of tools that were available to the model during the turn that produced this tool call.
      */
     availableTools?: ChatMessage['availableTools'];
+    /**
+     * Resolved theme used by embedded Monaco viewers in the advanced modal.
+     */
+    mode?: 'LIGHT' | 'DARK';
 };
 /**
  * Renders a technical view with raw tool input/output payloads.

package/esm/src/book-components/Chat/CodeBlock/CodeBlock.d.ts

@@ -8,11 +8,12 @@ type CodeBlockProps = {
     language?: string;
     className?: string;
     onCreateAgent?: (bookContent: string) => void;
+    theme?: 'LIGHT' | 'DARK';
 };
 /**
  * Component to render a code block with syntax highlighting, copy, download, and create agent options.
  *
  * @private Internal utility of `<ChatMessage />` component
  */
-export declare function CodeBlock({ code, language, className, onCreateAgent }: CodeBlockProps): import("react/jsx-runtime").JSX.Element;
+export declare function CodeBlock({ code, language, className, onCreateAgent, theme }: CodeBlockProps): import("react/jsx-runtime").JSX.Element;
 export {};

package/esm/src/speech-recognition/OpenAiSpeechRecognition.d.ts

@@ -10,7 +10,7 @@ export type OpenAiSpeechRecognitionOptions = {
     readonly baseUrl?: string;
 };
 /**
- * Speech recognition using OpenAI Whisper API to transcribe audio into text
+ * Speech recognition using the OpenAI transcription API to transcribe audio into text
  *
  * Note: This implementation uses a server-side proxy to avoid exposing the OpenAI API key on the client.
  *
@@ -34,6 +34,7 @@ export declare class OpenAiSpeechRecognition implements SpeechRecognition {
     private ambientNoiseLevel;
     private voiceLevelMultiplier;
     private silenceAutoStopDelayMs;
+    private recordingMimeType;
     get state(): SpeechRecognitionState;
     constructor(options?: OpenAiSpeechRecognitionOptions);
     $start(options?: SpeechRecognitionStartOptions): Promise<void>;
@@ -42,7 +43,7 @@ export declare class OpenAiSpeechRecognition implements SpeechRecognition {
     /**
      * Handles `MediaRecorder.onstop` by releasing audio resources and forwarding the clip to transcription.
      *
-     * @param language Optional language hint for Whisper.
+     * @param language Optional language hint for OpenAI transcription.
      */
     private handleRecorderStop;
     /**
@@ -81,3 +82,24 @@ export declare class OpenAiSpeechRecognition implements SpeechRecognition {
     subscribe(callback: (event: SpeechRecognitionEvent) => void): () => void;
     private emit;
 }
+/**
+ * Resolves the preferred recorder output format supported by the current browser.
+ *
+ * @private internal utility of `OpenAiSpeechRecognition`
+ */
+export declare function resolveOpenAiSpeechRecognitionPreferredRecordingFormat(): {
+    readonly mimeType: string;
+    readonly fileExtension: string;
+} | undefined;
+/**
+ * Resolves the MIME type and filename for one recorded audio upload.
+ *
+ * @private internal utility of `OpenAiSpeechRecognition`
+ */
+export declare function resolveOpenAiSpeechRecognitionAudioFileDescriptor(options: {
+    readonly recorderMimeType?: string;
+    readonly audioChunks: ReadonlyArray<Blob>;
+}): {
+    readonly mimeType: string;
+    readonly fileName: string;
+};

package/esm/src/speech-recognition/OpenAiSpeechRecognition.test.d.ts

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

package/esm/src/types/SpeechRecognition.d.ts

@@ -44,6 +44,10 @@ export type SpeechRecognitionStartOptions = {
      * Enables a more sensitive profile for quiet speech.
      */
     readonly whisperMode?: boolean;
+    /**
+     * Optional text prompt used to preserve continuity across multiple transcription chunks.
+     */
+    readonly transcriptionPrompt?: string;
 };
 /**
  * Current state of the speech recognition

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.112.0-47`).
+ * It follows semantic versioning (e.g., `0.112.0-49`).
  *
  * @generated
  */

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@promptbook/remote-client",
-    "version": "0.112.0-48",
+    "version": "0.112.0-50",
     "description": "Promptbook: Create persistent AI agents that turn your company's scattered knowledge into action",
     "private": false,
     "sideEffects": false,
@@ -104,7 +104,7 @@
     "types": "./esm/src/_packages/remote-client.index.d.ts",
     "typings": "./esm/src/_packages/remote-client.index.d.ts",
     "peerDependencies": {
-        "@promptbook/core": "0.112.0-48"
+        "@promptbook/core": "0.112.0-50"
     },
     "dependencies": {
         "crypto": "1.0.1",

package/umd/index.umd.js

@@ -22,7 +22,7 @@
      * @generated
      * @see https://github.com/webgptorg/promptbook
      */
-    const PROMPTBOOK_ENGINE_VERSION = '0.112.0-48';
+    const PROMPTBOOK_ENGINE_VERSION = '0.112.0-50';
     /**
      * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
      * Note: [💞] Ignore a discrepancy between file name and entity name

package/umd/src/avatars/avatarAnimationScheduler.d.ts

@@ -0,0 +1,16 @@
+/**
+ * One callback registered in the shared avatar animation scheduler.
+ *
+ * @private utility of the avatar rendering system
+ */
+type AvatarAnimationListener = (now: number) => void;
+/**
+ * Registers one avatar animation callback in the shared animation loop.
+ *
+ * @param avatarAnimationListener Frame callback invoked on every animation frame.
+ * @returns Cleanup function that unregisters the callback.
+ *
+ * @private utility of the avatar rendering system
+ */
+export declare function retainAvatarAnimationListener(avatarAnimationListener: AvatarAnimationListener): () => void;
+export {};

package/umd/src/avatars/avatarPointerTracking.d.ts

@@ -15,3 +15,19 @@ export declare function retainAvatarPointerTracking(): () => void;
  * @private utility of the avatar rendering system
  */
 export declare function getAvatarPointerSnapshot(): AvatarPointerSnapshot | null;
+/**
+ * Returns the current pointer snapshot version.
+ *
+ * @returns Monotonic pointer snapshot version.
+ *
+ * @private utility of the avatar rendering system
+ */
+export declare function getAvatarPointerSnapshotVersion(): number;
+/**
+ * Returns the current viewport-layout version used to invalidate cached avatar bounds.
+ *
+ * @returns Monotonic viewport-layout version.
+ *
+ * @private utility of the avatar rendering system
+ */
+export declare function getAvatarViewportLayoutVersion(): number;

package/umd/src/avatars/avatarVisibilityTracking.d.ts

@@ -0,0 +1,17 @@
+/**
+ * One callback observing the viewport visibility of an avatar canvas.
+ *
+ * @private utility of the avatar rendering system
+ */
+type AvatarVisibilityListener = (isVisible: boolean) => void;
+/**
+ * Observes one avatar element and notifies the caller when it enters or leaves the viewport.
+ *
+ * @param element Observed avatar element.
+ * @param avatarVisibilityListener Listener notified with the current visibility state.
+ * @returns Cleanup function that stops observing the element.
+ *
+ * @private utility of the avatar rendering system
+ */
+export declare function observeAvatarVisibility(element: Element, avatarVisibilityListener: AvatarVisibilityListener): () => void;
+export {};

package/umd/src/avatars/renderAvatarVisual.d.ts

@@ -1,9 +1,37 @@
 import type { RenderAvatarVisualOptions } from './types/AvatarVisualDefinition';
+import type { AvatarDefinition } from './types/AvatarDefinition';
+import type { AvatarPalette, AvatarSurfaceStyle, AvatarVisualDefinition, AvatarVisualId } from './types/AvatarVisualDefinition';
+/**
+ * Stable render data derived once from the avatar definition, surface, and visual id.
+ *
+ * @private shared helper for canvas avatar rendering
+ */
+export type ResolvedAvatarRenderDefinition = {
+    readonly avatarDefinition: AvatarDefinition;
+    readonly avatarVisual: AvatarVisualDefinition;
+    readonly surface: AvatarSurfaceStyle;
+    readonly palette: AvatarPalette;
+    readonly createRandom: (salt: string) => () => number;
+};
+/**
+ * Resolves the stable avatar render inputs reused across multiple frames.
+ *
+ * @param options Avatar identity and visual selection.
+ * @returns Stable render data ready to be used by `renderAvatarVisual`.
+ *
+ * @private shared helper for canvas avatar rendering
+ */
+export declare function resolveAvatarRenderDefinition(options: {
+    readonly avatarDefinition: AvatarDefinition;
+    readonly visualId: AvatarVisualId;
+    readonly surface?: AvatarSurfaceStyle;
+}): ResolvedAvatarRenderDefinition;
 /**
  * Renders one deterministic avatar frame into the provided canvas.
  *
  * @param options Rendering options.
+ * @param resolvedAvatarRenderDefinition Optional stable render data reused between frames.
  *
  * @private shared helper for canvas avatar rendering
  */
-export declare function renderAvatarVisual(options: RenderAvatarVisualOptions): void;
+export declare function renderAvatarVisual(options: RenderAvatarVisualOptions, resolvedAvatarRenderDefinition?: ResolvedAvatarRenderDefinition): void;

package/umd/src/avatars/visuals/octopus3AvatarVisual.d.ts

@@ -1,4 +1,76 @@
 import type { AvatarVisualDefinition } from '../types/AvatarVisualDefinition';
+/**
+ * Deterministic morphology knobs that keep `Octopus3` recognizable while widening seeded body, face, and tentacle variety.
+ *
+ * @private helper of `octopus3AvatarVisual`
+ */
+export type Octopus3MorphologyProfile = {
+    readonly bodyFamily: 'lantern' | 'drifter' | 'rounded';
+    readonly faceFamily: 'watchful' | 'sleepy' | 'mischief';
+    readonly body: {
+        readonly centerXJitterRatio: number;
+        readonly centerYRatio: number;
+        readonly bodyRadiusRatio: number;
+        readonly horizontalStretch: number;
+        readonly verticalStretch: number;
+        readonly mantleLiftRatio: number;
+        readonly lowerDropRatio: number;
+        readonly tentacleDepthRatio: number;
+        readonly wobbleAmplitudeRatio: number;
+        readonly lobeCount: number;
+        readonly pointCount: number;
+        readonly shadowWidthRatio: number;
+        readonly shadowHeightRatio: number;
+        readonly crownHighlightWidthRatio: number;
+        readonly crownHighlightHeightRatio: number;
+        readonly crownHighlightYOffsetRatio: number;
+    };
+    readonly tentacles: {
+        readonly count: number;
+        readonly flowLengthScale: number;
+        readonly lateralReachScale: number;
+        readonly tipReachScale: number;
+        readonly baseWidthScale: number;
+        readonly tipWidthScale: number;
+        readonly rootSpreadScale: number;
+        readonly startYOffsetScale: number;
+        readonly swayScale: number;
+    };
+    readonly face: {
+        readonly eyeSpacingRatio: number;
+        readonly eyeCenterYOffsetRatio: number;
+        readonly eyeRadiusXRatio: number;
+        readonly eyeHeightRatio: number;
+        readonly eyeRotationRange: number;
+        readonly eyeTiltBias: number;
+        readonly mouthWidthRatio: number;
+        readonly mouthYOffsetRatio: number;
+        readonly mouthCurveDepthRatio: number;
+        readonly mouthCenterOffsetRatio: number;
+        readonly mouthCornerTiltRatio: number;
+        readonly eyeStyle: {
+            readonly irisScale: number;
+            readonly pupilWidthScale: number;
+            readonly pupilHeightScale: number;
+            readonly upperLidArchRatio: number;
+            readonly upperLidInsetRatio: number;
+            readonly lowerLidOpacity: number;
+        };
+    };
+    readonly details: {
+        readonly mantleCurrentCount: number;
+        readonly mantleNodeCount: number;
+    };
+};
+/**
+ * Builds one deterministic morphology profile for `Octopus3`.
+ *
+ * @param createRandom Seeded random factory scoped to the current avatar.
+ * @returns Stable morphology profile.
+ *
+ * @private helper of `octopus3AvatarVisual`
+ */
+export declare function createOctopus3MorphologyProfile(createRandom: (salt: string) => () => number): Octopus3MorphologyProfile;
 /**
  * Octopus3 avatar visual.
  *

package/umd/src/avatars/visuals/octopus3AvatarVisual.test.d.ts

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

package/umd/src/avatars/visuals/octopusAvatarVisualShared.d.ts

@@ -61,6 +61,22 @@ type CreateOrganicOctopusTentacleShapesOptions = {
     readonly timeMs: number;
     readonly saltPrefix: string;
     readonly bodyPoints?: ReadonlyArray<Point>;
+    readonly variation?: OrganicTentacleVariationOptions;
+};
+/**
+ * Opt-in shape multipliers that let one visual broaden or tighten the shared tentacle generator.
+ *
+ * @private shared geometry helper of `octopus3AvatarVisual` and `asciiOctopusAvatarVisual`
+ */
+type OrganicTentacleVariationOptions = {
+    readonly flowLengthScale?: number;
+    readonly lateralReachScale?: number;
+    readonly tipReachScale?: number;
+    readonly baseWidthScale?: number;
+    readonly tipWidthScale?: number;
+    readonly rootSpreadScale?: number;
+    readonly startYOffsetScale?: number;
+    readonly swayScale?: number;
 };
 /**
  * One sampled ribbon point on an organic octopus tentacle.

package/umd/src/book-components/BookEditor/BookEditor.d.ts

@@ -90,6 +90,15 @@ export type BookEditorProps = {
      * Optional CSS style which will be added to root <div/> element
      */
     readonly style?: CSSProperties;
+    /**
+     * Resolved visual theme used for the editor wrapper and Monaco instance.
+     *
+     * Host applications should pass the final light/dark theme instead of relying on
+     * browser media-query inference inside `<BookEditor/>`.
+     *
+     * @default 'LIGHT'
+     */
+    readonly theme?: 'LIGHT' | 'DARK';
     /**
      * Height of the `BookEditor` component
      *

package/umd/src/book-components/BookEditor/useBookEditorMonacoLanguage.d.ts

@@ -3,11 +3,18 @@ import type { editor } from 'monaco-editor';
  * Type describing monaco editor.
  */
 type MonacoEditor = typeof import('monaco-editor');
+/**
+ * Resolved visual theme supported by the Book editor.
+ *
+ * @private function of BookEditorMonaco
+ */
+type BookEditorTheme = 'LIGHT' | 'DARK';
 /**
  * Props for use book editor monaco language.
  */
 type UseBookEditorMonacoLanguageProps = {
     readonly monaco: MonacoEditor | null;
+    readonly theme: BookEditorTheme;
 };
 /**
  * Ensures the BookEditor Monaco language, tokenizer, links and completion providers are
@@ -15,7 +22,7 @@ type UseBookEditorMonacoLanguageProps = {
  *
  * @private function of BookEditorMonaco
  */
-export declare function ensureBookEditorMonacoLanguage(monaco: MonacoEditor): void;
+export declare function ensureBookEditorMonacoLanguage(monaco: MonacoEditor, theme?: BookEditorTheme): void;
 /**
  * Props required to enforce Book Monaco language/theme on one mounted editor.
  *
@@ -24,6 +31,7 @@ export declare function ensureBookEditorMonacoLanguage(monaco: MonacoEditor): vo
 type EnsureBookEditorMonacoLanguageForEditorProps = {
     readonly monaco: MonacoEditor;
     readonly monacoEditor: editor.IStandaloneCodeEditor;
+    readonly theme?: BookEditorTheme;
 };
 /**
  * Ensures the mounted Monaco editor model uses Book language and Book theme.
@@ -41,5 +49,5 @@ export declare function ensureBookEditorMonacoLanguageForEditor(props: EnsureBoo
  *
  * @private function of BookEditorMonaco
  */
-export declare function useBookEditorMonacoLanguage({ monaco }: UseBookEditorMonacoLanguageProps): void;
+export declare function useBookEditorMonacoLanguage({ monaco, theme }: UseBookEditorMonacoLanguageProps): void;
 export {};

package/umd/src/book-components/BookEditor/useBookEditorMonacoStyles.d.ts

@@ -7,11 +7,12 @@ type UseBookEditorMonacoStylesProps = {
     readonly scaledContentPaddingLeft: number;
     readonly scaledVerticalLineLeft: number;
     readonly zoomLevel: number;
+    readonly theme: 'LIGHT' | 'DARK';
 };
 /**
  * Injects notebook-inspired styling that is unique per `BookEditorMonaco` instance.
  *
  * @private function of BookEditorMonaco
  */
-export declare function useBookEditorMonacoStyles({ instanceClass, scaledLineHeight, scaledContentPaddingLeft, scaledVerticalLineLeft, zoomLevel, }: UseBookEditorMonacoStylesProps): void;
+export declare function useBookEditorMonacoStyles({ instanceClass, scaledLineHeight, scaledContentPaddingLeft, scaledVerticalLineLeft, zoomLevel, theme, }: UseBookEditorMonacoStylesProps): void;
 export {};

package/umd/src/book-components/Chat/Chat/ChatMessageRichContent.d.ts

@@ -23,6 +23,10 @@ export type ChatMessageRichContentProps = {
      * Optional callback for creating a new agent from a book code block.
      */
     readonly onCreateAgent?: (bookContent: string) => void;
+    /**
+     * Resolved theme used by nested code blocks and editors.
+     */
+    readonly mode: 'LIGHT' | 'DARK';
 };
 /**
  * Renders markdown, code blocks, maps, and generated-image placeholders for one message.

package/umd/src/book-components/Chat/Chat/ChatProps.d.ts

@@ -4,10 +4,10 @@ import { Color } from '../../../_packages/color.index';
 import { SpeechRecognition } from '../../../types/SpeechRecognition';
 import type { string_href } from '../../../types/typeAliases';
 import { string_color } from '../../../types/typeAliases';
+import type { AgentChipData } from '../AgentChip/AgentChip';
 import type { string_chat_format_name } from '../save/_common/string_chat_format_name';
 import type { ChatMessage } from '../types/ChatMessage';
 import type { ChatParticipant } from '../types/ChatParticipant';
-import type { AgentChipData } from '../AgentChip/AgentChip';
 /**
  * Response data returned by the optional `onFeedback` handler.
  *
@@ -749,9 +749,18 @@ export type ChatProps = {
      */
     readonly visualMode?: ChatVisualMode;
     /**
-     * Visual style of the chat component
+     * Resolved visual theme used for chat surfaces, modals, and embedded Monaco viewers.
+     *
+     * Host applications should pass the final light/dark theme here instead of leaving
+     * `<Chat/>` to infer anything from the document.
+     *
+     * @default 'LIGHT'
+     */
+    readonly theme?: 'LIGHT' | 'DARK';
+    /**
+     * Layout of the chat component
      */
-    readonly visual: 'STANDALONE' | 'FULL_PAGE';
+    readonly layout: 'STANDALONE' | 'FULL_PAGE';
     /**
      * Optional array of effect configurations for chat animations
      * When provided, enables visual effects (confetti, hearts, etc.) based on emojis in messages

package/umd/src/book-components/Chat/Chat/ChatToolCallModal.d.ts

@@ -11,6 +11,7 @@ import type { ChatParticipant } from '../types/ChatParticipant';
 export type ChatToolCallModalProps = {
     isOpen: boolean;
     toolCall: NonNullable<ChatMessage['toolCalls']>[number] | null;
+    mode?: 'LIGHT' | 'DARK';
     /**
      * Stable identity of the selected tool call.
      *

package/umd/src/book-components/Chat/Chat/ChatToolCallModalContent.d.ts

@@ -26,6 +26,7 @@ type ChatToolCallModalContentProps = {
     readonly focusedToolCall: ToolCallModalToolCall;
     readonly isAdvancedView: boolean;
     readonly locale?: string;
+    readonly mode: 'LIGHT' | 'DARK';
     readonly onClearSelectedTeamToolCall: () => void;
     readonly onRequestAdvancedView: () => void;
     readonly onSelectTeamToolCall: (toolCall: TransitiveToolCall) => void;
@@ -42,5 +43,5 @@ type ChatToolCallModalContentProps = {
  *
  * @private component of `ChatToolCallModal`
  */
-export declare function ChatToolCallModalContent({ agentParticipant, availableTools, buttonColor, chatUiTranslations, focusedToolCall, isAdvancedView, locale, onClearSelectedTeamToolCall, onRequestAdvancedView, onSelectTeamToolCall, selectedTeamToolCall, teamProfiles, teamResult, teamToolCallSummary, toolCall, toolCallDate, toolTitles, }: ChatToolCallModalContentProps): ReactElement;
+export declare function ChatToolCallModalContent({ agentParticipant, availableTools, buttonColor, chatUiTranslations, focusedToolCall, isAdvancedView, locale, mode, onClearSelectedTeamToolCall, onRequestAdvancedView, onSelectTeamToolCall, selectedTeamToolCall, teamProfiles, teamResult, teamToolCallSummary, toolCall, toolCallDate, toolTitles, }: ChatToolCallModalContentProps): ReactElement;
 export {};

package/umd/src/book-components/Chat/Chat/renderAdvancedToolCallDetails.d.ts

@@ -18,6 +18,10 @@ type AdvancedToolCallDetailsOptions = {
      * Optional list of tools that were available to the model during the turn that produced this tool call.
      */
     availableTools?: ChatMessage['availableTools'];
+    /**
+     * Resolved theme used by embedded Monaco viewers in the advanced modal.
+     */
+    mode?: 'LIGHT' | 'DARK';
 };
 /**
  * Renders a technical view with raw tool input/output payloads.

package/umd/src/book-components/Chat/CodeBlock/CodeBlock.d.ts

@@ -8,11 +8,12 @@ type CodeBlockProps = {
     language?: string;
     className?: string;
     onCreateAgent?: (bookContent: string) => void;
+    theme?: 'LIGHT' | 'DARK';
 };
 /**
  * Component to render a code block with syntax highlighting, copy, download, and create agent options.
  *
  * @private Internal utility of `<ChatMessage />` component
  */
-export declare function CodeBlock({ code, language, className, onCreateAgent }: CodeBlockProps): import("react/jsx-runtime").JSX.Element;
+export declare function CodeBlock({ code, language, className, onCreateAgent, theme }: CodeBlockProps): import("react/jsx-runtime").JSX.Element;
 export {};

package/umd/src/speech-recognition/OpenAiSpeechRecognition.d.ts

@@ -10,7 +10,7 @@ export type OpenAiSpeechRecognitionOptions = {
     readonly baseUrl?: string;
 };
 /**
- * Speech recognition using OpenAI Whisper API to transcribe audio into text
+ * Speech recognition using the OpenAI transcription API to transcribe audio into text
  *
  * Note: This implementation uses a server-side proxy to avoid exposing the OpenAI API key on the client.
  *
@@ -34,6 +34,7 @@ export declare class OpenAiSpeechRecognition implements SpeechRecognition {
     private ambientNoiseLevel;
     private voiceLevelMultiplier;
     private silenceAutoStopDelayMs;
+    private recordingMimeType;
     get state(): SpeechRecognitionState;
     constructor(options?: OpenAiSpeechRecognitionOptions);
     $start(options?: SpeechRecognitionStartOptions): Promise<void>;
@@ -42,7 +43,7 @@ export declare class OpenAiSpeechRecognition implements SpeechRecognition {
     /**
      * Handles `MediaRecorder.onstop` by releasing audio resources and forwarding the clip to transcription.
      *
-     * @param language Optional language hint for Whisper.
+     * @param language Optional language hint for OpenAI transcription.
      */
     private handleRecorderStop;
     /**
@@ -81,3 +82,24 @@ export declare class OpenAiSpeechRecognition implements SpeechRecognition {
     subscribe(callback: (event: SpeechRecognitionEvent) => void): () => void;
     private emit;
 }
+/**
+ * Resolves the preferred recorder output format supported by the current browser.
+ *
+ * @private internal utility of `OpenAiSpeechRecognition`
+ */
+export declare function resolveOpenAiSpeechRecognitionPreferredRecordingFormat(): {
+    readonly mimeType: string;
+    readonly fileExtension: string;
+} | undefined;
+/**
+ * Resolves the MIME type and filename for one recorded audio upload.
+ *
+ * @private internal utility of `OpenAiSpeechRecognition`
+ */
+export declare function resolveOpenAiSpeechRecognitionAudioFileDescriptor(options: {
+    readonly recorderMimeType?: string;
+    readonly audioChunks: ReadonlyArray<Blob>;
+}): {
+    readonly mimeType: string;
+    readonly fileName: string;
+};

package/umd/src/speech-recognition/OpenAiSpeechRecognition.test.d.ts

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

package/umd/src/types/SpeechRecognition.d.ts

@@ -44,6 +44,10 @@ export type SpeechRecognitionStartOptions = {
      * Enables a more sensitive profile for quiet speech.
      */
     readonly whisperMode?: boolean;
+    /**
+     * Optional text prompt used to preserve continuity across multiple transcription chunks.
+     */
+    readonly transcriptionPrompt?: string;
 };
 /**
  * Current state of the speech recognition

package/umd/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.112.0-47`).
+ * It follows semantic versioning (e.g., `0.112.0-49`).
  *
  * @generated
  */