@promptbook/remote-server 0.112.0-12 → 0.112.0-15

package/esm/index.es.js

@@ -1,7 +1,7 @@
 import { join, basename, dirname, isAbsolute } from 'path';
 import { spawn } from 'child_process';
 import colors from 'colors';
-import spaceTrim$2, { spaceTrim as spaceTrim$1 } from 'spacetrim';
+import _spaceTrim, { spaceTrim as spaceTrim$1 } from 'spacetrim';
 import { forTime } from 'waitasecond';
 import express from 'express';
 import * as OpenApiValidator from 'express-openapi-validator';
@@ -9,15 +9,12 @@ import http from 'http';
 import { Server } from 'socket.io';
 import swaggerUi from 'swagger-ui-express';
 import { stat, access, constants, readFile, writeFile, readdir, mkdir, watch, rm } from 'fs/promises';
-import { randomBytes, randomUUID } from 'crypto';
+import { randomBytes } from 'crypto';
 import { SHA256 } from 'crypto-js';
 import hexEncoder from 'crypto-js/enc-hex';
 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 { createElement } from 'react';
 import { renderToStaticMarkup } from 'react-dom/server';
 import { Subject, BehaviorSubject } from 'rxjs';
@@ -43,7 +40,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
@@ -1432,7 +1429,7 @@ async function startAgentServer(options) {
 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}.
@@ -1899,7 +1896,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}"
 
@@ -2245,7 +2242,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
@@ -2264,7 +2261,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\`
@@ -2287,7 +2284,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)}
@@ -2319,7 +2316,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}\`:
@@ -2982,7 +2979,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}
@@ -2996,7 +2993,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:
@@ -3049,7 +3046,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:
@@ -3604,7 +3601,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';
@@ -4036,14 +4033,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)}
@@ -4145,7 +4142,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
@@ -4158,7 +4155,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\`:
@@ -4195,7 +4192,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.
 
@@ -4512,14 +4509,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) => {
@@ -5025,7 +5022,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:
@@ -5185,7 +5182,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:
@@ -5278,7 +5275,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:
@@ -5294,7 +5291,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:
@@ -5869,7 +5866,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:
@@ -5914,7 +5911,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:
@@ -6124,7 +6121,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:
@@ -6927,7 +6924,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\`
@@ -6940,7 +6937,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:
@@ -6957,7 +6954,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}":
@@ -6997,7 +6994,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})
@@ -7021,7 +7018,7 @@ async function executeFormatSubvalues(options) {
                     ...options,
                     priority: priority + index,
                     parameters: allSubparameters,
-                    pipelineIdentification: spaceTrim$2((block) => `
+                    pipelineIdentification: spaceTrim$1((block) => `
                             ${block(pipelineIdentification)}
                             Subparameter index: ${index}
                         `),
@@ -7030,7 +7027,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})
@@ -7920,13 +7917,13 @@ function $registeredLlmToolsMessage() {
     });
     const usedEnvMessage = `Unknown \`.env\` file` ;
     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)}
 
@@ -7972,7 +7969,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('; ')}
                             `);
@@ -8018,7 +8015,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'}
 
@@ -8397,7 +8394,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'))}
 
@@ -8470,7 +8467,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) => {
@@ -8511,7 +8508,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);
     }
@@ -8520,7 +8517,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))}}
@@ -8601,7 +8598,7 @@ function attachClientVersionHeader(headers) {
  * @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
@@ -10510,8 +10507,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 = [];
             /*
@@ -10524,7 +10521,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({
@@ -10877,2200 +10874,190 @@ 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.
+ * Cached implementation of `run_browser` when it can be resolved.
  *
- * @private internal runtime wiring for commitment tools
+ * @private internal utility for USE BROWSER commitment
  */
-let toolCallProgressListenerCounter = 0;
+let cachedRunBrowserTool = null;
 /**
- * Active tool-progress listeners keyed by hidden execution token.
+ * Cached loading error to avoid repeating expensive resolution attempts.
  *
- * @private internal runtime wiring for commitment tools
+ * @private internal utility for USE BROWSER commitment
  */
-const toolCallProgressListeners = new Map();
+let cachedRunBrowserToolError = null;
 /**
- * Parses unknown runtime context payload into a normalized object.
+ * Attempts to load the server-side `run_browser` tool lazily.
  *
- * @private internal runtime wiring for commitment tools
+ * @returns Loaded `run_browser` implementation
+ * @private internal utility for USE BROWSER commitment
  */
-function parseToolRuntimeContext(rawValue) {
-    if (!rawValue) {
-        return null;
+function loadRunBrowserToolForNode() {
+    if (cachedRunBrowserTool !== null) {
+        return cachedRunBrowserTool;
     }
-    let parsed = rawValue;
-    if (typeof rawValue === 'string') {
-        try {
-            parsed = JSON.parse(rawValue);
-        }
-        catch (_a) {
-            return null;
+    if (cachedRunBrowserToolError !== null) {
+        throw cachedRunBrowserToolError;
+    }
+    try {
+        // 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);
         }
+        cachedRunBrowserTool = runBrowserModule.run_browser;
+        return cachedRunBrowserTool;
     }
-    if (!parsed || typeof parsed !== 'object') {
-        return null;
+    catch (error) {
+        assertsError(error);
+        cachedRunBrowserToolError = error;
+        throw error;
     }
-    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.
+ * Resolves the server-side implementation of the `run_browser` tool for Node.js environments.
  *
- * @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.
+ * 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 runtime wiring for commitment tools
+ * @private internal utility for USE BROWSER commitment
  */
-function serializeToolRuntimeContext(context) {
-    return JSON.stringify(context);
+function resolveRunBrowserToolForNode() {
+    return async (args) => {
+        try {
+            const runBrowserTool = loadRunBrowserToolForNode();
+            return await runBrowserTool(args);
+        }
+        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.
+
+                        ${error.name}:
+                        ${block(error.message)}
+                    `));
+        }
+    };
 }
+
 /**
- * Registers one in-memory listener that receives progress updates emitted by a running tool.
+ * Resolves the server-side implementation of the send_email tool for Node.js environments.
  *
- * 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.
+ * This uses a lazy require so the core package can still load even if the Agents Server
+ * module is unavailable. When the server tool cannot be resolved, a fallback implementation
+ * throws a helpful error message.
  *
- * @param listener - Listener notified about tool progress.
- * @returns Hidden token used to route progress updates.
- * @private internal runtime wiring for commitment tools
+ * @private internal utility for USE EMAIL commitment
  */
-function registerToolCallProgressListener(listener) {
-    toolCallProgressListenerCounter += 1;
-    const token = `tool-progress:${Date.now()}:${toolCallProgressListenerCounter}`;
-    toolCallProgressListeners.set(token, listener);
-    return token;
+function resolveSendEmailToolForNode() {
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-var-requires
+        const { send_email } = require('../../../apps/agents-server/src/tools/send_email');
+        if (typeof send_email !== 'function') {
+            throw new Error('send_email value is not a function but ' + typeof send_email);
+        }
+        return send_email;
+    }
+    catch (error) {
+        const normalizedError = error instanceof Error
+            ? error
+            : new Error(typeof error === 'string' ? error : JSON.stringify(error !== null && error !== void 0 ? error : 'Unknown error'));
+        return async () => {
+            throw new EnvironmentMismatchError(spaceTrim$1((block) => `
+                        \`send_email\` tool is not available in this environment.
+                        This commitment requires Agents Server runtime with wallet-backed SMTP sending.
+
+                        ${normalizedError.name}:
+                        ${block(normalizedError.message)}
+                    `));
+        };
+    }
 }
+
 /**
- * Unregisters one in-memory progress listener.
+ * Resolves the server-side `spawn_agent` tool for Node.js runtimes.
  *
- * @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.
+ * Uses lazy require so core package can load outside Agents Server.
  *
- * @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
+ * @private internal utility for USE SPAWN commitment
  */
-function emitToolCallProgressFromToolArgs(args, update) {
-    const token = readToolProgressTokenFromToolArgs(args);
-    if (!token) {
-        return false;
+function resolveSpawnAgentToolForNode() {
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-var-requires
+        const { spawn_agent } = require('../../../apps/agents-server/src/tools/spawn_agent');
+        if (typeof spawn_agent !== 'function') {
+            throw new Error('spawn_agent value is not a function but ' + typeof spawn_agent);
+        }
+        return spawn_agent;
     }
-    const listener = toolCallProgressListeners.get(token);
-    if (!listener) {
-        return false;
+    catch (error) {
+        const normalizedError = error instanceof Error
+            ? error
+            : new Error(typeof error === 'string' ? error : JSON.stringify(error !== null && error !== void 0 ? error : 'Unknown error'));
+        return async () => {
+            throw new EnvironmentMismatchError(spaceTrim$1((block) => `
+                        \`spawn_agent\` tool is not available in this environment.
+                        This commitment requires Agents Server runtime with agent persistence enabled.
+
+                        ${normalizedError.name}:
+                        ${block(normalizedError.message)}
+                    `));
+        };
     }
-    listener(update);
-    return true;
 }
-/**
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */
 
 /**
- * Logical public directory marker used in `run_browser` payload paths.
+ * Generates a regex pattern to match a specific commitment
  *
- * 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(pathname) {
-    return pathname.split('\\').join('/');
-}
-/**
- * Resolves writable filesystem directory used for artifact persistence.
+ * Note: It always creates new Regex object
+ * Note: Uses word boundaries to ensure only full words are matched (e.g., "PERSONA" matches but "PERSONALITY" does not)
+ *
+ * @private - TODO: [🧠] Maybe should be public?
  */
-function resolveRunBrowserArtifactStorageDirectory() {
-    const configuredStorageDirectory = process.env[RUN_BROWSER_ARTIFACT_STORAGE_DIRECTORY_ENV];
-    if (configuredStorageDirectory && configuredStorageDirectory.trim()) {
-        return configuredStorageDirectory.trim();
+function createCommitmentRegex(commitment, aliases = [], requiresContent = true) {
+    const allCommitments = [commitment, ...aliases];
+    const patterns = allCommitments.map((commitment) => {
+        const escapedCommitment = commitment.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+        return escapedCommitment.split(/\s+/).join('\\s+');
+    });
+    const keywordPattern = patterns.join('|');
+    if (requiresContent) {
+        return new RegExp(`^\\s*(?<type>${keywordPattern})\\b\\s+(?<contents>.+)$`, 'gim');
+    }
+    else {
+        return new RegExp(`^\\s*(?<type>${keywordPattern})\\b(?:\\s+(?<contents>.+))?$`, 'gim');
     }
-    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.
+ * Generates a regex pattern to match a specific commitment type
+ *
+ * Note: It just matches the type part of the commitment
+ * Note: It always creates new Regex object
+ * Note: Uses word boundaries to ensure only full words are matched (e.g., "PERSONA" matches but "PERSONALITY" does not)
+ *
+ * @private
  */
-function resolveRunBrowserArtifactPublicPath(artifactFilename) {
-    return toPosixPath(`${RUN_BROWSER_ARTIFACT_PUBLIC_DIRECTORY}/${artifactFilename}`);
+function createCommitmentTypeRegex(commitment, aliases = []) {
+    const allCommitments = [commitment, ...aliases];
+    const patterns = allCommitments.map((commitment) => {
+        const escapedCommitment = commitment.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+        return escapedCommitment.split(/\s+/).join('\\s+');
+    });
+    const keywordPattern = patterns.join('|');
+    const regex = new RegExp(`^\\s*(?<type>${keywordPattern})\\b`, 'gim');
+    return regex;
 }
 
 /**
- * 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.
+ * Base implementation of CommitmentDefinition that provides common functionality
+ * Most commitments can extend this class and only override the applyToAgentModelRequirements method
+ *
+ * @private
  */
-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
- */
-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;
-        }
-    }
-}
-
-/**
- * Singleton instance of the browser connection provider.
- *
- * @private internal cache for `$provideBrowserForServer`
- */
-let browserProvider = 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.
- *
- * @param options - Optional runtime request options used for cancellation and logging context.
- * @returns Browser context instance
- */
-async function $provideBrowserForServer(options = {}) {
-    if (browserProvider === null) {
-        browserProvider = new BrowserConnectionProvider({ isVerbose: false });
-    }
-    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;
-    }
-    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,
-            });
-        }
-        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,
-        });
-    }
-    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);
-    }
-}
-
-/**
- * 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.
- * 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 run_browser;
-    }
-    catch (error) {
-        assertsError(error);
-        return async () => {
-            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.
-
-                        ${error.name}:
-                        ${block(error.message)}
-                    `));
-        };
-    }
-}
-
-/**
- * Resolves the server-side implementation of the send_email tool for Node.js environments.
- *
- * This uses a lazy require so the core package can still load even if the Agents Server
- * module is unavailable. When the server tool cannot be resolved, a fallback implementation
- * throws a helpful error message.
- *
- * @private internal utility for USE EMAIL commitment
- */
-function resolveSendEmailToolForNode() {
-    try {
-        // eslint-disable-next-line @typescript-eslint/no-var-requires
-        const { send_email } = require('../../../apps/agents-server/src/tools/send_email');
-        if (typeof send_email !== 'function') {
-            throw new Error('send_email value is not a function but ' + typeof send_email);
-        }
-        return send_email;
-    }
-    catch (error) {
-        const normalizedError = error instanceof Error
-            ? error
-            : new Error(typeof error === 'string' ? error : JSON.stringify(error !== null && error !== void 0 ? error : 'Unknown error'));
-        return async () => {
-            throw new EnvironmentMismatchError(spaceTrim$1((block) => `
-                        \`send_email\` tool is not available in this environment.
-                        This commitment requires Agents Server runtime with wallet-backed SMTP sending.
-
-                        ${normalizedError.name}:
-                        ${block(normalizedError.message)}
-                    `));
-        };
-    }
-}
-
-/**
- * Resolves the server-side `spawn_agent` tool for Node.js runtimes.
- *
- * Uses lazy require so core package can load outside Agents Server.
- *
- * @private internal utility for USE SPAWN commitment
- */
-function resolveSpawnAgentToolForNode() {
-    try {
-        // eslint-disable-next-line @typescript-eslint/no-var-requires
-        const { spawn_agent } = require('../../../apps/agents-server/src/tools/spawn_agent');
-        if (typeof spawn_agent !== 'function') {
-            throw new Error('spawn_agent value is not a function but ' + typeof spawn_agent);
-        }
-        return spawn_agent;
-    }
-    catch (error) {
-        const normalizedError = error instanceof Error
-            ? error
-            : new Error(typeof error === 'string' ? error : JSON.stringify(error !== null && error !== void 0 ? error : 'Unknown error'));
-        return async () => {
-            throw new EnvironmentMismatchError(spaceTrim$1((block) => `
-                        \`spawn_agent\` tool is not available in this environment.
-                        This commitment requires Agents Server runtime with agent persistence enabled.
-
-                        ${normalizedError.name}:
-                        ${block(normalizedError.message)}
-                    `));
-        };
-    }
-}
-
-/**
- * Generates a regex pattern to match a specific commitment
- *
- * Note: It always creates new Regex object
- * Note: Uses word boundaries to ensure only full words are matched (e.g., "PERSONA" matches but "PERSONALITY" does not)
- *
- * @private - TODO: [🧠] Maybe should be public?
- */
-function createCommitmentRegex(commitment, aliases = [], requiresContent = true) {
-    const allCommitments = [commitment, ...aliases];
-    const patterns = allCommitments.map((commitment) => {
-        const escapedCommitment = commitment.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
-        return escapedCommitment.split(/\s+/).join('\\s+');
-    });
-    const keywordPattern = patterns.join('|');
-    if (requiresContent) {
-        return new RegExp(`^\\s*(?<type>${keywordPattern})\\b\\s+(?<contents>.+)$`, 'gim');
-    }
-    else {
-        return new RegExp(`^\\s*(?<type>${keywordPattern})\\b(?:\\s+(?<contents>.+))?$`, 'gim');
-    }
-}
-/**
- * Generates a regex pattern to match a specific commitment type
- *
- * Note: It just matches the type part of the commitment
- * Note: It always creates new Regex object
- * Note: Uses word boundaries to ensure only full words are matched (e.g., "PERSONA" matches but "PERSONALITY" does not)
- *
- * @private
- */
-function createCommitmentTypeRegex(commitment, aliases = []) {
-    const allCommitments = [commitment, ...aliases];
-    const patterns = allCommitments.map((commitment) => {
-        const escapedCommitment = commitment.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
-        return escapedCommitment.split(/\s+/).join('\\s+');
-    });
-    const keywordPattern = patterns.join('|');
-    const regex = new RegExp(`^\\s*(?<type>${keywordPattern})\\b`, 'gim');
-    return regex;
-}
-
-/**
- * Base implementation of CommitmentDefinition that provides common functionality
- * Most commitments can extend this class and only override the applyToAgentModelRequirements method
- *
- * @private
- */
-class BaseCommitmentDefinition {
-    constructor(type, aliases = []) {
-        this.type = type;
-        this.aliases = aliases;
+class BaseCommitmentDefinition {
+    constructor(type, aliases = []) {
+        this.type = type;
+        this.aliases = aliases;
     }
     /**
      * Whether this commitment requires content.
@@ -14716,74 +12703,178 @@ function getMemoryToolRuntimeAdapterOrDisabledResult(action, runtimeContext) {
         };
     }
 }
-
+
+/**
+ * Parses a memory identifier argument shared across MEMORY tools.
+ *
+ * @private function of MemoryCommitmentDefinition
+ */
+function parseMemoryIdArg(value) {
+    const memoryId = typeof value === 'string' ? value.trim() : '';
+    if (!memoryId) {
+        throw new Error('Memory id is required.');
+    }
+    return memoryId;
+}
+/**
+ * Collection of MEMORY tool argument parsers.
+ *
+ * @private function of MemoryCommitmentDefinition
+ */
+const parseMemoryToolArgs = {
+    /**
+     * Parses retrieve memory arguments.
+     */
+    retrieve(args) {
+        const query = typeof args.query === 'string' ? args.query.trim() : undefined;
+        const limit = typeof args.limit === 'number' && Number.isFinite(args.limit) ? Math.floor(args.limit) : undefined;
+        return {
+            query: query && query.length > 0 ? query : undefined,
+            limit: limit && limit > 0 ? Math.min(limit, 20) : undefined,
+        };
+    },
+    /**
+     * Parses store memory arguments.
+     */
+    store(args) {
+        const content = typeof args.content === 'string' ? args.content.trim() : '';
+        if (!content) {
+            throw new Error('Memory content is required.');
+        }
+        return {
+            content,
+            isGlobal: args.isGlobal === true,
+        };
+    },
+    /**
+     * Parses update memory arguments.
+     */
+    update(args) {
+        const memoryId = parseMemoryIdArg(args.memoryId);
+        const content = typeof args.content === 'string' ? args.content.trim() : '';
+        if (!content) {
+            throw new Error('Memory content is required.');
+        }
+        const isGlobal = typeof args.isGlobal === 'boolean' ? args.isGlobal : undefined;
+        return {
+            memoryId,
+            content,
+            isGlobal,
+        };
+    },
+    /**
+     * Parses delete memory arguments.
+     */
+    delete(args) {
+        return {
+            memoryId: parseMemoryIdArg(args.memoryId),
+        };
+    },
+};
+
+/**
+ * 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;
+}
 /**
- * Parses a memory identifier argument shared across MEMORY tools.
+ * Unregisters one in-memory progress listener.
  *
- * @private function of MemoryCommitmentDefinition
+ * @param token - Token previously created by `registerToolCallProgressListener`.
+ * @private internal runtime wiring for commitment tools
  */
-function parseMemoryIdArg(value) {
-    const memoryId = typeof value === 'string' ? value.trim() : '';
-    if (!memoryId) {
-        throw new Error('Memory id is required.');
-    }
-    return memoryId;
+function unregisterToolCallProgressListener(token) {
+    toolCallProgressListeners.delete(token);
 }
 /**
- * Collection of MEMORY tool argument parsers.
- *
- * @private function of MemoryCommitmentDefinition
+ * Note: [💞] Ignore a discrepancy between file name and entity name
  */
-const parseMemoryToolArgs = {
-    /**
-     * Parses retrieve memory arguments.
-     */
-    retrieve(args) {
-        const query = typeof args.query === 'string' ? args.query.trim() : undefined;
-        const limit = typeof args.limit === 'number' && Number.isFinite(args.limit) ? Math.floor(args.limit) : undefined;
-        return {
-            query: query && query.length > 0 ? query : undefined,
-            limit: limit && limit > 0 ? Math.min(limit, 20) : undefined,
-        };
-    },
-    /**
-     * Parses store memory arguments.
-     */
-    store(args) {
-        const content = typeof args.content === 'string' ? args.content.trim() : '';
-        if (!content) {
-            throw new Error('Memory content is required.');
-        }
-        return {
-            content,
-            isGlobal: args.isGlobal === true,
-        };
-    },
-    /**
-     * Parses update memory arguments.
-     */
-    update(args) {
-        const memoryId = parseMemoryIdArg(args.memoryId);
-        const content = typeof args.content === 'string' ? args.content.trim() : '';
-        if (!content) {
-            throw new Error('Memory content is required.');
-        }
-        const isGlobal = typeof args.isGlobal === 'boolean' ? args.isGlobal : undefined;
-        return {
-            memoryId,
-            content,
-            isGlobal,
-        };
-    },
-    /**
-     * Parses delete memory arguments.
-     */
-    delete(args) {
-        return {
-            memoryId: parseMemoryIdArg(args.memoryId),
-        };
-    },
-};
 
 /**
  * Resolves runtime context from hidden tool arguments.
@@ -22493,9 +20584,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)}
         `);
@@ -22556,13 +20647,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',
@@ -22589,6 +20673,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.
  *
@@ -22623,6 +20719,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,
+        };
+    },
 };
 
 /**
@@ -22633,6 +20754,7 @@ const parseTimeoutToolArgs = {
 const TimeoutToolNames = {
     set: 'set_timeout',
     cancel: 'cancel_timeout',
+    list: 'list_timeouts',
 };
 
 /**
@@ -22732,6 +20854,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);
+            }
+        },
     };
 }
 
@@ -22765,26 +20916,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
  */
@@ -22799,7 +20969,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.
@@ -22814,14 +20984,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
@@ -22850,6 +21021,7 @@ class UseTimeoutCommitmentDefinition extends BaseCommitmentDefinition {
         return {
             [TimeoutToolNames.set]: 'Set timer',
             [TimeoutToolNames.cancel]: 'Cancel timer',
+            [TimeoutToolNames.list]: 'List timers',
         };
     }
     /**
@@ -23703,7 +21875,7 @@ function getAllCommitmentsToolFunctionsForNode() {
 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'))}
@@ -23812,7 +21984,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);
@@ -23903,7 +22075,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)}
@@ -23918,7 +22090,7 @@ class JavascriptEvalExecutionTools {
                 (async ()=>{ ${script} })()
             `);
         if (this.options.isVerbose) {
-            console.info(spaceTrim$2((block) => `
+            console.info(_spaceTrim((block) => `
                         🚀 Evaluating ${scriptLanguage} script:
 
                         ${block(statementToEvaluate)}`));
@@ -23927,7 +22099,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))}
                         `));
@@ -23946,7 +22118,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
 
@@ -23968,7 +22140,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
@@ -25325,7 +23497,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
@@ -25374,7 +23546,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\`
@@ -25384,7 +23556,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\`
@@ -25668,7 +23840,7 @@ function computeAgentHash(agentSource) {
  * @public exported from `@promptbook/core`
  */
 function normalizeAgentName(rawAgentName) {
-    return titleToName(spaceTrim$2(rawAgentName));
+    return titleToName(spaceTrim$1(rawAgentName));
 }
 
 /**
@@ -26112,7 +24284,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;
             }
@@ -26135,7 +24307,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 {
@@ -26173,7 +24345,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';
@@ -26232,7 +24404,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;
@@ -26242,11 +24414,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') {
@@ -26254,7 +24426,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') {
@@ -26270,7 +24442,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') {
@@ -26279,10 +24451,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) {
@@ -26313,7 +24485,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;
     }
@@ -26326,7 +24498,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();
 }
 /**
@@ -27586,7 +25758,7 @@ function pricing(value) {
 /**
  * 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/
@@ -27708,8 +25880,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`),
             },
         },
         /**/
@@ -27720,8 +25892,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`),
             },
         },
         /**/
@@ -27732,8 +25904,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`),
             },
         },
         /**/
@@ -27744,8 +25916,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`),
             },
         },
         /**/
@@ -27756,8 +25928,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`),
             },
         },
         /**/
@@ -27768,8 +25940,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`),
             },
         },
         /**/
@@ -28127,8 +26299,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`),
             },
         },
         /**/
@@ -28139,8 +26311,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`),
             },
         },
         /**/
@@ -28211,8 +26383,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`),
             },
         },
         /**/
@@ -28312,53 +26484,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
  *
@@ -28415,6 +26540,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.
  */
@@ -29381,7 +27553,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:
@@ -30307,7 +28479,7 @@ class OpenAiVectorStoreHandler extends OpenAiExecutionTools {
     }
 }
 
-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.
  *
@@ -30802,7 +28974,7 @@ class OpenAiAgentKitExecutionTools extends OpenAiVectorStoreHandler {
                                     }),
                                 ],
                             };
-                            const errorMessage = spaceTrim$2((block) => `
+                            const errorMessage = spaceTrim$1((block) => `
 
                                         The invoked tool \`${functionName}\` failed with error:
 
@@ -31520,7 +29692,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:
                                         
@@ -32528,7 +30700,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:
@@ -32559,12 +30731,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.
 
@@ -32597,7 +30769,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?)\`
@@ -32640,7 +30812,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);
     }
 }
@@ -32668,13 +30840,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))}
             \`\`\`
@@ -32706,7 +30878,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)}
@@ -32724,7 +30896,7 @@ function formatSelfLearningSample(options) {
  * @private function of Agent
  */
 function formatInternalLearningMessage(internalMessage) {
-    return spaceTrim$2((block) => `
+    return spaceTrim$1((block) => `
             INTERNAL MESSAGE
             ${block(stringifyInternalLearningPayload(internalMessage))}
         `);
@@ -33190,7 +31362,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 || '')}
         `)
@@ -33226,7 +31398,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: