@promptbook/javascript 0.111.0-7 → 0.112.0-11

package/umd/src/book-2.0/agent-source/createAgentModelRequirements.writing.test.d.ts

@@ -0,0 +1 @@
+export {};

package/umd/src/book-2.0/agent-source/createAgentModelRequirementsWithCommitments.knowledge.test.d.ts

@@ -0,0 +1 @@
+export {};

package/umd/src/book-2.0/agent-source/createTeamToolName.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Builds a deterministic TEAM tool name from teammate identity.
+ *
+ * The readable part is based on teammate label while the hash suffix
+ * keeps uniqueness and stable mapping for the underlying teammate URL.
+ *
+ * @param teammateUrl - Canonical teammate URL used at runtime.
+ * @param teammateLabel - Human-readable teammate label.
+ * @returns Deterministic TEAM tool name.
+ * @private internal utility of TEAM commitments and chat UI mapping
+ */
+export declare function createTeamToolName(teammateUrl: string, teammateLabel?: string): string;

package/umd/src/book-2.0/agent-source/extractOpenTeacherInstructions.d.ts

@@ -0,0 +1,12 @@
+import type { string_book } from './string_book';
+/**
+ * Extracts the teacher-focused instructions from the latest `OPEN` commitment in the book.
+ *
+ * The `OPEN` commitment may include extra text that should guide the teacher agent when
+ * self-learning. We keep the last non-empty `OPEN` value so later overrides win.
+ *
+ * @param agentSource - The raw agent book source
+ * @returns The trimmed instructions or `null` when no instructive `OPEN` commitment exists.
+ * @private Internal helper shared between self-learning and related features.
+ */
+export declare function extractOpenTeacherInstructions(agentSource: string_book): string | null;

package/umd/src/book-2.0/agent-source/extractOpenTeacherInstructions.test.d.ts

@@ -0,0 +1 @@
+export {};

package/umd/src/book-2.0/agent-source/parseAgentSourcePrelude.d.ts

@@ -0,0 +1,38 @@
+import type { string_agent_name } from '../../types/typeAliases';
+import type { string_book } from './string_book';
+/**
+ * Parsed prelude of one agent source.
+ *
+ * @private internal utility of book agent-source parsing
+ */
+type AgentSourcePrelude = {
+    /**
+     * Source split into logical lines.
+     */
+    readonly lines: string[];
+    /**
+     * First non-empty line consumed as the agent name.
+     */
+    readonly agentName: string_agent_name | null;
+    /**
+     * Zero-based index of the agent-name line.
+     */
+    readonly agentNameLineIndex: number;
+    /**
+     * One-based line number of the agent-name line.
+     */
+    readonly agentNameLineNumber?: number;
+};
+/**
+ * Consumes the agent-name prelude from raw source.
+ *
+ * Leading whitespace-only lines are skipped. The first subsequent line that contains any
+ * non-whitespace characters is always treated as plain-text agent name, even when it starts
+ * with a commitment keyword or other book syntax.
+ *
+ * @param agentSource - Raw agent source.
+ * @returns Parsed prelude with shared line metadata.
+ * @private internal utility of book agent-source parsing
+ */
+export declare function parseAgentSourcePrelude(agentSource: string_book): AgentSourcePrelude;
+export {};

package/umd/src/book-2.0/agent-source/parseAgentSourceWithCommitments.d.ts

@@ -4,6 +4,9 @@ import type { string_book } from './string_book';
  * Parses agent source using the new commitment system with multiline support
  * This function replaces the hardcoded commitment parsing in the original parseAgentSource
  *
+ * The first non-empty line is always consumed as plain-text agent name. Commitment parsing
+ * starts only after that title line has been fixed.
+ *
  * @private internal utility of `parseAgentSource`
  */
 export declare function parseAgentSourceWithCommitments(agentSource: string_book): Omit<AgentSourceParseResult, 'agentHash'>;

package/umd/src/book-2.0/agent-source/parseAgentSourceWithCommitments.title.test.d.ts

@@ -0,0 +1 @@
+export {};

package/umd/src/book-2.0/agent-source/pseudoAgentReferences.d.ts

@@ -0,0 +1,110 @@
+import type { BookCommitment } from '../../commitments/_base/BookCommitment';
+/**
+ * Supported pseudo-agent kinds.
+ *
+ * @private internal utility of pseudo-agent resolution
+ */
+export type PseudoAgentKind = 'USER' | 'VOID';
+/**
+ * Canonical pseudo-agent URL representing the current human user.
+ *
+ * @private internal utility of pseudo-agent resolution
+ */
+export declare const PSEUDO_AGENT_USER_URL = "https://pseudo-agent.promptbook/user";
+/**
+ * Canonical pseudo-agent URL representing void / nothingness.
+ *
+ * @private internal utility of pseudo-agent resolution
+ */
+export declare const PSEUDO_AGENT_VOID_URL = "https://pseudo-agent.promptbook/void";
+/**
+ * Canonical compact token representation of the `{Void}` pseudo-agent.
+ *
+ * @private internal utility of pseudo-agent resolution
+ */
+export declare const VOID_PSEUDO_AGENT_REFERENCE = "{Void}";
+/**
+ * Normalized alias keys that should resolve to the `{Void}` pseudo-agent.
+ *
+ * @private internal utility of pseudo-agent resolution
+ */
+export declare const VOID_PSEUDO_AGENT_ALIAS_KEYS: readonly ["void", "null", "none", "nil"];
+/**
+ * Resolves pseudo-agent kind from compact reference text.
+ *
+ * This accepts compact references in all supported syntaxes:
+ * `{User}`, `{user}`, `@USER`, `Void`, etc.
+ *
+ * @param rawReference - Raw reference token or payload.
+ * @returns Pseudo-agent kind or `null` when the reference is not pseudo.
+ * @private internal utility of pseudo-agent resolution
+ */
+export declare function resolvePseudoAgentKindFromReference(rawReference: string): PseudoAgentKind | null;
+/**
+ * Resolves pseudo-agent kind from canonical pseudo-agent URL.
+ *
+ * @param agentUrl - URL to inspect.
+ * @returns Pseudo-agent kind or `null` when the URL is not pseudo.
+ * @private internal utility of pseudo-agent resolution
+ */
+export declare function resolvePseudoAgentKindFromUrl(agentUrl: string): PseudoAgentKind | null;
+/**
+ * Checks whether a URL points to a pseudo-agent.
+ *
+ * @param agentUrl - URL to inspect.
+ * @returns True when the URL identifies a pseudo-agent.
+ * @private internal utility of pseudo-agent resolution
+ */
+export declare function isPseudoAgentUrl(agentUrl: string): boolean;
+/**
+ * Creates canonical pseudo-agent URL by pseudo-agent kind.
+ *
+ * @param pseudoAgentKind - Pseudo-agent kind.
+ * @returns Canonical pseudo-agent URL.
+ * @private internal utility of pseudo-agent resolution
+ */
+export declare function createPseudoAgentUrl(pseudoAgentKind: PseudoAgentKind): string;
+/**
+ * Creates a deterministic human-readable pseudonym for the `{User}` pseudo-agent.
+ *
+ * The seed is derived from TEAM commitment text with pseudo-user URLs removed so
+ * the remaining human instructions influence the resulting name.
+ *
+ * @param teamCommitmentContent - TEAM commitment content after reference resolution.
+ * @returns Deterministic English full name representing pseudo-user in that TEAM context.
+ * @private internal utility of TEAM commitment rendering
+ */
+export declare function createPseudoUserTeammateLabel(teamCommitmentContent: string): string;
+/**
+ * Returns true when reference should behave as the `{Void}` pseudo-agent.
+ *
+ * This keeps backward compatibility with legacy aliases (`VOID`, `NULL`, `NONE`, `NIL`)
+ * while also supporting compact pseudo-agent references.
+ *
+ * @param rawReference - Raw reference content.
+ * @returns True when the reference maps to void.
+ * @private internal utility of pseudo-agent resolution
+ */
+export declare function isVoidPseudoAgentReference(rawReference: string): boolean;
+/**
+ * Returns true when reference resolves to the `{User}` pseudo-agent.
+ *
+ * @param rawReference - Raw reference content.
+ * @returns True when the reference maps to user.
+ * @private internal utility of pseudo-agent resolution
+ */
+export declare function isUserPseudoAgentReference(rawReference: string): boolean;
+/**
+ * Checks whether a pseudo-agent can be used inside the specified commitment.
+ *
+ * `USER` is intentionally disallowed in FROM/IMPORT commitments.
+ *
+ * @param pseudoAgentKind - Pseudo-agent kind to validate.
+ * @param commitmentType - Commitment where it is used.
+ * @returns True when the pseudo-agent is allowed in the commitment.
+ * @private internal utility of pseudo-agent resolution
+ */
+export declare function isPseudoAgentAllowedInCommitment(pseudoAgentKind: PseudoAgentKind, commitmentType: BookCommitment): boolean;
+/**
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ */

package/umd/src/book-2.0/agent-source/removeCommentsFromSystemMessage.d.ts

@@ -1,10 +1,10 @@
 /**
- * Removes comment lines (lines starting with #) from a system message
+ * Removes single-hash comment lines (`# Comment`) from a system message
  * This is used to clean up the final system message before sending it to the AI model
  * while preserving the original content with comments in metadata
  *
  * @param systemMessage The system message that may contain comment lines
- * @returns The system message with comment lines removed
+ * @returns The system message with single-hash comment lines removed
  *
  * @private - TODO: [🧠] Maybe should be public?
  */

package/umd/src/book-components/BookEditor/BookEditor.d.ts

@@ -2,6 +2,7 @@ import { CSSProperties } from 'react';
 import type { Promisable } from 'type-fest';
 import type { string_book } from '../../book-2.0/agent-source/string_book';
 import type { number_percent, number_positive, string_css_value, string_knowledge_source_content } from '../../types/typeAliases';
+import type { HoistedMenuItem } from '../_common/MenuHoisting/MenuHoistingContext';
 /**
  * Monaco diagnostic shown inside `BookEditor`.
  *
@@ -196,6 +197,20 @@ export type BookEditorProps = {
          */
         readonly roomName: string;
     };
+    /**
+     * Stable Monaco model path used to restore cursor/scroll view state across remounts.
+     *
+     * Keep this unique per logical book editor document.
+     *
+     * @private Internal to Promptbook app integrations.
+     */
+    readonly monacoModelPath?: string;
+    /**
+     * Additional actions merged into the BookEditor actionbar and hoisted header menu.
+     *
+     * @private Internal to Promptbook app integrations.
+     */
+    readonly hoistedMenuItems?: ReadonlyArray<HoistedMenuItem>;
 };
 /**
  * Renders a book editor

package/umd/src/book-components/BookEditor/BookEditorActionbar.d.ts

@@ -1,3 +1,4 @@
+import { HoistedMenuItem } from '../_common/MenuHoisting/MenuHoistingContext';
 type BookEditorActionbarProps = {
     value: string | undefined;
     isDownloadButtonShown?: boolean;
@@ -9,6 +10,7 @@ type BookEditorActionbarProps = {
     onUploadDocument?: () => void;
     onTakePhoto?: () => void;
     isFullscreen?: boolean;
+    hoistedMenuItems?: ReadonlyArray<HoistedMenuItem>;
 };
 /**
  *

package/umd/src/book-components/BookEditor/BookEditorMonacoConstants.d.ts

@@ -5,6 +5,7 @@
  */
 export declare const BookEditorMonacoConstants: {
     readonly BOOK_LANGUAGE_ID: "book";
+    readonly BOOK_THEME_ID: "book-theme";
     readonly LINE_HEIGHT: 28;
     readonly CONTENT_PADDING_LEFT: 20;
     readonly VERTICAL_LINE_LEFT: 0;

package/umd/src/book-components/BookEditor/BookEditorMonacoTokenization.d.ts

@@ -1,3 +1,14 @@
+/**
+ * Matched agent reference token used by Monaco links.
+ *
+ * @private function of BookEditorMonaco
+ */
+type AgentReferenceMatch = {
+    readonly value: string;
+    readonly url: string;
+    readonly index: number;
+    readonly length: number;
+};
 /**
  * Agent reference helpers for `BookEditorMonaco`.
  *
@@ -7,13 +18,9 @@ export declare const BookEditorMonacoTokenization: {
     AGENT_URL_REFERENCE_REGEX: RegExp;
     AGENT_REFERENCE_TOKEN_REGEX: RegExp;
     AGENT_REFERENCE_BRACED_REGEX: RegExp;
-    AGENT_REFERENCE_HIGHLIGHT_REGEXES: readonly [RegExp, RegExp, RegExp, RegExp, RegExp];
+    AGENT_REFERENCE_HIGHLIGHT_REGEXES: readonly [RegExp, RegExp, RegExp];
     extractAgentReferenceValue: (token: string) => string;
     resolveAgentReferenceToUrl: (referenceValue: string) => string | null;
-    extractAgentReferenceMatches: (content: string) => {
-        value: string;
-        url: string;
-        index: number;
-        length: number;
-    }[];
+    extractAgentReferenceMatches: (content: string) => Array<AgentReferenceMatch>;
 };
+export {};

package/umd/src/book-components/BookEditor/BookEditorMonacoTokenization.test.d.ts

@@ -0,0 +1 @@
+export {};

package/umd/src/book-components/BookEditor/createDeprecatedCommitmentDiagnostics.d.ts

@@ -0,0 +1,28 @@
+import type { string_book } from '../../book-2.0/agent-source/string_book';
+/**
+ * Monaco diagnostic shape used by deprecated-commitment warnings.
+ *
+ * @private internal type of `BookEditorMonaco`
+ */
+type DeprecatedCommitmentDiagnostic = {
+    readonly startLineNumber: number;
+    readonly startColumn: number;
+    readonly endLineNumber: number;
+    readonly endColumn: number;
+    readonly message: string;
+    readonly source: string;
+    readonly severity: 'warning';
+};
+/**
+ * Creates Book editor diagnostics for deprecated commitment keywords.
+ *
+ * The deprecation metadata is UI-only. This helper surfaces it in Monaco so
+ * legacy commitments remain functional while still guiding authors toward
+ * preferred replacements.
+ *
+ * @param agentSource - Current editor content.
+ * @returns Warning markers for deprecated commitment keywords.
+ * @private internal utility of `BookEditorMonaco`
+ */
+export declare function createDeprecatedCommitmentDiagnostics(agentSource?: string_book): ReadonlyArray<DeprecatedCommitmentDiagnostic>;
+export {};

package/umd/src/book-components/BookEditor/createDeprecatedCommitmentDiagnostics.test.d.ts

@@ -0,0 +1 @@
+export {};

package/umd/src/book-components/BookEditor/useBookEditorMonacoLanguage.d.ts

@@ -1,7 +1,34 @@
+import type { editor } from 'monaco-editor';
 type MonacoEditor = typeof import('monaco-editor');
 type UseBookEditorMonacoLanguageProps = {
     readonly monaco: MonacoEditor | null;
 };
+/**
+ * Ensures the BookEditor Monaco language, tokenizer, links and completion providers are
+ * registered exactly once per Monaco instance, while always re-applying the Book theme.
+ *
+ * @private function of BookEditorMonaco
+ */
+export declare function ensureBookEditorMonacoLanguage(monaco: MonacoEditor): void;
+/**
+ * Props required to enforce Book Monaco language/theme on one mounted editor.
+ *
+ * @private function of BookEditorMonaco
+ */
+type EnsureBookEditorMonacoLanguageForEditorProps = {
+    readonly monaco: MonacoEditor;
+    readonly monacoEditor: editor.IStandaloneCodeEditor;
+};
+/**
+ * Ensures the mounted Monaco editor model uses Book language and Book theme.
+ *
+ * This is resilient when a shared Monaco runtime/theme is changed by another page and the
+ * Book editor tree is restored from App Router cache without a full remount.
+ *
+ * @param props - Monaco runtime and mounted editor instance.
+ * @private function of BookEditorMonaco
+ */
+export declare function ensureBookEditorMonacoLanguageForEditor(props: EnsureBookEditorMonacoLanguageForEditorProps): void;
 /**
  * Registers the language helpers that power Monaco inside `BookEditorMonaco`.
  *

package/umd/src/book-components/BookEditor/useBookEditorMonacoLanguage.test.d.ts

@@ -0,0 +1 @@
+export {};

package/umd/src/book-components/Chat/AgentChat/AgentChatProps.d.ts

@@ -1,5 +1,6 @@
 import { Agent } from '../../../llm-providers/agent/Agent';
 import type { LlmChatProps } from '../LlmChat/LlmChatProps';
+import type { AgentChipData } from '../AgentChip/AgentChip';
 /**
  * Props for AgentChat component, derived from LlmChatProps but with Agent-specific modifications
  *
@@ -15,4 +16,8 @@ export type AgentChatProps = Omit<LlmChatProps, 'thread' | 'llmTools' | 'initial
      * e.g., { "web_search": "Searching the web..." }
      */
     readonly toolTitles?: Record<string, string>;
+    /**
+     * Optional pre-fetched team agent metadata to make tool call chips friendlier.
+     */
+    readonly teamAgentProfiles?: Record<string, AgentChipData>;
 };

package/umd/src/book-components/Chat/Chat/ChatActionsBar.d.ts

@@ -15,6 +15,7 @@ export type ChatActionsBarProps = {
     participants: ReadonlyArray<ChatParticipant>;
     title: string;
     onReset?: () => Promisable<void>;
+    resetRequiresConfirmation?: boolean;
     onUseTemplate?: () => void;
     extraActions?: ReactNode;
     saveFormats?: Array<string_chat_format_name>;

package/umd/src/book-components/Chat/Chat/ChatInputArea.d.ts

@@ -31,6 +31,8 @@ export type ChatInputAreaProps = {
     speechRecognition?: ChatProps['speechRecognition'];
     speechRecognitionLanguage?: ChatProps['speechRecognitionLanguage'];
     defaultMessage?: string;
+    enterBehavior?: ChatProps['enterBehavior'];
+    resolveEnterBehavior?: ChatProps['resolveEnterBehavior'];
     placeholderMessageContent?: string;
     isFocusedOnLoad?: boolean;
     isMobile: boolean;

package/umd/src/book-components/Chat/Chat/ChatInputArea.test.d.ts

@@ -0,0 +1,2 @@
+/** @jest-environment jsdom */
+export {};

package/umd/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'> & {
+type ChatMessageItemProps = Pick<ChatProps, 'onMessage' | 'onActionButton' | 'participants'> & {
     message: ChatMessage;
     participant: ChatParticipant | undefined;
     isLastMessage: boolean;
@@ -44,6 +44,10 @@ type ChatMessageItemProps = Pick<ChatProps, 'onMessage' | 'participants'> & {
      * Maps tool name to agent information
      */
     teammates?: TeammatesMap;
+    /**
+     * Optional cached metadata keyed by TEAM tool names to enrich tool call chips.
+     */
+    teamAgentProfiles?: ChatProps['teamAgentProfiles'];
     /**
      * Called when a tool call chiplet is clicked.
      */
@@ -60,6 +64,7 @@ type ChatMessageItemProps = Pick<ChatProps, 'onMessage' | 'participants'> & {
      * Controls whether the play button below the message is shown.
      */
     isSpeechPlaybackEnabled?: ChatProps['isSpeechPlaybackEnabled'];
+    readonly elevenLabsVoiceId?: ChatProps['elevenLabsVoiceId'];
 };
 /**
  * Metadata for a teammate agent tool.

package/umd/src/book-components/Chat/Chat/ChatMessageList.d.ts

@@ -22,13 +22,16 @@ export type ChatMessageListProps = {
     isFeedbackEnabled?: boolean;
     onCopy?: () => void;
     onMessage?: (messageContent: string) => Promisable<void>;
+    onActionButton?: ChatProps['onActionButton'];
     onCreateAgent?: (bookContent: string) => void;
     toolTitles?: Record<string, string>;
     teammates?: ChatProps['teammates'];
+    teamAgentProfiles?: ChatProps['teamAgentProfiles'];
     onToolCallClick?: (toolCall: NonNullable<ChatMessage['toolCalls']>[number]) => void;
     onCitationClick?: (citation: ParsedCitation) => void;
     soundSystem?: ChatProps['soundSystem'];
     isSpeechPlaybackEnabled?: ChatProps['isSpeechPlaybackEnabled'];
+    elevenLabsVoiceId?: ChatProps['elevenLabsVoiceId'];
     setChatMessagesElement: (element: HTMLDivElement | null) => void;
     onScroll: (event: UIEvent<HTMLDivElement>) => void;
     chatMessagesClassName?: string;

package/umd/src/book-components/Chat/Chat/ChatProps.d.ts

@@ -6,6 +6,7 @@ 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 { AgentChipData } from '../AgentChip/AgentChip';
 /**
  * Response data returned by the optional `onFeedback` handler.
  *
@@ -42,6 +43,20 @@ export type ChatSoundSystem = {
      */
     vibrate?(event: string): void;
 };
+/**
+ * Supported primary Enter-key behaviors for the chat composer.
+ *
+ * @private internal helper of `<Chat/>`
+ */
+type ChatEnterBehavior = 'SEND' | 'NEWLINE';
+/**
+ * Async resolver used when the host app wants to decide Enter behavior lazily.
+ *
+ * Returning `null` / `undefined` keeps the current composer text unchanged.
+ *
+ * @private internal helper of `<Chat/>`
+ */
+type ChatEnterBehaviorResolver = () => Promisable<ChatEnterBehavior | null | undefined>;
 /**
  * @public exported from `@promptbook/components`
  */
@@ -72,6 +87,13 @@ export type ChatProps = {
      * - When undefined, the chat has no input and is read-only showing only the messages
      */
     onMessage?(messageContent: string): Promisable<void>;
+    /**
+     * Called when user clicks a quick action button parsed from message markdown.
+     *
+     * The callback is responsible for running the browser-side action and may reject
+     * to keep the button available for another attempt.
+     */
+    onActionButton?(code: string): Promisable<void>;
     /**
      * Optional callback
      *
@@ -79,6 +101,12 @@ export type ChatProps = {
      * - When undefined, no reset button will be shown
      */
     onReset?(): Promisable<void>;
+    /**
+     * Controls whether the reset button asks for native browser confirmation before calling `onReset`.
+     *
+     * @default true
+     */
+    readonly resetRequiresConfirmation?: boolean;
     /**
      * Determines whether the voice recognition button is rendered
      */
@@ -100,6 +128,11 @@ export type ChatProps = {
      * @default true
      */
     readonly isSpeechPlaybackEnabled?: boolean;
+    /**
+     * Optional ElevenLabs voice ID that should be used when reading messages aloud.
+     * When not provided, the server uses the default configured voice.
+     */
+    readonly elevenLabsVoiceId?: string;
     /**
      * Optional placeholder message for the textarea
      *
@@ -110,6 +143,24 @@ export type ChatProps = {
      * Optional preset message in chat
      */
     readonly defaultMessage?: string;
+    /**
+     * Determines which action the plain `Enter` key triggers in the composer.
+     *
+     * `Ctrl+Enter` automatically performs the inverse action.
+     * `Shift+Enter` always inserts a new line.
+     *
+     * @default 'SEND'
+     */
+    readonly enterBehavior?: ChatEnterBehavior;
+    /**
+     * Optional async hook used when `enterBehavior` is not known yet.
+     *
+     * It is invoked after the user presses plain `Enter` and can resolve to the
+     * preferred behavior without coupling `<Chat/>` to any specific persistence UI.
+     *
+     * Returning `null` / `undefined` leaves the text unchanged.
+     */
+    readonly resolveEnterBehavior?: ChatEnterBehaviorResolver;
     /**
      * List of tasks that are currently in progress that should be displayed
      */
@@ -213,6 +264,10 @@ export type ChatProps = {
         instructions?: string;
         toolName: string;
     }>;
+    /**
+     * Optional cached agent metadata keyed by TEAM tool names to improve chip rendering.
+     */
+    readonly teamAgentProfiles?: Record<string, AgentChipData>;
     /**
      * Optional callback to create a new agent from the template.
      * If provided, renders the [Create Agent] button for book code blocks.
@@ -305,6 +360,7 @@ export type ChatProps = {
      */
     readonly soundSystem?: ChatSoundSystem;
 };
+export {};
 /**
  * TODO: [☁️] Export component prop types only to `@promptbook/components` (not `@promptbook/types`)
  */

package/umd/src/book-components/Chat/Chat/ChatToolCallModal.d.ts

@@ -1,5 +1,6 @@
 import { Color } from '../../../utils/color/Color';
 import type { WithTake } from '../../../utils/take/interfaces/ITakeChain';
+import type { AgentChipData } from '../AgentChip/AgentChip';
 import type { ChatMessage } from '../types/ChatMessage';
 import type { ChatParticipant } from '../types/ChatParticipant';
 /**
@@ -10,10 +11,20 @@ import type { ChatParticipant } from '../types/ChatParticipant';
 export type ChatToolCallModalProps = {
     isOpen: boolean;
     toolCall: NonNullable<ChatMessage['toolCalls']>[number] | null;
+    /**
+     * Stable identity of the selected tool call.
+     *
+     * Used so live streamed snapshots do not reset the current modal view.
+     */
+    toolCallIdentity?: string | null;
     onClose: () => void;
     toolTitles?: Record<string, string>;
     agentParticipant?: ChatParticipant;
     buttonColor: WithTake<Color>;
+    /**
+     * Optional cached team agent metadata keyed by TEAM tool name.
+     */
+    teamAgentProfiles?: Record<string, AgentChipData>;
 };
 /**
  * Modal that renders rich tool call details for chat chiplets.

package/umd/src/book-components/Chat/Chat/TeamToolCallModalContent.d.ts

@@ -0,0 +1,32 @@
+import { type ReactElement } from 'react';
+import { Color } from '../../../utils/color/Color';
+import type { WithTake } from '../../../utils/take/interfaces/ITakeChain';
+import type { ChatParticipant } from '../types/ChatParticipant';
+import { type TeamToolCallSummary, type TransitiveToolCall } from '../utils/collectTeamToolCallSummary';
+import type { AgentProfileData } from '../utils/loadAgentProfile';
+import type { TeamToolResult } from '../utils/toolCallParsing';
+/**
+ * Rendering options for TEAM tool-call modal content.
+ *
+ * @private function of ChatToolCallModal
+ */
+type TeamToolCallModalContentOptions = {
+    teamResult: TeamToolResult;
+    toolCallDate: Date | null;
+    teamToolCallSummary: TeamToolCallSummary;
+    selectedTeamToolCall: TransitiveToolCall | null;
+    onSelectTeamToolCall: (toolCall: TransitiveToolCall) => void;
+    onClearSelectedTeamToolCall: () => void;
+    teamProfiles: Record<string, AgentProfileData>;
+    toolTitles?: Record<string, string>;
+    agentParticipant?: ChatParticipant;
+    buttonColor: WithTake<Color>;
+};
+/**
+ * Renders TEAM conversation details, nested actions, and citations.
+ *
+ * @param options - TEAM modal rendering options.
+ * @private function of ChatToolCallModal
+ */
+export declare function TeamToolCallModalContent(options: TeamToolCallModalContentOptions): ReactElement;
+export {};