@promptbook/components 0.112.0-58 → 0.112.0-60

package/esm/index.es.js

@@ -40,7 +40,7 @@ const BOOK_LANGUAGE_VERSION = '2.0.0';
  * @generated
  * @see https://github.com/webgptorg/promptbook
  */
-const PROMPTBOOK_ENGINE_VERSION = '0.112.0-58';
+const PROMPTBOOK_ENGINE_VERSION = '0.112.0-60';
 /**
  * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
  * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -9530,6 +9530,49 @@ class BaseCommitmentDefinition {
             return this.appendToSystemMessage(requirements, commentSection);
         }
     }
+    /**
+     * Helper method to append a bullet point to an existing `## SectionTitle` section in the system
+     * message, or to create a new section when it does not yet exist.
+     *
+     * Handles the case where the same commitment type appears multiple times in the book source and
+     * all entries should be grouped under one shared heading rather than emitting a duplicate block.
+     *
+     * @param requirements - Current model requirements.
+     * @param sectionTitle - Section title without the `##` prefix.
+     * @param bulletContent - Bullet content without the leading `-   ` prefix.
+     * @returns Requirements with the bullet appended to the section.
+     */
+    appendBulletPointToSection(requirements, sectionTitle, bulletContent) {
+        const sectionHeader = `## ${sectionTitle}`;
+        const bullet = `-   ${bulletContent}`;
+        if (requirements.systemMessage.includes(sectionHeader)) {
+            // Append bullet to end of existing section, before the next h2 heading or end of message
+            const newSystemMessage = requirements.systemMessage.replace(new RegExp(`(## ${sectionTitle.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}\\n\\n)([\\s\\S]*?)(?=\\n\\n##|$)`), `$1$2\n${bullet}`);
+            return { ...requirements, systemMessage: newSystemMessage };
+        }
+        return this.appendToSystemMessage(requirements, `${sectionHeader}\n\n${bullet}`, '\n\n');
+    }
+    /**
+     * Helper method to replace an existing `## SectionTitle` section in the system message, or to
+     * append a new one when the section does not yet exist.
+     *
+     * Use this when a commitment type can appear multiple times and each subsequent occurrence should
+     * update the single shared section rather than appending a duplicate block.
+     *
+     * @param requirements - Current model requirements.
+     * @param sectionTitle - Section title without the `##` prefix.
+     * @param sectionContent - Full section content including the `## Title` header line.
+     * @returns Requirements with the section replaced or appended.
+     */
+    replaceOrCreateSection(requirements, sectionTitle, sectionContent) {
+        const sectionHeader = `## ${sectionTitle}`;
+        if (requirements.systemMessage.includes(sectionHeader)) {
+            // Replace all text from the heading until the next h2 heading or end of message
+            const newSystemMessage = requirements.systemMessage.replace(new RegExp(`## ${sectionTitle.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}[\\s\\S]*?(?=\\n\\n##|$)`), sectionContent);
+            return { ...requirements, systemMessage: newSystemMessage };
+        }
+        return this.appendToSystemMessage(requirements, sectionContent, '\n\n');
+    }
     /**
      * Gets tool function implementations provided by this commitment
      *
@@ -10009,20 +10052,16 @@ class DictionaryCommitmentDefinition extends BaseCommitmentDefinition {
         if (!trimmedContent) {
             return requirements;
         }
-        // Get existing dictionary entries from metadata
+        // Store the entry in metadata for debugging and inspection
         const existingDictionary = ((_a = requirements._metadata) === null || _a === void 0 ? void 0 : _a.DICTIONARY) || '';
-        // Merge the new dictionary entry with existing entries
         const mergedDictionary = existingDictionary ? `${existingDictionary}\n${trimmedContent}` : trimmedContent;
-        // Store the merged dictionary in metadata for debugging and inspection
         const updatedMetadata = {
             ...requirements._metadata,
             DICTIONARY: mergedDictionary,
         };
-        // Create the dictionary section for the system message
-        // Format: "# DICTIONARY\nTerm: definition\nTerm: definition..."
-        const dictionarySection = `# DICTIONARY\n${mergedDictionary}`;
+        // Append each dictionary entry as a bullet point under ## Dictionary
         return {
-            ...this.appendToSystemMessage(requirements, dictionarySection),
+            ...this.appendBulletPointToSection(requirements, 'Dictionary', trimmedContent),
             _metadata: updatedMetadata,
         };
     }
@@ -10536,10 +10575,10 @@ class GoalCommitmentDefinition extends BaseCommitmentDefinition {
         if (!trimmedContent) {
             return requirements;
         }
-        // Add goal to the system message
-        const goalSection = `Goal: ${trimmedContent}`;
+        // Add goal as a proper h2 section to the system message
+        const goalSection = `## Goal\n\n${trimmedContent}`;
         const requirementsWithGoal = this.appendToSystemMessage(requirements, goalSection, '\n\n');
-        return this.appendToPromptSuffix(requirementsWithGoal, goalSection);
+        return this.appendToPromptSuffix(requirementsWithGoal, trimmedContent);
     }
 }
 // Note: [💞] Ignore a discrepancy between file name and entity name
@@ -11059,11 +11098,8 @@ class LanguageCommitmentDefinition extends BaseCommitmentDefinition {
         if (!trimmedContent) {
             return requirements;
         }
-        // Add language rule to the system message
-        const languageSection = this.createSystemMessageSection('Language:', spaceTrim$1((block) => `
-                    ${block(trimmedContent)}
-                    <- You are speaking these languages in your responses to the user.
-                `));
+        // Add language as a bullet under a ## Language section
+        const languageSection = `## Language\n\n-   Your language is ${trimmedContent}`;
         return this.appendToSystemMessage(requirements, languageSection, '\n\n');
     }
 }
@@ -11107,15 +11143,16 @@ const MemoryToolNames = {
  */
 function createMemorySystemMessage(extraInstructions) {
     return spaceTrim$1((block) => `
-            Memory:
-            - Prefer storing agent-scoped memories; only make them global when the fact should apply across all your agents.
-            - You can use persistent user memory tools.
-            - Use "${MemoryToolNames.retrieve}" to load relevant memory before answering.
-            - Use "${MemoryToolNames.store}" to save stable user-specific facts that improve future help.
-            - Use "${MemoryToolNames.update}" to refresh an existing memory when the content changes.
-            - Use "${MemoryToolNames.delete}" to delete memories that are no longer accurate (deletions are soft and hidden from future queries).
-            - Store concise memory items and avoid duplicates.
-            - Never claim memory was saved or loaded unless the tool confirms it.
+            ## Memory
+
+            -   Prefer storing agent-scoped memories; only make them global when the fact should apply across all your agents.
+            -   You can use persistent user memory tools.
+            -   Use \`${MemoryToolNames.retrieve}\` to load relevant memory before answering.
+            -   Use \`${MemoryToolNames.store}\` to save stable user-specific facts that improve future help.
+            -   Use \`${MemoryToolNames.update}\` to refresh an existing memory when the content changes.
+            -   Use \`${MemoryToolNames.delete}\` to delete memories that are no longer accurate (deletions are soft and hidden from future queries).
+            -   Store concise memory items and avoid duplicates.
+            -   Never claim memory was saved or loaded unless the tool confirms it.
             ${block(extraInstructions)}
         `);
 }
@@ -12037,10 +12074,8 @@ class MessageCommitmentDefinition extends BaseCommitmentDefinition {
         if (!trimmedContent) {
             return requirements;
         }
-        // Create message section for system message
-        const messageSection = `Previous Message: ${trimmedContent}`;
         // Messages represent conversation history and should be included for context
-        return this.appendToSystemMessage(requirements, messageSection, '\n\n');
+        return this.appendBulletPointToSection(requirements, 'Previous messages', trimmedContent);
     }
 }
 // Note: [💞] Ignore a discrepancy between file name and entity name
@@ -13677,10 +13712,9 @@ class RuleCommitmentDefinition extends BaseCommitmentDefinition {
         if (!trimmedContent) {
             return requirements;
         }
-        // Add rule to the system message
-        const ruleSection = `Rule: ${trimmedContent}`;
-        const requirementsWithRule = this.appendToSystemMessage(requirements, ruleSection, '\n\n');
-        return this.appendToPromptSuffix(requirementsWithRule, ruleSection);
+        // Group all rules under a single ## Rules section as bullet points
+        const requirementsWithRule = this.appendBulletPointToSection(requirements, 'Rules', trimmedContent);
+        return this.appendToPromptSuffix(requirementsWithRule, `-   ${trimmedContent}`);
     }
 }
 // Note: [💞] Ignore a discrepancy between file name and entity name
@@ -13916,10 +13950,8 @@ class ScenarioCommitmentDefinition extends BaseCommitmentDefinition {
         if (!trimmedContent) {
             return requirements;
         }
-        // Create scenario section for system message
-        const scenarioSection = `Scenario: ${trimmedContent}`;
         // Scenarios provide important contextual information that affects behavior
-        return this.appendToSystemMessage(requirements, scenarioSection, '\n\n');
+        return this.appendBulletPointToSection(requirements, 'Scenarios', trimmedContent);
     }
 }
 // Note: [💞] Ignore a discrepancy between file name and entity name
@@ -14302,8 +14334,8 @@ const teamToolTitles = {};
  * @private
  */
 const TEAM_SYSTEM_MESSAGE_GUIDANCE_LINES = [
-    '- If a teammate is relevant to the request, consult that teammate using the matching tool.',
-    '- Do not ask the user for information that a listed teammate can provide directly.',
+    '-   If a teammate is relevant to the request, consult that teammate using the matching tool.',
+    '-   Do not ask the user for information that a listed teammate can provide directly.',
 ];
 /**
  * Constant for remote agents by Url.
@@ -14431,7 +14463,7 @@ class TeamCommitmentDefinition extends BaseCommitmentDefinition {
                 toolName: entry.toolName,
             });
         }
-        const teamSystemMessage = this.createSystemMessageSection('Teammates:', buildTeamSystemMessageBody(teamEntries));
+        const teamSystemMessage = this.createSystemMessageSection('Teammates', buildTeamSystemMessageBody(teamEntries));
         return this.appendToSystemMessage({
             ...requirements,
             tools: updatedTools,
@@ -14921,36 +14953,38 @@ function createAggregatedUseCommitmentSystemMessage(type, additionalInstructions
     switch (type) {
         case 'USE TIME':
             return spaceTrim$1((block) => `
-                    Time and date context:
-                    - It is ${moment().format('MMMM YYYY')} now.
-                    - If you need more precise current time information, use the tool "get_current_time".
+                    ## Time and date context
+
+                    -   It is ${moment().format('MMMM YYYY')} now.
+                    -   If you need more precise current time information, use the tool \`get_current_time\`.
                     ${block(formatOptionalInstructionBlock('Time instructions', combinedAdditionalInstructions))}
                 `);
         case 'USE BROWSER':
             return spaceTrim$1((block) => `
-                    You have access to browser tools to fetch and access content from the internet.
-                    - Use "fetch_url_content" to retrieve content from specific URLs (webpages or documents) using scrapers.
-                    - Use "run_browser" for real interactive browser automation (navigation, clicks, typing, waiting, scrolling).
-                    When you need to know information from a specific website or document, use the fetch_url_content tool.
+                    ## Browser
+
+                    -   Use \`fetch_url_content\` to retrieve content from specific URLs (webpages or documents) using scrapers.
+                    -   Use \`run_browser\` for real interactive browser automation (navigation, clicks, typing, waiting, scrolling).
+                    -   When you need to know information from a specific website or document, use the tools provided.
                     ${block(formatOptionalInstructionBlock('Browser instructions', combinedAdditionalInstructions))}
                 `);
         case 'USE SEARCH ENGINE':
             return spaceTrim$1((block) => `
-                    Tool:
-                    - You have access to the web search engine via the tool "web_search".
-                    - Use it to find up-to-date information or facts that you don't know.
-                    - When you need to know some information from the internet, use the tool provided to you.
-                    - Do not make up information when you can search for it.
-                    - Do not tell the user you cannot search for information, YOU CAN.
+                    ## Web Search
+
+                    -   Use \`web_search\` to find up-to-date information or facts.
+                    -   When you need to know some information from the internet, use the search tool provided.
+                    -   Do not make up information when you can search for it.
+                    -   Do not tell the user you cannot search for information, YOU CAN.
                     ${block(formatOptionalInstructionBlock('Search instructions', combinedAdditionalInstructions))}
                 `);
         case 'USE DEEPSEARCH':
             return spaceTrim$1((block) => `
-                    Tool:
-                    - You have access to DeepSearch via the tool "deep_search".
-                    - Use it for broader research tasks that need multi-step investigation, comparison, or synthesis across multiple sources.
-                    - Prefer it over quick search when the user asks for a well-grounded brief, report, or deeper investigation.
-                    - Do not pretend you cannot research current information when this tool is available.
+                    ## Deep Research
+
+                    -   Use \`deep_search\` for broader research tasks that need multi-step investigation, comparison, or synthesis across multiple sources.
+                    -   Prefer it over quick search when the user asks for a well-grounded brief, report, or deeper investigation.
+                    -   Do not pretend you cannot research current information when this tool is available.
                     ${block(formatOptionalInstructionBlock('DeepSearch instructions', combinedAdditionalInstructions))}
                 `);
     }
@@ -15280,96 +15314,6 @@ class UseBrowserCommitmentDefinition extends BaseCommitmentDefinition {
 }
 // Note: [💞] Ignore a discrepancy between file name and entity name
 
-/**
- * Base Google Calendar API URL.
- *
- * @private constant of callGoogleCalendarApi
- */
-const GOOGLE_CALENDAR_API_BASE_URL = 'https://www.googleapis.com/calendar/v3';
-/**
- * Runs one Google Calendar API request and parses JSON response payload.
- *
- * @private function of UseCalendarCommitmentDefinition
- */
-async function callGoogleCalendarApi(accessToken, options) {
-    const url = new URL(options.path, GOOGLE_CALENDAR_API_BASE_URL);
-    if (options.query) {
-        for (const [key, value] of Object.entries(options.query)) {
-            if (value && value.trim()) {
-                url.searchParams.set(key, value);
-            }
-        }
-    }
-    const response = await fetch(url.toString(), {
-        method: options.method,
-        headers: {
-            Authorization: `Bearer ${accessToken}`,
-            Accept: 'application/json',
-            'Content-Type': 'application/json',
-        },
-        body: options.body ? JSON.stringify(options.body) : undefined,
-    });
-    const textPayload = await response.text();
-    const parsedPayload = tryParseJson$2(textPayload);
-    if (options.allowNotFound && response.status === 404) {
-        return null;
-    }
-    if (!response.ok) {
-        throw new Error(spaceTrim$1(`
-                Google Calendar API request failed (${response.status} ${response.statusText}):
-                ${extractGoogleCalendarApiErrorMessage(parsedPayload, textPayload)}
-            `));
-    }
-    return parsedPayload;
-}
-/**
- * Parses raw text into JSON when possible.
- *
- * @private function of callGoogleCalendarApi
- */
-function tryParseJson$2(rawText) {
-    if (!rawText.trim()) {
-        return {};
-    }
-    try {
-        return JSON.parse(rawText);
-    }
-    catch (_a) {
-        return rawText;
-    }
-}
-/**
- * Extracts a user-friendly Google Calendar API error message.
- *
- * @private function of callGoogleCalendarApi
- */
-function extractGoogleCalendarApiErrorMessage(parsedPayload, fallbackText) {
-    if (parsedPayload && typeof parsedPayload === 'object') {
-        const payload = parsedPayload;
-        const errorPayload = payload.error;
-        if (errorPayload && typeof errorPayload === 'object') {
-            const normalizedErrorPayload = errorPayload;
-            const message = typeof normalizedErrorPayload.message === 'string' ? normalizedErrorPayload.message : '';
-            const errors = Array.isArray(normalizedErrorPayload.errors) ? normalizedErrorPayload.errors : [];
-            const flattenedErrors = errors
-                .map((errorEntry) => {
-                if (!errorEntry || typeof errorEntry !== 'object') {
-                    return '';
-                }
-                const normalizedErrorEntry = errorEntry;
-                const detailMessage = typeof normalizedErrorEntry.message === 'string' ? normalizedErrorEntry.message : '';
-                const reason = typeof normalizedErrorEntry.reason === 'string' ? normalizedErrorEntry.reason : '';
-                return [detailMessage, reason].filter(Boolean).join(' | ');
-            })
-                .filter(Boolean);
-            if (message || flattenedErrors.length > 0) {
-                return [message, ...flattenedErrors].filter(Boolean).join(' | ');
-            }
-        }
-    }
-    return fallbackText || 'Unknown Google Calendar API error';
-}
-
 /**
  * Hostnames accepted for Google Calendar references.
  *
@@ -15551,6 +15495,96 @@ function removeTokenFromLine(line, token) {
 }
 // Note: [💞] Ignore a discrepancy between file name and entity name
 
+/**
+ * Base Google Calendar API URL.
+ *
+ * @private constant of callGoogleCalendarApi
+ */
+const GOOGLE_CALENDAR_API_BASE_URL = 'https://www.googleapis.com/calendar/v3';
+/**
+ * Runs one Google Calendar API request and parses JSON response payload.
+ *
+ * @private function of UseCalendarCommitmentDefinition
+ */
+async function callGoogleCalendarApi(accessToken, options) {
+    const url = new URL(options.path, GOOGLE_CALENDAR_API_BASE_URL);
+    if (options.query) {
+        for (const [key, value] of Object.entries(options.query)) {
+            if (value && value.trim()) {
+                url.searchParams.set(key, value);
+            }
+        }
+    }
+    const response = await fetch(url.toString(), {
+        method: options.method,
+        headers: {
+            Authorization: `Bearer ${accessToken}`,
+            Accept: 'application/json',
+            'Content-Type': 'application/json',
+        },
+        body: options.body ? JSON.stringify(options.body) : undefined,
+    });
+    const textPayload = await response.text();
+    const parsedPayload = tryParseJson$2(textPayload);
+    if (options.allowNotFound && response.status === 404) {
+        return null;
+    }
+    if (!response.ok) {
+        throw new Error(spaceTrim$1(`
+                Google Calendar API request failed (${response.status} ${response.statusText}):
+                ${extractGoogleCalendarApiErrorMessage(parsedPayload, textPayload)}
+            `));
+    }
+    return parsedPayload;
+}
+/**
+ * Parses raw text into JSON when possible.
+ *
+ * @private function of callGoogleCalendarApi
+ */
+function tryParseJson$2(rawText) {
+    if (!rawText.trim()) {
+        return {};
+    }
+    try {
+        return JSON.parse(rawText);
+    }
+    catch (_a) {
+        return rawText;
+    }
+}
+/**
+ * Extracts a user-friendly Google Calendar API error message.
+ *
+ * @private function of callGoogleCalendarApi
+ */
+function extractGoogleCalendarApiErrorMessage(parsedPayload, fallbackText) {
+    if (parsedPayload && typeof parsedPayload === 'object') {
+        const payload = parsedPayload;
+        const errorPayload = payload.error;
+        if (errorPayload && typeof errorPayload === 'object') {
+            const normalizedErrorPayload = errorPayload;
+            const message = typeof normalizedErrorPayload.message === 'string' ? normalizedErrorPayload.message : '';
+            const errors = Array.isArray(normalizedErrorPayload.errors) ? normalizedErrorPayload.errors : [];
+            const flattenedErrors = errors
+                .map((errorEntry) => {
+                if (!errorEntry || typeof errorEntry !== 'object') {
+                    return '';
+                }
+                const normalizedErrorEntry = errorEntry;
+                const detailMessage = typeof normalizedErrorEntry.message === 'string' ? normalizedErrorEntry.message : '';
+                const reason = typeof normalizedErrorEntry.reason === 'string' ? normalizedErrorEntry.reason : '';
+                return [detailMessage, reason].filter(Boolean).join(' | ');
+            })
+                .filter(Boolean);
+            if (message || flattenedErrors.length > 0) {
+                return [message, ...flattenedErrors].filter(Boolean).join(' | ');
+            }
+        }
+    }
+    return fallbackText || 'Unknown Google Calendar API error';
+}
+
 /**
  * Wallet metadata used by USE CALENDAR when resolving Google Calendar credentials.
  *
@@ -16451,18 +16485,20 @@ class UseCalendarCommitmentDefinition extends BaseCommitmentDefinition {
         if (parsedCommitment.calendar) {
             addConfiguredCalendarIfMissing(existingConfiguredCalendars, parsedCommitment.calendar);
         }
-        const calendarsList = existingConfiguredCalendars.length > 0
-            ? existingConfiguredCalendars
-                .map((calendar) => [
-                `- ${calendar.provider}: ${calendar.url}`,
-                calendar.scopes.length > 0 ? `  scopes: ${calendar.scopes.join(', ')}` : '',
-            ]
-                .filter(Boolean)
-                .join('\n'))
-                .join('\n')
-            : '- Calendar is resolved from runtime context';
+        const calendarBullets = existingConfiguredCalendars.length > 0
+            ? existingConfiguredCalendars.map((calendar) => `-   ${calendar.provider}: ${calendar.url}`).join('\n')
+            : '-   Calendar is resolved from runtime context';
         const extraInstructions = formatOptionalInstructionBlock('Calendar instructions', parsedCommitment.instructions);
-        return this.appendToSystemMessage({
+        const calendarSectionContent = spaceTrim$1((block) => `
+                ## Calendar
+
+                -   Use \`calendar_list_events\`, \`calendar_get_event\`, \`calendar_create_event\`, \`calendar_update_event\`, \`calendar_delete_event\`, and \`calendar_invite_guests\` to manage events in configured calendars.
+                -   Supported operations include read, create, update, delete, invite guests, and reminders.
+                -   Configured calendars:
+                ${block(calendarBullets)}
+                ${block(extraInstructions)}
+            `);
+        return this.replaceOrCreateSection({
             ...requirements,
             tools: createUseCalendarTools(requirements.tools || []),
             _metadata: {
@@ -16470,16 +16506,7 @@ class UseCalendarCommitmentDefinition extends BaseCommitmentDefinition {
                 useCalendar: true,
                 useCalendars: existingConfiguredCalendars,
             },
-        }, spaceTrim$1((block) => `
-                    Calendar tools:
-                    - You can inspect and manage events in configured calendars.
-                    - Supported operations include read, create, update, delete, invite guests, and reminders.
-                    - Configured calendars:
-                      ${block(calendarsList)}
-                    - USE CALENDAR credentials are read from wallet records (ACCESS_TOKEN, service "${UseCalendarWallet.service}", key "${UseCalendarWallet.key}").
-                    - If credentials are missing, ask user to connect calendar credentials in host UI and/or add them to wallet.
-                    ${block(extraInstructions)}
-                `));
+        }, 'Calendar', calendarSectionContent);
     }
     /**
      * Gets human-readable titles for tool functions provided by this commitment.
@@ -16816,18 +16843,6 @@ async function sendEmailViaBrowser(args, agentsServerUrl) {
  * @private internal USE EMAIL constant
  */
 const SEND_EMAIL_TOOL_NAME = 'send_email';
-/**
- * Wallet service used for SMTP credentials required by USE EMAIL.
- *
- * @private internal USE EMAIL constant
- */
-const USE_EMAIL_SMTP_WALLET_SERVICE = 'smtp';
-/**
- * Wallet key used for SMTP credentials required by USE EMAIL.
- *
- * @private internal USE EMAIL constant
- */
-const USE_EMAIL_SMTP_WALLET_KEY = 'use-email-smtp-credentials';
 /**
  * USE EMAIL commitment definition.
  *
@@ -16886,31 +16901,41 @@ class UseEmailCommitmentDefinition extends BaseCommitmentDefinition {
         `);
     }
     applyToAgentModelRequirements(requirements, content) {
+        var _a;
         const parsedCommitment = parseUseEmailCommitmentContent(content);
-        const extraInstructions = formatOptionalInstructionBlock('Email instructions', parsedCommitment.instructions);
-        const senderInstruction = parsedCommitment.senderEmail
-            ? `- Default sender address from commitment: "${parsedCommitment.senderEmail}".`
-            : '';
         const updatedTools = addUseEmailTools(requirements.tools || []);
-        return this.appendToSystemMessage({
+        // Collect all configured sender emails across multiple USE EMAIL commitments
+        const existingSenders = Array.isArray((_a = requirements._metadata) === null || _a === void 0 ? void 0 : _a.useEmailSenders)
+            ? [...requirements._metadata.useEmailSenders]
+            : [];
+        if (parsedCommitment.senderEmail && !existingSenders.includes(parsedCommitment.senderEmail)) {
+            existingSenders.push(parsedCommitment.senderEmail);
+        }
+        const senderBullets = existingSenders.length > 0
+            ? existingSenders
+                .map((email, index) => index === 0
+                ? `-   Default sender address: "${email}".`
+                : `-   Additional sender address: "${email}".`)
+                .join('\n')
+            : '';
+        const extraInstructions = formatOptionalInstructionBlock('Email instructions', parsedCommitment.instructions);
+        const emailSectionContent = spaceTrim$1((block) => `
+                ## Emails
+
+                -   Use \`${SEND_EMAIL_TOOL_NAME}\` to send outbound emails.
+                ${block(senderBullets)}
+                ${block(extraInstructions)}
+            `);
+        return this.replaceOrCreateSection({
             ...requirements,
             tools: updatedTools,
             _metadata: {
                 ...requirements._metadata,
                 useEmail: true,
                 ...(parsedCommitment.senderEmail ? { useEmailSender: parsedCommitment.senderEmail } : {}),
+                useEmailSenders: existingSenders,
             },
-        }, spaceTrim$1((block) => `
-                    Email tool:
-                    - Use "${SEND_EMAIL_TOOL_NAME}" to send outbound emails.
-                    - Prefer \`message\` argument compatible with Promptbook \`Message\` type.
-                    - Include subject in \`message.metadata.subject\` (or use legacy \`subject\` argument).
-                    - USE EMAIL credentials are read from wallet records (ACCESS_TOKEN, service "${USE_EMAIL_SMTP_WALLET_SERVICE}", key "${USE_EMAIL_SMTP_WALLET_KEY}").
-                    - Wallet secret must contain SMTP credentials in JSON format with fields \`host\`, \`port\`, \`secure\`, \`username\`, \`password\`.
-                    - If credentials are missing, ask user to add wallet credentials.
-                    ${block(senderInstruction)}
-                    ${block(extraInstructions)}
-                `));
+        }, 'Emails', emailSectionContent);
     }
     /**
      * Gets human-readable titles for tool functions provided by this commitment.
@@ -16946,13 +16971,13 @@ function addUseEmailTools(existingTools) {
         ...existingTools,
         {
             name: SEND_EMAIL_TOOL_NAME,
-            description: 'Send an outbound email through configured SMTP credentials. Prefer providing Message-like payload in `message`.',
+            description: 'Send an outbound email.',
             parameters: {
                 type: 'object',
                 properties: {
                     message: {
                         type: 'object',
-                        description: 'Preferred input payload compatible with Promptbook Message type. Use metadata.subject for subject line.',
+                        description: 'Email payload. Use metadata.subject for the subject line.',
                     },
                     to: {
                         type: 'string',
@@ -17056,13 +17081,14 @@ class UseImageGeneratorCommitmentDefinition extends BaseCommitmentDefinition {
                 useImageGenerator: content || true,
             },
         }, spaceTrim$1((block) => `
-                    Image generation:
-                    - You do not generate images directly and you do not call any image tool.
-                    - When the user asks for an image, include markdown notation in your message:
-                      \`![<alt text>](?image-prompt=<prompt>)\`
-                    - Keep \`<alt text>\` short and descriptive.
-                    - Keep \`<prompt>\` detailed so the generated image matches the request.
-                    - You can include normal explanatory text before and after the notation.
+                    ## Image generation
+
+                    -   You do not generate images directly and you do not call any image tool.
+                    -   When the user asks for an image, include markdown notation in your message:
+                        \`![<alt text>](?image-prompt=<prompt>)\`
+                    -   Keep \`<alt text>\` short and descriptive.
+                    -   Keep \`<prompt>\` detailed so the generated image matches the request.
+                    -   You can include normal explanatory text before and after the notation.
                     ${block(extraInstructions)}
                 `));
     }
@@ -17242,11 +17268,12 @@ class UsePopupCommitmentDefinition extends BaseCommitmentDefinition {
                 usePopup: content || true,
             },
         }, spaceTrim$1((block) => `
-                    Tool:
-                    - You can open a popup window with a specific URL using the tool "open_popup".
-                    - Use this when you want the user to see or interact with a specific website.
+                    ## Popup
+
+                    -   You can open a popup window with a specific URL using the tool \`open_popup\`.
+                    -   Use this when you want the user to see or interact with a specific website.
                     ${block(extraInstructions)}
-            `));
+                `));
     }
     /**
      * Gets human-readable titles for tool functions provided by this commitment.
@@ -17420,11 +17447,12 @@ class UsePrivacyCommitmentDefinition extends BaseCommitmentDefinition {
                 usePrivacy: content || true,
             },
         }, spaceTrim$1((block) => `
-                    Privacy mode:
-                    - Use "${TURN_PRIVACY_ON_TOOL_NAME}" when the user asks for a private/sensitive conversation.
-                    - This tool requests a UI confirmation dialog. Private mode is enabled only after user confirms.
-                    - Current implementation uses the existing chat private mode (no chat persistence, memory persistence, or self-learning while active).
-                    - Do not claim that end-to-end encryption is implemented yet.
+                    ## Privacy
+
+                    -   Use \`${TURN_PRIVACY_ON_TOOL_NAME}\` when the user asks for a private/sensitive conversation.
+                    -   This tool requests a UI confirmation dialog. Private mode is enabled only after user confirms.
+                    -   Current implementation uses the existing chat private mode (no chat persistence, memory persistence, or self-learning while active).
+                    -   Do not claim that end-to-end encryption is implemented yet.
                     ${block(extraInstructions)}
                 `));
     }
@@ -19067,9 +19095,16 @@ class UseProjectCommitmentDefinition extends BaseCommitmentDefinition {
         }
         const existingConfiguredProjects = normalizeConfiguredProjects((_a = requirements._metadata) === null || _a === void 0 ? void 0 : _a.useProjects);
         addConfiguredProjectIfMissing(existingConfiguredProjects, parsedCommitment.repository);
-        const repositoriesList = existingConfiguredProjects.map((project) => `- ${project.url}`).join('\n');
         const extraInstructions = formatOptionalInstructionBlock('Project instructions', parsedCommitment.instructions);
-        return this.appendToSystemMessage({
+        const sectionContent = spaceTrim$1((block) => `
+                -   You can inspect and edit configured GitHub repositories using project tools.
+                -   Configured repositories:
+                    ${block(existingConfiguredProjects.map((project) => `-   ${project.url}`).join('\n'))}
+                -   When a repository is not obvious from context, pass \`repository\` in tool arguments explicitly.
+                -   If credentials are missing, ask the user to connect their GitHub account in the host UI.
+                ${block(extraInstructions)}
+            `);
+        return this.replaceOrCreateSection({
             ...requirements,
             tools: createUseProjectTools(requirements.tools || []),
             _metadata: {
@@ -19077,16 +19112,7 @@ class UseProjectCommitmentDefinition extends BaseCommitmentDefinition {
                 useProject: true,
                 useProjects: existingConfiguredProjects,
             },
-        }, spaceTrim$1((block) => `
-                    Project tools:
-                    - You can inspect and edit configured GitHub repositories using project tools.
-                    - Configured repositories:
-                      ${block(repositoriesList)}
-                    - When a repository is not obvious from context, pass "repository" in tool arguments explicitly.
-                    - USE PROJECT credentials are read from wallet records (ACCESS_TOKEN, service "${UseProjectWallet.service}", key "${UseProjectWallet.key}").
-                    - If credentials are missing, ask the user to connect credentials in host UI and/or add them to wallet.
-                    ${block(extraInstructions)}
-                `));
+        }, 'GitHub repositories', sectionContent);
     }
     /**
      * Gets human-readable titles for tool functions provided by this commitment.
@@ -19433,11 +19459,12 @@ class UseSpawnCommitmentDefinition extends BaseCommitmentDefinition {
                 useSpawn: content || true,
             },
         }, spaceTrim$1((block) => `
-                    Spawning agents:
-                    - Use "${SPAWN_AGENT_TOOL_NAME}" only when user asks to create a persistent new agent.
-                    - Pass full agent source in \`source\`.
-                    - Keep \`source\` concise; the maximum accepted length is ${CREATE_AGENT_INPUT_SOURCE_MAX_LENGTH} characters.
-                    - Do not add unknown fields in tool arguments.
+                    ## Spawning agents
+
+                    -   Use \`${SPAWN_AGENT_TOOL_NAME}\` only when user asks to create a persistent new agent.
+                    -   Pass full agent source in \`source\`.
+                    -   Keep \`source\` concise; the maximum accepted length is ${CREATE_AGENT_INPUT_SOURCE_MAX_LENGTH} characters.
+                    -   Do not add unknown fields in tool arguments.
                     ${block(extraInstructions)}
                 `));
     }
@@ -19471,13 +19498,14 @@ class UseSpawnCommitmentDefinition extends BaseCommitmentDefinition {
  */
 function createTimeoutSystemMessage(extraInstructions) {
     return spaceTrim$1((block) => `
-            Timeout scheduling:
-            - Use "set_timeout" to wake this same chat thread in the future.
-            - Use "list_timeouts" to review timeout ids/details across all chats for the same user+agent scope.
-            - "cancel_timeout" accepts either one timeout id or \`allActive: true\` to cancel all active timeouts in this same user+agent scope.
-            - Use "update_timeout" to pause/resume, edit next run, edit recurrence, or update timeout payload details.
-            - 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\`.
-            - Do not claim a timer was set or cancelled unless the tool confirms it.
+            ## Timeout scheduling
+
+            -   Use \`set_timeout\` to wake this same chat thread in the future.
+            -   Use \`list_timeouts\` to review timeout ids/details across all chats for the same user+agent scope.
+            -   \`cancel_timeout\` accepts either one timeout id or \`allActive: true\` to cancel all active timeouts in this same user+agent scope.
+            -   Use \`update_timeout\` to pause/resume, edit next run, edit recurrence, or update timeout payload details.
+            -   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\`.
+            -   Do not claim a timer was set or cancelled unless the tool confirms it.
             ${block(extraInstructions)}
         `);
 }
@@ -20577,10 +20605,11 @@ class UseUserLocationCommitmentDefinition extends BaseCommitmentDefinition {
                 useUserLocation: content || true,
             },
         }, spaceTrim$1((block) => `
-                    User location:
-                    - Use "${GET_USER_LOCATION_TOOL_NAME}" only when location is needed for a better answer.
-                    - If the tool returns "unavailable" or "permission-denied", ask user to share location or provide city manually.
-                    - Do not invent coordinates or local facts when location is unavailable.
+                    ## User location
+
+                    -   Use \`${GET_USER_LOCATION_TOOL_NAME}\` only when location is needed for a better answer.
+                    -   If the tool returns "unavailable" or "permission-denied", ask user to share location or provide city manually.
+                    -   Do not invent coordinates or local facts when location is unavailable.
                     ${block(extraInstructions)}
                 `));
     }
@@ -23532,6 +23561,241 @@ function useBookEditorMonacoDiagnostics({ editor, monaco, diagnostics }) {
     }, [diagnostics, editor, monaco]);
 }
 
+/**
+ * Clipboard MIME types treated as rich text documents for upload.
+ *
+ * @private function of BookEditorMonaco
+ */
+const RICH_CLIPBOARD_TEXT_MIME_TYPES = new Set(['text/html', 'text/rtf']);
+/**
+ * Uploaded filename mapping for known rich clipboard MIME types.
+ *
+ * @private function of BookEditorMonaco
+ */
+const CLIPBOARD_RICH_CONTENT_FILENAMES = {
+    'text/html': 'clipboard-content.html',
+    'text/rtf': 'clipboard-content.rtf',
+    'application/rtf': 'clipboard-content.rtf',
+};
+/**
+ * Fallback filename used when clipboard MIME type is unknown.
+ *
+ * @private function of BookEditorMonaco
+ */
+const DEFAULT_CLIPBOARD_RICH_CONTENT_FILENAME = 'clipboard-content.txt';
+/**
+ * Maximum pointer travel still treated as a tap on the touch focus overlay.
+ *
+ * @private function of BookEditorMonaco
+ */
+const TOUCH_TAP_THRESHOLD = 10;
+/**
+ * Lists transferable items from a browser `DataTransfer` object.
+ *
+ * @private function of BookEditorMonaco
+ */
+function listDataTransferItems(dataTransfer) {
+    const items = [];
+    for (let index = 0; index < dataTransfer.items.length; index++) {
+        const item = dataTransfer.items[index];
+        if (item) {
+            items.push(item);
+        }
+    }
+    return items;
+}
+/**
+ * Removes duplicate files by using stable file metadata signature.
+ *
+ * @private function of BookEditorMonaco
+ */
+function deduplicateFiles(files) {
+    const uniqueFiles = new Map();
+    for (const file of files) {
+        uniqueFiles.set(`${file.name}:${file.type}:${file.size}`, file);
+    }
+    return Array.from(uniqueFiles.values());
+}
+/**
+ * Extracts all file-like clipboard/drop payloads from a `DataTransfer`.
+ *
+ * @private function of BookEditorMonaco
+ */
+function getDataTransferFiles(dataTransfer) {
+    const directFiles = Array.from(dataTransfer.files || []);
+    const itemFiles = listDataTransferItems(dataTransfer)
+        .filter((item) => item.kind === 'file')
+        .map((item) => item.getAsFile())
+        .filter((file) => file !== null);
+    return deduplicateFiles([...directFiles, ...itemFiles]);
+}
+/**
+ * Picks the richest textual clipboard item that should be uploaded as a document.
+ *
+ * @private function of BookEditorMonaco
+ */
+function getRichClipboardTextItem(dataTransfer) {
+    const items = listDataTransferItems(dataTransfer);
+    const hasPlainTextItem = items.some((item) => item.kind === 'string' && item.type.toLowerCase() === 'text/plain');
+    const applicationItem = items.find((item) => item.kind === 'string' && item.type.toLowerCase().startsWith('application/'));
+    if (applicationItem) {
+        return applicationItem;
+    }
+    if (hasPlainTextItem) {
+        return null;
+    }
+    const richTextItem = items.find((item) => {
+        if (item.kind !== 'string') {
+            return false;
+        }
+        return RICH_CLIPBOARD_TEXT_MIME_TYPES.has(item.type.toLowerCase());
+    });
+    return richTextItem || null;
+}
+/**
+ * Resolves whether paste should route into upload workflow instead of text insert.
+ *
+ * @private function of BookEditorMonaco
+ */
+function hasUploadableClipboardContent(dataTransfer) {
+    if (getDataTransferFiles(dataTransfer).length > 0) {
+        return true;
+    }
+    return getRichClipboardTextItem(dataTransfer) !== null;
+}
+/**
+ * Reads string payload from clipboard item.
+ *
+ * @private function of BookEditorMonaco
+ */
+function getClipboardItemString(item) {
+    return new Promise((resolve) => {
+        try {
+            item.getAsString((value) => resolve(value || ''));
+        }
+        catch (_a) {
+            resolve('');
+        }
+    });
+}
+/**
+ * Determines filename for generated clipboard rich-content uploads.
+ *
+ * @private function of BookEditorMonaco
+ */
+function getClipboardRichContentFilename(mimeType) {
+    return CLIPBOARD_RICH_CONTENT_FILENAMES[mimeType.toLowerCase()] || DEFAULT_CLIPBOARD_RICH_CONTENT_FILENAME;
+}
+/**
+ * Converts clipboard payload into upload-ready files.
+ *
+ * @private function of BookEditorMonaco
+ */
+async function resolveClipboardUploadFiles(dataTransfer) {
+    const files = getDataTransferFiles(dataTransfer);
+    if (files.length > 0) {
+        return files;
+    }
+    const richTextItem = getRichClipboardTextItem(dataTransfer);
+    if (!richTextItem) {
+        return [];
+    }
+    const content = await getClipboardItemString(richTextItem);
+    const mimeType = richTextItem.type || 'text/plain';
+    if (!content.trim()) {
+        return [];
+    }
+    return [new File([content], getClipboardRichContentFilename(mimeType), { type: mimeType })];
+}
+/**
+ * Manages drag, paste and file input interactions for `BookEditorMonaco`.
+ *
+ * @private function of BookEditorMonaco
+ */
+function useBookEditorMonacoInteractions({ editor, handleFiles, }) {
+    const [isDragOver, setIsDragOver] = useState(false);
+    const touchStartRef = useRef(null);
+    const fileUploadInputRef = useRef(null);
+    const cameraInputRef = useRef(null);
+    const handleDrop = useCallback(async (event) => {
+        event.preventDefault();
+        setIsDragOver(false);
+        const files = getDataTransferFiles(event.dataTransfer);
+        await handleFiles(files);
+    }, [handleFiles]);
+    const handlePaste = useCallback(async (event) => {
+        const clipboardData = event.clipboardData;
+        if (!hasUploadableClipboardContent(clipboardData)) {
+            return;
+        }
+        event.preventDefault();
+        event.stopPropagation();
+        const files = await resolveClipboardUploadFiles(clipboardData);
+        await handleFiles(files);
+    }, [handleFiles]);
+    const handleUploadDocument = useCallback(() => {
+        var _a;
+        (_a = fileUploadInputRef.current) === null || _a === void 0 ? void 0 : _a.click();
+    }, []);
+    const handleTakePhoto = useCallback(() => {
+        var _a;
+        (_a = cameraInputRef.current) === null || _a === void 0 ? void 0 : _a.click();
+    }, []);
+    const handleFileInputChange = useCallback((event) => {
+        const files = Array.from(event.target.files || []);
+        void handleFiles(files);
+        event.target.value = '';
+    }, [handleFiles]);
+    const handleDragOver = useCallback((event) => {
+        event.preventDefault();
+        setIsDragOver(true);
+    }, []);
+    const handleDragEnter = useCallback((event) => {
+        event.preventDefault();
+        setIsDragOver(true);
+    }, []);
+    const handleDragLeave = useCallback((event) => {
+        event.preventDefault();
+        setIsDragOver(false);
+    }, []);
+    const handleFocusOverlayTouchStart = useCallback((event) => {
+        const touch = event.touches[0];
+        if (touch) {
+            touchStartRef.current = { x: touch.clientX, y: touch.clientY };
+        }
+    }, []);
+    const handleFocusOverlayTouchEnd = useCallback((event) => {
+        event.preventDefault();
+        const touch = event.changedTouches[0];
+        if (touch && touchStartRef.current) {
+            const deltaX = Math.abs(touch.clientX - touchStartRef.current.x);
+            const deltaY = Math.abs(touch.clientY - touchStartRef.current.y);
+            if (deltaX < TOUCH_TAP_THRESHOLD && deltaY < TOUCH_TAP_THRESHOLD) {
+                editor === null || editor === void 0 ? void 0 : editor.focus();
+            }
+        }
+        touchStartRef.current = null;
+    }, [editor]);
+    const focusOverlayTouchHandlers = useMemo(() => ({
+        onTouchStart: handleFocusOverlayTouchStart,
+        onTouchEnd: handleFocusOverlayTouchEnd,
+    }), [handleFocusOverlayTouchEnd, handleFocusOverlayTouchStart]);
+    return {
+        isDragOver,
+        fileUploadInputRef,
+        cameraInputRef,
+        handleDrop,
+        handlePaste,
+        handleUploadDocument,
+        handleTakePhoto,
+        handleFileInputChange,
+        handleDragOver,
+        handleDragEnter,
+        handleDragLeave,
+        focusOverlayTouchHandlers,
+    };
+}
+
 /**
  * Priority order for the important commitments shown first in catalogues and intellisense.
  *
@@ -24194,6 +24458,181 @@ function useBookEditorMonacoLanguage({ monaco, theme }) {
     }, [monaco, theme]);
 }
 
+/**
+ * Local storage key that enables BookEditor Monaco lifecycle debug logs in development.
+ *
+ * @private function of BookEditorMonaco
+ */
+const BOOK_EDITOR_MONACO_DEBUG_STORAGE_KEY = 'promptbook-debug-book-editor-monaco';
+/**
+ * Duration of the save notification.
+ *
+ * @private function of BookEditorMonaco
+ */
+const SAVE_NOTIFICATION_HIDE_DELAY_MS = 2000;
+/**
+ * Resolves whether verbose BookEditor Monaco lifecycle logs are enabled.
+ *
+ * @private function of BookEditorMonaco
+ */
+function isBookEditorMonacoDebugEnabled() {
+    if (process.env.NODE_ENV === 'production' || typeof window === 'undefined') {
+        return false;
+    }
+    try {
+        return window.localStorage.getItem(BOOK_EDITOR_MONACO_DEBUG_STORAGE_KEY) === '1';
+    }
+    catch (_a) {
+        return false;
+    }
+}
+/**
+ * Prints one BookEditor Monaco debug line when the dev debug flag is enabled.
+ *
+ * @param message - Human-readable lifecycle message.
+ *
+ * @private function of BookEditorMonaco
+ */
+function logBookEditorMonacoDebug(message) {
+    if (!isBookEditorMonacoDebugEnabled()) {
+        return;
+    }
+    console.info(`[BookEditorMonaco] ${message}`);
+}
+/**
+ * Detects whether the current device primarily uses a coarse pointer.
+ *
+ * @private function of BookEditorMonaco
+ */
+function detectIsTouchDevice() {
+    if (typeof window === 'undefined') {
+        return false;
+    }
+    return window.matchMedia('(pointer: coarse)').matches;
+}
+/**
+ * Manages Monaco lifecycle wiring for `BookEditorMonaco`.
+ *
+ * @private function of BookEditorMonaco
+ */
+function useBookEditorMonacoLifecycle({ monaco, theme, }) {
+    const [editor, setEditor] = useState(null);
+    const [isFocused, setIsFocused] = useState(false);
+    const [isTouchDevice, setIsTouchDevice] = useState(false);
+    const [isSavedShown, setIsSavedShown] = useState(false);
+    /**
+     * Re-applies Book language + theme to the currently mounted Monaco model.
+     */
+    const reapplyBookLanguageAndTheme = useCallback((reason) => {
+        if (!editor || !monaco) {
+            return;
+        }
+        ensureBookEditorMonacoLanguageForEditor({ monaco, monacoEditor: editor, theme });
+        logBookEditorMonacoDebug(`Re-applied Book Monaco language/theme (${reason}).`);
+    }, [editor, monaco, theme]);
+    /**
+     * Re-triggers the transient save toast without preventing the browser save dialog.
+     */
+    const showSavedNotification = useCallback(() => {
+        setIsSavedShown(false);
+        setTimeout(() => setIsSavedShown(true), 0);
+    }, []);
+    useEffect(() => {
+        setIsTouchDevice(detectIsTouchDevice());
+    }, []);
+    useEffect(() => {
+        if (!editor || !monaco) {
+            return;
+        }
+        const focusListener = editor.onDidFocusEditorWidget(() => {
+            setIsFocused(true);
+            reapplyBookLanguageAndTheme('focus');
+        });
+        const blurListener = editor.onDidBlurEditorWidget(() => {
+            setIsFocused(false);
+        });
+        const saveAction = editor.addAction({
+            id: 'save-book',
+            label: 'Save',
+            keybindings: [monaco.KeyMod.CtrlCmd | monaco.KeyCode.KeyS],
+            run: () => {
+                showSavedNotification();
+                // Note: We don't prevent default, so browser's save dialog still opens
+            },
+        });
+        return () => {
+            focusListener.dispose();
+            blurListener.dispose();
+            saveAction.dispose();
+        };
+    }, [editor, monaco, reapplyBookLanguageAndTheme, showSavedNotification]);
+    useEffect(() => {
+        reapplyBookLanguageAndTheme('editor-ready');
+    }, [reapplyBookLanguageAndTheme]);
+    useEffect(() => {
+        if (!editor || !monaco) {
+            return;
+        }
+        const handlePopState = () => {
+            reapplyBookLanguageAndTheme('history-popstate');
+        };
+        const handlePageShow = () => {
+            reapplyBookLanguageAndTheme('pageshow');
+        };
+        const handleWindowFocus = () => {
+            reapplyBookLanguageAndTheme('window-focus');
+        };
+        const handleVisibilityChange = () => {
+            if (document.visibilityState === 'visible') {
+                reapplyBookLanguageAndTheme('visibility-visible');
+            }
+        };
+        window.addEventListener('popstate', handlePopState);
+        window.addEventListener('pageshow', handlePageShow);
+        window.addEventListener('focus', handleWindowFocus);
+        document.addEventListener('visibilitychange', handleVisibilityChange);
+        return () => {
+            window.removeEventListener('popstate', handlePopState);
+            window.removeEventListener('pageshow', handlePageShow);
+            window.removeEventListener('focus', handleWindowFocus);
+            document.removeEventListener('visibilitychange', handleVisibilityChange);
+        };
+    }, [editor, monaco, reapplyBookLanguageAndTheme]);
+    useEffect(() => {
+        if (!isSavedShown) {
+            return;
+        }
+        const timer = setTimeout(() => {
+            setIsSavedShown(false);
+        }, SAVE_NOTIFICATION_HIDE_DELAY_MS);
+        return () => {
+            clearTimeout(timer);
+        };
+    }, [isSavedShown]);
+    /**
+     * Ensures Book language/tokenizer is ready before Monaco creates the editor model.
+     */
+    const handleBeforeMonacoMount = useCallback((beforeMountMonaco) => {
+        ensureBookEditorMonacoLanguage(beforeMountMonaco, theme);
+    }, [theme]);
+    /**
+     * Re-applies Book language/theme once Monaco editor is mounted.
+     */
+    const handleMonacoMount = useCallback((mountedEditor, mountedMonaco) => {
+        setEditor(mountedEditor);
+        ensureBookEditorMonacoLanguageForEditor({ monaco: mountedMonaco, monacoEditor: mountedEditor, theme });
+        logBookEditorMonacoDebug('Mounted Monaco editor and re-applied Book language/theme.');
+    }, [theme]);
+    return {
+        editor,
+        isFocused,
+        isTouchDevice,
+        isSavedShown,
+        handleBeforeMonacoMount,
+        handleMonacoMount,
+    };
+}
+
 /**
  * Relative Y offset multiplier for aligning line background with Monaco rendering.
  *
@@ -25003,190 +25442,101 @@ function BookEditorMonacoUploadPanel({ activeUploadItems, uploadStats, pauseUplo
  */
 const INVALID_CSS_IDENTIFIER_CHARACTER_PATTERN = /[^a-zA-Z0-9_-]/g;
 /**
- * Clipboard MIME types treated as rich text documents for upload.
+ * Base Book editor font size before zoom scaling.
  *
  * @private Internal utility of `BookEditorMonaco`.
  */
-const RICH_CLIPBOARD_TEXT_MIME_TYPES = new Set(['text/html', 'text/rtf']);
+const BASE_FONT_SIZE = 20;
 /**
- * Uploaded filename mapping for known rich clipboard MIME types.
+ * Minimum supported Book editor font size after zoom scaling.
  *
  * @private Internal utility of `BookEditorMonaco`.
  */
-const CLIPBOARD_RICH_CONTENT_FILENAMES = {
-    'text/html': 'clipboard-content.html',
-    'text/rtf': 'clipboard-content.rtf',
-    'application/rtf': 'clipboard-content.rtf',
-};
+const MIN_FONT_SIZE = 8;
 /**
- * Fallback filename used when clipboard MIME type is unknown.
- *
- * @private Internal utility of `BookEditorMonaco`.
- */
-const DEFAULT_CLIPBOARD_RICH_CONTENT_FILENAME = 'clipboard-content.txt';
-/**
- * Local storage key that enables BookEditor Monaco lifecycle debug logs in development.
- *
- * @private Internal utility of `BookEditorMonaco`.
- */
-const BOOK_EDITOR_MONACO_DEBUG_STORAGE_KEY = 'promptbook-debug-book-editor-monaco';
-/**
- * Resolves whether verbose BookEditor Monaco lifecycle logs are enabled.
+ * Default Monaco scrollbar size before zoom scaling.
  *
  * @private Internal utility of `BookEditorMonaco`.
  */
-function isBookEditorMonacoDebugEnabled() {
-    if (process.env.NODE_ENV === 'production' || typeof window === 'undefined') {
-        return false;
-    }
-    try {
-        return window.localStorage.getItem(BOOK_EDITOR_MONACO_DEBUG_STORAGE_KEY) === '1';
-    }
-    catch (_a) {
-        return false;
-    }
-}
-/**
- * Prints one BookEditor Monaco debug line when the dev debug flag is enabled.
- *
- * @param message - Human-readable lifecycle message.
- *
- * @private Internal utility of `BookEditorMonaco`.
- */
-function logBookEditorMonacoDebug(message) {
-    if (!isBookEditorMonacoDebugEnabled()) {
-        return;
-    }
-    console.info(`[BookEditorMonaco] ${message}`);
-}
-/**
- * Lists transferable items from a browser `DataTransfer` object.
- *
- * @private Internal utility of `BookEditorMonaco`.
- */
-function listDataTransferItems(dataTransfer) {
-    const items = [];
-    for (let index = 0; index < dataTransfer.items.length; index++) {
-        const item = dataTransfer.items[index];
-        if (item) {
-            items.push(item);
-        }
-    }
-    return items;
-}
-/**
- * Removes duplicate files by using stable file metadata signature.
- *
- * @private Internal utility of `BookEditorMonaco`.
- */
-function deduplicateFiles(files) {
-    const uniqueFiles = new Map();
-    for (const file of files) {
-        uniqueFiles.set(`${file.name}:${file.type}:${file.size}`, file);
-    }
-    return Array.from(uniqueFiles.values());
-}
-/**
- * Extracts all file-like clipboard/drop payloads from a `DataTransfer`.
- *
- * @private Internal utility of `BookEditorMonaco`.
- */
-function getDataTransferFiles(dataTransfer) {
-    const directFiles = Array.from(dataTransfer.files || []);
-    const itemFiles = listDataTransferItems(dataTransfer)
-        .filter((item) => item.kind === 'file')
-        .map((item) => item.getAsFile())
-        .filter((file) => file !== null);
-    return deduplicateFiles([...directFiles, ...itemFiles]);
-}
+const BASE_SCROLLBAR_SIZE = 5;
 /**
- * Picks the richest textual clipboard item that should be uploaded as a document.
+ * Minimum Monaco scrollbar size after zoom scaling.
  *
  * @private Internal utility of `BookEditorMonaco`.
  */
-function getRichClipboardTextItem(dataTransfer) {
-    const items = listDataTransferItems(dataTransfer);
-    const hasPlainTextItem = items.some((item) => item.kind === 'string' && item.type.toLowerCase() === 'text/plain');
-    const applicationItem = items.find((item) => item.kind === 'string' && item.type.toLowerCase().startsWith('application/'));
-    if (applicationItem) {
-        return applicationItem;
-    }
-    if (hasPlainTextItem) {
-        return null;
-    }
-    const richTextItem = items.find((item) => {
-        if (item.kind !== 'string') {
-            return false;
-        }
-        return RICH_CLIPBOARD_TEXT_MIME_TYPES.has(item.type.toLowerCase());
-    });
-    if (richTextItem) {
-        return richTextItem;
-    }
-    return null;
-}
+const MIN_SCROLLBAR_SIZE = 2;
 /**
- * Resolves whether paste should route into upload workflow instead of text insert.
+ * Minimum left padding Monaco reserves for custom line decorations.
  *
  * @private Internal utility of `BookEditorMonaco`.
  */
-function hasUploadableClipboardContent(dataTransfer) {
-    if (getDataTransferFiles(dataTransfer).length > 0) {
-        return true;
-    }
-    return getRichClipboardTextItem(dataTransfer) !== null;
-}
+const MIN_CONTENT_PADDING_LEFT = 8;
 /**
- * Reads string payload from clipboard item.
+ * Creates a hydration-stable CSS class name from React's `useId()` value.
  *
  * @private Internal utility of `BookEditorMonaco`.
  */
-function getClipboardItemString(item) {
-    return new Promise((resolve) => {
-        try {
-            item.getAsString((value) => resolve(value || ''));
-        }
-        catch (_a) {
-            resolve('');
-        }
-    });
+function createStableBookEditorInstanceClassName(reactId) {
+    return `book-editor-instance-${reactId.replace(INVALID_CSS_IDENTIFIER_CHARACTER_PATTERN, '-')}`;
 }
 /**
- * Determines filename for generated clipboard rich-content uploads.
+ * Resolves Monaco layout values from the active Book editor zoom level.
  *
  * @private Internal utility of `BookEditorMonaco`.
  */
-function getClipboardRichContentFilename(mimeType) {
-    return CLIPBOARD_RICH_CONTENT_FILENAMES[mimeType.toLowerCase()] || DEFAULT_CLIPBOARD_RICH_CONTENT_FILENAME;
+function createBookEditorMonacoScale(zoomLevel) {
+    return {
+        scaledLineHeight: Math.round(BookEditorMonacoConstants.LINE_HEIGHT * zoomLevel),
+        scaledContentPaddingLeft: Math.max(MIN_CONTENT_PADDING_LEFT, Math.round(BookEditorMonacoConstants.CONTENT_PADDING_LEFT * zoomLevel)),
+        scaledVerticalLineLeft: Math.max(0, Math.round(BookEditorMonacoConstants.VERTICAL_LINE_LEFT * zoomLevel)),
+        scaledFontSize: Math.max(MIN_FONT_SIZE, Math.round(BASE_FONT_SIZE * zoomLevel)),
+        scaledScrollbarSize: Math.max(MIN_SCROLLBAR_SIZE, Math.round(BASE_SCROLLBAR_SIZE * zoomLevel)),
+    };
 }
 /**
- * Creates a hydration-stable CSS class name from React's `useId()` value.
+ * Determines whether the Book editor action bar should be shown.
  *
  * @private Internal utility of `BookEditorMonaco`.
  */
-function createStableBookEditorInstanceClassName(reactId) {
-    return `book-editor-instance-${reactId.replace(INVALID_CSS_IDENTIFIER_CHARACTER_PATTERN, '-')}`;
+function isBookEditorMonacoActionbarVisible({ hoistedMenuItems, isUploadButtonShown, isCameraButtonShown, isDownloadButtonShown, isAboutButtonShown, isFullscreenButtonShown, }) {
+    return (Boolean(hoistedMenuItems && hoistedMenuItems.length > 0) ||
+        Boolean(isUploadButtonShown) ||
+        Boolean(isCameraButtonShown) ||
+        Boolean(isDownloadButtonShown) ||
+        Boolean(isAboutButtonShown) ||
+        Boolean(isFullscreenButtonShown));
 }
 /**
- * Converts clipboard payload into upload-ready files.
+ * Builds the Monaco editor options consumed by `MonacoEditorWithShadowDom`.
  *
  * @private Internal utility of `BookEditorMonaco`.
  */
-async function resolveClipboardUploadFiles(dataTransfer) {
-    const files = getDataTransferFiles(dataTransfer);
-    if (files.length > 0) {
-        return files;
-    }
-    const richTextItem = getRichClipboardTextItem(dataTransfer);
-    if (!richTextItem) {
-        return [];
-    }
-    const content = await getClipboardItemString(richTextItem);
-    const mimeType = richTextItem.type || 'text/plain';
-    if (!content.trim()) {
-        return [];
-    }
-    return [new File([content], getClipboardRichContentFilename(mimeType), { type: mimeType })];
+function createBookEditorMonacoOptions({ isReadonly, translations, scaledFontSize, scaledLineHeight, scaledContentPaddingLeft, scaledScrollbarSize, }) {
+    return {
+        readOnly: isReadonly,
+        readOnlyMessage: {
+            value: (translations === null || translations === void 0 ? void 0 : translations.readonlyMessage) || 'You cannot edit this book',
+        },
+        wordWrap: 'on',
+        minimap: { enabled: false },
+        lineNumbers: 'off',
+        fontSize: scaledFontSize,
+        fontFamily: `"Playfair Display", serif`,
+        lineHeight: scaledLineHeight,
+        renderLineHighlight: 'none',
+        lineDecorationsWidth: scaledContentPaddingLeft,
+        glyphMargin: false,
+        folding: false,
+        lineNumbersMinChars: 0,
+        links: true,
+        scrollbar: {
+            vertical: 'auto',
+            horizontal: 'hidden',
+            verticalScrollbarSize: scaledScrollbarSize,
+            arrowSize: 0,
+            useShadows: false,
+        },
+    };
 }
 /**
  * Handles book editor monaco.
@@ -25196,29 +25546,40 @@ async function resolveClipboardUploadFiles(dataTransfer) {
 function BookEditorMonaco(props) {
     const { value, onChange, diagnostics, isReadonly, theme = 'LIGHT', translations, onFileUpload, isUploadButtonShown, isCameraButtonShown, isDownloadButtonShown, isAboutButtonShown = true, isFullscreenButtonShown = true, onFullscreenClick, isFullscreen, zoom = 1, monacoModelPath, hoistedMenuItems, } = props;
     const zoomLevel = zoom;
-    const scaledLineHeight = Math.round(BookEditorMonacoConstants.LINE_HEIGHT * zoomLevel);
-    const scaledContentPaddingLeft = Math.max(8, Math.round(BookEditorMonacoConstants.CONTENT_PADDING_LEFT * zoomLevel));
-    const scaledVerticalLineLeft = Math.max(0, Math.round(BookEditorMonacoConstants.VERTICAL_LINE_LEFT * zoomLevel));
-    const baseFontSize = 20;
-    const scaledFontSize = Math.max(8, Math.round(baseFontSize * zoomLevel));
-    const scaledScrollbarSize = Math.max(2, Math.round(5 * zoomLevel));
-    const [isDragOver, setIsDragOver] = useState(false);
-    const [editor, setEditor] = useState(null);
-    const [isFocused, setIsFocused] = useState(false);
-    const [isTouchDevice, setIsTouchDevice] = useState(false);
-    const [isSavedShown, setIsSavedShown] = useState(false);
+    const { scaledLineHeight, scaledContentPaddingLeft, scaledVerticalLineLeft, scaledFontSize, scaledScrollbarSize } = createBookEditorMonacoScale(zoomLevel);
     const monaco = useMonaco();
     const reactId = useId();
     const instanceClass = createStableBookEditorInstanceClassName(reactId);
-    const touchStartRef = useRef(null);
-    const fileUploadInputRef = useRef(null);
-    const cameraInputRef = useRef(null);
+    const { editor, isFocused, isTouchDevice, isSavedShown, handleBeforeMonacoMount, handleMonacoMount } = useBookEditorMonacoLifecycle({
+        monaco,
+        theme,
+    });
     const { activeUploadItems, uploadStats, pauseUpload, resumeUpload, handleFiles } = useBookEditorMonacoUploads({
         editor,
         monaco,
         onFileUpload,
     });
+    const { isDragOver, fileUploadInputRef, cameraInputRef, handleDrop, handlePaste, handleUploadDocument, handleTakePhoto, handleFileInputChange, handleDragOver, handleDragEnter, handleDragLeave, focusOverlayTouchHandlers, } = useBookEditorMonacoInteractions({
+        editor,
+        handleFiles,
+    });
     const combinedDiagnostics = [...(diagnostics || []), ...createDeprecatedCommitmentDiagnostics(value)];
+    const isActionBarVisible = isBookEditorMonacoActionbarVisible({
+        hoistedMenuItems,
+        isUploadButtonShown,
+        isCameraButtonShown,
+        isDownloadButtonShown,
+        isAboutButtonShown,
+        isFullscreenButtonShown,
+    });
+    const monacoOptions = createBookEditorMonacoOptions({
+        isReadonly,
+        translations,
+        scaledFontSize,
+        scaledLineHeight,
+        scaledContentPaddingLeft,
+        scaledScrollbarSize,
+    });
     useBookEditorMonacoLanguage({ monaco, theme });
     useBookEditorMonacoDiagnostics({ monaco, editor, diagnostics: combinedDiagnostics });
     useBookEditorMonacoDecorations({ editor, monaco });
@@ -25230,171 +25591,6 @@ function BookEditorMonaco(props) {
         zoomLevel,
         theme,
     });
-    /**
-     * Re-applies Book language + theme to the currently mounted Monaco model.
-     */
-    const reapplyBookLanguageAndTheme = useCallback((reason) => {
-        if (!editor || !monaco) {
-            return;
-        }
-        ensureBookEditorMonacoLanguageForEditor({ monaco, monacoEditor: editor, theme });
-        logBookEditorMonacoDebug(`Re-applied Book Monaco language/theme (${reason}).`);
-    }, [editor, monaco, theme]);
-    useEffect(() => {
-        setIsTouchDevice(typeof window !== 'undefined' && window.matchMedia('(pointer: coarse)').matches);
-    }, []);
-    useEffect(() => {
-        if (!editor || !monaco) {
-            return;
-        }
-        const focusListener = editor.onDidFocusEditorWidget(() => {
-            setIsFocused(true);
-            reapplyBookLanguageAndTheme('focus');
-        });
-        const blurListener = editor.onDidBlurEditorWidget(() => {
-            setIsFocused(false);
-        });
-        const saveAction = editor.addAction({
-            id: 'save-book',
-            label: 'Save',
-            keybindings: [monaco.KeyMod.CtrlCmd | monaco.KeyCode.KeyS],
-            run: () => {
-                setIsSavedShown(false);
-                setTimeout(() => setIsSavedShown(true), 0);
-                // Note: We don't prevent default, so browser's save dialog still opens
-            },
-        });
-        return () => {
-            focusListener.dispose();
-            blurListener.dispose();
-            saveAction.dispose();
-        };
-    }, [editor, monaco, reapplyBookLanguageAndTheme]);
-    useEffect(() => {
-        reapplyBookLanguageAndTheme('editor-ready');
-    }, [reapplyBookLanguageAndTheme]);
-    useEffect(() => {
-        if (!editor || !monaco) {
-            return;
-        }
-        const handlePopState = () => {
-            reapplyBookLanguageAndTheme('history-popstate');
-        };
-        const handlePageShow = () => {
-            reapplyBookLanguageAndTheme('pageshow');
-        };
-        const handleWindowFocus = () => {
-            reapplyBookLanguageAndTheme('window-focus');
-        };
-        const handleVisibilityChange = () => {
-            if (document.visibilityState === 'visible') {
-                reapplyBookLanguageAndTheme('visibility-visible');
-            }
-        };
-        window.addEventListener('popstate', handlePopState);
-        window.addEventListener('pageshow', handlePageShow);
-        window.addEventListener('focus', handleWindowFocus);
-        document.addEventListener('visibilitychange', handleVisibilityChange);
-        return () => {
-            window.removeEventListener('popstate', handlePopState);
-            window.removeEventListener('pageshow', handlePageShow);
-            window.removeEventListener('focus', handleWindowFocus);
-            document.removeEventListener('visibilitychange', handleVisibilityChange);
-        };
-    }, [editor, monaco, reapplyBookLanguageAndTheme]);
-    useEffect(() => {
-        if (!isSavedShown) {
-            return;
-        }
-        const timer = setTimeout(() => {
-            setIsSavedShown(false);
-        }, 2000);
-        return () => {
-            clearTimeout(timer);
-        };
-    }, [isSavedShown]);
-    const handleDrop = useCallback(async (event) => {
-        event.preventDefault();
-        setIsDragOver(false);
-        const files = getDataTransferFiles(event.dataTransfer);
-        await handleFiles(files);
-    }, [handleFiles]);
-    const handlePaste = useCallback(async (event) => {
-        const clipboardData = event.clipboardData;
-        if (!hasUploadableClipboardContent(clipboardData)) {
-            return;
-        }
-        event.preventDefault();
-        event.stopPropagation();
-        const files = await resolveClipboardUploadFiles(clipboardData);
-        await handleFiles(files);
-    }, [handleFiles]);
-    const handleUploadDocument = useCallback(() => {
-        var _a;
-        (_a = fileUploadInputRef.current) === null || _a === void 0 ? void 0 : _a.click();
-    }, []);
-    const handleTakePhoto = useCallback(() => {
-        var _a;
-        (_a = cameraInputRef.current) === null || _a === void 0 ? void 0 : _a.click();
-    }, []);
-    const handleFileInputChange = useCallback((event) => {
-        const files = Array.from(event.target.files || []);
-        void handleFiles(files);
-        event.target.value = '';
-    }, [handleFiles]);
-    /**
-     * Ensures Book language/tokenizer is ready before Monaco creates the editor model.
-     */
-    const handleBeforeMonacoMount = useCallback((beforeMountMonaco) => {
-        ensureBookEditorMonacoLanguage(beforeMountMonaco, theme);
-    }, [theme]);
-    /**
-     * Re-applies Book language/theme once Monaco editor is mounted.
-     */
-    const handleMonacoMount = useCallback((mountedEditor, mountedMonaco) => {
-        setEditor(mountedEditor);
-        ensureBookEditorMonacoLanguageForEditor({ monaco: mountedMonaco, monacoEditor: mountedEditor, theme });
-        logBookEditorMonacoDebug('Mounted Monaco editor and re-applied Book language/theme.');
-    }, [theme]);
-    const handleDragOver = useCallback((event) => {
-        event.preventDefault();
-        setIsDragOver(true);
-    }, []);
-    const handleDragEnter = useCallback((event) => {
-        event.preventDefault();
-        setIsDragOver(true);
-    }, []);
-    const handleDragLeave = useCallback((event) => {
-        event.preventDefault();
-        setIsDragOver(false);
-    }, []);
-    const focusOverlayTouchHandlers = {
-        onTouchStart: (event) => {
-            const touch = event.touches[0];
-            if (touch) {
-                touchStartRef.current = { x: touch.clientX, y: touch.clientY };
-            }
-        },
-        onTouchEnd: (event) => {
-            event.preventDefault();
-            const touch = event.changedTouches[0];
-            if (touch && touchStartRef.current) {
-                const deltaX = Math.abs(touch.clientX - touchStartRef.current.x);
-                const deltaY = Math.abs(touch.clientY - touchStartRef.current.y);
-                const threshold = 10;
-                if (deltaX < threshold && deltaY < threshold) {
-                    editor === null || editor === void 0 ? void 0 : editor.focus();
-                }
-            }
-            touchStartRef.current = null;
-        },
-    };
-    const isActionBarVisible = Boolean(hoistedMenuItems && hoistedMenuItems.length > 0) ||
-        isUploadButtonShown ||
-        isCameraButtonShown ||
-        isDownloadButtonShown ||
-        isAboutButtonShown ||
-        isFullscreenButtonShown;
     return (jsxs("div", { className: classNames(styles$d.bookEditorContainer, instanceClass), onDrop: handleDrop, onPaste: handlePaste, onDragOver: handleDragOver, onDragEnter: handleDragEnter, onDragLeave: handleDragLeave, children: [isActionBarVisible && (jsx(BookEditorActionbar, { value,
                 isUploadButtonShown,
                 isCameraButtonShown: isCameraButtonShown !== null && isCameraButtonShown !== void 0 ? isCameraButtonShown : isTouchDevice,
@@ -25420,31 +25616,7 @@ function BookEditorMonaco(props) {
                             height: '100%',
                             width: '100%',
                             backgroundColor: 'transparent',
-                        }, ...focusOverlayTouchHandlers })), jsx(MonacoEditorWithShadowDom, { language: BookEditorMonacoConstants.BOOK_LANGUAGE_ID, theme: BookEditorMonacoConstants.BOOK_THEME_ID, path: monacoModelPath, saveViewState: Boolean(monacoModelPath), value: value, beforeMount: handleBeforeMonacoMount, onMount: handleMonacoMount, onChange: (newValue) => onChange === null || onChange === void 0 ? void 0 : onChange(newValue), options: {
-                            readOnly: isReadonly,
-                            readOnlyMessage: {
-                                value: (translations === null || translations === void 0 ? void 0 : translations.readonlyMessage) || 'You cannot edit this book',
-                            },
-                            wordWrap: 'on',
-                            minimap: { enabled: false },
-                            lineNumbers: 'off',
-                            fontSize: scaledFontSize,
-                            fontFamily: `"Playfair Display", serif`,
-                            lineHeight: scaledLineHeight,
-                            renderLineHighlight: 'none',
-                            lineDecorationsWidth: scaledContentPaddingLeft,
-                            glyphMargin: false,
-                            folding: false,
-                            lineNumbersMinChars: 0,
-                            links: true,
-                            scrollbar: {
-                                vertical: 'auto',
-                                horizontal: 'hidden',
-                                verticalScrollbarSize: scaledScrollbarSize,
-                                arrowSize: 0,
-                                useShadows: false,
-                            },
-                        }, loading: jsx("div", { className: styles$d.loading, children: "\uD83D\uDCD6" }) })] })] }));
+                        }, ...focusOverlayTouchHandlers })), jsx(MonacoEditorWithShadowDom, { language: BookEditorMonacoConstants.BOOK_LANGUAGE_ID, theme: BookEditorMonacoConstants.BOOK_THEME_ID, path: monacoModelPath, saveViewState: Boolean(monacoModelPath), value: value, beforeMount: handleBeforeMonacoMount, onMount: handleMonacoMount, onChange: (newValue) => onChange === null || onChange === void 0 ? void 0 : onChange(newValue), options: monacoOptions, loading: jsx("div", { className: styles$d.loading, children: "\uD83D\uDCD6" }) })] })] }));
 }
 
 /**
@@ -36204,7 +36376,7 @@ function createExampleInteractionsContent(parseResult, samples) {
     if (examples.length === 0) {
         return null;
     }
-    return `Example interaction:\n\n${examples.join('\n\n')}`;
+    return `## Sample of communication with the agent:\n\n${examples.join('\n\n')}`;
 }
 /**
  * Collects the individual lines used in the example interaction section.
@@ -36220,11 +36392,11 @@ function collectExampleInteractionLines(parseResult, samples) {
     const examples = [];
     const initialMessage = (_a = parseResult.commitments.find((commitment) => commitment.type === 'INITIAL MESSAGE')) === null || _a === void 0 ? void 0 : _a.content;
     if (initialMessage) {
-        examples.push(`Agent: ${initialMessage}`);
+        examples.push(`**Agent:**\n${initialMessage}`);
     }
     if (samples && samples.length > 0) {
         for (const sample of samples) {
-            examples.push(`User: ${sample.question}\nAgent: ${sample.answer}`);
+            examples.push(`**User:** ${sample.question}\n\n**Agent:**\n${sample.answer}`);
         }
     }
     return examples;
@@ -41061,8 +41233,8 @@ class OpenAiAgentKitExecutionTools extends OpenAiVectorStoreHandler {
      * Prepares an AgentKit agent with optional knowledge sources and tool definitions.
      */
     async prepareAgentKitAgent(options) {
-        var _a, _b;
-        const { name, instructions, knowledgeSources, tools, vectorStoreId: cachedVectorStoreId, storeAsPrepared, } = options;
+        var _a, _b, _c;
+        const { name, instructions, knowledgeSources, tools, nativeAgentKitTools, vectorStoreId: cachedVectorStoreId, storeAsPrepared, } = options;
         await this.ensureAgentKitDefaults();
         if (this.options.isVerbose) {
             console.info('[🤰]', 'Preparing OpenAI AgentKit agent', {
@@ -41070,6 +41242,7 @@ class OpenAiAgentKitExecutionTools extends OpenAiVectorStoreHandler {
                 instructionsLength: instructions.length,
                 knowledgeSourcesCount: (_a = knowledgeSources === null || knowledgeSources === void 0 ? void 0 : knowledgeSources.length) !== null && _a !== void 0 ? _a : 0,
                 toolsCount: (_b = tools === null || tools === void 0 ? void 0 : tools.length) !== null && _b !== void 0 ? _b : 0,
+                nativeAgentKitToolsCount: (_c = nativeAgentKitTools === null || nativeAgentKitTools === void 0 ? void 0 : nativeAgentKitTools.length) !== null && _c !== void 0 ? _c : 0,
             });
         }
         let vectorStoreId = cachedVectorStoreId;
@@ -41088,7 +41261,7 @@ class OpenAiAgentKitExecutionTools extends OpenAiVectorStoreHandler {
                 vectorStoreId,
             });
         }
-        const agentKitTools = this.buildAgentKitTools({ tools, vectorStoreId });
+        const agentKitTools = this.buildAgentKitTools({ tools, nativeAgentKitTools, vectorStoreId });
         const openAiAgentKitAgent = new Agent$1({
             name,
             model: this.agentKitModelName,
@@ -41127,11 +41300,14 @@ class OpenAiAgentKitExecutionTools extends OpenAiVectorStoreHandler {
      * Builds the tool list for AgentKit, including hosted file search when applicable.
      */
     buildAgentKitTools(options) {
-        const { tools, vectorStoreId } = options;
+        const { tools, nativeAgentKitTools, vectorStoreId } = options;
         const agentKitTools = [];
         if (vectorStoreId) {
             agentKitTools.push(fileSearchTool(vectorStoreId));
         }
+        if (nativeAgentKitTools && nativeAgentKitTools.length > 0) {
+            agentKitTools.push(...nativeAgentKitTools);
+        }
         if (tools && tools.length > 0) {
             let scriptTools = null;
             for (const toolDefinition of tools) {