@promptbook/cli 0.112.0-12 → 0.112.0-15

package/esm/index.es.js

@@ -1,6 +1,6 @@
 import colors from 'colors';
 import commander from 'commander';
-import spaceTrim$2, { spaceTrim as spaceTrim$1 } from 'spacetrim';
+import _spaceTrim, { spaceTrim as spaceTrim$1 } from 'spacetrim';
 import * as fs from 'fs';
 import { writeFileSync, readFileSync, existsSync } from 'fs';
 import * as path from 'path';
@@ -14,13 +14,10 @@ import sha256 from 'crypto-js/sha256';
 import { io } from 'socket.io-client';
 import { SHA256 } from 'crypto-js';
 import JSZip from 'jszip';
-import { randomBytes, randomUUID, createHash } from 'crypto';
+import { randomBytes, createHash } from 'crypto';
 import { Readability } from '@mozilla/readability';
 import { JSDOM } from 'jsdom';
 import { Converter } from 'showdown';
-import { tmpdir } from 'os';
-import { ConfigChecker } from 'configchecker';
-import { chromium } from 'playwright';
 import glob from 'glob-promise';
 import moment from 'moment';
 import express from 'express';
@@ -60,7 +57,7 @@ const BOOK_LANGUAGE_VERSION = '2.0.0';
  * @generated
  * @see https://github.com/webgptorg/promptbook
  */
-const PROMPTBOOK_ENGINE_VERSION = '0.112.0-12';
+const PROMPTBOOK_ENGINE_VERSION = '0.112.0-15';
 /**
  * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
  * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -1428,7 +1425,7 @@ function $isRunningInWebWorker() {
 function getErrorReportUrl(error) {
     const report = {
         title: `🐜 Error report from ${NAME}`,
-        body: spaceTrim$2((block) => `
+        body: spaceTrim$1((block) => `
 
 
             \`${error.name || 'Error'}\` has occurred in the [${NAME}], please look into it @${ADMIN_GITHUB_NAME}.
@@ -1567,7 +1564,7 @@ function handleActionErrors(action) {
  */
 function $initializeAboutCommand(program) {
     const makeCommand = program.command('about');
-    makeCommand.description(spaceTrim$2(`
+    makeCommand.description(spaceTrim$1(`
             Tells about Promptbook CLI and its abilities
         `));
     makeCommand.action(handleActionErrors(async () => {
@@ -1607,15 +1604,15 @@ function $initializeAboutCommand(program) {
  */
 
 /**
- * Initializes `coder find-fresh-emoji-tag` command for Promptbook CLI utilities
+ * Initializes `coder find-fresh-emoji-tags` command for Promptbook CLI utilities
  *
  * Note: `$` is used to indicate that this function is not a pure function - it registers a command in the CLI
  *
  * @private internal function of `promptbookCli`
  */
 function $initializeCoderFindFreshEmojiTagCommand(program) {
-    const command = program.command('find-fresh-emoji-tag');
-    command.description(spaceTrim$2(`
+    const command = program.command('find-fresh-emoji-tags');
+    command.description(_spaceTrim(`
             Find unused emoji tags in the codebase
 
             Scans entire codebase for emoji tags already in use (format: [emoji])
@@ -1624,7 +1621,7 @@ function $initializeCoderFindFreshEmojiTagCommand(program) {
         `));
     command.action(handleActionErrors(async () => {
         // Note: Import the function dynamically to avoid loading heavy dependencies until needed
-        const { findFreshEmojiTag } = await Promise.resolve().then(function () { return findFreshEmojiTag$1; });
+        const { findFreshEmojiTag } = await Promise.resolve().then(function () { return findFreshEmojiTags; });
         try {
             await findFreshEmojiTag();
         }
@@ -1649,7 +1646,7 @@ function $initializeCoderFindFreshEmojiTagCommand(program) {
  */
 function $initializeCoderFindRefactorCandidatesCommand(program) {
     const command = program.command('find-refactor-candidates');
-    command.description(spaceTrim$2(`
+    command.description(spaceTrim$1(`
             Scan source files to identify refactoring candidates
 
             Flags files that exceed:
@@ -1839,7 +1836,7 @@ function buildPromptSlug$1(template, title) {
  */
 function $initializeCoderRunCommand(program) {
     const command = program.command('run');
-    command.description(spaceTrim$2(`
+    command.description(spaceTrim$1(`
             Execute coding prompts through selected AI agent
 
             Runners:
@@ -1857,7 +1854,7 @@ function $initializeCoderRunCommand(program) {
         `));
     command.option('--dry-run', 'Print unwritten prompts without executing', false);
     command.option('--agent <agent-name>', 'Select runner: openai-codex, cline, claude-code, opencode, gemini (required for non-dry-run)');
-    command.option('--model <model>', spaceTrim$2(`
+    command.option('--model <model>', spaceTrim$1(`
             Model to use (required for openai-codex and gemini)
 
             OpenAI examples: gpt-5.2-codex, default
@@ -1945,7 +1942,7 @@ function parseIntOption(value) {
  */
 function $initializeCoderVerifyCommand(program) {
     const command = program.command('verify');
-    command.description(spaceTrim$2(`
+    command.description(spaceTrim$1(`
             Interactive verification helper for completed prompts
 
             Features:
@@ -1983,7 +1980,7 @@ function $initializeCoderVerifyCommand(program) {
  * - find-refactor-candidates: Find files that need refactoring
  * - run: Run coding prompts with AI agents
  * - verify: Verify completed prompts
- * - find-fresh-emoji-tag: Find unused emoji tags
+ * - find-fresh-emoji-tags: Find unused emoji tags
  *
  * Note: `$` is used to indicate that this function is not a pure function - it registers a command in the CLI
  *
@@ -1991,7 +1988,7 @@ function $initializeCoderVerifyCommand(program) {
  */
 function $initializeCoderCommand(program) {
     const coderCommand = program.command('coder');
-    coderCommand.description(spaceTrim$2(`
+    coderCommand.description(spaceTrim$1(`
             Coding utilities for automated development workflows
 
             Subcommands:
@@ -1999,7 +1996,7 @@ function $initializeCoderCommand(program) {
             - find-refactor-candidates: Find files that need refactoring
             - run: Run coding prompts with AI agents
             - verify: Verify completed prompts
-            - find-fresh-emoji-tag: Find unused emoji tags
+            - find-fresh-emoji-tags: Find unused emoji tags
         `));
     // Register all subcommands
     $initializeCoderGenerateBoilerplatesCommand(coderCommand);
@@ -2028,7 +2025,7 @@ function $initializeCoderCommand(program) {
  */
 function $initializeHelloCommand(program) {
     const helloCommand = program.command('hello');
-    helloCommand.description(spaceTrim$2(`
+    helloCommand.description(spaceTrim$1(`
             Just command for testing
         `));
     helloCommand.alias('hi');
@@ -2290,13 +2287,13 @@ function $registeredLlmToolsMessage() {
     });
     const usedEnvMessage = $usedEnvFilename === null ? `Unknown \`.env\` file` : `Used \`.env\` file:\n${$usedEnvFilename}`;
     if (metadata.length === 0) {
-        return spaceTrim$2((block) => `
+        return spaceTrim$1((block) => `
                 No LLM providers are available.
 
                 ${block(usedEnvMessage)}
           `);
     }
-    return spaceTrim$2((block) => `
+    return spaceTrim$1((block) => `
 
             ${block(usedEnvMessage)}
 
@@ -2342,7 +2339,7 @@ function $registeredLlmToolsMessage() {
                 morePieces.push(`Not configured`); // <- Note: Can not be configured via environment variables
             }
         }
-        let providerMessage = spaceTrim$2(`
+        let providerMessage = spaceTrim$1(`
                                 ${i + 1}) **${title}** \`${className}\` from \`${packageName}\`
                                     ${morePieces.join('; ')}
                             `);
@@ -2408,7 +2405,7 @@ function jsonParse(value) {
     }
     else if (typeof value !== 'string') {
         console.error('Can not parse JSON from non-string value.', { text: value });
-        throw new Error(spaceTrim$2(`
+        throw new Error(spaceTrim$1(`
                     Can not parse JSON from non-string value.
 
                     The value type: ${typeof value}
@@ -2422,7 +2419,7 @@ function jsonParse(value) {
         if (!(error instanceof Error)) {
             throw error;
         }
-        throw new Error(spaceTrim$2((block) => `
+        throw new Error(spaceTrim$1((block) => `
                     ${block(error.message)}
 
                     The expected JSON text:
@@ -2644,7 +2641,7 @@ class $EnvStorage {
             .filter((line) => !line.startsWith(`# ${GENERATOR_WARNING_IN_ENV}`)) // Remove GENERATOR_WARNING_IN_ENV
             .filter((line) => !line.startsWith(`${transformedKey}=`)) // Remove existing key if present
             .join('\n');
-        const newEnvContent = spaceTrim$2((block) => `
+        const newEnvContent = spaceTrim$1((block) => `
                 ${block(updatedEnvContent)}
 
                 # ${GENERATOR_WARNING_IN_ENV}
@@ -2755,7 +2752,7 @@ function checkSerializableAsJson(options) {
     }
     else if (typeof value === 'object') {
         if (value instanceof Date) {
-            throw new UnexpectedError(spaceTrim$2((block) => `
+            throw new UnexpectedError(spaceTrim$1((block) => `
                         \`${name}\` is Date
 
                         Use \`string_date_iso8601\` instead
@@ -2774,7 +2771,7 @@ function checkSerializableAsJson(options) {
             throw new UnexpectedError(`${name} is RegExp`);
         }
         else if (value instanceof Error) {
-            throw new UnexpectedError(spaceTrim$2((block) => `
+            throw new UnexpectedError(spaceTrim$1((block) => `
                         \`${name}\` is unserialized Error
 
                         Use function \`serializeError\`
@@ -2797,7 +2794,7 @@ function checkSerializableAsJson(options) {
             }
             catch (error) {
                 assertsError(error);
-                throw new UnexpectedError(spaceTrim$2((block) => `
+                throw new UnexpectedError(spaceTrim$1((block) => `
                             \`${name}\` is not serializable
 
                             ${block(error.stack || error.message)}
@@ -2829,7 +2826,7 @@ function checkSerializableAsJson(options) {
         }
     }
     else {
-        throw new UnexpectedError(spaceTrim$2((block) => `
+        throw new UnexpectedError(spaceTrim$1((block) => `
                     \`${name}\` is unknown type
 
                     Additional message for \`${name}\`:
@@ -3093,7 +3090,7 @@ function isSerializableAsJson(value) {
  */
 function stringifyPipelineJson(pipeline) {
     if (!isSerializableAsJson(pipeline)) {
-        throw new UnexpectedError(spaceTrim$2(`
+        throw new UnexpectedError(spaceTrim$1(`
                 Cannot stringify the pipeline, because it is not serializable as JSON
 
                 There can be multiple reasons:
@@ -4007,7 +4004,7 @@ function deserializeError(error, isStackAddedToMessage = true) {
         message = `${name}: ${message}`;
     }
     if (isStackAddedToMessage && stack !== undefined && stack !== '') {
-        message = spaceTrim$2((block) => `
+        message = spaceTrim$1((block) => `
                 ${block(message)}
 
                 Original stack trace:
@@ -4034,7 +4031,7 @@ async function createRemoteClient(options) {
     const remoteServerUrlParsed = new URL(remoteServerUrl);
     if (remoteServerUrlParsed.pathname !== '/' && remoteServerUrlParsed.pathname !== '') {
         remoteServerUrlParsed.pathname = '/';
-        throw new Error(spaceTrim$2((block) => `
+        throw new Error(spaceTrim$1((block) => `
                         Remote server requires root url \`/\`
 
                         You have provided \`remoteServerUrl\`:
@@ -4360,7 +4357,7 @@ function serializeError(error) {
     const { name, message, stack } = error;
     const { id } = error;
     if (!Object.keys(ALL_ERRORS).includes(name)) {
-        console.error(spaceTrim$2((block) => `
+        console.error(spaceTrim$1((block) => `
 
                     Cannot serialize error with name "${name}"
 
@@ -4885,7 +4882,7 @@ function buildParametersSection(items) {
     const entries = items
         .flatMap((item) => formatParameterListItem(item).split(/\r?\n/))
         .filter((line) => line !== '');
-    return spaceTrim$2((block) => `
+    return spaceTrim$1((block) => `
             **Parameters:**
             ${block(entries.join('\n'))}
 
@@ -4958,7 +4955,7 @@ function isPromptString(value) {
  */
 function prompt(strings, ...values) {
     if (values.length === 0) {
-        return new PromptString(spaceTrim$2(strings.join('')));
+        return new PromptString(spaceTrim$1(strings.join('')));
     }
     const stringsWithHiddenParameters = strings.map((stringsItem) => ParameterEscaping.hideBrackets(stringsItem));
     const parameterMetadata = values.map((value) => {
@@ -4999,7 +4996,7 @@ function prompt(strings, ...values) {
             ? `${result}${stringsItem}`
             : `${result}${stringsItem}${ParameterSection.formatParameterPlaceholder(parameterName)}`;
     }, '');
-    pipelineString = spaceTrim$2(pipelineString);
+    pipelineString = spaceTrim$1(pipelineString);
     try {
         pipelineString = templateParameters(pipelineString, parameters);
     }
@@ -5008,7 +5005,7 @@ function prompt(strings, ...values) {
             throw error;
         }
         console.error({ pipelineString, parameters, parameterNames: parameterNamesOrdered, error });
-        throw new UnexpectedError(spaceTrim$2((block) => `
+        throw new UnexpectedError(spaceTrim$1((block) => `
                     Internal error in prompt template literal
                   
                     ${block(JSON.stringify({ strings, values }, null, 4))}}
@@ -5231,7 +5228,7 @@ const CountUtils = {
  * @public exported from `@promptbook/utils`
  */
 function computeHash(value) {
-    return SHA256(hexEncoder.parse(spaceTrim$2(valueToString(value)))).toString( /* hex */);
+    return SHA256(hexEncoder.parse(spaceTrim$1(valueToString(value)))).toString( /* hex */);
 }
 /**
  * TODO: [🥬][🥬] Use this ACRY
@@ -7517,7 +7514,7 @@ function cacheLlmTools(llmTools, options = {}) {
         let normalizedContent = content;
         normalizedContent = normalizedContent.replace(/\s+/g, ' ');
         normalizedContent = normalizedContent.split('\r\n').join('\n');
-        normalizedContent = spaceTrim$2(normalizedContent);
+        normalizedContent = spaceTrim$1(normalizedContent);
         // Note: Do not need to save everything in the cache, just the relevant parameters
         const relevantParameterNames = extractParameterNames(content);
         const relevantParameters = Object.fromEntries(Object.entries(parameters).filter(([key]) => relevantParameterNames.has(key)));
@@ -7987,14 +7984,14 @@ class MultipleLlmExecutionTools {
             if (description === undefined) {
                 return headLine;
             }
-            return spaceTrim$2((block) => `
+            return spaceTrim$1((block) => `
                         ${headLine}
 
                           ${ /* <- Note: Indenting the description: */block(description)}
                     `);
         })
             .join('\n\n');
-        return spaceTrim$2((block) => `
+        return spaceTrim$1((block) => `
                 Multiple LLM Providers:
 
                 ${block(innerModelsTitlesAndDescriptions)}
@@ -8096,7 +8093,7 @@ class MultipleLlmExecutionTools {
             //     1) OpenAI throw PipelineExecutionError: Parameter `{knowledge}` is not defined
             //     2) AnthropicClaude throw PipelineExecutionError: Parameter `{knowledge}` is not defined
             //     3) ...
-            spaceTrim$2((block) => `
+            spaceTrim$1((block) => `
                           All execution tools of ${this.title} failed:
 
                           ${block(errors
@@ -8109,7 +8106,7 @@ class MultipleLlmExecutionTools {
             throw new PipelineExecutionError(`You have not provided any \`LlmExecutionTools\` into ${this.title}`);
         }
         else {
-            throw new PipelineExecutionError(spaceTrim$2((block) => `
+            throw new PipelineExecutionError(spaceTrim$1((block) => `
                           You have not provided any \`LlmExecutionTools\` that support model variant "${prompt.modelRequirements.modelVariant}" into ${this.title}
 
                           Available \`LlmExecutionTools\`:
@@ -8146,7 +8143,7 @@ class MultipleLlmExecutionTools {
  */
 function joinLlmExecutionTools(title, ...llmExecutionTools) {
     if (llmExecutionTools.length === 0) {
-        const warningMessage = spaceTrim$2(`
+        const warningMessage = spaceTrim$1(`
             You have not provided any \`LlmExecutionTools\`
             This means that you won't be able to execute any prompts that require large language models like GPT-4 or Anthropic's Claude.
 
@@ -8204,7 +8201,7 @@ function createLlmToolsFromConfiguration(configuration, options = {}) {
             .find(({ packageName, className }) => llmConfiguration.packageName === packageName && llmConfiguration.className === className);
         if (registeredItem === undefined) {
             // console.log('$llmToolsRegister.list()', $llmToolsRegister.list());
-            throw new Error(spaceTrim$2((block) => `
+            throw new Error(spaceTrim$1((block) => `
                         There is no constructor for LLM provider \`${llmConfiguration.className}\` from \`${llmConfiguration.packageName}\`
                         Running in ${!$isRunningInBrowser() ? '' : 'browser environment'}${!$isRunningInNode() ? '' : 'node environment'}${!$isRunningInWebWorker() ? '' : 'worker environment'}
 
@@ -8272,14 +8269,14 @@ async function $provideLlmToolsFromEnv(options = {}) {
     const configuration = await $provideLlmToolsConfigurationFromEnv();
     if (configuration.length === 0) {
         if ($llmToolsMetadataRegister.list().length === 0) {
-            throw new UnexpectedError(spaceTrim$2((block) => `
+            throw new UnexpectedError(spaceTrim$1((block) => `
                         No LLM tools registered, this is probably a bug in the Promptbook library
 
                         ${block($registeredLlmToolsMessage())}}
                     `));
         }
         // TODO: [🥃]
-        throw new Error(spaceTrim$2((block) => `
+        throw new Error(spaceTrim$1((block) => `
                     No LLM tools found in the environment
 
                     ${block($registeredLlmToolsMessage())}}
@@ -8389,7 +8386,7 @@ const promptbookFetch = async (urlOrRequest, init) => {
         else if (urlOrRequest instanceof Request) {
             url = urlOrRequest.url;
         }
-        throw new PromptbookFetchError(spaceTrim$2((block) => `
+        throw new PromptbookFetchError(spaceTrim$1((block) => `
                     Can not fetch "${url}"
 
                     Fetch error:
@@ -8443,7 +8440,7 @@ async function $provideLlmToolsForCli(options) {
                     console.log(colors.red(`You can not login to remote server in non-interactive mode`));
                     process.exit(1);
                 }
-                console.info(colors.cyan(spaceTrim$2(`
+                console.info(colors.cyan(spaceTrim$1(`
                           You will be logged in to ${remoteServerUrl}
                           If you don't have an account, it will be created automatically.
                       `)));
@@ -8517,7 +8514,7 @@ async function $provideLlmToolsForCli(options) {
  */
 function $initializeListModelsCommand(program) {
     const listModelsCommand = program.command('list-models');
-    listModelsCommand.description(spaceTrim$2(`
+    listModelsCommand.description(spaceTrim$1(`
             List all available and configured LLM models
         `));
     listModelsCommand.alias('models');
@@ -9006,14 +9003,14 @@ function $registeredScrapersMessage(availableScrapers) {
         return { ...metadata, isMetadataAviailable, isInstalled, isAvailableInTools };
     });
     if (metadata.length === 0) {
-        return spaceTrim$2(`
+        return spaceTrim$1(`
             **No scrapers are available**
 
             This is a unexpected behavior, you are probably using some broken version of Promptbook
             At least there should be available the metadata of the scrapers
         `);
     }
-    return spaceTrim$2((block) => `
+    return spaceTrim$1((block) => `
             Available scrapers are:
             ${block(metadata
         .map(({ packageName, className, isMetadataAviailable, isInstalled, mimeTypes, isAvailableInBrowser, isAvailableInTools, }, i) => {
@@ -9064,7 +9061,7 @@ function $registeredScrapersMessage(availableScrapers) {
  */
 function $initializeListScrapersCommand(program) {
     const listModelsCommand = program.command('list-scrapers');
-    listModelsCommand.description(spaceTrim$2(`
+    listModelsCommand.description(spaceTrim$1(`
             List all available and configured scrapers and executables
         `));
     listModelsCommand.alias('scrapers');
@@ -9072,7 +9069,7 @@ function $initializeListScrapersCommand(program) {
         // TODO: [🌞] Do not allow on REMOTE_SERVER strategy
         const scrapers = await $provideScrapersForNode({});
         const executables = await $provideExecutablesForNode();
-        console.info(spaceTrim$2((block) => `
+        console.info(spaceTrim$1((block) => `
                     ${block($registeredScrapersMessage(scrapers))}
 
                     All mime-types which can be scraped:
@@ -9102,7 +9099,7 @@ function $initializeListScrapersCommand(program) {
  */
 function $initializeLoginCommand(program) {
     const loginCommand = program.command('login');
-    loginCommand.description(spaceTrim$2(`
+    loginCommand.description(spaceTrim$1(`
             Login to the remote Promptbook server
         `));
     loginCommand.action(handleActionErrors(async (cliOptions) => {
@@ -9602,7 +9599,7 @@ function pipelineJsonToString(pipelineJson) {
         pipelineString += '\n\n';
         pipelineString += '```' + contentLanguage;
         pipelineString += '\n';
-        pipelineString += spaceTrim$2(content);
+        pipelineString += spaceTrim$1(content);
         //                   <- TODO: [main] !!3 Escape
         //                   <- TODO: [🧠] Some clear strategy how to spaceTrim the blocks
         pipelineString += '\n';
@@ -10237,7 +10234,7 @@ const CsvFormatParser = {
                 const { value, outputParameterName, settings, mapCallback, onProgress } = options;
                 const csv = csvParse(value, settings);
                 if (csv.errors.length !== 0) {
-                    throw new CsvFormatError(spaceTrim$2((block) => `
+                    throw new CsvFormatError(spaceTrim$1((block) => `
                                 CSV parsing error
 
                                 Error(s) from CSV parsing:
@@ -10282,7 +10279,7 @@ const CsvFormatParser = {
                 const { value, settings, mapCallback, onProgress } = options;
                 const csv = csvParse(value, settings);
                 if (csv.errors.length !== 0) {
-                    throw new CsvFormatError(spaceTrim$2((block) => `
+                    throw new CsvFormatError(spaceTrim$1((block) => `
                                 CSV parsing error
 
                                 Error(s) from CSV parsing:
@@ -10468,7 +10465,7 @@ function mapAvailableToExpectedParameters(options) {
     }
     // Phase 2️⃣: Non-matching mapping
     if (expectedParameterNames.size !== availableParametersNames.size) {
-        throw new PipelineExecutionError(spaceTrim$2((block) => `
+        throw new PipelineExecutionError(spaceTrim$1((block) => `
                     Can not map available parameters to expected parameters
 
                     Mapped parameters:
@@ -10883,7 +10880,7 @@ async function executeFormatSubvalues(options) {
         return /* not await */ executeAttempts({ ...options, logLlmCall });
     }
     if (jokerParameterNames.length !== 0) {
-        throw new UnexpectedError(spaceTrim$2((block) => `
+        throw new UnexpectedError(spaceTrim$1((block) => `
                     JOKER parameters are not supported together with FOREACH command
 
                     [🧞‍♀️] This should be prevented in \`validatePipeline\`
@@ -10896,7 +10893,7 @@ async function executeFormatSubvalues(options) {
     if (formatDefinition === undefined) {
         throw new UnexpectedError(
         // <- TODO: [🧠][🧐] Should be formats fixed per promptbook version or behave as plugins (=> change UnexpectedError)
-        spaceTrim$2((block) => `
+        spaceTrim$1((block) => `
                     Unsupported format "${task.foreach.formatName}"
 
                     Available formats:
@@ -10913,7 +10910,7 @@ async function executeFormatSubvalues(options) {
     if (subvalueParser === undefined) {
         throw new UnexpectedError(
         // <- TODO: [🧠][🧐] Should be formats fixed per promptbook version or behave as plugins (=> change UnexpectedError)
-        spaceTrim$2((block) => `
+        spaceTrim$1((block) => `
                     Unsupported subformat name "${task.foreach.subformatName}" for format "${task.foreach.formatName}"
 
                     Available subformat names for format "${formatDefinition.formatName}":
@@ -10953,7 +10950,7 @@ async function executeFormatSubvalues(options) {
                 if (!(error instanceof PipelineExecutionError)) {
                     throw error;
                 }
-                const highLevelError = new PipelineExecutionError(spaceTrim$2((block) => `
+                const highLevelError = new PipelineExecutionError(spaceTrim$1((block) => `
                             ${error.message}
 
                             This is error in FOREACH command when mapping ${formatDefinition.formatName} ${subvalueParser.subvalueName} data (${index + 1}/${length})
@@ -10977,7 +10974,7 @@ async function executeFormatSubvalues(options) {
                     ...options,
                     priority: priority + index,
                     parameters: allSubparameters,
-                    pipelineIdentification: spaceTrim$2((block) => `
+                    pipelineIdentification: spaceTrim$1((block) => `
                             ${block(pipelineIdentification)}
                             Subparameter index: ${index}
                         `),
@@ -10986,7 +10983,7 @@ async function executeFormatSubvalues(options) {
             }
             catch (error) {
                 if (length > BIG_DATASET_TRESHOLD) {
-                    console.error(spaceTrim$2((block) => `
+                    console.error(spaceTrim$1((block) => `
                               ${error.message}
 
                               This is error in FOREACH command when processing ${formatDefinition.formatName} ${subvalueParser.subvalueName} data (${index + 1}/${length})
@@ -12030,7 +12027,7 @@ async function makeKnowledgeSourceHandler(knowledgeSource, tools, options) {
         const fileExtension = getFileExtension(filename);
         const mimeType = extensionToMimeType(fileExtension || '');
         if (!(await isFileExisting(filename, tools.fs))) {
-            throw new NotFoundError(spaceTrim$2((block) => `
+            throw new NotFoundError(spaceTrim$1((block) => `
                           Can not make source handler for file which does not exist:
 
                           File:
@@ -12123,7 +12120,7 @@ async function prepareKnowledgePieces(knowledgeSources, tools, options) {
                     // <- TODO: [🪓] Here should be no need for spreading new array, just `partialPieces = partialPiecesUnchecked`
                     break;
                 }
-                console.warn(spaceTrim$2((block) => `
+                console.warn(spaceTrim$1((block) => `
                             Cannot scrape knowledge from source despite the scraper \`${scraper.metadata.className}\` supports the mime type "${sourceHandler.mimeType}".
 
                             The source:
@@ -12139,7 +12136,7 @@ async function prepareKnowledgePieces(knowledgeSources, tools, options) {
                 // <- TODO: [🏮] Some standard way how to transform errors into warnings and how to handle non-critical fails during the tasks
             }
             if (partialPieces === null) {
-                throw new KnowledgeScrapeError(spaceTrim$2((block) => `
+                throw new KnowledgeScrapeError(spaceTrim$1((block) => `
                             Cannot scrape knowledge
 
                             The source:
@@ -12475,7 +12472,7 @@ const knowledgeCommandParser = {
      */
     parse(input) {
         const { args } = input;
-        const knowledgeSourceContent = spaceTrim$2(args[0] || '');
+        const knowledgeSourceContent = spaceTrim$1(args[0] || '');
         if (knowledgeSourceContent === '') {
             throw new ParseError(`Source is not defined`);
         }
@@ -12619,7 +12616,7 @@ const sectionCommandParser = {
         normalized = normalized.split('DIALOGUE').join('DIALOG');
         const taskTypes = SectionTypes.filter((sectionType) => normalized.includes(sectionType.split('_TASK').join('')));
         if (taskTypes.length !== 1) {
-            throw new ParseError(spaceTrim$2((block) => `
+            throw new ParseError(spaceTrim$1((block) => `
                         Unknown section type "${normalized}"
 
                         Supported section types are:
@@ -12639,7 +12636,7 @@ const sectionCommandParser = {
      */
     $applyToTaskJson(command, $taskJson, $pipelineJson) {
         if ($taskJson.isSectionTypeSet === true) {
-            throw new ParseError(spaceTrim$2(`
+            throw new ParseError(spaceTrim$1(`
                     Section type is already defined in the section.
                     It can be defined only once.
                 `));
@@ -12919,7 +12916,7 @@ const expectCommandParser = {
     /**
      * Description of the FORMAT command
      */
-    description: spaceTrim$2(`
+    description: spaceTrim$1(`
         Expect command describes the desired output of the task *(after post-processing)*
         It can set limits for the maximum/minimum length of the output, measured in characters, words, sentences, paragraphs or some other shape of the output.
     `),
@@ -12993,7 +12990,7 @@ const expectCommandParser = {
         }
         catch (error) {
             assertsError(error);
-            throw new ParseError(spaceTrim$2((block) => `
+            throw new ParseError(spaceTrim$1((block) => `
                             Invalid FORMAT command
                             ${block(error.message)}:
                         `));
@@ -13105,7 +13102,7 @@ function validateParameterName(parameterName) {
         if (!(error instanceof ParseError)) {
             throw error;
         }
-        throw new ParseError(spaceTrim$2((block) => `
+        throw new ParseError(spaceTrim$1((block) => `
                     ${block(error.message)}
 
                     Tried to validate parameter name:
@@ -13164,7 +13161,7 @@ const foreachCommandParser = {
         const assignSign = args[3];
         const formatDefinition = FORMAT_DEFINITIONS.find((formatDefinition) => [formatDefinition.formatName, ...(formatDefinition.aliases || [])].includes(formatName));
         if (formatDefinition === undefined) {
-            throw new ParseError(spaceTrim$2((block) => `
+            throw new ParseError(spaceTrim$1((block) => `
                         Unsupported format "${formatName}"
 
                         Available formats:
@@ -13176,7 +13173,7 @@ const foreachCommandParser = {
         }
         const subvalueParser = formatDefinition.subvalueParsers.find((subvalueParser) => [subvalueParser.subvalueName, ...(subvalueParser.aliases || [])].includes(subformatName));
         if (subvalueParser === undefined) {
-            throw new ParseError(spaceTrim$2((block) => `
+            throw new ParseError(spaceTrim$1((block) => `
                         Unsupported subformat name "${subformatName}" for format "${formatName}"
 
                         Available subformat names for format "${formatDefinition.formatName}":
@@ -13224,7 +13221,7 @@ const foreachCommandParser = {
                 outputSubparameterName = 'newLine';
             }
             else {
-                throw new ParseError(spaceTrim$2(`
+                throw new ParseError(spaceTrim$1(`
                         FOREACH ${formatName} ${subformatName} must specify output subparameter
 
                         Correct example:
@@ -13300,7 +13297,7 @@ const formatCommandParser = {
     /**
      * Description of the FORMAT command
      */
-    description: spaceTrim$2(`
+    description: spaceTrim$1(`
         Format command describes the desired output of the task (after post-processing)
         It can set limits for the maximum/minimum length of the output, measured in characters, words, sentences, paragraphs or some other shape of the output.
     `),
@@ -13672,7 +13669,7 @@ const formfactorCommandParser = {
         const formfactorNameCandidate = args[0].toUpperCase();
         const formfactor = FORMFACTOR_DEFINITIONS.find((definition) => [definition.name, ...{ aliasNames: [], ...definition }.aliasNames].includes(formfactorNameCandidate));
         if (formfactor === undefined) {
-            throw new ParseError(spaceTrim$2((block) => `
+            throw new ParseError(spaceTrim$1((block) => `
                         Unknown formfactor name "${formfactorNameCandidate}"
 
                         Available formfactors:
@@ -13691,7 +13688,7 @@ const formfactorCommandParser = {
      */
     $applyToPipelineJson(command, $pipelineJson) {
         if ($pipelineJson.formfactorName !== undefined && $pipelineJson.formfactorName !== command.formfactorName) {
-            throw new ParseError(spaceTrim$2(`
+            throw new ParseError(spaceTrim$1(`
                     Redefinition of \`FORMFACTOR\` in the pipeline head
 
                     You have used:
@@ -13839,7 +13836,7 @@ const modelCommandParser = {
      */
     parse(input) {
         const { args, normalized } = input;
-        const availableVariantsMessage = spaceTrim$2((block) => `
+        const availableVariantsMessage = spaceTrim$1((block) => `
               Available variants are:
               ${block(MODEL_VARIANTS.map((variantName) => `- ${variantName}${variantName !== 'EMBEDDING' ? '' : ' (Not available in pipeline)'}`).join('\n'))}
           `);
@@ -13861,14 +13858,14 @@ const modelCommandParser = {
                 // <- Note: [🤖]
             }
             else if (normalized.startsWith('MODEL_VARIANT_EMBED')) {
-                spaceTrim$2((block) => `
+                spaceTrim$1((block) => `
                         Embedding model can not be used in pipeline
 
                         ${block(availableVariantsMessage)}
                     `);
             }
             else {
-                throw new ParseError(spaceTrim$2((block) => `
+                throw new ParseError(spaceTrim$1((block) => `
                             Unknown model variant in command:
 
                             ${block(availableVariantsMessage)}
@@ -13883,7 +13880,7 @@ const modelCommandParser = {
             };
         }
         else {
-            throw new ParseError(spaceTrim$2((block) => `
+            throw new ParseError(spaceTrim$1((block) => `
                     Unknown model key in command.
 
                     Supported model keys are:
@@ -13910,7 +13907,7 @@ const modelCommandParser = {
                 // <- TODO: [🏮] Some standard way how to transform errors into warnings and how to handle non-critical fails during the tasks
             }
             else {
-                throw new ParseError(spaceTrim$2(`
+                throw new ParseError(spaceTrim$1(`
                         Redefinition of \`MODEL ${command.key}\` in the pipeline head
 
                         You have used:
@@ -13938,7 +13935,7 @@ const modelCommandParser = {
                 // <- TODO: [🏮] Some standard way how to transform errors into warnings and how to handle non-critical fails during the tasks
             }
             else {
-                throw new ParseError(spaceTrim$2(`
+                throw new ParseError(spaceTrim$1(`
                               Redefinition of MODEL \`${command.key}\` in the task "${$taskJson.title || $taskJson.name}"
 
                               You have used:
@@ -13948,7 +13945,7 @@ const modelCommandParser = {
             }
         }
         if (command.value === ($pipelineJson.defaultModelRequirements || {})[command.key]) {
-            console.log(spaceTrim$2(`
+            console.log(spaceTrim$1(`
                     Setting MODEL \`${command.key}\` in the task "${$taskJson.title || $taskJson.name}" to the same value as in the pipeline head
 
                     In pipeline head:
@@ -14031,7 +14028,7 @@ const parameterCommandParser = {
         // <- TODO: When [🥶] fixed, change to:
         //        >   const parameterDescriptionRaw = rawArgs.split(parameterNameRaw).join('').trim();
         if (parameterDescriptionRaw && parameterDescriptionRaw.match(/\{(?<embeddedParameterName>[a-z0-9_]+)\}/im)) {
-            throw new ParseError(spaceTrim$2((block) => `
+            throw new ParseError(spaceTrim$1((block) => `
                         Parameter \`{${parameterNameRaw}}\` can not contain another parameter in description
 
                         The description:
@@ -14213,7 +14210,7 @@ function $applyToTaskJson(command, $taskJson, $pipelineJson) {
         persona.description = personaDescription;
         return;
     }
-    console.warn(spaceTrim$2(`
+    console.warn(spaceTrim$1(`
 
             Persona "${personaName}" is defined multiple times with different description:
 
@@ -14224,7 +14221,7 @@ function $applyToTaskJson(command, $taskJson, $pipelineJson) {
             ${personaDescription}
 
         `));
-    persona.description += spaceTrim$2('\n\n' + personaDescription);
+    persona.description += spaceTrim$1('\n\n' + personaDescription);
 }
 
 /**
@@ -15065,7 +15062,7 @@ function removeMarkdownComments(content) {
  */
 function isFlatPipeline(pipelineString) {
     pipelineString = removeMarkdownComments(pipelineString);
-    pipelineString = spaceTrim$2(pipelineString);
+    pipelineString = spaceTrim$1(pipelineString);
     const isMarkdownBeginningWithHeadline = pipelineString.startsWith('# ');
     //const isLastLineReturnStatement = pipelineString.split(/\r?\n/).pop()!.split('`').join('').startsWith('->');
     const isBacktickBlockUsed = pipelineString.includes('```');
@@ -15091,7 +15088,7 @@ function deflatePipeline(pipelineString) {
     if (!isFlatPipeline(pipelineString)) {
         return pipelineString;
     }
-    pipelineString = spaceTrim$2(pipelineString);
+    pipelineString = spaceTrim$1(pipelineString);
     const pipelineStringLines = pipelineString.split(/\r?\n/);
     const potentialReturnStatement = pipelineStringLines.pop();
     let returnStatement;
@@ -15104,19 +15101,19 @@ function deflatePipeline(pipelineString) {
         returnStatement = `-> {${DEFAULT_BOOK_OUTPUT_PARAMETER_NAME}}`;
         pipelineStringLines.push(potentialReturnStatement);
     }
-    const prompt = spaceTrim$2(pipelineStringLines.join('\n'));
+    const prompt = spaceTrim$1(pipelineStringLines.join('\n'));
     let quotedPrompt;
     if (prompt.split(/\r?\n/).length <= 1) {
         quotedPrompt = `> ${prompt}`;
     }
     else {
-        quotedPrompt = spaceTrim$2((block) => `
+        quotedPrompt = spaceTrim$1((block) => `
                 \`\`\`
                 ${block(prompt.split('`').join('\\`'))}
                 \`\`\`
             `);
     }
-    pipelineString = validatePipelineString(spaceTrim$2((block) => `
+    pipelineString = validatePipelineString(spaceTrim$1((block) => `
                 # ${DEFAULT_BOOK_TITLE}
 
                 ## Prompt
@@ -15180,7 +15177,7 @@ function extractAllListItemsFromMarkdown(markdown) {
 function extractOneBlockFromMarkdown(markdown) {
     const codeBlocks = extractAllBlocksFromMarkdown(markdown);
     if (codeBlocks.length !== 1) {
-        throw new ParseError(spaceTrim$2((block) => `
+        throw new ParseError(spaceTrim$1((block) => `
                     There should be exactly 1 code block in task section, found ${codeBlocks.length} code blocks
 
                     ${block(codeBlocks.map((block, i) => `Block ${i + 1}:\n${block.content}`).join('\n\n\n'))}
@@ -15205,7 +15202,7 @@ function parseMarkdownSection(value) {
     }
     const title = lines[0].replace(/^#+\s*/, '');
     const level = (_b = (_a = lines[0].match(/^#+/)) === null || _a === void 0 ? void 0 : _a[0].length) !== null && _b !== void 0 ? _b : 0;
-    const content = spaceTrim$2(lines.slice(1).join('\n'));
+    const content = spaceTrim$1(lines.slice(1).join('\n'));
     if (level < 1 || level > 6) {
         throw new ParseError('Markdown section must have heading level between 1 and 6');
     }
@@ -15233,7 +15230,7 @@ function splitMarkdownIntoSections(markdown) {
         if (buffer.length === 0) {
             return;
         }
-        let section = spaceTrim$2(buffer.join('\n'));
+        let section = spaceTrim$1(buffer.join('\n'));
         if (section === '') {
             return;
         }
@@ -15308,7 +15305,7 @@ function flattenMarkdown(markdown) {
         flattenedMarkdown += `## ${title}` + `\n\n`;
         flattenedMarkdown += content + `\n\n`; // <- [🧠] Maybe 3 new lines?
     }
-    return spaceTrim$2(flattenedMarkdown);
+    return spaceTrim$1(flattenedMarkdown);
 }
 /**
  * TODO: [🏛] This can be part of markdown builder
@@ -15959,8 +15956,8 @@ class MarkdownScraper {
         knowledgeTextPieces.map(async (knowledgeTextPiece, i) => {
             // Note: These are just default values, they will be overwritten by the actual values:
             let name = `piece-${i}`;
-            let title = spaceTrim$2(knowledgeTextPiece.substring(0, 100));
-            const knowledgePieceContent = spaceTrim$2(knowledgeTextPiece);
+            let title = spaceTrim$1(knowledgeTextPiece.substring(0, 100));
+            const knowledgePieceContent = spaceTrim$1(knowledgeTextPiece);
             let keywords = [];
             const index = [];
             /*
@@ -15973,7 +15970,7 @@ class MarkdownScraper {
                     isCrashedOnError: true,
                 });
                 const { title: titleRaw = 'Untitled' } = titleResult.outputParameters;
-                title = spaceTrim$2(titleRaw) /* <- TODO: Maybe do in pipeline */;
+                title = spaceTrim$1(titleRaw) /* <- TODO: Maybe do in pipeline */;
                 name = titleToName(title);
                 // --- Keywords
                 const keywordsResult = await prepareKeywordsExecutor({ knowledgePieceContent }).asPromise({
@@ -16326,2071 +16323,61 @@ async function fetchUrlContent(url) {
  */
 
 /**
- * Prompt parameter key used to pass hidden runtime context to tool execution.
- *
- * @private internal runtime wiring for commitment tools
- */
-const TOOL_RUNTIME_CONTEXT_PARAMETER = 'promptbookToolRuntimeContext';
-/**
- * Hidden argument key used to pass runtime context into individual tool calls.
- *
- * @private internal runtime wiring for commitment tools
- */
-const TOOL_RUNTIME_CONTEXT_ARGUMENT = '__promptbookToolRuntimeContext';
-/**
- * Prompt parameter key used to pass a hidden tool-progress listener token into script execution.
- *
- * @private internal runtime wiring for commitment tools
- */
-const TOOL_PROGRESS_TOKEN_PARAMETER = 'promptbookToolProgressToken';
-/**
- * Hidden argument key used to pass a tool-progress listener token into individual tool calls.
- *
- * @private internal runtime wiring for commitment tools
- */
-const TOOL_PROGRESS_TOKEN_ARGUMENT = '__promptbookToolProgressToken';
-/**
- * Monotonic counter used for hidden progress-listener tokens.
- *
- * @private internal runtime wiring for commitment tools
- */
-let toolCallProgressListenerCounter = 0;
-/**
- * Active tool-progress listeners keyed by hidden execution token.
- *
- * @private internal runtime wiring for commitment tools
- */
-const toolCallProgressListeners = new Map();
-/**
- * Parses unknown runtime context payload into a normalized object.
- *
- * @private internal runtime wiring for commitment tools
- */
-function parseToolRuntimeContext(rawValue) {
-    if (!rawValue) {
-        return null;
-    }
-    let parsed = rawValue;
-    if (typeof rawValue === 'string') {
-        try {
-            parsed = JSON.parse(rawValue);
-        }
-        catch (_a) {
-            return null;
-        }
-    }
-    if (!parsed || typeof parsed !== 'object') {
-        return null;
-    }
-    return parsed;
-}
-/**
- * Reads runtime context attached to tool call arguments.
- *
- * @private internal runtime wiring for commitment tools
- */
-function readToolRuntimeContextFromToolArgs(args) {
-    return parseToolRuntimeContext(args[TOOL_RUNTIME_CONTEXT_ARGUMENT]);
-}
-/**
- * Reads the hidden tool-progress token from tool arguments.
- *
- * @private internal runtime wiring for commitment tools
- */
-function readToolProgressTokenFromToolArgs(args) {
-    const token = args[TOOL_PROGRESS_TOKEN_ARGUMENT];
-    return typeof token === 'string' && token.trim().length > 0 ? token : null;
-}
-/**
- * Serializes runtime context for prompt parameters.
- *
- * @private internal runtime wiring for commitment tools
- */
-function serializeToolRuntimeContext(context) {
-    return JSON.stringify(context);
-}
-/**
- * Registers one in-memory listener that receives progress updates emitted by a running tool.
- *
- * The returned token is passed into script execution as a hidden argument so tool implementations
- * can stream progress without exposing extra parameters to the model.
- *
- * @param listener - Listener notified about tool progress.
- * @returns Hidden token used to route progress updates.
- * @private internal runtime wiring for commitment tools
- */
-function registerToolCallProgressListener(listener) {
-    toolCallProgressListenerCounter += 1;
-    const token = `tool-progress:${Date.now()}:${toolCallProgressListenerCounter}`;
-    toolCallProgressListeners.set(token, listener);
-    return token;
-}
-/**
- * Unregisters one in-memory progress listener.
- *
- * @param token - Token previously created by `registerToolCallProgressListener`.
- * @private internal runtime wiring for commitment tools
- */
-function unregisterToolCallProgressListener(token) {
-    toolCallProgressListeners.delete(token);
-}
-/**
- * Emits one tool progress update using a hidden token carried in tool arguments.
- *
- * @param args - Raw tool arguments including hidden runtime keys.
- * @param update - Incremental progress update.
- * @returns `true` when a listener was found and notified.
- * @private internal runtime wiring for commitment tools
- */
-function emitToolCallProgressFromToolArgs(args, update) {
-    const token = readToolProgressTokenFromToolArgs(args);
-    if (!token) {
-        return false;
-    }
-    const listener = toolCallProgressListeners.get(token);
-    if (!listener) {
-        return false;
-    }
-    listener(update);
-    return true;
-}
-/**
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */
-
-/**
- * Logical public directory marker used in `run_browser` payload paths.
+ * Cached implementation of `run_browser` when it can be resolved.
  *
- * This value is kept stable for UI parsing and `/api/browser-artifacts/*` URL mapping.
- */
-const RUN_BROWSER_ARTIFACT_PUBLIC_DIRECTORY = '.playwright-cli';
-/**
- * Runtime environment variable that overrides local artifact storage directory.
- */
-const RUN_BROWSER_ARTIFACT_STORAGE_DIRECTORY_ENV = 'RUN_BROWSER_ARTIFACT_STORAGE_DIRECTORY';
-/**
- * Default writable directory for `run_browser` screenshot/video artifacts.
- */
-const DEFAULT_RUN_BROWSER_ARTIFACT_STORAGE_DIRECTORY = join(tmpdir(), 'promptbook', 'run-browser-artifacts');
-/**
- * Converts Windows separators to POSIX separators for payload paths.
- */
-function toPosixPath$1(pathname) {
-    return pathname.split('\\').join('/');
-}
-/**
- * Resolves writable filesystem directory used for artifact persistence.
- */
-function resolveRunBrowserArtifactStorageDirectory() {
-    const configuredStorageDirectory = process.env[RUN_BROWSER_ARTIFACT_STORAGE_DIRECTORY_ENV];
-    if (configuredStorageDirectory && configuredStorageDirectory.trim()) {
-        return configuredStorageDirectory.trim();
-    }
-    return DEFAULT_RUN_BROWSER_ARTIFACT_STORAGE_DIRECTORY;
-}
-/**
- * Resolves absolute filesystem path of one artifact filename.
- */
-function resolveRunBrowserArtifactFilesystemPath(artifactFilename) {
-    return join(resolveRunBrowserArtifactStorageDirectory(), artifactFilename);
-}
-/**
- * Resolves payload path of one artifact filename used by replay renderers.
- */
-function resolveRunBrowserArtifactPublicPath(artifactFilename) {
-    return toPosixPath$1(`${RUN_BROWSER_ARTIFACT_PUBLIC_DIRECTORY}/${artifactFilename}`);
-}
-
-/**
- * Error code used for remote-browser infrastructure outages.
- */
-const REMOTE_BROWSER_UNAVAILABLE_ERROR_CODE = 'REMOTE_BROWSER_UNAVAILABLE';
-/**
- * Error thrown when a remote Playwright browser cannot be reached.
- */
-class RemoteBrowserUnavailableError extends KnowledgeScrapeError {
-    constructor(options) {
-        var _a;
-        super(options.message);
-        this.code = REMOTE_BROWSER_UNAVAILABLE_ERROR_CODE;
-        this.isRetryable = true;
-        this.debug = options.debug;
-        this.suggestedNextSteps =
-            (_a = options.suggestedNextSteps) !== null && _a !== void 0 ? _a : [
-                'Verify remote browser infrastructure is running and reachable from Agents Server.',
-                'Check firewall and DNS routing for the remote browser host and port.',
-                'Retry later or continue with non-graphical fallback scraping.',
-            ];
-        this.cause = options.cause;
-        Object.setPrototypeOf(this, RemoteBrowserUnavailableError.prototype);
-    }
-}
-/**
- * Returns true when an unknown value is one of the remote-browser outage errors.
- */
-function isRemoteBrowserUnavailableError(error) {
-    return error instanceof RemoteBrowserUnavailableError;
-}
-/**
- * Sanitizes a remote websocket endpoint so debug payloads never expose path secrets.
- */
-function sanitizeRemoteBrowserEndpoint(wsEndpoint) {
-    var _a, _b;
-    try {
-        const parsedEndpoint = new URL(wsEndpoint);
-        return {
-            protocol: parsedEndpoint.protocol || null,
-            host: parsedEndpoint.hostname || null,
-            port: parsedEndpoint.port ? Number.parseInt(parsedEndpoint.port, 10) : null,
-        };
-    }
-    catch (_c) {
-        const hostPortMatch = wsEndpoint.trim().match(/^(?:wss?:\/\/)?(?<host>[^:/?#]+)(?::(?<port>\d{1,5}))?/i);
-        const host = ((_a = hostPortMatch === null || hostPortMatch === void 0 ? void 0 : hostPortMatch.groups) === null || _a === void 0 ? void 0 : _a.host) || null;
-        const parsedPort = (_b = hostPortMatch === null || hostPortMatch === void 0 ? void 0 : hostPortMatch.groups) === null || _b === void 0 ? void 0 : _b.port;
-        return {
-            protocol: wsEndpoint.startsWith('wss://') ? 'wss:' : wsEndpoint.startsWith('ws://') ? 'ws:' : null,
-            host,
-            port: parsedPort ? Number.parseInt(parsedPort, 10) : null,
-        };
-    }
-}
-/**
- * Extracts network-like error code from unknown error payload.
- */
-function extractNetworkErrorCode(error) {
-    var _a;
-    if (error && typeof error === 'object') {
-        const maybeCode = error.code;
-        if (typeof maybeCode === 'string' && maybeCode.trim()) {
-            return maybeCode.trim().toUpperCase();
-        }
-    }
-    const message = getErrorMessage(error);
-    const match = message.match(/\b(ECONNREFUSED|ETIMEDOUT|ENOTFOUND|EAI_AGAIN|ECONNRESET|EHOSTUNREACH|ENETUNREACH)\b/i);
-    return ((_a = match === null || match === void 0 ? void 0 : match[1]) === null || _a === void 0 ? void 0 : _a.toUpperCase()) || null;
-}
-/**
- * Classifies whether an unknown error most likely represents remote browser infra outage.
- */
-function isRemoteBrowserInfrastructureError(error) {
-    const networkErrorCode = extractNetworkErrorCode(error);
-    if (networkErrorCode) {
-        return true;
-    }
-    const message = getErrorMessage(error).toLowerCase();
-    const isWebSocketFailure = message.includes('websocket') ||
-        message.includes('<ws error>') ||
-        message.includes('ws connect error') ||
-        message.includes('socket hang up');
-    const hasHandshakeFailure = message.includes('unexpected server response') ||
-        message.includes('handshake') ||
-        message.includes('code=1006') ||
-        message.includes('disconnected');
-    return isWebSocketFailure && hasHandshakeFailure;
-}
-/**
- * Converts unknown thrown values into safe string messages.
- */
-function getErrorMessage(error) {
-    return error instanceof Error ? error.message : String(error);
-}
-/**
- * Converts unknown errors into stack payloads that are safe to render in debug mode.
- */
-function getErrorStack(error) {
-    return error instanceof Error && error.stack ? error.stack : null;
-}
-
-/**
- * Matches unsupported characters in snapshot file suffixes.
- */
-const SNAPSHOT_FILE_SUFFIX_UNSAFE_CHARACTER_PATTERN = /[^a-z0-9-]/g;
-/**
- * Creates one filesystem-safe optional filename suffix for a snapshot.
- */
-function createSnapshotFileSuffix(rawSuffix) {
-    if (!rawSuffix) {
-        return '';
-    }
-    const normalized = rawSuffix
-        .trim()
-        .toLowerCase()
-        .replace(/\s+/g, '-')
-        .replace(SNAPSHOT_FILE_SUFFIX_UNSAFE_CHARACTER_PATTERN, '-')
-        .replace(/-+/g, '-')
-        .replace(/^-|-$/g, '');
-    return normalized;
-}
-/**
- * Resolves snapshot filename for one session and optional stage suffix.
- */
-function resolveSnapshotFilename(sessionId, fileSuffix) {
-    const safeSuffix = createSnapshotFileSuffix(fileSuffix);
-    return safeSuffix ? `${sessionId}-${safeSuffix}.png` : `${sessionId}.png`;
-}
-/**
- * Creates one user-facing description for an executed browser action.
- */
-function formatActionSummary(action) {
-    switch (action.type) {
-        case 'navigate':
-            return `Navigate to ${action.url}`;
-        case 'click':
-            return `Click ${action.selector}`;
-        case 'type':
-            return `Type into ${action.selector}`;
-        case 'wait':
-            return `Wait ${action.milliseconds}ms`;
-        case 'scroll':
-            return action.selector ? `Scroll ${action.pixels}px in ${action.selector}` : `Scroll ${action.pixels}px on page`;
-    }
-}
-/**
- * Screenshot/artifact and page-cleanup helpers for `run_browser`.
- *
- * @private function of `run_browser`
- */
-const runBrowserArtifacts = {
-    /**
-     * Captures a screenshot artifact for the current page and returns relative path.
-     */
-    async captureSnapshot(page, sessionId, fileSuffix) {
-        const snapshotFilename = resolveSnapshotFilename(sessionId, fileSuffix);
-        const snapshotDirectoryPath = resolveRunBrowserArtifactStorageDirectory();
-        const snapshotPath = resolveRunBrowserArtifactFilesystemPath(snapshotFilename);
-        try {
-            await mkdir(snapshotDirectoryPath, { recursive: true });
-            try {
-                await page.screenshot({ path: snapshotPath, fullPage: true });
-            }
-            catch (error) {
-                console.warn('[run_browser] Full-page snapshot failed, retrying viewport-only screenshot', {
-                    sessionId,
-                    snapshotFilename,
-                    error: getErrorMessage(error),
-                });
-                await page.screenshot({ path: snapshotPath, fullPage: false });
-            }
-            return resolveRunBrowserArtifactPublicPath(snapshotFilename);
-        }
-        catch (error) {
-            console.error('[run_browser] Failed to capture snapshot', {
-                sessionId,
-                snapshotFilename,
-                error: getErrorMessage(error),
-            });
-            return null;
-        }
-    },
-    /**
-     * Safely retrieves page title from current browser page.
-     */
-    async getPageTitle(page) {
-        try {
-            return await page.title();
-        }
-        catch (_a) {
-            return null;
-        }
-    },
-    /**
-     * Closes browser page and logs non-fatal cleanup errors.
-     */
-    async cleanupPage(page, sessionId) {
-        if (!page) {
-            return;
-        }
-        try {
-            await page.close();
-        }
-        catch (error) {
-            console.error('[run_browser] Failed to cleanup browser page', {
-                sessionId,
-                error: getErrorMessage(error),
-            });
-        }
-    },
-    /**
-     * Captures one screenshot artifact and enriches it with page metadata.
-     */
-    async captureSnapshotArtifact(options) {
-        const { page, sessionId, label, fileSuffix, actionIndex, action } = options;
-        const path = await this.captureSnapshot(page, sessionId, fileSuffix);
-        if (!path) {
-            return null;
-        }
-        const actionSummary = action ? formatActionSummary(action) : undefined;
-        return {
-            kind: 'screenshot',
-            label,
-            path,
-            capturedAt: new Date().toISOString(),
-            url: page.url(),
-            title: await this.getPageTitle(page),
-            actionIndex,
-            actionSummary,
-        };
-    },
-};
-
-/**
- * Shared constants used by the `run_browser` tool.
- *
- * @private internal constants of `run_browser`
- */
-const runBrowserConstants = {
-    sessionPrefix: 'agents-server-run-browser',
-    snapshotDirectory: '.playwright-cli',
-    resultSchema: 'promptbook/run-browser@1',
-    defaultWaitMs: 1000,
-    maxWaitMs: 60000,
-    defaultScrollPixels: 800,
-    defaultNavigationTimeoutMs: 20000,
-    defaultActionTimeoutMs: 15000,
-    fallbackDynamicContentWarning: 'Remote browser is unavailable. Fallback scraping was used and dynamic content may be missing.',
-    validationErrorCode: 'RUN_BROWSER_VALIDATION_ERROR',
-    navigationFailedErrorCode: 'RUN_BROWSER_NAVIGATION_FAILED',
-    actionFailedErrorCode: 'RUN_BROWSER_ACTION_FAILED',
-    cancelledErrorCode: 'RUN_BROWSER_CANCELLED',
-    unknownErrorCode: 'RUN_BROWSER_UNKNOWN_ERROR',
-};
-
-const config = ConfigChecker.from({
-    ...process.env,
-    // Note: To expose env variables to the browser, using this seemingly strange syntax:
-    //       @see https://nextjs.org/docs/pages/building-your-application/configuring/environment-variables#exposing-environment-variables-to-the-browser
-    NEXT_PUBLIC_SITE_URL: process.env.NEXT_PUBLIC_SITE_URL,
-    NEXT_PUBLIC_VERCEL_ENV: process.env.NEXT_PUBLIC_VERCEL_ENV,
-    NEXT_PUBLIC_VERCEL_TARGET_ENV: process.env.NEXT_PUBLIC_VERCEL_TARGET_ENV,
-    NEXT_PUBLIC_VERCEL_URL: process.env.NEXT_PUBLIC_VERCEL_URL,
-    NEXT_PUBLIC_VERCEL_BRANCH_URL: process.env.NEXT_PUBLIC_VERCEL_BRANCH_URL,
-    NEXT_PUBLIC_VERCEL_PROJECT_PRODUCTION_URL: process.env.NEXT_PUBLIC_VERCEL_PROJECT_PRODUCTION_URL,
-    NEXT_PUBLIC_VERCEL_GIT_PROVIDER: process.env.NEXT_PUBLIC_VERCEL_GIT_PROVIDER,
-    NEXT_PUBLIC_VERCEL_GIT_REPO_OWNER: process.env.NEXT_PUBLIC_VERCEL_GIT_REPO_OWNER,
-    NEXT_PUBLIC_VERCEL_GIT_REPO_SLUG: process.env.NEXT_PUBLIC_VERCEL_GIT_REPO_SLUG,
-    NEXT_PUBLIC_VERCEL_GIT_REPO_ID: process.env.NEXT_PUBLIC_VERCEL_GIT_REPO_ID,
-    NEXT_PUBLIC_VERCEL_GIT_COMMIT_SHA: process.env.NEXT_PUBLIC_VERCEL_GIT_COMMIT_SHA,
-    NEXT_PUBLIC_VERCEL_GIT_COMMIT_MESSAGE: process.env.NEXT_PUBLIC_VERCEL_GIT_COMMIT_MESSAGE,
-    NEXT_PUBLIC_VERCEL_GIT_COMMIT_REF: process.env.NEXT_PUBLIC_VERCEL_GIT_COMMIT_REF,
-    NEXT_PUBLIC_VERCEL_GIT_COMMIT_AUTHOR_NAME: process.env.NEXT_PUBLIC_VERCEL_GIT_COMMIT_AUTHOR_NAME,
-    NEXT_PUBLIC_VERCEL_GIT_COMMIT_AUTHOR_LOGIN: process.env.NEXT_PUBLIC_VERCEL_GIT_COMMIT_AUTHOR_LOGIN,
-    NEXT_PUBLIC_VERCEL_GIT_PREVIOUS_SHA: process.env.NEXT_PUBLIC_VERCEL_GIT_PREVIOUS_SHA,
-    NEXT_PUBLIC_VERCEL_GIT_PULL_REQUEST_ID: process.env.NEXT_PUBLIC_VERCEL_GIT_PULL_REQUEST_ID,
-});
-/**
- * Public URL of the deployment, e.g. "https://my-app.vercel.app"
- *
- * Note: When a request resolves through the global `_Server` registry,
- * this URL will be overridden by the matched server domain.
- */
-config.get('NEXT_PUBLIC_SITE_URL').url().value;
-/**
- * [♐️] Vercel environment: "development" | "preview" | "production"
- */
-config.get('NEXT_PUBLIC_VERCEL_ENV').value;
-/**
- * [♐️] Target environment – can be system or custom
- */
-config.get('NEXT_PUBLIC_VERCEL_TARGET_ENV').value;
-/**
- * [♐️] Deployment URL (without https://), e.g. "my-app-abc123.vercel.app"
- */
-config.get('NEXT_PUBLIC_VERCEL_URL').value;
-/**
- * [♐️] Branch URL (without https://), only for branch deployments
- */
-config.get('NEXT_PUBLIC_VERCEL_BRANCH_URL').value;
-/**
- * [♐️] Production domain of the project
- */
-config.get('NEXT_PUBLIC_VERCEL_PROJECT_PRODUCTION_URL').value;
-/**
- * [♐️] Git provider (github | gitlab | bitbucket)
- */
-config.get('NEXT_PUBLIC_VERCEL_GIT_PROVIDER').value;
-/**
- * [♐️] Repository owner (e.g. "hejny")
- */
-config.get('NEXT_PUBLIC_VERCEL_GIT_REPO_OWNER').value;
-/**
- * [♐️] Repository slug (e.g. "my-project")
- */
-config.get('NEXT_PUBLIC_VERCEL_GIT_REPO_SLUG').value;
-/**
- * [♐️] Repository internal ID
- */
-config.get('NEXT_PUBLIC_VERCEL_GIT_REPO_ID').value;
-/**
- * [♐️] Git commit SHA (short or long)
- */
-config.get('NEXT_PUBLIC_VERCEL_GIT_COMMIT_SHA').value;
-/**
- * [♐️] Commit message used for this deployment
- */
-config.get('NEXT_PUBLIC_VERCEL_GIT_COMMIT_MESSAGE').value;
-/**
- * [♐️] Branch name (ref), e.g. "main"
- */
-config.get('NEXT_PUBLIC_VERCEL_GIT_COMMIT_REF').value;
-/**
- * Author name of the commit
- */
-config.get('NEXT_PUBLIC_VERCEL_GIT_COMMIT_AUTHOR_NAME').value;
-/**
- * [♐️] Author login/username
- */
-config.get('NEXT_PUBLIC_VERCEL_GIT_COMMIT_AUTHOR_LOGIN').value;
-/**
- * [♐️] Previous deployment commit SHA (if exists)
- */
-config.get('NEXT_PUBLIC_VERCEL_GIT_PREVIOUS_SHA').value;
-/**
- * [♐️] Pull Request ID for PR-based deployments
- */
-config.get('NEXT_PUBLIC_VERCEL_GIT_PULL_REQUEST_ID').value;
-/**
- * Supabase table prefix
- *
- * This remains the fallback/default prefix used before `_Server` contains records
- * or for local development requests.
- */
-config.get('SUPABASE_TABLE_PREFIX').value;
-/**
- * WebSocket endpoint URL for remote Playwright browser server (e.g., ws://browser-server:3000).
- *
- * When set, browser automation will connect to this remote server instead of launching a local browser.
- * This is useful for environments like Vercel where running a full browser locally is not possible.
- * Leave empty to use local browser mode.
- */
-const rawRemoteBrowserUrl = config.get('REMOTE_BROWSER_URL').value;
-/**
- * WebSocket endpoint URL for remote Playwright browser server (e.g., ws://browser-server:3000).
- *
- * When set, browser automation will connect to this remote server instead of launching a local browser.
- * This is useful for environments like Vercel where running a full browser locally is not possible.
- * Leave empty to use local browser mode.
- */
-const REMOTE_BROWSER_URL = typeof rawRemoteBrowserUrl === 'string' ? rawRemoteBrowserUrl : '';
-
-/**
- * Reads a positive integer value from environment variables.
- */
-function resolvePositiveIntFromEnv$1(variableName, defaultValue) {
-    const rawValue = process.env[variableName];
-    if (!rawValue || !rawValue.trim()) {
-        return defaultValue;
-    }
-    const parsed = Number.parseInt(rawValue.trim(), 10);
-    if (!Number.isFinite(parsed) || parsed <= 0) {
-        return defaultValue;
-    }
-    return parsed;
-}
-/**
- * Runtime helpers for mode/session/timeout handling in `run_browser`.
- *
- * @private function of `run_browser`
- */
-const runBrowserRuntime = {
-    /**
-     * Creates a dedicated session id for one tool invocation.
-     */
-    createRunBrowserSessionId() {
-        return `${runBrowserConstants.sessionPrefix}-${randomUUID()}`;
-    },
-    /**
-     * Determines whether the browser tool is running in local or remote mode.
-     */
-    resolveExecutionMode() {
-        return REMOTE_BROWSER_URL && REMOTE_BROWSER_URL.trim().length > 0 ? 'remote' : 'local';
-    },
-    /**
-     * Converts the execution mode into a human-readable label.
-     */
-    formatExecutionMode(mode) {
-        return mode === 'remote' ? 'remote-browser' : 'local-browser';
-    },
-    /**
-     * Resolves timeout configuration from env defaults and optional call overrides.
-     */
-    resolveTimeoutConfiguration(overrides) {
-        const envNavigationTimeoutMs = resolvePositiveIntFromEnv$1('RUN_BROWSER_NAVIGATION_TIMEOUT_MS', runBrowserConstants.defaultNavigationTimeoutMs);
-        const envActionTimeoutMs = resolvePositiveIntFromEnv$1('RUN_BROWSER_ACTION_TIMEOUT_MS', runBrowserConstants.defaultActionTimeoutMs);
-        const navigationTimeoutMs = (overrides === null || overrides === void 0 ? void 0 : overrides.navigationMs) && Number.isFinite(overrides.navigationMs) && overrides.navigationMs > 0
-            ? Math.floor(overrides.navigationMs)
-            : envNavigationTimeoutMs;
-        const actionTimeoutMs = (overrides === null || overrides === void 0 ? void 0 : overrides.actionMs) && Number.isFinite(overrides.actionMs) && overrides.actionMs > 0
-            ? Math.floor(overrides.actionMs)
-            : envActionTimeoutMs;
-        return {
-            navigationTimeoutMs,
-            actionTimeoutMs,
-        };
-    },
-};
-
-/**
- * Error classification and cancellation helpers used by `run_browser`.
- *
- * @private function of `run_browser`
- */
-const runBrowserErrorHandling = {
-    /**
-     * Creates one tagged ParseError used for deterministic input validation failures.
-     */
-    createRunBrowserValidationError(options) {
-        const error = new ParseError(options.message);
-        error.name = 'RunBrowserValidationError';
-        error.runBrowserCode = runBrowserConstants.validationErrorCode;
-        error.isRetryable = false;
-        error.suggestedNextSteps = [
-            'Fix the action payload to match the run_browser schema.',
-            'Check selectors and required action fields before retrying.',
-        ];
-        error.debug = options.debug;
-        return error;
-    },
-    /**
-     * Creates one tagged KnowledgeScrapeError used for navigation failures.
-     */
-    createRunBrowserNavigationError(options) {
-        const error = new KnowledgeScrapeError(options.message);
-        error.name = 'RunBrowserNavigationError';
-        error.runBrowserCode = runBrowserConstants.navigationFailedErrorCode;
-        error.isRetryable = false;
-        error.suggestedNextSteps = [
-            'Verify the URL is reachable and not blocked.',
-            'Retry with a simpler action sequence.',
-        ];
-        error.debug = options.debug;
-        error.cause = options.cause;
-        return error;
-    },
-    /**
-     * Creates one tagged KnowledgeScrapeError used for action failures.
-     */
-    createRunBrowserActionError(options) {
-        const error = new KnowledgeScrapeError(options.message);
-        error.name = 'RunBrowserActionError';
-        error.runBrowserCode = runBrowserConstants.actionFailedErrorCode;
-        error.isRetryable = false;
-        error.suggestedNextSteps = [
-            'Verify selectors and action values.',
-            'Reduce the action sequence to isolate the failing step.',
-        ];
-        error.debug = options.debug;
-        error.cause = options.cause;
-        return error;
-    },
-    /**
-     * Creates one tagged KnowledgeScrapeError used for cancellation.
-     */
-    createRunBrowserCancelledError(options) {
-        const error = new KnowledgeScrapeError(options.message);
-        error.name = 'RunBrowserCancelledError';
-        error.runBrowserCode = runBrowserConstants.cancelledErrorCode;
-        error.isRetryable = true;
-        error.suggestedNextSteps = [
-            'Retry while request context is still active.',
-            'Increase timeout if operation is expected to run longer.',
-        ];
-        error.debug = options.debug;
-        error.cause = options.cause;
-        return error;
-    },
-    /**
-     * Checks whether an unknown error carries run_browser classification tags.
-     */
-    isTaggedRunBrowserError(error) {
-        if (!error || typeof error !== 'object') {
-            return false;
-        }
-        const candidate = error;
-        return (typeof candidate.runBrowserCode === 'string' &&
-            typeof candidate.isRetryable === 'boolean' &&
-            Array.isArray(candidate.suggestedNextSteps) &&
-            typeof candidate.debug === 'object' &&
-            candidate.debug !== null);
-    },
-    /**
-     * Converts unknown errors into structured tool error payloads.
-     */
-    classifyRunBrowserToolError(options) {
-        if (isRemoteBrowserUnavailableError(options.error)) {
-            return {
-                code: options.error.code,
-                message: options.error.message,
-                isRetryable: options.error.isRetryable,
-                suggestedNextSteps: options.error.suggestedNextSteps,
-                debug: {
-                    ...options.error.debug,
-                    sessionId: options.sessionId,
-                    mode: runBrowserRuntime.formatExecutionMode(options.mode),
-                },
-            };
-        }
-        if (this.isTaggedRunBrowserError(options.error)) {
-            return {
-                code: options.error.runBrowserCode,
-                message: options.error.message,
-                isRetryable: options.error.isRetryable,
-                suggestedNextSteps: options.error.suggestedNextSteps,
-                debug: {
-                    ...options.error.debug,
-                    sessionId: options.sessionId,
-                    mode: runBrowserRuntime.formatExecutionMode(options.mode),
-                },
-            };
-        }
-        const remoteBrowserEndpoint = REMOTE_BROWSER_URL && REMOTE_BROWSER_URL.trim().length > 0
-            ? sanitizeRemoteBrowserEndpoint(REMOTE_BROWSER_URL.trim())
-            : null;
-        const message = getErrorMessage(options.error);
-        return {
-            code: runBrowserConstants.unknownErrorCode,
-            message,
-            isRetryable: false,
-            suggestedNextSteps: ['Inspect debug details to identify the failing phase.', 'Retry with fewer actions.'],
-            debug: {
-                sessionId: options.sessionId,
-                mode: runBrowserRuntime.formatExecutionMode(options.mode),
-                remoteBrowserEndpoint,
-                message,
-                stack: getErrorStack(options.error),
-            },
-        };
-    },
-    /**
-     * Asserts that the run was not aborted.
-     */
-    assertNotAborted(signal, sessionId) {
-        if (!(signal === null || signal === void 0 ? void 0 : signal.aborted)) {
-            return;
-        }
-        throw this.createRunBrowserCancelledError({
-            message: 'run_browser execution was cancelled.',
-            debug: { sessionId },
-        });
-    },
-    /**
-     * Returns true when the tool error represents remote browser unavailability.
-     */
-    isRemoteBrowserUnavailableCode(code) {
-        return code === REMOTE_BROWSER_UNAVAILABLE_ERROR_CODE;
-    },
-};
-
-/**
- * In-memory observability counters for browser tool execution.
- */
-const RUN_BROWSER_OBSERVABILITY = {
-    totalRuns: 0,
-    fallbackRuns: 0,
-    errorCodeCounts: {},
-};
-/**
- * Observability counters and metric logging for `run_browser`.
- *
- * @private function of `run_browser`
- */
-const runBrowserObservability = {
-    /**
-     * Increments total-run counter and returns the updated value.
-     */
-    incrementTotalRuns() {
-        RUN_BROWSER_OBSERVABILITY.totalRuns++;
-        return RUN_BROWSER_OBSERVABILITY.totalRuns;
-    },
-    /**
-     * Returns current total run count.
-     */
-    getTotalRuns() {
-        return RUN_BROWSER_OBSERVABILITY.totalRuns;
-    },
-    /**
-     * Increments fallback counter and returns updated metrics.
-     */
-    incrementFallbackRunsAndGetMetrics() {
-        RUN_BROWSER_OBSERVABILITY.fallbackRuns++;
-        return {
-            fallbackRuns: RUN_BROWSER_OBSERVABILITY.fallbackRuns,
-            fallbackRate: RUN_BROWSER_OBSERVABILITY.totalRuns === 0
-                ? 0
-                : RUN_BROWSER_OBSERVABILITY.fallbackRuns / RUN_BROWSER_OBSERVABILITY.totalRuns,
-        };
-    },
-    /**
-     * Increments one error-code counter and returns the updated value.
-     */
-    incrementRunBrowserErrorCodeCounter(code) {
-        const currentValue = RUN_BROWSER_OBSERVABILITY.errorCodeCounts[code] || 0;
-        const nextValue = currentValue + 1;
-        RUN_BROWSER_OBSERVABILITY.errorCodeCounts[code] = nextValue;
-        return nextValue;
-    },
-    /**
-     * Writes one structured metric line for browser-tool observability.
-     */
-    logRunBrowserMetric(options) {
-        console.info('[run_browser][metric]', {
-            tool: 'run_browser',
-            mode: options.mode,
-            sessionId: options.sessionId,
-            event: options.event,
-            ...(options.payload || {}),
-        });
-    },
-};
-
-/**
- * Computes one compact preview of a fallback scrape payload.
- */
-function createContentPreview(content) {
-    const normalized = content.replace(/\s+/g, ' ').trim();
-    if (normalized.length <= 280) {
-        return normalized;
-    }
-    return `${normalized.slice(0, 277)}...`;
-}
-/**
- * Payload and markdown formatters for `run_browser` outcomes.
- *
- * @private function of `run_browser`
- */
-const runBrowserResultFormatting = {
-    /**
-     * Produces one structured payload consumed by chat UI browser replay renderers.
-     */
-    createResultPayload(options) {
-        return {
-            schema: runBrowserConstants.resultSchema,
-            sessionId: options.sessionId,
-            mode: options.mode,
-            modeUsed: options.modeUsed,
-            initialUrl: options.initialUrl,
-            finalUrl: options.finalUrl,
-            finalTitle: options.finalTitle,
-            executedActions: options.executedActions,
-            artifacts: options.artifacts,
-            warning: options.warning,
-            error: options.error,
-            fallback: options.modeUsed === 'fallback' && options.fallbackContent !== null
-                ? {
-                    scraper: 'fetch_url_content',
-                    contentPreview: createContentPreview(options.fallbackContent),
-                }
-                : null,
-            timing: options.timing,
-        };
-    },
-    /**
-     * Produces a model-friendly markdown summary from browser execution artifacts.
-     */
-    formatSuccessResult(options) {
-        const { payload, snapshotPath } = options;
-        return spaceTrim$1((block) => {
-            var _a, _b, _c;
-            return `
-                # Browser run completed
-
-                **Session:** ${payload.sessionId}
-                **Mode requested:** ${runBrowserRuntime.formatExecutionMode(payload.mode)}
-                **Mode used:** ${payload.modeUsed}
-                **Initial URL:** ${payload.initialUrl}
-                **Executed actions:** ${payload.executedActions.length}
-
-                ## Final page
-
-                - URL: ${payload.finalUrl || 'Unknown'}
-                - Title: ${payload.finalTitle || 'Unknown'}
-
-                ## Timings
-
-                - Connect: ${(_a = payload.timing.connectDurationMs) !== null && _a !== void 0 ? _a : 'Unknown'} ms
-                - Initial navigation: ${(_b = payload.timing.initialNavigationDurationMs) !== null && _b !== void 0 ? _b : 'Unknown'} ms
-                - Time to first byte: ${(_c = payload.timing.timeToFirstByteMs) !== null && _c !== void 0 ? _c : 'Unknown'} ms
-                - Total: ${payload.timing.totalDurationMs} ms
-
-                ${payload.artifacts.length === 0
-                ? ''
-                : `
-                        ## Visual replay
-
-                        ${payload.artifacts
-                    .map((artifact, index) => {
-                    const actionPart = artifact.actionSummary ? ` (${artifact.actionSummary})` : '';
-                    return `- ${index + 1}. ${artifact.label}${actionPart}: ${artifact.path}`;
-                })
-                    .join('\n')}
-                    `}
-
-                ${!snapshotPath
-                ? ''
-                : `
-                        ## Final snapshot
-
-                        ${snapshotPath}
-                    `}
-
-                ## Playback payload
-
-                \`\`\`json
-                ${JSON.stringify(payload, null, 2)}
-                \`\`\`
-
-                ${block(payload.executedActions.length === 0
-                ? ''
-                : `
-                        ## Action log
-
-                        ${payload.executedActions
-                    .map((action, index) => `- ${index + 1}. ${JSON.stringify(action)}`)
-                    .join('\n')}
-                    `)}
-
-                Note: Browser page has been automatically closed to free up resources.
-            `;
-        });
-    },
-    /**
-     * Produces a model-friendly markdown payload when fallback scraping is used.
-     */
-    formatFallbackResult(options) {
-        const { payload, fallbackContent, requestedActions } = options;
-        return spaceTrim$1(`
-            # Browser run completed with fallback
-
-            **Session:** ${payload.sessionId}
-            **Mode requested:** ${runBrowserRuntime.formatExecutionMode(payload.mode)}
-            **Mode used:** ${payload.modeUsed}
-            **Initial URL:** ${payload.initialUrl}
-            **Requested actions:** ${requestedActions}
-            **Executed actions:** ${payload.executedActions.length}
-            **Warning:** ${payload.warning || runBrowserConstants.fallbackDynamicContentWarning}
-
-            ## Extracted content
-
-            ${fallbackContent}
-
-            ## Playback payload
-
-            \`\`\`json
-            ${JSON.stringify(payload, null, 2)}
-            \`\`\`
-        `);
-    },
-    /**
-     * Produces a model-friendly markdown error payload from browser execution failures.
-     */
-    formatErrorResult(options) {
-        const { payload } = options;
-        const toolError = payload.error;
-        const suggestedNextSteps = (toolError === null || toolError === void 0 ? void 0 : toolError.suggestedNextSteps) || [];
-        return spaceTrim$1(`
-            # Browser run failed
-
-            **Session:** ${payload.sessionId}
-            **Mode requested:** ${runBrowserRuntime.formatExecutionMode(payload.mode)}
-            **Mode used:** ${payload.modeUsed}
-            **Initial URL:** ${payload.initialUrl}
-            **Error code:** ${(toolError === null || toolError === void 0 ? void 0 : toolError.code) || runBrowserConstants.unknownErrorCode}
-            **Error:** ${(toolError === null || toolError === void 0 ? void 0 : toolError.message) || 'Unknown browser tool error'}
-
-            ${suggestedNextSteps.length === 0
-            ? ''
-            : `
-                    ## Suggested next steps
-
-                    ${suggestedNextSteps.map((step) => `- ${step}`).join('\n')}
-                `}
-
-            ## Playback payload
-
-            \`\`\`json
-            ${JSON.stringify(payload, null, 2)}
-            \`\`\`
-
-            The browser tool could not complete the requested actions.
-        `);
-    },
-};
-
-/**
- * @@@
- *
- * @private within the repository
- */
-function locateChrome() {
-    return locateApp({
-        appName: 'Chrome',
-        linuxWhich: 'google-chrome',
-        windowsSuffix: '\\Google\\Chrome\\Application\\chrome.exe',
-        macOsName: 'Google Chrome',
-    });
-}
-
-/**
- * Creates one standard abort error for cancelled retry loops.
- *
- * @private utility for Agents Server runtime retries
- */
-function createAbortError$1() {
-    const error = new Error('Operation was aborted.');
-    error.name = 'AbortError';
-    return error;
-}
-/**
- * Throws when the supplied signal is already aborted.
- *
- * @private utility for Agents Server runtime retries
- */
-function assertNotAborted(signal) {
-    if (signal === null || signal === void 0 ? void 0 : signal.aborted) {
-        throw createAbortError$1();
-    }
-}
-/**
- * Waits for a duration while respecting cancellation.
- *
- * @private utility for Agents Server runtime retries
- */
-async function sleepWithAbort(delayMs, signal) {
-    if (delayMs <= 0) {
-        assertNotAborted(signal);
-        return;
-    }
-    await new Promise((resolve, reject) => {
-        const timeout = setTimeout(() => {
-            signal === null || signal === void 0 ? void 0 : signal.removeEventListener('abort', onAbort);
-            resolve();
-        }, delayMs);
-        const onAbort = () => {
-            clearTimeout(timeout);
-            signal === null || signal === void 0 ? void 0 : signal.removeEventListener('abort', onAbort);
-            reject(createAbortError$1());
-        };
-        signal === null || signal === void 0 ? void 0 : signal.addEventListener('abort', onAbort, { once: true });
-    });
-}
-/**
- * Resolves the retry wait duration for one failed attempt.
- *
- * @private utility for Agents Server runtime retries
- */
-function resolveBackoffDelayMs(options) {
-    const exponentialDelay = options.initialDelayMs * Math.pow(options.backoffFactor, Math.max(0, options.attempt - 1));
-    const boundedDelay = Math.min(exponentialDelay, options.maxDelayMs);
-    const jitterDelay = boundedDelay * options.jitterRatio * Math.max(0, options.random());
-    return Math.max(0, Math.round(boundedDelay + jitterDelay));
-}
-/**
- * Retries one async operation with exponential backoff and jitter.
- *
- * @private utility for Agents Server runtime retries
- */
-async function retryWithBackoff(operation, options) {
-    var _a, _b, _c;
-    const startedAt = Date.now();
-    const totalAttempts = Math.max(1, options.retries + 1);
-    const random = (_a = options.random) !== null && _a !== void 0 ? _a : Math.random;
-    const sleep = (_b = options.sleep) !== null && _b !== void 0 ? _b : sleepWithAbort;
-    for (let attempt = 1; attempt <= totalAttempts; attempt++) {
-        assertNotAborted(options.signal);
-        try {
-            const value = await operation(attempt);
-            return {
-                value,
-                attempts: attempt,
-                durationMs: Date.now() - startedAt,
-            };
-        }
-        catch (error) {
-            const isLastAttempt = attempt >= totalAttempts;
-            const isRetryable = options.shouldRetry ? options.shouldRetry(error, attempt) : true;
-            if (isLastAttempt || !isRetryable) {
-                throw error;
-            }
-            const delayMs = resolveBackoffDelayMs({
-                attempt,
-                initialDelayMs: options.initialDelayMs,
-                maxDelayMs: options.maxDelayMs,
-                backoffFactor: options.backoffFactor,
-                jitterRatio: options.jitterRatio,
-                random,
-            });
-            (_c = options.onRetry) === null || _c === void 0 ? void 0 : _c.call(options, {
-                attempt,
-                retries: options.retries,
-                delayMs,
-                error,
-            });
-            await sleep(delayMs, options.signal);
-        }
-    }
-    throw new Error('Retry loop exited unexpectedly.');
-}
-
-const DEFAULT_BROWSER_USER_DATA_DIR = join(tmpdir(), 'promptbook', 'browser', 'user-data');
-/**
- * Default remote browser connect timeout in milliseconds.
- */
-const DEFAULT_REMOTE_CONNECT_TIMEOUT_MS = 10000;
-/**
- * Default retry count for remote browser connection establishment.
- */
-const DEFAULT_REMOTE_CONNECT_RETRIES = 2;
-/**
- * Default initial retry delay for remote browser connection.
- */
-const DEFAULT_REMOTE_CONNECT_BACKOFF_INITIAL_MS = 250;
-/**
- * Default maximum retry delay for remote browser connection.
- */
-const DEFAULT_REMOTE_CONNECT_BACKOFF_MAX_MS = 1000;
-/**
- * Default exponential multiplier for remote browser retry delay.
- */
-const DEFAULT_REMOTE_CONNECT_BACKOFF_FACTOR = 4;
-/**
- * Default retry jitter ratio for remote browser connection.
- */
-const DEFAULT_REMOTE_CONNECT_JITTER_RATIO = 0.2;
-/**
- * In-memory metrics counters for remote browser connect attempts.
- */
-const REMOTE_BROWSER_CONNECT_METRICS = {
-    success: 0,
-    failure: 0,
-};
-/**
- * Reads a positive integer from environment variables with a fallback default.
- */
-function resolvePositiveIntFromEnv(variableName, defaultValue) {
-    const rawValue = process.env[variableName];
-    if (!rawValue || !rawValue.trim()) {
-        return defaultValue;
-    }
-    const parsed = Number.parseInt(rawValue.trim(), 10);
-    if (!Number.isFinite(parsed) || parsed <= 0) {
-        return defaultValue;
-    }
-    return parsed;
-}
-/**
- * Reads a positive number from environment variables with a fallback default.
- */
-function resolvePositiveNumberFromEnv(variableName, defaultValue) {
-    const rawValue = process.env[variableName];
-    if (!rawValue || !rawValue.trim()) {
-        return defaultValue;
-    }
-    const parsed = Number.parseFloat(rawValue.trim());
-    if (!Number.isFinite(parsed) || parsed <= 0) {
-        return defaultValue;
-    }
-    return parsed;
-}
-/**
- * Reads a non-negative integer from environment variables with a fallback default.
- */
-function resolveNonNegativeIntFromEnv(variableName, defaultValue) {
-    const rawValue = process.env[variableName];
-    if (!rawValue || !rawValue.trim()) {
-        return defaultValue;
-    }
-    const parsed = Number.parseInt(rawValue.trim(), 10);
-    if (!Number.isFinite(parsed) || parsed < 0) {
-        return defaultValue;
-    }
-    return parsed;
-}
-/**
- * Reads a non-negative number from environment variables with a fallback default.
- */
-function resolveNonNegativeNumberFromEnv(variableName, defaultValue) {
-    const rawValue = process.env[variableName];
-    if (!rawValue || !rawValue.trim()) {
-        return defaultValue;
-    }
-    const parsed = Number.parseFloat(rawValue.trim());
-    if (!Number.isFinite(parsed) || parsed < 0) {
-        return defaultValue;
-    }
-    return parsed;
-}
-/**
- * Creates one standard abort error.
- */
-function createAbortError() {
-    const error = new Error('Browser connection request was aborted.');
-    error.name = 'AbortError';
-    return error;
-}
-/**
- * Provides browser context instances with support for both local and remote browser connections.
- *
- * This provider manages browser lifecycle and supports:
- * - Local mode: Launches a persistent Chromium context on the same machine
- * - Remote mode: Connects to a remote Playwright browser via WebSocket
- *
- * The remote mode is useful for environments like Vercel where running a full browser
- * is not possible due to resource constraints.
- *
- * @private internal utility for Agents Server browser tools
+ * @private internal utility for USE BROWSER commitment
  */
-class BrowserConnectionProvider {
-    /**
-     * Creates a new BrowserConnectionProvider.
-     *
-     * @param options - Provider options
-     * @param options.isVerbose - Enable verbose logging
-     */
-    constructor(options = {}) {
-        var _a, _b, _c, _d, _e, _f, _g, _h;
-        this.browserContext = null;
-        this.connectionMode = null;
-        this.isVerbose = (_a = options.isVerbose) !== null && _a !== void 0 ? _a : false;
-        this.remoteConnectTimeoutMs =
-            (_b = options.remoteConnectTimeoutMs) !== null && _b !== void 0 ? _b : resolvePositiveIntFromEnv('RUN_BROWSER_CONNECT_TIMEOUT_MS', DEFAULT_REMOTE_CONNECT_TIMEOUT_MS);
-        this.remoteConnectRetries =
-            (_c = options.remoteConnectRetries) !== null && _c !== void 0 ? _c : resolveNonNegativeIntFromEnv('RUN_BROWSER_CONNECT_RETRIES', DEFAULT_REMOTE_CONNECT_RETRIES);
-        this.remoteConnectBackoffInitialMs =
-            (_d = options.remoteConnectBackoffInitialMs) !== null && _d !== void 0 ? _d : resolvePositiveIntFromEnv('RUN_BROWSER_CONNECT_BACKOFF_INITIAL_MS', DEFAULT_REMOTE_CONNECT_BACKOFF_INITIAL_MS);
-        this.remoteConnectBackoffMaxMs =
-            (_e = options.remoteConnectBackoffMaxMs) !== null && _e !== void 0 ? _e : resolvePositiveIntFromEnv('RUN_BROWSER_CONNECT_BACKOFF_MAX_MS', DEFAULT_REMOTE_CONNECT_BACKOFF_MAX_MS);
-        this.remoteConnectBackoffFactor =
-            (_f = options.remoteConnectBackoffFactor) !== null && _f !== void 0 ? _f : resolvePositiveNumberFromEnv('RUN_BROWSER_CONNECT_BACKOFF_FACTOR', DEFAULT_REMOTE_CONNECT_BACKOFF_FACTOR);
-        this.remoteConnectJitterRatio =
-            (_g = options.remoteConnectJitterRatio) !== null && _g !== void 0 ? _g : resolveNonNegativeNumberFromEnv('RUN_BROWSER_CONNECT_JITTER_RATIO', DEFAULT_REMOTE_CONNECT_JITTER_RATIO);
-        this.random = (_h = options.random) !== null && _h !== void 0 ? _h : Math.random;
-        this.sleep = options.sleep;
-    }
-    /**
-     * Gets a browser context, creating a new one if needed.
-     *
-     * This method automatically determines whether to use local or remote browser
-     * based on the REMOTE_BROWSER_URL environment variable.
-     *
-     * @returns Browser context instance
-     */
-    async getBrowserContext(options = {}) {
-        var _a;
-        if ((_a = options.signal) === null || _a === void 0 ? void 0 : _a.aborted) {
-            throw createAbortError();
-        }
-        // Check if we have a cached connection that's still valid
-        if (this.browserContext !== null && this.isBrowserContextAlive(this.browserContext)) {
-            return this.browserContext;
-        }
-        // Determine connection mode from configuration
-        const mode = this.resolveConnectionMode();
-        this.connectionMode = mode;
-        if (this.isVerbose) {
-            console.info('[BrowserConnectionProvider] Creating new browser context', {
-                mode: mode.type,
-                wsEndpoint: mode.type === 'remote' ? mode.wsEndpoint : undefined,
-            });
-        }
-        // Create new browser context based on mode
-        if (mode.type === 'local') {
-            this.browserContext = await this.createLocalBrowserContext();
-        }
-        else {
-            this.browserContext = await this.createRemoteBrowserContext(mode.wsEndpoint, options);
-        }
-        return this.browserContext;
-    }
-    /**
-     * Closes all pages in the current browser context.
-     *
-     * This method is useful for cleanup between agent tasks without closing
-     * the entire browser instance.
-     */
-    async closeAllPages() {
-        if (!this.browserContext) {
-            return;
-        }
-        try {
-            const pages = this.browserContext.pages();
-            if (this.isVerbose) {
-                console.info('[BrowserConnectionProvider] Closing all pages', {
-                    pageCount: pages.length,
-                });
-            }
-            await Promise.all(pages.map((page) => page.close().catch((error) => {
-                console.error('[BrowserConnectionProvider] Failed to close page', { error });
-            })));
-        }
-        catch (error) {
-            console.error('[BrowserConnectionProvider] Error closing pages', { error });
-        }
-    }
-    /**
-     * Closes the browser context and disconnects from the browser.
-     *
-     * This should be called when the browser is no longer needed to free up resources.
-     * For local mode, this closes the browser process. For remote mode, it disconnects
-     * from the remote browser but doesn't shut down the remote server.
-     */
-    async close() {
-        var _a;
-        if (!this.browserContext) {
-            return;
-        }
-        try {
-            if (this.isVerbose) {
-                console.info('[BrowserConnectionProvider] Closing browser context', {
-                    mode: (_a = this.connectionMode) === null || _a === void 0 ? void 0 : _a.type,
-                });
-            }
-            await this.browserContext.close();
-            this.browserContext = null;
-            this.connectionMode = null;
-        }
-        catch (error) {
-            console.error('[BrowserConnectionProvider] Error closing browser context', { error });
-            // Reset state even if close fails
-            this.browserContext = null;
-            this.connectionMode = null;
-        }
-    }
-    /**
-     * Checks if a browser context is still alive and connected.
-     *
-     * @param context - Browser context to check
-     * @returns True if the context is connected and usable
-     */
-    isBrowserContextAlive(context) {
-        try {
-            const browser = context.browser();
-            return browser !== null && browser.isConnected();
-        }
-        catch (_a) {
-            return false;
-        }
-    }
-    /**
-     * Determines whether to use local or remote browser based on configuration.
-     *
-     * @returns Connection mode configuration
-     */
-    resolveConnectionMode() {
-        const remoteBrowserUrl = REMOTE_BROWSER_URL;
-        if (remoteBrowserUrl && remoteBrowserUrl.trim().length > 0) {
-            return {
-                type: 'remote',
-                wsEndpoint: remoteBrowserUrl.trim(),
-            };
-        }
-        return { type: 'local' };
-    }
-    /**
-     * Creates a local browser context using persistent Chromium.
-     *
-     * @returns Local browser context
-     */
-    async createLocalBrowserContext() {
-        if (this.isVerbose) {
-            console.info('[BrowserConnectionProvider] Launching local browser context');
-        }
-        const userDataDir = join(DEFAULT_BROWSER_USER_DATA_DIR, 'run-browser');
-        await mkdir(userDataDir, { recursive: true });
-        const launchOptions = {
-            headless: false,
-            args: ['--no-sandbox', '--disable-setuid-sandbox', '--disable-dev-shm-usage'],
-        };
-        try {
-            const chromePath = await locateChrome();
-            launchOptions.executablePath = chromePath;
-        }
-        catch (error) {
-            if (this.isVerbose) {
-                console.warn('[BrowserConnectionProvider] Could not locate system Chrome; using Playwright bundled Chromium', {
-                    error: error instanceof Error ? error.message : String(error),
-                });
-            }
-        }
-        return await chromium.launchPersistentContext(userDataDir, launchOptions);
-    }
-    /**
-     * Creates a remote browser context by connecting to a Playwright server.
-     *
-     * @param wsEndpoint - WebSocket endpoint of the remote Playwright server
-     * @returns Remote browser context
-     */
-    async createRemoteBrowserContext(wsEndpoint, options) {
-        const endpointDebug = sanitizeRemoteBrowserEndpoint(wsEndpoint);
-        const startedAt = Date.now();
-        if (this.isVerbose) {
-            console.info('[BrowserConnectionProvider] Connecting to remote browser', {
-                endpoint: endpointDebug,
-                connectTimeoutMs: this.remoteConnectTimeoutMs,
-                retries: this.remoteConnectRetries,
-            });
-        }
-        let attempts = 0;
-        try {
-            const connectResult = await retryWithBackoff(async (attempt) => {
-                attempts = attempt;
-                return await chromium.connect(wsEndpoint, {
-                    timeout: this.remoteConnectTimeoutMs,
-                });
-            }, {
-                retries: this.remoteConnectRetries,
-                initialDelayMs: this.remoteConnectBackoffInitialMs,
-                maxDelayMs: this.remoteConnectBackoffMaxMs,
-                backoffFactor: this.remoteConnectBackoffFactor,
-                jitterRatio: this.remoteConnectJitterRatio,
-                signal: options.signal,
-                shouldRetry: (error) => isRemoteBrowserInfrastructureError(error),
-                onRetry: ({ attempt, delayMs, error }) => {
-                    console.warn('[run_browser][retry]', {
-                        tool: 'run_browser',
-                        mode: 'remote-browser',
-                        sessionId: options.sessionId || null,
-                        event: 'remote_browser_connect_retry',
-                        attempt,
-                        delayMs,
-                        endpoint: endpointDebug,
-                        errorCode: extractNetworkErrorCode(error),
-                        error: getErrorMessage(error),
-                    });
-                },
-                random: this.random,
-                sleep: this.sleep,
-            });
-            const browser = connectResult.value;
-            // For remote connections, we need to create a new context
-            // Note: Remote browsers don't support persistent contexts
-            const context = await browser.newContext();
-            REMOTE_BROWSER_CONNECT_METRICS.success++;
-            console.info('[run_browser][metric]', {
-                tool: 'run_browser',
-                mode: 'remote-browser',
-                sessionId: options.sessionId || null,
-                event: 'remote_browser_connect_success',
-                attempts: connectResult.attempts,
-                connectDurationMs: connectResult.durationMs,
-                endpoint: endpointDebug,
-                counter: REMOTE_BROWSER_CONNECT_METRICS.success,
-            });
-            if (this.isVerbose) {
-                console.info('[BrowserConnectionProvider] Successfully connected to remote browser');
-            }
-            return context;
-        }
-        catch (error) {
-            REMOTE_BROWSER_CONNECT_METRICS.failure++;
-            const durationMs = Date.now() - startedAt;
-            const remoteInfraUnavailable = isRemoteBrowserInfrastructureError(error);
-            if (remoteInfraUnavailable) {
-                const remoteBrowserUnavailableError = new RemoteBrowserUnavailableError({
-                    message: `Remote browser is unavailable. Could not establish a websocket connection.`,
-                    debug: {
-                        endpoint: endpointDebug,
-                        attempts: Math.max(1, attempts),
-                        connectTimeoutMs: this.remoteConnectTimeoutMs,
-                        durationMs,
-                        networkErrorCode: extractNetworkErrorCode(error),
-                        originalMessage: getErrorMessage(error),
-                    },
-                    cause: error,
-                });
-                console.warn('[run_browser][metric]', {
-                    tool: 'run_browser',
-                    mode: 'remote-browser',
-                    sessionId: options.sessionId || null,
-                    event: 'remote_browser_connect_failure',
-                    errorCode: remoteBrowserUnavailableError.code,
-                    attempts: Math.max(1, attempts),
-                    connectDurationMs: durationMs,
-                    endpoint: endpointDebug,
-                    counter: REMOTE_BROWSER_CONNECT_METRICS.failure,
-                });
-                throw remoteBrowserUnavailableError;
-            }
-            console.error('[run_browser][metric]', {
-                tool: 'run_browser',
-                mode: 'remote-browser',
-                sessionId: options.sessionId || null,
-                event: 'remote_browser_connect_failure',
-                errorCode: 'REMOTE_BROWSER_CONNECT_ERROR',
-                attempts: Math.max(1, attempts),
-                connectDurationMs: durationMs,
-                endpoint: endpointDebug,
-                error: getErrorMessage(error),
-                counter: REMOTE_BROWSER_CONNECT_METRICS.failure,
-            });
-            throw error;
-        }
-    }
-}
-
+let cachedRunBrowserTool = null;
 /**
- * Singleton instance of the browser connection provider.
+ * Cached loading error to avoid repeating expensive resolution attempts.
  *
- * @private internal cache for `$provideBrowserForServer`
+ * @private internal utility for USE BROWSER commitment
  */
-let browserProvider = null;
+let cachedRunBrowserToolError = null;
 /**
- * Provides a browser context for server-side operations, with caching to reuse instances.
- *
- * This function supports both local and remote browser connections based on environment configuration.
- * Use REMOTE_BROWSER_URL environment variable to configure a remote Playwright server.
+ * Attempts to load the server-side `run_browser` tool lazily.
  *
- * @param options - Optional runtime request options used for cancellation and logging context.
- * @returns Browser context instance
+ * @returns Loaded `run_browser` implementation
+ * @private internal utility for USE BROWSER commitment
  */
-async function $provideBrowserForServer(options = {}) {
-    if (browserProvider === null) {
-        browserProvider = new BrowserConnectionProvider({ isVerbose: false });
+function loadRunBrowserToolForNode() {
+    if (cachedRunBrowserTool !== null) {
+        return cachedRunBrowserTool;
     }
-    return await browserProvider.getBrowserContext(options);
-}
-/**
- * TODO: [🏓] Unite `xxxForServer` and `xxxForNode` naming
- */
-
-/**
- * Attempts to compute time-to-first-byte from Playwright response timing.
- */
-function resolveTimeToFirstByteMs(response) {
-    if (!response) {
-        return null;
+    if (cachedRunBrowserToolError !== null) {
+        throw cachedRunBrowserToolError;
     }
     try {
-        const timing = response.request().timing();
-        if (typeof (timing === null || timing === void 0 ? void 0 : timing.responseStart) === 'number' &&
-            typeof (timing === null || timing === void 0 ? void 0 : timing.startTime) === 'number' &&
-            timing.responseStart >= timing.startTime) {
-            return Math.round(timing.responseStart - timing.startTime);
-        }
-    }
-    catch (_a) {
-        return null;
-    }
-    return null;
-}
-/**
- * Page open, action normalization and action execution helpers for `run_browser`.
- *
- * @private function of `run_browser`
- */
-const runBrowserWorkflow = {
-    /**
-     * Opens a new browser page and navigates to the requested URL.
-     */
-    async openPageWithUrl(options) {
-        runBrowserErrorHandling.assertNotAborted(options.signal, options.sessionId);
-        const connectStartedAt = Date.now();
-        const browserContext = await $provideBrowserForServer({
-            signal: options.signal,
-            sessionId: options.sessionId,
-        });
-        const connectDurationMs = Date.now() - connectStartedAt;
-        const page = await browserContext.newPage();
-        page.setDefaultNavigationTimeout(options.timeouts.navigationTimeoutMs);
-        page.setDefaultTimeout(options.timeouts.actionTimeoutMs);
-        const navigationStartedAt = Date.now();
-        try {
-            const navigationResponse = await page.goto(options.url, {
-                waitUntil: 'domcontentloaded',
-                timeout: options.timeouts.navigationTimeoutMs,
-            });
-            return {
-                page,
-                connectDurationMs,
-                initialNavigationDurationMs: Date.now() - navigationStartedAt,
-                timeToFirstByteMs: resolveTimeToFirstByteMs(navigationResponse),
-            };
-        }
-        catch (error) {
-            throw runBrowserErrorHandling.createRunBrowserNavigationError({
-                message: `Failed to navigate to \`${options.url}\`.`,
-                debug: {
-                    phase: 'initial-navigation',
-                    url: options.url,
-                    navigationTimeoutMs: options.timeouts.navigationTimeoutMs,
-                },
-                cause: error,
-            });
-        }
-    },
-    /**
-     * Validates and normalizes browser actions received from the model.
-     */
-    normalizeActions(actions) {
-        if (!actions || actions.length === 0) {
-            return [];
-        }
-        return actions.map((action, index) => this.normalizeAction(action, index));
-    },
-    /**
-     * Validates and normalizes a single action.
-     */
-    normalizeAction(action, index) {
-        var _a, _b, _c;
-        switch (action.type) {
-            case 'navigate': {
-                const url = String(action.value || '').trim();
-                if (!url) {
-                    throw runBrowserErrorHandling.createRunBrowserValidationError({
-                        message: spaceTrim$1(`Action ${index + 1}: \`navigate\` requires non-empty \`value\` URL.`),
-                        debug: {
-                            actionIndex: index + 1,
-                            actionType: action.type,
-                        },
-                    });
-                }
-                return { type: 'navigate', url };
-            }
-            case 'click': {
-                const selector = String(action.selector || '').trim();
-                if (!selector) {
-                    throw runBrowserErrorHandling.createRunBrowserValidationError({
-                        message: spaceTrim$1(`Action ${index + 1}: \`click\` requires non-empty \`selector\`.`),
-                        debug: {
-                            actionIndex: index + 1,
-                            actionType: action.type,
-                        },
-                    });
-                }
-                return { type: 'click', selector };
-            }
-            case 'type': {
-                const selector = String(action.selector || '').trim();
-                if (!selector) {
-                    throw runBrowserErrorHandling.createRunBrowserValidationError({
-                        message: spaceTrim$1(`Action ${index + 1}: \`type\` requires non-empty \`selector\`.`),
-                        debug: {
-                            actionIndex: index + 1,
-                            actionType: action.type,
-                        },
-                    });
-                }
-                const text = String((_a = action.value) !== null && _a !== void 0 ? _a : '');
-                return { type: 'type', selector, text };
-            }
-            case 'wait': {
-                const requestedValue = Number.parseInt(String((_b = action.value) !== null && _b !== void 0 ? _b : runBrowserConstants.defaultWaitMs), 10);
-                const milliseconds = Number.isFinite(requestedValue)
-                    ? Math.min(Math.max(requestedValue, 1), runBrowserConstants.maxWaitMs)
-                    : runBrowserConstants.defaultWaitMs;
-                return { type: 'wait', milliseconds };
-            }
-            case 'scroll': {
-                const requestedValue = Number.parseInt(String((_c = action.value) !== null && _c !== void 0 ? _c : runBrowserConstants.defaultScrollPixels), 10);
-                const pixels = Number.isFinite(requestedValue) ? requestedValue : runBrowserConstants.defaultScrollPixels;
-                const rawSelector = String(action.selector || '').trim();
-                return { type: 'scroll', selector: rawSelector || null, pixels };
-            }
-        }
-    },
-    /**
-     * Executes one normalized browser action on a Playwright page.
-     */
-    async executeAction(options) {
-        const { page, action, actionIndex, timeouts, signal } = options;
-        runBrowserErrorHandling.assertNotAborted(signal, `action-${actionIndex}`);
-        try {
-            switch (action.type) {
-                case 'navigate':
-                    await page.goto(action.url, {
-                        waitUntil: 'domcontentloaded',
-                        timeout: timeouts.navigationTimeoutMs,
-                    });
-                    return;
-                case 'click':
-                    await page.locator(action.selector).first().click({ timeout: timeouts.actionTimeoutMs });
-                    return;
-                case 'type':
-                    await page.locator(action.selector).first().fill(action.text, { timeout: timeouts.actionTimeoutMs });
-                    return;
-                case 'wait':
-                    if (action.milliseconds > timeouts.actionTimeoutMs) {
-                        throw runBrowserErrorHandling.createRunBrowserActionError({
-                            message: `Action ${actionIndex}: \`wait\` exceeds action timeout (${timeouts.actionTimeoutMs}ms).`,
-                            debug: {
-                                actionIndex,
-                                action,
-                                actionTimeoutMs: timeouts.actionTimeoutMs,
-                            },
-                        });
-                    }
-                    await page.waitForTimeout(action.milliseconds);
-                    return;
-                case 'scroll':
-                    if (action.selector) {
-                        await page
-                            .locator(action.selector)
-                            .first()
-                            .scrollIntoViewIfNeeded({ timeout: timeouts.actionTimeoutMs });
-                    }
-                    await page.mouse.wheel(0, action.pixels);
-                    return;
-            }
-        }
-        catch (error) {
-            if (runBrowserErrorHandling.isTaggedRunBrowserError(error)) {
-                throw error;
-            }
-            if (action.type === 'navigate') {
-                throw runBrowserErrorHandling.createRunBrowserNavigationError({
-                    message: `Action ${actionIndex}: failed to navigate to \`${action.url}\`.`,
-                    debug: {
-                        actionIndex,
-                        action,
-                        navigationTimeoutMs: timeouts.navigationTimeoutMs,
-                    },
-                    cause: error,
-                });
-            }
-            throw runBrowserErrorHandling.createRunBrowserActionError({
-                message: `Action ${actionIndex}: failed to execute \`${action.type}\`.`,
-                debug: {
-                    actionIndex,
-                    action,
-                    actionTimeoutMs: timeouts.actionTimeoutMs,
-                },
-                cause: error,
-            });
-        }
-    },
-};
-
-/**
- * Summarizes one normalized browser action in user-facing language.
- */
-function formatRunBrowserActionSummary(action) {
-    switch (action.type) {
-        case 'navigate':
-            return `Navigate to ${action.url}`;
-        case 'click':
-            return `Click ${action.selector}`;
-        case 'type':
-            return `Type into ${action.selector}`;
-        case 'wait':
-            return `Wait ${action.milliseconds}ms`;
-        case 'scroll':
-            return action.selector ? `Scroll ${action.pixels}px in ${action.selector}` : `Scroll ${action.pixels}px on page`;
-    }
-}
-/**
- * Emits one incremental browser-tool update when a hidden chat-progress listener is attached.
- */
-function emitRunBrowserProgress(args, update) {
-    emitToolCallProgressFromToolArgs(args, update);
-}
-/**
- * Returns the current timestamp in the branded ISO-8601 format used by tool-call logs.
- */
-function createRunBrowserLogTimestamp() {
-    return new Date().toISOString();
-}
-/**
- * Executes non-graphical fallback scraping.
- */
-async function runFallbackScrape(url) {
-    return await fetchUrlContent(url);
-}
-/**
- * Runs interactive browser automation through Playwright.
- *
- * @param args Tool arguments provided by the model.
- * @param internalOptions Optional runtime options for cancellation.
- * @returns Markdown summary with structured playback payload.
- */
-async function run_browser(args, internalOptions = {}) {
-    runBrowserObservability.incrementTotalRuns();
-    const startedAt = Date.now();
-    const sessionId = runBrowserRuntime.createRunBrowserSessionId();
-    const initialUrl = String(args.url || '').trim();
-    const mode = runBrowserRuntime.resolveExecutionMode();
-    const timeoutConfiguration = runBrowserRuntime.resolveTimeoutConfiguration(args.timeouts);
-    let page = null;
-    let connectDurationMs = null;
-    let initialNavigationDurationMs = null;
-    let timeToFirstByteMs = null;
-    try {
-        if (!initialUrl) {
-            throw runBrowserErrorHandling.createRunBrowserValidationError({
-                message: 'Missing required `url` argument.',
-                debug: {
-                    field: 'url',
-                },
-            });
-        }
-        const normalizedActions = runBrowserWorkflow.normalizeActions(args.actions);
-        runBrowserErrorHandling.assertNotAborted(internalOptions.signal, sessionId);
-        const openedPage = await runBrowserWorkflow.openPageWithUrl({
-            url: initialUrl,
-            sessionId,
-            timeouts: timeoutConfiguration,
-            signal: internalOptions.signal,
-        });
-        page = openedPage.page;
-        connectDurationMs = openedPage.connectDurationMs;
-        initialNavigationDurationMs = openedPage.initialNavigationDurationMs;
-        timeToFirstByteMs = openedPage.timeToFirstByteMs;
-        emitRunBrowserProgress(args, {
-            state: 'PARTIAL',
-            log: {
-                createdAt: createRunBrowserLogTimestamp(),
-                kind: 'browser-session',
-                title: 'Browser ready',
-                message: 'Opened the initial page and started the browser session.',
-                payload: {
-                    sessionId,
-                    initialUrl,
-                    connectDurationMs,
-                    initialNavigationDurationMs,
-                    timeToFirstByteMs,
-                },
-            },
-        });
-        const artifacts = [];
-        const initialArtifact = await runBrowserArtifacts.captureSnapshotArtifact({
-            page,
-            sessionId,
-            label: 'Initial page',
-            fileSuffix: 'initial',
-        });
-        if (initialArtifact) {
-            artifacts.push(initialArtifact);
-        }
-        for (const [index, action] of normalizedActions.entries()) {
-            runBrowserErrorHandling.assertNotAborted(internalOptions.signal, sessionId);
-            emitRunBrowserProgress(args, {
-                state: 'PARTIAL',
-                log: {
-                    createdAt: createRunBrowserLogTimestamp(),
-                    kind: 'browser-action',
-                    title: `Action ${index + 1} running`,
-                    message: formatRunBrowserActionSummary(action),
-                    payload: {
-                        actionIndex: index + 1,
-                        action,
-                        phase: 'running',
-                    },
-                },
-            });
-            await runBrowserWorkflow.executeAction({
-                page,
-                action,
-                actionIndex: index + 1,
-                timeouts: timeoutConfiguration,
-                signal: internalOptions.signal,
-            });
-            emitRunBrowserProgress(args, {
-                state: 'PARTIAL',
-                log: {
-                    createdAt: createRunBrowserLogTimestamp(),
-                    kind: 'browser-action',
-                    title: `Action ${index + 1} finished`,
-                    message: formatRunBrowserActionSummary(action),
-                    payload: {
-                        actionIndex: index + 1,
-                        action,
-                        phase: 'complete',
-                    },
-                },
-            });
-            const actionArtifact = await runBrowserArtifacts.captureSnapshotArtifact({
-                page,
-                sessionId,
-                label: `After action ${index + 1}`,
-                fileSuffix: `action-${String(index + 1).padStart(3, '0')}-${action.type}`,
-                actionIndex: index + 1,
-                action,
-            });
-            if (actionArtifact) {
-                artifacts.push(actionArtifact);
-            }
-        }
-        const snapshotPath = await runBrowserArtifacts.captureSnapshot(page, sessionId);
-        const finalUrl = page.url();
-        const finalTitle = await runBrowserArtifacts.getPageTitle(page);
-        if (snapshotPath) {
-            artifacts.push({
-                kind: 'screenshot',
-                label: 'Final page',
-                path: snapshotPath,
-                capturedAt: new Date().toISOString(),
-                url: finalUrl,
-                title: finalTitle,
-            });
+        // eslint-disable-next-line @typescript-eslint/no-var-requires
+        const runBrowserModule = require('../../../apps/agents-server/src/tools/run_browser');
+        if (typeof runBrowserModule.run_browser !== 'function') {
+            throw new Error('run_browser value is not a function but ' + typeof runBrowserModule.run_browser);
         }
-        const payload = runBrowserResultFormatting.createResultPayload({
-            sessionId,
-            mode,
-            modeUsed: 'remote-browser',
-            initialUrl,
-            finalUrl,
-            finalTitle,
-            executedActions: normalizedActions,
-            artifacts,
-            warning: null,
-            error: null,
-            fallbackContent: null,
-            timing: {
-                connectDurationMs,
-                initialNavigationDurationMs,
-                timeToFirstByteMs,
-                totalDurationMs: Date.now() - startedAt,
-            },
-        });
-        runBrowserObservability.logRunBrowserMetric({
-            event: 'run_browser_success',
-            sessionId,
-            mode: 'remote-browser',
-            payload: {
-                actions: normalizedActions.length,
-                connectDurationMs,
-                initialNavigationDurationMs,
-                timeToFirstByteMs,
-            },
-        });
-        return runBrowserResultFormatting.formatSuccessResult({
-            payload,
-            snapshotPath,
-        });
+        cachedRunBrowserTool = runBrowserModule.run_browser;
+        return cachedRunBrowserTool;
     }
     catch (error) {
-        const toolError = runBrowserErrorHandling.classifyRunBrowserToolError({
-            error,
-            sessionId,
-            mode,
-        });
-        const errorCodeCount = runBrowserObservability.incrementRunBrowserErrorCodeCounter(toolError.code);
-        if (runBrowserErrorHandling.isRemoteBrowserUnavailableCode(toolError.code) && initialUrl) {
-            const fallbackContent = await runFallbackScrape(initialUrl);
-            const { fallbackRuns, fallbackRate } = runBrowserObservability.incrementFallbackRunsAndGetMetrics();
-            emitRunBrowserProgress(args, {
-                state: 'PARTIAL',
-                log: {
-                    createdAt: createRunBrowserLogTimestamp(),
-                    kind: 'warning',
-                    level: 'warning',
-                    title: 'Fallback enabled',
-                    message: 'Remote browser was unavailable, so fallback scraping was used instead.',
-                    payload: {
-                        errorCode: toolError.code,
-                        initialUrl,
-                    },
-                },
-            });
-            const payload = runBrowserResultFormatting.createResultPayload({
-                sessionId,
-                mode,
-                modeUsed: 'fallback',
-                initialUrl,
-                finalUrl: null,
-                finalTitle: null,
-                executedActions: [],
-                artifacts: [],
-                warning: runBrowserConstants.fallbackDynamicContentWarning,
-                error: toolError,
-                fallbackContent,
-                timing: {
-                    connectDurationMs,
-                    initialNavigationDurationMs,
-                    timeToFirstByteMs,
-                    totalDurationMs: Date.now() - startedAt,
-                },
-            });
-            runBrowserObservability.logRunBrowserMetric({
-                event: 'run_browser_fallback_used',
-                sessionId,
-                mode: 'fallback',
-                payload: {
-                    errorCode: toolError.code,
-                    errorCodeCount,
-                    fallbackRuns,
-                    totalRuns: runBrowserObservability.getTotalRuns(),
-                    fallbackRate,
-                },
-            });
-            return runBrowserResultFormatting.formatFallbackResult({
-                payload,
-                fallbackContent,
-                requestedActions: Array.isArray(args.actions) ? args.actions.length : 0,
-            });
-        }
-        emitRunBrowserProgress(args, {
-            state: 'ERROR',
-            log: {
-                createdAt: createRunBrowserLogTimestamp(),
-                kind: 'error',
-                level: 'error',
-                title: 'Browser run failed',
-                message: toolError.message,
-                payload: {
-                    code: toolError.code,
-                    debug: toolError.debug,
-                },
-            },
-        });
-        const payload = runBrowserResultFormatting.createResultPayload({
-            sessionId,
-            mode,
-            modeUsed: 'remote-browser',
-            initialUrl,
-            finalUrl: page ? page.url() : null,
-            finalTitle: page ? await runBrowserArtifacts.getPageTitle(page) : null,
-            executedActions: [],
-            artifacts: [],
-            warning: null,
-            error: toolError,
-            fallbackContent: null,
-            timing: {
-                connectDurationMs,
-                initialNavigationDurationMs,
-                timeToFirstByteMs,
-                totalDurationMs: Date.now() - startedAt,
-            },
-        });
-        runBrowserObservability.logRunBrowserMetric({
-            event: 'run_browser_failed',
-            sessionId,
-            mode: 'remote-browser',
-            payload: {
-                errorCode: toolError.code,
-                errorCodeCount,
-                connectDurationMs,
-                initialNavigationDurationMs,
-                timeToFirstByteMs,
-            },
-        });
-        return runBrowserResultFormatting.formatErrorResult({
-            payload,
-        });
-    }
-    finally {
-        await runBrowserArtifacts.cleanupPage(page, sessionId);
+        assertsError(error);
+        cachedRunBrowserToolError = error;
+        throw error;
     }
 }
-
 /**
  * Resolves the server-side implementation of the `run_browser` tool for Node.js environments.
  *
- * This uses lazy `require` to keep the core package decoupled from Agents Server internals.
+ * This uses fully lazy resolution to keep CLI startup independent from optional browser tooling.
  * When the server tool cannot be resolved, the fallback implementation throws a helpful error.
  *
  * @private internal utility for USE BROWSER commitment
  */
 function resolveRunBrowserToolForNode() {
-    try {
-        // eslint-disable-next-line @typescript-eslint/no-var-requires
-        // const { run_browser } = require('../../../apps/agents-server/src/tools/run_browser');
-        if (typeof run_browser !== 'function') {
-            throw new Error('run_browser value is not a function but ' + typeof run_browser);
+    return async (args) => {
+        try {
+            const runBrowserTool = loadRunBrowserToolForNode();
+            return await runBrowserTool(args);
         }
-        return run_browser;
-    }
-    catch (error) {
-        assertsError(error);
-        return async () => {
+        catch (error) {
+            assertsError(error);
             throw new EnvironmentMismatchError(spaceTrim$1((block) => `
                         \`run_browser\` tool is not available in this environment.
                         This commitment requires the Agents Server browser runtime with Playwright CLI.
@@ -18398,8 +16385,8 @@ function resolveRunBrowserToolForNode() {
                         ${error.name}:
                         ${block(error.message)}
                     `));
-        };
-    }
+        }
+    };
 }
 
 /**
@@ -20234,6 +18221,110 @@ const parseMemoryToolArgs = {
     },
 };
 
+/**
+ * Prompt parameter key used to pass hidden runtime context to tool execution.
+ *
+ * @private internal runtime wiring for commitment tools
+ */
+const TOOL_RUNTIME_CONTEXT_PARAMETER = 'promptbookToolRuntimeContext';
+/**
+ * Hidden argument key used to pass runtime context into individual tool calls.
+ *
+ * @private internal runtime wiring for commitment tools
+ */
+const TOOL_RUNTIME_CONTEXT_ARGUMENT = '__promptbookToolRuntimeContext';
+/**
+ * Prompt parameter key used to pass a hidden tool-progress listener token into script execution.
+ *
+ * @private internal runtime wiring for commitment tools
+ */
+const TOOL_PROGRESS_TOKEN_PARAMETER = 'promptbookToolProgressToken';
+/**
+ * Hidden argument key used to pass a tool-progress listener token into individual tool calls.
+ *
+ * @private internal runtime wiring for commitment tools
+ */
+const TOOL_PROGRESS_TOKEN_ARGUMENT = '__promptbookToolProgressToken';
+/**
+ * Monotonic counter used for hidden progress-listener tokens.
+ *
+ * @private internal runtime wiring for commitment tools
+ */
+let toolCallProgressListenerCounter = 0;
+/**
+ * Active tool-progress listeners keyed by hidden execution token.
+ *
+ * @private internal runtime wiring for commitment tools
+ */
+const toolCallProgressListeners = new Map();
+/**
+ * Parses unknown runtime context payload into a normalized object.
+ *
+ * @private internal runtime wiring for commitment tools
+ */
+function parseToolRuntimeContext(rawValue) {
+    if (!rawValue) {
+        return null;
+    }
+    let parsed = rawValue;
+    if (typeof rawValue === 'string') {
+        try {
+            parsed = JSON.parse(rawValue);
+        }
+        catch (_a) {
+            return null;
+        }
+    }
+    if (!parsed || typeof parsed !== 'object') {
+        return null;
+    }
+    return parsed;
+}
+/**
+ * Reads runtime context attached to tool call arguments.
+ *
+ * @private internal runtime wiring for commitment tools
+ */
+function readToolRuntimeContextFromToolArgs(args) {
+    return parseToolRuntimeContext(args[TOOL_RUNTIME_CONTEXT_ARGUMENT]);
+}
+/**
+ * Serializes runtime context for prompt parameters.
+ *
+ * @private internal runtime wiring for commitment tools
+ */
+function serializeToolRuntimeContext(context) {
+    return JSON.stringify(context);
+}
+/**
+ * Registers one in-memory listener that receives progress updates emitted by a running tool.
+ *
+ * The returned token is passed into script execution as a hidden argument so tool implementations
+ * can stream progress without exposing extra parameters to the model.
+ *
+ * @param listener - Listener notified about tool progress.
+ * @returns Hidden token used to route progress updates.
+ * @private internal runtime wiring for commitment tools
+ */
+function registerToolCallProgressListener(listener) {
+    toolCallProgressListenerCounter += 1;
+    const token = `tool-progress:${Date.now()}:${toolCallProgressListenerCounter}`;
+    toolCallProgressListeners.set(token, listener);
+    return token;
+}
+/**
+ * Unregisters one in-memory progress listener.
+ *
+ * @param token - Token previously created by `registerToolCallProgressListener`.
+ * @private internal runtime wiring for commitment tools
+ */
+function unregisterToolCallProgressListener(token) {
+    toolCallProgressListeners.delete(token);
+}
+/**
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ */
+
 /**
  * Resolves runtime context from hidden tool arguments.
  *
@@ -27942,9 +26033,9 @@ function createTimeoutSystemMessage(extraInstructions) {
     return spaceTrim$1((block) => `
             Timeout scheduling:
             - Use "set_timeout" to wake this same chat thread in the future.
-            - Timers are thread-scoped, not global for the whole agent.
+            - Use "list_timeouts" to review timeouts across all chats for the same user+agent scope.
+            - "cancel_timeout" accepts a timeout id from any chat in this same user+agent scope.
             - When one timeout elapses, you will receive a new user-like message that explicitly says it is a timeout wake-up and includes the \`timeoutId\`.
-            - Use "cancel_timeout" when a previously scheduled timeout is no longer relevant.
             - Do not claim a timer was set or cancelled unless the tool confirms it.
             ${block(extraInstructions)}
         `);
@@ -28005,13 +26096,6 @@ function parseToolExecutionEnvelope(rawValue) {
  * @private internal utility of USE TIMEOUT
  */
 function createDisabledTimeoutResult(action, message) {
-    if (action === 'set') {
-        return {
-            action,
-            status: 'disabled',
-            message,
-        };
-    }
     return {
         action,
         status: 'disabled',
@@ -28038,6 +26122,18 @@ function getTimeoutToolRuntimeAdapterOrDisabledResult(action, runtimeContext) {
     }
 }
 
+/**
+ * Default number of rows returned by `list_timeouts`.
+ *
+ * @private internal USE TIMEOUT constant
+ */
+const DEFAULT_LIST_TIMEOUTS_LIMIT = 20;
+/**
+ * Hard cap for `list_timeouts` page size.
+ *
+ * @private internal USE TIMEOUT constant
+ */
+const MAX_LIST_TIMEOUTS_LIMIT = 100;
 /**
  * Parses and validates `USE TIMEOUT` tool arguments.
  *
@@ -28072,6 +26168,31 @@ const parseTimeoutToolArgs = {
         }
         return { timeoutId };
     },
+    /**
+     * Parses `list_timeouts` input.
+     */
+    list(args) {
+        if (args.includeFinished !== undefined && typeof args.includeFinished !== 'boolean') {
+            throw new PipelineExecutionError(spaceTrim$1(`
+                    Timeout \`includeFinished\` must be a boolean when provided.
+                `));
+        }
+        const parsedLimit = args.limit === undefined ? DEFAULT_LIST_TIMEOUTS_LIMIT : Math.floor(Number(args.limit));
+        if (!Number.isFinite(parsedLimit) || parsedLimit <= 0) {
+            throw new PipelineExecutionError(spaceTrim$1(`
+                    Timeout \`limit\` must be a positive number.
+                `));
+        }
+        if (parsedLimit > MAX_LIST_TIMEOUTS_LIMIT) {
+            throw new PipelineExecutionError(spaceTrim$1(`
+                    Timeout \`limit\` must be at most \`${MAX_LIST_TIMEOUTS_LIMIT}\`.
+                `));
+        }
+        return {
+            includeFinished: args.includeFinished === true,
+            limit: parsedLimit,
+        };
+    },
 };
 
 /**
@@ -28082,6 +26203,7 @@ const parseTimeoutToolArgs = {
 const TimeoutToolNames = {
     set: 'set_timeout',
     cancel: 'cancel_timeout',
+    list: 'list_timeouts',
 };
 
 /**
@@ -28181,6 +26303,35 @@ function createTimeoutToolFunctions() {
                 return JSON.stringify(result);
             }
         },
+        async [TimeoutToolNames.list](args) {
+            const runtimeContext = resolveTimeoutRuntimeContext(args);
+            const { adapter, disabledResult } = getTimeoutToolRuntimeAdapterOrDisabledResult('list', runtimeContext);
+            if (!adapter || disabledResult) {
+                return JSON.stringify(disabledResult);
+            }
+            try {
+                const parsedArgs = parseTimeoutToolArgs.list(args);
+                const listedTimeouts = await adapter.listTimeouts(parsedArgs, runtimeContext);
+                const result = {
+                    action: 'list',
+                    status: 'listed',
+                    items: listedTimeouts.items,
+                    total: listedTimeouts.total,
+                };
+                return createToolExecutionEnvelope({
+                    assistantMessage: listedTimeouts.total === 1 ? 'Found 1 timeout.' : `Found ${listedTimeouts.total} timeouts.`,
+                    toolResult: result,
+                });
+            }
+            catch (error) {
+                const result = {
+                    action: 'list',
+                    status: 'error',
+                    message: error instanceof Error ? error.message : String(error),
+                };
+                return JSON.stringify(result);
+            }
+        },
     };
 }
 
@@ -28214,26 +26365,45 @@ function createTimeoutTools(existingTools = []) {
     if (!tools.some((tool) => tool.name === TimeoutToolNames.cancel)) {
         tools.push({
             name: TimeoutToolNames.cancel,
-            description: 'Cancel one previously scheduled timeout in the current chat thread.',
+            description: 'Cancel one previously scheduled timeout within the same user+agent scope, even if it was set in another chat.',
             parameters: {
                 type: 'object',
                 properties: {
                     timeoutId: {
                         type: 'string',
-                        description: 'Identifier returned earlier by `set_timeout`.',
+                        description: 'Identifier returned earlier by `set_timeout` or `list_timeouts`.',
                     },
                 },
                 required: ['timeoutId'],
             },
         });
     }
+    if (!tools.some((tool) => tool.name === TimeoutToolNames.list)) {
+        tools.push({
+            name: TimeoutToolNames.list,
+            description: 'List scheduled timeouts across all chats for this same user+agent scope so they can be reviewed or cancelled.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    includeFinished: {
+                        type: 'boolean',
+                        description: 'When true, include completed, failed, and cancelled rows in addition to active timeouts.',
+                    },
+                    limit: {
+                        type: 'number',
+                        description: 'Maximum number of rows to return (default 20, max 100).',
+                    },
+                },
+            },
+        });
+    }
     return tools;
 }
 
 /**
  * `USE TIMEOUT` commitment definition.
  *
- * The `USE TIMEOUT` commitment enables thread-scoped timers that wake the same chat later.
+ * The `USE TIMEOUT` commitment enables timeout wake-ups and scoped timeout management.
  *
  * @private [🪔] Maybe export the commitments through some package
  */
@@ -28248,7 +26418,7 @@ class UseTimeoutCommitmentDefinition extends BaseCommitmentDefinition {
      * Short one-line description of `USE TIMEOUT`.
      */
     get description() {
-        return 'Enable thread-scoped timers that can wake the same chat in the future.';
+        return 'Enable timeout wake-ups plus scoped timeout listing/cancellation across chats.';
     }
     /**
      * Icon for this commitment.
@@ -28263,14 +26433,15 @@ class UseTimeoutCommitmentDefinition extends BaseCommitmentDefinition {
         return spaceTrim$1(`
             # USE TIMEOUT
 
-            Enables the agent to schedule thread-scoped timeout wake-ups.
+            Enables timeout wake-ups and timeout management for the same user+agent scope.
 
             ## Key aspects
 
             - The agent uses \`set_timeout\` to schedule a future wake-up in the same chat thread.
             - The tool returns immediately while the timeout is stored and executed by the runtime later.
             - The wake-up arrives as a new user-like timeout message in the same conversation.
-            - The agent can cancel an existing timeout by \`timeoutId\` via \`cancel_timeout\`.
+            - The agent can inspect known timeouts via \`list_timeouts\`.
+            - The agent can cancel an existing timeout by \`timeoutId\` via \`cancel_timeout\`, including timeouts created in another chat.
             - Commitment content is treated as optional timeout policy instructions.
 
             ## Examples
@@ -28299,6 +26470,7 @@ class UseTimeoutCommitmentDefinition extends BaseCommitmentDefinition {
         return {
             [TimeoutToolNames.set]: 'Set timer',
             [TimeoutToolNames.cancel]: 'Cancel timer',
+            [TimeoutToolNames.list]: 'List timers',
         };
     }
     /**
@@ -29230,7 +27402,7 @@ class JavascriptEvalExecutionTools {
         }
         // Note: [💎]
         // Note: Using direct eval, following variables are in same scope as eval call so they are accessible from inside the evaluated script:
-        const spaceTrim = (_) => spaceTrim$2(_);
+        const spaceTrim = (_) => _spaceTrim(_);
         $preserve(spaceTrim);
         const removeQuotes$1 = removeQuotes;
         $preserve(removeQuotes$1);
@@ -29321,7 +27493,7 @@ class JavascriptEvalExecutionTools {
             .join('\n');
         // script = templateParameters(script, parameters);
         // <- TODO: [🧠][🥳] Should be this is one of two variants how to use parameters in script
-        const statementToEvaluate = spaceTrim$2((block) => `
+        const statementToEvaluate = _spaceTrim((block) => `
 
                 // Build-in functions:
                 ${block(buildinFunctionsStatement)}
@@ -29336,7 +27508,7 @@ class JavascriptEvalExecutionTools {
                 (async ()=>{ ${script} })()
             `);
         if (this.options.isVerbose) {
-            console.info(spaceTrim$2((block) => `
+            console.info(_spaceTrim((block) => `
                         🚀 Evaluating ${scriptLanguage} script:
 
                         ${block(statementToEvaluate)}`));
@@ -29345,7 +27517,7 @@ class JavascriptEvalExecutionTools {
         try {
             result = await eval(statementToEvaluate);
             if (this.options.isVerbose) {
-                console.info(spaceTrim$2((block) => `
+                console.info(_spaceTrim((block) => `
                             🚀 Script evaluated successfully, result:   
                             ${block(valueToString(result))}
                         `));
@@ -29364,7 +27536,7 @@ class JavascriptEvalExecutionTools {
                       To:   [PipelineExecutionError: Parameter `{thing}` is not defined],
                 */
                 if (!statementToEvaluate.includes(undefinedName + '(')) {
-                    throw new PipelineExecutionError(spaceTrim$2((block) => `
+                    throw new PipelineExecutionError(_spaceTrim((block) => `
 
                                 Parameter \`{${undefinedName}}\` is not defined
 
@@ -29386,7 +27558,7 @@ class JavascriptEvalExecutionTools {
                             `));
                 }
                 else {
-                    throw new PipelineExecutionError(spaceTrim$2((block) => `
+                    throw new PipelineExecutionError(_spaceTrim((block) => `
                                   Function ${undefinedName}() is not defined
 
                                   -  Make sure that the function is one of built-in functions
@@ -29639,7 +27811,7 @@ async function createPipelineCollectionFromDirectory(rootPath, tools, options) {
             catch (error) {
                 assertsError(error);
                 // TODO: [7] DRY
-                const wrappedErrorMessage = spaceTrim$2((block) => `
+                const wrappedErrorMessage = spaceTrim$1((block) => `
                             ${error.name} in pipeline ${fileName.split('\\').join('/')}⁠:
 
                             Original error message:
@@ -29674,7 +27846,7 @@ async function createPipelineCollectionFromDirectory(rootPath, tools, options) {
                         pipeline = { ...pipeline, pipelineUrl };
                     }
                     else if (!pipeline.pipelineUrl.startsWith(rootUrl)) {
-                        throw new PipelineUrlError(spaceTrim$2(`
+                        throw new PipelineUrlError(spaceTrim$1(`
                                 Pipeline with URL ${pipeline.pipelineUrl} is not a child of the root URL ${rootUrl} 🍏
 
                                 File:
@@ -29712,7 +27884,7 @@ async function createPipelineCollectionFromDirectory(rootPath, tools, options) {
                     }
                     else {
                         const existing = collection.get(pipeline.pipelineUrl);
-                        throw new PipelineUrlError(spaceTrim$2(`
+                        throw new PipelineUrlError(spaceTrim$1(`
                                 Pipeline with URL ${pipeline.pipelineUrl} is already in the collection 🍏
 
                                 Conflicting files:
@@ -29730,7 +27902,7 @@ async function createPipelineCollectionFromDirectory(rootPath, tools, options) {
             catch (error) {
                 assertsError(error);
                 // TODO: [7] DRY
-                const wrappedErrorMessage = spaceTrim$2((block) => `
+                const wrappedErrorMessage = spaceTrim$1((block) => `
                             ${error.name} in pipeline ${fileName.split('\\').join('/')}⁠:
 
                             Original error message:
@@ -29865,7 +28037,7 @@ function usageToHuman(usage) {
         // Note: For negligible usage, we report at least something
         reportItems.push('Negligible');
     }
-    return spaceTrim$2((block) => `
+    return spaceTrim$1((block) => `
             Usage:
             ${block(reportItems.map((item) => `- ${item}`).join('\n'))}
         `);
@@ -29905,7 +28077,7 @@ async function $provideScriptingForNode(options) {
  */
 function $initializeMakeCommand(program) {
     const makeCommand = program.command('make');
-    makeCommand.description(spaceTrim$2(`
+    makeCommand.description(spaceTrim$1(`
             Makes a new pipeline collection in given folder
         `));
     makeCommand.alias('compile');
@@ -29917,7 +28089,7 @@ function $initializeMakeCommand(program) {
     'Path to promptbook collection directory', DEFAULT_BOOKS_DIRNAME);
     makeCommand.option('--project-name', `Name of the project for whom collection is`, 'Untitled Promptbook project');
     makeCommand.option('--root-url <url>', `Root URL of all pipelines to make`, undefined);
-    makeCommand.option('-f, --format <format>', spaceTrim$2(`
+    makeCommand.option('-f, --format <format>', spaceTrim$1(`
             Output format of builded collection "bookc", "javascript", "typescript" or "json"
 
             Note: You can use multiple formats separated by comma
@@ -29925,14 +28097,14 @@ function $initializeMakeCommand(program) {
     makeCommand.option('--no-validation', `Do not validate logic of pipelines in collection`, true);
     makeCommand.option('--validation', `Types of validations separated by comma (options "logic","imports")`, 'logic,imports');
     makeCommand.option('-r, --reload', `Call LLM models even if same prompt with result is in the cache`, false);
-    makeCommand.option('-o, --output <path>', spaceTrim$2(`
+    makeCommand.option('-o, --output <path>', spaceTrim$1(`
             Where to save the builded collection
 
             Note: If you keep it "${DEFAULT_PIPELINE_COLLECTION_BASE_FILENAME}" it will be saved in the root of the promptbook directory
                   If you set it to a path, it will be saved in that path
                   BUT you can use only one format and set correct extension
         `), DEFAULT_PIPELINE_COLLECTION_BASE_FILENAME);
-    makeCommand.option('-fn, --function-name <functionName>', spaceTrim$2(`
+    makeCommand.option('-fn, --function-name <functionName>', spaceTrim$1(`
             Name of the function to get pipeline collection
 
             Note: This can be used only with "javascript" or "typescript" format
@@ -30015,7 +28187,7 @@ function $initializeMakeCommand(program) {
             if (lastChar !== ']') {
                 throw new UnexpectedError(`Last character of serialized collection should be "]" not "${lastChar}"`);
             }
-            return spaceTrim$2(collectionJsonString.substring(1, collectionJsonString.length - 1));
+            return spaceTrim$1(collectionJsonString.substring(1, collectionJsonString.length - 1));
         })();
         const saveFile = async (extension, content) => {
             const filename = output !== DEFAULT_PIPELINE_COLLECTION_BASE_FILENAME
@@ -30046,7 +28218,7 @@ function $initializeMakeCommand(program) {
         }
         if (formats.includes('javascript') || formats.includes('js')) {
             formats = formats.filter((format) => format !== 'javascript' && format !== 'js');
-            (await saveFile('js', spaceTrim$2((block) => `
+            (await saveFile('js', spaceTrim$1((block) => `
                             // ${block(GENERATOR_WARNING_BY_PROMPTBOOK_CLI)}
 
                             import { createPipelineCollectionFromJson } from '@promptbook/core';
@@ -30083,7 +28255,7 @@ function $initializeMakeCommand(program) {
         }
         if (formats.includes('typescript') || formats.includes('ts')) {
             formats = formats.filter((format) => format !== 'typescript' && format !== 'ts');
-            await saveFile('ts', spaceTrim$2((block) => `
+            await saveFile('ts', spaceTrim$1((block) => `
                             // ${block(GENERATOR_WARNING_BY_PROMPTBOOK_CLI)}
 
                             import { createPipelineCollectionFromJson } from '@promptbook/core';
@@ -30228,7 +28400,7 @@ async function prettifyPipelineString(pipelineString, options) {
  */
 function $initializePrettifyCommand(program) {
     const prettifyCommand = program.command('prettify');
-    prettifyCommand.description(spaceTrim$2(`
+    prettifyCommand.description(spaceTrim$1(`
             Iterates over \`.book.md\` files and does multiple enhancing operations on them:
 
             1) Adds Mermaid graph
@@ -30684,7 +28856,7 @@ async function $getCompiledBook(tools, pipelineSource, options) {
         // console.log(`Strategy 3️⃣`);
         const response = await fetch(pipelineSource);
         if (response.status >= 300) {
-            throw new NotFoundError(spaceTrim$2((block) => `
+            throw new NotFoundError(spaceTrim$1((block) => `
                         Book not found on URL:
                         ${block(pipelineSource)}
 
@@ -30694,7 +28866,7 @@ async function $getCompiledBook(tools, pipelineSource, options) {
         const pipelineString = await response.text();
         // console.log({ pipelineString });
         if (!isValidPipelineString(pipelineString)) {
-            throw new NotFoundError(spaceTrim$2((block) => `
+            throw new NotFoundError(spaceTrim$1((block) => `
                         Book not found on URL:
                         ${block(pipelineSource)}
 
@@ -30716,7 +28888,7 @@ async function $getCompiledBook(tools, pipelineSource, options) {
         });
         return pipelineJson;
     } /* not else */
-    throw new NotFoundError(spaceTrim$2((block) => `
+    throw new NotFoundError(spaceTrim$1((block) => `
                 Book not found:
                 ${block(pipelineSource)}
 
@@ -30763,7 +28935,7 @@ async function runInteractiveChatbot(options) {
     const initialMessage = (((_a = pipeline.parameters.find(({ name }) => name === 'chatbotResponse')) === null || _a === void 0 ? void 0 : _a.exampleValues) || [])[0];
     if (initialMessage) {
         console.info(`\n`);
-        console.info(spaceTrim$2((block) => `
+        console.info(spaceTrim$1((block) => `
 
                     ${colors.bold(colors.green('Chatbot:'))}
                     ${block(colors.green(initialMessage))}
@@ -30786,7 +28958,7 @@ async function runInteractiveChatbot(options) {
                 type: 'text',
                 name: 'userMessage',
                 message: 'User message',
-                hint: spaceTrim$2((block) => `
+                hint: spaceTrim$1((block) => `
                         Type "exit" to exit,
 
                         previousTitle
@@ -30802,7 +28974,7 @@ async function runInteractiveChatbot(options) {
                 return process.exit(0);
             }
             console.info(`\n`);
-            console.info(spaceTrim$2((block) => `
+            console.info(spaceTrim$1((block) => `
 
                         ${colors.bold(colors.blue('User:'))}
                         ${block(colors.blue(userMessage))}
@@ -30815,7 +28987,7 @@ async function runInteractiveChatbot(options) {
             };
             const result = await pipelineExecutor(inputParameters).asPromise({ isCrashedOnError: true });
             console.info(`\n`);
-            console.info(spaceTrim$2((block) => `
+            console.info(spaceTrim$1((block) => `
 
                         ${colors.bold(colors.green('Chatbot:'))}
                         ${block(colors.green(result.outputParameters.chatbotResponse))}
@@ -30846,7 +29018,7 @@ async function runInteractiveChatbot(options) {
  */
 function $initializeRunCommand(program) {
     const runCommand = program.command('run', { isDefault: true });
-    runCommand.description(spaceTrim$2(`
+    runCommand.description(spaceTrim$1(`
             Runs a pipeline
         `));
     runCommand.alias('execute');
@@ -30889,7 +29061,7 @@ function $initializeRunCommand(program) {
             if (!error.message.includes('No LLM tools')) {
                 throw error;
             }
-            console.error(colors.red(spaceTrim$2((block) => `
+            console.error(colors.red(spaceTrim$1((block) => `
                             You need to configure LLM tools first
 
                             1) Create .env file at the root of your project
@@ -30957,7 +29129,7 @@ function $initializeRunCommand(program) {
             if (!(error instanceof ParseError)) {
                 throw error;
             }
-            console.error(colors.red(spaceTrim$2((block) => `
+            console.error(colors.red(spaceTrim$1((block) => `
                             ${block(error.message)}
 
                             in ${pipelineSource}
@@ -31009,7 +29181,7 @@ function $initializeRunCommand(program) {
             };
         });
         if (isInteractive === false && questions.length !== 0) {
-            console.error(colors.red(spaceTrim$2((block) => `
+            console.error(colors.red(spaceTrim$1((block) => `
                               When using --no-interactive you need to pass all the input parameters through --json
 
                               You are missing:
@@ -31141,7 +29313,7 @@ function $initializeStartAgentsServerCommand(program) {
     'Path to agents directory', DEFAULT_AGENTS_DIRNAME);
     startServerCommand.option('--port <port>', `Port to start the server on`, '4440');
     startServerCommand.option('-r, --reload', `Call LLM models even if same prompt with result is in the cache`, false);
-    startServerCommand.description(spaceTrim$2(`
+    startServerCommand.description(spaceTrim$1(`
             Starts a Promptbook agents server
         `));
     startServerCommand.alias('start');
@@ -32448,7 +30620,7 @@ function $initializeStartPipelinesServerCommand(program) {
     // <- TODO: [🧟‍♂️] Unite path to promptbook collection argument
     'Path to promptbook collection directory', DEFAULT_BOOKS_DIRNAME);
     startServerCommand.option('--port <port>', `Port to start the server on`, '4460');
-    startServerCommand.option('-u, --url <url>', spaceTrim$2(`
+    startServerCommand.option('-u, --url <url>', spaceTrim$1(`
             Public root url of the server
             It is used for following purposes:
 
@@ -32458,7 +30630,7 @@ function $initializeStartPipelinesServerCommand(program) {
     startServerCommand.option('--allow-anonymous', `Is anonymous mode allowed`, false);
     startServerCommand.option('-r, --reload', `Call LLM models even if same prompt with result is in the cache`, false);
     startServerCommand.option('--no-rich-ui', `Disable rich UI`, true);
-    startServerCommand.description(spaceTrim$2(`
+    startServerCommand.description(spaceTrim$1(`
             Starts a remote server to execute books
 
             Note: You want probably to use "ptbk start-agents-server" to start agents server instead of pipelines server
@@ -32549,7 +30721,7 @@ function $initializeStartPipelinesServerCommand(program) {
  */
 function $initializeTestCommand(program) {
     const testCommand = program.command('test');
-    testCommand.description(spaceTrim$2(`
+    testCommand.description(spaceTrim$1(`
             Iterates over \`.book.md\` and \`.bookc\` and checks if they are parsable and logically valid
       `));
     testCommand.argument('<filesGlob>', 
@@ -32789,7 +30961,7 @@ function pricing(value) {
 /**
  * List of available Anthropic Claude models with pricing
  *
- * Note: Synced with official API docs at 2025-11-19
+ * Note: Synced with official API docs at 2026-03-22
  *
  * @see https://docs.anthropic.com/en/docs/models-overview
  * @public exported from `@promptbook/anthropic-claude`
@@ -32797,6 +30969,26 @@ function pricing(value) {
 const ANTHROPIC_CLAUDE_MODELS = exportJson({
     name: 'ANTHROPIC_CLAUDE_MODELS',
     value: [
+        {
+            modelVariant: 'CHAT',
+            modelTitle: 'Claude Opus 4.6',
+            modelName: 'claude-opus-4-6',
+            modelDescription: "Anthropic's most capable model for advanced coding, complex reasoning, and agentic workflows with 1M token context window.",
+            pricing: {
+                prompt: pricing(`$5.00 / 1M tokens`),
+                output: pricing(`$25.00 / 1M tokens`),
+            },
+        },
+        {
+            modelVariant: 'CHAT',
+            modelTitle: 'Claude Sonnet 4.6',
+            modelName: 'claude-sonnet-4-6',
+            modelDescription: 'Best speed and intelligence balance for production-ready workloads with 1M token context window. Ideal for high-performance, lower-latency applications.',
+            pricing: {
+                prompt: pricing(`$3.00 / 1M tokens`),
+                output: pricing(`$15.00 / 1M tokens`),
+            },
+        },
         {
             modelVariant: 'CHAT',
             modelTitle: 'Claude Sonnet 4.5',
@@ -33198,7 +31390,7 @@ class AnthropicClaudeExecutionTools {
     getDefaultModel(defaultModelName) {
         const model = ANTHROPIC_CLAUDE_MODELS.find(({ modelName }) => modelName.startsWith(defaultModelName));
         if (model === undefined) {
-            throw new UnexpectedError(spaceTrim$2((block) => `
+            throw new UnexpectedError(spaceTrim$1((block) => `
                           Cannot find model in Anthropic Claude models with name "${defaultModelName}" which should be used as default.
 
                           Available models:
@@ -33355,7 +31547,7 @@ const _AzureOpenAiMetadataRegistration = $llmToolsMetadataRegister.register({
 /**
  * List of available OpenAI models with pricing
  *
- * Note: Synced with official API docs at 2025-11-19
+ * Note: Synced with official API docs at 2026-03-22
  *
  * @see https://platform.openai.com/docs/models/
  * @see https://openai.com/api/pricing/
@@ -33477,8 +31669,8 @@ const OPENAI_MODELS = exportJson({
             modelName: 'gpt-4.1',
             modelDescription: 'Smartest non-reasoning model with 128K context window. Enhanced version of GPT-4 with improved instruction following, better factual accuracy, and reduced hallucinations. Features advanced function calling capabilities and superior performance on coding tasks. Ideal for applications requiring high intelligence without reasoning overhead.',
             pricing: {
-                prompt: pricing(`$3.00 / 1M tokens`),
-                output: pricing(`$12.00 / 1M tokens`),
+                prompt: pricing(`$2.00 / 1M tokens`),
+                output: pricing(`$8.00 / 1M tokens`),
             },
         },
         /**/
@@ -33489,8 +31681,8 @@ const OPENAI_MODELS = exportJson({
             modelName: 'gpt-4.1-mini',
             modelDescription: 'Smaller, faster version of GPT-4.1 with 128K context window. Balances intelligence and efficiency with 3x faster inference than base GPT-4.1. Maintains strong capabilities across text generation, reasoning, and coding while offering better cost-performance ratio for most applications.',
             pricing: {
-                prompt: pricing(`$0.80 / 1M tokens`),
-                output: pricing(`$3.20 / 1M tokens`),
+                prompt: pricing(`$0.40 / 1M tokens`),
+                output: pricing(`$1.60 / 1M tokens`),
             },
         },
         /**/
@@ -33501,8 +31693,8 @@ const OPENAI_MODELS = exportJson({
             modelName: 'gpt-4.1-nano',
             modelDescription: 'Fastest, most cost-efficient version of GPT-4.1 with 128K context window. Optimized for high-throughput applications requiring good quality at minimal cost. Features 5x faster inference than GPT-4.1 while maintaining adequate performance for most general-purpose tasks.',
             pricing: {
-                prompt: pricing(`$0.20 / 1M tokens`),
-                output: pricing(`$0.80 / 1M tokens`),
+                prompt: pricing(`$0.10 / 1M tokens`),
+                output: pricing(`$0.40 / 1M tokens`),
             },
         },
         /**/
@@ -33513,8 +31705,8 @@ const OPENAI_MODELS = exportJson({
             modelName: 'o3',
             modelDescription: 'Advanced reasoning model with 128K context window specializing in complex logical, mathematical, and analytical tasks. Successor to o1 with enhanced step-by-step problem-solving capabilities and superior performance on STEM-focused problems. Ideal for professional applications requiring deep analytical thinking and precise reasoning.',
             pricing: {
-                prompt: pricing(`$15.00 / 1M tokens`),
-                output: pricing(`$60.00 / 1M tokens`),
+                prompt: pricing(`$2.00 / 1M tokens`),
+                output: pricing(`$8.00 / 1M tokens`),
             },
         },
         /**/
@@ -33525,8 +31717,8 @@ const OPENAI_MODELS = exportJson({
             modelName: 'o3-pro',
             modelDescription: 'Enhanced version of o3 with more compute allocated for better responses on the most challenging problems. Features extended reasoning time and improved accuracy on complex analytical tasks. Designed for applications where maximum reasoning quality is more important than response speed.',
             pricing: {
-                prompt: pricing(`$30.00 / 1M tokens`),
-                output: pricing(`$120.00 / 1M tokens`),
+                prompt: pricing(`$20.00 / 1M tokens`),
+                output: pricing(`$80.00 / 1M tokens`),
             },
         },
         /**/
@@ -33537,8 +31729,8 @@ const OPENAI_MODELS = exportJson({
             modelName: 'o4-mini',
             modelDescription: 'Fast, cost-efficient reasoning model with 128K context window. Successor to o1-mini with improved analytical capabilities while maintaining speed advantages. Features enhanced mathematical reasoning and logical problem-solving at significantly lower cost than full reasoning models.',
             pricing: {
-                prompt: pricing(`$4.00 / 1M tokens`),
-                output: pricing(`$16.00 / 1M tokens`),
+                prompt: pricing(`$1.10 / 1M tokens`),
+                output: pricing(`$4.40 / 1M tokens`),
             },
         },
         /**/
@@ -33896,8 +32088,8 @@ const OPENAI_MODELS = exportJson({
             modelName: 'gpt-4o-2024-05-13',
             modelDescription: 'May 2024 version of GPT-4o with 128K context window. Features enhanced multimodal capabilities including superior image understanding (up to 20MP), audio processing, and improved reasoning. Optimized for 2x lower latency than GPT-4 Turbo while maintaining high performance. Includes knowledge up to October 2023. Ideal for production applications requiring reliable multimodal capabilities.',
             pricing: {
-                prompt: pricing(`$5.00 / 1M tokens`),
-                output: pricing(`$15.00 / 1M tokens`),
+                prompt: pricing(`$2.50 / 1M tokens`),
+                output: pricing(`$10.00 / 1M tokens`),
             },
         },
         /**/
@@ -33908,8 +32100,8 @@ const OPENAI_MODELS = exportJson({
             modelName: 'gpt-4o',
             modelDescription: "OpenAI's most advanced general-purpose multimodal model with 128K context window. Optimized for balanced performance, speed, and cost with 2x faster responses than GPT-4 Turbo. Features excellent vision processing, audio understanding, reasoning, and text generation quality. Represents optimal balance of capability and efficiency for most advanced applications.",
             pricing: {
-                prompt: pricing(`$5.00 / 1M tokens`),
-                output: pricing(`$15.00 / 1M tokens`),
+                prompt: pricing(`$2.50 / 1M tokens`),
+                output: pricing(`$10.00 / 1M tokens`),
             },
         },
         /**/
@@ -33980,8 +32172,8 @@ const OPENAI_MODELS = exportJson({
             modelName: 'o3-mini',
             modelDescription: 'Cost-effective reasoning model with 128K context window optimized for academic and scientific problem-solving. Features efficient performance on STEM tasks with specialized capabilities in mathematics, physics, chemistry, and computer science. Offers 80% of O1 performance on technical domains at significantly lower cost. Ideal for educational applications and research support.',
             pricing: {
-                prompt: pricing(`$3.00 / 1M tokens`),
-                output: pricing(`$12.00 / 1M tokens`),
+                prompt: pricing(`$1.10 / 1M tokens`),
+                output: pricing(`$4.40 / 1M tokens`),
             },
         },
         /**/
@@ -34496,7 +32688,7 @@ function createExecutionToolsFromVercelProvider(options) {
             const modelName = modelRequirements.modelName ||
                 ((_a = availableModels.find(({ modelVariant }) => modelVariant === 'CHAT')) === null || _a === void 0 ? void 0 : _a.modelName);
             if (!modelName) {
-                throw new PipelineExecutionError(spaceTrim$2(`
+                throw new PipelineExecutionError(spaceTrim$1(`
                         Can not determine which model to use.
 
                         You need to provide at least one of:
@@ -34611,7 +32803,7 @@ function createExecutionToolsFromVercelProvider(options) {
 /**
  * List of available Deepseek models with descriptions
  *
- * Note: Synced with official API docs at 2025-08-20
+ * Note: Synced with official API docs at 2026-03-22
  *
  * @see https://www.deepseek.com/models
  * @public exported from `@promptbook/deepseek`
@@ -34625,8 +32817,8 @@ const DEEPSEEK_MODELS = exportJson({
             modelName: 'deepseek-chat',
             modelDescription: 'Latest flagship general-purpose model with 128K context window. Features exceptional reasoning capabilities, advanced code generation, and strong performance across diverse domains. Offers competitive performance with leading models while maintaining cost efficiency. Ideal for complex reasoning, coding, and knowledge-intensive tasks.',
             pricing: {
-                prompt: pricing(`$0.14 / 1M tokens`),
-                output: pricing(`$0.28 / 1M tokens`),
+                prompt: pricing(`$0.28 / 1M tokens`),
+                output: pricing(`$0.42 / 1M tokens`),
             },
         },
         {
@@ -34892,7 +33084,7 @@ const _GoogleMetadataRegistration = $llmToolsMetadataRegister.register({
 /**
  * List of available Google models with descriptions
  *
- * Note: Synced with official API docs at 2025-11-19
+ * Note: Synced with official API docs at 2026-03-22
  *
  * @see https://ai.google.dev/models/gemini
  * @public exported from `@promptbook/google`
@@ -34913,8 +33105,8 @@ const GOOGLE_MODELS = exportJson({
             modelName: 'gemini-2.5-pro',
             modelDescription: 'State-of-the-art thinking model with 1M token context window capable of reasoning over complex problems in code, math, and STEM. Features enhanced thinking capabilities, advanced multimodal understanding, and superior performance on analytical tasks. Ideal for complex enterprise applications requiring maximum intelligence and reasoning.',
             pricing: {
-                prompt: pricing(`$7.00 / 1M tokens`),
-                output: pricing(`$21.00 / 1M tokens`),
+                prompt: pricing(`$1.25 / 1M tokens`),
+                output: pricing(`$10.00 / 1M tokens`),
             },
         },
         {
@@ -34923,8 +33115,8 @@ const GOOGLE_MODELS = exportJson({
             modelName: 'gemini-2.5-flash',
             modelDescription: 'Best model in terms of price-performance with 1M token context window offering well-rounded capabilities. Features adaptive thinking, cost efficiency, and enhanced reasoning for large-scale processing. Ideal for low-latency, high-volume tasks that require thinking and agentic use cases.',
             pricing: {
-                prompt: pricing(`$0.35 / 1M tokens`),
-                output: pricing(`$1.05 / 1M tokens`),
+                prompt: pricing(`$0.30 / 1M tokens`),
+                output: pricing(`$2.50 / 1M tokens`),
             },
         },
         {
@@ -34933,8 +33125,8 @@ const GOOGLE_MODELS = exportJson({
             modelName: 'gemini-2.5-flash-lite',
             modelDescription: 'Cost-efficient Gemini 2.5 Flash model optimized for high throughput with 1M token context window. Features thinking capabilities while maintaining the most cost-efficient pricing. Perfect for real-time, low-latency use cases requiring good quality at scale.',
             pricing: {
-                prompt: pricing(`$0.20 / 1M tokens`),
-                output: pricing(`$0.60 / 1M tokens`),
+                prompt: pricing(`$0.10 / 1M tokens`),
+                output: pricing(`$0.40 / 1M tokens`),
             },
         },
         {
@@ -35413,53 +33605,6 @@ resultContent, rawResponse, duration = ZERO_VALUE) {
  * TODO: [🤝] DRY Maybe some common abstraction between `computeOpenAiUsage` and `computeAnthropicClaudeUsage`
  */
 
-/**
- * Maps Promptbook tools to OpenAI tools.
- *
- * @private
- */
-function mapToolsToOpenAi(tools) {
-    return tools.map((tool) => ({
-        type: 'function',
-        function: {
-            name: tool.name,
-            description: tool.description,
-            parameters: tool.parameters,
-        },
-    }));
-}
-
-/**
- * Builds a tool invocation script that injects hidden runtime context into tool args.
- *
- * @private utility of OpenAI tool execution wrappers
- */
-function buildToolInvocationScript(options) {
-    const { functionName, functionArgsExpression } = options;
-    return `
-        const args = ${functionArgsExpression};
-        const runtimeContextRaw =
-            typeof ${TOOL_RUNTIME_CONTEXT_PARAMETER} === 'undefined'
-                ? undefined
-                : ${TOOL_RUNTIME_CONTEXT_PARAMETER};
-
-        if (runtimeContextRaw !== undefined && args && typeof args === 'object' && !Array.isArray(args)) {
-            args.${TOOL_RUNTIME_CONTEXT_ARGUMENT} = runtimeContextRaw;
-        }
-
-        const toolProgressTokenRaw =
-            typeof ${TOOL_PROGRESS_TOKEN_PARAMETER} === 'undefined'
-                ? undefined
-                : ${TOOL_PROGRESS_TOKEN_PARAMETER};
-
-        if (toolProgressTokenRaw !== undefined && args && typeof args === 'object' && !Array.isArray(args)) {
-            args.${TOOL_PROGRESS_TOKEN_ARGUMENT} = toolProgressTokenRaw;
-        }
-
-        return await ${functionName}(args);
-    `;
-}
-
 /**
  * Parses an OpenAI error message to identify which parameter is unsupported
  *
@@ -35516,6 +33661,53 @@ function isUnsupportedParameterError(error) {
         errorMessage.includes('does not support'));
 }
 
+/**
+ * Builds a tool invocation script that injects hidden runtime context into tool args.
+ *
+ * @private utility of OpenAI tool execution wrappers
+ */
+function buildToolInvocationScript(options) {
+    const { functionName, functionArgsExpression } = options;
+    return `
+        const args = ${functionArgsExpression};
+        const runtimeContextRaw =
+            typeof ${TOOL_RUNTIME_CONTEXT_PARAMETER} === 'undefined'
+                ? undefined
+                : ${TOOL_RUNTIME_CONTEXT_PARAMETER};
+
+        if (runtimeContextRaw !== undefined && args && typeof args === 'object' && !Array.isArray(args)) {
+            args.${TOOL_RUNTIME_CONTEXT_ARGUMENT} = runtimeContextRaw;
+        }
+
+        const toolProgressTokenRaw =
+            typeof ${TOOL_PROGRESS_TOKEN_PARAMETER} === 'undefined'
+                ? undefined
+                : ${TOOL_PROGRESS_TOKEN_PARAMETER};
+
+        if (toolProgressTokenRaw !== undefined && args && typeof args === 'object' && !Array.isArray(args)) {
+            args.${TOOL_PROGRESS_TOKEN_ARGUMENT} = toolProgressTokenRaw;
+        }
+
+        return await ${functionName}(args);
+    `;
+}
+
+/**
+ * Maps Promptbook tools to OpenAI tools.
+ *
+ * @private
+ */
+function mapToolsToOpenAi(tools) {
+    return tools.map((tool) => ({
+        type: 'function',
+        function: {
+            name: tool.name,
+            description: tool.description,
+            parameters: tool.parameters,
+        },
+    }));
+}
+
 /**
  * Provides access to the structured clone implementation when available.
  */
@@ -36482,7 +34674,7 @@ class OpenAiCompatibleExecutionTools {
         // Note: Match exact or prefix for model families
         const model = this.HARDCODED_MODELS.find(({ modelName }) => modelName === defaultModelName || modelName.startsWith(defaultModelName));
         if (model === undefined) {
-            throw new PipelineExecutionError(spaceTrim$2((block) => `
+            throw new PipelineExecutionError(spaceTrim$1((block) => `
                             Cannot find model in ${this.title} models with name "${defaultModelName}" which should be used as default.
 
                             Available models:
@@ -38239,7 +36431,7 @@ class OpenAiAssistantExecutionTools extends OpenAiVectorStoreHandler {
                                 assertsError(error);
                                 const serializedError = serializeError(error);
                                 errors = [serializedError];
-                                functionResponse = spaceTrim$2((block) => `
+                                functionResponse = spaceTrim$1((block) => `
                                     
                                         The invoked tool \`${functionName}\` failed with error:
                                         
@@ -38968,7 +37160,7 @@ class BoilerplateScraper {
             await $execCommand(command);
             // Note: [0]
             if (!(await isFileExisting(cacheFilehandler.filename, this.tools.fs))) {
-                throw new UnexpectedError(spaceTrim$2((block) => `
+                throw new UnexpectedError(spaceTrim$1((block) => `
                     File that was supposed to be created by Pandoc does not exist for unknown reason
 
                     Expected file:
@@ -39132,7 +37324,7 @@ class DocumentScraper {
             await $execCommand(command);
             // Note: [0]
             if (!(await isFileExisting(cacheFilehandler.filename, this.tools.fs))) {
-                throw new UnexpectedError(spaceTrim$2((block) => `
+                throw new UnexpectedError(spaceTrim$1((block) => `
                             File that was supposed to be created by Pandoc does not exist for unknown reason
 
                             Expected file:
@@ -39283,7 +37475,7 @@ class LegacyDocumentScraper {
             await $execCommand(command);
             const files = await readdir(documentSourceOutdirPathForLibreOffice);
             if (files.length !== 1) {
-                throw new UnexpectedError(spaceTrim$2((block) => `
+                throw new UnexpectedError(spaceTrim$1((block) => `
                             Expected exactly 1 file in the LibreOffice output directory, got ${files.length}
 
                             The temporary folder:
@@ -39297,7 +37489,7 @@ class LegacyDocumentScraper {
             await rename(join(documentSourceOutdirPathForLibreOffice, file), cacheFilehandler.filename);
             await rmdir(documentSourceOutdirPathForLibreOffice);
             if (!(await isFileExisting(cacheFilehandler.filename, this.tools.fs))) {
-                throw new UnexpectedError(spaceTrim$2((block) => `
+                throw new UnexpectedError(spaceTrim$1((block) => `
                             File that was supposed to be created by LibreOffice does not exist for unknown reason
 
                             Expected file:
@@ -40564,7 +38756,7 @@ function computeAgentHash(agentSource) {
  * @public exported from `@promptbook/core`
  */
 function normalizeAgentName(rawAgentName) {
-    return titleToName(spaceTrim$2(rawAgentName));
+    return titleToName(spaceTrim$1(rawAgentName));
 }
 
 /**
@@ -40739,7 +38931,7 @@ function parseAgentSource(agentSource) {
             continue;
         }
         if (commitment.type === 'FROM') {
-            const content = spaceTrim$2(commitment.content).split(/\r?\n/)[0] || '';
+            const content = spaceTrim$1(commitment.content).split(/\r?\n/)[0] || '';
             if (content === 'Adam' || content === '' /* <- Note: Adam is implicit */) {
                 continue;
             }
@@ -40762,7 +38954,7 @@ function parseAgentSource(agentSource) {
             continue;
         }
         if (commitment.type === 'IMPORT') {
-            const content = spaceTrim$2(commitment.content).split(/\r?\n/)[0] || '';
+            const content = spaceTrim$1(commitment.content).split(/\r?\n/)[0] || '';
             let label = content;
             let iconName = 'ExternalLink'; // Import remote
             try {
@@ -40800,7 +38992,7 @@ function parseAgentSource(agentSource) {
             continue;
         }
         if (commitment.type === 'KNOWLEDGE') {
-            const content = spaceTrim$2(commitment.content);
+            const content = spaceTrim$1(commitment.content);
             const extractedUrls = extractUrlsFromText(content);
             let label = content;
             let iconName = 'Book';
@@ -40859,7 +39051,7 @@ function parseAgentSource(agentSource) {
             continue;
         }
         if (commitment.type === 'META LINK') {
-            const linkValue = spaceTrim$2(commitment.content);
+            const linkValue = spaceTrim$1(commitment.content);
             links.push(linkValue);
             meta.link = linkValue;
             continue;
@@ -40869,11 +39061,11 @@ function parseAgentSource(agentSource) {
             continue;
         }
         if (commitment.type === 'META IMAGE') {
-            meta.image = spaceTrim$2(commitment.content);
+            meta.image = spaceTrim$1(commitment.content);
             continue;
         }
         if (commitment.type === 'META DESCRIPTION') {
-            meta.description = spaceTrim$2(commitment.content);
+            meta.description = spaceTrim$1(commitment.content);
             continue;
         }
         if (commitment.type === 'META DISCLAIMER') {
@@ -40881,7 +39073,7 @@ function parseAgentSource(agentSource) {
             continue;
         }
         if (commitment.type === 'META INPUT PLACEHOLDER') {
-            meta.inputPlaceholder = spaceTrim$2(commitment.content);
+            meta.inputPlaceholder = spaceTrim$1(commitment.content);
             continue;
         }
         if (commitment.type === 'MESSAGE SUFFIX') {
@@ -40897,7 +39089,7 @@ function parseAgentSource(agentSource) {
             continue;
         }
         if (commitment.type === 'META VOICE') {
-            meta.voice = spaceTrim$2(commitment.content);
+            meta.voice = spaceTrim$1(commitment.content);
             continue;
         }
         if (commitment.type !== 'META') {
@@ -40906,10 +39098,10 @@ function parseAgentSource(agentSource) {
         // Parse META commitments - format is "META TYPE content"
         const metaTypeRaw = commitment.content.split(' ')[0] || 'NONE';
         if (metaTypeRaw === 'LINK') {
-            links.push(spaceTrim$2(commitment.content.substring(metaTypeRaw.length)));
+            links.push(spaceTrim$1(commitment.content.substring(metaTypeRaw.length)));
         }
         const metaType = normalizeTo_camelCase(metaTypeRaw);
-        meta[metaType] = spaceTrim$2(commitment.content.substring(metaTypeRaw.length));
+        meta[metaType] = spaceTrim$1(commitment.content.substring(metaTypeRaw.length));
     }
     // Generate fullname fallback if no meta fullname specified
     if (!meta.fullname) {
@@ -40940,7 +39132,7 @@ function parseAgentSource(agentSource) {
  * @returns The content with normalized separators
  */
 function normalizeSeparator(content) {
-    const trimmed = spaceTrim$2(content);
+    const trimmed = spaceTrim$1(content);
     if (trimmed.includes(',')) {
         return trimmed;
     }
@@ -40953,7 +39145,7 @@ function normalizeSeparator(content) {
  * @returns Normalized domain or a trimmed fallback.
  */
 function normalizeMetaDomain(content) {
-    const trimmed = spaceTrim$2(content);
+    const trimmed = spaceTrim$1(content);
     return normalizeDomainForMatching(trimmed) || trimmed.toLowerCase();
 }
 /**
@@ -41091,7 +39283,7 @@ const OpenAiSdkTranspiler = {
         }
         const KNOWLEDGE_THRESHOLD = 1000;
         if (directKnowledge.join('\n').length > KNOWLEDGE_THRESHOLD || knowledgeSources.length > 0) {
-            return spaceTrim$2((block) => `
+            return spaceTrim$1((block) => `
                     #!/usr/bin/env node
 
                     import * as dotenv from 'dotenv';
@@ -41166,7 +39358,7 @@ const OpenAiSdkTranspiler = {
 
                         if (context) {
                             question = spaceTrim(\`
-                                ${block(spaceTrim$2(`
+                                ${block(spaceTrim$1(`
                                         Here is some additional context to help you answer the question:
                                         \${context}
 
@@ -41247,7 +39439,7 @@ const OpenAiSdkTranspiler = {
                     })();
                 `);
         }
-        const source = spaceTrim$2((block) => `
+        const source = spaceTrim$1((block) => `
 
                 #!/usr/bin/env node
 
@@ -41437,12 +39629,7 @@ const EMOJIS_OF_SINGLE_PICTOGRAM = new Set(Array.from(EMOJIS).filter((emoji) =>
  * Note: [💞] Ignore a discrepancy between file name and entity name
  */
 
-// find-fresh-emoji-tag.ts
-dotenv.config({ path: '.env' });
-if (process.cwd() !== join(__dirname, '../..')) {
-    console.error(colors.red(`CWD must be root of the project`));
-    process.exit(1);
-}
+// find-fresh-emoji-tags.ts
 // Note: When run as a standalone script, call the exported function
 if (require.main === module) {
     findFreshEmojiTag()
@@ -41455,12 +39642,31 @@ if (require.main === module) {
         process.exit(0);
     });
 }
+/**
+ * Initializes environment and validates repository context for this script.
+ *
+ * @private utility for `findFreshEmojiTag`
+ */
+function initializeFindFreshEmojiTagRun() {
+    dotenv.config({ path: '.env' });
+    if (process.cwd() !== join(__dirname, '../..')) {
+        console.error(colors.red(spaceTrim$1(`
+                    CWD must be root of the project
+
+                    Script: find-fresh-emoji-tag.ts
+                    Current CWD: ${process.cwd()}
+                    Expected CWD: ${join(__dirname, '../..')}
+                `)));
+        process.exit(1);
+    }
+}
 /**
  * Finds fresh emoji tags that are not yet used in the codebase.
  *
  * @public exported from `@promptbook/cli`
  */
 async function findFreshEmojiTag() {
+    initializeFindFreshEmojiTagRun();
     console.info(`🤪  Find fresh emoji tag`);
     const allFiles = await glob('**/*.{ts,tsx,js,jsx,json,md,txt}', {
         ignore: '**/node_modules/**', // <- TODO: [🚰] Ignore also hidden folders like *(`.promptbook`, `.next`, `.git`,...)*
@@ -41500,7 +39706,7 @@ async function findFreshEmojiTag() {
  * Note: [🟡] Code in this file should never be published outside of `@promptbook/cli`
  */
 
-var findFreshEmojiTag$1 = /*#__PURE__*/Object.freeze({
+var findFreshEmojiTags = /*#__PURE__*/Object.freeze({
     __proto__: null,
     findFreshEmojiTag: findFreshEmojiTag
 });
@@ -41729,11 +39935,6 @@ const PROMPT_SLUG_MAX_LENGTH = 80;
  * Note: [?] Code in this file should never be published in any package
  */
 
-dotenv.config({ path: '.env' });
-if (process.cwd() !== join(__dirname, '../..')) {
-    console.error(colors.red(`CWD must be root of the project`));
-    process.exit(1);
-}
 if (require.main === module) {
     findRefactorCandidates()
         .catch((error) => {
@@ -41746,12 +39947,31 @@ if (require.main === module) {
         process.exit(0);
     });
 }
+/**
+ * Initializes environment and validates repository context for this script.
+ *
+ * @private utility for `findRefactorCandidates`
+ */
+function initializeFindRefactorCandidatesRun() {
+    dotenv.config({ path: '.env' });
+    if (process.cwd() !== join(__dirname, '../..')) {
+        console.error(colors.red(spaceTrim$1(`
+                    CWD must be root of the project
+
+                    Script: find-refactor-candidates.ts
+                    Current CWD: ${process.cwd()}
+                    Expected CWD: ${join(__dirname, '../..')}
+                `)));
+        process.exit(1);
+    }
+}
 /**
  * Orchestrates scanning for refactor candidates and generating prompts.
  *
  * @public exported from `@promptbook/cli`
  */
 async function findRefactorCandidates() {
+    initializeFindRefactorCandidatesRun();
     console.info(colors.cyan('?? Find refactor candidates'));
     const rootDir = process.cwd();
     const promptsDir = join(rootDir, PROMPTS_DIR_NAME);
@@ -41841,7 +40061,7 @@ async function findRefactorCandidates() {
 function buildPromptContent(candidate, emojiTag) {
     const fileName = basename(candidate.relativePath);
     const guidanceLines = buildPromptGuidance(candidate);
-    return spaceTrim$2((block) => `
+    return spaceTrim$1((block) => `
 
             [ ]
 
@@ -42731,7 +40951,7 @@ async function pushCommittedChanges(agentEnv) {
     }
     const currentBranch = await readCurrentBranchName(agentEnv);
     if (currentBranch === 'HEAD') {
-        throw new GitPushFailedError(spaceTrim$2(`
+        throw new GitPushFailedError(spaceTrim$1(`
                 Failed to push coding-agent commit because Git is in detached HEAD mode.
 
                 Actionable hint:
@@ -42811,7 +41031,7 @@ async function resolveDefaultRemoteName(currentBranch, agentEnv) {
         return remotes[0];
     }
     if (remotes.length > 1) {
-        throw new GitPushFailedError(spaceTrim$2(`
+        throw new GitPushFailedError(spaceTrim$1(`
                 Failed to push coding-agent commit because no default remote is configured.
 
                 Available remotes: ${remotes.join(', ')}
@@ -42820,7 +41040,7 @@ async function resolveDefaultRemoteName(currentBranch, agentEnv) {
                 - Configure \`remote.pushDefault\` or \`branch.${currentBranch}.remote\`, then rerun the coding script.
             `));
     }
-    throw new GitPushFailedError(spaceTrim$2(`
+    throw new GitPushFailedError(spaceTrim$1(`
             Failed to push coding-agent commit because no Git remote is configured.
 
             Actionable hint:
@@ -42865,7 +41085,7 @@ function buildPushFailureMessage(command, error) {
     const details = stringifyUnknownError(error).trim() || '(No Git output)';
     const hints = buildPushFailureHints(details);
     const hintsMarkdown = hints.map((hint) => `- ${hint}`).join('\n');
-    return spaceTrim$2(`
+    return spaceTrim$1(`
         Failed to push coding-agent commit to the remote repository.
 
         Command:
@@ -42963,7 +41183,7 @@ async function isWorkingTreeClean(path) {
 async function ensureWorkingTreeClean() {
     const isClean = await isWorkingTreeClean(process.cwd());
     if (!isClean) {
-        throw new Error(spaceTrim$2(`
+        throw new Error(spaceTrim$1(`
                 Git working tree is not clean.
 
                 Please commit or stash your changes before running this script
@@ -43081,7 +41301,7 @@ const SERVER_REGISTRY_TABLE_NAME = '_Server';
 function parseServerRecord(rawRow, label = 'row') {
     const rawEnvironment = typeof rawRow.environment === 'string' ? rawRow.environment.trim().toUpperCase() : '';
     if (!isServerEnvironment(rawEnvironment)) {
-        throw new DatabaseError(spaceTrim$2(`
+        throw new DatabaseError(spaceTrim$1(`
                 Invalid \`${SERVER_REGISTRY_TABLE_NAME}\` ${label}.
 
                 Field \`environment\` must be one of \`${SERVER_ENVIRONMENT.PRODUCTION}\`, \`${SERVER_ENVIRONMENT.PREVIEW}\`, \`${SERVER_ENVIRONMENT.LTS}\` or \`${SERVER_ENVIRONMENT.LIVE}\`.
@@ -43090,7 +41310,7 @@ function parseServerRecord(rawRow, label = 'row') {
     const domain = typeof rawRow.domain === 'string' ? rawRow.domain.trim().toLowerCase() : '';
     const normalizedDomain = normalizeServerDomain(domain);
     if (!normalizedDomain) {
-        throw new DatabaseError(spaceTrim$2(`
+        throw new DatabaseError(spaceTrim$1(`
                 Invalid \`${SERVER_REGISTRY_TABLE_NAME}\` ${label}.
 
                 Field \`domain\` must contain a valid host or URL-like domain string.
@@ -43104,7 +41324,7 @@ function parseServerRecord(rawRow, label = 'row') {
     const updatedAt = typeof rawRow.updatedAt === 'string' ? rawRow.updatedAt : '';
     const id = typeof rawRow.id === 'number' ? rawRow.id : Number(rawRow.id);
     if (!name || !hasTablePrefix /*|| !createdAt || !updatedAt ||*/ || !Number.isFinite(id)) {
-        throw new DatabaseError(spaceTrim$2(`
+        throw new DatabaseError(spaceTrim$1(`
                 Invalid \`${SERVER_REGISTRY_TABLE_NAME}\` ${label}.
 
                 Fields \`id\`, \`name\`, \`tablePrefix\`, \`createdAt\`, and \`updatedAt\` are required.
@@ -43224,7 +41444,7 @@ async function listRegisteredServersFromDatabase(client) {
         if (isMissingServerRegistryError(error)) {
             return [];
         }
-        throw new DatabaseError(spaceTrim$2((block) => `
+        throw new DatabaseError(spaceTrim$1((block) => `
                     Failed to query global server registry table \`_Server\`.
 
                     ${block(error instanceof Error ? error.message : String(error))}
@@ -43409,7 +41629,7 @@ function selectPrefixesForMigration(configuredPrefixes, registeredServers, onlyT
         invalidTargets.push(onlyTarget);
     }
     if (invalidTargets.length > 0) {
-        throw new DatabaseError(spaceTrim$2(`
+        throw new DatabaseError(spaceTrim$1(`
                 Invalid migration targets specified in \`--only\`: ${invalidTargets
             .map((target) => `\`${target}\``)
             .join(', ')}.
@@ -43517,7 +41737,7 @@ const DATABASE_CONNECTION_ENV_NAMES = ['POSTGRES_URL', 'DATABASE_URL'];
 async function resolveDatabaseMigrationRuntimeConfiguration(logger = console) {
     const connectionString = resolveDatabaseMigrationConnectionStringFromEnvironment();
     if (!connectionString) {
-        throw new DatabaseError(spaceTrim$2(`
+        throw new DatabaseError(spaceTrim$1(`
                 ${DATABASE_CONNECTION_ENV_NAMES.join(' or ')} is not defined.
             `));
     }
@@ -43879,7 +42099,7 @@ function createDestructiveAutoMigrationBlockedError(findings) {
         .map((match) => `${getReadableRuleName(match.rule)}: ${createSqlStatementPreview(match.statement)}`)
         .join(' | ')})`)
         .join('\n');
-    return new DatabaseError(spaceTrim$2((block) => `
+    return new DatabaseError(spaceTrim$1((block) => `
                 Auto-migration blocked because pending testing-server migrations contain potentially destructive SQL.
 
                 Review these migration statements:
@@ -45643,7 +43863,7 @@ function getRunnerMetadata(options, actualModel) {
 async function runCodexPrompts(providedOptions) {
     const options = providedOptions !== null && providedOptions !== void 0 ? providedOptions : parseRunOptions(process.argv.slice(2));
     if (options.allowDestructiveAutoMigrate && !options.autoMigrate) {
-        throw new DatabaseError(spaceTrim$2(`
+        throw new DatabaseError(spaceTrim$1(`
                 Flag \`--allow-destructive-auto-migrate\` requires \`--auto-migrate\`.
             `));
     }
@@ -46297,7 +44517,7 @@ function validateBook(source) {
  * @deprecated Use `$generateBookBoilerplate` instead
  * @public exported from `@promptbook/core`
  */
-padBook(validateBook(spaceTrim$2(`
+padBook(validateBook(spaceTrim$1(`
             AI Avatar
 
             PERSONA A friendly AI assistant that helps you with your tasks
@@ -46324,7 +44544,7 @@ function book(strings, ...values) {
     const bookString = prompt(strings, ...values).toString();
     if (!isValidPipelineString(bookString)) {
         // TODO: Make the CustomError for this
-        throw new Error(spaceTrim$2(`
+        throw new Error(spaceTrim$1(`
                 The string is not a valid pipeline string
 
                 book\`
@@ -46334,7 +44554,7 @@ function book(strings, ...values) {
     }
     if (!isValidBook(bookString)) {
         // TODO: Make the CustomError for this
-        throw new Error(spaceTrim$2(`
+        throw new Error(spaceTrim$1(`
                 The string is not a valid book
 
                 book\`
@@ -47260,7 +45480,7 @@ function promptbookifyAiText(text) {
  * TODO: [🧠][✌️] Make some Promptbook-native token system
  */
 
-const DEFAULT_AGENT_KIT_MODEL_NAME = 'gpt-5-mini-2025-08-07';
+const DEFAULT_AGENT_KIT_MODEL_NAME = 'gpt-5.4-nano';
 /**
  * Creates one structured log entry for streamed tool-call updates.
  *
@@ -47755,7 +45975,7 @@ class OpenAiAgentKitExecutionTools extends OpenAiVectorStoreHandler {
                                     }),
                                 ],
                             };
-                            const errorMessage = spaceTrim$2((block) => `
+                            const errorMessage = spaceTrim$1((block) => `
 
                                         The invoked tool \`${functionName}\` failed with error:
 
@@ -48705,7 +46925,7 @@ class SelfLearningManager {
         if (isJsonSchemaResponseFormat(responseFormat)) {
             const jsonSchema = responseFormat.json_schema;
             const schemaJson = JSON.stringify(jsonSchema, null, 4);
-            userMessageContent = spaceTrim$2((block) => `
+            userMessageContent = spaceTrim$1((block) => `
                     ${block(prompt.content)}
 
                     NOTE Request was made through OpenAI Compatible API with \`response_format\` of type \`json_schema\` with the following schema:
@@ -48736,12 +46956,12 @@ class SelfLearningManager {
         const formattedAgentMessage = formatAgentMessageForJsonMode(result.content, usesJsonSchemaMode);
         const teacherInstructions = extractOpenTeacherInstructions(agentSource);
         const teacherInstructionsSection = teacherInstructions
-            ? spaceTrim$2((block) => `
+            ? spaceTrim$1((block) => `
                       **Teacher instructions:**
                       ${block(teacherInstructions)}
                   `)
             : '';
-        const teacherPromptContent = spaceTrim$2((block) => `
+        const teacherPromptContent = spaceTrim$1((block) => `
 
                 You are a teacher agent helping another agent to learn from its interactions.
 
@@ -48774,7 +46994,7 @@ class SelfLearningManager {
             ? '- This interaction used JSON mode, so the agent answer should stay as a formatted JSON code block.'
             : ''}
                 ${block(isInitialMessageMissing
-            ? spaceTrim$2(`
+            ? spaceTrim$1(`
                             - The agent source does not have an INITIAL MESSAGE defined, generate one.
                             - The INITIAL MESSAGE should be welcoming, informative about the agent capabilities and also should give some quick options to start the conversation with the agent.
                             - The quick option looks like \`[👋 Hello](?message=Hello, how are you?)\`
@@ -48817,7 +47037,7 @@ class SelfLearningManager {
      */
     appendToAgentSource(section) {
         const currentSource = this.options.getAgentSource();
-        const newSource = padBook(validateBook(spaceTrim$2(currentSource) + section));
+        const newSource = padBook(validateBook(spaceTrim$1(currentSource) + section));
         this.options.updateAgentSource(newSource);
     }
 }
@@ -48845,13 +47065,13 @@ function formatAgentMessageForJsonMode(content, isJsonMode) {
     }
     const parsedJson = tryParseJson(content);
     if (parsedJson === null) {
-        return spaceTrim$2((block) => `
+        return spaceTrim$1((block) => `
                 \`\`\`json
                 ${block(content)}
                 \`\`\`
             `);
     }
-    return spaceTrim$2((block) => `
+    return spaceTrim$1((block) => `
             \`\`\`json
             ${block(JSON.stringify(parsedJson, null, 4))}
             \`\`\`
@@ -48883,7 +47103,7 @@ function formatSelfLearningSample(options) {
     const internalMessagesSection = options.internalMessages
         .map((internalMessage) => formatInternalLearningMessage(internalMessage))
         .join('\n\n');
-    return spaceTrim$2((block) => `
+    return spaceTrim$1((block) => `
 
             USER MESSAGE
             ${block(options.userMessageContent)}
@@ -48901,7 +47121,7 @@ function formatSelfLearningSample(options) {
  * @private function of Agent
  */
 function formatInternalLearningMessage(internalMessage) {
-    return spaceTrim$2((block) => `
+    return spaceTrim$1((block) => `
             INTERNAL MESSAGE
             ${block(stringifyInternalLearningPayload(internalMessage))}
         `);
@@ -49367,7 +47587,7 @@ function buildRemoteAgentSource(profile, meta) {
         .filter((line) => Boolean(line))
         .join('\n');
     const personaBlock = profile.personaDescription
-        ? spaceTrim$2((block) => `
+        ? spaceTrim$1((block) => `
             PERSONA
             ${block(profile.personaDescription || '')}
         `)
@@ -49403,7 +47623,7 @@ class RemoteAgent extends Agent {
         // <- TODO: [🐱‍🚀] What about closed-source agents?
         // <- TODO: [🐱‍🚀] Maybe use promptbookFetch
         if (!profileResponse.ok) {
-            throw new Error(spaceTrim$2((block) => `
+            throw new Error(spaceTrim$1((block) => `
                         Failed to fetch remote agent profile:
 
                         Agent URL: