@promptbook/core 0.114.0-0 → 0.114.0-2

package/umd/index.umd.js

@@ -29,7 +29,7 @@
      * @generated
      * @see https://github.com/webgptorg/promptbook
      */
-    const PROMPTBOOK_ENGINE_VERSION = '0.114.0-0';
+    const PROMPTBOOK_ENGINE_VERSION = '0.114.0-2';
     /**
      * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
      * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -29677,13 +29677,12 @@
         `),
         },
         {
-            id: 'use-project-and-wallet-integration-agent',
+            id: 'use-project-integration-agent',
             source: spacetrim.spaceTrim(`
             Repository Maintainer
 
             GOAL Maintain a GitHub repository and prepare safe pull requests.
             USE PROJECT https://github.com/acme/website
-            WALLET Store credentials for repository operations.
             RULE Before editing files, explain the planned change and impacted paths.
             RULE Never reveal raw credentials in chat output.
             INITIAL MESSAGE I can inspect the repository and help you prepare PR-ready changes.
@@ -29755,24 +29754,6 @@
      * Longer label used for unfinished and low-level commitments.
      */
     const LOW_LEVEL_COMMITMENT_DETAIL_LABEL = 'Low-level commitment';
-    /**
-     * Prefix used when formatting replacement guidance.
-     */
-    const PREFERRED_REPLACEMENT_LABEL = 'Preferred replacement';
-    /**
-     * Formats preferred replacement guidance for deprecated commitments.
-     *
-     * @param replacedBy - Preferred replacement commitment keywords.
-     * @returns Optional replacement guidance sentence with leading space.
-     *
-     * @private internal utility of commitment catalog notices
-     */
-    function formatCommitmentReplacementText(replacedBy) {
-        if (!replacedBy || replacedBy.length === 0) {
-            return '';
-        }
-        return ` ${PREFERRED_REPLACEMENT_LABEL}: ${replacedBy.map((type) => `\`${type}\``).join(', ')}.`;
-    }
     /**
      * Returns true when one commitment notice should be rendered with low-visibility styling.
      *
@@ -29838,6 +29819,10 @@
             if ((notice === null || notice === void 0 ? void 0 : notice.kind) === 'deprecated') {
                 continue;
             }
+            if (groupedCommitment.primary instanceof NotYetImplementedCommitmentDefinition ||
+                groupedCommitment.primary.isUnfinished) {
+                continue;
+            }
             if (isLowVisibilityCommitmentNotice(notice)) {
                 lowLevel.push(groupedCommitment);
                 continue;
@@ -29865,9 +29850,7 @@
         metadataLabels: {
             bookLanguageVersion: 'Verze jazyka Book',
             generatedAt: 'Vygenerováno',
-            commitmentGroups: 'Skupin commitmentů',
-            implementedCommitments: 'Hotových commitmentů',
-            placeholderCommitments: 'Připravovaných commitmentů',
+            commitmentCount: 'Počet commitmentů',
         },
         tableOfContentsTitle: 'Obsah',
         chapters: {
@@ -29929,15 +29912,7 @@
             commitmentCatalog: {
                 title: 'Katalog commitmentů',
                 body: spacetrim.spaceTrim(`
-                Tato kapitola se generuje z definic commitmentů v \`src/commitments\`.
-                U každé skupiny commitmentů najdete:
-
-                - shrnutí významu (popis, ikona, stav)
-                - schéma pro parsování (\`createTypeRegex\` a \`createRegex\`)
-                - úplnou dokumentaci
-
-                Klíčová slova commitmentů jsou součástí syntaxe, a proto zůstávají anglicky.
-                Anglicky zůstávají i jejich referenční popisy, které jsou závaznou specifikací jazyka.
+                Každá sekce commitmentu vysvětluje jeho účel, důležité podrobnosti a ukazuje soustředěný příklad.
             `),
             },
             examples: {
@@ -30024,41 +29999,28 @@
                 První neprázdný řádek, který není klíčovým slovem commitmentu.
                 2. **Blok commitmentu**:
                 Začíná klíčovým slovem commitmentu a pokračuje až k dalšímu commitmentu nebo oddělovači.
-                3. **Vodorovný oddělovač**:
-                Řádky jako \`---\` dělí zdroj na části; v Agents Serveru jimi lze oddělit agenty vložené přímo v knize.
+                3. **Více agentů**:
+                Řádky jako \`---\` oddělují agenty definované ve stejném zdroji Booku.
                 4. **Bloky kódu**:
-                Uvnitř obsahu commitmentu zůstávají zachované; hodí se pro ukázky a instrukce.
-                5. **Parametry**:
-                Podporovaný a rozpoznávaný je zápis \`@parametr\` i \`{parametr}\`.
+                Začínají a končí pomocí <code>\`\`\`</code>; jejich obsah zůstává uvnitř commitmentu zachovaný a hodí se pro ukázky a instrukce.
             `),
             },
             references: {
                 title: 'Odkazy a zástupní agenti',
                 body: spacetrim.spaceTrim(`
-                - Zkrácené odkazy jako \`{Jméno agenta}\` vyhodnocuje resolver odkazů v Agents Serveru.
+                - \`@Foo\` a \`{Foo foo}\` odkazují na jiného agenta; nejde o zápis parametrů.
+                - Zkrácené odkazy jako \`@Jméno agenta\` a \`{Jméno agenta}\` vyhodnocuje resolver odkazů v Agents Serveru.
                 - V příslušných commitmentech lze použít i zástupné agenty (například \`{User}\` nebo \`{Void}\`).
                 - \`{User}\` je určený pro \`TEAM\`; \`{Void}\` se hodí pro výslovné zrušení dědičnosti.
             `),
             },
-            keywordsTitle: 'Aktuálně rozpoznávaná klíčová slova commitmentů',
         },
         commitmentCatalogTitleSuffixes: {
             usedFirst: ' (nejdřív používané commitmenty)',
             all: ' (všechny commitmenty)',
         },
         commitmentLabels: {
-            status: 'Stav',
             aliases: 'Varianty zápisu',
-            semantics: 'Význam',
-            typeSchema: 'Schéma klíčového slova',
-            blockSchema: 'Schéma bloku',
-            lowLevelNotice: 'Nízkoúrovňový commitment',
-            usage: 'Použití u vybraných agentů',
-            usageOccurrence: 'výskyt',
-            usageOccurrences: 'výskytů',
-            statusImplemented: 'Hotovo',
-            statusPlaceholder: 'Připravuje se (zatím není plně hotové)',
-            noAliases: 'Žádné',
         },
         exampleLabels: {
             commitmentsUsed: 'Použité commitmenty',
@@ -30108,14 +30070,14 @@
                     'Hodí se pro asistenty, kteří si musí držet kontext v čase.',
                 ],
             },
-            'use-project-and-wallet-integration-agent': {
-                title: 'Napojení na projekt (USE PROJECT) a peněženku',
-                goal: 'Pracovat s repozitáři na GitHubu a s přihlašovacími údaji z peněženky.',
+            'use-project-integration-agent': {
+                title: 'Napojení na projekt (USE PROJECT)',
+                goal: 'Pracovat s repozitářem na GitHubu přes připojení projektu.',
                 walkthrough: [
                     '`USE PROJECT` zapne nástroje pro výpis, čtení a úpravy souborů a pro zakládání pull requestů.',
                     'Přihlašovací údaje se v Agents Serveru za běhu načtou ze záznamů v peněžence.',
-                    '`WALLET` je zde ponechaný jen kvůli zpětné kompatibilitě, aktuální parsování Book 2.0 ho ignoruje.',
-                    'V současném chování zajišťují napojení s přihlašovacími údaji commitmenty jako `USE PROJECT` a `USE EMAIL`.',
+                    'Agent má také výslovná pravidla pro bezpečné úpravy a práci s přihlašovacími údaji.',
+                    'Tento vzor použijte, když agent potřebuje soustředěný přístup k repozitáři.',
                 ],
             },
             'use-calendar-integration-agent': {
@@ -30185,10 +30147,10 @@
         footer: {
             title: 'Vygenerováno z:',
             body: spacetrim.spaceTrim(`
-            - Registru commitmentů a běhové dokumentace v \`src/commitments\`
-            - Chování parseru a překladače v \`src/book-2.0/agent-source\`
-            - Vyhodnocení odkazů a dědičnosti v Agents Serveru v \`apps/agents-server/src/utils\`
-            - Zdrojových bloků samostatné dokumentace v \`apps/agents-server/src/utils/bookLanguageDocumentation\`
+            - [Registru commitmentů a běhové dokumentace](https://github.com/webgptorg/promptbook/tree/main/src/commitments)
+            - [Parseru jazyka Book a práce se zdrojem](https://github.com/webgptorg/promptbook/tree/main/src/book-2.0/agent-source)
+            - [Vyhodnocení odkazů a dědičnosti v Agents Serveru](https://github.com/webgptorg/promptbook/tree/main/apps/agents-server/src/utils)
+            - [Zdrojových kódů samostatné příručky](https://github.com/webgptorg/promptbook/tree/main/src/book-2.0/book-language-documentation)
         `),
         },
     };
@@ -30211,9 +30173,7 @@
         metadataLabels: {
             bookLanguageVersion: 'Book language version',
             generatedAt: 'Generated at',
-            commitmentGroups: 'Commitment groups',
-            implementedCommitments: 'Implemented commitments',
-            placeholderCommitments: 'Placeholder commitments',
+            commitmentCount: 'Number of commitments',
         },
         tableOfContentsTitle: 'Table of Contents',
         chapters: {
@@ -30275,12 +30235,7 @@
             commitmentCatalog: {
                 title: 'Commitment catalog',
                 body: spacetrim.spaceTrim(`
-                This section is generated from commitment definitions in \`src/commitments\`.
-                For each commitment group you get:
-
-                - semantics summary (description/icon/status)
-                - parsing schema (\`createTypeRegex\` and \`createRegex\`)
-                - canonical documentation block
+                Each commitment section explains its purpose, important details, and a focused example.
             `),
             },
             examples: {
@@ -30367,41 +30322,28 @@
                 First non-empty line that is not a commitment keyword.
                 2. **Commitment block**:
                 Starts with a commitment keyword and continues until the next commitment block or separator.
-                3. **Horizontal separator**:
-                Lines like \`---\` split sections; in Agents Server they can delimit embedded in-book agents.
+                3. **Multiple agent**:
+                Lines like \`---\` separate agents defined in the same Book source.
                 4. **Code fences**:
-                Preserved inside commitment content; useful for examples/instructions.
-                5. **Parameters**:
-                Both \`@parameter\` and \`{parameter}\` notations are supported and parsed.
+                Start and end with <code>\`\`\`</code>; their content is preserved inside commitments and is useful for examples and instructions.
             `),
             },
             references: {
                 title: 'Reference tokens and pseudo-agents',
                 body: spacetrim.spaceTrim(`
-                - Compact references like \`{Agent Name}\` are resolved by Agents Server reference resolver.
+                - \`@Foo\` and \`{Foo foo}\` reference another agent; they are not parameter notation.
+                - Compact references like \`@Agent Name\` and \`{Agent Name}\` are resolved by the Agents Server reference resolver.
                 - Pseudo-agent forms (for example \`{User}\`, \`{Void}\`) are supported in relevant commitments.
                 - \`{User}\` is intended for \`TEAM\`; \`{Void}\` is useful for explicit no-parent inheritance.
             `),
             },
-            keywordsTitle: 'Commitment keywords currently recognized',
         },
         commitmentCatalogTitleSuffixes: {
             usedFirst: ' (used commitments first)',
             all: ' (all commitments)',
         },
         commitmentLabels: {
-            status: 'Status',
             aliases: 'Aliases',
-            semantics: 'Semantics',
-            typeSchema: 'Type schema',
-            blockSchema: 'Block schema',
-            lowLevelNotice: 'Low-level commitment',
-            usage: 'Used in selected agents',
-            usageOccurrence: 'occurrence',
-            usageOccurrences: 'occurrences',
-            statusImplemented: 'Implemented',
-            statusPlaceholder: 'Placeholder (not fully implemented)',
-            noAliases: 'None',
         },
         exampleLabels: {
             commitmentsUsed: 'Commitments used',
@@ -30451,14 +30393,14 @@
                     'Use this for assistants that must preserve context over time.',
                 ],
             },
-            'use-project-and-wallet-integration-agent': {
-                title: 'USE PROJECT and WALLET external integration',
-                goal: 'Work with GitHub repositories and wallet-backed credentials.',
+            'use-project-integration-agent': {
+                title: 'USE PROJECT external integration',
+                goal: 'Work with a GitHub repository through a connected project integration.',
                 walkthrough: [
                     '`USE PROJECT` enables repository tools for listing, reading, editing files, and creating PRs.',
                     'Credentials are resolved from wallet records at runtime in Agents Server.',
-                    '`WALLET` is kept here as a compatibility marker, but current Book 2.0 parsing treats it as ignored.',
-                    'In current runtime behavior, wallet-backed integrations are driven by commitments such as `USE PROJECT` and `USE EMAIL`.',
+                    'The agent also defines explicit rules for safe editing and credential handling.',
+                    'Use this pattern when an agent needs focused repository access.',
                 ],
             },
             'use-calendar-integration-agent': {
@@ -30528,10 +30470,10 @@
         footer: {
             title: 'Generated from:',
             body: spacetrim.spaceTrim(`
-            - Commitments registry and runtime docs in \`src/commitments\`
-            - Parser/compiler behavior in \`src/book-2.0/agent-source\`
-            - Agents Server reference/inheritance resolution in \`apps/agents-server/src/utils\`
-            - Standalone docs source blocks in \`apps/agents-server/src/utils/bookLanguageDocumentation\`
+            - [Commitments registry and runtime documentation](https://github.com/webgptorg/promptbook/tree/main/src/commitments)
+            - [Book language parser and source handling](https://github.com/webgptorg/promptbook/tree/main/src/book-2.0/agent-source)
+            - [Agents Server reference and inheritance resolution](https://github.com/webgptorg/promptbook/tree/main/apps/agents-server/src/utils)
+            - [Standalone manual source](https://github.com/webgptorg/promptbook/tree/main/src/book-2.0/book-language-documentation)
         `),
         },
     };
@@ -30580,6 +30522,28 @@
         return `${fence}${language}\n${content}\n${fence}`;
     }
 
+    /**
+     * Gets all available commitment definitions
+     *
+     * @returns Array of all commitment definitions
+     *
+     * @public exported from `@promptbook/core`
+     */
+    function getAllCommitmentDefinitions() {
+        return $deepFreeze(sortCommitmentDefinitions(COMMITMENT_REGISTRY, { isUnfinishedLast: true, isLowLevelLast: true }));
+    }
+
+    /**
+     * Gets all available commitment types
+     *
+     * @returns Array of all commitment types
+     *
+     * @public exported from `@promptbook/core`
+     */
+    function getAllCommitmentTypes() {
+        return $deepFreeze(getAllCommitmentDefinitions().map((commitmentDefinition) => commitmentDefinition.type));
+    }
+
     /**
      * Deepest heading level markdown supports.
      *
@@ -30653,6 +30617,19 @@
      * @private internal utility of `createStandaloneBookLanguageMarkdown`
      */
     const COMMITMENT_DOCUMENTATION_SECTION_HEADING_LEVEL = 2;
+    /**
+     * Markdown code blocks whose Book source is shown as a commitment example.
+     *
+     * @private internal utility of `createStandaloneBookLanguageMarkdown`
+     */
+    const BOOK_CODE_BLOCK_PATTERN = /(`{3,})book[^\n]*\n([\s\S]*?)\n\1/gu;
+    /**
+     * Recognized commitment types, ordered so compound keywords take priority over
+     * their shorter prefixes when reducing an example line by line.
+     *
+     * @private internal utility of `createStandaloneBookLanguageMarkdown`
+     */
+    const COMMITMENT_TYPES_BY_LENGTH = [...getAllCommitmentTypes()].sort((firstType, secondType) => secondType.length - firstType.length);
     /**
      * Removes the top-level heading from one commitment documentation block.
      *
@@ -30669,17 +30646,18 @@
      *
      * @param title - Heading label for the subsection.
      * @param documentation - Raw commitment documentation markdown.
+     * @param group - Commitment family represented by the documentation entry.
      * @param headingLevelShift - How many levels the whole entry is nested by its host document.
      * @returns Markdown subsection introducing one commitment of the family.
      *
      * @private internal utility of `createStandaloneBookLanguageMarkdown`
      */
-    function renderDocumentationSection(title, documentation, headingLevelShift) {
+    function renderDocumentationSection(title, documentation, group, headingLevelShift) {
         const headingPrefix = '#'.repeat(COMMITMENT_DOCUMENTATION_SECTION_HEADING_LEVEL + headingLevelShift);
         return spacetrim.spaceTrim((block) => `
             ${headingPrefix} ${title}
 
-            ${block(shiftMarkdownHeadingLevels(removeLeadingTopLevelHeading(documentation), headingLevelShift + 1))}
+            ${block(shiftMarkdownHeadingLevels(removeLeadingTopLevelHeading(renderFocusedCommitmentExamples(documentation, group)), headingLevelShift + 1))}
         `);
     }
     /**
@@ -30696,18 +30674,199 @@
      */
     function renderGroupedCommitmentDocumentationMarkdown(group, headingLevelShift = 0) {
         const commitmentTypes = new Set([group.primary.type, ...group.aliases]);
-        if (commitmentTypes.has(OPEN_COMMITMENT_TYPE) && commitmentTypes.has(CLOSED_COMMITMENT_TYPE)) {
+        const isOpenClosedCommitmentFamily = commitmentTypes.has(OPEN_COMMITMENT_TYPE) && commitmentTypes.has(CLOSED_COMMITMENT_TYPE);
+        if (isOpenClosedCommitmentFamily) {
             const openCommitmentDefinition = getCommitmentDefinition(OPEN_COMMITMENT_TYPE);
             const closedCommitmentDefinition = getCommitmentDefinition(CLOSED_COMMITMENT_TYPE);
             if (openCommitmentDefinition && closedCommitmentDefinition) {
                 return spacetrim.spaceTrim((block) => `
-                    ${block(renderDocumentationSection(OPEN_COMMITMENT_TYPE, openCommitmentDefinition.documentation, headingLevelShift))}
+                    ${block(renderDocumentationSection(OPEN_COMMITMENT_TYPE, openCommitmentDefinition.documentation, group, headingLevelShift))}
 
-                    ${block(renderDocumentationSection(CLOSED_COMMITMENT_TYPE, closedCommitmentDefinition.documentation, headingLevelShift))}
+                    ${block(renderDocumentationSection(CLOSED_COMMITMENT_TYPE, closedCommitmentDefinition.documentation, group, headingLevelShift))}
                 `);
             }
         }
-        return shiftMarkdownHeadingLevels(removeLeadingTopLevelHeading(group.primary.documentation), headingLevelShift);
+        return shiftMarkdownHeadingLevels(removeLeadingTopLevelHeading(renderFocusedCommitmentExamples(group.primary.documentation, group)), headingLevelShift);
+    }
+    /**
+     * Rewrites Book examples in commitment documentation to show one canonical
+     * commitment in isolation, with only `GOAL` and `CLOSED` as supporting syntax.
+     *
+     * @param documentation - Raw commitment documentation markdown.
+     * @param group - Commitment family represented by the documentation entry.
+     * @returns Documentation whose Book examples use focused canonical syntax.
+     *
+     * @private internal utility of `createStandaloneBookLanguageMarkdown`
+     */
+    function renderFocusedCommitmentExamples(documentation, group) {
+        return documentation.replace(BOOK_CODE_BLOCK_PATTERN, (codeBlock, _fence, source) => {
+            const focusedSource = createFocusedCommitmentExampleSource(source, group);
+            return focusedSource ? getSafeCodeBlock(focusedSource, 'book') : codeBlock;
+        });
+    }
+    /**
+     * Creates a focused Book source example for one commitment documentation entry.
+     *
+     * @param source - Original Book source from the commitment documentation.
+     * @param group - Commitment family represented by the documentation entry.
+     * @returns Focused source, or `null` when the source cannot be safely reduced.
+     *
+     * @private internal utility of `createStandaloneBookLanguageMarkdown`
+     */
+    function createFocusedCommitmentExampleSource(source, group) {
+        const parsedSource = parseAgentSourceWithCommitments(source);
+        const commitmentTypes = new Set([group.primary.type, ...group.aliases]);
+        const isOpenClosedCommitmentFamily = commitmentTypes.has(OPEN_COMMITMENT_TYPE) && commitmentTypes.has(CLOSED_COMMITMENT_TYPE);
+        const allowedCommitmentTypes = new Set([
+            group.primary.type,
+            ...group.aliases,
+            'GOAL',
+            CLOSED_COMMITMENT_TYPE,
+        ]);
+        const canonicalTypeByCommitmentType = createCanonicalCommitmentTypeByCommitmentType(group, isOpenClosedCommitmentFamily);
+        const focusedCommitments = parsedSource.commitments
+            .filter((commitment) => allowedCommitmentTypes.has(commitment.type))
+            .map((commitment) => {
+            const type = canonicalTypeByCommitmentType.get(commitment.type) || commitment.type;
+            return `${type}${commitment.content ? ` ${commitment.content}` : ''}`;
+        });
+        if (focusedCommitments.length > 0) {
+            return finalizeFocusedCommitmentExampleSource(getFocusedExampleAgentName(parsedSource.agentName), focusedCommitments);
+        }
+        return createLineFocusedCommitmentExampleSource(source, group, isOpenClosedCommitmentFamily);
+    }
+    /**
+     * Creates a focused example when the Book parser cannot recognize the target
+     * commitment because it appears as the first source line or has a shared prefix.
+     *
+     * @param source - Original Book source from the documentation code block.
+     * @param group - Commitment family represented by the documentation entry.
+     * @param isOpenClosedCommitmentFamily - Whether the family contains both switch commitments.
+     * @returns Focused source, or `null` when the source does not use this commitment family.
+     *
+     * @private internal utility of `createStandaloneBookLanguageMarkdown`
+     */
+    function createLineFocusedCommitmentExampleSource(source, group, isOpenClosedCommitmentFamily) {
+        const sourceLines = source.split(/\r?\n/u);
+        const allowedCommitmentTypes = new Set([group.primary.type, ...group.aliases, 'GOAL', CLOSED_COMMITMENT_TYPE]);
+        const canonicalTypeByCommitmentType = createCanonicalCommitmentTypeByCommitmentType(group, isOpenClosedCommitmentFamily);
+        const focusedCommitments = [];
+        const firstSourceLine = sourceLines.find((line) => line.trim().length > 0) || null;
+        const firstCommitmentType = firstSourceLine ? getCommitmentTypeAtLine(firstSourceLine) : null;
+        const agentName = firstSourceLine && !firstCommitmentType ? firstSourceLine.trim() : null;
+        let activeFocusedCommitmentIndex = null;
+        let isInsideCodeBlock = false;
+        for (const sourceLine of sourceLines) {
+            const trimmedSourceLine = sourceLine.trim();
+            if (trimmedSourceLine.startsWith('```')) {
+                appendLineToActiveCommitment(focusedCommitments, activeFocusedCommitmentIndex, sourceLine);
+                isInsideCodeBlock = !isInsideCodeBlock;
+                continue;
+            }
+            if (isInsideCodeBlock) {
+                appendLineToActiveCommitment(focusedCommitments, activeFocusedCommitmentIndex, sourceLine);
+                continue;
+            }
+            const commitmentType = getCommitmentTypeAtLine(sourceLine);
+            if (!commitmentType) {
+                appendLineToActiveCommitment(focusedCommitments, activeFocusedCommitmentIndex, sourceLine);
+                continue;
+            }
+            if (!allowedCommitmentTypes.has(commitmentType)) {
+                activeFocusedCommitmentIndex = null;
+                continue;
+            }
+            const canonicalType = canonicalTypeByCommitmentType.get(commitmentType) || commitmentType;
+            const content = trimmedSourceLine.slice(commitmentType.length).trimStart();
+            focusedCommitments.push(`${canonicalType}${content ? ` ${content}` : ''}`);
+            activeFocusedCommitmentIndex = focusedCommitments.length - 1;
+        }
+        return finalizeFocusedCommitmentExampleSource(agentName, focusedCommitments);
+    }
+    /**
+     * Finds the longest supported commitment keyword at the start of a source line.
+     *
+     * @param sourceLine - One Book source line to inspect.
+     * @returns Matching commitment type, or `null` when the line is ordinary content.
+     *
+     * @private internal utility of `createStandaloneBookLanguageMarkdown`
+     */
+    function getCommitmentTypeAtLine(sourceLine) {
+        const trimmedSourceLine = sourceLine.trim();
+        return (COMMITMENT_TYPES_BY_LENGTH.find((commitmentType) => trimmedSourceLine === commitmentType || trimmedSourceLine.startsWith(`${commitmentType} `)) || null);
+    }
+    /**
+     * Appends a source line only when a focused commitment currently owns it.
+     *
+     * @param focusedCommitments - Focused commitments assembled from the example.
+     * @param activeFocusedCommitmentIndex - Index of the commitment receiving continuation lines.
+     * @param sourceLine - Source line to append.
+     *
+     * @private internal utility of `createStandaloneBookLanguageMarkdown`
+     */
+    function appendLineToActiveCommitment(focusedCommitments, activeFocusedCommitmentIndex, sourceLine) {
+        if (activeFocusedCommitmentIndex === null) {
+            return;
+        }
+        focusedCommitments[activeFocusedCommitmentIndex] += `\n${sourceLine}`;
+    }
+    /**
+     * Adds the standard closing marker and formats one reduced Book example.
+     *
+     * @param agentName - Optional human-readable title retained from the original example.
+     * @param focusedCommitments - Canonical commitment blocks kept in the example.
+     * @returns Focused source, or `null` when no relevant commitment was found.
+     *
+     * @private internal utility of `createStandaloneBookLanguageMarkdown`
+     */
+    function finalizeFocusedCommitmentExampleSource(agentName, focusedCommitments) {
+        const normalizedFocusedCommitments = focusedCommitments.map((commitment) => commitment.trim());
+        if (normalizedFocusedCommitments.length === 0) {
+            return null;
+        }
+        const isClosedCommitmentIncluded = normalizedFocusedCommitments.some((commitment) => commitment.startsWith(CLOSED_COMMITMENT_TYPE));
+        const isOpenCommitmentIncluded = normalizedFocusedCommitments.some((commitment) => commitment.startsWith(OPEN_COMMITMENT_TYPE));
+        if (!isClosedCommitmentIncluded && !isOpenCommitmentIncluded) {
+            normalizedFocusedCommitments.push(CLOSED_COMMITMENT_TYPE);
+        }
+        return [agentName, ...normalizedFocusedCommitments]
+            .filter((line) => Boolean(line))
+            .join('\n\n');
+    }
+    /**
+     * Keeps an example title unless the parser interpreted a commitment-only
+     * example's first line as its mandatory agent name.
+     *
+     * @param agentName - Parsed agent name from the original example.
+     * @returns Agent title suitable for a focused example, or `null` when absent.
+     *
+     * @private internal utility of `createStandaloneBookLanguageMarkdown`
+     */
+    function getFocusedExampleAgentName(agentName) {
+        if (!agentName || getCommitmentDefinition(agentName)) {
+            return null;
+        }
+        return agentName;
+    }
+    /**
+     * Maps aliases to the canonical keyword shown by a commitment example.
+     *
+     * `OPEN` and `CLOSED` share one documentation entry, but each remains a
+     * distinct keyword and must therefore retain its own spelling.
+     *
+     * @param group - Commitment family represented by the documentation entry.
+     * @param isOpenClosedCommitmentFamily - Whether the family contains both switch commitments.
+     * @returns Canonical keyword by accepted source keyword.
+     *
+     * @private internal utility of `createStandaloneBookLanguageMarkdown`
+     */
+    function createCanonicalCommitmentTypeByCommitmentType(group, isOpenClosedCommitmentFamily) {
+        const canonicalTypeByCommitmentType = new Map();
+        canonicalTypeByCommitmentType.set(group.primary.type, group.primary.type);
+        for (const alias of group.aliases) {
+            canonicalTypeByCommitmentType.set(alias, isOpenClosedCommitmentFamily ? alias : group.primary.type);
+        }
+        return canonicalTypeByCommitmentType;
     }
 
     /**
@@ -30747,50 +30906,18 @@
      * @private internal utility of `createStandaloneBookLanguageMarkdown`
      */
     function renderCommitmentCatalogSection(options) {
-        var _a;
-        const { groupedCommitment, usageCount, dictionary } = options;
+        const { groupedCommitment, dictionary } = options;
         const { primary, aliases } = groupedCommitment;
         const labels = dictionary.commitmentLabels;
-        const notice = getCommitmentNoticeMetadata(primary);
-        const status = primary instanceof NotYetImplementedCommitmentDefinition
-            ? labels.statusPlaceholder
-            : notice
-                ? `${labels.statusImplemented} (${notice.detailLabel})`
-                : labels.statusImplemented;
-        const aliasText = aliases.length === 0 ? labels.noAliases : aliases.map((alias) => `\`${alias}\``).join(', ');
-        const noticeText = notice
-            ? notice.kind === 'deprecated'
-                ? `- **${notice.detailLabel}:** ${notice.message}${formatCommitmentReplacementText((_a = primary.deprecation) === null || _a === void 0 ? void 0 : _a.replacedBy)}`
-                : `- **${labels.lowLevelNotice}:** ${notice.message}`
-            : '';
-        const usageMarkdown = usageCount > 0
-            ? `- **${labels.usage}:** ${usageCount} ${usageCount === 1 ? labels.usageOccurrence : labels.usageOccurrences}`
-            : '';
+        const aliasesMarkdown = aliases.length === 0 ? '' : `- **${labels.aliases}:** ${aliases.map((alias) => `\`${alias}\``).join(', ')}`;
         return spacetrim.spaceTrim((block) => `
             ### <a id="commitment-${toStableAnchorId(primary.type)}"></a>${primary.icon} ${primary.type}
 
-            - **${labels.status}:** ${status}
-            - **${labels.aliases}:** ${aliasText}
-            - **${labels.semantics}:** ${primary.description}
-            - **${labels.typeSchema} (\`createTypeRegex\`):** \`${stringifyRegex(primary.createTypeRegex())}\`
-            - **${labels.blockSchema} (\`createRegex\`):** \`${stringifyRegex(primary.createRegex())}\`
-            ${noticeText}
-            ${usageMarkdown}
+            ${aliasesMarkdown}
 
             ${block(renderGroupedCommitmentDocumentationMarkdown(groupedCommitment, COMMITMENT_CATALOG_HEADING_LEVEL_SHIFT))}
         `);
     }
-    /**
-     * Converts a regular expression into a concise literal-like string.
-     *
-     * @param regex - Regex instance.
-     * @returns Printable regex pattern and flags.
-     *
-     * @private internal utility of `renderCommitmentCatalogSection`
-     */
-    function stringifyRegex(regex) {
-        return `/${regex.source}/${regex.flags}`;
-    }
 
     /**
      * Commitment types that primarily model composition of multiple agents.
@@ -30897,11 +31024,10 @@
             : [];
         const manualCommitments = [...catalogCommitments, ...lowLevelCommitments];
         const generatedAtIso = new Date().toISOString();
-        const placeholderCommitmentCount = manualCommitments.filter(({ primary }) => primary instanceof NotYetImplementedCommitmentDefinition).length;
         const catalogTitleSuffix = isServerSpecificManual
             ? dictionary.commitmentCatalogTitleSuffixes.usedFirst
             : dictionary.commitmentCatalogTitleSuffixes.all;
-        const allCommitmentKeywords = manualCommitments.flatMap(({ primary, aliases }) => [primary.type, ...aliases]);
+        const commitmentSectionAnchorByType = createCommitmentSectionAnchorByType(manualCommitments);
         return spacetrim.spaceTrim(
         // [✨]
         (block) => `
@@ -30911,9 +31037,7 @@
 
             - ${dictionary.metadataLabels.bookLanguageVersion}: \`${BOOK_LANGUAGE_VERSION}\`
             - ${dictionary.metadataLabels.generatedAt}: \`${generatedAtIso}\`
-            - ${dictionary.metadataLabels.commitmentGroups}: \`${manualCommitments.length}\`
-            - ${dictionary.metadataLabels.implementedCommitments}: \`${manualCommitments.length - placeholderCommitmentCount}\`
-            - ${dictionary.metadataLabels.placeholderCommitments}: \`${placeholderCommitmentCount}\`
+            - ${dictionary.metadataLabels.commitmentCount}: \`${manualCommitments.length}\`
 
             ## <a id="table-of-contents"></a>${dictionary.tableOfContentsTitle}
 
@@ -30922,12 +31046,16 @@
             - [${dictionary.chapters.howToStructure.title}](#how-to-structure-good-agents)
             - [${dictionary.chapters.primitives.title}](#primitives-and-constructs-reference)
             - [${dictionary.chapters.commitmentCatalog.title}${catalogTitleSuffix}](#commitment-catalog)
+            ${block(renderCommitmentCatalogTableOfContents(catalogCommitments))}
             - [${dictionary.chapters.examples.title}](#end-to-end-examples)
             - [${dictionary.chapters.pitfalls.title}](#do-nots-and-common-pitfalls)
             - [${dictionary.chapters.tutorial.title}](#build-an-agent-from-scratch-offline-tutorial)
-            ${isLowLevelCommitmentsIncluded
-        ? `- [${dictionary.chapters.lowLevelCommitments.title}](#low-level-commitments)`
-        : ''}
+            ${block(isLowLevelCommitmentsIncluded
+        ? spacetrim.spaceTrim(`
+                        - [${dictionary.chapters.lowLevelCommitments.title}](#low-level-commitments)
+                        ${renderCommitmentCatalogTableOfContents(lowLevelCommitments)}
+                    `)
+        : '')}
 
             ## <a id="what-book-language-is"></a>${dictionary.chapters.whatIs.title}
 
@@ -30971,24 +31099,20 @@
 
             ${block(dictionary.primitivesSections.references.body)}
 
-            ### ${dictionary.primitivesSections.keywordsTitle}
-
-            ${block(getSafeCodeBlock(allCommitmentKeywords.join(', '), 'text'))}
-
-            <a id="commitment-catalog-all-commitments"></a>
-
             ## <a id="commitment-catalog"></a>${dictionary.chapters.commitmentCatalog.title}${catalogTitleSuffix}
 
             ${block(dictionary.chapters.commitmentCatalog.body)}
 
-            ${block(renderCommitmentCatalogSections(catalogCommitments, commitmentUsageByType, dictionary))}
+            ${block(renderCommitmentCatalogSections(catalogCommitments, dictionary))}
 
             ## <a id="end-to-end-examples"></a>${dictionary.chapters.examples.title}
 
             ${block(isServerSpecificManual
-        ? selectedAgents.map((agent) => renderBakedAgentExampleSection(agent, dictionary)).join('\n\n')
+        ? selectedAgents
+            .map((agent) => renderBakedAgentExampleSection(agent, dictionary, commitmentSectionAnchorByType))
+            .join('\n\n')
         : bookLanguageDocumentationExamples
-            .map((example) => renderExampleSection(example, dictionary))
+            .map((example) => renderExampleSection(example, dictionary, commitmentSectionAnchorByType))
             .join('\n\n'))}
 
             ## <a id="do-nots-and-common-pitfalls"></a>${dictionary.chapters.pitfalls.title}
@@ -31008,7 +31132,7 @@
             ${block(dictionary.tutorialSections.checklistBody)}
 
             ${block(isLowLevelCommitmentsIncluded
-        ? renderLowLevelCommitmentsChapter(lowLevelCommitments, commitmentUsageByType, dictionary)
+        ? renderLowLevelCommitmentsChapter(lowLevelCommitments, dictionary)
         : '')}
 
             ---
@@ -31048,17 +31172,15 @@
      * Renders every commitment section of one catalog chapter.
      *
      * @param commitmentGroups - Commitment groups to render, in final order.
-     * @param commitmentUsageByType - Selected-agent occurrence counts by primary type.
      * @param dictionary - Translated labels of the manual.
      * @returns Markdown sections joined by blank lines.
      *
      * @private internal utility of `createStandaloneBookLanguageMarkdown`
      */
-    function renderCommitmentCatalogSections(commitmentGroups, commitmentUsageByType, dictionary) {
+    function renderCommitmentCatalogSections(commitmentGroups, dictionary) {
         return commitmentGroups
             .map((groupedCommitment) => renderCommitmentCatalogSection({
             groupedCommitment,
-            usageCount: commitmentUsageByType.get(groupedCommitment.primary.type) || 0,
             dictionary,
         }))
             .join('\n\n');
@@ -31067,21 +31189,52 @@
      * Renders the closing chapter documenting low-level commitments.
      *
      * @param commitmentGroups - Low-level commitment groups, in final order.
-     * @param commitmentUsageByType - Selected-agent occurrence counts by primary type.
      * @param dictionary - Translated labels of the manual.
      * @returns Markdown chapter for low-level commitments.
      *
      * @private internal utility of `createStandaloneBookLanguageMarkdown`
      */
-    function renderLowLevelCommitmentsChapter(commitmentGroups, commitmentUsageByType, dictionary) {
+    function renderLowLevelCommitmentsChapter(commitmentGroups, dictionary) {
         return spacetrim.spaceTrim((block) => `
             ## <a id="low-level-commitments"></a>${dictionary.chapters.lowLevelCommitments.title}
 
             ${block(dictionary.chapters.lowLevelCommitments.body)}
 
-            ${block(renderCommitmentCatalogSections(commitmentGroups, commitmentUsageByType, dictionary))}
+            ${block(renderCommitmentCatalogSections(commitmentGroups, dictionary))}
         `);
     }
+    /**
+     * Renders links from the manual table of contents to the commitment sections.
+     *
+     * @param commitmentGroups - Commitment sections included in the manual.
+     * @returns Indented markdown links ordered like the catalog.
+     *
+     * @private internal utility of `createStandaloneBookLanguageMarkdown`
+     */
+    function renderCommitmentCatalogTableOfContents(commitmentGroups) {
+        return commitmentGroups
+            .map(({ primary }) => `    - [${primary.icon} \`${primary.type}\`](#commitment-${toStableAnchorId(primary.type)})`)
+            .join('\n');
+    }
+    /**
+     * Maps every recognized spelling of a documented commitment to its stable section anchor.
+     *
+     * @param commitmentGroups - Commitment sections included in the manual.
+     * @returns Canonical anchor id by parsed commitment type.
+     *
+     * @private internal utility of `createStandaloneBookLanguageMarkdown`
+     */
+    function createCommitmentSectionAnchorByType(commitmentGroups) {
+        const anchorByType = new Map();
+        for (const { primary, aliases } of commitmentGroups) {
+            const anchorId = `commitment-${toStableAnchorId(primary.type)}`;
+            anchorByType.set(primary.type, anchorId);
+            for (const alias of aliases) {
+                anchorByType.set(alias, anchorId);
+            }
+        }
+        return anchorByType;
+    }
     /**
      * Renders the "don't vs do" list of common authoring pitfalls.
      *
@@ -31188,9 +31341,9 @@
      *
      * @private internal utility of `createStandaloneBookLanguageMarkdown`
      */
-    function renderBakedAgentExampleSection(agent, dictionary) {
+    function renderBakedAgentExampleSection(agent, dictionary, commitmentSectionAnchorByType) {
         const usedCommitmentTypes = Array.from(new Set(parseAgentSourceWithCommitments(agent.agentSource).commitments.map((commitment) => commitment.type)));
-        const usedCommitmentsMarkdown = usedCommitmentTypes.map((type) => `\`${type}\``).join(', ');
+        const usedCommitmentsMarkdown = renderCommitmentSectionLinks(usedCommitmentTypes, commitmentSectionAnchorByType);
         return spacetrim.spaceTrim((block) => `
             ### <a id="example-${toStableAnchorId(agent.agentName)}"></a>${agent.agentName}
 
@@ -31210,7 +31363,7 @@
      *
      * @private internal utility of `createStandaloneBookLanguageMarkdown`
      */
-    function renderExampleSection(example, dictionary) {
+    function renderExampleSection(example, dictionary, commitmentSectionAnchorByType) {
         const exampleText = dictionary.exampleTexts[example.id];
         if (exampleText === undefined) {
             return '';
@@ -31220,6 +31373,8 @@
 
             **${dictionary.exampleLabels.goal}:** ${exampleText.goal}
 
+            **${dictionary.exampleLabels.commitmentsUsed}:** ${renderCommitmentSectionLinks(parseAgentSourceWithCommitments(example.source).commitments.map((commitment) => commitment.type), commitmentSectionAnchorByType)}
+
             **${dictionary.exampleLabels.fullSource}**
 
             ${block(getSafeCodeBlock(example.source, 'book'))}
@@ -31229,6 +31384,23 @@
             ${block(exampleText.walkthrough.map((step, index) => `${index + 1}. ${step}`).join('\n'))}
         `);
     }
+    /**
+     * Renders unique commitment links used by an end-to-end example.
+     *
+     * @param commitmentTypes - Commitment types in their source order.
+     * @param commitmentSectionAnchorByType - Documented commitment anchors by parsed type.
+     * @returns Comma-separated markdown links, or an empty string when none are documented.
+     *
+     * @private internal utility of `createStandaloneBookLanguageMarkdown`
+     */
+    function renderCommitmentSectionLinks(commitmentTypes, commitmentSectionAnchorByType) {
+        return Array.from(new Set(commitmentTypes))
+            .flatMap((type) => {
+            const anchorId = commitmentSectionAnchorByType.get(type);
+            return anchorId ? [`[\`${type}\`](#${anchorId})`] : [];
+        })
+            .join(', ');
+    }
 
     /**
      * Generates an image for the agent to use as profile image
@@ -32208,17 +32380,6 @@
     }
     // TODO: [🧠] Maybe clear `sourceFile` or clear when exposing through API or remote server
 
-    /**
-     * Gets all available commitment definitions
-     *
-     * @returns Array of all commitment definitions
-     *
-     * @public exported from `@promptbook/core`
-     */
-    function getAllCommitmentDefinitions() {
-        return $deepFreeze(sortCommitmentDefinitions(COMMITMENT_REGISTRY, { isUnfinishedLast: true, isLowLevelLast: true }));
-    }
-
     /**
      * Gets all tool titles provided by all commitments
      *
@@ -32239,17 +32400,6 @@
         return allToolTitles;
     }
 
-    /**
-     * Gets all available commitment types
-     *
-     * @returns Array of all commitment types
-     *
-     * @public exported from `@promptbook/core`
-     */
-    function getAllCommitmentTypes() {
-        return $deepFreeze(getAllCommitmentDefinitions().map((commitmentDefinition) => commitmentDefinition.type));
-    }
-
     /**
      * Checks if a commitment type is supported
      *