@promptbook/javascript 0.105.0-7 → 0.105.0-8

package/esm/index.es.js

@@ -18,7 +18,7 @@ const BOOK_LANGUAGE_VERSION = '2.0.0';
  * @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
@@ -5634,6 +5634,46 @@ class UseMcpCommitmentDefinition extends BaseCommitmentDefinition {
  * 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
  *
@@ -5710,18 +5750,13 @@ class UseSearchEngineCommitmentDefinition extends BaseCommitmentDefinition {
             ? 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(`
+                        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: {
@@ -5733,7 +5768,6 @@ class UseSearchEngineCommitmentDefinition extends BaseCommitmentDefinition {
                         required: ['query'],
                     },
                 },
-                */
             ];
         // Return requirements with updated tools and metadata
         return {
@@ -5745,6 +5779,33 @@ class UseSearchEngineCommitmentDefinition extends BaseCommitmentDefinition {
             },
         };
     }
+    /**
+     * 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((block) => `
+                        Search results for "${query}":
+
+                        ${block(results
+                    .map((result) => spaceTrim$1(`
+                                            - **${result.title}**
+                                              ${result.url}
+                                              ${result.snippet}
+                                        `))
+                    .join('\n\n'))}
+                    `);
+            },
+        };
+    }
 }
 /**
  * Note: [💞] Ignore a discrepancy between file name and entity name