@promptbook/browser 0.105.0-1 → 0.105.0-3

package/umd/index.umd.js

@@ -23,7 +23,7 @@
      * @generated
      * @see https://github.com/webgptorg/promptbook
      */
-    const PROMPTBOOK_ENGINE_VERSION = '0.105.0-1';
+    const PROMPTBOOK_ENGINE_VERSION = '0.105.0-3';
     /**
      * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
      * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -1075,6 +1075,7 @@
         SEPARATOR: Color.fromHex('#cccccc'),
         COMMITMENT: Color.fromHex('#DA0F78'),
         PARAMETER: Color.fromHex('#8e44ad'),
+        CODE_BLOCK: Color.fromHex('#7700ffff'),
     });
     // <- TODO: [🧠][🈵] Using `Color` here increases the package size approx 3kb, maybe remove it
     /**
@@ -2795,6 +2796,14 @@
                 return this.appendToSystemMessage(requirements, commentSection);
             }
         }
+        /**
+         * Gets tool function implementations provided by this commitment
+         *
+         * When the `applyToAgentModelRequirements` adds tools to the requirements, this method should return the corresponding function definitions.
+         */
+        getToolFunctions() {
+            return {};
+        }
     }
 
     /**
@@ -3410,79 +3419,6 @@
      * 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,
-                importedAgentUrls: [...(requirements.importedAgentUrls || []), importedAgentUrl],
-            };
-        }
-    }
-    /**
-     * Note: [💞] Ignore a discrepancy between file name and entity name
-     */
-
     /**
      * GOAL commitment definition
      *
@@ -3583,6 +3519,87 @@
      * 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 or a generic text file.';
+        }
+        /**
+         * 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 or a generic text file at the location of the commitment.
+
+            ## Examples
+
+            \`\`\`book
+            My AI Agent
+
+            IMPORT https://s6.ptbk.io/benjamin-white
+            IMPORT https://example.com/some-text-file.txt
+            IMPORT ./path/to/local-file.json
+            RULE Speak only in English.
+            \`\`\`
+        `);
+        }
+        applyToAgentModelRequirements(requirements, content) {
+            const trimmedContent = content.trim();
+            if (!trimmedContent) {
+                return requirements;
+            }
+            if (isValidAgentUrl(trimmedContent)) {
+                const importedAgentUrl = trimmedContent;
+                return {
+                    ...requirements,
+                    importedAgentUrls: [...(requirements.importedAgentUrls || []), importedAgentUrl],
+                };
+            }
+            if (isValidUrl(trimmedContent) || isValidFilePath(trimmedContent)) {
+                return {
+                    ...requirements,
+                    importedFileUrls: [...(requirements.importedFileUrls || []), trimmedContent],
+                };
+            }
+            throw new Error(spaceTrim$1.spaceTrim((block) => `
+                    Invalid agent URL or file path in IMPORT commitment: "${trimmedContent}"
+
+                    \`\`\`book
+                    ${block(content)}
+                    \`\`\`
+            `));
+        }
+    }
+    /**
+     * Note: [💞] Ignore a discrepancy between file name and entity name
+     */
+
     /**
      * KNOWLEDGE commitment definition
      *
@@ -4002,7 +4019,13 @@
         `);
         }
         applyToAgentModelRequirements(requirements, content) {
-            return requirements;
+            // INITIAL MESSAGE is for UI display purposes and for conversation history construction.
+            const newSample = { question: null, answer: content };
+            const newSamples = [...(requirements.samples || []), newSample];
+            return {
+                ...requirements,
+                samples: newSamples,
+            };
         }
     }
 
@@ -5034,27 +5057,16 @@
         `);
         }
         applyToAgentModelRequirements(requirements, content) {
-            var _a;
             // The NOTE commitment makes no changes to the system message or model requirements
             // It only stores the note content in metadata for documentation purposes
-            const trimmedContent = content.trim();
-            if (!trimmedContent) {
+            const trimmedContent = spaceTrim$1.spaceTrim(content);
+            if (trimmedContent === '') {
                 return requirements;
             }
-            // Get existing note content from metadata
-            const existingNoteContent = ((_a = requirements.metadata) === null || _a === void 0 ? void 0 : _a.NOTE) || '';
-            // Merge the new content with existing note content
-            // When multiple NOTE commitments exist, they are aggregated together
-            const mergedNoteContent = existingNoteContent ? `${existingNoteContent}\n${trimmedContent}` : trimmedContent;
-            // Store the merged note content in metadata for debugging and inspection
-            const updatedMetadata = {
-                ...requirements.metadata,
-                NOTE: mergedNoteContent,
-            };
-            // Return requirements with updated metadata but no changes to system message
+            // Return requirements with updated notes but no changes to system message
             return {
                 ...requirements,
-                metadata: updatedMetadata,
+                notes: [...(requirements.notes || []), trimmedContent],
             };
         }
     }
@@ -6073,6 +6085,104 @@
      * Note: [💞] Ignore a discrepancy between file name and entity name
      */
 
+    /**
+     * USE TIME commitment definition
+     *
+     * The `USE TIME` commitment indicates that the agent should be able to determine the current date and time.
+     *
+     * Example usage in agent source:
+     *
+     * ```book
+     * USE TIME
+     * ```
+     *
+     * @private [🪔] Maybe export the commitments through some package
+     */
+    class UseTimeCommitmentDefinition extends BaseCommitmentDefinition {
+        constructor() {
+            super('USE TIME', ['CURRENT TIME', 'TIME', 'DATE']);
+        }
+        /**
+         * Short one-line description of USE TIME.
+         */
+        get description() {
+            return 'Enable the agent to determine the current date and time.';
+        }
+        /**
+         * Icon for this commitment.
+         */
+        get icon() {
+            return '🕒';
+        }
+        /**
+         * Markdown documentation for USE TIME commitment.
+         */
+        get documentation() {
+            return spaceTrim$1.spaceTrim(`
+            # USE TIME
+
+            Enables the agent to determine the current date and time.
+
+            ## Key aspects
+
+            - This tool won't receive any input.
+            - It outputs the current date and time as an ISO 8601 string.
+            - Allows the agent to answer questions about the current time or date.
+
+            ## Examples
+
+            \`\`\`book
+            Time-aware Assistant
+
+            PERSONA You are a helpful assistant who knows the current time.
+            USE TIME
+            \`\`\`
+        `);
+        }
+        applyToAgentModelRequirements(requirements, content) {
+            // Get existing tools array or create new one
+            const existingTools = requirements.tools || [];
+            // Add 'get_current_time' to tools if not already present
+            const updatedTools = existingTools.some((tool) => tool.name === 'get_current_time')
+                ? existingTools
+                : [
+                    ...existingTools,
+                    {
+                        name: 'get_current_time',
+                        description: 'Get the current date and time in ISO 8601 format.',
+                        parameters: {
+                            type: 'object',
+                            properties: {},
+                            required: [],
+                        },
+                    },
+                    // <- TODO: !!!! define the function in LLM tools
+                ];
+            // Return requirements with updated tools and metadata
+            return {
+                ...requirements,
+                tools: updatedTools,
+                metadata: {
+                    ...requirements.metadata,
+                },
+            };
+        }
+        /**
+         * Gets the `get_current_time` tool function implementation.
+         */
+        getToolFunctions() {
+            return {
+                async get_current_time() {
+                    console.log('!!!! [Tool] get_current_time called');
+                    return new Date().toISOString();
+                },
+            };
+        }
+    }
+    /**
+     * Note: [💞] Ignore a discrepancy between file name and entity name
+     */
+
     /**
      * Placeholder commitment definition for commitments that are not yet implemented
      *
@@ -6140,7 +6250,6 @@
         }
     }
 
-    // Import all commitment definition classes
     /**
      * Registry of all available commitment definitions
      * This array contains instances of all commitment definitions
@@ -6157,10 +6266,10 @@
         new MemoryCommitmentDefinition('MEMORIES'),
         new StyleCommitmentDefinition('STYLE'),
         new StyleCommitmentDefinition('STYLES'),
-        new RuleCommitmentDefinition('RULE'),
         new RuleCommitmentDefinition('RULES'),
-        new LanguageCommitmentDefinition('LANGUAGE'),
+        new RuleCommitmentDefinition('RULE'),
         new LanguageCommitmentDefinition('LANGUAGES'),
+        new LanguageCommitmentDefinition('LANGUAGE'),
         new SampleCommitmentDefinition('SAMPLE'),
         new SampleCommitmentDefinition('EXAMPLE'),
         new FormatCommitmentDefinition('FORMAT'),
@@ -6200,6 +6309,7 @@
         new ClosedCommitmentDefinition(),
         new UseBrowserCommitmentDefinition(),
         new UseSearchEngineCommitmentDefinition(),
+        new UseTimeCommitmentDefinition(),
         new UseMcpCommitmentDefinition(),
         new UseCommitmentDefinition(),
         // Not yet implemented commitments (using placeholder)
@@ -6293,11 +6403,37 @@
         let currentCommitment = null;
         // Process lines starting from after the agent name line
         const startIndex = agentNameLineIndex >= 0 ? agentNameLineIndex + 1 : 0;
+        let isInsideCodeBlock = false;
         for (let i = startIndex; i < lines.length; i++) {
             const line = lines[i];
             if (line === undefined) {
                 continue;
             }
+            const trimmedLine = line.trim();
+            // Check if this line starts or ends a code block
+            if (trimmedLine.startsWith('```')) {
+                isInsideCodeBlock = !isInsideCodeBlock;
+                if (currentCommitment) {
+                    // If we are inside a commitment, the code block is part of it
+                    currentCommitment.contentLines.push(line);
+                }
+                else {
+                    // If we are not inside a commitment, the code block is non-commitment
+                    nonCommitmentLines.push(line);
+                }
+                continue;
+            }
+            if (isInsideCodeBlock) {
+                if (currentCommitment) {
+                    // If we are inside a commitment and a code block, the line is part of the commitment
+                    currentCommitment.contentLines.push(line);
+                }
+                else {
+                    // If we are inside a code block but not a commitment, the line is non-commitment
+                    nonCommitmentLines.push(line);
+                }
+                continue;
+            }
             // Check if this line starts a new commitment
             let foundNewCommitment = false;
             for (const definition of COMMITMENT_REGISTRY) {
@@ -6471,7 +6607,24 @@
         const meta = {};
         const links = [];
         const capabilities = [];
+        const samples = [];
+        let pendingUserMessage = null;
         for (const commitment of parseResult.commitments) {
+            if (commitment.type === 'INITIAL MESSAGE') {
+                samples.push({ question: null, answer: commitment.content });
+                continue;
+            }
+            if (commitment.type === 'USER MESSAGE') {
+                pendingUserMessage = commitment.content;
+                continue;
+            }
+            if (commitment.type === 'AGENT MESSAGE') {
+                if (pendingUserMessage !== null) {
+                    samples.push({ question: pendingUserMessage, answer: commitment.content });
+                    pendingUserMessage = null;
+                }
+                continue;
+            }
             if (commitment.type === 'USE BROWSER') {
                 capabilities.push({
                     type: 'browser',
@@ -6488,6 +6641,37 @@
                 });
                 continue;
             }
+            if (commitment.type === 'USE TIME') {
+                capabilities.push({
+                    type: 'time',
+                    label: 'Time',
+                    iconName: 'Clock',
+                });
+                continue;
+            }
+            if (commitment.type === 'IMPORT') {
+                const content = spaceTrim__default["default"](commitment.content).split('\n')[0] || '';
+                let label = content;
+                const iconName = 'Download';
+                try {
+                    if (content.startsWith('http://') || content.startsWith('https://')) {
+                        const url = new URL(content);
+                        label = url.hostname.replace(/^www\./, '') + '.../' + url.pathname.split('/').pop();
+                    }
+                    else if (content.startsWith('./') || content.startsWith('../') || content.startsWith('/')) {
+                        label = content.split('/').pop() || content;
+                    }
+                }
+                catch (e) {
+                    // Invalid URL or path, keep default label
+                }
+                capabilities.push({
+                    type: 'knowledge',
+                    label,
+                    iconName,
+                });
+                continue;
+            }
             if (commitment.type === 'KNOWLEDGE') {
                 const content = spaceTrim__default["default"](commitment.content).split('\n')[0] || '';
                 let label = content;
@@ -6572,6 +6756,7 @@
             links,
             parameters,
             capabilities,
+            samples,
         };
     }
     /**