@promptbook/node 0.111.0-0 → 0.111.0-1

package/esm/typings/src/book-components/Chat/hooks/useChatActionsOverlap.d.ts

@@ -17,6 +17,12 @@ export type ChatActionsOverlapConfig = {
      * Selector used to locate message elements for overlap checks.
      */
     messageSelector: string;
+    /**
+     * Optional selector for the actual message content region used for overlap checks.
+     *
+     * When not provided or when no matching element is found, the full message element is used.
+     */
+    messageCollisionSelector?: string;
     /**
      * Messages used to trigger overlap recalculation.
      */

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

@@ -1,12 +1,10 @@
-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 IMAGE GENERATOR commitment definition
  *
- * The `USE IMAGE GENERATOR` commitment indicates that the agent should utilize an image generation tool
- * to create images based on text prompts.
+ * The `USE IMAGE GENERATOR` commitment indicates that the agent can output
+ * markdown placeholders for UI-driven image generation.
  *
  * Example usage in agent source:
  *
@@ -19,6 +17,7 @@ import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
  */
 export declare class UseImageGeneratorCommitmentDefinition extends BaseCommitmentDefinition<'USE IMAGE GENERATOR' | 'USE IMAGE GENERATION' | 'IMAGE GENERATOR' | 'IMAGE GENERATION' | 'USE IMAGE'> {
     constructor(type?: 'USE IMAGE GENERATOR' | 'USE IMAGE GENERATION' | 'IMAGE GENERATOR' | 'IMAGE GENERATION' | 'USE IMAGE');
+    get requiresContent(): boolean;
     /**
      * Short one-line description of USE IMAGE GENERATOR.
      */
@@ -32,14 +31,6 @@ export declare class UseImageGeneratorCommitmentDefinition extends BaseCommitmen
      */
     get documentation(): string;
     applyToAgentModelRequirements(requirements: AgentModelRequirements, content: string): AgentModelRequirements;
-    /**
-     * Gets human-readable titles for tool functions provided by this commitment.
-     */
-    getToolTitles(): Record<string_javascript_name, string>;
-    /**
-     * Gets the `generate_image` tool function implementation.
-     */
-    getToolFunctions(): Record<string_javascript_name, ToolFunction>;
 }
 /**
  * Note: [💞] Ignore a discrepancy between file name and entity name

package/esm/typings/src/utils/knowledge/simplifyKnowledgeLabel.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Simplifies knowledge labels for UI chips by:
+ * - extracting filename from URL/path-like values,
+ * - removing extension,
+ * - removing trailing random ID segment when detected,
+ * - truncating to 20 characters with ellipsis.
+ *
+ * @param label - Raw knowledge label or source value.
+ * @returns Display-friendly chip label.
+ * @private utility of knowledge/source chip rendering
+ */
+export declare function simplifyKnowledgeLabel(label: string): string;
+/**
+ * Heuristic that classifies a short text as human-readable, identifier-like, or unknown.
+ *
+ * @param text - Candidate value (typically a filename segment).
+ * @returns `'HUMAN'`, `'ID'`, or `'UNKNOWN'`.
+ * @private utility of knowledge/source chip rendering
+ */
+export declare function isHumanOrID(text: string): 'HUMAN' | 'ID' | 'UNKNOWN';

package/esm/typings/src/utils/knowledge/simplifyKnowledgeLabel.test.d.ts

@@ -0,0 +1 @@
+export {};

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

package/package.json

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

package/umd/index.umd.js

@@ -48,7 +48,7 @@
      * @generated
      * @see https://github.com/webgptorg/promptbook
      */
-    const PROMPTBOOK_ENGINE_VERSION = '0.111.0-0';
+    const PROMPTBOOK_ENGINE_VERSION = '0.111.0-1';
     /**
      * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
      * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -18371,8 +18371,8 @@
     /**
      * USE IMAGE GENERATOR commitment definition
      *
-     * The `USE IMAGE GENERATOR` commitment indicates that the agent should utilize an image generation tool
-     * to create images based on text prompts.
+     * The `USE IMAGE GENERATOR` commitment indicates that the agent can output
+     * markdown placeholders for UI-driven image generation.
      *
      * Example usage in agent source:
      *
@@ -18387,11 +18387,14 @@
         constructor(type = 'USE IMAGE GENERATOR') {
             super(type, ['USE IMAGE GENERATION', 'IMAGE GENERATOR', 'IMAGE GENERATION', 'USE IMAGE']);
         }
+        get requiresContent() {
+            return false;
+        }
         /**
          * Short one-line description of USE IMAGE GENERATOR.
          */
         get description() {
-            return 'Enable the agent to use an image generation tool for creating images from text prompts.';
+            return 'Enable the agent to output markdown image placeholders that the UI turns into generated images.';
         }
         /**
          * Icon for this commitment.
@@ -18406,21 +18409,21 @@
             return spaceTrim$1.spaceTrim(`
             # USE IMAGE GENERATOR
 
-            Enables the agent to use an image generation tool to create images based on text prompts.
+            Enables the agent to output markdown image placeholders that trigger image generation in the user interface.
 
             ## Key aspects
 
             - The content following \`USE IMAGE GENERATOR\` is an arbitrary text that the agent should know (e.g. style instructions or safety guidelines).
-            - The actual image generation is handled by the agent runtime using LLM execution tools.
-            - Allows the agent to generate visual content based on user requests.
-            - Returns the URL of the generated image.
+            - The agent does **not** call an image-generation tool directly.
+            - The agent inserts markdown notation: \`![alt](?image-prompt=...)\`.
+            - The user interface detects the notation and generates the image asynchronously.
 
             ## Examples
 
             \`\`\`book
             Visual Artist
 
-            PERSONA You are a creative visual artist who can generate images.
+            PERSONA You are a creative visual artist.
             USE IMAGE GENERATOR
             RULE Always describe the generated image to the user.
             \`\`\`
@@ -18430,80 +18433,28 @@
 
             PERSONA You are an interior designer who helps users visualize their space.
             USE IMAGE GENERATOR Professional interior design renders.
-            ACTION Generate a preview of the designed room.
+            ACTION Add one generated image placeholder whenever a user asks for a visual.
             \`\`\`
         `);
         }
         applyToAgentModelRequirements(requirements, content) {
-            // Get existing tools array or create new one
-            const existingTools = requirements.tools || [];
-            // Add 'generate_image' to tools if not already present
-            const updatedTools = existingTools.some((tool) => tool.name === 'generate_image')
-                ? existingTools
-                : [
-                    ...existingTools,
-                    {
-                        name: 'generate_image',
-                        description: spaceTrim$1.spaceTrim(`
-                        Generate an image from a text prompt.
-                        Use this tool when the user asks to create, draw, or generate an image.
-                        ${!content ? '' : `Style instructions / guidelines: ${content}`}
-                    `),
-                        parameters: {
-                            type: 'object',
-                            properties: {
-                                prompt: {
-                                    type: 'string',
-                                    description: 'The detailed description of the image to generate',
-                                },
-                            },
-                            required: ['prompt'],
-                        },
-                    },
-                ];
-            // Return requirements with updated tools and metadata
+            const extraInstructions = formatOptionalInstructionBlock('Image instructions', content);
             return this.appendToSystemMessage({
                 ...requirements,
-                tools: updatedTools,
                 _metadata: {
                     ...requirements._metadata,
                     useImageGenerator: content || true,
                 },
-            }, spaceTrim$1.spaceTrim(`
-                You have access to an image generator. Use it to create images based on user requests.
-                When you generate an image, you will receive a URL of the generated image.
-            `));
-        }
-        /**
-         * Gets human-readable titles for tool functions provided by this commitment.
-         */
-        getToolTitles() {
-            return {
-                generate_image: 'Generate image',
-            };
-        }
-        /**
-         * Gets the `generate_image` tool function implementation.
-         */
-        getToolFunctions() {
-            return {
-                async generate_image(args, ...extra) {
-                    console.log('!!!! [Tool] generate_image called', { args });
-                    const { prompt } = args;
-                    if (!prompt) {
-                        throw new Error('Image prompt is required');
-                    }
-                    const { llmTools } = extra[0] || {};
-                    if (!llmTools || !llmTools.callImageGenerationModel) {
-                        throw new Error('Image generation is not supported by the current model provider');
-                    }
-                    const result = await llmTools.callImageGenerationModel({
-                        content: prompt,
-                        modelName: 'dall-e-3', // Defaulting to dall-e-3, but this could be configurable
-                    });
-                    return result.content;
-                },
-            };
+            }, spaceTrim$1.spaceTrim((block) => `
+                    Image generation:
+                    - You do not generate images directly and you do not call any image tool.
+                    - When the user asks for an image, include markdown notation in your message:
+                      \`![<alt text>](?image-prompt=<prompt>)\`
+                    - Keep \`<alt text>\` short and descriptive.
+                    - Keep \`<prompt>\` detailed so the generated image matches the request.
+                    - You can include normal explanatory text before and after the notation.
+                    ${block(extraInstructions)}
+                `));
         }
     }
     /**