@promptbook/components 0.112.0-64 → 0.112.0-66

package/esm/index.es.js

@@ -1,9 +1,9 @@
 import { jsxs, jsx, Fragment } from 'react/jsx-runtime';
 import { spaceTrim as spaceTrim$1 } from 'spacetrim';
+import { posix, basename, join, dirname, isAbsolute } from 'path';
 import { useMemo, useId, useState, memo, useRef, useEffect, createContext, useContext, useCallback, forwardRef } from 'react';
 import { SHA256 } from 'crypto-js';
 import hexEncoder from 'crypto-js/enc-hex';
-import { basename, join, dirname, isAbsolute } from 'path';
 import { randomBytes } from 'crypto';
 import moment from 'moment';
 import { lookup, extension } from 'mime-types';
@@ -40,7 +40,7 @@ const BOOK_LANGUAGE_VERSION = '2.0.0';
  * @generated
  * @see https://github.com/webgptorg/promptbook
  */
-const PROMPTBOOK_ENGINE_VERSION = '0.112.0-64';
+const PROMPTBOOK_ENGINE_VERSION = '0.112.0-66';
 /**
  * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
  * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -973,6 +973,29 @@ function saturate(amount) {
 }
 // TODO: Maybe implement by mix+hsl
 
+/**
+ * Relative directory name without the `./` prefix for Git ignore rules and glob patterns.
+ *
+ * @private internal utility for Promptbook-owned temp files
+ */
+const PROMPTBOOK_TEMP_DIRECTORY_NAME = '.promptbook';
+/**
+ * Builds one project-relative path inside the shared Promptbook working directory.
+ *
+ * @private internal utility for Promptbook-owned temp files
+ */
+function getPromptbookTempPath(...pathSegments) {
+    return `./${getPromptbookTempPosixPath(...pathSegments)}`;
+}
+/**
+ * Builds one POSIX path fragment inside the shared Promptbook working directory for globs and generated text files.
+ *
+ * @private internal utility for Promptbook-owned temp files
+ */
+function getPromptbookTempPosixPath(...pathSegments) {
+    return posix.join(PROMPTBOOK_TEMP_DIRECTORY_NAME, ...pathSegments);
+}
+
 /**
  * Returns the same value that is passed as argument.
  * No side effects.
@@ -1175,7 +1198,6 @@ const DEFAULT_MAX_CONCURRENT_UPLOADS = 5;
  */
 const DEFAULT_MAX_EXECUTION_ATTEMPTS = 7; // <- TODO: [🤹‍♂️]
 // <- TODO: [🕝] Make also `AGENTS_DIRNAME_ALTERNATIVES`
-// TODO: Just `.promptbook` in config, hardcode subfolders like `download-cache` or `execution-cache`
 /**
  * Where to store the temporary downloads
  *
@@ -1183,7 +1205,15 @@ const DEFAULT_MAX_EXECUTION_ATTEMPTS = 7; // <- TODO: [🤹‍♂️]
  *
  * @public exported from `@promptbook/core`
  */
-const DEFAULT_DOWNLOAD_CACHE_DIRNAME = './.promptbook/download-cache';
+const DEFAULT_DOWNLOAD_CACHE_DIRNAME = getPromptbookTempPath('download-cache');
+/**
+ * Where to store the cache of executions for promptbook CLI
+ *
+ * Note: When the folder does not exist, it is created recursively
+ *
+ * @public exported from `@promptbook/core`
+ */
+getPromptbookTempPath('execution-cache');
 /**
  * Where to store the scrape cache
  *
@@ -1191,7 +1221,7 @@ const DEFAULT_DOWNLOAD_CACHE_DIRNAME = './.promptbook/download-cache';
  *
  * @public exported from `@promptbook/core`
  */
-const DEFAULT_SCRAPE_CACHE_DIRNAME = './.promptbook/scrape-cache';
+const DEFAULT_SCRAPE_CACHE_DIRNAME = getPromptbookTempPath('scrape-cache');
 /**
  * Default remote server URL for the Promptbook
  *
@@ -2825,6 +2855,177 @@ function drawFractalCore(context, size, palette, timeMs, corePhase) {
     context.restore();
 }
 
+/* eslint-disable no-magic-numbers */
+/**
+ * Builds the seeded six-face texture pack used by the Minecraft-style head cuboid.
+ *
+ * @param random Seeded random generator.
+ * @param palette Derived avatar palette.
+ * @param hasHeadband Whether the generated avatar should include a colored headband.
+ * @returns Head cuboid textures.
+ *
+ * @private helper of the Minecraft avatar visuals
+ */
+function createMinecraftHeadTextures(random, palette, hasHeadband) {
+    const faceTexture = createMinecraftFaceTexture(random, palette, hasHeadband);
+    const hairColor = random() < 0.5 ? palette.primary : palette.secondary;
+    const skinColor = palette.highlight;
+    const headbandColor = hasHeadband ? palette.accent : hairColor;
+    const sideTexture = createFilledTexture(skinColor);
+    const backTexture = createFilledTexture(skinColor);
+    const topTexture = createFilledTexture(hairColor);
+    const bottomTexture = createFilledTexture(`${palette.shadow}cc`);
+    fillTextureRect(sideTexture, 0, 0, 8, 3, hairColor);
+    fillTextureRect(backTexture, 0, 0, 8, 5, hairColor);
+    fillTextureRect(backTexture, 1, 5, 6, 1, hairColor);
+    if (hasHeadband) {
+        fillTextureRect(sideTexture, 0, 2, 8, 1, headbandColor);
+        fillTextureRect(backTexture, 0, 2, 8, 1, headbandColor);
+        fillTextureRect(topTexture, 0, 4, 8, 1, headbandColor);
+    }
+    sideTexture[4][4] = `${palette.shadow}99`;
+    sideTexture[5][4] = `${palette.shadow}cc`;
+    backTexture[6][2] = `${palette.shadow}99`;
+    backTexture[6][5] = `${palette.shadow}99`;
+    return {
+        front: faceTexture,
+        back: backTexture,
+        left: sideTexture,
+        right: mirrorMinecraftTexture(sideTexture),
+        top: topTexture,
+        bottom: bottomTexture,
+    };
+}
+/**
+ * Builds the seeded six-face texture pack used by the Minecraft-style torso cuboid.
+ *
+ * @param random Seeded random generator.
+ * @param palette Derived avatar palette.
+ * @returns Torso cuboid textures.
+ *
+ * @private helper of the Minecraft avatar visuals
+ */
+function createMinecraftTorsoTextures(random, palette) {
+    const frontTexture = createMinecraftShirtTexture(random, palette);
+    const sideTexture = createFilledTexture(palette.primary);
+    const backTexture = createFilledTexture(palette.primary);
+    const topTexture = createFilledTexture(`${palette.highlight}dd`);
+    const bottomTexture = createFilledTexture(`${palette.shadow}dd`);
+    const stripeColor = random() < 0.5 ? palette.secondary : palette.highlight;
+    fillTextureRect(sideTexture, 0, 0, 8, 2, palette.shadow);
+    fillTextureRect(backTexture, 0, 0, 8, 2, palette.shadow);
+    fillTextureRect(backTexture, 3, 2, 2, 6, stripeColor);
+    fillTextureRect(sideTexture, 4, 2, 1, 6, stripeColor);
+    fillTextureRect(topTexture, 0, 0, 8, 2, palette.shadow);
+    fillTextureRect(topTexture, 2, 2, 4, 4, stripeColor);
+    return {
+        front: frontTexture,
+        back: backTexture,
+        left: sideTexture,
+        right: mirrorMinecraftTexture(sideTexture),
+        top: topTexture,
+        bottom: bottomTexture,
+    };
+}
+/**
+ * Mirrors one Minecraft texture horizontally.
+ *
+ * @param texture Source texture.
+ * @returns Mirrored texture copy.
+ *
+ * @private helper of the Minecraft avatar visuals
+ */
+function mirrorMinecraftTexture(texture) {
+    return texture.map((row) => [...row].reverse());
+}
+/**
+ * Creates the front-face pixel texture for the cube head.
+ *
+ * @param random Seeded random generator.
+ * @param palette Derived avatar palette.
+ * @param hasHeadband Whether the avatar should render a headband row.
+ * @returns 8x8 pixel texture.
+ *
+ * @private helper of the Minecraft avatar visuals
+ */
+function createMinecraftFaceTexture(random, palette, hasHeadband) {
+    const texture = createFilledTexture(palette.highlight);
+    const hairlineColor = random() < 0.5 ? palette.primary : palette.secondary;
+    const cheekColor = random() < 0.5 ? `${palette.accent}bb` : `${palette.secondary}bb`;
+    fillTextureRect(texture, 0, 0, 8, 2, hairlineColor);
+    texture[2][0] = hairlineColor;
+    texture[2][7] = hairlineColor;
+    texture[3][0] = hairlineColor;
+    texture[3][7] = hairlineColor;
+    if (hasHeadband) {
+        fillTextureRect(texture, 0, 2, 8, 1, palette.accent);
+    }
+    texture[3][2] = palette.ink;
+    texture[3][5] = palette.ink;
+    texture[4][2] = '#ffffff';
+    texture[4][5] = '#ffffff';
+    texture[5][1] = cheekColor;
+    texture[5][6] = cheekColor;
+    texture[5][3] = palette.shadow;
+    texture[5][4] = palette.shadow;
+    texture[6][3] = palette.shadow;
+    texture[6][4] = palette.shadow;
+    return texture;
+}
+/**
+ * Creates the front-face pixel texture for the torso.
+ *
+ * @param random Seeded random generator.
+ * @param palette Derived avatar palette.
+ * @returns 8x8 torso texture.
+ *
+ * @private helper of the Minecraft avatar visuals
+ */
+function createMinecraftShirtTexture(random, palette) {
+    const texture = createFilledTexture(palette.primary);
+    const stripeColor = random() < 0.5 ? palette.secondary : palette.highlight;
+    fillTextureRect(texture, 0, 0, 8, 2, palette.shadow);
+    for (let rowIndex = 2; rowIndex < 8; rowIndex++) {
+        texture[rowIndex][3] = stripeColor;
+        texture[rowIndex][4] = stripeColor;
+    }
+    texture[4][1] = palette.accent;
+    texture[4][6] = palette.accent;
+    texture[5][2] = palette.highlight;
+    texture[5][5] = palette.highlight;
+    return texture;
+}
+/**
+ * Creates one solid-color 8x8 Minecraft texture.
+ *
+ * @param color Fill color.
+ * @returns Filled 8x8 texture.
+ *
+ * @private helper of the Minecraft avatar visuals
+ */
+function createFilledTexture(color) {
+    return Array.from({ length: 8 }, () => Array.from({ length: 8 }, () => color));
+}
+/**
+ * Fills one rectangular area inside a mutable Minecraft texture.
+ *
+ * @param texture Mutable target texture.
+ * @param x Left texture coordinate.
+ * @param y Top texture coordinate.
+ * @param width Rectangle width.
+ * @param height Rectangle height.
+ * @param color Fill color.
+ *
+ * @private helper of the Minecraft avatar visuals
+ */
+function fillTextureRect(texture, x, y, width, height, color) {
+    for (let rowIndex = y; rowIndex < y + height; rowIndex++) {
+        for (let columnIndex = x; columnIndex < x + width; columnIndex++) {
+            texture[rowIndex][columnIndex] = color;
+        }
+    }
+}
+
 /* eslint-disable no-magic-numbers */
 /**
  * Minecraft-style 3D avatar visual.
@@ -2849,8 +3050,8 @@ const minecraftAvatarVisual = {
         const bodyX = size * 0.33;
         const bodyY = headY + headSize * 0.96;
         const hasHeadband = random() < 0.5;
-        const faceTexture = createMinecraftFaceTexture(createRandom('minecraft-face'), palette, hasHeadband);
-        const shirtTexture = createMinecraftShirtTexture(createRandom('minecraft-shirt'), palette);
+        const headTextures = createMinecraftHeadTextures(createRandom('minecraft-face'), palette, hasHeadband);
+        const torsoTextures = createMinecraftTorsoTextures(createRandom('minecraft-shirt'), palette);
         drawAvatarFrame(context, size, palette);
         const spotlight = context.createRadialGradient(size * 0.5, size * 0.18, size * 0.05, size * 0.5, size * 0.18, size * 0.5);
         spotlight.addColorStop(0, `${palette.highlight}66`);
@@ -2870,7 +3071,7 @@ const minecraftAvatarVisual = {
             width: bodyWidth,
             height: bodyHeight,
             depth: bodyDepth,
-            frontTexture: shirtTexture,
+            frontTexture: torsoTextures.front,
             topColor: `${palette.highlight}cc`,
             sideColor: `${palette.secondary}dd`,
             outlineColor: `${palette.shadow}aa`,
@@ -2881,7 +3082,7 @@ const minecraftAvatarVisual = {
             width: headSize,
             height: headSize,
             depth,
-            frontTexture: faceTexture,
+            frontTexture: headTextures.front,
             topColor: `${palette.highlight}ee`,
             sideColor: `${palette.secondary}ee`,
             outlineColor: `${palette.shadow}cc`,
@@ -2946,72 +3147,505 @@ function drawVoxelCuboid(context, cuboid) {
     context.closePath();
     context.stroke();
 }
+
+/* eslint-disable no-magic-numbers */
 /**
- * Creates the front-face pixel texture for the cube head.
+ * Fixed scene camera distance used for the proper-3D projection.
  *
- * @param random Seeded random generator.
+ * @private helper of `minecraft2AvatarVisual`
+ */
+const CAMERA_DISTANCE_RATIO = 1.4;
+/**
+ * Shared light direction used to shade projected cuboid faces.
+ *
+ * @private helper of `minecraft2AvatarVisual`
+ */
+const LIGHT_DIRECTION = normalizeVector3({
+    x: 0.4,
+    y: -0.65,
+    z: 0.92,
+});
+/**
+ * Minecraft 3D 2 avatar visual.
+ *
+ * @private built-in avatar visual
+ */
+const minecraft2AvatarVisual = {
+    id: 'minecraft2',
+    title: 'Minecraft 3D 2',
+    description: 'Proper 3D Minecraft-style portrait with textured cuboids and pointer-driven head turns.',
+    isAnimated: true,
+    supportsPointerTracking: true,
+    render({ context, size, palette, createRandom, timeMs, interaction }) {
+        const spotlightY = size * 0.22;
+        const headRandom = createRandom('minecraft2-head');
+        const hasHeadband = headRandom() < 0.5;
+        const headTextures = createMinecraftHeadTextures(createRandom('minecraft2-head-textures'), palette, hasHeadband);
+        const torsoTextures = createMinecraftTorsoTextures(createRandom('minecraft2-body-textures'), palette);
+        const bob = Math.sin(timeMs / 880) * size * 0.014;
+        const bodyYaw = -0.24 + Math.sin(timeMs / 2300) * 0.06 + interaction.bodyOffsetX * 0.16;
+        const bodyPitch = -0.12 + Math.cos(timeMs / 2800) * 0.02 - interaction.bodyOffsetY * 0.06;
+        const headYaw = -0.18 + Math.sin(timeMs / 1900 + 0.6) * 0.05 + interaction.gazeX * 0.62;
+        const headPitch = -0.12 + Math.cos(timeMs / 2400 + 1.1) * 0.03 - interaction.gazeY * 0.38;
+        const sceneCenterX = size * 0.5;
+        const sceneCenterY = size * 0.57;
+        const bodyWidth = size * 0.225;
+        const bodyHeight = size * 0.245;
+        const bodyDepth = size * 0.145;
+        const headSize = size * 0.24;
+        const headLift = size * 0.205;
+        const headForwardShift = interaction.intensity * size * 0.018;
+        const sceneCuboids = [
+            {
+                center: {
+                    x: interaction.bodyOffsetX * size * 0.026,
+                    y: size * 0.05 + interaction.bodyOffsetY * size * 0.018 + bob,
+                    z: 0,
+                },
+                width: bodyWidth,
+                height: bodyHeight,
+                depth: bodyDepth,
+                rotationX: bodyPitch,
+                rotationY: bodyYaw,
+                textures: torsoTextures,
+                outlineColor: `${palette.shadow}cc`,
+            },
+            {
+                center: {
+                    x: interaction.bodyOffsetX * size * 0.018 + interaction.gazeX * size * 0.016,
+                    y: -headLift + bob * 1.15,
+                    z: headForwardShift,
+                },
+                width: headSize,
+                height: headSize,
+                depth: headSize,
+                rotationX: headPitch,
+                rotationY: headYaw,
+                textures: headTextures,
+                outlineColor: `${palette.shadow}dd`,
+            },
+        ];
+        const visibleFaces = sceneCuboids
+            .flatMap((cuboid) => resolveVisibleCuboidFaces(cuboid, size, sceneCenterX, sceneCenterY))
+            .sort((firstFace, secondFace) => firstFace.averageDepth - secondFace.averageDepth);
+        drawAvatarFrame(context, size, palette);
+        drawMinecraftBackdrop(context, size, palette, sceneCenterX, spotlightY, interaction, timeMs);
+        drawMinecraftShadow(context, size, palette, interaction, timeMs);
+        for (const visibleFace of visibleFaces) {
+            drawTexturedProjectedFace(context, visibleFace);
+        }
+    },
+};
+/**
+ * Draws the shared background atmosphere behind the Minecraft 3D 2 portrait.
+ *
+ * @param context Canvas 2D context.
+ * @param size Canvas size in CSS pixels.
  * @param palette Derived avatar palette.
- * @param hasHeadband Whether the avatar should render a headband row.
- * @returns 8x8 pixel texture.
+ * @param sceneCenterX Horizontal scene center.
+ * @param spotlightY Vertical spotlight anchor.
+ * @param interaction Smoothed pointer-aware interaction state.
+ * @param timeMs Current animation time in milliseconds.
  *
- * @private helper of `minecraftAvatarVisual`
+ * @private helper of `minecraft2AvatarVisual`
  */
-function createMinecraftFaceTexture(random, palette, hasHeadband) {
-    const texture = Array.from({ length: 8 }, () => Array.from({ length: 8 }, () => palette.highlight));
-    const hairlineColor = random() < 0.5 ? palette.primary : palette.secondary;
-    const cheekColor = random() < 0.5 ? `${palette.accent}bb` : `${palette.secondary}bb`;
-    for (let rowIndex = 0; rowIndex < 2; rowIndex++) {
-        for (let columnIndex = 0; columnIndex < 8; columnIndex++) {
-            texture[rowIndex][columnIndex] = hairlineColor;
+function drawMinecraftBackdrop(context, size, palette, sceneCenterX, spotlightY, interaction, timeMs) {
+    const spotlightGradient = context.createRadialGradient(sceneCenterX + interaction.gazeX * size * 0.08, spotlightY + interaction.gazeY * size * 0.05, size * 0.03, sceneCenterX, spotlightY, size * 0.52);
+    spotlightGradient.addColorStop(0, `${palette.highlight}66`);
+    spotlightGradient.addColorStop(0.42, `${palette.accent}1d`);
+    spotlightGradient.addColorStop(1, `${palette.highlight}00`);
+    context.fillStyle = spotlightGradient;
+    context.fillRect(0, 0, size, size);
+    const rimGradient = context.createLinearGradient(0, size * 0.14, 0, size * 0.92);
+    rimGradient.addColorStop(0, `${palette.highlight}12`);
+    rimGradient.addColorStop(0.55, `${palette.secondary}0a`);
+    rimGradient.addColorStop(1, `${palette.shadow}00`);
+    context.fillStyle = rimGradient;
+    context.fillRect(0, 0, size, size);
+    context.save();
+    context.globalAlpha = 0.08 + interaction.intensity * 0.04;
+    context.fillStyle = palette.highlight;
+    context.beginPath();
+    context.arc(size * 0.72 + Math.sin(timeMs / 1600) * size * 0.03, size * 0.2 + Math.cos(timeMs / 1400) * size * 0.018, size * 0.025, 0, Math.PI * 2);
+    context.fill();
+    context.restore();
+}
+/**
+ * Draws the soft floor shadow used to anchor the cuboids in the frame.
+ *
+ * @param context Canvas 2D context.
+ * @param size Canvas size in CSS pixels.
+ * @param palette Derived avatar palette.
+ * @param interaction Smoothed pointer-aware interaction state.
+ * @param timeMs Current animation time in milliseconds.
+ *
+ * @private helper of `minecraft2AvatarVisual`
+ */
+function drawMinecraftShadow(context, size, palette, interaction, timeMs) {
+    context.save();
+    context.fillStyle = `${palette.shadow}66`;
+    context.filter = `blur(${size * 0.02}px)`;
+    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.fill();
+    context.restore();
+}
+/**
+ * Resolves all visible projected faces for one scene cuboid.
+ *
+ * @param cuboid Scene cuboid definition.
+ * @param size Canvas size in CSS pixels.
+ * @param sceneCenterX Horizontal scene center.
+ * @param sceneCenterY Vertical scene center.
+ * @returns Visible faces sorted later by depth.
+ *
+ * @private helper of `minecraft2AvatarVisual`
+ */
+function resolveVisibleCuboidFaces(cuboid, size, sceneCenterX, sceneCenterY) {
+    const halfWidth = cuboid.width / 2;
+    const halfHeight = cuboid.height / 2;
+    const halfDepth = cuboid.depth / 2;
+    const faceDefinitions = [
+        {
+            texture: cuboid.textures.front,
+            corners: [
+                { x: -halfWidth, y: -halfHeight, z: halfDepth },
+                { x: halfWidth, y: -halfHeight, z: halfDepth },
+                { x: halfWidth, y: halfHeight, z: halfDepth },
+                { x: -halfWidth, y: halfHeight, z: halfDepth },
+            ],
+        },
+        {
+            texture: cuboid.textures.back,
+            corners: [
+                { x: halfWidth, y: -halfHeight, z: -halfDepth },
+                { x: -halfWidth, y: -halfHeight, z: -halfDepth },
+                { x: -halfWidth, y: halfHeight, z: -halfDepth },
+                { x: halfWidth, y: halfHeight, z: -halfDepth },
+            ],
+        },
+        {
+            texture: cuboid.textures.right,
+            corners: [
+                { x: halfWidth, y: -halfHeight, z: halfDepth },
+                { x: halfWidth, y: -halfHeight, z: -halfDepth },
+                { x: halfWidth, y: halfHeight, z: -halfDepth },
+                { x: halfWidth, y: halfHeight, z: halfDepth },
+            ],
+        },
+        {
+            texture: cuboid.textures.left,
+            corners: [
+                { x: -halfWidth, y: -halfHeight, z: -halfDepth },
+                { x: -halfWidth, y: -halfHeight, z: halfDepth },
+                { x: -halfWidth, y: halfHeight, z: halfDepth },
+                { x: -halfWidth, y: halfHeight, z: -halfDepth },
+            ],
+        },
+        {
+            texture: cuboid.textures.top,
+            corners: [
+                { x: -halfWidth, y: -halfHeight, z: -halfDepth },
+                { x: halfWidth, y: -halfHeight, z: -halfDepth },
+                { x: halfWidth, y: -halfHeight, z: halfDepth },
+                { x: -halfWidth, y: -halfHeight, z: halfDepth },
+            ],
+        },
+        {
+            texture: cuboid.textures.bottom,
+            corners: [
+                { x: -halfWidth, y: halfHeight, z: halfDepth },
+                { x: halfWidth, y: halfHeight, z: halfDepth },
+                { x: halfWidth, y: halfHeight, z: -halfDepth },
+                { x: -halfWidth, y: halfHeight, z: -halfDepth },
+            ],
+        },
+    ];
+    const visibleFaces = faceDefinitions
+        .map((faceDefinition) => {
+        const transformedCorners = faceDefinition.corners.map((corner) => transformScenePoint(corner, cuboid.center, cuboid.rotationX, cuboid.rotationY));
+        const faceNormal = normalizeVector3(crossProduct3D(subtractPoint3D(transformedCorners[1], transformedCorners[0]), subtractPoint3D(transformedCorners[2], transformedCorners[0])));
+        if (faceNormal.z <= 0.02) {
+            return null;
         }
+        const projectedCorners = transformedCorners.map((corner) => projectScenePoint(corner, size, sceneCenterX, sceneCenterY));
+        return {
+            corners: projectedCorners,
+            texture: faceDefinition.texture,
+            averageDepth: transformedCorners.reduce((depthSum, corner) => depthSum + corner.z, 0) / transformedCorners.length,
+            lightIntensity: clampNumber$1(dotProduct3D(faceNormal, LIGHT_DIRECTION), -1, 1),
+            outlineColor: cuboid.outlineColor,
+        };
+    });
+    return visibleFaces.filter((visibleFace) => visibleFace !== null);
+}
+/**
+ * Draws one projected textured face by tessellating its texture cells into quads.
+ *
+ * @param context Canvas 2D context.
+ * @param face Visible projected face.
+ *
+ * @private helper of `minecraft2AvatarVisual`
+ */
+function drawTexturedProjectedFace(context, face) {
+    var _a;
+    const rows = face.texture.length;
+    const columns = ((_a = face.texture[0]) === null || _a === void 0 ? void 0 : _a.length) || 0;
+    if (rows === 0 || columns === 0) {
+        return;
     }
-    texture[2][0] = hairlineColor;
-    texture[2][7] = hairlineColor;
-    texture[3][0] = hairlineColor;
-    texture[3][7] = hairlineColor;
-    if (hasHeadband) {
-        for (let columnIndex = 0; columnIndex < 8; columnIndex++) {
-            texture[2][columnIndex] = palette.accent;
+    for (let rowIndex = 0; rowIndex < rows; rowIndex++) {
+        for (let columnIndex = 0; columnIndex < columns; columnIndex++) {
+            const startX = columnIndex / columns;
+            const endX = (columnIndex + 1) / columns;
+            const startY = rowIndex / rows;
+            const endY = (rowIndex + 1) / rows;
+            drawProjectedQuad(context, [
+                interpolateProjectedQuad(face.corners, startX, startY),
+                interpolateProjectedQuad(face.corners, endX, startY),
+                interpolateProjectedQuad(face.corners, endX, endY),
+                interpolateProjectedQuad(face.corners, startX, endY),
+            ], face.texture[rowIndex][columnIndex]);
         }
     }
-    texture[3][2] = palette.ink;
-    texture[3][5] = palette.ink;
-    texture[4][2] = '#ffffff';
-    texture[4][5] = '#ffffff';
-    texture[5][1] = cheekColor;
-    texture[5][6] = cheekColor;
-    texture[5][3] = palette.shadow;
-    texture[5][4] = palette.shadow;
-    texture[6][3] = palette.shadow;
-    texture[6][4] = palette.shadow;
-    return texture;
+    if (face.lightIntensity > 0) {
+        drawProjectedQuad(context, face.corners, `rgba(255, 255, 255, ${0.15 * face.lightIntensity})`);
+    }
+    else if (face.lightIntensity < 0) {
+        drawProjectedQuad(context, face.corners, `rgba(0, 0, 0, ${0.22 * Math.abs(face.lightIntensity)})`);
+    }
+    context.save();
+    context.beginPath();
+    context.moveTo(face.corners[0].x, face.corners[0].y);
+    for (let cornerIndex = 1; cornerIndex < face.corners.length; cornerIndex++) {
+        context.lineTo(face.corners[cornerIndex].x, face.corners[cornerIndex].y);
+    }
+    context.closePath();
+    context.strokeStyle = face.outlineColor;
+    context.lineWidth = Math.max(1.1, getProjectedQuadPerimeter(face.corners) * 0.0045);
+    context.lineJoin = 'round';
+    context.stroke();
+    context.restore();
 }
 /**
- * Creates the front-face pixel texture for the torso.
+ * Draws one filled projected quad.
  *
- * @param random Seeded random generator.
- * @param palette Derived avatar palette.
- * @returns 8x8 torso texture.
+ * @param context Canvas 2D context.
+ * @param corners Quad corners in clockwise order.
+ * @param fillStyle CSS fill style.
  *
- * @private helper of `minecraftAvatarVisual`
+ * @private helper of `minecraft2AvatarVisual`
  */
-function createMinecraftShirtTexture(random, palette) {
-    const texture = Array.from({ length: 8 }, () => Array.from({ length: 8 }, () => palette.primary));
-    const stripeColor = random() < 0.5 ? palette.secondary : palette.highlight;
-    for (let rowIndex = 0; rowIndex < 2; rowIndex++) {
-        for (let columnIndex = 0; columnIndex < 8; columnIndex++) {
-            texture[rowIndex][columnIndex] = palette.shadow;
-        }
+function drawProjectedQuad(context, corners, fillStyle) {
+    context.beginPath();
+    context.moveTo(corners[0].x, corners[0].y);
+    context.lineTo(corners[1].x, corners[1].y);
+    context.lineTo(corners[2].x, corners[2].y);
+    context.lineTo(corners[3].x, corners[3].y);
+    context.closePath();
+    context.fillStyle = fillStyle;
+    context.fill();
+}
+/**
+ * Interpolates one point inside a projected quad across both quad axes.
+ *
+ * @param corners Quad corners in clockwise order.
+ * @param horizontalRatio Horizontal ratio in the range `[0, 1]`.
+ * @param verticalRatio Vertical ratio in the range `[0, 1]`.
+ * @returns Interpolated projected point.
+ *
+ * @private helper of `minecraft2AvatarVisual`
+ */
+function interpolateProjectedQuad(corners, horizontalRatio, verticalRatio) {
+    const topPoint = interpolateProjectedPoint(corners[0], corners[1], horizontalRatio);
+    const bottomPoint = interpolateProjectedPoint(corners[3], corners[2], horizontalRatio);
+    return interpolateProjectedPoint(topPoint, bottomPoint, verticalRatio);
+}
+/**
+ * Interpolates between two projected points.
+ *
+ * @param startPoint Start point.
+ * @param endPoint End point.
+ * @param ratio Interpolation ratio in the range `[0, 1]`.
+ * @returns Interpolated projected point.
+ *
+ * @private helper of `minecraft2AvatarVisual`
+ */
+function interpolateProjectedPoint(startPoint, endPoint, ratio) {
+    return {
+        x: startPoint.x + (endPoint.x - startPoint.x) * ratio,
+        y: startPoint.y + (endPoint.y - startPoint.y) * ratio,
+        z: startPoint.z + (endPoint.z - startPoint.z) * ratio,
+    };
+}
+/**
+ * Projects one rotated scene point into canvas coordinates.
+ *
+ * @param point Scene point.
+ * @param size Canvas size in CSS pixels.
+ * @param sceneCenterX Horizontal scene center.
+ * @param sceneCenterY Vertical scene center.
+ * @returns Projected point.
+ *
+ * @private helper of `minecraft2AvatarVisual`
+ */
+function projectScenePoint(point, size, sceneCenterX, sceneCenterY) {
+    const cameraDistance = size * CAMERA_DISTANCE_RATIO;
+    const perspectiveScale = cameraDistance / Math.max(cameraDistance - point.z, cameraDistance * 0.35);
+    return {
+        x: sceneCenterX + point.x * perspectiveScale,
+        y: sceneCenterY + point.y * perspectiveScale,
+        z: point.z,
+    };
+}
+/**
+ * Applies the local cuboid rotations and translation to one scene point.
+ *
+ * @param localPoint Point in cuboid-local space.
+ * @param center Cuboid center in scene space.
+ * @param rotationX Cuboid pitch in radians.
+ * @param rotationY Cuboid yaw in radians.
+ * @returns Transformed scene-space point.
+ *
+ * @private helper of `minecraft2AvatarVisual`
+ */
+function transformScenePoint(localPoint, center, rotationX, rotationY) {
+    const yawedPoint = rotatePointAroundY(localPoint, rotationY);
+    const pitchedPoint = rotatePointAroundX(yawedPoint, rotationX);
+    return {
+        x: center.x + pitchedPoint.x,
+        y: center.y + pitchedPoint.y,
+        z: center.z + pitchedPoint.z,
+    };
+}
+/**
+ * Rotates one point around the local Y axis.
+ *
+ * @param point Source point.
+ * @param angle Rotation angle in radians.
+ * @returns Rotated point.
+ *
+ * @private helper of `minecraft2AvatarVisual`
+ */
+function rotatePointAroundY(point, angle) {
+    const cosine = Math.cos(angle);
+    const sine = Math.sin(angle);
+    return {
+        x: point.x * cosine + point.z * sine,
+        y: point.y,
+        z: -point.x * sine + point.z * cosine,
+    };
+}
+/**
+ * Rotates one point around the local X axis.
+ *
+ * @param point Source point.
+ * @param angle Rotation angle in radians.
+ * @returns Rotated point.
+ *
+ * @private helper of `minecraft2AvatarVisual`
+ */
+function rotatePointAroundX(point, angle) {
+    const cosine = Math.cos(angle);
+    const sine = Math.sin(angle);
+    return {
+        x: point.x,
+        y: point.y * cosine - point.z * sine,
+        z: point.y * sine + point.z * cosine,
+    };
+}
+/**
+ * Subtracts one 3D point from another.
+ *
+ * @param leftPoint Left point.
+ * @param rightPoint Right point.
+ * @returns Difference vector.
+ *
+ * @private helper of `minecraft2AvatarVisual`
+ */
+function subtractPoint3D(leftPoint, rightPoint) {
+    return {
+        x: leftPoint.x - rightPoint.x,
+        y: leftPoint.y - rightPoint.y,
+        z: leftPoint.z - rightPoint.z,
+    };
+}
+/**
+ * Computes the 3D cross product of two vectors.
+ *
+ * @param leftVector Left vector.
+ * @param rightVector Right vector.
+ * @returns Cross product.
+ *
+ * @private helper of `minecraft2AvatarVisual`
+ */
+function crossProduct3D(leftVector, rightVector) {
+    return {
+        x: leftVector.y * rightVector.z - leftVector.z * rightVector.y,
+        y: leftVector.z * rightVector.x - leftVector.x * rightVector.z,
+        z: leftVector.x * rightVector.y - leftVector.y * rightVector.x,
+    };
+}
+/**
+ * Computes the 3D dot product of two vectors.
+ *
+ * @param leftVector Left vector.
+ * @param rightVector Right vector.
+ * @returns Dot product.
+ *
+ * @private helper of `minecraft2AvatarVisual`
+ */
+function dotProduct3D(leftVector, rightVector) {
+    return leftVector.x * rightVector.x + leftVector.y * rightVector.y + leftVector.z * rightVector.z;
+}
+/**
+ * Normalizes one 3D vector while keeping zero vectors stable.
+ *
+ * @param vector Source vector.
+ * @returns Normalized vector.
+ *
+ * @private helper of `minecraft2AvatarVisual`
+ */
+function normalizeVector3(vector) {
+    const length = Math.hypot(vector.x, vector.y, vector.z);
+    if (length === 0) {
+        return vector;
     }
-    for (let rowIndex = 2; rowIndex < 8; rowIndex++) {
-        texture[rowIndex][3] = stripeColor;
-        texture[rowIndex][4] = stripeColor;
+    return {
+        x: vector.x / length,
+        y: vector.y / length,
+        z: vector.z / length,
+    };
+}
+/**
+ * Clamps one number into the provided range.
+ *
+ * @param value Input value.
+ * @param minimumValue Inclusive lower bound.
+ * @param maximumValue Inclusive upper bound.
+ * @returns Clamped value.
+ *
+ * @private helper of `minecraft2AvatarVisual`
+ */
+function clampNumber$1(value, minimumValue, maximumValue) {
+    return Math.min(maximumValue, Math.max(minimumValue, value));
+}
+/**
+ * Measures the perimeter of one projected quad.
+ *
+ * @param corners Quad corners.
+ * @returns Perimeter length.
+ *
+ * @private helper of `minecraft2AvatarVisual`
+ */
+function getProjectedQuadPerimeter(corners) {
+    let perimeter = 0;
+    for (let cornerIndex = 0; cornerIndex < corners.length; cornerIndex++) {
+        const currentCorner = corners[cornerIndex];
+        const nextCorner = corners[(cornerIndex + 1) % corners.length];
+        perimeter += Math.hypot(nextCorner.x - currentCorner.x, nextCorner.y - currentCorner.y);
     }
-    texture[4][1] = palette.accent;
-    texture[4][6] = palette.accent;
-    texture[5][2] = palette.highlight;
-    texture[5][5] = palette.highlight;
-    return texture;
+    return perimeter;
 }
 
 /* eslint-disable no-magic-numbers */
@@ -4616,6 +5250,7 @@ const AVATAR_VISUALS = [
     octopus3AvatarVisual,
     asciiOctopusAvatarVisual,
     minecraftAvatarVisual,
+    minecraft2AvatarVisual,
     fractalAvatarVisual,
     orbAvatarVisual,
 ];
@@ -10898,18 +11533,6 @@ function parseDataUrlKnowledgeSource(source) {
 }
 // Note: [💞] Ignore a discrepancy between file name and entity name
 
-/**
- * Name of the tool used by agents to search configured `KNOWLEDGE` sources.
- *
- * @public exported from `@promptbook/core`
- */
-const KNOWLEDGE_SEARCH_TOOL_NAME = 'knowledge_search';
-/**
- * Title of the system-message section generated for `KNOWLEDGE` commitments.
- *
- * @private constant of `KnowledgeCommitmentDefinition`
- */
-const KNOWLEDGE_SEARCH_SYSTEM_SECTION_TITLE = 'Knowledge Search';
 /**
  * KNOWLEDGE commitment definition
  *
@@ -11031,17 +11654,9 @@ class KnowledgeCommitmentDefinition extends BaseCommitmentDefinition {
             knowledgeInfoEntries.push(`Knowledge Source Inline: ${inlineSource.filename} (derived from inline content and processed for retrieval during chat)`);
         }
         if (knowledgeInfoEntries.length === 0) {
-            return addKnowledgeSearchToolAndSystemSection(nextRequirements);
+            return nextRequirements;
         }
-        return addKnowledgeSearchToolAndSystemSection(nextRequirements);
-    }
-    /**
-     * Gets human-readable titles for tool functions provided by this commitment.
-     */
-    getToolTitles() {
-        return {
-            [KNOWLEDGE_SEARCH_TOOL_NAME]: 'Knowledge search',
-        };
+        return this.appendToSystemMessage(nextRequirements, knowledgeInfoEntries.join('\n'), '\n\n');
     }
 }
 /**
@@ -11055,128 +11670,6 @@ function hasMeaningfulNonUrlText(content, urls) {
     const significantText = contentWithoutUrls.replace(/[\s.,!?;:'"`()[\]{}<>/-]+/g, '');
     return significantText.length > 0;
 }
-/**
- * Adds the shared `knowledge_search` tool definition and the consolidated system-message section.
- *
- * @param requirements - Requirements after one `KNOWLEDGE` commitment was applied.
- * @returns Requirements with the knowledge search instructions and tool definition.
- *
- * @private internal utility of `KnowledgeCommitmentDefinition`
- */
-function addKnowledgeSearchToolAndSystemSection(requirements) {
-    const nextRequirements = addKnowledgeSearchTool(requirements);
-    const section = createKnowledgeSearchSystemSection(nextRequirements);
-    const sectionHeader = `## ${KNOWLEDGE_SEARCH_SYSTEM_SECTION_TITLE}`;
-    if (nextRequirements.systemMessage.includes(sectionHeader)) {
-        return {
-            ...nextRequirements,
-            systemMessage: nextRequirements.systemMessage.replace(new RegExp(`## ${KNOWLEDGE_SEARCH_SYSTEM_SECTION_TITLE.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}[\\s\\S]*?(?=\\n\\n##|$)`), section),
-        };
-    }
-    return {
-        ...nextRequirements,
-        systemMessage: nextRequirements.systemMessage.trim()
-            ? `${nextRequirements.systemMessage}\n\n${section}`
-            : section,
-    };
-}
-/**
- * Adds the `knowledge_search` model tool when it is not already present.
- *
- * @param requirements - Current model requirements.
- * @returns Requirements with the tool definition available to the model.
- *
- * @private internal utility of `KnowledgeCommitmentDefinition`
- */
-function addKnowledgeSearchTool(requirements) {
-    const existingTools = requirements.tools || [];
-    if (existingTools.some((tool) => tool.name === KNOWLEDGE_SEARCH_TOOL_NAME)) {
-        return requirements;
-    }
-    return {
-        ...requirements,
-        tools: [
-            ...existingTools,
-            {
-                name: KNOWLEDGE_SEARCH_TOOL_NAME,
-                description: spaceTrim$1(`
-                    Search the agent's configured knowledge sources and return relevant excerpts with citation ids.
-                    Use this before answering questions that may depend on the agent's KNOWLEDGE commitments.
-                `),
-                parameters: {
-                    type: 'object',
-                    properties: {
-                        query: {
-                            type: 'string',
-                            description: 'The natural-language search query for the knowledge base.',
-                        },
-                        limit: {
-                            type: 'integer',
-                            description: 'Maximum number of matching source excerpts to return.',
-                        },
-                    },
-                    required: ['query'],
-                },
-            },
-        ],
-    };
-}
-/**
- * Creates the model-facing system-message section for knowledge search.
- *
- * @param requirements - Current model requirements.
- * @returns Markdown system-message section.
- *
- * @private internal utility of `KnowledgeCommitmentDefinition`
- */
-function createKnowledgeSearchSystemSection(requirements) {
-    const sourceEntries = createKnowledgeSourceSystemEntries(requirements);
-    const sourceList = sourceEntries.length > 0 ? sourceEntries.map((entry) => `-   ${entry}`).join('\n') : '-   None';
-    return spaceTrim$1(`
-        ## ${KNOWLEDGE_SEARCH_SYSTEM_SECTION_TITLE}
-
-        -   Use \`${KNOWLEDGE_SEARCH_TOOL_NAME}\` to search the configured knowledge sources before answering questions that depend on this agent's knowledge base.
-        -   Base source-backed factual answers on the returned excerpts.
-        -   When you use a returned excerpt, include its citation marker in the answer body, for example \`[0:0]\`.
-        -   If the search returns no relevant information, say that the knowledge base did not contain the answer instead of inventing it.
-
-        Configured knowledge sources:
-        ${sourceList}
-    `);
-}
-/**
- * Builds a stable list of configured knowledge sources for system-message diagnostics.
- *
- * @param requirements - Current model requirements.
- * @returns Human-readable source entries.
- *
- * @private internal utility of `KnowledgeCommitmentDefinition`
- */
-function createKnowledgeSourceSystemEntries(requirements) {
-    var _a;
-    const entries = [];
-    const seenEntries = new Set();
-    for (const source of requirements.knowledgeSources || []) {
-        const entry = `Source URL: ${source} (processed for retrieval during chat)`;
-        if (seenEntries.has(entry)) {
-            continue;
-        }
-        seenEntries.add(entry);
-        entries.push(entry);
-    }
-    const inlineSources = (((_a = requirements._metadata) === null || _a === void 0 ? void 0 : _a.inlineKnowledgeSources) || [])
-        .map((source) => source.filename)
-        .filter(Boolean);
-    for (const filename of inlineSources) {
-        const entry = `Knowledge Source Inline: ${filename} (Inline source: processed for retrieval during chat)`;
-        if (seenEntries.has(entry)) {
-            continue;
-        }
-        seenEntries.add(entry);
-        entries.push(entry);
-    }
-    return entries;
-}
 
 /**
  * LANGUAGE commitment definition
@@ -13764,7 +14257,11 @@ class PersonaCommitmentDefinition extends BaseCommitmentDefinition {
         // Create new system message with persona at the beginning
         // Format: "You are {agentName}\n{personaContent}"
         // The # PERSONA comment will be removed later by removeCommentsFromSystemMessage
-        const personaSection = `# PERSONA\nYou are ${agentName}\n${mergedPersonaContent}`; // <- TODO: Use spaceTrim
+        const personaSection = spaceTrim$1((block) => `
+                # PERSONA
+                You are ${agentName}
+                ${block(mergedPersonaContent)}
+            `);
         const newSystemMessage = cleanedMessage ? `${personaSection}\n\n${cleanedMessage}` : personaSection;
         return {
             ...requirements,
@@ -14666,7 +15163,10 @@ function buildTeamSystemMessageBody(teamEntries) {
  */
 function buildTeamToolDescription(entry) {
     const detailLines = collectTeamEntryDetails(entry).map(({ label, content }) => `${label}: ${content}`);
-    return [`Consult teammate ${entry.teammate.label}`, ...detailLines].join('\n');
+    return spaceTrim$1((block) => `
+            Consult teammate ${entry.teammate.label}
+            ${block(detailLines.join('\n'))}
+        `);
 }
 /**
  * Collects structured teammate details that should stay visible to the model.
@@ -20182,7 +20682,10 @@ function createListedTimeoutsAssistantMessage(options) {
     if (hiddenCount > 0) {
         summaryRows.push(`...and ${hiddenCount} more.`);
     }
-    return [`Found ${options.total} ${options.total === 1 ? 'timeout' : 'timeouts'}:`, ...summaryRows].join('\n');
+    return spaceTrim$1((block) => `
+            Found ${options.total} ${options.total === 1 ? 'timeout' : 'timeouts'}:
+            ${block(summaryRows.join('\n'))}
+        `);
 }
 /**
  * Formats one timeout row for assistant-visible timeout listings.
@@ -38167,6 +38670,174 @@ function extractMcpServers(agentSource) {
         .filter(Boolean);
 }
 
+/**
+ * End-to-end examples used by the standalone Book language documentation.
+ *
+ * These are intentionally compact but complete, so they can be copy-pasted and
+ * used as practical starting points.
+ *
+ * @private internal utility of `createStandaloneBookLanguageMarkdown`
+ */
+[
+    {
+        id: 'minimal-hello-world-agent',
+        title: 'Minimal hello-world agent',
+        goal: 'Create the smallest useful agent with identity and greeting.',
+        source: spaceTrim$1(`
+            Hello World Agent
+
+            GOAL Be a concise and friendly assistant.
+            INITIAL MESSAGE Hello! I am ready to help.
+            CLOSED
+        `),
+        walkthrough: [
+            'The first line (`Hello World Agent`) is the agent name.',
+            '`GOAL` defines the effective role and profile text.',
+            '`INITIAL MESSAGE` sets a deterministic first message for a new chat.',
+            '`CLOSED` prevents conversational self-modification.',
+        ],
+    },
+    {
+        id: 'tool-using-browser-search-agent',
+        title: 'Tool-using agent (Browser + Search engine)',
+        goal: 'Enable internet research with clear sourcing behavior.',
+        source: spaceTrim$1(`
+            Web Research Assistant
+
+            GOAL Research topics using fresh and verifiable information.
+            USE SEARCH ENGINE Prefer official sources and recent publications.
+            USE BROWSER
+            RULE Verify important claims across multiple sources when possible.
+            RULE Include source links in your final answer.
+            INITIAL MESSAGE Ask me what topic you want to research and how deep the report should be.
+        `),
+        walkthrough: [
+            '`USE SEARCH ENGINE` provides web search tooling and optional search instructions.',
+            '`USE BROWSER` enables URL fetching and interactive browsing tools.',
+            '`RULE` commitments make reliability behavior explicit and repeatable.',
+            'This pattern is ideal for current-events and fact-checking agents.',
+        ],
+    },
+    {
+        id: 'rule-and-knowledge-agent',
+        title: 'Agent with RULE and KNOWLEDGE',
+        goal: 'Ground responses in explicit constraints and curated sources.',
+        source: spaceTrim$1(`
+            Support Policy Assistant
+
+            GOAL Answer questions about support policy.
+            KNOWLEDGE Refunds are available within 30 days with proof of purchase.
+            KNOWLEDGE https://example.com/support-policy
+            RULE If a policy item is missing in available knowledge, say it explicitly.
+            RULE Never invent legal or policy statements.
+            INITIAL MESSAGE I can explain refund and support rules from provided knowledge.
+        `),
+        walkthrough: [
+            '`KNOWLEDGE` may be inline text or an external URL/document.',
+            '`RULE` commitments define non-negotiable behavior constraints.',
+            'Combining both creates predictable, grounded policy responses.',
+            'Use this pattern for compliance, support, and internal procedures.',
+        ],
+    },
+    {
+        id: 'memory-agent-with-long-term-memory',
+        title: 'MEMORY agent with long-term memory',
+        goal: 'Persist user preferences across conversations.',
+        source: spaceTrim$1(`
+            Customer Success Memory Agent
+
+            GOAL Support SaaS customers while remembering relevant setup and preference context.
+            MEMORY Remember product setup, user goals, and communication preferences.
+            RULE Store only user-approved preferences and project context.
+            RULE Never store secrets or sensitive data unless explicitly requested and allowed.
+            INITIAL MESSAGE I can remember your setup and preferences for future sessions.
+        `),
+        walkthrough: [
+            '`MEMORY` adds runtime memory tools and memory-specific system guidance.',
+            '`RULE` commitments narrow what should be remembered to reduce privacy risks.',
+            'In Agents Server, memory is runtime-backed and user-scoped.',
+            'Use this for assistants that must preserve context over time.',
+        ],
+    },
+    {
+        id: 'use-project-and-wallet-integration-agent',
+        title: 'USE PROJECT and WALLET external integration',
+        goal: 'Work with GitHub repositories and wallet-backed credentials.',
+        source: spaceTrim$1(`
+            Repository Maintainer
+
+            GOAL Maintain a GitHub repository and prepare safe pull requests.
+            USE PROJECT https://github.com/acme/website
+            WALLET Store credentials for repository operations.
+            RULE Before editing files, explain the planned change and impacted paths.
+            RULE Never reveal raw credentials in chat output.
+            INITIAL MESSAGE I can inspect the repository and help you prepare PR-ready changes.
+        `),
+        walkthrough: [
+            '`USE PROJECT` enables repository tools for listing, reading, editing files, and creating PRs.',
+            'Credentials are resolved from wallet records at runtime in Agents Server.',
+            '`WALLET` is kept here as a compatibility marker, but current Book 2.0 parsing treats it as deprecated/ignored.',
+            'In current runtime behavior, wallet-backed integrations are driven by commitments such as `USE PROJECT` and `USE EMAIL`.',
+        ],
+    },
+    {
+        id: 'use-calendar-integration-agent',
+        title: 'USE CALENDAR integration',
+        goal: 'Coordinate meetings and schedules through a connected Google Calendar.',
+        source: spaceTrim$1(`
+            Calendar Assistant
+
+            GOAL Schedule meetings and keep the calendar conflict-free.
+            USE CALENDAR https://calendar.google.com/calendar/u/0/r
+            SCOPES https://www.googleapis.com/auth/calendar
+            RULE Confirm destructive actions before deleting an event.
+            INITIAL MESSAGE Tell me the meeting details and I will schedule it in your calendar.
+        `),
+        walkthrough: [
+            '`USE CALENDAR` enables calendar tools for listing, reading, creating, updating, and deleting events.',
+            'The first calendar URL identifies which calendar integration should be used.',
+            '`SCOPES` can explicitly request required Google Calendar OAuth permissions.',
+            'Credentials are resolved from wallet-backed Google Calendar OAuth records at runtime in Agents Server.',
+        ],
+    },
+    {
+        id: 'agents-team-example',
+        title: 'Agents TEAM (with in-book teammates)',
+        goal: 'Delegate sub-tasks to specialized teammates.',
+        source: spaceTrim$1(`
+            Team Manager
+
+            GOAL Coordinate specialists and deliver one consolidated answer.
+            TEAM Ask {Legal Reviewer} for legal constraints and {Implementation Reviewer} for technical feasibility.
+            RULE Always summarize teammate outputs into one action plan.
+
+            ---
+
+            Legal Reviewer
+
+            FROM VOID
+            GOAL Review legal and compliance risk.
+            RULE Flag legal/compliance risk and uncertainty clearly.
+            CLOSED
+
+            ---
+
+            Implementation Reviewer
+
+            FROM VOID
+            GOAL Review implementation effort and delivery risk.
+            RULE Estimate complexity and identify blockers.
+            CLOSED
+        `),
+        walkthrough: [
+            'The main agent delegates via `TEAM` commitment.',
+            'References in `{...}` are resolved against embedded agents inside the same book (split by `---`).',
+            'Each teammate can be isolated with `FROM VOID` for deterministic specialization.',
+            'This pattern works well for multi-role review and decision support.',
+        ],
+    },
+];
+
 /**
  * Gets all tool titles provided by all commitments
  *
@@ -38417,6 +39088,72 @@ const EXPECTATION_UNITS = ['CHARACTERS', 'WORDS', 'SENTENCES', 'LINES', 'PARAGRA
     },
 });
 
+/**
+ * Matcher is form of app that evaluates (spreadsheet) content against defined criteria or patterns,
+ * determining if it matches or meets specific requirements. Used for classification,
+ * validation, filtering, and quality assessment of inputs.
+ *
+ * @public exported from `@promptbook/core`
+ */
+({
+    name: 'EXPERIMENTAL_MATCHER',
+    description: spaceTrim$1(`
+        An evaluation system that determines whether content meets specific criteria or patterns.
+        Used for content validation, quality assessment, and intelligent filtering tasks. Currently in experimental phase.
+    `),
+    documentationUrl: `https://github.com/webgptorg/promptbook/discussions/177`,
+    pipelineInterface: {
+        inputParameters: [
+            /* Input parameters for content to be matched and criteria to match against */
+            {
+                name: 'nonce',
+                description: 'Just to prevent EXPERIMENTAL_MATCHER to be set as implicit formfactor',
+                isInput: true,
+                isOutput: false,
+            },
+        ],
+        outputParameters: [
+        /* Output parameters containing match results, confidence scores, and relevant metadata */
+        ],
+    },
+});
+
+/**
+ * Translator is form of app that transforms input text from one form to another,
+ * such as language translation, style conversion, tone modification, or other text transformations.
+ *
+ * @public exported from `@promptbook/core`
+ */
+({
+    name: 'TRANSLATOR',
+    description: spaceTrim$1(`
+        A text transformation system that converts input content into different forms,
+        including language translations, paraphrasing, style conversions, and tone adjustments.
+        This form factor takes one input and produces one transformed output.
+    `),
+    documentationUrl: `https://github.com/webgptorg/promptbook/discussions/175`,
+    pipelineInterface: {
+        inputParameters: [
+            {
+                name: 'inputMessage',
+                description: `Input message to be translated`,
+                isInput: true,
+                isOutput: false,
+            },
+        ],
+        outputParameters: [
+            {
+                name: 'outputMessage',
+                description: `Translated output message`,
+                isInput: false,
+                isOutput: true,
+            },
+        ],
+        // <- TODO: [🤓] Maybe add {summary}
+        // <- TODO: [🧠] maybe change to {inputText}, {inputText} / or make system for any name of first input and first outpur parameter
+    },
+});
+
 /**
  * Register for LLM tools metadata.
  *
@@ -38594,11 +39331,11 @@ function formatChatAttachmentContext(attachments) {
     if (attachments.length === 0) {
         return '';
     }
-    return [
-        CHAT_ATTACHMENTS_HEADING,
-        ...attachments.map((attachment) => formatChatAttachmentLine(attachment)),
-        CHAT_ATTACHMENTS_INSTRUCTION,
-    ].join('\n');
+    return spaceTrim$1((block) => `
+            ${CHAT_ATTACHMENTS_HEADING}
+            ${block(attachments.map((attachment) => formatChatAttachmentLine(attachment)).join('\n'))}
+            ${CHAT_ATTACHMENTS_INSTRUCTION}
+        `);
 }
 
 /**
@@ -38839,24 +39576,24 @@ function formatResolvedChatAttachmentContent(contentResolution) {
             : ''}`
         : null;
     const warningsLine = contentResolution.warnings.length > 0 ? `Warnings: ${contentResolution.warnings.join(' | ')}` : null;
-    if (!contentResolution.content) {
+    const metadataLines = [decodingLine, warningsLine].filter((line) => Boolean(line)).join('\n');
+    const resolvedContent = contentResolution.content;
+    if (!resolvedContent) {
         const reason = contentResolution.reason || 'content unavailable';
-        return [`- ${attachmentLabel}: ${reason}. URL: ${contentResolution.attachment.url}`, decodingLine, warningsLine]
-            .filter(Boolean)
-            .join('\n');
+        return spaceTrim$1((block) => `
+                - ${attachmentLabel}: ${reason}. URL: ${contentResolution.attachment.url}
+                ${block(metadataLines)}
+            `);
     }
     const truncatedLabel = contentResolution.isTruncated ? ' [truncated]' : '';
-    return [
-        `File: ${attachmentLabel}${truncatedLabel}`,
-        `URL: ${contentResolution.attachment.url}`,
-        decodingLine,
-        warningsLine,
-        '```text',
-        contentResolution.content,
-        '```',
-    ]
-        .filter(Boolean)
-        .join('\n');
+    return spaceTrim$1((block) => `
+            File: ${attachmentLabel}${truncatedLabel}
+            URL: ${contentResolution.attachment.url}
+            ${block(metadataLines)}
+            \`\`\`text
+            ${block(resolvedContent)}
+            \`\`\`
+        `);
 }
 /**
  * Formats inline attachment-content context section for the model.
@@ -38870,11 +39607,14 @@ function formatChatAttachmentContentContext(resolvedContents) {
     if (resolvedContents.length === 0) {
         return '';
     }
-    return [
-        CHAT_ATTACHMENT_CONTENT_HEADING,
-        CHAT_ATTACHMENT_CONTENT_INSTRUCTION,
-        ...resolvedContents.map((resolvedContent) => formatResolvedChatAttachmentContent(resolvedContent)),
-    ].join('\n\n');
+    return spaceTrim$1((block) => `
+            ${CHAT_ATTACHMENT_CONTENT_HEADING}
+            ${CHAT_ATTACHMENT_CONTENT_INSTRUCTION}
+
+            ${block(resolvedContents
+        .map((resolvedContent) => formatResolvedChatAttachmentContent(resolvedContent))
+        .join('\n\n'))}
+        `);
 }
 
 /**
@@ -40019,9 +40759,11 @@ class OpenAiCompatibleUnsupportedParameterRetrier {
      * Creates the retry-history error message shared by all OpenAI-compatible model variants.
      */
     createAttemptHistoryError(finalErrorMessage) {
-        return new PipelineExecutionError(`All attempts failed. Attempt history:\n` +
-            formatUnsupportedParameterAttemptHistory(this.attemptStack) +
-            `\nFinal error: ${finalErrorMessage}`);
+        return new PipelineExecutionError(spaceTrim$1((block) => `
+                    All attempts failed. Attempt history:
+                    ${block(formatUnsupportedParameterAttemptHistory(this.attemptStack))}
+                    Final error: ${finalErrorMessage}
+                `));
     }
 }
 
@@ -42615,7 +43357,7 @@ class OpenAiAgentKitExecutionTools extends OpenAiVectorStoreHandler {
             });
         }
         let vectorStoreId = cachedVectorStoreId;
-        if (this.isNativeKnowledgeSearchEnabled && !vectorStoreId && knowledgeSources && knowledgeSources.length > 0) {
+        if (!vectorStoreId && knowledgeSources && knowledgeSources.length > 0) {
             const vectorStoreResult = await this.createVectorStoreWithKnowledgeSources({
                 client: await this.getClient(),
                 name,
@@ -42624,19 +43366,13 @@ class OpenAiAgentKitExecutionTools extends OpenAiVectorStoreHandler {
             });
             vectorStoreId = vectorStoreResult.vectorStoreId;
         }
-        else if (this.isNativeKnowledgeSearchEnabled && vectorStoreId && this.options.isVerbose) {
+        else if (vectorStoreId && this.options.isVerbose) {
             console.info('[🤰]', 'Using cached vector store for AgentKit agent', {
                 name,
                 vectorStoreId,
             });
         }
-        if (!this.isNativeKnowledgeSearchEnabled) {
-            vectorStoreId = undefined;
-        }
-        const agentKitTools = this.buildAgentKitTools({
-            tools,
-            vectorStoreId,
-        });
+        const agentKitTools = this.buildAgentKitTools({ tools, vectorStoreId });
         const openAiAgentKitAgent = new Agent$1({
             name,
             model: this.agentKitModelName,
@@ -42655,7 +43391,7 @@ class OpenAiAgentKitExecutionTools extends OpenAiVectorStoreHandler {
                 name,
                 model: this.agentKitModelName,
                 toolCount: agentKitTools.length,
-                hasVectorStore: this.isNativeKnowledgeSearchEnabled && Boolean(vectorStoreId),
+                hasVectorStore: Boolean(vectorStoreId),
             });
         }
         return preparedAgent;
@@ -43154,12 +43890,6 @@ class OpenAiAgentKitExecutionTools extends OpenAiVectorStoreHandler {
     get agentKitOptions() {
         return this.options;
     }
-    /**
-     * Returns true when hosted OpenAI vector-store search should back `knowledgeSources`.
-     */
-    get isNativeKnowledgeSearchEnabled() {
-        return this.agentKitOptions.isNativeKnowledgeSearchEnabled !== false;
-    }
     /**
      * Discriminant for type guards.
      */
@@ -48887,7 +49617,6 @@ const TOOL_TITLES = {
     request_wallet_record: { title: 'Requesting wallet', emoji: '👛' },
     web_search: { title: 'Searching the web', emoji: '🔎' },
     deep_search: { title: 'Deep research', emoji: '🔬' },
-    knowledge_search: { title: 'Searching knowledge', emoji: '📚' },
     useSearchEngine: { title: 'Searching the web', emoji: '🔎' },
     search: { title: 'Searching the web', emoji: '🔎' },
     useBrowser: { title: 'Browsing the web', emoji: '🌐' },
@@ -49763,13 +50492,6 @@ const ChatMessageItem = memo(
         content: sanitizedContentWithoutButtons,
         citations: message.citations,
     }), [message.citations, sanitizedContentWithoutButtons]);
-    const structuredSourceCitations = useMemo(() => {
-        const footnoteSourceKeys = new Set(citationFootnoteRenderModel.footnotes.map((footnote) => footnote.citation.source.trim().toLowerCase()));
-        return (message.sources || []).filter((source) => {
-            const sourceKey = source.source.trim().toLowerCase();
-            return sourceKey && !footnoteSourceKeys.has(sourceKey);
-        });
-    }, [citationFootnoteRenderModel.footnotes, message.sources]);
     const contentSegments = useMemo(() => splitMessageContentIntoSegments(citationFootnoteRenderModel.content), [citationFootnoteRenderModel.content]);
     const hasMapSegment = useMemo(() => contentSegments.some((segment) => segment.type === 'map'), [contentSegments]);
     const [localHoveredRating, setLocalHoveredRating] = useState(0);
@@ -50041,7 +50763,7 @@ const ChatMessageItem = memo(
                             '--message-bg-color': isAgentArticleMode ? articleModeBackgroundColor : color.toHex(),
                             '--message-text-color': isAgentArticleMode ? articleModeTextColor : colorOfText.toHex(),
                             '--chat-message-swipe-offset': swipeTranslation,
-                        }, onPointerDown: handleReplyPointerDown, onPointerMove: handleReplyPointerMove, onPointerUp: handleReplyPointerEnd, onPointerCancel: resetReplySwipe, children: [isReplyActionEnabled && (jsx("div", { className: classNames(styles$5.replySwipeIndicator, isMe && styles$5.replySwipeIndicatorRight, isReplySwipeArmed && styles$5.replySwipeIndicatorActive), "aria-hidden": "true", children: jsx(Reply, { className: styles$5.replySwipeIndicatorIcon }) })), !shouldRenderArticleActionsBar && renderMessageReadAndCopyControls(), message.isVoiceCall && (jsx("div", { className: styles$5.voiceCallIndicator, children: jsx("svg", { width: "16", height: "16", viewBox: "0 0 24 24", fill: "currentColor", children: jsx("path", { d: "M6.62 10.79c1.44 2.83 3.76 5.14 6.59 6.59l2.2-2.2c.27-.27.67-.36 1.02-.24 1.12.37 2.33.57 3.57.57.55 0 1 .45 1 1V20c0 .55-.45 1-1 1-9.39 0-17-7.61-17-17 0-.55.45-1 1-1h3.5c.55 0 1 .45 1 1 0 1.25.2 2.45.57 3.57.11.35.03.74-.25 1.02l-2.2 2.2z" }) }) })), replyingToMessage && replyPreviewText && replySenderLabel && (jsx(ChatReplyPreview, { label: replyPreviewLabel, senderLabel: replySenderLabel, previewText: replyPreviewText, className: styles$5.replyBubblePreview })), jsx("div", { ref: contentWithoutButtonsRef, children: jsx(ChatMessageRichContent, { content: message.content, contentSegments: contentSegments, streamingFeaturePlaceholderKind: streamingFeaturePlaceholderKind, onCreateAgent: onCreateAgent, mode: mode }) }), message.attachments && message.attachments.length > 0 && (jsx("div", { className: styles$5.attachments, children: message.attachments.map((attachment, index) => (jsxs("a", { href: attachment.url, target: "_blank", rel: "noopener noreferrer", className: styles$5.attachment, title: attachment.name, children: [jsx("span", { className: styles$5.attachmentIcon, children: "\uD83D\uDCCE" }), jsx("span", { className: styles$5.attachmentName, children: attachment.name })] }, index))) })), jsx(ChatMessageToolCallChips, { chips: toolCallChips, onToolCallClick: onToolCallClick }), citationFootnoteRenderModel.footnotes.length > 0 && (jsx("div", { className: styles$5.citationFootnotes, children: citationFootnoteRenderModel.footnotes.map((footnote) => (jsxs("div", { className: styles$5.citationFootnoteItem, children: [jsx("span", { className: styles$5.citationFootnoteNumber, children: footnote.number }), jsx(SourceChip, { citation: footnote.citation, onClick: onCitationClick, isCitationIdVisible: false })] }, `citation-footnote-${footnote.number}-${footnote.citation.source}`))) })), structuredSourceCitations.length > 0 && (jsx("div", { className: styles$5.sourceCitations, children: structuredSourceCitations.map((citation, index) => (jsx(SourceChip, { citation: citation, onClick: onCitationClick, isCitationIdVisible: false }, `message-source-${citation.source}-${citation.id}-${index}`))) })), transitiveCitations.length > 0 && (jsx("div", { className: styles$5.sourceCitations, children: transitiveCitations.map((citation, index) => (jsx(SourceChip, { citation: citation, suffix: `by ${citation.origin.label}`, onClick: onCitationClick }, `team-source-${citation.source}-${index}`))) })), shouldShowButtons && (jsx("div", { className: styles$5.messageButtons, children: renderableButtons.map(({ button, buttonIndex }) => (jsx("button", { type: "button", className: classNames(styles$5.messageButton, button.type === 'action' && styles$5.actionMessageButton), onClick: (event) => {
+                        }, onPointerDown: handleReplyPointerDown, onPointerMove: handleReplyPointerMove, onPointerUp: handleReplyPointerEnd, onPointerCancel: resetReplySwipe, children: [isReplyActionEnabled && (jsx("div", { className: classNames(styles$5.replySwipeIndicator, isMe && styles$5.replySwipeIndicatorRight, isReplySwipeArmed && styles$5.replySwipeIndicatorActive), "aria-hidden": "true", children: jsx(Reply, { className: styles$5.replySwipeIndicatorIcon }) })), !shouldRenderArticleActionsBar && renderMessageReadAndCopyControls(), message.isVoiceCall && (jsx("div", { className: styles$5.voiceCallIndicator, children: jsx("svg", { width: "16", height: "16", viewBox: "0 0 24 24", fill: "currentColor", children: jsx("path", { d: "M6.62 10.79c1.44 2.83 3.76 5.14 6.59 6.59l2.2-2.2c.27-.27.67-.36 1.02-.24 1.12.37 2.33.57 3.57.57.55 0 1 .45 1 1V20c0 .55-.45 1-1 1-9.39 0-17-7.61-17-17 0-.55.45-1 1-1h3.5c.55 0 1 .45 1 1 0 1.25.2 2.45.57 3.57.11.35.03.74-.25 1.02l-2.2 2.2z" }) }) })), replyingToMessage && replyPreviewText && replySenderLabel && (jsx(ChatReplyPreview, { label: replyPreviewLabel, senderLabel: replySenderLabel, previewText: replyPreviewText, className: styles$5.replyBubblePreview })), jsx("div", { ref: contentWithoutButtonsRef, children: jsx(ChatMessageRichContent, { content: message.content, contentSegments: contentSegments, streamingFeaturePlaceholderKind: streamingFeaturePlaceholderKind, onCreateAgent: onCreateAgent, mode: mode }) }), message.attachments && message.attachments.length > 0 && (jsx("div", { className: styles$5.attachments, children: message.attachments.map((attachment, index) => (jsxs("a", { href: attachment.url, target: "_blank", rel: "noopener noreferrer", className: styles$5.attachment, title: attachment.name, children: [jsx("span", { className: styles$5.attachmentIcon, children: "\uD83D\uDCCE" }), jsx("span", { className: styles$5.attachmentName, children: attachment.name })] }, index))) })), jsx(ChatMessageToolCallChips, { chips: toolCallChips, onToolCallClick: onToolCallClick }), citationFootnoteRenderModel.footnotes.length > 0 && (jsx("div", { className: styles$5.citationFootnotes, children: citationFootnoteRenderModel.footnotes.map((footnote) => (jsxs("div", { className: styles$5.citationFootnoteItem, children: [jsx("span", { className: styles$5.citationFootnoteNumber, children: footnote.number }), jsx(SourceChip, { citation: footnote.citation, onClick: onCitationClick, isCitationIdVisible: false })] }, `citation-footnote-${footnote.number}-${footnote.citation.source}`))) })), transitiveCitations.length > 0 && (jsx("div", { className: styles$5.sourceCitations, children: transitiveCitations.map((citation, index) => (jsx(SourceChip, { citation: citation, suffix: `by ${citation.origin.label}`, onClick: onCitationClick }, `team-source-${citation.source}-${index}`))) })), shouldShowButtons && (jsx("div", { className: styles$5.messageButtons, children: renderableButtons.map(({ button, buttonIndex }) => (jsx("button", { type: "button", className: classNames(styles$5.messageButton, button.type === 'action' && styles$5.actionMessageButton), onClick: (event) => {
                                         event.stopPropagation();
                                         if (button.type === 'message') {
                                             const quickMessageHandler = onQuickMessageButton || onMessage;
@@ -50093,9 +50815,6 @@ const ChatMessageItem = memo(
     if (prev.message.citations !== next.message.citations) {
         return false;
     }
-    if (prev.message.sources !== next.message.sources) {
-        return false;
-    }
     if (JSON.stringify(prev.message.attachments) !== JSON.stringify(next.message.attachments)) {
         return false;
     }
@@ -51510,7 +52229,7 @@ function renderSearchToolCallDetails(options) {
     const { results, rawText } = extractSearchResults(resultRaw);
     const hasResults = results.length > 0;
     const hasRawText = !hasResults && !!rawText && rawText.trim().length > 0;
-    return (jsxs(Fragment, { children: [jsxs("div", { className: styles$5.searchModalHeader, children: [jsx("span", { className: styles$5.searchModalIcon, children: "\uD83D\uDD0E" }), jsx("h3", { className: styles$5.searchModalQuery, children: args.query || args.searchText || 'Search Results' })] }), jsx("div", { className: styles$5.searchModalContent, children: hasResults ? (jsx("div", { className: styles$5.searchResultsList, children: results.map((item, index) => (jsxs("div", { className: styles$5.searchResultItem, children: [jsx("div", { className: styles$5.searchResultUrl, children: item.url && (jsx("a", { href: item.url, target: "_blank", rel: "noreferrer", children: item.url })) }), jsx("h4", { className: styles$5.searchResultTitle, children: item.url ? (jsx("a", { href: item.url, target: "_blank", rel: "noreferrer", children: item.title || item.source || 'Untitled' })) : (item.title || item.source || 'Untitled') }), jsx("p", { className: styles$5.searchResultSnippet, children: item.snippet || item.content || item.excerpt || '' })] }, index))) })) : hasRawText ? (jsx(MarkdownContent, { className: styles$5.searchResultsRaw, content: rawText })) : toolCallState !== 'COMPLETE' ? (jsxs(Fragment, { children: [renderToolCallProgressPlaceholder({
+    return (jsxs(Fragment, { children: [jsxs("div", { className: styles$5.searchModalHeader, children: [jsx("span", { className: styles$5.searchModalIcon, children: "\uD83D\uDD0E" }), jsx("h3", { className: styles$5.searchModalQuery, children: args.query || args.searchText || 'Search Results' })] }), jsx("div", { className: styles$5.searchModalContent, children: hasResults ? (jsx("div", { className: styles$5.searchResultsList, children: results.map((item, index) => (jsxs("div", { className: styles$5.searchResultItem, children: [jsx("div", { className: styles$5.searchResultUrl, children: item.url && (jsx("a", { href: item.url, target: "_blank", rel: "noreferrer", children: item.url })) }), jsx("h4", { className: styles$5.searchResultTitle, children: item.url ? (jsx("a", { href: item.url, target: "_blank", rel: "noreferrer", children: item.title || 'Untitled' })) : (item.title || 'Untitled') }), jsx("p", { className: styles$5.searchResultSnippet, children: item.snippet || item.content || '' })] }, index))) })) : hasRawText ? (jsx(MarkdownContent, { className: styles$5.searchResultsRaw, content: rawText })) : toolCallState !== 'COMPLETE' ? (jsxs(Fragment, { children: [renderToolCallProgressPlaceholder({
                             title: 'Search results pending',
                             message: resolveToolCallProgressMessage(toolCall),
                         }), jsxs("div", { className: styles$5.toolCallDetailsCard, children: [jsxs("div", { className: styles$5.toolCallDetailsCardRow, children: [jsx("strong", { children: "Query" }), jsx("span", { children: String(args.query || args.searchText || 'Search query is being prepared.') })] }), args.location && (jsxs("div", { className: styles$5.toolCallDetailsCardRow, children: [jsx("strong", { children: "Location" }), jsx("span", { children: String(args.location) })] })), args.engine && (jsxs("div", { className: styles$5.toolCallDetailsCardRow, children: [jsx("strong", { children: "Engine" }), jsx("span", { children: String(args.engine) })] }))] })] })) : (jsx("div", { className: styles$5.noResults, children: resultRaw ? 'No search results found.' : 'Search results are not available.' })) })] }));
@@ -52090,7 +52809,6 @@ function renderGenericToolCallDetails(options) {
 function isSearchToolCallName(toolName) {
     return (toolName === 'web_search' ||
         toolName === 'deep_search' ||
-        toolName === 'knowledge_search' ||
         toolName === 'useSearchEngine' ||
         toolName === 'search');
 }