@promptbook/node 0.100.0-36 → 0.100.0-37

package/esm/typings/src/execution/ExecutionTask.d.ts

@@ -29,6 +29,19 @@ type CreateTaskOptions<TTaskResult extends AbstractTaskResult> = {
          */
         readonly title?: AbstractTask<TTaskResult>['title'];
     }) => void): Promise<TTaskResult>;
+    /**
+     * Optional callback to provide custom tldr information
+     * @param createdAt When the task was created
+     * @param status Current task status
+     * @param currentValue Current partial result
+     * @param errors Current errors
+     * @param warnings Current warnings
+     * @returns Custom tldr information
+     */
+    tldrProvider?(createdAt: Date, status: task_status, currentValue: PartialDeep<TTaskResult>, errors: Array<Error>, warnings: Array<Error>): {
+        readonly percent: number_percent;
+        readonly message: string;
+    };
 };
 /**
  * Helper to create a new task

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-35`).
+ * It follows semantic versioning (e.g., `0.100.0-36`).
  *
  * @generated
  */

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@promptbook/node",
-    "version": "0.100.0-36",
+    "version": "0.100.0-37",
     "description": "Promptbook: Run AI apps in plain human language across multiple models and platforms",
     "private": false,
     "sideEffects": false,
@@ -93,7 +93,7 @@
     "module": "./esm/index.es.js",
     "typings": "./esm/typings/src/_packages/node.index.d.ts",
     "peerDependencies": {
-        "@promptbook/core": "0.100.0-36"
+        "@promptbook/core": "0.100.0-37"
     },
     "dependencies": {
         "colors": "1.4.0",

package/umd/index.umd.js

@@ -46,7 +46,7 @@
      * @generated
      * @see https://github.com/webgptorg/promptbook
      */
-    const PROMPTBOOK_ENGINE_VERSION = '0.100.0-36';
+    const PROMPTBOOK_ENGINE_VERSION = '0.100.0-37';
     /**
      * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
      * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -2104,7 +2104,7 @@
      * @private internal helper function
      */
     function createTask(options) {
-        const { taskType, taskProcessCallback } = options;
+        const { taskType, taskProcessCallback, tldrProvider } = options;
         let { title } = options;
         // TODO: [🐙] DRY
         const taskId = `${taskType.toLowerCase().substring(0, 4)}-${$randomToken(8 /* <- TODO: To global config + Use Base58 to avoid similar char conflicts   */)}`;
@@ -2179,7 +2179,11 @@
             },
             get tldr() {
                 var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
-                // Simulate progress based on elapsed time and subtasks
+                // Use custom tldr provider if available
+                if (tldrProvider) {
+                    return tldrProvider(createdAt, status, currentValue, errors, warnings);
+                }
+                // Fallback to default implementation
                 const cv = currentValue;
                 // If explicit percent is provided, use it
                 let percentRaw = (_f = (_d = (_b = (_a = cv === null || cv === void 0 ? void 0 : cv.tldr) === null || _a === void 0 ? void 0 : _a.percent) !== null && _b !== void 0 ? _b : (_c = cv === null || cv === void 0 ? void 0 : cv.usage) === null || _c === void 0 ? void 0 : _c.percent) !== null && _d !== void 0 ? _d : (_e = cv === null || cv === void 0 ? void 0 : cv.progress) === null || _e === void 0 ? void 0 : _e.percent) !== null && _f !== void 0 ? _f : cv === null || cv === void 0 ? void 0 : cv.percent;
@@ -5027,6 +5031,71 @@
                     updateOngoingResult(newOngoingResult);
                 });
             },
+            tldrProvider(createdAt, status, currentValue, errors) {
+                var _a;
+                // Better progress estimation based on pipeline structure
+                const cv = currentValue;
+                // Handle finished/error states
+                if (status === 'FINISHED') {
+                    return {
+                        percent: 1,
+                        message: 'Finished',
+                    };
+                }
+                if (status === 'ERROR') {
+                    const errorMessage = errors.length > 0 ? errors[errors.length - 1].message : 'Error';
+                    return {
+                        percent: 0,
+                        message: errorMessage,
+                    };
+                }
+                // Calculate progress based on pipeline tasks
+                const totalTasks = pipeline.tasks.length;
+                let completedTasks = 0;
+                let currentTaskName = '';
+                // Check execution report for completed tasks
+                if ((_a = cv === null || cv === void 0 ? void 0 : cv.executionReport) === null || _a === void 0 ? void 0 : _a.promptExecutions) {
+                    const executedTaskTitles = new Set(cv.executionReport.promptExecutions.map((execution) => execution.prompt.title));
+                    // Count completed tasks by matching titles
+                    const completedTasksByTitle = pipeline.tasks.filter(task => executedTaskTitles.has(task.title));
+                    completedTasks = completedTasksByTitle.length;
+                    // Find current task being executed (first task not yet completed)
+                    const remainingTasks = pipeline.tasks.filter(task => !executedTaskTitles.has(task.title));
+                    if (remainingTasks.length > 0) {
+                        currentTaskName = remainingTasks[0].name;
+                    }
+                }
+                // Calculate progress percentage
+                let percent = totalTasks > 0 ? completedTasks / totalTasks : 0;
+                // Add time-based progress for current task (assuming 5 minutes total)
+                if (completedTasks < totalTasks) {
+                    const elapsedMs = new Date().getTime() - createdAt.getTime();
+                    const totalMs = 5 * 60 * 1000; // 5 minutes
+                    const timeProgress = Math.min(elapsedMs / totalMs, 1);
+                    // Add partial progress for current task
+                    percent += (1 / totalTasks) * timeProgress;
+                }
+                // Clamp to [0,1]
+                percent = Math.min(Math.max(percent, 0), 1);
+                // Generate message
+                let message = '';
+                if (currentTaskName) {
+                    // Find the task to get its title
+                    const currentTask = pipeline.tasks.find(task => task.name === currentTaskName);
+                    const taskTitle = (currentTask === null || currentTask === void 0 ? void 0 : currentTask.title) || currentTaskName;
+                    message = `Working on task ${taskTitle}`;
+                }
+                else if (completedTasks === 0) {
+                    message = 'Starting pipeline execution';
+                }
+                else {
+                    message = `Processing pipeline (${completedTasks}/${totalTasks} tasks completed)`;
+                }
+                return {
+                    percent,
+                    message,
+                };
+            },
         });
         //        <- TODO: Make types such as there is no need to do `as` for `createTask`
         return pipelineExecutor;