@mcpher/gas-fakes 1.2.22 → 1.2.23

package/README.RU.md

@@ -359,6 +359,8 @@ const getParentsIterator = ({
 - [Supercharge Your Google Apps Script Caching with GasFlexCache](https://ramblings.mcpher.com/supercharge-your-google-apps-script-caching-with-gasflexcache/)
 - [Fake-Sandbox for Google Apps Script: Granular controls.](https://ramblings.mcpher.com/fake-sandbox-for-google-apps-script-granular-controls/)
 - [A Fake-Sandbox for Google Apps Script: Securely Executing Code Generated by Gemini CLI](https://ramblings.mcpher.com/gas-fakes-sandbox/)
+- [A New Era for Google Apps Script: Unlocking the Future of Google Workspace Automation with Natural Language](https://medium.com/google-cloud/a-new-era-for-google-apps-script-unlocking-the-future-of-google-workspace-automation-with-natural-a9cecf87b4c6)
+- [Next-Generation Google Apps Script Development: Leveraging Antigravity and Gemini 3.0](https://medium.com/google-cloud/next-generation-google-apps-script-development-leveraging-antigravity-and-gemini-3-0-c4d5affbc1a8)
 - [Modern Google Apps Script Workflow Building on the Cloud](https://medium.com/google-cloud/modern-google-apps-script-workflow-building-on-the-cloud-2255dbd32ac3)
 - [Bridging the Gap: Seamless Integration for Local Google Apps Script Development](https://medium.com/@tanaike/bridging-the-gap-seamless-integration-for-local-google-apps-script-development-9b9b973aeb02)
 - [Next-Level Google Apps Script Development](https://medium.com/google-cloud/next-level-google-apps-script-development-654be5153912)

package/README.md

@@ -178,6 +178,8 @@ As I mentioned earlier, to take this further, I'm going to need a lot of help to
 - [Supercharge Your Google Apps Script Caching with GasFlexCache](https://ramblings.mcpher.com/supercharge-your-google-apps-script-caching-with-gasflexcache/)
 - [Fake-Sandbox for Google Apps Script: Granular controls.](https://ramblings.mcpher.com/fake-sandbox-for-google-apps-script-granular-controls/)
 - [A Fake-Sandbox for Google Apps Script: Securely Executing Code Generated by Gemini CLI](https://ramblings.mcpher.com/gas-fakes-sandbox/)
+- [A New Era for Google Apps Script: Unlocking the Future of Google Workspace Automation with Natural Language](https://medium.com/google-cloud/a-new-era-for-google-apps-script-unlocking-the-future-of-google-workspace-automation-with-natural-a9cecf87b4c6)
+- [Next-Generation Google Apps Script Development: Leveraging Antigravity and Gemini 3.0](https://medium.com/google-cloud/next-generation-google-apps-script-development-leveraging-antigravity-and-gemini-3-0-c4d5affbc1a8)
 - [Modern Google Apps Script Workflow Building on the Cloud](https://medium.com/google-cloud/modern-google-apps-script-workflow-building-on-the-cloud-2255dbd32ac3)
 - [Bridging the Gap: Seamless Integration for Local Google Apps Script Development](https://medium.com/@tanaike/bridging-the-gap-seamless-integration-for-local-google-apps-script-development-9b9b973aeb02)
 - [Next-Level Google Apps Script Development](https://medium.com/google-cloud/next-level-google-apps-script-development-654be5153912)

package/gas-fakes.js

@@ -6,8 +6,7 @@
 
 import fs from "fs";
 import path from "path";
-import { exec } from "child_process";
-import { promisify } from "util";
+import { spawn } from "child_process";
 import { Command } from "commander";
 import dotenv from "dotenv";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
@@ -31,9 +30,8 @@ const VERSION = pjson.version;
 // CONSTANTS & UTILITIES
 // -----------------------------------------------------------------------------
 
-const CLI_VERSION = "0.0.13";
-const MCP_VERSION = "0.0.3";
-const execAsync = promisify(exec);
+const CLI_VERSION = "0.0.14";
+const MCP_VERSION = "0.0.4";
 
 /**
  * Replaces escaped newline characters ('\\n') with actual newlines,
@@ -237,132 +235,327 @@ async function executeGasScript(options) {
 // -----------------------------------------------------------------------------
 
 /**
- * Defines and runs the MCP server for gas-fakes.
+ * Helper: Constructs the CLI arguments array for gas-fakes execution.
+ * Modified to return an array suitable for spawn (no shell escaping needed).
+ * @param {object} params Configuration parameters
+ * @returns {string[]} Array of CLI arguments
  */
-async function startMcpServer() {
-  const server = new McpServer({
-    name: "gas-fakes-mcp",
-    version: MCP_VERSION,
+function buildCliArguments(params) {
+  const {
+    filename,
+    script,
+    args,
+    sandbox,
+    whitelistRead,
+    whitelistReadWrite,
+    whitelistReadWriteTrash,
+    json,
+  } = params;
+
+  const cliArgs = [];
+
+  // Input source
+  if (filename) {
+    cliArgs.push("-f", filename);
+  }
+  if (script) {
+    cliArgs.push("-s", script);
+  }
+
+  // Execution arguments
+  if (args) {
+    cliArgs.push("-a", JSON.stringify(args));
+  }
+
+  // Sandbox & Permissions
+  if (sandbox) cliArgs.push("-x");
+  if (whitelistRead) cliArgs.push("-w", whitelistRead);
+  if (whitelistReadWrite) cliArgs.push("--ww", whitelistReadWrite);
+  if (whitelistReadWriteTrash) cliArgs.push("--wt", whitelistReadWriteTrash);
+  if (json) cliArgs.push("-j", JSON.stringify(json));
+
+  return cliArgs;
+}
+
+/**
+ * Helper: Executes the gas-fakes command via child_process.spawn.
+ * Uses spawn instead of exec to avoid shell interpretation of arguments.
+ * @param {string[]} cliArgs Arguments to pass to the command
+ * @returns {Promise<object>} MCP tool result object
+ */
+async function runGasFakesProcess(cliArgs) {
+  return new Promise((resolve) => {
+    // We invoke the current node executable with the current script
+    const child = spawn(process.execPath, [process.argv[1], ...cliArgs], {
+      env: process.env,
+      stdio: ["ignore", "pipe", "pipe"], // ignore stdin, capture stdout/stderr
+      shell: false, // Important: Disable shell execution
+    });
+
+    let stdoutData = "";
+    let stderrData = "";
+
+    child.stdout.on("data", (data) => {
+      stdoutData += data.toString();
+    });
+
+    child.stderr.on("data", (data) => {
+      stderrData += data.toString();
+    });
+
+    child.on("close", (code) => {
+      if (code === 0) {
+        resolve({
+          content: [
+            { type: "text", text: stdoutData || "Execution finished." },
+          ],
+          isError: false,
+        });
+      } else {
+        // If there's content in stdout, it might contain the error info from gas-fakes
+        const output = stderrData || stdoutData || "Unknown error occurred";
+        resolve({
+          content: [{ type: "text", text: output }],
+          isError: true,
+        });
+      }
+    });
+
+    child.on("error", (err) => {
+      resolve({
+        content: [{ type: "text", text: err.message }],
+        isError: true,
+      });
+    });
   });
+}
 
-  const mcpToolSchema = {
+/**
+ * Registers the default "run-gas-by-gas-fakes" tool.
+ */
+function registerDefaultTool(server) {
+  const schema1 = {
     description: [
       `Use this to safely run Google Apps Script in a sandbox using gas-fakes.`,
       `# Important`,
       `- Use the extension of the Google Apps Script files as \`js\`. Don't use \`gs\``,
-      `- When you provide the generated Google Apps Script to the tool "gas-fakes" of the MCP server "gas-development-kit-extension", please be careful of the following rule. For example, when you generated a Google Apps Script like \`function sample() { script }\`, please add \`sample();\` to execute the function. Or, you can also create a Google Apps Script without enclosing the script with \`function sample() { script }\`.`,
+      `- When providing script content, ensure functions are called (e.g., add \`sample();\`).`,
     ].join("\n"),
     inputSchema: {
       filename: z
         .string()
-        .describe(
-          `Provide a filename with the path of the file, including Google Apps Script. Write the Google Apps Script into a file and use this.`
-        ),
+        .optional() // Made optional because script can be provided
+        .describe(`Path to the file containing Google Apps Script.`),
+      script: z
+        .string()
+        .optional()
+        .describe(`Direct GAS script content string.`),
       sandbox: z
         .boolean()
         .describe("Use to run Google Apps Script in a sandbox."),
       whitelistRead: z
         .string()
+        .optional()
         .describe(
-          "Whitelist of file IDs for readonly access (comma-separated). Enables sandbox mode."
-        )
-        .optional(),
+          "Whitelist of file IDs for readonly access (comma-separated). When the file IDs and folder IDs are used or provided, use `whiteListRead`, `whitelistReadWrite`, or `whitelistReadWriteTrash` by judging from the prompt."
+        ),
       whitelistReadWrite: z
         .string()
+        .optional()
         .describe(
-          "Whitelist of file IDs for read/write access (comma-separated). Enables sandbox mode."
-        )
-        .optional(),
+          "Whitelist of file IDs for read/write access (comma-separated). When the file IDs and folder IDs are used or provided, use `whiteListRead`, `whitelistReadWrite`, or `whitelistReadWriteTrash` by judging from the prompt."
+        ),
       whitelistReadWriteTrash: z
         .string()
+        .optional()
         .describe(
-          "Whitelist of file IDs for read/write/trash access (comma-separated). Enables sandbox mode."
-        )
-        .optional(),
+          "Whitelist of file IDs for read/write/trash access (comma-separated). When the file IDs and folder IDs are used or provided, use `whiteListRead`, `whitelistReadWrite`, or `whitelistReadWriteTrash` by judging from the prompt."
+        ),
       json: z
         .object({
           whitelistItems: z
             .array(
               z.object({
-                itemId: z
-                  .string()
-                  .describe("The file or folder ID on Google Drive."),
-                read: z.boolean().optional().default(true),
-                write: z.boolean().optional().default(false),
-                trash: z.boolean().optional().default(false),
+                itemId: z.string(),
+                read: z.boolean().default(true).optional(),
+                write: z.boolean().default(false).optional(),
+                trash: z.boolean().default(false).optional(),
               })
             )
-            .describe("A list of items to be whitelisted."),
+            .optional(),
           whitelistServices: z
             .array(
               z.object({
-                className: z
-                  .string()
-                  .describe("The class name of the GAS service."),
-                methodNames: z
-                  .array(z.string())
-                  .describe(
-                    "A list of method names for the class to be whitelisted."
-                  )
-                  .optional(),
+                className: z.string(),
+                methodNames: z.array(z.string()).optional(),
               })
             )
-            .describe("A list of services to be whitelisted.")
-            .optional(),
-          blacklistServices: z
-            .array(z.string())
-            .describe("A list of GAS services to be blacklisted.")
             .optional(),
+          blacklistServices: z.array(z.string()).optional(),
         })
-        .describe("A JSON object for advanced sandbox configuration.")
-        .optional(),
+        .optional()
+        .describe("Advanced sandbox configuration JSON."),
     },
   };
 
-  const mcpToolFunc = async (options = {}) => {
-    const {
-      filename,
-      sandbox,
-      whitelistRead,
-      whitelistReadWrite,
-      whitelistReadWriteTrash,
-      json,
-    } = options;
-
-    if (!filename) {
+  server.registerTool("run-gas-by-gas-fakes", schema1, async (args) => {
+    if (!args.filename && !args.script) {
       return {
         content: [
-          { type: "text", text: "Error: `filename` is a required parameter." },
+          {
+            type: "text",
+            text: "Error: Either `filename` or `script` is required.",
+          },
         ],
         isError: true,
       };
     }
+    const cliArgs = buildCliArguments(args);
+    return await runGasFakesProcess(cliArgs);
+  });
 
-    try {
-      const cliArgs = [];
-      cliArgs.push(`-f "${filename}"`);
-      if (sandbox) cliArgs.push("-x");
-      if (whitelistRead) cliArgs.push(`-w "${whitelistRead}"`);
-      if (whitelistReadWrite) cliArgs.push(`--ww "${whitelistReadWrite}"`);
-      if (whitelistReadWriteTrash)
-        cliArgs.push(`--wt "${whitelistReadWriteTrash}"`);
-      if (json) cliArgs.push(`-j '${JSON.stringify(json)}'`);
-
-      const command = `gas-fakes ${cliArgs.join(" ")}`;
-      const { stdout } = await execAsync(command);
-      return {
-        content: [{ type: "text", text: stdout || "Execution finished." }],
-        isError: false,
-      };
-    } catch (err) {
+  const schema2 = {
+    description: [
+      `Use this to create the tools of the MCP server using Google Apps Script as a new file. If a file \`settings.json\` or \`mcp_config.json\` or and so on for loading the MCP servers include \`--tools\` and the tool file to \`gas-fakes\` MCP server, ask the current client which you want to create a new file including the tools or you want to add the tools to the existing tool file. When a new tool file is created, show how to use the tool file as follows. When the created tool file is \`toolFile.js\`, modify the MCP server setting to \`"mcpServers": { "gas-fakes": { "command": "gas-fakes", "args": [ "mcp", "--tools", "{Absolute path}/toolFile.js" ] } }\`. Don't forget to replace \`{Absolute path}\` with the actual path.`,
+    ].join("\n"),
+    inputSchema: {
+      filename: z
+        .string()
+        .describe(
+          "Filename of the tool file built by Google Apps Script. The extension is required to be `.js`."
+        ),
+      tools: z
+        .array(
+          z
+            .object({
+              name: z.string().describe("Tool name."),
+              schema: z
+                .string()
+                .describe(
+                  `JSON schema of the arguments to \`gas-script\`. This is required to be an object by creating zod. The simple sample script of Zod is \`{ description: "Use this to search files by a filename on Google Drive.", inputSchema: { filename: z.string().describe("Filename of the search file.") } }\`. Generate a JSON schema using Zod by following this sample. You are required to generate the JSON schema using Zod. This object of inputSchema will be used as "object" in Google Apps Script.`
+                ),
+              gas_script: z
+                .string()
+                .describe(
+                  `Generated Google Apps Script. Please be careful of the following rule. For example, when you generated a Google Apps Script like \`function sample(object) { script }\`, please add \`return sample(object);\` to execute the function. This is a very important point. When the prompt says "Create a function", please create a function and add a line of script for calling the function and returning the response like \`return sample(object);\`. Or, you can also create a Google Apps Script without enclosing the script with \`function sample(object) { script }\`. When you want to return the value, show the value using \`console.log\` in the script, or return the value using \`return\`. The simple sample script is \`const { filename } = object; const files = DriveApp.getFilesByName(filename); const ar = []; while (files.hasNext()) { const file = files.next(); ar.push({ filename: file.getName(), fileId: file.getId() }); } return ar;\` This tool is required to be used for creating tools as a new file. When you want to add more tools to the existing file, add them to an array \`tools\` in the file by following the specification of \`tools\`. If you cannot find the array, please create it as a new file.`
+                ),
+            })
+            .describe("An object for each tool.")
+        )
+        .describe("An array including tools."),
+    },
+  };
+  server.registerTool("create-new-tools", schema2, async (args) => {
+    if (!args.filename || !args.tools) {
       return {
-        content: [{ type: "text", text: err.message }],
+        content: [
+          {
+            type: "text",
+            text: "Error: `filename` and `tools` are required.",
+          },
+        ],
         isError: true,
       };
     }
-  };
+    const tool_ar = args.tools
+      .map(
+        ({ name, schema, gas_script }) =>
+          `{ name: "${name}", schema: ${schema}, func: (object = {}) => { ${gas_script} } }`
+      )
+      .join(", ");
+    const tool_script = [
+      `import { z } from "zod";`,
+      ``,
+      `const tools = [${tool_ar}];`,
+    ].join("\n");
+    const absolutePath = path.resolve(process.cwd(), args.filename);
+    fs.writeFileSync(absolutePath, tool_script);
+    return {
+      content: [
+        {
+          type: "text",
+          text: `A new file including tools for gas-fakes-mcp was successfully created as "${absolutePath}".`,
+        },
+      ],
+      isError: false,
+    };
+  });
+}
+
+/**
+ * Loads and registers custom tools from an external file.
+ */
+async function registerCustomTools(server, toolsPath) {
+  if (!toolsPath || !fs.existsSync(toolsPath)) {
+    if (toolsPath) console.error(`No tool file: ${toolsPath}`);
+    return;
+  }
+
+  const absolutePath = path.resolve(process.cwd(), toolsPath);
+  let toolsStr = fs.readFileSync(absolutePath, "utf8");
+  toolsStr = toolsStr.replace(/^import.*/gm, "");
+  const getTools = new Function("z", `${toolsStr} return tools || [];`);
+  const tools = getTools(z);
+
+  if (!tools || tools.length === 0) return;
+
+  tools.forEach((tool) => {
+    // Extend the custom tool schema with sandbox options
+    const extendedSchema = { ...tool.schema };
+    extendedSchema.inputSchema = {
+      gas_args: z
+        .object(tool.schema.inputSchema)
+        .describe("Arguments for Google Apps Script."),
+      sandbox: z.boolean().describe("Run in sandbox."),
+      whitelistRead: z.string().optional().describe("Read-only whitelist IDs."),
+      whitelistReadWrite: z
+        .string()
+        .optional()
+        .describe("Read/Write whitelist IDs."),
+      whitelistReadWriteTrash: z
+        .string()
+        .optional()
+        .describe("Read/Write/Trash whitelist IDs."),
+      json: z.any().optional().describe("Advanced sandbox JSON configuration."),
+    };
+
+    const originalFuncStr = tool.func.toString();
 
-  server.registerTool("run-gas-by-gas-fakes", mcpToolSchema, mcpToolFunc);
+    const toolHandler = async (opts) => {
+      // Wrap the original function string to execute it with args
+      const wrappedScript = `return (${originalFuncStr})(args)`;
+
+      const cliArgs = buildCliArguments({
+        script: wrappedScript,
+        args: opts.gas_args,
+        ...opts,
+      });
+
+      return await runGasFakesProcess(cliArgs);
+    };
+
+    server.registerTool(tool.name, extendedSchema, toolHandler);
+  });
+}
+
+/**
+ * Defines and runs the MCP server for gas-fakes.
+ */
+async function startMcpServer(options) {
+  const { tools } = options;
+
+  const server = new McpServer({
+    name: "gas-fakes-mcp",
+    version: MCP_VERSION,
+  });
+
+  // Register the built-in generic runner
+  registerDefaultTool(server);
+
+  // Register dynamic custom tools if provided
+  if (tools) {
+    await registerCustomTools(server, tools);
+  }
 
   const transport = new StdioServerTransport();
   await server.connect(transport);
@@ -561,6 +754,10 @@ async function main() {
   program
     .command("mcp")
     .description("Launch gas-fakes as an MCP server.")
+    .option(
+      "-t, --tools <string>",
+      "A filename of the custom MCP server tools built by Google Apps Script."
+    )
     .action(startMcpServer);
 
   program.showHelpAfterError("(add --help for additional information)");

package/gasfakes.json

@@ -2,7 +2,7 @@
   "manifest": "./appsscript.json",
   "clasp": "./.clasp.json",
   "scriptId": "28780abe-aaec-4526-a0bf-9d5c104c68b8",
-  "documentId": null,
+  "documentId": "1h9IGIShgVBVUrUjjawk5MaCEQte_7t32XeEP1Z5jXKQ",
   "cache": "/tmp/gas-fakes/cache",
   "properties": "/tmp/gas-fakes/properties"
 }

package/package.json

@@ -4,7 +4,7 @@
   },
   "dependencies": {
     "@mcpher/fake-gasenum": "^1.0.2",
-    "@mcpher/gas-flex-cache": "^1.1.2",
+    "@mcpher/gas-flex-cache": "^1.1.3",
     "@modelcontextprotocol/sdk": "^1.20.2",
     "@sindresorhus/is": "^7.0.1",
     "archiver": "^7.0.1",
@@ -33,7 +33,7 @@
   },
   "name": "@mcpher/gas-fakes",
   "author": "bruce mcpherson",
-  "version": "1.2.22",
+  "version": "1.2.23",
   "license": "MIT",
   "main": "main.js",
   "description": "A proof of concept implementation of Apps Script Environment on Node",

package/src/services/documentapp/fakedocumentapp.js

@@ -73,7 +73,11 @@ class FakeDocumentApp {
     }
     return this.openById(match[1]);
   }
-
+  /**
+   * note that this in gas-fakes uses the documentId from gasfakes.json config file
+   * Returns the document to which the script is container-bound. To interact with document to which the script is not container-bound, use openById(id) or openByUrl(url) instead.
+   * @returns {Document}
+   */
   getActiveDocument() {
     const documentId = Auth.getDocumentId();
     if (!documentId) return null;

package/src/services/formapp/fakeform.js

@@ -475,7 +475,16 @@ export class FakeForm {
   getPublishedUrl() {
     return `https://docs.google.com/forms/d/e/${this.getId()}/viewform`;
   }
-
+  /**
+   * Gets the URL to respond to the form
+   * https://github.com/brucemcpherson/gas-fakes/issues/111
+   * shorten url no longer supported by google
+   * @returns {string} The form URL.
+   */
+  shortenFormUrl() {
+    return this.getPublishedUrl()
+  }
+  
   toString() {
     return 'Form';
   }

package/src/services/spreadsheetapp/fakespreadsheetapp.js

@@ -1,4 +1,5 @@
 import { Proxies } from "../../support/proxies.js";
+import { Auth } from "../../support/auth.js";
 import { newFakeSpreadsheet } from "./fakespreadsheet.js";
 import {
   notYetImplemented,
@@ -34,6 +35,8 @@ export const newFakeSpreadsheetApp = (...args) => {
  */
 export class FakeSpreadsheetApp {
   constructor() {
+    // in the context of gas-fakes we start with the activespreadsheet being the one mentioned in gasfakes.json
+    this.__activeSpreadsheet = null
     const enumProps = [
       "AutoFillSeries", //	AutoFillSeries	An enumeration of the types of series used to calculate auto-filled values.
       "BandingTheme", //	BandingTheme	An enumeration of the possible banding themes.
@@ -75,24 +78,19 @@ export class FakeSpreadsheetApp {
     });
 
     const props = [
-
-
       "getActive",
       "newConditionalFormatRule",
-      "getActiveSpreadsheet",
       "getActiveSheet",
       "getCurrentCell",
       "getActiveRange",
       "getActiveRangeList",
       "getSelection",
-      "setActiveSpreadsheet",
       "setActiveSheet",
       "setCurrentCell",
       "setActiveRange",
       "setActiveRangeList",
       "newCellImage",
       "getUi",
-
       "open",
 
       "ChartAggregationType",
@@ -108,6 +106,20 @@ export class FakeSpreadsheetApp {
   toString() {
     return "SpreadsheetApp";
   }
+  getActiveSpreadsheet() {
+    if (this.__activeSpreadsheet) return this.__activeSpreadsheet;
+    // because this is a faked container bound app, we need to get the documentId from the config file
+    const documentId = Auth.getDocumentId();
+    if (documentId) {
+      return this.openById(documentId);
+    }
+    return null;
+  }
+
+  setActiveSpreadsheet(ss) {
+    this.__activeSpreadsheet = ss;
+    return this;
+  }
 
 
   enableBigQueryExecution() {