@promptbook/node 0.105.0-6 → 0.105.0-8

package/esm/typings/src/commitments/NOTE/NOTE.d.ts

@@ -26,8 +26,8 @@ import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
  *
  * @private [🪔] Maybe export the commitments through some package
  */
-export declare class NoteCommitmentDefinition extends BaseCommitmentDefinition<'NOTE' | 'NOTES' | 'COMMENT' | 'NONCE'> {
-    constructor(type?: 'NOTE' | 'NOTES' | 'COMMENT' | 'NONCE');
+export declare class NoteCommitmentDefinition extends BaseCommitmentDefinition<'NOTE' | 'NOTES' | 'COMMENT' | 'NONCE' | 'TODO'> {
+    constructor(type?: 'NOTE' | 'NOTES' | 'COMMENT' | 'NONCE' | 'TODO');
     /**
      * Short one-line description of NOTE.
      */

package/esm/typings/src/commitments/USE_SEARCH_ENGINE/USE_SEARCH_ENGINE.d.ts

@@ -1,4 +1,6 @@
+import { string_javascript_name } from '../../_packages/types.index';
 import type { AgentModelRequirements } from '../../book-2.0/agent-source/AgentModelRequirements';
+import { ToolFunction } from '../../scripting/javascript/JavascriptExecutionToolsOptions';
 import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
 /**
  * USE SEARCH ENGINE commitment definition
@@ -32,6 +34,10 @@ export declare class UseSearchEngineCommitmentDefinition extends BaseCommitmentD
      */
     get documentation(): string;
     applyToAgentModelRequirements(requirements: AgentModelRequirements, content: string): AgentModelRequirements;
+    /**
+     * Gets the `web_search` tool function implementation.
+     */
+    getToolFunctions(): Record<string_javascript_name, ToolFunction>;
 }
 /**
  * Note: [💞] Ignore a discrepancy between file name and entity name

package/esm/typings/src/commitments/index.d.ts

@@ -44,7 +44,7 @@ import { NotYetImplementedCommitmentDefinition } from './_base/NotYetImplemented
  *
  * @private Use functions to access commitments instead of this array directly
  */
-export declare const COMMITMENT_REGISTRY: readonly [PersonaCommitmentDefinition, PersonaCommitmentDefinition, KnowledgeCommitmentDefinition, MemoryCommitmentDefinition, MemoryCommitmentDefinition, StyleCommitmentDefinition, StyleCommitmentDefinition, RuleCommitmentDefinition, RuleCommitmentDefinition, LanguageCommitmentDefinition, LanguageCommitmentDefinition, SampleCommitmentDefinition, SampleCommitmentDefinition, FormatCommitmentDefinition, FormatCommitmentDefinition, FromCommitmentDefinition, ImportCommitmentDefinition, ImportCommitmentDefinition, ModelCommitmentDefinition, ModelCommitmentDefinition, ActionCommitmentDefinition, ActionCommitmentDefinition, ComponentCommitmentDefinition, MetaImageCommitmentDefinition, MetaColorCommitmentDefinition, MetaFontCommitmentDefinition, MetaLinkCommitmentDefinition, MetaCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, GoalCommitmentDefinition, GoalCommitmentDefinition, InitialMessageCommitmentDefinition, UserMessageCommitmentDefinition, AgentMessageCommitmentDefinition, MessageCommitmentDefinition, MessageCommitmentDefinition, ScenarioCommitmentDefinition, ScenarioCommitmentDefinition, DeleteCommitmentDefinition, DeleteCommitmentDefinition, DeleteCommitmentDefinition, DeleteCommitmentDefinition, DictionaryCommitmentDefinition, OpenCommitmentDefinition, ClosedCommitmentDefinition, UseBrowserCommitmentDefinition, UseSearchEngineCommitmentDefinition, UseTimeCommitmentDefinition, UseMcpCommitmentDefinition, UseCommitmentDefinition, NotYetImplementedCommitmentDefinition<"EXPECT">, NotYetImplementedCommitmentDefinition<"BEHAVIOUR">, NotYetImplementedCommitmentDefinition<"BEHAVIOURS">, NotYetImplementedCommitmentDefinition<"AVOID">, NotYetImplementedCommitmentDefinition<"AVOIDANCE">, NotYetImplementedCommitmentDefinition<"CONTEXT">];
+export declare const COMMITMENT_REGISTRY: readonly [PersonaCommitmentDefinition, PersonaCommitmentDefinition, KnowledgeCommitmentDefinition, MemoryCommitmentDefinition, MemoryCommitmentDefinition, StyleCommitmentDefinition, StyleCommitmentDefinition, RuleCommitmentDefinition, RuleCommitmentDefinition, LanguageCommitmentDefinition, LanguageCommitmentDefinition, SampleCommitmentDefinition, SampleCommitmentDefinition, FormatCommitmentDefinition, FormatCommitmentDefinition, FromCommitmentDefinition, ImportCommitmentDefinition, ImportCommitmentDefinition, ModelCommitmentDefinition, ModelCommitmentDefinition, ActionCommitmentDefinition, ActionCommitmentDefinition, ComponentCommitmentDefinition, MetaImageCommitmentDefinition, MetaColorCommitmentDefinition, MetaFontCommitmentDefinition, MetaLinkCommitmentDefinition, MetaCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, GoalCommitmentDefinition, GoalCommitmentDefinition, InitialMessageCommitmentDefinition, UserMessageCommitmentDefinition, AgentMessageCommitmentDefinition, MessageCommitmentDefinition, MessageCommitmentDefinition, ScenarioCommitmentDefinition, ScenarioCommitmentDefinition, DeleteCommitmentDefinition, DeleteCommitmentDefinition, DeleteCommitmentDefinition, DeleteCommitmentDefinition, DictionaryCommitmentDefinition, OpenCommitmentDefinition, ClosedCommitmentDefinition, UseBrowserCommitmentDefinition, UseSearchEngineCommitmentDefinition, UseTimeCommitmentDefinition, UseMcpCommitmentDefinition, UseCommitmentDefinition, NotYetImplementedCommitmentDefinition<"EXPECT">, NotYetImplementedCommitmentDefinition<"BEHAVIOUR">, NotYetImplementedCommitmentDefinition<"BEHAVIOURS">, NotYetImplementedCommitmentDefinition<"AVOID">, NotYetImplementedCommitmentDefinition<"AVOIDANCE">, NotYetImplementedCommitmentDefinition<"CONTEXT">];
 /**
  * Gets a commitment definition by its type
  * @param type The commitment type to look up

package/esm/typings/src/llm-providers/agent/Agent.d.ts

@@ -72,6 +72,7 @@ export declare class Agent extends AgentLlmExecutionTools implements LlmExecutio
      */
     get parameters(): Array<BookParameter>;
     readonly agentSource: BehaviorSubject<string_book>;
+    private readonly teacherAgent;
     constructor(options: AgentOptions);
     /**
      * Calls the chat model with agent-specific system prompt and requirements with streaming

package/esm/typings/src/llm-providers/agent/AgentOptions.d.ts

@@ -2,6 +2,7 @@ import type { string_book } from '../../book-2.0/agent-source/string_book';
 import type { CommonToolsOptions } from '../../execution/CommonToolsOptions';
 import type { ExecutionTools } from '../../execution/ExecutionTools';
 import type { Updatable } from '../../types/Updatable';
+import { Agent } from './Agent';
 /**
  * Options for creating an Agent
  */
@@ -16,4 +17,10 @@ export type AgentOptions = CommonToolsOptions & {
      * The source of the agent
      */
     agentSource: Updatable<string_book>;
+    /**
+     * Teacher agent for self-learning
+     *
+     * Note: If provided, the agent can do full self-learning from the teacher agent during its operation.
+     */
+    teacherAgent: Agent | null;
 };

package/esm/typings/src/llm-providers/agent/RemoteAgentOptions.d.ts

@@ -3,7 +3,7 @@ import type { string_agent_url } from '../../types/typeAliases';
 /**
  * Options for creating a Remote Agent
  */
-export type RemoteAgentOptions = CommonToolsOptions & {
+export type RemoteAgentOptions = Omit<CommonToolsOptions, 'teacherAgent'> & {
     /**
      * Url of the remote agent
      */

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

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@promptbook/node",
-    "version": "0.105.0-6",
+    "version": "0.105.0-8",
     "description": "Promptbook: Turn your company's scattered knowledge into AI ready books",
     "private": false,
     "sideEffects": false,
@@ -93,7 +93,7 @@
     "module": "./esm/index.es.js",
     "typings": "./esm/typings/src/_packages/node.index.d.ts",
     "peerDependencies": {
-        "@promptbook/core": "0.105.0-6"
+        "@promptbook/core": "0.105.0-8"
     },
     "dependencies": {
         "colors": "1.4.0",

package/umd/index.umd.js

@@ -45,7 +45,7 @@
      * @generated
      * @see https://github.com/webgptorg/promptbook
      */
-    const PROMPTBOOK_ENGINE_VERSION = '0.105.0-6';
+    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
@@ -11847,6 +11847,16 @@
             trimmedText = spaceTrim$1.spaceTrim(trimmedText);
         }
         let processedText = trimmedText;
+        // Check for markdown code block
+        const codeBlockRegex = /^```[a-z]*\n([\s\S]*?)\n```\s*$/;
+        const codeBlockMatch = processedText.match(codeBlockRegex);
+        if (codeBlockMatch && codeBlockMatch[1] !== undefined) {
+            // Check if there's only one code block
+            const codeBlockCount = (processedText.match(/```/g) || []).length / 2;
+            if (codeBlockCount === 1) {
+                return unwrapResult(codeBlockMatch[1], { isTrimmed: false, isIntroduceSentenceRemoved: false });
+            }
+        }
         if (isIntroduceSentenceRemoved) {
             const introduceSentenceRegex = /^[a-zěščřžýáíéúů:\s]*:\s*/i;
             if (introduceSentenceRegex.test(text)) {
@@ -11854,6 +11864,14 @@
                 processedText = processedText.replace(introduceSentenceRegex, '');
             }
             processedText = spaceTrim$1.spaceTrim(processedText);
+            // Check again for code block after removing introduce sentence
+            const codeBlockMatch2 = processedText.match(codeBlockRegex);
+            if (codeBlockMatch2 && codeBlockMatch2[1] !== undefined) {
+                const codeBlockCount = (processedText.match(/```/g) || []).length / 2;
+                if (codeBlockCount === 1) {
+                    return unwrapResult(codeBlockMatch2[1], { isTrimmed: false, isIntroduceSentenceRemoved: false });
+                }
+            }
         }
         if (processedText.length < 3) {
             return trimmedText;
@@ -15253,6 +15271,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
      *
@@ -15329,18 +15387,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: {
@@ -15352,7 +15405,6 @@
                             required: ['query'],
                         },
                     },
-                    */
                 ];
             // Return requirements with updated tools and metadata
             return {
@@ -15364,6 +15416,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
@@ -15607,6 +15686,7 @@
         new NoteCommitmentDefinition('NOTES'),
         new NoteCommitmentDefinition('COMMENT'),
         new NoteCommitmentDefinition('NONCE'),
+        new NoteCommitmentDefinition('TODO'),
         new GoalCommitmentDefinition('GOAL'),
         new GoalCommitmentDefinition('GOALS'),
         new InitialMessageCommitmentDefinition(),