@promptbook/javascript 0.112.0-31 → 0.112.0-34

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

@@ -0,0 +1,29 @@
+import { type RefObject } from 'react';
+/**
+ * Inputs needed to manage speech playback for one chat message.
+ *
+ * @private internal hook of `<ChatMessageItem/>`
+ */
+export type UseChatMessageSpeechPlaybackOptions = {
+    readonly trimmedMessageContent: string;
+    readonly contentRef: RefObject<HTMLElement | null>;
+    readonly shouldShowPlayButton: boolean;
+    readonly elevenLabsVoiceId?: string;
+};
+/**
+ * Speech playback state and actions returned to `<ChatMessageItem/>`.
+ *
+ * @private internal hook of `<ChatMessageItem/>`
+ */
+export type UseChatMessageSpeechPlaybackResult = {
+    readonly audioError: string | null;
+    readonly isAudioLoading: boolean;
+    readonly isAudioPlaying: boolean;
+    readonly handlePlayMessage: () => Promise<void>;
+};
+/**
+ * Handles ElevenLabs speech playback, caching, and audio element lifecycle for one message.
+ *
+ * @private internal hook of `<ChatMessageItem/>`
+ */
+export declare function useChatMessageSpeechPlayback(options: UseChatMessageSpeechPlaybackOptions): UseChatMessageSpeechPlaybackResult;

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

@@ -1,3 +1,4 @@
+/// <reference types="react" />
 import type { string_markdown } from '../../../types/typeAliases';
 type MarkdownContentProps = {
     content: string_markdown;
@@ -9,7 +10,7 @@ type MarkdownContentProps = {
  *
  * @public exported from `@promptbook/components`
  */
-export declare function MarkdownContent(props: MarkdownContentProps): import("react/jsx-runtime").JSX.Element;
+export declare const MarkdownContent: import("react").NamedExoticComponent<MarkdownContentProps>;
 export {};
 /**
  * TODO: !!! Split into multiple files

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

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

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

@@ -0,0 +1,18 @@
+import type { ChatSoundSystem } from '../Chat/ChatProps';
+import type { ChatMessage } from '../types/ChatMessage';
+/**
+ * Plays the "message received" sound + vibration exactly once when the last
+ * assistant message transitions to a completed / finalized state.
+ *
+ * Notifications are suppressed for:
+ * - Every streaming chunk / intermediate content update
+ * - `message_typing` lifecycle events before the message is finalized
+ * - Re-renders of an already-notified completed message (idempotent)
+ * - User-originated messages
+ *
+ * @param messages - Current list of chat messages
+ * @param soundSystem - Optional sound system instance; no-op when absent
+ *
+ * @private internal hook of `<Chat/>`
+ */
+export declare function useChatCompleteNotification(messages: ReadonlyArray<ChatMessage>, soundSystem: ChatSoundSystem | undefined): void;

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

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

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/cli/$runPromptbookCli.d.ts

@@ -4,6 +4,4 @@
  * @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`
- */
+/** Note: [🟡] Code for CLI bootstrap [$runPromptbookCli](src/cli/$runPromptbookCli.ts) should never be published outside of `@promptbook/cli` */

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

@@ -8,7 +8,5 @@ import type { $side_effect } from '../../utils/organization/$side_effect';
  * @private internal function of `promptbookCli`
  */
 export declare function $initializeBoilerplateCommand(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`
- */
+/** Note: [🟡] Code for CLI command [_boilerplate](src/cli/cli-commands/_boilerplate.ts) should never be published outside of `@promptbook/cli` */
+/** Note: [💞] Ignore a discrepancy between file name and entity name */

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

@@ -8,9 +8,9 @@ import type { $side_effect } from '../../utils/organization/$side_effect';
  * @private internal function of `promptbookCli`
  */
 export declare function $initializeAboutCommand(program: Program): $side_effect;
+/** Note: [🟡] Code for CLI command [about](src/cli/cli-commands/about.ts) should never be published outside of `@promptbook/cli` */
 /**
  * TODO: [🕋] Use here `aboutPromptbookInformation`
  * TODO: [🗽] Unite branding and make single place for it
  * 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/find-fresh-emoji-tags.d.ts

@@ -8,7 +8,5 @@ import type { $side_effect } from '../../../utils/organization/$side_effect';
  * @private internal function of `promptbookCli`
  */
 export declare function $initializeCoderFindFreshEmojiTagCommand(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`
- */
+/** Note: [🟡] Code for CLI command [find-fresh-emoji-tags](src/cli/cli-commands/coder/find-fresh-emoji-tags.ts) should never be published outside of `@promptbook/cli` */
+/** Note: [💞] Ignore a discrepancy between file name and entity name */

package/umd/src/cli/cli-commands/coder/find-refactor-candidates.d.ts

@@ -8,7 +8,5 @@ import type { $side_effect } from '../../../utils/organization/$side_effect';
  * @private internal function of `promptbookCli`
  */
 export declare function $initializeCoderFindRefactorCandidatesCommand(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`
- */
+/** Note: [🟡] Code for CLI command [find-refactor-candidates](src/cli/cli-commands/coder/find-refactor-candidates.ts) should never be published outside of `@promptbook/cli` */
+/** Note: [💞] Ignore a discrepancy between file name and entity name */

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

@@ -8,7 +8,5 @@ import type { $side_effect } from '../../../utils/organization/$side_effect';
  * @private internal function of `promptbookCli`
  */
 export declare function $initializeCoderGenerateBoilerplatesCommand(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`
- */
+/** Note: [🟡] Code for CLI command [generate-boilerplates](src/cli/cli-commands/coder/generate-boilerplates.ts) should never be published outside of `@promptbook/cli` */
+/** Note: [💞] Ignore a discrepancy between file name and entity name */

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

@@ -8,7 +8,5 @@ import type { $side_effect } from '../../../utils/organization/$side_effect';
  * @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`
- */
+/** Note: [🟡] Code for CLI command [init](src/cli/cli-commands/coder/init.ts) should never be published outside of `@promptbook/cli` */
+/** Note: [💞] Ignore a discrepancy between file name and entity name */

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

@@ -8,7 +8,5 @@ import type { $side_effect } from '../../../utils/organization/$side_effect';
  * @private internal function of `promptbookCli`
  */
 export declare function $initializeCoderRunCommand(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`
- */
+/** Note: [🟡] Code for CLI command [run](src/cli/cli-commands/coder/run.ts) should never be published outside of `@promptbook/cli` */
+/** Note: [💞] Ignore a discrepancy between file name and entity name */

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

@@ -8,7 +8,5 @@ import type { $side_effect } from '../../../utils/organization/$side_effect';
  * @private internal function of `promptbookCli`
  */
 export declare function $initializeCoderVerifyCommand(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`
- */
+/** Note: [🟡] Code for CLI command [verify](src/cli/cli-commands/coder/verify.ts) should never be published outside of `@promptbook/cli` */
+/** Note: [💞] Ignore a discrepancy between file name and entity name */

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

@@ -16,7 +16,5 @@ import type { $side_effect } from '../../utils/organization/$side_effect';
  * @private internal function of `promptbookCli`
  */
 export declare function $initializeCoderCommand(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`
- */
+/** Note: [🟡] Code for CLI command [coder](src/cli/cli-commands/coder.ts) should never be published outside of `@promptbook/cli` */
+/** Note: [💞] Ignore a discrepancy between file name and entity name */

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

@@ -8,8 +8,8 @@ import type { $side_effect } from '../../utils/organization/$side_effect';
  * @private internal function of `promptbookCli`
  */
 export declare function $initializeHelloCommand(program: Program): $side_effect;
+/** Note: [🟡] Code for CLI command [hello](src/cli/cli-commands/hello.ts) should never be published outside of `@promptbook/cli` */
 /**
  * TODO: [🧠][🐣] Make here some easter egg with generated hello greeting via LLM models
  * 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/list-models.d.ts

@@ -8,7 +8,5 @@ import type { $side_effect } from '../../utils/organization/$side_effect';
  * @private internal function of `promptbookCli`
  */
 export declare function $initializeListModelsCommand(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`
- */
+/** Note: [🟡] Code for CLI command [list-models](src/cli/cli-commands/list-models.ts) should never be published outside of `@promptbook/cli` */
+/** Note: [💞] Ignore a discrepancy between file name and entity name */

package/umd/src/cli/cli-commands/list-scrapers.d.ts

@@ -8,7 +8,5 @@ import type { $side_effect } from '../../utils/organization/$side_effect';
  * @private internal function of `promptbookCli`
  */
 export declare function $initializeListScrapersCommand(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`
- */
+/** Note: [🟡] Code for CLI command [list-scrapers](src/cli/cli-commands/list-scrapers.ts) should never be published outside of `@promptbook/cli` */
+/** Note: [💞] Ignore a discrepancy between file name and entity name */

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

@@ -8,8 +8,8 @@ import type { $side_effect } from '../../utils/organization/$side_effect';
  * @private internal function of `promptbookCli`
  */
 export declare function $initializeLoginCommand(program: Program): $side_effect;
+/** Note: [🟡] Code for CLI command [login](src/cli/cli-commands/login.ts) should never be published outside of `@promptbook/cli` */
 /**
  * TODO: Implement non-interactive login
  * 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/make.d.ts

@@ -8,10 +8,10 @@ import type { $side_effect } from '../../utils/organization/$side_effect';
  * @private internal function of `promptbookCli`
  */
 export declare function $initializeMakeCommand(program: Program): $side_effect;
+/** Note: [🟡] Code for CLI command [make](src/cli/cli-commands/make.ts) should never be published outside of `@promptbook/cli` */
 /**
  * TODO: [🥃][main] !!3 Allow `ptbk make` without configuring any llm tools
  * TODO: [0] DRY Javascript and typescript - Maybe make ONLY typescript and for javascript just remove types
  * Note: [💞] Ignore a discrepancy between file name and entity name
- * Note: [🟡] Code in this file should never be published outside of `@promptbook/cli`
  * TODO: [🖇] What about symlinks? Maybe flag --follow-symlinks
  */

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

@@ -8,9 +8,9 @@ import type { $side_effect } from '../../utils/organization/$side_effect';
  * @private internal function of `promptbookCli`
  */
 export declare function $initializePrettifyCommand(program: Program): $side_effect;
+/** Note: [🟡] Code for CLI command [prettify](src/cli/cli-commands/prettify.ts) should never be published outside of `@promptbook/cli` */
 /**
  * TODO: [😶] Unite folder listing
  * Note: [💞] Ignore a discrepancy between file name and entity name
- * Note: [🟡] Code in this file should never be published outside of `@promptbook/cli`
  * TODO: [🖇] What about symlinks? Maybe flag --follow-symlinks
  */

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

@@ -8,11 +8,11 @@ import type { $side_effect } from '../../utils/organization/$side_effect';
  * @private internal function of `promptbookCli`
  */
 export declare function $initializeRunCommand(program: Program): $side_effect;
+/** Note: [🟡] Code for CLI command [run](src/cli/cli-commands/run.ts) should never be published outside of `@promptbook/cli` */
 /**
  * TODO: !!5 Catch and wrap all errors from CLI
  * TODO: [🧠] Pass `maxExecutionAttempts`, `csvSettings`
  * TODO: [🥃][main] !!3 Allow `ptbk run` without configuring any llm tools
  * Note: [💞] Ignore a discrepancy between file name and entity name
- * Note: [🟡] Code in this file should never be published outside of `@promptbook/cli`
  * TODO: [🖇] What about symlinks? Maybe flag --follow-symlinks
  */

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

@@ -25,8 +25,8 @@ type RunInteractiveChatbotOptions = {
  */
 export declare function runInteractiveChatbot(options: RunInteractiveChatbotOptions): Promise<void | never>;
 export {};
+/** Note: [🟡] Code for CLI command [runInteractiveChatbot](src/cli/cli-commands/runInteractiveChatbot.ts) should never be published outside of `@promptbook/cli` */
 /**
  * TODO: Saving reports from the chatbot conversation
  * TODO: [⛲️] This is the right place to start implementing INK
- * Note: [🟡] Code in this file should never be published outside of `@promptbook/cli`
  */

package/umd/src/cli/cli-commands/start-agents-server.d.ts

@@ -8,7 +8,5 @@ import type { $side_effect } from '../../utils/organization/$side_effect';
  * @private internal function of `promptbookCli`
  */
 export declare function $initializeStartAgentsServerCommand(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`
- */
+/** Note: [🟡] Code for CLI command [start-agents-server](src/cli/cli-commands/start-agents-server.ts) should never be published outside of `@promptbook/cli` */
+/** Note: [💞] Ignore a discrepancy between file name and entity name */

package/umd/src/cli/cli-commands/start-pipelines-server.d.ts

@@ -8,8 +8,8 @@ import type { $side_effect } from '../../utils/organization/$side_effect';
  * @private internal function of `promptbookCli`
  */
 export declare function $initializeStartPipelinesServerCommand(program: Program): $side_effect;
+/** Note: [🟡] Code for CLI command [start-pipelines-server](src/cli/cli-commands/start-pipelines-server.ts) should never be published outside of `@promptbook/cli` */
 /**
  * TODO: [🕋] Use here `aboutPromptbookInformation`
  * 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/test-command.d.ts

@@ -8,10 +8,10 @@ import type { $side_effect } from '../../utils/organization/$side_effect';
  * @private internal function of `promptbookCli`
  */
 export declare function $initializeTestCommand(program: Program): $side_effect;
+/** Note: [🟡] Code for CLI command [test-command](src/cli/cli-commands/test-command.ts) should never be published outside of `@promptbook/cli` */
 /**
  * TODO: [😶] Unite folder listing
  * Note: [💞] Ignore a discrepancy between file name and entity name
- * Note: [🟡] Code in this file should never be published outside of `@promptbook/cli`
  * TODO: [🖇] What about symlinks? Maybe flag --follow-symlinks
  * Note: This is named "test-command.ts" to avoid name collision with jest unit test files
  */

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

@@ -10,7 +10,5 @@ import { $runPromptbookCli } from './$runPromptbookCli';
 export declare const _CLI: {
     _initialize_promptbookCli: typeof $runPromptbookCli;
 };
-/**
- * Note: [💞] Ignore a discrepancy between file name and entity name
- * Note: [🟡] Code in this file should never be published outside of `@promptbook/cli`
- */
+/** Note: [🟡] Code for CLI entrypoint [main](src/cli/main.ts) should never be published outside of `@promptbook/cli` */
+/** Note: [💞] Ignore a discrepancy between file name and entity name */

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

@@ -4,10 +4,10 @@
  * @private within the `@promptbook/cli`
  */
 export declare function promptbookCli(): Promise<void>;
+/** Note: [🟡] Code for CLI program [promptbookCli](src/cli/promptbookCli.ts) should never be published outside of `@promptbook/cli` */
 /**
  * TODO: [🧠] Maybe `run` command the default, instead of `ptbk run ./foo.book` -> `ptbk ./foo.book`
  * TODO: [🥠] Do not export, its just for CLI script
  * TODO: [🕌] When more functionalities, rename
  * Note: 11:11
- * Note: [🟡] Code in this file should never be published outside of `@promptbook/cli`
  */

package/umd/src/commitments/USE_BROWSER/fetchUrlContent.d.ts

@@ -17,6 +17,4 @@
  * the Agents Server API endpoint at /api/scrape
  */
 export declare function fetchUrlContent(url: string): Promise<string>;
-/**
- * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
- */
+/** Note: [🟢] Code for Node browser-fetch helper [fetchUrlContent](src/commitments/USE_BROWSER/fetchUrlContent.ts) should never be published into packages that could be imported into browser environment */

package/umd/src/conversion/archive/loadArchive.d.ts

@@ -11,6 +11,4 @@ import type { string_filename } from '../../types/typeAliases';
  * @private utility of Promptbook
  */
 export declare function loadArchive(filePath: string_filename, fs: FilesystemTools): Promise<ReadonlyArray<PipelineJson>>;
-/**
- * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
- */
+/** Note: [🟢] Code for Node archive helper [loadArchive](src/conversion/archive/loadArchive.ts) should never be published into packages that could be imported into browser environment */