donobu 2.20.0 → 2.21.0

package/dist/utils/ToolsPluginsLoader.js

@@ -0,0 +1,301 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ToolsPluginsLoader = void 0;
+const fs = __importStar(require("fs/promises"));
+const path = __importStar(require("path"));
+const Logger_1 = require("./Logger");
+const MiscUtils_1 = require("./MiscUtils");
+/**
+ * Loads and manages tools plugins from the filesystem.
+ *
+ * Plugins are loaded from the 'plugins' directory within the base working directory.
+ * Each plugin should be a directory containing a package.json with a "main" field
+ * pointing to the plugin entry point that exports a class implementing DonobuToolPlugin.
+ */
+class ToolsPluginsLoader {
+    constructor() {
+        this.loadedPlugins = new Map();
+        this.loadedTools = new Map();
+        this.pluginsPath = path.join(MiscUtils_1.MiscUtils.baseWorkingDirectory(), ToolsPluginsLoader.PLUGINS_DIRECTORY);
+    }
+    /**
+     * Loads all available plugins and returns the tools they provide.
+     *
+     * @returns Promise<Tool[]> Array of all tools from all successfully loaded plugins
+     */
+    async loadAllTools() {
+        Logger_1.appLogger.info(`Loading plugins from: ${this.pluginsPath}`);
+        try {
+            await this.ensurePluginsDirectoryExists();
+            const pluginDirectories = await this.discoverPluginDirectories();
+            Logger_1.appLogger.info(`Found ${pluginDirectories.length} potential plugin directories`);
+            // Load each plugin directory
+            for (const pluginDir of pluginDirectories) {
+                try {
+                    await this.loadPlugin(pluginDir);
+                }
+                catch (error) {
+                    Logger_1.appLogger.error(`Failed to load plugin from ${pluginDir}:`, error);
+                    // Continue loading other plugins even if one fails
+                }
+            }
+            // Collect tools from all successfully loaded plugins
+            const allTools = [];
+            for (const [pluginName, plugin] of this.loadedPlugins) {
+                try {
+                    const tools = await plugin.loadTools();
+                    for (const tool of tools) {
+                        // Validate that the tool has required properties
+                        if (!tool.name ||
+                            typeof tool.call !== 'function' ||
+                            typeof tool.callFromGpt !== 'function') {
+                            Logger_1.appLogger.warn(`Invalid tool from plugin ${pluginName}: missing required properties`);
+                            continue;
+                        }
+                        // Check for tool name conflicts
+                        if (this.loadedTools.has(tool.name)) {
+                            Logger_1.appLogger.warn(`Tool name conflict: '${tool.name}' is already loaded. Skipping duplicate from plugin ${pluginName}`);
+                            continue;
+                        }
+                        this.loadedTools.set(tool.name, tool);
+                        allTools.push(tool);
+                        Logger_1.appLogger.info(`Loaded tool '${tool.name}' from plugin ${pluginName}`);
+                    }
+                }
+                catch (error) {
+                    Logger_1.appLogger.error(`Failed to load tools from plugin ${pluginName}:`, error);
+                }
+            }
+            Logger_1.appLogger.info(`Successfully loaded ${allTools.length} tools from ${this.loadedPlugins.size} plugins`);
+            return allTools;
+        }
+        catch (error) {
+            Logger_1.appLogger.error('Failed to load plugins:', error);
+            return [];
+        }
+    }
+    /**
+     * Reloads all plugins. Useful for development or when plugins are updated.
+     */
+    async reloadAllPlugins() {
+        Logger_1.appLogger.info('Reloading all plugins...');
+        // Clear existing loaded plugins and tools
+        this.loadedPlugins.clear();
+        this.loadedTools.clear();
+        // Clear the Node.js module cache for plugin directories
+        await this.clearPluginModuleCache();
+        return this.loadAllTools();
+    }
+    /**
+     * Gets information about currently loaded plugins.
+     */
+    getLoadedPluginsInfo() {
+        const info = [];
+        for (const [pluginName, _plugin] of this.loadedPlugins) {
+            const toolNames = Array.from(this.loadedTools.entries())
+                .filter(([_, tool]) => tool.name) // This is a bit of a hack since we don't track which plugin provided which tool
+                .map(([name, _]) => name);
+            info.push({
+                name: pluginName,
+                toolCount: toolNames.length,
+                toolNames: toolNames,
+            });
+        }
+        return info;
+    }
+    /**
+     * Ensures the plugins directory exists.
+     */
+    async ensurePluginsDirectoryExists() {
+        try {
+            await fs.access(this.pluginsPath);
+        }
+        catch (_error) {
+            // Directory doesn't exist, create it
+            Logger_1.appLogger.info(`Creating plugins directory: ${this.pluginsPath}`);
+            await fs.mkdir(this.pluginsPath, { recursive: true });
+            // Create a simple README file to explain the directory
+            const readmePath = path.join(this.pluginsPath, 'README.md');
+            const readmeContent = `# Donobu Tool Plugins
+
+This directory contains custom tool plugins for Donobu.
+
+## Creating a Plugin
+
+Create a directory with a package.json file that has a "main" field pointing to your plugin entry point:
+
+\`\`\`json
+{
+  "name": "my-plugin",
+  "main": "dist/src/Plugin.js"
+}
+\`\`\`
+
+The main file should export a class implementing the DonobuToolPlugin interface as the default export:
+
+\`\`\`typescript
+import { DonobuToolPlugin } from 'donobu/models/DonobuToolPlugin';
+import { Tool } from 'donobu/tools/Tool';
+
+export default class MyPlugin implements DonobuToolPlugin {
+  async loadTools(): Promise<Tool<any, any>[]> {
+    return [
+      // Your custom tools here
+    ];
+  }
+}
+\`\`\`
+
+## Directory Structure
+
+\`\`\`
+plugins/
+└── my-plugin/
+    ├── package.json
+    └── dist/
+        └── src/
+            └── Plugin.js
+\`\`\`
+
+## Error Handling
+
+If a plugin fails to load, Donobu will log the error and continue loading other plugins.
+`;
+            try {
+                await fs.writeFile(readmePath, readmeContent, 'utf8');
+            }
+            catch (writeError) {
+                // Don't fail if we can't write the README
+                Logger_1.appLogger.warn('Could not create plugins README file:', writeError);
+            }
+        }
+    }
+    /**
+     * Discovers plugin directories in the plugins directory.
+     * Only returns directories that contain a package.json file.
+     */
+    async discoverPluginDirectories() {
+        try {
+            const entries = await fs.readdir(this.pluginsPath, {
+                withFileTypes: true,
+            });
+            const pluginDirectories = [];
+            for (const entry of entries) {
+                if (entry.isDirectory() && !entry.name.startsWith('.')) {
+                    const pluginDir = path.join(this.pluginsPath, entry.name);
+                    const packageJsonPath = path.join(pluginDir, 'package.json');
+                    try {
+                        await fs.access(packageJsonPath);
+                        pluginDirectories.push(pluginDir);
+                    }
+                    catch {
+                        // No package.json, skip this directory
+                        Logger_1.appLogger.debug(`Skipping directory ${entry.name} - no package.json found`);
+                    }
+                }
+            }
+            return pluginDirectories;
+        }
+        catch (error) {
+            Logger_1.appLogger.error('Failed to read plugins directory:', error);
+            return [];
+        }
+    }
+    /**
+     * Loads a single plugin directory.
+     */
+    async loadPlugin(pluginDir) {
+        const pluginName = path.basename(pluginDir);
+        Logger_1.appLogger.debug(`Loading plugin: ${pluginName} from ${pluginDir}`);
+        try {
+            // Clear any existing cache for this module
+            try {
+                const resolvedPath = require.resolve(pluginDir);
+                delete require.cache[resolvedPath];
+            }
+            catch {
+                // Module not cached, continue
+            }
+            // Use require() which will automatically use package.json main field
+            let PluginClass = require(pluginDir);
+            // Handle both default export and direct export
+            if (PluginClass.default) {
+                PluginClass = PluginClass.default;
+            }
+            // Validate that we got a constructor function or class
+            if (typeof PluginClass !== 'function') {
+                throw new Error(`Plugin ${pluginName} does not export a constructor function or class`);
+            }
+            // Create an instance of the plugin
+            const pluginInstance = new PluginClass();
+            // Validate that the instance implements the DonobuToolPlugin interface
+            if (typeof pluginInstance.loadTools !== 'function') {
+                throw new Error(`Plugin ${pluginName} does not implement the DonobuToolPlugin interface (missing loadTools method)`);
+            }
+            // Store the successfully loaded plugin
+            this.loadedPlugins.set(pluginName, pluginInstance);
+            Logger_1.appLogger.info(`Successfully loaded plugin: ${pluginName}`);
+        }
+        catch (error) {
+            Logger_1.appLogger.error(`Failed to load plugin ${pluginName}:`, error);
+            throw error;
+        }
+    }
+    /**
+     * Clears the Node.js module cache for plugin directories to enable reloading.
+     */
+    async clearPluginModuleCache() {
+        try {
+            const pluginDirectories = await this.discoverPluginDirectories();
+            for (const pluginDir of pluginDirectories) {
+                try {
+                    const resolvedPath = require.resolve(pluginDir);
+                    delete require.cache[resolvedPath];
+                }
+                catch (error) {
+                    // It's okay if the module wasn't cached
+                    Logger_1.appLogger.debug(`Could not clear cache for ${pluginDir}:`, error);
+                }
+            }
+        }
+        catch (error) {
+            Logger_1.appLogger.warn('Failed to clear plugin module cache:', error);
+        }
+    }
+}
+exports.ToolsPluginsLoader = ToolsPluginsLoader;
+ToolsPluginsLoader.PLUGINS_DIRECTORY = 'plugins';
+//# sourceMappingURL=ToolsPluginsLoader.js.map

package/dist/utils/ToolsPluginsLoader.js.map

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

package/dist/utils/jsonSchemaUtils.d.ts

@@ -0,0 +1,4 @@
+import { z } from 'zod';
+import { JSONSchema7 } from 'json-schema';
+export declare function jsonSchemaToZod(schema: JSONSchema7): z.ZodTypeAny;
+//# sourceMappingURL=JsonSchemaUtils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"JsonSchemaUtils.d.ts","sourceRoot":"","sources":["../../src/utils/JsonSchemaUtils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,wBAAgB,eAAe,CAAC,MAAM,EAAE,WAAW,GAAG,CAAC,CAAC,UAAU,CAkDjE"}

package/dist/utils/jsonSchemaUtils.js

@@ -0,0 +1,179 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.jsonSchemaToZod = jsonSchemaToZod;
+const zod_1 = require("zod");
+function jsonSchemaToZod(schema) {
+    // Handle anyOf
+    if (schema.anyOf) {
+        const unions = schema.anyOf
+            .filter((subSchema) => typeof subSchema === 'object')
+            .map((subSchema) => jsonSchemaToZod(subSchema));
+        if (unions.length === 0) {
+            throw new Error('anyOf must contain at least one valid schema object');
+        }
+        return zod_1.z.union(unions);
+    }
+    // Handle enum
+    if (schema.enum) {
+        if (schema.enum.length === 0) {
+            throw new Error('Enum must have at least one value');
+        }
+        return zod_1.z.enum(schema.enum);
+    }
+    // Handle type
+    const type = Array.isArray(schema.type) ? schema.type[0] : schema.type;
+    switch (type) {
+        case 'string':
+            return buildStringSchema(schema);
+        case 'number':
+            return buildNumberSchema(schema);
+        case 'integer':
+            return buildIntegerSchema(schema);
+        case 'boolean':
+            return zod_1.z.boolean();
+        case 'object':
+            return buildObjectSchema(schema);
+        case 'array':
+            return buildArraySchema(schema);
+        default:
+            // If no type is specified, default to unknown
+            return zod_1.z.unknown();
+    }
+}
+function buildStringSchema(schema) {
+    let zodSchema = zod_1.z.string();
+    // Apply format constraints
+    if (schema.format) {
+        switch (schema.format) {
+            case 'date-time':
+                zodSchema = zodSchema.datetime();
+                break;
+            case 'date':
+                zodSchema = zodSchema.date();
+                break;
+            case 'time':
+                zodSchema = zodSchema.time();
+                break;
+            case 'email':
+                zodSchema = zodSchema.email();
+                break;
+            case 'uuid':
+                zodSchema = zodSchema.uuid();
+                break;
+            case 'ipv4':
+                zodSchema = zodSchema.ip({ version: 'v4' });
+                break;
+            case 'ipv6':
+                zodSchema = zodSchema.ip({ version: 'v6' });
+                break;
+            case 'hostname':
+                // Zod doesn't have a built-in hostname validator, so we use a regex
+                zodSchema = zodSchema.regex(/^(?!-)[A-Za-z0-9-]{1,63}(?<!-)(?:\.(?!-)[A-Za-z0-9-]{1,63}(?<!-))*$/, 'Invalid hostname');
+                break;
+            case 'duration':
+                // ISO 8601 duration format
+                zodSchema = zodSchema.regex(/^P(?!$)(\d+Y)?(\d+M)?(\d+W)?(\d+D)?(T(?=\d)(\d+H)?(\d+M)?(\d+(\.\d+)?S)?)?$/, 'Invalid duration format');
+                break;
+        }
+    }
+    // Apply pattern constraint
+    if (schema.pattern) {
+        zodSchema = zodSchema.regex(new RegExp(schema.pattern));
+    }
+    return zodSchema;
+}
+function buildNumberSchema(schema) {
+    let zodSchema = zod_1.z.number();
+    // Apply numeric constraints
+    if (schema.minimum !== undefined) {
+        zodSchema = zodSchema.min(schema.minimum);
+    }
+    if (schema.maximum !== undefined) {
+        zodSchema = zodSchema.max(schema.maximum);
+    }
+    if (schema.exclusiveMinimum !== undefined) {
+        zodSchema = zodSchema.gt(schema.exclusiveMinimum);
+    }
+    if (schema.exclusiveMaximum !== undefined) {
+        zodSchema = zodSchema.lt(schema.exclusiveMaximum);
+    }
+    if (schema.multipleOf !== undefined) {
+        zodSchema = zodSchema.multipleOf(schema.multipleOf);
+    }
+    return zodSchema;
+}
+function buildIntegerSchema(schema) {
+    let zodSchema = zod_1.z.number().int();
+    // Apply numeric constraints (same as number)
+    if (schema.minimum !== undefined) {
+        zodSchema = zodSchema.min(schema.minimum);
+    }
+    if (schema.maximum !== undefined) {
+        zodSchema = zodSchema.max(schema.maximum);
+    }
+    if (schema.exclusiveMinimum !== undefined) {
+        zodSchema = zodSchema.gt(schema.exclusiveMinimum);
+    }
+    if (schema.exclusiveMaximum !== undefined) {
+        zodSchema = zodSchema.lt(schema.exclusiveMaximum);
+    }
+    if (schema.multipleOf !== undefined) {
+        zodSchema = zodSchema.multipleOf(schema.multipleOf);
+    }
+    return zodSchema;
+}
+function buildObjectSchema(schema) {
+    // If no properties are defined, treat as a record/unknown object
+    if (!schema.properties || Object.keys(schema.properties).length === 0) {
+        return zod_1.z.record(zod_1.z.unknown());
+    }
+    const shape = {};
+    for (const [key, propSchema] of Object.entries(schema.properties)) {
+        // Handle JSONSchema7Definition - skip if boolean
+        if (typeof propSchema === 'boolean') {
+            continue;
+        }
+        let zodProp = jsonSchemaToZod(propSchema);
+        // Make property optional if it's not in the required array
+        if (!schema.required?.includes(key)) {
+            zodProp = zodProp.optional();
+        }
+        shape[key] = zodProp;
+    }
+    return zod_1.z.object(shape);
+}
+function buildArraySchema(schema) {
+    let itemSchema = zod_1.z.unknown();
+    if (schema.items) {
+        if (typeof schema.items === 'boolean') {
+            // Boolean schema: true allows anything, false allows nothing
+            itemSchema = schema.items ? zod_1.z.unknown() : zod_1.z.never();
+        }
+        else if (Array.isArray(schema.items)) {
+            // Tuple validation - for simplicity, we'll use a union of all item schemas
+            const itemSchemas = schema.items
+                .filter((item) => typeof item === 'object')
+                .map((item) => jsonSchemaToZod(item));
+            if (itemSchemas.length > 0) {
+                itemSchema =
+                    itemSchemas.length === 1
+                        ? itemSchemas[0]
+                        : zod_1.z.union(itemSchemas);
+            }
+        }
+        else {
+            // Single schema object
+            itemSchema = jsonSchemaToZod(schema.items);
+        }
+    }
+    let zodSchema = zod_1.z.array(itemSchema);
+    // Apply array constraints
+    if (schema.minItems !== undefined) {
+        zodSchema = zodSchema.min(schema.minItems);
+    }
+    if (schema.maxItems !== undefined) {
+        zodSchema = zodSchema.max(schema.maxItems);
+    }
+    return zodSchema;
+}
+//# sourceMappingURL=JsonSchemaUtils.js.map

package/dist/utils/jsonSchemaUtils.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "donobu",
-  "version": "2.20.0",
+  "version": "2.21.0",
   "description": "Create browser automations with an LLM agent and replay them as Playwright scripts.",
   "main": "dist/main.js",
   "module": "dist/esm/main.js",
@@ -17,7 +17,7 @@
     "copy-assets": "copyfiles \"assets/**/*\" dist/ && copyfiles \"assets/**/*\" dist/esm/",
     "generate-schemas": "ts-node scripts/generate-schemas.ts",
     "generate-version": "ts-node scripts/generate-version.ts",
-    "build": "npm install && npm run generate-schemas && npm run generate-version && npm run format && tsc && tsc -p tsconfig.esm.json && npm run lint && npm run copy-assets",
+    "build": "npm install && npm run generate-version && npm run format && tsc && tsc -p tsconfig.esm.json && npm run lint && npm run copy-assets",
     "start": "node dist/main.js",
     "dev": "ts-node src/main.ts",
     "lint": "eslint .",
@@ -67,7 +67,7 @@
     "@ai-sdk/google": "^1.2.14",
     "@aws-sdk/client-s3": "^3.750.0",
     "@google-cloud/storage": "^7.15.2",
-    "@playwright/test": "1.51.0",
+    "@playwright/test": "1.53.1",
     "@types/json-schema": "^7.0.15",
     "ai": "^4.1.63",
     "better-sqlite3": "^11.8.1",
@@ -77,12 +77,13 @@
     "jimp": "^1.6.0",
     "jose": "^5.9.6",
     "jsonpath": "^1.1.1",
-    "playwright": "1.51.0",
+    "playwright": "1.53.1",
     "prettier": "^3.5.3",
     "typescript": "^5.8.3",
     "typescript-json-schema": "^0.65.1",
     "winston": "^3.17.0",
-    "winston-daily-rotate-file": "^5.0.0"
+    "winston-daily-rotate-file": "^5.0.0",
+    "zod-to-json-schema": "^3.24.5"
   },
   "files": [
     "dist"