@promptbook/cli 0.103.0-47 → 0.103.0-48

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-48';
     /**
      * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
      * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -2947,6 +2947,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 +3018,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'
@@ -10026,6 +10030,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.
@@ -13034,6 +13040,9 @@
     }
 
     /**
+     * Normalizes a given text to PascalCase format.
+     *
+     * Note: [🔂] This function is idempotent.
      *
      * @param text @public exported from `@promptbook/utils`
      * @returns
@@ -15091,7 +15100,7 @@
      *
      * @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;
@@ -16403,8 +16412,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 +17533,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',
@@ -20566,15 +20574,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 +20596,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) {
@@ -20680,6 +20703,95 @@
                 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,
+                assistantId: assistant.id,
+            });
+        }
         /**
          * Discriminant for type guards
          */
@@ -23610,6 +23722,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
@@ -24438,6 +24551,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 cryptoJs.SHA256(hexEncoder__default["default"].parse(agentSource /* <- TODO: !!!!! spaceTrim */)).toString( /* hex */);
+    }
+
+    /**
+     * 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
      *
@@ -24480,8 +24623,10 @@
         // 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,
             meta,
             parameters,
@@ -24701,7 +24846,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 +24865,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 +24912,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 +24929,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 +24945,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);
     /**