@promptbook/core 0.112.0-41 → 0.112.0-42

package/esm/src/cli/cli-commands/coder/verify.test.d.ts

@@ -0,0 +1 @@
+export {};

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

@@ -4,23 +4,11 @@ import type { string_book } from '../../../../book-2.0/agent-source/string_book'
 import type { string_agent_name, string_agent_permanent_id } from '../../../../types/typeAliases';
 import { AgentCollectionInSupabaseOptions } from './AgentCollectionInSupabaseOptions';
 import type { AgentsDatabaseSchema } from './AgentsDatabaseSchema';
+import { type CreateAgentPersistenceRecordsOptions } from './createAgentPersistenceRecords';
 /**
  * Options for creating a new agent entry.
  */
-type CreateAgentOptions = {
-    /**
-     * Visibility for the new agent.
-     */
-    readonly visibility?: 'PRIVATE' | 'UNLISTED' | 'PUBLIC';
-    /**
-     * Folder identifier to assign the new agent to.
-     */
-    readonly folderId?: number | null;
-    /**
-     * Sort order for the agent within its parent folder.
-     */
-    readonly sortOrder?: number;
-};
+type CreateAgentOptions = CreateAgentPersistenceRecordsOptions;
 /**
  * Optional controls for persisting one source update.
  */

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

@@ -0,0 +1,40 @@
+import type { AgentBasicInformation } from '../../../../book-2.0/agent-source/AgentBasicInformation';
+import type { string_book } from '../../../../book-2.0/agent-source/string_book';
+import type { CreateAgentInput } from '../../CreateAgentInput';
+import type { AgentsDatabaseSchema } from './AgentsDatabaseSchema';
+/**
+ * Optional persistence overrides for one new agent row.
+ *
+ * @private shared persistence helper for `AgentCollectionInSupabase`
+ */
+export type CreateAgentPersistenceRecordsOptions = Omit<CreateAgentInput, 'source'>;
+/**
+ * Prepared insert rows and returned profile for one newly persisted agent.
+ *
+ * @private shared persistence helper for `AgentCollectionInSupabase`
+ */
+export type CreateAgentPersistenceRecordsResult = {
+    /**
+     * Parsed created agent profile including the resolved permanent id.
+     */
+    readonly createdAgent: AgentBasicInformation & Required<Pick<AgentBasicInformation, 'permanentId'>>;
+    /**
+     * Insert row for the `Agent` table.
+     */
+    readonly agentInsertRecord: AgentsDatabaseSchema['public']['Tables']['Agent']['Insert'];
+    /**
+     * Insert row for the `AgentHistory` table.
+     */
+    readonly agentHistoryInsertRecord: AgentsDatabaseSchema['public']['Tables']['AgentHistory']['Insert'];
+};
+/**
+ * Builds normalized insert rows for a newly created persisted agent.
+ *
+ * @param agentSource - Source content of the agent.
+ * @param options - Optional folder placement, ordering, and visibility overrides.
+ * @param createdAt - Shared creation timestamp used across all persisted rows.
+ * @returns Insert rows and the created agent profile.
+ *
+ * @private shared persistence helper for `AgentCollectionInSupabase`
+ */
+export declare function createAgentPersistenceRecords(agentSource: string_book, options?: CreateAgentPersistenceRecordsOptions, createdAt?: string): CreateAgentPersistenceRecordsResult;

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

@@ -0,0 +1 @@
+export {};

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-40`).
+ * It follows semantic versioning (e.g., `0.112.0-41`).
  *
  * @generated
  */

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@promptbook/core",
-    "version": "0.112.0-41",
+    "version": "0.112.0-42",
     "description": "Promptbook: Turn your company's scattered knowledge into AI ready books",
     "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-41';
+    const PROMPTBOOK_ENGINE_VERSION = '0.112.0-42';
     /**
      * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
      * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -23456,6 +23456,60 @@
         return strippedLines.join('\n');
     }
 
+    /**
+     * Builds normalized insert rows for a newly created persisted agent.
+     *
+     * @param agentSource - Source content of the agent.
+     * @param options - Optional folder placement, ordering, and visibility overrides.
+     * @param createdAt - Shared creation timestamp used across all persisted rows.
+     * @returns Insert rows and the created agent profile.
+     *
+     * @private shared persistence helper for `AgentCollectionInSupabase`
+     */
+    function createAgentPersistenceRecords(agentSource, options = {}, createdAt = new Date().toISOString()) {
+        const preparedAgentSource = prepareAgentSourceForPersistence(agentSource);
+        const { agentProfile, agentSource: normalizedAgentSource } = preparedAgentSource;
+        const permanentId = preparedAgentSource.permanentId || $randomBase58(14);
+        const { agentName, agentHash } = agentProfile;
+        const agentInsertRecord = {
+            agentName,
+            agentHash,
+            permanentId,
+            agentProfile,
+            createdAt,
+            updatedAt: null,
+            promptbookEngineVersion: PROMPTBOOK_ENGINE_VERSION,
+            usage: ZERO_USAGE,
+            agentSource: normalizedAgentSource,
+        };
+        if (options.folderId !== undefined) {
+            agentInsertRecord.folderId = options.folderId;
+        }
+        if (options.sortOrder !== undefined) {
+            agentInsertRecord.sortOrder = options.sortOrder;
+        }
+        if (options.visibility !== undefined) {
+            agentInsertRecord.visibility = options.visibility;
+        }
+        return {
+            createdAgent: {
+                ...agentProfile,
+                permanentId,
+            },
+            agentInsertRecord,
+            agentHistoryInsertRecord: {
+                createdAt,
+                agentName,
+                permanentId,
+                agentHash,
+                previousAgentHash: null,
+                agentSource: normalizedAgentSource,
+                promptbookEngineVersion: PROMPTBOOK_ENGINE_VERSION,
+                versionName: null,
+            },
+        };
+    }
+
     /**
      * Normalizes optional history version name before persistence.
      *
@@ -23579,52 +23633,18 @@
          * @param options - Optional folder placement and ordering data.
          */
         async createAgent(agentSource, options = {}) {
-            const preparedAgentSource = prepareAgentSourceForPersistence(agentSource);
-            const { agentProfile, agentSource: normalizedAgentSource } = preparedAgentSource;
-            let { permanentId } = preparedAgentSource;
-            const { agentName, agentHash } = agentProfile;
-            if (!permanentId) {
-                permanentId = $randomBase58(14);
-            }
-            const insertPayload = {
-                agentName,
-                agentHash,
-                permanentId,
-                agentProfile,
-                createdAt: new Date().toISOString(),
-                updatedAt: null,
-                promptbookEngineVersion: PROMPTBOOK_ENGINE_VERSION,
-                usage: ZERO_USAGE,
-                agentSource: normalizedAgentSource,
-            };
-            if (options.folderId !== undefined) {
-                insertPayload.folderId = options.folderId;
-            }
-            if (options.sortOrder !== undefined) {
-                insertPayload.sortOrder = options.sortOrder;
-            }
-            if (options.visibility !== undefined) {
-                insertPayload.visibility = options.visibility;
-            }
-            const insertAgentResult = await this.supabaseClient.from(this.getTableName('Agent')).insert(insertPayload);
+            const createdAt = new Date().toISOString();
+            const { createdAgent, agentInsertRecord, agentHistoryInsertRecord } = createAgentPersistenceRecords(agentSource, options, createdAt);
+            const insertAgentResult = await this.supabaseClient.from(this.getTableName('Agent')).insert(agentInsertRecord);
             if (insertAgentResult.error) {
                 throw new DatabaseError(spaceTrim((block) => `
-                        Error creating agent "${agentProfile.agentName}" in Supabase:
+                        Error creating agent "${createdAgent.agentName}" in Supabase:
                         
                         ${block(insertAgentResult.error.message)}
                     `));
             }
-            await this.insertAgentHistoryRow({
-                createdAt: new Date().toISOString(),
-                agentName,
-                permanentId,
-                agentHash,
-                previousAgentHash: null,
-                agentSource: normalizedAgentSource,
-                promptbookEngineVersion: PROMPTBOOK_ENGINE_VERSION,
-                versionName: null,
-            });
-            return { ...agentProfile, permanentId };
+            await this.insertAgentHistoryRow(agentHistoryInsertRecord);
+            return createdAgent;
         }
         /**
          * Updates an existing agent in the collection