@promptbook/utils 0.112.0-65 → 0.112.0-66

package/esm/index.es.js

@@ -1,5 +1,5 @@
 import { spaceTrim as spaceTrim$1 } from 'spacetrim';
-import { basename } from 'path';
+import { posix, basename } from 'path';
 import { randomBytes } from 'crypto';
 import { SHA256 } from 'crypto-js';
 import hexEncoder from 'crypto-js/enc-hex';
@@ -18,7 +18,7 @@ const BOOK_LANGUAGE_VERSION = '2.0.0';
  * @generated
  * @see https://github.com/webgptorg/promptbook
  */
-const PROMPTBOOK_ENGINE_VERSION = '0.112.0-65';
+const PROMPTBOOK_ENGINE_VERSION = '0.112.0-66';
 /**
  * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
  * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -937,6 +937,29 @@ function saturate(amount) {
 }
 // TODO: Maybe implement by mix+hsl
 
+/**
+ * Relative directory name without the `./` prefix for Git ignore rules and glob patterns.
+ *
+ * @private internal utility for Promptbook-owned temp files
+ */
+const PROMPTBOOK_TEMP_DIRECTORY_NAME = '.promptbook';
+/**
+ * Builds one project-relative path inside the shared Promptbook working directory.
+ *
+ * @private internal utility for Promptbook-owned temp files
+ */
+function getPromptbookTempPath(...pathSegments) {
+    return `./${getPromptbookTempPosixPath(...pathSegments)}`;
+}
+/**
+ * Builds one POSIX path fragment inside the shared Promptbook working directory for globs and generated text files.
+ *
+ * @private internal utility for Promptbook-owned temp files
+ */
+function getPromptbookTempPosixPath(...pathSegments) {
+    return posix.join(PROMPTBOOK_TEMP_DIRECTORY_NAME, ...pathSegments);
+}
+
 /**
  * Name for the Promptbook
  *
@@ -1031,6 +1054,31 @@ const VALUE_STRINGS = {
  * @public exported from `@promptbook/utils`
  */
 const SMALL_NUMBER = 0.001;
+// <- TODO: [🕝] Make also `AGENTS_DIRNAME_ALTERNATIVES`
+/**
+ * Where to store the temporary downloads
+ *
+ * Note: When the folder does not exist, it is created recursively
+ *
+ * @public exported from `@promptbook/core`
+ */
+getPromptbookTempPath('download-cache');
+/**
+ * Where to store the cache of executions for promptbook CLI
+ *
+ * Note: When the folder does not exist, it is created recursively
+ *
+ * @public exported from `@promptbook/core`
+ */
+getPromptbookTempPath('execution-cache');
+/**
+ * Where to store the scrape cache
+ *
+ * Note: When the folder does not exist, it is created recursively
+ *
+ * @public exported from `@promptbook/core`
+ */
+getPromptbookTempPath('scrape-cache');
 // <- TODO: [🧜‍♂️]
 /**
  * Default settings for parsing and generating CSV files in Promptbook.