@promptbook/core 0.114.0-0 → 0.114.0-2

package/esm/index.es.js

@@ -28,7 +28,7 @@ const BOOK_LANGUAGE_VERSION = '2.0.0';
  * @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
@@ -29676,13 +29676,12 @@ const bookLanguageDocumentationExamples = [
         `),
     },
     {
-        id: 'use-project-and-wallet-integration-agent',
+        id: 'use-project-integration-agent',
         source: spaceTrim$1(`
             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.
@@ -29754,24 +29753,6 @@ const DEPRECATED_COMMITMENT_DETAIL_LABEL = 'Deprecated commitment';
  * 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.
  *
@@ -29837,6 +29818,10 @@ function getBookLanguageManualCommitmentGroups() {
         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;
@@ -29864,9 +29849,7 @@ const czechBookLanguageManualDictionary = {
     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: {
@@ -29928,15 +29911,7 @@ const czechBookLanguageManualDictionary = {
         commitmentCatalog: {
             title: 'Katalog commitmentů',
             body: spaceTrim$1(`
-                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: {
@@ -30023,41 +29998,28 @@ const czechBookLanguageManualDictionary = {
                 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$1(`
-                - 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',
@@ -30107,14 +30069,14 @@ const czechBookLanguageManualDictionary = {
                 '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': {
@@ -30184,10 +30146,10 @@ const czechBookLanguageManualDictionary = {
     footer: {
         title: 'Vygenerováno z:',
         body: spaceTrim$1(`
-            - 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)
         `),
     },
 };
@@ -30210,9 +30172,7 @@ const englishBookLanguageManualDictionary = {
     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: {
@@ -30274,12 +30234,7 @@ const englishBookLanguageManualDictionary = {
         commitmentCatalog: {
             title: 'Commitment catalog',
             body: spaceTrim$1(`
-                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: {
@@ -30366,41 +30321,28 @@ const englishBookLanguageManualDictionary = {
                 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$1(`
-                - 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',
@@ -30450,14 +30392,14 @@ const englishBookLanguageManualDictionary = {
                 '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': {
@@ -30527,10 +30469,10 @@ const englishBookLanguageManualDictionary = {
     footer: {
         title: 'Generated from:',
         body: spaceTrim$1(`
-            - 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)
         `),
     },
 };
@@ -30579,6 +30521,28 @@ function getSafeCodeBlock(content, language = 'markdown') {
     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.
  *
@@ -30652,6 +30616,19 @@ const CLOSED_COMMITMENT_TYPE = 'CLOSED';
  * @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.
  *
@@ -30668,17 +30645,18 @@ function removeLeadingTopLevelHeading(markdown) {
  *
  * @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$1((block) => `
             ${headingPrefix} ${title}
 
-            ${block(shiftMarkdownHeadingLevels(removeLeadingTopLevelHeading(documentation), headingLevelShift + 1))}
+            ${block(shiftMarkdownHeadingLevels(removeLeadingTopLevelHeading(renderFocusedCommitmentExamples(documentation, group)), headingLevelShift + 1))}
         `);
 }
 /**
@@ -30695,18 +30673,199 @@ function renderDocumentationSection(title, documentation, headingLevelShift) {
  */
 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$1((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;
 }
 
 /**
@@ -30746,50 +30905,18 @@ const COMMITMENT_CATALOG_HEADING_LEVEL_SHIFT = 2;
  * @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$1((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.
@@ -30896,11 +31023,10 @@ function createStandaloneBookLanguageMarkdown(options = {}) {
         : [];
     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$1(
     // [✨]
     (block) => `
@@ -30910,9 +31036,7 @@ function createStandaloneBookLanguageMarkdown(options = {}) {
 
             - ${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}
 
@@ -30921,12 +31045,16 @@ function createStandaloneBookLanguageMarkdown(options = {}) {
             - [${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$1(`
+                        - [${dictionary.chapters.lowLevelCommitments.title}](#low-level-commitments)
+                        ${renderCommitmentCatalogTableOfContents(lowLevelCommitments)}
+                    `)
+        : '')}
 
             ## <a id="what-book-language-is"></a>${dictionary.chapters.whatIs.title}
 
@@ -30970,24 +31098,20 @@ function createStandaloneBookLanguageMarkdown(options = {}) {
 
             ${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}
@@ -31007,7 +31131,7 @@ function createStandaloneBookLanguageMarkdown(options = {}) {
             ${block(dictionary.tutorialSections.checklistBody)}
 
             ${block(isLowLevelCommitmentsIncluded
-        ? renderLowLevelCommitmentsChapter(lowLevelCommitments, commitmentUsageByType, dictionary)
+        ? renderLowLevelCommitmentsChapter(lowLevelCommitments, dictionary)
         : '')}
 
             ---
@@ -31047,17 +31171,15 @@ function renderDetectedCommitmentList(commitmentGroups, dictionary) {
  * 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');
@@ -31066,21 +31188,52 @@ function renderCommitmentCatalogSections(commitmentGroups, commitmentUsageByType
  * 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$1((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.
  *
@@ -31187,9 +31340,9 @@ function prioritizeGroupedCommitments(groupedCommitments, commitmentUsageByType)
  *
  * @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$1((block) => `
             ### <a id="example-${toStableAnchorId(agent.agentName)}"></a>${agent.agentName}
 
@@ -31209,7 +31362,7 @@ function renderBakedAgentExampleSection(agent, dictionary) {
  *
  * @private internal utility of `createStandaloneBookLanguageMarkdown`
  */
-function renderExampleSection(example, dictionary) {
+function renderExampleSection(example, dictionary, commitmentSectionAnchorByType) {
     const exampleText = dictionary.exampleTexts[example.id];
     if (exampleText === undefined) {
         return '';
@@ -31219,6 +31372,8 @@ function renderExampleSection(example, dictionary) {
 
             **${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'))}
@@ -31228,6 +31383,23 @@ function renderExampleSection(example, dictionary) {
             ${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
@@ -32207,17 +32379,6 @@ async function pipelineCollectionToJson(collection) {
 }
 // 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
  *
@@ -32238,17 +32399,6 @@ function getAllCommitmentsToolTitles() {
     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
  *