@promptbook/cli 0.103.0-47 → 0.103.0-49

package/umd/index.umd.js

@@ -56,7 +56,7 @@
      * @generated
      * @see https://github.com/webgptorg/promptbook
      */
-    const PROMPTBOOK_ENGINE_VERSION = '0.103.0-47';
+    const PROMPTBOOK_ENGINE_VERSION = '0.103.0-49';
     /**
      * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
      * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -95,6 +95,7 @@
         */
     ];
     /**
+     * TODO: [🐱‍🚀] Auto-federated server from url in here
      * Note: [💞] Ignore a discrepancy between file name and entity name
      */
 
@@ -441,6 +442,9 @@
             if (hex.length === 3) {
                 return Color.fromHex3(hex);
             }
+            if (hex.length === 4) {
+                return Color.fromHex4(hex);
+            }
             if (hex.length === 6) {
                 return Color.fromHex6(hex);
             }
@@ -461,6 +465,19 @@
             const b = parseInt(hex.substr(2, 1), 16) * 16;
             return take(new Color(r, g, b));
         }
+        /**
+         * Creates a new Color instance from color in hex format with 4 digits (with alpha channel)
+         *
+         * @param color in hex for example `09df`
+         * @returns Color object
+         */
+        static fromHex4(hex) {
+            const r = parseInt(hex.substr(0, 1), 16) * 16;
+            const g = parseInt(hex.substr(1, 1), 16) * 16;
+            const b = parseInt(hex.substr(2, 1), 16) * 16;
+            const a = parseInt(hex.substr(3, 1), 16) * 16;
+            return take(new Color(r, g, b, a));
+        }
         /**
          * Creates a new Color instance from color in hex format with 6 color digits (without alpha channel)
          *
@@ -651,7 +668,8 @@
          * @returns true if the value is a valid hex color string (e.g., `#009edd`, `#fff`, etc.)
          */
         static isHexColorString(value) {
-            return typeof value === 'string' && /^#(?:[0-9a-fA-F]{3}){1,2}$/.test(value);
+            return (typeof value === 'string' &&
+                /^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{4}|[0-9a-fA-F]{6}|[0-9a-fA-F]{8})$/.test(value));
         }
         /**
          * Creates new Color object
@@ -992,6 +1010,7 @@
     ({
         TITLE: Color.fromHex('#244EA8'),
         LINE: Color.fromHex('#eeeeee'),
+        SEPARATOR: Color.fromHex('#cccccc'),
         COMMITMENT: Color.fromHex('#DA0F78'),
         PARAMETER: Color.fromHex('#8e44ad'),
     });
@@ -2394,7 +2413,7 @@
         TODO: [🧠] Is there a better implementation?
         > const propertyNames = Object.getOwnPropertyNames(objectValue);
         > for (const propertyName of propertyNames) {
-        >     const value = (objectValue as really_any)[propertyName];
+        >     const value = (objectValue as chococake)[propertyName];
         >     if (value && typeof value === 'object') {
         >         deepClone(value);
         >     }
@@ -2947,6 +2966,8 @@
     /**
      * Converts a given text to kebab-case format.
      *
+     * Note: [🔂] This function is idempotent.
+     *
      * @param text The text to be converted.
      * @returns The kebab-case formatted string.
      * @example 'hello-world'
@@ -3016,6 +3037,8 @@
     /**
      * Converts a title string into a normalized name.
      *
+     * Note: [🔂] This function is idempotent.
+     *
      * @param value The title string to be converted to a name.
      * @returns A normalized name derived from the input title.
      * @example 'Hello World!' -> 'hello-world'
@@ -3209,7 +3232,7 @@
         }
     }
     /**
-     * TODO: !!!! Explain that NotFoundError (!!! and other specific errors) has priority over DatabaseError in some contexts
+     * TODO: [🐱‍🚀] Explain that NotFoundError ([🐱‍🚀] and other specific errors) has priority over DatabaseError in some contexts
      */
 
     /**
@@ -10026,6 +10049,8 @@
     /**
      * Normalizes a given text to camelCase format.
      *
+     * Note: [🔂] This function is idempotent.
+     *
      * @param text The text to be normalized.
      * @param _isFirstLetterCapital Whether the first letter should be capitalized.
      * @returns The camelCase formatted string.
@@ -12975,6 +13000,18 @@
      * TODO: [🕌] When more than 2 functionalities, split into separate functions
      */
 
+    /**
+     * Computes SHA-256 hash of the given object
+     *
+     * @public exported from `@promptbook/utils`
+     */
+    function computeHash(value) {
+        return cryptoJs.SHA256(hexEncoder__default["default"].parse(spaceTrim__default["default"](valueToString(value)))).toString( /* hex */);
+    }
+    /**
+     * TODO: [🥬][🥬] Use this ACRY
+     */
+
     /**
      * Makes first letter of a string lowercase
      *
@@ -13034,6 +13071,9 @@
     }
 
     /**
+     * Normalizes a given text to PascalCase format.
+     *
+     * Note: [🔂] This function is idempotent.
      *
      * @param text @public exported from `@promptbook/utils`
      * @returns
@@ -15083,7 +15123,7 @@
      */
 
     /**
-     * !!!!!
+     * [🐱‍🚀]
      * 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.
@@ -15091,11 +15131,11 @@
      *
      * @see https://github.com/webgptorg/promptbook#remote-server
      * @public exported from `@promptbook/remote-server`
-     * <- TODO: !!!! Maybe change to `@promptbook/agent-server`
+     * <- TODO: [🐱‍🚀] Change to `@promptbook/agent-server`
      */
     async function startAgentServer(options) {
         const { port = 4440 } = options;
-        // TODO: !!!! [🌕]
+        // TODO: [🐱‍🚀] [🌕]
         const agentsServerRoot = path.join(__dirname, '../apps/agents-server');
         console.trace(`!!! Starting agents server on port ${port}...`);
         console.log(`!!! cwd`, process.cwd());
@@ -15131,7 +15171,7 @@
         startServerCommand.alias('start');
         startServerCommand.action(handleActionErrors(async (path, cliOptions) => {
             const { port: portRaw, reload: isCacheReloaded, verbose: isVerbose } = cliOptions;
-            // TODO: !!!! [🌕] DRY
+            // TODO: [🐱‍🚀] [🌕] DRY
             const port = parseInt(portRaw, 10);
             if (isNaN(port) || port <= 0 || port > 65535) {
                 console.error(colors__default["default"].red(`Invalid port number: ${portRaw}`));
@@ -15173,11 +15213,11 @@
             TODO_USE(tools);
             TODO_USE(collection);
             */
-            // TODO: !!!! Use
-            // TODO: !!!! Pass collection and tools to the server starter
-            // TODO: !!!! The Next app should be build during the package build step not here
+            // TODO: [🐱‍🚀] Use
+            // TODO: [🐱‍🚀] Pass collection and tools to the server starter
+            // TODO: [🐱‍🚀] The Next app should be build during the package build step not here
             /*
-            // TODO: !!!! Run this conditionally only in production mode in dev mode use `next dev`
+            // TODO: [🐱‍🚀] Run this conditionally only in production mode in dev mode use `next dev`
             await $execCommand({
                 cwd: './apps/agents-server',
                 command: `next build`,
@@ -16403,8 +16443,7 @@
         };
     }
     /**
-     * TODO !!!! Add agent
-     * TODO: !!!! Allow to chat with agents directly via remote server
+
      * TODO: [🕋] Use here `aboutPromptbookInformation`
      * TODO: [🌡] Add CORS and security - probably via `helmet`
      * TODO: Split this file into multiple functions - handler for each request
@@ -17525,17 +17564,17 @@
             },
             /**/
             /*/
-          {
-              modelTitle: 'tts-1-hd-1106',
-              modelName: 'tts-1-hd-1106',
-          },
-          /**/
+            {
+                modelTitle: 'tts-1-hd-1106',
+                modelName: 'tts-1-hd-1106',
+            },
+            /**/
             /*/
-          {
-              modelTitle: 'tts-1-hd',
-              modelName: 'tts-1-hd',
-          },
-          /**/
+            {
+                modelTitle: 'tts-1-hd',
+                modelName: 'tts-1-hd',
+            },
+            /**/
             /**/
             {
                 modelVariant: 'CHAT',
@@ -20391,11 +20430,12 @@
      *
      * This is useful for calling OpenAI API with a single assistant, for more wide usage use `OpenAiExecutionTools`.
      *
-     * !!! Note: [🦖] There are several different things in Promptbook:
+     * Note: [🦖] There are several different things in Promptbook:
      * - `Agent` - which represents an AI Agent with its source, memories, actions, etc. Agent is a higher-level abstraction which is internally using:
      * - `LlmExecutionTools` - which wraps one or more LLM models and provides an interface to execute them
      * - `AgentLlmExecutionTools` - which is a specific implementation of `LlmExecutionTools` that wraps another LlmExecutionTools and applies agent-specific system prompts and requirements
      * - `OpenAiAssistantExecutionTools` - which is a specific implementation of `LlmExecutionTools` for OpenAI models with assistant capabilities, recommended for usage in `Agent` or `AgentLlmExecutionTools`
+     * - `RemoteAgent` - which is an `Agent` that connects to a Promptbook Agents Server
      *
      * @public exported from `@promptbook/openai`
      */
@@ -20430,6 +20470,12 @@
          * Calls OpenAI API to use a chat model.
          */
         async callChatModel(prompt) {
+            return this.callChatModelStream(prompt, () => { });
+        }
+        /**
+         * Calls OpenAI API to use a chat model with streaming.
+         */
+        async callChatModelStream(prompt, onProgress) {
             var _a, _b, _c;
             if (this.options.isVerbose) {
                 console.info('💬 OpenAI callChatModel call', { prompt });
@@ -20497,21 +20543,24 @@
                     console.info('connect', stream.currentEvent);
                 }
             });
-            /*
-            stream.on('messageDelta', (messageDelta) => {
-                if (
-                    this.options.isVerbose &&
-                    messageDelta &&
-                    messageDelta.content &&
-                    messageDelta.content[0] &&
-                    messageDelta.content[0].type === 'text'
-                ) {
-                    console.info('messageDelta', messageDelta.content[0].text?.value);
+            stream.on('textDelta', (textDelta, snapshot) => {
+                if (this.options.isVerbose && textDelta.value) {
+                    console.info('textDelta', textDelta.value);
                 }
-
-                // <- TODO: [🐚] Make streaming and running tasks working
+                const chunk = {
+                    content: textDelta.value || '',
+                    modelName: 'assistant',
+                    timing: {
+                        start,
+                        complete: $getCurrentDate(),
+                    },
+                    usage: UNCERTAIN_USAGE,
+                    rawPromptContent,
+                    rawRequest,
+                    rawResponse: snapshot,
+                };
+                onProgress(chunk);
             });
-            */
             stream.on('messageCreated', (message) => {
                 if (this.options.isVerbose) {
                     console.info('messageCreated', message);
@@ -20547,7 +20596,7 @@
             }
             return exportJson({
                 name: 'promptResult',
-                message: `Result of \`OpenAiAssistantExecutionTools.callChatModel\``,
+                message: `Result of \`OpenAiAssistantExecutionTools.callChatModelStream\``,
                 order: [],
                 value: {
                     content: resultContent,
@@ -20566,15 +20615,19 @@
                 },
             });
         }
-        async playground() {
+        /*
+        public async playground() {
             const client = await this.getClient();
+
             // List all assistants
             const assistants = await client.beta.assistants.list();
             console.log('!!! Assistants:', assistants);
+
             // Get details of a specific assistant
             const assistantId = 'asst_MO8fhZf4dGloCfXSHeLcIik0';
             const assistant = await client.beta.assistants.retrieve(assistantId);
             console.log('!!! Assistant Details:', assistant);
+
             // Update an assistant
             const updatedAssistant = await client.beta.assistants.update(assistantId, {
                 name: assistant.name + '(M)',
@@ -20584,7 +20637,18 @@
                 },
             });
             console.log('!!! Updated Assistant:', updatedAssistant);
-            await waitasecond.forEver();
+
+            await forEver();
+        }
+        */
+        /**
+         * Get an existing assistant tool wrapper
+         */
+        getAssistant(assistantId) {
+            return new OpenAiAssistantExecutionTools({
+                ...this.options,
+                assistantId,
+            });
         }
         async createNewAssistant(options) {
             if (!this.isCreatingNewAssistantsAllowed) {
@@ -20671,9 +20735,98 @@
             }
             const assistant = await client.beta.assistants.create(assistantConfig);
             console.log(`✅ Assistant created: ${assistant.id}`);
-            // TODO: !!!! Try listing existing assistants
-            // TODO: !!!! Try marking existing assistants by DISCRIMINANT
-            // TODO: !!!! Allow to update and reconnect to existing assistants
+            // TODO: [🐱‍🚀] Try listing existing assistants
+            // TODO: [🐱‍🚀] Try marking existing assistants by DISCRIMINANT
+            // TODO: [🐱‍🚀] Allow to update and reconnect to existing assistants
+            return new OpenAiAssistantExecutionTools({
+                ...this.options,
+                isCreatingNewAssistantsAllowed: false,
+                assistantId: assistant.id,
+            });
+        }
+        async updateAssistant(options) {
+            if (!this.isCreatingNewAssistantsAllowed) {
+                throw new NotAllowed(`Updating assistants is not allowed. Set \`isCreatingNewAssistantsAllowed: true\` in options to enable this feature.`);
+            }
+            const { assistantId, name, instructions, knowledgeSources } = options;
+            const client = await this.getClient();
+            let vectorStoreId;
+            // If knowledge sources are provided, create a vector store with them
+            // TODO: [🧠] Reuse vector store creation logic from createNewAssistant
+            if (knowledgeSources && knowledgeSources.length > 0) {
+                if (this.options.isVerbose) {
+                    console.info(`📚 Creating vector store for update with ${knowledgeSources.length} knowledge sources...`);
+                }
+                // Create a vector store
+                const vectorStore = await client.beta.vectorStores.create({
+                    name: `${name} Knowledge Base`,
+                });
+                vectorStoreId = vectorStore.id;
+                if (this.options.isVerbose) {
+                    console.info(`✅ Vector store created: ${vectorStoreId}`);
+                }
+                // Upload files from knowledge sources to the vector store
+                const fileStreams = [];
+                for (const source of knowledgeSources) {
+                    try {
+                        // Check if it's a URL
+                        if (source.startsWith('http://') || source.startsWith('https://')) {
+                            // Download the file
+                            const response = await fetch(source);
+                            if (!response.ok) {
+                                console.error(`Failed to download ${source}: ${response.statusText}`);
+                                continue;
+                            }
+                            const buffer = await response.arrayBuffer();
+                            const filename = source.split('/').pop() || 'downloaded-file';
+                            const blob = new Blob([buffer]);
+                            const file = new File([blob], filename);
+                            fileStreams.push(file);
+                        }
+                        else {
+                            // Assume it's a local file path
+                            // Note: This will work in Node.js environment
+                            // For browser environments, this would need different handling
+                            const fs = await import('fs');
+                            const fileStream = fs.createReadStream(source);
+                            fileStreams.push(fileStream);
+                        }
+                    }
+                    catch (error) {
+                        console.error(`Error processing knowledge source ${source}:`, error);
+                    }
+                }
+                // Batch upload files to the vector store
+                if (fileStreams.length > 0) {
+                    try {
+                        await client.beta.vectorStores.fileBatches.uploadAndPoll(vectorStoreId, {
+                            files: fileStreams,
+                        });
+                        if (this.options.isVerbose) {
+                            console.info(`✅ Uploaded ${fileStreams.length} files to vector store`);
+                        }
+                    }
+                    catch (error) {
+                        console.error('Error uploading files to vector store:', error);
+                    }
+                }
+            }
+            const assistantUpdate = {
+                name,
+                instructions,
+                tools: [/* TODO: [🧠] Maybe add { type: 'code_interpreter' }, */ { type: 'file_search' }],
+            };
+            if (vectorStoreId) {
+                assistantUpdate.tool_resources = {
+                    file_search: {
+                        vector_store_ids: [vectorStoreId],
+                    },
+                };
+            }
+            const assistant = await client.beta.assistants.update(assistantId, assistantUpdate);
+            if (this.options.isVerbose) {
+                console.log(`✅ Assistant updated: ${assistant.id}`);
+            }
             return new OpenAiAssistantExecutionTools({
                 ...this.options,
                 isCreatingNewAssistantsAllowed: false,
@@ -22906,6 +23059,60 @@
      * Note: [💞] Ignore a discrepancy between file name and entity name
      */
 
+    /**
+     * INITIAL MESSAGE commitment definition
+     *
+     * The INITIAL MESSAGE commitment defines the first message that the user sees when opening the chat.
+     * It is used to greet the user and set the tone of the conversation.
+     *
+     * Example usage in agent source:
+     *
+     * ```book
+     * INITIAL MESSAGE Hello! I am ready to help you with your tasks.
+     * ```
+     *
+     * @private [🪔] Maybe export the commitments through some package
+     */
+    class InitialMessageCommitmentDefinition extends BaseCommitmentDefinition {
+        constructor() {
+            super('INITIAL MESSAGE');
+        }
+        /**
+         * Short one-line description of INITIAL MESSAGE.
+         */
+        get description() {
+            return 'Defines the **initial message** shown to the user when the chat starts.';
+        }
+        /**
+         * Markdown documentation for INITIAL MESSAGE commitment.
+         */
+        get documentation() {
+            return spaceTrim.spaceTrim(`
+            # ${this.type}
+
+            Defines the first message that the user sees when opening the chat. This message is purely for display purposes in the UI and does not inherently become part of the LLM's system prompt context (unless also included via other means).
+
+            ## Key aspects
+
+            - Used to greet the user.
+            - Sets the tone of the conversation.
+            - Displayed immediately when the chat interface loads.
+
+            ## Examples
+
+            \`\`\`book
+            Support Agent
+
+            PERSONA You are a helpful support agent.
+            INITIAL MESSAGE Hi there! How can I assist you today?
+            \`\`\`
+        `);
+        }
+        applyToAgentModelRequirements(requirements, content) {
+            return requirements;
+        }
+    }
+
     /**
      * MESSAGE commitment definition
      *
@@ -23610,6 +23817,7 @@
                 // Keep everything after the PERSONA section
                 cleanedMessage = lines.slice(personaEndIndex).join('\n').trim();
             }
+            // TODO: [🕛] There should be `agentFullname` not `agentName`
             // Create new system message with persona at the beginning
             // Format: "You are {agentName}\n{personaContent}"
             // The # PERSONA comment will be removed later by removeCommentsFromSystemMessage
@@ -24066,6 +24274,7 @@
         new NoteCommitmentDefinition('NONCE'),
         new GoalCommitmentDefinition('GOAL'),
         new GoalCommitmentDefinition('GOALS'),
+        new InitialMessageCommitmentDefinition(),
         new MessageCommitmentDefinition('MESSAGE'),
         new MessageCommitmentDefinition('MESSAGES'),
         new ScenarioCommitmentDefinition('SCENARIO'),
@@ -24438,6 +24647,36 @@
      * TODO: [🤹] Figure out best placeholder image generator https://i.pravatar.cc/1000?u=568
      */
 
+    /**
+     * Computes SHA-256 hash of the agent source
+     *
+     * @public exported from `@promptbook/core`
+     */
+    function computeAgentHash(agentSource) {
+        return computeHash(agentSource);
+    }
+
+    /**
+     * Normalizes agent name from arbitrary string to valid agent name
+     *
+     * Note: [🔂] This function is idempotent.
+     *
+     * @public exported from `@promptbook/core`
+     */
+    function normalizeAgentName(rawAgentName) {
+        return titleToName(spaceTrim__default["default"](rawAgentName));
+    }
+
+    /**
+     * Creates temporary default agent name based on agent source hash
+     *
+     * @public exported from `@promptbook/core`
+     */
+    function createDefaultAgentName(agentSource) {
+        const agentHash = computeAgentHash(agentSource);
+        return normalizeAgentName(`Agent ${agentHash.substring(0, 6)}`);
+    }
+
     /**
      * Parses basic information from agent source
      *
@@ -24463,13 +24702,31 @@
             }
             personaDescription += commitment.content;
         }
+        let initialMessage = null;
+        for (const commitment of parseResult.commitments) {
+            if (commitment.type !== 'INITIAL MESSAGE') {
+                continue;
+            }
+            // Note: Initial message override logic - later overrides earlier
+            //       Or should it append? Usually initial message is just one block.
+            //       Let's stick to "later overrides earlier" for simplicity, or just take the last one.
+            initialMessage = commitment.content;
+        }
         const meta = {};
+        const links = [];
         for (const commitment of parseResult.commitments) {
+            if (commitment.type === 'META LINK') {
+                links.push(spaceTrim__default["default"](commitment.content));
+                continue;
+            }
             if (commitment.type !== 'META') {
                 continue;
             }
             // Parse META commitments - format is "META TYPE content"
             const metaTypeRaw = commitment.content.split(' ')[0] || 'NONE';
+            if (metaTypeRaw === 'LINK') {
+                links.push(spaceTrim__default["default"](commitment.content.substring(metaTypeRaw.length)));
+            }
             const metaType = normalizeTo_camelCase(metaTypeRaw);
             meta[metaType] = spaceTrim__default["default"](commitment.content.substring(metaTypeRaw.length));
         }
@@ -24480,10 +24737,14 @@
         // Parse parameters using unified approach - both @Parameter and {parameter} notations
         // are treated as the same syntax feature with unified representation
         const parameters = parseParameters(agentSource);
+        const agentHash = computeAgentHash(agentSource);
         return {
-            agentName: parseResult.agentName,
+            agentName: normalizeAgentName(parseResult.agentName || createDefaultAgentName(agentSource)),
+            agentHash,
             personaDescription,
+            initialMessage,
             meta,
+            links,
             parameters,
         };
     }
@@ -24701,7 +24962,7 @@
                         });
 
                         const answer = response.choices[0].message.content;
-                        console.log('\\n🧠 ${agentName}:', answer, '\\n');
+                        console.log('\\n🧠 ${agentName /* <- TODO: [🕛] There should be `agentFullname` not `agentName` */}:', answer, '\\n');
 
                         chatHistory.push({ role: 'assistant', content: answer });
                         promptUser();
@@ -24720,7 +24981,7 @@
 
                     (async () => {
                         await setupKnowledge();
-                        console.log("🤖 Chat with ${agentName} (type 'exit' to quit)\\n");
+                        console.log("🤖 Chat with ${agentName /* <- TODO: [🕛] There should be `agentFullname` not `agentName` */} (type 'exit' to quit)\\n");
                         promptUser();
                     })();
                 `);
@@ -24767,7 +25028,7 @@
                     });
 
                     const answer = response.choices[0].message.content;
-                    console.log('\\n🧠 ${agentName}:', answer, '\\n');
+                    console.log('\\n🧠 ${agentName /* <- TODO: [🕛] There should be `agentFullname` not `agentName` */}:', answer, '\\n');
 
                     chatHistory.push({ role: 'assistant', content: answer });
                     promptUser();
@@ -24784,7 +25045,7 @@
                     });
                 }
 
-                console.log("🤖 Chat with ${agentName} (type 'exit' to quit)\\n");
+                console.log("🤖 Chat with ${agentName /* <- TODO: [🕛] There should be `agentFullname` not `agentName` */} (type 'exit' to quit)\\n");
                 promptUser();
 
             `);
@@ -24800,7 +25061,7 @@
      * @public exported from `@promptbook/wizard`
      * @public exported from `@promptbook/cli`
      *
-     * TODO: !!!! Which package should export this?
+     * TODO: [🧠] Which package should export this?
      */
     const _OpenAiSdkTranspilerRegistration = $bookTranspilersRegister.register(OpenAiSdkTranspiler);
     /**