@promptbook/cli 0.112.0-104 → 0.112.0-106

package/umd/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/umd/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/umd/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/umd/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/umd/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/umd/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/umd/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/umd/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/umd/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/umd/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/umd/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/apps/agents-server/src/message-providers/email/_common/utils/parseEmailAddress.test.ts.todo

@@ -1,108 +0,0 @@
-import { describe, expect, it } from '@jest/globals';
-import { parseEmailAddress } from './parseEmailAddress';
-
-describe('how parseEmailAddress works', () => {
-    it('should work with simple email', () => {
-        expect(parseEmailAddress('pavol@webgpt.cz')).toEqual({
-            fullName: null,
-            baseEmail: 'pavol@webgpt.cz',
-            fullEmail: 'pavol@webgpt.cz',
-            plus: [],
-        });
-        expect(parseEmailAddress('jirka@webgpt.cz')).toEqual({
-            fullName: null,
-            baseEmail: 'jirka@webgpt.cz',
-            fullEmail: 'jirka@webgpt.cz',
-            plus: [],
-        });
-        expect(parseEmailAddress('tomas@webgpt.cz')).toEqual({
-            fullName: null,
-            baseEmail: 'tomas@webgpt.cz',
-            fullEmail: 'tomas@webgpt.cz',
-            plus: [],
-        });
-    });
-
-    it('should work with fullname', () => {
-        expect(parseEmailAddress('Pavol Hejný <pavol@webgpt.cz>')).toEqual({
-            fullName: 'Pavol Hejný',
-            baseEmail: 'pavol@webgpt.cz',
-            fullEmail: 'pavol@webgpt.cz',
-            plus: [],
-        });
-        expect(parseEmailAddress('Jirka <jirka@webgpt.cz>')).toEqual({
-            fullName: 'Jirka',
-            baseEmail: 'jirka@webgpt.cz',
-            fullEmail: 'jirka@webgpt.cz',
-            plus: [],
-        });
-        expect(parseEmailAddress('"Tomáš Studeník" <tomas@webgpt.cz>')).toEqual({
-            fullName: 'Tomáš Studeník',
-            baseEmail: 'tomas@webgpt.cz',
-            fullEmail: 'tomas@webgpt.cz',
-            plus: [],
-        });
-    });
-
-    it('should work with plus', () => {
-        expect(parseEmailAddress('pavol+test@webgpt.cz')).toEqual({
-            fullName: null,
-            baseEmail: 'pavol@webgpt.cz',
-            fullEmail: 'pavol+test@webgpt.cz',
-            plus: ['test'],
-        });
-        expect(parseEmailAddress('jirka+test@webgpt.cz')).toEqual({
-            fullName: null,
-            baseEmail: 'jirka@webgpt.cz',
-            fullEmail: 'jirka+test@webgpt.cz',
-            plus: ['test'],
-        });
-        expect(parseEmailAddress('tomas+test+ainautes@webgpt.cz')).toEqual({
-            fullName: null,
-            baseEmail: 'tomas@webgpt.cz',
-            fullEmail: 'tomas+test+ainautes@webgpt.cz',
-            plus: ['test', 'ainautes'],
-        });
-    });
-
-    it('should work with both fullname and plus', () => {
-        expect(parseEmailAddress('Pavol Hejný <pavol+foo@webgpt.cz>')).toEqual({
-            fullName: 'Pavol Hejný',
-            baseEmail: 'pavol@webgpt.cz',
-            fullEmail: 'pavol+foo@webgpt.cz',
-            plus: ['foo'],
-        });
-        expect(parseEmailAddress('Jirka <jirka+test@webgpt.cz>')).toEqual({
-            fullName: 'Jirka',
-            baseEmail: 'jirka@webgpt.cz',
-            fullEmail: 'jirka+test@webgpt.cz',
-            plus: ['test'],
-        });
-        expect(parseEmailAddress('"Tomáš Studeník" <tomas+test+ainautes@webgpt.cz>')).toEqual({
-            fullName: 'Tomáš Studeník',
-            baseEmail: 'tomas@webgpt.cz',
-            fullEmail: 'tomas+test+ainautes@webgpt.cz',
-            plus: ['test', 'ainautes'],
-        });
-    });
-
-    it('throws on multiple adresses', () => {
-        expect(() => parseEmailAddress('Pavol <pavol@webgpt.cz>, Jirka <jirka@webgpt.cz>')).toThrowError(
-            /Seems like you are trying to parse multiple email addresses/,
-        );
-    });
-
-    it('throws on invalid email adresses', () => {
-        expect(() => parseEmailAddress('')).toThrowError(/Invalid email address/);
-        expect(() => parseEmailAddress('Pavol Hejný')).toThrowError(/Invalid email address/);
-        expect(() => parseEmailAddress('Pavol Hejný <>')).toThrowError(/Invalid email address/);
-        expect(() => parseEmailAddress('Pavol Hejný <@webgpt.cz>')).toThrowError(/Invalid email address/);
-        expect(() => parseEmailAddress('Pavol Hejný <webgpt.cz>')).toThrowError(/Invalid email address/);
-        expect(() => parseEmailAddress('Pavol Hejný <pavol@>')).toThrowError(/Invalid email address/);
-        expect(() => parseEmailAddress('Pavol Hejný <a@b>')).toThrowError(/Invalid email address/);
-    });
-});
-
-/**
- * TODO: [🐫] This test fails because of aliased imports `import type { string_emails } from '@promptbook-local/types';`, fix it
- */

package/apps/agents-server/src/message-providers/email/_common/utils/parseEmailAddresses.test.ts.todo

@@ -1,117 +0,0 @@
-import { describe, expect, it } from '@jest/globals';
-import { parseEmailAddresses } from './parseEmailAddresses';
-
-describe('how parseEmailAddresses works', () => {
-    it('should work with single email', () => {
-        expect(parseEmailAddresses('pavol@webgpt.cz')).toEqual([
-            {
-                fullName: null,
-                baseEmail: 'pavol@webgpt.cz',
-                fullEmail: 'pavol@webgpt.cz',
-                plus: [],
-            },
-        ]);
-    });
-
-    it('should work with simple emails', () => {
-        expect(parseEmailAddresses('pavol@webgpt.cz, jirka@webgpt.cz, tomas@webgpt.cz')).toEqual([
-            {
-                fullName: null,
-                baseEmail: 'pavol@webgpt.cz',
-                fullEmail: 'pavol@webgpt.cz',
-                plus: [],
-            },
-            {
-                fullName: null,
-                baseEmail: 'jirka@webgpt.cz',
-                fullEmail: 'jirka@webgpt.cz',
-                plus: [],
-            },
-            {
-                fullName: null,
-                baseEmail: 'tomas@webgpt.cz',
-                fullEmail: 'tomas@webgpt.cz',
-                plus: [],
-            },
-        ]);
-    });
-
-    it('should work with fullname', () => {
-        expect(
-            parseEmailAddresses(
-                'Pavol Hejný <pavol@webgpt.cz>, Jirka <jirka@webgpt.cz>, "Tomáš Studeník" <tomas@webgpt.cz>',
-            ),
-        ).toEqual([
-            {
-                fullName: 'Pavol Hejný',
-                baseEmail: 'pavol@webgpt.cz',
-                fullEmail: 'pavol@webgpt.cz',
-                plus: [],
-            },
-            {
-                fullName: 'Jirka',
-                baseEmail: 'jirka@webgpt.cz',
-                fullEmail: 'jirka@webgpt.cz',
-                plus: [],
-            },
-            {
-                fullName: 'Tomáš Studeník',
-                baseEmail: 'tomas@webgpt.cz',
-                fullEmail: 'tomas@webgpt.cz',
-                plus: [],
-            },
-        ]);
-    });
-
-    it('not confused by comma', () => {
-        expect(parseEmailAddresses(', pavol@webgpt.cz, ')).toEqual([
-            {
-                fullName: null,
-                fullEmail: 'pavol@webgpt.cz',
-                baseEmail: 'pavol@webgpt.cz',
-                plus: [],
-            },
-        ]);
-    });
-
-    it('works on real-life example', () => {
-        expect(
-            parseEmailAddresses(
-                '"bob" <bob@bot.webgpt.cz>, "pavolto" <pavol+to@ptbk.io>, "Pavol" <pavol@collboard.com>',
-            ),
-        ).toEqual([
-            {
-                fullName: 'bob',
-                fullEmail: 'bob@bot.webgpt.cz',
-                baseEmail: 'bob@bot.webgpt.cz',
-                plus: [],
-            },
-            {
-                fullName: 'pavolto',
-                fullEmail: 'pavol+to@ptbk.io',
-                baseEmail: 'pavol@ptbk.io',
-                plus: ['to'],
-            },
-            {
-                fullName: 'Pavol',
-                fullEmail: 'pavol@collboard.com',
-                baseEmail: 'pavol@collboard.com',
-                plus: [],
-            },
-        ]);
-    });
-
-    it('throws on invalid email adresses', () => {
-        expect(() => parseEmailAddresses('Pavol, Hejný')).toThrowError(/Invalid email address/);
-        expect(() => parseEmailAddresses('Pavol Hejný <>')).toThrowError(/Invalid email address/);
-        expect(() => parseEmailAddresses('Pavol Hejný, <@webgpt.cz>')).toThrowError(/Invalid email address/);
-        expect(() => parseEmailAddresses('Pavol Hejný <webgpt.cz>')).toThrowError(/Invalid email address/);
-        expect(() => parseEmailAddresses('Pavol Hejný <pavol@>')).toThrowError(/Invalid email address/);
-        expect(() => parseEmailAddresses('Pavol Hejný <a@b>,')).toThrowError(/Invalid email address/);
-    });
-});
-
-
-/**
- * TODO: [🐫] This test fails because of aliased imports `import type { string_emails } from '@promptbook-local/types';`, fix it
- */

package/apps/agents-server/src/message-providers/email/_common/utils/stringifyEmailAddress.test.ts.todo

@@ -1,119 +0,0 @@
-import { describe, expect, it } from '@jest/globals';
-import { stringifyEmailAddress } from './stringifyEmailAddress';
-
-describe('how stringifyEmailAddress works', () => {
-    it('should work with simple email', () => {
-        expect(
-            stringifyEmailAddress({
-                fullName: null,
-                baseEmail: 'pavol@webgpt.cz',
-                fullEmail: 'pavol@webgpt.cz',
-                plus: [],
-            }),
-        ).toBe('pavol@webgpt.cz');
-        expect(
-            stringifyEmailAddress({
-                fullName: null,
-                baseEmail: 'jirka@webgpt.cz',
-                fullEmail: 'jirka@webgpt.cz',
-                plus: [],
-            }),
-        ).toBe('jirka@webgpt.cz');
-        expect(
-            stringifyEmailAddress({
-                fullName: null,
-                baseEmail: 'tomas@webgpt.cz',
-                fullEmail: 'tomas@webgpt.cz',
-                plus: [],
-            }),
-        ).toBe('tomas@webgpt.cz');
-    });
-
-    it('should work with fullname', () => {
-        expect(
-            stringifyEmailAddress({
-                fullName: 'Pavol Hejný',
-                baseEmail: 'pavol@webgpt.cz',
-                fullEmail: 'pavol@webgpt.cz',
-                plus: [],
-            }),
-        ).toBe('"Pavol Hejný" <pavol@webgpt.cz>');
-        expect(
-            stringifyEmailAddress({
-                fullName: 'Jirka',
-                baseEmail: 'jirka@webgpt.cz',
-                fullEmail: 'jirka@webgpt.cz',
-                plus: [],
-            }),
-        ).toBe('"Jirka" <jirka@webgpt.cz>');
-        expect(
-            stringifyEmailAddress({
-                fullName: 'Tomáš Studeník',
-                baseEmail: 'tomas@webgpt.cz',
-                fullEmail: 'tomas@webgpt.cz',
-                plus: [],
-            }),
-        ).toBe('"Tomáš Studeník" <tomas@webgpt.cz>');
-    });
-
-    it('should work with plus', () => {
-        expect(
-            stringifyEmailAddress({
-                fullName: null,
-                baseEmail: 'pavol@webgpt.cz',
-                fullEmail: 'pavol+test@webgpt.cz',
-                plus: ['test'],
-            }),
-        ).toBe('pavol+test@webgpt.cz');
-        expect(
-            stringifyEmailAddress({
-                fullName: null,
-                baseEmail: 'jirka@webgpt.cz',
-                fullEmail: 'jirka+test@webgpt.cz',
-                plus: ['test'],
-            }),
-        ).toBe('jirka+test@webgpt.cz');
-        expect(
-            stringifyEmailAddress({
-                fullName: null,
-                baseEmail: 'tomas@webgpt.cz',
-                fullEmail: 'tomas+test+ainautes@webgpt.cz',
-                plus: ['test', 'ainautes'],
-            }),
-        ).toBe('tomas+test+ainautes@webgpt.cz');
-    });
-
-    it('should work with both fullname and plus', () => {
-        expect(
-            stringifyEmailAddress({
-                fullName: 'Pavol Hejný',
-                baseEmail: 'pavol@webgpt.cz',
-                fullEmail: 'pavol+test@webgpt.cz',
-                plus: ['test'],
-            }),
-        ).toBe('"Pavol Hejný" <pavol+test@webgpt.cz>');
-        expect(
-            stringifyEmailAddress({
-                fullName: 'Jirka',
-                baseEmail: 'jirka@webgpt.cz',
-                fullEmail: 'jirka+test@webgpt.cz',
-                plus: ['test'],
-            }),
-        ).toBe('"Jirka" <jirka+test@webgpt.cz>');
-        expect(
-            stringifyEmailAddress({
-                fullName: 'Tomáš Studeník',
-                baseEmail: 'tomas@webgpt.cz',
-                fullEmail: 'tomas+test+ainautes@webgpt.cz',
-                plus: ['test', 'ainautes'],
-            }),
-        ).toBe('"Tomáš Studeník" <tomas+test+ainautes@webgpt.cz>');
-    });
-
-    // TODO: [🎾] Implement and test here escaping
-});
-
-
-/**
- * TODO: [🐫] This test fails because of aliased imports `import type { string_emails } from '@promptbook-local/types';`, fix it
- */

package/apps/agents-server/src/message-providers/email/_common/utils/stringifyEmailAddresses.test.ts.todo

@@ -1,74 +0,0 @@
-import { describe, expect, it } from '@jest/globals';
-import { stringifyEmailAddresses } from './stringifyEmailAddresses';
-
-describe('how stringifyEmailAddresses works', () => {
-    it('should work with single email', () => {
-        expect(
-            stringifyEmailAddresses([
-                {
-                    fullName: null,
-                    baseEmail: 'pavol@webgpt.cz',
-                    fullEmail: 'pavol@webgpt.cz',
-                    plus: [],
-                },
-            ]),
-        ).toEqual('pavol@webgpt.cz');
-    });
-
-    it('should work with simple emails', () => {
-        expect(
-            stringifyEmailAddresses([
-                {
-                    fullName: null,
-                    baseEmail: 'pavol@webgpt.cz',
-                    fullEmail: 'pavol@webgpt.cz',
-                    plus: [],
-                },
-                {
-                    fullName: null,
-                    baseEmail: 'jirka@webgpt.cz',
-                    fullEmail: 'jirka@webgpt.cz',
-                    plus: [],
-                },
-                {
-                    fullName: null,
-                    baseEmail: 'tomas@webgpt.cz',
-                    fullEmail: 'tomas@webgpt.cz',
-                    plus: [],
-                },
-            ]),
-        ).toEqual('pavol@webgpt.cz, jirka@webgpt.cz, tomas@webgpt.cz');
-    });
-
-    it('should work with fullname', () => {
-        expect(
-            stringifyEmailAddresses([
-                {
-                    fullName: 'Pavol Hejný',
-                    baseEmail: 'pavol@webgpt.cz',
-                    fullEmail: 'pavol@webgpt.cz',
-                    plus: [],
-                },
-                {
-                    fullName: 'Jiří Jahn',
-                    baseEmail: 'jirka@webgpt.cz',
-                    fullEmail: 'jirka@webgpt.cz',
-                    plus: [],
-                },
-                {
-                    fullName: 'Tomáš Studeník',
-                    baseEmail: 'tomas@webgpt.cz',
-                    fullEmail: 'tomas@webgpt.cz',
-                    plus: [],
-                },
-            ]),
-        ).toEqual('"Pavol Hejný" <pavol@webgpt.cz>, "Jiří Jahn" <jirka@webgpt.cz>, "Tomáš Studeník" <tomas@webgpt.cz>');
-    });
-
-    // TODO: [🎾] Implement and test here escaping
-});
-
-
-/**
- * TODO: [🐫] This test fails because of aliased imports `import type { string_emails } from '@promptbook-local/types';`, fix it
- */