@promptbook/cli 0.112.0-115 → 0.112.0-118

package/esm/scripts/run-codex-prompts/common/parseDuration.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Parses a human-readable duration string into milliseconds.
+ *
+ * Supported formats: `Xh`, `Xm`, `Xs`, and combinations like `1h30m`, `1h30m5s`.
+ *
+ * @returns Duration in milliseconds
+ * @throws When the string does not match any supported format
+ *
+ * @private internal utility of `ptbk coder run`
+ */
+export declare function parseDuration(durationString: string): number;
+/**
+ * Formats a duration in milliseconds into a compact human-readable string.
+ *
+ * Examples: `3600000` → `"1h"`, `90000` → `"1m 30s"`, `5000` → `"5s"`.
+ *
+ * @private internal utility of `ptbk coder run`
+ */
+export declare function formatDurationMs(ms: number): string;

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

@@ -12,6 +12,7 @@ import type { BookEditorUploadProgressCallback } from '../book-components/BookEd
 import type { BookEditorUploadOptions } from '../book-components/BookEditor/BookEditor';
 import type { BookEditorProps } from '../book-components/BookEditor/BookEditor';
 import { BookEditor } from '../book-components/BookEditor/BookEditor';
+import { BookEditorForClient } from '../book-components/BookEditor/BookEditorForClient';
 import { AgentChat } from '../book-components/Chat/AgentChat/AgentChat';
 import type { AgentChatProps } from '../book-components/Chat/AgentChat/AgentChatProps';
 import { Chat } from '../book-components/Chat/Chat/Chat';
@@ -95,6 +96,7 @@ export type { BookEditorUploadProgressCallback };
 export type { BookEditorUploadOptions };
 export type { BookEditorProps };
 export { BookEditor };
+export { BookEditorForClient };
 export { AgentChat };
 export type { AgentChatProps };
 export { Chat };

package/esm/src/_packages/node.index.d.ts

@@ -1,4 +1,9 @@
 import { BOOK_LANGUAGE_VERSION, PROMPTBOOK_ENGINE_VERSION } from '../version';
+import { AGENT_BOOK_FILE_PATH } from '../book-3.0/agentFolderPaths';
+import { AGENT_MESSAGES_DIRECTORY_PATH } from '../book-3.0/agentFolderPaths';
+import { AGENT_QUEUED_MESSAGES_DIRECTORY_PATH } from '../book-3.0/agentFolderPaths';
+import { AGENT_FINISHED_MESSAGES_DIRECTORY_PATH } from '../book-3.0/agentFolderPaths';
+import { AGENT_FAILED_MESSAGES_DIRECTORY_PATH } from '../book-3.0/agentFolderPaths';
 import type { BookNodeAgentSource } from '../book-3.0/BookNodeAgentSource';
 import type { BookNodeAgentSourceOptions } from '../book-3.0/BookNodeAgentSource';
 import type { CliAgentHarness } from '../book-3.0/CliAgent';
@@ -6,6 +11,11 @@ import type { CliAgentThinkingLevel } from '../book-3.0/CliAgent';
 import type { CliAgentRunOptions } from '../book-3.0/CliAgent';
 import type { CliAgentOptions } from '../book-3.0/CliAgent';
 import { CliAgent } from '../book-3.0/CliAgent';
+import { CLI_AGENT_HARNESS_NAMES } from '../book-3.0/cliAgentEnv';
+import { CLI_AGENT_THINKING_LEVEL_VALUES } from '../book-3.0/cliAgentEnv';
+import { PTBK_HARNESS_ENV } from '../book-3.0/cliAgentEnv';
+import { PTBK_MODEL_ENV } from '../book-3.0/cliAgentEnv';
+import { PTBK_THINKING_LEVEL_ENV } from '../book-3.0/cliAgentEnv';
 import type { LiteAgentOptions } from '../book-3.0/LiteAgent';
 import type { LiteAgentRunOptions } from '../book-3.0/LiteAgent';
 import { LiteAgent } from '../book-3.0/LiteAgent';
@@ -22,6 +32,11 @@ import { FileCacheStorage } from '../storage/file-cache-storage/FileCacheStorage
 import { $execCommand } from '../utils/execCommand/$execCommand';
 import { $execCommands } from '../utils/execCommand/$execCommands';
 export { BOOK_LANGUAGE_VERSION, PROMPTBOOK_ENGINE_VERSION };
+export { AGENT_BOOK_FILE_PATH };
+export { AGENT_MESSAGES_DIRECTORY_PATH };
+export { AGENT_QUEUED_MESSAGES_DIRECTORY_PATH };
+export { AGENT_FINISHED_MESSAGES_DIRECTORY_PATH };
+export { AGENT_FAILED_MESSAGES_DIRECTORY_PATH };
 export type { BookNodeAgentSource };
 export type { BookNodeAgentSourceOptions };
 export type { CliAgentHarness };
@@ -29,6 +44,11 @@ export type { CliAgentThinkingLevel };
 export type { CliAgentRunOptions };
 export type { CliAgentOptions };
 export { CliAgent };
+export { CLI_AGENT_HARNESS_NAMES };
+export { CLI_AGENT_THINKING_LEVEL_VALUES };
+export { PTBK_HARNESS_ENV };
+export { PTBK_MODEL_ENV };
+export { PTBK_THINKING_LEVEL_ENV };
 export type { LiteAgentOptions };
 export type { LiteAgentRunOptions };
 export { LiteAgent };

package/esm/src/book-3.0/BookNodeAgentSource.d.ts

@@ -15,7 +15,7 @@ export type BookNodeAgentSource = Book | string_book;
  */
 export type BookNodeAgentSourceOptions = {
     readonly agentPath?: string;
-    readonly book?: BookNodeAgentSource;
+    readonly book?: string | BookNodeAgentSource;
     readonly currentWorkingDirectory?: string;
 };
 /**

package/esm/src/book-3.0/CliAgent.d.ts

@@ -1,16 +1,17 @@
 import type { BookNodeAgentSourceOptions } from './BookNodeAgentSource';
+import { CLI_AGENT_HARNESS_NAMES, CLI_AGENT_THINKING_LEVEL_VALUES } from './cliAgentEnv';
 /**
  * CLI harness names supported by `ptbk agent exec`.
  *
  * @public exported from `@promptbook/node`
  */
-export type CliAgentHarness = 'openai-codex' | 'github-copilot' | 'cline' | 'claude-code' | 'opencode' | 'gemini';
+export type CliAgentHarness = (typeof CLI_AGENT_HARNESS_NAMES)[number];
 /**
  * Thinking levels supported by CLI coding harnesses.
  *
  * @public exported from `@promptbook/node`
  */
-export type CliAgentThinkingLevel = 'low' | 'medium' | 'high' | 'xhigh';
+export type CliAgentThinkingLevel = (typeof CLI_AGENT_THINKING_LEVEL_VALUES)[number];
 /**
  * Per-run CLI options exposed by `CliAgent`.
  *
@@ -22,6 +23,7 @@ export type CliAgentRunOptions = {
     readonly allowCredits?: boolean;
     readonly context?: string;
     readonly harness?: CliAgentHarness;
+    readonly isVerbose?: boolean;
     readonly model?: string;
     readonly noUi?: boolean;
     readonly thinkingLevel?: CliAgentThinkingLevel;
@@ -31,19 +33,15 @@ export type CliAgentRunOptions = {
  *
  * @public exported from `@promptbook/node`
  */
-export type CliAgentOptions = BookNodeAgentSourceOptions & CliAgentRunOptions & {
-    /**
-     * Executable used for the wrapper command.
-     *
-     * @default ptbk
-     */
-    readonly command?: string;
-};
+export type CliAgentOptions = BookNodeAgentSourceOptions & CliAgentRunOptions;
 /**
- * Lightweight JavaScript wrapper around `ptbk agent exec`.
+ * Lightweight JavaScript wrapper around the Promptbook agent execution pipeline.
+ *
+ * It uses the same harnesses and execution path as `ptbk agent exec`, running the runner
+ * in-process instead of spawning a separate CLI process.
  *
- * It uses the same CLI harnesses as Promptbook's agent command, making it the most faithful
- * way to run a local Book agent from Node.js when you want the CLI execution flow.
+ * When no `harness` is provided in the constructor or per-run options, `CliAgent` falls back
+ * to the `PTBK_HARNESS` environment variable, mirroring `ptbk agent exec` behavior.
  *
  * @public exported from `@promptbook/node`
  */
@@ -52,15 +50,15 @@ export declare class CliAgent {
     private temporaryAgentPath;
     constructor(options: CliAgentOptions);
     /**
-     * Runs one non-interactive agent turn through `ptbk agent exec`.
+     * Runs one non-interactive agent turn through the selected harness.
      *
      * @param message - User message sent to the agent.
-     * @param options - Optional per-run CLI overrides.
-     * @returns Raw stdout emitted by the CLI command.
+     * @param options - Optional per-run overrides.
+     * @returns Final agent answer.
      */
     run(message: string, options?: CliAgentRunOptions): Promise<string>;
     /**
-     * Resolves the agent path passed to the CLI, materializing one temporary `.book` file when needed.
+     * Resolves the agent path passed to the runner, materializing one temporary `.book` file when needed.
      *
      * @private internal utility of `CliAgent`
      */

package/esm/src/book-3.0/agentFolderPaths.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Relative path to the local agent source used by the agent folder convention.
+ *
+ * @public exported from `@promptbook/node`
+ */
+export declare const AGENT_BOOK_FILE_PATH = "agent.book";
+/**
+ * Relative path to the message queue root used by the agent folder convention.
+ *
+ * @public exported from `@promptbook/node`
+ */
+export declare const AGENT_MESSAGES_DIRECTORY_PATH = "messages";
+/**
+ * Relative path to queued user messages consumed by the agent runner.
+ *
+ * @public exported from `@promptbook/node`
+ */
+export declare const AGENT_QUEUED_MESSAGES_DIRECTORY_PATH: string;
+/**
+ * Relative path to answered messages written by the agent runner.
+ *
+ * @public exported from `@promptbook/node`
+ */
+export declare const AGENT_FINISHED_MESSAGES_DIRECTORY_PATH: string;
+/**
+ * Relative path to messages that the agent runner stopped retrying.
+ *
+ * @public exported from `@promptbook/node`
+ */
+export declare const AGENT_FAILED_MESSAGES_DIRECTORY_PATH: string;

package/esm/src/book-3.0/cliAgentEnv.d.ts

@@ -0,0 +1,33 @@
+/**
+ * All CLI harness names supported by `CliAgent` and `ptbk agent exec`.
+ *
+ * @public exported from `@promptbook/node`
+ */
+export declare const CLI_AGENT_HARNESS_NAMES: readonly ["openai-codex", "github-copilot", "cline", "claude-code", "opencode", "gemini"];
+/**
+ * All supported thinking-level values for CLI coding-agent runners.
+ *
+ * @public exported from `@promptbook/node`
+ */
+export declare const CLI_AGENT_THINKING_LEVEL_VALUES: readonly ["low", "medium", "high", "xhigh"];
+/**
+ * Environment variable used as the default runner identifier when `--harness` is omitted or not set in `CliAgent`.
+ *
+ * Set this to one of the harness names (`openai-codex`, `github-copilot`, `cline`, `claude-code`, `opencode`, `gemini`)
+ * so that `CliAgent` and `ptbk agent exec` can run without an explicit `harness` option.
+ *
+ * @public exported from `@promptbook/node`
+ */
+export declare const PTBK_HARNESS_ENV = "PTBK_HARNESS";
+/**
+ * Environment variable used as the default runner model when `--model` is omitted or not set in `CliAgent`.
+ *
+ * @public exported from `@promptbook/node`
+ */
+export declare const PTBK_MODEL_ENV = "PTBK_MODEL";
+/**
+ * Environment variable used as the default thinking level when `--thinking-level` is omitted or not set in `CliAgent`.
+ *
+ * @public exported from `@promptbook/node`
+ */
+export declare const PTBK_THINKING_LEVEL_ENV = "PTBK_THINKING_LEVEL";

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

@@ -0,0 +1,2 @@
+export { NAME, CLAIM, PROMPTBOOK_LEGAL_ENTITY, IS_COST_PREVENTED, DEFAULT_IS_VERBOSE, DEFAULT_MAX_CONCURRENT_UPLOADS, PROMPTBOOK_SYNTAX_COLORS, } from '../../config';
+export { PUBLIC_AGENTS_SERVERS } from '../../../servers';

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

@@ -0,0 +1,7 @@
+import { BookEditorProps } from './BookEditor';
+/**
+ * Renders a book editor
+ *
+ * @public exported from `@promptbook/components`
+ */
+export declare function BookEditorForClient(props: BookEditorProps): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,9 @@
+/**
+ * Browser-compatible stub for `createDeprecatedCommitmentDiagnostics`.
+ *
+ * In the browser build the full Node.js implementation is not available,
+ * so this stub always returns an empty array to keep the editor functional.
+ *
+ * @private internal utility of `BookEditorMonaco`
+ */
+export declare function createDeprecatedCommitmentDiagnostics(_agentSource?: string): [];

package/esm/src/cli/cli-commands/agent-folder/agentProjectPaths.d.ts

@@ -1,39 +1,11 @@
-/**
- * Relative path to the local agent source initialized by `ptbk agent-folder init`.
- *
- * @private internal utility of `ptbk agent-folder`
- */
-export declare const AGENT_BOOK_FILE_PATH = "agent.book";
+import { AGENT_BOOK_FILE_PATH, AGENT_FAILED_MESSAGES_DIRECTORY_PATH, AGENT_FINISHED_MESSAGES_DIRECTORY_PATH, AGENT_MESSAGES_DIRECTORY_PATH, AGENT_QUEUED_MESSAGES_DIRECTORY_PATH } from '../../../book-3.0/agentFolderPaths';
+export { AGENT_BOOK_FILE_PATH, AGENT_FAILED_MESSAGES_DIRECTORY_PATH, AGENT_FINISHED_MESSAGES_DIRECTORY_PATH, AGENT_MESSAGES_DIRECTORY_PATH, AGENT_QUEUED_MESSAGES_DIRECTORY_PATH, };
 /**
  * Relative path to local knowledge files initialized by `ptbk agent-folder init`.
  *
  * @private internal utility of `ptbk agent-folder`
  */
 export declare const AGENT_KNOWLEDGE_DIRECTORY_PATH = "knowledge";
-/**
- * Relative path to the message queue root initialized by `ptbk agent-folder init`.
- *
- * @private internal utility of `ptbk agent-folder`
- */
-export declare const AGENT_MESSAGES_DIRECTORY_PATH = "messages";
-/**
- * Relative path to queued user messages consumed by `ptbk agent-folder run-once`.
- *
- * @private internal utility of `ptbk agent-folder`
- */
-export declare const AGENT_QUEUED_MESSAGES_DIRECTORY_PATH: string;
-/**
- * Relative path to answered messages written by `ptbk agent-folder run-once`.
- *
- * @private internal utility of `ptbk agent-folder`
- */
-export declare const AGENT_FINISHED_MESSAGES_DIRECTORY_PATH: string;
-/**
- * Relative path to messages that the agent runner stopped retrying.
- *
- * @private internal utility of `ptbk agent-folder`
- */
-export declare const AGENT_FAILED_MESSAGES_DIRECTORY_PATH: string;
 /**
  * Relative path to generated local agent documentation initialized by `ptbk agent-folder init`.
  *

package/esm/src/cli/cli-commands/common/promptRunnerCliOptions.d.ts

@@ -1,29 +1,13 @@
 import { Command as Program } from 'commander';
 import type { ThinkingLevel } from '../coder/ThinkingLevel';
+import { PTBK_HARNESS_ENV, PTBK_MODEL_ENV, PTBK_THINKING_LEVEL_ENV } from '../../../book-3.0/cliAgentEnv';
+export { PTBK_HARNESS_ENV, PTBK_MODEL_ENV, PTBK_THINKING_LEVEL_ENV };
 /**
  * Runner identifiers supported by Promptbook CLI agent orchestration commands.
  *
  * @private internal utility of `promptbookCli`
  */
 export declare const PROMPT_RUNNER_HARNESS_NAMES: readonly ["openai-codex", "github-copilot", "cline", "claude-code", "opencode", "gemini"];
-/**
- * Environment variable used as the default runner identifier when `--harness` is omitted.
- *
- * @private internal utility of `promptbookCli`
- */
-export declare const PTBK_HARNESS_ENV = "PTBK_HARNESS";
-/**
- * Environment variable used as the default runner model when `--model` is omitted.
- *
- * @private internal utility of `promptbookCli`
- */
-export declare const PTBK_MODEL_ENV = "PTBK_MODEL";
-/**
- * Environment variable used as the default runner thinking level when `--thinking-level` is omitted.
- *
- * @private internal utility of `promptbookCli`
- */
-export declare const PTBK_THINKING_LEVEL_ENV = "PTBK_THINKING_LEVEL";
 /**
  * Runner identifier supported by Promptbook CLI agent orchestration commands.
  *

package/esm/src/scrapers/website/utils/createShowdownConverter.d.ts

@@ -1,7 +1,7 @@
-import { Converter as ShowdownConverter } from 'showdown';
+import showdown from 'showdown';
 /**
  * Create a new showdown converter instance
  *
  * @private utility of `WebsiteScraper`
  */
-export declare function createShowdownConverter(): ShowdownConverter;
+export declare function createShowdownConverter(): showdown.Converter;

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

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@promptbook/cli",
-    "version": "0.112.0-115",
+    "version": "0.112.0-118",
     "description": "Promptbook: Create persistent AI agents that turn your company's scattered knowledge into action",
     "private": false,
     "sideEffects": false,

package/src/_packages/components.index.ts

@@ -17,6 +17,7 @@ import type { BookEditorUploadProgressCallback } from '../book-components/BookEd
 import type { BookEditorUploadOptions } from '../book-components/BookEditor/BookEditor';
 import type { BookEditorProps } from '../book-components/BookEditor/BookEditor';
 import { BookEditor } from '../book-components/BookEditor/BookEditor';
+import { BookEditorForClient } from '../book-components/BookEditor/BookEditorForClient';
 import { AgentChat } from '../book-components/Chat/AgentChat/AgentChat';
 import type { AgentChatProps } from '../book-components/Chat/AgentChat/AgentChatProps';
 import { Chat } from '../book-components/Chat/Chat/Chat';
@@ -106,6 +107,7 @@ export type { BookEditorUploadProgressCallback };
 export type { BookEditorUploadOptions };
 export type { BookEditorProps };
 export { BookEditor };
+export { BookEditorForClient };
 export { AgentChat };
 export type { AgentChatProps };
 export { Chat };

package/src/_packages/node.index.ts

@@ -2,6 +2,11 @@
 // `@promptbook/node`
 
 import { BOOK_LANGUAGE_VERSION, PROMPTBOOK_ENGINE_VERSION } from '../version';
+import { AGENT_BOOK_FILE_PATH } from '../book-3.0/agentFolderPaths';
+import { AGENT_MESSAGES_DIRECTORY_PATH } from '../book-3.0/agentFolderPaths';
+import { AGENT_QUEUED_MESSAGES_DIRECTORY_PATH } from '../book-3.0/agentFolderPaths';
+import { AGENT_FINISHED_MESSAGES_DIRECTORY_PATH } from '../book-3.0/agentFolderPaths';
+import { AGENT_FAILED_MESSAGES_DIRECTORY_PATH } from '../book-3.0/agentFolderPaths';
 import type { BookNodeAgentSource } from '../book-3.0/BookNodeAgentSource';
 import type { BookNodeAgentSourceOptions } from '../book-3.0/BookNodeAgentSource';
 import type { CliAgentHarness } from '../book-3.0/CliAgent';
@@ -9,6 +14,11 @@ import type { CliAgentThinkingLevel } from '../book-3.0/CliAgent';
 import type { CliAgentRunOptions } from '../book-3.0/CliAgent';
 import type { CliAgentOptions } from '../book-3.0/CliAgent';
 import { CliAgent } from '../book-3.0/CliAgent';
+import { CLI_AGENT_HARNESS_NAMES } from '../book-3.0/cliAgentEnv';
+import { CLI_AGENT_THINKING_LEVEL_VALUES } from '../book-3.0/cliAgentEnv';
+import { PTBK_HARNESS_ENV } from '../book-3.0/cliAgentEnv';
+import { PTBK_MODEL_ENV } from '../book-3.0/cliAgentEnv';
+import { PTBK_THINKING_LEVEL_ENV } from '../book-3.0/cliAgentEnv';
 import type { LiteAgentOptions } from '../book-3.0/LiteAgent';
 import type { LiteAgentRunOptions } from '../book-3.0/LiteAgent';
 import { LiteAgent } from '../book-3.0/LiteAgent';
@@ -31,6 +41,11 @@ export { BOOK_LANGUAGE_VERSION, PROMPTBOOK_ENGINE_VERSION };
 
 
 // Note: Entities of the `@promptbook/node`
+export { AGENT_BOOK_FILE_PATH };
+export { AGENT_MESSAGES_DIRECTORY_PATH };
+export { AGENT_QUEUED_MESSAGES_DIRECTORY_PATH };
+export { AGENT_FINISHED_MESSAGES_DIRECTORY_PATH };
+export { AGENT_FAILED_MESSAGES_DIRECTORY_PATH };
 export type { BookNodeAgentSource };
 export type { BookNodeAgentSourceOptions };
 export type { CliAgentHarness };
@@ -38,6 +53,11 @@ export type { CliAgentThinkingLevel };
 export type { CliAgentRunOptions };
 export type { CliAgentOptions };
 export { CliAgent };
+export { CLI_AGENT_HARNESS_NAMES };
+export { CLI_AGENT_THINKING_LEVEL_VALUES };
+export { PTBK_HARNESS_ENV };
+export { PTBK_MODEL_ENV };
+export { PTBK_THINKING_LEVEL_ENV };
 export type { LiteAgentOptions };
 export type { LiteAgentRunOptions };
 export { LiteAgent };

package/src/avatars/avatarAnimationScheduler.ts

@@ -7,6 +7,24 @@
  */
 type AvatarAnimationListener = (now: number) => void;
 
+/**
+ * Target frames per second for the shared avatar animation loop.
+ *
+ * Animated octopus visuals change slowly enough that 24 fps is indistinguishable
+ * from 60 fps in practice, while cutting rendering work by ~60% when multiple
+ * avatars are on screen simultaneously.
+ *
+ * @private utility of the avatar rendering system
+ */
+const AVATAR_TARGET_FPS = 24;
+
+/**
+ * Minimum elapsed time in milliseconds required between avatar render passes.
+ *
+ * @private utility of the avatar rendering system
+ */
+const AVATAR_TARGET_FRAME_INTERVAL_MS = 1000 / AVATAR_TARGET_FPS;
+
 /**
  * Next registration id used by the shared avatar animation scheduler.
  *
@@ -28,6 +46,15 @@ const avatarAnimationListeners = new Map<number, AvatarAnimationListener>();
  */
 let avatarAnimationFrameId: number | null = null;
 
+/**
+ * Timestamp of the most recently rendered avatar frame.
+ *
+ * Used to throttle callbacks to `AVATAR_TARGET_FRAME_INTERVAL_MS`.
+ *
+ * @private utility of the avatar rendering system
+ */
+let lastAvatarFrameTime = 0;
+
 /**
  * Registers one avatar animation callback in the shared animation loop.
  *
@@ -68,8 +95,12 @@ function ensureAvatarAnimationLoop(): void {
     const runFrame = (now: number) => {
         avatarAnimationFrameId = null;
 
-        for (const avatarAnimationListener of [...avatarAnimationListeners.values()]) {
-            avatarAnimationListener(now);
+        if (now - lastAvatarFrameTime >= AVATAR_TARGET_FRAME_INTERVAL_MS) {
+            lastAvatarFrameTime = now;
+
+            for (const avatarAnimationListener of [...avatarAnimationListeners.values()]) {
+                avatarAnimationListener(now);
+            }
         }
 
         ensureAvatarAnimationLoop();

package/src/avatars/visuals/fractalAvatarVisual.ts

@@ -290,7 +290,7 @@ function drawDragonCurveLayer(
         layerIndex: number;
     },
 ): void {
-    const { size, primaryColor, secondaryColor, tertiaryColor, shadowColor, strokeWidth, timeMs, layerIndex } = options;
+    const { primaryColor, secondaryColor, tertiaryColor, shadowColor, strokeWidth, timeMs, layerIndex } = options;
     const firstPoint = points[0]!;
     const lastPoint = points[points.length - 1]!;
     const ribbonGradient = context.createLinearGradient(firstPoint.x, firstPoint.y, lastPoint.x, lastPoint.y);
@@ -298,14 +298,15 @@ function drawDragonCurveLayer(
     ribbonGradient.addColorStop(0.5, `${secondaryColor}e6`);
     ribbonGradient.addColorStop(1, `${tertiaryColor}f2`);
 
+    // Approximate the blurred shadow stroke with a wider semi-transparent stroke instead of
+    // context.filter blur, which triggers a costly software rasterization pass every frame.
     context.save();
     context.beginPath();
     tracePolyline(context, points);
-    context.strokeStyle = `${shadowColor}82`;
-    context.lineWidth = strokeWidth * 1.8;
+    context.strokeStyle = `${shadowColor}48`;
+    context.lineWidth = strokeWidth * 4.5;
     context.lineJoin = 'round';
     context.lineCap = 'round';
-    context.filter = `blur(${size * 0.022}px)`;
     context.stroke();
     context.restore();
 

package/src/avatars/visuals/minecraft2AvatarVisual.ts

@@ -218,19 +218,24 @@ function drawMinecraftShadow(
     },
     timeMs: number,
 ): void {
+    const cx = size * 0.5 + interaction.gazeX * size * 0.03;
+    const cy = size * 0.85 + Math.sin(timeMs / 880) * size * 0.01;
+    const rx = size * (0.16 + interaction.intensity * 0.015);
+    const ry = size * 0.055;
+
+    // Radial gradient approximates the blurry ellipse shadow without context.filter blur.
     context.save();
-    context.fillStyle = `${palette.shadow}66`;
-    context.filter = `blur(${size * 0.02}px)`;
+    context.translate(cx, cy);
+    context.scale(1, ry / rx);
+    const blurRadius = rx * 1.4;
+    const shadowGradient = context.createRadialGradient(0, 0, 0, 0, 0, blurRadius);
+    shadowGradient.addColorStop(0, `${palette.shadow}7a`);
+    shadowGradient.addColorStop(0.45, `${palette.shadow}44`);
+    shadowGradient.addColorStop(0.8, `${palette.shadow}1a`);
+    shadowGradient.addColorStop(1, `${palette.shadow}00`);
+    context.fillStyle = shadowGradient;
     context.beginPath();
-    context.ellipse(
-        size * 0.5 + interaction.gazeX * size * 0.03,
-        size * 0.85 + Math.sin(timeMs / 880) * size * 0.01,
-        size * (0.16 + interaction.intensity * 0.015),
-        size * 0.055,
-        0,
-        0,
-        Math.PI * 2,
-    );
+    context.arc(0, 0, blurRadius, 0, Math.PI * 2);
     context.fill();
     context.restore();
 }

package/src/avatars/visuals/minecraftAvatarVisual.ts

@@ -45,13 +45,27 @@ export const minecraftAvatarVisual: AvatarVisualDefinition = {
         context.fillStyle = spotlight;
         context.fillRect(0, 0, size, size);
 
-        context.save();
-        context.fillStyle = 'rgba(0, 0, 0, 0.22)';
-        context.filter = `blur(${size * 0.018}px)`;
-        context.beginPath();
-        context.ellipse(size * 0.5, size * 0.86, size * 0.2, size * 0.06, 0, 0, Math.PI * 2);
-        context.fill();
-        context.restore();
+        {
+            // Radial gradient approximates the blurry ellipse shadow without context.filter blur.
+            const cx = size * 0.5;
+            const cy = size * 0.86;
+            const rx = size * 0.2;
+            const ry = size * 0.06;
+            const blurRadius = rx * 1.4;
+            const shadowGradient = context.createRadialGradient(0, 0, 0, 0, 0, blurRadius);
+            shadowGradient.addColorStop(0, 'rgba(0,0,0,0.28)');
+            shadowGradient.addColorStop(0.45, 'rgba(0,0,0,0.14)');
+            shadowGradient.addColorStop(0.8, 'rgba(0,0,0,0.05)');
+            shadowGradient.addColorStop(1, 'rgba(0,0,0,0)');
+            context.save();
+            context.translate(cx, cy);
+            context.scale(1, ry / rx);
+            context.fillStyle = shadowGradient;
+            context.beginPath();
+            context.arc(0, 0, blurRadius, 0, Math.PI * 2);
+            context.fill();
+            context.restore();
+        }
 
         drawVoxelCuboid(context, {
             x: bodyX,