@promptbook/node 0.112.0-117 → 0.112.0-119

package/umd/index.umd.js

@@ -51,7 +51,7 @@
      * @generated
      * @see https://github.com/webgptorg/promptbook
      */
-    const PROMPTBOOK_ENGINE_VERSION = '0.112.0-117';
+    const PROMPTBOOK_ENGINE_VERSION = '0.112.0-119';
     /**
      * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
      * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -249,7 +249,9 @@
      * @private internal utility of `Book`
      */
     function parseCommitmentHeader(line) {
-        const match = /^([A-Z][A-Z0-9]*(?: [A-Z0-9]+)*)(?:\s+(.*))?$/u.exec(line);
+        // Require at least 2 characters in the first keyword word to avoid treating common
+        // single-letter words (e.g. "V" in Czech, "I" or "A" in English) as commitment headers.
+        const match = /^([A-Z][A-Z0-9]+(?: [A-Z0-9]+)*)(?:\s+(.*))?$/u.exec(line);
         if (!match) {
             return null;
         }
@@ -4514,14 +4516,50 @@
      * Builds the prompt sent to the selected coding runner for one queued user-thread book.
      */
     function buildAgentMessagePrompt(messageRelativePath, agentSystemMessage) {
-        const taskPrompt = _spaceTrim.spaceTrim(`
-            Answer 1 user question
+        return _spaceTrim.spaceTrim((block) => `
+                # Answer 1 user question
 
-            -   Read \`${messageRelativePath}\` and answer the most recent \`MESSAGE @User\`
-            -   Only change the queued message file by appending one new \`MESSAGE @Agent\` block
-            -   Do not modify any other file in the repository
-        `);
-        return `${taskPrompt}\n\n**This is how you should behave:**\n\n${agentSystemMessage.trim()}`;
+                -   Read \`${messageRelativePath}\` and answer the most recent \`MESSAGE @User\`
+                -   Only change the queued message file by appending one new \`MESSAGE @Agent\` block
+                -   Do not modify any other file in the repository
+
+                ## Rules for the answering
+
+                ## Formatting
+
+                - You can use Markdown formatting in the messages like **bold** or *italic*
+
+                ## Sources and citations
+
+                Mark sources and citations like this "【https://example.com/document123.pdf 】"
+
+                At the same time, you can write sources naturally in the text of the answers
+
+                For example:
+
+                > According to paragraph §745b, the fee can be waived for a person over 65 years old. 【https://praha13.cz/2026/paragraph-745.doc】
+
+                - "paragraph §745b" fits naturally in the text.
+                - "【https://praha13.cz/2026/paragraph-745.doc】" The exact format of the quote is important for further processing of the answer.
+                - The "【" and "】" symbols are used to mark the source and will be parsed, inside should be valid URL used as a source for the answer.
+
+                ## Quick buttons
+
+                If there is a meaningful follow-up procedure, use quick buttons at the end of the answer:
+
+                \`\`\`
+                How big is the contract you are posting?
+
+                [Up to 50,000 CZK](?message=We are posting an order up to 50,000 CZK)
+                [Up to 100,000 CZK](?message=We are posting an order up to 100,000 CZK)
+                [Over 100,000 CZK](?message=We are posting an order over 100,000 CZK)
+                \`\`\`
+
+
+                ## This is how you should behave
+
+                ${block(agentSystemMessage)}
+            `);
     }
 
     /**
@@ -15428,21 +15466,22 @@
      * @private helper of `fractalAvatarVisual`
      */
     function drawDragonCurveLayer(context, points, options) {
-        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);
         ribbonGradient.addColorStop(0, `${primaryColor}f2`);
         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();
         context.beginPath();
@@ -16026,11 +16065,23 @@
      * @private helper of `minecraft2AvatarVisual`
      */
     function drawMinecraftShadow(context, size, palette, interaction, timeMs) {
+        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();
     }
@@ -16254,13 +16305,27 @@
             spotlight.addColorStop(1, `${palette.highlight}00`);
             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,
                 y: bodyY,
@@ -17312,6 +17377,35 @@
         y: -0.62,
         z: 0.94,
     });
+    /**
+     * Cache keyed by the `createRandom` factory reference (stable per mounted `<Avatar/>`).
+     *
+     * @private helper of `octopus3dAvatarVisual`
+     */
+    const octopus3dStableStateCache = new WeakMap();
+    /**
+     * Returns the stable per-avatar state, computing it on first access and caching for subsequent frames.
+     *
+     * @private helper of `octopus3dAvatarVisual`
+     */
+    function getOctopus3dStableState(createRandom) {
+        const cached = octopus3dStableStateCache.get(createRandom);
+        if (cached !== undefined) {
+            return cached;
+        }
+        const animationRandom = createRandom('octopus3d-animation-profile');
+        const eyeRandom = createRandom('octopus3d-eye-profile');
+        const leftEyePhaseOffset = eyeRandom() * 0.6;
+        const rightEyePhaseOffset = eyeRandom() * 0.6;
+        const state = {
+            morphologyProfile: createOctopus3MorphologyProfile(createRandom),
+            animationPhase: animationRandom() * Math.PI * 2,
+            leftEyePhaseOffset,
+            rightEyePhaseOffset,
+        };
+        octopus3dStableStateCache.set(createRandom, state);
+        return state;
+    }
     /**
      * Proper 3D Octopus visual built from projected organic meshes and tentacles.
      *
@@ -17324,10 +17418,7 @@
         isAnimated: true,
         supportsPointerTracking: true,
         render({ context, size, palette, createRandom, timeMs, interaction }) {
-            const morphologyProfile = createOctopus3MorphologyProfile(createRandom);
-            const animationRandom = createRandom('octopus3d-animation-profile');
-            const eyeRandom = createRandom('octopus3d-eye-profile');
-            const animationPhase = animationRandom() * Math.PI * 2;
+            const { morphologyProfile, animationPhase, leftEyePhaseOffset, rightEyePhaseOffset } = getOctopus3dStableState(createRandom);
             const sceneCenterX = size * 0.5;
             const sceneCenterY = size * 0.56;
             const bob = Math.sin(timeMs / 920 + animationPhase) * size * 0.014;
@@ -17424,12 +17515,12 @@
                 x: -faceEyeSpacing,
                 y: faceEyeYOffset,
                 z: resolveEllipsoidSurfaceDepth(mantleRadiusX, mantleRadiusY, mantleRadiusZ, -faceEyeSpacing, faceEyeYOffset),
-            }, faceEyeRadiusX, faceEyeRadiusY, mantleCenter, headPitch, headYaw, sceneCenterX, sceneCenterY, size, palette, timeMs, animationPhase + eyeRandom() * 0.6, interaction, morphologyProfile.face.eyeStyle);
+            }, faceEyeRadiusX, faceEyeRadiusY, mantleCenter, headPitch, headYaw, sceneCenterX, sceneCenterY, size, palette, timeMs, animationPhase + leftEyePhaseOffset, interaction, morphologyProfile.face.eyeStyle);
             drawProjectedOrganicEye(context, {
                 x: faceEyeSpacing,
                 y: faceEyeYOffset,
                 z: resolveEllipsoidSurfaceDepth(mantleRadiusX, mantleRadiusY, mantleRadiusZ, faceEyeSpacing, faceEyeYOffset),
-            }, faceEyeRadiusX, faceEyeRadiusY, mantleCenter, headPitch, headYaw, sceneCenterX, sceneCenterY, size, palette, timeMs, animationPhase + 0.7 + eyeRandom() * 0.6, interaction, morphologyProfile.face.eyeStyle);
+            }, faceEyeRadiusX, faceEyeRadiusY, mantleCenter, headPitch, headYaw, sceneCenterX, sceneCenterY, size, palette, timeMs, animationPhase + 0.7 + rightEyePhaseOffset, interaction, morphologyProfile.face.eyeStyle);
             drawProjectedOrganicMouth(context, [
                 {
                     x: -mouthHalfWidth,
@@ -17473,14 +17564,28 @@
     /**
      * Draws the soft ground shadow below the octopus.
      *
+     * Uses a scaled radial gradient instead of `context.filter = 'blur()'` to approximate the
+     * blurry ellipse without triggering a costly software rasterization pass on every frame.
+     *
      * @private helper of `octopus3dAvatarVisual`
      */
     function drawOctopus3dShadow(context, size, palette, interaction, timeMs) {
+        const cx = size * 0.5 + interaction.gazeX * size * 0.04;
+        const cy = size * 0.87 + Math.sin(timeMs / 920) * size * 0.008;
+        const rx = size * (0.18 + interaction.intensity * 0.02);
+        const ry = size * 0.06;
         context.save();
-        context.fillStyle = `${palette.shadow}66`;
-        context.filter = `blur(${size * 0.022}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.04, size * 0.87 + Math.sin(timeMs / 920) * size * 0.008, size * (0.18 + interaction.intensity * 0.02), size * 0.06, 0, 0, Math.PI * 2);
+        context.arc(0, 0, blurRadius, 0, Math.PI * 2);
         context.fill();
         context.restore();
     }
@@ -17711,6 +17816,35 @@
         y: -0.6,
         z: 0.98,
     });
+    /**
+     * Cache keyed by the `createRandom` factory reference (stable per mounted `<Avatar/>`).
+     *
+     * @private helper of `octopus3d2AvatarVisual`
+     */
+    const octopus3d2StableStateCache = new WeakMap();
+    /**
+     * Returns the stable per-avatar state, computing it on first access and caching for subsequent frames.
+     *
+     * @private helper of `octopus3d2AvatarVisual`
+     */
+    function getOctopus3d2StableState(createRandom) {
+        const cached = octopus3d2StableStateCache.get(createRandom);
+        if (cached !== undefined) {
+            return cached;
+        }
+        const animationRandom = createRandom('octopus3d2-animation-profile');
+        const eyeRandom = createRandom('octopus3d2-eye-profile');
+        const leftEyePhaseOffset = eyeRandom() * 0.7;
+        const rightEyePhaseOffset = eyeRandom() * 0.7;
+        const state = {
+            morphologyProfile: createOctopus3MorphologyProfile(createRandom),
+            animationPhase: animationRandom() * Math.PI * 2,
+            leftEyePhaseOffset,
+            rightEyePhaseOffset,
+        };
+        octopus3d2StableStateCache.set(createRandom, state);
+        return state;
+    }
     /**
      * Octopus 3D 2 avatar visual.
      *
@@ -17723,10 +17857,7 @@
         isAnimated: true,
         supportsPointerTracking: true,
         render({ context, size, palette, createRandom, timeMs, interaction }) {
-            const morphologyProfile = createOctopus3MorphologyProfile(createRandom);
-            const animationRandom = createRandom('octopus3d2-animation-profile');
-            const eyeRandom = createRandom('octopus3d2-eye-profile');
-            const animationPhase = animationRandom() * Math.PI * 2;
+            const { morphologyProfile, animationPhase, leftEyePhaseOffset, rightEyePhaseOffset } = getOctopus3d2StableState(createRandom);
             const sceneCenterX = size * 0.5;
             const sceneCenterY = size * 0.575;
             const bob = Math.sin(timeMs / 940 + animationPhase) * size * 0.013;
@@ -17779,8 +17910,8 @@
             const rightEyeLocalCenter = sampleBlobbyOctopusSurfacePoint(surfaceOptions, eyeLatitude, eyeLongitude);
             const eyeRadiusX = size * morphologyProfile.face.eyeRadiusXRatio * 0.78;
             const eyeRadiusY = eyeRadiusX * morphologyProfile.face.eyeHeightRatio * 0.92;
-            drawProjectedOrganicEye(context, leftEyeLocalCenter, eyeRadiusX, eyeRadiusY, meshCenter, rotationX, rotationY, sceneCenterX, sceneCenterY, size, palette, timeMs, animationPhase + eyeRandom() * 0.7, interaction, morphologyProfile.face.eyeStyle);
-            drawProjectedOrganicEye(context, rightEyeLocalCenter, eyeRadiusX, eyeRadiusY, meshCenter, rotationX, rotationY, sceneCenterX, sceneCenterY, size, palette, timeMs, animationPhase + 0.9 + eyeRandom() * 0.7, interaction, morphologyProfile.face.eyeStyle);
+            drawProjectedOrganicEye(context, leftEyeLocalCenter, eyeRadiusX, eyeRadiusY, meshCenter, rotationX, rotationY, sceneCenterX, sceneCenterY, size, palette, timeMs, animationPhase + leftEyePhaseOffset, interaction, morphologyProfile.face.eyeStyle);
+            drawProjectedOrganicEye(context, rightEyeLocalCenter, eyeRadiusX, eyeRadiusY, meshCenter, rotationX, rotationY, sceneCenterX, sceneCenterY, size, palette, timeMs, animationPhase + 0.9 + rightEyePhaseOffset, interaction, morphologyProfile.face.eyeStyle);
             drawProjectedOrganicMouth(context, [
                 sampleBlobbyOctopusSurfacePoint(surfaceOptions, mouthLatitude, mouthCenterLongitude - mouthHalfLongitude),
                 sampleBlobbyOctopusSurfacePoint(surfaceOptions, mouthCurveLatitude, mouthCenterLongitude),
@@ -17809,14 +17940,28 @@
     /**
      * Draws the soft floor shadow that anchors the single mesh in the frame.
      *
+     * Uses a scaled radial gradient instead of `context.filter = 'blur()'` to approximate the
+     * blurry ellipse without triggering a costly software rasterization pass on every frame.
+     *
      * @private helper of `octopus3d2AvatarVisual`
      */
     function drawBlobbyOctopusShadow(context, size, palette, interaction, timeMs, morphologyProfile) {
+        const cx = size * 0.5 + interaction.gazeX * size * 0.045;
+        const cy = size * 0.88 + Math.sin(timeMs / 940) * size * 0.008;
+        const rx = size * (0.18 + (morphologyProfile.body.horizontalStretch - 1) * 0.04 + interaction.intensity * 0.018);
+        const ry = size * 0.062;
         context.save();
-        context.fillStyle = `${palette.shadow}66`;
-        context.filter = `blur(${size * 0.024}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.045, size * 0.88 + Math.sin(timeMs / 940) * size * 0.008, size * (0.18 + (morphologyProfile.body.horizontalStretch - 1) * 0.04 + interaction.intensity * 0.018), size * 0.062, 0, 0, Math.PI * 2);
+        context.arc(0, 0, blurRadius, 0, Math.PI * 2);
         context.fill();
         context.restore();
     }
@@ -17972,6 +18117,40 @@
      * @private helper of `octopus3d3AvatarVisual`
      */
     const OCTOPUS_TENTACLE_COUNT = 8;
+    /**
+     * Cache keyed by the `createRandom` factory reference, which is stable for the lifetime of one
+     * mounted `<Avatar/>` component (created inside `resolveAvatarRenderDefinition` and held in a
+     * React `useMemo`).  Using a `WeakMap` ensures the entry is collected when the component unmounts.
+     *
+     * @private helper of `octopus3d3AvatarVisual`
+     */
+    const stableStateCache = new WeakMap();
+    /**
+     * Returns the stable per-avatar state, computing it on first access and returning the cached
+     * result on every subsequent call within the same `<Avatar/>` mount.
+     *
+     * @private helper of `octopus3d3AvatarVisual`
+     */
+    function getOctopus3d3StableState(createRandom) {
+        const cached = stableStateCache.get(createRandom);
+        if (cached !== undefined) {
+            return cached;
+        }
+        const morphologyProfile = createOctopus3MorphologyProfile(createRandom);
+        const animationRandom = createRandom('octopus3d3-animation-profile');
+        const eyeRandom = createRandom('octopus3d3-eye-profile');
+        const leftEyePhaseOffset = eyeRandom() * 0.7;
+        const rightEyePhaseOffset = eyeRandom() * 0.7;
+        const state = {
+            morphologyProfile,
+            animationPhase: animationRandom() * Math.PI * 2,
+            leftEyePhaseOffset,
+            rightEyePhaseOffset,
+            tentacleProfiles: createContinuousTentacleProfiles(createRandom, morphologyProfile),
+        };
+        stableStateCache.set(createRandom, state);
+        return state;
+    }
     /**
      * Octopus 3D 3 avatar visual.
      *
@@ -17984,11 +18163,7 @@
         isAnimated: true,
         supportsPointerTracking: true,
         render({ context, size, palette, createRandom, timeMs, interaction }) {
-            const morphologyProfile = createOctopus3MorphologyProfile(createRandom);
-            const animationRandom = createRandom('octopus3d3-animation-profile');
-            const eyeRandom = createRandom('octopus3d3-eye-profile');
-            const animationPhase = animationRandom() * Math.PI * 2;
-            const tentacleProfiles = createContinuousTentacleProfiles(createRandom, morphologyProfile);
+            const { morphologyProfile, animationPhase, leftEyePhaseOffset, rightEyePhaseOffset, tentacleProfiles } = getOctopus3d3StableState(createRandom);
             const sceneCenterX = size * 0.5;
             const sceneCenterY = size * 0.535;
             const bob = Math.sin(timeMs / 960 + animationPhase) * size * 0.012;
@@ -18065,8 +18240,8 @@
                 size,
                 palette,
             });
-            drawProjectedOrganicEye(context, sampleContinuousOctopusSurfacePoint(surfaceOptions, eyeLatitude, -eyeLongitude), eyeRadiusX, eyeRadiusY, meshCenter, rotationX, rotationY, sceneCenterX, sceneCenterY, size, palette, timeMs, animationPhase + eyeRandom() * 0.7, interaction, morphologyProfile.face.eyeStyle);
-            drawProjectedOrganicEye(context, sampleContinuousOctopusSurfacePoint(surfaceOptions, eyeLatitude, eyeLongitude), eyeRadiusX, eyeRadiusY, meshCenter, rotationX, rotationY, sceneCenterX, sceneCenterY, size, palette, timeMs, animationPhase + 0.85 + eyeRandom() * 0.7, interaction, morphologyProfile.face.eyeStyle);
+            drawProjectedOrganicEye(context, sampleContinuousOctopusSurfacePoint(surfaceOptions, eyeLatitude, -eyeLongitude), eyeRadiusX, eyeRadiusY, meshCenter, rotationX, rotationY, sceneCenterX, sceneCenterY, size, palette, timeMs, animationPhase + leftEyePhaseOffset, interaction, morphologyProfile.face.eyeStyle);
+            drawProjectedOrganicEye(context, sampleContinuousOctopusSurfacePoint(surfaceOptions, eyeLatitude, eyeLongitude), eyeRadiusX, eyeRadiusY, meshCenter, rotationX, rotationY, sceneCenterX, sceneCenterY, size, palette, timeMs, animationPhase + 0.85 + rightEyePhaseOffset, interaction, morphologyProfile.face.eyeStyle);
             drawProjectedOrganicMouth(context, [
                 sampleContinuousOctopusSurfacePoint(surfaceOptions, mouthLatitude, mouthCenterLongitude - mouthHalfLongitude),
                 sampleContinuousOctopusSurfacePoint(surfaceOptions, mouthCurveLatitude, mouthCenterLongitude),
@@ -18117,14 +18292,30 @@
     /**
      * Draws the soft lower shadow that anchors the octopus in the avatar frame.
      *
+     * Uses a scaled radial gradient instead of `context.filter = 'blur()'` to approximate the
+     * blurry ellipse without triggering a costly software rasterization pass on every frame.
+     *
      * @private helper of `octopus3d3AvatarVisual`
      */
     function drawContinuousOctopusShadow(context, size, palette, interaction, timeMs, morphologyProfile) {
+        const cx = size * 0.5 + interaction.gazeX * size * 0.045;
+        const cy = size * 0.9 + Math.sin(timeMs / 980) * size * 0.007;
+        const rx = size * (0.19 + morphologyProfile.tentacles.rootSpreadScale * 0.022 + interaction.intensity * 0.02);
+        const ry = size * 0.06;
+        // Scale the context so that drawing a circle produces the correct ellipse aspect ratio,
+        // then fill with a radial gradient that approximates the blurry edge without context.filter.
         context.save();
-        context.fillStyle = `${palette.shadow}66`;
-        context.filter = `blur(${size * 0.025}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.045, size * 0.9 + Math.sin(timeMs / 980) * size * 0.007, size * (0.19 + morphologyProfile.tentacles.rootSpreadScale * 0.022 + interaction.intensity * 0.02), size * 0.06, 0, 0, Math.PI * 2);
+        context.arc(0, 0, blurRadius, 0, Math.PI * 2);
         context.fill();
         context.restore();
     }
@@ -30500,6 +30691,7 @@
             noUi: options.noUi,
             thinkingLevel: options.thinkingLevel,
             waitForUser: false,
+            waitBetweenPrompts: 0,
             noCommit: true,
             ignoreGitChanges: true,
             normalizeLineEndings: false,
@@ -30630,6 +30822,48 @@
         return Book.parse(agentSource).agentName.trim() || 'Agent';
     }
 
+    // Note: [💞] Ignore a discrepancy between file name and entity name
+    /**
+     * All CLI harness names supported by `CliAgent` and `ptbk agent exec`.
+     *
+     * @public exported from `@promptbook/node`
+     */
+    const CLI_AGENT_HARNESS_NAMES = [
+        'openai-codex',
+        'github-copilot',
+        'cline',
+        'claude-code',
+        'opencode',
+        'gemini',
+    ];
+    /**
+     * All supported thinking-level values for CLI coding-agent runners.
+     *
+     * @public exported from `@promptbook/node`
+     */
+    const CLI_AGENT_THINKING_LEVEL_VALUES = ['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`
+     */
+    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`
+     */
+    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`
+     */
+    const PTBK_THINKING_LEVEL_ENV = 'PTBK_THINKING_LEVEL';
+
     /**
      * Default non-interactive mode used by `CliAgent`.
      *
@@ -30642,6 +30876,9 @@
      * It uses the same harnesses and execution path as `ptbk agent exec`, running the runner
      * in-process instead of spawning a separate CLI process.
      *
+     * 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`
      */
     class CliAgent {
@@ -30657,7 +30894,7 @@
          * @returns Final agent answer.
          */
         async run(message, options = {}) {
-            var _a, _b;
+            var _a, _b, _c, _d, _e, _f;
             const normalizedMessage = message.trim();
             if (!normalizedMessage) {
                 throw new NotAllowed('Pass a non-empty message to `CliAgent.run(...)`.');
@@ -30665,15 +30902,26 @@
             const resolvedSource = await resolveBookNodeAgentSource(this.options);
             const agentPath = await this.resolveExecutableAgentPath(resolvedSource);
             const mergedOptions = mergeCliAgentRunOptions(this.options, options);
+            const harness = (_a = mergedOptions.harness) !== null && _a !== void 0 ? _a : resolveCliAgentHarnessFromEnv();
+            if (!harness) {
+                throw new NotAllowed(spaceTrim(`
+                    No harness specified for \`CliAgent\`. Pass \`harness\` in the constructor options or per-run options,
+                    or set the \`${PTBK_HARNESS_ENV}\` environment variable.
+
+                    Available harnesses: ${CLI_AGENT_HARNESS_NAMES.join(', ')}
+
+                    Example: \`PTBK_HARNESS=claude-code\`
+                `));
+            }
             const result = await executeAgentChatTurn({
                 agentPath,
                 messages: [{ sender: 'USER', content: normalizedMessage }],
-                agentName: mergedOptions.harness,
-                model: mergedOptions.model,
-                noUi: (_a = mergedOptions.noUi) !== null && _a !== void 0 ? _a : DEFAULT_CLI_AGENT_IS_NO_UI,
-                thinkingLevel: mergedOptions.thinkingLevel,
-                allowCredits: (_b = mergedOptions.allowCredits) !== null && _b !== void 0 ? _b : false,
-                isVerbose: false,
+                agentName: harness,
+                model: (_b = mergedOptions.model) !== null && _b !== void 0 ? _b : process.env[PTBK_MODEL_ENV],
+                noUi: (_c = mergedOptions.noUi) !== null && _c !== void 0 ? _c : DEFAULT_CLI_AGENT_IS_NO_UI,
+                thinkingLevel: (_d = mergedOptions.thinkingLevel) !== null && _d !== void 0 ? _d : resolveCliAgentThinkingLevelFromEnv(),
+                allowCredits: (_e = mergedOptions.allowCredits) !== null && _e !== void 0 ? _e : false,
+                isVerbose: (_f = mergedOptions.isVerbose) !== null && _f !== void 0 ? _f : false,
                 context: mergedOptions.context,
                 currentWorkingDirectory: resolvedSource.currentWorkingDirectory,
             });
@@ -30702,16 +30950,55 @@
      * @private internal utility of `CliAgent`
      */
     function mergeCliAgentRunOptions(defaults, overrides) {
-        var _a, _b, _c, _d, _e, _f;
+        var _a, _b, _c, _d, _e, _f, _g;
         return {
             allowCredits: (_a = overrides.allowCredits) !== null && _a !== void 0 ? _a : defaults.allowCredits,
             context: (_b = overrides.context) !== null && _b !== void 0 ? _b : defaults.context,
             harness: (_c = overrides.harness) !== null && _c !== void 0 ? _c : defaults.harness,
-            model: (_d = overrides.model) !== null && _d !== void 0 ? _d : defaults.model,
-            noUi: (_e = overrides.noUi) !== null && _e !== void 0 ? _e : defaults.noUi,
-            thinkingLevel: (_f = overrides.thinkingLevel) !== null && _f !== void 0 ? _f : defaults.thinkingLevel,
+            isVerbose: (_d = overrides.isVerbose) !== null && _d !== void 0 ? _d : defaults.isVerbose,
+            model: (_e = overrides.model) !== null && _e !== void 0 ? _e : defaults.model,
+            noUi: (_f = overrides.noUi) !== null && _f !== void 0 ? _f : defaults.noUi,
+            thinkingLevel: (_g = overrides.thinkingLevel) !== null && _g !== void 0 ? _g : defaults.thinkingLevel,
         };
     }
+    /**
+     * Reads and validates the harness name from the `PTBK_HARNESS` environment variable.
+     *
+     * @private internal utility of `CliAgent`
+     */
+    function resolveCliAgentHarnessFromEnv() {
+        const envValue = process.env[PTBK_HARNESS_ENV];
+        if (!envValue) {
+            return undefined;
+        }
+        if (!CLI_AGENT_HARNESS_NAMES.includes(envValue)) {
+            throw new NotAllowed(spaceTrim(`
+                Invalid value for \`${PTBK_HARNESS_ENV}\` environment variable: \`${envValue}\`
+
+                Must be one of: ${CLI_AGENT_HARNESS_NAMES.join(', ')}
+            `));
+        }
+        return envValue;
+    }
+    /**
+     * Reads and validates the thinking level from the `PTBK_THINKING_LEVEL` environment variable.
+     *
+     * @private internal utility of `CliAgent`
+     */
+    function resolveCliAgentThinkingLevelFromEnv() {
+        const envValue = process.env[PTBK_THINKING_LEVEL_ENV];
+        if (!envValue) {
+            return undefined;
+        }
+        if (!CLI_AGENT_THINKING_LEVEL_VALUES.includes(envValue)) {
+            throw new NotAllowed(spaceTrim(`
+                Invalid value for \`${PTBK_THINKING_LEVEL_ENV}\` environment variable: \`${envValue}\`
+
+                Must be one of: ${CLI_AGENT_THINKING_LEVEL_VALUES.join(', ')}
+            `));
+        }
+        return envValue;
+    }
     /**
      * Creates the stable temporary path used when `CliAgent` is initialized from in-memory Book source.
      *
@@ -33493,7 +33780,7 @@
                     return { skippedReason: 'invalid_data_url' };
                 }
                 return {
-                    file: new File([parsed.buffer], parsed.filename, {
+                    file: new File([new Uint8Array(parsed.buffer)], parsed.filename, {
                         type: parsed.mimeType,
                     }),
                     sizeBytes: parsed.buffer.length,
@@ -47646,10 +47933,15 @@
     exports.AGENT_MESSAGES_DIRECTORY_PATH = AGENT_MESSAGES_DIRECTORY_PATH;
     exports.AGENT_QUEUED_MESSAGES_DIRECTORY_PATH = AGENT_QUEUED_MESSAGES_DIRECTORY_PATH;
     exports.BOOK_LANGUAGE_VERSION = BOOK_LANGUAGE_VERSION;
+    exports.CLI_AGENT_HARNESS_NAMES = CLI_AGENT_HARNESS_NAMES;
+    exports.CLI_AGENT_THINKING_LEVEL_VALUES = CLI_AGENT_THINKING_LEVEL_VALUES;
     exports.CliAgent = CliAgent;
     exports.FileCacheStorage = FileCacheStorage;
     exports.LiteAgent = LiteAgent;
     exports.PROMPTBOOK_ENGINE_VERSION = PROMPTBOOK_ENGINE_VERSION;
+    exports.PTBK_HARNESS_ENV = PTBK_HARNESS_ENV;
+    exports.PTBK_MODEL_ENV = PTBK_MODEL_ENV;
+    exports.PTBK_THINKING_LEVEL_ENV = PTBK_THINKING_LEVEL_ENV;
     exports.createPipelineCollectionFromDirectory = createPipelineCollectionFromDirectory;
     exports.getAllCommitmentsToolFunctionsForNode = getAllCommitmentsToolFunctionsForNode;