@promptbook/wizard 0.100.0-2 → 0.100.0-4

package/esm/typings/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.100.0-1`).
+ * It follows semantic versioning (e.g., `0.100.0-3`).
  *
  * @generated
  */

package/esm/typings/src/wizard/wizard.d.ts

@@ -6,6 +6,15 @@ import type { InputParameters } from '../types/typeAliases';
 import type { string_filename } from '../types/typeAliases';
 import type { string_parameter_value } from '../types/typeAliases';
 import type { string_pipeline_url } from '../types/typeAliases';
+/**
+ * Options for wizard methods
+ */
+interface WizardOptions {
+    /**
+     * Whether to enable verbose logging
+     */
+    isVerbose?: boolean;
+}
 /**
  * Wizard for simple usage of the Promptbook
  * Look at `wizard` for more details
@@ -26,7 +35,7 @@ declare class Wizard {
      *
      * Note: This works similar to the `ptbk run` command
      */
-    execute(book: string_pipeline_url | string_filename | PipelineString, inputParameters: InputParameters): Promise<{
+    execute(book: string_pipeline_url | string_filename | PipelineString, inputParameters: InputParameters, options?: WizardOptions): Promise<{
         /**
          * Simple result of the execution
          */
@@ -36,9 +45,9 @@ declare class Wizard {
     /**
      * Provides the tools automatically for the Node.js environment
      *
-     * @param pipelineSource
+     * @param options
      */
-    getExecutionTools(): Promise<Required<Pick<ExecutionTools, 'fs' | 'fetch'>>>;
+    getExecutionTools(options?: WizardOptions): Promise<Required<Pick<ExecutionTools, 'fs' | 'fetch'>>>;
     /**
      * Load book from the source
      *
@@ -49,8 +58,9 @@ declare class Wizard {
      * 3) As a string
      *
      * @param pipelineSource
+     * @param options
      */
-    getCompiledBook(pipelineSource: string_filename | string_pipeline_url | PipelineString): Promise<PipelineJson>;
+    getCompiledBook(pipelineSource: string_filename | string_pipeline_url | PipelineString, options?: WizardOptions): Promise<PipelineJson>;
 }
 /**
  * Wizard for simple usage of the Promptbook

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@promptbook/wizard",
-    "version": "0.100.0-2",
+    "version": "0.100.0-4",
     "description": "Promptbook: Run AI apps in plain human language across multiple models and platforms",
     "private": false,
     "sideEffects": false,
@@ -95,7 +95,7 @@
     "module": "./esm/index.es.js",
     "typings": "./esm/typings/src/_packages/wizard.index.d.ts",
     "peerDependencies": {
-        "@promptbook/core": "0.100.0-2"
+        "@promptbook/core": "0.100.0-4"
     },
     "dependencies": {
         "@ai-sdk/deepseek": "0.1.6",

package/umd/index.umd.js

@@ -49,7 +49,7 @@
      * @generated
      * @see https://github.com/webgptorg/promptbook
      */
-    const PROMPTBOOK_ENGINE_VERSION = '0.100.0-2';
+    const PROMPTBOOK_ENGINE_VERSION = '0.100.0-4';
     /**
      * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
      * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -5974,7 +5974,23 @@
             .join('/') +
             '.' +
             extension;
-        await promises.mkdir(path.dirname(cacheFilename), { recursive: true });
+        // Note: Try to create cache directory, but don't fail if filesystem has issues
+        try {
+            await promises.mkdir(path.dirname(cacheFilename), { recursive: true });
+        }
+        catch (error) {
+            // Note: If we can't create cache directory, continue without it
+            //       This handles read-only filesystems, permission issues, and missing parent directories
+            if (error instanceof Error && (error.message.includes('EROFS') ||
+                error.message.includes('read-only') ||
+                error.message.includes('EACCES') ||
+                error.message.includes('EPERM') ||
+                error.message.includes('ENOENT'))) ;
+            else {
+                // Re-throw other unexpected errors
+                throw error;
+            }
+        }
         let isDestroyed = true;
         const fileHandler = {
             filename: cacheFilename,
@@ -7738,7 +7754,23 @@
             //    <- TODO: [🥬] Encapsulate sha256 to some private utility function
             const rootDirname = path.join(process.cwd(), DEFAULT_DOWNLOAD_CACHE_DIRNAME);
             const filepath = path.join(...nameToSubfolderPath(hash /* <- TODO: [🎎] Maybe add some SHA256 prefix */), `${basename.substring(0, MAX_FILENAME_LENGTH)}.${mimeTypeToExtension(mimeType)}`);
-            await tools.fs.mkdir(path.dirname(path.join(rootDirname, filepath)), { recursive: true });
+            // Note: Try to create cache directory, but don't fail if filesystem has issues
+            try {
+                await tools.fs.mkdir(path.dirname(path.join(rootDirname, filepath)), { recursive: true });
+            }
+            catch (error) {
+                // Note: If we can't create cache directory, we'll handle it when trying to write the file
+                //       This handles read-only filesystems, permission issues, and missing parent directories
+                if (error instanceof Error && (error.message.includes('EROFS') ||
+                    error.message.includes('read-only') ||
+                    error.message.includes('EACCES') ||
+                    error.message.includes('EPERM') ||
+                    error.message.includes('ENOENT'))) ;
+                else {
+                    // Re-throw other unexpected errors
+                    throw error;
+                }
+            }
             const fileContent = Buffer.from(await response.arrayBuffer());
             if (fileContent.length > DEFAULT_MAX_FILE_SIZE /* <- TODO: Allow to pass different value to remote server */) {
                 throw new LimitReachedError(`File is too large (${Math.round(fileContent.length / 1024 / 1024)}MB). Maximum allowed size is ${Math.round(DEFAULT_MAX_FILE_SIZE / 1024 / 1024)}MB.`);
@@ -7753,7 +7785,8 @@
                 if (error instanceof Error && (error.message.includes('EROFS') ||
                     error.message.includes('read-only') ||
                     error.message.includes('EACCES') ||
-                    error.message.includes('EPERM'))) {
+                    error.message.includes('EPERM') ||
+                    error.message.includes('ENOENT'))) {
                     // Return a handler that works directly with the downloaded content
                     return {
                         source: name,
@@ -10860,7 +10893,8 @@
                     if (error instanceof Error && (error.message.includes('EROFS') ||
                         error.message.includes('read-only') ||
                         error.message.includes('EACCES') ||
-                        error.message.includes('EPERM'))) ;
+                        error.message.includes('EPERM') ||
+                        error.message.includes('ENOENT'))) ;
                     else {
                         // Re-throw other unexpected errors
                         throw error;
@@ -11163,7 +11197,8 @@
                 if (error instanceof Error && (error.message.includes('EROFS') ||
                     error.message.includes('read-only') ||
                     error.message.includes('EACCES') ||
-                    error.message.includes('EPERM'))) ;
+                    error.message.includes('EPERM') ||
+                    error.message.includes('ENOENT'))) ;
                 else {
                     // Re-throw other unexpected errors
                     throw error;
@@ -11909,8 +11944,27 @@
                 throw new UnexpectedError(`The "${key}" you want to store in JSON file is not serializable as JSON`);
             }
             const fileContent = stringifyPipelineJson(value);
-            await promises.mkdir(path.dirname(filename), { recursive: true }); // <- [0]
-            await promises.writeFile(filename, fileContent, 'utf-8');
+            // Note: Try to create cache directory and write file, but don't fail if filesystem is read-only or has permission issues
+            try {
+                await promises.mkdir(path.dirname(filename), { recursive: true }); // <- [0]
+                await promises.writeFile(filename, fileContent, 'utf-8');
+            }
+            catch (error) {
+                // Note: If we can't write to cache, silently ignore the error
+                //       This handles read-only filesystems, permission issues, and missing parent directories
+                if (error instanceof Error && (error.message.includes('EROFS') ||
+                    error.message.includes('read-only') ||
+                    error.message.includes('EACCES') ||
+                    error.message.includes('EPERM') ||
+                    error.message.includes('ENOENT'))) {
+                    // Silently ignore filesystem errors - caching is optional
+                    return;
+                }
+                else {
+                    // Re-throw other unexpected errors
+                    throw error;
+                }
+            }
         }
         /**
          * Removes the key/value pair with the given key from the storage, if a key/value pair with the given key exists.
@@ -16790,7 +16844,8 @@
                         if (error instanceof Error && (error.message.includes('EROFS') ||
                             error.message.includes('read-only') ||
                             error.message.includes('EACCES') ||
-                            error.message.includes('EPERM'))) ;
+                            error.message.includes('EPERM') ||
+                            error.message.includes('ENOENT'))) ;
                         else {
                             // Re-throw other unexpected errors
                             throw error;
@@ -16917,14 +16972,14 @@
          *
          * Note: This works similar to the `ptbk run` command
          */
-        async execute(book, inputParameters) {
+        async execute(book, inputParameters, options = {}) {
             if (!$isRunningInNode()) {
                 throw new EnvironmentMismatchError('Wizard works only in Node.js environment');
             }
             // ▶ Get the tools
-            const tools = await this.getExecutionTools();
+            const tools = await this.getExecutionTools(options);
             // ▶ Get the Pipeline
-            const pipeline = await this.getCompiledBook(book);
+            const pipeline = await this.getCompiledBook(book, options);
             // ▶ Create executor - the function that will execute the Pipeline
             const pipelineExecutor = createPipelineExecutor({ pipeline, tools });
             // 🚀▶ Execute the Pipeline
@@ -16947,15 +17002,16 @@
         /**
          * Provides the tools automatically for the Node.js environment
          *
-         * @param pipelineSource
+         * @param options
          */
-        async getExecutionTools() {
+        async getExecutionTools(options = {}) {
+            var _a;
             if (this.executionTools !== null) {
                 return this.executionTools;
             }
             // TODO: DRY [◽]
             const prepareAndScrapeOptions = {
-                isVerbose: false,
+                isVerbose: (_a = options.isVerbose) !== null && _a !== void 0 ? _a : false,
                 isCacheReloaded: false, // <- TODO: Allow to pass
             }; /* <- TODO: ` satisfies PrepareAndScrapeOptions` */
             const fs = $provideFilesystemForNode();
@@ -16985,9 +17041,10 @@
          * 3) As a string
          *
          * @param pipelineSource
+         * @param options
          */
-        async getCompiledBook(pipelineSource) {
-            const tools = await this.getExecutionTools();
+        async getCompiledBook(pipelineSource, options = {}) {
+            const tools = await this.getExecutionTools(options);
             return /* not await */ $getCompiledBook(tools, pipelineSource);
         }
     }