testdriverai 6.2.2 → 7.1.0

package/agent/lib/cache.js

@@ -0,0 +1,142 @@
+const fs = require("fs");
+const path = require("path");
+const crypto = require("crypto");
+
+/**
+ * Generate a cache key from a prompt
+ * Uses a hash to create a safe filename
+ */
+function getCacheKey(prompt) {
+  // Normalize the prompt by trimming and converting to lowercase
+  const normalized = prompt.trim().toLowerCase();
+
+  // Create a hash for the filename
+  const hash = crypto.createHash("md5").update(normalized).digest("hex");
+
+  // Also create a sanitized version of the prompt for readability
+  const sanitized = normalized
+    .replace(/[^a-z0-9\s]/g, "") // Remove special chars
+    .replace(/\s+/g, "-") // Replace spaces with hyphens
+    .substring(0, 50); // Limit length
+
+  // Combine sanitized prompt with hash for uniqueness
+  return `${sanitized}-${hash}.yaml`;
+}
+
+/**
+ * Get the cache directory path
+ * Creates it if it doesn't exist
+ */
+function getCacheDir() {
+  const cacheDir = path.join(process.cwd(), ".testdriver", ".cache");
+
+  if (!fs.existsSync(cacheDir)) {
+    fs.mkdirSync(cacheDir, { recursive: true });
+  }
+
+  return cacheDir;
+}
+
+/**
+ * Get the full path to a cache file
+ */
+function getCachePath(prompt) {
+  const cacheDir = getCacheDir();
+  const key = getCacheKey(prompt);
+  return path.join(cacheDir, key);
+}
+
+/**
+ * Check if a cached response exists for a prompt
+ */
+function hasCache(prompt) {
+  const cachePath = getCachePath(prompt);
+  return fs.existsSync(cachePath);
+}
+
+/**
+ * Read cached YAML for a prompt
+ * Returns null if no cache exists
+ */
+function readCache(prompt) {
+  if (!hasCache(prompt)) {
+    return null;
+  }
+
+  try {
+    const cachePath = getCachePath(prompt);
+    const yaml = fs.readFileSync(cachePath, "utf8");
+    return yaml;
+  } catch {
+    // If there's an error reading the cache, return null
+    return null;
+  }
+}
+
+/**
+ * Write YAML to cache for a prompt
+ */
+function writeCache(prompt, yaml) {
+  try {
+    const cachePath = getCachePath(prompt);
+    fs.writeFileSync(cachePath, yaml, "utf8");
+    return cachePath;
+  } catch {
+    // Silently fail if we can't write to cache
+    return null;
+  }
+}
+
+/**
+ * Clear all cached prompts
+ */
+function clearCache() {
+  const cacheDir = getCacheDir();
+
+  try {
+    const files = fs.readdirSync(cacheDir);
+
+    for (const file of files) {
+      if (file.endsWith(".yaml")) {
+        fs.unlinkSync(path.join(cacheDir, file));
+      }
+    }
+
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * Get cache statistics
+ */
+function getCacheStats() {
+  const cacheDir = getCacheDir();
+
+  try {
+    const files = fs.readdirSync(cacheDir);
+    const yamlFiles = files.filter((f) => f.endsWith(".yaml"));
+
+    return {
+      count: yamlFiles.length,
+      files: yamlFiles,
+    };
+  } catch {
+    return {
+      count: 0,
+      files: [],
+    };
+  }
+}
+
+module.exports = {
+  getCacheKey,
+  getCacheDir,
+  getCachePath,
+  hasCache,
+  readCache,
+  writeCache,
+  clearCache,
+  getCacheStats,
+};

package/agent/lib/commander.js

@@ -81,42 +81,26 @@ commands:
       switch (object.command) {
         case "type":
           emitter.emit(events.log.log, generator.jsonToManual(object));
-          emitter.emit(events.log.narration, `typing ${object.text}`);
           response = await commands.type(object.text, object.delay);
           break;
         case "press-keys":
           emitter.emit(events.log.log, generator.jsonToManual(object));
-          emitter.emit(
-            events.log.narration,
-            `pressing keys: ${Array.isArray(object.keys) ? object.keys.join(", ") : object.keys}`,
-          );
           response = await commands["press-keys"](object.keys);
           break;
         case "scroll":
           emitter.emit(events.log.log, generator.jsonToManual(object));
-          emitter.emit(events.log.narration, `scrolling ${object.direction}`);
-          response = await commands.scroll(
-            object.direction,
-            object.amount,
-            object.method,
-          );
+          response = await commands.scroll(object.direction, object.amount);
           break;
         case "wait":
           emitter.emit(events.log.log, generator.jsonToManual(object));
-          emitter.emit(
-            events.log.narration,
-            `waiting ${object.timeout} seconds`,
-          );
           response = await commands.wait(object.timeout);
           break;
         case "click":
           emitter.emit(events.log.log, generator.jsonToManual(object));
-          emitter.emit(events.log.narration, `${object.action}`);
           response = await commands["click"](object.x, object.y, object.action);
           break;
         case "hover":
           emitter.emit(events.log.log, generator.jsonToManual(object));
-          emitter.emit(events.log.narration, `moving mouse`);
           response = await commands["hover"](object.x, object.y);
           break;
         case "drag":
@@ -125,10 +109,6 @@ commands:
           break;
         case "hover-text":
           emitter.emit(events.log.log, generator.jsonToManual(object));
-          emitter.emit(
-            events.log.narration,
-            `searching for ${object.description}`,
-          );
           response = await commands["hover-text"](
             object.text,
             object.description,
@@ -139,10 +119,6 @@ commands:
           break;
         case "hover-image":
           emitter.emit(events.log.log, generator.jsonToManual(object));
-          emitter.emit(
-            events.log.narration,
-            `searching for image of ${object.description}`,
-          );
           response = await commands["hover-image"](
             object.description,
             object.action,
@@ -150,10 +126,6 @@ commands:
           break;
         case "match-image":
           emitter.emit(events.log.log, generator.jsonToManual(object));
-          emitter.emit(
-            events.log.narration,
-            `${object.action} image ${object.path}`,
-          );
           response = await commands["match-image"](
             object.path,
             object.action,
@@ -162,10 +134,6 @@ commands:
           break;
         case "wait-for-image":
           emitter.emit(events.log.log, generator.jsonToManual(object));
-          emitter.emit(
-            events.log.narration,
-            `waiting for ${object.description}`,
-          );
           response = await commands["wait-for-image"](
             object.description,
             object.timeout,
@@ -174,7 +142,6 @@ commands:
           break;
         case "wait-for-text":
           emitter.emit(events.log.log, generator.jsonToManual(object));
-          emitter.emit(events.log.narration, `waiting for ${object.text}`);
           copy.text = "*****";
           response = await commands["wait-for-text"](
             object.text,
@@ -185,7 +152,6 @@ commands:
           break;
         case "scroll-until-text":
           emitter.emit(events.log.log, generator.jsonToManual(object));
-          emitter.emit(events.log.narration, `scrolling until ${object.text}`);
           copy.text = "*****";
           response = await commands["scroll-until-text"](
             object.text,
@@ -197,9 +163,7 @@ commands:
           );
           break;
         case "scroll-until-image": {
-          const needle = object.description || object.path;
           emitter.emit(events.log.log, generator.jsonToManual(object));
-          emitter.emit(events.log.narration, `scrolling until ${needle}`);
           response = await commands["scroll-until-image"](
             object.description,
             object.direction,
@@ -212,7 +176,6 @@ commands:
         }
         case "focus-application":
           emitter.emit(events.log.log, generator.jsonToManual(object));
-          emitter.emit(events.log.narration, `focusing ${object.name}`);
           response = await commands["focus-application"](object.name);
           break;
         case "remember": {
@@ -224,7 +187,6 @@ commands:
         }
         case "assert":
           emitter.emit(events.log.log, generator.jsonToManual(object));
-          emitter.emit(events.log.narration, `asserting ${object.expect}`);
           response = await commands.assert(
             object.expect,
             object.async,