@promptbook/utils 0.112.0-22 → 0.112.0-24

package/esm/index.es.js

@@ -18,7 +18,7 @@ const BOOK_LANGUAGE_VERSION = '2.0.0';
  * @generated
  * @see https://github.com/webgptorg/promptbook
  */
-const PROMPTBOOK_ENGINE_VERSION = '0.112.0-22';
+const PROMPTBOOK_ENGINE_VERSION = '0.112.0-24';
 /**
  * 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/_packages/components.index.d.ts

@@ -16,6 +16,7 @@ import { AgentChat } from '../book-components/Chat/AgentChat/AgentChat';
 import type { AgentChatProps } from '../book-components/Chat/AgentChat/AgentChatProps';
 import { Chat } from '../book-components/Chat/Chat/Chat';
 import type { ChatFeedbackResponse } from '../book-components/Chat/Chat/ChatProps';
+import type { ChatFeedbackMode } from '../book-components/Chat/Chat/ChatProps';
 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';
@@ -54,6 +55,8 @@ import { mdSaveFormatDefinition } from '../book-components/Chat/save/markdown/md
 import { pdfSaveFormatDefinition } from '../book-components/Chat/save/pdf/pdfSaveFormatDefinition';
 import { reactSaveFormatDefinition } from '../book-components/Chat/save/react/reactSaveFormatDefinition';
 import { txtSaveFormatDefinition } from '../book-components/Chat/save/text/txtSaveFormatDefinition';
+import type { ChatProgressItem } from '../book-components/Chat/types/ChatMessage';
+import type { ChatProgressCard } 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 { MessageButton } from '../book-components/Chat/utils/parseMessageButtons';
@@ -90,6 +93,7 @@ export { AgentChat };
 export type { AgentChatProps };
 export { Chat };
 export type { ChatFeedbackResponse };
+export type { ChatFeedbackMode };
 export type { ChatSoundSystem };
 export type { ChatProps };
 export { ChatSoundToggle };
@@ -128,6 +132,8 @@ export { mdSaveFormatDefinition };
 export { pdfSaveFormatDefinition };
 export { reactSaveFormatDefinition };
 export { txtSaveFormatDefinition };
+export type { ChatProgressItem };
+export type { ChatProgressCard };
 export type { ChatMessage };
 export type { ChatParticipant };
 export type { MessageButton };

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

@@ -17,6 +17,7 @@ import type { AgentChatProps } from '../book-components/Chat/AgentChat/AgentChat
 import type { AgentChipData } from '../book-components/Chat/AgentChip/AgentChip';
 import type { AgentChipProps } from '../book-components/Chat/AgentChip/AgentChip';
 import type { ChatFeedbackResponse } from '../book-components/Chat/Chat/ChatProps';
+import type { ChatFeedbackMode } from '../book-components/Chat/Chat/ChatProps';
 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';
@@ -37,6 +38,8 @@ import type { ChatSaveFormatDefinition } from '../book-components/Chat/save/_com
 import type { string_chat_format_name } from '../book-components/Chat/save/_common/string_chat_format_name';
 import type { SourceChipProps } from '../book-components/Chat/SourceChip/SourceChip';
 import type { ChatToolCall } from '../book-components/Chat/types/ChatMessage';
+import type { ChatProgressItem } from '../book-components/Chat/types/ChatMessage';
+import type { ChatProgressCard } 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 { ParsedCitation } from '../book-components/Chat/utils/parseCitationsFromContent';
@@ -438,6 +441,7 @@ export type { AgentChatProps };
 export type { AgentChipData };
 export type { AgentChipProps };
 export type { ChatFeedbackResponse };
+export type { ChatFeedbackMode };
 export type { ChatSoundSystem };
 export type { ChatProps };
 export type { ChatSoundToggleProps };
@@ -458,6 +462,8 @@ export type { ChatSaveFormatDefinition };
 export type { string_chat_format_name };
 export type { SourceChipProps };
 export type { ChatToolCall };
+export type { ChatProgressItem };
+export type { ChatProgressCard };
 export type { ChatMessage };
 export type { ChatParticipant };
 export type { ParsedCitation };

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

@@ -26,6 +26,10 @@ type ChatMessageItemProps = Pick<ChatProps, 'onMessage' | 'onActionButton' | 'pa
      * Enables the feedback (rating) UI for this message bubble.
      */
     isFeedbackEnabled?: boolean;
+    /**
+     * Chooses which feedback controls should be rendered.
+     */
+    feedbackMode?: ChatProps['feedbackMode'];
     /**
      * Called when the copy button is pressed.
      */

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

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

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

@@ -20,6 +20,10 @@ export type ChatMessageListProps = {
     mode: 'LIGHT' | 'DARK';
     isCopyButtonEnabled?: boolean;
     isFeedbackEnabled?: boolean;
+    /**
+     * Chooses which feedback controls should be rendered.
+     */
+    feedbackMode?: ChatProps['feedbackMode'];
     onCopy?: () => void;
     onMessage?: (messageContent: string) => Promisable<void>;
     onActionButton?: ChatProps['onActionButton'];

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

@@ -18,6 +18,12 @@ export type ChatFeedbackResponse = {
      */
     readonly message?: string;
 };
+/**
+ * Visual mode for post-response feedback actions.
+ *
+ * @public exported from `@promptbook/components`
+ */
+export type ChatFeedbackMode = 'off' | 'stars' | 'report_issue';
 /**
  * Interface for sound system that can be passed to Chat component
  * This allows the chat to trigger sounds without tight coupling
@@ -275,11 +281,11 @@ export type ChatProps = {
     onCreateAgent?: (bookContent: string) => void;
     /**
      * Optional callback for handling user feedback on messages
-     * When provided, star rating buttons (1-5 stars) will be displayed next to each message
+     * When provided, message feedback actions are displayed according to `feedbackMode`.
      *
      * @param feedback - Object containing the feedback data
      * @param feedback.message - The message being rated
-     * @param feedback.rating - Star rating from 1 to 5
+     * @param feedback.rating - Numeric feedback rating value
      * @param feedback.textRating - Optional text feedback/note from user
      * @param feedback.chatThread - Complete chat thread as string
      * @param feedback.expectedAnswer - Optional expected answer provided by user
@@ -293,6 +299,12 @@ export type ChatProps = {
         expectedAnswer: string | null;
         url: string;
     }): Promisable<void>;
+    /**
+     * Selects which feedback action UI is shown on assistant responses.
+     *
+     * @default 'stars'
+     */
+    readonly feedbackMode?: ChatFeedbackMode;
     /**
      * Optional callback for handling file uploads
      * When provided, enables file upload functionality via drag-and-drop and file button

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

@@ -1,5 +1,6 @@
 import type { id } from '../../../types/typeAliases';
 import type { ChatMessage } from '../types/ChatMessage';
+import type { ChatFeedbackMode } from './ChatProps';
 /**
  * Props for the rating modal used in Chat.
  *
@@ -13,6 +14,10 @@ export type ChatRatingModalProps = {
     hoveredRating: number;
     messageRatings: Map<id, number>;
     textRating: string;
+    /**
+     * Chooses which feedback flow the modal should render.
+     */
+    feedbackMode: ChatFeedbackMode;
     mode: 'LIGHT' | 'DARK';
     isMobile: boolean;
     onClose: () => void;

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

@@ -19,6 +19,10 @@ export type SourceChipProps = {
      * Optional suffix text to display after the citation label.
      */
     suffix?: string;
+    /**
+     * Controls whether the technical citation id is shown inside the chip label.
+     */
+    isCitationIdVisible?: boolean;
 };
 /**
  * SourceChip component - displays a chip with source document information
@@ -36,4 +40,4 @@ export type SourceChipProps = {
  *
  * @private utility of `ChatMessageItem` component
  */
-export declare function SourceChip({ citation, onClick, className, suffix }: SourceChipProps): import("react/jsx-runtime").JSX.Element;
+export declare function SourceChip({ citation, onClick, className, suffix, isCitationIdVisible }: SourceChipProps): import("react/jsx-runtime").JSX.Element;

package/esm/src/book-components/Chat/hooks/useChatRatings.d.ts

@@ -1,7 +1,7 @@
 import type { Promisable } from 'type-fest';
 import type { id } from '../../../types/typeAliases';
 import type { ChatMessage } from '../types/ChatMessage';
-import type { ChatFeedbackResponse } from '../Chat/ChatProps';
+import type { ChatFeedbackMode, ChatFeedbackResponse } from '../Chat/ChatProps';
 /**
  * Input parameters for the chat rating hook.
  *
@@ -23,6 +23,10 @@ export type UseChatRatingsOptions = {
         expectedAnswer: string | null;
         url: string;
     }) => Promisable<ChatFeedbackResponse | void>;
+    /**
+     * Feedback mode currently used by the chat UI.
+     */
+    feedbackMode: ChatFeedbackMode;
     /**
      * Whether the UI should apply mobile-specific behavior.
      */

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

@@ -2,6 +2,56 @@ import { Message } from '../../../types/Message';
 import type { ToolCall } from '../../../types/ToolCall';
 import type { id, string_date_iso8601, string_markdown } from '../../../types/typeAliases';
 export type ChatToolCall = ToolCall;
+/**
+ * One item in a user-facing progress card shown while assistant response is still running.
+ *
+ * @public exported from `@promptbook/components`
+ */
+export type ChatProgressItem = {
+    /**
+     * Stable item id used for incremental updates.
+     */
+    readonly id: string;
+    /**
+     * Item text in markdown.
+     */
+    readonly text: string_markdown;
+    /**
+     * Item status shown by the UI.
+     */
+    readonly status: 'pending' | 'completed';
+};
+/**
+ * Structured progress card rendered in place of generic thinking placeholders.
+ *
+ * @public exported from `@promptbook/components`
+ */
+export type ChatProgressCard = {
+    /**
+     * Optional title shown at the top of the panel.
+     */
+    readonly title?: string_markdown;
+    /**
+     * Optional markdown section describing current work.
+     */
+    readonly now?: string_markdown;
+    /**
+     * Optional markdown section describing upcoming work.
+     */
+    readonly next?: string_markdown;
+    /**
+     * Ordered bullet items representing in-progress or completed tasks.
+     */
+    readonly items: ReadonlyArray<ChatProgressItem>;
+    /**
+     * Optional timestamp when this card was last updated.
+     */
+    readonly updatedAt?: string_date_iso8601;
+    /**
+     * Optional visibility flag allowing explicit panel hide before final answer.
+     */
+    readonly isVisible?: boolean;
+};
 /**
  * Represents a single message within a chat interface.
  *
@@ -111,6 +161,10 @@ export type ChatMessage = Omit<Message<id>, 'direction' | 'recipients' | 'thread
          */
         excerpt?: string;
     }>;
+    /**
+     * Optional structured progress-card payload shown while a response is still in progress.
+     */
+    readonly progressCard?: ChatProgressCard;
 };
 /**
  * TODO: Make all fields readonly

package/esm/src/book-components/Chat/utils/createCitationFootnoteRenderModel.d.ts

@@ -0,0 +1,53 @@
+import type { ChatMessage } from '../types/ChatMessage';
+import { type ParsedCitation } from './parseCitationsFromContent';
+/**
+ * Minimal message shape required to derive inline citation references and footnotes.
+ *
+ * @private utility of `<Chat/>`
+ */
+type CitationFootnoteMessage = Pick<ChatMessage, 'content' | 'citations'>;
+/**
+ * One rendered citation footnote entry shown below the message body.
+ *
+ * @private utility of `<Chat/>`
+ */
+export type CitationFootnoteEntry = {
+    /**
+     * Visible footnote number assigned by first appearance in the message body.
+     */
+    readonly number: number;
+    /**
+     * Citation metadata rendered for this footnote.
+     */
+    readonly citation: ParsedCitation;
+};
+/**
+ * Render-ready message citation payload containing transformed content plus footnotes.
+ *
+ * @private utility of `<Chat/>`
+ */
+export type CitationFootnoteRenderModel = {
+    /**
+     * Markdown/HTML content with inline citation tokens replaced by numeric superscripts.
+     */
+    readonly content: ChatMessage['content'];
+    /**
+     * Deduplicated footnotes ordered by first appearance in the message body.
+     */
+    readonly footnotes: ReadonlyArray<CitationFootnoteEntry>;
+};
+/**
+ * Creates one render model that replaces raw citation tokens with numeric footnotes.
+ *
+ * Supported input markers:
+ * - OpenAI-style full markers that already include the document source name.
+ * - Bracketed id-only tokens, for example `[0:0]` or `[8:13]`
+ *
+ * Footnotes are deduplicated by document source while preserving the first-seen order.
+ *
+ * @param message - Message content plus optional structured citation metadata.
+ * @returns Render-ready content and matching footnote entries.
+ * @private utility of `<Chat/>`
+ */
+export declare function createCitationFootnoteRenderModel(message: CitationFootnoteMessage): CitationFootnoteRenderModel;
+export {};

package/esm/src/book-components/Chat/utils/createCitationFootnoteRenderModel.test.d.ts

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

package/esm/src/cli/$runPromptbookCli.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Shared bootstrap for Promptbook CLI used by both local `ts-node` and packaged `npx` entrypoints.
+ *
+ * @private internal utility of Promptbook CLI bootstrap
+ */
+export declare function $runPromptbookCli(): Promise<void>;
+/**
+ * Note: [🟡] Code in this file should never be published outside of `@promptbook/cli`
+ */

package/esm/src/cli/cli-commands/coder/init.d.ts

@@ -0,0 +1,14 @@
+import type { Command as Program } from 'commander';
+import type { $side_effect } from '../../../utils/organization/$side_effect';
+/**
+ * Initializes `coder init` command for Promptbook CLI utilities.
+ *
+ * Note: `$` is used to indicate that this function is not a pure function - it registers a command in the CLI.
+ *
+ * @private internal function of `promptbookCli`
+ */
+export declare function $initializeCoderInitCommand(program: Program): $side_effect;
+/**
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ * Note: [🟡] Code in this file should never be published outside of `@promptbook/cli`
+ */

package/esm/src/cli/cli-commands/coder.d.ts

@@ -4,6 +4,7 @@ import type { $side_effect } from '../../utils/organization/$side_effect';
  * Initializes `coder` command with subcommands for Promptbook CLI utilities
  *
  * The coder command provides utilities for automated coding:
+ * - init: Initialize coder configuration in current project
  * - generate-boilerplates: Generate prompt boilerplate files
  * - find-refactor-candidates: Find files that need refactoring
  * - run: Run coding prompts with AI agents

package/esm/src/cli/main.d.ts

@@ -1,4 +1,4 @@
-import { promptbookCli } from './promptbookCli';
+import { $runPromptbookCli } from './$runPromptbookCli';
 /**
  * Note: [🔺] Purpose of this file is to export CLI for production environment
  */
@@ -8,7 +8,7 @@ import { promptbookCli } from './promptbookCli';
  * @public exported from `@promptbook/cli`
  */
 export declare const _CLI: {
-    _initialize_promptbookCli: typeof promptbookCli;
+    _initialize_promptbookCli: typeof $runPromptbookCli;
 };
 /**
  * Note: [💞] Ignore a discrepancy between file name and entity name

package/esm/src/cli/test/ptbk.d.ts

@@ -2,4 +2,4 @@
 /**
  * Note: [🔺] Purpose of this file is to test and use the current CLI in development environment
  */
-import '../../_packages/cli.index';
+export {};

package/esm/src/commitments/_common/toolRuntimeContext.d.ts

@@ -104,6 +104,10 @@ export type ToolRuntimeContext = {
         userId?: number;
         agentId?: string;
         agentName?: string;
+        /**
+         * Optional assistant message id currently being generated in durable web chat.
+         */
+        assistantMessageId?: string;
         parameters?: Record<string, string>;
         attachments?: ReadonlyArray<ChatAttachment>;
     };

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-21`).
+ * It follows semantic versioning (e.g., `0.112.0-23`).
  *
  * @generated
  */

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@promptbook/utils",
-    "version": "0.112.0-22",
+    "version": "0.112.0-24",
     "description": "Promptbook: Turn your company's scattered knowledge into AI ready books",
     "private": false,
     "sideEffects": false,

package/umd/index.umd.js

@@ -22,7 +22,7 @@
      * @generated
      * @see https://github.com/webgptorg/promptbook
      */
-    const PROMPTBOOK_ENGINE_VERSION = '0.112.0-22';
+    const PROMPTBOOK_ENGINE_VERSION = '0.112.0-24';
     /**
      * 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/umd/src/_packages/components.index.d.ts

@@ -16,6 +16,7 @@ import { AgentChat } from '../book-components/Chat/AgentChat/AgentChat';
 import type { AgentChatProps } from '../book-components/Chat/AgentChat/AgentChatProps';
 import { Chat } from '../book-components/Chat/Chat/Chat';
 import type { ChatFeedbackResponse } from '../book-components/Chat/Chat/ChatProps';
+import type { ChatFeedbackMode } from '../book-components/Chat/Chat/ChatProps';
 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';
@@ -54,6 +55,8 @@ import { mdSaveFormatDefinition } from '../book-components/Chat/save/markdown/md
 import { pdfSaveFormatDefinition } from '../book-components/Chat/save/pdf/pdfSaveFormatDefinition';
 import { reactSaveFormatDefinition } from '../book-components/Chat/save/react/reactSaveFormatDefinition';
 import { txtSaveFormatDefinition } from '../book-components/Chat/save/text/txtSaveFormatDefinition';
+import type { ChatProgressItem } from '../book-components/Chat/types/ChatMessage';
+import type { ChatProgressCard } 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 { MessageButton } from '../book-components/Chat/utils/parseMessageButtons';
@@ -90,6 +93,7 @@ export { AgentChat };
 export type { AgentChatProps };
 export { Chat };
 export type { ChatFeedbackResponse };
+export type { ChatFeedbackMode };
 export type { ChatSoundSystem };
 export type { ChatProps };
 export { ChatSoundToggle };
@@ -128,6 +132,8 @@ export { mdSaveFormatDefinition };
 export { pdfSaveFormatDefinition };
 export { reactSaveFormatDefinition };
 export { txtSaveFormatDefinition };
+export type { ChatProgressItem };
+export type { ChatProgressCard };
 export type { ChatMessage };
 export type { ChatParticipant };
 export type { MessageButton };

package/umd/src/_packages/types.index.d.ts

@@ -17,6 +17,7 @@ import type { AgentChatProps } from '../book-components/Chat/AgentChat/AgentChat
 import type { AgentChipData } from '../book-components/Chat/AgentChip/AgentChip';
 import type { AgentChipProps } from '../book-components/Chat/AgentChip/AgentChip';
 import type { ChatFeedbackResponse } from '../book-components/Chat/Chat/ChatProps';
+import type { ChatFeedbackMode } from '../book-components/Chat/Chat/ChatProps';
 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';
@@ -37,6 +38,8 @@ import type { ChatSaveFormatDefinition } from '../book-components/Chat/save/_com
 import type { string_chat_format_name } from '../book-components/Chat/save/_common/string_chat_format_name';
 import type { SourceChipProps } from '../book-components/Chat/SourceChip/SourceChip';
 import type { ChatToolCall } from '../book-components/Chat/types/ChatMessage';
+import type { ChatProgressItem } from '../book-components/Chat/types/ChatMessage';
+import type { ChatProgressCard } 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 { ParsedCitation } from '../book-components/Chat/utils/parseCitationsFromContent';
@@ -438,6 +441,7 @@ export type { AgentChatProps };
 export type { AgentChipData };
 export type { AgentChipProps };
 export type { ChatFeedbackResponse };
+export type { ChatFeedbackMode };
 export type { ChatSoundSystem };
 export type { ChatProps };
 export type { ChatSoundToggleProps };
@@ -458,6 +462,8 @@ export type { ChatSaveFormatDefinition };
 export type { string_chat_format_name };
 export type { SourceChipProps };
 export type { ChatToolCall };
+export type { ChatProgressItem };
+export type { ChatProgressCard };
 export type { ChatMessage };
 export type { ChatParticipant };
 export type { ParsedCitation };

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

@@ -26,6 +26,10 @@ type ChatMessageItemProps = Pick<ChatProps, 'onMessage' | 'onActionButton' | 'pa
      * Enables the feedback (rating) UI for this message bubble.
      */
     isFeedbackEnabled?: boolean;
+    /**
+     * Chooses which feedback controls should be rendered.
+     */
+    feedbackMode?: ChatProps['feedbackMode'];
     /**
      * Called when the copy button is pressed.
      */

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

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

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

@@ -20,6 +20,10 @@ export type ChatMessageListProps = {
     mode: 'LIGHT' | 'DARK';
     isCopyButtonEnabled?: boolean;
     isFeedbackEnabled?: boolean;
+    /**
+     * Chooses which feedback controls should be rendered.
+     */
+    feedbackMode?: ChatProps['feedbackMode'];
     onCopy?: () => void;
     onMessage?: (messageContent: string) => Promisable<void>;
     onActionButton?: ChatProps['onActionButton'];

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

@@ -18,6 +18,12 @@ export type ChatFeedbackResponse = {
      */
     readonly message?: string;
 };
+/**
+ * Visual mode for post-response feedback actions.
+ *
+ * @public exported from `@promptbook/components`
+ */
+export type ChatFeedbackMode = 'off' | 'stars' | 'report_issue';
 /**
  * Interface for sound system that can be passed to Chat component
  * This allows the chat to trigger sounds without tight coupling
@@ -275,11 +281,11 @@ export type ChatProps = {
     onCreateAgent?: (bookContent: string) => void;
     /**
      * Optional callback for handling user feedback on messages
-     * When provided, star rating buttons (1-5 stars) will be displayed next to each message
+     * When provided, message feedback actions are displayed according to `feedbackMode`.
      *
      * @param feedback - Object containing the feedback data
      * @param feedback.message - The message being rated
-     * @param feedback.rating - Star rating from 1 to 5
+     * @param feedback.rating - Numeric feedback rating value
      * @param feedback.textRating - Optional text feedback/note from user
      * @param feedback.chatThread - Complete chat thread as string
      * @param feedback.expectedAnswer - Optional expected answer provided by user
@@ -293,6 +299,12 @@ export type ChatProps = {
         expectedAnswer: string | null;
         url: string;
     }): Promisable<void>;
+    /**
+     * Selects which feedback action UI is shown on assistant responses.
+     *
+     * @default 'stars'
+     */
+    readonly feedbackMode?: ChatFeedbackMode;
     /**
      * Optional callback for handling file uploads
      * When provided, enables file upload functionality via drag-and-drop and file button

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

@@ -1,5 +1,6 @@
 import type { id } from '../../../types/typeAliases';
 import type { ChatMessage } from '../types/ChatMessage';
+import type { ChatFeedbackMode } from './ChatProps';
 /**
  * Props for the rating modal used in Chat.
  *
@@ -13,6 +14,10 @@ export type ChatRatingModalProps = {
     hoveredRating: number;
     messageRatings: Map<id, number>;
     textRating: string;
+    /**
+     * Chooses which feedback flow the modal should render.
+     */
+    feedbackMode: ChatFeedbackMode;
     mode: 'LIGHT' | 'DARK';
     isMobile: boolean;
     onClose: () => void;

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

@@ -19,6 +19,10 @@ export type SourceChipProps = {
      * Optional suffix text to display after the citation label.
      */
     suffix?: string;
+    /**
+     * Controls whether the technical citation id is shown inside the chip label.
+     */
+    isCitationIdVisible?: boolean;
 };
 /**
  * SourceChip component - displays a chip with source document information
@@ -36,4 +40,4 @@ export type SourceChipProps = {
  *
  * @private utility of `ChatMessageItem` component
  */
-export declare function SourceChip({ citation, onClick, className, suffix }: SourceChipProps): import("react/jsx-runtime").JSX.Element;
+export declare function SourceChip({ citation, onClick, className, suffix, isCitationIdVisible }: SourceChipProps): import("react/jsx-runtime").JSX.Element;

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

@@ -1,7 +1,7 @@
 import type { Promisable } from 'type-fest';
 import type { id } from '../../../types/typeAliases';
 import type { ChatMessage } from '../types/ChatMessage';
-import type { ChatFeedbackResponse } from '../Chat/ChatProps';
+import type { ChatFeedbackMode, ChatFeedbackResponse } from '../Chat/ChatProps';
 /**
  * Input parameters for the chat rating hook.
  *
@@ -23,6 +23,10 @@ export type UseChatRatingsOptions = {
         expectedAnswer: string | null;
         url: string;
     }) => Promisable<ChatFeedbackResponse | void>;
+    /**
+     * Feedback mode currently used by the chat UI.
+     */
+    feedbackMode: ChatFeedbackMode;
     /**
      * Whether the UI should apply mobile-specific behavior.
      */

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

@@ -2,6 +2,56 @@ import { Message } from '../../../types/Message';
 import type { ToolCall } from '../../../types/ToolCall';
 import type { id, string_date_iso8601, string_markdown } from '../../../types/typeAliases';
 export type ChatToolCall = ToolCall;
+/**
+ * One item in a user-facing progress card shown while assistant response is still running.
+ *
+ * @public exported from `@promptbook/components`
+ */
+export type ChatProgressItem = {
+    /**
+     * Stable item id used for incremental updates.
+     */
+    readonly id: string;
+    /**
+     * Item text in markdown.
+     */
+    readonly text: string_markdown;
+    /**
+     * Item status shown by the UI.
+     */
+    readonly status: 'pending' | 'completed';
+};
+/**
+ * Structured progress card rendered in place of generic thinking placeholders.
+ *
+ * @public exported from `@promptbook/components`
+ */
+export type ChatProgressCard = {
+    /**
+     * Optional title shown at the top of the panel.
+     */
+    readonly title?: string_markdown;
+    /**
+     * Optional markdown section describing current work.
+     */
+    readonly now?: string_markdown;
+    /**
+     * Optional markdown section describing upcoming work.
+     */
+    readonly next?: string_markdown;
+    /**
+     * Ordered bullet items representing in-progress or completed tasks.
+     */
+    readonly items: ReadonlyArray<ChatProgressItem>;
+    /**
+     * Optional timestamp when this card was last updated.
+     */
+    readonly updatedAt?: string_date_iso8601;
+    /**
+     * Optional visibility flag allowing explicit panel hide before final answer.
+     */
+    readonly isVisible?: boolean;
+};
 /**
  * Represents a single message within a chat interface.
  *
@@ -111,6 +161,10 @@ export type ChatMessage = Omit<Message<id>, 'direction' | 'recipients' | 'thread
          */
         excerpt?: string;
     }>;
+    /**
+     * Optional structured progress-card payload shown while a response is still in progress.
+     */
+    readonly progressCard?: ChatProgressCard;
 };
 /**
  * TODO: Make all fields readonly

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

@@ -0,0 +1,53 @@
+import type { ChatMessage } from '../types/ChatMessage';
+import { type ParsedCitation } from './parseCitationsFromContent';
+/**
+ * Minimal message shape required to derive inline citation references and footnotes.
+ *
+ * @private utility of `<Chat/>`
+ */
+type CitationFootnoteMessage = Pick<ChatMessage, 'content' | 'citations'>;
+/**
+ * One rendered citation footnote entry shown below the message body.
+ *
+ * @private utility of `<Chat/>`
+ */
+export type CitationFootnoteEntry = {
+    /**
+     * Visible footnote number assigned by first appearance in the message body.
+     */
+    readonly number: number;
+    /**
+     * Citation metadata rendered for this footnote.
+     */
+    readonly citation: ParsedCitation;
+};
+/**
+ * Render-ready message citation payload containing transformed content plus footnotes.
+ *
+ * @private utility of `<Chat/>`
+ */
+export type CitationFootnoteRenderModel = {
+    /**
+     * Markdown/HTML content with inline citation tokens replaced by numeric superscripts.
+     */
+    readonly content: ChatMessage['content'];
+    /**
+     * Deduplicated footnotes ordered by first appearance in the message body.
+     */
+    readonly footnotes: ReadonlyArray<CitationFootnoteEntry>;
+};
+/**
+ * Creates one render model that replaces raw citation tokens with numeric footnotes.
+ *
+ * Supported input markers:
+ * - OpenAI-style full markers that already include the document source name.
+ * - Bracketed id-only tokens, for example `[0:0]` or `[8:13]`
+ *
+ * Footnotes are deduplicated by document source while preserving the first-seen order.
+ *
+ * @param message - Message content plus optional structured citation metadata.
+ * @returns Render-ready content and matching footnote entries.
+ * @private utility of `<Chat/>`
+ */
+export declare function createCitationFootnoteRenderModel(message: CitationFootnoteMessage): CitationFootnoteRenderModel;
+export {};

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

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

package/umd/src/cli/$runPromptbookCli.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Shared bootstrap for Promptbook CLI used by both local `ts-node` and packaged `npx` entrypoints.
+ *
+ * @private internal utility of Promptbook CLI bootstrap
+ */
+export declare function $runPromptbookCli(): Promise<void>;
+/**
+ * Note: [🟡] Code in this file should never be published outside of `@promptbook/cli`
+ */

package/umd/src/cli/cli-commands/coder/init.d.ts

@@ -0,0 +1,14 @@
+import type { Command as Program } from 'commander';
+import type { $side_effect } from '../../../utils/organization/$side_effect';
+/**
+ * Initializes `coder init` command for Promptbook CLI utilities.
+ *
+ * Note: `$` is used to indicate that this function is not a pure function - it registers a command in the CLI.
+ *
+ * @private internal function of `promptbookCli`
+ */
+export declare function $initializeCoderInitCommand(program: Program): $side_effect;
+/**
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ * Note: [🟡] Code in this file should never be published outside of `@promptbook/cli`
+ */

package/umd/src/cli/cli-commands/coder.d.ts

@@ -4,6 +4,7 @@ import type { $side_effect } from '../../utils/organization/$side_effect';
  * Initializes `coder` command with subcommands for Promptbook CLI utilities
  *
  * The coder command provides utilities for automated coding:
+ * - init: Initialize coder configuration in current project
  * - generate-boilerplates: Generate prompt boilerplate files
  * - find-refactor-candidates: Find files that need refactoring
  * - run: Run coding prompts with AI agents

package/umd/src/cli/main.d.ts

@@ -1,4 +1,4 @@
-import { promptbookCli } from './promptbookCli';
+import { $runPromptbookCli } from './$runPromptbookCli';
 /**
  * Note: [🔺] Purpose of this file is to export CLI for production environment
  */
@@ -8,7 +8,7 @@ import { promptbookCli } from './promptbookCli';
  * @public exported from `@promptbook/cli`
  */
 export declare const _CLI: {
-    _initialize_promptbookCli: typeof promptbookCli;
+    _initialize_promptbookCli: typeof $runPromptbookCli;
 };
 /**
  * Note: [💞] Ignore a discrepancy between file name and entity name

package/umd/src/cli/test/ptbk.d.ts

@@ -2,4 +2,4 @@
 /**
  * Note: [🔺] Purpose of this file is to test and use the current CLI in development environment
  */
-import '../../_packages/cli.index';
+export {};

package/umd/src/commitments/_common/toolRuntimeContext.d.ts

@@ -104,6 +104,10 @@ export type ToolRuntimeContext = {
         userId?: number;
         agentId?: string;
         agentName?: string;
+        /**
+         * Optional assistant message id currently being generated in durable web chat.
+         */
+        assistantMessageId?: string;
         parameters?: Record<string, string>;
         attachments?: ReadonlyArray<ChatAttachment>;
     };

package/umd/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-21`).
+ * It follows semantic versioning (e.g., `0.112.0-23`).
  *
  * @generated
  */