@promptbook/remote-server 0.112.0-32 → 0.112.0-34

package/esm/index.es.js

@@ -40,7 +40,7 @@ const BOOK_LANGUAGE_VERSION = '2.0.0';
  * @generated
  * @see https://github.com/webgptorg/promptbook
  */
-const PROMPTBOOK_ENGINE_VERSION = '0.112.0-32';
+const PROMPTBOOK_ENGINE_VERSION = '0.112.0-34';
 /**
  * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
  * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -1388,9 +1388,7 @@ function $execCommand(options) {
         }
     });
 }
-/**
- * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
- */
+/** Note: [🟢] Code for Node command-execution helper [$execCommand](src/utils/execCommand/$execCommand.ts) should never be published into packages that could be imported into browser environment */
 
 /**
  * [🐱‍🚀]
@@ -1417,9 +1415,7 @@ async function startAgentServer(options) {
         isVerbose: true,
     });
 }
-/**
- * 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 */
 
 /**
  * Make error report URL for the given error
@@ -1932,10 +1928,8 @@ async function locateAppOnLinux({ linuxWhich, }) {
         return 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` */
 
 /**
  * Provides filesystem access (for example for Node.js-based scrapers)
@@ -1958,10 +1952,8 @@ function $provideFilesystemForNode(options) {
         watch,
     };
 }
-/**
- * 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 */
 
 /**
  * Checks if the file is executable
@@ -2014,10 +2006,8 @@ async function locateAppOnMacOs({ macOsName, }) {
         return 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` */
 
 /**
  * Attempts to locate the specified application on a Windows system by searching common installation directories.
@@ -2046,10 +2036,8 @@ async function locateAppOnWindows({ appName, windowsSuffix, }) {
         return 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` */
 
 /**
  * Locates an application on the system
@@ -2086,10 +2074,8 @@ function locateApp(options) {
         }
     }
 }
-/**
- * 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` */
 
 /**
  * Locates the LibreOffice executable on the current system by searching platform-specific paths.
@@ -2105,10 +2091,8 @@ function locateLibreoffice() {
         macOsName: 'LibreOffice',
     });
 }
-/**
- * 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` */
 
 /**
  * Locates the Pandoc executable on the current system by searching platform-specific paths.
@@ -2124,10 +2108,8 @@ function locatePandoc() {
         macOsName: 'Pandoc',
     });
 }
-/**
- * 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` */
 
 /**
  * Provides paths to required executables (i.e. as Pandoc and LibreOffice) for Node.js environments.
@@ -2144,9 +2126,9 @@ async function $provideExecutablesForNode(options) {
         //                                              <- TODO: [🧠] `null` vs `undefined`
     };
 }
+/** 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
  */
 
@@ -8079,10 +8061,8 @@ async function $provideScrapersForNode(tools, options) {
     }
     return scrapers;
 }
-/**
- * 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 */
 
 /**
  * Normalizes a given text to camelCase format.
@@ -10405,12 +10385,12 @@ async function getScraperIntermediateSource(source, options) {
     };
     return fileHandler;
 }
+/** 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
  */
 
 /**
@@ -10742,11 +10722,11 @@ class WebsiteScraper {
         return knowledge;
     }
 }
+/** 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
  */
 
 /**
@@ -10869,9 +10849,7 @@ async function fetchUrlContent(url) {
         `);
     }
 }
-/**
- * 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 */
 
 /**
  * Cached implementation of `run_browser` when it can be resolved.
@@ -22642,10 +22620,8 @@ async function $provideScriptingForNode(options) {
     // TODO: [🔱] Do here auto-installation
     return [new JavascriptExecutionTools({ ...options, functions: getAllCommitmentsToolFunctionsForNode() })];
 }
-/**
- * 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 */
 
 // TODO: [🥺] List running services from REMOTE_SERVER_URLS
 // TODO: [🥺] Import directly from YML
@@ -23851,8 +23827,8 @@ function startRemoteServer(options) {
         },
     };
 }
+/** 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
@@ -23865,7 +23841,6 @@ function startRemoteServer(options) {
  * 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
  */
 
 /**