@promptbook/components 0.112.0-104 → 0.112.0-105

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

@@ -6,6 +6,7 @@ import type { number_positive } from '../../types/number_positive';
 import type { string_knowledge_source_content } from '../../types/string_knowledge_source_content';
 import type { string_css_value } from '../../types/string_markdown';
 import type { HoistedMenuItem } from '../_common/MenuHoisting/MenuHoistingContext';
+import type { BookEditorTheme } from './BookEditorTheme';
 /**
  * Monaco diagnostic shown inside `BookEditor`.
  *
@@ -94,14 +95,14 @@ export type BookEditorProps = {
      */
     readonly style?: CSSProperties;
     /**
-     * Resolved visual theme used for the editor wrapper and Monaco instance.
+     * Resolved host application theme.
      *
-     * Host applications should pass the final light/dark theme instead of relying on
-     * browser media-query inference inside `<BookEditor/>`.
+     * `<BookEditor/>` accepts this for integration compatibility, but the notebook
+     * editor itself is intentionally rendered as light paper in every app theme.
      *
      * @default 'LIGHT'
      */
-    readonly theme?: 'LIGHT' | 'DARK';
+    readonly theme?: BookEditorTheme;
     /**
      * Height of the `BookEditor` component
      *

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

@@ -0,0 +1,24 @@
+/**
+ * Visual theme accepted by `<BookEditor/>` integrations.
+ *
+ * @private internal type of `BookEditor`
+ */
+export type BookEditorTheme = 'LIGHT' | 'DARK';
+/**
+ * Theme used for the actual notebook editor surface.
+ *
+ * The host application can still pass its resolved app theme, but book sources
+ * are intentionally rendered as light paper in both light and dark app modes.
+ *
+ * @private internal constant of `BookEditor`
+ */
+export declare const BOOK_EDITOR_RENDER_THEME = "LIGHT";
+/**
+ * Resolves an app-level theme into the visual theme used by `<BookEditor/>`.
+ *
+ * @param hostTheme - Resolved theme from the embedding application.
+ * @returns Light theme used by the Book editor surface.
+ *
+ * @private internal utility of `BookEditor`
+ */
+export declare function resolveBookEditorRenderTheme(hostTheme?: BookEditorTheme): BookEditorTheme;

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

@@ -1,14 +1,9 @@
 import type { editor } from 'monaco-editor';
+import type { BookEditorTheme } from './BookEditorTheme';
 /**
  * Type describing monaco editor.
  */
 type MonacoEditor = typeof import('monaco-editor');
-/**
- * Resolved visual theme supported by the Book editor.
- *
- * @private function of BookEditorMonaco
- */
-type BookEditorTheme = 'LIGHT' | 'DARK';
 /**
  * Props for use book editor monaco language.
  */

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

@@ -1,12 +1,9 @@
 import type { editor } from 'monaco-editor';
+import type { BookEditorTheme } from './BookEditorTheme';
 /**
  * Type describing monaco editor.
  */
 type MonacoEditor = typeof import('monaco-editor');
-/**
- * Resolved visual theme supported by the Book editor.
- */
-type BookEditorTheme = 'LIGHT' | 'DARK';
 /**
  * Props for use book editor monaco lifecycle.
  */

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

@@ -1,3 +1,4 @@
+import type { BookEditorTheme } from './BookEditorTheme';
 /**
  * Props for use book editor monaco styles.
  */
@@ -7,7 +8,7 @@ type UseBookEditorMonacoStylesProps = {
     readonly scaledContentPaddingLeft: number;
     readonly scaledVerticalLineLeft: number;
     readonly zoomLevel: number;
-    readonly theme: 'LIGHT' | 'DARK';
+    readonly theme: BookEditorTheme;
 };
 /**
  * Injects notebook-inspired styling that is unique per `BookEditorMonaco` instance.

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

@@ -28,6 +28,12 @@ export declare const AGENT_QUEUED_MESSAGES_DIRECTORY_PATH: string;
  * @private internal utility of `ptbk agent-folder`
  */
 export declare const AGENT_FINISHED_MESSAGES_DIRECTORY_PATH: string;
+/**
+ * Relative path to messages that the agent runner stopped retrying.
+ *
+ * @private internal utility of `ptbk agent-folder`
+ */
+export declare const AGENT_FAILED_MESSAGES_DIRECTORY_PATH: string;
 /**
  * Relative path to generated local agent documentation initialized by `ptbk agent-folder init`.
  *

package/esm/src/version.d.ts

@@ -15,7 +15,7 @@ export declare const BOOK_LANGUAGE_VERSION: string_semantic_version;
 export declare const PROMPTBOOK_ENGINE_VERSION: string_promptbook_version;
 /**
  * Represents the version string of the Promptbook engine.
- * It follows semantic versioning (e.g., `0.112.0-102`).
+ * It follows semantic versioning (e.g., `0.112.0-104`).
  *
  * @generated
  */

package/package.json

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

package/umd/index.umd.js

@@ -31,7 +31,7 @@
      * @generated
      * @see https://github.com/webgptorg/promptbook
      */
-    const PROMPTBOOK_ENGINE_VERSION = '0.112.0-104';
+    const PROMPTBOOK_ENGINE_VERSION = '0.112.0-105';
     /**
      * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
      * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -5550,10 +5550,7 @@
             Math.max(0, Math.cos(effectiveLongitude)) * 0.1 +
             lowerBlend * tentacleInfluence.core * (0.1 + tentacleInfluence.depthScale * 0.06) -
             Math.max(0, -Math.cos(effectiveLongitude)) * 0.05;
-        const tentacleTubeRadius = lowerBlend *
-            tentacleInfluence.core *
-            (0.11 + tipBlend * 0.06 + tentacleInfluence.widthScale * 0.025) *
-            radiusX;
+        const tentacleTubeRadius = lowerBlend * tentacleInfluence.core * (0.11 + tipBlend * 0.06 + tentacleInfluence.widthScale * 0.025) * radiusX;
         const planarRadiusX = cosineLatitude * radiusX * horizontalScale + tentacleTubeRadius;
         const planarRadiusZ = cosineLatitude * radiusZ * depthScale + tentacleTubeRadius * 0.72;
         const lowerDrop = lowerBlend *
@@ -5564,8 +5561,7 @@
                         tentacleInfluence.lengthScale * 0.22 +
                         (morphologyProfile.tentacles.flowLengthScale - 1) * 0.08));
         return {
-            x: Math.sin(effectiveLongitude) * planarRadiusX +
-                tentacleWave * radiusX * (0.052 + tipBlend * 0.05),
+            x: Math.sin(effectiveLongitude) * planarRadiusX + tentacleWave * radiusX * (0.052 + tipBlend * 0.05),
             y: Math.sin(latitude) * radiusY * (1 + upperBlend * 0.12) -
                 upperBlend * radiusY * 0.1 +
                 lowerDrop +
@@ -5639,8 +5635,11 @@
      */
     function resolveContinuousLobeWave(options, longitude) {
         const { morphologyProfile, animationPhase, timeMs } = options;
-        return (Math.cos(longitude * OCTOPUS_TENTACLE_COUNT + animationPhase + timeMs / (980 + morphologyProfile.body.lobeCount * 18)) +
-            1) / 2;
+        return ((Math.cos(longitude * OCTOPUS_TENTACLE_COUNT +
+            animationPhase +
+            timeMs / (980 + morphologyProfile.body.lobeCount * 18)) +
+            1) /
+            2);
     }
     /**
      * Resolves one base fill tone for a patch on the continuous octopus mesh.
@@ -5704,8 +5703,7 @@
             for (let sampleIndex = 0; sampleIndex < 8; sampleIndex++) {
                 const progress = sampleIndex / 7;
                 const latitude = -0.46 + progress * 0.74;
-                const longitude = baseLongitude +
-                    Math.sin(timeMs / 1160 + animationPhase + currentIndex * 0.7 + progress * 2) * 0.035;
+                const longitude = baseLongitude + Math.sin(timeMs / 1160 + animationPhase + currentIndex * 0.7 + progress * 2) * 0.035;
                 const scenePoint = transformScenePoint(sampleContinuousOctopusSurfacePoint(surfaceOptions, latitude, longitude), center, rotationX, rotationY);
                 if (scenePoint.z > center.z - size * 0.016) {
                     projectedPoints.push(projectScenePoint(scenePoint, size, sceneCenterX, sceneCenterY));
@@ -23380,6 +23378,30 @@
         DIAGNOSTIC_MARKER_OWNER: 'book-editor-diagnostics',
     };
 
+    /**
+     * Theme used for the actual notebook editor surface.
+     *
+     * The host application can still pass its resolved app theme, but book sources
+     * are intentionally rendered as light paper in both light and dark app modes.
+     *
+     * @private internal constant of `BookEditor`
+     */
+    const BOOK_EDITOR_RENDER_THEME = 'LIGHT';
+    /**
+     * Resolves an app-level theme into the visual theme used by `<BookEditor/>`.
+     *
+     * @param hostTheme - Resolved theme from the embedding application.
+     * @returns Light theme used by the Book editor surface.
+     *
+     * @private internal utility of `BookEditor`
+     */
+    function resolveBookEditorRenderTheme(hostTheme = BOOK_EDITOR_RENDER_THEME) {
+        if (hostTheme === 'DARK') {
+            return BOOK_EDITOR_RENDER_THEME;
+        }
+        return hostTheme;
+    }
+
     /**
      * Gets a commitment definition by its type
      *
@@ -24389,19 +24411,20 @@
      *
      * @private function of BookEditorMonaco
      */
-    function ensureBookEditorMonacoLanguage(monaco, theme = 'LIGHT') {
+    function ensureBookEditorMonacoLanguage(monaco, theme = BOOK_EDITOR_RENDER_THEME) {
+        const renderedTheme = resolveBookEditorRenderTheme(theme);
         const monacoWithLanguageState = monaco;
         if (monacoWithLanguageState[BOOK_EDITOR_LANGUAGE_INITIALIZED_FLAG]) {
-            if (monacoWithLanguageState[BOOK_EDITOR_THEME_MODE_FLAG] !== theme) {
-                applyBookEditorMonacoTheme(monaco, theme);
-                monacoWithLanguageState[BOOK_EDITOR_THEME_MODE_FLAG] = theme;
+            if (monacoWithLanguageState[BOOK_EDITOR_THEME_MODE_FLAG] !== renderedTheme) {
+                applyBookEditorMonacoTheme(monaco, renderedTheme);
+                monacoWithLanguageState[BOOK_EDITOR_THEME_MODE_FLAG] = renderedTheme;
                 return;
             }
             monaco.editor.setTheme(BookEditorMonacoConstants.BOOK_THEME_ID);
             return;
         }
         monacoWithLanguageState[BOOK_EDITOR_LANGUAGE_INITIALIZED_FLAG] = true;
-        monacoWithLanguageState[BOOK_EDITOR_THEME_MODE_FLAG] = theme;
+        monacoWithLanguageState[BOOK_EDITOR_THEME_MODE_FLAG] = renderedTheme;
         monaco.languages.register({ id: BookEditorMonacoConstants.BOOK_LANGUAGE_ID });
         const commitmentDefinitions = getAllCommitmentDefinitions();
         const commitmentTypes = [...new Set(commitmentDefinitions.map(({ type }) => type))];
@@ -24511,7 +24534,7 @@
                 return { links };
             },
         });
-        applyBookEditorMonacoTheme(monaco, theme);
+        applyBookEditorMonacoTheme(monaco, renderedTheme);
     }
     /**
      * Ensures the mounted Monaco editor model uses Book language and Book theme.
@@ -24524,8 +24547,9 @@
      * @private function of BookEditorMonaco
      */
     function ensureBookEditorMonacoLanguageForEditor(props) {
-        const { monaco, monacoEditor, theme = 'LIGHT' } = props;
-        ensureBookEditorMonacoLanguage(monaco, theme);
+        const { monaco, monacoEditor, theme = BOOK_EDITOR_RENDER_THEME } = props;
+        const renderedTheme = resolveBookEditorRenderTheme(theme);
+        ensureBookEditorMonacoLanguage(monaco, renderedTheme);
         const model = monacoEditor.getModel();
         if (!model) {
             return;
@@ -25757,7 +25781,8 @@
      * @private Internal component used by `BookEditor`
      */
     function BookEditorMonaco(props) {
-        const { value, onChange, diagnostics, isReadonly, theme = 'LIGHT', translations, onFileUpload, isUploadButtonShown, isCameraButtonShown, isDownloadButtonShown, isAboutButtonShown = true, isFullscreenButtonShown = true, onFullscreenClick, isFullscreen, zoom = 1, monacoModelPath, hoistedMenuItems, } = props;
+        const { value, onChange, diagnostics, isReadonly, theme: hostTheme = BOOK_EDITOR_RENDER_THEME, translations, onFileUpload, isUploadButtonShown, isCameraButtonShown, isDownloadButtonShown, isAboutButtonShown = true, isFullscreenButtonShown = true, onFullscreenClick, isFullscreen, zoom = 1, monacoModelPath, hoistedMenuItems, } = props;
+        const theme = resolveBookEditorRenderTheme(hostTheme);
         const zoomLevel = zoom;
         const { scaledLineHeight, scaledContentPaddingLeft, scaledVerticalLineLeft, scaledFontSize, scaledScrollbarSize } = createBookEditorMonacoScale(zoomLevel);
         const monaco = MonacoEditor.useMonaco();
@@ -25846,15 +25871,16 @@
      * @public exported from `@promptbook/components`
      */
     function BookEditor(props) {
-        const { agentSource, className, style, theme = 'LIGHT', zoom = 1, value, onChange, diagnostics, onFileUpload, isVerbose = DEFAULT_IS_VERBOSE, isBorderRadiusDisabled = false, isReadonly = false, translations, isUploadButtonShown = true, isCameraButtonShown, isDownloadButtonShown = true, isAboutButtonShown = true, isFullscreenButtonShown = true, sync, monacoModelPath, hoistedMenuItems, } = props;
+        const { agentSource, className, style, theme: hostTheme = BOOK_EDITOR_RENDER_THEME, zoom = 1, value, onChange, diagnostics, onFileUpload, isVerbose = DEFAULT_IS_VERBOSE, isBorderRadiusDisabled = false, isReadonly = false, translations, isUploadButtonShown = true, isCameraButtonShown, isDownloadButtonShown = true, isAboutButtonShown = true, isFullscreenButtonShown = true, sync, monacoModelPath, hoistedMenuItems, } = props;
         const [isFullscreen, setIsFullscreen] = react.useState(false);
+        const renderedTheme = resolveBookEditorRenderTheme(hostTheme);
         /**
          * Toggles fullscreen mode for the editor.
          */
         const handleFullscreenToggle = () => {
             setIsFullscreen(!isFullscreen);
         };
-        const editorContent = (jsxRuntime.jsx("div", { "data-book-component": "BookEditor", "data-book-editor-theme": theme.toLowerCase(), className: classNames(styles$d.BookEditor, isVerbose && styles$d.isVerbose, styles$d.bookEditorWrapper, isBorderRadiusDisabled && styles$d.isBorderRadiusDisabled, isFullscreen && styles$d.fullscreen, className), style: isFullscreen
+        const editorContent = (jsxRuntime.jsx("div", { "data-book-component": "BookEditor", "data-book-editor-theme": renderedTheme.toLowerCase(), className: classNames(styles$d.BookEditor, isVerbose && styles$d.isVerbose, styles$d.bookEditorWrapper, isBorderRadiusDisabled && styles$d.isBorderRadiusDisabled, isFullscreen && styles$d.fullscreen, className), style: isFullscreen
                 ? style
                 : {
                     ...(style || {}),
@@ -25865,7 +25891,7 @@
                                 ? `${props.height}px`
                                 : props.height || `${DEFAULT_BOOK_EDITOR_HEIGHT}px`,
                         }),
-                }, children: jsxRuntime.jsx(BookEditorMonaco, { value: agentSource || value, onChange: onChange, diagnostics: diagnostics, onFileUpload: onFileUpload, isVerbose: isVerbose, isBorderRadiusDisabled: isBorderRadiusDisabled, isReadonly: isReadonly, translations: translations, isUploadButtonShown: isUploadButtonShown, isCameraButtonShown: isCameraButtonShown, isDownloadButtonShown: isDownloadButtonShown, isAboutButtonShown: isAboutButtonShown, isFullscreenButtonShown: isFullscreenButtonShown, onFullscreenClick: handleFullscreenToggle, isFullscreen: isFullscreen, sync: sync, zoom: zoom, monacoModelPath: monacoModelPath, hoistedMenuItems: hoistedMenuItems, theme: theme }) }));
+                }, children: jsxRuntime.jsx(BookEditorMonaco, { value: agentSource || value, onChange: onChange, diagnostics: diagnostics, onFileUpload: onFileUpload, isVerbose: isVerbose, isBorderRadiusDisabled: isBorderRadiusDisabled, isReadonly: isReadonly, translations: translations, isUploadButtonShown: isUploadButtonShown, isCameraButtonShown: isCameraButtonShown, isDownloadButtonShown: isDownloadButtonShown, isAboutButtonShown: isAboutButtonShown, isFullscreenButtonShown: isFullscreenButtonShown, onFullscreenClick: handleFullscreenToggle, isFullscreen: isFullscreen, sync: sync, zoom: zoom, monacoModelPath: monacoModelPath, hoistedMenuItems: hoistedMenuItems, theme: renderedTheme }) }));
         return isFullscreen && typeof document !== 'undefined' ? reactDom.createPortal(editorContent, document.body) : editorContent;
     }