donobu 2.30.0 → 2.31.0

package/dist/utils/JsonUtils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"JsonUtils.d.ts","sourceRoot":"","sources":["../../src/utils/JsonUtils.ts"],"names":[],"mappings":"AAMA,qBAAa,SAAS;IACpB,OAAO;WAEO,YAAY,CAAC,MAAM,EAAE,GAAG,GAAG,GAAG;WA2F9B,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;WAU3C,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,GAAG,GAAG,IAAI;IASpE;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,qBAAqB;IA4CpC;;;;OAIG;WACiB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAyB5E"}
+{"version":3,"file":"JsonUtils.d.ts","sourceRoot":"","sources":["../../src/utils/JsonUtils.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,qBAAa,SAAS;IACpB;;;OAGG;IACH,OAAO;IAEP;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;WACW,YAAY,CAAC,MAAM,EAAE,GAAG,GAAG,GAAG;IA2F5C;;;;;;;;;;;;;;;;;;;OAmBG;WACW,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,GAAG;IAUrD;;;;;;;;;;;;;;;;;OAiBG;WACW,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,GAAG,GAAG,IAAI;CAQrE"}

package/dist/utils/JsonUtils.js

@@ -1,15 +1,68 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.JsonUtils = void 0;
 const MiscUtils_1 = require("./MiscUtils");
-const path_1 = __importDefault(require("path"));
 const Logger_1 = require("./Logger");
-const promises_1 = __importDefault(require("fs/promises"));
+/**
+ * Utility class for JSON operations including serialization, parsing, and safe object conversion.
+ *
+ * Provides comprehensive JSON handling capabilities including:
+ * - Safe object-to-JSON conversion with circular reference detection
+ * - Resource file reading and parsing with error handling
+ * - JSON string parsing with graceful error recovery
+ *
+ * All methods handle errors gracefully and provide appropriate logging.
+ *
+ * @example
+ * ```typescript
+ * // Safe object serialization
+ * const obj = { name: 'test', date: new Date() };
+ * const safeJson = JsonUtils.objectToJson(obj);
+ *
+ * // Read JSON from resource file
+ * const config = JsonUtils.readResourceAsJson('config.json');
+ *
+ * // Parse JSON string safely
+ * const parsed = JsonUtils.jsonStringToJsonObject('{"key": "value"}');
+ * ```
+ *
+ * @since 1.0.0
+ */
 class JsonUtils {
+    /**
+     * Private constructor to prevent instantiation of this utility class.
+     * All methods are static and should be called directly on the class.
+     */
     constructor() { }
+    /**
+     * Converts an object to a JSON-serializable format with comprehensive type handling and circular reference protection.
+     *
+     * Handles special cases including:
+     * - Date objects (converted to ISO strings)
+     * - RegExp objects (converted to string representation)
+     * - Error objects (converted to structured object with name, message, stack)
+     * - Node.js-specific objects (Timeout, EventEmitter, etc. - converted to descriptive strings)
+     * - Circular references (replaced with '[Circular Reference]' string)
+     * - Functions and symbols (excluded from output)
+     *
+     * @param object - The object to convert to JSON-safe format
+     * @returns A JSON-serializable version of the input object, or the original value for primitives
+     *
+     * @example
+     * ```typescript
+     * const complexObj = {
+     *   date: new Date(),
+     *   error: new Error('test'),
+     *   regex: /test/g,
+     *   func: () => {},  // Will be excluded
+     *   circular: null as any
+     * };
+     * complexObj.circular = complexObj;  // Create circular reference
+     *
+     * const safe = JsonUtils.objectToJson(complexObj);
+     * // Result: { date: "2023-...", error: {...}, regex: "/test/g", circular: "[Circular Reference]" }
+     * ```
+     */
     static objectToJson(object) {
         // Handle undefined or null
         if (object === undefined || object === null) {
@@ -85,6 +138,26 @@ class JsonUtils {
         };
         return JSON.parse(JSON.stringify(object, replacer));
     }
+    /**
+     * Reads and parses a JSON file from the application's resource directory.
+     *
+     * Uses MiscUtils to read the file as a string and then parses it as JSON.
+     * Provides error handling and logging for file read and parse failures.
+     *
+     * @param source - The relative path to the JSON resource file
+     * @returns The parsed JSON object, or null if reading or parsing fails
+     *
+     * @example
+     * ```typescript
+     * // Read configuration from resources
+     * const config = JsonUtils.readResourceAsJson('config/app-settings.json');
+     * if (config) {
+     *   console.log('Config loaded:', config);
+     * } else {
+     *   console.log('Failed to load config');
+     * }
+     * ```
+     */
     static readResourceAsJson(source) {
         try {
             const jsonString = MiscUtils_1.MiscUtils.getResourceFileAsString(source);
@@ -95,6 +168,24 @@ class JsonUtils {
             return null;
         }
     }
+    /**
+     * Safely parses a JSON string into a JavaScript object.
+     *
+     * Provides error handling and logging for malformed JSON strings.
+     * Returns null instead of throwing an exception when parsing fails.
+     *
+     * @param jsonString - The JSON string to parse
+     * @returns The parsed JavaScript object, or null if parsing fails
+     *
+     * @example
+     * ```typescript
+     * const validJson = '{"name": "test", "value": 123}';
+     * const invalidJson = '{name: "test"}';  // Missing quotes
+     *
+     * const obj1 = JsonUtils.jsonStringToJsonObject(validJson);   // Returns object
+     * const obj2 = JsonUtils.jsonStringToJsonObject(invalidJson); // Returns null
+     * ```
+     */
     static jsonStringToJsonObject(jsonString) {
         try {
             return JSON.parse(jsonString);
@@ -104,78 +195,6 @@ class JsonUtils {
             return null;
         }
     }
-    /**
-     * Post-process the given schema to conform with OpenAI constraints
-     * @see https://platform.openai.com/docs/guides/structured-outputs/additionalproperties-false-must-always-be-set-in-objects
-     */
-    static postProcessJsonSchema(schema) {
-        if (schema.type === 'object') {
-            schema.additionalProperties = false;
-            if (schema.properties) {
-                const properties = schema.properties;
-                schema.required = schema.required || [];
-                Object.entries(properties).forEach(([fieldName, fieldSchema]) => {
-                    if (!schema.required?.includes(fieldName)) {
-                        schema.required?.push(fieldName);
-                        if (typeof fieldSchema.type === 'string') {
-                            fieldSchema.type = [fieldSchema.type, 'null'];
-                        }
-                        else if (Array.isArray(fieldSchema.type) &&
-                            !fieldSchema.type.includes('null')) {
-                            fieldSchema.type.push('null');
-                        }
-                    }
-                });
-            }
-        }
-        // Recursively process nested schemas
-        if (schema.properties) {
-            Object.values(schema.properties).forEach((prop) => {
-                if (typeof prop === 'object') {
-                    this.postProcessJsonSchema(prop);
-                }
-            });
-        }
-        if (schema.items) {
-            const items = Array.isArray(schema.items) ? schema.items : [schema.items];
-            items.forEach((item) => {
-                if (typeof item === 'object') {
-                    this.postProcessJsonSchema(item);
-                }
-            });
-        }
-    }
-    /**
-     * Ensures the given file path exists. If the file does not initially exist,
-     * all directories to it will be created and the file will be created with a
-     * value of an empty JSON object (AKA {}).
-     */
-    static async maybeInitEmptyJsonFile(filePath) {
-        // Ensure the directory exists
-        const directory = path_1.default.dirname(filePath);
-        await promises_1.default
-            .mkdir(directory, { recursive: true })
-            .catch((dirError) => {
-            // Directory already exists, continue...
-            if (dirError.code !== 'EEXIST') {
-                throw dirError;
-            }
-        });
-        // Try to access the file to check if it exists
-        try {
-            await promises_1.default.access(filePath);
-        }
-        catch (error) {
-            const fsError = error;
-            // File doesn't exist, create it.
-            if (fsError.code === 'ENOENT') {
-                await promises_1.default.writeFile(filePath, '{}', 'utf8');
-            }
-            else {
-                throw error;
-            }
-        }
-    }
 }
 exports.JsonUtils = JsonUtils;
 //# sourceMappingURL=JsonUtils.js.map

package/dist/utils/JsonUtils.js.map

@@ -1 +1 @@
-{"version":3,"file":"JsonUtils.js","sourceRoot":"","sources":["../../src/utils/JsonUtils.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"JsonUtils.js","sourceRoot":"","sources":["../../src/utils/JsonUtils.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "donobu",
-  "version": "2.30.0",
+  "version": "2.31.0",
   "description": "Create browser automations with an LLM agent and replay them as Playwright scripts.",
   "main": "dist/main.js",
   "module": "dist/esm/main.js",
@@ -11,9 +11,9 @@
     "types": "./dist/main.d.ts"
   },
   "bin": {
-    "playwright-json-to-markdown": "./dist/assets/playwright-json-to-markdown.js",
-    "playwright-json-to-slack-json": "./dist/assets/playwright-json-to-slack-json.js",
-    "install-donobu-plugin": "./dist/assets/install-donobu-plugin.js"
+    "playwright-json-to-markdown": "./dist/cli/playwright-json-to-markdown.js",
+    "playwright-json-to-slack-json": "./dist/cli/playwright-json-to-slack-json.js",
+    "install-donobu-plugin": "./dist/cli/install-donobu-plugin.js"
   },
   "scripts": {
     "clean": "rm -rf dist && rm -rf donobu-tool-plugins-for-docker",
@@ -41,6 +41,7 @@
   "license": "UNLICENSED",
   "devDependencies": {
     "@eslint/js": "^9.17.0",
+    "@playwright/test": "1.53.2",
     "@types/better-sqlite3": "^7.6.12",
     "@types/express": "^5.0.0",
     "@types/glob": "^8.1.0",
@@ -60,20 +61,20 @@
     "jest": "^29.7.0",
     "js-yaml": "^4.1.0",
     "open": "^10.1.0",
+    "playwright": "1.53.2",
     "slugify": "^1.6.6",
     "ts-jest": "^29.3.0",
     "ts-node": "^10.9.2",
-    "typescript-eslint": "^8.28.0",
-    "playwright": "1.53.2",
-    "@playwright/test": "1.53.2"
+    "typescript-eslint": "^8.28.0"
   },
   "dependencies": {
     "@ai-sdk/amazon-bedrock": "^2.2.8",
-    "@ai-sdk/google": "^1.2.14",
+    "@ai-sdk/google": "^1.2.22",
+    "@ai-sdk/google-vertex": "^2.2.27",
     "@aws-sdk/client-s3": "^3.750.0",
     "@google-cloud/storage": "^7.15.2",
     "@types/json-schema": "^7.0.15",
-    "ai": "^4.1.63",
+    "ai": "^4.3.19",
     "better-sqlite3": "^11.8.1",
     "commander": "^13.0.0",
     "express": "^4.21.2",
@@ -89,8 +90,8 @@
     "zod-to-json-schema": "^3.24.5"
   },
   "peerDependencies": {
-    "playwright": ">=1.40.0",
-    "@playwright/test": ">=1.40.0"
+    "@playwright/test": ">=1.40.0",
+    "playwright": ">=1.40.0"
   },
   "peerDependenciesMeta": {
     "playwright": {

package/dist/assets/install-donobu-plugin.js

@@ -1,96 +0,0 @@
-#!/usr/bin/env node
-
-const { exec } = require('child_process');
-const { promisify } = require('util');
-const { access, mkdir, rm, cp, readFile } = require('fs/promises');
-const { basename, join } = require('path');
-const { constants } = require('fs');
-
-const execAsync = promisify(exec);
-
-async function getPluginName() {
-  try {
-    // First, try to read the plugin name from package.json
-    const packageJsonContent = await readFile('package.json', 'utf8');
-    const packageJson = JSON.parse(packageJsonContent);
-
-    if (packageJson.name) {
-      console.log(`Using plugin name from package.json: ${packageJson.name}`);
-      return packageJson.name;
-    }
-  } catch (error) {
-    console.warn(
-      'Could not read package.json name, falling back to git/user detection',
-    );
-  }
-
-  // Fallback to a heuristic
-  try {
-    const { stdout } = await execAsync('git rev-parse --show-toplevel');
-    const repoPath = stdout.trim();
-    const gitBasedName = `${basename(repoPath).replace(/\.git$/, '')}-custom-tools`;
-    console.log(`Using git-based plugin name: ${gitBasedName}`);
-    return gitBasedName;
-  } catch {
-    const user = process.env.USER || 'unknown-user';
-    const userBasedName = `${user}-custom-tools`;
-    console.log(`Using user-based plugin name: ${userBasedName}`);
-    return userBasedName;
-  }
-}
-
-async function buildPlugin() {
-  console.log('Building plugin...');
-  await execAsync('npm run build');
-}
-
-async function installPlugin() {
-  const pluginName = await getPluginName();
-  const pluginsDir = join(
-    process.env.HOME,
-    'Library/Application Support/Donobu Studio/plugins',
-  );
-  const thisPluginDir = join(pluginsDir, pluginName);
-
-  console.log(`Installing plugin: ${pluginName}`);
-
-  // Create plugins directory
-  await mkdir(pluginsDir, { recursive: true });
-
-  // Remove old plugin if exists
-  try {
-    await rm(thisPluginDir, { recursive: true, force: true });
-  } catch (err) {
-    // Ignore if directory doesn't exist
-  }
-
-  // Copy built plugin
-  await cp('dist', thisPluginDir, { recursive: true });
-
-  console.log(`Plugin installed successfully to: ${thisPluginDir}`);
-  console.log('Restart Donobu to see the new tools.');
-}
-
-async function main() {
-  try {
-    // Check if we're in a plugin directory
-    try {
-      await access('package.json', constants.F_OK);
-      await access('src', constants.F_OK);
-    } catch {
-      console.error(
-        'Error: This command must be run from a Donobu plugin directory',
-      );
-      console.error('Make sure you have package.json and src/ directory');
-      process.exit(1);
-    }
-
-    await buildPlugin();
-    await installPlugin();
-  } catch (error) {
-    console.error('Installation failed:', error.message);
-    process.exit(1);
-  }
-}
-
-main();

package/dist/assets/playwright-json-to-markdown.js

@@ -1,257 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * Convert Playwright JSON test results to a Markdown report.
- *
- * Usage: node playwright-json-to-markdown.js input.json > report.md
- */
-
-const fs = require('fs');
-
-function stripAnsiCodes(str) {
-  return str.replace(
-    /[\u001b\u009b][[()#;?]*(?:[0-9]{1,4}(?:;[0-9]{0,4})*)?[0-9A-ORZcf-nqry=><]/g,
-    '',
-  );
-}
-
-// Function to format duration in a readable way
-function formatDuration(ms) {
-  if (ms < 1000) {
-    return `${ms}ms`;
-  }
-  const seconds = Math.floor(ms / 1000);
-  if (seconds < 60) {
-    return `${seconds}s`;
-  }
-  const minutes = Math.floor(seconds / 60);
-  const remainingSeconds = seconds % 60;
-  return `${minutes}m ${remainingSeconds}s`;
-}
-
-// Read the JSON data from file or stdin
-function readInput() {
-  const args = process.argv.slice(2);
-  if (args.length > 0) {
-    return JSON.parse(fs.readFileSync(args[0], 'utf8'));
-  } else {
-    return JSON.parse(fs.readFileSync(0, 'utf8')); // Read from stdin
-  }
-}
-
-// Process JSON and create markdown
-function generateMarkdown(jsonData) {
-  const { suites } = jsonData;
-
-  // Count self-healed tests
-  let selfHealedCount = 0;
-  suites.forEach((suite) => {
-    suite.specs.forEach((spec) => {
-      spec.tests.forEach((test) => {
-        if (
-          test.annotations &&
-          test.annotations.some((a) => a.type === 'self-healed')
-        ) {
-          selfHealedCount++;
-        }
-      });
-    });
-  });
-
-  // Create report header
-  let markdown = `# Playwright Test Report\n\n`;
-  // Tests by file
-  markdown += `## Summary\n\n`;
-
-  // Create file summary table with status counts
-  markdown += `| File | Passed | Self-Healed | Failed | Timed Out | Skipped | Interrupted | Duration |\n`;
-  markdown += `| - | - | - | - | - | - | - | - |\n`;
-
-  // Track totals for summary row
-  let totalPassed = 0;
-  let totalFailed = 0;
-  let totalTimedOut = 0;
-  let totalSkipped = 0;
-  let totalInterrupted = 0;
-  let totalSelfHealed = 0;
-  let totalDuration = 0;
-
-  suites.forEach((suite) => {
-    // Count tests by status for this file
-    let passed = 0;
-    let failed = 0;
-    let timedOut = 0;
-    let skipped = 0;
-    let interrupted = 0;
-    let selfHealed = 0;
-
-    const fileDuration = suite.specs.reduce(
-      (total, spec) =>
-        total +
-        spec.tests.reduce((testTotal, test) => {
-          const result = test.results && test.results.at(-1);
-          const isSelfHealed =
-            test.annotations &&
-            test.annotations.some((a) => a.type === 'self-healed');
-
-          if (
-            test.status === 'skipped' ||
-            (!result && test.status === undefined)
-          ) {
-            skipped++;
-          } else if (result) {
-            if (isSelfHealed) {
-              selfHealed++;
-            } else {
-              switch (result.status) {
-                case 'passed':
-                  passed++;
-                  break;
-                case 'failed':
-                  failed++;
-                  break;
-                case 'timedOut':
-                  timedOut++;
-                  break;
-                case 'skipped':
-                  skipped++;
-                  break;
-                case 'interrupted':
-                  interrupted++;
-                  break;
-              }
-            }
-          }
-
-          return testTotal + (result?.duration || 0);
-        }, 0),
-      0,
-    );
-
-    // Add to totals
-    totalPassed += passed;
-    totalFailed += failed;
-    totalTimedOut += timedOut;
-    totalSkipped += skipped;
-    totalInterrupted += interrupted;
-    totalSelfHealed += selfHealed;
-    totalDuration += fileDuration;
-
-    markdown += `| ${suite.file} | ${passed ? passed + ' ✅' : ''} | ${selfHealed ? selfHealed + ' ❤️‍🩹' : ''} | ${failed ? failed + ' ❌' : ''} | ${timedOut ? timedOut + ' ⏰' : ''} | ${skipped ? skipped + ' ⏭️' : ''} | ${interrupted ? interrupted + ' ⚡' : ''} | ${formatDuration(fileDuration)} |\n`;
-  });
-
-  // Add totals row
-  markdown += `| **TOTAL** | **${totalPassed + ' ✅'}** | **${totalSelfHealed + ' ❤️‍🩹'}** | **${totalFailed + ' ❌'}** | **${totalTimedOut + ' ⏰'}** | **${totalSkipped + ' ⏭️'}** | **${totalInterrupted + ' ⚡'}** | **${formatDuration(totalDuration)}** |\n`;
-
-  markdown += `\n`;
-
-  // Generate test details sections
-  suites.forEach((suite) => {
-    const fileName = suite.file;
-    markdown += `## ${fileName}\n\n`;
-
-    suite.specs.forEach((spec) => {
-      markdown += `### ${spec.title}\n\n`;
-
-      spec.tests.forEach((test) => {
-        const result = test.results && test.results.at(-1);
-
-        if (test.status === 'skipped' || !result || test.status === undefined) {
-          markdown += `**Status**: ⏭️ Skipped  \n`;
-          markdown += `**Duration**: N/A  \n`;
-          // Get objective from annotations if available
-          let objective = 'No objective provided';
-
-          if (test.annotations) {
-            const objectiveAnnotation = test.annotations.find(
-              (a) => a.type === 'objective',
-            );
-            if (objectiveAnnotation) {
-              objective =
-                objectiveAnnotation.description || 'No objective provided';
-            }
-          }
-
-          // Escape any existing triple backticks in the objective
-          objective = objective.replace(/```/g, '\\`\\`\\`');
-          markdown += `**Objective**:\n\`\`\`\n${objective}\n\`\`\`\n`;
-          markdown += `---\n\n`;
-          return;
-        }
-
-        const isSelfHealed =
-          test.annotations &&
-          test.annotations.some((a) => a.type === 'self-healed');
-
-        // Determine status based on result status and self-healing annotation
-        let status;
-        if (result.status === 'passed') {
-          status = '✅ Passed';
-        } else if (isSelfHealed) {
-          status = '❌ Failed (❤️‍🩹 Self-Healed)';
-        } else if (result.status === 'failed') {
-          status = '❌ Failed';
-        } else if (result.status === 'timedOut') {
-          status = '⏰ Timed Out';
-        } else if (result.status === 'skipped') {
-          status = '⏭️ Skipped';
-        } else if (result.status === 'interrupted') {
-          status = '⚡ Interrupted';
-        } else {
-          status = `⚠️ ${result.status || 'Unknown'}`;
-        }
-
-        const duration = formatDuration(result.duration || 0);
-
-        // Get objective from annotations if available
-        let objective = 'No objective provided';
-        if (test.annotations) {
-          const objectiveAnnotation = test.annotations.find(
-            (a) => a.type === 'objective',
-          );
-          if (objectiveAnnotation) {
-            objective =
-              objectiveAnnotation.description || 'No objective provided';
-          }
-        }
-
-        // Escape any existing triple backticks in the objective by replacing ``` with \`\`\`
-        objective = objective.replace(/```/g, '\\`\\`\\`');
-
-        markdown += `**Status**: ${status}  \n`;
-        markdown += `**Duration**: ${duration}  \n`;
-        markdown += `**Objective**:\n\`\`\`\n${objective}\n\`\`\`\n`;
-
-        // Add error details if test failed
-        if (result.status === 'failed' && result.error) {
-          markdown += `\n<details>\n<summary>⚠️ Error Details</summary>\n\n`;
-          markdown += `\`\`\`\n${result.error.message || 'No error message available'}\n\`\`\`\n\n`;
-
-          // Include code snippet if available
-          if (result.error.snippet) {
-            markdown += `**Code Snippet**:\n\`\`\`\n${stripAnsiCodes(result.error.snippet)}\n\`\`\`\n\n`;
-          }
-
-          markdown += `</details>\n\n`;
-        }
-
-        markdown += `---\n\n`;
-      });
-    });
-  });
-
-  // Add timestamp footer
-  markdown += `_Report generated on ${new Date().toLocaleString()} by Donobu_\n`;
-
-  return markdown;
-}
-
-// Main execution
-try {
-  const jsonData = readInput();
-  const markdown = generateMarkdown(jsonData);
-  console.log(markdown);
-} catch (error) {
-  console.error('Error processing JSON:', error.message);
-  process.exit(1);
-}