@promptbook/javascript 0.111.0-7 → 0.112.0-12

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

@@ -0,0 +1,41 @@
+/**
+ * Stable global CSS class names exposed by chat components for host-level styling.
+ *
+ * These names are intentionally centralized so both rendering code and
+ * host-application tooling (for example Agents Server custom CSS editor) can stay DRY.
+ *
+ * @private Internal chat styling contract for Promptbook-host applications.
+ */
+export declare const chatCssClassNames: {
+    readonly chat: "agent-chat";
+    readonly chatMainFlow: "agent-chat-main-flow";
+    readonly chatMessages: "chat-messages";
+    readonly chatMessage: "chat-message";
+    readonly userMessage: "user-message";
+    readonly agentResponse: "agent-response";
+    readonly messageStack: "chat-message-stack";
+    readonly messageContent: "chat-message-content";
+    readonly messageAvatar: "chat-message-avatar";
+    readonly userAvatar: "user-avatar";
+    readonly agentAvatar: "agent-avatar";
+    readonly chatInput: "chat-input";
+    readonly inputContainer: "chat-input-container";
+    readonly inputTextarea: "chat-input-textarea";
+    readonly inputAttachmentButton: "chat-input-attachment-button";
+    readonly inputVoiceButton: "chat-input-voice-button";
+    readonly inputSendButton: "chat-input-send-button";
+};
+/**
+ * Human-readable descriptions for globally available chat CSS hooks.
+ *
+ * @private Internal chat styling contract for Promptbook-host applications.
+ */
+export declare const chatCssClassDescriptions: Record<keyof typeof chatCssClassNames, string>;
+/**
+ * Resolves legacy global chat classes that already existed in rendered markup.
+ *
+ * @param suffix - Legacy chat class suffix.
+ * @returns Legacy global class name prefixed with `chat-`.
+ * @private Internal helper for backward-compatible chat selectors.
+ */
+export declare function getChatCssClassName(suffix: string): string;

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

@@ -0,0 +1,44 @@
+import { type ReactElement } from 'react';
+import type { ChatMessage } from '../types/ChatMessage';
+/**
+ * Rendering options for advanced raw payload details.
+ *
+ * @private function of ChatToolCallModal
+ */
+type AdvancedToolCallDetailsOptions = {
+    /**
+     * Tool call currently selected in the modal.
+     */
+    toolCall: NonNullable<ChatMessage['toolCalls']>[number];
+    /**
+     * Optional mapping of tool titles.
+     */
+    toolTitles?: Record<string, string>;
+};
+/**
+ * Renders a technical view with raw tool input/output payloads.
+ *
+ * @param options - Rendering options for advanced mode.
+ * @private function of ChatToolCallModal
+ */
+export declare function renderAdvancedToolCallDetails(options: AdvancedToolCallDetailsOptions): ReactElement;
+/**
+ * Builds a markdown advanced report for one tool call.
+ *
+ * The report includes the same payload sections rendered in the advanced modal,
+ * so copied/saved output always mirrors the visible technical details.
+ *
+ * @param options - Rendering options for advanced mode.
+ * @returns Markdown report content.
+ * @private function of ChatToolCallModal
+ */
+export declare function createAdvancedToolCallReportMarkdown(options: AdvancedToolCallDetailsOptions): string;
+/**
+ * Creates a stable filename for downloaded advanced tool-call reports.
+ *
+ * @param toolCall - Tool call currently selected in the modal.
+ * @returns Safe markdown filename.
+ * @private function of ChatToolCallModal
+ */
+export declare function createAdvancedToolCallReportFilename(toolCall: NonNullable<ChatMessage['toolCalls']>[number]): string;
+export {};

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

@@ -0,0 +1,40 @@
+import { type ReactElement } from 'react';
+import { Color } from '../../../utils/color/Color';
+import type { WithTake } from '../../../utils/take/interfaces/ITakeChain';
+import type { ChatMessage } from '../types/ChatMessage';
+import type { ChatParticipant } from '../types/ChatParticipant';
+/**
+ * Options for rendering a tool call detail view.
+ *
+ * @private utility of `<ChatToolCallModal/>`
+ */
+type ToolCallDetailsOptions = {
+    /**
+     * Tool call to render.
+     */
+    toolCall: NonNullable<ChatMessage['toolCalls']>[number];
+    /**
+     * Optional mapping of tool titles.
+     */
+    toolTitles?: Record<string, string>;
+    /**
+     * Agent participant metadata for avatar details.
+     */
+    agentParticipant?: ChatParticipant;
+    /**
+     * Chat button color for fallback styling.
+     */
+    buttonColor: WithTake<Color>;
+    /**
+     * Requests switching the modal into advanced technical mode.
+     */
+    onRequestAdvancedView?: () => void;
+};
+/**
+ * Renders the detail view for a single tool call.
+ *
+ * @param options - Rendering options for the tool call.
+ * @private function of ChatToolCallModal
+ */
+export declare function renderToolCallDetails(options: ToolCallDetailsOptions): ReactElement;
+export {};

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

@@ -1,3 +1,8 @@
+/**
+ * Props for `<CodeBlock/>`.
+ *
+ * @private Internal utility of `<ChatMessage />` component
+ */
 type CodeBlockProps = {
     code: string;
     language?: string;

package/umd/src/book-components/Chat/CodeBlock/resolveCodeBlockLanguage.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Monaco language identifiers supported for markdown code snippets.
+ *
+ * @private internal helper of `<CodeBlock/>`
+ */
+export type MonacoCodeBlockLanguage = 'javascript' | 'typescript' | 'html' | 'css' | 'python' | 'shell' | 'json' | 'sql' | 'book' | 'plaintext';
+/**
+ * Resolves a markdown fenced-code language label into a Monaco language identifier.
+ *
+ * Unknown languages intentionally resolve to `plaintext` so unsupported snippets render
+ * as readable text without syntax highlighting.
+ *
+ * @param language - Raw markdown code fence language label (for example `ts`, `typescript`, `bash`).
+ * @returns Canonical Monaco language identifier.
+ *
+ * @private internal helper of `<CodeBlock/>`
+ */
+export declare function resolveCodeBlockLanguage(language: string | undefined): MonacoCodeBlockLanguage;

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

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

package/umd/src/book-components/Chat/LlmChat/LlmChatProps.d.ts

@@ -4,6 +4,7 @@ import type { ChatProps } from '../Chat/ChatProps';
 import type { SendMessageToLlmChatFunction } from '../hooks/useSendMessageToLlmChat';
 import type { ChatMessage } from '../types/ChatMessage';
 import type { ChatParticipant } from '../types/ChatParticipant';
+import type { AgentChipData } from '../AgentChip/AgentChip';
 /**
  * Determines how the chat reset action should behave when user clicks "New chat".
  */
@@ -39,6 +40,13 @@ export type LlmChatProps = Omit<ChatProps, 'messages' | 'onMessage' | 'onChange'
      * Called when the chat state changes (messages, participants, etc.)
      */
     onChange?(messages: ReadonlyArray<ChatMessage>, participants: ReadonlyArray<ChatParticipant>): void;
+    /**
+     * Called every time the user types in the input field (for draft message persistence).
+     * This is passed through to the underlying Chat component's onChange handler.
+     *
+     * @private internal utility of <AgentChatHistoryClient/>
+     */
+    onInputTextChange?(messageContent: string): void;
     /**
      * Optional external sendMessage function produced by useSendMessageToLlmChat hook.
      * When provided, LlmChat will attach its internal handler to it (no React context needed).
@@ -61,11 +69,19 @@ export type LlmChatProps = Omit<ChatProps, 'messages' | 'onMessage' | 'onChange'
      * This is useful for seamless transitions from other pages.
      */
     readonly autoExecuteMessage?: string;
+    /**
+     * Optional attachments that should be sent alongside the auto-executed message.
+     */
+    readonly autoExecuteMessageAttachments?: ChatMessage['attachments'];
     /**
      * Optional mapping of technical tool names to human-readable titles.
      * e.g., { "web_search": "Searching the web..." }
      */
     readonly toolTitles?: Record<string, string>;
+    /**
+     * Optional pre-fetched team agent metadata keyed by TEAM tool name.
+     */
+    readonly teamAgentProfiles?: Record<string, AgentChipData>;
     /**
      * Custom variants for the placeholder thinking message shown while the agent buffers its response.
      *

package/umd/src/book-components/Chat/hooks/useChatAutoScroll.d.ts

@@ -33,7 +33,7 @@ export declare function useChatAutoScroll(config?: ChatAutoScrollConfig): {
     isAutoScrolling: boolean;
     chatMessagesRef: (element: HTMLDivElement | null) => void;
     handleScroll: (event: React.UIEvent<HTMLDivElement>) => void;
-    handleMessagesChange: () => void;
+    handleMessagesChange: (isStreaming?: boolean) => void;
     scrollToBottom: () => void;
     enableAutoScroll: () => void;
     disableAutoScroll: () => void;

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

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

package/umd/src/book-components/Chat/types/ChatMessage.d.ts

@@ -29,6 +29,22 @@ export type ChatMessage = Omit<Message<id>, 'direction' | 'recipients' | 'thread
      * Optional duration of agent message generation in milliseconds
      */
     generationDurationMs?: number;
+    /**
+     * Durable lifecycle state tracked by server-owned chat implementations.
+     */
+    lifecycleState?: 'queued' | 'running' | 'completed' | 'failed' | 'cancelled';
+    /**
+     * Optional failure/cancellation explanation persisted with the message.
+     */
+    lifecycleError?: string;
+    /**
+     * Optional client-generated idempotency key associated with the originating user message.
+     */
+    clientMessageId?: string;
+    /**
+     * Optional durable job id responsible for generating this assistant message.
+     */
+    jobId?: string;
     /**
      * Whether the message is complete (for example, if it's still being generated by an AI)
      *

package/umd/src/book-components/Chat/utils/ChatPersistence.d.ts

@@ -6,6 +6,22 @@ import type { ChatMessage } from '../types/ChatMessage';
  */
 export declare class ChatPersistence {
     private static readonly STORAGE_PREFIX;
+    /**
+     * In-memory fallback storage used when browser storage is unavailable or throws.
+     */
+    private static readonly MEMORY_STORAGE;
+    /**
+     * Builds normalized storage key for one persistence scope.
+     */
+    private static resolveStorageKey;
+    /**
+     * Stores serialized payload in the in-memory fallback store.
+     */
+    private static saveToMemoryStorage;
+    /**
+     * Resolves serialized payload from localStorage and falls back to in-memory storage.
+     */
+    private static loadSerializedMessages;
     /**
      * Save messages to localStorage under the given key
      */

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

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

package/umd/src/book-components/Chat/utils/createTeamToolNameFromUrl.d.ts

@@ -1,9 +1,9 @@
 /**
- * Builds a TEAM tool name from a teammate agent URL.
+ * Builds a TEAM tool name from teammate identity.
  *
  * @private utility of chat components
  */
-export declare function createTeamToolNameFromUrl(url: string): string;
+export declare function createTeamToolNameFromUrl(url: string, teammateLabel?: string): string;
 /**
  * Checks whether a tool name belongs to a TEAM tool.
  *

package/umd/src/book-components/Chat/utils/getToolCallChipletInfo.timeout.test.d.ts

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

package/umd/src/book-components/Chat/utils/parseMessageButtons.d.ts

@@ -1,15 +1,32 @@
 /**
- * Represents a parsed message button from markdown
+ * Represents a quick message button parsed from chat markdown.
  *
- * @public exported from `@promptbook/components`
+ * @private internal helper type of `MessageButton`
  */
-export type MessageButton = {
+export type MessageQuickButton = {
+    type: 'message';
     text: string;
     message: string;
 };
 /**
- * Parses markdown buttons in the format [Button Text](?message=Message%20to%20send)
- * Returns both the content without buttons and the extracted buttons
+ * Represents a quick action button parsed from chat markdown.
+ *
+ * @private internal helper type of `MessageButton`
+ */
+export type ActionQuickButton = {
+    type: 'action';
+    text: string;
+    code: string;
+};
+/**
+ * Represents one parsed quick button from chat markdown.
+ *
+ * @public exported from `@promptbook/components`
+ */
+export type MessageButton = MessageQuickButton | ActionQuickButton;
+/**
+ * Parses markdown quick buttons in the format `[Button Text](?message=...)` or `[Button Text](?action=...)`.
+ * Returns both the content without supported quick buttons and the extracted button definitions.
  *
  * @param content The markdown content that may contain buttons
  * @returns Object with contentWithoutButtons and buttons array

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

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

package/umd/src/book-components/Chat/utils/resolveToolCallFromChatMessages.d.ts

@@ -0,0 +1,13 @@
+import type { ToolCall } from '../../../types/ToolCall';
+import type { ChatMessage } from '../types/ChatMessage';
+/**
+ * Resolves the latest known snapshot of one tool call from rendered chat messages.
+ *
+ * @param messages - Chat messages currently rendered in the UI.
+ * @param toolCallIdentity - Stable tool-call identity.
+ * @param fallbackToolCall - Optional fallback snapshot used before live state is found.
+ * @returns Latest matching tool call or the fallback snapshot.
+ *
+ * @private internal helper for chat tool-call modal state
+ */
+export declare function resolveToolCallFromChatMessages(messages: ReadonlyArray<ChatMessage>, toolCallIdentity: string | null, fallbackToolCall: ToolCall | null): ToolCall | null;

package/umd/src/book-components/Chat/utils/resolveToolCallState.d.ts

@@ -0,0 +1,10 @@
+import type { ToolCall, ToolCallState } from '../../../types/ToolCall';
+/**
+ * Resolves one explicit or inferred lifecycle state for a tool call snapshot.
+ *
+ * @param toolCall - Tool call snapshot to inspect.
+ * @returns Resolved lifecycle state.
+ *
+ * @private internal helper for chat tool-call rendering
+ */
+export declare function resolveToolCallState(toolCall: ToolCall): ToolCallState;

package/umd/src/book-components/Chat/utils/sanitizeStreamingMessageContent.d.ts

@@ -7,8 +7,36 @@ type SanitizeStreamingMessageContentOptions = {
      */
     isComplete?: boolean;
 };
+type FenceDelimiter = '```' | '~~~';
+type CodeFenceStreamingBoundary = {
+    readonly kind: 'codeFence';
+    readonly index: number;
+    readonly delimiter: FenceDelimiter;
+};
+type MathStreamingBoundary = {
+    readonly kind: 'math';
+    readonly index: number;
+};
+type ImagePromptStreamingBoundary = {
+    readonly kind: 'imagePrompt';
+    readonly index: number;
+};
+/**
+ * Metadata describing the most-recently introduced rich feature that is still streaming.
+ *
+ * @private internal helper of <ChatMessageItem/>
+ */
+export type StreamingFeatureBoundary = CodeFenceStreamingBoundary | MathStreamingBoundary | ImagePromptStreamingBoundary;
+/**
+ * Examines the latest streaming feature boundary so rich placeholders can be rendered while content is still being produced.
+ *
+ * @param content - Message text that may still be streaming.
+ * @returns Metadata describing the richest streaming feature or `null` when nothing is being hidden.
+ * @private internal helper of <ChatMessageItem/>
+ */
+export declare function getLatestStreamingFeatureBoundary(content: string): StreamingFeatureBoundary | null;
 /**
- * Trims trailing rich-feature markup from streaming messages so users do not see raw source while the feature is being generated.
+ * Trims trailing rich-feature markup from streaming messages so users do not see the raw source while the feature loads.
  *
  * @param content - Full markdown text produced by the assistant.
  * @param options - Sanitization options (streaming state).

package/umd/src/book-components/Chat/utils/splitMessageContentIntoSegments.d.ts

@@ -25,14 +25,27 @@ export type ChatMapSegment = {
     data: GeoJsonObject;
 };
 /**
- * Composite segment type that covers text, image prompts, and map features.
+ * Segment that represents a fenced code block inside a chat message.
  */
 /**
- * Composite segment type that covers text, image prompts, and map features.
+ * Segment that represents a fenced code block inside a chat message.
  *
  * @private internal helper of `<ChatMessageItem/>`
  */
-export type ChatMessageContentSegment = ImagePromptSegment | ChatTextSegment | ChatMapSegment;
+export type ChatCodeSegment = {
+    type: 'code';
+    language?: string;
+    code: string;
+};
+/**
+ * Composite segment type that covers text, image prompts, map features, and code blocks.
+ */
+/**
+ * Composite segment type that covers text, image prompts, map features, and code blocks.
+ *
+ * @private internal helper of `<ChatMessageItem/>`
+ */
+export type ChatMessageContentSegment = ImagePromptSegment | ChatTextSegment | ChatMapSegment | ChatCodeSegment;
 /**
  * Splits chat message content into markdown, image prompt, and map segments while preserving their order.
  *

package/umd/src/book-components/Chat/utils/thinkingMessageVariants.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Normalizes configured thinking-message variants to a non-empty trimmed list.
+ *
+ * @param thinkingMessages Raw thinking-message variants.
+ * @returns Trimmed non-empty variants or the shared defaults.
+ * @private internal helper for Promptbook chat placeholders
+ */
+export declare function normalizeThinkingMessageVariants(thinkingMessages?: ReadonlyArray<string>): ReadonlyArray<string>;
+/**
+ * Returns a random delay used between browser-side thinking-message rotations.
+ *
+ * @returns Delay in milliseconds.
+ * @private internal helper for Promptbook chat placeholders
+ */
+export declare function getRandomThinkingMessageDelayMs(): number;
+/**
+ * Selects one random thinking-message variant, avoiding the previous variant when possible.
+ *
+ * @param variants Available thinking-message variants.
+ * @param excludeVariant Variant to avoid repeating immediately.
+ * @returns Selected thinking-message variant.
+ * @private internal helper for Promptbook chat placeholders
+ */
+export declare function getRandomThinkingMessageVariant(variants: ReadonlyArray<string>, excludeVariant?: string): string;

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

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

package/umd/src/book-components/Chat/utils/timeoutToolCallPresentation.d.ts

@@ -0,0 +1,123 @@
+import type { TODO_any } from '../../../utils/organization/TODO_any';
+/**
+ * Action performed by timeout tools.
+ *
+ * @private internal timeout-chat type
+ */
+export type TimeoutToolCallAction = 'set' | 'cancel';
+/**
+ * Friendly presentation payload derived from timeout tool arguments and result.
+ *
+ * @private internal utility of `<Chat/>`
+ */
+export type TimeoutToolCallPresentation = {
+    /**
+     * Timeout action represented by this tool call.
+     */
+    readonly action: TimeoutToolCallAction;
+    /**
+     * Timeout operation status from tool result.
+     */
+    readonly status: string | null;
+    /**
+     * Requested timeout duration in milliseconds.
+     */
+    readonly milliseconds: number | null;
+    /**
+     * Optional timeout identifier returned by runtime.
+     */
+    readonly timeoutId: string | null;
+    /**
+     * Optional custom timeout wake-up message.
+     */
+    readonly message: string | null;
+    /**
+     * Parsed due date for scheduled timeout.
+     */
+    readonly dueAtDate: Date | null;
+    /**
+     * Exact due timestamp in ISO UTC format.
+     */
+    readonly dueAtIsoUtc: string | null;
+    /**
+     * Local timezone used for user-facing rendering.
+     */
+    readonly localTimezone: string;
+    /**
+     * Compact duration label used by timeout chips.
+     */
+    readonly compactDurationLabel: string | null;
+    /**
+     * Long duration label used by timeout detail popup copy.
+     */
+    readonly humanDurationLabel: string | null;
+    /**
+     * Relative time label resolved from due date and current time.
+     */
+    readonly relativeDueLabel: string | null;
+    /**
+     * Localized due time for friendly popups.
+     */
+    readonly localDueTimeLabel: string | null;
+    /**
+     * Localized due date for friendly popups.
+     */
+    readonly localDueDateLabel: string | null;
+};
+/**
+ * Inputs required to derive timeout presentation metadata.
+ *
+ * @private internal timeout-chat type
+ */
+type ResolveTimeoutToolCallPresentationOptions = {
+    /**
+     * Tool name being rendered.
+     */
+    readonly toolCallName: string;
+    /**
+     * Parsed tool arguments.
+     */
+    readonly args: Record<string, TODO_any>;
+    /**
+     * Parsed raw tool result payload.
+     */
+    readonly resultRaw: TODO_any;
+    /**
+     * Current date used to calculate relative labels.
+     */
+    readonly currentDate?: Date;
+};
+/**
+ * Determines whether a tool name belongs to the timeout commitment.
+ *
+ * @private internal utility of `<Chat/>`
+ */
+export declare function isTimeoutToolCallName(toolName: string): boolean;
+/**
+ * Resolves friendly timeout presentation metadata from one tool call payload.
+ *
+ * @private internal utility of `<Chat/>`
+ */
+export declare function resolveTimeoutToolCallPresentation(options: ResolveTimeoutToolCallPresentationOptions): TimeoutToolCallPresentation | null;
+/**
+ * Builds concise chip text for timeout tool calls.
+ *
+ * @private internal utility of `<Chat/>`
+ */
+export declare function buildTimeoutToolCallChipLabel(presentation: TimeoutToolCallPresentation): string;
+/**
+ * Builds the primary timeout sentence shown in default modal view.
+ *
+ * @private internal utility of `<Chat/>`
+ */
+export declare function buildTimeoutToolPrimarySentence(presentation: TimeoutToolCallPresentation): string;
+/**
+ * Builds one default-view scheduling sentence with local-time and relative context.
+ *
+ * @private internal utility of `<Chat/>`
+ */
+export declare function buildTimeoutToolScheduleSentence(presentation: TimeoutToolCallPresentation): string | null;
+export {};
+/**
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ */

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

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

package/umd/src/book-components/Chat/utils/toolCallParsing/RunBrowserToolResult.d.ts

@@ -0,0 +1,50 @@
+import type { TODO_any } from '../../../../utils/organization/TODO_any';
+/**
+ * Structured browser artifact metadata extracted from `run_browser` tool result.
+ *
+ * @private type of toolCallParsing
+ */
+export type RunBrowserToolArtifact = {
+    kind: 'screenshot' | 'video';
+    path: string;
+    label: string;
+    actionSummary?: string;
+};
+/**
+ * Structured browser action summary extracted from `run_browser` tool result.
+ *
+ * @private type of toolCallParsing
+ */
+export type RunBrowserToolAction = {
+    summary: string;
+};
+/**
+ * Structured browser error metadata extracted from `run_browser` payload.
+ *
+ * @private type of toolCallParsing
+ */
+export type RunBrowserToolError = {
+    code: string;
+    message: string;
+    isRetryable: boolean;
+    suggestedNextSteps: Array<string>;
+    debug: Record<string, TODO_any> | null;
+};
+/**
+ * Parsed `run_browser` tool result normalized for modal rendering.
+ *
+ * @private type of toolCallParsing
+ */
+export type RunBrowserToolResult = {
+    sessionId: string | null;
+    mode: string | null;
+    modeUsed: string | null;
+    initialUrl: string | null;
+    finalUrl: string | null;
+    finalTitle: string | null;
+    warning: string | null;
+    fallbackContent: string | null;
+    error: RunBrowserToolError | null;
+    artifacts: Array<RunBrowserToolArtifact>;
+    actions: Array<RunBrowserToolAction>;
+};

package/umd/src/book-components/Chat/utils/toolCallParsing/TeamToolResult.d.ts

@@ -0,0 +1,30 @@
+import type { ToolCall } from '../../../../types/ToolCall';
+/**
+ * Structured payload emitted by TEAM tool calls.
+ */
+export type TeamToolResult = {
+    teammate?: {
+        url?: string;
+        label?: string;
+        instructions?: string;
+        toolName?: string;
+        pseudoAgentKind?: 'USER' | 'VOID';
+    };
+    request?: string;
+    response?: string;
+    interaction?: {
+        kind?: string;
+        prompt?: string;
+    };
+    /**
+     * Tool calls executed by the teammate while answering.
+     */
+    toolCalls?: ReadonlyArray<ToolCall>;
+    error?: string | null;
+    conversation?: Array<{
+        sender?: string;
+        name?: string;
+        role?: string;
+        content?: string;
+    }>;
+};