@promptbook/cli 0.112.0-104 → 0.112.0-106

package/esm/scripts/run-agent-messages/main/AgentMessageFailureTracker.d.ts

@@ -0,0 +1,27 @@
+import type { AgentMessageFile } from '../messages/AgentMessageFile';
+/**
+ * Result of recording one failed queued-message attempt.
+ */
+export type AgentMessageFailureTrackingResult = {
+    readonly failureCount: number;
+    readonly maxMessageProcessingFailures: number;
+    readonly isMessageMovedToFailed: boolean;
+};
+/**
+ * Tracks repeated watch-level failures for queued message files and stops retrying them after a configured cap.
+ */
+export declare class AgentMessageFailureTracker {
+    private readonly failuresByMessageKey;
+    private readonly maxMessageProcessingFailures;
+    constructor(options?: {
+        readonly maxMessageProcessingFailures?: number;
+    });
+    /**
+     * Clears the failure counter after a queued message is processed successfully.
+     */
+    clearMessageFailure(projectPath: string, messageFile: AgentMessageFile | undefined): void;
+    /**
+     * Records one queued-message failure and moves the message into `messages/failed` when the retry cap is reached.
+     */
+    recordFailure(error: unknown): Promise<AgentMessageFailureTrackingResult | null>;
+}

package/esm/scripts/run-agent-messages/main/handleAgentWatchError.d.ts

@@ -19,3 +19,7 @@ export declare function handleAgentWatchError(options: {
     readonly logDirectoryPath: string;
     readonly error: unknown;
 }): Promise<void>;
+/**
+ * Recovers previously attached watch-loop context from an error-like value.
+ */
+export declare function getAgentWatchErrorContext(error: unknown): AgentWatchErrorContext | undefined;

package/esm/scripts/run-agent-messages/main/runAgentMessages.d.ts

@@ -4,4 +4,5 @@ import type { AgentRunOptions } from '../AgentRunOptions';
  */
 export declare function runAgentMessages(options: AgentRunOptions, controls?: {
     readonly shouldContinue?: () => boolean;
+    readonly queuePollIntervalMs?: number;
 }): Promise<void>;

package/esm/scripts/run-agent-messages/messages/moveAgentMessageToFailed.d.ts

@@ -0,0 +1,17 @@
+import type { AgentMessageFile } from './AgentMessageFile';
+/**
+ * Result of moving one abandoned queued message into the failed queue.
+ */
+export type FailedAgentMessageFile = {
+    readonly absolutePath: string;
+    readonly relativePath: string;
+    readonly fileName: string;
+};
+/**
+ * Moves one repeatedly failing queued message to `messages/failed` with a visible agent failure reply.
+ */
+export declare function moveAgentMessageToFailed(options: {
+    readonly projectPath: string;
+    readonly messageFile: AgentMessageFile;
+    readonly failureReason: string;
+}): Promise<FailedAgentMessageFile>;

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-105`).
  *
  * @generated
  */

package/package.json

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

package/src/avatars/visuals/octopus3d3AvatarVisual.ts

@@ -153,11 +153,7 @@ export const octopus3d3AvatarVisual: AvatarVisualDefinition = {
         });
         const eyeLatitude = clampNumber(morphologyProfile.face.eyeCenterYOffsetRatio * 4.2 - 0.03, -0.22, 0.08);
         const eyeLongitude = clampNumber(morphologyProfile.face.eyeSpacingRatio * 3.1, 0.18, 0.32);
-        const mouthLatitude = clampNumber(
-            eyeLatitude + 0.2 + morphologyProfile.face.mouthYOffsetRatio,
-            0.08,
-            0.34,
-        );
+        const mouthLatitude = clampNumber(eyeLatitude + 0.2 + morphologyProfile.face.mouthYOffsetRatio, 0.08, 0.34);
         const mouthCenterLongitude = clampNumber(morphologyProfile.face.mouthCenterOffsetRatio * 5.6, -0.08, 0.08);
         const mouthHalfLongitude = clampNumber(eyeLongitude * 0.78, 0.15, 0.28);
         const mouthCurveLatitude = clampNumber(
@@ -377,15 +373,17 @@ function drawContinuousOctopusShadow(
  *
  * @private helper of `octopus3d3AvatarVisual`
  */
-function resolveVisibleContinuousOctopusPatches(options: ContinuousOctopusSurfaceOptions & {
-    readonly center: Point3D;
-    readonly rotationX: number;
-    readonly rotationY: number;
-    readonly sceneCenterX: number;
-    readonly sceneCenterY: number;
-    readonly size: number;
-    readonly palette: AvatarPalette;
-}): Array<ContinuousOctopusSurfacePatch> {
+function resolveVisibleContinuousOctopusPatches(
+    options: ContinuousOctopusSurfaceOptions & {
+        readonly center: Point3D;
+        readonly rotationX: number;
+        readonly rotationY: number;
+        readonly sceneCenterX: number;
+        readonly sceneCenterY: number;
+        readonly size: number;
+        readonly palette: AvatarPalette;
+    },
+): Array<ContinuousOctopusSurfacePatch> {
     const { center, rotationX, rotationY, sceneCenterX, sceneCenterY, size, palette } = options;
     const latitudePatchCount = 16;
     const longitudePatchCount = 40;
@@ -469,8 +467,7 @@ function sampleContinuousOctopusSurfacePoint(
     const tipBlend = smoothStep(0.68, 1, verticalProgress);
     const tentacleInfluence = resolveContinuousTentacleInfluence(options, longitude);
     const centerPull = resolveSignedAngularDistance(longitude, tentacleInfluence.centerLongitude);
-    const effectiveLongitude =
-        longitude + centerPull * lowerBlend * tentacleInfluence.core * (0.24 + tipBlend * 0.2);
+    const effectiveLongitude = longitude + centerPull * lowerBlend * tentacleInfluence.core * (0.24 + tipBlend * 0.2);
     const lowerLobeWave = resolveContinuousLobeWave(options, longitude);
     const mantleRipple =
         Math.sin(
@@ -498,10 +495,7 @@ function sampleContinuousOctopusSurfacePoint(
         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;
+        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 =
@@ -514,9 +508,7 @@ function sampleContinuousOctopusSurfacePoint(
                     (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 +
@@ -603,9 +595,14 @@ function resolveContinuousLobeWave(options: ContinuousOctopusSurfaceOptions, lon
     const { morphologyProfile, animationPhase, timeMs } = options;
 
     return (
-        Math.cos(longitude * OCTOPUS_TENTACLE_COUNT + animationPhase + timeMs / (980 + morphologyProfile.body.lobeCount * 18)) +
-        1
-    ) / 2;
+        (Math.cos(
+            longitude * OCTOPUS_TENTACLE_COUNT +
+                animationPhase +
+                timeMs / (980 + morphologyProfile.body.lobeCount * 18),
+        ) +
+            1) /
+        2
+    );
 }
 
 /**
@@ -722,8 +719,7 @@ function drawProjectedSurfaceCurrents(options: {
             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;
+                baseLongitude + Math.sin(timeMs / 1160 + animationPhase + currentIndex * 0.7 + progress * 2) * 0.035;
             const scenePoint = transformScenePoint(
                 sampleContinuousOctopusSurfacePoint(surfaceOptions, latitude, longitude),
                 center,
@@ -858,7 +854,10 @@ function drawProjectedSurfaceSpot(options: {
         size * 0.018,
     );
     const verticalRadius = clampNumber(
-        Math.hypot(projectedVerticalPoint.x - projectedCenterPoint.x, projectedVerticalPoint.y - projectedCenterPoint.y) *
+        Math.hypot(
+            projectedVerticalPoint.x - projectedCenterPoint.x,
+            projectedVerticalPoint.y - projectedCenterPoint.y,
+        ) *
             radiusScale *
             0.52,
         size * 0.0024,

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

@@ -17,6 +17,8 @@ import type { HoistedMenuItem } from '../_common/MenuHoisting/MenuHoistingContex
 import { classNames } from '../_common/react-utils/classNames';
 import styles from './BookEditor.module.css';
 import { BookEditorMonaco } from './BookEditorMonaco';
+import type { BookEditorTheme } from './BookEditorTheme';
+import { BOOK_EDITOR_RENDER_THEME, resolveBookEditorRenderTheme } from './BookEditorTheme';
 
 /**
  * Monaco diagnostic shown inside `BookEditor`.
@@ -123,14 +125,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
@@ -288,7 +290,7 @@ export function BookEditor(props: BookEditorProps) {
         agentSource,
         className,
         style,
-        theme = 'LIGHT',
+        theme: hostTheme = BOOK_EDITOR_RENDER_THEME,
         zoom = 1,
         value,
         onChange,
@@ -309,6 +311,7 @@ export function BookEditor(props: BookEditorProps) {
     } = props;
 
     const [isFullscreen, setIsFullscreen] = useState(false);
+    const renderedTheme = resolveBookEditorRenderTheme(hostTheme);
 
     /**
      * Toggles fullscreen mode for the editor.
@@ -320,7 +323,7 @@ export function BookEditor(props: BookEditorProps) {
     const editorContent = (
         <div
             data-book-component="BookEditor"
-            data-book-editor-theme={theme.toLowerCase()}
+            data-book-editor-theme={renderedTheme.toLowerCase()}
             className={classNames(
                 styles.BookEditor,
                 isVerbose && styles.isVerbose,
@@ -365,7 +368,7 @@ export function BookEditor(props: BookEditorProps) {
                 zoom={zoom}
                 monacoModelPath={monacoModelPath}
                 hoistedMenuItems={hoistedMenuItems}
-                theme={theme}
+                theme={renderedTheme}
             />
         </div>
     );

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

@@ -12,6 +12,7 @@ import type { BookEditorProps } from './BookEditor';
 import styles from './BookEditor.module.css';
 import { BookEditorActionbar } from './BookEditorActionbar';
 import { BookEditorMonacoConstants } from './BookEditorMonacoConstants';
+import { BOOK_EDITOR_RENDER_THEME, resolveBookEditorRenderTheme } from './BookEditorTheme';
 import { createDeprecatedCommitmentDiagnostics } from './createDeprecatedCommitmentDiagnostics';
 import { useBookEditorMonacoDecorations } from './useBookEditorMonacoDecorations';
 import { useBookEditorMonacoDiagnostics } from './useBookEditorMonacoDiagnostics';
@@ -204,7 +205,7 @@ export function BookEditorMonaco(props: BookEditorProps) {
         onChange,
         diagnostics,
         isReadonly,
-        theme = 'LIGHT',
+        theme: hostTheme = BOOK_EDITOR_RENDER_THEME,
         translations,
         onFileUpload,
         isUploadButtonShown,
@@ -219,6 +220,7 @@ export function BookEditorMonaco(props: BookEditorProps) {
         hoistedMenuItems,
     } = props;
 
+    const theme = resolveBookEditorRenderTheme(hostTheme);
     const zoomLevel = zoom;
     const { scaledLineHeight, scaledContentPaddingLeft, scaledVerticalLineLeft, scaledFontSize, scaledScrollbarSize } =
         createBookEditorMonacoScale(zoomLevel);

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

@@ -0,0 +1,32 @@
+/**
+ * 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 const BOOK_EDITOR_RENDER_THEME = 'LIGHT' satisfies BookEditorTheme;
+
+/**
+ * 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 function resolveBookEditorRenderTheme(hostTheme: BookEditorTheme = BOOK_EDITOR_RENDER_THEME): BookEditorTheme {
+    if (hostTheme === 'DARK') {
+        return BOOK_EDITOR_RENDER_THEME;
+    }
+
+    return hostTheme;
+}

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

@@ -8,19 +8,14 @@ import {
 import { PROMPTBOOK_SYNTAX_COLORS } from '../../config';
 import { BookEditorMonacoConstants } from './BookEditorMonacoConstants';
 import { BookEditorMonacoTokenization } from './BookEditorMonacoTokenization';
+import type { BookEditorTheme } from './BookEditorTheme';
+import { BOOK_EDITOR_RENDER_THEME, resolveBookEditorRenderTheme } 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.
  */
@@ -286,12 +281,16 @@ function createNoteLikeBodyRules(
  *
  * @private function of BookEditorMonaco
  */
-export function ensureBookEditorMonacoLanguage(monaco: MonacoEditor, theme: BookEditorTheme = 'LIGHT'): void {
+export function ensureBookEditorMonacoLanguage(
+    monaco: MonacoEditor,
+    theme: BookEditorTheme = BOOK_EDITOR_RENDER_THEME,
+): void {
+    const renderedTheme = resolveBookEditorRenderTheme(theme);
     const monacoWithLanguageState = monaco as MonacoEditorWithBookEditorLanguageState;
     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;
         }
 
@@ -300,7 +299,7 @@ export function ensureBookEditorMonacoLanguage(monaco: MonacoEditor, theme: Book
     }
 
     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 });
 
@@ -437,7 +436,7 @@ export function ensureBookEditorMonacoLanguage(monaco: MonacoEditor, theme: Book
         },
     });
 
-    applyBookEditorMonacoTheme(monaco, theme);
+    applyBookEditorMonacoTheme(monaco, renderedTheme);
 }
 
 /**
@@ -462,8 +461,9 @@ type EnsureBookEditorMonacoLanguageForEditorProps = {
  * @private function of BookEditorMonaco
  */
 export function ensureBookEditorMonacoLanguageForEditor(props: EnsureBookEditorMonacoLanguageForEditorProps): void {
-    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) {

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

@@ -1,5 +1,6 @@
 import type { editor } from 'monaco-editor';
 import { useCallback, useEffect, useState } from 'react';
+import type { BookEditorTheme } from './BookEditorTheme';
 import { ensureBookEditorMonacoLanguage, ensureBookEditorMonacoLanguageForEditor } from './useBookEditorMonacoLanguage';
 
 /**
@@ -7,11 +8,6 @@ import { ensureBookEditorMonacoLanguage, ensureBookEditorMonacoLanguageForEditor
  */
 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/src/book-components/BookEditor/useBookEditorMonacoStyles.ts

@@ -1,5 +1,6 @@
 import { useEffect } from 'react';
 import { PROMPTBOOK_SYNTAX_COLORS } from '../../config';
+import type { BookEditorTheme } from './BookEditorTheme';
 
 /**
  * Relative Y offset multiplier for aligning line background with Monaco rendering.
@@ -17,7 +18,7 @@ type UseBookEditorMonacoStylesProps = {
     readonly scaledContentPaddingLeft: number;
     readonly scaledVerticalLineLeft: number;
     readonly zoomLevel: number;
-    readonly theme: 'LIGHT' | 'DARK';
+    readonly theme: BookEditorTheme;
 };
 
 /**

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

@@ -36,6 +36,13 @@ export const AGENT_QUEUED_MESSAGES_DIRECTORY_PATH = join(AGENT_MESSAGES_DIRECTOR
  */
 export const AGENT_FINISHED_MESSAGES_DIRECTORY_PATH = join(AGENT_MESSAGES_DIRECTORY_PATH, 'finished');
 
+/**
+ * Relative path to messages that the agent runner stopped retrying.
+ *
+ * @private internal utility of `ptbk agent-folder`
+ */
+export const AGENT_FAILED_MESSAGES_DIRECTORY_PATH = join(AGENT_MESSAGES_DIRECTORY_PATH, 'failed');
+
 /**
  * Relative path to generated local agent documentation initialized by `ptbk agent-folder init`.
  *