@promptbook/cli 0.103.0-44 → 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/remote-server/startAgentServer.d.ts

@@ -21,3 +21,6 @@ type AgentsServerOptions = {
  */
 export declare function startAgentServer(options: AgentsServerOptions): Promise<TODO_any>;
 export {};
+/**
+ * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
+ */

package/esm/typings/src/remote-server/startRemoteServer.d.ts

@@ -25,4 +25,5 @@ export declare function startRemoteServer<TCustomOptions = undefined>(options: R
  * TODO: [🃏] Pass here some security token to prevent malitious usage and/or DDoS
  * TODO: [0] Set unavailable models as undefined in `RemoteLlmExecutionTools` NOT throw error here
  * TODO: Allow to constrain anonymous mode for specific models / providers
+ * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
  */

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

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@promptbook/cli",
-    "version": "0.103.0-44",
+    "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

@@ -56,7 +56,7 @@
      * @generated
      * @see https://github.com/webgptorg/promptbook
      */
-    const PROMPTBOOK_ENGINE_VERSION = '0.103.0-44';
+    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
@@ -3956,6 +3956,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`
@@ -5723,6 +5725,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
@@ -6039,6 +6043,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
@@ -10095,6 +10101,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.
@@ -12075,6 +12083,8 @@
     /**
      * A function that adds padding to the book content
      *
+     * Note: [🔂] This function is idempotent.
+     *
      * @public exported from `@promptbook/core`
      */
     function padBook(content) {
@@ -15070,6 +15080,33 @@
      * TODO: [🖇] What about symlinks? Maybe flag --follow-symlinks
      */
 
+    /**
+     * !!!!!
+     * Remote server is a proxy server that uses its execution tools internally and exposes the executor interface externally.
+     *
+     * You can simply use `RemoteExecutionTools` on client-side javascript and connect to your remote server.
+     * This is useful to make all logic on browser side but not expose your API keys or no need to use customer's GPU.
+     *
+     * @see https://github.com/webgptorg/promptbook#remote-server
+     * @public exported from `@promptbook/remote-server`
+     * <- TODO: !!!! Maybe change to `@promptbook/agent-server`
+     */
+    async function startAgentServer(options) {
+        const { port = 4440 } = options;
+        // TODO: !!!! [🌕]
+        console.trace(`!!! Starting agents server on port ${port}...`);
+        console.log(`!!! cwd`, process.cwd());
+        console.log(`!!! __dirname`, __dirname);
+        await $execCommand({
+            cwd: './apps/agents-server',
+            command: `next dev --port ${port} `,
+            isVerbose: true,
+        });
+    }
+    /**
+     * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
+     */
+
     /**
      * Initializes `start-agents-server` command for Promptbook CLI utilities
      *
@@ -15149,11 +15186,7 @@
                 isVerbose: true,
             });
             */
-            await $execCommand({
-                cwd: './apps/agents-server',
-                command: `next dev --port ${port} `,
-                isVerbose: true,
-            });
+            await startAgentServer({ port });
         }));
     }
     /**
@@ -16380,6 +16413,7 @@
      * TODO: [🃏] Pass here some security token to prevent malitious usage and/or DDoS
      * TODO: [0] Set unavailable models as undefined in `RemoteLlmExecutionTools` NOT throw error here
      * TODO: Allow to constrain anonymous mode for specific models / providers
+     * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
      */
 
     /**