@promptbook/javascript 0.110.0-2 → 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-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

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/javascript",
-    "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,
@@ -94,7 +94,7 @@
     "module": "./esm/index.es.js",
     "typings": "./esm/typings/src/_packages/javascript.index.d.ts",
     "peerDependencies": {
-        "@promptbook/core": "0.110.0-2"
+        "@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-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