@nbakka/mcp-appium 3.0.23 → 3.0.24

package/lib/server.js

@@ -336,32 +336,138 @@ tool(
   }
 );
 
- tool(
-   "mobile_learn_testcases_generation_context",
-   "Reads previously saved app context notes and returns them so they can be used to validate or update test cases. This should be executed before generating manual test cases.",
-   {},
-   async () => {
-     try {
-       // Read app context notes from file
-       const notesFilePath = path.join(__dirname, "app_context.txt");
-       const fileContent = await fs.readFile(notesFilePath, "utf-8");
-
-       const notes = fileContent
-         .split("\n")
-         .map(line => line.trim())
-         .filter(line => line.length > 0);
-
-       if (notes.length === 0) {
-         return "No app context notes found.";
-       }
-
-       return `App context loaded for testcase generation: ${JSON.stringify({ notes })}`;
-     } catch (error) {
-       return `Error reading app context notes: ${error.message}`;
-     }
-   }
- );
+tool(
+  "mobile_learn_teststeps_generation_guidelines",
+  "Reads previously saved test steps generation guidelines and returns them so they can be used to validate or update test steps. This should be executed before generating manual test steps.",
+  {},
+  async () => {
+    try {
+      // Read test steps generation guidelines from Desktop
+      const guidelinesFilePath = path.join(os.homedir(), 'Desktop', 'teststeps_generation_guidelines.txt');
+      const fileContent = await fs.readFile(guidelinesFilePath, "utf-8");
+
+      const guidelines = fileContent
+        .split("\n")
+        .map(line => line.trim())
+        .filter(line => line.length > 0);
+
+      if (guidelines.length === 0) {
+        return "No test steps generation guidelines found.";
+      }
+
+      return `Test steps generation guidelines loaded: ${JSON.stringify({ guidelines })}`;
+    } catch (error) {
+      return `Error reading test steps generation guidelines: ${error.message}`;
+    }
+  }
+);
+
+// Tool 3: Update Test Scenario (Always appends with green color)
+tool(
+  "mobile_update_test_scenario",
+  "Updates the Test Scenario (Testcases column) in Google Sheet for outdated scenarios. Always keeps the existing scenario and adds the updated scenario in green color on a new line.",
+  {
+    sheetName: zod_1.z.string().describe("The name of the Google Sheet tab"),
+    rowNumber: zod_1.z.number().describe("The row number to update"),
+    columnLetter: zod_1.z.string().describe("The column letter for Testcases column"),
+    updatedScenario: zod_1.z.string().describe("The updated test scenario content"),
+  },
+  async ({ sheetName, rowNumber, columnLetter, updatedScenario }) => {
+    try {
+      // Load Google Sheets credentials with write permissions
+      const keyFile = path.join(os.homedir(), 'Desktop', 'secret.json');
+
+      const auth = new google.auth.GoogleAuth({
+        keyFile,
+        scopes: ['https://www.googleapis.com/auth/spreadsheets'],
+      });
+
+      const authClient = await auth.getClient();
+      const sheets = google.sheets({ version: 'v4', auth: authClient });
+      const spreadsheetId = '1jAilVUeQW99JUYj1KL4jovoxeWGUnsIcY_nMJR5H6dc';
+
+      const cellReference = `${sheetName}!${columnLetter}${rowNumber}`;
+
+      // First, read the existing scenario
+      const getRes = await sheets.spreadsheets.values.get({
+        spreadsheetId,
+        range: cellReference
+      });
+
+      const existingScenario = getRes.data.values && getRes.data.values[0] && getRes.data.values[0][0]
+        ? getRes.data.values[0][0]
+        : '';
+
+      if (!existingScenario) {
+        return `No existing scenario found at ${cellReference}. Cannot append to empty cell.`;
+      }
+
+      // Combine: existing scenario + newline + updated scenario
+      const combinedContent = `${existingScenario}\n${updatedScenario}`;
 
+      // Get sheet ID dynamically
+      const sheetsMetadata = await sheets.spreadsheets.get({ spreadsheetId });
+      const sheetId = sheetsMetadata.data.sheets.find(s => s.properties.title === sheetName)?.properties.sheetId || 0;
+
+      // Calculate text positions
+      const existingLength = existingScenario.length;
+      const newTextStartIndex = existingLength + 1; // +1 for newline
+
+      // Apply green color formatting to the new text
+      const batchUpdateRes = await sheets.spreadsheets.batchUpdate({
+        spreadsheetId,
+        resource: {
+          requests: [
+            {
+              repeatCell: {
+                range: {
+                  sheetId: sheetId,
+                  startRowIndex: rowNumber - 1,
+                  endRowIndex: rowNumber,
+                  startColumnIndex: columnLetter.charCodeAt(0) - 65,
+                  endColumnIndex: columnLetter.charCodeAt(0) - 64
+                },
+                cell: {
+                  userEnteredValue: {
+                    stringValue: combinedContent
+                  },
+                  textFormatRuns: [
+                    // Keep existing text in default color
+                    {
+                      startIndex: 0,
+                      format: {}
+                    },
+                    // New text in green
+                    {
+                      startIndex: newTextStartIndex,
+                      format: {
+                        foregroundColor: {
+                          red: 0.0,
+                          green: 0.5,
+                          blue: 0.0
+                        }
+                      }
+                    }
+                  ]
+                },
+                fields: 'userEnteredValue,textFormatRuns'
+              }
+            }
+          ]
+        }
+      });
+
+      if (batchUpdateRes.status === 200) {
+        return `Successfully appended updated scenario at ${cellReference}. New scenario added in green color: "${updatedScenario.substring(0, 100)}${updatedScenario.length > 100 ? '...' : ''}"`;
+      } else {
+        return `Failed to append scenario. Status: ${batchUpdateRes.status}`;
+      }
+
+    } catch (error) {
+      return `Error updating test scenario: ${error.message}`;
+    }
+  }
+);
 
  tool("mobile_list_elements_on_screennn", "List elements on screen and their coordinates, with display text or accessibility label. Returns the complete XML structure to maintain hierarchy for XPath creation. Do not cache this result.", {}, async ({}) => {
      requireRobot();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nbakka/mcp-appium",
-  "version": "3.0.23",
+  "version": "3.0.24",
   "description": "Appium MCP",
   "engines": {
     "node": ">=18"