@promptbook/node 0.112.0-30 → 0.112.0-32

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

@@ -1,6 +1,9 @@
 import { Message } from '../../../types/Message';
+import type { LlmToolDefinition } from '../../../types/LlmToolDefinition';
+import type { ChatModelRequirements } from '../../../types/ModelRequirements';
 import type { ToolCall } from '../../../types/ToolCall';
-import type { id, string_date_iso8601, string_markdown } from '../../../types/typeAliases';
+import type { TODO_object } from '../../../utils/organization/TODO_object';
+import type { id, Parameters, string_date_iso8601, string_markdown, string_prompt, string_title } from '../../../types/typeAliases';
 export type ChatToolCall = ToolCall;
 /**
  * One item in a user-facing progress card shown while assistant response is still running.
@@ -52,6 +55,63 @@ export type ChatProgressCard = {
      */
     readonly isVisible?: boolean;
 };
+/**
+ * Serializable prompt snapshot stored alongside one assistant message for debugging and inspection.
+ */
+type ChatMessagePrompt = {
+    /**
+     * Human-readable label used for the prompt execution.
+     */
+    readonly title: string_title;
+    /**
+     * User-facing chat content submitted into the prompt pipeline.
+     */
+    readonly content: string_prompt;
+    /**
+     * Resolved prompt parameters passed into the agent turn.
+     */
+    readonly parameters: Parameters;
+    /**
+     * Chat-model requirements used when the turn was executed.
+     */
+    readonly modelRequirements: ChatModelRequirements;
+    /**
+     * Prior thread history provided to the prompt.
+     */
+    readonly thread?: ReadonlyArray<ChatMessage>;
+    /**
+     * Attachments submitted with the user turn.
+     */
+    readonly attachments?: ReadonlyArray<{
+        name: string;
+        type: string;
+        url: string;
+    }>;
+    /**
+     * Runtime tools explicitly passed on the chat prompt object.
+     */
+    readonly tools?: ReadonlyArray<LlmToolDefinition>;
+    /**
+     * Full list of tools available to the model for this turn.
+     */
+    readonly availableTools?: ReadonlyArray<LlmToolDefinition>;
+    /**
+     * Tool calls associated with the generated message, duplicated here for raw prompt inspection.
+     */
+    readonly toolCalls?: ReadonlyArray<ChatToolCall>;
+    /**
+     * Completed tool calls associated with the generated message, duplicated here for raw prompt inspection.
+     */
+    readonly completedToolCalls?: ReadonlyArray<ChatToolCall>;
+    /**
+     * Provider-facing prompt text after agent/runtime preparation, when available.
+     */
+    readonly rawPromptContent?: string_prompt;
+    /**
+     * Provider-facing raw request payload, when available.
+     */
+    readonly rawRequest?: TODO_object | null;
+};
 /**
  * Represents a single message within a chat interface.
  *
@@ -165,7 +225,23 @@ export type ChatMessage = Omit<Message<id>, 'direction' | 'recipients' | 'thread
      * Optional structured progress-card payload shown while a response is still in progress.
      */
     readonly progressCard?: ChatProgressCard;
+    /**
+     * Optional list of tools that were available to the model when generating this message.
+     *
+     * This field is populated by the server from the exact tool definitions passed to the LLM
+     * request so developers can inspect what capabilities the model had access to during
+     * each conversation turn.
+     */
+    readonly availableTools?: ReadonlyArray<LlmToolDefinition>;
+    /**
+     * Optional prompt snapshot from which this message was generated.
+     *
+     * Intended for advanced/raw inspection so developers can see the exact chat prompt,
+     * resolved parameters, tool availability, and provider payload associated with one turn.
+     */
+    readonly prompt?: ChatMessagePrompt;
 };
+export {};
 /**
  * TODO: Make all fields readonly
  * TODO: Delete `expectedAnswer` from ChatMessage

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

@@ -0,0 +1,37 @@
+/**
+ * Locale-aware date/time labels derived from one tool-call timestamp.
+ *
+ * @private utility of `<Chat/>`
+ */
+type ToolCallDateTimeLabels = {
+    /**
+     * Primary local time label shown in chips and clock panels.
+     */
+    readonly localTimeLabel: string;
+    /**
+     * Local calendar date label shown under the primary time.
+     */
+    readonly localDateLabel: string;
+    /**
+     * Exact local timestamp label used in detail sections.
+     */
+    readonly localDateTimeLabel: string;
+    /**
+     * Relative label such as `in 5 minutes` or `2 minutes ago`.
+     */
+    readonly relativeTimeLabel: string | null;
+};
+/**
+ * Formats one tool-call timestamp into shared locale-aware labels.
+ *
+ * @param date - Timestamp to format.
+ * @param options - Optional locale and relative-time reference point.
+ * @returns Shared labels consumed by tool-call chips and modals.
+ *
+ * @private utility of `<Chat/>`
+ */
+export declare function formatToolCallDateTime(date: Date, options?: {
+    locale?: string;
+    currentDate?: Date;
+}): ToolCallDateTimeLabels;
+export {};

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

@@ -0,0 +1,11 @@
+/**
+ * Formats a Date as a locale-aware short time string (e.g. "5:30 PM" or "17:30").
+ *
+ * @param date - Date to format.
+ * @param locale - Optional BCP-47 locale string (e.g. `"en"`, `"cs"`).
+ *                 When omitted the browser/OS default locale is used.
+ * @returns Formatted time string such as `"5:30 PM"` or `"17:30"`.
+ *
+ * @private utility of `<Chat/>`
+ */
+export declare function formatToolCallLocalTime(date: Date, locale?: string): string;

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

@@ -0,0 +1,10 @@
+/**
+ * Applies `{placeholder}` values to one tool-call translation template.
+ *
+ * @param template - Template from the host application or fallback copy.
+ * @param variables - Placeholder values keyed by variable name.
+ * @returns Formatted string ready for rendering.
+ *
+ * @private utility of `<Chat/>`
+ */
+export declare function formatToolCallTranslationTemplate(template: string, variables: Record<string, string | number>): string;

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

@@ -1,3 +1,4 @@
+import 'moment/locale/cs';
 import type { ChatMessage } from '../types/ChatMessage';
 /**
  * Display-ready timestamp values for a chat message.
@@ -21,6 +22,9 @@ export type ChatMessageTimingDisplay = {
 /**
  * Builds display-ready timestamp and duration labels for a chat message.
  *
+ * @param message - Message with optional timestamp metadata.
+ * @param locale - Optional moment locale used for formatting.
+ *
  * @private utility of `<Chat/>` component
  */
-export declare function getChatMessageTimingDisplay(message: ChatMessage): ChatMessageTimingDisplay | null;
+export declare function getChatMessageTimingDisplay(message: ChatMessage, locale?: string): ChatMessageTimingDisplay | null;

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

@@ -15,6 +15,25 @@ export type ToolCallChipletInfo = {
      */
     agentData?: AgentChipData;
 };
+/**
+ * Optional user-facing title overrides for technical tool names.
+ *
+ * @private utility of `<Chat/>`
+ */
+type ToolCallTitleOverrides = Readonly<Record<string, string>>;
+/**
+ * Optional localized labels used for user-facing chip text.
+ *
+ * @private utility of `<Chat/>`
+ */
+type ToolCallChipTranslations = {
+    readonly toolCallTimeChipLabel?: string;
+    readonly toolCallTimeoutChipLabel?: string;
+    readonly toolCallTimeoutChipCancelledLabel?: string;
+    readonly toolCallTimeoutChipInactiveLabel?: string;
+    readonly toolCallTimeoutChipUpdatedLabel?: string;
+    readonly toolCallTimeoutChipFallbackLabel?: string;
+};
 /**
  * Builds display text for a tool call chiplet.
  *
@@ -35,6 +54,12 @@ export declare const TOOL_TITLES: Record<string, {
 /**
  * Gets the chiplet information including text and agent data (for team tools).
  *
+ * @param toolCall - Tool call to build chiplet info for.
+ * @param locale - Optional BCP-47 locale string used to format time labels.
+ * @param titleOverrides - Optional localized titles keyed by tool name.
+ * @param chipTranslations - Optional localized chip templates for time-related tools.
+ *
  * @private [🧠] Maybe public?
  */
-export declare function getToolCallChipletInfo(toolCall: ToolCall): ToolCallChipletInfo;
+export declare function getToolCallChipletInfo(toolCall: ToolCall, locale?: string, titleOverrides?: ToolCallTitleOverrides, chipTranslations?: ToolCallChipTranslations): ToolCallChipletInfo;
+export {};

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

@@ -64,6 +64,24 @@ export type TimeoutToolCallPresentation = {
      */
     readonly localDueDateLabel: string | null;
 };
+/**
+ * Optional localized labels used by timeout chips and friendly modal copy.
+ *
+ * @private internal utility of `<Chat/>`
+ */
+type TimeoutToolCallTranslations = {
+    readonly toolCallTimeoutChipLabel?: string;
+    readonly toolCallTimeoutChipCancelledLabel?: string;
+    readonly toolCallTimeoutChipInactiveLabel?: string;
+    readonly toolCallTimeoutChipUpdatedLabel?: string;
+    readonly toolCallTimeoutChipFallbackLabel?: string;
+    readonly toolCallTimeoutPrimaryScheduledLabel?: string;
+    readonly toolCallTimeoutSecondaryDurationLabel?: string;
+    readonly toolCallTimeoutPrimaryCancelledLabel?: string;
+    readonly toolCallTimeoutPrimaryInactiveLabel?: string;
+    readonly toolCallTimeoutPrimaryUpdatedLabel?: string;
+    readonly toolCallTimeoutPrimaryFallbackLabel?: string;
+};
 /**
  * Inputs required to derive timeout presentation metadata.
  *
@@ -86,6 +104,11 @@ type ResolveTimeoutToolCallPresentationOptions = {
      * Current date used to calculate relative labels.
      */
     readonly currentDate?: Date;
+    /**
+     * Optional BCP-47 locale string used to format local-time labels.
+     * When omitted the browser/OS default locale is used.
+     */
+    readonly locale?: string;
 };
 /**
  * Determines whether a tool name belongs to the timeout commitment.
@@ -104,19 +127,19 @@ export declare function resolveTimeoutToolCallPresentation(options: ResolveTimeo
  *
  * @private internal utility of `<Chat/>`
  */
-export declare function buildTimeoutToolCallChipLabel(presentation: TimeoutToolCallPresentation): string;
+export declare function buildTimeoutToolCallChipLabel(presentation: TimeoutToolCallPresentation, translations?: TimeoutToolCallTranslations): string;
 /**
  * Builds the primary timeout sentence shown in default modal view.
  *
  * @private internal utility of `<Chat/>`
  */
-export declare function buildTimeoutToolPrimarySentence(presentation: TimeoutToolCallPresentation): string;
+export declare function buildTimeoutToolPrimarySentence(presentation: TimeoutToolCallPresentation, translations?: TimeoutToolCallTranslations): string;
 /**
  * Builds one default-view scheduling sentence with local-time and relative context.
  *
  * @private internal utility of `<Chat/>`
  */
-export declare function buildTimeoutToolScheduleSentence(presentation: TimeoutToolCallPresentation): string | null;
+export declare function buildTimeoutToolScheduleSentence(presentation: TimeoutToolCallPresentation, translations?: TimeoutToolCallTranslations): string | null;
 export {};
 /**
  * Note: [💞] Ignore a discrepancy between file name and entity name

package/umd/src/utils/toolCalls/mergeToolCalls.d.ts

@@ -1,4 +1,4 @@
-import type { ToolCall } from '../../types/ToolCall';
+import { type ToolCall } from '../../types/ToolCall';
 /**
  * Merges streamed tool-call snapshots by stable identity while preserving incremental logs,
  * warnings, and partial results.

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