@promptbook/javascript 0.110.0-3 → 0.110.0-4

package/esm/index.es.js

@@ -18,7 +18,7 @@ const BOOK_LANGUAGE_VERSION = '2.0.0';
  * @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

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/javascript",
-    "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,
@@ -90,14 +90,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/javascript.index.d.ts",
     "peerDependencies": {
-        "@promptbook/core": "0.110.0-3"
+        "@promptbook/core": "0.110.0-4"
     },
     "dependencies": {
         "crypto": "1.0.1",

package/umd/index.umd.js

@@ -22,7 +22,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