@promptbook/utils 0.112.0-65 → 0.112.0-66

package/esm/src/avatars/visuals/minecraftAvatarVisualShared.d.ts

@@ -0,0 +1,48 @@
+import type { AvatarPalette } from '../types/AvatarVisualDefinition';
+/**
+ * One Minecraft-style pixel texture sampled on a cuboid face.
+ *
+ * @private helper of the Minecraft avatar visuals
+ */
+export type MinecraftTexture = ReadonlyArray<ReadonlyArray<string>>;
+/**
+ * Full six-face texture pack for one rendered cuboid.
+ *
+ * @private helper of the Minecraft avatar visuals
+ */
+export type MinecraftCuboidTextures = {
+    readonly front: MinecraftTexture;
+    readonly back: MinecraftTexture;
+    readonly left: MinecraftTexture;
+    readonly right: MinecraftTexture;
+    readonly top: MinecraftTexture;
+    readonly bottom: MinecraftTexture;
+};
+/**
+ * Shared subset of avatar colors used by the Minecraft avatar helpers.
+ *
+ * @private helper of the Minecraft avatar visuals
+ */
+type MinecraftTexturePalette = Pick<AvatarPalette, 'primary' | 'secondary' | 'accent' | 'highlight' | 'ink' | 'shadow'>;
+/**
+ * Builds the seeded six-face texture pack used by the Minecraft-style head cuboid.
+ *
+ * @param random Seeded random generator.
+ * @param palette Derived avatar palette.
+ * @param hasHeadband Whether the generated avatar should include a colored headband.
+ * @returns Head cuboid textures.
+ *
+ * @private helper of the Minecraft avatar visuals
+ */
+export declare function createMinecraftHeadTextures(random: () => number, palette: MinecraftTexturePalette, hasHeadband: boolean): MinecraftCuboidTextures;
+/**
+ * Builds the seeded six-face texture pack used by the Minecraft-style torso cuboid.
+ *
+ * @param random Seeded random generator.
+ * @param palette Derived avatar palette.
+ * @returns Torso cuboid textures.
+ *
+ * @private helper of the Minecraft avatar visuals
+ */
+export declare function createMinecraftTorsoTextures(random: () => number, palette: MinecraftTexturePalette): MinecraftCuboidTextures;
+export {};

package/esm/src/cli/cli-commands/coder/ensureCoderGitignoreFile.d.ts

@@ -1,6 +1,6 @@
 import type { InitializationStatus } from './boilerplateTemplates';
 /**
- * Ensures `.gitignore` contains the standalone Promptbook coder temp and cache entries.
+ * Ensures `.gitignore` contains the shared Promptbook working-directory entry.
  *
  * @private function of `initializeCoderProjectConfiguration`
  */

package/esm/src/config.d.ts

@@ -270,7 +270,7 @@ export declare const DEFAULT_AGENTS_DIRNAME = "./agents";
  *
  * @public exported from `@promptbook/core`
  */
-export declare const DEFAULT_DOWNLOAD_CACHE_DIRNAME = "./.promptbook/download-cache";
+export declare const DEFAULT_DOWNLOAD_CACHE_DIRNAME: string;
 /**
  * Where to store the cache of executions for promptbook CLI
  *
@@ -278,7 +278,7 @@ export declare const DEFAULT_DOWNLOAD_CACHE_DIRNAME = "./.promptbook/download-ca
  *
  * @public exported from `@promptbook/core`
  */
-export declare const DEFAULT_EXECUTION_CACHE_DIRNAME = "./.promptbook/execution-cache";
+export declare const DEFAULT_EXECUTION_CACHE_DIRNAME: string;
 /**
  * Where to store the scrape cache
  *
@@ -286,7 +286,7 @@ export declare const DEFAULT_EXECUTION_CACHE_DIRNAME = "./.promptbook/execution-
  *
  * @public exported from `@promptbook/core`
  */
-export declare const DEFAULT_SCRAPE_CACHE_DIRNAME = "./.promptbook/scrape-cache";
+export declare const DEFAULT_SCRAPE_CACHE_DIRNAME: string;
 /**
  * Id of application for the CLI when using remote server
  *

package/esm/src/utils/files/getPromptbookTempPath.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Builds one project-relative path inside the shared Promptbook working directory.
+ *
+ * @private internal utility for Promptbook-owned temp files
+ */
+export declare function getPromptbookTempPath(...pathSegments: ReadonlyArray<string>): string;
+/**
+ * Builds one absolute filesystem path inside the shared Promptbook working directory for a project root.
+ *
+ * @private internal utility for Promptbook-owned temp files
+ */
+export declare function resolvePromptbookTempPath(projectPath: string, ...pathSegments: ReadonlyArray<string>): string;
+/**
+ * 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
+ */
+export declare function getPromptbookTempPosixPath(...pathSegments: ReadonlyArray<string>): string;
+/**
+ * Builds one rooted `.gitignore` rule targeting a path inside the shared Promptbook working directory.
+ *
+ * @private internal utility for Promptbook-owned temp files
+ */
+export declare function getPromptbookTempGitignoreRule(...pathSegments: ReadonlyArray<string>): string;

package/esm/src/utils/files/getPromptbookTempPath.test.d.ts

@@ -0,0 +1 @@
+export {};

package/esm/src/version.d.ts

@@ -15,7 +15,7 @@ export declare const BOOK_LANGUAGE_VERSION: string_semantic_version;
 export declare const PROMPTBOOK_ENGINE_VERSION: string_promptbook_version;
 /**
  * Represents the version string of the Promptbook engine.
- * It follows semantic versioning (e.g., `0.112.0-64`).
+ * It follows semantic versioning (e.g., `0.112.0-65`).
  *
  * @generated
  */

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@promptbook/utils",
-    "version": "0.112.0-65",
+    "version": "0.112.0-66",
     "description": "Promptbook: Create persistent AI agents that turn your company's scattered knowledge into action",
     "private": false,
     "sideEffects": false,

package/umd/index.umd.js

@@ -22,7 +22,7 @@
      * @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
@@ -941,6 +941,29 @@
     }
     // 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 path.posix.join(PROMPTBOOK_TEMP_DIRECTORY_NAME, ...pathSegments);
+    }
+
     /**
      * Name for the Promptbook
      *
@@ -1035,6 +1058,31 @@
      * @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.