@promptbook/cli 0.112.0-115 → 0.112.0-118

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

@@ -1,11 +1,6 @@
 import type { editor, Position } from 'monaco-editor';
 import { useEffect } from 'react';
-import { getAllCommitmentDefinitions } from '../../commitments/_common/getAllCommitmentDefinitions';
-import {
-    formatCommitmentReplacementText,
-    getCommitmentNoticeMetadata,
-} from '../../commitments/_common/getCommitmentNoticeMetadata';
-import { PROMPTBOOK_SYNTAX_COLORS } from '../../config';
+import { PROMPTBOOK_SYNTAX_COLORS } from './BookEditorBrowserConfig';
 import { BookEditorMonacoConstants } from './BookEditorMonacoConstants';
 import { BookEditorMonacoTokenization } from './BookEditorMonacoTokenization';
 import type { BookEditorTheme } from './BookEditorTheme';
@@ -303,23 +298,26 @@ export function ensureBookEditorMonacoLanguage(
 
     monaco.languages.register({ id: BookEditorMonacoConstants.BOOK_LANGUAGE_ID });
 
-    const commitmentDefinitions = getAllCommitmentDefinitions();
-    const commitmentTypes = [...new Set(commitmentDefinitions.map(({ type }) => type))];
-    const commitmentDefinitionByType = new Map(
-        commitmentDefinitions.map((definition) => [definition.type, definition]),
-    );
-    const completionCommitmentTypes = [...commitmentTypes].sort((leftType, rightType) => {
-        const leftDefinition = commitmentDefinitionByType.get(leftType);
-        const rightDefinition = commitmentDefinitionByType.get(rightType);
-        const leftRank = leftDefinition?.isUnfinished ? 1 : 0;
-        const rightRank = rightDefinition?.isUnfinished ? 1 : 0;
-
-        if (leftRank !== rightRank) {
-            return leftRank - rightRank;
-        }
-
-        return commitmentTypes.indexOf(leftType) - commitmentTypes.indexOf(rightType);
-    });
+    const commitmentTypes = [
+        'GOAL',
+        'RULE',
+        'PERSONA',
+        'KNOWLEDGE',
+        'TASK',
+        'PROMPT',
+        'EXPECT',
+        'FORMAT',
+        'MODEL',
+        'SAMPLE',
+        'FROM',
+        'IMPORT',
+        'IMPORTS',
+        'TEAM',
+        ...TODO_COMMITMENT_TYPES,
+        ...NOTE_COMMITMENT_TYPES,
+        'REMOVE',
+    ];
+    const completionCommitmentTypes = [...commitmentTypes];
     const noteLikeCommitmentTypeSet = new Set<string>([...TODO_COMMITMENT_TYPES, ...NOTE_COMMITMENT_TYPES]);
     const noteLikeCommitmentStates = createNoteLikeCommitmentStates(commitmentTypes);
     const executableCommitmentTypes = commitmentTypes.filter(
@@ -390,29 +388,17 @@ export function ensureBookEditorMonacoLanguage(
                 endColumn: word.endColumn,
             };
 
-            const suggestions = completionCommitmentTypes.map((type, index) => {
-                const definition = commitmentDefinitionByType.get(type);
-                const notice = definition ? getCommitmentNoticeMetadata(definition) : null;
-                const completionDocumentation = notice
-                    ? `${notice.detailLabel}. ${notice.message}${
-                          notice.kind === 'deprecated'
-                              ? formatCommitmentReplacementText(definition?.deprecation?.replacedBy)
-                              : ''
-                      }`
-                    : definition?.description || 'Commitment';
-
-                return {
-                    label: type,
-                    kind: monaco.languages.CompletionItemKind.Keyword,
-                    insertText: type,
-                    range,
-                    sortText: index.toString().padStart(4, '0'),
-                    detail: notice?.detailLabel || 'Commitment',
-                    documentation: {
-                        value: completionDocumentation,
-                    },
-                };
-            });
+            const suggestions = completionCommitmentTypes.map((type, index) => ({
+                label: type,
+                kind: monaco.languages.CompletionItemKind.Keyword,
+                insertText: type,
+                range,
+                sortText: index.toString().padStart(4, '0'),
+                detail: 'Commitment',
+                documentation: {
+                    value: 'Book commitment',
+                },
+            }));
 
             return { suggestions };
         },

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

@@ -1,5 +1,5 @@
 import { useEffect } from 'react';
-import { PROMPTBOOK_SYNTAX_COLORS } from '../../config';
+import { PROMPTBOOK_SYNTAX_COLORS } from './BookEditorBrowserConfig';
 import type { BookEditorTheme } from './BookEditorTheme';
 
 /**

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

@@ -3,7 +3,7 @@ import { type MutableRefObject, useCallback, useEffect, useMemo, useRef, useStat
 import type { Promisable } from 'type-fest';
 import { BookEditable } from '../../book-2.0/agent-source/BookEditable';
 import type { string_book } from '../../book-2.0/agent-source/string_book';
-import { DEFAULT_MAX_CONCURRENT_UPLOADS } from '../../config';
+import { DEFAULT_MAX_CONCURRENT_UPLOADS } from './BookEditorBrowserConfig';
 import { BookEditorMonacoConstants } from './BookEditorMonacoConstants';
 import { BookEditorMonacoFormatting } from './BookEditorMonacoFormatting';
 

package/src/book-components/Chat/utils/renderMarkdown.ts

@@ -5,7 +5,8 @@ import createDOMPurify, {
     type WindowLike as DomPurifyWindowLike,
 } from 'dompurify';
 import katex from 'katex';
-import { Converter as ShowdownConverter } from 'showdown';
+import type { Converter as ShowdownConverter } from 'showdown';
+import showdown from 'showdown';
 import type { string_html, string_markdown } from '../../../types/string_markdown';
 import { TODO_USE } from '../../../utils/organization/TODO_USE';
 import { createCitationMarkerRegex, parseCitationMarker } from './parseCitationMarker';
@@ -507,7 +508,7 @@ function normalizeMarkdownSublists(markdown: string_markdown): string_markdown {
 function createChatMarkdownConverter(options?: RenderMarkdownOptions): ShowdownConverter {
     const citationReferenceClassName = options?.citationReferenceClassName ?? DEFAULT_CITATION_REFERENCE_CLASS_NAME;
 
-    return new ShowdownConverter({
+    return new showdown.Converter({
         flavor: 'github',
         tables: true,
         strikethrough: true,

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

@@ -1,12 +1,20 @@
 import { join } from 'path';
 import { spaceTrim } from 'spacetrim';
-
-/**
- * Relative path to the local agent source initialized by `ptbk agent-folder init`.
- *
- * @private internal utility of `ptbk agent-folder`
- */
-export const AGENT_BOOK_FILE_PATH = 'agent.book';
+import {
+    AGENT_BOOK_FILE_PATH,
+    AGENT_FAILED_MESSAGES_DIRECTORY_PATH,
+    AGENT_FINISHED_MESSAGES_DIRECTORY_PATH,
+    AGENT_MESSAGES_DIRECTORY_PATH,
+    AGENT_QUEUED_MESSAGES_DIRECTORY_PATH,
+} from '../../../book-3.0/agentFolderPaths';
+
+export {
+    AGENT_BOOK_FILE_PATH,
+    AGENT_FAILED_MESSAGES_DIRECTORY_PATH,
+    AGENT_FINISHED_MESSAGES_DIRECTORY_PATH,
+    AGENT_MESSAGES_DIRECTORY_PATH,
+    AGENT_QUEUED_MESSAGES_DIRECTORY_PATH,
+};
 
 /**
  * Relative path to local knowledge files initialized by `ptbk agent-folder init`.
@@ -15,34 +23,6 @@ export const AGENT_BOOK_FILE_PATH = 'agent.book';
  */
 export const AGENT_KNOWLEDGE_DIRECTORY_PATH = 'knowledge';
 
-/**
- * Relative path to the message queue root initialized by `ptbk agent-folder init`.
- *
- * @private internal utility of `ptbk agent-folder`
- */
-export const AGENT_MESSAGES_DIRECTORY_PATH = 'messages';
-
-/**
- * Relative path to queued user messages consumed by `ptbk agent-folder run-once`.
- *
- * @private internal utility of `ptbk agent-folder`
- */
-export const AGENT_QUEUED_MESSAGES_DIRECTORY_PATH = join(AGENT_MESSAGES_DIRECTORY_PATH, 'queued');
-
-/**
- * Relative path to answered messages written by `ptbk agent-folder run-once`.
- *
- * @private internal utility of `ptbk agent-folder`
- */
-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`.
  *

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/commands/KNOWLEDGE/utils/knowledgeSourceContentToName.ts

@@ -1,4 +1,4 @@
-import { SHA256 as sha256 } from 'crypto-js';
+import CryptoJS from 'crypto-js';
 import hexEncoder from 'crypto-js/enc-hex';
 import type { string_knowledge_source_content } from '../../../types/string_knowledge_source_content';
 import type { string_name } from '../../../types/string_name';
@@ -10,7 +10,7 @@ import { normalizeToKebabCase } from '../../../utils/normalization/normalize-to-
  * @public exported from `@promptbook/editable`
  */
 export function knowledgeSourceContentToName(knowledgeSourceContent: string_knowledge_source_content): string_name {
-    const hash = sha256(hexEncoder.parse(JSON.stringify(knowledgeSourceContent)))
+    const hash = CryptoJS.SHA256(hexEncoder.parse(JSON.stringify(knowledgeSourceContent)))
         //    <- TODO: [🥬] Encapsulate sha256 to some private utility function
         .toString(/* hex */)
         .substring(0, 20);

package/src/commitments/_common/teamInternalAgentAccess.ts

@@ -1,4 +1,4 @@
-import { SHA256 as sha256 } from 'crypto-js';
+import CryptoJS from 'crypto-js';
 
 /**
  * Header used for same-server TEAM calls that may access private teammate agents.
@@ -44,7 +44,7 @@ export function resolveTeamInternalAgentAccessToken(): string | null {
         return null;
     }
 
-    return sha256(`promptbook-team-agent-access:${secret}`).toString();
+    return CryptoJS.SHA256(`promptbook-team-agent-access:${secret}`).toString();
 }
 
 /**

package/src/formats/csv/CsvFormatParser.ts

@@ -1,4 +1,4 @@
-import { unparse } from 'papaparse';
+import papaparse from 'papaparse';
 import { spaceTrim } from 'spacetrim';
 import type { TODO_any } from '../../utils/organization/TODO_any';
 import { TODO_USE } from '../../utils/organization/TODO_USE';
@@ -102,11 +102,11 @@ export const CsvFormatParser: FormatParser<
                             i > index ? { ...row, [outputParameterName]: PENDING_VALUE_PLACEHOLDER } : row,
                         );
                         */
-                        await onProgress(unparse(mappedData, { ...settings, ...MANDATORY_CSV_SETTINGS }));
+                        await onProgress(papaparse.unparse(mappedData, { ...settings, ...MANDATORY_CSV_SETTINGS }));
                     }
                 }
 
-                return unparse(mappedData, { ...settings, ...MANDATORY_CSV_SETTINGS });
+                return papaparse.unparse(mappedData, { ...settings, ...MANDATORY_CSV_SETTINGS });
             },
         },
         {
@@ -149,7 +149,7 @@ export const CsvFormatParser: FormatParser<
                     }),
                 );
 
-                return unparse(mappedData, { ...settings, ...MANDATORY_CSV_SETTINGS });
+                return papaparse.unparse(mappedData, { ...settings, ...MANDATORY_CSV_SETTINGS });
             },
         },
     ],

package/src/formats/csv/utils/csvParse.ts

@@ -1,5 +1,5 @@
 import type { ParseResult } from 'papaparse';
-import { parse } from 'papaparse';
+import papaparse from 'papaparse';
 import type { Parameters } from '../../../types/Parameters';
 import type { TODO_any } from '../../../utils/organization/TODO_any';
 import { TODO_USE } from '../../../utils/organization/TODO_USE';
@@ -31,6 +31,6 @@ export function csvParse(
         value = value.replace(/\r\n/g, '\n').replace(/\r/g, '\n');
     }
 
-    const csv = parse<Parameters>(value, settings);
+    const csv = papaparse.parse<Parameters>(value, settings);
     return csv;
 }

package/src/llm-providers/agent/AgentLlmExecutionTools.ts

@@ -1,4 +1,4 @@
-import { SHA256 as sha256 } from 'crypto-js';
+import CryptoJS from 'crypto-js';
 import hexEncoder from 'crypto-js/enc-hex';
 import type { Promisable } from 'type-fest';
 import type { AgentModelRequirements } from '../../book-2.0/agent-source/AgentModelRequirements';
@@ -230,7 +230,7 @@ export class AgentLlmExecutionTools implements LlmExecutionTools {
      * Returns a virtual model name representing the agent behavior.
      */
     public get modelName(): string_model_name {
-        const hash = sha256(hexEncoder.parse(this.options.agentSource)).toString(/* hex */);
+        const hash = CryptoJS.SHA256(hexEncoder.parse(this.options.agentSource)).toString(/* hex */);
         const agentId = hash.substring(0, 10);
 
         return (normalizeToKebabCase(this.title) + '-' + agentId) as string_model_name;

package/src/llm-providers/agent/AgentLlmExecutionToolsAgentKitRunner.ts

@@ -1,4 +1,4 @@
-import { SHA256 as sha256 } from 'crypto-js';
+import CryptoJS from 'crypto-js';
 import type { CallChatModelStreamOptions } from '../../execution/LlmExecutionTools';
 import type { ChatPromptResult, CommonPromptResult } from '../../execution/PromptResult';
 import type { Prompt } from '../../types/Prompt';
@@ -29,7 +29,7 @@ type AgentKitCacheState = {
  * Computes one stable hash from a JSON-serializable value.
  */
 function computeJsonHash(value: unknown): string {
-    return sha256(JSON.stringify(value)).toString();
+    return CryptoJS.SHA256(JSON.stringify(value)).toString();
 }
 
 /**

package/src/llm-providers/agent/AgentLlmExecutionToolsOpenAiAssistantRunner.ts

@@ -1,4 +1,4 @@
-import { SHA256 as sha256 } from 'crypto-js';
+import CryptoJS from 'crypto-js';
 import type { CallChatModelStreamOptions } from '../../execution/LlmExecutionTools';
 import type { ChatPromptResult, CommonPromptResult } from '../../execution/PromptResult';
 import type { ChatPrompt, Prompt } from '../../types/Prompt';
@@ -12,7 +12,7 @@ import { emitAgentLlmExecutionToolsAssistantPreparationProgress } from './emitAg
  * Computes one stable hash from a JSON-serializable value.
  */
 function computeJsonHash(value: unknown): string {
-    return sha256(JSON.stringify(value)).toString();
+    return CryptoJS.SHA256(JSON.stringify(value)).toString();
 }
 
 /**