@promptbook/core 0.103.0-45 → 0.103.0-46

package/esm/typings/src/book-2.0/agent-source/padBook.d.ts

@@ -8,6 +8,8 @@ export declare const PADDING_LINES = 11;
 /**
  * A function that adds padding to the book content
  *
+ * Note: [🔂] This function is idempotent.
+ *
  * @public exported from `@promptbook/core`
  */
 export declare function padBook(content: string_book): string_book;

package/esm/typings/src/book-2.0/agent-source/string_book.d.ts

@@ -15,6 +15,8 @@ export declare function isValidBook(value: string): value is string_book;
  * This function should be used when you have a string that you know represents agent source
  * but need to convert it to the branded type for type safety
  *
+ * Note: [🔂] This function is idempotent.
+ *
  * @public exported from `@promptbook/core`
  */
 export declare function validateBook(source: string): string_book;

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

@@ -95,6 +95,10 @@ export declare class AgentCollectionInSupabase {
      * Note: You can set 'PARENT' in the agent source to inherit from another agent in the collection.
      */
     createAgent(agentSource: string_book): Promise<AgentBasicInformation>;
+    /**
+     * Updates an existing agent in the collection
+     */
+    updateAgentSource(agentName: string_agent_name, agentSource: string_book): Promise<void>;
     /**
      * Deletes an agent from the collection
      */

package/esm/typings/src/conversion/validation/validatePipeline.d.ts

@@ -9,6 +9,8 @@ import type { PipelineJson } from '../../pipeline/PipelineJson/PipelineJson';
  * -   if it is valid json
  * -   if it is meaningful
  *
+ * Note: [🔂] This function is idempotent.
+ *
  * @param pipeline valid or invalid PipelineJson
  * @returns the same pipeline if it is logically valid
  * @throws {PipelineLogicError} on logical error in the pipeline

package/esm/typings/src/execution/utils/validatePromptResult.d.ts

@@ -46,6 +46,8 @@ export type ValidatePromptResultResult = {
  * This function provides a common abstraction for result validation that can be used
  * by both execution logic and caching logic to ensure consistency.
  *
+ * Note: [🔂] This function is idempotent.
+ *
  * @param options - The validation options including result string, expectations, and format
  * @returns Validation result with processed string and validity status
  * @private internal function of `createPipelineExecutor` and `cacheLlmTools`

package/esm/typings/src/pipeline/validatePipelineString.d.ts

@@ -3,6 +3,8 @@ import type { PipelineString } from './PipelineString';
  * Function `validatePipelineString` will validate the if the string is a valid pipeline string
  * It does not check if the string is fully logically correct, but if it is a string that can be a pipeline string or the string looks completely different.
  *
+ * Note: [🔂] This function is idempotent.
+ *
  * @param {string} pipelineString the candidate for a pipeline string
  * @returns {PipelineString} the same string as input, but validated as valid
  * @throws {ParseError} if the string is not a valid pipeline string

package/esm/typings/src/utils/validators/parameterName/validateParameterName.d.ts

@@ -3,6 +3,8 @@ import type { string_parameter_name } from '../../../types/typeAliases';
  * Function `validateParameterName` will normalize and validate a parameter name for use in pipelines.
  * It removes diacritics, emojis, and quotes, normalizes to camelCase, and checks for reserved names and invalid characters.
  *
+ * Note: [🔂] This function is idempotent.
+ *
  * @param parameterName The parameter name to validate and normalize.
  * @returns The validated and normalized parameter name.
  * @throws {ParseError} If the parameter name is empty, reserved, or contains invalid characters.

package/esm/typings/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.103.0-44`).
+ * It follows semantic versioning (e.g., `0.103.0-45`).
  *
  * @generated
  */

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@promptbook/core",
-    "version": "0.103.0-45",
+    "version": "0.103.0-46",
     "description": "Promptbook: Turn your company's scattered knowledge into AI ready books",
     "private": false,
     "sideEffects": false,

package/umd/index.umd.js

@@ -28,7 +28,7 @@
      * @generated
      * @see https://github.com/webgptorg/promptbook
      */
-    const PROMPTBOOK_ENGINE_VERSION = '0.103.0-45';
+    const PROMPTBOOK_ENGINE_VERSION = '0.103.0-46';
     /**
      * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
      * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -1543,6 +1543,8 @@
      * Function `validatePipelineString` will validate the if the string is a valid pipeline string
      * It does not check if the string is fully logically correct, but if it is a string that can be a pipeline string or the string looks completely different.
      *
+     * Note: [🔂] This function is idempotent.
+     *
      * @param {string} pipelineString the candidate for a pipeline string
      * @returns {PipelineString} the same string as input, but validated as valid
      * @throws {ParseError} if the string is not a valid pipeline string
@@ -2174,6 +2176,8 @@
      * -   if it is valid json
      * -   if it is meaningful
      *
+     * Note: [🔂] This function is idempotent.
+     *
      * @param pipeline valid or invalid PipelineJson
      * @returns the same pipeline if it is logically valid
      * @throws {PipelineLogicError} on logical error in the pipeline
@@ -6031,6 +6035,8 @@
      * This function provides a common abstraction for result validation that can be used
      * by both execution logic and caching logic to ensure consistency.
      *
+     * Note: [🔂] This function is idempotent.
+     *
      * @param options - The validation options including result string, expectations, and format
      * @returns Validation result with processed string and validity status
      * @private internal function of `createPipelineExecutor` and `cacheLlmTools`
@@ -9823,6 +9829,8 @@
     /**
      * A function that adds padding to the book content
      *
+     * Note: [🔂] This function is idempotent.
+     *
      * @public exported from `@promptbook/core`
      */
     function padBook(content) {
@@ -9868,6 +9876,8 @@
      * This function should be used when you have a string that you know represents agent source
      * but need to convert it to the branded type for type safety
      *
+     * Note: [🔂] This function is idempotent.
+     *
      * @public exported from `@promptbook/core`
      */
     function validateBook(source) {
@@ -10074,6 +10084,37 @@
             }
             return agentProfile;
         }
+        /**
+         * Updates an existing agent in the collection
+         */
+        async updateAgentSource(agentName, agentSource) {
+            const agentProfile = parseAgentSource(agentSource);
+            // TODO: !!!!!! What about agentName change
+            console.log('!!! agentName', agentName);
+            const oldAgentSource = await this.getAgentSource(agentName);
+            const result = await this.supabaseClient
+                .from('AgentCollection' /* <- TODO: !!!! Change to `Agent` */)
+                .update({
+                // TODO: !!!! Compare not update> agentName: agentProfile.agentName || '!!!!!' /* <- TODO: !!!! Remove */,
+                agentProfile,
+                updatedAt: new Date().toISOString(),
+                agentVersion: 0,
+                agentSource: agentSource,
+            })
+                .eq('agentName', agentName);
+            const newAgentSource = await this.getAgentSource(agentName);
+            console.log('!!! updateAgent', result);
+            console.log('!!! old', oldAgentSource);
+            console.log('!!! new', newAgentSource);
+            if (result.error) {
+                throw new DatabaseError(spaceTrim((block) => `
+                        Error updating agent "${agentName}" in Supabase:
+                        
+                        ${block(result.error.message)}
+                    `));
+            }
+        }
+        // TODO: !!!! getAgentSourceSubject
         /**
          * Deletes an agent from the collection
          */
@@ -10965,6 +11006,8 @@
      * Function `validateParameterName` will normalize and validate a parameter name for use in pipelines.
      * It removes diacritics, emojis, and quotes, normalizes to camelCase, and checks for reserved names and invalid characters.
      *
+     * Note: [🔂] This function is idempotent.
+     *
      * @param parameterName The parameter name to validate and normalize.
      * @returns The validated and normalized parameter name.
      * @throws {ParseError} If the parameter name is empty, reserved, or contains invalid characters.