gogcli-mcp-drive 2.28.0 → 2.29.0

package/.claude-plugin/marketplace.json

@@ -7,7 +7,7 @@
   },
   "metadata": {
     "description": "Extended Google Drive for Claude via gogcli — auth + full Drive support (upload, download, permissions, comments, shared drives)",
-    "version": "2.28.0"
+    "version": "2.29.0"
   },
   "plugins": [
     {
@@ -15,7 +15,7 @@
       "displayName": "gogcli (Drive)",
       "source": "./",
       "description": "Extended Google Drive for Claude via gogcli — auth + full Drive support (upload, download, permissions, comments, shared drives)",
-      "version": "2.28.0",
+      "version": "2.29.0",
       "author": {
         "name": "Chris Hall"
       },

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "gogcli-mcp-drive",
   "displayName": "gogcli (Drive)",
-  "version": "2.28.0",
+  "version": "2.29.0",
   "description": "Extended Google Drive for Claude via gogcli — auth + full Drive support (upload, download, permissions, comments, shared drives)",
   "author": {
     "name": "Chris Hall",

package/dist/index.js

@@ -31323,6 +31323,77 @@ function redactSecrets(text) {
   return text.replace(BEARER_RE, "$1[REDACTED]").replace(BASIC_AUTH_RE, "$1[REDACTED]").replace(SET_COOKIE_RE, "$1$2=[REDACTED]").replace(COOKIE_HEADER_RE, (_m, prefix, pairs) => `${prefix}${pairs.replace(/=[^;,\s]*/g, "=[REDACTED]")}`).replace(API_KEY_RE, "[REDACTED]").replace(QUERY_SECRET_RE, "$1[REDACTED]").replace(AWS_SIGV4_RE, "$1[REDACTED]").replace(JSON_SECRET_DQ_RE, "$1[REDACTED]$2").replace(JSON_SECRET_SQ_RE, "$1[REDACTED]$2").replace(JWT_RE, "[REDACTED]");
 }
 
+// ../../node_modules/@chrischall/mcp-utils/dist/response/view.js
+var VIEWS = ["compact", "full", "raw"];
+var DEFAULT_VIEW = "compact";
+var BLURB = {
+  compact: '"compact" (default) drops fields the response already carries elsewhere',
+  full: '"full" returns every field this server understands',
+  raw: '"raw" returns the upstream payload unprojected'
+};
+function viewParam(honoured, opts = {}) {
+  if (honoured.length < 2) {
+    throw new Error("viewParam needs at least two rungs: a parameter offering one value decides nothing");
+  }
+  if (!honoured.includes("compact")) {
+    throw new Error('viewParam must offer "compact": a tool with no cheap rung has nothing to default to');
+  }
+  const ordered = VIEWS.filter((v) => honoured.includes(v));
+  const sentence = `Response shape: ${ordered.map((v) => BLURB[v]).join("; ")}.`;
+  return external_exports.enum(Object.fromEntries(ordered.map((v) => [v, v]))).optional().describe(opts.note ? `${sentence} ${opts.note}` : sentence);
+}
+function resolveView(value, honoured) {
+  return value !== void 0 && honoured.includes(value) ? value : DEFAULT_VIEW;
+}
+function minifiedResult(data) {
+  return { content: [{ type: "text", text: JSON.stringify(data) }] };
+}
+
+// ../../node_modules/@chrischall/mcp-utils/dist/response/media.js
+var MEDIA_NOUN = "(?:avatar|tall_avatar|cover_photo|cover_image|picture|photo|thumbnail|thumb|image|icon|banner|profile_pic(?:ture)?|logo)";
+var MEDIA_KEY = new RegExp(`^${MEDIA_NOUN}s?(?:(?:link|uri|url)s?)?$`, "i");
+var MEDIA_URL = /^https?:\/\/[^\s]+?\.(png|jpe?g|gif|webp|svg|avif|bmp|ico)([?#]|$)/i;
+function stripMediaUrls(value, opts = {}) {
+  const keep = new Set((opts.keep ?? []).map((k) => k.toLowerCase()));
+  const drop = (opts.drop ?? []).map((rule) => typeof rule === "string" ? rule.toLowerCase() : new RegExp(rule.source, rule.flags));
+  return walk(value, keep, drop);
+}
+function alsoDrop(key, drop) {
+  const lower = key.toLowerCase();
+  for (const rule of drop) {
+    if (typeof rule === "string") {
+      if (rule === lower)
+        return true;
+      continue;
+    }
+    rule.lastIndex = 0;
+    if (rule.test(key))
+      return true;
+  }
+  return false;
+}
+function walk(value, keep, drop) {
+  if (Array.isArray(value))
+    return value.map((v) => walk(v, keep, drop));
+  if (value === null || typeof value !== "object")
+    return value;
+  if (Object.getPrototypeOf(value) !== Object.prototype && Object.getPrototypeOf(value) !== null)
+    return value;
+  const out = {};
+  for (const [key, v] of Object.entries(value)) {
+    if (keep.has(key.toLowerCase())) {
+      out[key] = v;
+      continue;
+    }
+    if (MEDIA_KEY.test(key) || alsoDrop(key, drop))
+      continue;
+    if (typeof v === "string" && MEDIA_URL.test(v))
+      continue;
+    out[key] = walk(v, keep, drop);
+  }
+  return out;
+}
+
 // ../../node_modules/@chrischall/mcp-utils/dist/response/index.js
 function rawTextResult(text) {
   return { content: [{ type: "text", text }] };
@@ -31852,11 +31923,11 @@ function parseTimestampValue(key, value, assumeNaiveIn) {
   }
   return null;
 }
-function walk(node, tz, naiveTz) {
+function walk2(node, tz, naiveTz) {
   let changed = false;
   if (Array.isArray(node)) {
     for (const item of node) {
-      if (walk(item, tz, naiveTz)) changed = true;
+      if (walk2(item, tz, naiveTz)) changed = true;
     }
     return changed;
   }
@@ -31865,7 +31936,7 @@ function walk(node, tz, naiveTz) {
   for (const key of Object.keys(obj)) {
     const value = obj[key];
     if (value !== null && typeof value === "object") {
-      if (walk(value, tz, naiveTz)) changed = true;
+      if (walk2(value, tz, naiveTz)) changed = true;
       continue;
     }
     if (ZONE_NAME_KEYS.has(key) || !TIMESTAMP_KEYS.has(key)) continue;
@@ -31891,7 +31962,7 @@ function normalizeTimestamps(text, tz = displayTimeZone(), naiveTz = naiveSource
   } catch {
     return text;
   }
-  if (!walk(parsed, tz, naiveTz)) return text;
+  if (!walk2(parsed, tz, naiveTz)) return text;
   return JSON.stringify(parsed, null, detectIndent(text));
 }
 
@@ -32033,10 +32104,38 @@ ${accounts || "(none)"}${hint}`);
     return errorResult(`${errText}${hint}`);
   }
 }
+function minifiedOrRawText(text, stripMedia = false) {
+  const trimmed = text.trim();
+  if (trimmed === "" || !/^[[{]/.test(trimmed)) return rawTextResult(text);
+  try {
+    const parsed = JSON.parse(trimmed);
+    return minifiedResult(stripMedia ? stripMediaUrls(parsed) : parsed);
+  } catch {
+    return rawTextResult(text);
+  }
+}
+function isRejectedFieldMask(err) {
+  return /invalidParameter|invalid field selection/i.test(String(err));
+}
+async function runProjected(args, options) {
+  const { fieldsMask } = options;
+  if (!fieldsMask) return run(args, options);
+  try {
+    return await run([...args, `--fields=${fieldsMask}`], options);
+  } catch (err) {
+    if (!isRejectedFieldMask(err)) throw err;
+    process.stderr.write(
+      `gogcli-mcp: Google rejected the compact field mask (${fieldsMask}); retrying unprojected
+`
+    );
+    return run(args, options);
+  }
+}
 async function runOrDiagnose(args, options) {
   try {
-    const raw = await run(args, options);
-    return rawTextResult(options.lossless ? raw : stripConsumedPageToken(normalizeTimestamps(raw)));
+    const raw = await runProjected(args, options);
+    if (options.lossless) return rawTextResult(raw);
+    return minifiedOrRawText(stripConsumedPageToken(normalizeTimestamps(raw)), options.stripMedia);
   } catch (err) {
     return diagnose(err);
   }
@@ -32286,6 +32385,7 @@ function fileMeta(raw) {
   const f = parsed.file ?? parsed;
   return { name: f.name, mimeType: f.mimeType };
 }
+var DRIVE_LS_COMPACT_FIELDS = "nextPageToken,files(id,name,mimeType,modifiedTime,size,webViewLink)";
 function registerDriveTools(server) {
   server.registerTool("gog_drive_ls", {
     description: "List files in a Google Drive folder (default: root).",
@@ -32297,9 +32397,12 @@ function registerDriveTools(server) {
       page: pageAliasParam,
       query: external_exports.string().optional().describe(`Drive query filter (e.g. "name contains 'budget'")`),
       allDrives: external_exports.boolean().optional().describe("Include shared drives (default: true). Set false for My Drive only."),
+      view: viewParam(["compact", "full"], {
+        note: "compact (the default) drops owners, parents, thumbnailLink and hasThumbnail \u2014 near-constant across a listing and 48% of its bytes. Ask for full to get them."
+      }),
       account: accountParam
     }
-  }, async ({ folderId, max, pageToken, page, query, allDrives, account }) => {
+  }, async ({ folderId, max, pageToken, page, query, allDrives, view, account }) => {
     const args = ["drive", "ls"];
     if (folderId) args.push(`--parent=${folderId}`);
     if (max !== void 0) args.push(`--max=${max}`);
@@ -32307,27 +32410,48 @@ function registerDriveTools(server) {
     if (token) args.push(`--page=${token}`);
     if (query) args.push(`--query=${query}`);
     if (allDrives === false) args.push("--no-all-drives");
-    return runOrDiagnose(args, { account });
+    const rung = resolveView(view, ["compact", "full"]);
+    return runOrDiagnose(args, {
+      account,
+      fieldsMask: rung === "compact" ? DRIVE_LS_COMPACT_FIELDS : void 0
+    });
   });
   server.registerTool("gog_drive_search", {
     description: "Search Google Drive files by full-text query.",
     annotations: { readOnlyHint: true },
     inputSchema: {
       query: external_exports.string().describe("Search query"),
+      // gog's `drive search` accepts no --fields mask, so unlike gog_drive_ls
+      // this tool's compact rung is a LOCAL projection. Same vocabulary either
+      // way: a caller does not need to know which lever is being pulled.
+      view: viewParam(["compact", "full"], { note: "compact (the default) drops thumbnailLink \u2014 a URL a model cannot see, and 30%+ of a Drive file record. Ask for full to get it back." }),
       account: accountParam
     }
-  }, async ({ query, account }) => {
-    return runOrDiagnose(["drive", "search", query], { account });
+  }, async ({ query, view, account }) => {
+    return runOrDiagnose(["drive", "search", query], {
+      account,
+      stripMedia: resolveView(view, ["compact", "full"]) === "compact"
+    });
   });
   server.registerTool("gog_drive_get", {
     description: "Get metadata for a Google Drive file.",
     annotations: { readOnlyHint: true },
     inputSchema: {
       fileId: external_exports.string().describe("File ID"),
+      // A --fields mask saves only 7% here: the default set is already narrow,
+      // which is why this tool takes no mask. The media strip saves 27.5% of
+      // the tool's actual output, measured end to end over stdio, which is why
+      // it takes a view after all. (An earlier note said 32.9%; that was a
+      // minified-vs-stripped comparison of the raw gog payload rather than of
+      // what the tool returns. The end-to-end figure is the one a caller sees.)
+      view: viewParam(["compact", "full"], { note: "compact (the default) drops thumbnailLink \u2014 a URL a model cannot see, and 30%+ of a Drive file record. Ask for full to get it back." }),
       account: accountParam
     }
-  }, async ({ fileId, account }) => {
-    return runOrDiagnose(["drive", "get", fileId], { account });
+  }, async ({ fileId, view, account }) => {
+    return runOrDiagnose(["drive", "get", fileId], {
+      account,
+      stripMedia: resolveView(view, ["compact", "full"]) === "compact"
+    });
   });
   server.registerTool("gog_drive_mkdir", {
     description: "Create a new folder in Google Drive.",
@@ -32526,7 +32650,7 @@ var failIfNotEmptyParam = external_exports.boolean().optional().describe(
 );
 
 // ../gogcli-mcp/src/server.ts
-var VERSION = true ? "2.28.0" : "0.0.0";
+var VERSION = true ? "2.29.0" : "0.0.0";
 
 // ../gogcli-mcp/src/auth-log.ts
 var FAILURES = /* @__PURE__ */ new Set([

package/manifest.json

@@ -3,7 +3,7 @@
   "manifest_version": "0.3",
   "name": "gogcli-mcp-drive",
   "display_name": "gogcli (Drive)",
-  "version": "2.28.0",
+  "version": "2.29.0",
   "description": "Extended Google Drive for Claude via gogcli — auth + full Drive support (upload, download, permissions, comments, shared drives)",
   "author": {
     "name": "Chris Hall",
@@ -91,11 +91,11 @@
     },
     {
       "name": "gog_drive_ls",
-      "description": "List files in a Google Drive folder (with pagination and query filters)"
+      "description": "List files in a Google Drive folder; compact by default (view=full for owners, parents and thumbnails), with pagination and query filters"
     },
     {
       "name": "gog_drive_search",
-      "description": "Full-text search across Drive"
+      "description": "Full-text search across Drive; compact by default (view=full for thumbnails)"
     },
     {
       "name": "gog_drive_extract_text",
@@ -107,7 +107,7 @@
     },
     {
       "name": "gog_drive_get",
-      "description": "Get file metadata"
+      "description": "Get file metadata; compact by default (view=full for thumbnails)"
     },
     {
       "name": "gog_drive_mkdir",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gogcli-mcp-drive",
-  "version": "2.28.0",
+  "version": "2.29.0",
   "mcpName": "io.github.chrischall/gogcli-mcp-drive",
   "description": "Extended Google Drive MCP server via gogcli — auth + full Drive support (upload/download/permissions/comments/shared drives)",
   "author": "Claude Code (AI) <https://www.anthropic.com/claude>",
@@ -24,7 +24,7 @@
     "test:coverage": "vitest run --coverage"
   },
   "dependencies": {
-    "@chrischall/mcp-utils": "^0.17.1",
+    "@chrischall/mcp-utils": "^0.23.0",
     "@modelcontextprotocol/sdk": "^1.30.0",
     "zod": "^4.4.3"
   },

package/server.json

@@ -7,12 +7,12 @@
     "source": "github",
     "subfolder": "packages/gogcli-mcp-drive"
   },
-  "version": "2.28.0",
+  "version": "2.29.0",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "gogcli-mcp-drive",
-      "version": "2.28.0",
+      "version": "2.29.0",
       "transport": {
         "type": "stdio"
       },