gogcli-mcp 2.27.1 → 2.29.0

package/dist/lib.js

@@ -23237,6 +23237,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 }] };
@@ -23325,7 +23396,7 @@ function activeExecutor() {
   return runExecutor.getStore() ?? defaultExecutor;
 }
 var TIMEOUT_MS = 3e4;
-var MIN_GOG_VERSION = "0.38.3";
+var MIN_GOG_VERSION = "0.39.0";
 function readonlyEnvEnabled() {
   return readEnvVar("GOG_READONLY") !== void 0 && parseBoolEnv("GOG_READONLY", { default: true });
 }
@@ -23698,11 +23769,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;
   }
@@ -23711,7 +23782,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;
@@ -23737,7 +23808,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));
 }
 
@@ -23915,10 +23986,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);
   }
@@ -24295,6 +24394,7 @@ function pushReminderFlags(args, p) {
   }
   for (const reminder of p.reminders) args.push(`--reminder=${reminder}`);
 }
+var CALENDAR_EVENTS_COMPACT_FIELDS = "nextPageToken,items(id,summary,start,end,location,status,htmlLink)";
 function registerCalendarTools(server) {
   server.registerTool("gog_calendar_events", {
     description: 'List calendar events. Describe the window ONE way and one way only (gog >= 0.36.0 rejects the rest as ambiguous rather than silently discarding a flag): today on its own; or from + to; or from + days; or days on its own (a window of that many days starting today). today cannot be combined with from, to or days, and days cannot be combined with to. gog returns only 10 events by default, so a wide date range is USUALLY INCOMPLETE: raise max, or page with pageToken until the response carries no nextPageToken. A response carrying "truncated": true is an incomplete view \u2014 never conclude an event does not exist from one.',
@@ -24317,9 +24417,12 @@ function registerCalendarTools(server) {
       all: external_exports.boolean().optional().describe('Fetch events from ALL CALENDARS. NOTE: unlike the gmail search tools, this does NOT mean "all pages" \u2014 it widens the calendar set, not the page window. Use pageToken to reach later pages.'),
       eventTypes: external_exports.array(external_exports.enum(["default", "birthday", "focus-time", "from-gmail", "out-of-office", "working-location"])).optional().describe("Filter to specific event types (repeatable)"),
       timezone: external_exports.string().optional().describe(`Display timezone for event times (IANA name, e.g. America/New_York, or "local" for the system timezone). Default: each event's timezone, then its calendar's timezone.`),
+      view: viewParam(["compact", "full"], {
+        note: "compact (the default) drops description and attendees \u2014 together two thirds of a listing's bytes \u2014 plus etag/iCalUID/kind. Ask for full when you need a body or a guest list."
+      }),
       account: accountParam
     }
-  }, async ({ calendarId, from, to, days, today, query, max, pageToken, page, all, eventTypes, timezone, account }) => {
+  }, async ({ calendarId, from, to, days, today, query, max, pageToken, page, all, eventTypes, timezone, view, account }) => {
     const args = ["calendar", "events"];
     if (calendarId) args.push(calendarId);
     if (from) args.push(`--from=${from}`);
@@ -24333,7 +24436,11 @@ function registerCalendarTools(server) {
     if (all) args.push("--all");
     if (eventTypes) for (const t of eventTypes) args.push(`--event-types=${t}`);
     if (timezone) args.push(`--timezone=${timezone}`);
-    const result = await runOrDiagnose(args, { account });
+    const rung = resolveView(view, ["compact", "full"]);
+    const result = await runOrDiagnose(args, {
+      account,
+      fieldsMask: rung === "compact" ? CALENDAR_EVENTS_COMPACT_FIELDS : void 0
+    });
     return annotateTruncatedList(result, "events");
   });
   server.registerTool("gog_calendar_get", {
@@ -24604,6 +24711,30 @@ function registerChatTools(server) {
     pushPaginationFlags(args, { max, pageToken, page, all });
     return runOrDiagnose(args, { account });
   });
+  server.registerTool("gog_chat_messages_search", {
+    description: 'Search Chat messages ACROSS every space and DM the account can see (gog >= 0.39.0) \u2014 the tool to reach for when the user asks "where did we discuss X" without naming a room, since gog_chat_messages_list needs a space up front. The query is Google Chat filter syntax, so it takes plain keywords or filters like sender, space, date, mention, unread, link and attachment. It is a search, NOT an export: Chat excludes some conversations (muted spaces among them), so an empty result does not prove a message never existed. view="full" adds each hit\'s read state and space mute setting; read state works on an ordinary chat grant, but the mute setting needs chat.users.spacesettings, which gog\'s chat scope set does NOT request (re-auth with extraScopes to get it). Missing metadata is OMITTED rather than defaulted, so an absent `read` means unknown while an explicit false means unread.' + workspaceOnlyNote,
+    annotations: { readOnlyHint: true },
+    inputSchema: {
+      query: external_exports.string().describe('Google Chat filter-syntax query \u2014 keywords, or filters such as "from:alice@example.com budget"'),
+      order: external_exports.enum(["create_time desc", "relevance desc"]).optional().describe(
+        `Sort order. NOTE the snake_case, which differs from gog_chat_messages_list's camelCase. "relevance desc" needs Google Developer Preview access and errors without it`
+      ),
+      view: external_exports.enum(["basic", "full"]).optional().describe(
+        'Result view (default "basic"). "full" also requests read state (covered by an ordinary chat grant) and space mute setting (needs chat.users.spacesettings, which that grant does not include)'
+      ),
+      markup: external_exports.enum(["chat", "markdown"]).optional().describe("Syntax to render each hit's formatted text in"),
+      ...paginationParams,
+      max: external_exports.number().int().min(1).max(100).optional().describe("Max results per page (1-100; Chat search caps a page at 100)"),
+      account: accountParam
+    }
+  }, async ({ query, order, view, markup, max, pageToken, page, all, account }) => {
+    const args = ["chat", "messages", "search", query];
+    if (order) args.push(`--order=${order}`);
+    if (view) args.push(`--view=${view}`);
+    if (markup) args.push(`--markup=${markup}`);
+    pushPaginationFlags(args, { max, pageToken, page, all });
+    return runOrDiagnose(args, { account });
+  });
   server.registerTool("gog_chat_messages_send", {
     description: "Post a message to a Chat space. THIS IS IMMEDIATELY VISIBLE TO EVERYONE IN THE SPACE and cannot be unsent through this tool, so treat it like sending mail, not like saving a draft. Pass `thread` to reply inside an existing conversation (from gog_chat_threads_list or a message's thread field); omit it to start a new one. Text supports Chat's markdown-ish formatting (*bold*, _italic_, `code`)." + workspaceOnlyNote,
     inputSchema: {
@@ -25242,6 +25373,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).",
@@ -25253,9 +25385,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}`);
@@ -25263,27 +25398,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.",
@@ -26016,7 +26172,7 @@ function registerTasksTools(server) {
 }
 
 // src/server.ts
-var VERSION = true ? "2.27.1" : "0.0.0";
+var VERSION = true ? "2.29.0" : "0.0.0";
 var BASE_TOOL_REGISTRARS = [
   registerApiTools,
   registerAppScriptTools,

package/manifest.json

@@ -3,7 +3,7 @@
   "manifest_version": "0.3",
   "name": "gogcli-mcp",
   "display_name": "gogcli",
-  "version": "2.27.1",
+  "version": "2.29.0",
   "description": "Google Sheets (and more) for Claude via gogcli — read, write, and manage spreadsheets",
   "author": {
     "name": "Chris Hall",
@@ -126,7 +126,7 @@
     },
     {
       "name": "gog_calendar_events",
-      "description": "List calendar events; paginated (gog returns only 10 by default) and flags a truncated range"
+      "description": "List calendar events; compact by default (view=full for descriptions and attendees), paginated and flags a truncated range"
     },
     {
       "name": "gog_calendar_get",
@@ -254,11 +254,11 @@
     },
     {
       "name": "gog_drive_ls",
-      "description": "List files in a Google Drive folder"
+      "description": "List files in a Google Drive folder; compact by default (view=full for owners, parents and thumbnails)"
     },
     {
       "name": "gog_drive_search",
-      "description": "Search Google Drive files"
+      "description": "Search Google Drive files; compact by default (view=full for thumbnails)"
     },
     {
       "name": "gog_drive_extract_text",
@@ -270,7 +270,7 @@
     },
     {
       "name": "gog_drive_get",
-      "description": "Get Google Drive file metadata"
+      "description": "Get Google Drive file metadata; compact by default (view=full for thumbnails)"
     },
     {
       "name": "gog_drive_mkdir",
@@ -452,6 +452,10 @@
       "name": "gog_chat_messages_list",
       "description": "Read messages in a space, with mentions and reaction summaries"
     },
+    {
+      "name": "gog_chat_messages_search",
+      "description": "Search Chat messages across every space and DM the account can see"
+    },
     {
       "name": "gog_chat_messages_send",
       "description": "Post a message to a Chat space (immediately visible; supports attachments)"

package/mint.yaml

@@ -86,7 +86,7 @@ dependencies:
   # nine pins too.
   - kind: github-release
     repo: openclaw/gogcli
-    tag: v0.38.3
+    tag: v0.39.0
     asset: "gogcli_*_linux_amd64.tar.gz"
     bin: [gog]
 state:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gogcli-mcp",
-  "version": "2.27.1",
+  "version": "2.29.0",
   "mcpName": "io.github.chrischall/gogcli-mcp",
   "description": "MCP server wrapping gogcli for Google service access",
   "author": "Claude Code (AI) <https://www.anthropic.com/claude>",
@@ -41,7 +41,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"
   },
-  "version": "2.27.1",
+  "version": "2.29.0",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "gogcli-mcp",
-      "version": "2.27.1",
+      "version": "2.29.0",
       "transport": {
         "type": "stdio"
       },

package/src/runner.ts

@@ -217,7 +217,7 @@ const TIMEOUT_MS = 30_000;
 // so the requirement change is surfaced in the release notes (see
 // .github/release.yml). This is the single source of truth for the required
 // version; keep the README/CLAUDE.md mention in sync.
-export const MIN_GOG_VERSION = '0.38.3';
+export const MIN_GOG_VERSION = '0.39.0';
 
 // Interpret the GOG_READONLY kill-switch. `readEnvVar` already treats blank
 // values, 'undefined'/'null' sentinels, and unresolved .mcpb placeholders

package/src/tools/calendar.ts

@@ -1,5 +1,6 @@
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { z } from 'zod';
+import { viewParam, resolveView } from '@chrischall/mcp-utils';
 import { accountParam, runOrDiagnose, registerRunTool, pageTokenParam, pageAliasParam, resolvePageToken } from './utils.js';
 import { annotateTruncatedList } from '../pagination.js';
 
@@ -53,6 +54,27 @@ function pushReminderFlags(
   for (const reminder of p.reminders) args.push(`--reminder=${reminder}`);
 }
 
+
+// The `compact` rung for gog_calendar_events, as a Google Calendar field mask.
+//
+// nextPageToken FIRST and always. This tool's own description tells a caller
+// that a wide range is usually incomplete and to page until the cursor is gone;
+// a mask of `items(...)` alone drops that cursor from the envelope, which would
+// turn that instruction into a guarantee of the wrong answer. Verified live
+// against gog 0.39.0.
+//
+// Chosen from the DATA over a 25-event window: description costs 5,951 bytes
+// and attendees 3,145 — the two fat blobs `full` exists to return — while etag,
+// kind, iCalUID, eventType, timezone, guestsCanInviteOthers and privateCopy are
+// internal or single-valued across every row. Net: 21,260 -> 7,292 bytes, 66%
+// smaller. status is kept despite being single-valued in that sample precisely
+// because its whole value is flagging the rare cancelled event.
+//
+// gog's derived fields (startLocal, endDayOfWeek, ...) survive the mask, since
+// gog computes them from start/end, which the mask keeps.
+export const CALENDAR_EVENTS_COMPACT_FIELDS =
+  'nextPageToken,items(id,summary,start,end,location,status,htmlLink)';
+
 export function registerCalendarTools(server: McpServer): void {
   server.registerTool('gog_calendar_events', {
     description: 'List calendar events. Describe the window ONE way and one way only (gog >= 0.36.0 rejects the rest as ambiguous rather than silently discarding a flag): '
@@ -78,9 +100,13 @@ export function registerCalendarTools(server: McpServer): void {
       all: z.boolean().optional().describe('Fetch events from ALL CALENDARS. NOTE: unlike the gmail search tools, this does NOT mean "all pages" — it widens the calendar set, not the page window. Use pageToken to reach later pages.'),
       eventTypes: z.array(z.enum(['default', 'birthday', 'focus-time', 'from-gmail', 'out-of-office', 'working-location'])).optional().describe('Filter to specific event types (repeatable)'),
       timezone: z.string().optional().describe('Display timezone for event times (IANA name, e.g. America/New_York, or "local" for the system timezone). Default: each event\'s timezone, then its calendar\'s timezone.'),
+      view: viewParam(['compact', 'full'], {
+        note: 'compact (the default) drops description and attendees — together two thirds of a '
+          + 'listing\'s bytes — plus etag/iCalUID/kind. Ask for full when you need a body or a guest list.',
+      }),
       account: accountParam,
     },
-  }, async ({ calendarId, from, to, days, today, query, max, pageToken, page, all, eventTypes, timezone, account }) => {
+  }, async ({ calendarId, from, to, days, today, query, max, pageToken, page, all, eventTypes, timezone, view, account }) => {
     const args = ['calendar', 'events'];
     if (calendarId) args.push(calendarId);
     if (from) args.push(`--from=${from}`);
@@ -94,7 +120,11 @@ export function registerCalendarTools(server: McpServer): void {
     if (all) args.push('--all');
     if (eventTypes) for (const t of eventTypes) args.push(`--event-types=${t}`);
     if (timezone) args.push(`--timezone=${timezone}`);
-    const result = await runOrDiagnose(args, { account });
+    const rung = resolveView(view, ['compact', 'full']);
+    const result = await runOrDiagnose(args, {
+      account,
+      fieldsMask: rung === 'compact' ? CALENDAR_EVENTS_COMPACT_FIELDS : undefined,
+    });
     // No count probe here: unlike Gmail's list endpoints, the Calendar API has
     // no cheap way to count a range exactly, so the warning carries the fact of
     // truncation without inventing a total.

package/src/tools/chat.ts

@@ -11,7 +11,7 @@ import type { GogArg } from '../runner.js';
 import { attachInlineParam, inlineAttachmentArgs } from '../attachments.js';
 
 // Google Chat (gog >= 0.38.0 for the mention/reaction metadata in
-// `messages list`; the rest of the surface is older).
+// `messages list`, >= 0.39.0 for `messages search`; the rest is older).
 //
 // TWO NAMING SYSTEMS MEET HERE, and mixing them is the mistake this module's
 // descriptions exist to prevent. Chat identifies everything by RESOURCE NAME —
@@ -135,6 +135,41 @@ export function registerChatTools(server: McpServer): void {
     return runOrDiagnose(args, { account });
   });
 
+  server.registerTool('gog_chat_messages_search', {
+    description:
+      'Search Chat messages ACROSS every space and DM the account can see (gog >= 0.39.0) — the tool to reach for when the '
+      + 'user asks "where did we discuss X" without naming a room, since gog_chat_messages_list needs a space up front. '
+      + 'The query is Google Chat filter syntax, so it takes plain keywords or filters like sender, space, date, mention, '
+      + 'unread, link and attachment. It is a search, NOT an export: Chat excludes some conversations (muted spaces among '
+      + 'them), so an empty result does not prove a message never existed. view="full" adds each hit\'s read state and space '
+      + 'mute setting; read state works on an ordinary chat grant, but the mute setting needs chat.users.spacesettings, '
+      + 'which gog\'s chat scope set does NOT request (re-auth with extraScopes to get it). Missing metadata is OMITTED '
+      + 'rather than defaulted, so an absent `read` means unknown while an explicit false means unread.' + workspaceOnlyNote,
+    annotations: { readOnlyHint: true },
+    inputSchema: {
+      query: z.string().describe('Google Chat filter-syntax query — keywords, or filters such as "from:alice@example.com budget"'),
+      order: z.enum(['create_time desc', 'relevance desc']).optional().describe(
+        'Sort order. NOTE the snake_case, which differs from gog_chat_messages_list\'s camelCase. "relevance desc" needs '
+        + 'Google Developer Preview access and errors without it',
+      ),
+      view: z.enum(['basic', 'full']).optional().describe(
+        'Result view (default "basic"). "full" also requests read state (covered by an ordinary chat grant) and space '
+        + 'mute setting (needs chat.users.spacesettings, which that grant does not include)',
+      ),
+      markup: z.enum(['chat', 'markdown']).optional().describe('Syntax to render each hit\'s formatted text in'),
+      ...paginationParams,
+      max: z.number().int().min(1).max(100).optional().describe('Max results per page (1-100; Chat search caps a page at 100)'),
+      account: accountParam,
+    },
+  }, async ({ query, order, view, markup, max, pageToken, page, all, account }) => {
+    const args = ['chat', 'messages', 'search', query];
+    if (order) args.push(`--order=${order}`);
+    if (view) args.push(`--view=${view}`);
+    if (markup) args.push(`--markup=${markup}`);
+    pushPaginationFlags(args, { max, pageToken, page, all });
+    return runOrDiagnose(args, { account });
+  });
+
   server.registerTool('gog_chat_messages_send', {
     description:
       'Post a message to a Chat space. THIS IS IMMEDIATELY VISIBLE TO EVERYONE IN THE SPACE and cannot be unsent through '

package/src/tools/drive.ts

@@ -1,7 +1,8 @@
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
 import { z } from 'zod';
-import { rawTextResult } from '@chrischall/mcp-utils';
+import { rawTextResult, viewParam, resolveView } from '@chrischall/mcp-utils';
+
 import { run, runBinary } from '../runner.js';
 import { accountParam, diagnose, runOrDiagnose, registerRunTool, pageTokenParam, pageAliasParam, resolvePageToken} from './utils.js';
 
@@ -18,6 +19,21 @@ function fileMeta(raw: string): { name?: string; mimeType?: string } {
   return { name: f.name, mimeType: f.mimeType };
 }
 
+
+// The `compact` rung for gog_drive_ls, as a Google Drive field mask.
+//
+// nextPageToken FIRST and always: a mask of `files(...)` alone drops the cursor
+// from the envelope, and a compact listing would then look complete when it was
+// one page of many. Verified live against gog 0.39.0.
+//
+// The dropped fields were chosen from the DATA, not from taste — measured over
+// a 25-row listing: thumbnailLink costs 4,998 bytes at ONE distinct value,
+// owners 1,400 at one, parents 900 at one, hasThumbnail 550 at one. Everything
+// kept below varies across rows. Net: 15,718 -> 8,095 bytes, 48% smaller.
+// A caller who needs an owner or a parent asks for view="full".
+export const DRIVE_LS_COMPACT_FIELDS =
+  'nextPageToken,files(id,name,mimeType,modifiedTime,size,webViewLink)';
+
 export function registerDriveTools(server: McpServer): void {
   server.registerTool('gog_drive_ls', {
     description: 'List files in a Google Drive folder (default: root).',
@@ -29,9 +45,13 @@ export function registerDriveTools(server: McpServer): void {
       page: pageAliasParam,
       query: z.string().optional().describe('Drive query filter (e.g. "name contains \'budget\'")'),
       allDrives: z.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 — '
+          + '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 !== undefined) args.push(`--max=${max}`);
@@ -39,7 +59,11 @@ export function registerDriveTools(server: McpServer): void {
     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 : undefined,
+    });
   });
 
   server.registerTool('gog_drive_search', {
@@ -47,10 +71,17 @@ export function registerDriveTools(server: McpServer): void {
     annotations: { readOnlyHint: true },
     inputSchema: {
       query: z.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 — 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', {
@@ -58,10 +89,20 @@ export function registerDriveTools(server: McpServer): void {
     annotations: { readOnlyHint: true },
     inputSchema: {
       fileId: z.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 — 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', {