@promptbook/node 0.110.0-1 → 0.110.0-10

package/esm/typings/src/_packages/components.index.d.ts

@@ -18,6 +18,8 @@ import { Chat } from '../book-components/Chat/Chat/Chat';
 import type { ChatSoundSystem } from '../book-components/Chat/Chat/ChatProps';
 import type { ChatProps } from '../book-components/Chat/Chat/ChatProps';
 import { ChatSoundToggle } from '../book-components/Chat/Chat/ChatSoundToggle';
+import { ChatVibrationToggle } from '../book-components/Chat/Chat/ChatSoundToggle';
+import { ChatSoundAndVibrationPanel } from '../book-components/Chat/Chat/ChatSoundToggle';
 import { ChatEffectsSystem } from '../book-components/Chat/effects/ChatEffectsSystem';
 import { ConfettiEffect } from '../book-components/Chat/effects/components/ConfettiEffect';
 import { HeartsEffect } from '../book-components/Chat/effects/components/HeartsEffect';
@@ -88,6 +90,8 @@ export { Chat };
 export type { ChatSoundSystem };
 export type { ChatProps };
 export { ChatSoundToggle };
+export { ChatVibrationToggle };
+export { ChatSoundAndVibrationPanel };
 export { ChatEffectsSystem };
 export { ConfettiEffect };
 export { HeartsEffect };

package/esm/typings/src/_packages/core.index.d.ts

@@ -1,7 +1,7 @@
 import { BOOK_LANGUAGE_VERSION, PROMPTBOOK_ENGINE_VERSION } from '../version';
 import { computeAgentHash } from '../book-2.0/agent-source/computeAgentHash';
 import { createAgentModelRequirements } from '../book-2.0/agent-source/createAgentModelRequirements';
-import { createAgentModelRequirementsWithCommitments } from '../book-2.0/agent-source/createAgentModelRequirementsWithCommitments';
+import type { CreateAgentModelRequirementsOptions } from '../book-2.0/agent-source/CreateAgentModelRequirementsOptions';
 import { createDefaultAgentName } from '../book-2.0/agent-source/createDefaultAgentName';
 import { normalizeAgentName } from '../book-2.0/agent-source/normalizeAgentName';
 import { PADDING_LINES } from '../book-2.0/agent-source/padBook';
@@ -205,7 +205,7 @@ import { PUBLIC_AGENTS_SERVERS } from '../../servers';
 export { BOOK_LANGUAGE_VERSION, PROMPTBOOK_ENGINE_VERSION };
 export { computeAgentHash };
 export { createAgentModelRequirements };
-export { createAgentModelRequirementsWithCommitments };
+export type { CreateAgentModelRequirementsOptions };
 export { createDefaultAgentName };
 export { normalizeAgentName };
 export { PADDING_LINES };

package/esm/typings/src/_packages/openai.index.d.ts

@@ -1,10 +1,10 @@
 import { BOOK_LANGUAGE_VERSION, PROMPTBOOK_ENGINE_VERSION } from '../version';
-import { createOpenAiAgentExecutionTools } from '../llm-providers/openai/createOpenAiAgentExecutionTools';
 import { createOpenAiAssistantExecutionTools } from '../llm-providers/openai/createOpenAiAssistantExecutionTools';
 import { createOpenAiCompatibleExecutionTools } from '../llm-providers/openai/createOpenAiCompatibleExecutionTools';
 import { createOpenAiExecutionTools } from '../llm-providers/openai/createOpenAiExecutionTools';
 import { OPENAI_MODELS } from '../llm-providers/openai/openai-models';
-import { OpenAiAgentExecutionTools } from '../llm-providers/openai/OpenAiAgentExecutionTools';
+import { OpenAiAgentKitExecutionTools } from '../llm-providers/openai/OpenAiAgentKitExecutionTools';
+import type { OpenAiAgentKitExecutionToolsOptions } from '../llm-providers/openai/OpenAiAgentKitExecutionToolsOptions';
 import { OpenAiAssistantExecutionTools } from '../llm-providers/openai/OpenAiAssistantExecutionTools';
 import type { OpenAiAssistantExecutionToolsOptions } from '../llm-providers/openai/OpenAiAssistantExecutionToolsOptions';
 import { OpenAiCompatibleExecutionTools } from '../llm-providers/openai/OpenAiCompatibleExecutionTools';
@@ -13,16 +13,18 @@ import type { OpenAiCompatibleExecutionToolsNonProxiedOptions } from '../llm-pro
 import type { OpenAiCompatibleExecutionToolsProxiedOptions } from '../llm-providers/openai/OpenAiCompatibleExecutionToolsOptions';
 import { OpenAiExecutionTools } from '../llm-providers/openai/OpenAiExecutionTools';
 import type { OpenAiExecutionToolsOptions } from '../llm-providers/openai/OpenAiExecutionToolsOptions';
+import type { OpenAiVectorStoreHandlerOptions } from '../llm-providers/openai/OpenAiVectorStoreHandler';
+import { OpenAiVectorStoreHandler } from '../llm-providers/openai/OpenAiVectorStoreHandler';
 import { _OpenAiRegistration } from '../llm-providers/openai/register-constructor';
 import { _OpenAiAssistantRegistration } from '../llm-providers/openai/register-constructor';
 import { _OpenAiCompatibleRegistration } from '../llm-providers/openai/register-constructor';
 export { BOOK_LANGUAGE_VERSION, PROMPTBOOK_ENGINE_VERSION };
-export { createOpenAiAgentExecutionTools };
 export { createOpenAiAssistantExecutionTools };
 export { createOpenAiCompatibleExecutionTools };
 export { createOpenAiExecutionTools };
 export { OPENAI_MODELS };
-export { OpenAiAgentExecutionTools };
+export { OpenAiAgentKitExecutionTools };
+export type { OpenAiAgentKitExecutionToolsOptions };
 export { OpenAiAssistantExecutionTools };
 export type { OpenAiAssistantExecutionToolsOptions };
 export { OpenAiCompatibleExecutionTools };
@@ -31,6 +33,8 @@ export type { OpenAiCompatibleExecutionToolsNonProxiedOptions };
 export type { OpenAiCompatibleExecutionToolsProxiedOptions };
 export { OpenAiExecutionTools };
 export type { OpenAiExecutionToolsOptions };
+export type { OpenAiVectorStoreHandlerOptions };
+export { OpenAiVectorStoreHandler };
 export { _OpenAiRegistration };
 export { _OpenAiAssistantRegistration };
 export { _OpenAiCompatibleRegistration };

package/esm/typings/src/_packages/types.index.d.ts

@@ -2,6 +2,7 @@ import type { BookParameter } from '../book-2.0/agent-source/AgentBasicInformati
 import type { AgentCapability } from '../book-2.0/agent-source/AgentBasicInformation';
 import type { AgentBasicInformation } from '../book-2.0/agent-source/AgentBasicInformation';
 import type { AgentModelRequirements } from '../book-2.0/agent-source/AgentModelRequirements';
+import type { CreateAgentModelRequirementsOptions } from '../book-2.0/agent-source/CreateAgentModelRequirementsOptions';
 import type { string_book } from '../book-2.0/agent-source/string_book';
 import type { AvatarChipProps } from '../book-components/AvatarProfile/AvatarChip/AvatarChip';
 import type { AvatarChipFromSourceProps } from '../book-components/AvatarProfile/AvatarChip/AvatarChipFromSource';
@@ -16,6 +17,8 @@ import type { AgentChipProps } from '../book-components/Chat/AgentChip/AgentChip
 import type { ChatSoundSystem } from '../book-components/Chat/Chat/ChatProps';
 import type { ChatProps } from '../book-components/Chat/Chat/ChatProps';
 import type { ChatSoundToggleProps } from '../book-components/Chat/Chat/ChatSoundToggle';
+import type { ChatVibrationToggleProps } from '../book-components/Chat/Chat/ChatSoundToggle';
+import type { ChatSoundAndVibrationPanelProps } from '../book-components/Chat/Chat/ChatSoundToggle';
 import type { ChatEffect } from '../book-components/Chat/effects/types/ChatEffect';
 import type { ChatEffectConfig } from '../book-components/Chat/effects/types/ChatEffectConfig';
 import type { ChatEffectsSystemProps } from '../book-components/Chat/effects/types/ChatEffectsSystemProps';
@@ -33,7 +36,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';
@@ -139,12 +141,13 @@ import type { AzureOpenAiExecutionToolsOptions } from '../llm-providers/azure-op
 import type { DeepseekExecutionToolsOptions } from '../llm-providers/deepseek/DeepseekExecutionToolsOptions';
 import type { GoogleExecutionToolsOptions } from '../llm-providers/google/GoogleExecutionToolsOptions';
 import type { OllamaExecutionToolsOptions } from '../llm-providers/ollama/OllamaExecutionToolsOptions';
-import type { OpenAiAgentExecutionToolsOptions } from '../llm-providers/openai/OpenAiAgentExecutionTools';
+import type { OpenAiAgentKitExecutionToolsOptions } from '../llm-providers/openai/OpenAiAgentKitExecutionToolsOptions';
 import type { OpenAiAssistantExecutionToolsOptions } from '../llm-providers/openai/OpenAiAssistantExecutionToolsOptions';
 import type { OpenAiCompatibleExecutionToolsOptions } from '../llm-providers/openai/OpenAiCompatibleExecutionToolsOptions';
 import type { OpenAiCompatibleExecutionToolsNonProxiedOptions } from '../llm-providers/openai/OpenAiCompatibleExecutionToolsOptions';
 import type { OpenAiCompatibleExecutionToolsProxiedOptions } from '../llm-providers/openai/OpenAiCompatibleExecutionToolsOptions';
 import type { OpenAiExecutionToolsOptions } from '../llm-providers/openai/OpenAiExecutionToolsOptions';
+import type { OpenAiVectorStoreHandlerOptions } from '../llm-providers/openai/OpenAiVectorStoreHandler';
 import type { VercelExecutionToolsOptions } from '../llm-providers/vercel/VercelExecutionToolsOptions';
 import type { VercelProvider } from '../llm-providers/vercel/VercelProvider';
 import type { IsPipelineImplementingInterfaceOptions } from '../pipeline/PipelineInterface/isPipelineImplementingInterface';
@@ -373,6 +376,7 @@ import type { number_gigabytes } from '../types/typeAliases';
 import type { number_terabytes } from '../types/typeAliases';
 import type { Updatable } from '../types/Updatable';
 import type { ColorTransformer } from '../utils/color/operators/ColorTransformer';
+import type { ThinkingMessageVariant } from '../utils/DEFAULT_THINKING_MESSAGES';
 import type { PipelineEditableSerialized } from '../utils/editable/types/PipelineEditableSerialized';
 import type { ExecCommandOptions } from '../utils/execCommand/ExecCommandOptions';
 import type { ExecCommandOptionsAdvanced } from '../utils/execCommand/ExecCommandOptions';
@@ -405,6 +409,7 @@ export type { BookParameter };
 export type { AgentCapability };
 export type { AgentBasicInformation };
 export type { AgentModelRequirements };
+export type { CreateAgentModelRequirementsOptions };
 export type { string_book };
 export type { AvatarChipProps };
 export type { AvatarChipFromSourceProps };
@@ -419,6 +424,8 @@ export type { AgentChipProps };
 export type { ChatSoundSystem };
 export type { ChatProps };
 export type { ChatSoundToggleProps };
+export type { ChatVibrationToggleProps };
+export type { ChatSoundAndVibrationPanelProps };
 export type { ChatEffect };
 export type { ChatEffectConfig };
 export type { ChatEffectsSystemProps };
@@ -436,7 +443,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 };
@@ -542,12 +548,13 @@ export type { AzureOpenAiExecutionToolsOptions };
 export type { DeepseekExecutionToolsOptions };
 export type { GoogleExecutionToolsOptions };
 export type { OllamaExecutionToolsOptions };
-export type { OpenAiAgentExecutionToolsOptions };
+export type { OpenAiAgentKitExecutionToolsOptions };
 export type { OpenAiAssistantExecutionToolsOptions };
 export type { OpenAiCompatibleExecutionToolsOptions };
 export type { OpenAiCompatibleExecutionToolsNonProxiedOptions };
 export type { OpenAiCompatibleExecutionToolsProxiedOptions };
 export type { OpenAiExecutionToolsOptions };
+export type { OpenAiVectorStoreHandlerOptions };
 export type { VercelExecutionToolsOptions };
 export type { VercelProvider };
 export type { IsPipelineImplementingInterfaceOptions };
@@ -776,6 +783,7 @@ export type { number_gigabytes };
 export type { number_terabytes };
 export type { Updatable };
 export type { ColorTransformer };
+export type { ThinkingMessageVariant };
 export type { PipelineEditableSerialized };
 export type { ExecCommandOptions };
 export type { ExecCommandOptionsAdvanced };

package/esm/typings/src/book-2.0/agent-source/AgentModelRequirements.d.ts

@@ -1,6 +1,6 @@
 import type { LlmToolDefinition } from '../../types/LlmToolDefinition';
 import type { string_agent_url, string_knowledge_source_link } from '../../types/typeAliases';
-import type { TODO_any } from '../../utils/organization/TODO_any';
+import { chococake } from '../../utils/organization/really_any';
 /**
  * Model requirements for an agent
  *
@@ -12,22 +12,16 @@ export type AgentModelRequirements = {
      */
     readonly systemMessage: string;
     /**
-     * The model name to use for this agent
+     * Text appended to every user prompt after the user's input and before tools/messages.
+     *
+     * This allows commitments to emphasize important rules or reminders that should be
+     * visible in the prompt in addition to the system message.
      */
-    readonly modelName: string;
+    readonly promptSuffix: string;
     /**
-     * Optional list of MCP servers that the agent can connect to
-     */
-    readonly mcpServers?: ReadonlyArray<string>;
-    /**
-     * Optional link to the parent agent from which this agent inherits
-     *
-     * Note: [🆓] There are several cases what the agent ancestor could be:
-     * -  1) `parentAgentUrl` is `string_agent_url` valid agent URL
-     * -  2) `parentAgentUrl` is explicitly `null` (forcefully no parent)
-     * -  3) `parentAgentUrl` is not defined `undefined`,  the default ancestor agent, Adam,  will be used
+     * The model name to use for this agent
      */
-    readonly parentAgentUrl?: string_agent_url | null;
+    readonly modelName: string;
     /**
      * List of imported agent URLs
      */
@@ -64,17 +58,24 @@ export type AgentModelRequirements = {
      */
     readonly tools?: ReadonlyArray<LlmToolDefinition>;
     /**
-     * Arbitrary metadata storage for commitments
-     * Each commitment can store its own data here
+     * Optional list of MCP servers that the agent can connect to
      */
-    readonly metadata?: Record<string, TODO_any>;
+    readonly mcpServers?: ReadonlyArray<string>;
     /**
-     * Notes associated with the agent
-     *
-     * Note: This does not affect agent behavior in any way
+     * The URL of the parent agent to inherit from, or null if there is no parent (i.e., do not inherit from any agent)
+     */
+    readonly parentAgentUrl: string_agent_url | null;
+    /**
+     * Is the agent closed to modification by conversation (i.e., it will not learn from interactions and its source code will remain static during conversation)
+     */
+    readonly isClosed: boolean;
+    /**
+     * Arbitrary metadata storage for commitments
+     * Each commitment can store its own data here
      */
-    readonly notes?: ReadonlyArray<string>;
+    readonly _metadata?: Record<string, chococake>;
 };
 /**
  * TODO: [🐤] DRY `AgentModelRequirements` and `ModelRequirements`
+ * TODO: [🧠] `isClosed` and `parentAgentUrl` doesn't truly belong to `AgentModelRequirements` nor agent profile but it is in the `AgentModelRequirements` because of some legacy - maybe figure out better place
  */

package/esm/typings/src/book-2.0/agent-source/AgentReferenceResolver.d.ts

@@ -0,0 +1,18 @@
+import type { BookCommitment } from '../../commitments/_base/BookCommitment';
+/**
+ * Resolves compact agent references that appear inside FROM, IMPORT, and TEAM commitments.
+ *
+ * Implementations are expected to rewrite reference tokens such as `{Activation code agent}`
+ * or `@Superagent` into concrete agent URLs before the commitment is applied.
+ *
+ * @private @@@
+ */
+export type AgentReferenceResolver = {
+    /**
+     * Normalizes the content of a commitment before it is applied to the model requirements.
+     *
+     * @param commitmentType - The commitment keyword (e.g. FROM, IMPORT, TEAM)
+     * @param content - Original payload of the commitment
+     */
+    resolveCommitmentContent(commitmentType: BookCommitment, content: string): Promise<string>;
+};

package/esm/typings/src/book-2.0/agent-source/CreateAgentModelRequirementsOptions.d.ts

@@ -0,0 +1,12 @@
+import type { AgentReferenceResolver } from './AgentReferenceResolver';
+/**
+ * Options for `createAgentModelRequirements` and `createAgentModelRequirementsWithCommitments`.
+ *
+ * @public exported from `@promptbook/core`
+ */
+export type CreateAgentModelRequirementsOptions = {
+    /**
+     * Resolver that transforms compact agent references (FROM, IMPORT, TEAM) into concrete URLs.
+     */
+    readonly agentReferenceResolver?: AgentReferenceResolver;
+};

package/esm/typings/src/book-2.0/agent-source/createAgentModelRequirements.d.ts

@@ -2,17 +2,23 @@ import type { AvailableModel } from '../../execution/AvailableModel';
 import type { LlmExecutionTools } from '../../execution/LlmExecutionTools';
 import type { string_agent_name, string_model_name, string_system_message, string_url_image } from '../../types/typeAliases';
 import type { AgentModelRequirements } from './AgentModelRequirements';
+import type { CreateAgentModelRequirementsOptions } from './CreateAgentModelRequirementsOptions';
 import type { string_book } from './string_book';
 /**
- * Creates model requirements for an agent based on its source
+ * Creates model requirements for an agent based on its source.
  *
  * There are 2 similar functions:
  * - `parseAgentSource` which is a lightweight parser for agent source, it parses basic information and its purpose is to be quick and synchronous. The commitments there are hardcoded.
  * - `createAgentModelRequirements` which is an asynchronous function that creates model requirements it applies each commitment one by one and works asynchronous.
  *
+ * @param agentSource - Book describing the agent.
+ * @param modelName - Optional override for the agent's model.
+ * @param availableModels - Models that could fulfill the agent.
+ * @param llmTools - Execution tools used when selecting a best model.
+ * @param options - Optional hooks such as the agent reference resolver.
  * @public exported from `@promptbook/core`
  */
-export declare function createAgentModelRequirements(agentSource: string_book, modelName?: string_model_name, availableModels?: readonly AvailableModel[], llmTools?: LlmExecutionTools): Promise<AgentModelRequirements>;
+export declare function createAgentModelRequirements(agentSource: string_book, modelName?: string_model_name, availableModels?: readonly AvailableModel[], llmTools?: LlmExecutionTools, options?: CreateAgentModelRequirementsOptions): Promise<AgentModelRequirements>;
 /**
  * Extracts MCP servers from agent source
  *

package/esm/typings/src/book-2.0/agent-source/createAgentModelRequirementsWithCommitments.agentReferenceResolver.test.d.ts

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

package/esm/typings/src/book-2.0/agent-source/createAgentModelRequirementsWithCommitments.d.ts

@@ -1,11 +1,10 @@
 import type { string_model_name } from '../../types/typeAliases';
 import type { AgentModelRequirements } from './AgentModelRequirements';
+import type { CreateAgentModelRequirementsOptions } from './CreateAgentModelRequirementsOptions';
 import type { string_book } from './string_book';
 /**
- * Creates agent model requirements using the new commitment system
- * This function uses a reduce-like pattern where each commitment applies its changes
- * to build the final requirements starting from a basic empty model
+ * @@@
  *
- * @public exported from `@promptbook/core`
+ * @private @@@
  */
-export declare function createAgentModelRequirementsWithCommitments(agentSource: string_book, modelName?: string_model_name): Promise<AgentModelRequirements>;
+export declare function createAgentModelRequirementsWithCommitments(agentSource: string_book, modelName?: string_model_name, options?: CreateAgentModelRequirementsOptions): Promise<AgentModelRequirements>;

package/esm/typings/src/book-components/Chat/AgentChip/AgentChip.d.ts

@@ -45,6 +45,10 @@ export type AgentChipProps = {
      * Additional CSS class name
      */
     className?: string;
+    /**
+     * Optional suffix appended to the agent label (e.g., " (2x)").
+     */
+    labelSuffix?: string;
 };
 /**
  * AgentChip component - displays a chip with agent avatar and name
@@ -64,4 +68,4 @@ export type AgentChipProps = {
  *
  * @private utility of `ChatMessageItem` component
  */
-export declare function AgentChip({ agent, isOngoing, isClickable, onClick, className }: AgentChipProps): import("react/jsx-runtime").JSX.Element;
+export declare function AgentChip({ agent, isOngoing, isClickable, onClick, className, labelSuffix, }: AgentChipProps): import("react/jsx-runtime").JSX.Element;

package/esm/typings/src/book-components/Chat/Chat/ChatActionsBar.d.ts

@@ -3,7 +3,6 @@ import type { Promisable } from 'type-fest';
 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 { ChatSoundSystem } from './ChatProps';
 /**
  * Props for the Chat actions toolbar.
  *
@@ -21,8 +20,11 @@ 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;
 };
 /**
  * Renders the action buttons row for Chat.

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

@@ -29,6 +29,7 @@ export type ChatInputAreaProps = {
     onChange?: ChatProps['onChange'];
     onFileUpload?: ChatProps['onFileUpload'];
     speechRecognition?: ChatProps['speechRecognition'];
+    speechRecognitionLanguage?: ChatProps['speechRecognitionLanguage'];
     defaultMessage?: string;
     placeholderMessageContent?: string;
     isFocusedOnLoad?: boolean;

package/esm/typings/src/book-components/Chat/Chat/ChatMessageItem.d.ts

@@ -52,6 +52,10 @@ type ChatMessageItemProps = Pick<ChatProps, 'onMessage' | 'participants'> & {
      * Called when a source citation chip is clicked.
      */
     onCitationClick?: (citation: ParsedCitation) => void;
+    /**
+     * Optional sound system for triggering tool chip events.
+     */
+    soundSystem?: ChatProps['soundSystem'];
 };
 /**
  * Metadata for a teammate agent tool.

package/esm/typings/src/book-components/Chat/Chat/ChatMessageList.d.ts

@@ -27,6 +27,7 @@ export type ChatMessageListProps = {
     teammates?: ChatProps['teammates'];
     onToolCallClick?: (toolCall: NonNullable<ChatMessage['toolCalls']>[number]) => void;
     onCitationClick?: (citation: ParsedCitation) => void;
+    soundSystem?: ChatProps['soundSystem'];
     setChatMessagesElement: (element: HTMLDivElement | null) => void;
     onScroll: (event: UIEvent<HTMLDivElement>) => void;
     chatMessagesClassName?: string;

package/esm/typings/src/book-components/Chat/Chat/ChatProps.d.ts

@@ -20,6 +20,16 @@ export type ChatSoundSystem = {
     isEnabled(): boolean;
     setEnabled(enabled: boolean): void;
     toggle(): boolean;
+    /**
+     * Optional helpers for haptic vibration state.
+     */
+    isVibrationEnabled?(): boolean;
+    setVibrationEnabled?(enabled: boolean): void;
+    toggleVibration?(): boolean;
+    /**
+     * Optional vibration helper to stay in sync with sound events.
+     */
+    vibrate?(event: string): void;
 };
 /**
  * @public exported from `@promptbook/components`
@@ -66,6 +76,11 @@ export type ChatProps = {
      * Speech recognition provider
      */
     readonly speechRecognition?: SpeechRecognition;
+    /**
+     * Optional language tag (BCP 47) to force speech recognition to use a specific language.
+     * When not provided, the browser preferences are used with a fallback to `en-US`.
+     */
+    readonly speechRecognitionLanguage?: string;
     /**
      * Optional placeholder message for the textarea
      *

package/esm/typings/src/book-components/Chat/Chat/ChatSoundToggle.d.ts

@@ -21,3 +21,34 @@ export type ChatSoundToggleProps = {
  * @public exported from `@promptbook/components`
  */
 export declare function ChatSoundToggle(props: ChatSoundToggleProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Props for the chat vibration toggle.
+ */
+export type ChatVibrationToggleProps = {
+    /**
+     * The sound system instance that supports vibration helpers.
+     */
+    soundSystem: ChatSoundSystem;
+    /**
+     * Optional CSS class name.
+     */
+    className?: string;
+};
+/**
+ * ChatVibrationToggle component that controls haptic feedback.
+ *
+ * @public exported from `@promptbook/components`
+ */
+export declare function ChatVibrationToggle(props: ChatVibrationToggleProps): import("react/jsx-runtime").JSX.Element | null;
+/**
+ * Props for the combined sound and vibration control panel.
+ */
+export type ChatSoundAndVibrationPanelProps = {
+    readonly soundSystem: ChatSoundSystem;
+};
+/**
+ * Renders a compact control panel that surfaces both sound and haptic toggles with richer affordances.
+ *
+ * @public exported from `@promptbook/components`
+ */
+export declare function ChatSoundAndVibrationPanel(props: ChatSoundAndVibrationPanelProps): import("react/jsx-runtime").JSX.Element;

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

@@ -62,6 +62,12 @@ export type LlmChatProps = Omit<ChatProps, 'messages' | 'onMessage' | 'onChange'
      * e.g., { "web_search": "Searching the web..." }
      */
     readonly toolTitles?: Record<string, string>;
+    /**
+     * Custom variants for the placeholder thinking message shown while the agent buffers its response.
+     *
+     * @default Shared thinking message variants
+     */
+    readonly thinkingMessages?: ReadonlyArray<string>;
     /**
      * Optional custom error handler that will be called when an error occurs during chat.
      * If not provided, errors will be displayed as messages in the chat.
@@ -69,5 +75,8 @@ export type LlmChatProps = Omit<ChatProps, 'messages' | 'onMessage' | 'onChange'
      * @param error - The error that occurred
      * @param retry - Function to retry the last failed message
      */
-    onError?(error: unknown, retry: () => void): void;
+    onError?(error: unknown, retry: () => void, failedMessage: {
+        content: string;
+        attachments: ChatMessage['attachments'];
+    }): void;
 };

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,36 +1,36 @@
 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 = {
     /**
-     * Display text for the chiplet
+     * Display text for the chiplet.
      */
     text: string;
     /**
-     * Agent data for team tools (if applicable)
+     * Agent data for team tools (if applicable).
      */
     agentData?: AgentChipData;
-    /**
-     * Whether to wrap the chip text in brackets when rendering.
-     *
-     * @default true
-     */
-    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;
     emoji: string;
-    wrapInBrackets?: boolean;
 }>;
 /**
  * Gets the chiplet information including text and agent data (for team tools).

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
  *