@promptbook/components 0.103.0-45 → 0.103.0-47

package/esm/index.es.js

@@ -8,6 +8,7 @@ import { Registration } from 'destroyable';
 import hljs from 'highlight.js';
 import katex from 'katex';
 import { Converter } from 'showdown';
+import { BehaviorSubject } from 'rxjs';
 import { forTime } from 'waitasecond';
 import QRCode from 'qrcode';
 
@@ -25,7 +26,7 @@ const BOOK_LANGUAGE_VERSION = '2.0.0';
  * @generated
  * @see https://github.com/webgptorg/promptbook
  */
-const PROMPTBOOK_ENGINE_VERSION = '0.103.0-45';
+const PROMPTBOOK_ENGINE_VERSION = '0.103.0-47';
 /**
  * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
  * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -666,6 +667,36 @@ class GoalCommitmentDefinition extends BaseCommitmentDefinition {
  * Note: [💞] Ignore a discrepancy between file name and entity name
  */
 
+/**
+ * Tests if given string is valid URL.
+ *
+ * Note: [🔂] This function is idempotent.
+ * Note: Dataurl are considered perfectly valid.
+ * Note: There are two similar functions:
+ * - `isValidUrl` which tests any URL
+ * - `isValidPipelineUrl` *(this one)* which tests just promptbook URL
+ *
+ * @public exported from `@promptbook/utils`
+ */
+function isValidUrl(url) {
+    if (typeof url !== 'string') {
+        return false;
+    }
+    try {
+        if (url.startsWith('blob:')) {
+            url = url.replace(/^blob:/, '');
+        }
+        const urlObject = new URL(url /* because fail is handled */);
+        if (!['http:', 'https:', 'data:'].includes(urlObject.protocol)) {
+            return false;
+        }
+        return true;
+    }
+    catch (error) {
+        return false;
+    }
+}
+
 /**
  * KNOWLEDGE commitment definition
  *
@@ -739,23 +770,19 @@ class KnowledgeCommitmentDefinition extends BaseCommitmentDefinition {
         `);
     }
     applyToAgentModelRequirements(requirements, content) {
-        var _a;
         const trimmedContent = content.trim();
         if (!trimmedContent) {
             return requirements;
         }
         // Check if content is a URL (external knowledge source)
-        if (this.isUrl(trimmedContent)) {
+        if (isValidUrl(trimmedContent)) {
             // Store the URL for later async processing
             const updatedRequirements = {
                 ...requirements,
-                metadata: {
-                    ...requirements.metadata,
-                    knowledgeSources: [
-                        ...(((_a = requirements.metadata) === null || _a === void 0 ? void 0 : _a.knowledgeSources) || []),
-                        trimmedContent,
-                    ],
-                },
+                knowledgeSources: [
+                    ...(requirements.knowledgeSources || []),
+                    trimmedContent,
+                ],
             };
             // Add placeholder information about knowledge sources to system message
             const knowledgeInfo = `Knowledge Source URL: ${trimmedContent} (will be processed for retrieval during chat)`;
@@ -767,18 +794,6 @@ class KnowledgeCommitmentDefinition extends BaseCommitmentDefinition {
             return this.appendToSystemMessage(requirements, knowledgeSection, '\n\n');
         }
     }
-    /**
-     * Check if content is a URL
-     */
-    isUrl(content) {
-        try {
-            new URL(content);
-            return true;
-        }
-        catch (_a) {
-            return false;
-        }
-    }
 }
 /**
  * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -2323,6 +2338,8 @@ const PADDING_LINES = 11;
 /**
  * A function that adds padding to the book content
  *
+ * Note: [🔂] This function is idempotent.
+ *
  * @public exported from `@promptbook/core`
  */
 function padBook(content) {
@@ -2368,6 +2385,8 @@ function isValidBook(value) {
  * This function should be used when you have a string that you know represents agent source
  * but need to convert it to the branded type for type safety
  *
+ * Note: [🔂] This function is idempotent.
+ *
  * @public exported from `@promptbook/core`
  */
 function validateBook(source) {
@@ -2399,15 +2418,20 @@ const DEFAULT_BOOK = padBook(validateBook(spaceTrim$1(`
  */
 const REMOTE_SERVER_URLS = [
     {
-        title: 'Promptbook',
-        description: `Servers of Promptbook.studio`,
+        title: 'Promptbook.Studio',
+        description: `Server of Promptbook.studio`,
         owner: 'AI Web, LLC <legal@ptbk.io> (https://www.ptbk.io/)',
-        isAnonymousModeAllowed: true,
         urls: [
             'https://promptbook.s5.ptbk.io/',
             // Note: Servers 1-4 are not running
         ],
     },
+    {
+        title: 'Testing Agents',
+        description: `Testing Agents server on Vercel`,
+        owner: 'AI Web, LLC <legal@ptbk.io> (https://www.ptbk.io/)',
+        urls: ['https://s6.ptbk.io/'],
+    },
     /*
     Note: Working on older version of Promptbook and not supported anymore
     {
@@ -2652,9 +2676,6 @@ function checkChannelValue(channelName, value) {
         throw new Error(`${channelName} channel is greater than 255, it is ${value}`);
     }
 }
-/**
- * TODO: [🧠][🚓] Is/which combination it better to use asserts/check, validate or is utility function?
- */
 
 /**
  * Color object represents an RGB color with alpha channel
@@ -3502,36 +3523,6 @@ function isValidFilePath(filename) {
  * TODO: [🍏] Implement for MacOs
  */
 
-/**
- * Tests if given string is valid URL.
- *
- * Note: [🔂] This function is idempotent.
- * Note: Dataurl are considered perfectly valid.
- * Note: There are two similar functions:
- * - `isValidUrl` which tests any URL
- * - `isValidPipelineUrl` *(this one)* which tests just promptbook URL
- *
- * @public exported from `@promptbook/utils`
- */
-function isValidUrl(url) {
-    if (typeof url !== 'string') {
-        return false;
-    }
-    try {
-        if (url.startsWith('blob:')) {
-            url = url.replace(/^blob:/, '');
-        }
-        const urlObject = new URL(url /* because fail is handled */);
-        if (!['http:', 'https:', 'data:'].includes(urlObject.protocol)) {
-            return false;
-        }
-        return true;
-    }
-    catch (error) {
-        return false;
-    }
-}
-
 const defaultDiacriticsRemovalMap = [
     {
         base: 'A',
@@ -4504,8 +4495,7 @@ function aboutPromptbookInformation(options) {
 
                 ## Servers
 
-                ${block(REMOTE_SERVER_URLS.map(({ title, urls, isAnonymousModeAllowed, description }, index) => `${index + 1}. ${title} ${description}
-                        ${isAnonymousModeAllowed ? '🐱‍💻 ' : ''} ${urls.join(', ')}
+                ${block(REMOTE_SERVER_URLS.map(({ title, urls, description }, index) => `${index + 1}. ${title} ${description} ${urls.join(', ')}
                     `).join('\n'))}
             `);
         fullInfoPieces.push(serversInfo);
@@ -4925,7 +4915,7 @@ function BookEditorMonaco(props) {
             const uploadResults = await Promise.all(uploadPromises);
             // Note: This is a simplified implementation. A more robust solution would
             // determine the drop position in the editor and insert the text there.
-            const newText = uploadResults.map((fileSrc) => `KNOWLEDGE { ${fileSrc} }`).join('\n');
+            const newText = uploadResults.map((fileSrc) => `KNOWLEDGE ${fileSrc}`).join('\n');
             const currentValue = value || '';
             const newValue = currentValue + '\n' + newText;
             onChange === null || onChange === void 0 ? void 0 : onChange(newValue);
@@ -5085,6 +5075,38 @@ function AvatarProfileFromSource(props) {
     return jsx(AvatarProfile, { ...rest, agent: agent, agentSource: agentSource });
 }
 
+/**
+ * Restricts an Updatable to a (2) BehaviorSubject variant
+ *
+ * @see Updatable
+ * @private internal utility <- TODO: [🧠] Maybe export from `@promptbook/types`
+ */
+function asUpdatableSubject(value) {
+    if (value instanceof BehaviorSubject) {
+        return value;
+    }
+    else if (Array.isArray(value)) {
+        if (value.length !== 2) {
+            throw new TypeError('`asUpdatableSubject`: Invalid tuple length, expected 2 elements');
+        }
+        if (typeof value[1] !== 'function') {
+            throw new TypeError('`asUpdatableSubject`: Invalid tuple, expected second element to be a function');
+        }
+        const [theValue, setValue] = value;
+        const subject = new BehaviorSubject(theValue);
+        subject.subscribe((newValue) => {
+            setValue(newValue);
+        });
+        return subject;
+    }
+    else {
+        return new BehaviorSubject(value);
+    }
+}
+/**
+ * TODO: [🧠] Maybe `BehaviorSubject` is too heavy for this use case, maybe just tuple `[value,setValue]` is enough
+ */
+
 /**
  * Calculates distance between two colors
  *
@@ -6544,53 +6566,6 @@ function Chat(props) {
                             placeholder: "Add a note (optional)", defaultValue: textRating, onChange: (e) => setTextRating(e.target.value), className: chatStyles.ratingInput }), jsxs("div", { className: chatStyles.ratingActions, children: [jsx("button", { onClick: () => setRatingModalOpen(false), children: "Cancel" }), jsx("button", { onClick: submitRating, children: "Submit" })] })] }) }))] }));
 }
 
-/**
- * Hook to create a sendMessage function for an <LlmChat/> component WITHOUT needing any React Context.
- *
- * Usage pattern:
- * ```tsx
- * const sendMessage = useSendMessageToLlmChat();
- * return (
- *   <>
- *     <button onClick={() => sendMessage('Hello!')}>Hello</button>
- *     <LlmChat llmTools={llmTools} sendMessage={sendMessage} />
- *   </>
- * );
- * ```
- *
- * - No provider wrapping needed.
- * - Safe to call before the <LlmChat/> mounts (messages will be queued).
- * - Keeps DRY by letting <LlmChat/> reuse its internal `handleMessage` logic.
- *
- * @public exported from `@promptbook/components`
- */
-function useSendMessageToLlmChat() {
-    const ref = useRef(null);
-    if (!ref.current) {
-        let handler = null;
-        const queue = [];
-        const sendMessage = (message) => {
-            if (handler) {
-                // Fire and forget
-                void handler(message);
-            }
-            else {
-                queue.push(message);
-            }
-        };
-        sendMessage._attach = (attachedHandler) => {
-            handler = attachedHandler;
-            // Flush queued messages
-            while (queue.length > 0) {
-                const next = queue.shift();
-                void handler(next);
-            }
-        };
-        ref.current = sendMessage;
-    }
-    return ref.current;
-}
-
 /**
  * Utility functions for persisting chat conversations in localStorage
  *
@@ -6844,6 +6819,96 @@ function LlmChat(props) {
     return (jsx(Chat, { ...restProps, messages, onReset, tasksProgress, participants, onMessage: handleMessage, onReset: handleReset }));
 }
 
+/**
+ * AgentChat component that provides chat functionality with LLM integration
+ *
+ * This component internally manages messages, participants, and task progress,
+ * and uses the provided LLM tools to generate responses via `LlmExecutionTools.callChatModel`.
+ *
+ * Note: There are multiple chat components:
+ * - `<Chat/>` renders chat as it is without any logic
+ * - `<AgentChat/>` connected to LLM Execution Tools of Promptbook
+ *
+ * @public exported from `@promptbook/components`
+ */
+function AgentChat(props) {
+    const { agent, title, persistenceKey, onChange, sendMessage, ...restProps } = props;
+    return (jsx(LlmChat, { title: title || `Chat with ${agent.agentName || 'Agent'}`, persistenceKey: persistenceKey || `agent-chat-${agent.agentName || '!!!!!remove'}`, userParticipantName: "USER", llmParticipantName: "AGENT" // <- TODO: [🧠] Maybe dynamic agent id
+        , initialMessages: [
+            {
+                from: 'AGENT',
+                content: spaceTrim$1(`
+                                
+                        Hello! I am ${agent.agentName || 'an AI Agent'}.
+                        
+                        [Hello](?message=Hello, can you tell me about yourself?)
+                    `),
+            },
+        ], participants: [
+            {
+                name: 'AGENT',
+                fullname: agent.agentName || 'Agent',
+                avatarSrc: agent.meta.image,
+                color: agent.meta.color,
+                isMe: false,
+                agentSource: asUpdatableSubject(agent.agentSource).getValue() /* <- TODO: !!!!! asValue */,
+            },
+            {
+                name: 'USER',
+                fullname: 'User',
+                color: '#115EB6',
+                isMe: true,
+            },
+        ], llmTools: agent, onChange, sendMessage, ...restProps }));
+}
+
+/**
+ * Hook to create a sendMessage function for an <LlmChat/> component WITHOUT needing any React Context.
+ *
+ * Usage pattern:
+ * ```tsx
+ * const sendMessage = useSendMessageToLlmChat();
+ * return (
+ *   <>
+ *     <button onClick={() => sendMessage('Hello!')}>Hello</button>
+ *     <LlmChat llmTools={llmTools} sendMessage={sendMessage} />
+ *   </>
+ * );
+ * ```
+ *
+ * - No provider wrapping needed.
+ * - Safe to call before the <LlmChat/> mounts (messages will be queued).
+ * - Keeps DRY by letting <LlmChat/> reuse its internal `handleMessage` logic.
+ *
+ * @public exported from `@promptbook/components`
+ */
+function useSendMessageToLlmChat() {
+    const ref = useRef(null);
+    if (!ref.current) {
+        let handler = null;
+        const queue = [];
+        const sendMessage = (message) => {
+            if (handler) {
+                // Fire and forget
+                void handler(message);
+            }
+            else {
+                queue.push(message);
+            }
+        };
+        sendMessage._attach = (attachedHandler) => {
+            handler = attachedHandler;
+            // Flush queued messages
+            while (queue.length > 0) {
+                const next = queue.shift();
+                void handler(next);
+            }
+        };
+        ref.current = sendMessage;
+    }
+    return ref.current;
+}
+
 /**
  * Normal flow of messages in the `MockedChat` component
  *
@@ -7453,5 +7518,5 @@ function injectCssModuleIntoShadowRoot(options) {
     }
 }
 
-export { AboutPromptbookInformation, ArrowIcon, AttachmentIcon, AvatarChip, AvatarChipFromSource, AvatarProfile, AvatarProfileFromSource, BLOCKY_FLOW, BOOK_LANGUAGE_VERSION, BookEditor, BrandedQrCode, CHAT_SAVE_FORMATS, Chat, DEFAULT_BOOK_EDITOR_HEIGHT, FAST_FLOW, GenericQrCode, LlmChat, MOCKED_CHAT_DELAY_CONFIGS, MarkdownContent, MockedChat, NORMAL_FLOW, PROMPTBOOK_ENGINE_VERSION, PauseIcon, PlayIcon, PromptbookQrCode, RANDOM_FLOW, ResetIcon, SLOW_FLOW, SaveIcon, SendIcon, TemplateIcon, getChatSaveFormatDefinitions, htmlSaveFormatDefinition, injectCssModuleIntoShadowRoot, jsonSaveFormatDefinition, mdSaveFormatDefinition, parseMessageButtons, pdfSaveFormatDefinition, reactSaveFormatDefinition, txtSaveFormatDefinition, useChatAutoScroll, useSendMessageToLlmChat };
+export { AboutPromptbookInformation, AgentChat, ArrowIcon, AttachmentIcon, AvatarChip, AvatarChipFromSource, AvatarProfile, AvatarProfileFromSource, BLOCKY_FLOW, BOOK_LANGUAGE_VERSION, BookEditor, BrandedQrCode, CHAT_SAVE_FORMATS, Chat, DEFAULT_BOOK_EDITOR_HEIGHT, FAST_FLOW, GenericQrCode, LlmChat, MOCKED_CHAT_DELAY_CONFIGS, MarkdownContent, MockedChat, NORMAL_FLOW, PROMPTBOOK_ENGINE_VERSION, PauseIcon, PlayIcon, PromptbookQrCode, RANDOM_FLOW, ResetIcon, SLOW_FLOW, SaveIcon, SendIcon, TemplateIcon, getChatSaveFormatDefinitions, htmlSaveFormatDefinition, injectCssModuleIntoShadowRoot, jsonSaveFormatDefinition, mdSaveFormatDefinition, parseMessageButtons, pdfSaveFormatDefinition, reactSaveFormatDefinition, txtSaveFormatDefinition, useChatAutoScroll, useSendMessageToLlmChat };
 //# sourceMappingURL=index.es.js.map