@promptbook/cli 0.112.0-101 → 0.112.0-103

package/esm/scripts/run-codex-prompts/common/waitForPause.d.ts

@@ -30,6 +30,18 @@ export declare function checkPause(options?: {
  * Returns the current pause state for external consumers such as the terminal UI.
  */
 export declare function getPauseState(): CoderRunPauseState;
+/**
+ * Returns the label of the next checkpoint where pausing will take effect.
+ */
+export declare function getPauseTargetLabel(): string;
+/**
+ * Updates the label of the next pause checkpoint.
+ */
+export declare function announcePauseTargetLabel(nextPauseTargetLabel: string): void;
+/**
+ * Restores the default generic pause target label.
+ */
+export declare function resetPauseTargetLabel(): void;
 /**
  * Requests a pause from an external controller (e.g. the Ink UI).
  */

package/esm/scripts/run-codex-prompts/main/runPromptRound.d.ts

@@ -1,3 +1,4 @@
+import type { WaitForCoderRunPauseCheckpoint } from '../common/CoderRunPauseCheckpoint';
 import type { CliProgressDisplay } from '../common/cliProgressDisplay';
 import type { RunOptions } from '../cli/RunOptions';
 import type { PromptSelection } from '../prompts/types/PromptSelection';
@@ -19,7 +20,7 @@ type RunPromptRoundOptions = {
     isRichUiEnabled: boolean;
     progressDisplay?: CliProgressDisplay;
     uiHandle?: CoderRunUiHandle;
-    waitForRequestedPause(): Promise<void>;
+    waitForRequestedPause: WaitForCoderRunPauseCheckpoint;
 };
 /**
  * Runs one prompt round from prompt construction through commit or failure logging.

package/esm/scripts/run-codex-prompts/ui/buildCoderRunUiFrame.d.ts

@@ -12,6 +12,7 @@ export type BuildCoderRunUiFrameOptions = {
     readonly animationFrame: number;
     readonly spinner: string;
     readonly pauseState: CoderRunPauseState;
+    readonly pauseTargetLabel: string;
     readonly config: CoderRunConfig;
     readonly phase: CoderRunPhase;
     readonly currentPromptLabel: string;

package/esm/scripts/run-codex-prompts/ui/buildRunUiFrameShared.d.ts

@@ -42,7 +42,7 @@ export declare function buildScriptPathSessionRows(scriptPaths: readonly string[
 /**
  * Builds the colored phase badge shown in the session box.
  */
-export declare function buildPausePresentation(phase: CoderRunPhase, pauseState: CoderRunPauseState, statusMessage: string): PausePresentation;
+export declare function buildPausePresentation(phase: CoderRunPhase, pauseState: CoderRunPauseState, pauseTargetLabel: string, statusMessage: string): PausePresentation;
 /**
  * Builds the progress bar shown in the session box.
  */

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

@@ -7,6 +7,7 @@ type MarkdownContentProps = {
     content: string_markdown;
     className?: string;
     onCreateAgent?: (bookContent: string) => void;
+    theme?: 'LIGHT' | 'DARK';
 };
 /**
  * Renders markdown content with support for code highlighting, math, and tables.

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

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@promptbook/cli",
-    "version": "0.112.0-101",
+    "version": "0.112.0-103",
     "description": "Promptbook: Create persistent AI agents that turn your company's scattered knowledge into action",
     "private": false,
     "sideEffects": false,
@@ -159,6 +159,7 @@
         "@types/swagger-ui-react": "5.18.0",
         "@types/turndown": "5.0.6",
         "@vercel/blob": "1.1.1",
+        "@xmldom/xmldom": "^0.9.10",
         "@xterm/addon-fit": "0.11.0",
         "@xterm/xterm": "6.0.0",
         "better-sqlite3": "^11.10.0",
@@ -166,7 +167,6 @@
         "cross-fetch": "4.0.0",
         "destroyable": "0.12.145",
         "dompurify": "3.4.6",
-        "fast-xml-parser": "^5.2.5",
         "formidable": "3.5.4",
         "highlight.js": "11.11.1",
         "html-to-image": "1.11.13",

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

@@ -1,6 +1,6 @@
 'use client';
 
-import { memo, useEffect, useMemo, useRef } from 'react';
+import { memo, useEffect, useMemo, useRef, useState } from 'react';
 import { createRoot, type Root } from 'react-dom/client';
 import type { string_markdown } from '../../../types/string_markdown';
 import { classNames } from '../../_common/react-utils/classNames';
@@ -23,8 +23,37 @@ type MarkdownContentProps = {
 
     className?: string;
     onCreateAgent?: (bookContent: string) => void;
+    theme?: 'LIGHT' | 'DARK';
 };
 
+/**
+ * Visual theme consumed by nested code-block renderers.
+ *
+ * @private utility of `MarkdownContent` component
+ */
+type MarkdownContentTheme = NonNullable<MarkdownContentProps['theme']>;
+
+/**
+ * Resolves the active document theme when a host application does not pass an explicit theme.
+ *
+ * @private utility of `MarkdownContent` component
+ */
+function resolveMarkdownContentTheme(explicitTheme?: MarkdownContentTheme): MarkdownContentTheme {
+    if (explicitTheme) {
+        return explicitTheme;
+    }
+
+    if (typeof document !== 'undefined') {
+        const resolvedTheme = document.documentElement.dataset.themeResolved;
+
+        if (resolvedTheme === 'dark' || document.documentElement.classList.contains('dark')) {
+            return 'DARK';
+        }
+    }
+
+    return 'LIGHT';
+}
+
 /**
  * Returns a stable key for a `<details>` element based on its `<summary>` text.
  * Used to identify and restore open state across re-renders.
@@ -85,7 +114,7 @@ function resolveClickedDetailsElement(target: EventTarget | null, container: HTM
  * @public exported from `@promptbook/components`
  */
 export const MarkdownContent = memo(function MarkdownContent(props: MarkdownContentProps) {
-    const { content, className, onCreateAgent } = props;
+    const { content, className, onCreateAgent, theme } = props;
     const htmlContent = useMemo(
         () =>
             renderMarkdown(content, {
@@ -93,6 +122,7 @@ export const MarkdownContent = memo(function MarkdownContent(props: MarkdownCont
             }),
         [content],
     );
+    const [resolvedTheme, setResolvedTheme] = useState<MarkdownContentTheme>(() => resolveMarkdownContentTheme(theme));
     const containerRef = useRef<HTMLDivElement>(null);
     const rootsRef = useRef<Root[]>([]);
     /** Tracks which `<details>` elements (by summary key) are currently open */
@@ -100,6 +130,28 @@ export const MarkdownContent = memo(function MarkdownContent(props: MarkdownCont
     const onCreateAgentRef = useRef(onCreateAgent);
     onCreateAgentRef.current = onCreateAgent;
 
+    useEffect(() => {
+        if (theme) {
+            setResolvedTheme(theme);
+            return;
+        }
+
+        const updateTheme = () => setResolvedTheme(resolveMarkdownContentTheme());
+        updateTheme();
+
+        if (typeof document === 'undefined' || typeof MutationObserver === 'undefined') {
+            return;
+        }
+
+        const observer = new MutationObserver(updateTheme);
+        observer.observe(document.documentElement, {
+            attributes: true,
+            attributeFilter: ['class', 'data-theme-resolved'],
+        });
+
+        return () => observer.disconnect();
+    }, [theme]);
+
     useEffect(() => {
         // Cleanup previous roots
         rootsRef.current.forEach((root) => root.unmount());
@@ -191,7 +243,14 @@ export const MarkdownContent = memo(function MarkdownContent(props: MarkdownCont
 
             // Render CodeBlock
             const root = createRoot(mountPoint);
-            root.render(<CodeBlock code={code} language={language} onCreateAgent={onCreateAgentRef.current} />);
+            root.render(
+                <CodeBlock
+                    code={code}
+                    language={language}
+                    onCreateAgent={onCreateAgentRef.current}
+                    theme={resolvedTheme}
+                />,
+            );
             rootsRef.current.push(root);
         });
 
@@ -203,7 +262,7 @@ export const MarkdownContent = memo(function MarkdownContent(props: MarkdownCont
             rootsRef.current.forEach((root) => root.unmount());
             rootsRef.current = [];
         };
-    }, [htmlContent]);
+    }, [htmlContent, resolvedTheme]);
 
     return (
         <div