@promptbook/cli 0.112.0-118 → 0.112.0-119

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

@@ -1,4 +1,4 @@
-import { CSSProperties } from 'react';
+import { type CSSProperties } from 'react';
 import type { Promisable } from 'type-fest';
 import type { string_book } from '../../book-2.0/agent-source/string_book';
 import type { number_percent } from '../../types/number_percent';

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

@@ -1,4 +1,4 @@
-import { BookEditorProps } from './BookEditor';
+import type { BookEditorProps } from './BookEditor';
 /**
  * Renders a book editor
  *

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

@@ -0,0 +1,20 @@
+/**
+ * Props for the citation iframe preview component.
+ *
+ * @private component of `<ChatCitationModal/>`
+ */
+export type CitationIframePreviewProps = {
+    src: string;
+    title: string;
+};
+/**
+ * Renders a citation URL preview as an iframe when the target page allows embedding,
+ * or falls back to a server-side screenshot with an "Open in new tab" link when it
+ * does not (e.g. X-Frame-Options: DENY / SAMEORIGIN).
+ *
+ * Embedding capability is determined by `GET /api/page-preview/check?url=<url>`.
+ * If that endpoint is unavailable the component falls back to the iframe directly.
+ *
+ * @private component of `<ChatCitationModal/>`
+ */
+export declare function CitationIframePreview({ src, title }: CitationIframePreviewProps): import("react/jsx-runtime").JSX.Element;

package/esm/src/book-components/_common/Dropdown/Dropdown.d.ts

@@ -1,4 +1,4 @@
-import { ReactNode } from 'react';
+import { type ReactNode } from 'react';
 /**
  * Props for dropdown.
  */

package/esm/src/book-components/_common/MenuHoisting/MenuHoistingContext.d.ts

@@ -1,4 +1,4 @@
-import { ReactNode } from 'react';
+import { type ReactNode } from 'react';
 /**
  * Item that can be hoisted to the top menu
  *

package/esm/src/book-components/_common/Modal/Modal.d.ts

@@ -1,4 +1,4 @@
-import { ReactNode } from 'react';
+import { type ReactNode } from 'react';
 /**
  * Handles modal.
  *

package/esm/src/book-components/icons/AboutIcon.d.ts

@@ -1,4 +1,4 @@
-import { SVGProps } from 'react';
+import type { SVGProps } from 'react';
 /**
  * Renders an information/about icon.
  *

package/esm/src/book-components/icons/DownloadIcon.d.ts

@@ -1,4 +1,4 @@
-import { SVGProps } from 'react';
+import type { SVGProps } from 'react';
 /**
  * Renders a download icon.
  *

package/esm/src/book-components/icons/ExitFullscreenIcon.d.ts

@@ -1,4 +1,4 @@
-import { JSX } from 'react';
+import type { JSX } from 'react';
 /**
  * Renders an icon that represents the exit fullscreen action
  *

package/esm/src/book-components/icons/FullscreenIcon.d.ts

@@ -1,4 +1,4 @@
-import { JSX } from 'react';
+import type { JSX } from 'react';
 /**
  * Renders an icon that represents the fullscreen action
  *

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

package/package.json

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

package/src/book-3.0/LiteAgent.ts

@@ -305,7 +305,7 @@ async function resolveLiteAgentScriptExecutionTools(
     if (options.scriptExecutionTools) {
         return Array.isArray(options.scriptExecutionTools)
             ? options.scriptExecutionTools
-            : [options.scriptExecutionTools];
+            : [options.scriptExecutionTools as ScriptExecutionTools];
     }
 
     return $provideScriptingForNode({

package/src/book-components/BookEditor/BookEditor.tsx

@@ -2,7 +2,7 @@
 // <- Note: [👲] 'use client' is enforced by Next.js when building the https://book-components.ptbk.io/ but in ideal case,
 //          this would not be here because the `@promptbook/components` package should be React library independent of Next.js specifics
 
-import { CSSProperties, useState } from 'react';
+import { type CSSProperties, useState } from 'react';
 import { createPortal } from 'react-dom';
 import type { Promisable } from 'type-fest';
 import type { string_book } from '../../book-2.0/agent-source/string_book';
@@ -14,8 +14,8 @@ import type { string_css_value } from '../../types/string_markdown';
 import { countLines } from '../../utils/expectation-counters/countLines';
 import type { HoistedMenuItem } from '../_common/MenuHoisting/MenuHoistingContext';
 import { classNames } from '../_common/react-utils/classNames';
-import { DEFAULT_IS_VERBOSE } from './BookEditorBrowserConfig';
 import styles from './BookEditor.module.css';
+import { DEFAULT_IS_VERBOSE } from './BookEditorBrowserConfig';
 import { BookEditorMonaco } from './BookEditorMonaco';
 import type { BookEditorTheme } from './BookEditorTheme';
 import { BOOK_EDITOR_RENDER_THEME, resolveBookEditorRenderTheme } from './BookEditorTheme';
@@ -300,11 +300,11 @@ export function BookEditor(props: BookEditorProps) {
         isBorderRadiusDisabled = false,
         isReadonly = false,
         translations,
-        isUploadButtonShown = true,
+        isUploadButtonShown = false,
         isCameraButtonShown,
-        isDownloadButtonShown = true,
-        isAboutButtonShown = true,
-        isFullscreenButtonShown = true,
+        isDownloadButtonShown = false,
+        isAboutButtonShown = false,
+        isFullscreenButtonShown = false,
         sync,
         monacoModelPath,
         hoistedMenuItems,

package/src/book-components/BookEditor/BookEditorForClient.tsx

@@ -1,5 +1,5 @@
 import { useEffect, useState } from 'react';
-import { BookEditorProps } from './BookEditor';
+import type { BookEditorProps } from './BookEditor';
 
 type BookEditorComponent = typeof import('./BookEditor').BookEditor;
 

package/src/book-components/Chat/Chat/Chat.module.css

@@ -3311,6 +3311,51 @@
     display: block;
 }
 
+.citationIframeLoading {
+    width: 100%;
+    height: 60vh;
+    min-height: 400px;
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    color: #888;
+    font-size: 0.9em;
+}
+
+.citationScreenshotFallback {
+    width: 100%;
+    position: relative;
+    display: flex;
+    flex-direction: column;
+}
+
+.citationScreenshotImage {
+    width: 100%;
+    max-height: 60vh;
+    min-height: 400px;
+    object-fit: cover;
+    object-position: top;
+    display: block;
+}
+
+.citationScreenshotLink {
+    display: block;
+    text-align: center;
+    padding: 10px 16px;
+    background: #f0f0f0;
+    color: #333;
+    font-size: 0.9em;
+    font-weight: 500;
+    text-decoration: none;
+    border-top: 1px solid #ddd;
+    transition: background 0.15s;
+}
+
+.citationScreenshotLink:hover {
+    background: #e0e0e0;
+    text-decoration: underline;
+}
+
 .citationMetadata {
     background: #f8f8f8;
     padding: 16px;

package/src/book-components/Chat/Chat/ChatCitationModal.tsx

@@ -8,6 +8,7 @@ import type { ChatParticipant } from '../types/ChatParticipant';
 import { getCitationLabel, isPlainTextCitation, resolveCitationPreviewUrl } from '../utils/citationHelpers';
 import type { ParsedCitation } from '../utils/parseCitationsFromContent';
 import styles from './Chat.module.css';
+import { CitationIframePreview } from './CitationIframePreview';
 import type { ChatSoundSystem } from './ChatProps';
 
 /**
@@ -84,9 +85,8 @@ export function ChatCitationModal(props: ChatCitationModalProps) {
                                         }}
                                     />
                                 ) : (
-                                    <iframe
+                                    <CitationIframePreview
                                         src={previewUrl ?? citation.source}
-                                        className={styles.citationIframe}
                                         title={`Preview of ${label}`}
                                     />
                                 )}

package/src/book-components/Chat/Chat/CitationIframePreview.tsx

@@ -0,0 +1,83 @@
+'use client';
+
+import { useEffect, useState } from 'react';
+import styles from './Chat.module.css';
+
+/**
+ * Props for the citation iframe preview component.
+ *
+ * @private component of `<ChatCitationModal/>`
+ */
+export type CitationIframePreviewProps = {
+    src: string;
+    title: string;
+};
+
+/**
+ * Internal status of the iframe embed check.
+ *
+ * @private type of `<CitationIframePreview/>`
+ */
+type EmbedStatus = 'loading' | 'embed' | 'screenshot';
+
+/**
+ * Renders a citation URL preview as an iframe when the target page allows embedding,
+ * or falls back to a server-side screenshot with an "Open in new tab" link when it
+ * does not (e.g. X-Frame-Options: DENY / SAMEORIGIN).
+ *
+ * Embedding capability is determined by `GET /api/page-preview/check?url=<url>`.
+ * If that endpoint is unavailable the component falls back to the iframe directly.
+ *
+ * @private component of `<ChatCitationModal/>`
+ */
+export function CitationIframePreview({ src, title }: CitationIframePreviewProps) {
+    const [status, setStatus] = useState<EmbedStatus>('loading');
+
+    useEffect(() => {
+        let cancelled = false;
+
+        fetch(`/api/page-preview/check?url=${encodeURIComponent(src)}`)
+            .then((response) => response.json())
+            .then((data: { canEmbed: boolean }) => {
+                if (!cancelled) {
+                    setStatus(data.canEmbed ? 'embed' : 'screenshot');
+                }
+            })
+            .catch(() => {
+                // API not available — fall back to iframe (e.g. outside agents-server)
+                if (!cancelled) {
+                    setStatus('embed');
+                }
+            });
+
+        return () => {
+            cancelled = true;
+        };
+    }, [src]);
+
+    if (status === 'loading') {
+        return <div className={styles.citationIframeLoading}>Loading preview…</div>;
+    }
+
+    if (status === 'screenshot') {
+        return (
+            <div className={styles.citationScreenshotFallback}>
+                <img
+                    src={`/api/page-preview/screenshot?url=${encodeURIComponent(src)}`}
+                    alt={`Screenshot of ${title}`}
+                    className={styles.citationScreenshotImage}
+                />
+                <a
+                    href={src}
+                    target="_blank"
+                    rel="noopener noreferrer"
+                    className={styles.citationScreenshotLink}
+                >
+                    Open in new tab ↗
+                </a>
+            </div>
+        );
+    }
+
+    return <iframe src={src} className={styles.citationIframe} title={title} />;
+}

package/src/book-components/_common/Dropdown/Dropdown.tsx

@@ -1,6 +1,6 @@
 'use client';
 
-import React, { ReactNode, useState } from 'react';
+import React, { type ReactNode, useState } from 'react';
 import { HamburgerMenu } from '../HamburgerMenu/HamburgerMenu';
 import { classNames } from '../react-utils/classNames';
 import styles from './Dropdown.module.css';

package/src/book-components/_common/MenuHoisting/MenuHoistingContext.tsx

@@ -1,4 +1,4 @@
-import { createContext, ReactNode, useContext, useState } from 'react';
+import { createContext, type ReactNode, useContext, useState } from 'react';
 
 /**
  * Item that can be hoisted to the top menu

package/src/book-components/_common/Modal/Modal.tsx

@@ -1,4 +1,4 @@
-import { ReactNode, useEffect } from 'react';
+import { type ReactNode, useEffect } from 'react';
 import { createPortal } from 'react-dom';
 import { classNames } from '../react-utils/classNames';
 import styles from './Modal.module.css';

package/src/book-components/icons/AboutIcon.tsx

@@ -1,6 +1,6 @@
 'use client';
 
-import { SVGProps } from 'react';
+import type { SVGProps } from 'react';
 
 /**
  * Renders an information/about icon.

package/src/book-components/icons/DownloadIcon.tsx

@@ -1,6 +1,6 @@
 'use client';
 
-import { SVGProps } from 'react';
+import type { SVGProps } from 'react';
 
 /**
  * Renders a download icon.

package/src/book-components/icons/ExitFullscreenIcon.tsx

@@ -1,4 +1,4 @@
-import { JSX } from 'react';
+import type { JSX } from 'react';
 import iconAsset from './ExitFullscreenIcon.svg';
 // <- TODO: [😺] Is this type of SVG import working correctly?
 // <- TODO: [😺] Try also the png import if SVG works

package/src/book-components/icons/FullscreenIcon.tsx

@@ -1,4 +1,4 @@
-import { JSX } from 'react';
+import type { JSX } from 'react';
 
 /**
  * Renders an icon that represents the fullscreen action

package/src/cli/cli-commands/agents-server/buildAgentsServer.ts

@@ -34,6 +34,17 @@ const AGENTS_SERVER_NEXT_BUILD_ID_FILENAME = 'BUILD_ID';
  */
 const DEFAULT_AGENTS_SERVER_NEXT_DIST_DIRECTORY_NAME = '.next';
 
+/**
+ * Node.js heap size limit (in MiB) injected into `NODE_OPTIONS` for the Next.js production build.
+ *
+ * Next.js webpack peaks at ~1.9 GiB on a fresh install; the Node.js default cap is ~1.7 GiB,
+ * which causes an OOM crash on first-run VPS installations where swap is the primary resource.
+ * Raising the limit lets the build complete on the first attempt.
+ *
+ * @private internal constant of `ptbk agents-server`
+ */
+const AGENTS_SERVER_BUILD_MAX_OLD_SPACE_MIB = 4096;
+
 /**
  * Environment variable passed to the bundled Next app so webpack can resolve dependencies
  * installed beside `ptbk` even when the app sources are materialized into a project cache.
@@ -618,7 +629,13 @@ async function runNextBuild(options: {
     await new Promise<void>((resolveBuild, rejectBuild) => {
         const buildProcess = spawn(process.execPath, [options.nextCliPath, 'build'], {
             cwd: options.appPath,
-            env: options.environment,
+            env: {
+                ...options.environment,
+                NODE_OPTIONS: mergeNodeOptionsWithHeapSize(
+                    options.environment.NODE_OPTIONS,
+                    AGENTS_SERVER_BUILD_MAX_OLD_SPACE_MIB,
+                ),
+            },
             stdio: ['ignore', 'pipe', 'pipe'],
         });
 
@@ -641,6 +658,19 @@ async function runNextBuild(options: {
     });
 }
 
+/**
+ * Prepends `--max-old-space-size=<mib>` to `NODE_OPTIONS` unless the caller already set one.
+ */
+function mergeNodeOptionsWithHeapSize(existingNodeOptions: string | undefined, maxOldSpaceMib: number): string {
+    if (existingNodeOptions !== undefined && /--max-old-space-size[= ]/u.test(existingNodeOptions)) {
+        return existingNodeOptions;
+    }
+
+    const heapFlag = `--max-old-space-size=${maxOldSpaceMib}`;
+
+    return existingNodeOptions ? `${heapFlag} ${existingNodeOptions}` : heapFlag;
+}
+
 /**
  * Sends one Next build output chunk through the caller handler or to the foreground terminal.
  */

package/src/execution/createPipelineExecutor/getKnowledgeForTask.ts

@@ -4,7 +4,7 @@ import { getSingleLlmExecutionTools } from '../../llm-providers/_multiple/getSin
 import type { PipelineJson } from '../../pipeline/PipelineJson/PipelineJson';
 import type { TaskJson } from '../../pipeline/PipelineJson/TaskJson';
 import type { Parameters } from '../../types/Parameters';
-import { Prompt } from '../../types/Prompt';
+import type { Prompt } from '../../types/Prompt';
 import type { string_markdown } from '../../types/string_markdown';
 import type { string_parameter_value } from '../../types/string_name';
 import type { ExecutionTools } from '../ExecutionTools';

package/src/llm-providers/openai/OpenAiAgentKitExecutionToolsToolBuilder.ts

@@ -449,7 +449,7 @@ export class OpenAiAgentKitExecutionToolsToolBuilder {
             );
         }
 
-        return Array.isArray(executionTools.script) ? executionTools.script : [executionTools.script];
+        return Array.isArray(executionTools.script) ? executionTools.script : [executionTools.script as ScriptExecutionTools];
     }
 
     /**

package/src/llm-providers/openai/OpenAiAssistantExecutionToolsToolRunner.ts

@@ -436,7 +436,7 @@ export class OpenAiAssistantExecutionToolsToolRunner {
 
         return Array.isArray(this.options.scriptExecutionTools)
             ? this.options.scriptExecutionTools
-            : [this.options.scriptExecutionTools];
+            : [this.options.scriptExecutionTools as ScriptExecutionTools];
     }
 
     /**

package/src/llm-providers/openai/OpenAiVectorStoreKnowledgeSourcePreparer.ts

@@ -134,7 +134,7 @@ export class OpenAiVectorStoreKnowledgeSourcePreparer {
             }
 
             return {
-                file: new File([parsed.buffer], parsed.filename, {
+                file: new File([new Uint8Array(parsed.buffer)], parsed.filename, {
                     type: parsed.mimeType,
                 }),
                 sizeBytes: parsed.buffer.length,