@promptbook/core 0.114.0-13 → 0.114.0-18

package/umd/index.umd.js

@@ -28,7 +28,7 @@
      * @generated
      * @see https://github.com/webgptorg/promptbook
      */
-    const PROMPTBOOK_ENGINE_VERSION = '0.114.0-13';
+    const PROMPTBOOK_ENGINE_VERSION = '0.114.0-18';
     /**
      * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
      * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -9898,6 +9898,12 @@
 
             Inherits agent source from another agent.
 
+            Every agent inherits from the core agent \`@Adam\` unless it says otherwise, so writing no ${this.type} at all
+            is the same as writing \`${this.type} @Adam\`. Write \`${this.type} @Null\` to inherit from nothing.
+
+            An agent has exactly one parent, so when ${this.type} is written more than once, the last one wins and
+            overrides every earlier one.
+
             ## Examples
 
             \`\`\`book
@@ -9906,6 +9912,13 @@
             FROM https://s6.ptbk.io/benjamin-white
             RULE Speak only in English.
             \`\`\`
+
+            \`\`\`book
+            My Standalone Agent
+
+            FROM @Null
+            RULE Speak only in English.
+            \`\`\`
         `);
         }
         applyToAgentModelRequirements(requirements, content) {
@@ -26084,7 +26097,7 @@
     const DEFAULT_BOOK = padBook(validateBook(spacetrim.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.
         `)));
     // <- Note: Not using book`...` notation to avoid strange error in jest unit tests `TypeError: (0 , book_notation_1.book) is not a function`
     // <- TODO: [🐱‍🚀] `GENESIS_BOOK` / `ADAM_BOOK` in `/agents/adam.book`
@@ -26575,7 +26588,12 @@
                 \`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.
             `),
             },
@@ -26873,7 +26891,12 @@
                 \`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.
             `),
             },
@@ -28466,16 +28489,49 @@
         }
         /**
          * Retrieves the permanent ID of an agent by its name or permanent ID.
+         *
+         * An agent that still exists always wins over a soft-deleted one, so a name that was deleted and
+         * later created again resolves to the agent that is live now instead of to the recycle-bin leftover.
+         * Soft-deleted agents stay resolvable as a fallback because the recycle bin restores them by name
+         * or permanent id.
          */
         async getAgentPermanentId(agentNameOrPermanentId) {
-            const selectResult = await this.supabaseClient
+            const activeAgentPermanentId = await this.findAgentPermanentId(agentNameOrPermanentId, {
+                isDeletedAgentIncluded: false,
+            });
+            if (activeAgentPermanentId !== null) {
+                return activeAgentPermanentId;
+            }
+            const deletedAgentPermanentId = await this.findAgentPermanentId(agentNameOrPermanentId, {
+                isDeletedAgentIncluded: true,
+            });
+            if (deletedAgentPermanentId !== null) {
+                return deletedAgentPermanentId;
+            }
+            throw new NotFoundError(`Agent with name or id "${agentNameOrPermanentId}" not found`);
+        }
+        /**
+         * Looks up the permanent id of the oldest agent matching one name or permanent id.
+         *
+         * @param agentNameOrPermanentId - Agent name or stable permanent identifier to match.
+         * @param options - Whether soft-deleted agents may be matched as well.
+         * @returns Permanent id of the matched agent, or `null` when nothing matches.
+         *
+         * @private internal helper of `AgentCollectionInSupabase`
+         */
+        async findAgentPermanentId(agentNameOrPermanentId, options) {
+            const selectQuery = this.supabaseClient
                 .from(this.getTableName('Agent'))
                 .select('permanentId')
-                .or(buildAgentNameOrPermanentIdFilter(agentNameOrPermanentId))
+                .or(buildAgentNameOrPermanentIdFilter(agentNameOrPermanentId));
+            if (!options.isDeletedAgentIncluded) {
+                selectQuery.is('deletedAt', null);
+            }
+            const selectResult = await selectQuery
                 .order('createdAt', { ascending: true }) // Pick oldest if multiple match by name
                 .limit(1);
             if (selectResult.error || !selectResult.data || selectResult.data.length === 0) {
-                throw new NotFoundError(`Agent with name or id "${agentNameOrPermanentId}" not found`);
+                return null;
             }
             return selectResult.data[0].permanentId;
         }
@@ -48888,7 +48944,7 @@
                 ${agentName}
     
                 
-                PERSONA ${block(personaDescription)}
+                GOAL ${block(personaDescription)}
                 ${block(initialRules.map((rule) => `RULE ${rule}`).join('\n'))}
                 CLOSED
             `));