@promptbook/core 0.112.0-110 → 0.112.0-112

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.112.0-110';
+const PROMPTBOOK_ENGINE_VERSION = '0.112.0-112';
 /**
  * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
  * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -29360,6 +29360,18 @@ function normalizeHistoryVersionName(versionName) {
     const normalizedVersionName = versionName.trim();
     return normalizedVersionName.length > 0 ? normalizedVersionName : null;
 }
+/**
+ * Builds a Supabase `.or()` filter for agent name or permanent id lookups.
+ *
+ * @param agentNameOrPermanentId - Agent name or stable permanent identifier to match.
+ * @returns `.or()` filter string safe to pass to Supabase.
+ *
+ * @private internal helper of `AgentCollectionInSupabase`
+ */
+function buildAgentNameOrPermanentIdFilter(agentNameOrPermanentId) {
+    const encodedAgentIdentifier = encodeURIComponent(agentNameOrPermanentId);
+    return `agentName.eq.${encodedAgentIdentifier},permanentId.eq.${encodedAgentIdentifier}`;
+}
 /**
  * Agent collection stored in a Supabase table.
  *
@@ -29407,21 +29419,63 @@ class AgentCollectionInSupabase /* TODO: [🌈][🐱‍🚀] implements AgentCol
         if (isVerbose) {
             console.info(`Found ${selectResult.data.length} agents in directory`);
         }
-        return selectResult.data.map(({ agentName, agentProfile, permanentId }) => {
-            if (isVerbose && agentProfile.agentName !== agentName) {
-                console.warn(spaceTrim(`
+        return selectResult.data.map((row) => this.mapAgentBasicInformationRow(row, isVerbose));
+    }
+    /**
+     * Finds one active agent profile by its human-readable name or permanent id.
+     *
+     * This keeps route-level lookups from loading the whole agent collection when only
+     * one canonical route identifier is needed.
+     *
+     * @param agentNameOrPermanentId - Agent name or stable permanent identifier.
+     * @returns Matching active agent profile or `null` when not found.
+     *
+     * @public exported from `@promptbook/core`
+     */
+    async findAgentBasicInformation(agentNameOrPermanentId) {
+        var _a;
+        const { isVerbose = DEFAULT_IS_VERBOSE } = this.options || {};
+        const selectResult = await this.supabaseClient
+            .from(this.getTableName('Agent'))
+            .select('agentName,agentProfile,permanentId')
+            .or(buildAgentNameOrPermanentIdFilter(agentNameOrPermanentId))
+            .is('deletedAt', null)
+            .order('createdAt', { ascending: true })
+            .limit(1);
+        if (selectResult.error) {
+            throw new DatabaseError(spaceTrim((block) => `
+
+                        Error fetching agent "${agentNameOrPermanentId}" from Supabase:
+
+                        ${block(selectResult.error.message)}
+                    `));
+        }
+        const row = (_a = selectResult.data) === null || _a === void 0 ? void 0 : _a[0];
+        return row ? this.mapAgentBasicInformationRow(row, isVerbose) : null;
+    }
+    /**
+     * Converts one database row into public agent information.
+     *
+     * @param row - Database row carrying the persisted profile snapshot.
+     * @param isVerbose - Whether profile-name mismatches should be logged.
+     * @returns Agent profile with canonical database name and permanent id.
+     *
+     * @private internal helper of `AgentCollectionInSupabase`
+     */
+    mapAgentBasicInformationRow({ agentName, agentProfile, permanentId }, isVerbose) {
+        if (isVerbose && agentProfile.agentName !== agentName) {
+            console.warn(spaceTrim(`
                         Agent name mismatch for agent "${agentName}". Using name from database.
 
                         agentName: "${agentName}"
                         agentProfile.agentName: "${agentProfile.agentName}"
                     `));
-            }
-            return {
-                ...agentProfile,
-                agentName,
-                permanentId: permanentId || agentProfile.permanentId,
-            };
-        });
+        }
+        return {
+            ...agentProfile,
+            agentName,
+            permanentId: permanentId || agentProfile.permanentId,
+        };
     }
     /**
      * Retrieves the permanent ID of an agent by its name or permanent ID.
@@ -29430,7 +29484,7 @@ class AgentCollectionInSupabase /* TODO: [🌈][🐱‍🚀] implements AgentCol
         const selectResult = await this.supabaseClient
             .from(this.getTableName('Agent'))
             .select('permanentId')
-            .or(`agentName.eq.${agentNameOrPermanentId},permanentId.eq.${agentNameOrPermanentId}`)
+            .or(buildAgentNameOrPermanentIdFilter(agentNameOrPermanentId))
             .order('createdAt', { ascending: true }) // Pick oldest if multiple match by name
             .limit(1);
         if (selectResult.error || !selectResult.data || selectResult.data.length === 0) {
@@ -29445,7 +29499,7 @@ class AgentCollectionInSupabase /* TODO: [🌈][🐱‍🚀] implements AgentCol
         const selectResult = await this.supabaseClient
             .from(this.getTableName('Agent'))
             .select('agentSource')
-            .or(`agentName.eq.${agentNameOrPermanentId},permanentId.eq.${agentNameOrPermanentId}`)
+            .or(buildAgentNameOrPermanentIdFilter(agentNameOrPermanentId))
             .is('deletedAt', null)
             .order('createdAt', { ascending: true }) // Pick oldest if multiple match by name
             .limit(1);