@promptbook/cli 0.103.0-46 → 0.103.0-47

package/esm/typings/src/llm-providers/openai/OpenAiAssistantExecutionTools.d.ts

@@ -9,7 +9,7 @@ import { OpenAiExecutionTools } from './OpenAiExecutionTools';
  *
  * 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
@@ -42,6 +42,10 @@ export declare class OpenAiAssistantExecutionTools extends OpenAiExecutionTools
          * Instructions for the new assistant
          */
         readonly instructions: string_markdown;
+        /**
+         * Optional list of knowledge source links (URLs or file paths) to attach to the assistant via vector store
+         */
+        readonly knowledgeSources?: ReadonlyArray<string>;
     }): Promise<OpenAiAssistantExecutionTools>;
     /**
      * Discriminant for type guards

package/esm/typings/src/storage/_common/PromptbookStorage.d.ts

@@ -21,4 +21,5 @@ export type PromptbookStorage<TItem> = {
 };
 /**
  * TODO: [💺] Constrain `TItem` to [🚉] JSON-serializable objects only in type level
+ * TODO: [☹️] Unite the storages
  */

package/esm/typings/src/types/typeAliases.d.ts

@@ -360,6 +360,12 @@ export type string_base_url = string;
  * For example `"https://promptbook.studio/webgpt/"`
  */
 export type string_pipeline_root_url = string;
+/**
+ * Semantic helper
+ *
+ * For example `"https://s6.ptbk.io/agents/agent-007"`
+ */
+export type string_agent_url = string;
 /**
  * Semantic helper
  *

package/esm/typings/src/utils/color/internal-utils/checkChannelValue.d.ts

@@ -9,6 +9,3 @@
  * @private util of `@promptbook/color`
  */
 export declare function checkChannelValue(channelName: string, value: number): asserts value is number;
-/**
- * TODO: [🧠][🚓] Is/which combination it better to use asserts/check, validate or is utility function?
- */

package/esm/typings/src/utils/random/$generateBookBoilerplate.d.ts

@@ -1,7 +1,7 @@
 import type { PartialDeep } from 'type-fest';
 import type { AgentBasicInformation } from '../../book-2.0/agent-source/AgentBasicInformation';
-import { string_book } from '../../book-2.0/agent-source/string_book';
-import { string_agent_name_in_book } from '../../types/typeAliases';
+import type { string_book } from '../../book-2.0/agent-source/string_book';
+import type { string_agent_name_in_book } from '../../types/typeAliases';
 type GenerateBookBoilerplateOptions = PartialDeep<Omit<AgentBasicInformation, 'parameters'>> & {
     /**
      * Name of the parent agent to inherit from

package/esm/typings/src/utils/random/$randomFullnameWithColor.d.ts

@@ -1,4 +1,4 @@
-import { string_color, string_person_fullname } from '../../types/typeAliases';
+import type { string_color, string_person_fullname } from '../../types/typeAliases';
 export type RandomFullnameWithColorResult = {
     fullname: string_person_fullname;
     color: string_color;

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

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@promptbook/cli",
-    "version": "0.103.0-46",
+    "version": "0.103.0-47",
     "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-46';
+    const PROMPTBOOK_ENGINE_VERSION = '0.103.0-47';
     /**
      * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
      * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -69,15 +69,20 @@
      */
     const REMOTE_SERVER_URLS = [
         {
-            title: 'Promptbook',
-            description: `Servers of Promptbook.studio`,
+            title: 'Promptbook.Studio',
+            description: `Server of Promptbook.studio`,
             owner: 'AI Web, LLC <legal@ptbk.io> (https://www.ptbk.io/)',
-            isAnonymousModeAllowed: true,
             urls: [
                 'https://promptbook.s5.ptbk.io/',
                 // Note: Servers 1-4 are not running
             ],
         },
+        {
+            title: 'Testing Agents',
+            description: `Testing Agents server on Vercel`,
+            owner: 'AI Web, LLC <legal@ptbk.io> (https://www.ptbk.io/)',
+            urls: ['https://s6.ptbk.io/'],
+        },
         /*
         Note: Working on older version of Promptbook and not supported anymore
         {
@@ -335,9 +340,6 @@
             throw new Error(`${channelName} channel is greater than 255, it is ${value}`);
         }
     }
-    /**
-     * TODO: [🧠][🚓] Is/which combination it better to use asserts/check, validate or is utility function?
-     */
 
     /**
      * Color object represents an RGB color with alpha channel
@@ -15094,11 +15096,13 @@
     async function startAgentServer(options) {
         const { port = 4440 } = options;
         // TODO: !!!! [🌕]
+        const agentsServerRoot = path.join(__dirname, '../apps/agents-server');
         console.trace(`!!! Starting agents server on port ${port}...`);
         console.log(`!!! cwd`, process.cwd());
         console.log(`!!! __dirname`, __dirname);
+        console.log(`!!! agentsServerRoot`, agentsServerRoot);
         await $execCommand({
-            cwd: './apps/agents-server',
+            cwd: agentsServerRoot,
             command: `next dev --port ${port} `,
             isVerbose: true,
         });
@@ -18851,26 +18855,6 @@
                     output: pricing(`$0.45 / 1M tokens`),
                 },
             },
-            {
-                modelVariant: 'CHAT',
-                modelTitle: 'Gemini 2.0 Flash',
-                modelName: 'gemini-2.0-flash',
-                modelDescription: 'Fast, efficient model with 128K context window optimized for rapid response times. Balances performance and cost with 2x lower latency than Pro models while maintaining strong capabilities in text generation, code completion, and logical reasoning. Excellent for interactive applications, chatbots, and services requiring quick responses with good quality.',
-                pricing: {
-                    prompt: pricing(`$0.35 / 1M tokens`),
-                    output: pricing(`$1.05 / 1M tokens`),
-                },
-            },
-            {
-                modelVariant: 'CHAT',
-                modelTitle: 'Gemini 2.0 Flash Lite',
-                modelName: 'gemini-2.0-flash-lite',
-                modelDescription: 'Streamlined version of Gemini 2.0 Flash with 64K context window, designed for extremely low-latency applications. Features 40% smaller model size and 3x faster inference while retaining core capabilities for text and simple reasoning tasks. Perfect for mobile applications, edge deployments, and high-volume services with strict latency requirements.',
-                pricing: {
-                    prompt: pricing(`$0.20 / 1M tokens`),
-                    output: pricing(`$0.60 / 1M tokens`),
-                },
-            },
             {
                 modelVariant: 'CHAT',
                 modelTitle: 'Gemini 2.0 Flash Thinking',
@@ -20407,7 +20391,7 @@
      *
      * 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
@@ -20513,17 +20497,21 @@
                     console.info('connect', stream.currentEvent);
                 }
             });
+            /*
             stream.on('messageDelta', (messageDelta) => {
-                var _a;
-                if (this.options.isVerbose &&
+                if (
+                    this.options.isVerbose &&
                     messageDelta &&
                     messageDelta.content &&
                     messageDelta.content[0] &&
-                    messageDelta.content[0].type === 'text') {
-                    console.info('messageDelta', (_a = messageDelta.content[0].text) === null || _a === void 0 ? void 0 : _a.value);
+                    messageDelta.content[0].type === 'text'
+                ) {
+                    console.info('messageDelta', messageDelta.content[0].text?.value);
                 }
+
                 // <- TODO: [🐚] Make streaming and running tasks working
             });
+            */
             stream.on('messageCreated', (message) => {
                 if (this.options.isVerbose) {
                     console.info('messageCreated', message);
@@ -20603,64 +20591,85 @@
                 throw new NotAllowed(`Creating new assistants is not allowed. Set \`isCreatingNewAssistantsAllowed: true\` in options to enable this feature.`);
             }
             // await this.playground();
-            const { name, instructions } = options;
+            const { name, instructions, knowledgeSources } = options;
             const client = await this.getClient();
-            /*/
-            //TODO: !!!
-            async function downloadFile(url: string, folder = './tmp'): Promise<string> {
-                const filename = path.basename(url.split('?')[0]);
-                const filepath = path.join(folder, filename);
-
-                if (!fs.existsSync(folder)) fs.mkdirSync(folder);
-
-                const res = await fetch(url);
-                if (!res.ok) throw new Error(`Download error: ${url}`);
-                const buffer = await res.arrayBuffer();
-                fs.writeFileSync(filepath, Buffer.from(buffer));
-                console.log(`📥 File downloaded: ${filename}`);
-
-                return filepath;
-            }
-
-            async function uploadFileToOpenAI(filepath: string) {
-                const file = await client.files.create({
-                    file: fs.createReadStream(filepath),
-                    purpose: 'assistants',
+            let vectorStoreId;
+            // If knowledge sources are provided, create a vector store with them
+            if (knowledgeSources && knowledgeSources.length > 0) {
+                if (this.options.isVerbose) {
+                    console.info(`📚 Creating vector store with ${knowledgeSources.length} knowledge sources...`);
+                }
+                // Create a vector store
+                const vectorStore = await client.beta.vectorStores.create({
+                    name: `${name} Knowledge Base`,
                 });
-                console.log(`⬆️  File uploaded to OpenAI: ${file.filename} (${file.id})`);
-                return file;
-            }
-
-            // 🌐 URL addresses of files to upload
-            const fileUrls = [
-                'https://raw.githubusercontent.com/vercel/next.js/canary/packages/next/README.md',
-                'https://raw.githubusercontent.com/openai/openai-cookbook/main/examples/How_to_call_the_Assistants_API_with_Node.js.ipynb',
-            ];
-
-            // 1️⃣ Download files from URL
-            const localFiles = [];
-            for (const url of fileUrls) {
-                const filepath = await downloadFile(url);
-                localFiles.push(filepath);
-            }
-
-            // 2️⃣ Upload files to OpenAI
-            const uploadedFiles = [];
-            for (const filepath of localFiles) {
-                const file = await uploadFileToOpenAI(filepath);
-                uploadedFiles.push(file.id);
+                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);
+                    }
+                }
             }
-            /**/
-            // alert('!!!! Creating new OpenAI assistant');
-            // 3️⃣ Create assistant with uploaded files
-            const assistant = await client.beta.assistants.create({
+            // Create assistant with vector store attached
+            const assistantConfig = {
                 name,
                 description: 'Assistant created via Promptbook',
                 model: 'gpt-4o',
                 instructions,
                 tools: [/* TODO: [🧠] Maybe add { type: 'code_interpreter' }, */ { type: 'file_search' }],
-                // !!!! file_ids: uploadedFiles,
-            });
+            };
+            // Attach vector store if created
+            if (vectorStoreId) {
+                assistantConfig.tool_resources = {
+                    file_search: {
+                        vector_store_ids: [vectorStoreId],
+                    },
+                };
+            }
+            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
@@ -22234,40 +22243,6 @@
      * Note: [💞] Ignore a discrepancy between file name and entity name
      */
 
-    /**
-     * Creates an empty/basic agent model requirements object
-     * This serves as the starting point for the reduce-like pattern
-     * where each commitment applies its changes to build the final requirements
-     *
-     * @public exported from `@promptbook/core`
-     */
-    function createEmptyAgentModelRequirements() {
-        return {
-            systemMessage: '',
-            // modelName: 'gpt-5',
-            modelName: 'gemini-2.5-flash-lite',
-            temperature: 0.7,
-            topP: 0.9,
-            topK: 50,
-        };
-    }
-    /**
-     * Creates a basic agent model requirements with just the agent name
-     * This is used when we have an agent name but no commitments
-     *
-     * @public exported from `@promptbook/core`
-     */
-    function createBasicAgentModelRequirements(agentName) {
-        const empty = createEmptyAgentModelRequirements();
-        return {
-            ...empty,
-            systemMessage: `You are ${agentName || 'AI Agent'}`,
-        };
-    }
-    /**
-     * TODO: [🐤] Deduplicate `AgentModelRequirements` and `ModelRequirements` model requirements
-     */
-
     /**
      * Generates a regex pattern to match a specific commitment
      *
@@ -22801,23 +22776,19 @@
         `);
         }
         applyToAgentModelRequirements(requirements, content) {
-            var _a;
             const trimmedContent = content.trim();
             if (!trimmedContent) {
                 return requirements;
             }
             // Check if content is a URL (external knowledge source)
-            if (this.isUrl(trimmedContent)) {
+            if (isValidUrl(trimmedContent)) {
                 // Store the URL for later async processing
                 const updatedRequirements = {
                     ...requirements,
-                    metadata: {
-                        ...requirements.metadata,
-                        knowledgeSources: [
-                            ...(((_a = requirements.metadata) === null || _a === void 0 ? void 0 : _a.knowledgeSources) || []),
-                            trimmedContent,
-                        ],
-                    },
+                    knowledgeSources: [
+                        ...(requirements.knowledgeSources || []),
+                        trimmedContent,
+                    ],
                 };
                 // Add placeholder information about knowledge sources to system message
                 const knowledgeInfo = `Knowledge Source URL: ${trimmedContent} (will be processed for retrieval during chat)`;
@@ -22829,18 +22800,6 @@
                 return this.appendToSystemMessage(requirements, knowledgeSection, '\n\n');
             }
         }
-        /**
-         * Check if content is a URL
-         */
-        isUrl(content) {
-            try {
-                new URL(content);
-                return true;
-            }
-            catch (_a) {
-                return false;
-            }
-        }
     }
     /**
      * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -24138,6 +24097,40 @@
      * Note: [💞] Ignore a discrepancy between file name and entity name
      */
 
+    /**
+     * Creates an empty/basic agent model requirements object
+     * This serves as the starting point for the reduce-like pattern
+     * where each commitment applies its changes to build the final requirements
+     *
+     * @public exported from `@promptbook/core`
+     */
+    function createEmptyAgentModelRequirements() {
+        return {
+            systemMessage: '',
+            // modelName: 'gpt-5',
+            modelName: 'gemini-2.5-flash-lite',
+            temperature: 0.7,
+            topP: 0.9,
+            topK: 50,
+        };
+    }
+    /**
+     * Creates a basic agent model requirements with just the agent name
+     * This is used when we have an agent name but no commitments
+     *
+     * @public exported from `@promptbook/core`
+     */
+    function createBasicAgentModelRequirements(agentName) {
+        const empty = createEmptyAgentModelRequirements();
+        return {
+            ...empty,
+            systemMessage: `You are ${agentName || 'AI Agent'}`,
+        };
+    }
+    /**
+     * TODO: [🐤] Deduplicate `AgentModelRequirements` and `ModelRequirements` model requirements
+     */
+
     /**
      * Parses agent source using the new commitment system with multiline support
      * This function replaces the hardcoded commitment parsing in the original parseAgentSource
@@ -24228,29 +24221,6 @@
         };
     }
 
-    /**
-     * Removes comment lines (lines starting with #) from a system message
-     * This is used to clean up the final system message before sending it to the AI model
-     * while preserving the original content with comments in metadata
-     *
-     * @param systemMessage The system message that may contain comment lines
-     * @returns The system message with comment lines removed
-     *
-     * @private - TODO: [🧠] Maybe should be public?
-     */
-    function removeCommentsFromSystemMessage(systemMessage) {
-        if (!systemMessage) {
-            return systemMessage;
-        }
-        const lines = systemMessage.split('\n');
-        const filteredLines = lines.filter((line) => {
-            const trimmedLine = line.trim();
-            // Remove lines that start with # (comments)
-            return !trimmedLine.startsWith('#');
-        });
-        return filteredLines.join('\n').trim();
-    }
-
     /**
      * Parses parameters from text using both supported notations:
      * 1. @Parameter - single word parameter starting with @
@@ -24309,6 +24279,29 @@
         return uniqueParameters;
     }
 
+    /**
+     * Removes comment lines (lines starting with #) from a system message
+     * This is used to clean up the final system message before sending it to the AI model
+     * while preserving the original content with comments in metadata
+     *
+     * @param systemMessage The system message that may contain comment lines
+     * @returns The system message with comment lines removed
+     *
+     * @private - TODO: [🧠] Maybe should be public?
+     */
+    function removeCommentsFromSystemMessage(systemMessage) {
+        if (!systemMessage) {
+            return systemMessage;
+        }
+        const lines = systemMessage.split('\n');
+        const filteredLines = lines.filter((line) => {
+            const trimmedLine = line.trim();
+            // Remove lines that start with # (comments)
+            return !trimmedLine.startsWith('#');
+        });
+        return filteredLines.join('\n').trim();
+    }
+
     /**
      * Creates agent model requirements using the new commitment system
      * This function uses a reduce-like pattern where each commitment applies its changes