@promptbook/javascript 0.111.0-3 → 0.111.0-7

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

@@ -0,0 +1,14 @@
+import type { UploadItem, UploadStats } from './useBookEditorMonacoUploads';
+type BookEditorMonacoUploadPanelProps = {
+    readonly activeUploadItems: UploadItem[];
+    readonly uploadStats: UploadStats;
+    readonly pauseUpload: (uploadId: string) => void;
+    readonly resumeUpload: (uploadId: string) => void;
+};
+/**
+ * Shows upload progress details for active uploads inside `BookEditorMonaco`.
+ *
+ * @private function of BookEditorMonaco
+ */
+export declare function BookEditorMonacoUploadPanel({ activeUploadItems, uploadStats, pauseUpload, resumeUpload, }: BookEditorMonacoUploadPanelProps): import("react/jsx-runtime").JSX.Element | null;
+export {};

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

@@ -0,0 +1,13 @@
+import type { editor } from 'monaco-editor';
+type MonacoEditor = typeof import('monaco-editor');
+type UseBookEditorMonacoDecorationsProps = {
+    readonly editor: editor.IStandaloneCodeEditor | null;
+    readonly monaco: MonacoEditor | null;
+};
+/**
+ * Adds visual decorations for separators and code blocks inside `BookEditorMonaco`.
+ *
+ * @private function of BookEditorMonaco
+ */
+export declare function useBookEditorMonacoDecorations({ editor, monaco }: UseBookEditorMonacoDecorationsProps): void;
+export {};

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

@@ -0,0 +1,23 @@
+import type { editor } from 'monaco-editor';
+type MonacoEditor = typeof import('monaco-editor');
+type BookEditorMonacoDiagnostic = {
+    readonly startLineNumber: number;
+    readonly startColumn: number;
+    readonly endLineNumber: number;
+    readonly endColumn: number;
+    readonly message: string;
+    readonly source?: string;
+    readonly severity?: 'error' | 'warning' | 'info' | 'hint';
+};
+type UseBookEditorMonacoDiagnosticsProps = {
+    readonly monaco: MonacoEditor | null;
+    readonly editor: editor.IStandaloneCodeEditor | null;
+    readonly diagnostics?: ReadonlyArray<BookEditorMonacoDiagnostic>;
+};
+/**
+ * Synchronizes Monaco markers with the diagnostics provided to `BookEditorMonaco`.
+ *
+ * @private function of BookEditorMonaco
+ */
+export declare function useBookEditorMonacoDiagnostics({ editor, monaco, diagnostics }: UseBookEditorMonacoDiagnosticsProps): void;
+export {};

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

@@ -0,0 +1,11 @@
+type MonacoEditor = typeof import('monaco-editor');
+type UseBookEditorMonacoLanguageProps = {
+    readonly monaco: MonacoEditor | null;
+};
+/**
+ * Registers the language helpers that power Monaco inside `BookEditorMonaco`.
+ *
+ * @private function of BookEditorMonaco
+ */
+export declare function useBookEditorMonacoLanguage({ monaco }: UseBookEditorMonacoLanguageProps): void;
+export {};

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

@@ -0,0 +1,14 @@
+type UseBookEditorMonacoStylesProps = {
+    readonly instanceClass: string;
+    readonly scaledLineHeight: number;
+    readonly scaledContentPaddingLeft: number;
+    readonly scaledVerticalLineLeft: number;
+    readonly zoomLevel: number;
+};
+/**
+ * Injects notebook-inspired styling that is unique per `BookEditorMonaco` instance.
+ *
+ * @private function of BookEditorMonaco
+ */
+export declare function useBookEditorMonacoStyles({ instanceClass, scaledLineHeight, scaledContentPaddingLeft, scaledVerticalLineLeft, zoomLevel, }: UseBookEditorMonacoStylesProps): void;
+export {};

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

@@ -0,0 +1,57 @@
+import type { editor } from 'monaco-editor';
+import type { Promisable } from 'type-fest';
+type MonacoEditor = typeof import('monaco-editor');
+type UploadStatus = 'queued' | 'uploading' | 'paused' | 'completed' | 'failed';
+export type UploadItem = {
+    readonly id: string;
+    readonly fileName: string;
+    readonly fileSize: number;
+    readonly status: UploadStatus;
+    readonly progress: number;
+    readonly loadedBytes: number;
+    readonly totalBytes: number;
+    readonly startedAt: number | null;
+    readonly completedAt: number | null;
+    readonly errorMessage?: string;
+};
+export type UploadStats = {
+    readonly totalFiles: number;
+    readonly queuedFiles: number;
+    readonly uploadingFiles: number;
+    readonly pausedFiles: number;
+    readonly failedFiles: number;
+    readonly completedFiles: number;
+    readonly totalBytes: number;
+    readonly uploadedBytes: number;
+    readonly progress: number;
+    readonly elapsedMs: number;
+    readonly speedBytesPerSecond: number;
+};
+type BookEditorMonacoUploadProgressCallback = (progress: number, stats?: {
+    loadedBytes: number;
+    totalBytes: number;
+}) => void;
+type BookEditorMonacoUploadOptions = {
+    readonly onProgress?: BookEditorMonacoUploadProgressCallback;
+    readonly abortSignal?: AbortSignal;
+};
+type BookEditorMonacoOnFileUpload = (file: File, options?: BookEditorMonacoUploadOptions | BookEditorMonacoUploadProgressCallback) => Promisable<string>;
+type UseBookEditorMonacoUploadsProps = {
+    readonly editor: editor.IStandaloneCodeEditor | null;
+    readonly monaco: MonacoEditor | null;
+    readonly onFileUpload?: BookEditorMonacoOnFileUpload;
+};
+/**
+ * Handles file uploads and placeholder rendering inside `BookEditorMonaco`.
+ *
+ * @private function of BookEditorMonaco
+ */
+export declare function useBookEditorMonacoUploads({ editor, monaco, onFileUpload }: UseBookEditorMonacoUploadsProps): {
+    activeUploadItems: UploadItem[];
+    uploadItems: UploadItem[];
+    uploadStats: UploadStats;
+    handleFiles: (files: File[]) => Promise<void>;
+    pauseUpload: (uploadId: string) => void;
+    resumeUpload: (uploadId: string) => void;
+};
+export {};

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

@@ -0,0 +1,17 @@
+import type { AgentChatProps } from './AgentChatProps';
+/**
+ * AgentChat component that provides chat functionality with LLM integration
+ *
+ * This component internally manages messages, participants, and task progress,
+ * and uses the provided LLM tools to generate responses via `LlmExecutionTools.callChatModel`.
+ *
+ * Note: There are multiple chat components:
+ * - `<Chat/>` renders chat as it is without any logic
+ * - `<AgentChat/>` connected to LLM Execution Tools of Promptbook
+ *
+ * @public exported from `@promptbook/components`
+ */
+export declare function AgentChat(props: AgentChatProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * TODO: !!!! Search ACRY ".meta.color" and make sure that we count that we count color can be array
+ */

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

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

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

@@ -0,0 +1,18 @@
+import { Agent } from '../../../llm-providers/agent/Agent';
+import type { LlmChatProps } from '../LlmChat/LlmChatProps';
+/**
+ * Props for AgentChat component, derived from LlmChatProps but with Agent-specific modifications
+ *
+ * @public exported from `@promptbook/components`
+ */
+export type AgentChatProps = Omit<LlmChatProps, 'thread' | 'llmTools' | 'initialMessages' | 'userParticipantName' | 'llmParticipantName'> & {
+    /**
+     * The agent to chat with
+     */
+    readonly agent: Agent;
+    /**
+     * Optional mapping of technical tool names to human-readable titles.
+     * e.g., { "web_search": "Searching the web..." }
+     */
+    readonly toolTitles?: Record<string, string>;
+};

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

@@ -0,0 +1,71 @@
+/// <reference types="react" />
+import type { string_url } from '../../../types/typeAliases';
+/**
+ * Agent profile information for chip display
+ */
+export type AgentChipData = {
+    /**
+     * Agent URL (required)
+     */
+    url: string_url;
+    /**
+     * Agent display name/label
+     */
+    label?: string;
+    /**
+     * Agent profile image URL
+     */
+    imageUrl?: string_url;
+    /**
+     * Public URL of the agents server (for generating placeholder images)
+     */
+    publicUrl?: string_url;
+};
+/**
+ * Props for AgentChip component
+ */
+export type AgentChipProps = {
+    /**
+     * Agent data to display
+     */
+    agent: AgentChipData;
+    /**
+     * Whether this is an ongoing interaction (shows spinner)
+     */
+    isOngoing?: boolean;
+    /**
+     * Whether this is clickable (completed state)
+     */
+    isClickable?: boolean;
+    /**
+     * Click handler
+     */
+    onClick?: (event?: React.MouseEvent) => void;
+    /**
+     * 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
+ *
+ * This component is used to display agent interactions in chat messages.
+ * It fetches the agent profile if needed and displays the agent's avatar and name.
+ *
+ * @example
+ * ```tsx
+ * <AgentChip
+ *   agent={{ url: 'https://agents.example.com/joe', label: 'Joe' }}
+ *   isOngoing={false}
+ *   isClickable={true}
+ *   onClick={() => console.log('clicked')}
+ * />
+ * ```
+ *
+ * @private utility of `ChatMessageItem` component
+ */
+export declare function AgentChip({ agent, isOngoing, isClickable, onClick, className, labelSuffix, }: AgentChipProps): import("react/jsx-runtime").JSX.Element;

package/umd/src/book-components/Chat/AgentChip/index.d.ts

@@ -0,0 +1,2 @@
+export { AgentChip } from './AgentChip';
+export type { AgentChipData, AgentChipProps } from './AgentChip';

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

@@ -0,0 +1,15 @@
+import type { ChatProps } from './ChatProps';
+/**
+ * Renders a chat with messages and input for new messages
+ *
+ * Note: 🔇 This component does NOT have speak functionality, it just allows to trigger voice recognition
+ *
+ * Note: There are multiple chat components:
+ * - `<Chat/>` renders chat as it is without any logic
+ * - `<LlmChat/>` connected to LLM Execution Tools of Promptbook
+ *
+ * Use <WorkerChat/> or <SignalChat/> in most cases.
+ *
+ * @public exported from `@promptbook/components`
+ */
+export declare function Chat(props: ChatProps): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,34 @@
+import { type MouseEvent, type MutableRefObject, type ReactNode } from 'react';
+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';
+/**
+ * Props for the Chat actions toolbar.
+ *
+ * @private component of `<Chat/>`
+ */
+export type ChatActionsBarProps = {
+    actionsRef: MutableRefObject<HTMLDivElement | null>;
+    actionsContainer?: HTMLElement | null;
+    messages: ReadonlyArray<ChatMessage>;
+    participants: ReadonlyArray<ChatParticipant>;
+    title: string;
+    onReset?: () => Promisable<void>;
+    onUseTemplate?: () => void;
+    extraActions?: ReactNode;
+    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;
+};
+/**
+ * Renders the action buttons row for Chat.
+ *
+ * @private component of `<Chat/>`
+ */
+export declare function ChatActionsBar(props: ChatActionsBarProps): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,21 @@
+import type { ChatParticipant } from '../types/ChatParticipant';
+import type { ParsedCitation } from '../utils/parseCitationsFromContent';
+import type { ChatSoundSystem } from './ChatProps';
+/**
+ * Props for the citation preview modal.
+ *
+ * @private component of `<Chat/>`
+ */
+export type ChatCitationModalProps = {
+    isOpen: boolean;
+    citation: ParsedCitation | null;
+    participants: ReadonlyArray<ChatParticipant>;
+    soundSystem?: ChatSoundSystem;
+    onClose: () => void;
+};
+/**
+ * Modal that previews a citation source or excerpt.
+ *
+ * @private component of `<Chat/>`
+ */
+export declare function ChatCitationModal(props: ChatCitationModalProps): import("react/jsx-runtime").JSX.Element | null;

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

@@ -0,0 +1,49 @@
+import { type MouseEvent } from 'react';
+import { Color } from '../../../utils/color/Color';
+import type { WithTake } from '../../../utils/take/interfaces/ITakeChain';
+import type { ChatParticipant } from '../types/ChatParticipant';
+import type { ChatProps, ChatSoundSystem } from './ChatProps';
+/**
+ * Wrapper for consistent button-click sound handling.
+ *
+ * @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.
+ *
+ * @private component of `<Chat/>`
+ */
+export type ChatInputAreaProps = {
+    onMessage?: ChatProps['onMessage'];
+    onChange?: ChatProps['onChange'];
+    onFileUpload?: ChatProps['onFileUpload'];
+    speechRecognition?: ChatProps['speechRecognition'];
+    speechRecognitionLanguage?: ChatProps['speechRecognitionLanguage'];
+    defaultMessage?: string;
+    placeholderMessageContent?: string;
+    isFocusedOnLoad?: boolean;
+    isMobile: boolean;
+    isVoiceCalling?: boolean;
+    participants: ReadonlyArray<ChatParticipant>;
+    buttonColor: WithTake<Color>;
+    soundSystem?: ChatSoundSystem;
+    onButtonClick: ChatInputButtonClickHandler;
+    chatInputClassName?: string;
+};
+/**
+ * Renders the chat input area with text, file upload, and voice controls.
+ *
+ * @private component of `<Chat/>`
+ */
+export declare function ChatInputArea(props: ChatInputAreaProps): import("react/jsx-runtime").JSX.Element | null;

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

@@ -0,0 +1,83 @@
+/// <reference types="react" />
+import type { id } from '../../../types/typeAliases';
+import type { ChatMessage } from '../types/ChatMessage';
+import type { ChatParticipant } from '../types/ChatParticipant';
+import { type ParsedCitation } from '../utils/parseCitationsFromContent';
+import type { ChatProps } from './ChatProps';
+/**
+ * Props for the `ChatMessageItem` component
+ *
+ * @private props for internal subcomponent
+ */
+type ChatMessageItemProps = Pick<ChatProps, 'onMessage' | 'participants'> & {
+    message: ChatMessage;
+    participant: ChatParticipant | undefined;
+    isLastMessage: boolean;
+    setExpandedMessageId: (value: id | null) => void;
+    isExpanded: boolean;
+    currentRating: number;
+    handleRating: (message: ChatMessage, rating: number) => void;
+    mode: 'LIGHT' | 'DARK';
+    /**
+     * Enables the copy button for this message bubble.
+     */
+    isCopyButtonEnabled?: boolean;
+    /**
+     * Enables the feedback (rating) UI for this message bubble.
+     */
+    isFeedbackEnabled?: boolean;
+    /**
+     * Called when the copy button is pressed.
+     */
+    onCopy?: () => void;
+    /**
+     * Called when the create agent button is pressed for book code blocks.
+     */
+    onCreateAgent?: (bookContent: string) => void;
+    /**
+     * Optional mapping of technical tool names to human-readable titles.
+     * e.g., { "web_search": "Searching the web..." }
+     */
+    toolTitles?: Record<string, string>;
+    /**
+     * Optional metadata about teammates for team tool calls
+     * Maps tool name to agent information
+     */
+    teammates?: TeammatesMap;
+    /**
+     * Called when a tool call chiplet is clicked.
+     */
+    onToolCallClick?: (toolCall: NonNullable<ChatMessage['toolCalls']>[number]) => void;
+    /**
+     * Called when a source citation chip is clicked.
+     */
+    onCitationClick?: (citation: ParsedCitation) => void;
+    /**
+     * Optional sound system for triggering tool chip events.
+     */
+    soundSystem?: ChatProps['soundSystem'];
+    /**
+     * Controls whether the play button below the message is shown.
+     */
+    isSpeechPlaybackEnabled?: ChatProps['isSpeechPlaybackEnabled'];
+};
+/**
+ * Metadata for a teammate agent tool.
+ */
+type TeammateMetadata = {
+    url: string;
+    label?: string;
+    instructions?: string;
+    toolName: string;
+};
+/**
+ * Lookup map of teammate metadata by tool name.
+ */
+type TeammatesMap = Record<string, TeammateMetadata>;
+/**
+ * Renders a single chat message item with avatar, content, buttons, and rating.
+ *
+ * @private internal subcomponent of `<Chat>` component
+ */
+export declare const ChatMessageItem: import("react").MemoExoticComponent<(props: ChatMessageItemProps) => import("react/jsx-runtime").JSX.Element>;
+export {};

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

@@ -0,0 +1,42 @@
+import type { UIEvent } from 'react';
+import type { Promisable } from 'type-fest';
+import type { id } from '../../../types/typeAliases';
+import type { ChatMessage } from '../types/ChatMessage';
+import type { ChatParticipant } from '../types/ChatParticipant';
+import type { ParsedCitation } from '../utils/parseCitationsFromContent';
+import type { ChatProps } from './ChatProps';
+/**
+ * Props for the Chat message list container.
+ *
+ * @private component of `<Chat/>`
+ */
+export type ChatMessageListProps = {
+    messages: ReadonlyArray<ChatMessage>;
+    participants: ReadonlyArray<ChatParticipant>;
+    expandedMessageId: id | null;
+    messageRatings: Map<id, number>;
+    setExpandedMessageId: (value: id | null) => void;
+    handleRating: (message: ChatMessage, rating: number) => void;
+    mode: 'LIGHT' | 'DARK';
+    isCopyButtonEnabled?: boolean;
+    isFeedbackEnabled?: boolean;
+    onCopy?: () => void;
+    onMessage?: (messageContent: string) => Promisable<void>;
+    onCreateAgent?: (bookContent: string) => void;
+    toolTitles?: Record<string, string>;
+    teammates?: ChatProps['teammates'];
+    onToolCallClick?: (toolCall: NonNullable<ChatMessage['toolCalls']>[number]) => void;
+    onCitationClick?: (citation: ParsedCitation) => void;
+    soundSystem?: ChatProps['soundSystem'];
+    isSpeechPlaybackEnabled?: ChatProps['isSpeechPlaybackEnabled'];
+    setChatMessagesElement: (element: HTMLDivElement | null) => void;
+    onScroll: (event: UIEvent<HTMLDivElement>) => void;
+    chatMessagesClassName?: string;
+    hasActions: boolean;
+};
+/**
+ * Renders the list of chat messages.
+ *
+ * @private component of `<Chat/>`
+ */
+export declare function ChatMessageList(props: ChatMessageListProps): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,17 @@
+import 'leaflet/dist/leaflet.css';
+import type { GeoJsonObject } from 'geojson';
+/**
+ * Props for `<ChatMessageMap/>`.
+ *
+ * @private internal helper of `<ChatMessageItem/>`
+ */
+type ChatMessageMapProps = {
+    data: GeoJsonObject;
+};
+/**
+ * Renders a Leaflet map for GeoJSON data inside the chat bubble and exposes a modal control for a larger view.
+ *
+ * @private internal helper of `<ChatMessageItem/>`
+ */
+export declare function ChatMessageMap({ data }: ChatMessageMapProps): import("react/jsx-runtime").JSX.Element;
+export {};