@promptbook/core 0.105.0-7 → 0.105.0-8

package/esm/index.es.js

@@ -27,7 +27,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
@@ -12098,6 +12098,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
  *
@@ -12174,18 +12214,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: {
@@ -12197,7 +12232,6 @@ class UseSearchEngineCommitmentDefinition extends BaseCommitmentDefinition {
                         required: ['query'],
                     },
                 },
-                */
             ];
         // Return requirements with updated tools and metadata
         return {
@@ -12209,6 +12243,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
@@ -18429,6 +18490,16 @@ function cacheLlmTools(llmTools, options = {}) {
                 }
             }
         }
+        if (shouldCache && promptResult.toolCalls !== undefined) {
+            // Note: Do not cache results that contain tool calls because they are dynamic and should be always fresh
+            //       For example, it doesn't make sense to cache the message 'What time is it? 3:30 pm' because when the question is asked another time, it can be a different time.
+            shouldCache = false;
+            if (isVerbose) {
+                console.info('Not caching result that contains tool calls for key:', key, {
+                    toolCalls: promptResult.toolCalls,
+                });
+            }
+        }
         if (shouldCache) {
             await storage.setItem(key, {
                 date: $getCurrentDate(),
@@ -21487,6 +21558,7 @@ _Agent_instances = new WeakSet(), _Agent_selfLearnNonce =
  */
 async function _Agent_selfLearnNonce() {
     await forTime(Math.random() * 5000);
+    // <- TODO: [🕓] `await forRandom(...)`
     console.info(colors.bgCyan('[Self-learning]') + colors.cyan(' Nonce'));
     const nonce = `NONCE ${await linguisticHash(Math.random().toString())}`;
     // Append to the current source