@mcpher/gas-fakes 1.2.23 → 1.2.24

package/README.RU.md

@@ -359,6 +359,7 @@ 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/)
+- [Power of Google Apps Script: Building MCP Server Tools for Gemini CLI and Google Antigravity in Google Workspace Automation](https://medium.com/google-cloud/power-of-google-apps-script-building-mcp-server-tools-for-gemini-cli-and-google-antigravity-in-71e754e4b740)
 - [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)

package/README.md

@@ -178,6 +178,7 @@ 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/)
+- [Power of Google Apps Script: Building MCP Server Tools for Gemini CLI and Google Antigravity in Google Workspace Automation](https://medium.com/google-cloud/power-of-google-apps-script-building-mcp-server-tools-for-gemini-cli-and-google-antigravity-in-71e754e4b740)
 - [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)

package/drive_tools.js

@@ -0,0 +1,20 @@
+import { z } from "zod";
+
+const tools = [{ name: "search_files_by_name", schema: {
+  description: "Search for files on Google Drive by filename.",
+  inputSchema: {
+    filename: z.string().describe("The name of the file to search for.")
+  }
+}, func: (object = {}) => { const { filename } = object;
+const files = DriveApp.getFilesByName(filename);
+const results = [];
+while (files.hasNext()) {
+  const file = files.next();
+  results.push({
+    name: file.getName(),
+    id: file.getId(),
+    url: file.getUrl(),
+    mimeType: file.getMimeType()
+  });
+}
+return results; } }];

package/gas-fakes.js

@@ -12,6 +12,9 @@ import dotenv from "dotenv";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { z } from "zod";
+import { parse } from "acorn";
+
+import { Auth } from "./src/support/auth.js";
 
 // --- Import setup commands ---
 import {
@@ -22,6 +25,7 @@ import {
 
 // sync the version with gas fakes code since they share a package.json
 import { createRequire } from "node:module";
+import { access } from "node:fs";
 const require = createRequire(import.meta.url);
 const pjson = require("./package.json");
 const VERSION = pjson.version;
@@ -30,8 +34,8 @@ const VERSION = pjson.version;
 // CONSTANTS & UTILITIES
 // -----------------------------------------------------------------------------
 
-const CLI_VERSION = "0.0.14";
-const MCP_VERSION = "0.0.4";
+const CLI_VERSION = "0.0.15";
+const MCP_VERSION = "0.0.5";
 
 /**
  * Replaces escaped newline characters ('\\n') with actual newlines,
@@ -40,8 +44,16 @@ const MCP_VERSION = "0.0.4";
  * @returns {string} The processed text.
  */
 function normalizeScriptNewlines(text) {
-  const regex = /("[^"]*")|('[^']*')|(`[^`]*`)|(\\n)/g;
-  return text.replace(regex, (match, g1, g2, g3, g4) => (g4 ? "\n" : match));
+  // const regex = /("[^"]*")|('[^']*')|(`[^`]*`)|(\\n)/g;
+  // return text.replace(regex, (match, g1, g2, g3, g4) => (g4 ? "\n" : match));
+
+  // Updated the above as follows.
+  const regex =
+    /("(?:[^"\\]|\\.)*")|('(?:[^'\\]|\\.)*')|(`(?:[^`\\]|\\.)*`)|(\/\\[rn]\/[dgimsuy]*)|(\/\*[\s\S]*?\*\/)|(\/\/(?:(?!\\n).)*)|(\\n)/g;
+  return text.replace(regex, (match, g1, g2, g3, g4, g5, g6, g7) => {
+    if (g7) return "\n";
+    return match;
+  });
 }
 
 // -----------------------------------------------------------------------------
@@ -189,6 +201,7 @@ async function executeGasScript(options) {
     useSandbox,
     sandboxConfig,
     args,
+    gas_library,
   } = options;
 
   let scriptText = filename ? fs.readFileSync(filename, "utf8") : script;
@@ -197,7 +210,7 @@ async function executeGasScript(options) {
     scriptText = scriptText.replace(/\\\s*?\n/g, "\n");
   }
 
-  const { mainScript, gasScript } = generateExecutionScript({
+  let { mainScript, gasScript } = generateExecutionScript({
     scriptText: normalizeScriptNewlines(scriptText),
     useSandbox,
     sandboxConfig,
@@ -216,6 +229,18 @@ async function executeGasScript(options) {
     configurable: true,
   });
 
+  if (gas_library && gas_library.length > 0) {
+    const libs = gas_library.reduce((ar, { identifier, libScript }) => {
+      if (mainScript.includes(identifier)) {
+        ar.push(libScript);
+      }
+      return ar;
+    }, []);
+    if (libs.length > 0) {
+      mainScript = `${libs.join("\n\n")}\n\n${mainScript}`;
+    }
+  }
+
   let res;
   if (args) {
     const gasFunction = new Function("args", mainScript);
@@ -344,7 +369,7 @@ function registerDefaultTool(server) {
     inputSchema: {
       filename: z
         .string()
-        .optional() // Made optional because script can be provided
+        .optional()
         .describe(`Path to the file containing Google Apps Script.`),
       script: z
         .string()
@@ -416,7 +441,7 @@ function registerDefaultTool(server) {
 
   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.`,
+      `Use this to create the tools of the MCP server using Google Apps Script as a new file. Only when the prompt that a new tool for the MCP server is required is clearly shown, use this tool. 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
@@ -439,6 +464,24 @@ function registerDefaultTool(server) {
                 .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.`
                 ),
+              libraries: z
+                .array(
+                  z
+                    .string()
+                    .describe(
+                      [
+                        `Use this when Google Apps Script libraries are required to be used in the script. The sample values are as follows.`,
+                        `It supposes that the identity of the library is \`LIB\`.`,
+                        `- When the library script is the file with path, \`LIB@{filename1}\``,
+                        `- When the library script is the file direct link, \`LIB@{file URL}\``,
+                        `- When the library script is the ID (Library project key or library key or script ID or file ID) of the file on Google Drive, \`LIB@{ID}\``,
+                      ].join("\n")
+                    )
+                )
+                .default([])
+                .describe(
+                  `Use this when Google Apps Script libraries are required to be used in the script.`
+                ),
             })
             .describe("An object for each tool.")
         )
@@ -457,16 +500,21 @@ function registerDefaultTool(server) {
         isError: true,
       };
     }
-    const tool_ar = args.tools
-      .map(
-        ({ name, schema, gas_script }) =>
-          `{ name: "${name}", schema: ${schema}, func: (object = {}) => { ${gas_script} } }`
-      )
-      .join(", ");
+
+    const tool_ar = [];
+    for (let i = 0; i < args.length; i++) {
+      const { name, schema, gas_script, libraries } = args[i];
+      tool_ar.push(
+        `{ name: "${name}", schema: ${schema}, func: (object = {}) => { ${gas_library}\n\n${gas_script} }, libraries: [${libraries.join(
+          ","
+        )}] }`
+      );
+    }
+
     const tool_script = [
       `import { z } from "zod";`,
       ``,
-      `const tools = [${tool_ar}];`,
+      `const tools = [${tool_ar.join(", ")}];`,
     ].join("\n");
     const absolutePath = path.resolve(process.cwd(), args.filename);
     fs.writeFileSync(absolutePath, tool_script);
@@ -499,7 +547,9 @@ async function registerCustomTools(server, toolsPath) {
 
   if (!tools || tools.length === 0) return;
 
-  tools.forEach((tool) => {
+  for (let i = 0; i < tools.length; i++) {
+    const tool = tools[i];
+
     // Extend the custom tool schema with sandbox options
     const extendedSchema = { ...tool.schema };
     extendedSchema.inputSchema = {
@@ -519,7 +569,24 @@ async function registerCustomTools(server, toolsPath) {
       json: z.any().optional().describe("Advanced sandbox JSON configuration."),
     };
 
-    const originalFuncStr = tool.func.toString();
+    let originalFuncStr = tool.func.toString();
+    if (tool.libraries && tool.libraries.length > 0) {
+      const gas_library = await getLibraries({ libraries: tool.libraries });
+
+      if (gas_library && gas_library.length > 0) {
+        const libs = gas_library.reduce((ar, { identifier, libScript }) => {
+          if (originalFuncStr.includes(identifier)) {
+            ar.push(libScript);
+          }
+          return ar;
+        }, []);
+        if (libs.length > 0) {
+          originalFuncStr = `(object = {}) => {\n\n${libs.join(
+            "\n\n"
+          )}\n\nconst main_gas_fakes = ${originalFuncStr}\n\nreturn main_gas_fakes(object);\n}`;
+        }
+      }
+    }
 
     const toolHandler = async (opts) => {
       // Wrap the original function string to execute it with args
@@ -535,7 +602,7 @@ async function registerCustomTools(server, toolsPath) {
     };
 
     server.registerTool(tool.name, extendedSchema, toolHandler);
-  });
+  }
 }
 
 /**
@@ -609,6 +676,296 @@ function buildSandboxConfig(options) {
   return undefined;
 }
 
+// -----------------------------------------------------------------------------
+// PROCESS GAS LIBRARIES
+// -----------------------------------------------------------------------------
+
+/**
+ * Helper function to wrap spawn in a Promise.
+ * This captures stdout and stderr and resolves or rejects based on the exit code.
+ */
+function spawnCommand(command, args) {
+  return new Promise((resolve, reject) => {
+    const child = spawn(command, args);
+    let stdout = "";
+    let stderr = "";
+
+    // Collect data from stdout stream
+    child.stdout.on("data", (data) => {
+      stdout += data.toString();
+    });
+
+    // Collect data from stderr stream
+    child.stderr.on("data", (data) => {
+      stderr += data.toString();
+    });
+
+    // Handle command not found or other spawn errors
+    child.on("error", (err) => {
+      reject(err);
+    });
+
+    // Handle process exit
+    child.on("close", (code) => {
+      if (code === 0) {
+        resolve(stdout.trim());
+      } else {
+        reject(
+          new Error(stderr.trim() || `Command failed with exit code ${code}`)
+        );
+      }
+    });
+  });
+}
+
+async function checkForGcloudCli() {
+  try {
+    // args: ['--version']
+    await spawnCommand("gcloud", ["--version"]);
+  } catch (error) {
+    console.error(
+      "\n[Error] Google Cloud SDK (gcloud CLI) not found or failed to run."
+    );
+    console.error("Please install it by following the official instructions:");
+    console.error("https://cloud.google.com/sdk/gcloud");
+    // Only exit if it's strictly required to stop execution here
+    process.exit(1);
+  }
+}
+
+async function getAccessToken(pattern) {
+  if (pattern == 1) {
+    // Authorization pattern 1
+    const auth = await Auth.setAuth(
+      ["https://www.googleapis.com/auth/drive.readonly"],
+      null,
+      true
+    );
+    auth.cachedCredential = null;
+    return await auth.getAccessToken();
+  } else {
+    // Authorization pattern 2
+    await checkForGcloudCli();
+    try {
+      const accessToken = await spawnCommand("gcloud", [
+        "auth",
+        "print-access-token",
+      ]);
+      return accessToken;
+    } catch (error) {
+      console.error("\nError obtaining access token:");
+      console.error(error.message);
+      console.error(
+        "Please ensure you are authenticated with gcloud CLI. Run 'gcloud auth application-default login'."
+      );
+      process.exit(1);
+    }
+  }
+}
+
+async function fetchScriptFileFromGoogleDrive(sourcePath, pattern = 1) {
+  try {
+    const accessToken = await getAccessToken(pattern);
+    const url = `https://www.googleapis.com/drive/v3/files/${sourcePath}/export?mimeType=${encodeURIComponent(
+      "application/vnd.google-apps.script+json"
+    )}`;
+
+    const response = await fetch(url, {
+      headers: { authorization: `Bearer ${accessToken}` },
+    });
+
+    if (!response.ok) {
+      throw new Error(
+        `HTTP error ${response.status} fetching Drive ID "${sourcePath}".`
+      );
+    }
+
+    const text = await response.json();
+    if (text.files && text.files.length > 0) {
+      // GAS projects can have multiple files; filter for server-side JS and join them.
+      return text.files
+        .filter((e) => e.type === "server_js")
+        .map((e) => e.source)
+        .join("\n\n");
+    }
+  } catch (err) {
+    if (pattern == 1) {
+      return await fetchScriptFileFromGoogleDrive(sourcePath, 2);
+    }
+
+    // If it wasn't a Drive ID or auth failed, fall through to error
+    throw new Error(
+      `Could not retrieve script from "${sourcePath}". Ensure it is a valid path, URL, or Drive ID, and that you are authenticated.`
+    );
+  }
+}
+
+/**
+ * Fetches the source code for a library from a local file, a URL, or Google Drive.
+ *
+ * @param {string} sourcePath - The file path, URL, or Drive File ID of the library.
+ * @returns {Promise<string>} The source code of the library.
+ * @throws {Error} If the source cannot be found, HTTP fails, or auth fails.
+ */
+async function fetchLibrarySource(sourcePath) {
+  // 1. Check Local File
+  if (fs.existsSync(sourcePath)) {
+    return fs.readFileSync(sourcePath, "utf8");
+  }
+
+  // 2. Check URL
+  // Note: URL.canParse requires Node.js v18.17.0+ or v20+
+  if (URL.canParse(sourcePath)) {
+    const response = await fetch(sourcePath);
+    if (!response.ok) {
+      throw new Error(`HTTP error ${response.status} fetching ${sourcePath}`);
+    }
+    return await response.text();
+  }
+
+  // 3. Check Google Drive (via gcloud)
+  try {
+    return await fetchScriptFileFromGoogleDrive(sourcePath);
+  } catch (err) {
+    throw new Error(
+      `No valid source code found for "${sourcePath}". Error message: ${err.message}`
+    );
+  }
+}
+
+/**
+ * Wraps raw library source code into a GAS-style namespace using an IIFE.
+ * It uses AST parsing to export top-level functions and 'var' variables.
+ *
+ * @param {string} identifier - The library namespace identifier (e.g., "TableApp").
+ * @param {string} source - The raw JavaScript source code.
+ * @returns {string} The wrapped, executable JavaScript code.
+ */
+function generateLibraryWrapper(identifier, source) {
+  try {
+    const ast = parse(source, { ecmaVersion: 2020 });
+
+    // Extract top-level FunctionDeclarations and VariableDeclarations (var only)
+    const exportNames = ast.body.reduce((names, node) => {
+      if (node.type === "FunctionDeclaration") {
+        names.push(node.id.name);
+      } else if (node.type === "VariableDeclaration" && node.kind === "var") {
+        names.push(...node.declarations.map((d) => d.id.name));
+      }
+      return names;
+    }, []);
+
+    if (exportNames.length === 0) {
+      throw new Error(
+        `No top-level functions or var variables found to export in library "${identifier}".`
+      );
+    }
+
+    return [
+      `var ${identifier} = (function () {`,
+      `var ${identifier};`,
+      source,
+      `\n`,
+      `if (this && this.${identifier}) { ${identifier} = this.${identifier}; }`,
+      `return { ${exportNames.join(", ")} };`,
+      `}).call({});`,
+    ].join("\n");
+
+    // Or, use the following script.
+    // return [
+    //   `var ${identifier} = (function () {`,
+    //   source,
+    //   `\n`,
+    //   `return { ${exportNames.join(", ")} };`,
+    //   `})();`,
+    // ].join("\n");
+  } catch (err) {
+    console.error(`Error processing library "${identifier}": ${err.message}`);
+    process.exit(1);
+  }
+}
+
+/**
+ * Processes library arguments, fetches source code, merges duplicates,
+ * and generates namespaced wrapper scripts.
+ *
+ * This function handles the format "Identifier@Source". If the same Identifier
+ * is provided multiple times, the sources are concatenated in order.
+ *
+ * @param {object} options - The CLI options object.
+ * @param {string[]} [options.libraries] - Array of library strings (e.g., ["Lib@./file.js"]).
+ * @returns {Promise<string|null>} The combined string of all library scripts, or null if none provided.
+ */
+async function getLibraries(options) {
+  const { libraries } = options;
+
+  if (!libraries || !Array.isArray(libraries) || libraries.length === 0) {
+    return null;
+  }
+
+  // 1. Parse and Fetch (Concurrent)
+  // We map arguments to Promises to fetch all libraries in parallel.
+  const fetchPromises = libraries.map(async (libArg) => {
+    const splitIndex = libArg.indexOf("@");
+
+    if (splitIndex === -1) {
+      throw new Error(
+        `Invalid library format: "${libArg}". Expected format: 'Identifier@Source'.`
+      );
+    }
+
+    const identifier = libArg.substring(0, splitIndex).trim();
+    const sourcePath = libArg.substring(splitIndex + 1).trim();
+
+    if (!identifier || !sourcePath) {
+      throw new Error(
+        `Invalid library argument: "${libArg}". Identifier or Source is missing.`
+      );
+    }
+
+    try {
+      const source = await fetchLibrarySource(sourcePath);
+      return { identifier, source };
+    } catch (err) {
+      throw new Error(`Failed to load library "${identifier}": ${err.message}`);
+    }
+  });
+
+  let fetchedLibs;
+  try {
+    fetchedLibs = await Promise.all(fetchPromises);
+  } catch (err) {
+    // If any fetch fails, log the error and exit
+    console.error(`Error: ${err.message}`);
+    process.exit(1);
+  }
+
+  // 2. Merge libraries with the same Identifier
+  // Using a Map to maintain insertion order and group sources
+  const mergedLibsMap = new Map();
+
+  for (const { identifier, source } of fetchedLibs) {
+    if (mergedLibsMap.has(identifier)) {
+      const existingSource = mergedLibsMap.get(identifier);
+      mergedLibsMap.set(identifier, existingSource + "\n\n" + source);
+    } else {
+      mergedLibsMap.set(identifier, source);
+    }
+  }
+
+  // 3. Generate Wrappers
+  // Convert the merged sources into wrapped IIFE strings
+  const wrappedScripts = [];
+  for (const [identifier, source] of mergedLibsMap) {
+    wrappedScripts.push({
+      identifier,
+      libScript: generateLibraryWrapper(identifier, source),
+    });
+  }
+
+  return wrappedScripts;
+}
+
 /**
  * Sets up and runs the command-line interface.
  */
@@ -618,7 +975,11 @@ async function main() {
   program
     .name("gas-fakes")
     .description("A CLI tool to execute Google Apps Script with fakes/mocks.")
-    .version(VERSION, "-v, --version", "Display the current version");
+    .version(
+      VERSION,
+      "-v, --version",
+      "Display the current version of gas-fakes"
+    );
 
   // Default command to execute a script
   program
@@ -661,6 +1022,11 @@ async function main() {
       `Arguments for the function of Google Apps Script. Provide it as a JSON string. The name of the argument is "args" as a fixed name. For example, when the function of GAS is \`function sample(args) { script }\`, you can provide the arguments like \`-a '{"key": "value"}'\`.`,
       null
     )
+    .option(
+      "-l, --libraries <string...>",
+      `Libraries. You can run the Google Apps Script with libraries. When you use 2 libraries "Lib1" and "Lib" which are the identifiers of library, provide '--libraries "Lib1@{filename}" --libraries "Lib2@{file URL}"'.`,
+      null
+    )
     .action(async (options) => {
       const { filename, script, env, gfsettings } = options;
       if (!filename && !script) {
@@ -705,6 +1071,8 @@ async function main() {
         }
       }
 
+      const gas_library = await getLibraries(options);
+
       await executeGasScript({
         filename,
         script,
@@ -713,6 +1081,7 @@ async function main() {
         sandboxConfig,
         gfSettings: settingsPath,
         args,
+        gas_library,
       });
     });
 

package/package.json

@@ -7,6 +7,7 @@
     "@mcpher/gas-flex-cache": "^1.1.3",
     "@modelcontextprotocol/sdk": "^1.20.2",
     "@sindresorhus/is": "^7.0.1",
+    "acorn": "^8.15.0",
     "archiver": "^7.0.1",
     "commander": "^14.0.1",
     "dotenv": "^17.2.3",
@@ -33,7 +34,7 @@
   },
   "name": "@mcpher/gas-fakes",
   "author": "bruce mcpherson",
-  "version": "1.2.23",
+  "version": "1.2.24",
   "license": "MIT",
   "main": "main.js",
   "description": "A proof of concept implementation of Apps Script Environment on Node",

package/src/services/advforms/fakeadvforms.js

@@ -42,8 +42,7 @@ class FakeAdvForms {
       "newFormInfo": [
         "title",
         "documentTitle",
-        "description",
-        "state"
+        "description"
       ],
       "newUpdateSettingsRequest": [
         "settings",
@@ -53,7 +52,7 @@ class FakeAdvForms {
         "emailCollectionType",
         "quizSettings"
       ],
-      "newQuizSettings" : [
+      "newQuizSettings": [
         "isQuiz"
       ],
       "newItem": [
@@ -188,7 +187,7 @@ class FakeAdvForms {
         "properties",
         "youtubeUri"
       ],
-        
+
     }
 
     Reflect.ownKeys(propLists).forEach(p => {

package/src/services/formapp/fakeform.js

@@ -3,15 +3,18 @@ import { newFakeFormItem } from './fakeformitem.js';
 import { newFakeFormResponse } from './fakeformresponse.js';
 import { newFakeGridItem } from './fakegriditem.js';
 import { newFakeCheckboxGridItem } from './fakecheckboxgriditem.js';
+import { DestinationType } from '../enums/formsenums.js';
 import { newFakeSectionHeaderItem } from './fakesectionheaderitem.js';
 import { newFakeScaleItem } from './fakescaleitem.js';
-import './formitems.js'; // Import for side effects (item class registration)
+//import './formitems.js'; // Import for side effects (item class registration)
 import { newFakeMultipleChoiceItem } from './fakemultiplechoiceitem.js';
 import { newFakeCheckboxItem } from './fakecheckboxitem.js';
 import { newFakeListItem } from './fakelistitem.js';
 import { newFakePageBreakItem } from './fakepagebreakitem.js';
 import { newFakeTextItem } from './faketextitem.js';
-
+import { signatureArgs } from '../../support/helpers.js';
+import {Utils} from '../../support/utils.js';
+const { is } = Utils
 export const newFakeForm = (...args) => {
   return Proxies.guard(new FakeForm(...args));
 };
@@ -29,14 +32,28 @@ export class FakeForm {
     // Store the resource provided at creation as the single source of truth for this instance.
     this.__id = resource.formId;
     this.__file = DriveApp.getFileById(this.__id);
-    // Since the API doesn't allow setting the published state, we'll manage it internally for the fake.
-    // A new form defaults to accepting responses (true).
-    this.__publishedState = resource.settings?.state !== 'INACTIVE';
+    this.__destinationId = resource.linkedSheetId || null;
+    this.__destinationType = this.__destinationId ? DestinationType.SPREADSHEET : null;
   }
 
   get __resource() {
     return Forms.Form.get(this.__id);
   }
+  get __publishSettings() {
+    return this.__resource.publishSettings;
+  }
+  isAcceptingResponses() {
+    return this.__publishSettings.isAcceptingResponses;
+  }
+  isPublished() {
+    return this.__publishSettings.isPublished;
+  }
+  setPublished(enabled) {
+    throw new Error('setPublished is not yet implemented in the fake environment.');
+    return this;
+  }
+
+    
   saveAndClose() {
     // this is a no-op in fake environment since it is stateless
   }
@@ -244,6 +261,24 @@ export class FakeForm {
     return this.__addItem(itemResource, newFakeTextItem);
   }
 
+  /**
+   * Gets the ID of the form's response destination.
+   * @returns {string | null} The destination ID, or null if no destination is set.
+   */
+  getDestinationId() {
+    return this.__resource.linkedSheetId || null;
+  }
+
+  /**
+   * Gets the type of the form's response destination.
+   * @returns {import('../enums/formsenums.js').DestinationType | null} The destination type, or null if no destination is set.
+   */
+  getDestinationType() {
+    if (this.getDestinationId()) {
+      return DestinationType.SPREADSHEET;
+    }
+    return null;
+  }
 
 
   /**
@@ -338,14 +373,6 @@ export class FakeForm {
     return responses.sort((a, b) => a.getTimestamp() - b.getTimestamp());
   }
 
-  /**
-   * Gets whether the form is accepting responses.
-   * @returns {boolean} true if the form is accepting responses; false otherwise.
-   */
-  isPublished() {
-    // ACTIVE is the state for accepting responses. The default if not set is ACTIVE.
-    return this.__publishedState;
-  }
 
   /**
    * Sets the name of the form file in Google Drive.
@@ -415,7 +442,32 @@ export class FakeForm {
     return itemToMove;
   }
   /**
-   * Sets whether the form is accepting responses.
+   * Unlinks the form from its response destination.
+   * @returns {FakeForm} The form, for chaining.
+   */
+  removeDestination() {
+    // This is not supported by the REST API, so we manage it internally for the fake.
+    this.__destinationId = null;
+    this.__destinationType = null;
+    return this;
+  }
+  /**
+   * Sets the destination for form responses.
+   * @param {import('../enums/formsenums.js').DestinationType} type The type of destination.
+   * @param {string} id The ID of the destination (spreadsheet ID).
+   * @returns {FakeForm} The form, for chaining.
+   */
+  setDestination(type, id) {
+    if (type !== DestinationType.SPREADSHEET) {
+      throw new Error('Only SPREADSHEET destination type is supported.');
+    }
+    // This is not supported by the REST API, so we manage it internally for the fake.
+    this.__destinationId = id;
+    this.__destinationType = DestinationType.SPREADSHEET;
+    return this;
+  }
+  /**
+   * Sets whether the form is published responses.
    * @param {boolean} enabled true if the form should accept responses; false otherwise.
    * @returns {FakeForm} The form, for chaining.
    */
@@ -423,6 +475,7 @@ export class FakeForm {
     throw new Error('setPublished is not yet implemented in the fake environment.');
   }
 
+
   __update(updateRequest) {
     const batchRequest = Forms.newBatchUpdateFormRequest()
       .setRequests([updateRequest])
@@ -430,6 +483,16 @@ export class FakeForm {
     return this;
   }
 
+  /**
+   * Sets whether the form is accepting responses.
+   * @param {boolean} enabled true if the form should accept responses; false otherwise.
+   * @returns {FakeForm} The form, for chaining.
+   */
+  setAcceptingResponses(enabled) {
+    // The REST API does not expose a way to set this. The fake will manage it internally.
+    throw new Error('setAcceptingResponses is not yet implemented in the fake environment.');
+  }
+
   /**
    * Sets the title of the form.
    * @param {string} title The new title for the form.
@@ -481,10 +544,16 @@ export class FakeForm {
    * shorten url no longer supported by google
    * @returns {string} The form URL.
    */
-  shortenFormUrl() {
+  shortenFormUrl(url) {
+    // just validate the atgs would work on apps script
+    const { nargs, matchThrow } = signatureArgs(arguments, 'shortenFormUrl');
+    if (nargs !== 1 || !is.nonEmptyString(url)) {
+      matchThrow();
+    }
+    // apps script expects a url, but we return the published url and just ignore the url anyway
     return this.getPublishedUrl()
   }
-  
+
   toString() {
     return 'Form';
   }

package/src/services/formapp/fakeformitem.js

@@ -115,7 +115,7 @@ export class FakeFormItem {
 
   getId() {
     // Live Apps Script returns IDs as decimal numbers, not the hex strings from the API.
-    return this.__itemId;
+    return parseInt(this.__itemId, 16); // Convert to decimal
   }
 
   getIndex() {

package/src/services/formapp/fakeformresponse.js

@@ -30,10 +30,10 @@ export class FakeFormResponse {
 
   /**
    * Gets the unique ID for this form response.
-   * @returns {string} the unique ID
+   * @returns {number} the unique hex ID converted to a decimal number
    */
   getId() {
-    return this.__resource.responseId;
+    return parseInt(this.__resource.responseId, 16);
   }
 
   /**

package/src/services/formapp/fakeitemresponse.js

@@ -32,7 +32,7 @@ export class FakeItemResponse {
    * @returns {string} the item's ID
    */
   getId() {
-    return this.__item.getId();
+    return parseInt(this.__item.getId(), 16); // Convert to decimal
   }
 
   /**

package/src/support/auth.js

@@ -1,119 +1,127 @@
-import { GoogleAuth } from 'google-auth-library'
-import is from '@sindresorhus/is'
-import { createHash } from 'node:crypto'
-import { syncLog } from './workersync/synclogger.js'
+import { GoogleAuth } from "google-auth-library";
+import is from "@sindresorhus/is";
+import { createHash } from "node:crypto";
+import { syncLog } from "./workersync/synclogger.js";
 
-const _authScopes = new Set([])
+const _authScopes = new Set([]);
 
 // all this stuff gets populated by the initial synced fxInit
-let _auth = null
-let _projectId = null
-let _tokenInfo = null
+let _auth = null;
+let _projectId = null;
+let _tokenInfo = null;
 let _accessToken = null;
 let _tokenExpiresAt = null;
-let _manifest = null
-let _clasp = null
-
-let _settings = null
-const setManifest = (manifest) => _manifest = manifest
-const setClasp = (clasp) => _clasp = clasp
-const getManifest = () => _manifest
-const getClasp = () => _clasp
-const getSettings = () => _settings
-const getScriptId = () => getSettings().scriptId
-const getDocumentId = () => getSettings().documentId
-const setProjectId = (projectId) => _projectId = projectId
-const setAccessToken = (accessToken) => _accessToken = accessToken
-const setSettings = (settings) => _settings = settings
-const getCachePath = () => getSettings().cache
-const getPropertiesPath = () => getSettings().properties
-const setTokenExpiresAt = (expiresAt) => _tokenExpiresAt = expiresAt;
+let _manifest = null;
+let _clasp = null;
+
+let _settings = null;
+const setManifest = (manifest) => (_manifest = manifest);
+const setClasp = (clasp) => (_clasp = clasp);
+const getManifest = () => _manifest;
+const getClasp = () => _clasp;
+const getSettings = () => _settings;
+const getScriptId = () => getSettings().scriptId;
+const getDocumentId = () => getSettings().documentId;
+const setProjectId = (projectId) => (_projectId = projectId);
+const setAccessToken = (accessToken) => (_accessToken = accessToken);
+const setSettings = (settings) => (_settings = settings);
+const getCachePath = () => getSettings().cache;
+const getPropertiesPath = () => getSettings().properties;
+const setTokenExpiresAt = (expiresAt) => (_tokenExpiresAt = expiresAt);
 const setTokenInfo = (tokenInfo) => {
   _tokenInfo = tokenInfo;
   // set expiry time with a 60 second buffer
   if (tokenInfo && tokenInfo.expires_in) {
-    setTokenExpiresAt(Date.now() + ((tokenInfo.expires_in - 60) * 1000));
+    setTokenExpiresAt(Date.now() + (tokenInfo.expires_in - 60) * 1000);
   } else {
     // no expiry info, so we'll have to fetch a new one next time
     setTokenExpiresAt(0);
   }
-}
+};
 const getTokenInfo = () => {
-  if (!_tokenInfo) throw `token info isnt set yet`
-  return _tokenInfo
-}
-
-const getTimeZone = () => getManifest().timeZone
-const getUserId = () => getTokenInfo().sub
-const getTokenScopes = () => getTokenInfo().scope
-const getHashedUserId = () => createHash('md5').update(getUserId() + 'hud').digest().toString('hex')
+  if (!_tokenInfo) throw `token info isnt set yet`;
+  return _tokenInfo;
+};
 
+const getTimeZone = () => getManifest().timeZone;
+const getUserId = () => getTokenInfo().sub;
+const getTokenScopes = () => getTokenInfo().scope;
+const getHashedUserId = () =>
+  createHash("md5")
+    .update(getUserId() + "hud")
+    .digest()
+    .toString("hex");
 
 const getAccessToken = () => _accessToken;
 
-const isTokenExpired = () => !_accessToken || !_tokenExpiresAt || Date.now() >= _tokenExpiresAt;
+const isTokenExpired = () =>
+  !_accessToken || !_tokenExpiresAt || Date.now() >= _tokenExpiresAt;
 /**
  * we'll be using adc credentials so no need for any special auth here
  * the idea here is to keep addign scopes to any auth so we have them all
  * @param {string[]} [scopes=[]] the required scopes will be added to existing scopes already asked for
+ * @param {string} [keyFile=null]
+ * @param {boolean} [mcpLoading=false] When the MCP server is loading, this value is true. By this, the invalid values can be hidden while the MCP server is loading. This is important for using Google Antigravity.
  * @returns {GoogleAuth.auth}
  */
-let _authClient = null
-const getAuthClient = () => _authClient
-const setAuth = async (scopes = [], keyFile = null) => {
-  const hasCurrentAuth = hasAuth() && scopes.every(s => _authScopes.has(s));
-  
-  
+let _authClient = null;
+const getAuthClient = () => _authClient;
+const setAuth = async (scopes = [], keyFile = null, mcpLoading = false) => {
+  const hasCurrentAuth = hasAuth() && scopes.every((s) => _authScopes.has(s));
+
   if (!hasCurrentAuth) {
-    syncLog(`...initializing auth and discovering project ID`); 
-    
+    if (!mcpLoading) {
+      syncLog(`...initializing auth and discovering project ID`);
+    }
+
     // 1. Create the GoogleAuth manager instance (this instance has getProjectId)
     _auth = new GoogleAuth({ scopes });
-    
+
     // 2. Use the manager to get the authenticated client (this is passed to API methods)
     _authClient = await _auth.getClient();
-    
+
     // 3. Use the manager to reliably get the project ID
     _projectId = await _auth.getProjectId();
-    
+
     if (!_projectId) {
-      throw new Error('Failed to get project ID from Application Default Credentials.');
+      throw new Error(
+        "Failed to get project ID from Application Default Credentials."
+      );
+    }
+
+    if (!mcpLoading) {
+      syncLog(`...discovered and set projectId to ${_projectId}`);
     }
-    
-    syncLog(`...discovered and set projectId to ${_projectId}`);
-    scopes.forEach(s => _authScopes.add(s));
+    scopes.forEach((s) => _authScopes.add(s));
   }
   return getAuth();
 };
 
-
 /**
  * if we're doing a fetch on drive API we need a special header
  */
 const googify = (options = {}) => {
-  const { headers } = options
+  const { headers } = options;
 
   // no auth, therefore no need
-  if (!headers || !hasAuth()) return options
+  if (!headers || !hasAuth()) return options;
 
   // if no authorization, we dont need this either
-  if (!Reflect.has(headers, "Authorization")) return options
+  if (!Reflect.has(headers, "Authorization")) return options;
 
   // we'll need the projectID for this
   // note - you must add the x-goog-user-project header, otherwise it'll use some nonexistent project
   // see https://cloud.google.com/docs/authentication/rest#set-billing-project
   // this has been syncified
-  const projectId = getProjectId()
+  const projectId = getProjectId();
   return {
     ...options,
     headers: {
       "x-goog-user-project": projectId,
-      ...headers
-    }
-  }
-
-}
-
+      ...headers,
+    },
+  };
+};
 
 /**
  * this would have been set up when manifest was imported
@@ -121,56 +129,59 @@ const googify = (options = {}) => {
  */
 const getProjectId = () => {
   if (is.null(_projectId) || is.undefined(_projectId)) {
-    throw new Error('Project id not set - this means that the fxInit wasnt run')
+    throw new Error(
+      "Project id not set - this means that the fxInit wasnt run"
+    );
   }
-  return _projectId
-}
+  return _projectId;
+};
 
-/** 
+/**
  * @returns {Boolean} checks to see if auth has bee initialized yet
  */
-const hasAuth = () => Boolean(_auth)
+const hasAuth = () => Boolean(_auth);
 
 /**
  * @returns {GoogleAuth.auth}
  */
 const getAuth = () => {
-  if (!hasAuth()) throw new Error(`auth hasnt been intialized with setAuth yet`)
-  return _auth
-}
-
+  if (!hasAuth())
+    throw new Error(`auth hasnt been intialized with setAuth yet`);
+  return _auth;
+};
 
 /**
  * why is this here ?
  * because when we syncit, we import auth for each method and it needs this
  * if it was somewhere else we'd need to import that too.
- * we can't serialize a return object 
+ * we can't serialize a return object
  * so we just select a few props from it
- * @param {SyncApiResponse} result 
- * @returns 
+ * @param {SyncApiResponse} result
+ * @returns
  */
 export const responseSyncify = (result) => {
   if (!result) {
     return {
       status: 503, // Service Unavailable, a good representation for a worker-level failure
-      statusText: 'Worker Error: No response object received from API call',
-      error: { message: 'Worker Error: No response object received from API call' }
+      statusText: "Worker Error: No response object received from API call",
+      error: {
+        message: "Worker Error: No response object received from API call",
+      },
     };
   }
   return {
     status: result.status,
     statusText: result.statusText,
     responseUrl: result.request?.responseURL,
-    error: result.data?.error
+    error: result.data?.error,
   };
-}
-
+};
 
 /**
  * these are the ones that have been so far requested
  * @returns {Set}
  */
-const getAuthedScopes = () => _authScopes
+const getAuthedScopes = () => _authScopes;
 
 export const Auth = {
   getAuth,
@@ -198,5 +209,5 @@ export const Auth = {
   getTimeZone,
   setAccessToken,
   isTokenExpired,
-  getAuthClient
-}
+  getAuthClient,
+};

package/src/support/sxfetch.js

@@ -20,10 +20,31 @@ export const sxFetch = async (Auth, url, options, responseFields) => {
 
   // Always fetch as a buffer to prevent corruption of binary data like images.
   // The caller (UrlFetchApp/HttpResponse) will be responsible for decoding to text if needed.
+  // we need to fiddle with options as apps script is diffeent
+  let fixedOptions = {}
+  if (options) {
+    fixedOptions = { ...options }
+    Object.keys(fixedOptions).forEach(k => {
+      if (k.match(/Content-Type/i)) {
+        fixedOptions.contentType = fixedOptions[k]
+        delete fixedOptions[k]
+      }
+      if (k.match(/payload/i)) {
+        fixedOptions.body = fixedOptions[k]
+        delete fixedOptions[k]
+      }
+      if(k.match(/muteHttpExceptions/i)) {
+        fixedOptions.throwHttpErrors = !fixedOptions[k]
+        delete fixedOptions[k]
+      }
+    })
+  }
+
   const response = await got(url, {
-    ...options,
+    ...fixedOptions,
     responseType: 'buffer'
   })
+
   // we cant return the response from this as it cant be serialized
   // so we;ll extract oout the fields required
   const result = responseFields.reduce((p, c) => {