@promptbook/node 0.110.0-2 → 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/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/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,10 +1,9 @@
 import { type ToolCall } from '../../../types/ToolCall';
 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 = {
     /**
@@ -22,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;

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

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@promptbook/node",
-    "version": "0.110.0-2",
+    "version": "0.110.0-4",
     "description": "Promptbook: Turn your company's scattered knowledge into AI ready books",
     "private": false,
     "sideEffects": false,
@@ -93,7 +93,7 @@
     "module": "./esm/index.es.js",
     "typings": "./esm/typings/src/_packages/node.index.d.ts",
     "peerDependencies": {
-        "@promptbook/core": "0.110.0-2"
+        "@promptbook/core": "0.110.0-4"
     },
     "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.110.0-2';
+    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', {
@@ -24785,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);
@@ -25060,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
      *
@@ -25074,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?
@@ -25093,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({
@@ -25123,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 || {};