@promptbook/browser 0.104.0-9 → 0.105.0-0

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

@@ -1,9 +1,14 @@
+import type { string_persona_description } from '../../types/typeAliases';
 /**
- * @@@@
+ * Generates a random agent persona description.
  *
+ * This function selects a random personality profile from a predefined pool
+ * of common AI agent characteristics (e.g., friendly, professional, creative).
+ *
+ * @returns A string describing the agent's persona
  * @private internal helper function
  */
-export declare function $randomAgentPersona(): string;
+export declare function $randomAgentPersona(): string_persona_description;
 /**
  * TODO: [🤶] Maybe export through `@promptbook/utils` or `@promptbook/random` package
  */

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

@@ -6,4 +6,4 @@
 export declare function $randomItem<TItem>(...items: Array<TItem>): TItem;
 /**
  * TODO: [🤶] Maybe export through `@promptbook/utils` or `@promptbook/random` package
- */ 
+ */

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

@@ -10,4 +10,4 @@ import type { number_seed } from '../../types/typeAliases';
 export declare function $randomSeed(): number_seed;
 /**
  * TODO: [🤶] Maybe export through `@promptbook/utils` or `@promptbook/random` package
- */ 
+ */

package/esm/typings/src/utils/validators/url/isValidAgentUrl.d.ts

@@ -0,0 +1,16 @@
+import type { string_agent_url } from '../../../types/typeAliases';
+import type { really_unknown } from '../../organization/really_unknown';
+/**
+ * Tests if given string is valid agent URL
+ *
+ * Note: There are few similar functions:
+ * - `isValidUrl` which tests any URL
+ * - `isValidAgentUrl` *(this one)* which tests just agent URL
+ * - `isValidPipelineUrl` which tests just pipeline URL
+ *
+ * @public exported from `@promptbook/utils`
+ */
+export declare function isValidAgentUrl(url: really_unknown): url is string_agent_url;
+/**
+ * TODO: [🐠] Maybe more info why the URL is invalid
+ */

package/esm/typings/src/utils/validators/url/isValidAgentUrl.test.d.ts

@@ -0,0 +1 @@
+export {};

package/esm/typings/src/utils/validators/url/isValidPipelineUrl.d.ts

@@ -3,8 +3,9 @@ import type { really_unknown } from '../../organization/really_unknown';
 /**
  * Tests if given string is valid pipeline URL URL.
  *
- * Note: There are two similar functions:
+ * Note: There are few similar functions:
  * - `isValidUrl` which tests any URL
+ * - `isValidAgentUrl` which tests just agent URL
  * - `isValidPipelineUrl` *(this one)* which tests just pipeline URL
  *
  * @public exported from `@promptbook/utils`

package/esm/typings/src/utils/validators/url/isValidUrl.d.ts

@@ -5,9 +5,10 @@ import type { really_unknown } from '../../organization/really_unknown';
  *
  * Note: [🔂] This function is idempotent.
  * Note: Dataurl are considered perfectly valid.
- * Note: There are two similar functions:
- * - `isValidUrl` which tests any URL
- * - `isValidPipelineUrl` *(this one)* which tests just promptbook URL
+ * Note: There are few similar functions:
+ * - `isValidUrl` *(this one)* which tests any URL
+ * - `isValidAgentUrl` which tests just agent URL
+ * - `isValidPipelineUrl` which tests just pipeline URL
  *
  * @public exported from `@promptbook/utils`
  */

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

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@promptbook/browser",
-    "version": "0.104.0-9",
+    "version": "0.105.0-0",
     "description": "Promptbook: Turn your company's scattered knowledge into AI ready books",
     "private": false,
     "sideEffects": false,
@@ -94,7 +94,7 @@
     "module": "./esm/index.es.js",
     "typings": "./esm/typings/src/_packages/browser.index.d.ts",
     "peerDependencies": {
-        "@promptbook/core": "0.104.0-9"
+        "@promptbook/core": "0.105.0-0"
     },
     "dependencies": {
         "crypto": "1.0.1",

package/umd/index.umd.js

@@ -23,7 +23,7 @@
      * @generated
      * @see https://github.com/webgptorg/promptbook
      */
-    const PROMPTBOOK_ENGINE_VERSION = '0.104.0-9';
+    const PROMPTBOOK_ENGINE_VERSION = '0.105.0-0';
     /**
      * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
      * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -2212,9 +2212,10 @@
      *
      * Note: [🔂] This function is idempotent.
      * Note: Dataurl are considered perfectly valid.
-     * Note: There are two similar functions:
-     * - `isValidUrl` which tests any URL
-     * - `isValidPipelineUrl` *(this one)* which tests just promptbook URL
+     * Note: There are few similar functions:
+     * - `isValidUrl` *(this one)* which tests any URL
+     * - `isValidAgentUrl` which tests just agent URL
+     * - `isValidPipelineUrl` which tests just pipeline URL
      *
      * @public exported from `@promptbook/utils`
      */
@@ -2492,8 +2493,8 @@
      */
     function removeDiacritics(input) {
         /*eslint no-control-regex: "off"*/
-        return input.replace(/[^\u0000-\u007E]/g, (a) => {
-            return DIACRITIC_VARIANTS_LETTERS[a] || a;
+        return input.replace(/[^\u0000-\u007E]/g, (character) => {
+            return DIACRITIC_VARIANTS_LETTERS[character] || character;
         });
     }
     /**
@@ -2624,6 +2625,39 @@
      * Note: [💞] Ignore a discrepancy between file name and entity name
      */
 
+    /**
+     * Tests if given string is valid agent URL
+     *
+     * Note: There are few similar functions:
+     * - `isValidUrl` which tests any URL
+     * - `isValidAgentUrl` *(this one)* which tests just agent URL
+     * - `isValidPipelineUrl` which tests just pipeline URL
+     *
+     * @public exported from `@promptbook/utils`
+     */
+    function isValidAgentUrl(url) {
+        if (!isValidUrl(url)) {
+            return false;
+        }
+        if (!url.startsWith('https://') && !url.startsWith('http://') /* <- Note: [👣] */) {
+            return false;
+        }
+        if (url.includes('#')) {
+            // TODO: [🐠]
+            return false;
+        }
+        /*
+        Note: [👣][🧠] Is it secure to allow pipeline URLs on private and unsecured networks?
+        if (isUrlOnPrivateNetwork(url)) {
+            return false;
+        }
+        */
+        return true;
+    }
+    /**
+     * TODO: [🐠] Maybe more info why the URL is invalid
+     */
+
     /**
      * Normalizes agent name from arbitrary string to valid agent name
      *
@@ -2655,8 +2689,8 @@
      */
     function createCommitmentRegex(commitment, aliases = [], requiresContent = true) {
         const allCommitments = [commitment, ...aliases];
-        const patterns = allCommitments.map((c) => {
-            const escapedCommitment = c.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+        const patterns = allCommitments.map((commitment) => {
+            const escapedCommitment = commitment.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
             return escapedCommitment.split(/\s+/).join('\\s+');
         });
         const keywordPattern = patterns.join('|');
@@ -2678,8 +2712,8 @@
      */
     function createCommitmentTypeRegex(commitment, aliases = []) {
         const allCommitments = [commitment, ...aliases];
-        const patterns = allCommitments.map((c) => {
-            const escapedCommitment = c.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+        const patterns = allCommitments.map((commitment) => {
+            const escapedCommitment = commitment.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
             return escapedCommitment.split(/\s+/).join('\\s+');
         });
         const keywordPattern = patterns.join('|');
@@ -3189,9 +3223,7 @@
             // Get existing dictionary entries from metadata
             const existingDictionary = ((_a = requirements.metadata) === null || _a === void 0 ? void 0 : _a.DICTIONARY) || '';
             // Merge the new dictionary entry with existing entries
-            const mergedDictionary = existingDictionary
-                ? `${existingDictionary}\n${trimmedContent}`
-                : trimmedContent;
+            const mergedDictionary = existingDictionary ? `${existingDictionary}\n${trimmedContent}` : trimmedContent;
             // Store the merged dictionary in metadata for debugging and inspection
             const updatedMetadata = {
                 ...requirements.metadata,
@@ -3342,21 +3374,108 @@
         applyToAgentModelRequirements(requirements, content) {
             const trimmedContent = content.trim();
             if (!trimmedContent) {
-                return requirements;
+                return {
+                    ...requirements,
+                    parentAgentUrl: undefined,
+                };
             }
-            // Validate URL
-            try {
-                // eslint-disable-next-line @typescript-eslint/no-unused-vars
-                const url = new URL(trimmedContent);
-                // TODO: Add more validation if needed (e.g. check for valid protocol)
+            if (trimmedContent.toUpperCase() === 'VOID' ||
+                trimmedContent.toUpperCase() === 'NULL' ||
+                trimmedContent.toUpperCase() === 'NONE' ||
+                trimmedContent.toUpperCase() === 'NIL') {
+                return {
+                    ...requirements,
+                    parentAgentUrl: null,
+                };
             }
-            catch (error) {
-                console.warn(`Invalid URL in FROM commitment: ${trimmedContent}`);
+            if (!isValidAgentUrl(trimmedContent)) {
+                throw new Error(spaceTrim$1.spaceTrim((block) => `
+                        Invalid agent URL in FROM commitment: "${trimmedContent}"
+
+                        \`\`\`book
+                        ${block(content)}
+                        \`\`\`
+
+
+                `));
+            }
+            const parentAgentUrl = trimmedContent;
+            return {
+                ...requirements,
+                parentAgentUrl,
+            };
+        }
+    }
+    /**
+     * Note: [💞] Ignore a discrepancy between file name and entity name
+     */
+
+    /**
+     * IMPORT commitment definition
+     *
+     * The IMPORT commitment tells the agent to import content from another agent at the current location.
+     *
+     * Example usage in agent source:
+     *
+     * ```book
+     * IMPORT https://s6.ptbk.io/benjamin-white
+     * ```
+     *
+     * @private [🪔] Maybe export the commitments through some package
+     */
+    class ImportCommitmentDefinition extends BaseCommitmentDefinition {
+        constructor(type = 'IMPORT') {
+            super(type);
+        }
+        /**
+         * Short one-line description of IMPORT.
+         */
+        get description() {
+            return 'Import content from another agent.';
+        }
+        /**
+         * Icon for this commitment.
+         */
+        get icon() {
+            return '📥';
+        }
+        /**
+         * Markdown documentation for IMPORT commitment.
+         */
+        get documentation() {
+            return spaceTrim$1.spaceTrim(`
+            # ${this.type}
+
+            Imports content from another agent at the location of the commitment.
+
+            ## Examples
+
+            \`\`\`book
+            My AI Agent
+
+            IMPORT https://s6.ptbk.io/benjamin-white
+            RULE Speak only in English.
+            \`\`\`
+        `);
+        }
+        applyToAgentModelRequirements(requirements, content) {
+            const trimmedContent = content.trim();
+            if (!trimmedContent) {
                 return requirements;
             }
+            if (!isValidAgentUrl(trimmedContent)) {
+                throw new Error(spaceTrim$1.spaceTrim((block) => `
+                        Invalid agent URL in IMPORT commitment: "${trimmedContent}"
+
+                        \`\`\`book
+                        ${block(content)}
+                        \`\`\`
+                `));
+            }
+            const importedAgentUrl = trimmedContent;
             return {
                 ...requirements,
-                parentAgentUrl: trimmedContent,
+                importedAgentUrls: [...(requirements.importedAgentUrls || []), importedAgentUrl],
             };
         }
     }
@@ -5720,19 +5839,38 @@
         `);
         }
         applyToAgentModelRequirements(requirements, content) {
-            // We simply mark that browser capability is enabled in metadata
-            // Get existing metadata
-            const existingMetadata = requirements.metadata || {};
             // Get existing tools array or create new one
-            const existingTools = existingMetadata.tools || [];
-            // Add 'browser' to tools if not already present
-            const updatedTools = existingTools.includes('browser') ? existingTools : [...existingTools, 'browser'];
-            // Return requirements with updated metadata
+            const existingTools = requirements.tools || [];
+            // Add 'web_browser' to tools if not already present
+            const updatedTools = existingTools.some((tool) => tool.name === 'web_browser')
+                ? existingTools
+                : ([
+                    // TODO: [🔰] Use through proper MCP server
+                    ...existingTools,
+                    {
+                        name: 'web_browser',
+                        description: spaceTrim$1.spaceTrim(`
+                        A tool that can browse the web.
+                        Use this tool when you need to access specific websites or browse the internet.
+                    `),
+                        parameters: {
+                            type: 'object',
+                            properties: {
+                                url: {
+                                    type: 'string',
+                                    description: 'The URL to browse',
+                                },
+                            },
+                            required: ['url'],
+                        },
+                    },
+                ]);
+            // Return requirements with updated tools and metadata
             return {
                 ...requirements,
+                tools: updatedTools,
                 metadata: {
-                    ...existingMetadata,
-                    tools: updatedTools,
+                    ...requirements.metadata,
                     useBrowser: true,
                 },
             };
@@ -5825,13 +5963,13 @@
      * The `USE SEARCH ENGINE` commitment indicates that the agent should utilize a search engine tool
      * to access and retrieve up-to-date information from the internet when necessary.
      *
-     * The content following `USE SEARCH ENGINE` is ignored (similar to NOTE).
+     * The content following `USE SEARCH ENGINE` is an arbitrary text that the agent should know (e.g. search scope or instructions).
      *
      * Example usage in agent source:
      *
      * ```book
      * USE SEARCH ENGINE
-     * USE SEARCH ENGINE This will be ignored
+     * USE SEARCH ENGINE Hledej informace o Přemyslovcích
      * ```
      *
      * @private [🪔] Maybe export the commitments through some package
@@ -5863,7 +6001,7 @@
 
             ## Key aspects
 
-            - The content following \`USE SEARCH ENGINE\` is ignored (similar to NOTE)
+            - The content following \`USE SEARCH ENGINE\` is an arbitrary text that the agent should know (e.g. search scope or instructions).
             - The actual search engine tool usage is handled by the agent runtime
             - Allows the agent to search for current information from the web
             - Useful for research tasks, finding facts, and accessing dynamic content
@@ -5888,20 +6026,45 @@
         `);
         }
         applyToAgentModelRequirements(requirements, content) {
-            // We simply mark that search engine capability is enabled in metadata
-            // Get existing metadata
-            const existingMetadata = requirements.metadata || {};
             // Get existing tools array or create new one
-            const existingTools = existingMetadata.tools || [];
-            // Add 'search-engine' to tools if not already present
-            const updatedTools = existingTools.includes('search-engine') ? existingTools : [...existingTools, 'search-engine'];
-            // Return requirements with updated metadata
+            const existingTools = requirements.tools || [];
+            // Add 'web_search' to tools if not already present
+            const updatedTools = existingTools.some((tool) => tool.name === 'web_search')
+                ? existingTools
+                : [
+                    ...existingTools,
+                    { type: 'web_search' },
+                    // <- Note: [🔰] This is just using simple native search tool by OpenAI @see https://platform.openai.com/docs/guides/tools-web-search
+                    //          In future we will use proper MCP search tool:
+                    /*
+     
+                    {
+                        name: 'web_search',
+                        description: spaceTrim(`
+                          Search the internet for information.
+                          Use this tool when you need to find up-to-date information or facts that you don't know.
+                          ${!content ? '' : `Search scope / instructions: ${content}`}
+                      `),
+                        parameters: {
+                            type: 'object',
+                            properties: {
+                                query: {
+                                    type: 'string',
+                                    description: 'The search query',
+                                },
+                            },
+                            required: ['query'],
+                        },
+                    },
+                    */
+                ];
+            // Return requirements with updated tools and metadata
             return {
                 ...requirements,
+                tools: updatedTools,
                 metadata: {
-                    ...existingMetadata,
-                    tools: updatedTools,
-                    useSearchEngine: true,
+                    ...requirements.metadata,
+                    useSearchEngine: content || true,
                 },
             };
         }
@@ -6003,6 +6166,8 @@
         new FormatCommitmentDefinition('FORMAT'),
         new FormatCommitmentDefinition('FORMATS'),
         new FromCommitmentDefinition('FROM'),
+        new ImportCommitmentDefinition('IMPORT'),
+        new ImportCommitmentDefinition('IMPORTS'),
         new ModelCommitmentDefinition('MODEL'),
         new ModelCommitmentDefinition('MODELS'),
         new ActionCommitmentDefinition('ACTION'),
@@ -6262,8 +6427,8 @@
             return match;
         });
         // Remove duplicates based on name (keep the first occurrence)
-        const uniqueParameters = parameters.filter((param, index, array) => {
-            return array.findIndex((p) => p.name === param.name) === index;
+        const uniqueParameters = parameters.filter((parameter, index, array) => {
+            return array.findIndex((parameterItem) => parameterItem.name === parameter.name) === index;
         });
         return uniqueParameters;
     }
@@ -6305,7 +6470,57 @@
         }
         const meta = {};
         const links = [];
+        const capabilities = [];
         for (const commitment of parseResult.commitments) {
+            if (commitment.type === 'USE BROWSER') {
+                capabilities.push({
+                    type: 'browser',
+                    label: 'Browser',
+                    iconName: 'Globe',
+                });
+                continue;
+            }
+            if (commitment.type === 'USE SEARCH ENGINE') {
+                capabilities.push({
+                    type: 'search-engine',
+                    label: 'Search Internet',
+                    iconName: 'Search',
+                });
+                continue;
+            }
+            if (commitment.type === 'KNOWLEDGE') {
+                const content = spaceTrim__default["default"](commitment.content).split('\n')[0] || '';
+                let label = content;
+                let iconName = 'Book';
+                if (content.startsWith('http://') || content.startsWith('https://')) {
+                    try {
+                        const url = new URL(content);
+                        if (url.pathname.endsWith('.pdf')) {
+                            label = url.pathname.split('/').pop() || 'Document.pdf';
+                            iconName = 'FileText';
+                        }
+                        else {
+                            label = url.hostname.replace(/^www\./, '');
+                        }
+                    }
+                    catch (e) {
+                        // Invalid URL, treat as text
+                    }
+                }
+                else {
+                    // Text content - take first few words
+                    const words = content.split(/\s+/);
+                    if (words.length > 4) {
+                        label = words.slice(0, 4).join(' ') + '...';
+                    }
+                }
+                capabilities.push({
+                    type: 'knowledge',
+                    label,
+                    iconName,
+                });
+                continue;
+            }
             if (commitment.type === 'META LINK') {
                 const linkValue = spaceTrim__default["default"](commitment.content);
                 links.push(linkValue);
@@ -6316,6 +6531,10 @@
                 meta.image = spaceTrim__default["default"](commitment.content);
                 continue;
             }
+            if (commitment.type === 'META DESCRIPTION') {
+                meta.description = spaceTrim__default["default"](commitment.content);
+                continue;
+            }
             if (commitment.type === 'META COLOR') {
                 meta.color = normalizeSeparator(commitment.content);
                 continue;
@@ -6352,6 +6571,7 @@
             meta,
             links,
             parameters,
+            capabilities,
         };
     }
     /**