@promptbook/cli 0.112.0-119 → 0.112.0-121

package/esm/src/book-components/BookEditor/BookEditorMonacoTokenization.d.ts

@@ -15,6 +15,7 @@ type AgentReferenceMatch = {
  * @private function of BookEditorMonaco
  */
 export declare const BookEditorMonacoTokenization: {
+    DYNAMIC_COMMITMENT_REGEX: RegExp;
     AGENT_URL_REFERENCE_REGEX: RegExp;
     AGENT_REFERENCE_TOKEN_REGEX: RegExp;
     AGENT_REFERENCE_BRACED_REGEX: RegExp;

package/esm/src/llm-providers/_common/register/$provideLlmToolsConfigurationFromEnv.d.ts

@@ -6,7 +6,7 @@ import type { LlmToolsConfiguration } from './LlmToolsConfiguration';
  *
  * It looks for environment variables:
  * - `process.env.OPENAI_API_KEY`
- * - `process.env.ANTHROPIC_CLAUDE_API_KEY`
+ * - `process.env.ANTHROPIC_API_KEY` (or the deprecated `process.env.ANTHROPIC_CLAUDE_API_KEY`)
  * - ...
  *
  * @see Environment variables documentation or .env file for required variables.

package/esm/src/llm-providers/_common/register/$provideLlmToolsFromEnv.d.ts

@@ -13,7 +13,7 @@ import type { CreateLlmToolsFromConfigurationOptions } from './createLlmToolsFro
  *
  * It looks for environment variables:
  * - `process.env.OPENAI_API_KEY`
- * - `process.env.ANTHROPIC_CLAUDE_API_KEY`
+ * - `process.env.ANTHROPIC_API_KEY` (or the deprecated `process.env.ANTHROPIC_CLAUDE_API_KEY`)
  * - ...
  *
  * @param options Configuration options for the LLM tools

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

package/package.json

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

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

@@ -7,10 +7,12 @@ const AGENT_REFERENCE_URL_PATTERN = 'https?:\\/\\/[^\\s{}]+';
 
 /**
  * Regex source for compact `@id` references.
+ * The negative lookbehind `(?<!\S)` ensures the `@` is preceded only by whitespace or is at the
+ * start of the string, so email addresses like `team@foo.bar` are not treated as agent references.
  *
  * @private function of BookEditorMonaco
  */
-const AGENT_REFERENCE_AT_PATTERN = '@[A-Za-z0-9_-]+';
+const AGENT_REFERENCE_AT_PATTERN = '(?<!\\S)@[A-Za-z0-9_-]+';
 
 /**
  * Regex source for braced references (`{Agent}`, `{Agent Name}`, `{https://...}`).
@@ -27,28 +29,15 @@ const AGENT_REFERENCE_BRACED_PATTERN = '\\{[^{}\\r\\n]+\\}';
 const AGENT_REFERENCE_COMMITMENT_TYPES = ['FROM', 'IMPORT', 'IMPORTS', 'TEAM'] as const;
 
 /**
- * Commitment types known to the browser editor tokenizer.
+ * Regex matching any line that starts with one or more all-uppercase words (minimum 2 characters each).
+ * Used to detect commitment line boundaries without a hardcoded list of commitment types.
+ *
+ * Single-letter uppercase words (e.g. "V", "A") are excluded to avoid false positives with
+ * natural-language sentences that start with a short uppercase word.
  *
  * @private function of BookEditorMonaco
  */
-const BOOK_EDITOR_COMMITMENT_TYPES = [
-    'PERSONA',
-    'KNOWLEDGE',
-    'TASK',
-    'PROMPT',
-    'EXPECT',
-    'FORMAT',
-    'MODEL',
-    'SAMPLE',
-    'FROM',
-    'IMPORT',
-    'IMPORTS',
-    'TEAM',
-    'TODO',
-    'NOTE',
-    'NOTES',
-    'NONCE',
-] as const;
+const DYNAMIC_COMMITMENT_REGEX = /^\s*[A-Z][A-Z0-9]+(?:\s+[A-Z][A-Z0-9]+)*(?=\s|$)/;
 
 /**
  * Regex pattern to match horizontal lines.
@@ -57,7 +46,7 @@ const BOOK_EDITOR_COMMITMENT_TYPES = [
  */
 const HORIZONTAL_LINE_PATTERN = /^[\s]*[-_*][\s]*[-_*][\s]*[-_*][\s]*[-_*]*[\s]*$/;
 
-const BOOK_EDITOR_COMMITMENT_LINE_REGEX = createCommitmentLineRegex(BOOK_EDITOR_COMMITMENT_TYPES);
+const BOOK_EDITOR_COMMITMENT_LINE_REGEX = DYNAMIC_COMMITMENT_REGEX;
 const AGENT_REFERENCE_COMMITMENT_LINE_REGEX = createCommitmentLineRegex(AGENT_REFERENCE_COMMITMENT_TYPES);
 
 /**
@@ -204,13 +193,6 @@ const extractAgentReferenceMatches = (content: string): Array<AgentReferenceMatc
 
                 const absoluteIndex = lineStartOffset + indexInLine;
 
-                if (token.startsWith('@') && absoluteIndex > 0) {
-                    const previousChar = content[absoluteIndex - 1] || '';
-                    if (/[A-Za-z0-9_.-]/.test(previousChar)) {
-                        continue;
-                    }
-                }
-
                 const value = extractAgentReferenceValue(token);
                 const url = resolveAgentReferenceToUrl(value);
 
@@ -348,6 +330,7 @@ function findBookBodyStartLineIndex(sourceLines: ReadonlyArray<string>): number
  * @private function of BookEditorMonaco
  */
 export const BookEditorMonacoTokenization = {
+    DYNAMIC_COMMITMENT_REGEX,
     AGENT_URL_REFERENCE_REGEX,
     AGENT_REFERENCE_TOKEN_REGEX,
     AGENT_REFERENCE_BRACED_REGEX,

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

@@ -204,32 +204,18 @@ function createCommitmentRegex(commitmentTypes: ReadonlyArray<string>): RegExp {
 }
 
 /**
- * Creates regex-token-state triples for note-like commitment groups available in this runtime.
+ * Creates regex-token-state triples for note-like commitment groups (TODO/NOTE/NOTES/NONCE).
  *
- * @param commitmentTypes - All known commitment types.
  * @returns Tokenization metadata for TODO/NOTE-like commitment groups.
  *
  * @private function of BookEditorMonaco
  */
-function createNoteLikeCommitmentStates(commitmentTypes: ReadonlyArray<string>): Array<NoteLikeCommitmentState> {
-    const commitmentTypeSet = new Set(commitmentTypes.map((type) => type.toUpperCase()));
-
-    return NOTE_LIKE_COMMITMENT_GROUPS.flatMap((group) => {
-        const matchingCommitmentTypes = group.commitmentTypes.filter((type) =>
-            commitmentTypeSet.has(type.toUpperCase()),
-        );
-        if (matchingCommitmentTypes.length === 0) {
-            return [];
-        }
-
-        return [
-            {
-                regex: createCommitmentRegex(matchingCommitmentTypes),
-                token: group.token,
-                state: group.state,
-            } satisfies NoteLikeCommitmentState,
-        ];
-    });
+function createNoteLikeCommitmentStates(): Array<NoteLikeCommitmentState> {
+    return NOTE_LIKE_COMMITMENT_GROUPS.map((group) => ({
+        regex: createCommitmentRegex([...group.commitmentTypes]),
+        token: group.token,
+        state: group.state,
+    }));
 }
 
 /**
@@ -298,7 +284,7 @@ export function ensureBookEditorMonacoLanguage(
 
     monaco.languages.register({ id: BookEditorMonacoConstants.BOOK_LANGUAGE_ID });
 
-    const commitmentTypes = [
+    const completionCommitmentTypes = [
         'GOAL',
         'RULE',
         'PERSONA',
@@ -317,13 +303,8 @@ export function ensureBookEditorMonacoLanguage(
         ...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(
-        (type) => !noteLikeCommitmentTypeSet.has(type.toUpperCase()),
-    );
-    const commitmentRegex = createCommitmentRegex(executableCommitmentTypes);
+    const noteLikeCommitmentStates = createNoteLikeCommitmentStates();
+    const commitmentRegex = BookEditorMonacoTokenization.DYNAMIC_COMMITMENT_REGEX;
     const agentReferenceCommitmentRegex = /^\s*(FROM|IMPORT|IMPORTS|TEAM)(?=\s|$)/;
     const commitmentTransitionRules = createCommitmentTransitionRules(
         noteLikeCommitmentStates,
@@ -359,7 +340,6 @@ export function ensureBookEditorMonacoLanguage(
     const todoCommitmentBodyRules: any = createNoteLikeBodyRules('todo-commitment', commitmentTransitionRules);
 
     monaco.languages.setMonarchTokensProvider(BookEditorMonacoConstants.BOOK_LANGUAGE_ID, {
-        ignoreCase: true,
         tokenizer: {
             root: [
                 [/^\s*$/, 'empty'],

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

@@ -67,12 +67,7 @@ export function CitationIframePreview({ src, title }: CitationIframePreviewProps
                     alt={`Screenshot of ${title}`}
                     className={styles.citationScreenshotImage}
                 />
-                <a
-                    href={src}
-                    target="_blank"
-                    rel="noopener noreferrer"
-                    className={styles.citationScreenshotLink}
-                >
+                <a href={src} target="_blank" rel="noopener noreferrer" className={styles.citationScreenshotLink}>
                     Open in new tab ↗
                 </a>
             </div>

package/src/cli/cli-commands/coder/agentCodingFile.ts

@@ -45,7 +45,7 @@ export function getDefaultCoderAgentCodingFileContent({
             6. Use \`npm run coder:verify\` to archive finished prompts into \`${formatDisplayPath(
                 PROMPTS_DONE_DIRECTORY_PATH,
             )}/\` and append repair follow-up prompts when more work is needed.
-            7. Use \`npm run coder:find-refactor-candidates\` when you want Promptbook to suggest refactor prompts automatically.
+            7. Use \`ptbk coder find-refactor-candidates\` when you want Promptbook to suggest refactor prompts automatically.
 
             ## Templates
             -   Project-owned templates created by \`ptbk coder init\`: ${formatInlineCodeList(

package/src/cli/cli-commands/coder/getDefaultCoderPackageJsonScripts.ts

@@ -4,8 +4,8 @@
 const DEFAULT_CODER_PACKAGE_JSON_SCRIPTS = {
     'coder:generate-boilerplates': 'ptbk coder generate-boilerplates --template ./prompts/templates/common.md',
     'coder:run':
-        'ptbk coder run --harness github-copilot --model gpt-5.4 --thinking-level xhigh --context AGENTS.md --no-wait',
-    'coder:find-refactor-candidates': 'ptbk coder find-refactor-candidates',
+        'ptbk coder run --harness openai-codex --model gpt-5.4 --thinking-level xhigh --context AGENTS.md --no-wait',
+    // 'coder:find-refactor-candidates': 'ptbk coder find-refactor-candidates',
     'coder:verify': 'ptbk coder verify',
 } as const satisfies Readonly<Record<string, string>>;
 

package/src/llm-providers/_common/register/$provideLlmToolsConfigurationFromEnv.ts

@@ -13,7 +13,7 @@ import type { LlmToolsConfiguration } from './LlmToolsConfiguration';
  *
  * It looks for environment variables:
  * - `process.env.OPENAI_API_KEY`
- * - `process.env.ANTHROPIC_CLAUDE_API_KEY`
+ * - `process.env.ANTHROPIC_API_KEY` (or the deprecated `process.env.ANTHROPIC_CLAUDE_API_KEY`)
  * - ...
  *
  * @see Environment variables documentation or .env file for required variables.

package/src/llm-providers/_common/register/$provideLlmToolsFromEnv.ts

@@ -22,7 +22,7 @@ import { createLlmToolsFromConfiguration } from './createLlmToolsFromConfigurati
  *
  * It looks for environment variables:
  * - `process.env.OPENAI_API_KEY`
- * - `process.env.ANTHROPIC_CLAUDE_API_KEY`
+ * - `process.env.ANTHROPIC_API_KEY` (or the deprecated `process.env.ANTHROPIC_CLAUDE_API_KEY`)
  * - ...
  *
  * @param options Configuration options for the LLM tools

package/src/llm-providers/anthropic-claude/register-configuration.ts

@@ -19,7 +19,7 @@ export const _AnthropicClaudeMetadataRegistration: Registration = $llmToolsMetad
     title: 'Anthropic Claude',
     packageName: '@promptbook/anthropic-claude',
     className: 'AnthropicClaudeExecutionTools',
-    envVariables: ['ANTHROPIC_CLAUDE_API_KEY'],
+    envVariables: ['ANTHROPIC_API_KEY', 'ANTHROPIC_CLAUDE_API_KEY'],
     trustLevel: 'CLOSED',
     order: MODEL_ORDERS.TOP_TIER,
 
@@ -39,13 +39,16 @@ export const _AnthropicClaudeMetadataRegistration: Registration = $llmToolsMetad
 
     createConfigurationFromEnv(env: Record<string_name, string>): LlmToolsConfiguration[number] | null {
         // Note: Note using `process.env` BUT `env` to pass in the environment variables dynamically
-        if (typeof env.ANTHROPIC_CLAUDE_API_KEY === 'string') {
+        // Note: `ANTHROPIC_API_KEY` takes precedence over the deprecated `ANTHROPIC_CLAUDE_API_KEY`
+        const apiKey = env.ANTHROPIC_API_KEY ?? env.ANTHROPIC_CLAUDE_API_KEY;
+
+        if (typeof apiKey === 'string') {
             return {
                 title: 'Claude (from env)',
                 packageName: '@promptbook/anthropic-claude',
                 className: 'AnthropicClaudeExecutionTools',
                 options: {
-                    apiKey: env.ANTHROPIC_CLAUDE_API_KEY!,
+                    apiKey,
                 } satisfies AnthropicClaudeExecutionToolsOptions,
             };
         }

package/src/llm-providers/openai/OpenAiAgentKitExecutionToolsToolBuilder.ts

@@ -449,7 +449,9 @@ export class OpenAiAgentKitExecutionToolsToolBuilder {
             );
         }
 
-        return Array.isArray(executionTools.script) ? executionTools.script : [executionTools.script as ScriptExecutionTools];
+        return Array.isArray(executionTools.script)
+            ? executionTools.script
+            : [executionTools.script as ScriptExecutionTools];
     }
 
     /**