@promptbook/core 0.103.0-43 → 0.103.0-45

package/umd/index.umd.js

@@ -1,16 +1,16 @@
 (function (global, factory) {
-    typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports, require('spacetrim'), require('crypto'), require('rxjs'), require('waitasecond'), require('crypto-js/enc-hex'), require('crypto-js/sha256'), require('path'), require('crypto-js'), require('mime-types'), require('papaparse'), require('colors'), require('moment'), require('bottleneck'), require('openai')) :
-    typeof define === 'function' && define.amd ? define(['exports', 'spacetrim', 'crypto', 'rxjs', 'waitasecond', 'crypto-js/enc-hex', 'crypto-js/sha256', 'path', 'crypto-js', 'mime-types', 'papaparse', 'colors', 'moment', 'bottleneck', 'openai'], factory) :
-    (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global["promptbook-core"] = {}, global.spaceTrim$1, global.crypto, global.rxjs, global.waitasecond, global.hexEncoder, global.sha256, global.path, global.cryptoJs, global.mimeTypes, global.papaparse, global.colors, global.moment, global.Bottleneck, global.OpenAI));
-})(this, (function (exports, spaceTrim$1, crypto, rxjs, waitasecond, hexEncoder, sha256, path, cryptoJs, mimeTypes, papaparse, colors, moment, Bottleneck, OpenAI) { 'use strict';
+    typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports, require('spacetrim'), require('crypto'), require('rxjs'), require('waitasecond'), require('crypto-js/enc-hex'), require('crypto-js/sha256'), require('path'), require('crypto-js'), require('mime-types'), require('papaparse'), require('moment'), require('colors'), require('bottleneck'), require('openai')) :
+    typeof define === 'function' && define.amd ? define(['exports', 'spacetrim', 'crypto', 'rxjs', 'waitasecond', 'crypto-js/enc-hex', 'crypto-js/sha256', 'path', 'crypto-js', 'mime-types', 'papaparse', 'moment', 'colors', 'bottleneck', 'openai'], factory) :
+    (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global["promptbook-core"] = {}, global.spaceTrim$1, global.crypto, global.rxjs, global.waitasecond, global.hexEncoder, global.sha256, global.path, global.cryptoJs, global.mimeTypes, global.papaparse, global.moment, global.colors, global.Bottleneck, global.OpenAI));
+})(this, (function (exports, spaceTrim$1, crypto, rxjs, waitasecond, hexEncoder, sha256, path, cryptoJs, mimeTypes, papaparse, moment, colors, Bottleneck, OpenAI) { 'use strict';
 
     function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e : { 'default': e }; }
 
     var spaceTrim__default = /*#__PURE__*/_interopDefaultLegacy(spaceTrim$1);
     var hexEncoder__default = /*#__PURE__*/_interopDefaultLegacy(hexEncoder);
     var sha256__default = /*#__PURE__*/_interopDefaultLegacy(sha256);
-    var colors__default = /*#__PURE__*/_interopDefaultLegacy(colors);
     var moment__default = /*#__PURE__*/_interopDefaultLegacy(moment);
+    var colors__default = /*#__PURE__*/_interopDefaultLegacy(colors);
     var Bottleneck__default = /*#__PURE__*/_interopDefaultLegacy(Bottleneck);
     var OpenAI__default = /*#__PURE__*/_interopDefaultLegacy(OpenAI);
 
@@ -21,14 +21,14 @@
      * @generated
      * @see https://github.com/webgptorg/book
      */
-    const BOOK_LANGUAGE_VERSION = '1.0.0';
+    const BOOK_LANGUAGE_VERSION = '2.0.0';
     /**
      * The version of the Promptbook engine
      *
      * @generated
      * @see https://github.com/webgptorg/promptbook
      */
-    const PROMPTBOOK_ENGINE_VERSION = '0.103.0-43';
+    const PROMPTBOOK_ENGINE_VERSION = '0.103.0-45';
     /**
      * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
      * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -2777,6 +2777,9 @@
             Object.setPrototypeOf(this, DatabaseError.prototype);
         }
     }
+    /**
+     * TODO: !!!! Explain that NotFoundError (!!! and other specific errors) has priority over DatabaseError in some contexts
+     */
 
     /**
      * This error type indicates that you try to use a feature that is not available in the current environment
@@ -2882,6 +2885,7 @@
         return crypto.randomBytes(randomness).toString('hex');
     }
     /**
+     * TODO: [🤶] Maybe export through `@promptbook/utils` or `@promptbook/random` package
      * TODO: Maybe use nanoid instead https://github.com/ai/nanoid
      */
 
@@ -3779,6 +3783,7 @@
         return new MultipleLlmExecutionTools(title || 'Multiple LLM Providers joined by `joinLlmExecutionTools`', ...llmExecutionTools);
     }
     /**
+     * TODO: [🙆] `getSingleLlmExecutionTools` vs `joinLlmExecutionTools` - explain difference or pick one
      * TODO: [👷‍♂️] @@@ Manual about construction of llmTools
      */
 
@@ -3795,6 +3800,7 @@
         return llmTools;
     }
     /**
+     * TODO: [🙆] `getSingleLlmExecutionTools` vs `joinLlmExecutionTools` - explain difference or pick one
      * TODO: [👷‍♂️] @@@ Manual about construction of llmTools
      */
 
@@ -9905,25 +9911,26 @@
      * @public exported from `@promptbook/core`
      * <- TODO: !!! Move to `@promptbook/supabase` package
      */
-    class AgentCollectionInSupabase {
+    class AgentCollectionInSupabase /* TODO: !!!! implements AgentCollection */ {
         /**
          * @param rootPath - path to the directory with agents
-         * @param tools - Execution tools to be used in `Agent` itself and listing the agents
+         * @param tools - Execution tools to be used in !!! `Agent` itself and listing the agents
          * @param options - Options for the collection creation
          */
-        constructor(supabaseClient, tools, options) {
+        constructor(supabaseClient, 
+        /// TODO: !!! Remove> private readonly tools?: Pick<ExecutionTools, 'llm' | 'fs' | 'scrapers'>,
+        options) {
             this.supabaseClient = supabaseClient;
-            this.tools = tools;
             this.options = options;
-            /**
-             * Cached defined execution tools
-             */
-            this._definedTools = null;
             const { isVerbose = exports.DEFAULT_IS_VERBOSE } = options || {};
             if (isVerbose) {
-                console.info(colors__default["default"].cyan(`Creating pipeline collection from supabase`));
+                console.info(`Creating pipeline collection from supabase...`);
             }
         }
+        /**
+         * Cached defined execution tools
+         */
+        // !!! private _definedTools: ExecutionTools | null = null;
         /*
         TODO: !!! Use or remove
         /**
@@ -9965,10 +9972,9 @@
         }
         /**
          * !!!
-         */
-        async spawnAgent(agentName) {
-            throw new NotYetImplementedError('Method not implemented.');
-            /*
+         * /
+        public async spawnAgent(agentName: string_agent_name): Promise<Agent> {
+       
             // <- TODO: !!! ENOENT: no such file or directory, open 'C:\Users\me\work\ai\promptbook\agents\examples\Asistent pro LŠVP.book
             const { isVerbose = DEFAULT_IS_VERBOSE } = this.options || {};
             const tools = await this.getTools();
@@ -10016,7 +10022,30 @@
             }
 
             return agent;
-            */
+            * /
+        }
+        */
+        /**
+         * !!!@@@
+         */
+        async getAgentSource(agentName) {
+            const result = await this.supabaseClient
+                .from('AgentCollection' /* <- TODO: !!!! Change to `Agent` */)
+                .select('agentSource')
+                .eq('agentName', agentName)
+                .single();
+            if (result.error) {
+                throw new DatabaseError(spaceTrim((block) => `
+                
+                        Error fetching agent "${agentName}" from Supabase:
+                        
+                        ${block(result.error.message)}
+                    `));
+                // <- TODO: !!! First check if the error is "not found" and throw `NotFoundError` instead then throw `DatabaseError`
+            }
+            const agentSource = new rxjs.BehaviorSubject(result.data.agentSource);
+            // <- TODO: !!!! Dynamic updates
+            return agentSource;
         }
         /**
          * Creates a new agent in the collection
@@ -10053,6 +10082,7 @@
         }
     }
     /**
+     * TODO: !!!! Implement it here correctly and update JSDoc comments here, and on interface + other implementations
      * TODO: Write unit test
      * TODO: [🧠][🚙] `AgentXxx` vs `AgentsXxx` naming convention
      */
@@ -15100,7 +15130,7 @@
     /**
      * List of available OpenAI models with pricing
      *
-     * Note: Synced with official API docs at 2025-08-20
+     * Note: Synced with official API docs at 2025-11-19
      *
      * @see https://platform.openai.com/docs/models/
      * @see https://openai.com/api/pricing/
@@ -15110,11 +15140,21 @@
         name: 'OPENAI_MODELS',
         value: [
             /**/
+            {
+                modelVariant: 'CHAT',
+                modelTitle: 'gpt-5.1',
+                modelName: 'gpt-5.1',
+                modelDescription: 'The best model for coding and agentic tasks with configurable reasoning effort.',
+                pricing: {
+                    prompt: pricing(`$1.25 / 1M tokens`),
+                    output: pricing(`$10.00 / 1M tokens`),
+                },
+            },
             {
                 modelVariant: 'CHAT',
                 modelTitle: 'gpt-5',
                 modelName: 'gpt-5',
-                modelDescription: "OpenAI's most advanced language model with unprecedented reasoning capabilities and 200K context window. Features revolutionary improvements in complex problem-solving, scientific reasoning, and creative tasks. Demonstrates human-level performance across diverse domains with enhanced safety measures and alignment. Represents the next generation of AI with superior understanding, nuanced responses, and advanced multimodal capabilities.",
+                modelDescription: "OpenAI's most advanced language model with unprecedented reasoning capabilities and 200K context window. Features revolutionary improvements in complex problem-solving, scientific reasoning, and creative tasks. Demonstrates human-level performance across diverse domains with enhanced safety measures and alignment. Represents the next generation of AI with superior understanding, nuanced responses, and advanced multimodal capabilities. DEPRECATED: Use gpt-5.1 instead.",
                 pricing: {
                     prompt: pricing(`$1.25 / 1M tokens`),
                     output: pricing(`$10.00 / 1M tokens`),
@@ -16675,11 +16715,11 @@
             if (!this.isCreatingNewAssistantsAllowed) {
                 throw new NotAllowed(`Creating new assistants is not allowed. Set \`isCreatingNewAssistantsAllowed: true\` in options to enable this feature.`);
             }
-            await this.playground();
+            // await this.playground();
             const { name, instructions } = options;
             const client = await this.getClient();
-            /*
-            TODO: !!!
+            /*/
+            //TODO: !!!
             async function downloadFile(url: string, folder = './tmp'): Promise<string> {
                 const filename = path.basename(url.split('?')[0]);
                 const filepath = path.join(folder, filename);
@@ -16723,8 +16763,8 @@
                 const file = await uploadFileToOpenAI(filepath);
                 uploadedFiles.push(file.id);
             }
-            */
-            alert('!!!! Creating new OpenAI assistant');
+            /**/
+            // alert('!!!! Creating new OpenAI assistant');
             // 3️⃣ Create assistant with uploaded files
             const assistant = await client.beta.assistants.create({
                 name,
@@ -16885,15 +16925,27 @@
             const chatPrompt = prompt;
             let underlyingLlmResult;
             if (OpenAiAssistantExecutionTools.isOpenAiAssistantExecutionTools(this.options.llmTools)) {
+                if (this.options.isVerbose) {
+                    console.log(`Creating new OpenAI Assistant for agent ${this.title}...`);
+                }
                 // <- TODO: !!! Check also `isCreatingNewAssistantsAllowed` and warn about it
                 const assistant = await this.options.llmTools.createNewAssistant({
                     name: this.title,
                     instructions: modelRequirements.systemMessage,
+                    /*
+                    !!!
+                    metadata: {
+                        agentModelName: this.modelName,
+                    }
+                    */
                 });
                 // <- TODO: !!! Cache the assistant in prepareCache
                 underlyingLlmResult = await assistant.callChatModel(chatPrompt);
             }
             else {
+                if (this.options.isVerbose) {
+                    console.log(`Creating Assistant ${this.title} on generic LLM execution tools...`);
+                }
                 // Create modified chat prompt with agent system message
                 const modifiedChatPrompt = {
                     ...chatPrompt,
@@ -16974,6 +17026,7 @@
          */
         getLlmExecutionTools() {
             const llmTools = new AgentLlmExecutionTools({
+                isVerbose: this.options.isVerbose,
                 llmTools: getSingleLlmExecutionTools(this.options.executionTools.llm),
                 agentSource: this.agentSource.value, // <- TODO: !!!! Allow to pass BehaviorSubject<string_book> OR refresh llmExecutionTools.callChat on agentSource change
             });
@@ -18294,6 +18347,105 @@
      * TODO: [🗽] Unite branding and make single place for it
      */
 
+    /**
+     * Pick random item from the received array
+     *
+     * @private internal helper function
+     */
+    function $randomItem(...items) {
+        if (items.length === 0) {
+            throw new Error(`Not enough items`);
+        }
+        return items[Math.floor(Math.random( /* <- TODO: [🐉] Probably use seed random */) * items.length)];
+    }
+    /**
+     * TODO: [🤶] Maybe export through `@promptbook/utils` or `@promptbook/random` package
+     */
+
+    const FIRSTNAMES = [
+        'Paul',
+        'George',
+        'Adam',
+        'Lucy',
+        'Sophia',
+        'Emma',
+        'Olivia',
+        'Noah',
+        'Liam',
+        'Ethan',
+        'Ava',
+        'Mia',
+        'Isabella',
+        'James',
+        'Benjamin',
+        'Elijah',
+        'Sophia',
+        'Charlotte',
+        'Amelia',
+        'Harper',
+        'Alexander',
+        'William',
+        'Michael',
+        'Daniel',
+        'Matthew',
+        'Joseph',
+        'David',
+        'Samuel',
+        'Henry',
+        'Jack',
+        'Sebastian',
+        'Gabriel',
+        'Anthony',
+        'Christopher',
+    ];
+    const LASTNAMES_WITH_COLORS = [
+        { lastname: 'Green', color: '#008000' },
+        { lastname: 'Brown', color: '#A52A2A' },
+        { lastname: 'Black', color: '#000000' },
+        { lastname: 'White', color: '#FFFFFF' },
+        { lastname: 'Gray', color: '#808080' },
+        { lastname: 'Blue', color: '#0000FF' },
+    ];
+    /**
+     *
+     * @private internal helper function
+     */
+    function $randomFullnameWithColor() {
+        const firstname = $randomItem(...FIRSTNAMES);
+        const { lastname, color } = $randomItem(...LASTNAMES_WITH_COLORS);
+        return {
+            fullname: `${firstname} ${lastname}`,
+            color,
+        };
+    }
+    /**
+     * TODO: [🤶] Maybe export through `@promptbook/utils` or `@promptbook/random` package
+     */
+
+    const PERSONALITIES = [
+        'Friendly and helpful AI agent.',
+        'Professional and efficient virtual assistant.',
+        'Creative and imaginative digital companion.',
+        'Knowledgeable and informative AI guide.',
+        'Empathetic and understanding support bot.',
+        'Energetic and enthusiastic conversational partner.',
+        'Calm and patient virtual helper.',
+        'Curious and inquisitive AI explorer.',
+        'Witty and humorous digital friend.',
+        'Serious and focused AI consultant.',
+    ];
+    /**
+     * @@@@
+     *
+     * @private internal helper function
+     */
+    function $randomAgentPersona() {
+        return $randomItem(...PERSONALITIES);
+    }
+    /**
+     * TODO: [🤶] Maybe export through `@promptbook/utils` or `@promptbook/random` package
+     */
+
     /**
      * Generates boilerplate for a new agent book
      *
@@ -18305,20 +18457,27 @@
     function $generateBookBoilerplate(options) {
         // eslint-disable-next-line prefer-const
         let { agentName, parentAgentName = 'Adam', personaDescription, meta } = options || {};
+        // eslint-disable-next-line prefer-const
+        let { image, color, ...restMeta } = meta || {};
         if (!agentName) {
-            agentName = 'Agent ' + $randomToken(20);
-            // <- TODO: !!! Supercool random name generator
+            const randomFullnameWithColor = $randomFullnameWithColor();
+            agentName = randomFullnameWithColor.fullname;
+            color = color || randomFullnameWithColor.color;
         }
         if (!personaDescription) {
-            personaDescription = 'Friendly and helpful AI agent.';
+            personaDescription = $randomAgentPersona();
         }
         const agentSource = validateBook(spaceTrim__default["default"]((block) => `
                 ${agentName}
     
+                META COLOR ${color || '#3498db' /* <- TODO: !!!! Best default color */}
                 PERSONA ${block(personaDescription)}
             `));
         return agentSource;
     }
+    /**
+     * TODO: [🤶] Maybe export through `@promptbook/utils` or `@promptbook/random` package
+     */
 
     exports.$bookTranspilersRegister = $bookTranspilersRegister;
     exports.$generateBookBoilerplate = $generateBookBoilerplate;