@promptbook/google 0.112.0-40 → 0.112.0-41

package/README.md

@@ -19,11 +19,13 @@ Create persistent AI agents that turn your company's scattered knowledge into ac
 [![🧪 Test types](https://github.com/webgptorg/promptbook/actions/workflows/test-types.yml/badge.svg)](https://github.com/webgptorg/promptbook/actions/workflows/test-types.yml)
 [![Issues](https://img.shields.io/github/issues/webgptorg/promptbook.svg?style=flat)](https://github.com/webgptorg/promptbook/issues)
 
+## 🚀 Quick deploy
 
 
-## 🌟 New Features
 
--   **Gemini 3 Support**
+[![Vercel](https://img.shields.io/badge/Vercel-Deploy%20Agents%20Server-black?logo=vercel)](https://vercel.com/new/clone?project-name=promptbook-agents-server&repository-name=promptbook-agents-server&repository-url=https%3A%2F%2Fgithub.com%2Fwebgptorg%2Fpromptbook&root-directory=apps%2Fagents-server&demo-title=Promptbook+Agents+Server&demo-description=Persistent+AI+agents+with+a+built-in+admin+UI.+This+deploy+creates+a+Supabase+project+automatically%2C+injects+the+required+database+credentials%2C+and+Promptbook+runs+the+SQL+migrations+on+first+startup.&demo-url=https%3A%2F%2Fgallery.ptbk.io%2F&external-id=https%3A%2F%2Fgithub.com%2Fwebgptorg%2Fpromptbook%2Ftree%2Fmain%2Fapps%2Fagents-server&env=OPENAI_API_KEY%2CADMIN_PASSWORD%2CSUPABASE_AUTO_MIGRATE&envDescription=Supabase+is+created+automatically+by+the+required+Vercel+integration.+Add+OPENAI_API_KEY+from+https%3A%2F%2Fplatform.openai.com%2Fapi-keys%2C+choose+ADMIN_PASSWORD+for+your+first+admin+login%2C+and+leave+SUPABASE_AUTO_MIGRATE+enabled.&envLink=https%3A%2F%2Fgithub.com%2Fwebgptorg%2Fpromptbook%2Fblob%2Fmain%2FREADME.md%23vercel-form-fields&envDefaults=%7B%22SUPABASE_AUTO_MIGRATE%22%3A%22true%22%7D&stores=%5B%7B%22type%22%3A%22integration%22%2C%22integrationSlug%22%3A%22supabase%22%2C%22productSlug%22%3A%22supabase%22%7D%5D)
+
+
 
 
 
@@ -669,28 +671,28 @@ npx ptbk coder verify
 
 #### What each command does
 
-| Command | What it does |
-| --- | --- |
-| `ptbk coder init` | Creates `prompts/`, `prompts/done/`, the project-generic template files materialized in `prompts/templates/` (currently `common.md`), and a starter `AGENTS.md`; ensures `.env` contains `CODING_AGENT_GIT_NAME`, `CODING_AGENT_GIT_EMAIL`, and `CODING_AGENT_GIT_SIGNING_KEY`; adds helper coder scripts to `package.json`; ensures `.gitignore` contains `/.tmp`; and configures `.vscode/settings.json` to save pasted prompt images into `prompts/screenshots/`. |
-| `ptbk coder generate-boilerplates` | Creates new prompt markdown files with fresh emoji tags so you can quickly fill in coding tasks; `--template` accepts either a built-in alias or a markdown file path relative to the project root. |
-| `ptbk coder run` | Picks the next ready prompt, appends optional context, runs it through the selected coding agent, marks success or failure, then commits and pushes the result. |
-| `ptbk coder find-refactor-candidates` | Scans the repository for oversized or overpacked files and writes prompt files for likely refactors; `--level <xlow|low|medium|high|xhigh|extreme>` ranges from a very benevolent scan to a very aggressive sweep. |
-| `ptbk coder verify` | Walks through completed prompts, archives truly finished work, and adds follow-up repair prompts for unfinished results. |
+| Command                               | What it does                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
+| ------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --- | ------ | ---- | ----- | ------------------------------------------------------------------------ |
+| `ptbk coder init`                     | Creates `prompts/`, `prompts/done/`, the project-generic template files materialized in `prompts/templates/` (currently `common.md`), and a starter `AGENTS.md`; ensures `.env` contains `CODING_AGENT_GIT_NAME`, `CODING_AGENT_GIT_EMAIL`, and `CODING_AGENT_GIT_SIGNING_KEY`; adds helper coder scripts to `package.json`; ensures `.gitignore` contains `/.tmp`; and configures `.vscode/settings.json` to save pasted prompt images into `prompts/screenshots/`. |
+| `ptbk coder generate-boilerplates`    | Creates new prompt markdown files with fresh emoji tags so you can quickly fill in coding tasks; `--template` accepts either a built-in alias or a markdown file path relative to the project root.                                                                                                                                                                                                                                                                  |
+| `ptbk coder run`                      | Picks the next ready prompt, appends optional context, runs it through the selected coding agent, marks success or failure, then commits and pushes the result.                                                                                                                                                                                                                                                                                                      |
+| `ptbk coder find-refactor-candidates` | Scans the repository for oversized or overpacked files and writes prompt files for likely refactors; `--level <xlow                                                                                                                                                                                                                                                                                                                                                  | low | medium | high | xhigh | extreme>` ranges from a very benevolent scan to a very aggressive sweep. |
+| `ptbk coder verify`                   | Walks through completed prompts, archives truly finished work, and adds follow-up repair prompts for unfinished results.                                                                                                                                                                                                                                                                                                                                             |
 
 #### Most useful `ptbk coder run` flags
 
-| Flag | Purpose |
-| --- | --- |
-| `--agent <name>` | Selects the coding backend. |
-| `--model <model>` | Chooses the runner model; required for `openai-codex` and `gemini`, optional for `github-copilot`. |
-| `--context <text-or-file>` | Appends extra instructions inline or from a file like `AGENTS.md`. |
-| `--thinking-level <level>` | Sets reasoning effort for supported runners. |
-| `--no-wait` | Skips interactive pauses between prompts for unattended execution. |
-| `--ignore-git-changes` | Disables the clean-working-tree guard. |
-| `--priority <n>` | Runs only prompts at or above the given priority. |
-| `--dry-run` | Prints which prompts are ready instead of executing them. |
-| `--allow-credits` | Lets OpenAI Codex spend credits when required. |
-| `--auto-migrate` | Runs testing-server database migrations after each successful prompt. |
+| Flag                       | Purpose                                                                                            |
+| -------------------------- | -------------------------------------------------------------------------------------------------- |
+| `--agent <name>`           | Selects the coding backend.                                                                        |
+| `--model <model>`          | Chooses the runner model; required for `openai-codex` and `gemini`, optional for `github-copilot`. |
+| `--context <text-or-file>` | Appends extra instructions inline or from a file like `AGENTS.md`.                                 |
+| `--thinking-level <level>` | Sets reasoning effort for supported runners.                                                       |
+| `--no-wait`                | Skips interactive pauses between prompts for unattended execution.                                 |
+| `--ignore-git-changes`     | Disables the clean-working-tree guard.                                                             |
+| `--priority <n>`           | Runs only prompts at or above the given priority.                                                  |
+| `--dry-run`                | Prints which prompts are ready instead of executing them.                                          |
+| `--allow-credits`          | Lets OpenAI Codex spend credits when required.                                                     |
+| `--auto-migrate`           | Runs testing-server database migrations after each successful prompt.                              |
 
 #### Typical usage pattern
 

package/esm/index.es.js

@@ -16,7 +16,7 @@ const BOOK_LANGUAGE_VERSION = '2.0.0';
  * @generated
  * @see https://github.com/webgptorg/promptbook
  */
-const PROMPTBOOK_ENGINE_VERSION = '0.112.0-40';
+const PROMPTBOOK_ENGINE_VERSION = '0.112.0-41';
 /**
  * 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/src/book-2.0/agent-source/createAgentModelRequirementsWithCommitments.d.ts

@@ -3,8 +3,14 @@ import type { AgentModelRequirements } from './AgentModelRequirements';
 import type { CreateAgentModelRequirementsOptions } from './CreateAgentModelRequirementsOptions';
 import type { string_book } from './string_book';
 /**
- * @@@
+ * Creates agent model requirements by parsing commitments, applying them in source order,
+ * and finalizing derived sections such as imports, example interactions, and inline knowledge uploads.
  *
- * @private @@@
+ * @param agentSource - Agent source book to parse.
+ * @param modelName - Optional override for the agent model name.
+ * @param options - Additional options such as reference and teammate resolvers.
+ * @returns Fully prepared model requirements for the parsed agent source.
+ *
+ * @private internal utility of `createAgentModelRequirements`
  */
 export declare function createAgentModelRequirementsWithCommitments(agentSource: string_book, modelName?: string_model_name, options?: CreateAgentModelRequirementsOptions): Promise<AgentModelRequirements>;

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

@@ -10,16 +10,6 @@ import type { ChatProps, ChatSoundSystem } from './ChatProps';
  * @private component of `<Chat/>`
  */
 export type ChatInputButtonClickHandler = (handler?: (event: MouseEvent<HTMLButtonElement>) => void) => (event: MouseEvent<HTMLButtonElement>) => void;
-/**
- * Internal representation of an uploaded file in the chat input.
- *
- * @private component of `<Chat/>`
- */
-export type ChatInputUploadedFile = {
-    id: string;
-    file: File;
-    content: string;
-};
 /**
  * Props for the chat input area.
  *

package/esm/src/book-components/Chat/Chat/ChatInputUploadedFile.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Internal representation of an uploaded file in the chat input.
+ *
+ * @private type of `<ChatInputArea/>`
+ */
+export type ChatInputUploadedFile = {
+    readonly id: string;
+    readonly file: File;
+    readonly content: string;
+};

package/esm/src/book-components/Chat/Chat/ChatToolCallModalContent.d.ts

@@ -0,0 +1,46 @@
+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';
+import { type TeamToolCallSummary, type TransitiveToolCall } from '../utils/collectTeamToolCallSummary';
+import type { AgentProfileData } from '../utils/loadAgentProfile';
+import type { TeamToolResult } from '../utils/toolCallParsing';
+import type { ChatUiTranslations } from './ChatProps';
+/**
+ * Tool-call snapshot rendered by the modal body.
+ *
+ * @private function of `ChatToolCallModalContent`
+ */
+type ToolCallModalToolCall = NonNullable<ChatMessage['toolCalls']>[number];
+/**
+ * Props consumed by `<ChatToolCallModalContent/>`.
+ *
+ * @private function of `ChatToolCallModalContent`
+ */
+type ChatToolCallModalContentProps = {
+    readonly agentParticipant?: ChatParticipant;
+    readonly availableTools?: ChatMessage['availableTools'];
+    readonly buttonColor: WithTake<Color>;
+    readonly chatUiTranslations?: ChatUiTranslations;
+    readonly focusedToolCall: ToolCallModalToolCall;
+    readonly isAdvancedView: boolean;
+    readonly locale?: string;
+    readonly onClearSelectedTeamToolCall: () => void;
+    readonly onRequestAdvancedView: () => void;
+    readonly onSelectTeamToolCall: (toolCall: TransitiveToolCall) => void;
+    readonly selectedTeamToolCall: TransitiveToolCall | null;
+    readonly teamProfiles: Record<string, AgentProfileData>;
+    readonly teamResult: TeamToolResult | null;
+    readonly teamToolCallSummary: TeamToolCallSummary;
+    readonly toolCall: ToolCallModalToolCall;
+    readonly toolCallDate: Date | null;
+    readonly toolTitles?: Record<string, string>;
+};
+/**
+ * Renders the simple TEAM view, the simple single-tool view, or the advanced raw-payload view.
+ *
+ * @private component of `ChatToolCallModal`
+ */
+export declare function ChatToolCallModalContent({ agentParticipant, availableTools, buttonColor, chatUiTranslations, focusedToolCall, isAdvancedView, locale, onClearSelectedTeamToolCall, onRequestAdvancedView, onSelectTeamToolCall, selectedTeamToolCall, teamProfiles, teamResult, teamToolCallSummary, toolCall, toolCallDate, toolTitles, }: ChatToolCallModalContentProps): ReactElement;
+export {};

package/esm/src/book-components/Chat/Chat/resolveRunBrowserToolCallDetailsState.d.ts

@@ -0,0 +1,146 @@
+import type { ToolCallLogEntry, ToolCallState } from '../../../types/ToolCall';
+import type { TODO_any } from '../../../utils/organization/TODO_any';
+import type { ChatMessage } from '../types/ChatMessage';
+import type { RunBrowserToolArtifact, RunBrowserToolError } from '../utils/toolCallParsing';
+/**
+ * One browser tool call rendered in the replay modal.
+ *
+ * @private type of resolveRunBrowserToolCallDetailsState
+ */
+type RunBrowserToolCall = NonNullable<ChatMessage['toolCalls']>[number];
+/**
+ * Rendering options needed to derive browser replay state.
+ *
+ * @private type of resolveRunBrowserToolCallDetailsState
+ */
+type ResolveRunBrowserToolCallDetailsStateOptions = {
+    /**
+     * Tool call being rendered.
+     */
+    toolCall: RunBrowserToolCall;
+    /**
+     * Parsed tool call arguments.
+     */
+    args: Record<string, TODO_any>;
+    /**
+     * Parsed tool result payload.
+     */
+    resultRaw: TODO_any;
+};
+/**
+ * Current visual state rendered for one browser action row in the modal.
+ *
+ * @private type of resolveRunBrowserToolCallDetailsState
+ */
+type BrowserActionRowState = 'pending' | 'running' | 'complete' | 'error';
+/**
+ * One browser action row rendered in the simple browser-tool view.
+ *
+ * @private type of resolveRunBrowserToolCallDetailsState
+ */
+type BrowserActionRow = {
+    /**
+     * Stable row key.
+     */
+    key: string;
+    /**
+     * Human-readable action summary.
+     */
+    label: string;
+    /**
+     * Current action state.
+     */
+    state: BrowserActionRowState;
+};
+/**
+ * One metadata row rendered in the browser replay summary block.
+ *
+ * @private type of resolveRunBrowserToolCallDetailsState
+ */
+type RunBrowserMetaItem = {
+    /**
+     * Stable key for React rendering.
+     */
+    key: string;
+    /**
+     * User-facing row label.
+     */
+    label: string;
+    /**
+     * User-facing row value.
+     */
+    value: string;
+    /**
+     * Optional link target when the value is a URL.
+     */
+    href?: string;
+};
+/**
+ * Fully derived browser replay state consumed by render helpers.
+ *
+ * @private type of resolveRunBrowserToolCallDetailsState
+ */
+type RunBrowserToolCallDetailsState = {
+    /**
+     * Original tool call currently being rendered.
+     */
+    toolCall: RunBrowserToolCall;
+    /**
+     * Resolved lifecycle state of the tool call snapshot.
+     */
+    toolCallState: ToolCallState;
+    /**
+     * Metadata rows shown at the top of the replay UI.
+     */
+    metaItems: Array<RunBrowserMetaItem>;
+    /**
+     * Browser-session log entry surfaced as a status banner.
+     */
+    browserReadyLog: ToolCallLogEntry | null;
+    /**
+     * Parsed browser warning message, when present.
+     */
+    warning: string | null;
+    /**
+     * Parsed fallback extracted content, when present.
+     */
+    fallbackContent: string | null;
+    /**
+     * Parsed browser error, when present.
+     */
+    runBrowserError: RunBrowserToolError | null;
+    /**
+     * Visual artifacts captured during the browser session.
+     */
+    artifacts: Array<RunBrowserToolArtifact>;
+    /**
+     * Ordered action rows combining requested actions, streamed logs, and final summaries.
+     */
+    actionRows: Array<BrowserActionRow>;
+    /**
+     * Indicates that the visual replay placeholder should be shown.
+     */
+    isVisualReplayPending: boolean;
+    /**
+     * Indicates that the empty visual replay state should be shown.
+     */
+    isVisualReplayEmpty: boolean;
+    /**
+     * Indicates that the action-plan placeholder should be shown.
+     */
+    isActionPlanPending: boolean;
+    /**
+     * Indicates that a streaming issue notice should be shown below the sections.
+     */
+    isStreamingErrorNoticeVisible: boolean;
+};
+/**
+ * Resolves all derived state needed by `renderRunBrowserToolCallDetails`.
+ *
+ * @param options - Raw browser tool-call data.
+ * @returns Derived state ready for focused render helpers.
+ *
+ * @private function of renderRunBrowserToolCallDetails
+ */
+export declare function resolveRunBrowserToolCallDetailsState(options: ResolveRunBrowserToolCallDetailsStateOptions): RunBrowserToolCallDetailsState;
+export {};

package/esm/src/book-components/Chat/Chat/useChatInputAreaAttachments.d.ts

@@ -1,5 +1,5 @@
 import { type ChangeEvent, type ClipboardEvent, type DragEvent } from 'react';
-import type { ChatInputUploadedFile } from './ChatInputArea';
+import type { ChatInputUploadedFile } from './ChatInputUploadedFile';
 import type { ChatProps } from './ChatProps';
 /**
  * Props for `useChatInputAreaAttachments`.

package/esm/src/book-components/Chat/Chat/useChatInputAreaComposer.d.ts

@@ -0,0 +1,39 @@
+import { type ChangeEvent, type KeyboardEvent as ReactKeyboardEvent, type MutableRefObject } from 'react';
+import type { ChatMessage } from '../types/ChatMessage';
+import type { ChatInputUploadedFile } from './ChatInputUploadedFile';
+import type { ChatProps, ChatSoundSystem } from './ChatProps';
+/**
+ * Props for `useChatInputAreaComposer`.
+ *
+ * @private function of `<ChatInputArea/>`
+ */
+type UseChatInputAreaComposerProps = {
+    readonly onMessage?: ChatProps['onMessage'];
+    readonly onChange?: ChatProps['onChange'];
+    readonly defaultMessage?: string;
+    readonly enterBehavior?: ChatProps['enterBehavior'];
+    readonly resolveEnterBehavior?: ChatProps['resolveEnterBehavior'];
+    readonly isFocusedOnLoad?: boolean;
+    readonly isMobile: boolean;
+    readonly uploadedFiles: ReadonlyArray<ChatInputUploadedFile>;
+    readonly uploadedFilesRef: MutableRefObject<Array<ChatInputUploadedFile>>;
+    readonly clearUploadedFiles: () => void;
+    readonly replyingToMessage?: ChatMessage | null;
+    readonly onCancelReply?: ChatProps['onCancelReply'];
+    readonly soundSystem?: ChatSoundSystem;
+};
+/**
+ * Manages textarea state, send/newline behavior, and deferred Enter resolution for `<ChatInputArea/>`.
+ *
+ * @private function of `<ChatInputArea/>`
+ */
+export declare function useChatInputAreaComposer(props: UseChatInputAreaComposerProps): {
+    textareaRef: import("react").RefObject<HTMLTextAreaElement | null>;
+    messageContent: string;
+    messageContentRef: import("react").RefObject<string>;
+    applyMessageContent: (nextContent: string) => void;
+    handleTextInputChange: (event: ChangeEvent<HTMLTextAreaElement>) => void;
+    handleComposerKeyDown: (event: ReactKeyboardEvent<HTMLTextAreaElement>) => void;
+    handleSend: () => Promise<void>;
+};
+export {};

package/esm/src/book-components/Chat/Chat/useChatPostprocessedMessages.d.ts

@@ -0,0 +1,17 @@
+import type { ChatMessage } from '../types/ChatMessage';
+/**
+ * Inputs required to normalize rendered chat messages.
+ *
+ * @private function of `useChatPostprocessedMessages`
+ */
+type UseChatPostprocessedMessagesProps = {
+    messages: ReadonlyArray<ChatMessage>;
+    isAiTextHumanizedAndPromptbookified: boolean;
+};
+/**
+ * Memoizes the render-only message normalization used by `<Chat/>`.
+ *
+ * @private function of `<Chat/>`
+ */
+export declare function useChatPostprocessedMessages({ messages, isAiTextHumanizedAndPromptbookified, }: UseChatPostprocessedMessagesProps): ReadonlyArray<ChatMessage>;
+export {};

package/esm/src/book-components/Chat/Chat/useChatScrollState.d.ts

@@ -0,0 +1,34 @@
+import { type MutableRefObject, type UIEvent } from 'react';
+import type { ChatMessage } from '../types/ChatMessage';
+/**
+ * Inputs required to coordinate Chat scroll behavior.
+ *
+ * @private function of `useChatScrollState`
+ */
+type UseChatScrollStateProps = {
+    messages: ReadonlyArray<ChatMessage>;
+};
+/**
+ * Public result consumed by `<Chat/>`.
+ *
+ * @private function of `useChatScrollState`
+ */
+type UseChatScrollStateResult = {
+    readonly actionsRef: MutableRefObject<HTMLDivElement | null>;
+    readonly ariaLabel: string;
+    readonly badgeLabel: string;
+    readonly handleChatScroll: (event: UIEvent<HTMLDivElement>) => void;
+    readonly isMobile: boolean;
+    readonly scrollToBottom: (behavior?: 'smooth' | 'auto') => void;
+    readonly setChatMessagesElement: (element: HTMLDivElement | null) => void;
+    readonly shouldDisableActions: boolean;
+    readonly shouldFadeActions: boolean;
+    readonly shouldShowScrollToBottom: boolean;
+};
+/**
+ * Coordinates auto-scroll, overlap tracking, and the scroll-to-bottom indicator for `<Chat/>`.
+ *
+ * @private function of `<Chat/>`
+ */
+export declare function useChatScrollState({ messages }: UseChatScrollStateProps): UseChatScrollStateResult;
+export {};

package/esm/src/book-components/Chat/Chat/useChatToolCallModalState.d.ts

@@ -0,0 +1,61 @@
+import { type MutableRefObject } from 'react';
+import type { AgentChipData } from '../AgentChip/AgentChip';
+import type { ChatMessage } from '../types/ChatMessage';
+import { type TeamToolCallSummary, type TransitiveToolCall } from '../utils/collectTeamToolCallSummary';
+import { type AgentProfileData } from '../utils/loadAgentProfile';
+import { type TeamToolResult } from '../utils/toolCallParsing';
+/**
+ * Tool-call snapshot rendered by the modal.
+ *
+ * @private function of `ChatToolCallModal`
+ */
+type ToolCallModalToolCall = NonNullable<ChatMessage['toolCalls']>[number];
+/**
+ * Export target used by the advanced tool-call report controls.
+ *
+ * @private function of `ChatToolCallModal`
+ */
+type ToolCallReportDestination = 'clipboard' | 'file';
+/**
+ * Inputs required to coordinate `<ChatToolCallModal/>` state.
+ *
+ * @private function of `useChatToolCallModalState`
+ */
+type UseChatToolCallModalStateProps = {
+    readonly isOpen: boolean;
+    readonly toolCall: ToolCallModalToolCall | null;
+    /**
+     * Stable identity of the selected tool call.
+     */
+    readonly toolCallIdentity?: string | null;
+    readonly onClose: () => void;
+    readonly toolTitles?: Record<string, string>;
+    readonly teamAgentProfiles?: Record<string, AgentChipData>;
+};
+/**
+ * State and callbacks consumed by `<ChatToolCallModal/>`.
+ *
+ * @private function of `useChatToolCallModalState`
+ */
+type UseChatToolCallModalStateResult = {
+    readonly clearSelectedTeamToolCall: () => void;
+    readonly exportAdvancedToolCallReport: (destination: ToolCallReportDestination) => Promise<void>;
+    readonly focusedToolCall: ToolCallModalToolCall | null;
+    readonly isAdvancedView: boolean;
+    readonly modalDialogRef: MutableRefObject<HTMLDivElement | null>;
+    readonly openAdvancedView: () => void;
+    readonly selectTeamToolCall: (toolCall: TransitiveToolCall) => void;
+    readonly selectedTeamToolCall: TransitiveToolCall | null;
+    readonly teamProfiles: Record<string, AgentProfileData>;
+    readonly teamResult: TeamToolResult | null;
+    readonly teamToolCallSummary: TeamToolCallSummary;
+    readonly toggleViewMode: () => void;
+    readonly toolCallDate: Date | null;
+};
+/**
+ * Coordinates derived data, modal lifecycle, and advanced-export actions for `<ChatToolCallModal/>`.
+ *
+ * @private function of `ChatToolCallModal`
+ */
+export declare function useChatToolCallModalState({ isOpen, toolCall, toolCallIdentity, onClose, toolTitles, teamAgentProfiles, }: UseChatToolCallModalStateProps): UseChatToolCallModalStateResult;
+export {};

package/esm/src/book-components/Chat/Chat/useChatToolCallState.d.ts

@@ -0,0 +1,35 @@
+import type { ToolCall } from '../../../types/ToolCall';
+import type { ChatMessage } from '../types/ChatMessage';
+import type { ParsedCitation } from '../utils/parseCitationsFromContent';
+/**
+ * Inputs required to keep Chat tool-call and citation modals in sync.
+ *
+ * @private function of `useChatToolCallState`
+ */
+type UseChatToolCallStateProps = {
+    messages: ReadonlyArray<ChatMessage>;
+};
+/**
+ * State and callbacks exposed back to `<Chat/>`.
+ *
+ * @private function of `useChatToolCallState`
+ */
+type UseChatToolCallStateResult = {
+    readonly citationModalOpen: boolean;
+    readonly closeCitationModal: () => void;
+    readonly closeToolCallModal: () => void;
+    readonly openCitation: (citation: ParsedCitation) => void;
+    readonly openToolCall: (toolCall: ToolCall) => void;
+    readonly selectedCitation: ParsedCitation | null;
+    readonly selectedMessageAvailableTools: ChatMessage['availableTools'];
+    readonly selectedToolCall: ToolCall | null;
+    readonly selectedToolCallIdentity: string | null;
+    readonly toolCallModalOpen: boolean;
+};
+/**
+ * Keeps Chat modal state focused on one selected tool call or citation.
+ *
+ * @private function of `<Chat/>`
+ */
+export declare function useChatToolCallState({ messages }: UseChatToolCallStateProps): UseChatToolCallStateResult;
+export {};

package/esm/src/book-components/Chat/LlmChat/useLlmChatMessageHandler.d.ts

@@ -0,0 +1,58 @@
+import { type Dispatch, type MutableRefObject, type SetStateAction } from 'react';
+import type { LlmExecutionTools } from '../../../execution/LlmExecutionTools';
+import type { id } from '../../../types/typeAliases';
+import type { ChatMessage } from '../types/ChatMessage';
+import type { LlmChatProps } from './LlmChatProps';
+/**
+ * Minimal task-progress item rendered by `<Chat/>`.
+ *
+ * @private function of `useLlmChatMessageHandler`
+ */
+type LlmChatTaskProgress = {
+    readonly id: string;
+    readonly name: string;
+    readonly progress?: number;
+};
+/**
+ * Internal send signature shared across retry and visibility-recovery flows.
+ *
+ * @private function of `useLlmChatMessageHandler`
+ */
+type HandleMessageFn = (messageContent: string, attachments?: ChatMessage['attachments']) => Promise<void>;
+/**
+ * Inputs required by `useLlmChatMessageHandler`.
+ *
+ * @private function of `useLlmChatMessageHandler`
+ */
+type UseLlmChatMessageHandlerProps = {
+    readonly chatFailMessage: string;
+    readonly hasUserInteractedRef: MutableRefObject<boolean>;
+    readonly llmParticipantName: id;
+    readonly llmTools: LlmExecutionTools;
+    readonly messages: ReadonlyArray<ChatMessage>;
+    readonly onError?: LlmChatProps['onError'];
+    readonly promptParameters: Record<string, string>;
+    readonly setMessages: Dispatch<SetStateAction<Array<ChatMessage>>>;
+    readonly setTasksProgress: Dispatch<SetStateAction<Array<LlmChatTaskProgress>>>;
+    readonly thinkingVariants: ReadonlyArray<string>;
+    readonly thread?: ReadonlyArray<ChatMessage>;
+    readonly userParticipantName: id;
+};
+/**
+ * State and handlers returned by `useLlmChatMessageHandler`.
+ *
+ * @private function of `useLlmChatMessageHandler`
+ */
+type UseLlmChatMessageHandlerResult = {
+    readonly clearLastFailedMessage: () => void;
+    readonly handleMessage: HandleMessageFn;
+    readonly handleStopStreaming: () => void;
+    readonly isStreaming: boolean;
+};
+/**
+ * Manages send, stream, retry, and background-recovery flows for `<LlmChat/>`.
+ *
+ * @private function of `useLlmChatState`
+ */
+export declare function useLlmChatMessageHandler(props: UseLlmChatMessageHandlerProps): UseLlmChatMessageHandlerResult;
+export {};

package/esm/src/book-components/Chat/LlmChat/useLlmChatMessages.d.ts

@@ -0,0 +1,29 @@
+import { type Dispatch, type MutableRefObject, type SetStateAction } from 'react';
+import type { ChatMessage } from '../types/ChatMessage';
+/**
+ * Inputs required to manage the persisted `<LlmChat/>` message list.
+ *
+ * @private function of `useLlmChatMessages`
+ */
+type UseLlmChatMessagesProps = {
+    readonly initialMessages?: ReadonlyArray<ChatMessage>;
+    readonly persistenceKey?: string;
+};
+/**
+ * State and helpers returned by `useLlmChatMessages`.
+ *
+ * @private function of `useLlmChatMessages`
+ */
+type UseLlmChatMessagesResult = {
+    readonly buildInitialMessages: () => Array<ChatMessage>;
+    readonly hasUserInteractedRef: MutableRefObject<boolean>;
+    readonly messages: Array<ChatMessage>;
+    readonly setMessages: Dispatch<SetStateAction<Array<ChatMessage>>>;
+};
+/**
+ * Manages initial seeding plus optional local persistence for `<LlmChat/>`.
+ *
+ * @private function of `useLlmChatState`
+ */
+export declare function useLlmChatMessages(props: UseLlmChatMessagesProps): UseLlmChatMessagesResult;
+export {};