@promptbook/core 0.111.0-0 → 0.111.0-2

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

@@ -0,0 +1,17 @@
+import 'leaflet/dist/leaflet.css';
+import type { GeoJsonObject } from 'geojson';
+/**
+ * Props for `<ChatMessageMap/>`.
+ *
+ * @private internal helper of `<ChatMessageItem/>`
+ */
+type ChatMessageMapProps = {
+    data: GeoJsonObject;
+};
+/**
+ * Renders a Leaflet map for GeoJSON data inside the chat bubble.
+ *
+ * @private internal helper of `<ChatMessageItem/>`
+ */
+export declare function ChatMessageMap({ data }: ChatMessageMapProps): import("react/jsx-runtime").JSX.Element;
+export {};

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/book-components/Chat/utils/citationHelpers.d.ts

@@ -0,0 +1,38 @@
+import { ChatParticipant } from '../types/ChatParticipant';
+import type { ParsedCitation } from './parseCitationsFromContent';
+/**
+ * Returns whether the provided value is a valid HTTP(S) URL.
+ *
+ * @param value - Candidate string to inspect.
+ * @returns True when the value parses as an HTTP or HTTPS URL.
+ * @private utility of `<Chat/>` citation rendering
+ */
+export declare function isCitationUrl(value: string): boolean;
+/**
+ * Determines whether a citation should be displayed as a text snippet instead of a file/URL.
+ *
+ * @param citation - Parsed citation metadata.
+ * @returns True when the citation looks like inline text instead of a document or URL.
+ * @private utility of `<Chat/>` citation rendering
+ */
+export declare function isPlainTextCitation(citation: ParsedCitation): boolean;
+/**
+ * Builds a label that matches the desired chip/modal title for a citation.
+ *
+ * @param citation - Parsed citation metadata.
+ * @returns The friendly label shown on chips and modal headers.
+ * @private utility of `<Chat/>` citation rendering
+ */
+export declare function getCitationLabel(citation: ParsedCitation): string;
+/**
+ * Resolves the preview URL used inside the citation modal iframe.
+ *
+ * @param citation - Parsed citation metadata.
+ * @param participants - Known chat participants for agent knowledge lookup.
+ * @returns URL string suitable for iframe preview or null when unavailable.
+ * @private utility of `<Chat/>` citation rendering
+ */
+export declare function resolveCitationPreviewUrl(citation: ParsedCitation, participants: ReadonlyArray<ChatParticipant>): string | null;
+/**
+ * TODO: [💞] Spread into multiple files
+ */ 

package/esm/typings/src/book-components/Chat/utils/citationHelpers.test.d.ts

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

package/esm/typings/src/book-components/Chat/utils/splitMessageContentIntoSegments.d.ts

@@ -0,0 +1,41 @@
+import type { GeoJsonObject } from 'geojson';
+import type { ImagePromptSegment } from './parseImagePrompts';
+/**
+ * Segment that represents plain markdown text inside a chat message.
+ */
+/**
+ * Segment that represents plain markdown text inside a chat message.
+ *
+ * @private internal helper of `<ChatMessageItem/>`
+ */
+export type ChatTextSegment = {
+    type: 'text';
+    content: string;
+};
+/**
+ * Segment that represents a Leaflet-ready map rendered from GeoJSON data.
+ */
+/**
+ * Segment that represents a Leaflet-ready map rendered from GeoJSON data.
+ *
+ * @private internal helper of `<ChatMessageItem/>`
+ */
+export type ChatMapSegment = {
+    type: 'map';
+    data: GeoJsonObject;
+};
+/**
+ * Composite segment type that covers text, image prompts, and map features.
+ */
+/**
+ * Composite segment type that covers text, image prompts, and map features.
+ *
+ * @private internal helper of `<ChatMessageItem/>`
+ */
+export type ChatMessageContentSegment = ImagePromptSegment | ChatTextSegment | ChatMapSegment;
+/**
+ * Splits chat message content into markdown, image prompt, and map segments while preserving their order.
+ *
+ * @private internal helper of `<ChatMessageItem/>`
+ */
+export declare function splitMessageContentIntoSegments(content: string): ReadonlyArray<ChatMessageContentSegment>;

package/esm/typings/src/book-components/Chat/utils/splitMessageContentIntoSegments.test.d.ts

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

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-1`).
  *
  * @generated
  */

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@promptbook/core",
-    "version": "0.111.0-0",
+    "version": "0.111.0-2",
     "description": "Promptbook: Turn your company's scattered knowledge into AI ready books",
     "private": false,
     "sideEffects": false,

package/umd/index.umd.js

@@ -28,7 +28,7 @@
      * @generated
      * @see https://github.com/webgptorg/promptbook
      */
-    const PROMPTBOOK_ENGINE_VERSION = '0.111.0-0';
+    const PROMPTBOOK_ENGINE_VERSION = '0.111.0-2';
     /**
      * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
      * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -14734,8 +14734,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:
      *
@@ -14750,11 +14750,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.
@@ -14769,21 +14772,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.
             \`\`\`
@@ -14793,80 +14796,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)}
+                `));
         }
     }
     /**
@@ -26946,7 +26897,6 @@
                         doneReading = !!done;
                         if (value) {
                             const textChunk = decoder.decode(value, { stream: true });
-                            let sawToolCalls = false;
                             let hasNonEmptyText = false;
                             const textLines = [];
                             const lines = textChunk.split(/\r?\n/);
@@ -26972,7 +26922,6 @@
                                                 rawResponse: {},
                                                 toolCalls: getActiveToolCalls(),
                                             });
-                                            sawToolCalls = true;
                                             isToolCallLine = true;
                                         }
                                     }
@@ -26982,22 +26931,16 @@
                                 }
                                 if (!isToolCallLine) {
                                     textLines.push(line);
-                                    if (line.length > 0) {
+                                    if (trimmedLine.length > 0) {
                                         hasNonEmptyText = true;
                                     }
                                 }
                             }
-                            if (sawToolCalls) {
-                                if (!hasNonEmptyText) {
-                                    continue;
-                                }
-                                const textChunkWithoutToolCalls = textLines.join('\n');
-                                content += textChunkWithoutToolCalls;
-                            }
-                            else {
-                                // console.debug('RemoteAgent chunk:', textChunk);
-                                content += textChunk;
+                            if (!hasNonEmptyText) {
+                                continue;
                             }
+                            const textChunkWithoutToolCalls = textLines.join('\n');
+                            content += textChunkWithoutToolCalls;
                             if (!hasReceivedModelOutput && content.trim().length > 0) {
                                 hasReceivedModelOutput = true;
                                 preparationToolCalls.length = 0;