@mcpher/gas-fakes 2.3.14 → 2.3.16

package/gf_agent/skills/urlfetch.md

@@ -0,0 +1,28 @@
+# Service: urlfetch
+
+## Class: HTTPResponse
+
+Supported Methods:
+- `getAllHeaders()`
+- `getAs(String)`
+- `getBlob()`
+- `getContent()`
+- `getContentText()`
+- `getContentText(String)`
+- `getHeaders()`
+- `getResponseCode()`
+- `fetch(String,Object)`
+- `fetch(String)`
+- `fetchAll(Object)`
+- `getRequest(String,Object)`
+- `getRequest(String)`
+
+## Class: UrlFetchApp
+
+Supported Methods:
+- `fetch(String,Object)`
+- `fetch(String)`
+- `fetchAll(Object)`
+- `getRequest(String,Object)`
+- `getRequest(String)`
+

package/gf_agent/skills/utilities.md

@@ -0,0 +1,33 @@
+# Service: utilities
+
+## Class: Utilities
+
+Supported Methods:
+- `base64Decode(String,Charset)`
+- `base64Decode(String)`
+- `base64DecodeWebSafe(String,Charset)`
+- `base64DecodeWebSafe(String)`
+- `base64Encode(Byte)`
+- `base64Encode(String,Charset)`
+- `base64Encode(String)`
+- `base64EncodeWebSafe(Byte)`
+- `base64EncodeWebSafe(String,Charset)`
+- `base64EncodeWebSafe(String)`
+- `computeHmacSha256Signature(Byte,Byte)`
+- `computeHmacSha256Signature(String,String,Charset)`
+- `computeHmacSha256Signature(String,String)`
+- `getUuid()`
+- `gzip(BlobSource,String)`
+- `gzip(BlobSource)`
+- `newBlob(Byte,String,String)`
+- `newBlob(Byte,String)`
+- `newBlob(Byte)`
+- `newBlob(String,String,String)`
+- `newBlob(String,String)`
+- `newBlob(String)`
+- `sleep(Integer)`
+- `ungzip(BlobSource)`
+- `unzip(BlobSource)`
+- `zip(BlobSource,String)`
+- `zip(BlobSource)`
+

package/gf_agent/skills/xml.md

@@ -0,0 +1,270 @@
+# Service: xml
+
+## Class: Attribute
+
+Supported Methods:
+- `getName()`
+- `getNamespace()`
+- `getRootElement()`
+- `getAttribute(String,Namespace)`
+- `getAttribute(String)`
+- `getChild(String,Namespace)`
+- `getChild(String)`
+- `getChildren()`
+- `getChildren(String,Namespace)`
+- `getChildren(String)`
+- `getChildText(String,Namespace)`
+- `getChildText(String)`
+- `getName()`
+- `getNamespace()`
+- `getNamespace(String)`
+- `getQualifiedName()`
+- `getText()`
+- `getValue()`
+- `getName()`
+- `format(Document)`
+- `format(Element)`
+- `getPrefix()`
+- `getURI()`
+- `getText()`
+- `getValue()`
+- `getNamespace(String,String)`
+- `getNamespace(String)`
+- `getPrettyFormat()`
+- `getRawFormat()`
+- `parse(String)`
+
+## Class: Cdata
+
+Supported Methods:
+- `getRootElement()`
+- `getAttribute(String,Namespace)`
+- `getAttribute(String)`
+- `getChild(String,Namespace)`
+- `getChild(String)`
+- `getChildren()`
+- `getChildren(String,Namespace)`
+- `getChildren(String)`
+- `getChildText(String,Namespace)`
+- `getChildText(String)`
+- `getName()`
+- `getNamespace()`
+- `getNamespace(String)`
+- `getQualifiedName()`
+- `getText()`
+- `getValue()`
+- `getName()`
+- `format(Document)`
+- `format(Element)`
+- `getPrefix()`
+- `getURI()`
+- `getText()`
+- `getValue()`
+- `getNamespace(String,String)`
+- `getNamespace(String)`
+- `getPrettyFormat()`
+- `getRawFormat()`
+- `parse(String)`
+
+## Class: Comment
+
+Supported Methods:
+- `getRootElement()`
+- `getAttribute(String,Namespace)`
+- `getAttribute(String)`
+- `getChild(String,Namespace)`
+- `getChild(String)`
+- `getChildren()`
+- `getChildren(String,Namespace)`
+- `getChildren(String)`
+- `getChildText(String,Namespace)`
+- `getChildText(String)`
+- `getName()`
+- `getNamespace()`
+- `getNamespace(String)`
+- `getQualifiedName()`
+- `getText()`
+- `getValue()`
+- `getName()`
+- `format(Document)`
+- `format(Element)`
+- `getPrefix()`
+- `getURI()`
+- `getText()`
+- `getValue()`
+- `getNamespace(String,String)`
+- `getNamespace(String)`
+- `getPrettyFormat()`
+- `getRawFormat()`
+- `parse(String)`
+
+## Class: DocType
+
+Supported Methods:
+- `getRootElement()`
+- `getAttribute(String,Namespace)`
+- `getAttribute(String)`
+- `getChild(String,Namespace)`
+- `getChild(String)`
+- `getChildren()`
+- `getChildren(String,Namespace)`
+- `getChildren(String)`
+- `getChildText(String,Namespace)`
+- `getChildText(String)`
+- `getName()`
+- `getNamespace()`
+- `getNamespace(String)`
+- `getQualifiedName()`
+- `getText()`
+- `getValue()`
+- `getName()`
+- `format(Document)`
+- `format(Element)`
+- `getPrefix()`
+- `getURI()`
+- `getText()`
+- `getValue()`
+- `getNamespace(String,String)`
+- `getNamespace(String)`
+- `getPrettyFormat()`
+- `getRawFormat()`
+- `parse(String)`
+
+## Class: Document
+
+Supported Methods:
+- `getRootElement()`
+- `getAttribute(String,Namespace)`
+- `getAttribute(String)`
+- `getChild(String,Namespace)`
+- `getChild(String)`
+- `getChildren()`
+- `getChildren(String,Namespace)`
+- `getChildren(String)`
+- `getChildText(String,Namespace)`
+- `getChildText(String)`
+- `getName()`
+- `getNamespace()`
+- `getNamespace(String)`
+- `getQualifiedName()`
+- `getText()`
+- `getValue()`
+- `getName()`
+- `format(Document)`
+- `format(Element)`
+- `getPrefix()`
+- `getURI()`
+- `getText()`
+- `getValue()`
+- `getNamespace(String,String)`
+- `getNamespace(String)`
+- `getPrettyFormat()`
+- `getRawFormat()`
+- `parse(String)`
+
+## Class: Element
+
+Supported Methods:
+- `getAttribute(String,Namespace)`
+- `getAttribute(String)`
+- `getChild(String,Namespace)`
+- `getChild(String)`
+- `getChildren()`
+- `getChildren(String,Namespace)`
+- `getChildren(String)`
+- `getChildText(String,Namespace)`
+- `getChildText(String)`
+- `getName()`
+- `getNamespace()`
+- `getNamespace(String)`
+- `getQualifiedName()`
+- `getText()`
+- `getValue()`
+- `getName()`
+- `format(Document)`
+- `format(Element)`
+- `getPrefix()`
+- `getURI()`
+- `getText()`
+- `getValue()`
+- `getNamespace(String,String)`
+- `getNamespace(String)`
+- `getPrettyFormat()`
+- `getRawFormat()`
+- `parse(String)`
+
+## Class: EntityRef
+
+Supported Methods:
+- `getName()`
+- `format(Document)`
+- `format(Element)`
+- `getPrefix()`
+- `getURI()`
+- `getText()`
+- `getValue()`
+- `getNamespace(String,String)`
+- `getNamespace(String)`
+- `getPrettyFormat()`
+- `getRawFormat()`
+- `parse(String)`
+
+## Class: Format
+
+Supported Methods:
+- `format(Document)`
+- `format(Element)`
+- `getPrefix()`
+- `getURI()`
+- `getText()`
+- `getValue()`
+- `getNamespace(String,String)`
+- `getNamespace(String)`
+- `getPrettyFormat()`
+- `getRawFormat()`
+- `parse(String)`
+
+## Class: Namespace
+
+Supported Methods:
+- `getPrefix()`
+- `getURI()`
+- `getText()`
+- `getValue()`
+- `getNamespace(String,String)`
+- `getNamespace(String)`
+- `getPrettyFormat()`
+- `getRawFormat()`
+- `parse(String)`
+
+## Class: ProcessingInstruction
+
+Supported Methods:
+- `getText()`
+- `getValue()`
+- `getNamespace(String,String)`
+- `getNamespace(String)`
+- `getPrettyFormat()`
+- `getRawFormat()`
+- `parse(String)`
+
+## Class: Text
+
+Supported Methods:
+- `getText()`
+- `getValue()`
+- `getNamespace(String,String)`
+- `getNamespace(String)`
+- `getPrettyFormat()`
+- `getRawFormat()`
+- `parse(String)`
+
+## Class: XmlService
+
+Supported Methods:
+- `getNamespace(String,String)`
+- `getNamespace(String)`
+- `getPrettyFormat()`
+- `getRawFormat()`
+- `parse(String)`
+

package/package.json

@@ -40,7 +40,7 @@
   },
   "name": "@mcpher/gas-fakes",
   "author": "bruce mcpherson",
-  "version": "2.3.14",
+  "version": "2.3.16",
   "license": "MIT",
   "main": "main.js",
   "description": "An implementation of the Google Workspace Apps Script runtime: Run native App Script Code on Node and Cloud Run",

package/src/cli/mcp.js

@@ -2,8 +2,15 @@ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { z } from "zod";
 import { spawn } from "child_process";
+import fs from "fs";
+import os from "os";
+import path from "path";
+import { fileURLToPath } from "url";
 import { MCP_VERSION } from "./utils.js";
 
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
 /**
  * Executes a GAS script using the gas-fakes CLI logic.
  */
@@ -37,57 +44,11 @@ async function runGasFakes(script) {
   });
 }
 
-const SERVICES = [
-  {
-    name: "spreadsheet_service",
-    description: "Automate Google Sheets: Create, read, and modify spreadsheets, ranges, and formatting.",
-    example: "const ss = SpreadsheetApp.create('Test'); ss.getActiveSheet().getRange('A1').setValue('Hello');"
-  },
-  {
-    name: "document_service",
-    description: "Automate Google Docs: Create and edit documents, paragraphs, tables, and styles.",
-    example: "const doc = DocumentApp.create('Hello'); doc.getBody().appendParagraph('World');"
-  },
-  {
-    name: "drive_service",
-    description: "Manage Google Drive: Search files, create folders, and handle permissions.",
-    example: "const files = DriveApp.getFilesByName('Test'); while(files.hasNext()) console.log(files.next().getName());"
-  },
-  {
-    name: "gmail_service",
-    description: "Automate Gmail: Send emails, search threads, and manage labels.",
-    example: "GmailApp.sendEmail('test@example.com', 'Subject', 'Body');"
-  },
-  {
-    name: "calendar_service",
-    description: "Manage Google Calendar: Create events, list calendars, and handle invitations.",
-    example: "CalendarApp.getDefaultCalendar().createEvent('Meeting', new Date(), new Date());"
-  },
-  {
-    name: "slides_service",
-    description: "Automate Google Slides: Create and edit presentations, slides, and shapes.",
-    example: "const deck = SlidesApp.create('Presentation'); deck.appendSlide().insertShape(SlidesApp.ShapeType.RECTANGLE);"
-  },
-  {
-    name: "forms_service",
-    description: "Automate Google Forms: Create forms, add items, and manage responses.",
-    example: "const form = FormApp.create('Survey'); form.addTextItem().setTitle('Name');"
-  },
-  {
-    name: "jdbc_service",
-    description: "Connect to databases via JDBC: Execute SQL queries and manage connections.",
-    example: "const conn = Jdbc.getConnection(url, user, pass); const stmt = conn.createStatement();"
-  },
-  {
-    name: "utilities_service",
-    description: "General utilities: Formatting, parsing, and base64 encoding/decoding.",
-    example: "const base64 = Utilities.base64Encode('hello');"
-  },
-  {
-    name: "urlfetch_service",
-    description: "HTTP Requests: Fetch external resources and APIs via GET/POST.",
-    example: "const res = UrlFetchApp.fetch('https://api.example.com'); console.log(res.getContentText());"
-  }
+// Available services mapping for the documentation lookup
+const AVAILABLE_SERVICES = [
+  "base", "cache", "calendar", "charts", "document", "drive", 
+  "forms", "gmail", "jdbc", "lock", "properties", "script", 
+  "slides", "spreadsheet", "urlfetch", "utilities", "xml"
 ];
 
 export async function startMcpServer() {
@@ -96,27 +57,81 @@ export async function startMcpServer() {
     version: MCP_VERSION,
   });
 
-  // Register a tool for each high-level service
-  for (const service of SERVICES) {
-    server.registerTool(
-      service.name,
-      {
-        description: `${service.description}\nExample script:\n${service.example}`,
-        inputSchema: {
-          script: z.string().describe("The Google Apps Script code to execute locally."),
-        },
+  // Documentation lookup tool
+  server.registerTool(
+    "lookup_docs",
+    {
+      description: "Lookup the available Google Apps Script classes and methods supported by gas-fakes for a specific service. You MUST use this tool to read the documentation before writing a script to ensure the methods you plan to use are actually implemented.",
+      inputSchema: {
+        service: z.enum(AVAILABLE_SERVICES).describe("The Google Apps Script service to look up (e.g., 'spreadsheet', 'drive', 'document')."),
       },
-      async ({ script }) => {
-        return await runGasFakes(script);
+    },
+    async ({ service }) => {
+      try {
+        const fileName = `${service.toLowerCase()}.md`;
+        
+        // Define potential paths for the skills documentation
+        const potentialPaths = [
+          // 1. Local project installation (e.g. from gas-fakes init standalone)
+          path.resolve(process.cwd(), "gf_agent", "skills", fileName),
+          path.resolve(process.cwd(), "gf_agent_standalone", "gf_agent", "skills", fileName),
+          
+          // 2. Global Gemini CLI skill installation
+          path.resolve(os.homedir(), ".gemini", "skills", "gf_agent", "skills", fileName),
+          
+          // 3. Bundled inside the npm package
+          path.resolve(__dirname, "../../gf_agent/skills", fileName)
+        ];
+
+        let docsPath = null;
+        for (const p of potentialPaths) {
+          if (fs.existsSync(p)) {
+            docsPath = p;
+            break;
+          }
+        }
+
+        if (!docsPath) {
+          // If not found locally, try fetching from the GitHub repository
+          const githubRawUrl = `https://raw.githubusercontent.com/brucemcpherson/gas-fakes/main/gf_agent/skills/${fileName}`;
+          try {
+            const response = await fetch(githubRawUrl);
+            if (response.ok) {
+              const githubContent = await response.text();
+              return {
+                content: [{ type: "text", text: githubContent }],
+                isError: false,
+              };
+            }
+          } catch (fetchErr) {
+            // Silently fail the fetch and fall through to the local error message
+          }
+          
+          return {
+            content: [{ type: "text", text: `Documentation not found for service: ${service}. Checked multiple standard locations and GitHub origin.` }],
+            isError: true,
+          };
+        }
+        
+        const content = fs.readFileSync(docsPath, "utf-8");
+        return {
+          content: [{ type: "text", text: content }],
+          isError: false,
+        };
+      } catch (err) {
+        return {
+          content: [{ type: "text", text: `Failed to read documentation: ${err.message}` }],
+          isError: true,
+        };
       }
-    );
-  }
+    }
+  );
 
-  // Also add a generic tool for tasks that span multiple services
+  // Consolidated execution tool
   server.registerTool(
-    "workspace_agent",
+    "run_script",
     {
-      description: "A general-purpose agent to automate tasks across multiple Google Workspace services (Sheets, Docs, Drive, etc.)",
+      description: "Executes Google Apps Script code locally using the gas-fakes emulator. You can interact with multiple Workspace services in a single script.",
       inputSchema: {
         script: z.string().describe("The Google Apps Script code to execute locally."),
       },

package/src/services/advgmail/fakeadvgmailmessages.js

@@ -10,6 +10,20 @@ class FakeAdvGmailMessages extends FakeAdvResource {
     super(mainService, 'users', Syncit.fxGmail);
     this.gmail = mainService;
     this.__fakeObjectType = 'Gmail.Users.Messages';
+    
+    const self = this;
+    this.Attachments = {
+      get(userId, messageId, id) {
+        const { data, response } = self._call(
+          'attachments.get',
+          { userId, messageId, id },
+          null,
+          'messages'
+        );
+        gError(response, 'gmail', 'users.messages.attachments.get', true);
+        return data;
+      }
+    };
   }
 
   /**
@@ -18,10 +32,10 @@ class FakeAdvGmailMessages extends FakeAdvResource {
    * @param {string} id - The ID of the message to retrieve.
    * @returns {object} The message resource.
    */
-  get(userId, id) {
+  get(userId, id, optionalArgs) {
     const { data, response } = this._call(
       'get',
-      { userId, id },
+      { userId, id, ...optionalArgs },
       null,
       'messages'
     );
@@ -39,11 +53,79 @@ class FakeAdvGmailMessages extends FakeAdvResource {
   send(resource, userId, media) {
     const { data, response } = this._call(
       'send',
-      { userId, resource, media },
+      { userId, requestBody: resource, media },
       null,
       'messages'
     );
     gError(response, 'gmail', 'users.messages.send');
     return data;
   }
+
+  /**
+   * Modifies the labels on the specified message.
+   * @param {object} resource - The modifications to apply.
+   * @param {string} userId - The user's email address.
+   * @param {string} id - The ID of the message to modify.
+   * @returns {object} The modified message resource.
+   */
+  modify(resource, userId, id) {
+    const { data, response } = this._call(
+      'modify',
+      { userId, id, requestBody: resource },
+      null,
+      'messages'
+    );
+    gError(response, 'gmail', 'users.messages.modify');
+    return data;
+  }
+
+  /**
+   * Modifies the labels on the specified messages.
+   * @param {object} resource - The batch modifications to apply.
+   * @param {string} userId - The user's email address.
+   */
+  batchModify(resource, userId) {
+    const { data, response } = this._call(
+      'batchModify',
+      { userId, requestBody: resource },
+      null,
+      'messages'
+    );
+    gError(response, 'gmail', 'users.messages.batchModify');
+    return data;
+  }
+
+  /**
+   * Moves the specified message to the trash.
+   * @param {string} userId - The user's email address.
+   * @param {string} id - The ID of the message to trash.
+   * @returns {object} The trashed message resource.
+   */
+  trash(userId, id) {
+    const { data, response } = this._call(
+      'trash',
+      { userId, id },
+      null,
+      'messages'
+    );
+    gError(response, 'gmail', 'users.messages.trash');
+    return data;
+  }
+
+  /**
+   * Removes the specified message from the trash.
+   * @param {string} userId - The user's email address.
+   * @param {string} id - The ID of the message to untrash.
+   * @returns {object} The untrashed message resource.
+   */
+  untrash(userId, id) {
+    const { data, response } = this._call(
+      'untrash',
+      { userId, id },
+      null,
+      'messages'
+    );
+    gError(response, 'gmail', 'users.messages.untrash');
+    return data;
+  }
 }