@promptbook/cli 0.114.0-2 → 0.114.0-21

package/src/book-2.0/agent-source/parseAgentSourceWithCommitments.ts

@@ -3,7 +3,9 @@ import type { BookCommitment } from '../../commitments/_base/BookCommitment';
 import type { ParsedCommitment } from '../../commitments/_base/ParsedCommitment';
 import { COMMITMENT_REGISTRY } from '../../commitments/index';
 import type { AgentSourceParseResult } from './AgentSourceParseResult';
+import { getBookCommitmentLineType } from './getBookCommitmentLineType';
 import { parseAgentSourcePrelude } from './parseAgentSourcePrelude';
+import type { ParsedUnknownCommitment } from './ParsedUnknownCommitment';
 import type { string_book } from './string_book';
 
 /**
@@ -12,6 +14,39 @@ import type { string_book } from './string_book';
  */
 const HORIZONTAL_LINE_PATTERN = /^[\s]*[-_*][\s]*[-_*][\s]*[-_*][\s]*[-_*]*[\s]*$/;
 
+/**
+ * Registered commitment block currently being collected from Book source.
+ *
+ * @private internal type of `parseAgentSourceWithCommitments`
+ */
+type CurrentKnownCommitment = {
+    readonly kind: 'known';
+    readonly type: string;
+    readonly startLineNumber: number;
+    readonly originalStartLine: string;
+    readonly contentLines: string[];
+};
+
+/**
+ * Unknown commitment block currently being collected from Book source.
+ *
+ * @private internal type of `parseAgentSourceWithCommitments`
+ */
+type CurrentUnknownCommitment = {
+    readonly kind: 'unknown';
+    readonly type: string;
+    readonly startLineNumber: number;
+    readonly originalStartLine: string;
+    readonly sourceLines: string[];
+};
+
+/**
+ * Commitment-like source block currently being collected.
+ *
+ * @private internal type of `parseAgentSourceWithCommitments`
+ */
+type CurrentCommitment = CurrentKnownCommitment | CurrentUnknownCommitment;
+
 /**
  * Parses agent source using the new commitment system with multiline support
  * This function replaces the hardcoded commitment parsing in the original parseAgentSource
@@ -26,6 +61,7 @@ export function parseAgentSourceWithCommitments(agentSource: string_book): Omit<
         return {
             agentName: null,
             commitments: [],
+            unknownCommitments: [],
             nonCommitmentLines: [],
         };
     }
@@ -33,15 +69,11 @@ export function parseAgentSourceWithCommitments(agentSource: string_book): Omit<
     const { lines, agentName, agentNameLineIndex, agentNameLineNumber } = parseAgentSourcePrelude(agentSource);
 
     const commitments: ParsedCommitment[] = [];
+    const unknownCommitments: ParsedUnknownCommitment[] = [];
     const nonCommitmentLines: string[] = agentNameLineIndex >= 0 ? [lines[agentNameLineIndex]!] : [];
 
-    // Parse commitments with multiline support
-    let currentCommitment: {
-        type: string;
-        startLineNumber: number;
-        originalStartLine: string;
-        contentLines: string[];
-    } | null = null;
+    // Parse commitments with multiline support.
+    let currentCommitment: CurrentCommitment | null = null;
 
     // Process lines starting from after the agent name line
     const startIndex = agentNameLineIndex >= 0 ? agentNameLineIndex + 1 : 0;
@@ -58,24 +90,12 @@ export function parseAgentSourceWithCommitments(agentSource: string_book): Omit<
         if (trimmedLine.startsWith('```')) {
             isInsideCodeBlock = !isInsideCodeBlock;
 
-            if (currentCommitment) {
-                // If we are inside a commitment, the code block is part of it
-                currentCommitment.contentLines.push(line);
-            } else {
-                // If we are not inside a commitment, the code block is non-commitment
-                nonCommitmentLines.push(line);
-            }
+            appendLineToCurrentCommitmentOrNonCommitmentLines(currentCommitment, line, nonCommitmentLines);
             continue;
         }
 
         if (isInsideCodeBlock) {
-            if (currentCommitment) {
-                // If we are inside a commitment and a code block, the line is part of the commitment
-                currentCommitment.contentLines.push(line);
-            } else {
-                // If we are inside a code block but not a commitment, the line is non-commitment
-                nonCommitmentLines.push(line);
-            }
+            appendLineToCurrentCommitmentOrNonCommitmentLines(currentCommitment, line, nonCommitmentLines);
             continue;
         }
 
@@ -86,16 +106,7 @@ export function parseAgentSourceWithCommitments(agentSource: string_book): Omit<
             const match = typeRegex.exec(line.trim());
 
             if (match && match.groups?.type) {
-                // Save the previous commitment if it exists
-                if (currentCommitment) {
-                    const fullContent = currentCommitment.contentLines.join('\n');
-                    commitments.push({
-                        type: currentCommitment.type as BookCommitment,
-                        content: spaceTrim(fullContent),
-                        originalLine: currentCommitment.originalStartLine,
-                        lineNumber: currentCommitment.startLineNumber,
-                    });
-                }
+                appendCurrentCommitment(currentCommitment, commitments, unknownCommitments);
 
                 // Extract the initial content from the commitment line
                 const fullRegex = definition.createRegex();
@@ -104,6 +115,7 @@ export function parseAgentSourceWithCommitments(agentSource: string_book): Omit<
 
                 // Start a new commitment
                 currentCommitment = {
+                    kind: 'known',
                     type: definition.type,
                     startLineNumber: i + 1,
                     originalStartLine: line,
@@ -114,51 +126,106 @@ export function parseAgentSourceWithCommitments(agentSource: string_book): Omit<
             }
         }
 
+        if (foundNewCommitment) {
+            continue;
+        }
+
+        const unknownCommitmentType = getBookCommitmentLineType(line);
+        if (unknownCommitmentType) {
+            appendCurrentCommitment(currentCommitment, commitments, unknownCommitments);
+            currentCommitment = {
+                kind: 'unknown',
+                type: unknownCommitmentType,
+                startLineNumber: i + 1,
+                originalStartLine: line,
+                sourceLines: [line],
+            };
+            continue;
+        }
+
         // Check if this is a horizontal line (ends any current commitment)
         const isHorizontalLine = HORIZONTAL_LINE_PATTERN.test(line);
         if (isHorizontalLine) {
-            // Save the current commitment if it exists
-            if (currentCommitment) {
-                const fullContent = currentCommitment.contentLines.join('\n');
-                commitments.push({
-                    type: currentCommitment.type as BookCommitment,
-                    content: spaceTrim(fullContent),
-                    originalLine: currentCommitment.originalStartLine,
-                    lineNumber: currentCommitment.startLineNumber,
-                });
-                currentCommitment = null;
-            }
+            appendCurrentCommitment(currentCommitment, commitments, unknownCommitments);
+            currentCommitment = null;
             // Add horizontal line to non-commitment lines
             nonCommitmentLines.push(line);
             continue;
         }
 
-        if (!foundNewCommitment) {
-            if (currentCommitment) {
-                // This line belongs to the current commitment
-                currentCommitment.contentLines.push(line);
-            } else {
-                // This line is not part of any commitment
-                nonCommitmentLines.push(line);
-            }
-        }
+        appendLineToCurrentCommitmentOrNonCommitmentLines(currentCommitment, line, nonCommitmentLines);
     }
 
-    // Don't forget to save the last commitment if it exists
-    if (currentCommitment) {
-        const fullContent = currentCommitment.contentLines.join('\n');
-        commitments.push({
-            type: currentCommitment.type as BookCommitment,
-            content: spaceTrim(fullContent) as BookCommitment,
-            originalLine: currentCommitment.originalStartLine,
-            lineNumber: currentCommitment.startLineNumber,
-        });
-    }
+    appendCurrentCommitment(currentCommitment, commitments, unknownCommitments);
 
     return {
         agentName,
         agentNameLineNumber,
         commitments,
+        unknownCommitments,
         nonCommitmentLines,
     };
 }
+
+/**
+ * Stores the current known or unknown commitment in its appropriate parsed collection.
+ *
+ * @param currentCommitment - Commitment-like block collected so far.
+ * @param commitments - Parsed registered commitments to append to.
+ * @param unknownCommitments - Parsed unregistered commitments to append to.
+ *
+ * @private internal utility of `parseAgentSourceWithCommitments`
+ */
+function appendCurrentCommitment(
+    currentCommitment: CurrentCommitment | null,
+    commitments: ParsedCommitment[],
+    unknownCommitments: ParsedUnknownCommitment[],
+): void {
+    if (!currentCommitment) {
+        return;
+    }
+
+    if (currentCommitment.kind === 'unknown') {
+        unknownCommitments.push({
+            type: currentCommitment.type,
+            originalLine: currentCommitment.originalStartLine,
+            lineNumber: currentCommitment.startLineNumber,
+            source: spaceTrim(currentCommitment.sourceLines.join('\n')),
+        });
+        return;
+    }
+
+    commitments.push({
+        type: currentCommitment.type as BookCommitment,
+        content: spaceTrim(currentCommitment.contentLines.join('\n')),
+        originalLine: currentCommitment.originalStartLine,
+        lineNumber: currentCommitment.startLineNumber,
+    });
+}
+
+/**
+ * Adds one source line to the active commitment-like block, or to plain source content when none is active.
+ *
+ * @param currentCommitment - Commitment-like block currently being collected.
+ * @param line - Source line to append.
+ * @param nonCommitmentLines - Plain source lines to append to when no block is active.
+ *
+ * @private internal utility of `parseAgentSourceWithCommitments`
+ */
+function appendLineToCurrentCommitmentOrNonCommitmentLines(
+    currentCommitment: CurrentCommitment | null,
+    line: string,
+    nonCommitmentLines: string[],
+): void {
+    if (!currentCommitment) {
+        nonCommitmentLines.push(line);
+        return;
+    }
+
+    if (currentCommitment.kind === 'unknown') {
+        currentCommitment.sourceLines.push(line);
+        return;
+    }
+
+    currentCommitment.contentLines.push(line);
+}

package/src/book-2.0/agent-source/string_book.ts

@@ -44,7 +44,7 @@ export const DEFAULT_BOOK = padBook(
         spaceTrim(`
             AI Avatar
 
-            PERSONA A friendly AI assistant that helps you with your tasks
+            GOAL Help users with their tasks as a friendly AI assistant.
         `),
     ),
 );

package/src/book-2.0/book-language-documentation/bookLanguageDocumentationExamples.ts

@@ -21,19 +21,6 @@ export const bookLanguageDocumentationExamples: ReadonlyArray<BookLanguageDocume
             CLOSED
         `),
     },
-    {
-        id: 'tool-using-browser-search-agent',
-        source: spaceTrim(`
-            Web Research Assistant
-
-            GOAL Research topics using fresh and verifiable information.
-            USE SEARCH ENGINE Prefer official sources and recent publications.
-            USE BROWSER
-            RULE Verify important claims across multiple sources when possible.
-            RULE Include source links in your final answer.
-            INITIAL MESSAGE Ask me what topic you want to research and how deep the report should be.
-        `),
-    },
     {
         id: 'rule-and-knowledge-agent',
         source: spaceTrim(`
@@ -47,18 +34,6 @@ export const bookLanguageDocumentationExamples: ReadonlyArray<BookLanguageDocume
             INITIAL MESSAGE I can explain refund and support rules from provided knowledge.
         `),
     },
-    {
-        id: 'memory-agent-with-long-term-memory',
-        source: spaceTrim(`
-            Customer Success Memory Agent
-
-            GOAL Support SaaS customers while remembering relevant setup and preference context.
-            MEMORY Remember product setup, user goals, and communication preferences.
-            RULE Store only user-approved preferences and project context.
-            RULE Never store secrets or sensitive data unless explicitly requested and allowed.
-            INITIAL MESSAGE I can remember your setup and preferences for future sessions.
-        `),
-    },
     {
         id: 'use-project-integration-agent',
         source: spaceTrim(`

package/src/book-2.0/book-language-documentation/createStandaloneBookLanguageMarkdown.ts

@@ -30,22 +30,13 @@ const COMPOSITION_COMMITMENT_TYPES = new Set(['FROM', 'IMPORT', 'IMPORTS', 'TEAM
  * @private internal utility of `createStandaloneBookLanguageMarkdown`
  */
 const TOOLING_COMMITMENT_TYPES = new Set([
-    'USE BROWSER',
-    'USE DEEPSEARCH',
-    'USE SEARCH ENGINE',
-    'USE SEARCH',
-    'USE SPAWN',
-    'USE EMAIL',
     'USE POPUP',
-    'USE TIME',
     'USE USER LOCATION',
     'USE PROJECT',
     'USE CALENDAR',
     'USE IMAGE GENERATOR',
     'USE MCP',
     'USE PRIVACY',
-    'MEMORY',
-    'MEMORIES',
 ]);
 
 /**
@@ -56,7 +47,6 @@ const TOOLING_COMMITMENT_TYPES = new Set([
 const PROFILE_COMMITMENT_TYPES = new Set([
     'GOAL',
     'GOALS',
-    'META',
     'META AVATAR',
     'META VISUAL',
     'META IMAGE',
@@ -64,6 +54,8 @@ const PROFILE_COMMITMENT_TYPES = new Set([
     'META DOMAIN',
     'META DESCRIPTION',
     'META DISCLAIMER',
+    'META FULLNAME',
+    'META ID',
     'META INPUT PLACEHOLDER',
     'META THINKING MESSAGE',
     'META VISIBILITY',
@@ -288,9 +280,7 @@ export function createStandaloneBookLanguageMarkdown(
             ${block(dictionary.tutorialSections.checklistBody)}
 
             ${block(
-                isLowLevelCommitmentsIncluded
-                    ? renderLowLevelCommitmentsChapter(lowLevelCommitments, dictionary)
-                    : '',
+                isLowLevelCommitmentsIncluded ? renderLowLevelCommitmentsChapter(lowLevelCommitments, dictionary) : '',
             )}
 
             ---
@@ -604,7 +594,9 @@ function renderExampleSection(
             **${dictionary.exampleLabels.goal}:** ${exampleText.goal}
 
             **${dictionary.exampleLabels.commitmentsUsed}:** ${renderCommitmentSectionLinks(
-            parseAgentSourceWithCommitments(example.source as string_book).commitments.map((commitment) => commitment.type),
+            parseAgentSourceWithCommitments(example.source as string_book).commitments.map(
+                (commitment) => commitment.type,
+            ),
             commitmentSectionAnchorByType,
         )}
 

package/src/book-2.0/book-language-documentation/czechBookLanguageManualDictionary.ts

@@ -47,7 +47,7 @@ export const czechBookLanguageManualDictionary: BookLanguageManualDictionary = {
                 2. **Vrstva chování**:
                 \`RULE\`, \`KNOWLEDGE\`, \`WRITING SAMPLE\`, \`WRITING RULES\`, \`LANGUAGE\`, \`GOAL\` a příbuzné commitmenty.
                 3. **Vrstva schopností**:
-                \`USE*\`, \`MEMORY\` a další nástrojové commitmenty, které agentovi otevírají běhové schopnosti.
+                \`USE*\` a další nástrojové commitmenty, které agentovi otevírají běhové schopnosti.
                 4. **Vrstva skládání**:
                 Dědičnost přes \`FROM\`, znovupoužití přes \`IMPORT\` a delegování přes \`TEAM\`.
             `),
@@ -69,9 +69,9 @@ export const czechBookLanguageManualDictionary: BookLanguageManualDictionary = {
                 4. **Skládání místo jednoho velkého agenta**:
                 Na specializované odpovědnosti použijte \`TEAM\` nebo \`IMPORT\`.
                 Kompromis: režie s koordinací, výrazně lepší modularita a znovupoužitelnost.
-                5. **Řízená paměť**:
-                Pokud používáte \`MEMORY\`, popište, co se pamatovat má a co v žádném případě ne.
-                Kompromis: přísnější návrh pravidel, lepší soukromí i kvalita zapamatovaného.
+                5. **Řízená práce s daty**:
+                Pokud používáte \`USE PRIVACY\`, popište, co smí a co v žádném případě nesmí opustit konverzaci.
+                Kompromis: přísnější návrh pravidel, lepší soukromí i kvalita odpovědí.
             `),
         },
         primitives: {
@@ -102,7 +102,7 @@ export const czechBookLanguageManualDictionary: BookLanguageManualDictionary = {
                 3. **Přidejte oporu ve znalostech**
                 Přidejte commitmenty \`KNOWLEDGE\` (přímý text, nebo lokální či importovatelné zdroje).
                 4. **Přidejte schopnosti**
-                Přidejte jen ty commitmenty \`USE*\` a \`MEMORY\`, které agent opravdu potřebuje.
+                Přidejte jen ty commitmenty \`USE*\`, které agent opravdu potřebuje.
                 5. **Doplňte profilová metadata**
                 Přidejte \`META DESCRIPTION\`, \`META AVATAR\` / \`META VISUAL\` nebo \`META IMAGE\`, \`META INPUT PLACEHOLDER\`, \`META THINKING MESSAGE\` a případná upozornění.
                 6. **Připravte první interakci**
@@ -140,7 +140,12 @@ export const czechBookLanguageManualDictionary: BookLanguageManualDictionary = {
                 \`FROM\` odkazuje na zdroj rodičovského agenta. Při vyhodnocení dědičnosti platí:
 
                 - Obsah rodiče se sloučí do výsledného zdroje.
-                - \`FROM {Void}\` / \`FROM VOID\` znamená výslovné „žádný rodič“.
+                - Když \`FROM\` není uvedeno vůbec, platí to samé jako \`FROM @Adam\`, tedy jádrový agent, ze kterého dědí každý agent.
+                - \`FROM @Null\` / \`FROM {Void}\` / \`FROM VOID\` znamená výslovné „žádný rodič“.
+                - Výslovně zvolený rodič nahradí implicitního Adama; vlastní řetězec \`FROM\` tohoto rodiče se pak zdědí běžným způsobem.
+                - \`@Jmeno\` je pro jednoslovné jméno agenta zkratka zápisu \`{Jmeno}\`.
+                - Když je \`FROM\` uvedeno vícekrát, platí poslední a přepíše všechna předchozí.
+                - Adam je kořenový agent a musí výslovně použít \`FROM @Null\` (\`@Void\` je ekvivalentní). Editor knihy upozorní na jiného Adamova rodiče i na lokální cykly dědičnosti.
                 - Chybějící odkazy se do výsledného zdroje propíší jako poznámky.
             `),
         },
@@ -155,7 +160,7 @@ export const czechBookLanguageManualDictionary: BookLanguageManualDictionary = {
         capabilities: {
             title: 'Commitmenty USE',
             body: spaceTrim(`
-                Commitmenty \`USE*\` zapínají schopnosti (vyhledávání, prohlížeč, napojení na projekt, e-mail, generování obrázků a další).
+                Commitmenty \`USE*\` zapínají schopnosti (napojení na projekt, kalendář, generování obrázků a další).
                 Zpřístupňují běhové nástroje a doplňují pokyny do systémové zprávy.
             `),
         },
@@ -209,16 +214,6 @@ export const czechBookLanguageManualDictionary: BookLanguageManualDictionary = {
                 '`CLOSED` brání tomu, aby se agent upravoval během konverzace.',
             ],
         },
-        'tool-using-browser-search-agent': {
-            title: 'Agent s nástroji (prohlížeč a vyhledávač)',
-            goal: 'Umožnit rešerši na internetu s jasnou prací se zdroji.',
-            walkthrough: [
-                '`USE SEARCH ENGINE` zpřístupní vyhledávání na webu a volitelné pokyny k němu.',
-                '`USE BROWSER` zapne stahování adres a interaktivní procházení webu.',
-                'Commitmenty `RULE` dělají požadavky na spolehlivost výslovnými a opakovatelnými.',
-                'Tento vzor se hodí pro agenty na aktuální dění a ověřování faktů.',
-            ],
-        },
         'rule-and-knowledge-agent': {
             title: 'Agent s RULE a KNOWLEDGE',
             goal: 'Opřít odpovědi o výslovná omezení a připravené zdroje.',
@@ -229,16 +224,6 @@ export const czechBookLanguageManualDictionary: BookLanguageManualDictionary = {
                 'Tento vzor použijte pro compliance, podporu a interní postupy.',
             ],
         },
-        'memory-agent-with-long-term-memory': {
-            title: 'Agent s dlouhodobou pamětí (MEMORY)',
-            goal: 'Uchovat preference uživatele napříč konverzacemi.',
-            walkthrough: [
-                '`MEMORY` přidá běhové nástroje paměti a příslušné pokyny do systémové zprávy.',
-                'Commitmenty `RULE` zúží, co se smí pamatovat, a snižují tak rizika pro soukromí.',
-                'V Agents Serveru je paměť vedená za běhu a je vázaná na konkrétního uživatele.',
-                'Hodí se pro asistenty, kteří si musí držet kontext v čase.',
-            ],
-        },
         'use-project-integration-agent': {
             title: 'Napojení na projekt (USE PROJECT)',
             goal: 'Pracovat s repozitářem na GitHubu přes připojení projektu.',
@@ -283,7 +268,7 @@ export const czechBookLanguageManualDictionary: BookLanguageManualDictionary = {
         {
             title: 'Neověřitelná tvrzení',
             dont: 'Agent odpovídá na otázky závislé na internetu bez nástrojů nebo bez uvedení zdrojů.',
-            doInstead: 'Přidejte `USE SEARCH ENGINE` / `USE BROWSER` a `RULE` zaměřené na citování.',
+            doInstead: 'Přidejte zdroje `KNOWLEDGE` a `RULE` zaměřené na citování.',
         },
         {
             title: 'Chybějící mantinely',
@@ -295,11 +280,6 @@ export const czechBookLanguageManualDictionary: BookLanguageManualDictionary = {
             dont: 'Dlouhé řetězce `FROM` bez vysvětlení, proč je každý rodič potřeba.',
             doInstead: 'Držte dědičnost mělkou a pro znovupoužití sáhněte po cíleném IMPORT nebo TEAM.',
         },
-        {
-            title: 'Nebezpečné zacházení s pamětí',
-            dont: 'Ukládání každého detailu do paměti bez jakýchkoli hranic.',
-            doInstead: 'Doplňte `MEMORY` výslovnými pravidly, co se smí uchovávat.',
-        },
     ],
     tutorialSections: {
         serverAgentsHint:

package/src/book-2.0/book-language-documentation/englishBookLanguageManualDictionary.ts

@@ -47,7 +47,7 @@ export const englishBookLanguageManualDictionary: BookLanguageManualDictionary =
                 2. **Behavior layer**:
                 \`RULE\`, \`KNOWLEDGE\`, \`WRITING SAMPLE\`, \`WRITING RULES\`, \`LANGUAGE\`, \`GOAL\`, and related commitments.
                 3. **Capability layer**:
-                \`USE*\`, \`MEMORY\`, and other tooling commitments exposing runtime abilities.
+                \`USE*\` and other tooling commitments exposing runtime abilities.
                 4. **Composition layer**:
                 \`FROM\` inheritance, \`IMPORT\` reuse, and \`TEAM\` delegation.
             `),
@@ -69,8 +69,8 @@ export const englishBookLanguageManualDictionary: BookLanguageManualDictionary =
                 4. **Composition over monoliths**:
                 Use \`TEAM\`/\`IMPORT\` for specialized responsibilities.
                 Tradeoff: orchestration overhead, stronger modularity and reuse.
-                5. **Controlled memory**:
-                If using \`MEMORY\`, define what must and must not be remembered.
+                5. **Controlled data access**:
+                If using \`USE PRIVACY\`, define what must and must not leave the conversation.
                 Tradeoff: stricter policy design, better privacy and signal quality.
             `),
         },
@@ -102,7 +102,7 @@ export const englishBookLanguageManualDictionary: BookLanguageManualDictionary =
                 3. **Add grounding**
                 Add \`KNOWLEDGE\` commitments (inline text or local/importable sources).
                 4. **Add capabilities**
-                Add only necessary \`USE*\` and/or \`MEMORY\` commitments.
+                Add only necessary \`USE*\` commitments.
                 5. **Set profile metadata**
                 Add \`META DESCRIPTION\`, \`META AVATAR\` / \`META VISUAL\` or \`META IMAGE\`, \`META INPUT PLACEHOLDER\`, \`META THINKING MESSAGE\`, and disclaimers if needed.
                 6. **Add first interaction**
@@ -140,7 +140,12 @@ export const englishBookLanguageManualDictionary: BookLanguageManualDictionary =
                 \`FROM\` points to a parent agent source. During inheritance resolution:
 
                 - Parent corpus is merged into effective source.
-                - \`FROM {Void}\` / \`FROM VOID\` means explicit "no parent".
+                - Writing no \`FROM\` at all is the same as writing \`FROM @Adam\`, the core agent every agent inherits from.
+                - \`FROM @Null\` / \`FROM {Void}\` / \`FROM VOID\` means explicit "no parent".
+                - An explicit parent replaces the implicit Adam parent; the selected parent's own \`FROM\` chain is then inherited normally.
+                - \`@Name\` is shorthand for \`{Name}\` when the agent name is one word.
+                - When \`FROM\` is written more than once, the last one wins and overrides every earlier one.
+                - Adam is the root agent and must explicitly use \`FROM @Null\` (\`@Void\` is equivalent). The Book editor warns about a different Adam parent and local inheritance cycles.
                 - Missing references are surfaced as notes in resolved source.
             `),
         },
@@ -155,7 +160,7 @@ export const englishBookLanguageManualDictionary: BookLanguageManualDictionary =
         capabilities: {
             title: 'USE commitments',
             body: spaceTrim(`
-                \`USE*\` commitments enable capabilities (search, browser, project integration, email, image generation, etc.).
+                \`USE*\` commitments enable capabilities (project integration, calendar, image generation, etc.).
                 They expose runtime tools and system-message guidance used during execution.
             `),
         },
@@ -209,16 +214,6 @@ export const englishBookLanguageManualDictionary: BookLanguageManualDictionary =
                 '`CLOSED` prevents conversational self-modification.',
             ],
         },
-        'tool-using-browser-search-agent': {
-            title: 'Tool-using agent (Browser + Search engine)',
-            goal: 'Enable internet research with clear sourcing behavior.',
-            walkthrough: [
-                '`USE SEARCH ENGINE` provides web search tooling and optional search instructions.',
-                '`USE BROWSER` enables URL fetching and interactive browsing tools.',
-                '`RULE` commitments make reliability behavior explicit and repeatable.',
-                'This pattern is ideal for current-events and fact-checking agents.',
-            ],
-        },
         'rule-and-knowledge-agent': {
             title: 'Agent with RULE and KNOWLEDGE',
             goal: 'Ground responses in explicit constraints and curated sources.',
@@ -229,16 +224,6 @@ export const englishBookLanguageManualDictionary: BookLanguageManualDictionary =
                 'Use this pattern for compliance, support, and internal procedures.',
             ],
         },
-        'memory-agent-with-long-term-memory': {
-            title: 'MEMORY agent with long-term memory',
-            goal: 'Persist user preferences across conversations.',
-            walkthrough: [
-                '`MEMORY` adds runtime memory tools and memory-specific system guidance.',
-                '`RULE` commitments narrow what should be remembered to reduce privacy risks.',
-                'In Agents Server, memory is runtime-backed and user-scoped.',
-                'Use this for assistants that must preserve context over time.',
-            ],
-        },
         'use-project-integration-agent': {
             title: 'USE PROJECT external integration',
             goal: 'Work with a GitHub repository through a connected project integration.',
@@ -283,7 +268,7 @@ export const englishBookLanguageManualDictionary: BookLanguageManualDictionary =
         {
             title: 'Unverifiable claims',
             dont: 'The agent answers internet-dependent questions without tools or without citing sources.',
-            doInstead: 'Add `USE SEARCH ENGINE` / `USE BROWSER` and a citation-oriented `RULE`.',
+            doInstead: 'Add `KNOWLEDGE` sources and a citation-oriented `RULE`.',
         },
         {
             title: 'Missing guardrails',
@@ -295,11 +280,6 @@ export const englishBookLanguageManualDictionary: BookLanguageManualDictionary =
             dont: 'Using deep `FROM` chains without documenting why each parent is needed.',
             doInstead: 'Keep inheritance shallow and use focused IMPORT/TEAM composition for reuse.',
         },
-        {
-            title: 'Unsafe memory usage',
-            dont: 'Storing every detail in memory without boundaries.',
-            doInstead: 'Pair `MEMORY` with explicit rules about what is allowed to persist.',
-        },
     ],
     tutorialSections: {
         serverAgentsHint:

package/src/book-2.0/book-language-documentation/renderCommitmentCatalogSection.ts

@@ -53,10 +53,7 @@ export function renderCommitmentCatalogSection(options: RenderCommitmentCatalogS
             ${aliasesMarkdown}
 
             ${block(
-                renderGroupedCommitmentDocumentationMarkdown(
-                    groupedCommitment,
-                    COMMITMENT_CATALOG_HEADING_LEVEL_SHIFT,
-                ),
+                renderGroupedCommitmentDocumentationMarkdown(groupedCommitment, COMMITMENT_CATALOG_HEADING_LEVEL_SHIFT),
             )}
         `,
     );

package/src/book-2.0/book-language-documentation/renderGroupedCommitmentDocumentationMarkdown.ts

@@ -196,10 +196,7 @@ export function renderGroupedCommitmentDocumentationMarkdown(
  *
  * @private internal utility of `createStandaloneBookLanguageMarkdown`
  */
-function renderFocusedCommitmentExamples(
-    documentation: string,
-    group: GroupedCommitmentDocumentationSource,
-): string {
+function renderFocusedCommitmentExamples(documentation: string, group: GroupedCommitmentDocumentationSource): string {
     return documentation.replace(BOOK_CODE_BLOCK_PATTERN, (codeBlock, _fence, source: string) => {
         const focusedSource = createFocusedCommitmentExampleSource(source, group);
         return focusedSource ? getSafeCodeBlock(focusedSource, 'book') : codeBlock;
@@ -223,12 +220,7 @@ function createFocusedCommitmentExampleSource(
     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 allowedCommitmentTypes = new Set([group.primary.type, ...group.aliases, 'GOAL', CLOSED_COMMITMENT_TYPE]);
     const canonicalTypeByCommitmentType = createCanonicalCommitmentTypeByCommitmentType(
         group,
         isOpenClosedCommitmentFamily,
@@ -384,9 +376,7 @@ function finalizeFocusedCommitmentExampleSource(
         normalizedFocusedCommitments.push(CLOSED_COMMITMENT_TYPE);
     }
 
-    return [agentName, ...normalizedFocusedCommitments]
-        .filter((line): line is string => Boolean(line))
-        .join('\n\n');
+    return [agentName, ...normalizedFocusedCommitments].filter((line): line is string => Boolean(line)).join('\n\n');
 }
 
 /**
@@ -427,10 +417,7 @@ function createCanonicalCommitmentTypeByCommitmentType(
     canonicalTypeByCommitmentType.set(group.primary.type, group.primary.type);
 
     for (const alias of group.aliases) {
-        canonicalTypeByCommitmentType.set(
-            alias,
-            isOpenClosedCommitmentFamily ? alias : group.primary.type,
-        );
+        canonicalTypeByCommitmentType.set(alias, isOpenClosedCommitmentFamily ? alias : group.primary.type);
     }
 
     return canonicalTypeByCommitmentType;