@promptbook/javascript 0.105.0-7 → 0.105.0-8

package/umd/index.umd.js

@@ -22,7 +22,7 @@
      * @generated
      * @see https://github.com/webgptorg/promptbook
      */
-    const PROMPTBOOK_ENGINE_VERSION = '0.105.0-7';
+    const PROMPTBOOK_ENGINE_VERSION = '0.105.0-8';
     /**
      * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
      * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -5638,6 +5638,46 @@
      * Note: [💞] Ignore a discrepancy between file name and entity name
      */
 
+    /**
+     * A search engine implementation that uses the SerpApi to fetch Google search results.
+     *
+     * @private <- TODO: !!!! Export via some package
+     */
+    class SerpSearchEngine {
+        get title() {
+            return 'SerpApi Search Engine';
+        }
+        get description() {
+            return 'Search engine that uses SerpApi to fetch Google search results';
+        }
+        checkConfiguration() {
+            if (!process.env.SERP_API_KEY) {
+                throw new Error('SERP_API_KEY is not configured');
+            }
+        }
+        async search(query) {
+            const apiKey = process.env.SERP_API_KEY;
+            if (!apiKey) {
+                throw new Error('SERP_API_KEY is not configured');
+            }
+            const url = new URL('https://serpapi.com/search');
+            url.searchParams.set('q', query);
+            url.searchParams.set('api_key', apiKey);
+            url.searchParams.set('engine', 'google');
+            const response = await fetch(url.toString());
+            if (!response.ok) {
+                const body = await response.text();
+                throw new Error(`SerpApi failed with status ${response.status}: ${response.statusText}\n${body}`);
+            }
+            const data = (await response.json());
+            return (data.organic_results || []).map((item) => ({
+                title: item.title,
+                url: item.link,
+                snippet: item.snippet || '',
+            }));
+        }
+    }
+
     /**
      * USE SEARCH ENGINE commitment definition
      *
@@ -5714,18 +5754,13 @@
                 ? 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}`}
-                      `),
+                        description: spaceTrim$1.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: {
@@ -5737,7 +5772,6 @@
                             required: ['query'],
                         },
                     },
-                    */
                 ];
             // Return requirements with updated tools and metadata
             return {
@@ -5749,6 +5783,33 @@
                 },
             };
         }
+        /**
+         * Gets the `web_search` tool function implementation.
+         */
+        getToolFunctions() {
+            return {
+                async web_search(args) {
+                    console.log('!!!! [Tool] web_search called', { args });
+                    const { query } = args;
+                    if (!query) {
+                        throw new Error('Search query is required');
+                    }
+                    const searchEngine = new SerpSearchEngine();
+                    const results = await searchEngine.search(query);
+                    return spaceTrim$1.spaceTrim((block) => `
+                        Search results for "${query}":
+
+                        ${block(results
+                    .map((result) => spaceTrim$1.spaceTrim(`
+                                            - **${result.title}**
+                                              ${result.url}
+                                              ${result.snippet}
+                                        `))
+                    .join('\n\n'))}
+                    `);
+                },
+            };
+        }
     }
     /**
      * Note: [💞] Ignore a discrepancy between file name and entity name