@promptbook/javascript 0.112.0-31 → 0.112.0-34

package/esm/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/esm/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/esm/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/esm/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/esm/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/esm/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/esm/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/esm/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/esm/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/esm/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/esm/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/esm/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/esm/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/esm/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/esm/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/esm/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/esm/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/esm/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/esm/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/esm/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/esm/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/esm/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/esm/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/esm/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/esm/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/esm/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 */

package/esm/src/conversion/archive/saveArchive.d.ts

@@ -11,8 +11,8 @@ import type { string_filename } from '../../types/typeAliases';
  * @private utility of Promptbook
  */
 export declare function saveArchive(filePath: string_filename, collectionJson: ReadonlyArray<PipelineJson>, fs: FilesystemTools): Promise<void>;
+/** Note: [🟢] Code for Node archive helper [saveArchive](src/conversion/archive/saveArchive.ts) should never be published into packages that could be imported into browser environment */
 /**
  * TODO: Add metadata to zip
  * TODO: Compression level and other zip options from config
- * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
  */

package/esm/src/conversion/validation/_importPipeline.d.ts

@@ -17,7 +17,5 @@ export declare function importPipelineWithoutPreparation(path: `${string}.bookc`
  * @private internal function of tests
  */
 export declare function importPipelineJson(path: `${string}.bookc`): Promise<PipelineJson>;
-/**
- * Note: [💞] Ignore a discrepancy between file name and entity name
- * Note: [⚫] Code in this file should never be published in any package
- */
+/** Note: [⚫] Code for private pipeline import shim [_importPipeline](src/conversion/validation/_importPipeline.ts) should never be published in any package */
+/** Note: [💞] Ignore a discrepancy between file name and entity name */

package/esm/src/dialogs/simple-prompt/SimplePromptInterfaceTools.d.ts

@@ -17,6 +17,4 @@ export declare class SimplePromptInterfaceTools implements UserInterfaceTools {
      */
     promptDialog(options: UserInterfaceToolsPromptDialogOptions): Promise<string>;
 }
-/**
- * Note: [🔵] Code in this file should never be published outside of `@promptbook/browser`
- */
+/** Note: [🔵] Code for browser dialog helper [SimplePromptInterfaceTools](src/dialogs/simple-prompt/SimplePromptInterfaceTools.ts) should never be published outside of `@promptbook/browser` */

package/esm/src/executables/$provideExecutablesForNode.d.ts

@@ -6,8 +6,8 @@ import type { PrepareAndScrapeOptions } from '../prepare/PrepareAndScrapeOptions
  * @public exported from `@promptbook/node`
  */
 export declare function $provideExecutablesForNode(options?: PrepareAndScrapeOptions): Promise<Executables>;
+/** Note: [🟢] Code for Node executable locator [$provideExecutablesForNode](src/executables/$provideExecutablesForNode.ts) should never be published into packages that could be imported into browser environment */
 /**
  * TODO: [🧠] Allow to override the executables without need to call `locatePandoc` / `locateLibreoffice` in case of provided
- * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
  * TODO: [🏓] Unite `xxxForServer` and `xxxForNode` naming
  */

package/esm/src/executables/apps/locateLibreoffice.d.ts

@@ -6,7 +6,5 @@ import type { string_executable_path } from '../../types/typeAliases';
  * @private within the repository
  */
 export declare function locateLibreoffice(): Promise<string_executable_path | null>;
-/**
- * TODO: [🧠][♿] Maybe export through `@promptbook/node` OR `@promptbook/legacy-documents`
- * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
- */
+/** Note: [🟢] Code for Node executable locator [locateLibreoffice](src/executables/apps/locateLibreoffice.ts) should never be published into packages that could be imported into browser environment */
+/** TODO: [🧠][♿] Maybe export through `@promptbook/node` OR `@promptbook/legacy-documents` */

package/esm/src/executables/apps/locatePandoc.d.ts

@@ -6,7 +6,5 @@ import type { string_executable_path } from '../../types/typeAliases';
  * @private within the repository
  */
 export declare function locatePandoc(): Promise<string_executable_path | null>;
-/**
- * TODO: [🧠][♿] Maybe export through `@promptbook/node` OR `@promptbook/documents`
- * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
- */
+/** Note: [🟢] Code for Node executable locator [locatePandoc](src/executables/apps/locatePandoc.ts) should never be published into packages that could be imported into browser environment */
+/** TODO: [🧠][♿] Maybe export through `@promptbook/node` OR `@promptbook/documents` */

package/esm/src/executables/locateApp.d.ts

@@ -27,7 +27,5 @@ export type LocateAppOptions = {
  * @private within the repository
  */
 export declare function locateApp(options: RequireAtLeastOne<LocateAppOptions, 'linuxWhich' | 'windowsSuffix' | 'macOsName'>): Promise<string_executable_path | null>;
-/**
- * TODO: [🧠][♿] Maybe export through `@promptbook/node`
- * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
- */
+/** Note: [🟢] Code for Node executable locator [locateApp](src/executables/locateApp.ts) should never be published into packages that could be imported into browser environment */
+/** TODO: [🧠][♿] Maybe export through `@promptbook/node` */

package/esm/src/executables/platforms/locateAppOnLinux.d.ts

@@ -7,7 +7,5 @@ import type { LocateAppOptions } from '../locateApp';
  * @private within the repository
  */
 export declare function locateAppOnLinux({ linuxWhich, }: Pick<Required<LocateAppOptions>, 'linuxWhich'>): Promise<string_executable_path | null>;
-/**
- * TODO: [🧠][♿] Maybe export through `@promptbook/node`
- * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
- */
+/** Note: [🟢] Code for Node executable locator [locateAppOnLinux](src/executables/platforms/locateAppOnLinux.ts) should never be published into packages that could be imported into browser environment */
+/** TODO: [🧠][♿] Maybe export through `@promptbook/node` */

package/esm/src/executables/platforms/locateAppOnMacOs.d.ts

@@ -7,7 +7,5 @@ import type { LocateAppOptions } from '../locateApp';
  * @private within the repository
  */
 export declare function locateAppOnMacOs({ macOsName, }: Pick<Required<LocateAppOptions>, 'macOsName'>): Promise<string_executable_path | null>;
-/**
- * TODO: [🧠][♿] Maybe export through `@promptbook/node`
- * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
- */
+/** Note: [🟢] Code for Node executable locator [locateAppOnMacOs](src/executables/platforms/locateAppOnMacOs.ts) should never be published into packages that could be imported into browser environment */
+/** TODO: [🧠][♿] Maybe export through `@promptbook/node` */

package/esm/src/executables/platforms/locateAppOnWindows.d.ts

@@ -7,7 +7,5 @@ import type { LocateAppOptions } from '../locateApp';
  * @private within the repository
  */
 export declare function locateAppOnWindows({ appName, windowsSuffix, }: Pick<Required<LocateAppOptions>, 'appName' | 'windowsSuffix'>): Promise<string_executable_path | null>;
-/**
- * TODO: [🧠][♿] Maybe export through `@promptbook/node`
- * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
- */
+/** Note: [🟢] Code for Node executable locator [locateAppOnWindows](src/executables/platforms/locateAppOnWindows.ts) should never be published into packages that could be imported into browser environment */
+/** TODO: [🧠][♿] Maybe export through `@promptbook/node` */

package/esm/src/execution/translation/automatic-translate/translateMessages.d.ts

@@ -6,7 +6,5 @@ import type { TranslatorOptions } from './automatic-translators/TranslatorOption
 export declare function translateMessages({ automaticTranslator, from, to, }: {
     automaticTranslator: AutomaticTranslator;
 } & TranslatorOptions): Promise<void>;
-/**
- * TODO: [😶] Unite folder listing
- * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
- */
+/** Note: [🟢] Code for Node translation helper [translateMessages](src/execution/translation/automatic-translate/translateMessages.ts) should never be published into packages that could be imported into browser environment */
+/** TODO: [😶] Unite folder listing */

package/esm/src/execution/utils/$provideExecutionToolsForNode.d.ts

@@ -8,7 +8,5 @@ import type { ExecutionTools } from '../ExecutionTools';
  * @public exported from `@promptbook/node`
  */
 export declare function $provideExecutionToolsForNode(options?: PrepareAndScrapeOptions): Promise<ExecutionTools>;
-/**
- * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
- * TODO: [🏓] Unite `xxxForServer` and `xxxForNode` naming
- */
+/** Note: [🟢] Code for Node execution helper [$provideExecutionToolsForNode](src/execution/utils/$provideExecutionToolsForNode.ts) should never be published into packages that could be imported into browser environment */
+/** TODO: [🏓] Unite `xxxForServer` and `xxxForNode` naming */

package/esm/src/llm-providers/_common/register/$provideEnvFilename.d.ts

@@ -7,6 +7,4 @@ import type { string_filename } from '../../../types/typeAliases';
  * @private within the repository - for CLI utils
  */
 export declare function $provideEnvFilename(): Promise<string_filename | null>;
-/**
- * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
- */
+/** Note: [🟢] Code for Node environment helper [$provideEnvFilename](src/llm-providers/_common/register/$provideEnvFilename.ts) should never be published into packages that could be imported into browser environment */

package/esm/src/llm-providers/_common/register/$provideLlmToolsConfigurationFromEnv.d.ts

@@ -14,6 +14,4 @@ import type { LlmToolsConfiguration } from './LlmToolsConfiguration';
  * @public exported from `@promptbook/node`
  */
 export declare function $provideLlmToolsConfigurationFromEnv(): Promise<LlmToolsConfiguration>;
-/**
- * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
- */
+/** Note: [🟢] Code for Node environment helper [$provideLlmToolsConfigurationFromEnv](src/llm-providers/_common/register/$provideLlmToolsConfigurationFromEnv.ts) should never be published into packages that could be imported into browser environment */

package/esm/src/llm-providers/_common/register/$provideLlmToolsForWizardOrCli.d.ts

@@ -49,8 +49,8 @@ type ProvideLlmToolsForWizardOrCliOptions = {
  */
 export declare function $provideLlmToolsForWizardOrCli(options?: ProvideLlmToolsForWizardOrCliOptions): Promise<LlmExecutionToolsWithTotalUsage>;
 export {};
+/** Note: [🟢] Code for Node environment helper [$provideLlmToolsForWizardOrCli](src/llm-providers/_common/register/$provideLlmToolsForWizardOrCli.ts) should never be published into packages that could be imported into browser environment */
 /**
- * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
  * TODO: [👷‍♂️] Write a comprehensive manual about the construction of LLM tools
  * TODO: [🥃] Allow `ptbk make` without llm tools
  * TODO: This should be maybe not under `_common` but under `utils-internal` / `utils/internal`

package/esm/src/llm-providers/_common/register/$provideLlmToolsFromEnv.d.ts

@@ -21,20 +21,18 @@ import type { CreateLlmToolsFromConfigurationOptions } from './createLlmToolsFro
  * @public exported from `@promptbook/node`
  */
 export declare function $provideLlmToolsFromEnv(options?: CreateLlmToolsFromConfigurationOptions): Promise<MultipleLlmExecutionTools>;
+/** Note: [🟢] Code for Node environment helper [$provideLlmToolsFromEnv](src/llm-providers/_common/register/$provideLlmToolsFromEnv.ts) should never be published into packages that could be imported into browser environment */
 /**
  * TODO: The architecture for LLM tools configuration consists of three key functions:
  * 1. `$provideLlmToolsFromEnv` - High-level function that detects available providers from env vars and returns ready-to-use LLM tools
  * 2. `$provideLlmToolsConfigurationFromEnv` - Middle layer that extracts configuration objects from environment variables
  * 3. `createLlmToolsFromConfiguration` - Low-level function that instantiates LLM tools from explicit configuration
- *
  * This layered approach allows flexibility in how tools are configured:
  * - Use $provideLlmToolsFromEnv for automatic detection and setup in Node.js environments
  * - Use $provideLlmToolsConfigurationFromEnv to extract config objects for modification before instantiation
  * - Use createLlmToolsFromConfiguration for explicit control over tool configurations
- *
  * TODO: [🧠][🍛] Which name is better `$provideLlmToolsFromEnv` or `$provideLlmToolsFromEnvironment`?
  * TODO: [🧠] Is there some meaningfull way how to test this util
- * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
  * TODO: [🥃] Allow `ptbk make` without llm tools
  * TODO: This should be maybe not under `_common` but under `utils`
  * TODO: [®] DRY Register logic

package/esm/src/llm-providers/_multiple/playground/playground.d.ts

@@ -1,5 +1,3 @@
 #!/usr/bin/env ts-node
 export {};
-/**
- * Note: [⚫] Code in this file should never be published in any package
- */
+/** Note: [⚫] Code for playground [_multiple playground](src/llm-providers/_multiple/playground/playground.ts) should never be published in any package */

package/esm/src/llm-providers/agent/playground/playground.d.ts

@@ -1,8 +1,8 @@
 #!/usr/bin/env ts-node
 export {};
+/** Note: [⚫] Code for playground [agent playground](src/llm-providers/agent/playground/playground.ts) should never be published in any package */
 /**
  * TODO: [🧠] Add more complex agent scenarios
  * TODO: [🧠] Add parameter substitution demo
  * TODO: [🧠] Add multi-turn conversation demo
- * Note: [⚫] Code in this file should never be published in any package
  */

package/esm/src/llm-providers/anthropic-claude/playground/playground.d.ts

@@ -1,7 +1,7 @@
 #!/usr/bin/env ts-node
 export {};
+/** Note: [⚫] Code for playground [anthropic-claude playground](src/llm-providers/anthropic-claude/playground/playground.ts) should never be published in any package */
 /**
  * TODO: [main] !!3 Playground with WebGPT / Promptbook.studio anonymous server
  * TODO: [main] !!3 Test here that `systemMessage`, `temperature` and `seed` are working correctly
- * Note: [⚫] Code in this file should never be published in any package
  */

package/esm/src/llm-providers/azure-openai/playground/playground.d.ts

@@ -1,6 +1,4 @@
 #!/usr/bin/env ts-node
 export {};
-/**
- * TODO: Test here that `systemMessage`, `temperature` and `seed` are working correctly
- * Note: [⚫] Code in this file should never be published in any package
- */
+/** Note: [⚫] Code for playground [azure-openai playground](src/llm-providers/azure-openai/playground/playground.ts) should never be published in any package */
+/** TODO: Test here that `systemMessage`, `temperature` and `seed` are working correctly */

package/esm/src/llm-providers/ollama/playground/playground.d.ts

@@ -1,6 +1,4 @@
 #!/usr/bin/env ts-node
 export {};
-/**
- * TODO: [main] !!3 Test here that `systemMessage`, `temperature` and `seed` are working correctly
- * Note: [⚫] Code in this file should never be published in any package
- */
+/** Note: [⚫] Code for playground [ollama playground](src/llm-providers/ollama/playground/playground.ts) should never be published in any package */
+/** TODO: [main] !!3 Test here that `systemMessage`, `temperature` and `seed` are working correctly */

package/esm/src/llm-providers/openai/playground/playground.d.ts

@@ -1,6 +1,4 @@
 #!/usr/bin/env ts-node
 export {};
-/**
- * TODO: [main] !!3 Test here that `systemMessage`, `temperature` and `seed` are working correctly
- * Note: [⚫] Code in this file should never be published in any package
- */
+/** Note: [⚫] Code for playground [openai playground](src/llm-providers/openai/playground/playground.ts) should never be published in any package */
+/** TODO: [main] !!3 Test here that `systemMessage`, `temperature` and `seed` are working correctly */

package/esm/src/llm-providers/remote/playground/playground.d.ts

@@ -1,5 +1,3 @@
 #!/usr/bin/env ts-node
 import '../../openai/register-constructor';
-/**
- * Note: [⚫] Code in this file should never be published in any package
- */
+/** Note: [⚫] Code for playground [remote playground](src/llm-providers/remote/playground/playground.ts) should never be published in any package */