@promptbook/wizard 0.100.0-2 → 0.100.0-21

package/esm/typings/src/book-2.0/utils/profileImageUtils.d.ts

@@ -0,0 +1,39 @@
+import type { string_url_image } from '../../types/typeAliases';
+/**
+ * Extracts profile image URL from agent definition text and returns cleaned system message
+ * @param systemMessage The original system message that may contain META IMAGE line
+ * @returns Object with profileImageUrl (if found) and cleanedSystemMessage (without META IMAGE line)
+ *
+ * @private - TODO: [🧠] Maybe should be public?
+ */
+export declare function extractProfileImageFromSystemMessage(systemMessage: string): {
+    profileImageUrl?: string_url_image;
+    cleanedSystemMessage: string;
+};
+/**
+ * Extracts persona, examples, and profile image from agent definition text
+ * @param systemMessage The original system message that may contain PERSONA, EXAMPLE, and META IMAGE lines
+ * @returns Object with extracted information and cleaned system message
+ *
+ * @private - TODO: [🧠] Maybe should be public?
+ */
+export declare function extractAgentMetadata(systemMessage: string): {
+    persona?: {
+        name: string;
+        description?: string;
+    };
+    examples: string[];
+    profileImageUrl?: string_url_image;
+    cleanedSystemMessage: string;
+};
+/**
+ * Generates a gravatar URL based on agent name for fallback avatar
+ * @param name The agent name to generate avatar for
+ * @returns Gravatar URL
+ *
+ * @private - TODO: [🧠] Maybe should be public?
+ */
+export declare function generateGravatarUrl(name?: string | null): string;
+/**
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ */

package/esm/typings/src/pipeline/book-notation.d.ts

@@ -1,3 +1,4 @@
+import type { string_book } from '../book-2.0/agent-source/string_book';
 import type { PipelineString } from './PipelineString';
 /**
  * Tag function for notating a pipeline with a book\`...\ notation as template literal
@@ -12,7 +13,7 @@ import type { PipelineString } from './PipelineString';
  * @returns the pipeline string
  * @public exported from `@promptbook/core`
  */
-export declare function book(strings: TemplateStringsArray, ...values: Array<string>): PipelineString;
+export declare function book(strings: TemplateStringsArray, ...values: Array<string>): string_book & PipelineString;
 /**
  * TODO: [🧠][🈴] Where is the best location for this file
  * Note: [💞] Ignore a discrepancy between file name and entity name

package/esm/typings/src/types/typeAliases.d.ts

@@ -136,6 +136,12 @@ export type ReservedParameters = Record<string_reserved_parameter_name, string_p
  * For example `"Ai*nautes"`
  */
 export type string_title = string;
+/**
+ * Semantic helper
+ *
+ * For example `"My AI Assistant"`
+ */
+export type string_agent_name = string;
 /**
  * Unstructured description of the persona
  *

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-20`).
  *
  * @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-21",
     "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-21"
     },
     "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-21';
     /**
      * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
      * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -2720,6 +2720,18 @@
     const OPENAI_MODELS = exportJson({
         name: 'OPENAI_MODELS',
         value: [
+            /**/
+            {
+                modelVariant: 'CHAT',
+                modelTitle: 'gpt-5',
+                modelName: 'gpt-5',
+                modelDescription: "OpenAI's most advanced language model with unprecedented reasoning capabilities and 200K context window. Features revolutionary improvements in complex problem-solving, scientific reasoning, and creative tasks. Demonstrates human-level performance across diverse domains with enhanced safety measures and alignment. Represents the next generation of AI with superior understanding, nuanced responses, and advanced multimodal capabilities.",
+                pricing: {
+                    prompt: pricing(`$10.00 / 1M tokens`),
+                    output: pricing(`$30.00 / 1M tokens`),
+                },
+            },
+            /**/
             /*/
               {
                   modelTitle: 'dall-e-3',
@@ -5184,7 +5196,7 @@
          * Default model for chat variant.
          */
         getDefaultChatModel() {
-            return this.getDefaultModel('gpt-4-turbo');
+            return this.getDefaultModel('gpt-5');
         }
         /**
          * Default model for completion variant.
@@ -5974,7 +5986,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 +7766,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 +7797,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 +10905,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 +11209,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 +11956,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 +16856,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 +16984,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 +17014,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 +17053,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);
         }
     }