@promptbook/node 0.110.0-3 → 0.110.0-4

package/esm/typings/src/_packages/types.index.d.ts

@@ -33,7 +33,6 @@ import type { SourceChipProps } from '../book-components/Chat/SourceChip/SourceC
 import type { ChatToolCall } from '../book-components/Chat/types/ChatMessage';
 import type { ChatMessage } from '../book-components/Chat/types/ChatMessage';
 import type { ChatParticipant } from '../book-components/Chat/types/ChatParticipant';
-import type { ToolCallChipletInfo } from '../book-components/Chat/utils/getToolCallChipletInfo';
 import type { ParsedCitation } from '../book-components/Chat/utils/parseCitationsFromContent';
 import type { MessageButton } from '../book-components/Chat/utils/parseMessageButtons';
 import type { TeamToolResult } from '../book-components/Chat/utils/toolCallParsing';
@@ -436,7 +435,6 @@ export type { SourceChipProps };
 export type { ChatToolCall };
 export type { ChatMessage };
 export type { ChatParticipant };
-export type { ToolCallChipletInfo };
 export type { ParsedCitation };
 export type { MessageButton };
 export type { TeamToolResult };

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

@@ -21,6 +21,10 @@ export type ChatActionsBarProps = {
     saveFormats?: Array<string_chat_format_name>;
     isSaveButtonEnabled: boolean;
     shouldFadeActions: boolean;
+    /**
+     * Disables action interactions while scroll is active.
+     */
+    shouldDisableActions: boolean;
     onButtonClick: (handler?: (event: MouseEvent<HTMLButtonElement>) => void) => (event: MouseEvent<HTMLButtonElement>) => void;
     soundSystem?: ChatSoundSystem;
 };

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

@@ -9,7 +9,7 @@ import type { ChatProps } from './ChatProps';
  *
  * @private props for internal subcomponent
  */
-type ChatMessageItemProps = Pick<ChatProps, 'onMessage' | 'participants' | 'agent'> & {
+type ChatMessageItemProps = Pick<ChatProps, 'onMessage' | 'participants'> & {
     message: ChatMessage;
     participant: ChatParticipant | undefined;
     isLastMessage: boolean;

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

@@ -5,14 +5,12 @@ import type { ChatMessage } from '../types/ChatMessage';
 import type { ChatParticipant } from '../types/ChatParticipant';
 import type { ParsedCitation } from '../utils/parseCitationsFromContent';
 import type { ChatProps } from './ChatProps';
-import { Agent } from '../../../llm-providers/agent/Agent';
 /**
  * Props for the Chat message list container.
  *
  * @private component of `<Chat/>`
  */
 export type ChatMessageListProps = {
-    agent?: Agent;
     messages: ReadonlyArray<ChatMessage>;
     participants: ReadonlyArray<ChatParticipant>;
     expandedMessageId: id | null;

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

@@ -6,7 +6,6 @@ import { string_color } from '../../../types/typeAliases';
 import type { string_chat_format_name } from '../save/_common/string_chat_format_name';
 import type { ChatMessage } from '../types/ChatMessage';
 import type { ChatParticipant } from '../types/ChatParticipant';
-import type { Agent } from '../../../llm-providers/agent/Agent';
 /**
  * Interface for sound system that can be passed to Chat component
  * This allows the chat to trigger sounds without tight coupling
@@ -26,12 +25,6 @@ export type ChatSoundSystem = {
  * @public exported from `@promptbook/components`
  */
 export type ChatProps = {
-    /**
-     * The agent that is used in the chat
-     *
-     * Note: This is not used directly but passed to subcomponents
-     */
-    readonly agent?: Agent;
     /**
      * Optional callback to create a new agent from the template.
      * If provided, renders the [Use this template] button.

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

@@ -15,6 +15,10 @@ export type SourceChipProps = {
      * Additional CSS class name
      */
     className?: string;
+    /**
+     * Optional suffix text to display after the citation label.
+     */
+    suffix?: string;
 };
 /**
  * SourceChip component - displays a chip with source document information
@@ -32,4 +36,4 @@ export type SourceChipProps = {
  *
  * @private utility of `ChatMessageItem` component
  */
-export declare function SourceChip({ citation, onClick, className }: SourceChipProps): import("react/jsx-runtime").JSX.Element;
+export declare function SourceChip({ citation, onClick, className, suffix }: SourceChipProps): import("react/jsx-runtime").JSX.Element;

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

@@ -39,10 +39,13 @@ export type ChatActionsOverlapResult = {
      */
     handleChatScroll: (event: UIEvent<HTMLDivElement>) => void;
     /**
-     * Note: Previously there were `isActionsScrolling` and `isActionsOverlapping` states,
-     * now there is just one state `shouldFadeActions` which is calculated based on the scroll position and overlap.
+     * Whether the actions toolbar is currently being scrolled.
      */
-    shouldFadeActions: boolean;
+    isActionsScrolling: boolean;
+    /**
+     * Whether the actions toolbar overlaps the first visible message.
+     */
+    isActionsOverlapping: boolean;
 };
 /**
  * Tracks action toolbar overlap while coordinating with chat auto-scroll.

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

@@ -0,0 +1,69 @@
+import { type ToolCall } from '../../../types/ToolCall';
+import type { ParsedCitation } from './parseCitationsFromContent';
+/**
+ * Origin metadata for a tool call or citation executed by a teammate.
+ *
+ * @private utility of `<Chat/>`
+ */
+export type ToolCallOrigin = {
+    /**
+     * Human-readable label for the teammate.
+     */
+    label: string;
+    /**
+     * Optional teammate URL.
+     */
+    url?: string;
+    /**
+     * Optional tool name for the teammate.
+     */
+    toolName?: string;
+};
+/**
+ * Tool call data enriched with its teammate origin.
+ *
+ * @private utility of `<Chat/>`
+ */
+export type TransitiveToolCall = {
+    /**
+     * Tool call executed by the teammate.
+     */
+    toolCall: ToolCall;
+    /**
+     * Teammate origin metadata for the tool call.
+     */
+    origin: ToolCallOrigin;
+};
+/**
+ * Citation data enriched with its teammate origin.
+ *
+ * @private utility of `<Chat/>`
+ */
+export type TransitiveCitation = ParsedCitation & {
+    /**
+     * Teammate origin metadata for the citation.
+     */
+    origin: ToolCallOrigin;
+};
+/**
+ * Aggregated teammate tool calls and citations derived from TEAM tool results.
+ *
+ * @private utility of `<Chat/>`
+ */
+export type TeamToolCallSummary = {
+    /**
+     * Tool calls executed by teammates, flattened transitively.
+     */
+    toolCalls: TransitiveToolCall[];
+    /**
+     * Citations referenced by teammates, flattened transitively.
+     */
+    citations: TransitiveCitation[];
+};
+/**
+ * Collects tool calls and citations from TEAM tool call results, resolving nested teammate chains.
+ *
+ * @param toolCalls - Tool calls from the top-level agent message.
+ * @private utility of `<Chat/>`
+ */
+export declare function collectTeamToolCallSummary(toolCalls: ReadonlyArray<ToolCall> | undefined): TeamToolCallSummary;

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

@@ -1,11 +1,9 @@
 import { type ToolCall } from '../../../types/ToolCall';
-import type { Agent } from '../../../llm-providers/agent/Agent';
 import type { AgentChipData } from '../AgentChip';
-/**
- * Utility to format tool call information for user-friendly display.
- */
 /**
  * Tool call chiplet information including agent data for team tools
+ *
+ * @private utility of `<Chat/>`
  */
 export type ToolCallChipletInfo = {
     /**
@@ -23,10 +21,19 @@ export type ToolCallChipletInfo = {
      */
     wrapInBrackets?: boolean;
 };
+/**
+ * Builds display text for a tool call chiplet.
+ *
+ * @param chipletInfo - Chiplet metadata for the tool call.
+ *
+ * @private utility of `<Chat/>`
+ */
+export declare function buildToolCallChipText(chipletInfo: ToolCallChipletInfo): string;
 /**
  * Technical to user-friendly tool names and emojis
  *
- * @private [🧠] Maybe public?
+ * @private utility of `<Chat/>` [🧠] Maybe public?
+ *
  */
 export declare const TOOL_TITLES: Record<string, {
     title: string;
@@ -38,4 +45,4 @@ export declare const TOOL_TITLES: Record<string, {
  *
  * @private [🧠] Maybe public?
  */
-export declare function getToolCallChipletInfo(toolCall: ToolCall, agent?: Agent): ToolCallChipletInfo;
+export declare function getToolCallChipletInfo(toolCall: ToolCall): ToolCallChipletInfo;

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

@@ -39,6 +39,15 @@ export declare function parseCitationsFromContent(content: string): ParsedCitati
  * @private utility for internal use
  */
 export declare function stripCitationsFromContent(content: string): string;
+/**
+ * Deduplicates citations by source while preserving the first-seen order.
+ *
+ * @param citations - Parsed citations to deduplicate.
+ * @returns Deduplicated citations in original order.
+ *
+ * @private utility for internal use
+ */
+export declare function dedupeCitationsBySource(citations: ReadonlyArray<ParsedCitation>): ParsedCitation[];
 /**
  * Extracts citations from a chat message if not already present
  *

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

@@ -25,6 +25,10 @@ export type TeamToolResult = {
     };
     request?: string;
     response?: string;
+    /**
+     * Tool calls executed by the teammate while answering.
+     */
+    toolCalls?: ReadonlyArray<ToolCall>;
     error?: string | null;
     conversation?: Array<{
         sender?: string;

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

@@ -81,12 +81,6 @@ export declare class Agent extends AgentLlmExecutionTools implements LlmExecutio
      * Human-readable titles for tool functions
      */
     toolTitles: Record<string, string>;
-    /**
-     * Externals prepared for the agent, like OpenAI assistant, etc.
-     */
-    preparedExternals: {
-        openaiAssistantId?: string;
-    };
     /**
      * Not used in Agent, always returns empty array
      */

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

@@ -13,6 +13,15 @@ export type AgentOptions = CommonToolsOptions & {
      * Here the agent has access to various LLM models, browser, scrapers, LibreOffice, tools, etc.
      */
     executionTools: ExecutionTools;
+    /**
+     * How to manage OpenAI assistant preparation when using OpenAiAssistantExecutionTools.
+     *
+     * Use `external` when an external cache manager already created the assistant and
+     * the agent should use it as-is.
+     *
+     * @default internal
+     */
+    assistantPreparationMode?: 'internal' | 'external';
     /**
      * The source of the agent
      */

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

@@ -10,6 +10,15 @@ export type CreateAgentLlmExecutionToolsOptions = CommonToolsOptions & {
      * The underlying LLM execution tools to wrap
      */
     llmTools: LlmExecutionTools | OpenAiAssistantExecutionTools;
+    /**
+     * How to manage OpenAI assistant preparation when using OpenAiAssistantExecutionTools.
+     *
+     * Use `external` when an external cache manager already created the assistant and
+     * the agent should use it as-is.
+     *
+     * @default internal
+     */
+    assistantPreparationMode?: 'internal' | 'external';
     /**
      * The agent source string that defines the agent's behavior
      */

package/esm/typings/src/utils/agents/resolveAgentAvatarImageUrl.d.ts

@@ -0,0 +1,29 @@
+import type { AgentBasicInformation } from '../../book-2.0/agent-source/AgentBasicInformation';
+import type { string_url, string_url_image } from '../../types/typeAliases';
+/**
+ * Options for resolving agent avatar URLs.
+ *
+ * @private utility of `<Chat/>`
+ */
+export type ResolveAgentAvatarImageUrlOptions = {
+    /**
+     * Agent metadata used for avatar resolution.
+     */
+    readonly agent: Pick<AgentBasicInformation, 'agentName' | 'permanentId' | 'meta'>;
+    /**
+     * Optional base URL used to resolve relative meta images and placeholders.
+     */
+    readonly baseUrl?: string_url;
+};
+/**
+ * Resolve the fallback avatar URL for an agent.
+ *
+ * @private utility of `<Chat/>`
+ */
+export declare function resolveAgentAvatarFallbackUrl(options: ResolveAgentAvatarImageUrlOptions): string_url_image | null;
+/**
+ * Resolve the best avatar URL for an agent, preferring META IMAGE and falling back to placeholders.
+ *
+ * @private utility of `<Chat/>`
+ */
+export declare function resolveAgentAvatarImageUrl(options: ResolveAgentAvatarImageUrlOptions): string_url_image | null;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@promptbook/node",
-    "version": "0.110.0-3",
+    "version": "0.110.0-4",
     "description": "Promptbook: Turn your company's scattered knowledge into AI ready books",
     "private": false,
     "sideEffects": false,
@@ -89,14 +89,11 @@
         "node": ">=18.18.0",
         "npm": ">=8.0.0"
     },
-    "overrides": {
-        "jsdom": "26.1.0"
-    },
     "main": "./umd/index.umd.js",
     "module": "./esm/index.es.js",
     "typings": "./esm/typings/src/_packages/node.index.d.ts",
     "peerDependencies": {
-        "@promptbook/core": "0.110.0-3"
+        "@promptbook/core": "0.110.0-4"
     },
     "dependencies": {
         "@mozilla/readability": "0.6.0",
@@ -105,6 +102,7 @@
         "crypto": "1.0.1",
         "crypto-js": "4.2.0",
         "dotenv": "16.3.2",
+        "jsdom": "25.0.1",
         "jszip": "3.10.1",
         "moment": "2.30.1",
         "openai": "4.63.0",

package/umd/index.umd.js

@@ -48,7 +48,7 @@
      * @generated
      * @see https://github.com/webgptorg/promptbook
      */
-    const PROMPTBOOK_ENGINE_VERSION = '0.110.0-3';
+    const PROMPTBOOK_ENGINE_VERSION = '0.110.0-4';
     /**
      * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
      * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -16988,11 +16988,16 @@
             const request = buildTeammateRequest(message, args.context);
             let response = '';
             let error = null;
+            let toolCalls;
             try {
                 const remoteAgent = await getRemoteTeammateAgent(entry.teammate.url);
                 const prompt = buildTeammatePrompt(request);
                 const teammateResult = await remoteAgent.callChatModel(prompt);
                 response = teammateResult.content || '';
+                toolCalls =
+                    'toolCalls' in teammateResult && Array.isArray(teammateResult.toolCalls)
+                        ? teammateResult.toolCalls
+                        : undefined;
             }
             catch (err) {
                 error = err instanceof Error ? err.message : String(err);
@@ -17002,6 +17007,7 @@
                 teammate: teammateMetadata,
                 request,
                 response: teammateReply,
+                toolCalls: toolCalls && toolCalls.length > 0 ? toolCalls : undefined,
                 error,
                 conversation: [
                     {
@@ -24566,7 +24572,20 @@
                 const requirementsHash = cryptoJs.SHA256(JSON.stringify(modelRequirements)).toString();
                 const cached = AgentLlmExecutionTools.assistantCache.get(this.title);
                 let assistant;
-                if (cached) {
+                if (this.options.assistantPreparationMode === 'external') {
+                    assistant = this.options.llmTools;
+                    if (this.options.isVerbose) {
+                        console.info('[🤰]', 'Using externally managed OpenAI Assistant', {
+                            agent: this.title,
+                            assistantId: assistant.assistantId,
+                        });
+                    }
+                    AgentLlmExecutionTools.assistantCache.set(this.title, {
+                        assistantId: assistant.assistantId,
+                        requirementsHash,
+                    });
+                }
+                else if (cached) {
                     if (cached.requirementsHash === requirementsHash) {
                         if (this.options.isVerbose) {
                             console.info('[🤰]', 'Using cached OpenAI Assistant', {
@@ -24632,11 +24651,6 @@
                         requirementsHash,
                     });
                 }
-                // [0] Expose prepared externals
-                if (this.preparedExternals) {
-                    this /* <- TODO: !!!!!! Remove */.preparedExternals.openaiAssistantId =
-                        assistant.assistantId;
-                }
                 // Create modified chat prompt with agent system message specific to OpenAI Assistant
                 const promptWithAgentModelRequirementsForOpenAiAssistantExecutionTools = {
                     ...promptWithAgentModelRequirements,
@@ -24790,6 +24804,7 @@
             super({
                 isVerbose: options.isVerbose,
                 llmTools: getSingleLlmExecutionTools(options.executionTools.llm),
+                assistantPreparationMode: options.assistantPreparationMode,
                 agentSource: agentSource.value, // <- TODO: [🐱‍🚀] Allow to pass BehaviorSubject<string_book> OR refresh llmExecutionTools.callChat on agentSource change
             });
             _Agent_instances.add(this);
@@ -24829,10 +24844,6 @@
              * Human-readable titles for tool functions
              */
             this.toolTitles = {};
-            /**
-             * Externals prepared for the agent, like OpenAI assistant, etc.
-             */
-            this.preparedExternals = {};
             // TODO: [🐱‍🚀] Add `Agent` simple "mocked" learning by appending to agent source
             // TODO: [🐱‍🚀] Add `Agent` learning by promptbookAgent
             this.teacherAgent = options.teacherAgent;
@@ -25069,6 +25080,63 @@
      * TODO: [🧠][😰]Agent is not working with the parameters, should it be?
      */
 
+    /**
+     * Resolve a remote META IMAGE value into an absolute URL when possible.
+     */
+    function resolveRemoteImageUrl(imageUrl, agentUrl) {
+        if (!imageUrl) {
+            return undefined;
+        }
+        if (imageUrl.startsWith('http://') ||
+            imageUrl.startsWith('https://') ||
+            imageUrl.startsWith('data:') ||
+            imageUrl.startsWith('blob:')) {
+            return imageUrl;
+        }
+        try {
+            return new URL(imageUrl, agentUrl).href;
+        }
+        catch (_a) {
+            return imageUrl;
+        }
+    }
+    /**
+     * Format a META commitment line when the value is provided.
+     */
+    function formatMetaLine(label, value) {
+        if (!value) {
+            return null;
+        }
+        return `META ${label} ${value}`;
+    }
+    /**
+     * Build a minimal agent source snapshot for remote agents.
+     */
+    function buildRemoteAgentSource(profile, meta) {
+        const metaLines = [
+            formatMetaLine('FULLNAME', meta === null || meta === void 0 ? void 0 : meta.fullname),
+            formatMetaLine('IMAGE', meta === null || meta === void 0 ? void 0 : meta.image),
+            formatMetaLine('DESCRIPTION', meta === null || meta === void 0 ? void 0 : meta.description),
+            formatMetaLine('COLOR', meta === null || meta === void 0 ? void 0 : meta.color),
+            formatMetaLine('FONT', meta === null || meta === void 0 ? void 0 : meta.font),
+            formatMetaLine('LINK', meta === null || meta === void 0 ? void 0 : meta.link),
+        ]
+            .filter((line) => Boolean(line))
+            .join('\n');
+        const personaBlock = profile.personaDescription
+            ? spaceTrim__default["default"]((block) => `
+            PERSONA
+            ${block(profile.personaDescription || '')}
+        `)
+            : '';
+        return book `
+        ${profile.agentName}
+
+        ${metaLines}
+
+        ${personaBlock}
+    `;
+    }
     /**
      * Represents one AI Agent
      *
@@ -25083,6 +25151,7 @@
      */
     class RemoteAgent extends Agent {
         static async connect(options) {
+            var _a, _b, _c;
             const agentProfileUrl = `${options.agentUrl}/api/profile`;
             const profileResponse = await fetch(agentProfileUrl);
             // <- TODO: [🐱‍🚀] What about closed-source agents?
@@ -25102,14 +25171,14 @@
                 
                 `));
             }
-            const profile = await profileResponse.json();
+            const profile = (await profileResponse.json());
+            const resolvedMeta = {
+                ...(profile.meta || {}),
+                image: resolveRemoteImageUrl((_a = profile.meta) === null || _a === void 0 ? void 0 : _a.image, options.agentUrl),
+            };
             // Note: We are creating dummy agent source because we don't have the source from the remote agent
             //       But we populate the metadata from the profile
-            const agentSource = new rxjs.BehaviorSubject(book `
-            ${profile.agentName}
-
-            ${profile.personaDescription}
-        `);
+            const agentSource = new rxjs.BehaviorSubject(buildRemoteAgentSource(profile, resolvedMeta));
             // <- TODO: [🐱‍🚀] createBookFromProfile
             // <- TODO: [🐱‍🚀] Support updating and self-updating
             const remoteAgent = new RemoteAgent({
@@ -25132,10 +25201,10 @@
             });
             remoteAgent._remoteAgentName = profile.agentName;
             remoteAgent._remoteAgentHash = profile.agentHash;
-            remoteAgent.personaDescription = profile.personaDescription;
-            remoteAgent.initialMessage = profile.initialMessage;
-            remoteAgent.links = profile.links;
-            remoteAgent.meta = profile.meta;
+            remoteAgent.personaDescription = (_b = profile.personaDescription) !== null && _b !== void 0 ? _b : null;
+            remoteAgent.initialMessage = (_c = profile.initialMessage) !== null && _c !== void 0 ? _c : null;
+            remoteAgent.links = profile.links || [];
+            remoteAgent.meta = resolvedMeta;
             remoteAgent.capabilities = profile.capabilities || [];
             remoteAgent.samples = profile.samples || [];
             remoteAgent.toolTitles = profile.toolTitles || {};