@promptbook/core 0.112.0-110 → 0.112.0-111

package/esm/src/collection/agent-collection/constructors/agent-collection-in-supabase/AgentCollectionInSupabase.d.ts

@@ -60,6 +60,28 @@ export declare class AgentCollectionInSupabase {
      * Gets all agents in the collection
      */
     listAgents(): Promise<ReadonlyArray<AgentBasicInformation>>;
+    /**
+     * 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`
+     */
+    findAgentBasicInformation(agentNameOrPermanentId: string_agent_name | string_agent_permanent_id): Promise<AgentBasicInformation | 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`
+     */
+    private mapAgentBasicInformationRow;
     /**
      * Retrieves the permanent ID of an agent by its name or permanent ID.
      */

package/esm/src/version.d.ts

@@ -15,7 +15,7 @@ export declare const BOOK_LANGUAGE_VERSION: string_semantic_version;
 export declare const PROMPTBOOK_ENGINE_VERSION: string_promptbook_version;
 /**
  * Represents the version string of the Promptbook engine.
- * It follows semantic versioning (e.g., `0.112.0-109`).
+ * It follows semantic versioning (e.g., `0.112.0-110`).
  *
  * @generated
  */

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@promptbook/core",
-    "version": "0.112.0-110",
+    "version": "0.112.0-111",
     "description": "Promptbook: Create persistent AI agents that turn your company's scattered knowledge into action",
     "private": false,
     "sideEffects": false,

package/umd/index.umd.js

@@ -27,7 +27,7 @@
      * @generated
      * @see https://github.com/webgptorg/promptbook
      */
-    const PROMPTBOOK_ENGINE_VERSION = '0.112.0-110';
+    const PROMPTBOOK_ENGINE_VERSION = '0.112.0-111';
     /**
      * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
      * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -29359,6 +29359,18 @@
         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.
      *
@@ -29406,21 +29418,63 @@
             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 = exports.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.
@@ -29429,7 +29483,7 @@
             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) {
@@ -29444,7 +29498,7 @@
             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);