@promptbook/cli 0.104.0 → 0.105.0-0

package/README.md

@@ -27,6 +27,10 @@ Turn your company's scattered knowledge into AI ready Books
 
 
 
+<blockquote style="color: #ff8811">
+    <b>⚠ Warning:</b> This is a pre-release version of the library. It is not yet ready for production use. Please look at <a href="https://www.npmjs.com/package/@promptbook/core?activeTab=versions">latest stable release</a>.
+</blockquote>
+
 ## 📦 Package `@promptbook/cli`
 
 - Promptbooks are [divided into several](#-packages) packages, all are published from [single monorepo](https://github.com/webgptorg/promptbook).

package/esm/index.es.js

@@ -47,7 +47,7 @@ const BOOK_LANGUAGE_VERSION = '2.0.0';
  * @generated
  * @see https://github.com/webgptorg/promptbook
  */
-const PROMPTBOOK_ENGINE_VERSION = '0.104.0';
+const PROMPTBOOK_ENGINE_VERSION = '0.105.0-0';
 /**
  * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
  * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -3493,7 +3493,7 @@ const ALL_ERRORS = {
  *
  * @public exported from `@promptbook/utils`
  */
-function deserializeError(error) {
+function deserializeError(error, isStackAddedToMessage = true) {
     const { name, stack, id } = error; // Added id
     let { message } = error;
     let ErrorClass = ALL_ERRORS[error.name];
@@ -3501,7 +3501,7 @@ function deserializeError(error) {
         ErrorClass = Error;
         message = `${name}: ${message}`;
     }
-    if (stack !== undefined && stack !== '') {
+    if (isStackAddedToMessage && stack !== undefined && stack !== '') {
         message = spaceTrim$2((block) => `
                 ${block(message)}
 
@@ -4303,6 +4303,9 @@ function computeHash(value) {
  * @public exported from `@promptbook/utils`
  */
 function parseNumber(value) {
+    if (value === null || value === undefined) {
+        return 0;
+    }
     const originalValue = value;
     if (typeof value === 'number') {
         value = value.toString(); // <- TODO: Maybe more efficient way to do this
@@ -19495,83 +19498,180 @@ class OpenAiCompatibleExecutionTools {
                 content: msg.content,
             }));
         }
-        const rawRequest = {
-            ...modelSettings,
-            messages: [
-                ...(currentModelRequirements.systemMessage === undefined
-                    ? []
-                    : [
-                        {
-                            role: 'system',
-                            content: currentModelRequirements.systemMessage,
-                        },
-                    ]),
-                ...threadMessages,
-                {
-                    role: 'user',
-                    content: rawPromptContent,
-                },
-            ],
-            user: (_a = this.options.userId) === null || _a === void 0 ? void 0 : _a.toString(),
-            tools: currentModelRequirements.tools === undefined
-                ? undefined
-                : mapToolsToOpenAi(currentModelRequirements.tools),
+        const messages = [
+            ...(currentModelRequirements.systemMessage === undefined
+                ? []
+                : [
+                    {
+                        role: 'system',
+                        content: currentModelRequirements.systemMessage,
+                    },
+                ]),
+            ...threadMessages,
+            {
+                role: 'user',
+                content: rawPromptContent,
+            },
+        ];
+        let totalUsage = {
+            price: uncertainNumber(0),
+            input: {
+                tokensCount: uncertainNumber(0),
+                charactersCount: uncertainNumber(0),
+                wordsCount: uncertainNumber(0),
+                sentencesCount: uncertainNumber(0),
+                linesCount: uncertainNumber(0),
+                paragraphsCount: uncertainNumber(0),
+                pagesCount: uncertainNumber(0),
+            },
+            output: {
+                tokensCount: uncertainNumber(0),
+                charactersCount: uncertainNumber(0),
+                wordsCount: uncertainNumber(0),
+                sentencesCount: uncertainNumber(0),
+                linesCount: uncertainNumber(0),
+                paragraphsCount: uncertainNumber(0),
+                pagesCount: uncertainNumber(0),
+            },
         };
+        const toolCalls = [];
         const start = $getCurrentDate();
-        if (this.options.isVerbose) {
-            console.info(colors.bgWhite('rawRequest'), JSON.stringify(rawRequest, null, 4));
-        }
-        try {
-            const rawResponse = await this.limiter
-                .schedule(() => this.makeRequestWithNetworkRetry(() => client.chat.completions.create(rawRequest)))
-                .catch((error) => {
-                assertsError(error);
-                if (this.options.isVerbose) {
-                    console.info(colors.bgRed('error'), error);
-                }
-                throw error;
-            });
+        const tools = 'tools' in prompt && Array.isArray(prompt.tools) ? prompt.tools : currentModelRequirements.tools;
+        let isLooping = true;
+        while (isLooping) {
+            const rawRequest = {
+                ...modelSettings,
+                messages,
+                user: (_a = this.options.userId) === null || _a === void 0 ? void 0 : _a.toString(),
+                tools: tools === undefined ? undefined : mapToolsToOpenAi(tools),
+            };
             if (this.options.isVerbose) {
-                console.info(colors.bgWhite('rawResponse'), JSON.stringify(rawResponse, null, 4));
-            }
-            const complete = $getCurrentDate();
-            if (!rawResponse.choices[0]) {
-                throw new PipelineExecutionError(`No choises from ${this.title}`);
-            }
-            if (rawResponse.choices.length > 1) {
-                // TODO: This should be maybe only warning
-                throw new PipelineExecutionError(`More than one choise from ${this.title}`);
-            }
-            const resultContent = rawResponse.choices[0].message.content;
-            const usage = this.computeUsage(content || '', resultContent || '', rawResponse);
-            if (resultContent === null) {
-                throw new PipelineExecutionError(`No response message from ${this.title}`);
+                console.info(colors.bgWhite('rawRequest'), JSON.stringify(rawRequest, null, 4));
             }
-            return exportJson({
-                name: 'promptResult',
-                message: `Result of \`OpenAiCompatibleExecutionTools.callChatModel\``,
-                order: [],
-                value: {
-                    content: resultContent,
-                    modelName: rawResponse.model || modelName,
-                    timing: {
-                        start,
-                        complete,
+            try {
+                const rawResponse = await this.limiter
+                    .schedule(() => this.makeRequestWithNetworkRetry(() => client.chat.completions.create(rawRequest)))
+                    .catch((error) => {
+                    assertsError(error);
+                    if (this.options.isVerbose) {
+                        console.info(colors.bgRed('error'), error);
+                    }
+                    throw error;
+                });
+                if (this.options.isVerbose) {
+                    console.info(colors.bgWhite('rawResponse'), JSON.stringify(rawResponse, null, 4));
+                }
+                if (!rawResponse.choices[0]) {
+                    throw new PipelineExecutionError(`No choises from ${this.title}`);
+                }
+                const responseMessage = rawResponse.choices[0].message;
+                messages.push(responseMessage);
+                const usage = this.computeUsage(content || '', responseMessage.content || '', rawResponse);
+                totalUsage = addUsage(totalUsage, usage);
+                if (responseMessage.tool_calls && responseMessage.tool_calls.length > 0) {
+                    await forEachAsync(responseMessage.tool_calls, {}, async (toolCall) => {
+                        const functionName = toolCall.function.name;
+                        const functionArgs = toolCall.function.arguments;
+                        const executionTools = this.options
+                            .executionTools;
+                        if (!executionTools || !executionTools.script) {
+                            throw new PipelineExecutionError(`Model requested tool '${functionName}' but no executionTools.script were provided in OpenAiCompatibleExecutionTools options`);
+                        }
+                        // TODO: [DRY] Use some common tool caller
+                        const scriptTools = Array.isArray(executionTools.script)
+                            ? executionTools.script
+                            : [executionTools.script];
+                        let functionResponse;
+                        try {
+                            const scriptTool = scriptTools[0]; // <- TODO: [🧠] Which script tool to use?
+                            functionResponse = await scriptTool.execute({
+                                scriptLanguage: 'javascript',
+                                script: `
+                                    const args = ${functionArgs};
+                                    return await ${functionName}(args);
+                                `,
+                                parameters: {}, // <- TODO: [🧠] What parameters to pass?
+                            });
+                        }
+                        catch (error) {
+                            assertsError(error);
+                            functionResponse = `Error: ${error.message}`;
+                        }
+                        messages.push({
+                            role: 'tool',
+                            tool_call_id: toolCall.id,
+                            content: functionResponse,
+                        });
+                        toolCalls.push({
+                            name: functionName,
+                            arguments: functionArgs,
+                            result: functionResponse,
+                            rawToolCall: toolCall,
+                        });
+                    });
+                    continue;
+                }
+                const complete = $getCurrentDate();
+                const resultContent = responseMessage.content;
+                if (resultContent === null) {
+                    throw new PipelineExecutionError(`No response message from ${this.title}`);
+                }
+                isLooping = false;
+                return exportJson({
+                    name: 'promptResult',
+                    message: `Result of \`OpenAiCompatibleExecutionTools.callChatModel\``,
+                    order: [],
+                    value: {
+                        content: resultContent,
+                        modelName: rawResponse.model || modelName,
+                        timing: {
+                            start,
+                            complete,
+                        },
+                        usage: totalUsage,
+                        toolCalls,
+                        rawPromptContent,
+                        rawRequest,
+                        rawResponse,
                     },
-                    usage,
-                    rawPromptContent,
-                    rawRequest,
-                    rawResponse,
-                    // <- [🗯]
-                },
-            });
-        }
-        catch (error) {
-            assertsError(error);
-            // Check if this is an unsupported parameter error
-            if (!isUnsupportedParameterError(error)) {
-                // If we have attemptStack, include it in the error message
-                if (attemptStack.length > 0) {
+                });
+            }
+            catch (error) {
+                isLooping = false;
+                assertsError(error);
+                // Check if this is an unsupported parameter error
+                if (!isUnsupportedParameterError(error)) {
+                    // If we have attemptStack, include it in the error message
+                    if (attemptStack.length > 0) {
+                        throw new PipelineExecutionError(`All attempts failed. Attempt history:\n` +
+                            attemptStack
+                                .map((a, i) => `  ${i + 1}. Model: ${a.modelName}` +
+                                (a.unsupportedParameter ? `, Stripped: ${a.unsupportedParameter}` : '') +
+                                `, Error: ${a.errorMessage}` +
+                                (a.stripped ? ' (stripped and retried)' : ''))
+                                .join('\n') +
+                            `\nFinal error: ${error.message}`);
+                    }
+                    throw error;
+                }
+                // Parse which parameter is unsupported
+                const unsupportedParameter = parseUnsupportedParameterError(error.message);
+                if (!unsupportedParameter) {
+                    if (this.options.isVerbose) {
+                        console.warn(colors.bgYellow('Warning'), 'Could not parse unsupported parameter from error:', error.message);
+                    }
+                    throw error;
+                }
+                // Create a unique key for this model + parameter combination to prevent infinite loops
+                const retryKey = `${modelName}-${unsupportedParameter}`;
+                if (retriedUnsupportedParameters.has(retryKey)) {
+                    // Already retried this parameter, throw the error with attemptStack
+                    attemptStack.push({
+                        modelName,
+                        unsupportedParameter,
+                        errorMessage: error.message,
+                        stripped: true,
+                    });
                     throw new PipelineExecutionError(`All attempts failed. Attempt history:\n` +
                         attemptStack
                             .map((a, i) => `  ${i + 1}. Model: ${a.modelName}` +
@@ -19581,52 +19681,25 @@ class OpenAiCompatibleExecutionTools {
                             .join('\n') +
                         `\nFinal error: ${error.message}`);
                 }
-                throw error;
-            }
-            // Parse which parameter is unsupported
-            const unsupportedParameter = parseUnsupportedParameterError(error.message);
-            if (!unsupportedParameter) {
+                // Mark this parameter as retried
+                retriedUnsupportedParameters.add(retryKey);
+                // Log warning in verbose mode
                 if (this.options.isVerbose) {
-                    console.warn(colors.bgYellow('Warning'), 'Could not parse unsupported parameter from error:', error.message);
+                    console.warn(colors.bgYellow('Warning'), `Removing unsupported parameter '${unsupportedParameter}' for model '${modelName}' and retrying request`);
                 }
-                throw error;
-            }
-            // Create a unique key for this model + parameter combination to prevent infinite loops
-            const retryKey = `${modelName}-${unsupportedParameter}`;
-            if (retriedUnsupportedParameters.has(retryKey)) {
-                // Already retried this parameter, throw the error with attemptStack
+                // Add to attemptStack
                 attemptStack.push({
                     modelName,
                     unsupportedParameter,
                     errorMessage: error.message,
                     stripped: true,
                 });
-                throw new PipelineExecutionError(`All attempts failed. Attempt history:\n` +
-                    attemptStack
-                        .map((a, i) => `  ${i + 1}. Model: ${a.modelName}` +
-                        (a.unsupportedParameter ? `, Stripped: ${a.unsupportedParameter}` : '') +
-                        `, Error: ${a.errorMessage}` +
-                        (a.stripped ? ' (stripped and retried)' : ''))
-                        .join('\n') +
-                    `\nFinal error: ${error.message}`);
-            }
-            // Mark this parameter as retried
-            retriedUnsupportedParameters.add(retryKey);
-            // Log warning in verbose mode
-            if (this.options.isVerbose) {
-                console.warn(colors.bgYellow('Warning'), `Removing unsupported parameter '${unsupportedParameter}' for model '${modelName}' and retrying request`);
+                // Remove the unsupported parameter and retry
+                const modifiedModelRequirements = removeUnsupportedModelRequirement(currentModelRequirements, unsupportedParameter);
+                return this.callChatModelWithRetry(prompt, modifiedModelRequirements, attemptStack, retriedUnsupportedParameters);
             }
-            // Add to attemptStack
-            attemptStack.push({
-                modelName,
-                unsupportedParameter,
-                errorMessage: error.message,
-                stripped: true,
-            });
-            // Remove the unsupported parameter and retry
-            const modifiedModelRequirements = removeUnsupportedModelRequirement(currentModelRequirements, unsupportedParameter);
-            return this.callChatModelWithRetry(prompt, modifiedModelRequirements, attemptStack, retriedUnsupportedParameters);
         }
+        throw new PipelineExecutionError(`Tool calling loop did not return a result from ${this.title}`);
     }
     /**
      * Calls OpenAI API to use a complete model.
@@ -23419,6 +23492,79 @@ class FromCommitmentDefinition extends BaseCommitmentDefinition {
  * 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(`
+            # ${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((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
  *
@@ -25780,7 +25926,7 @@ class UseBrowserCommitmentDefinition extends BaseCommitmentDefinition {
         // Add 'web_browser' to tools if not already present
         const updatedTools = existingTools.some((tool) => tool.name === 'web_browser')
             ? existingTools
-            : [
+            : ([
                 // TODO: [🔰] Use through proper MCP server
                 ...existingTools,
                 {
@@ -25800,7 +25946,7 @@ class UseBrowserCommitmentDefinition extends BaseCommitmentDefinition {
                         required: ['url'],
                     },
                 },
-            ];
+            ]);
         // Return requirements with updated tools and metadata
         return {
             ...requirements,
@@ -26102,6 +26248,8 @@ const COMMITMENT_REGISTRY = [
     new FormatCommitmentDefinition('FORMAT'),
     new FormatCommitmentDefinition('FORMATS'),
     new FromCommitmentDefinition('FROM'),
+    new ImportCommitmentDefinition('IMPORT'),
+    new ImportCommitmentDefinition('IMPORTS'),
     new ModelCommitmentDefinition('MODEL'),
     new ModelCommitmentDefinition('MODELS'),
     new ActionCommitmentDefinition('ACTION'),