@promptbook/cli 0.112.0-30 → 0.112.0-32

package/esm/index.es.js

@@ -57,7 +57,7 @@ const BOOK_LANGUAGE_VERSION = '2.0.0';
  * @generated
  * @see https://github.com/webgptorg/promptbook
  */
-const PROMPTBOOK_ENGINE_VERSION = '0.112.0-30';
+const PROMPTBOOK_ENGINE_VERSION = '0.112.0-32';
 /**
  * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
  * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -2040,6 +2040,7 @@ function $initializeCoderRunCommand(program) {
 
             Runners:
             - openai-codex: OpenAI Codex integration (requires --model)
+            - github-copilot: GitHub Copilot CLI integration
             - cline: Cline CLI integration
             - claude-code: Claude Code integration
             - opencode: Opencode integration
@@ -2052,7 +2053,7 @@ function $initializeCoderRunCommand(program) {
             - Dry-run mode to preview prompts
         `));
     command.option('--dry-run', 'Print unwritten prompts without executing', false);
-    command.option('--agent <agent-name>', 'Select runner: openai-codex, cline, claude-code, opencode, gemini (required for non-dry-run)');
+    command.option('--agent <agent-name>', 'Select runner: openai-codex, github-copilot, cline, claude-code, opencode, gemini (required for non-dry-run)');
     command.option('--model <model>', spaceTrim$1(`
             Model to use (required for openai-codex and gemini)
 
@@ -2072,6 +2073,7 @@ function $initializeCoderRunCommand(program) {
         let agentName = undefined;
         if (agent) {
             if (agent === 'openai-codex' ||
+                agent === 'github-copilot' ||
                 agent === 'cline' ||
                 agent === 'claude-code' ||
                 agent === 'opencode' ||
@@ -2079,12 +2081,12 @@ function $initializeCoderRunCommand(program) {
                 agentName = agent;
             }
             else {
-                console.error(colors.red(`Invalid agent "${agent}". Must be one of: openai-codex, cline, claude-code, opencode, gemini`));
+                console.error(colors.red(`Invalid agent "${agent}". Must be one of: openai-codex, github-copilot, cline, claude-code, opencode, gemini`));
                 return process.exit(1);
             }
         }
         if (!agentName && !dryRun) {
-            console.error(colors.red('You must choose an agent using --agent <openai-codex|cline|claude-code|opencode|gemini>'));
+            console.error(colors.red('You must choose an agent using --agent <openai-codex|github-copilot|cline|claude-code|opencode|gemini>'));
             return process.exit(1);
         }
         // Convert commander options to RunOptions format
@@ -21113,10 +21115,6 @@ class StyleCommitmentDefinition extends BaseCommitmentDefinition {
  * Prefix used for TEAM tool names.
  */
 const TEAM_TOOL_PREFIX = 'team_chat_';
-/**
- * Length of URL hash suffix appended to TEAM tool names.
- */
-const TEAM_TOOL_HASH_LENGTH = 10;
 /**
  * Fallback normalized name when teammate label is empty.
  */
@@ -21133,20 +21131,19 @@ function normalizeTeammateToolNamePart(teammateLabel) {
     return normalized || TEAM_TOOL_FALLBACK_NAME;
 }
 /**
- * Builds a deterministic TEAM tool name from teammate identity.
+ * Builds a deterministic TEAM tool name from the teammate label.
  *
- * The readable part is based on teammate label while the hash suffix
- * keeps uniqueness and stable mapping for the underlying teammate URL.
+ * The tool name is derived solely from the human-readable label so that it
+ * remains stable and predictable regardless of internal technical identifiers.
  *
- * @param teammateUrl - Canonical teammate URL used at runtime.
- * @param teammateLabel - Human-readable teammate label.
- * @returns Deterministic TEAM tool name.
+ * @param _teammateUrl - Canonical teammate URL (kept for API compatibility, not used).
+ * @param teammateLabel - Human-readable teammate label used as the basis for the name.
+ * @returns TEAM tool name derived from the label.
  * @private internal utility of TEAM commitments and chat UI mapping
  */
-function createTeamToolName(teammateUrl, teammateLabel) {
+function createTeamToolName(_teammateUrl, teammateLabel) {
     const normalizedLabel = normalizeTeammateToolNamePart(teammateLabel);
-    const hash = computeHash(teammateUrl).substring(0, TEAM_TOOL_HASH_LENGTH);
-    return `${TEAM_TOOL_PREFIX}${normalizedLabel}_${hash}`;
+    return `${TEAM_TOOL_PREFIX}${normalizedLabel}`;
 }
 
 const urlRegex = /https?:\/\/[^\s]+/gi;
@@ -21351,7 +21348,7 @@ class TeamCommitmentDefinition extends BaseCommitmentDefinition {
         `);
     }
     applyToAgentModelRequirements(requirements, content) {
-        var _a, _b;
+        var _a, _b, _c;
         const trimmedContent = content.trim();
         if (!trimmedContent) {
             return requirements;
@@ -21363,14 +21360,18 @@ class TeamCommitmentDefinition extends BaseCommitmentDefinition {
         }
         const agentName = ((_a = requirements._metadata) === null || _a === void 0 ? void 0 : _a.agentName) || 'Agent';
         const existingTeammates = ((_b = requirements._metadata) === null || _b === void 0 ? void 0 : _b.teammates) || [];
+        const preResolvedProfiles = (((_c = requirements._metadata) === null || _c === void 0 ? void 0 : _c.preResolvedTeammateProfiles) || {});
         const resolvedTeammates = resolveTeamTeammateLabels(trimmedContent, teammates);
         const teamEntries = resolvedTeammates.map((teammate) => {
+            const profile = preResolvedProfiles[teammate.url];
+            const resolvedLabel = (profile === null || profile === void 0 ? void 0 : profile.agentName) || teammate.label;
             const existingTeammate = existingTeammates.find((entry) => entry.url === teammate.url);
             return {
                 toolName: ((existingTeammate === null || existingTeammate === void 0 ? void 0 : existingTeammate.toolName) ||
-                    createTeamToolName(teammate.url, teammate.label)),
-                teammate,
+                    createTeamToolName(teammate.url, resolvedLabel)),
+                teammate: { ...teammate, label: resolvedLabel },
                 agentName,
+                description: (profile === null || profile === void 0 ? void 0 : profile.personaDescription) || null,
             };
         });
         for (const entry of teamEntries) {
@@ -21382,9 +21383,12 @@ class TeamCommitmentDefinition extends BaseCommitmentDefinition {
             if (updatedTools.some((tool) => tool.name === entry.toolName)) {
                 continue;
             }
+            const toolDescription = entry.description
+                ? `Consult teammate ${entry.teammate.label}\n${entry.description}`
+                : `Consult teammate ${entry.teammate.label}`;
             updatedTools.push({
                 name: entry.toolName,
-                description: `Consult teammate ${entry.teammate.label}`,
+                description: toolDescription,
                 parameters: {
                     type: 'object',
                     properties: {
@@ -21413,8 +21417,7 @@ class TeamCommitmentDefinition extends BaseCommitmentDefinition {
                 toolName: entry.toolName,
             });
         }
-        const teamOverviewText = createTeamOverviewText(trimmedContent, teamEntries);
-        const teamSystemMessage = this.createSystemMessageSection('Teammates:', buildTeamSystemMessageBody(teamOverviewText, teamEntries));
+        const teamSystemMessage = this.createSystemMessageSection('Teammates:', buildTeamSystemMessageBody(teamEntries));
         return this.appendToSystemMessage({
             ...requirements,
             tools: updatedTools,
@@ -21451,25 +21454,24 @@ function resolveTeamTeammateLabels(teamContent, teammates) {
         };
     });
 }
-/**
- * Rewrites TEAM commitment content into a URL-free teammate overview text.
- */
-function createTeamOverviewText(teamContent, teamEntries) {
-    let overviewText = teamContent;
-    for (const entry of teamEntries) {
-        overviewText = overviewText.split(entry.teammate.url).join(entry.teammate.label);
-    }
-    return overviewText.trim();
-}
 /**
  * Builds the textual TEAM section body for the final system message.
+ *
+ * Each teammate is listed with its tool name and, when available, a one-line description.
+ * Uses `spaceTrim` to ensure consistent whitespace and indentation.
  */
-function buildTeamSystemMessageBody(teamOverviewText, teamEntries) {
-    const teammateLines = teamEntries.map((entry, index) => `${index + 1}) ${entry.teammate.label} tool \`${entry.toolName}\``);
-    if (!teamOverviewText) {
-        return teammateLines.join('\n');
-    }
-    return `${teamOverviewText}\n\n${teammateLines.join('\n')}`;
+function buildTeamSystemMessageBody(teamEntries) {
+    const lines = teamEntries.map((entry, index) => {
+        const toolLine = `${index + 1}) ${entry.teammate.label} tool \`${entry.toolName}\``;
+        if (!entry.description) {
+            return toolLine;
+        }
+        return spaceTrim$1(`
+            ${toolLine}
+               ${entry.description}
+        `);
+    });
+    return lines.join('\n');
 }
 /**
  * Registers tool function and title for a teammate tool.
@@ -39117,7 +39119,7 @@ function getSafeReferenceCommitmentFallback(commitmentType, originalContent) {
  * @private @@@
  */
 async function createAgentModelRequirementsWithCommitments(agentSource, modelName, options) {
-    var _a;
+    var _a, _b, _c;
     const agentReferenceResolver = options === null || options === void 0 ? void 0 : options.agentReferenceResolver;
     // Parse the agent source to extract commitments
     const parseResult = parseAgentSourceWithCommitments(agentSource);
@@ -39185,6 +39187,36 @@ async function createAgentModelRequirementsWithCommitments(agentSource, modelNam
         if (commitment.type === 'CLOSED' && i !== filteredCommitments.length - 1) {
             continue;
         }
+        // For TEAM commitments, pre-resolve teammate profiles if a resolver is provided
+        // and store them in metadata before the commitment is applied.
+        const profileResolver = (_a = options === null || options === void 0 ? void 0 : options.teammateProfileResolver) !== null && _a !== void 0 ? _a : options === null || options === void 0 ? void 0 : options.agentReferenceResolver;
+        if (commitment.type === 'TEAM' && (profileResolver === null || profileResolver === void 0 ? void 0 : profileResolver.resolveTeammateProfile)) {
+            try {
+                const parsedTeammates = parseTeamCommitmentContent(commitmentContent, { strict: false });
+                const preResolved = {
+                    ...(_b = requirements._metadata) === null || _b === void 0 ? void 0 : _b.preResolvedTeammateProfiles,
+                };
+                for (const teammate of parsedTeammates) {
+                    if (preResolved[teammate.url]) {
+                        continue;
+                    }
+                    const profile = await profileResolver.resolveTeammateProfile(teammate.url);
+                    if (profile) {
+                        preResolved[teammate.url] = profile;
+                    }
+                }
+                requirements = {
+                    ...requirements,
+                    _metadata: {
+                        ...requirements._metadata,
+                        preResolvedTeammateProfiles: preResolved,
+                    },
+                };
+            }
+            catch (error) {
+                console.warn('Failed to pre-resolve teammate profiles for TEAM commitment:', error);
+            }
+        }
         const definition = getCommitmentDefinition(commitment.type);
         if (definition) {
             try {
@@ -39280,7 +39312,7 @@ async function createAgentModelRequirementsWithCommitments(agentSource, modelNam
     // Add example interactions to the system message
     const examples = [];
     // 1. Initial message as an example agent response
-    const initialMessage = (_a = parseResult.commitments.find((c) => c.type === 'INITIAL MESSAGE')) === null || _a === void 0 ? void 0 : _a.content;
+    const initialMessage = (_c = parseResult.commitments.find((c) => c.type === 'INITIAL MESSAGE')) === null || _c === void 0 ? void 0 : _c.content;
     if (initialMessage) {
         examples.push(`Agent: ${initialMessage}`);
     }
@@ -40733,6 +40765,7 @@ async function findRefactorCandidates() {
     const { selectedEmojis } = await getFreshPromptEmojiTags({
         count: candidatesToWrite.length,
         rootDir,
+        tagPrefix: '🧹',
     });
     await mkdir(promptsDir, { recursive: true });
     const createdPrompts = [];
@@ -40745,7 +40778,7 @@ async function findRefactorCandidates() {
         if (!selectedEmoji) {
             throw new Error(`Missing emoji for prompt candidate #${index + 1}`);
         }
-        const emojiTag = formatPromptEmojiTag(selectedEmoji);
+        const emojiTag = formatPromptEmojiTag(selectedEmoji, '🧹');
         const promptContent = buildPromptContent(candidate, emojiTag);
         await writeFile(promptPath, promptContent, 'utf-8');
         createdPrompts.push(filename);
@@ -40791,7 +40824,7 @@ function buildPromptGuidance(candidate) {
     if (counts.entityCount !== null && counts.maxEntities !== null) {
         guidance.push(`- The file defines too many responsibilities (${counts.entityCount} in single file)`, `    - Keep in mind the Single Responsibility Principle (SRP)`, `    - Consider breaking it down into smaller, focused modules or components.`);
     }
-    guidance.push('- Purpose of this refactoring is to improve code maintainability and readability.', '- Look at the internal structure, the usage and also surrounding code to understand how to best refactor this file.', '- Consider breaking down large functions into smaller, more manageable ones, removing any redundant code, and ensuring that the file adheres to the project coding standards.', '- After the refactoring, ensure that (1) `npm run test-name-discrepancies` and (2) `npm run test-package-generation` are passing successfully.', '    1. All the things you have moved to new files should correspond the thing in the file with the file name, for example `MyComponent.tsx` should export `MyComponent`.', '    2. All the things you have moved to new files but are private things to the outside world should have `@private function of TheMainThing` JSDoc comment.', '- Keep in mind DRY *(Do not repeat yourself)* and SOLID principles while refactoring.', '- **Do not change the external behavior** of the code. Focus solely on improving the internal structure and organization of the code.');
+    guidance.push('- Purpose of this refactoring is to improve code maintainability and readability.', '- Look at the internal structure, the usage and also surrounding code to understand how to best refactor this file.', '- Consider breaking down large functions into smaller, more manageable ones, removing any redundant code, and ensuring that the file adheres to the project coding standards.', '- After the refactoring, ensure that (1) `npm run test-name-discrepancies` and (2) `npm run test-package-generation` are passing successfully.', '    1. All the things you have moved to new files should correspond the thing in the file with the file name, for example `MyComponent.tsx` should export `MyComponent`.', '    2. All the things you have moved to new files but are private things to the outside world should have `@private function of TheMainThing` JSDoc comment.', '- Keep in mind DRY *(Do not repeat yourself)* and SOLID principles while refactoring.', '- **Do not change the external behavior** of the code. Focus solely on improving the internal structure and organization of the code.', '- Before you start refactoring, make sure to read the code carefully and understand its current structure and functionality. Do a analysis of the current functionality before you start.');
     // <- TODO: Leverage `spaceTrim` here
     return guidance;
 }
@@ -41043,6 +41076,7 @@ function parseRunOptions(args) {
     if (agentValue) {
         const value = agentValue;
         if (value === 'openai-codex' ||
+            value === 'github-copilot' ||
             value === 'cline' ||
             value === 'claude-code' ||
             value === 'opencode' ||
@@ -41059,7 +41093,7 @@ function parseRunOptions(args) {
     const autoMigrate = args.includes('--auto-migrate');
     const allowDestructiveAutoMigrate = args.includes('--allow-destructive-auto-migrate');
     if (!agentName && !dryRun) {
-        exitWithUsageError('You must choose an agent using --agent <openai-codex|cline|claude-code|opencode|gemini>');
+        exitWithUsageError('You must choose an agent using --agent <openai-codex|github-copilot|cline|claude-code|opencode|gemini>');
     }
     return {
         dryRun,
@@ -43488,6 +43522,7 @@ function createCodingContext() {
         -   Keep small responsibilities of functions and classes, avoid creating big functions or classes that do many things.
         -   When throwing errors, throw [branded errors](src/errors) and use \`spaceTrim\` utility to write clear and well-formatted multilie detailed error messages.
             -   Format errors as markdown, for example \`variabiles\` should be in backticks, important notes can be in bold, etc.
+        -   Constants should be always \`UPPER_SNAKE_CASE\`
         -   When writing multiline strings, use \`spaceTrim\` utility
         -   DO only the change described here above DO not add any additional features or make any additional changes that are not described in the prompt.
             -   If you find some critical issue that is not described in the prompt, report it to the file \`./AGENT_REPORT.md\` on the root of the project
@@ -43851,6 +43886,60 @@ class GeminiRunner {
     }
 }
 
+/**
+ * Builds the shell script that runs GitHub Copilot CLI with the prompt and coding context.
+ */
+function buildGitHubCopilotScript(options) {
+    const delimiter = 'GITHUB_COPILOT_PROMPT';
+    const projectPath = toPosixPath(options.projectPath);
+    const modelArgument = options.model ? ` --model ${options.model}` : '';
+    return spaceTrim((block) => `
+            cd "${projectPath}"
+
+            copilot -p "$(cat <<'${delimiter}'
+
+            ${block(options.prompt)}
+
+            ${block(createCodingContext())}
+
+            ${delimiter}
+            )" \
+                --yolo \
+                --no-ask-user \
+                --no-color \
+                --output-format json \
+                --stream off${modelArgument}
+        `);
+}
+
+/**
+ * Runs prompts via the GitHub Copilot CLI.
+ */
+class GitHubCopilotRunner {
+    /**
+     * Creates a new GitHub Copilot runner.
+     */
+    constructor(options) {
+        this.options = options;
+        this.name = 'github-copilot';
+    }
+    /**
+     * Runs the prompt using GitHub Copilot CLI.
+     */
+    async runPrompt(options) {
+        const scriptContent = buildGitHubCopilotScript({
+            prompt: options.prompt,
+            projectPath: options.projectPath,
+            model: this.options.model,
+        });
+        await $runGoScript({
+            scriptPath: options.scriptPath,
+            scriptContent,
+        });
+        return { usage: UNCERTAIN_USAGE };
+    }
+}
+
 /**
  * Maximum number of output characters included in thrown error messages.
  */
@@ -44588,6 +44677,7 @@ const DEFAULT_CODEX_MODEL = 'gpt-5.2-codex';
 const CLINE_MODEL = 'gemini:gemini-3-flash-preview';
 const RUNNER_LABELS = {
     'openai-codex': 'OpenAI Codex',
+    'github-copilot': 'GitHub Copilot',
     cline: 'Cline',
     'claude-code': 'Claude Code',
     opencode: 'Opencode',
@@ -44603,6 +44693,9 @@ function getRunnerMetadata(options, actualModel) {
     if (options.agentName === 'openai-codex') {
         modelName = actualModel;
     }
+    else if (options.agentName === 'github-copilot') {
+        modelName = actualModel;
+    }
     else if (options.agentName === 'gemini') {
         modelName = actualModel;
     }
@@ -44640,8 +44733,7 @@ async function runCodexPrompts(providedOptions) {
             return;
         }
         let runner;
-        let actualCodexModel;
-        let actualGeminiModel;
+        let actualRunnerModel;
         const agentName = options.agentName;
         if (!agentName) {
             throw new Error('Missing --agent in non-dry run mode');
@@ -44668,7 +44760,7 @@ async function runCodexPrompts(providedOptions) {
             else {
                 modelToUse = options.model;
             }
-            actualCodexModel = modelToUse;
+            actualRunnerModel = modelToUse;
             runner = new OpenAiCodexRunner({
                 codexCommand: 'codex',
                 model: modelToUse,
@@ -44685,6 +44777,13 @@ async function runCodexPrompts(providedOptions) {
                 model: CLINE_MODEL,
             });
         }
+        else if (agentName === 'github-copilot') {
+            const modelToUse = options.model === 'default' ? undefined : options.model;
+            actualRunnerModel = modelToUse;
+            runner = new GitHubCopilotRunner({
+                model: modelToUse,
+            });
+        }
         else if (agentName === 'claude-code') {
             runner = new ClaudeCodeRunner();
         }
@@ -44709,7 +44808,7 @@ async function runCodexPrompts(providedOptions) {
             else {
                 modelToUse = options.model;
             }
-            actualGeminiModel = modelToUse;
+            actualRunnerModel = modelToUse;
             runner = new GeminiRunner({
                 model: modelToUse,
             });
@@ -44718,7 +44817,7 @@ async function runCodexPrompts(providedOptions) {
             throw new Error(`Unknown agent: ${agentName}`);
         }
         console.info(colors.green(`Running prompts with ${runner.name}`));
-        const runnerMetadata = getRunnerMetadata(options, actualCodexModel !== null && actualCodexModel !== void 0 ? actualCodexModel : actualGeminiModel);
+        const runnerMetadata = getRunnerMetadata(options, actualRunnerModel);
         let hasShownUpcomingTasks = false;
         let hasWaitedForStart = false;
         while (just(true)) {
@@ -45465,13 +45564,23 @@ function getToolCallIdentity(toolCall) {
  */
 function mergeToolCalls(existingToolCalls, incomingToolCalls) {
     if (!existingToolCalls || existingToolCalls.length === 0) {
-        return incomingToolCalls ? [...incomingToolCalls] : [];
+        return incomingToolCalls ? deduplicatePreparationToolCalls([...incomingToolCalls]) : [];
     }
     if (!incomingToolCalls || incomingToolCalls.length === 0) {
         return [...existingToolCalls];
     }
     const mergedToolCalls = [...existingToolCalls];
     for (const incomingToolCall of incomingToolCalls) {
+        if (isAssistantPreparationToolCall(incomingToolCall)) {
+            // A new preparation phase always replaces any previous assistant_preparation tool
+            // call, regardless of phase argument, so only one chip is ever shown at a time.
+            const existingPreparationIndex = mergedToolCalls.findIndex(isAssistantPreparationToolCall);
+            if (existingPreparationIndex !== -1) {
+                mergedToolCalls.splice(existingPreparationIndex, 1);
+            }
+            mergedToolCalls.push(incomingToolCall);
+            continue;
+        }
         const incomingIdentity = getToolCallIdentity(incomingToolCall);
         const existingIndex = mergedToolCalls.findIndex((existingToolCall) => getToolCallIdentity(existingToolCall) === incomingIdentity);
         if (existingIndex === -1) {
@@ -45583,6 +45692,30 @@ function serializeValueForMerge(value) {
         return String(value);
     }
 }
+/**
+ * Ensures at most one `assistant_preparation` tool call survives in the list,
+ * keeping the last occurrence so the most recent preparation phase is shown.
+ *
+ * @param toolCalls - Mutable list to deduplicate in-place.
+ * @returns The same array after removing redundant preparation entries.
+ * @private helper of `mergeToolCalls`
+ */
+function deduplicatePreparationToolCalls(toolCalls) {
+    let lastPreparationIndex = -1;
+    for (let index = toolCalls.length - 1; index >= 0; index--) {
+        if (!isAssistantPreparationToolCall(toolCalls[index])) {
+            continue;
+        }
+        if (lastPreparationIndex === -1) {
+            lastPreparationIndex = index;
+        }
+        else {
+            // Remove earlier duplicate — keep only the last (most recent) one.
+            toolCalls.splice(index, 1);
+        }
+    }
+    return toolCalls;
+}
 
 /**
  * Gets all tool titles provided by all commitments
@@ -47749,6 +47882,7 @@ class SelfLearningManager {
 
                 - Decide what the agent should learn from this interaction.
                 - Append new commitments at the end of the agent source.
+                - Return only newly learned commitments, never repeat commitments that are already present.
                 - Do not modify the current agent source, just return new commitments (KNOWLEDGE, RULE, etc.).
                 - If there is nothing new to learn, return empty book code block
                 - Wrap the commitments in a book code block.
@@ -47801,10 +47935,42 @@ class SelfLearningManager {
      */
     appendToAgentSource(section) {
         const currentSource = this.options.getAgentSource();
-        const newSource = padBook(validateBook(spaceTrim$1(currentSource) + section));
+        const normalizedSection = normalizeBookSection(section);
+        if (!normalizedSection) {
+            return;
+        }
+        if (containsNormalizedBookSection(currentSource, normalizedSection)) {
+            return;
+        }
+        const newSource = padBook(validateBook(`${normalizeBookSection(currentSource)}\n\n${normalizedSection}`));
         this.options.updateAgentSource(newSource);
     }
 }
+/**
+ * Normalizes one book fragment for deduplication and append composition.
+ *
+ * @param section Raw fragment from self-learning workflow.
+ * @returns Trimmed fragment, or empty string when nothing remains.
+ * @private function of Agent
+ */
+function normalizeBookSection(section) {
+    return spaceTrim$1(section).replace(/\r\n/g, '\n');
+}
+/**
+ * Checks whether one normalized fragment already exists inside the current source.
+ *
+ * @param agentSource Current source.
+ * @param normalizedSection Candidate fragment expected to be normalized first.
+ * @returns True when appending would duplicate an existing fragment.
+ * @private function of Agent
+ */
+function containsNormalizedBookSection(agentSource, normalizedSection) {
+    if (!normalizedSection) {
+        return true;
+    }
+    const normalizedSource = normalizeBookSection(agentSource);
+    return normalizedSource.includes(normalizedSection);
+}
 /**
  * Determines whether the interaction runs in OpenAI-compatible JSON schema mode.
  *