@promptbook/cli 0.112.0-117 → 0.112.0-119

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/cli/cli-commands/coder/run.ts

@@ -11,6 +11,7 @@ import {
     normalizePromptRunnerCliOptions,
     PROMPT_RUNNER_DESCRIPTION,
 } from '../common/promptRunnerCliOptions';
+import { parseDuration } from '../../../../scripts/run-codex-prompts/common/parseDuration';
 
 /**
  * Initializes `coder run` command for Promptbook CLI utilities
@@ -57,7 +58,17 @@ export function $initializeCoderRunCommand(program: Program): $side_effect {
     );
     addPromptRunnerExecutionOptions(command);
     command.option('--priority <minimum-priority>', 'Filter prompts by minimum priority level', parseIntOption, 0);
-    command.option('--no-wait', 'Skip user prompts between processing');
+    command.option(
+        '--wait [duration]',
+        spaceTrim(`
+            Wait between prompt rounds.
+            Without a value (default): waits for user confirmation before each prompt (interactive mode).
+            With a duration like 1h, 30m, 5s: waits that long between prompts to avoid hitting rate limits of the harness.
+        `),
+        true,
+    );
+    // Note: --no-wait disables the default interactive wait-for-user behaviour
+    command.option('--no-wait', 'Skip all waiting between prompts and run non-interactively');
     command.option(
         '--auto-migrate',
         'Run testing-server database migrations automatically after each successfully processed prompt',
@@ -76,7 +87,7 @@ export function $initializeCoderRunCommand(program: Program): $side_effect {
                     readonly test?: string | string[];
                     readonly preserveLogs: boolean;
                     readonly priority: number;
-                    readonly wait: boolean;
+                    readonly wait: boolean | string;
                     readonly autoMigrate: boolean;
                     readonly allowDestructiveAutoMigrate: boolean;
                 } & PromptRunnerCliOptions;
@@ -86,10 +97,24 @@ export function $initializeCoderRunCommand(program: Program): $side_effect {
                 isAgentRequired: !dryRun,
             });
 
+            // [1] Parse the --wait option:
+            //   true (default or --wait without value): wait for user confirmation
+            //   false (--no-wait): no waiting at all
+            //   string (--wait 1h): wait that long between prompt rounds
+            let waitForUser = false;
+            let waitBetweenPrompts = 0;
+
+            if (wait === true) {
+                waitForUser = true;
+            } else if (typeof wait === 'string' && wait !== '') {
+                waitBetweenPrompts = parseDuration(wait);
+            }
+
             // Convert commander options to RunOptions format
             const runOptions = {
                 dryRun,
-                waitForUser: wait,
+                waitForUser,
+                waitBetweenPrompts,
                 noCommit: runnerOptions.noCommit,
                 ignoreGitChanges: runnerOptions.ignoreGitChanges,
                 agentName: runnerOptions.agentName,

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

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

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,