@promptbook/javascript 0.112.0-32 → 0.112.0-34

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

package/esm/src/llm-providers/vercel/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 [vercel playground](src/llm-providers/vercel/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/playground/permanent/_boilerplate.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 permanent playground [_boilerplate](src/playground/permanent/_boilerplate.ts) should never be published in any package */

package/esm/src/playground/permanent/agent-with-browser-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 permanent playground [agent-with-browser-playground](src/playground/permanent/agent-with-browser-playground.ts) should never be published in any package */

package/esm/src/playground/permanent/error-handling-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 permanent playground [error-handling-playground](src/playground/permanent/error-handling-playground.ts) should never be published in any package */

package/esm/src/playground/playground.d.ts

@@ -1,6 +1,4 @@
 #!/usr/bin/env ts-node
 export {};
-/**
- * TODO: !!!!!!! Extract to `other` and append DigitalOcean instructions
- * Note: [⚫] Code in this file should never be published in any package
- */
+/** Note: [⚫] Code for playground [main playground](src/playground/playground.ts) should never be published in any package */
+/** TODO: !!!!!!! Extract to `other` and append DigitalOcean instructions */

package/esm/src/remote-server/startAgentServer.d.ts

@@ -21,6 +21,4 @@ type AgentsServerOptions = {
  */
 export declare function startAgentServer(options: AgentsServerOptions): Promise<TODO_any>;
 export {};
-/**
- * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
- */
+/** Note: [🟢] Code for Node server bootstrap [startAgentServer](src/remote-server/startAgentServer.ts) should never be published into packages that could be imported into browser environment */

package/esm/src/remote-server/startRemoteServer.d.ts

@@ -10,8 +10,8 @@ import type { RemoteServerOptions } from './types/RemoteServerOptions';
  * @public exported from `@promptbook/remote-server`
  */
 export declare function startRemoteServer<TCustomOptions = undefined>(options: RemoteServerOptions<TCustomOptions>): RemoteServer;
+/** Note: [🟢] Code for Node server bootstrap [startRemoteServer](src/remote-server/startRemoteServer.ts) should never be published into packages that could be imported into browser environment */
 /**
-
  * TODO: [🕋] Use here `aboutPromptbookInformation`
  * TODO: [🌡] Add CORS and security - probably via `helmet`
  * TODO: Split this file into multiple functions - handler for each request
@@ -24,5 +24,4 @@ export declare function startRemoteServer<TCustomOptions = undefined>(options: R
  * TODO: [🃏] Pass here some security token to prevent malitious usage and/or DDoS
  * TODO: [0] Set unavailable models as undefined in `RemoteLlmExecutionTools` NOT throw error here
  * TODO: Allow to constrain anonymous mode for specific models / providers
- * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
  */

package/esm/src/scrapers/_boilerplate/BoilerplateScraper.d.ts

@@ -34,9 +34,7 @@ export declare class BoilerplateScraper implements Converter, Scraper {
      */
     scrape(source: ScraperSourceHandler): Promise<ReadonlyArray<Omit<KnowledgePiecePreparedJson, 'sources' | 'preparationIds'>> | null>;
 }
-/**
- * TODO: [👣] Converted documents can act as cached items - there is no need to run conversion each time
- * TODO: [🪂] Do it in parallel
- * Note: No need to aggregate usage here, it is done by intercepting the llmTools
- * @@ Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
- */
+/** TODO: [👣] Converted documents can act as cached items - there is no need to run conversion each time */
+/** TODO: [🪂] Do it in parallel */
+/** Note: No need to aggregate usage here, it is done by intercepting the llmTools */
+/** Note: [🟢] Code for Node scraper boilerplate [BoilerplateScraper](src/scrapers/_boilerplate/BoilerplateScraper.ts) should never be published into packages that could be imported into browser environment */

package/esm/src/scrapers/_boilerplate/playground/boilerplate-scraper-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 [boilerplate-scraper-playground](src/scrapers/_boilerplate/playground/boilerplate-scraper-playground.ts) should never be published in any package */

package/esm/src/scrapers/_common/register/$provideFilesystemForNode.d.ts

@@ -7,7 +7,5 @@ import type { PrepareAndScrapeOptions } from '../../../prepare/PrepareAndScrapeO
  * @public exported from `@promptbook/node`
  */
 export declare function $provideFilesystemForNode(options?: Pick<PrepareAndScrapeOptions, 'isVerbose'>): FilesystemTools;
-/**
- * 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 scraper registration helper [$provideFilesystemForNode](src/scrapers/_common/register/$provideFilesystemForNode.ts) should never be published into packages that could be imported into browser environment */
+/** TODO: [🏓] Unite `xxxForServer` and `xxxForNode` naming */

package/esm/src/scrapers/_common/register/$provideScrapersForNode.d.ts

@@ -8,7 +8,5 @@ import type { Scraper } from '../Scraper';
  * @public exported from `@promptbook/node`
  */
 export declare function $provideScrapersForNode(tools: Pick<ExecutionTools, 'fs' | 'llm' | 'executables'>, options?: PrepareAndScrapeOptions): Promise<ReadonlyArray<Scraper>>;
-/**
- * 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 scraper registration helper [$provideScrapersForNode](src/scrapers/_common/register/$provideScrapersForNode.ts) should never be published into packages that could be imported into browser environment */
+/** TODO: [🏓] Unite `xxxForServer` and `xxxForNode` naming */

package/esm/src/scrapers/_common/register/$provideScriptingForNode.d.ts

@@ -6,7 +6,5 @@ import type { PrepareAndScrapeOptions } from '../../../prepare/PrepareAndScrapeO
  * @public exported from `@promptbook/node`
  */
 export declare function $provideScriptingForNode(options?: PrepareAndScrapeOptions): Promise<ReadonlyArray<ScriptExecutionTools>>;
-/**
- * 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 scraper registration helper [$provideScriptingForNode](src/scrapers/_common/register/$provideScriptingForNode.ts) should never be published into packages that could be imported into browser environment */
+/** TODO: [🏓] Unite `xxxForServer` and `xxxForNode` naming */

package/esm/src/scrapers/_common/utils/getScraperIntermediateSource.d.ts

@@ -26,10 +26,10 @@ type GetScraperIntermediateSourceHandler = Required<Pick<PrepareAndScrapeOptions
  */
 export declare function getScraperIntermediateSource(source: GetScraperIntermediateSourceSource, options: GetScraperIntermediateSourceHandler): Promise<ScraperIntermediateSource>;
 export {};
+/** Note: [🟢] Code for Node scraper helper [getScraperIntermediateSource](src/scrapers/_common/utils/getScraperIntermediateSource.ts) should never be published into packages that could be imported into browser environment */
 /**
  * Note: Not using `FileCacheStorage` for two reasons:
  * 1) Need to store more than serialized JSONs
  * 2) Need to switch between a `rootDirname` and `cacheDirname` <- TODO: [😡]
  * TODO: [🐱‍🐉][🧠] Make some smart crop
- * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
  */

package/esm/src/scrapers/document/DocumentScraper.d.ts

@@ -34,9 +34,9 @@ export declare class DocumentScraper implements Converter, Scraper {
      */
     scrape(source: ScraperSourceHandler): Promise<ReadonlyArray<Omit<KnowledgePiecePreparedJson, 'sources' | 'preparationIds'>> | null>;
 }
+/** Note: [🟢] Code for Node scraper implementation [DocumentScraper](src/scrapers/document/DocumentScraper.ts) should never be published into packages that could be imported into browser environment */
 /**
  * TODO: [👣] Converted documents can act as cached items - there is no need to run conversion each time
  * TODO: [🪂] Do it in parallel 11:11
  * Note: No need to aggregate usage here, it is done by intercepting the llmTools
- * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
  */

package/esm/src/scrapers/document/playground/document-scraper-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 [document-scraper-playground](src/scrapers/document/playground/document-scraper-playground.ts) should never be published in any package */

package/esm/src/scrapers/document-legacy/LegacyDocumentScraper.d.ts

@@ -34,9 +34,9 @@ export declare class LegacyDocumentScraper implements Converter, Scraper {
      */
     scrape(source: ScraperSourceHandler): Promise<ReadonlyArray<Omit<KnowledgePiecePreparedJson, 'sources' | 'preparationIds'>> | null>;
 }
+/** Note: [🟢] Code for Node scraper implementation [LegacyDocumentScraper](src/scrapers/document-legacy/LegacyDocumentScraper.ts) should never be published into packages that could be imported into browser environment */
 /**
  * TODO: [👣] Converted documents can act as cached items - there is no need to run conversion each time
  * TODO: [🪂] Do it in parallel 11:11
  * Note: No need to aggregate usage here, it is done by intercepting the llmTools
- * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
  */

package/esm/src/scrapers/document-legacy/playground/legacy-document-scraper-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 [legacy-document-scraper-playground](src/scrapers/document-legacy/playground/legacy-document-scraper-playground.ts) should never be published in any package */

package/esm/src/scrapers/markdown/playground/markdown-scraper-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 [markdown-scraper-playground](src/scrapers/markdown/playground/markdown-scraper-playground.ts) should never be published in any package */

package/esm/src/scrapers/markitdown/MarkitdownScraper.d.ts

@@ -41,10 +41,10 @@ export declare class MarkitdownScraper implements Converter, Scraper {
      */
     scrape(source: ScraperSourceHandler): Promise<ReadonlyArray<Omit<KnowledgePiecePreparedJson, 'sources' | 'preparationIds'>> | null>;
 }
+/** Note: [🟢] Code for Node scraper implementation [MarkitdownScraper](src/scrapers/markitdown/MarkitdownScraper.ts) should never be published into packages that could be imported into browser environment */
 /**
  * TODO: [🧠][🌜] Export only from `@promptbook/markitdown` or `@promptbook/pdf` NOT both
  * TODO: [👣] Converted documents can act as cached items - there is no need to run conversion each time
  * TODO: [🪂] Do it in parallel
  * Note: No need to aggregate usage here, it is done by intercepting the llmTools
- * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
  */

package/esm/src/scrapers/markitdown/playground/markitdown-scraper-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 [markitdown-scraper-playground](src/scrapers/markitdown/playground/markitdown-scraper-playground.ts) should never be published in any package */

package/esm/src/scrapers/pdf/PdfScraper.d.ts

@@ -33,9 +33,9 @@ export declare class PdfScraper implements Converter, Scraper {
      */
     scrape(source: ScraperSourceHandler): Promise<ReadonlyArray<Omit<KnowledgePiecePreparedJson, 'sources' | 'preparationIds'>> | null>;
 }
+/** Note: [🟢] Code for Node scraper implementation [PdfScraper](src/scrapers/pdf/PdfScraper.ts) should never be published into packages that could be imported into browser environment */
 /**
  * TODO: [👣] Converted pdf documents can act as cached items - there is no need to run conversion each time
  * TODO: [🪂] Do it in parallel 11:11
  * Note: No need to aggregate usage here, it is done by intercepting the llmTools
- * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
  */

package/esm/src/scrapers/pdf/playground/pdf-scraper-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 [pdf-scraper-playground](src/scrapers/pdf/playground/pdf-scraper-playground.ts) should never be published in any package */

package/esm/src/scrapers/website/WebsiteScraper.d.ts

@@ -42,9 +42,9 @@ export declare class WebsiteScraper implements Converter, Scraper {
      */
     scrape(source: ScraperSourceHandler): Promise<ReadonlyArray<Omit<KnowledgePiecePreparedJson, 'sources' | 'preparationIds'>> | null>;
 }
+/** Note: [🟢] Code for Node scraper implementation [WebsiteScraper](src/scrapers/website/WebsiteScraper.ts) should never be published into packages that could be imported into browser environment */
 /**
  * TODO: [👣] Scraped website in .md can act as cache item - there is no need to run conversion each time
  * TODO: [🪂] Do it in parallel 11:11
  * Note: No need to aggregate usage here, it is done by intercepting the llmTools
- * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
  */

package/esm/src/scrapers/website/playground/website-scraper-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 [website-scraper-playground](src/scrapers/website/playground/website-scraper-playground.ts) should never be published in any package */

package/esm/src/speech-recognition/BrowserSpeechRecognition.d.ts

@@ -15,7 +15,5 @@ export declare class BrowserSpeechRecognition implements SpeechRecognition {
     subscribe(callback: (event: SpeechRecognitionEvent) => void): () => void;
     private emit;
 }
-/**
- * TODO: !!!! Search ACRY for `window` and put -> [🔵]
- * Note: [🔵] Code in this file should never be published outside of `@promptbook/browser`
- */
+/** Note: [🔵] Code for browser speech-recognition adapter [BrowserSpeechRecognition](src/speech-recognition/BrowserSpeechRecognition.ts) should never be published outside of `@promptbook/browser` */
+/** TODO: !!!! Search ACRY for `window` and put -> [🔵] */

package/esm/src/storage/file-cache-storage/FileCacheStorage.d.ts

@@ -34,7 +34,5 @@ export declare class FileCacheStorage<TItem> implements PromptbookStorage<TItem>
      */
     removeItem(key: string): Promise<void>;
 }
-/**
- * TODO: [🌗] Maybe some checkers, not all valid JSONs are desired and valid values
- * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
- */
+/** Note: [🟢] Code for Node file-cache storage [FileCacheStorage](src/storage/file-cache-storage/FileCacheStorage.ts) should never be published into packages that could be imported into browser environment */
+/** TODO: [🌗] Maybe some checkers, not all valid JSONs are desired and valid values */

package/esm/src/storage/local-storage/getIndexedDbStorage.d.ts

@@ -6,6 +6,4 @@ import type { IndexedDbStorageOptions } from './utils/IndexedDbStorageOptions';
  * @public exported from `@promptbook/browser`
  */
 export declare function getIndexedDbStorage<TItem>(options: IndexedDbStorageOptions): PromptbookStorage<TItem>;
-/**
- * Note: [🔵] Code in this file should never be published outside of `@promptbook/browser`
- */
+/** Note: [🔵] Code for browser storage helper [getIndexedDbStorage](src/storage/local-storage/getIndexedDbStorage.ts) should never be published outside of `@promptbook/browser` */

package/esm/src/storage/local-storage/getLocalStorage.d.ts

@@ -5,6 +5,4 @@ import type { PromptbookStorage } from '../_common/PromptbookStorage';
  * @public exported from `@promptbook/browser`
  */
 export declare function getLocalStorage<TItem>(): PromptbookStorage<TItem>;
-/**
- * Note: [🔵] Code in this file should never be published outside of `@promptbook/browser`
- */
+/** Note: [🔵] Code for browser storage helper [getLocalStorage](src/storage/local-storage/getLocalStorage.ts) should never be published outside of `@promptbook/browser` */

package/esm/src/storage/local-storage/getSessionStorage.d.ts

@@ -5,6 +5,4 @@ import type { PromptbookStorage } from '../_common/PromptbookStorage';
  * @public exported from `@promptbook/browser`
  */
 export declare function getSessionStorage<TItem>(): PromptbookStorage<TItem>;
-/**
- * Note: [🔵] Code in this file should never be published outside of `@promptbook/browser`
- */
+/** Note: [🔵] Code for browser storage helper [getSessionStorage](src/storage/local-storage/getSessionStorage.ts) should never be published outside of `@promptbook/browser` */

package/esm/src/transpilers/openai-sdk/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 [openai-sdk playground](src/transpilers/openai-sdk/playground/playground.ts) should never be published in any package */

package/esm/src/types/InputParameters_private.d.ts

@@ -0,0 +1,11 @@
+import type { really_unknown } from '../utils/organization/really_unknown';
+import type { ReservedParameters_private } from './ReservedParameters_private';
+import type { string_parameter_name } from './string_parameter_name';
+/**
+ * Parameters to pass to execution of the pipeline
+ *
+ * Note: [🚉] This should be fully serializable as JSON
+ * @see https://ptbk.io/parameters
+ * @private internal utility of `string_parameter_name.ts`
+ */
+export type InputParameters_private = Exclude<Record<string_parameter_name, really_unknown>, ReservedParameters_private>;