@promptbook/cli 0.112.0-96 → 0.112.0-98

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

@@ -1,5 +1,6 @@
 import { type MouseEvent, type MutableRefObject, type ReactNode } from 'react';
 import type { Promisable } from 'type-fest';
+import type { ChatSaveFormatHandlerMap } from '../save/_common/ChatSaveFormatHandler';
 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';
@@ -27,6 +28,7 @@ export type ChatActionsBarProps = {
     onUseTemplate?: () => void;
     extraActions?: ReactNode;
     saveFormats?: Array<string_chat_format_name>;
+    saveFormatHandlers?: ChatSaveFormatHandlerMap;
     isSaveButtonEnabled: boolean;
     shouldFadeActions: boolean;
     /**

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

@@ -8,6 +8,7 @@ import type { AgentChipData } from '../AgentChip/AgentChip';
 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 { ChatSaveFormatHandlerMap } from '../save/_common/ChatSaveFormatHandler';
 /**
  * Response data returned by the optional `onFeedback` handler.
  *
@@ -629,6 +630,11 @@ export type ChatProps = {
      * @default * All supported formats (see `string_chat_format_name` type)
      */
     readonly saveFormats?: Array<string_chat_format_name>;
+    /**
+     * Optional host-provided handlers that replace the default browser download flow
+     * for selected save formats.
+     */
+    readonly saveFormatHandlers?: ChatSaveFormatHandlerMap;
     /**
      * Is the writing textarea automatically focused?
      *

package/esm/src/book-components/Chat/save/_common/ChatSaveFormatHandler.d.ts

@@ -0,0 +1,35 @@
+import type { Promisable } from 'type-fest';
+import type { ChatMessage } from '../../types/ChatMessage';
+import type { ChatParticipant } from '../../types/ChatParticipant';
+import type { string_chat_format_name } from './string_chat_format_name';
+/**
+ * Serializable chat payload exposed to custom save-format handlers.
+ *
+ * @private Internal helper for chat save integrations.
+ */
+export type ChatSaveFormatHandlerOptions = {
+    /**
+     * Exported chat title used by downstream filename or document generation.
+     */
+    readonly title: string;
+    /**
+     * Messages included in the export.
+     */
+    readonly messages: ReadonlyArray<ChatMessage>;
+    /**
+     * Participant metadata included in the export.
+     */
+    readonly participants: ReadonlyArray<ChatParticipant>;
+};
+/**
+ * Custom handler used to override one chat save format.
+ *
+ * @private Internal helper for chat save integrations.
+ */
+export type ChatSaveFormatHandler = (options: ChatSaveFormatHandlerOptions) => Promisable<void>;
+/**
+ * Optional map of chat save formats handled by the host application.
+ *
+ * @private Internal helper for chat save integrations.
+ */
+export type ChatSaveFormatHandlerMap = Partial<Record<string_chat_format_name, ChatSaveFormatHandler>>;

package/esm/src/book-components/Chat/save/_common/createChatExportFilename.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Builds one normalized filename for a chat export download.
+ *
+ * @param title - Human-readable chat title.
+ * @param fileExtension - Output file extension without a leading dot.
+ * @param date - Export date used in the filename.
+ * @returns Stable filename suitable for browser downloads and HTTP headers.
+ *
+ * @private Internal helper shared by chat export flows.
+ */
+export declare function createChatExportFilename(title: string, fileExtension: string, date?: Date): string;

package/esm/src/version.d.ts

@@ -15,7 +15,7 @@ export declare const BOOK_LANGUAGE_VERSION: string_semantic_version;
 export declare const PROMPTBOOK_ENGINE_VERSION: string_promptbook_version;
 /**
  * Represents the version string of the Promptbook engine.
- * It follows semantic versioning (e.g., `0.112.0-94`).
+ * It follows semantic versioning (e.g., `0.112.0-97`).
  *
  * @generated
  */

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@promptbook/cli",
-    "version": "0.112.0-96",
+    "version": "0.112.0-98",
     "description": "Promptbook: Create persistent AI agents that turn your company's scattered knowledge into action",
     "private": false,
     "sideEffects": false,

package/src/book-components/Chat/Chat/Chat.tsx

@@ -107,6 +107,7 @@ export function Chat(props: ChatProps) {
         extraActions,
         actionsContainer,
         saveFormats,
+        saveFormatHandlers,
         isSaveButtonEnabled = true,
         isCopyButtonEnabled = true,
         buttonColor: buttonColorRaw,
@@ -315,6 +316,7 @@ export function Chat(props: ChatProps) {
                         onUseTemplate={onUseTemplate}
                         extraActions={extraActions}
                         saveFormats={saveFormats}
+                        saveFormatHandlers={saveFormatHandlers}
                         isSaveButtonEnabled={isSaveButtonEnabled}
                         shouldFadeActions={shouldFadeActions}
                         shouldDisableActions={shouldDisableActions}

package/src/book-components/Chat/Chat/ChatActionsBar.tsx

@@ -3,11 +3,12 @@
 import { useCallback, useEffect, useState, type MouseEvent, type MutableRefObject, type ReactNode } from 'react';
 import { createPortal } from 'react-dom';
 import type { Promisable } from 'type-fest';
-import { normalizeToKebabCase } from '../../../utils/normalization/normalize-to-kebab-case';
 import { classNames } from '../../_common/react-utils/classNames';
 import { ResetIcon } from '../../icons/ResetIcon';
 import { SaveIcon } from '../../icons/SaveIcon';
 import { TemplateIcon } from '../../icons/TemplateIcon';
+import type { ChatSaveFormatHandlerMap } from '../save/_common/ChatSaveFormatHandler';
+import { createChatExportFilename } from '../save/_common/createChatExportFilename';
 import { getChatSaveFormatDefinitions } from '../save/_common/getChatSaveFormatDefinitions';
 import type { string_chat_format_name } from '../save/_common/string_chat_format_name';
 import type { ChatMessage } from '../types/ChatMessage';
@@ -38,6 +39,7 @@ export type ChatActionsBarProps = {
     onUseTemplate?: () => void;
     extraActions?: ReactNode;
     saveFormats?: Array<string_chat_format_name>;
+    saveFormatHandlers?: ChatSaveFormatHandlerMap;
     isSaveButtonEnabled: boolean;
     shouldFadeActions: boolean;
     /**
@@ -71,6 +73,7 @@ export function ChatActionsBar(props: ChatActionsBarProps) {
         onUseTemplate,
         extraActions,
         saveFormats,
+        saveFormatHandlers,
         isSaveButtonEnabled,
         shouldFadeActions,
         shouldDisableActions,
@@ -98,23 +101,28 @@ export function ChatActionsBar(props: ChatActionsBarProps) {
 
     const handleDownload = useCallback(
         async (format: string_chat_format_name) => {
+            const customSaveFormatHandler = saveFormatHandlers?.[format];
+            if (customSaveFormatHandler) {
+                await customSaveFormatHandler({
+                    title,
+                    messages,
+                    participants,
+                });
+                setShowSaveMenu(false);
+                return;
+            }
+
             const formatDefinition = getChatSaveFormatDefinitions([format])[0];
             if (!formatDefinition) {
                 return;
             }
 
-            const date = new Date();
-            const dateName = `${date.getFullYear()}-${(date.getMonth() + 1).toString().padStart(2, '0')}-${date
-                .getDate()
-                .toString()
-                .padStart(2, '0')}`;
-
             const content = await formatDefinition.getContent({ title, messages, participants });
             const blob = new Blob([content], { type: formatDefinition.mimeType });
             const url = URL.createObjectURL(blob);
             const link = document.createElement('a');
             link.href = url;
-            link.download = `${normalizeToKebabCase(title)}-${dateName}.${formatDefinition.fileExtension}`;
+            link.download = createChatExportFilename(title, formatDefinition.fileExtension);
             document.body.appendChild(link);
             link.click();
             setTimeout(() => {
@@ -123,7 +131,7 @@ export function ChatActionsBar(props: ChatActionsBarProps) {
             }, 100);
             setShowSaveMenu(false);
         },
-        [messages, participants, title],
+        [messages, participants, saveFormatHandlers, title],
     );
 
     const firstMessageFromUser = messages[0]?.sender === 'USER';

package/src/book-components/Chat/Chat/ChatProps.tsx

@@ -12,6 +12,7 @@ import type { AgentChipData } from '../AgentChip/AgentChip';
 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 { ChatSaveFormatHandlerMap } from '../save/_common/ChatSaveFormatHandler';
 
 /**
  * Response data returned by the optional `onFeedback` handler.
@@ -728,6 +729,12 @@ export type ChatProps = {
      */
     readonly saveFormats?: Array<string_chat_format_name>;
 
+    /**
+     * Optional host-provided handlers that replace the default browser download flow
+     * for selected save formats.
+     */
+    readonly saveFormatHandlers?: ChatSaveFormatHandlerMap;
+
     /**
      * Is the writing textarea automatically focused?
      *

package/src/book-components/Chat/save/_common/ChatSaveFormatHandler.ts

@@ -0,0 +1,40 @@
+import type { Promisable } from 'type-fest';
+import type { ChatMessage } from '../../types/ChatMessage';
+import type { ChatParticipant } from '../../types/ChatParticipant';
+import type { string_chat_format_name } from './string_chat_format_name';
+
+/**
+ * Serializable chat payload exposed to custom save-format handlers.
+ *
+ * @private Internal helper for chat save integrations.
+ */
+export type ChatSaveFormatHandlerOptions = {
+    /**
+     * Exported chat title used by downstream filename or document generation.
+     */
+    readonly title: string;
+
+    /**
+     * Messages included in the export.
+     */
+    readonly messages: ReadonlyArray<ChatMessage>;
+
+    /**
+     * Participant metadata included in the export.
+     */
+    readonly participants: ReadonlyArray<ChatParticipant>;
+};
+
+/**
+ * Custom handler used to override one chat save format.
+ *
+ * @private Internal helper for chat save integrations.
+ */
+export type ChatSaveFormatHandler = (options: ChatSaveFormatHandlerOptions) => Promisable<void>;
+
+/**
+ * Optional map of chat save formats handled by the host application.
+ *
+ * @private Internal helper for chat save integrations.
+ */
+export type ChatSaveFormatHandlerMap = Partial<Record<string_chat_format_name, ChatSaveFormatHandler>>;

package/src/book-components/Chat/save/_common/createChatExportFilename.ts

@@ -0,0 +1,20 @@
+import { normalizeToKebabCase } from '../../../../utils/normalization/normalize-to-kebab-case';
+
+/**
+ * Builds one normalized filename for a chat export download.
+ *
+ * @param title - Human-readable chat title.
+ * @param fileExtension - Output file extension without a leading dot.
+ * @param date - Export date used in the filename.
+ * @returns Stable filename suitable for browser downloads and HTTP headers.
+ *
+ * @private Internal helper shared by chat export flows.
+ */
+export function createChatExportFilename(title: string, fileExtension: string, date = new Date()): string {
+    const dateName = `${date.getFullYear()}-${(date.getMonth() + 1).toString().padStart(2, '0')}-${date
+        .getDate()
+        .toString()
+        .padStart(2, '0')}`;
+
+    return `${normalizeToKebabCase(title)}-${dateName}.${fileExtension}`;
+}

package/src/book-components/Chat/utils/renderMarkdown.ts

@@ -311,9 +311,7 @@ function normalizeSanitizedUrlValue(value: string): string {
         .filter((character) => {
             const characterCode = character.charCodeAt(0);
 
-            return (
-                characterCode > MAX_ASCII_CONTROL_CHARACTER_CODE && characterCode !== ASCII_DELETE_CHARACTER_CODE
-            );
+            return characterCode > MAX_ASCII_CONTROL_CHARACTER_CODE && characterCode !== ASCII_DELETE_CHARACTER_CODE;
         })
         .join('');
 }