@promptbook/components 0.103.0-45 → 0.103.0-47

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

@@ -0,0 +1,32 @@
+import type { ChatPromptResult } from '../../execution/PromptResult';
+import type { Prompt } from '../../types/Prompt';
+import { Agent } from './Agent';
+import type { RemoteAgentOptions } from './RemoteAgentOptions';
+/**
+ * Represents one AI Agent
+ *
+ * !!! Note: [🦖] There are several different things in Promptbook:
+ * - `Agent` - which represents an AI Agent with its source, memories, actions, etc. Agent is a higher-level abstraction which is internally using:
+ * !!!! `RemoteAgent`
+ * - `LlmExecutionTools` - which wraps one or more LLM models and provides an interface to execute them
+ * - `AgentLlmExecutionTools` - which is a specific implementation of `LlmExecutionTools` that wraps another LlmExecutionTools and applies agent-specific system prompts and requirements
+ * - `OpenAiAssistantExecutionTools` - which is a specific implementation of `LlmExecutionTools` for OpenAI models with assistant capabilities, recommended for usage in `Agent` or `AgentLlmExecutionTools`
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare class RemoteAgent extends Agent {
+    static connect(options: RemoteAgentOptions): Promise<RemoteAgent>;
+    /**
+     * The source of the agent
+     */
+    private agentUrl;
+    private constructor();
+    /**
+     * Calls the agent on agents remote server
+     */
+    callChatModel(prompt: Prompt): Promise<ChatPromptResult>;
+}
+/**
+ * TODO: [🧠][😰]Agent is not working with the parameters, should it be?
+ * TODO: !!! Agent on remote server
+ */

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

@@ -0,0 +1,11 @@
+import type { CommonToolsOptions } from '../../execution/CommonToolsOptions';
+import type { string_agent_url } from '../../types/typeAliases';
+/**
+ * Options for creating a Remote Agent
+ */
+export type RemoteAgentOptions = CommonToolsOptions & {
+    /**
+     * Url of the remote agent
+     */
+    agentUrl: string_agent_url;
+};

package/esm/typings/src/llm-providers/openai/OpenAiAssistantExecutionTools.d.ts

@@ -9,7 +9,7 @@ import { OpenAiExecutionTools } from './OpenAiExecutionTools';
  *
  * This is useful for calling OpenAI API with a single assistant, for more wide usage use `OpenAiExecutionTools`.
  *
- * Note: [🦖] There are several different things in Promptbook:
+ * !!! Note: [🦖] There are several different things in Promptbook:
  * - `Agent` - which represents an AI Agent with its source, memories, actions, etc. Agent is a higher-level abstraction which is internally using:
  * - `LlmExecutionTools` - which wraps one or more LLM models and provides an interface to execute them
  * - `AgentLlmExecutionTools` - which is a specific implementation of `LlmExecutionTools` that wraps another LlmExecutionTools and applies agent-specific system prompts and requirements
@@ -42,6 +42,10 @@ export declare class OpenAiAssistantExecutionTools extends OpenAiExecutionTools
          * Instructions for the new assistant
          */
         readonly instructions: string_markdown;
+        /**
+         * Optional list of knowledge source links (URLs or file paths) to attach to the assistant via vector store
+         */
+        readonly knowledgeSources?: ReadonlyArray<string>;
     }): Promise<OpenAiAssistantExecutionTools>;
     /**
      * Discriminant for type guards

package/esm/typings/src/pipeline/validatePipelineString.d.ts

@@ -3,6 +3,8 @@ import type { PipelineString } from './PipelineString';
  * Function `validatePipelineString` will validate the if the string is a valid pipeline string
  * It does not check if the string is fully logically correct, but if it is a string that can be a pipeline string or the string looks completely different.
  *
+ * Note: [🔂] This function is idempotent.
+ *
  * @param {string} pipelineString the candidate for a pipeline string
  * @returns {PipelineString} the same string as input, but validated as valid
  * @throws {ParseError} if the string is not a valid pipeline string

package/esm/typings/src/storage/_common/PromptbookStorage.d.ts

@@ -21,4 +21,5 @@ export type PromptbookStorage<TItem> = {
 };
 /**
  * TODO: [💺] Constrain `TItem` to [🚉] JSON-serializable objects only in type level
+ * TODO: [☹️] Unite the storages
  */

package/esm/typings/src/types/typeAliases.d.ts

@@ -360,6 +360,12 @@ export type string_base_url = string;
  * For example `"https://promptbook.studio/webgpt/"`
  */
 export type string_pipeline_root_url = string;
+/**
+ * Semantic helper
+ *
+ * For example `"https://s6.ptbk.io/agents/agent-007"`
+ */
+export type string_agent_url = string;
 /**
  * Semantic helper
  *

package/esm/typings/src/utils/color/internal-utils/checkChannelValue.d.ts

@@ -9,6 +9,3 @@
  * @private util of `@promptbook/color`
  */
 export declare function checkChannelValue(channelName: string, value: number): asserts value is number;
-/**
- * TODO: [🧠][🚓] Is/which combination it better to use asserts/check, validate or is utility function?
- */

package/esm/typings/src/utils/random/$generateBookBoilerplate.d.ts

@@ -1,7 +1,7 @@
 import type { PartialDeep } from 'type-fest';
 import type { AgentBasicInformation } from '../../book-2.0/agent-source/AgentBasicInformation';
-import { string_book } from '../../book-2.0/agent-source/string_book';
-import { string_agent_name_in_book } from '../../types/typeAliases';
+import type { string_book } from '../../book-2.0/agent-source/string_book';
+import type { string_agent_name_in_book } from '../../types/typeAliases';
 type GenerateBookBoilerplateOptions = PartialDeep<Omit<AgentBasicInformation, 'parameters'>> & {
     /**
      * Name of the parent agent to inherit from

package/esm/typings/src/utils/random/$randomFullnameWithColor.d.ts

@@ -1,4 +1,4 @@
-import { string_color, string_person_fullname } from '../../types/typeAliases';
+import type { string_color, string_person_fullname } from '../../types/typeAliases';
 export type RandomFullnameWithColorResult = {
     fullname: string_person_fullname;
     color: string_color;

package/esm/typings/src/utils/validators/parameterName/validateParameterName.d.ts

@@ -3,6 +3,8 @@ import type { string_parameter_name } from '../../../types/typeAliases';
  * Function `validateParameterName` will normalize and validate a parameter name for use in pipelines.
  * It removes diacritics, emojis, and quotes, normalizes to camelCase, and checks for reserved names and invalid characters.
  *
+ * Note: [🔂] This function is idempotent.
+ *
  * @param parameterName The parameter name to validate and normalize.
  * @returns The validated and normalized parameter name.
  * @throws {ParseError} If the parameter name is empty, reserved, or contains invalid characters.

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.103.0-44`).
+ * It follows semantic versioning (e.g., `0.103.0-46`).
  *
  * @generated
  */

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@promptbook/components",
-    "version": "0.103.0-45",
+    "version": "0.103.0-47",
     "description": "Promptbook: Turn your company's scattered knowledge into AI ready books",
     "private": false,
     "sideEffects": false,
@@ -100,6 +100,7 @@
         "highlight.js": "11.11.1",
         "katex": "0.16.25",
         "qrcode": "^1.5.4",
+        "rxjs": "7.8.2",
         "showdown": "2.1.0",
         "spacetrim": "0.11.60",
         "waitasecond": "1.11.160"

package/umd/index.umd.js

@@ -1,8 +1,8 @@
 (function (global, factory) {
-    typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports, require('react/jsx-runtime'), require('react'), require('spacetrim'), require('react-dom'), require('@monaco-editor/react'), require('path'), require('destroyable'), require('highlight.js'), require('katex'), require('showdown'), require('waitasecond'), require('qrcode')) :
-    typeof define === 'function' && define.amd ? define(['exports', 'react/jsx-runtime', 'react', 'spacetrim', 'react-dom', '@monaco-editor/react', 'path', 'destroyable', 'highlight.js', 'katex', 'showdown', 'waitasecond', 'qrcode'], factory) :
-    (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global["promptbook-components"] = {}, global.jsxRuntime, global.react, global.spaceTrim, global.reactDom, global.Editor, global.path, global.destroyable, global.hljs, global.katex, global.showdown, global.waitasecond, global.QRCode));
-})(this, (function (exports, jsxRuntime, react, spaceTrim, reactDom, Editor, path, destroyable, hljs, katex, showdown, waitasecond, QRCode) { 'use strict';
+    typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports, require('react/jsx-runtime'), require('react'), require('spacetrim'), require('react-dom'), require('@monaco-editor/react'), require('path'), require('destroyable'), require('highlight.js'), require('katex'), require('showdown'), require('rxjs'), require('waitasecond'), require('qrcode')) :
+    typeof define === 'function' && define.amd ? define(['exports', 'react/jsx-runtime', 'react', 'spacetrim', 'react-dom', '@monaco-editor/react', 'path', 'destroyable', 'highlight.js', 'katex', 'showdown', 'rxjs', 'waitasecond', 'qrcode'], factory) :
+    (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global["promptbook-components"] = {}, global.jsxRuntime, global.react, global.spaceTrim, global.reactDom, global.Editor, global.path, global.destroyable, global.hljs, global.katex, global.showdown, global.rxjs, global.waitasecond, global.QRCode));
+})(this, (function (exports, jsxRuntime, react, spaceTrim, reactDom, Editor, path, destroyable, hljs, katex, showdown, rxjs, waitasecond, QRCode) { 'use strict';
 
     function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e : { 'default': e }; }
 
@@ -26,7 +26,7 @@
      * @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
@@ -667,6 +667,36 @@
      * 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
      *
@@ -740,23 +770,19 @@
         `);
         }
         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)`;
@@ -768,18 +794,6 @@
                 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
@@ -2324,6 +2338,8 @@
     /**
      * A function that adds padding to the book content
      *
+     * Note: [🔂] This function is idempotent.
+     *
      * @public exported from `@promptbook/core`
      */
     function padBook(content) {
@@ -2369,6 +2385,8 @@
      * 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) {
@@ -2400,15 +2418,20 @@
      */
     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
         {
@@ -2653,9 +2676,6 @@
             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
@@ -3503,36 +3523,6 @@
      * 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',
@@ -4505,8 +4495,7 @@
 
                 ## 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);
@@ -4926,7 +4915,7 @@
                 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);
@@ -5086,6 +5075,38 @@
         return jsxRuntime.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 rxjs.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 rxjs.BehaviorSubject(theValue);
+            subject.subscribe((newValue) => {
+                setValue(newValue);
+            });
+            return subject;
+        }
+        else {
+            return new rxjs.BehaviorSubject(value);
+        }
+    }
+    /**
+     * TODO: [🧠] Maybe `BehaviorSubject` is too heavy for this use case, maybe just tuple `[value,setValue]` is enough
+     */
+
     /**
      * Calculates distance between two colors
      *
@@ -6545,53 +6566,6 @@
                                 placeholder: "Add a note (optional)", defaultValue: textRating, onChange: (e) => setTextRating(e.target.value), className: chatStyles.ratingInput }), jsxRuntime.jsxs("div", { className: chatStyles.ratingActions, children: [jsxRuntime.jsx("button", { onClick: () => setRatingModalOpen(false), children: "Cancel" }), jsxRuntime.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 = react.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
      *
@@ -6845,6 +6819,96 @@
         return (jsxRuntime.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 (jsxRuntime.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__default["default"](`
+                                
+                        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 = react.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
      *
@@ -7455,6 +7519,7 @@
     }
 
     exports.AboutPromptbookInformation = AboutPromptbookInformation;
+    exports.AgentChat = AgentChat;
     exports.ArrowIcon = ArrowIcon;
     exports.AttachmentIcon = AttachmentIcon;
     exports.AvatarChip = AvatarChip;