gogcli-mcp 4.2.5 → 4.4.0

package/dist/lib.js

@@ -2001,8 +2001,8 @@ function emoji() {
 }
 var ipv4 = /^(?:(?:25[0-5]|2[0-4][0-9]|1[0-9][0-9]|[1-9][0-9]|[0-9])\.){3}(?:25[0-5]|2[0-4][0-9]|1[0-9][0-9]|[1-9][0-9]|[0-9])$/;
 var ipv6 = /^(([0-9a-fA-F]{1,4}:){7}[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,7}:|([0-9a-fA-F]{1,4}:){1,6}:[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,5}(:[0-9a-fA-F]{1,4}){1,2}|([0-9a-fA-F]{1,4}:){1,4}(:[0-9a-fA-F]{1,4}){1,3}|([0-9a-fA-F]{1,4}:){1,3}(:[0-9a-fA-F]{1,4}){1,4}|([0-9a-fA-F]{1,4}:){1,2}(:[0-9a-fA-F]{1,4}){1,5}|[0-9a-fA-F]{1,4}:((:[0-9a-fA-F]{1,4}){1,6})|:((:[0-9a-fA-F]{1,4}){1,7}|:))$/;
-var mac = (delimiter2) => {
-  const escapedDelim = escapeRegex(delimiter2 ?? ":");
+var mac = (delimiter3) => {
+  const escapedDelim = escapeRegex(delimiter3 ?? ":");
   return new RegExp(`^(?:[0-9A-F]{2}${escapedDelim}){5}[0-9A-F]{2}$|^(?:[0-9a-f]{2}${escapedDelim}){5}[0-9a-f]{2}$`);
 };
 var cidrv4 = /^((25[0-5]|2[0-4][0-9]|1[0-9][0-9]|[1-9][0-9]|[0-9])\.){3}(25[0-5]|2[0-4][0-9]|1[0-9][0-9]|[1-9][0-9]|[0-9])\/([0-9]|[1-2][0-9]|3[0-2])$/;
@@ -5030,7 +5030,7 @@ var recursive = /* @__PURE__ */ new WeakMap();
 var NONE = 0;
 var ASSUMED = 1;
 var PROVEN = 2;
-function isRecursive(inst, stack, resolve) {
+function isRecursive(inst, stack, resolve4) {
   const cached2 = recursive.get(inst);
   if (cached2 !== void 0)
     return cached2 ? PROVEN : NONE;
@@ -5040,7 +5040,7 @@ function isRecursive(inst, stack, resolve) {
   let result = NONE;
   const check2 = (child) => {
     if (result !== PROVEN && child?._zod) {
-      const answer = isRecursive(child, stack, resolve);
+      const answer = isRecursive(child, stack, resolve4);
       if (answer > result)
         result = answer;
     }
@@ -5051,7 +5051,7 @@ function isRecursive(inst, stack, resolve) {
       const desc = Object.getOwnPropertyDescriptor(sh, key);
       if (spread && !desc.enumerable)
         continue;
-      const child = desc.get ? ASSUMED : desc.value?._zod ? isRecursive(desc.value, stack, resolve) : NONE;
+      const child = desc.get ? ASSUMED : desc.value?._zod ? isRecursive(desc.value, stack, resolve4) : NONE;
       if (child > answer)
         answer = child;
     }
@@ -5115,7 +5115,7 @@ function isRecursive(inst, stack, resolve) {
       break;
     // `$ZodLazy` caches its inner on the def, so a resolved edge is followed exactly
     case "lazy": {
-      const inner = def._cachedInner ?? (resolve ? inst._zod.innerType : void 0);
+      const inner = def._cachedInner ?? (resolve4 ? inst._zod.innerType : void 0);
       merge2(inner ? isRecursive(inner, stack, false) : ASSUMED);
       break;
     }
@@ -23998,14 +23998,14 @@ function inputRequiredRoundsExceededMessage(method, maxRounds) {
   return `Multi-round-trip request '${method}' still required input after ${maxRounds} rounds (inputRequired.maxRounds)`;
 }
 function sleep(ms, signal) {
-  return new Promise((resolve, reject) => {
+  return new Promise((resolve4, reject) => {
     if (signal?.aborted) {
       reject(signal.reason instanceof SdkError ? signal.reason : new SdkError(SdkErrorCode.RequestTimeout, String(signal.reason)));
       return;
     }
     const timer = setTimeout(() => {
       signal?.removeEventListener("abort", onAbort);
-      resolve();
+      resolve4();
     }, ms);
     const onAbort = () => {
       clearTimeout(timer);
@@ -24796,7 +24796,7 @@ var Protocol = class {
     const flowStartedAt = Date.now();
     let onAbort;
     let cleanupMessageId;
-    return new Promise((resolve, reject) => {
+    return new Promise((resolve4, reject) => {
       const earlyReject = (error62) => {
         reject(error62);
       };
@@ -24864,7 +24864,7 @@ var Protocol = class {
         }
         if (decoded.kind === "invalid") return reject(decoded.error);
         if (decoded.kind === "input_required") {
-          if (options?.allowInputRequired === true) return resolve(manualInputRequiredValue(decoded));
+          if (options?.allowInputRequired === true) return resolve4(manualInputRequiredValue(decoded));
           const flow = {
             codec: codec2,
             request,
@@ -24876,11 +24876,11 @@ var Protocol = class {
               params
             }, resultSchema, legOptions)
           };
-          return resolve(this._resolveNonCompleteResult(decoded, flow));
+          return resolve4(this._resolveNonCompleteResult(decoded, flow));
         }
         const result = decoded.result;
         validateStandardSchema(resultSchema, result).then((parseResult) => {
-          if (parseResult.success) resolve(parseResult.data);
+          if (parseResult.success) resolve4(parseResult.data);
           else reject(new SdkError(SdkErrorCode.InvalidResult, `Invalid result for ${request.method}: ${parseResult.error}`));
         }, reject);
       });
@@ -27692,7 +27692,7 @@ var require_compile = /* @__PURE__ */ __commonJSMin(((exports) => {
     ref = (0, resolve_1.resolveUrl)(this.opts.uriResolver, baseId, ref);
     const schOrFunc = root.refs[ref];
     if (schOrFunc) return schOrFunc;
-    let _sch = resolve.call(this, root, ref);
+    let _sch = resolve4.call(this, root, ref);
     if (_sch === void 0) {
       const schema = (_a3 = root.localRefs) === null || _a3 === void 0 ? void 0 : _a3[ref];
       const { schemaId } = this.opts;
@@ -27718,7 +27718,7 @@ var require_compile = /* @__PURE__ */ __commonJSMin(((exports) => {
   function sameSchemaEnv(s1, s2) {
     return s1.schema === s2.schema && s1.root === s2.root && s1.baseId === s2.baseId;
   }
-  function resolve(root, ref) {
+  function resolve4(root, ref) {
     let sch;
     while (typeof (sch = this.refs[ref]) == "string") ref = sch;
     return sch || this.schemas[ref] || resolveSchema.call(this, root, ref);
@@ -28168,47 +28168,47 @@ var require_fast_uri = /* @__PURE__ */ __commonJSMin(((exports, module) => {
     else if (typeof uri === "object") uri = parse3(serialize(uri, options), options);
     return uri;
   }
-  function resolve(baseURI, relativeURI, options) {
+  function resolve4(baseURI, relativeURI, options) {
     const schemelessOptions = options ? Object.assign({ scheme: "null" }, options) : { scheme: "null" };
     const resolved = resolveComponent(parse3(baseURI, schemelessOptions), parse3(relativeURI, schemelessOptions), schemelessOptions, true);
     schemelessOptions.skipEscape = true;
     return serialize(resolved, schemelessOptions);
   }
-  function resolveComponent(base, relative, options, skipNormalization) {
+  function resolveComponent(base, relative3, options, skipNormalization) {
     const target = {};
     if (!skipNormalization) {
       base = parse3(serialize(base, options), options);
-      relative = parse3(serialize(relative, options), options);
+      relative3 = parse3(serialize(relative3, options), options);
     }
     options = options || {};
-    if (!options.tolerant && relative.scheme) {
-      target.scheme = relative.scheme;
-      target.userinfo = relative.userinfo;
-      target.host = relative.host;
-      target.port = relative.port;
-      target.path = removeDotSegments(relative.path || "");
-      target.query = relative.query;
+    if (!options.tolerant && relative3.scheme) {
+      target.scheme = relative3.scheme;
+      target.userinfo = relative3.userinfo;
+      target.host = relative3.host;
+      target.port = relative3.port;
+      target.path = removeDotSegments(relative3.path || "");
+      target.query = relative3.query;
     } else {
-      if (relative.userinfo !== void 0 || relative.host !== void 0 || relative.port !== void 0) {
-        target.userinfo = relative.userinfo;
-        target.host = relative.host;
-        target.port = relative.port;
-        target.path = removeDotSegments(relative.path || "");
-        target.query = relative.query;
+      if (relative3.userinfo !== void 0 || relative3.host !== void 0 || relative3.port !== void 0) {
+        target.userinfo = relative3.userinfo;
+        target.host = relative3.host;
+        target.port = relative3.port;
+        target.path = removeDotSegments(relative3.path || "");
+        target.query = relative3.query;
       } else {
-        if (!relative.path) {
+        if (!relative3.path) {
           target.path = base.path;
-          if (relative.query !== void 0) target.query = relative.query;
+          if (relative3.query !== void 0) target.query = relative3.query;
           else target.query = base.query;
         } else {
-          if (relative.path[0] === "/") target.path = removeDotSegments(relative.path);
+          if (relative3.path[0] === "/") target.path = removeDotSegments(relative3.path);
           else {
-            if ((base.userinfo !== void 0 || base.host !== void 0 || base.port !== void 0) && !base.path) target.path = "/" + relative.path;
-            else if (!base.path) target.path = relative.path;
-            else target.path = base.path.slice(0, base.path.lastIndexOf("/") + 1) + relative.path;
+            if ((base.userinfo !== void 0 || base.host !== void 0 || base.port !== void 0) && !base.path) target.path = "/" + relative3.path;
+            else if (!base.path) target.path = relative3.path;
+            else target.path = base.path.slice(0, base.path.lastIndexOf("/") + 1) + relative3.path;
             target.path = removeDotSegments(target.path);
           }
-          target.query = relative.query;
+          target.query = relative3.query;
         }
         target.userinfo = base.userinfo;
         target.host = base.host;
@@ -28216,7 +28216,7 @@ var require_fast_uri = /* @__PURE__ */ __commonJSMin(((exports, module) => {
       }
       target.scheme = base.scheme;
     }
-    target.fragment = relative.fragment;
+    target.fragment = relative3.fragment;
     return target;
   }
   function equal(uriA, uriB, options) {
@@ -28342,7 +28342,7 @@ var require_fast_uri = /* @__PURE__ */ __commonJSMin(((exports, module) => {
   const fastUri = {
     SCHEMES,
     normalize,
-    resolve,
+    resolve: resolve4,
     resolveComponent,
     equal,
     serialize,
@@ -29124,14 +29124,14 @@ var require_ucs2length = /* @__PURE__ */ __commonJSMin(((exports) => {
   function ucs2length(str) {
     const len = str.length;
     let length = 0;
-    let pos = 0;
+    let pos2 = 0;
     let value;
-    while (pos < len) {
+    while (pos2 < len) {
       length++;
-      value = str.charCodeAt(pos++);
-      if (value >= 55296 && value <= 56319 && pos < len) {
-        value = str.charCodeAt(pos);
-        if ((value & 64512) === 56320) pos++;
+      value = str.charCodeAt(pos2++);
+      if (value >= 55296 && value <= 56319 && pos2 < len) {
+        value = str.charCodeAt(pos2);
+        if ((value & 64512) === 56320) pos2++;
       }
     }
     return length;
@@ -32900,13 +32900,28 @@ var API_KEY_RE = new RegExp([
   "whsec_[A-Za-z0-9]{16,}\\b"
   // webhook signing secret (Stripe-style)
 ].map((p) => `\\b${p}`).join("|"), "g");
-var QUERY_SECRET_RE = /([?&](?:access_token|refresh_token|client_secret|api_?key|signature|token|key|sig)=)[^&#\s"'<>`]+/gi;
+var QUERY_SECRET_RE = /([?&](?:(?:access|refresh|id|auth|session|csrf|xsrf)[_-]?token|client[_-]?secret|api[_-]?secret|api[_-]?key|password|passwd|signature|token|key|sig)=)[^&#\s"'<>`]+/gi;
+var OAUTH_CODE_RE = /([?&]code=)(?=[^&#\s"'<>`]{16,})[^&#\s"'<>`]+/gi;
+var FORM_PASSWORD_RE = /((?:^|[\s,;:"'(\[{])(?:password|passwd)=)[^&#\s"'<>`]+/gim;
+var HEADER_SECRET_RE = /(\b(?:x[-_][a-z0-9_-]*?(?:api[-_]?key|token|secret|auth)[a-z0-9_-]*|api[-_]?key)\s*:\s*)[^\s,;"'<>`]+/gi;
 var AWS_SIGV4_RE = /([?&]X-Amz-(?:Signature|Security-Token|Credential)=)[^&#\s"'<>`]+/gi;
-var JSON_SECRET_KEYS = "access_token|refresh_token|client_secret|api_?key|password|passwd|secret|token";
-var JSON_SECRET_DQ_RE = new RegExp(`("(?:${JSON_SECRET_KEYS})"\\s*:\\s*")[^"]*(")`, "gi");
-var JSON_SECRET_SQ_RE = new RegExp(`('(?:${JSON_SECRET_KEYS})'\\s*:\\s*')[^']*(')`, "gi");
+var JSON_SECRET_KEYS = [
+  "(?:access|refresh|id|auth|session|bearer|csrf|xsrf)[_-]?token",
+  "client[_-]?secret",
+  "api[_-]?secret",
+  "(?:x[_-])?api[_-]?key",
+  "private[_-]?key",
+  "x[_-][a-z0-9_-]*?(?:api[_-]?key|token|secret|auth)[a-z0-9_-]*",
+  "(?:proxy-)?authorization",
+  "password",
+  "passwd",
+  "secret",
+  "token"
+].join("|");
+var JSON_SECRET_DQ_RE = new RegExp(`("(?:${JSON_SECRET_KEYS})"\\s*:\\s*")(?:[^"\\\\]|\\\\.)*(")`, "gi");
+var JSON_SECRET_SQ_RE = new RegExp(`('(?:${JSON_SECRET_KEYS})'\\s*:\\s*')(?:[^'\\\\]|\\\\.)*(')`, "gi");
 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]");
+  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(HEADER_SECRET_RE, "$1[REDACTED]").replace(QUERY_SECRET_RE, "$1[REDACTED]").replace(OAUTH_CODE_RE, "$1[REDACTED]").replace(FORM_PASSWORD_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
@@ -33001,26 +33016,105 @@ function errorResult(message) {
 }
 
 // ../../node_modules/@chrischall/mcp-utils/dist/server/confirmation.js
+import { createHash, createHmac, timingSafeEqual } from "node:crypto";
 var DEFAULT_REQUEST_KEY = "confirmation";
 var DEFAULT_CONFIRMATION_LABEL = "Confirm this action should proceed.";
 var UNSUPPORTED_NOTE = "Nothing was done because this client cannot show a confirmation prompt (it declares no MCP elicitation capability), and this action is never taken without one";
+var STATE_PREFIX = "mcpu.confirm.v1.";
+function canonicalJson(value) {
+  if (value === null || typeof value === "string" || typeof value === "boolean")
+    return JSON.stringify(value);
+  if (value === void 0)
+    return "null";
+  if (typeof value === "number")
+    return Number.isFinite(value) ? JSON.stringify(value) : `{"$num":"${String(value)}"}`;
+  if (typeof value === "bigint")
+    return `{"$bigint":"${value.toString()}"}`;
+  if (typeof value === "function" || typeof value === "symbol") {
+    throw new TypeError(`requireConfirmation: cannot bind a ${typeof value} argument value.`);
+  }
+  if (Array.isArray(value))
+    return `[${value.map(canonicalJson).join(",")}]`;
+  if (value instanceof Date) {
+    return `{"$date":${JSON.stringify(Number.isNaN(value.getTime()) ? "Invalid Date" : value.toISOString())}}`;
+  }
+  if (ArrayBuffer.isView(value)) {
+    const bytes = Buffer.from(value.buffer, value.byteOffset, value.byteLength);
+    return `{"$bytes":${JSON.stringify(bytes.toString("base64"))}}`;
+  }
+  if (value instanceof ArrayBuffer)
+    return `{"$bytes":${JSON.stringify(Buffer.from(value).toString("base64"))}}`;
+  if (value instanceof Map) {
+    const entries2 = [...value.entries()].map(([k, v]) => `[${canonicalJson(k)},${canonicalJson(v)}]`).sort();
+    return `{"$map":[${entries2.join(",")}]}`;
+  }
+  if (value instanceof Set) {
+    return `{"$set":[${[...value].map(canonicalJson).sort().join(",")}]}`;
+  }
+  const proto = Object.getPrototypeOf(value);
+  if (proto !== Object.prototype && proto !== null) {
+    throw new TypeError("requireConfirmation: cannot bind a non-plain object argument value (class instance).");
+  }
+  const entries = Object.entries(value).filter(([, v]) => v !== void 0).sort(([a], [b]) => a < b ? -1 : a > b ? 1 : 0);
+  return `{${entries.map(([k, v]) => `${JSON.stringify(escapeKey(k))}:${canonicalJson(v)}`).join(",")}}`;
+}
+function escapeKey(key) {
+  return key.startsWith("$") ? `$${key}` : key;
+}
+function bindingKey(binding) {
+  if (binding.ttlSeconds !== void 0 && !(Number.isFinite(binding.ttlSeconds) && binding.ttlSeconds > 0)) {
+    throw new RangeError("requireConfirmation: binding.ttlSeconds must be a finite number greater than 0.");
+  }
+  const key = typeof binding.key === "string" ? Buffer.from(binding.key, "utf8") : Buffer.from(binding.key);
+  if (key.length < 32) {
+    throw new RangeError("requireConfirmation: binding.key must be at least 32 bytes.");
+  }
+  return key;
+}
+function commitment(action, args) {
+  return createHash("sha256").update(`${action}\0${canonicalJson(args)}`).digest("base64url");
+}
+function mintState(key, action, binding) {
+  const exp = Math.floor(Date.now() / 1e3) + (binding.ttlSeconds ?? 600);
+  const body = Buffer.from(JSON.stringify({ c: commitment(action, binding.args), exp })).toString("base64url");
+  const mac3 = createHmac("sha256", key).update(`${STATE_PREFIX}${body}`).digest("base64url");
+  return `${STATE_PREFIX}${body}.${mac3}`;
+}
+function verifyState(key, action, binding, state) {
+  if (typeof state !== "string" || !state.startsWith(STATE_PREFIX))
+    return false;
+  const rest = state.slice(STATE_PREFIX.length);
+  const dot = rest.indexOf(".");
+  if (dot < 0)
+    return false;
+  const body = rest.slice(0, dot);
+  const mac3 = Buffer.from(rest.slice(dot + 1), "base64url");
+  const expected = createHmac("sha256", key).update(`${STATE_PREFIX}${body}`).digest();
+  if (mac3.length !== expected.length || !timingSafeEqual(mac3, expected))
+    return false;
+  let payload;
+  try {
+    payload = JSON.parse(Buffer.from(body, "base64url").toString("utf8"));
+  } catch {
+    return false;
+  }
+  if (typeof payload.exp !== "number" || payload.exp * 1e3 <= Date.now())
+    return false;
+  const want = Buffer.from(commitment(action, binding.args));
+  const got = Buffer.from(typeof payload.c === "string" ? payload.c : "");
+  return got.length === want.length && timingSafeEqual(got, want);
+}
+function echoedState(ctx) {
+  const accessor = ctx.mcpReq.requestState;
+  return typeof accessor === "function" ? accessor() : void 0;
+}
 function requireConfirmation(ctx, options) {
   const requestKey = options.requestKey ?? DEFAULT_REQUEST_KEY;
+  const key = options.binding ? bindingKey(options.binding) : void 0;
   const confirmationSchema = external_exports.object({
     confirmed: external_exports.boolean().describe(options.confirmationLabel ?? DEFAULT_CONFIRMATION_LABEL)
   });
-  const response = inputResponse(ctx.mcpReq.inputResponses, requestKey);
-  const accepted = acceptedContent(ctx.mcpReq.inputResponses, requestKey, confirmationSchema);
-  if (response.kind === "missing") {
-    if (callerAcceptsFormElicitation(ctx) === false) {
-      return textResult({
-        confirmed: false,
-        dispatched: false,
-        action: options.action,
-        reason: "confirmation-unsupported",
-        note: options.unsupportedNote ? `${UNSUPPORTED_NOTE}. ${options.unsupportedNote}` : `${UNSUPPORTED_NOTE}.`
-      });
-    }
+  const ask = () => {
     const preview = {
       action: options.action,
       ...options.details === void 0 ? {} : { details: options.details }
@@ -33032,10 +33126,33 @@ function requireConfirmation(ctx, options) {
 ${JSON.stringify(preview, null, 2)}`,
           requestedSchema: confirmationSchema
         })
-      }
+      },
+      ...key && options.binding ? { requestState: mintState(key, options.action, options.binding) } : {}
     });
+  };
+  const response = inputResponse(ctx.mcpReq.inputResponses, requestKey);
+  const accepted = acceptedContent(ctx.mcpReq.inputResponses, requestKey, confirmationSchema);
+  if (response.kind === "missing") {
+    if (callerAcceptsFormElicitation(ctx) === false) {
+      return textResult({
+        confirmed: false,
+        dispatched: false,
+        action: options.action,
+        reason: "confirmation-unsupported",
+        note: options.unsupportedNote ? `${UNSUPPORTED_NOTE}. ${options.unsupportedNote}` : `${UNSUPPORTED_NOTE}.`
+      });
+    }
+    return ask();
   }
   if (response.kind === "elicit" && response.action === "accept" && accepted?.confirmed === true) {
+    if (key && options.binding) {
+      const state = echoedState(ctx);
+      if (state === void 0 || state === null) {
+        return errorResult(`Confirmation for ${options.action} was accepted, but the retry carried no requestState, so it cannot be checked against the prompt that was shown. Nothing was done. The likely cause is that the MCP client or host does not round-trip requestState (it must echo the requestState from the input_required result back on the retry); asking again would loop.`);
+      }
+      if (!verifyState(key, options.action, options.binding, state))
+        return ask();
+    }
     return void 0;
   }
   return textResult({
@@ -33053,6 +33170,8 @@ var SERVER_PROTOCOL_VERSIONS = Object.freeze([
 ]);
 
 // ../../node_modules/@chrischall/mcp-utils/dist/config/index.js
+import { homedir } from "node:os";
+import { isAbsolute, join, resolve } from "node:path";
 var PLACEHOLDER_RE = /^\$\{[^}]*\}$/;
 function readEnvVar(key, opts = {}) {
   const env = opts.env ?? process.env;
@@ -33079,6 +33198,50 @@ function parseBoolEnv(key, opts = {}) {
     return false;
   return fallback;
 }
+function expandPath(p) {
+  let expanded = p;
+  if (p === "~") {
+    expanded = homedir();
+  } else if (p.startsWith("~/")) {
+    expanded = join(homedir(), p.slice(2));
+  }
+  return isAbsolute(expanded) ? expanded : resolve(expanded);
+}
+
+// ../../node_modules/@chrischall/mcp-utils/dist/fs/confine.js
+import { existsSync, realpathSync } from "node:fs";
+import { dirname, isAbsolute as isAbsolute2, relative, resolve as resolve2, sep } from "node:path";
+function isInside(root, target) {
+  const rel = relative(root, target);
+  return rel === "" || !rel.startsWith(`..${sep}`) && rel !== ".." && !isAbsolute2(rel);
+}
+function realPathAllowingMissing(p) {
+  const abs = resolve2(p);
+  let existing = abs;
+  const tail = [];
+  while (!existsSync(existing)) {
+    const parent = dirname(existing);
+    if (parent === existing)
+      break;
+    tail.unshift(existing.slice(parent.length).replace(/^[/\\]+/, ""));
+    existing = parent;
+  }
+  let real;
+  try {
+    real = realpathSync(existing);
+  } catch {
+    real = existing;
+  }
+  return tail.length > 0 ? resolve2(real, ...tail) : real;
+}
+function assertPathWithinRoots(path, roots) {
+  const target = realPathAllowingMissing(expandPath(path));
+  for (const root of roots) {
+    if (isInside(realPathAllowingMissing(expandPath(root)), target))
+      return target;
+  }
+  throw new Error(`Path is outside the allowed directories: ${path}`);
+}
 
 // ../../node_modules/@chrischall/mcp-utils/dist/zod/index.js
 var PositiveInt = external_exports.number().int().positive();
@@ -33100,7 +33263,7 @@ var pageSchema = {
 };
 
 // src/runner.ts
-import { delimiter, join } from "node:path";
+import { delimiter, join as join2 } from "node:path";
 
 // src/timestamps.ts
 var DEFAULT_DISPLAY_TZ = "America/New_York";
@@ -33126,9 +33289,9 @@ function offsetAt(instant, tz) {
   const w = wallPartsIn(instant, tz);
   const asUTC = Date.UTC(w.year, w.month - 1, w.day, w.hour, w.minute, w.second, instant.getUTCMilliseconds());
   const minutes = Math.round((asUTC - instant.getTime()) / 6e4);
-  const sign2 = minutes < 0 ? "-" : "+";
+  const sign3 = minutes < 0 ? "-" : "+";
   const abs = Math.abs(minutes);
-  return `${sign2}${pad(Math.floor(abs / 60))}:${pad(abs % 60)}`;
+  return `${sign3}${pad(Math.floor(abs / 60))}:${pad(abs % 60)}`;
 }
 function wallPartsIn(instant, tz) {
   const parts = new Intl.DateTimeFormat("en-US", {
@@ -33301,9 +33464,48 @@ function normalizeTimestamps(text, tz = displayTimeZone(), naiveTz = naiveSource
   return JSON.stringify(parsed, null, detectIndent(text));
 }
 
+// src/arg-guard.ts
+var FORBIDDEN_LONG_FLAG = /^--(readonly|enable-commands|enable-commands-exact|disable-commands|access-token|home|account|acct|client|gmail-no-send|no-input|non-interactive|noninteractive)(=|$)/i;
+var SHORT_ACCOUNT_CLUSTER = /^-(?!-)[A-Za-z]*a/;
+function forbiddenArgReason(arg) {
+  if (arg === "--") {
+    return 'The argument "--" is not allowed: it ends flag parsing and would disable safety flags appended after it.';
+  }
+  const match = FORBIDDEN_LONG_FLAG.exec(arg);
+  if (match) {
+    return `The flag ${arg} is not allowed here: --${match[1].toLowerCase()} is a safety/credential control set by the server operator, not a per-call option.`;
+  }
+  if (SHORT_ACCOUNT_CLUSTER.test(arg)) {
+    return `The flag ${arg} is not allowed here: -a selects the account. Use the tool's account parameter instead.`;
+  }
+  return void 0;
+}
+function assertSafeForwardedArgs(args) {
+  for (const arg of args) {
+    const reason = forbiddenArgReason(arg);
+    if (reason) throw new Error(reason);
+  }
+}
+var SUBCOMMAND_SHAPE = /^[a-z][a-z0-9-]*$/;
+function assertSafeSubcommand(subcommand) {
+  if (!SUBCOMMAND_SHAPE.test(subcommand)) {
+    throw new Error(
+      `Invalid subcommand ${JSON.stringify(subcommand)}: pass a single gog subcommand name such as "list" or "mark-read", and put its arguments in args.`
+    );
+  }
+}
+
+// src/argv.ts
+function pos(value) {
+  return { kind: "positional", value };
+}
+function isGogPositional(arg) {
+  return typeof arg === "object" && arg !== null && arg.kind === "positional";
+}
+
 // src/runner.ts
 function isGogFileArg(arg) {
-  return typeof arg !== "string";
+  return typeof arg !== "string" && arg.kind === "file";
 }
 var TIMEOUT_MS = 3e4;
 var MIN_GOG_VERSION = "0.41.0";
@@ -33388,8 +33590,8 @@ function formatTimeout(ms) {
 }
 async function spawnWithTempFiles(args, opts) {
   const { mkdtemp, mkdir, writeFile, rm } = await import("node:fs/promises");
-  const { tmpdir } = await import("node:os");
-  const dir = await mkdtemp(join(tmpdir(), "gogcli-mcp-"));
+  const { tmpdir: tmpdir2 } = await import("node:os");
+  const dir = await mkdtemp(join2(tmpdir2(), "gogcli-mcp-"));
   try {
     const argv = [];
     let seq = 0;
@@ -33398,10 +33600,10 @@ async function spawnWithTempFiles(args, opts) {
         argv.push(arg);
         continue;
       }
-      const sub = join(dir, String(seq));
+      const sub = join2(dir, String(seq));
       seq += 1;
       await mkdir(sub, { recursive: true, mode: 448 });
-      const path = join(sub, arg.filename ?? `${arg.flag}.${arg.ext ?? "txt"}`);
+      const path = join2(sub, arg.filename ?? `${arg.flag}.${arg.ext ?? "txt"}`);
       const data = arg.encoding === "base64" ? Buffer.from(arg.contents, "base64") : Buffer.from(arg.contents, "utf8");
       await writeFile(path, data, { mode: 384 });
       argv.push(arg.positional ? path : `--${arg.flag}=${path}`);
@@ -33419,10 +33621,10 @@ function spawnExecutor(args, opts) {
   return spawnGog(args, opts);
 }
 async function spawnGog(fullArgs, opts) {
-  const { timeout, interactive = false, spawner, binary = false } = opts;
+  const { timeout, interactive = false, spawner, binary = false, maxOutputBytes } = opts;
   const spawn = spawner ?? (await import("node:child_process")).spawn;
   const effectiveTimeout = timeout ?? TIMEOUT_MS;
-  return new Promise((resolve, reject) => {
+  return new Promise((resolve4, reject) => {
     const childEnv = { ...sanitizedEnv(), GOG_TIMEZONE: naiveSourceTimeZone(), PATH: augmentedPath() };
     const child = spawn(readEnvVar("GOG_PATH") ?? "gog", fullArgs, { env: childEnv });
     const stdoutChunks = [];
@@ -33440,7 +33642,17 @@ async function spawnGog(fullArgs, opts) {
       child.kill();
       reject(new Error(`gog timed out after ${formatTimeout(effectiveTimeout)}`));
     }, effectiveTimeout);
+    let stdoutBytes = 0;
     child.stdout.on("data", (chunk) => {
+      if (settled) return;
+      stdoutBytes += chunk.length;
+      if (maxOutputBytes !== void 0 && stdoutBytes > maxOutputBytes) {
+        settled = true;
+        stopWatching();
+        child.kill();
+        reject(new Error(`gog output exceeded the limit: more than ${maxOutputBytes} bytes`));
+        return;
+      }
       stdoutChunks.push(chunk);
     });
     child.stderr.on("data", (chunk) => {
@@ -33457,14 +33669,14 @@ async function spawnGog(fullArgs, opts) {
       const stderr = Buffer.concat(stderrChunks).toString().trim();
       if (code === 0) {
         if (binary) {
-          resolve(Buffer.concat(stdoutChunks).toString("base64"));
+          resolve4(Buffer.concat(stdoutChunks).toString("base64"));
           return;
         }
         const stdout = Buffer.concat(stdoutChunks).toString();
         if (interactive && stderr) {
-          resolve(stdout + "\n" + stderr);
+          resolve4(stdout + "\n" + stderr);
         } else {
-          resolve(stdout);
+          resolve4(stdout);
         }
       } else {
         reject(new Error(stderr || `gog exited with code ${code}`));
@@ -33484,7 +33696,33 @@ async function spawnGog(fullArgs, opts) {
     });
   });
 }
+function placePositionals(args) {
+  const flags = [];
+  const positionals = [];
+  let afterSeparator = false;
+  for (const arg of args) {
+    if (arg === "--") {
+      afterSeparator = true;
+    } else if (isGogPositional(arg)) {
+      positionals.push(arg.value);
+    } else if (afterSeparator || isGogFileArg(arg) && arg.positional) {
+      positionals.push(arg);
+    } else {
+      flags.push(arg);
+    }
+  }
+  return { flags, positionals };
+}
+function assertNoSafetyOverrides(flags) {
+  for (const arg of flags) {
+    if (typeof arg !== "string") continue;
+    const reason = forbiddenArgReason(arg);
+    if (reason) throw new Error(reason);
+  }
+}
 function assembleArgs(args, opts) {
+  const { flags, positionals } = placePositionals(args);
+  assertNoSafetyOverrides(flags);
   const effectiveAccount = opts.account ?? readEnvVar("GOG_ACCOUNT");
   const fullArgs = ["--json", "--color=never"];
   if (!opts.interactive) {
@@ -33493,17 +33731,21 @@ function assembleArgs(args, opts) {
   if (opts.readonly || readonlyEnvEnabled()) {
     fullArgs.push("--readonly");
   }
+  if (opts.gmailNoSend) {
+    fullArgs.push("--gmail-no-send");
+  }
   if (effectiveAccount) {
     fullArgs.push("--account", effectiveAccount);
   }
-  fullArgs.push(...args);
+  fullArgs.push(...flags);
+  if (positionals.length > 0) fullArgs.push("--", ...positionals);
   return fullArgs;
 }
 async function run(args, options = {}) {
-  const { account, spawner, interactive = false, timeout, readonly: readonly2 = false, redactMode = "full", opaqueFields } = options;
+  const { account, spawner, interactive = false, timeout, readonly: readonly2 = false, redactMode = "full", opaqueFields, gmailNoSend = false } = options;
   const base = redactMode === "tokens" ? redactGoogleTokens : redactSecrets2;
   const redact = opaqueFields?.length ? (text) => redactPreservingOpaqueFields(text, opaqueFields, base) : base;
-  const fullArgs = assembleArgs(args, { account, interactive, readonly: readonly2 });
+  const fullArgs = assembleArgs(args, { account, interactive, readonly: readonly2, gmailNoSend });
   try {
     return redact(await spawnExecutor(fullArgs, { timeout, interactive, spawner }));
   } catch (err) {
@@ -33511,9 +33753,9 @@ async function run(args, options = {}) {
   }
 }
 async function runBinary(args, options = {}) {
-  const { account, spawner, timeout, readonly: readonly2 = false } = options;
-  const fullArgs = assembleArgs(args, { account, interactive: false, readonly: readonly2 });
-  return spawnExecutor(fullArgs, { timeout, interactive: false, spawner, binary: true });
+  const { account, spawner, timeout, readonly: readonly2 = false, gmailNoSend = false, maxOutputBytes } = options;
+  const fullArgs = assembleArgs(args, { account, interactive: false, readonly: readonly2, gmailNoSend });
+  return spawnExecutor(fullArgs, { timeout, interactive: false, spawner, binary: true, maxOutputBytes });
 }
 
 // src/pagination.ts
@@ -33565,6 +33807,175 @@ function annotateTruncatedList(result, itemsKey) {
   return rawTextResult(JSON.stringify(out));
 }
 
+// src/file-roots.ts
+import { homedir as homedir2 } from "node:os";
+import { delimiter as delimiter2, join as join4 } from "node:path";
+
+// src/attachment-root.ts
+import { tmpdir, userInfo } from "node:os";
+import { dirname as dirname2, join as join3, relative as relative2, resolve as resolve3, isAbsolute as isAbsolute3, sep as sep2 } from "node:path";
+var ATTACHMENT_DOWNLOAD_ROOT = join3(tmpdir(), `gogcli-mcp-attachments-${userInfo().uid}`);
+var ATTACHMENT_TTL_MS = 24 * 60 * 60 * 1e3;
+function isInside2(root, target) {
+  const rel = relative2(root, target);
+  return rel !== "" && !rel.startsWith(`..${sep2}`) && rel !== ".." && !isAbsolute3(rel);
+}
+async function ensurePrivateDir(dir, opts = {}) {
+  const { mkdir, lstat, chmod } = await import("node:fs/promises");
+  try {
+    await mkdir(dir, { mode: 448 });
+  } catch (err) {
+    if (err.code !== "EEXIST") throw err;
+  }
+  const info = await lstat(dir);
+  if (info.isSymbolicLink() || !info.isDirectory()) {
+    throw new Error(`refusing to use ${dir} for attachment downloads: it is not a real directory`);
+  }
+  const uid = opts.uid ?? userInfo().uid;
+  if (info.uid !== uid) {
+    throw new Error(`refusing to use ${dir} for attachment downloads: it is owned by another user`);
+  }
+  if ((info.mode & 63) !== 0) await chmod(dir, 448);
+}
+async function sweepExpiredDownloads(root = ATTACHMENT_DOWNLOAD_ROOT, ttlMs = ATTACHMENT_TTL_MS, now = Date.now()) {
+  const { readdir, lstat, rm } = await import("node:fs/promises");
+  let entries;
+  try {
+    entries = await readdir(root);
+  } catch {
+    return 0;
+  }
+  let removed = 0;
+  for (const name of entries) {
+    const path = join3(root, name);
+    try {
+      const info = await lstat(path);
+      if (now - info.mtimeMs > ttlMs) {
+        await rm(path, { recursive: true, force: true });
+        removed += 1;
+      }
+    } catch {
+    }
+  }
+  return removed;
+}
+async function removeDownload(path, root = ATTACHMENT_DOWNLOAD_ROOT) {
+  const { rm, rmdir } = await import("node:fs/promises");
+  const base = resolve3(root);
+  const target = resolve3(base, path);
+  if (!isInside2(base, target)) return;
+  await rm(target, { force: true });
+  for (let dir = dirname2(target); isInside2(base, dir); dir = dirname2(dir)) {
+    try {
+      await rmdir(dir);
+    } catch {
+      break;
+    }
+  }
+}
+async function prepareDownloadRoot(root = ATTACHMENT_DOWNLOAD_ROOT) {
+  await ensurePrivateDir(root);
+  await sweepExpiredDownloads(root);
+}
+
+// src/file-roots.ts
+var FILE_ROOTS_ENV = "GOG_FILE_ROOTS";
+function defaultFileRoot() {
+  return join4(homedir2(), "gogcli-mcp-files");
+}
+function fileRoots() {
+  const raw = readEnvVar(FILE_ROOTS_ENV);
+  const roots = (raw ?? "").split(delimiter2).map((r) => r.trim()).filter(Boolean);
+  return roots.length > 0 ? roots : [defaultFileRoot()];
+}
+function confinePath(path, param, opts = {}) {
+  if (opts.allowDash && path === "-") return path;
+  const roots = [...fileRoots(), ATTACHMENT_DOWNLOAD_ROOT];
+  try {
+    assertPathWithinRoots(path, roots);
+  } catch {
+    throw new Error(
+      `${param} ${JSON.stringify(path)} is outside the directories this server may read or write (${roots.join(", ")}). Put the file in one of them, or ask the server operator to widen ${FILE_ROOTS_ENV}.`
+    );
+  }
+  return path;
+}
+function confinePaths(paths, param) {
+  for (const path of paths ?? []) confinePath(path, param);
+}
+function confineAtFile(value, param) {
+  if (value.startsWith("@")) confinePath(value.slice(1), param);
+  return value;
+}
+
+// src/run-path-guard.ts
+var POSITIONAL_PATH_SUBCOMMANDS = {
+  appscript: { pull: "gog_appscript_pull" },
+  drive: { upload: "gog_drive_upload", sync: "gog_drive_sync_push" },
+  gmail: { import: "gog_gmail_import" },
+  slides: {
+    "add-slide": "gog_slides_add_slide",
+    "insert-image": "gog_slides_insert_image",
+    "replace-slide": "gog_slides_replace_slide"
+  }
+};
+var PATH_FLAGS = /* @__PURE__ */ new Set(["out", "output", "out-dir", "output-dir", "dir", "worker-dir", "attach", "file", "key", "cert", "replacements"]);
+var ID_FLAGS = {
+  drive: /* @__PURE__ */ new Set(["file", "filter-file"])
+};
+var EXEC_FLAGS = /* @__PURE__ */ new Set(["on-change", "on-new", "mmdc"]);
+var SHORT_PATH_CLUSTER = /^-(?!-)[A-Za-z]*[of]/;
+var LONG_FLAG = /^--([A-Za-z0-9][A-Za-z0-9-]*)(?:=([\s\S]*))?$/;
+function isPathFlag(service, name) {
+  if (ID_FLAGS[service]?.has(name)) return false;
+  return PATH_FLAGS.has(name) || name.endsWith("-file");
+}
+function confineFlagValue(flag, value) {
+  if (value === "-") return;
+  confinePath(value, flag);
+  for (const part of value.split(",")) {
+    if (part !== "" && part !== "-") confinePath(part, flag);
+  }
+}
+function positionalPathTool(service, subcommand) {
+  return POSITIONAL_PATH_SUBCOMMANDS[service]?.[subcommand];
+}
+function assertRunPathsConfined(service, subcommand, args) {
+  const dedicated = positionalPathTool(service, subcommand);
+  if (dedicated) {
+    throw new Error(
+      `gog ${service} ${subcommand} reads or writes a local path given as a positional argument, so it is not available through gog_${service}_run. Use ${dedicated}, which confines the path to GOG_FILE_ROOTS.`
+    );
+  }
+  for (let i = 0; i < args.length; i++) {
+    const arg = args[i];
+    if (SHORT_PATH_CLUSTER.test(arg)) {
+      throw new Error(
+        `The flag ${arg} is not allowed here: spell a path flag out as --out or --file (e.g. --out=<path>) so its path can be checked against GOG_FILE_ROOTS.`
+      );
+    }
+    const match = LONG_FLAG.exec(arg);
+    if (!match) continue;
+    const name = match[1].toLowerCase();
+    if (EXEC_FLAGS.has(name)) {
+      throw new Error(`The flag --${name} is not allowed here: it runs a local program chosen by the caller.`);
+    }
+    const isJson = name.endsWith("-json");
+    if (!isJson && !isPathFlag(service, name)) continue;
+    let value = match[2];
+    if (value === void 0) {
+      value = args[i + 1];
+      if (value === void 0) continue;
+      i++;
+    }
+    if (isJson) {
+      if (value.startsWith("@")) confineFlagValue(`--${name}`, value.slice(1));
+      continue;
+    }
+    confineFlagValue(`--${name}`, value);
+  }
+}
+
 // src/tools/utils.ts
 var PAYLOAD_INLINE_MAX = 4096;
 function payloadArg(inlineFlag, fileFlag, value, ext) {
@@ -33622,9 +34033,17 @@ function pushPaginationFlags(args, p) {
   if (p.all) args.push("--all");
 }
 function registerRunTool(server, options) {
-  const { service, examples, omitAccount = false, note } = options;
+  const { service, examples, omitAccount = false, note, allowedSubcommands, vet, gmailNoSend = false } = options;
+  for (const [, example] of examples.matchAll(/"([^"]+)"/g)) {
+    const refused = allowedSubcommands && !allowedSubcommands.includes(example) || vet?.(example, []) || positionalPathTool(service, example);
+    if (refused) {
+      throw new Error(`gog_${service}_run example "${example}" is refused by the tool itself; list a subcommand it runs.`);
+    }
+  }
   const baseDescription = `Run any gog ${service} subcommand not covered by the other tools. Run \`gog ${service} --help\` for the full list of subcommands, or \`gog ${service} <subcommand> --help\` for flags on a specific subcommand.`;
-  const description = note ? `${baseDescription} ${note}` : baseDescription;
+  const restriction = allowedSubcommands ? ` Only these subcommands are available: ${allowedSubcommands.join(", ")}.` : "";
+  const safety = ' Flags that override server safety controls (--readonly, --enable-commands, --disable-commands, --account, --access-token, --home, --client, --gmail-no-send, --no-input) and a bare "--" are refused. Local file paths (--out, --out-dir, --attach, --file, --*-file, @file JSON) must be inside GOG_FILE_ROOTS; subcommands that take a local path positionally (e.g. drive upload) are refused in favour of their dedicated tools.';
+  const description = `${baseDescription}${restriction}${safety}${note ? ` ${note}` : ""}`;
   const inputSchema = {
     subcommand: external_exports.string().describe(`The gog ${service} subcommand to run, e.g. ${examples}`),
     args: external_exports.array(external_exports.string()).describe("Additional positional args and flags")
@@ -33638,7 +34057,21 @@ function registerRunTool(server, options) {
     inputSchema: external_exports.object(inputSchema)
   }, async (rawArgs) => {
     const { subcommand, args, account } = rawArgs;
-    return runOrDiagnose([service, subcommand, ...args], { account });
+    try {
+      assertSafeSubcommand(subcommand);
+      assertSafeForwardedArgs(args);
+      if (allowedSubcommands && !allowedSubcommands.includes(subcommand)) {
+        throw new Error(
+          `gog ${service} ${subcommand} is not available through gog_${service}_run. Allowed: ${allowedSubcommands.join(", ")}.`
+        );
+      }
+      const refusal = vet?.(subcommand, args);
+      if (refusal) throw new Error(refusal);
+      assertRunPathsConfined(service, subcommand, args);
+    } catch (err) {
+      return errorResult(errorText(err));
+    }
+    return runOrDiagnose([service, subcommand, ...args], gmailNoSend ? { account, gmailNoSend } : { account });
   });
 }
 function errorText(err) {
@@ -33766,7 +34199,240 @@ function assertNotBoth(inlineParam, fileParam, inlineValue, fileValue) {
   }
 }
 
+// src/dispatch-confirmation.ts
+import { createHash as createHash3 } from "node:crypto";
+import { readFileSync } from "node:fs";
+
+// src/send-confirm-token.ts
+import { createHash as createHash2, createHmac as createHmac2, randomBytes, timingSafeEqual as timingSafeEqual2 } from "node:crypto";
+var CONFIRM_TOKEN_TTL_DEFAULT_SECONDS = 600;
+var PREFIX = "gct1";
+var secret;
+var spent = /* @__PURE__ */ new Map();
+function sendConfirmFallbackEnabled() {
+  return readEnvVar("GOG_SEND_CONFIRM_FALLBACK")?.trim().toLowerCase() === "token";
+}
+function confirmTokenTtlSeconds() {
+  const raw = readEnvVar("GOG_CONFIRM_TTL_SECONDS")?.trim();
+  if (raw && /^\d+$/.test(raw)) {
+    const n = Number(raw);
+    if (n > 0) return n;
+  }
+  return CONFIRM_TOKEN_TTL_DEFAULT_SECONDS;
+}
+function hmacKey() {
+  if (!secret) {
+    const configured = readEnvVar("GOG_CONFIRM_SECRET");
+    secret = configured ? Buffer.from(configured, "utf8") : randomBytes(32);
+  }
+  return secret;
+}
+function canonicalize(value) {
+  if (Array.isArray(value)) return value.map(canonicalize);
+  if (value && typeof value === "object") {
+    const out = {};
+    for (const key of Object.keys(value).sort()) {
+      const v = value[key];
+      if (v !== void 0) out[key] = canonicalize(v);
+    }
+    return out;
+  }
+  return value;
+}
+function hashSendPayload(payload) {
+  return createHash2("sha256").update(JSON.stringify(canonicalize(payload))).digest("hex");
+}
+function sign(body) {
+  return createHmac2("sha256", hmacKey()).update(`${PREFIX}.${body}`).digest("base64url");
+}
+function issueConfirmToken(binding, now = Date.now()) {
+  const exp = now + confirmTokenTtlSeconds() * 1e3;
+  const claims = {
+    t: binding.tool,
+    a: binding.account,
+    g: binding.target,
+    ...binding.revision === void 0 ? {} : { r: binding.revision },
+    h: binding.payloadHash,
+    iat: now,
+    exp,
+    n: randomBytes(16).toString("base64url")
+  };
+  const body = Buffer.from(JSON.stringify(claims), "utf8").toString("base64url");
+  return { token: `${PREFIX}.${body}.${sign(body)}`, expiresAt: new Date(exp).toISOString() };
+}
+function signatureMatches(body, sig) {
+  const expected = Buffer.from(sign(body), "utf8");
+  const actual = Buffer.from(sig, "utf8");
+  return expected.length === actual.length && timingSafeEqual2(expected, actual);
+}
+function parseClaims(body) {
+  try {
+    return JSON.parse(Buffer.from(body, "base64url").toString("utf8"));
+  } catch {
+    return void 0;
+  }
+}
+function verifyConfirmToken(token, binding, now = Date.now()) {
+  for (const [nonce, exp] of spent) if (exp < now) spent.delete(nonce);
+  const parts = token.split(".");
+  if (parts.length !== 3 || parts[0] !== PREFIX || !parts[1] || !parts[2]) return { ok: false, error: "TOKEN_INVALID" };
+  const [, body, sig] = parts;
+  if (!signatureMatches(body, sig)) return { ok: false, error: "TOKEN_INVALID" };
+  const claims = parseClaims(body);
+  if (!claims) return { ok: false, error: "TOKEN_INVALID" };
+  if (claims.t !== binding.tool || claims.a !== binding.account || claims.g !== binding.target) {
+    return { ok: false, error: "TOKEN_INVALID" };
+  }
+  if (spent.has(claims.n)) return { ok: false, error: "TOKEN_REUSED" };
+  if (now > claims.exp) return { ok: false, error: "TOKEN_EXPIRED" };
+  if (claims.r !== binding.revision) return { ok: false, error: "DRAFT_CHANGED", reason: "message-id-rotated" };
+  if (claims.h !== binding.payloadHash) return { ok: false, error: "DRAFT_CHANGED", reason: "payload-changed" };
+  spent.set(claims.n, claims.exp);
+  return { ok: true };
+}
+
+// src/dispatch-confirmation.ts
+var BODY_PREVIEW_MAX = 2048;
+function bodyPreview(text) {
+  if (!text) return void 0;
+  if (text.length <= BODY_PREVIEW_MAX) return text;
+  return `${text.slice(0, BODY_PREVIEW_MAX)}\u2026 [${text.length - BODY_PREVIEW_MAX} more characters not shown]`;
+}
+function attachmentNames(paths, inline) {
+  return [...paths ?? [], ...(inline ?? []).map((a) => a.filename)];
+}
+function attachmentDetails(paths, inline) {
+  const out = [];
+  for (const path of paths ?? []) {
+    let bytes;
+    try {
+      bytes = readFileSync(path);
+    } catch {
+      bytes = void 0;
+    }
+    out.push(bytes ? { name: path, size: bytes.length, sha256: createHash3("sha256").update(bytes).digest("hex") } : { name: path, size: null });
+  }
+  for (const a of inline ?? []) {
+    out.push({
+      name: a.filename,
+      size: Buffer.from(a.contentBase64, "base64").length,
+      sha256: createHash3("sha256").update(a.contentBase64).digest("hex")
+    });
+  }
+  return out;
+}
+function senderPreview(account, from) {
+  return from ?? account ?? readEnvVar("GOG_ACCOUNT") ?? "the gog account's default address";
+}
+function attachmentPreview(details) {
+  return details.map(({ name, size }) => ({ name, size }));
+}
+var CONFIRM_SEND_INSTRUCTION = "Show this preview to the user verbatim and send only after they explicitly approve in chat. Then call again with confirmToken.";
+var CONFIRM_ACTION_INSTRUCTION = "Show this preview to the user verbatim and proceed only after they explicitly approve in chat. Then call again with confirmToken.";
+var FALLBACK_HINT = "Or set GOG_SEND_CONFIRM_FALLBACK=token to enable two-step confirmation.";
+var CONFIRM_FALLBACK_DESCRIPTION = ' If the client cannot show that prompt (no MCP elicitation, e.g. claude.ai) and the server sets GOG_SEND_CONFIRM_FALLBACK=token, a two-step flow applies instead: call WITHOUT confirmToken and nothing is sent or changed \u2014 the result has status "confirmation-required", the full preview and a confirmToken. Show that preview to the user verbatim; only after they explicitly approve it in chat, call again with the SAME arguments plus confirmToken. The tool re-reads what it would act on and refuses (DRAFT_CHANGED, with a fresh preview and token) if it changed; TOKEN_EXPIRED / TOKEN_REUSED / TOKEN_INVALID also do nothing.';
+var confirmTokenParam = external_exports.string().optional().describe(
+  `ONLY for the two-step fallback (client without MCP elicitation, server with GOG_SEND_CONFIRM_FALLBACK=token). The confirmToken from this same tool's phase-1 "confirmation-required" response, passed back ONLY after the user has seen that preview and explicitly approved it in chat \u2014 never on the first call, never invented, never reused. Call again with the same arguments. Ignored when the client supports elicitation.`
+);
+var TOKEN_ERROR_NOTE = {
+  TOKEN_EXPIRED: "Nothing was sent or changed: the confirmToken expired. Call again WITHOUT confirmToken for a fresh preview, and ask the user to approve it again.",
+  TOKEN_REUSED: "Nothing was sent or changed by this call: this confirmToken was already used, and one approval acts once. If doing it again is really intended, call again WITHOUT confirmToken and get a new approval.",
+  TOKEN_INVALID: "Nothing was sent or changed: this confirmToken was not issued by this server for this tool, account and target (or the server has restarted since). Call again WITHOUT confirmToken for a fresh preview and approval."
+};
+var DRAFT_CHANGED_NOTE = {
+  "message-id-rotated": "Nothing was sent or changed: the target was edited since the user approved it (a draft's messageId or an event's version rotated), so what would happen is not what they saw.",
+  "payload-changed": "Nothing was sent or changed: what would happen no longer matches what the user approved."
+};
+function isToolResult(value) {
+  return Array.isArray(value.content);
+}
+function rejection(data) {
+  return { ...textResult({ status: "confirmation-rejected", confirmed: false, dispatched: false, ...data }), isError: true };
+}
+async function tokenConfirmation(op, fallback) {
+  const subject = await fallback.subject();
+  if (isToolResult(subject)) return subject;
+  const binding = {
+    tool: fallback.tool,
+    account: fallback.account ?? readEnvVar("GOG_ACCOUNT") ?? "",
+    target: subject.target,
+    ...subject.revision === void 0 ? {} : { revision: subject.revision },
+    payloadHash: hashSendPayload(subject.payload)
+  };
+  const phaseOne = () => {
+    const { token, expiresAt } = issueConfirmToken(binding);
+    return {
+      action: op,
+      preview: subject.preview,
+      confirmToken: token,
+      expiresAt,
+      ttlSeconds: confirmTokenTtlSeconds(),
+      instruction: fallback.instruction ?? CONFIRM_ACTION_INSTRUCTION
+    };
+  };
+  if (!fallback.confirmToken) {
+    return textResult({ status: "confirmation-required", confirmed: false, dispatched: false, ...phaseOne() });
+  }
+  const verdict = verifyConfirmToken(fallback.confirmToken, binding);
+  if (verdict.ok) return void 0;
+  if (verdict.error === "DRAFT_CHANGED") {
+    return rejection({
+      error: "DRAFT_CHANGED",
+      reason: verdict.reason,
+      note: `${DRAFT_CHANGED_NOTE[verdict.reason]} The current preview and a fresh confirmToken are below.`,
+      ...phaseOne()
+    });
+  }
+  return rejection({ error: verdict.error, action: op, note: TOKEN_ERROR_NOTE[verdict.error] });
+}
+function gatedElsewhere(what, via, does, tool) {
+  return `${what} ${does} and is not available through ${via}. Use ${tool}, which asks the user to confirm.`;
+}
+function hasCommandWord(args, words) {
+  return args.find((a) => words.has(a.toLowerCase()));
+}
+async function requireDispatchConfirmation(ctx, options) {
+  const { action, fallback } = options;
+  if (fallback && callerAcceptsFormElicitation(ctx) === false && sendConfirmFallbackEnabled()) {
+    return tokenConfirmation(action, fallback);
+  }
+  const note = fallback ? [options.unsupportedNote, FALLBACK_HINT].filter(Boolean).join(" ") : options.unsupportedNote;
+  return requireConfirmation(ctx, {
+    action,
+    message: options.message,
+    details: options.details,
+    confirmationLabel: options.confirmationLabel,
+    ...note ? { unsupportedNote: note } : {}
+  });
+}
+function resultText(result) {
+  const first = result.content[0];
+  return first && first.type === "text" && typeof first.text === "string" ? first.text : "{}";
+}
+
 // src/tools/api.ts
+var GMAIL_API_BLOCKED = /(?:\.send$|forwarding|filters\.create|filters\.update|delegates\.create)/i;
+var DISPATCH_API_BLOCKED = {
+  chat: [{ method: /(?:^|\.)spaces\.messages\.create$/i, does: "posts a Chat message", tool: "gog_chat_messages_send / gog_chat_dm_send" }],
+  drive: [{ method: /(?:^|\.)permissions\.(?:create|update)$/i, does: "grants access to a file", tool: "gog_drive_share" }],
+  classroom: [
+    { method: /(?:^|\.)courses\.announcements\.create$/i, does: "posts to a class", tool: "gog_classroom_announcements_create" },
+    { method: /(?:^|\.)invitations\.create$/i, does: "invites someone to a class", tool: "gog_classroom_invitations_create" }
+  ],
+  calendar: [
+    { method: /(?:^|\.)events\.(?:insert|import|quickadd)$/i, does: "can put an event on guests' calendars", tool: "gog_calendar_create" },
+    { method: /(?:^|\.)events\.(?:update|patch)$/i, does: "can change what guests see", tool: "gog_calendar_update / gog_calendar_respond" }
+  ]
+};
+function refusedApiCall(api, method) {
+  const name = api.trim().toLowerCase();
+  const m = method.trim();
+  if (name === "gmail" && GMAIL_API_BLOCKED.test(m)) {
+    return `gmail ${method} is not available through gog_api_call: it sends or forwards mail. Use gog_gmail_send / gog_gmail_drafts_send (which ask the user to confirm) or the dedicated gog_gmail_* tool.`;
+  }
+  const hit = (Object.hasOwn(DISPATCH_API_BLOCKED, name) ? DISPATCH_API_BLOCKED[name] : []).find((b) => b.method.test(m));
+  return hit ? gatedElsewhere(`${name} ${m}`, "gog_api_call", hit.does, hit.tool) : void 0;
+}
 function registerApiTools(server) {
   server.registerTool("gog_api_list", {
     description: "List the Google Discovery APIs available for gog_api_call / gog_api_describe (name + version + title).",
@@ -33790,12 +34456,12 @@ function registerApiTools(server) {
       account: accountParam
     })
   }, async ({ api, version: version2, method, account }) => {
-    const args = ["api", "describe", api, version2];
-    if (method) args.push(method);
+    const args = ["api", "describe", pos(api), pos(version2)];
+    if (method) args.push(pos(method));
     return runOrDiagnose(args, { account });
   });
   server.registerTool("gog_api_call", {
-    description: "Call any Discovery-described Google API method directly \u2014 an escape hatch for endpoints gog has no dedicated tool for. Find the exact api/version/method/params with gog_api_describe first. Read methods (GET/LIST) run as-is. Mutating methods (POST/PUT/PATCH/DELETE) are refused unless you set allowWrite=true \u2014 keep it false to preview, or set dryRun=true to print the intended request without sending it.",
+    description: "Call any Discovery-described Google API method directly \u2014 an escape hatch for endpoints gog has no dedicated tool for. Find the exact api/version/method/params with gog_api_describe first. Read methods (GET/LIST) run as-is. Mutating methods (POST/PUT/PATCH/DELETE) are refused unless you set allowWrite=true \u2014 keep it false to preview, or set dryRun=true to print the intended request without sending it. Gmail send and forwarding methods (users.messages.send, users.drafts.send, forwarding/auto-forwarding, filters, delegates) are refused \u2014 use the dedicated gog_gmail_* tools, which ask the user to confirm. So are the other methods a dedicated tool asks about: Chat spaces.messages.create, Drive permissions.create/update, Classroom courses.announcements.create and invitations.create, and Calendar events.insert/import/quickAdd/update/patch.",
     annotations: { destructiveHint: true },
     inputSchema: external_exports.object({
       api: external_exports.string().describe("Discovery API name (e.g. drive, gmail, calendar)"),
@@ -33809,14 +34475,23 @@ function registerApiTools(server) {
       account: accountParam
     })
   }, async ({ api, version: version2, method, params, body, scope, allowWrite, dryRun, account }) => {
-    const args = ["api", "call", api, version2, method];
+    try {
+      assertSafeForwardedArgs([api, version2, method]);
+      const refusal = refusedApiCall(api, method);
+      if (refusal) throw new Error(refusal);
+      if (body) confineAtFile(body, "body");
+      if (params) confineAtFile(params, "params");
+    } catch (err) {
+      return errorResult(errorText(err));
+    }
+    const args = ["api", "call", pos(api), pos(version2), pos(method)];
     if (params) args.push(`--params=${params}`);
     if (body) args.push(`--body=${body}`);
     if (scope) args.push(`--scope=${scope}`);
     if (allowWrite) args.push("--allow-write");
     if (dryRun) args.push("--dry-run");
     if (allowWrite) args.push("--force");
-    return runOrDiagnose(args, { account });
+    return runOrDiagnose(args, { account, gmailNoSend: true });
   });
 }
 
@@ -33834,7 +34509,7 @@ function registerAppScriptTools(server) {
       account: accountParam
     })
   }, async ({ scriptId, account }) => {
-    return runOrDiagnose(["appscript", "get", scriptId], { account });
+    return runOrDiagnose(["appscript", "get", pos(scriptId)], { account });
   });
   server.registerTool("gog_appscript_content", {
     description: `Read a project's source \u2014 every .gs file and its appsscript.json manifest \u2014 INLINE in the response. This is the tool to reach for when the question is "what does this script do"; it needs no filesystem, so it works the same on a hosted deployment as it does locally, unlike gog_appscript_pull.` + apiEnableNote,
@@ -33844,19 +34519,20 @@ function registerAppScriptTools(server) {
       account: accountParam
     })
   }, async ({ scriptId, account }) => {
-    return runOrDiagnose(["appscript", "content", scriptId], { account });
+    return runOrDiagnose(["appscript", "content", pos(scriptId)], { account });
   });
   server.registerTool("gog_appscript_pull", {
     description: "Write a project's files into a local directory, for editing a script as ordinary files. THE DIRECTORY IS RESOLVED WHERE GOG RUNS, which is the caller's own machine only on a local (stdio) deployment: on a hosted deployment (e.g. mcp-host) the files land on that server where the caller cannot reach them. Use gog_appscript_content there instead \u2014 it returns the same source in the response. Existing files are left alone unless overwrite is set. Read-only as far as Google is concerned: nothing is pushed back." + apiEnableNote,
     annotations: { destructiveHint: true },
     inputSchema: external_exports.object({
       scriptId: scriptIdParam,
-      dir: external_exports.string().describe("Destination directory, resolved on the machine where gog runs"),
+      dir: external_exports.string().describe("Destination directory, resolved on the machine where gog runs; must be inside the server's GOG_FILE_ROOTS directories"),
       overwrite: external_exports.boolean().optional().describe("Overwrite files that already exist in dir"),
       account: accountParam
     })
   }, async ({ scriptId, dir, overwrite, account }) => {
-    const args = ["appscript", "pull", scriptId, dir];
+    confinePath(dir, "dir");
+    const args = ["appscript", "pull", pos(scriptId), pos(dir)];
     if (overwrite) args.push("--overwrite");
     return runOrDiagnose(args, { account });
   });
@@ -33882,7 +34558,7 @@ function registerAppScriptTools(server) {
       account: accountParam
     })
   }, async ({ scriptId, max, pageToken, page, all, account }) => {
-    const args = ["appscript", "deployments", scriptId];
+    const args = ["appscript", "deployments", pos(scriptId)];
     pushPaginationFlags(args, { max, pageToken, page, all });
     return runOrDiagnose(args, { account });
   });
@@ -33895,7 +34571,7 @@ function registerAppScriptTools(server) {
       account: accountParam
     })
   }, async ({ scriptId, max, pageToken, page, all, account }) => {
-    const args = ["appscript", "versions", scriptId];
+    const args = ["appscript", "versions", pos(scriptId)];
     pushPaginationFlags(args, { max, pageToken, page, all });
     return runOrDiagnose(args, { account });
   });
@@ -33921,7 +34597,7 @@ function registerAppScriptTools(server) {
         throw new Error(`params must be a JSON ARRAY of positional arguments, e.g. '["a", 1]' \u2014 Apps Script takes positional arguments, not named ones. Received: ${params}`);
       }
     }
-    const args = ["appscript", "run", scriptId, functionName];
+    const args = ["appscript", "run", pos(scriptId), pos(functionName)];
     if (params !== void 0) args.push(`--params=${params}`);
     if (devMode) args.push("--dev-mode");
     return runOrDiagnose(args, { account });
@@ -33934,6 +34610,7 @@ function registerAppScriptTools(server) {
 }
 
 // src/tools/auth.ts
+var AUTH_RUN_SUBCOMMANDS = ["list", "status", "services", "remove", "alias"];
 function registerAuthToolsWith(server, defaultServices) {
   const servicesDescribe = `Services to authorize: "all" or comma-separated list (e.g. "sheets,gmail,calendar"). Default: "${defaultServices}". Prefer the narrowest set you need \u2014 requesting a service whose Google API is not enabled on the OAuth client's project makes Google reject the WHOLE request with invalid_scope.`;
   const extraScopesDescribe = "Additional raw OAuth scope URIs to request, comma-separated, on top of the ones `services` implies. Use for scopes no service covers \u2014 e.g. https://www.googleapis.com/auth/bigquery.readonly, required before gog_sheets_datasource_* can read BigQuery-backed Connected Sheets. Leave unset otherwise: an extra scope whose API is not enabled on the OAuth client project makes Google reject the WHOLE authorization with invalid_scope.";
@@ -33991,7 +34668,7 @@ function registerAuthToolsWith(server, defaultServices) {
     })
   }, async ({ email: email3, services = defaultServices, extraScopes }) => {
     try {
-      const args = ["auth", "add", email3, "--services", services];
+      const args = ["auth", "add", pos(email3), "--services", services];
       if (extraScopes) args.push(`--extra-scopes=${extraScopes}`, "--force-consent");
       return rawTextResult(await run(args, {
         interactive: true,
@@ -34011,7 +34688,7 @@ function registerAuthToolsWith(server, defaultServices) {
     })
   }, async ({ email: email3, services = defaultServices, extraScopes }) => {
     try {
-      const args = ["auth", "add", email3, "--remote", "--step", "1", "--services", services, "--force-consent"];
+      const args = ["auth", "add", pos(email3), "--remote", "--step", "1", "--services", services, "--force-consent"];
       if (extraScopes) args.push(`--extra-scopes=${extraScopes}`);
       return rawTextResult(await run(args, { redactMode: "tokens" }));
     } catch (err) {
@@ -34038,7 +34715,7 @@ function registerAuthToolsWith(server, defaultServices) {
       const args = [
         "auth",
         "add",
-        email3,
+        pos(email3),
         "--remote",
         "--step",
         "2",
@@ -34058,6 +34735,7 @@ function registerAuthToolsWith(server, defaultServices) {
     service: "auth",
     examples: '"remove", "alias", "list"',
     omitAccount: true,
+    allowedSubcommands: AUTH_RUN_SUBCOMMANDS,
     note: "For browser-based authorization, use gog_auth_add instead."
   });
 }
@@ -34069,6 +34747,54 @@ function authToolsFor(defaultServices) {
 }
 
 // src/tools/calendar.ts
+var CALENDAR_GATED = {
+  create: "gog_calendar_create",
+  add: "gog_calendar_create",
+  new: "gog_calendar_create",
+  update: "gog_calendar_update",
+  edit: "gog_calendar_update",
+  set: "gog_calendar_update",
+  respond: "gog_calendar_respond",
+  rsvp: "gog_calendar_respond",
+  reply: "gog_calendar_respond"
+};
+function vetCalendarRun(subcommand, _args) {
+  const sub = subcommand.toLowerCase();
+  const tool = Object.hasOwn(CALENDAR_GATED, sub) ? CALENDAR_GATED[sub] : void 0;
+  return tool ? gatedElsewhere(`gog calendar ${sub}`, "gog_calendar_run", "can change what guests see", tool) : void 0;
+}
+function parseAttendees(value) {
+  if (!value) return [];
+  return value.split(",").map((entry) => entry.split(";")).filter((parts) => !parts.slice(1).some((m) => m.trim().toLowerCase() === "resource")).map((parts) => parts[0].trim()).filter(Boolean);
+}
+function timeOf(t) {
+  const v = t?.dateTime ?? t?.date;
+  return typeof v === "string" ? v : void 0;
+}
+function eventSnapshot(raw) {
+  let event;
+  try {
+    event = JSON.parse(raw)?.event;
+  } catch {
+    event = void 0;
+  }
+  const str = (v) => typeof v === "string" ? v : void 0;
+  return {
+    summary: str(event?.summary),
+    start: timeOf(event?.start),
+    end: timeOf(event?.end),
+    organizer: str(event?.organizer?.email),
+    // Guests are the OTHER people: not this account's own attendee row, not rooms.
+    guests: (Array.isArray(event?.attendees) ? event.attendees : []).filter((a) => a.self !== true && a.resource !== true && typeof a.email === "string").map((a) => a.email),
+    etag: str(event?.etag)
+  };
+}
+async function readEvent(calendarId, eventId, account) {
+  const got = await runOrDiagnose(["calendar", "event", pos(calendarId), pos(eventId)], { account });
+  if (got.isError) return { error: got };
+  return { event: eventSnapshot(resultText(got)) };
+}
+var CALENDAR_CONFIRM_LABEL = "Confirm that this change, which other people will see, should be made now.";
 var reminderParams = {
   reminders: external_exports.array(external_exports.string()).max(5).optional().describe(
     `Reminders as method:duration, e.g. ["popup:30m", "email:1d"]. Method is popup or email; duration accepts m/h/d (max 40320 minutes = 4 weeks). Google allows at most 5. These REPLACE the event's reminders \u2014 on update, pass an EMPTY array to drop custom reminders and go back to the calendar's defaults. Cannot be combined with noReminders.`
@@ -34122,7 +34848,7 @@ function registerCalendarTools(server) {
     })
   }, 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 (calendarId) args.push(pos(calendarId));
     if (from) args.push(`--from=${from}`);
     if (to) args.push(`--to=${to}`);
     if (days !== void 0) args.push(`--days=${days}`);
@@ -34151,12 +34877,12 @@ function registerCalendarTools(server) {
       account: accountParam
     })
   }, async ({ calendarId, eventId, timezone, account }) => {
-    const args = ["calendar", "event", calendarId, eventId];
+    const args = ["calendar", "event", pos(calendarId), pos(eventId)];
     if (timezone) args.push(`--timezone=${timezone}`);
     return runOrDiagnose(args, { account });
   });
   server.registerTool("gog_calendar_create", {
-    description: "Create a calendar event. Set withZoom=true to attach a Zoom meeting (requires Zoom S2S OAuth setup via gog_zoom_auth_setup; the join URL + meeting ID + passcode are appended to the event description \u2014 Google rejects native conference card writes from non-Workspace-Marketplace OAuth clients).",
+    description: "Create a calendar event. Set withZoom=true to attach a Zoom meeting (requires Zoom S2S OAuth setup via gog_zoom_auth_setup; the join URL + meeting ID + passcode are appended to the event description \u2014 Google rejects native conference card writes from non-Workspace-Marketplace OAuth clients). With attendees, the event lands on other people's calendars (no invitation email is sent), so the MCP host is asked to show the user a confirmation prompt with the guests, time and details first; a guest-free event is created without asking." + CONFIRM_FALLBACK_DESCRIPTION,
     annotations: { destructiveHint: false },
     inputSchema: external_exports.object({
       calendarId: external_exports.string().describe('Calendar ID (use "primary" for the default calendar)'),
@@ -34170,10 +34896,11 @@ function registerCalendarTools(server) {
       timezone: external_exports.string().optional().describe("IANA timezone metadata applied to from/to (e.g. America/New_York). Sets both start and end timezone unless start/end timezone are overridden."),
       withZoom: external_exports.boolean().optional().describe("Create a Zoom video conference for this event (requires Zoom S2S OAuth setup)"),
       ...reminderParams,
-      account: accountParam
+      account: accountParam,
+      confirmToken: confirmTokenParam
     })
-  }, async ({ calendarId, summary, from, to, description, location, attendees, allDay, timezone, withZoom, reminders, noReminders, account }) => {
-    const args = ["calendar", "create", calendarId, `--summary=${summary}`, `--from=${from}`, `--to=${to}`];
+  }, async ({ calendarId, summary, from, to, description, location, attendees, allDay, timezone, withZoom, reminders, noReminders, account, confirmToken }, ctx) => {
+    const args = ["calendar", "create", pos(calendarId), `--summary=${summary}`, `--from=${from}`, `--to=${to}`];
     if (description) args.push(`--description=${description}`);
     if (location) args.push(`--location=${location}`);
     if (attendees) args.push(`--attendees=${attendees}`);
@@ -34181,10 +34908,28 @@ function registerCalendarTools(server) {
     if (timezone) args.push(`--timezone=${timezone}`);
     if (withZoom) args.push("--with-zoom");
     pushReminderFlags(args, { reminders, noReminders });
+    const guests = parseAttendees(attendees);
+    if (guests.length > 0) {
+      const event = { calendarId, summary, from, to, allDay: Boolean(allDay), timezone, location, description, guests, attendees, withZoom: Boolean(withZoom) };
+      const confirmation = await requireDispatchConfirmation(ctx, {
+        action: "calendar.create",
+        message: "Review and confirm this event, which will appear on the guests' calendars:",
+        confirmationLabel: CALENDAR_CONFIRM_LABEL,
+        details: event,
+        unsupportedNote: "Create it without attendees instead; the user can add the guests in Google Calendar.",
+        fallback: {
+          tool: "gog_calendar_create",
+          account,
+          confirmToken,
+          subject: () => ({ target: calendarId, payload: event, preview: event })
+        }
+      });
+      if (confirmation) return confirmation;
+    }
     return runOrDiagnose(args, { account });
   });
   server.registerTool("gog_calendar_update", {
-    description: "Update an existing calendar event. Zoom: withZoom adds a Zoom meeting, regenerateZoom replaces the existing one, removeZoom strips it. removeMeet clears the event's Google Meet conference data (e.g. before attaching another provider). Conference flags are independent \u2014 use one per call.",
+    description: "Update an existing calendar event. Zoom: withZoom adds a Zoom meeting, regenerateZoom replaces the existing one, removeZoom strips it. removeMeet clears the event's Google Meet conference data (e.g. before attaching another provider). Conference flags are independent \u2014 use one per call. A change guests can see (time, title, place, description, attendees, attachments, conferencing) on an event that has guests \u2014 or gains them \u2014 reads the event and asks the MCP host to show the user a confirmation prompt with the event as it stands and the change; no invitation email is sent. Reminder-only changes and guest-free events are updated without asking." + CONFIRM_FALLBACK_DESCRIPTION,
     annotations: { destructiveHint: false },
     inputSchema: external_exports.object({
       calendarId: external_exports.string().describe("Calendar ID"),
@@ -34202,10 +34947,11 @@ function registerCalendarTools(server) {
       removeZoom: external_exports.boolean().optional().describe("Remove the event's Zoom video conference"),
       removeMeet: external_exports.boolean().optional().describe("Remove the event's Google Meet video conference (clears conference data only)"),
       ...reminderParams,
-      account: accountParam
+      account: accountParam,
+      confirmToken: confirmTokenParam
     })
-  }, async ({ calendarId, eventId, summary, from, to, description, location, attendees, addAttendees, attachments, withZoom, regenerateZoom, removeZoom, removeMeet, reminders, noReminders, account }) => {
-    const args = ["calendar", "update", calendarId, eventId];
+  }, async ({ calendarId, eventId, summary, from, to, description, location, attendees, addAttendees, attachments, withZoom, regenerateZoom, removeZoom, removeMeet, reminders, noReminders, account, confirmToken }, ctx) => {
+    const args = ["calendar", "update", pos(calendarId), pos(eventId)];
     if (summary !== void 0) args.push(`--summary=${summary}`);
     if (from !== void 0) args.push(`--from=${from}`);
     if (to !== void 0) args.push(`--to=${to}`);
@@ -34219,6 +34965,45 @@ function registerCalendarTools(server) {
     if (removeZoom) args.push("--remove-zoom");
     if (removeMeet) args.push("--remove-meet");
     pushReminderFlags(args, { reminders, noReminders });
+    const changes = Object.fromEntries(Object.entries({
+      summary,
+      from,
+      to,
+      description,
+      location,
+      attendees,
+      addAttendees,
+      attachments,
+      withZoom,
+      regenerateZoom,
+      removeZoom,
+      removeMeet
+    }).filter(([, v]) => v !== void 0 && v !== false));
+    if (Object.keys(changes).length > 0) {
+      const read = await readEvent(calendarId, eventId, account);
+      if (read.error) return read.error;
+      const { etag, ...current } = read.event;
+      const added = [...parseAttendees(attendees), ...parseAttendees(addAttendees)];
+      if (current.guests.length > 0 || added.length > 0) {
+        const view = { calendarId, eventId, current, changes };
+        const confirmation = await requireDispatchConfirmation(ctx, {
+          action: "calendar.update",
+          message: "Review and confirm this change to an event other people are on:",
+          confirmationLabel: CALENDAR_CONFIRM_LABEL,
+          details: view,
+          unsupportedNote: "Ask the user to make this change in Google Calendar.",
+          fallback: {
+            tool: "gog_calendar_update",
+            account,
+            confirmToken,
+            // The etag rotates on any edit, so an event changed elsewhere between
+            // the two phases is DRAFT_CHANGED rather than edited over.
+            subject: () => ({ target: `${calendarId}/${eventId}`, revision: etag, payload: view, preview: view })
+          }
+        });
+        if (confirmation) return confirmation;
+      }
+    }
     return runOrDiagnose(args, { account });
   });
   server.registerTool("gog_calendar_delete", {
@@ -34230,24 +35015,43 @@ function registerCalendarTools(server) {
       account: accountParam
     })
   }, async ({ calendarId, eventId, account }) => {
-    return runOrDiagnose(["calendar", "delete", calendarId, eventId, "--force"], { account });
+    return runOrDiagnose(["calendar", "delete", pos(calendarId), pos(eventId), "--force"], { account });
   });
   server.registerTool("gog_calendar_respond", {
-    description: "Respond to a calendar event invitation.",
+    description: "Respond to a calendar event invitation. The organizer sees the response, so this reads the event and asks the MCP host to show the user a confirmation prompt with the event, organizer, response and comment; nothing is recorded unless they accept." + CONFIRM_FALLBACK_DESCRIPTION,
     annotations: { destructiveHint: true },
     inputSchema: external_exports.object({
       calendarId: external_exports.string().describe("Calendar ID"),
       eventId: external_exports.string().describe("Event ID"),
       status: external_exports.enum(["accepted", "declined", "tentative"]).describe("Response status"),
       comment: external_exports.string().optional().describe("Optional comment to include with response"),
-      account: accountParam
+      account: accountParam,
+      confirmToken: confirmTokenParam
     })
-  }, async ({ calendarId, eventId, status, comment, account }) => {
-    const args = ["calendar", "respond", calendarId, eventId, `--status=${status}`];
+  }, async ({ calendarId, eventId, status, comment, account, confirmToken }, ctx) => {
+    const args = ["calendar", "respond", pos(calendarId), pos(eventId), `--status=${status}`];
     if (comment) args.push(`--comment=${comment}`);
+    const read = await readEvent(calendarId, eventId, account);
+    if (read.error) return read.error;
+    const { etag, ...event } = read.event;
+    const view = { calendarId, eventId, event, response: status, ...comment ? { comment } : {} };
+    const confirmation = await requireDispatchConfirmation(ctx, {
+      action: "calendar.respond",
+      message: "Review and confirm this response, which the organizer will see:",
+      confirmationLabel: "Confirm that this response should be recorded now.",
+      details: view,
+      unsupportedNote: "Ask the user to respond from Google Calendar.",
+      fallback: {
+        tool: "gog_calendar_respond",
+        account,
+        confirmToken,
+        subject: () => ({ target: `${calendarId}/${eventId}`, revision: etag, payload: view, preview: view })
+      }
+    });
+    if (confirmation) return confirmation;
     return runOrDiagnose(args, { account });
   });
-  registerRunTool(server, { service: "calendar", examples: '"calendars", "freebusy"' });
+  registerRunTool(server, { service: "calendar", examples: '"calendars", "freebusy"', vet: vetCalendarRun });
 }
 
 // src/attachments.ts
@@ -34258,6 +35062,7 @@ var MAX_REQUEST_PAYLOAD_WIRE_BYTES = REQUEST_MAX_BODY_BYTES - REQUEST_BODY_JSON_
 var MAX_INLINE_ATTACHMENT_TOTAL_BYTES = Math.floor(MAX_REQUEST_PAYLOAD_WIRE_BYTES * 3 / 4);
 function wireBytesOf(arg) {
   if (typeof arg === "string") return Buffer.byteLength(arg, "utf8");
+  if (arg.kind === "positional") return Buffer.byteLength(arg.value, "utf8");
   return arg.encoding === "base64" ? arg.contents.length : Buffer.byteLength(arg.contents, "utf8");
 }
 var formatMiB = (bytes) => `${Math.floor(bytes / (1024 * 1024))} MiB`;
@@ -34330,6 +35135,23 @@ function inlineAttachmentArgs(flag, attachments, siblingArgs = []) {
 }
 
 // src/tools/chat.ts
+var CHAT_SEND_WORDS = /* @__PURE__ */ new Set(["send", "create", "post"]);
+function vetChatRun(subcommand, args) {
+  const sub = subcommand.toLowerCase();
+  if (sub !== "messages" && sub !== "dm") return void 0;
+  const word = hasCommandWord(args, CHAT_SEND_WORDS);
+  if (!word) return void 0;
+  return gatedElsewhere(
+    `gog chat ${sub} ${word.toLowerCase()}`,
+    "gog_chat_run",
+    "posts a message",
+    sub === "dm" ? "gog_chat_dm_send" : "gog_chat_messages_send"
+  );
+}
+var CHAT_CONFIRM = {
+  message: "Review and confirm this Google Chat message:",
+  confirmationLabel: "Confirm that this Chat message should be posted now."
+};
 function registerChatTools(server) {
   const workspaceOnlyNote = ' WORKSPACE ONLY: Google Chat has no API for consumer accounts, so this fails on an @gmail.com account with "chat requires a Google Workspace account". That is the ACCOUNT, not the token \u2014 re-authorizing or adding scopes will not help.';
   const spaceParam = external_exports.string().describe(
@@ -34360,7 +35182,7 @@ function registerChatTools(server) {
       account: accountParam
     })
   }, async ({ displayName, exact, max, account }) => {
-    const args = ["chat", "spaces", "find", displayName];
+    const args = ["chat", "spaces", "find", pos(displayName)];
     if (exact) args.push("--exact");
     if (max !== void 0) args.push(`--max=${max}`);
     return runOrDiagnose(args, { account });
@@ -34374,7 +35196,7 @@ function registerChatTools(server) {
       account: accountParam
     })
   }, async ({ displayName, members: members2, account }) => {
-    const args = ["chat", "spaces", "create", displayName];
+    const args = ["chat", "spaces", "create", pos(displayName)];
     if (members2) for (const member of members2) args.push(`--member=${member}`);
     return runOrDiagnose(args, { account });
   });
@@ -34387,7 +35209,7 @@ function registerChatTools(server) {
       account: accountParam
     })
   }, async ({ space, max, pageToken, page, all, account }) => {
-    const args = ["chat", "threads", "list", space];
+    const args = ["chat", "threads", "list", pos(space)];
     pushPaginationFlags(args, { max, pageToken, page, all });
     return runOrDiagnose(args, { account });
   });
@@ -34403,7 +35225,7 @@ function registerChatTools(server) {
       account: accountParam
     })
   }, async ({ space, thread, unread, order, max, pageToken, page, all, account }) => {
-    const args = ["chat", "messages", "list", space];
+    const args = ["chat", "messages", "list", pos(space)];
     if (thread) args.push(`--thread=${thread}`);
     if (unread) args.push("--unread");
     if (order) args.push(`--order=${order}`);
@@ -34427,7 +35249,7 @@ function registerChatTools(server) {
       account: accountParam
     })
   }, async ({ query, order, view, markup, max, pageToken, page, all, account }) => {
-    const args = ["chat", "messages", "search", query];
+    const args = ["chat", "messages", "search", pos(query)];
     if (order) args.push(`--order=${order}`);
     if (view) args.push(`--view=${view}`);
     if (markup) args.push(`--markup=${markup}`);
@@ -34435,41 +35257,79 @@ function registerChatTools(server) {
     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,
+    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`). Asks the MCP host to show the user a confirmation prompt with the space, thread, text and attachments first; nothing is posted unless they accept." + CONFIRM_FALLBACK_DESCRIPTION + workspaceOnlyNote,
     annotations: { destructiveHint: true },
     inputSchema: external_exports.object({
       space: spaceParam,
       text: external_exports.string().optional().describe("Message text. Optional only when an attachment is supplied."),
       thread: threadParam,
       attach: external_exports.array(external_exports.string()).optional().describe(
-        "Attachment file paths, read WHERE GOG RUNS. On a hosted or remote deployment that is not your machine \u2014 use attachInline there instead."
+        "Attachment file paths, read WHERE GOG RUNS. On a hosted or remote deployment that is not your machine \u2014 use attachInline there instead. Must be inside the server's GOG_FILE_ROOTS directories (default ~/gogcli-mcp-files)."
       ),
       attachInline: attachInlineParam,
-      account: accountParam
+      account: accountParam,
+      confirmToken: confirmTokenParam
     })
-  }, async ({ space, text, thread, attach, attachInline, account }) => {
+  }, async ({ space, text, thread, attach, attachInline, account, confirmToken }, ctx) => {
+    confinePaths(attach, "attach");
     if (text === void 0 && !attach?.length && !attachInline?.length) {
       throw new Error("A Chat message needs text, an attachment, or both.");
     }
-    const args = ["chat", "messages", "send", space];
+    const args = ["chat", "messages", "send", pos(space)];
     if (text !== void 0) args.push(`--text=${text}`);
     if (thread) args.push(`--thread=${thread}`);
     if (attach) for (const path of attach) args.push(`--attach=${path}`);
     args.push(...inlineAttachmentArgs("attach", attachInline, args));
+    const confirmation = await requireDispatchConfirmation(ctx, {
+      ...CHAT_CONFIRM,
+      action: "chat.message-send",
+      details: { space, thread, textPreview: bodyPreview(text), attachments: attachmentNames(attach, attachInline) },
+      fallback: {
+        tool: "gog_chat_messages_send",
+        account,
+        confirmToken,
+        subject: () => {
+          const attachments = attachmentDetails(attach, attachInline);
+          const from = senderPreview(account);
+          return {
+            target: space,
+            payload: { from, space, thread, text, attachments },
+            preview: { from, space, thread, text, attachments: attachmentPreview(attachments) }
+          };
+        }
+      }
+    });
+    if (confirmation) return confirmation;
     return runOrDiagnose(args, { account });
   });
   server.registerTool("gog_chat_dm_send", {
-    description: "Send a direct message to one person by email address, creating the DM space if this is the first message. Delivered immediately and cannot be unsent through this tool. For a room rather than a person, use gog_chat_messages_send." + workspaceOnlyNote,
+    description: "Send a direct message to one person by email address, creating the DM space if this is the first message. Delivered immediately and cannot be unsent through this tool. For a room rather than a person, use gog_chat_messages_send. Asks the MCP host to show the user a confirmation prompt with the recipient and text first; nothing is sent unless they accept." + CONFIRM_FALLBACK_DESCRIPTION + workspaceOnlyNote,
     annotations: { destructiveHint: true },
     inputSchema: external_exports.object({
       email: external_exports.string().describe("Recipient email address"),
       text: external_exports.string().describe("Message text"),
       thread: threadParam,
-      account: accountParam
+      account: accountParam,
+      confirmToken: confirmTokenParam
     })
-  }, async ({ email: email3, text, thread, account }) => {
-    const args = ["chat", "dm", "send", email3, `--text=${text}`];
+  }, async ({ email: email3, text, thread, account, confirmToken }, ctx) => {
+    const args = ["chat", "dm", "send", pos(email3), `--text=${text}`];
     if (thread) args.push(`--thread=${thread}`);
+    const confirmation = await requireDispatchConfirmation(ctx, {
+      ...CHAT_CONFIRM,
+      action: "chat.dm-send",
+      details: { to: email3, thread, textPreview: bodyPreview(text) },
+      fallback: {
+        tool: "gog_chat_dm_send",
+        account,
+        confirmToken,
+        subject: () => {
+          const from = senderPreview(account);
+          return { target: email3, payload: { from, to: email3, thread, text }, preview: { from, to: email3, thread, text } };
+        }
+      }
+    });
+    if (confirmation) return confirmation;
     return runOrDiagnose(args, { account });
   });
   server.registerTool("gog_chat_dm_space", {
@@ -34480,7 +35340,7 @@ function registerChatTools(server) {
       account: accountParam
     })
   }, async ({ email: email3, account }) => {
-    return runOrDiagnose(["chat", "dm", "space", email3], { account });
+    return runOrDiagnose(["chat", "dm", "space", pos(email3)], { account });
   });
   server.registerTool("gog_chat_reactions_list", {
     description: "List the emoji reactions on one message, with who reacted. gog_chat_messages_list already returns a reaction SUMMARY per message; come here when you need the individual reactors, or the reaction resource names that gog_chat_reactions_delete takes." + workspaceOnlyNote,
@@ -34492,7 +35352,7 @@ function registerChatTools(server) {
       account: accountParam
     })
   }, async ({ message, space, max, pageToken, page, all, account }) => {
-    const args = ["chat", "messages", "reactions", "list", message];
+    const args = ["chat", "messages", "reactions", "list", pos(message)];
     if (space) args.push(`--space=${space}`);
     pushPaginationFlags(args, { max, pageToken, page, all });
     return runOrDiagnose(args, { account });
@@ -34507,7 +35367,7 @@ function registerChatTools(server) {
       account: accountParam
     })
   }, async ({ message, emoji: emoji3, space, account }) => {
-    const args = ["chat", "messages", "reactions", "create", message, emoji3];
+    const args = ["chat", "messages", "reactions", "create", pos(message), pos(emoji3)];
     if (space) args.push(`--space=${space}`);
     return runOrDiagnose(args, { account });
   });
@@ -34519,16 +35379,50 @@ function registerChatTools(server) {
       account: accountParam
     })
   }, async ({ reaction, account }) => {
-    return runOrDiagnose(["chat", "messages", "reactions", "delete", reaction], { account });
+    return runOrDiagnose(["chat", "messages", "reactions", "delete", pos(reaction)], { account });
   });
   registerRunTool(server, {
     service: "chat",
     examples: '"spaces", "messages", "dm"',
+    vet: vetChatRun,
     note: "Google Chat has no API for consumer accounts: every chat subcommand fails on an @gmail.com account regardless of scopes."
   });
 }
 
 // src/tools/classroom.ts
+var CLASSROOM_CREATE_WORDS = /* @__PURE__ */ new Set(["create", "add", "new"]);
+var CLASSROOM_GATED = {
+  announcements: { does: "posts to a class", tool: "gog_classroom_announcements_create" },
+  announcement: { does: "posts to a class", tool: "gog_classroom_announcements_create" },
+  ann: { does: "posts to a class", tool: "gog_classroom_announcements_create" },
+  invitations: { does: "invites someone to a class", tool: "gog_classroom_invitations_create" },
+  invitation: { does: "invites someone to a class", tool: "gog_classroom_invitations_create" },
+  invites: { does: "invites someone to a class", tool: "gog_classroom_invitations_create" }
+};
+function vetClassroomRun(subcommand, args) {
+  const sub = subcommand.toLowerCase();
+  const gated = Object.hasOwn(CLASSROOM_GATED, sub) ? CLASSROOM_GATED[sub] : void 0;
+  if (!gated) return void 0;
+  const word = hasCommandWord(args, CLASSROOM_CREATE_WORDS);
+  return word ? gatedElsewhere(`gog classroom ${sub} ${word.toLowerCase()}`, "gog_classroom_run", gated.does, gated.tool) : void 0;
+}
+async function readCourse(courseId, account, runner = runOrDiagnose) {
+  const got = await runner(["classroom", "courses", "get", pos(courseId)], { account });
+  if (got.isError) return { error: got };
+  let course;
+  try {
+    course = JSON.parse(resultText(got))?.course;
+  } catch {
+    course = void 0;
+  }
+  return {
+    course: {
+      id: courseId,
+      ...typeof course?.name === "string" ? { name: course.name } : {},
+      ...typeof course?.section === "string" ? { section: course.section } : {}
+    }
+  };
+}
 function registerClassroomTools(server) {
   server.registerTool("gog_classroom_courses_list", {
     description: "List Google Classroom courses.",
@@ -34562,7 +35456,7 @@ function registerClassroomTools(server) {
       account: accountParam
     })
   }, async ({ courseId, account }) => {
-    return runOrDiagnose(["classroom", "courses", "get", courseId], { account });
+    return runOrDiagnose(["classroom", "courses", "get", pos(courseId)], { account });
   });
   server.registerTool("gog_classroom_students_list", {
     description: "List students enrolled in a Google Classroom course.",
@@ -34576,7 +35470,7 @@ function registerClassroomTools(server) {
       account: accountParam
     })
   }, async ({ courseId, max, pageToken, page, all, account }) => {
-    const args = ["classroom", "students", "list", courseId];
+    const args = ["classroom", "students", "list", pos(courseId)];
     if (max !== void 0) args.push(`--max=${max}`);
     const token = resolvePageToken({ pageToken, page });
     if (token) args.push(`--page=${token}`);
@@ -34592,7 +35486,7 @@ function registerClassroomTools(server) {
       account: accountParam
     })
   }, async ({ courseId, userId, account }) => {
-    return runOrDiagnose(["classroom", "students", "get", courseId, userId], { account });
+    return runOrDiagnose(["classroom", "students", "get", pos(courseId), pos(userId)], { account });
   });
   server.registerTool("gog_classroom_teachers_list", {
     description: "List teachers in a Google Classroom course.",
@@ -34606,7 +35500,7 @@ function registerClassroomTools(server) {
       account: accountParam
     })
   }, async ({ courseId, max, pageToken, page, all, account }) => {
-    const args = ["classroom", "teachers", "list", courseId];
+    const args = ["classroom", "teachers", "list", pos(courseId)];
     if (max !== void 0) args.push(`--max=${max}`);
     const token = resolvePageToken({ pageToken, page });
     if (token) args.push(`--page=${token}`);
@@ -34622,7 +35516,7 @@ function registerClassroomTools(server) {
       account: accountParam
     })
   }, async ({ courseId, userId, account }) => {
-    return runOrDiagnose(["classroom", "teachers", "get", courseId, userId], { account });
+    return runOrDiagnose(["classroom", "teachers", "get", pos(courseId), pos(userId)], { account });
   });
   server.registerTool("gog_classroom_roster", {
     description: "List the full roster (students and/or teachers) of a Google Classroom course. Omit both flags to return both groups.",
@@ -34638,7 +35532,7 @@ function registerClassroomTools(server) {
       account: accountParam
     })
   }, async ({ courseId, students, teachers, max, pageToken, page, all, account }) => {
-    const args = ["classroom", "roster", courseId];
+    const args = ["classroom", "roster", pos(courseId)];
     if (students) args.push("--students");
     if (teachers) args.push("--teachers");
     if (max !== void 0) args.push(`--max=${max}`);
@@ -34663,7 +35557,7 @@ function registerClassroomTools(server) {
       account: accountParam
     })
   }, async ({ courseId, state, topic, orderBy, max, pageToken, page, all, scanPages, account }) => {
-    const args = ["classroom", "coursework", "list", courseId];
+    const args = ["classroom", "coursework", "list", pos(courseId)];
     if (state) args.push(`--state=${state}`);
     if (topic) args.push(`--topic=${topic}`);
     if (orderBy) args.push(`--order-by=${orderBy}`);
@@ -34683,7 +35577,7 @@ function registerClassroomTools(server) {
       account: accountParam
     })
   }, async ({ courseId, courseworkId, account }) => {
-    return runOrDiagnose(["classroom", "coursework", "get", courseId, courseworkId], { account });
+    return runOrDiagnose(["classroom", "coursework", "get", pos(courseId), pos(courseworkId)], { account });
   });
   server.registerTool("gog_classroom_submissions_list", {
     description: "List student submissions for a coursework item.",
@@ -34701,7 +35595,7 @@ function registerClassroomTools(server) {
       account: accountParam
     })
   }, async ({ courseId, courseworkId, state, late, user, max, pageToken, page, all, account }) => {
-    const args = ["classroom", "submissions", "list", courseId, courseworkId];
+    const args = ["classroom", "submissions", "list", pos(courseId), pos(courseworkId)];
     if (state) args.push(`--state=${state}`);
     if (late) args.push(`--late=${late}`);
     if (user) args.push(`--user=${user}`);
@@ -34721,7 +35615,7 @@ function registerClassroomTools(server) {
       account: accountParam
     })
   }, async ({ courseId, courseworkId, submissionId, account }) => {
-    return runOrDiagnose(["classroom", "submissions", "get", courseId, courseworkId, submissionId], { account });
+    return runOrDiagnose(["classroom", "submissions", "get", pos(courseId), pos(courseworkId), pos(submissionId)], { account });
   });
   server.registerTool("gog_classroom_submissions_grade", {
     description: "Grade a student submission. Set draft and/or assigned grade values.",
@@ -34735,7 +35629,7 @@ function registerClassroomTools(server) {
       account: accountParam
     })
   }, async ({ courseId, courseworkId, submissionId, draft, assigned, account }) => {
-    const args = ["classroom", "submissions", "grade", courseId, courseworkId, submissionId];
+    const args = ["classroom", "submissions", "grade", pos(courseId), pos(courseworkId), pos(submissionId)];
     if (draft) args.push(`--draft=${draft}`);
     if (assigned) args.push(`--assigned=${assigned}`);
     return runOrDiagnose(args, { account });
@@ -34750,7 +35644,7 @@ function registerClassroomTools(server) {
       account: accountParam
     })
   }, async ({ courseId, courseworkId, submissionId, account }) => {
-    return runOrDiagnose(["classroom", "submissions", "return", courseId, courseworkId, submissionId], { account });
+    return runOrDiagnose(["classroom", "submissions", "return", pos(courseId), pos(courseworkId), pos(submissionId)], { account });
   });
   server.registerTool("gog_classroom_submissions_turn_in", {
     description: "Turn in a student submission (student action).",
@@ -34762,7 +35656,7 @@ function registerClassroomTools(server) {
       account: accountParam
     })
   }, async ({ courseId, courseworkId, submissionId, account }) => {
-    return runOrDiagnose(["classroom", "submissions", "turn-in", courseId, courseworkId, submissionId], { account });
+    return runOrDiagnose(["classroom", "submissions", "turn-in", pos(courseId), pos(courseworkId), pos(submissionId)], { account });
   });
   server.registerTool("gog_classroom_submissions_reclaim", {
     description: "Reclaim a turned-in submission (student action to edit a submission).",
@@ -34774,7 +35668,7 @@ function registerClassroomTools(server) {
       account: accountParam
     })
   }, async ({ courseId, courseworkId, submissionId, account }) => {
-    return runOrDiagnose(["classroom", "submissions", "reclaim", courseId, courseworkId, submissionId], { account });
+    return runOrDiagnose(["classroom", "submissions", "reclaim", pos(courseId), pos(courseworkId), pos(submissionId)], { account });
   });
   server.registerTool("gog_classroom_announcements_list", {
     description: "List announcements in a Google Classroom course.",
@@ -34790,7 +35684,7 @@ function registerClassroomTools(server) {
       account: accountParam
     })
   }, async ({ courseId, state, orderBy, max, pageToken, page, all, account }) => {
-    const args = ["classroom", "announcements", "list", courseId];
+    const args = ["classroom", "announcements", "list", pos(courseId)];
     if (state) args.push(`--state=${state}`);
     if (orderBy) args.push(`--order-by=${orderBy}`);
     if (max !== void 0) args.push(`--max=${max}`);
@@ -34808,22 +35702,45 @@ function registerClassroomTools(server) {
       account: accountParam
     })
   }, async ({ courseId, announcementId, account }) => {
-    return runOrDiagnose(["classroom", "announcements", "get", courseId, announcementId], { account });
+    return runOrDiagnose(["classroom", "announcements", "get", pos(courseId), pos(announcementId)], { account });
   });
   server.registerTool("gog_classroom_announcements_create", {
-    description: "Create an announcement in a Google Classroom course.",
+    description: "Create an announcement in a Google Classroom course. Unless state is DRAFT (which students cannot see), this reads the course and asks the MCP host to show the user a confirmation prompt with the class, the full text and when it publishes; nothing is posted unless they accept. To stage one without asking, pass state DRAFT." + CONFIRM_FALLBACK_DESCRIPTION,
     annotations: { destructiveHint: true },
     inputSchema: external_exports.object({
       courseId: external_exports.string().describe("Course ID"),
       text: external_exports.string().describe("Announcement text"),
-      state: external_exports.enum(["PUBLISHED", "DRAFT"]).optional().describe("State"),
+      state: external_exports.enum(["PUBLISHED", "DRAFT"]).optional().describe("State (DRAFT is visible only to teachers and needs no confirmation)"),
       scheduled: external_exports.string().optional().describe("Scheduled publish time"),
-      account: accountParam
+      account: accountParam,
+      confirmToken: confirmTokenParam
     })
-  }, async ({ courseId, text, state, scheduled, account }) => {
-    const args = ["classroom", "announcements", "create", courseId, `--text=${text}`];
+  }, async ({ courseId, text, state, scheduled, account, confirmToken }, ctx) => {
+    const args = ["classroom", "announcements", "create", pos(courseId), `--text=${text}`];
     if (state) args.push(`--state=${state}`);
     if (scheduled) args.push(`--scheduled=${scheduled}`);
+    if (state !== "DRAFT") {
+      const read = await readCourse(courseId, account);
+      if (read.error) return read.error;
+      const publishes = scheduled ? `at ${scheduled}` : "immediately";
+      const confirmation = await requireDispatchConfirmation(ctx, {
+        action: "classroom.announcement-create",
+        message: "Review and confirm this Classroom announcement:",
+        confirmationLabel: "Confirm that this announcement should be posted to the class.",
+        details: { course: read.course, publishes, textPreview: bodyPreview(text) },
+        unsupportedNote: "Create it with state DRAFT instead; the user can review and post it from Classroom.",
+        fallback: {
+          tool: "gog_classroom_announcements_create",
+          account,
+          confirmToken,
+          subject: () => {
+            const view = { course: read.course, publishes, text };
+            return { target: courseId, payload: view, preview: view };
+          }
+        }
+      });
+      if (confirmation) return confirmation;
+    }
     return runOrDiagnose(args, { account });
   });
   server.registerTool("gog_classroom_topics_list", {
@@ -34838,7 +35755,7 @@ function registerClassroomTools(server) {
       account: accountParam
     })
   }, async ({ courseId, max, pageToken, page, all, account }) => {
-    const args = ["classroom", "topics", "list", courseId];
+    const args = ["classroom", "topics", "list", pos(courseId)];
     if (max !== void 0) args.push(`--max=${max}`);
     const token = resolvePageToken({ pageToken, page });
     if (token) args.push(`--page=${token}`);
@@ -34854,7 +35771,7 @@ function registerClassroomTools(server) {
       account: accountParam
     })
   }, async ({ courseId, topicId, account }) => {
-    return runOrDiagnose(["classroom", "topics", "get", courseId, topicId], { account });
+    return runOrDiagnose(["classroom", "topics", "get", pos(courseId), pos(topicId)], { account });
   });
   server.registerTool("gog_classroom_invitations_list", {
     description: "List Google Classroom invitations.",
@@ -34886,7 +35803,7 @@ function registerClassroomTools(server) {
       account: accountParam
     })
   }, async ({ invitationId, account }) => {
-    return runOrDiagnose(["classroom", "invitations", "get", invitationId], { account });
+    return runOrDiagnose(["classroom", "invitations", "get", pos(invitationId)], { account });
   });
   server.registerTool("gog_classroom_invitations_accept", {
     description: "Accept a Google Classroom invitation.",
@@ -34896,7 +35813,7 @@ function registerClassroomTools(server) {
       account: accountParam
     })
   }, async ({ invitationId, account }) => {
-    return runOrDiagnose(["classroom", "invitations", "accept", invitationId], { account });
+    return runOrDiagnose(["classroom", "invitations", "accept", pos(invitationId)], { account });
   });
   server.registerTool("gog_classroom_profile_get", {
     description: "Get a Google Classroom user profile. Omit userId to fetch the authenticated user.",
@@ -34907,12 +35824,13 @@ function registerClassroomTools(server) {
     })
   }, async ({ userId, account }) => {
     const args = ["classroom", "profile", "get"];
-    if (userId) args.push(userId);
+    if (userId) args.push(pos(userId));
     return runOrDiagnose(args, { account });
   });
   registerRunTool(server, {
     service: "classroom",
     examples: '"guardians", "materials", "guardian-invitations"',
+    vet: vetClassroomRun,
     note: "Covers anything not wrapped by the dedicated tools (guardians, guardian-invitations, materials, coursework assignees, announcement assignees, etc.)."
   });
 }
@@ -34927,7 +35845,7 @@ function registerContactsTools(server) {
       account: accountParam
     })
   }, async ({ query, account }) => {
-    return runOrDiagnose(["contacts", "search", query], { account });
+    return runOrDiagnose(["contacts", "search", pos(query)], { account });
   });
   server.registerTool("gog_contacts_list", {
     description: "List all Google Contacts.",
@@ -34946,7 +35864,7 @@ function registerContactsTools(server) {
       account: accountParam
     })
   }, async ({ resourceName, account }) => {
-    return runOrDiagnose(["contacts", "get", resourceName], { account });
+    return runOrDiagnose(["contacts", "get", pos(resourceName)], { account });
   });
   server.registerTool("gog_contacts_create", {
     description: "Create a new Google Contact.",
@@ -34982,7 +35900,7 @@ function registerDocsTools(server) {
       account: accountParam
     })
   }, async ({ docId, account }) => {
-    return runOrDiagnose(["docs", "info", docId], { account });
+    return runOrDiagnose(["docs", "info", pos(docId)], { account });
   });
   server.registerTool("gog_docs_cat", {
     description: "Read a Google Doc as plain text.",
@@ -34993,7 +35911,7 @@ function registerDocsTools(server) {
       account: accountParam
     })
   }, async ({ docId, chips, account }) => {
-    const args = ["docs", "cat", docId];
+    const args = ["docs", "cat", pos(docId)];
     if (chips) args.push("--chips");
     return runOrDiagnose(args, { account });
   });
@@ -35005,7 +35923,7 @@ function registerDocsTools(server) {
       account: accountParam
     })
   }, async ({ title, account }) => {
-    return runOrDiagnose(["docs", "create", title], { account });
+    return runOrDiagnose(["docs", "create", pos(title)], { account });
   });
   server.registerTool("gog_docs_write", {
     description: "Write text content to a Google Doc, replacing existing body content by default. Set append=true to add after existing content.",
@@ -35030,7 +35948,7 @@ function registerDocsTools(server) {
       account: accountParam
     })
   }, async ({ docId, text, append, checkOrphans, bullets, bulletPreset, ordered, noBullets, indentStart, indentEnd, indentFirstLine, spaceAbove, spaceBelow, keepLinesTogether, keepWithNext, batch, account }) => {
-    const args = ["docs", "write", docId, `--text=${text}`];
+    const args = ["docs", "write", pos(docId), `--text=${text}`];
     if (append) args.push("--append");
     if (checkOrphans) args.push("--check-orphans");
     if (bullets) args.push("--bullets");
@@ -35057,7 +35975,7 @@ function registerDocsTools(server) {
       account: accountParam
     })
   }, async ({ docId, find, replace, account }) => {
-    return runOrDiagnose(["docs", "find-replace", docId, find, replace], { account });
+    return runOrDiagnose(["docs", "find-replace", pos(docId), pos(find), pos(replace)], { account });
   });
   server.registerTool("gog_docs_structure", {
     description: "Show a Google Doc's structure with numbered paragraphs. Useful for understanding the document layout before making index-based edits.",
@@ -35067,18 +35985,31 @@ function registerDocsTools(server) {
       account: accountParam
     })
   }, async ({ docId, account }) => {
-    return runOrDiagnose(["docs", "structure", docId], { account });
+    return runOrDiagnose(["docs", "structure", pos(docId)], { account });
   });
   registerRunTool(server, { service: "docs", examples: '"copy", "clear", "insert", "sed", "export"' });
 }
 
 // src/tools/drive.ts
+function vetDriveRun(subcommand, _args) {
+  return subcommand.toLowerCase() === "share" ? gatedElsewhere("gog drive share", "gog_drive_run", "grants access to a file", "gog_drive_share") : void 0;
+}
 var GOOGLE_DOC_MIME = "application/vnd.google-apps.document";
+function shareTargetMeta(raw) {
+  try {
+    const { name, mimeType } = fileMeta(raw);
+    return { name, mimeType };
+  } catch {
+    return {};
+  }
+}
 function fileMeta(raw) {
   const parsed = JSON.parse(raw);
   const f = parsed.file ?? parsed;
-  return { name: f.name, mimeType: f.mimeType };
+  const size = f.size === void 0 ? void 0 : Number(f.size);
+  return { name: f.name, mimeType: f.mimeType, size: Number.isFinite(size) ? size : void 0 };
 }
+var MAX_DRIVE_READ_BYTES = MAX_INLINE_ATTACHMENT_BYTES;
 var DRIVE_LS_COMPACT_FIELDS = "nextPageToken,files(id,name,mimeType,modifiedTime,size,webViewLink)";
 function registerDriveTools(server) {
   server.registerTool("gog_drive_ls", {
@@ -35122,7 +36053,7 @@ function registerDriveTools(server) {
       account: accountParam
     })
   }, async ({ query, view, account }) => {
-    return runOrDiagnose(["drive", "search", query], {
+    return runOrDiagnose(["drive", "search", pos(query)], {
       account,
       stripMedia: resolveView(view, ["compact", "full"]) === "compact"
     });
@@ -35142,7 +36073,7 @@ function registerDriveTools(server) {
       account: accountParam
     })
   }, async ({ fileId, view, account }) => {
-    return runOrDiagnose(["drive", "get", fileId], {
+    return runOrDiagnose(["drive", "get", pos(fileId)], {
       account,
       stripMedia: resolveView(view, ["compact", "full"]) === "compact"
     });
@@ -35155,7 +36086,7 @@ function registerDriveTools(server) {
       account: accountParam
     })
   }, async ({ name, account }) => {
-    return runOrDiagnose(["drive", "mkdir", name], { account });
+    return runOrDiagnose(["drive", "mkdir", pos(name)], { account });
   });
   server.registerTool("gog_drive_rename", {
     description: "Rename a file or folder in Google Drive.",
@@ -35166,7 +36097,7 @@ function registerDriveTools(server) {
       account: accountParam
     })
   }, async ({ fileId, newName, account }) => {
-    return runOrDiagnose(["drive", "rename", fileId, newName], { account });
+    return runOrDiagnose(["drive", "rename", pos(fileId), pos(newName)], { account });
   });
   server.registerTool("gog_drive_move", {
     description: "Move a file to a different folder in Google Drive.",
@@ -35177,7 +36108,7 @@ function registerDriveTools(server) {
       account: accountParam
     })
   }, async ({ fileId, parentId, account }) => {
-    return runOrDiagnose(["drive", "move", fileId, `--parent=${parentId}`], { account });
+    return runOrDiagnose(["drive", "move", pos(fileId), `--parent=${parentId}`], { account });
   });
   server.registerTool("gog_drive_delete", {
     description: "Move a Google Drive file to trash, or permanently delete it with permanent=true (irreversible).",
@@ -35188,13 +36119,13 @@ function registerDriveTools(server) {
       account: accountParam
     })
   }, async ({ fileId, permanent, account }) => {
-    const args = ["drive", "delete", fileId];
+    const args = ["drive", "delete", pos(fileId)];
     if (permanent) args.push("--permanent");
     args.push("--force");
     return runOrDiagnose(args, { account });
   });
   server.registerTool("gog_drive_share", {
-    description: "Share a Google Drive file or folder.",
+    description: "Share a Google Drive file or folder. Granting access is the risk even though no email is sent (gog does not notify by default), so this reads the file and asks the MCP host to show the user a confirmation prompt naming it, who gets access and with what role; nothing is shared unless they accept." + CONFIRM_FALLBACK_DESCRIPTION,
     annotations: { destructiveHint: true },
     inputSchema: external_exports.object({
       fileId: external_exports.string().describe("File or folder ID"),
@@ -35202,10 +36133,36 @@ function registerDriveTools(server) {
       email: external_exports.string().optional().describe("User email (required when to=user)"),
       domain: external_exports.string().optional().describe("Domain (required when to=domain)"),
       role: external_exports.enum(["reader", "writer"]).optional().describe("Permission role (default: reader)"),
-      account: accountParam
+      account: accountParam,
+      confirmToken: confirmTokenParam
     })
-  }, async ({ fileId, to, email: email3, domain: domain2, role, account }) => {
-    const args = ["drive", "share", fileId, `--to=${to}`];
+  }, async ({ fileId, to, email: email3, domain: domain2, role, account, confirmToken }, ctx) => {
+    const got = await runOrDiagnose(["drive", "get", pos(fileId)], { account });
+    if (got.isError) return got;
+    const file2 = { id: fileId, ...shareTargetMeta(resultText(got)) };
+    const grant = {
+      file: file2,
+      to,
+      ...email3 ? { email: email3 } : {},
+      ...domain2 ? { domain: domain2 } : {},
+      role: role ?? "reader",
+      publicLink: to === "anyone"
+    };
+    const confirmation = await requireDispatchConfirmation(ctx, {
+      action: "drive.share",
+      message: to === "anyone" ? "Review and confirm making this file available to ANYONE with the link:" : "Review and confirm this Drive share:",
+      confirmationLabel: "Confirm that this access should be granted now.",
+      details: grant,
+      unsupportedNote: "Ask the user to share it themselves from Google Drive.",
+      fallback: {
+        tool: "gog_drive_share",
+        account,
+        confirmToken,
+        subject: () => ({ target: fileId, payload: grant, preview: grant })
+      }
+    });
+    if (confirmation) return confirmation;
+    const args = ["drive", "share", pos(fileId), `--to=${to}`];
     if (email3) args.push(`--email=${email3}`);
     if (domain2) args.push(`--domain=${domain2}`);
     if (role) args.push(`--role=${role}`);
@@ -35228,7 +36185,7 @@ function registerDriveTools(server) {
   }, async ({ fileId, ocrLanguage, offset = 0, maxChars, account }) => {
     let tempDocId;
     try {
-      const { name, mimeType } = fileMeta(await run(["drive", "get", fileId], { account }));
+      const { name, mimeType } = fileMeta(await run(["drive", "get", pos(fileId)], { account }));
       let sourceId = fileId;
       if (mimeType !== GOOGLE_DOC_MIME) {
         const params = JSON.stringify({ fileId, ...ocrLanguage ? { ocrLanguage } : {} });
@@ -35273,13 +36230,13 @@ function registerDriveTools(server) {
       return diagnose(err);
     } finally {
       if (tempDocId) {
-        await run(["drive", "delete", tempDocId, "--permanent", "--force"], { account }).catch(() => {
+        await run(["drive", "delete", pos(tempDocId), "--permanent", "--force"], { account }).catch(() => {
         });
       }
     }
   });
   server.registerTool("gog_drive_read_bytes", {
-    description: "Fetch a Drive file's raw bytes and return them base64-encoded as an embedded resource \u2014 the generic fallback for callers that want the file itself (to parse locally) rather than extracted text. For readable text from a PDF, prefer gog_drive_extract_text.",
+    description: "Fetch a Drive file's raw bytes and return them base64-encoded as an embedded resource \u2014 the generic fallback for callers that want the file itself (to parse locally) rather than extracted text. Files over 8 MiB are refused (checked before downloading). For readable text from a PDF, prefer gog_drive_extract_text.",
     annotations: { readOnlyHint: true },
     inputSchema: external_exports.object({
       fileId: external_exports.string().describe("Drive file ID"),
@@ -35287,9 +36244,17 @@ function registerDriveTools(server) {
     })
   }, async ({ fileId, account }) => {
     try {
-      const { name, mimeType } = fileMeta(await run(["drive", "get", fileId], { account }));
+      const { name, mimeType, size } = fileMeta(await run(["drive", "get", pos(fileId)], { account }));
+      if (size !== void 0 && size > MAX_DRIVE_READ_BYTES) {
+        return errorResult(
+          `${name ?? fileId} is ${size} bytes, over the 8 MiB this tool returns inline. Use gog_drive_extract_text for its text, or share its webViewLink (gog_drive_get) instead.`
+        );
+      }
       const params = JSON.stringify({ fileId, alt: "media" });
-      const blob = await runBinary(["api", "call", "drive", "v3", "files.get", `--params=${params}`], { account });
+      const blob = await runBinary(
+        ["api", "call", "drive", "v3", "files.get", `--params=${params}`],
+        { account, maxOutputBytes: MAX_DRIVE_READ_BYTES }
+      );
       const type = mimeType ?? "application/octet-stream";
       const unrenderableHint = type.startsWith("image/") ? "" : ` If your client does not render a ${type} resource, gog_drive_extract_text returns the same file as text (PDFs included, via OCR).`;
       return {
@@ -35309,7 +36274,7 @@ function registerDriveTools(server) {
       return diagnose(err);
     }
   });
-  registerRunTool(server, { service: "drive", examples: '"copy", "upload", "download", "permissions"' });
+  registerRunTool(server, { service: "drive", examples: '"copy", "download", "permissions"', vet: vetDriveRun });
 }
 
 // src/gmail-results.ts
@@ -35337,7 +36302,7 @@ async function countMatches(method, itemsKey, query, account) {
       maxResults: COUNT_PROBE_PAGE_SIZE,
       fields: `${itemsKey}/id,nextPageToken`
     });
-    const raw = await run(["api", "call", "gmail", "v1", method, `--params=${params}`], { account });
+    const raw = await run(["api", "call", "gmail", "v1", pos(method), `--params=${params}`], { account });
     const parsed = JSON.parse(raw);
     const items = parsed[itemsKey];
     if (!Array.isArray(items)) return {};
@@ -35376,7 +36341,7 @@ async function fetchGmailPages(runPage, itemsKey, maxPages, startToken) {
     const result = await runPage(token);
     const parsed = parsePage(result, itemsKey);
     if (parsed === void 0) {
-      return base === void 0 ? result : finish(base, itemsKey, merged, token);
+      return base === void 0 ? result : finish(base, itemsKey, merged, token, pageErrorText(result, itemsKey, pages + 1));
     }
     base = parsed;
     merged.push(...parsed[itemsKey]);
@@ -35407,10 +36372,18 @@ function parsePage(result, itemsKey) {
   const obj = parsed;
   return Array.isArray(obj[itemsKey]) ? obj : void 0;
 }
-function finish(base, itemsKey, merged, token) {
+var PAGE_ERROR_MAX = 2e3;
+function pageErrorText(result, itemsKey, n) {
+  const first = result.content[0];
+  const text = first?.type === "text" ? first.text.slice(0, PAGE_ERROR_MAX) : "";
+  if (result.isError) return `page ${n} failed${text ? `: ${text}` : ""}`;
+  return `page ${n} returned output that is not a ${itemsKey} list`;
+}
+function finish(base, itemsKey, merged, token, pageError) {
   const out = { ...base, [itemsKey]: merged };
   if (token === void 0) delete out.nextPageToken;
   else out.nextPageToken = token;
+  if (pageError !== void 0) out.pageError = pageError;
   return rawTextResult(JSON.stringify(out));
 }
 
@@ -35424,16 +36397,19 @@ var STAGING_TWIN = {
   "gmail.reply-all": "gog_gmail_drafts_reply_all",
   "gmail.send": "gog_gmail_drafts_create"
 };
-function requireGmailDispatchConfirmation(ctx, op, details) {
+var UNSUPPORTED_NOTE2 = {
+  "gmail.drafts-send": "The draft is still saved: ask the user to review it and send it from Gmail."
+};
+async function requireGmailDispatchConfirmation(ctx, op, details, fallback) {
   const twin = STAGING_TWIN[op];
-  return requireConfirmation(ctx, {
+  const note = twin ? `Stage it with ${twin} instead; the user can review the draft and send it from Gmail (gog_gmail_drafts_send also asks for confirmation).` : UNSUPPORTED_NOTE2[op];
+  return requireDispatchConfirmation(ctx, {
     action: op,
-    message: "Review and confirm this email dispatch:",
+    message: op === "gmail.filter-forward" ? "Review and confirm this mail-forwarding filter:" : "Review and confirm this email dispatch:",
     details,
-    confirmationLabel: "Confirm that this email should be sent now.",
-    ...twin ? {
-      unsupportedNote: `Stage it with ${twin} instead, review the draft, and send it with gog_gmail_drafts_send.`
-    } : {}
+    confirmationLabel: op === "gmail.filter-forward" ? "Confirm that matching mail should be forwarded automatically from now on." : "Confirm that this email should be sent now.",
+    unsupportedNote: note,
+    ...fallback ? { fallback: { instruction: CONFIRM_SEND_INSTRUCTION, ...fallback } } : {}
   });
 }
 var EMAIL_PATTERN = /[a-z0-9!#$%&'*+/=?^_`{|}~.-]+@[a-z0-9-]+(?:\.[a-z0-9-]+)+/gi;
@@ -35487,10 +36463,6 @@ function logGmailDispatch(tool, recipients, account) {
   process.stderr.write(`${JSON.stringify(event)}
 `);
 }
-function resultText(result) {
-  const first = result.content[0];
-  return first && first.type === "text" && typeof first.text === "string" ? first.text : "{}";
-}
 
 // src/tools/gmail.ts
 var replySchema = {
@@ -35504,7 +36476,7 @@ var replySchema = {
   remove: external_exports.array(external_exports.string()).optional().describe("Remove these recipients from all fields (repeatable) \u2014 e.g. to drop someone from a reply-all."),
   subject: external_exports.string().optional().describe('Override reply subject (default: "Re: <original>"). A changed subject starts a NEW Gmail thread.'),
   noQuote: external_exports.boolean().optional().describe("Do not include the original message quoted below the reply (default: the original is quoted)"),
-  attach: external_exports.array(external_exports.string()).optional().describe(`File paths to attach (repeatable), resolved ON THE GOG SERVER's filesystem \u2014 NOT this client's. Only usable when gog runs on the same machine you do (local stdio); on a hosted deployment (e.g. mcp-host) these paths do not exist and the call fails with "no such file or directory" \u2014 use attachInline there. Read on the server, base64-encoded with a MIME type inferred from the extension.`),
+  attach: external_exports.array(external_exports.string()).optional().describe(`File paths to attach (repeatable), resolved ON THE GOG SERVER's filesystem \u2014 NOT this client's. Only usable when gog runs on the same machine you do (local stdio); on a hosted deployment (e.g. mcp-host) these paths do not exist and the call fails with "no such file or directory" \u2014 use attachInline there. Read on the server, base64-encoded with a MIME type inferred from the extension. Must be inside the server's GOG_FILE_ROOTS directories (default ~/gogcli-mcp-files).`),
   attachInline: attachInlineParam,
   from: external_exports.string().optional().describe("Send from this email address (must be a verified send-as alias)"),
   autoFromAddressedAlias: external_exports.boolean().optional().describe("When from is omitted, send from the verified send-as alias the original message was addressed TO, instead of the account's primary address \u2014 so a reply to mail sent to an alias goes back out from that alias. Ignored when from is set."),
@@ -35513,8 +36485,14 @@ var replySchema = {
   signatureFile: external_exports.string().optional().describe("Append a local signature file (plain text or HTML), read on the gog server"),
   account: accountParam
 };
+function confineReplyPaths(f) {
+  confinePaths(f.attach, "attach");
+  if (f.bodyHtmlFile) confinePath(f.bodyHtmlFile, "bodyHtmlFile");
+  if (f.signatureFile) confinePath(f.signatureFile, "signatureFile");
+}
 function appendReplyFlags(args, f) {
   assertNotBoth("bodyHtml", "bodyHtmlFile", f.bodyHtml, f.bodyHtmlFile);
+  confineReplyPaths(f);
   if (f.body) args.push(payloadArg("body", "body-file", f.body));
   if (f.bodyHtml) args.push(payloadArg("body-html", "body-html-file", f.bodyHtml, "html"));
   else if (f.bodyHtmlFile) args.push(`--body-html-file=${f.bodyHtmlFile}`);
@@ -35532,7 +36510,7 @@ function appendReplyFlags(args, f) {
   if (f.signatureFile) args.push(`--signature-file=${f.signatureFile}`);
   args.push(f.autoFromAddressedAlias ? "--auto-from-addressed-alias" : "--auto-from-addressed-alias=false");
 }
-var sendReplySchema = external_exports.object(replySchema);
+var sendReplySchema = external_exports.object({ ...replySchema, confirmToken: confirmTokenParam });
 function parseMetadataHeaders(raw) {
   let parsed;
   try {
@@ -35557,27 +36535,110 @@ function computeReplyRecipients(kind, headers, flags) {
   }
   return emails;
 }
-async function sendReply(kind, toolName, messageId, account, flags, ctx) {
-  const metaResult = await runOrDiagnose(["gmail", "get", messageId, "--format=metadata"], { account });
+function metadataThreadId(raw) {
+  try {
+    const threadId = JSON.parse(raw)?.message?.threadId;
+    return typeof threadId === "string" ? threadId : void 0;
+  } catch {
+    return void 0;
+  }
+}
+function replyTokenSubject(kind, messageId, account, headers, threadId, flags) {
+  const removed = new Set(extractEmails(...flags.remove ?? []));
+  const keep = (emails) => emails.filter((e) => !removed.has(e));
+  const to = keep(extractEmails(headers.from, ...kind === "reply-all" ? [headers.to] : [], ...flags.to ?? []));
+  const cc = keep(extractEmails(...kind === "reply-all" ? [headers.cc] : [], ...flags.cc ?? []));
+  const bcc = keep(extractEmails(...flags.bcc ?? []));
+  const attachments = attachmentDetails(flags.attach, flags.attachInline);
+  const subject = flags.subject || (headers.subject ? `Re: ${headers.subject}` : void 0);
+  const from = flags.from ?? (flags.autoFromAddressedAlias ? "the send-as alias the original was addressed to" : senderPreview(account));
+  const localFiles = attachmentDetails([flags.bodyHtmlFile, flags.signatureFile].filter((p) => Boolean(p)), void 0);
+  return {
+    target: messageId,
+    payload: {
+      kind,
+      to,
+      cc,
+      bcc,
+      subject,
+      from,
+      body: flags.body,
+      bodyHtml: flags.bodyHtml,
+      localFiles,
+      signature: Boolean(flags.signature),
+      signatureFrom: flags.signatureFrom,
+      attachments,
+      quote: !flags.noQuote,
+      threadId,
+      inReplyTo: headers.message_id,
+      references: headers.references
+    },
+    preview: {
+      from,
+      to,
+      cc,
+      bcc,
+      subject,
+      body: flags.body,
+      ...flags.bodyHtml ? { bodyHtml: flags.bodyHtml } : {},
+      ...flags.bodyHtmlFile ? { bodyHtmlFile: flags.bodyHtmlFile } : {},
+      ...flags.signature || flags.signatureFrom || flags.signatureFile ? { signature: flags.signatureFile ?? flags.signatureFrom ?? "the Gmail signature of the sending address" } : {},
+      quotesOriginal: !flags.noQuote,
+      attachments: attachmentPreview(attachments),
+      replyingToMessageId: messageId,
+      threadId,
+      inReplyTo: headers.message_id
+    }
+  };
+}
+async function sendReply(kind, toolName, messageId, account, flags, ctx, confirmToken) {
+  const metaResult = await runOrDiagnose(["gmail", "get", pos(messageId), "--format=metadata"], { account });
   if (metaResult.isError) return metaResult;
-  const headers = parseMetadataHeaders(resultText(metaResult));
+  const metaText = resultText(metaResult);
+  const headers = parseMetadataHeaders(metaText);
   const recipients = computeReplyRecipients(kind, headers, flags);
-  const confirmation = requireGmailDispatchConfirmation(ctx, replyDispatchOp(kind), {
+  const confirmation = await requireGmailDispatchConfirmation(ctx, replyDispatchOp(kind), {
     messageId,
     recipients,
     recipientCount: recipients.length,
     subject: flags.subject || (headers.subject ? `Re: ${headers.subject}` : void 0),
     quoting: !flags.noQuote,
     bodyLength: (flags.body ?? flags.bodyHtml ?? "").length,
-    attachmentCount: (flags.attach?.length ?? 0) + (flags.attachInline?.length ?? 0)
+    bodyPreview: bodyPreview(flags.body ?? flags.bodyHtml),
+    bodyHtmlFile: flags.bodyHtmlFile,
+    attachmentCount: (flags.attach?.length ?? 0) + (flags.attachInline?.length ?? 0),
+    attachments: attachmentNames(flags.attach, flags.attachInline)
+  }, {
+    tool: toolName,
+    account,
+    confirmToken,
+    // The metadata read above IS the phase-2 re-read: it runs on every call,
+    // so the original's Message-ID/References are fresh here.
+    subject: () => replyTokenSubject(kind, messageId, account, headers, metadataThreadId(metaText), flags)
   });
   if (confirmation) return confirmation;
-  const args = ["gmail", kind, messageId];
+  const args = ["gmail", kind, pos(messageId)];
   appendReplyFlags(args, flags);
   const result = await runOrDiagnose(args, { account });
   if (!result.isError) logGmailDispatch(toolName, recipients, account);
   return result;
 }
+var GMAIL_RUN_BLOCKED_SETTINGS = /* @__PURE__ */ new Set(["forwarding", "autoforward", "filters", "delegates"]);
+function vetGmailRun(subcommand, args) {
+  if (subcommand === "autoreply") {
+    return "gog gmail autoreply sends mail and is not available through gog_gmail_run. Use gog_gmail_autoreply, which asks the user to confirm.";
+  }
+  if (GMAIL_RUN_BLOCKED_SETTINGS.has(subcommand)) {
+    return `gog gmail ${subcommand} can forward or hand over mail and is not available through gog_gmail_run. Use the dedicated gog_gmail_* tool instead.`;
+  }
+  if (subcommand === "settings") {
+    const blocked = hasCommandWord(args, GMAIL_RUN_BLOCKED_SETTINGS);
+    if (blocked) {
+      return `gog gmail settings ${blocked} can forward or hand over mail and is not available through gog_gmail_run. Use the dedicated gog_gmail_* tool instead.`;
+    }
+  }
+  return void 0;
+}
 function registerGmailTools(server) {
   server.registerTool("gog_gmail_search", {
     description: 'Search Gmail threads using Gmail query syntax (e.g. "from:alice subject:invoice is:unread"). The query is passed verbatim to Gmail; a bare name token (from:alison) matches per Gmail\'s own heuristics, a full address (from:alison@example.com) is exact. To match a contact across several addresses, OR them: from:(a@x.com OR b@y.com). Results are ALWAYS newest-first by Gmail\'s internalDate \u2014 the wrapper sorts them, so the first result is the most recent match and a recent message can never be buried below older ones. IMPORTANT \u2014 a response carrying "truncated": true is an INCOMPLETE view of the matches: NEVER report that a message does not exist, or that there is no such mail, on the strength of one. Page through it (pass nextPageToken back as `pageToken`), set maxPages to walk several pages in one call, or narrow the query, and only then draw a conclusion. If you already know the thread, do not search for it at all \u2014 read it directly with gog_gmail_thread_get, which returns the whole thread and cannot be truncated or mis-ranked.',
@@ -35593,7 +36654,7 @@ function registerGmailTools(server) {
       account: accountParam
     })
   }, async ({ query, max, pageToken, page, maxPages, all, fromContact, account }) => {
-    const args = ["gmail", "search", query];
+    const args = ["gmail", "search", pos(query)];
     if (max !== void 0) args.push(`--max=${max}`);
     if (all) args.push("--all");
     if (fromContact) args.push(`--from-contact=${fromContact}`);
@@ -35624,13 +36685,13 @@ function registerGmailTools(server) {
       account: accountParam
     })
   }, async ({ messageId, format, sanitizeContent, account }) => {
-    const args = ["gmail", "get", messageId];
+    const args = ["gmail", "get", pos(messageId)];
     if (format) args.push(`--format=${format}`);
     if (sanitizeContent) args.push("--sanitize-content");
     return runOrDiagnose(args, { account });
   });
   server.registerTool("gog_gmail_send", {
-    description: 'SENDS MAIL \u2014 asks the MCP host to show a confirmation prompt with the recipients, subject, and body size. Mail is sent only after the user accepts that prompt. Two ways to attach a file: `attach` takes paths READ ON THE GOG SERVER, and `attachInline` takes the bytes themselves. Use attachInline unless you know the file exists on the same machine gog runs on \u2014 on the hosted connector and any remote deployment there is no shared filesystem, so no path you can name resolves there and `attach` will fail with "no such file or directory". When either is used, the JSON result echoes the attached filenames and byte sizes \u2014 check it to confirm the files were embedded. NOT the tool for answering a message: replyToMessageId only files this in the right thread \u2014 the subject, recipients and body are entirely yours, and the original is not quoted unless you set quote. Use gog_gmail_reply / gog_gmail_reply_all instead, which inherit all three.',
+    description: 'SENDS MAIL \u2014 asks the MCP host to show a confirmation prompt with the recipients, subject, a preview of the body and the attachment names. Mail is sent only after the user accepts that prompt. Two ways to attach a file: `attach` takes paths READ ON THE GOG SERVER, and `attachInline` takes the bytes themselves. Use attachInline unless you know the file exists on the same machine gog runs on \u2014 on the hosted connector and any remote deployment there is no shared filesystem, so no path you can name resolves there and `attach` will fail with "no such file or directory". When either is used, the JSON result echoes the attached filenames and byte sizes \u2014 check it to confirm the files were embedded. NOT the tool for answering a message: replyToMessageId only files this in the right thread \u2014 the subject, recipients and body are entirely yours, and the original is not quoted unless you set quote. Use gog_gmail_reply / gog_gmail_reply_all instead, which inherit all three.' + CONFIRM_FALLBACK_DESCRIPTION,
     annotations: { destructiveHint: true },
     inputSchema: external_exports.object({
       to: external_exports.string().describe("Recipient(s), comma-separated"),
@@ -35641,11 +36702,13 @@ function registerGmailTools(server) {
       replyToMessageId: external_exports.string().optional().describe('Message ID to thread this message against \u2014 sets In-Reply-To/References only. It does NOT quote the original (pass quote for that), inherit its recipients, or prefix the subject with "Re:". For an actual reply use gog_gmail_reply.'),
       threadId: external_exports.string().optional().describe("Thread ID to thread this message within. Same caveat as replyToMessageId: threading only, no quote and no inherited subject or recipients."),
       quote: external_exports.boolean().optional().describe("Include the original message quoted below the body. Requires replyToMessageId or threadId. gog quotes by DEFAULT on gmail reply but never on gmail send, so without this a threaded send arrives with the original nowhere in it."),
-      attach: external_exports.array(external_exports.string()).optional().describe(`File paths to attach (repeatable), resolved ON THE GOG SERVER's filesystem \u2014 NOT this client's. Only usable when gog runs on the same machine you do (local stdio); on a hosted deployment (e.g. mcp-host) these paths do not exist and the call fails with "no such file or directory" \u2014 use attachInline there. Each file is read on the server, base64-encoded with a MIME type inferred from its extension, and added as a multipart attachment.`),
+      attach: external_exports.array(external_exports.string()).optional().describe(`File paths to attach (repeatable), resolved ON THE GOG SERVER's filesystem \u2014 NOT this client's. Only usable when gog runs on the same machine you do (local stdio); on a hosted deployment (e.g. mcp-host) these paths do not exist and the call fails with "no such file or directory" \u2014 use attachInline there. Each file is read on the server, base64-encoded with a MIME type inferred from its extension, and added as a multipart attachment. Must be inside the server's GOG_FILE_ROOTS directories (default ~/gogcli-mcp-files).`),
       attachInline: attachInlineParam,
-      account: accountParam
+      account: accountParam,
+      confirmToken: confirmTokenParam
     })
-  }, async ({ to, subject, body, cc, bcc, replyToMessageId, threadId, quote, attach, attachInline, account }, ctx) => {
+  }, async ({ to, subject, body, cc, bcc, replyToMessageId, threadId, quote, attach, attachInline, account, confirmToken }, ctx) => {
+    confinePaths(attach, "attach");
     const args = ["gmail", "send", `--to=${to}`, `--subject=${subject}`, payloadArg("body", "body-file", body)];
     if (cc) args.push(`--cc=${cc}`);
     if (bcc) args.push(`--bcc=${bcc}`);
@@ -35656,7 +36719,7 @@ function registerGmailTools(server) {
     const inline = inlineAttachmentArgs("attach", attachInline, args);
     args.push(...inline);
     const recipients = extractEmails(to, cc, bcc);
-    const confirmation = requireGmailDispatchConfirmation(ctx, "gmail.send", {
+    const confirmation = await requireGmailDispatchConfirmation(ctx, "gmail.send", {
       to,
       cc,
       bcc,
@@ -35664,9 +36727,37 @@ function registerGmailTools(server) {
       recipientCount: recipients.length,
       subject,
       bodyLength: body.length,
+      bodyPreview: bodyPreview(body),
       threaded: Boolean(replyToMessageId || threadId),
       quoting: Boolean(quote),
-      attachmentCount: (attach?.length ?? 0) + (attachInline?.length ?? 0)
+      attachmentCount: (attach?.length ?? 0) + (attachInline?.length ?? 0),
+      attachments: attachmentNames(attach, attachInline)
+    }, {
+      tool: "gog_gmail_send",
+      account,
+      confirmToken,
+      // Nothing is stored between the phases: the payload IS the arguments,
+      // so phase 2 must repeat them and any difference is a changed send.
+      subject: () => {
+        const attachments = attachmentDetails(attach, attachInline);
+        const from = senderPreview(account);
+        return {
+          target: replyToMessageId ?? threadId ?? "",
+          payload: { from, to, cc, bcc, subject, body, attachments, threadId, inReplyTo: replyToMessageId, quote: Boolean(quote) },
+          preview: {
+            from,
+            to,
+            cc,
+            bcc,
+            subject,
+            body,
+            attachments: attachmentPreview(attachments),
+            threadId,
+            inReplyTo: replyToMessageId,
+            quotesOriginal: Boolean(quote)
+          }
+        };
+      }
     });
     if (confirmation) return confirmation;
     const result = await runOrDiagnose(args, { account });
@@ -35674,22 +36765,32 @@ function registerGmailTools(server) {
     return result;
   });
   server.registerTool("gog_gmail_reply", {
-    description: 'SENDS MAIL \u2014 asks the MCP host to show a confirmation prompt with the resolved recipient, subject, and body size. Mail is sent only after the user accepts that prompt. To STAGE a reply instead of sending it, use gog_gmail_drafts_reply (gogcli-mcp-gmail only), which never needs confirmation. Reply to a Gmail message (goes to the original sender only). USE THIS, not gog_gmail_send, whenever you are answering a message: it threads off the original AND inherits its "Re:" subject and quotes its body below yours, which gog_gmail_send does not \u2014 a send with replyToMessageId lands in the right thread but reads as a brand-new message, with the original nowhere in it. To answer every participant use gog_gmail_reply_all. The gogcli-mcp-gmail package adds two more routes with the same composition: gog_gmail_autoreply to reply across every message matching a query, and gog_gmail_drafts_reply to stage this exact reply as a draft instead of sending it.',
+    description: 'SENDS MAIL \u2014 asks the MCP host to show a confirmation prompt with the resolved recipient, subject, a preview of the body and the attachment names. Mail is sent only after the user accepts that prompt. To STAGE a reply instead of sending it, use gog_gmail_drafts_reply (gogcli-mcp-gmail only), which never needs confirmation. Reply to a Gmail message (goes to the original sender only). USE THIS, not gog_gmail_send, whenever you are answering a message: it threads off the original AND inherits its "Re:" subject and quotes its body below yours, which gog_gmail_send does not \u2014 a send with replyToMessageId lands in the right thread but reads as a brand-new message, with the original nowhere in it. To answer every participant use gog_gmail_reply_all. The gogcli-mcp-gmail package adds two more routes with the same composition: gog_gmail_autoreply to reply across every message matching a query, and gog_gmail_drafts_reply to stage this exact reply as a draft instead of sending it.' + CONFIRM_FALLBACK_DESCRIPTION,
     annotations: { destructiveHint: true },
     inputSchema: sendReplySchema
-  }, async ({ messageId, account, ...flags }, ctx) => {
+  }, async ({ messageId, account, confirmToken, ...flags }, ctx) => {
     assertNotBoth("bodyHtml", "bodyHtmlFile", flags.bodyHtml, flags.bodyHtmlFile);
-    return sendReply("reply", "gog_gmail_reply", messageId, account, flags, ctx);
+    confineReplyPaths(flags);
+    return sendReply("reply", "gog_gmail_reply", messageId, account, flags, ctx, confirmToken);
   });
   server.registerTool("gog_gmail_reply_all", {
-    description: 'SENDS MAIL \u2014 asks the MCP host to show a confirmation prompt with the resolved recipients, subject, and body size. Mail is sent only after the user accepts that prompt. To STAGE a reply-all instead of sending it, use gog_gmail_drafts_reply_all (gogcli-mcp-gmail only), which never needs confirmation. Reply to all participants of a Gmail message (the sender plus every To/Cc recipient). Same inherited "Re:" subject and quoted original as gog_gmail_reply. Use the remove flag to drop specific recipients from the reply-all.',
+    description: 'SENDS MAIL \u2014 asks the MCP host to show a confirmation prompt with the resolved recipients, subject, a preview of the body and the attachment names. Mail is sent only after the user accepts that prompt. To STAGE a reply-all instead of sending it, use gog_gmail_drafts_reply_all (gogcli-mcp-gmail only), which never needs confirmation. Reply to all participants of a Gmail message (the sender plus every To/Cc recipient). Same inherited "Re:" subject and quoted original as gog_gmail_reply. Use the remove flag to drop specific recipients from the reply-all.' + CONFIRM_FALLBACK_DESCRIPTION,
     annotations: { destructiveHint: true },
     inputSchema: sendReplySchema
-  }, async ({ messageId, account, ...flags }, ctx) => {
+  }, async ({ messageId, account, confirmToken, ...flags }, ctx) => {
     assertNotBoth("bodyHtml", "bodyHtmlFile", flags.bodyHtml, flags.bodyHtmlFile);
-    return sendReply("reply-all", "gog_gmail_reply_all", messageId, account, flags, ctx);
+    confineReplyPaths(flags);
+    return sendReply("reply-all", "gog_gmail_reply_all", messageId, account, flags, ctx, confirmToken);
+  });
+  registerRunTool(server, {
+    service: "gmail",
+    examples: '"archive", "mark-read", "labels"',
+    // gog's --gmail-no-send blocks send/reply/forward/drafts send and all of
+    // their aliases at runtime (verified on gog 0.41.0). Sending goes through the
+    // confirmed tools, never this escape hatch.
+    gmailNoSend: true,
+    vet: vetGmailRun
   });
-  registerRunTool(server, { service: "gmail", examples: '"archive", "mark-read", "labels"' });
 }
 
 // src/tools/sheets-a1.ts
@@ -35758,7 +36859,7 @@ function registerSheetsTools(server) {
       account: accountParam
     })
   }, async ({ spreadsheetId, range, account }) => {
-    return runOrDiagnose(["sheets", "get", spreadsheetId, range], { account });
+    return runOrDiagnose(["sheets", "get", pos(spreadsheetId), pos(range)], { account });
   });
   server.registerTool("gog_sheets_update", {
     description: 'Write values to a Google Sheets range, overwriting existing content. Values may be strings, numbers, booleans, or null. Strings starting with "=" are interpreted as formulas (e.g. "=SUM(A1:A10)").',
@@ -35778,7 +36879,7 @@ function registerSheetsTools(server) {
       const readRange = expandAnchorRange(range, values.length, cols);
       let existing;
       try {
-        existing = await run(["sheets", "get", spreadsheetId, readRange], { account });
+        existing = await run(["sheets", "get", pos(spreadsheetId), pos(readRange)], { account });
       } catch (err) {
         return diagnose(err);
       }
@@ -35790,7 +36891,7 @@ function registerSheetsTools(server) {
         );
       }
     }
-    const args = ["sheets", "update", spreadsheetId, range, `--values-json=${JSON.stringify(values)}`];
+    const args = ["sheets", "update", pos(spreadsheetId), pos(range), `--values-json=${JSON.stringify(values)}`];
     if (dry_run) args.push("--dry-run");
     if (fail_on_formula_error) args.push("--fail-on-formula-error");
     return runOrDiagnose(args, { account });
@@ -35806,7 +36907,7 @@ function registerSheetsTools(server) {
       account: accountParam
     })
   }, async ({ spreadsheetId, range, values, account, dry_run }) => {
-    const args = ["sheets", "append", spreadsheetId, range, `--values-json=${JSON.stringify(values)}`];
+    const args = ["sheets", "append", pos(spreadsheetId), pos(range), `--values-json=${JSON.stringify(values)}`];
     if (dry_run) args.push("--dry-run");
     return runOrDiagnose(args, { account });
   });
@@ -35820,7 +36921,7 @@ function registerSheetsTools(server) {
       account: accountParam
     })
   }, async ({ spreadsheetId, range, account, dry_run }) => {
-    const args = ["sheets", "clear", spreadsheetId, range];
+    const args = ["sheets", "clear", pos(spreadsheetId), pos(range)];
     if (dry_run) args.push("--dry-run");
     return runOrDiagnose(args, { account });
   });
@@ -35832,7 +36933,7 @@ function registerSheetsTools(server) {
       account: accountParam
     })
   }, async ({ spreadsheetId, account }) => {
-    return runOrDiagnose(["sheets", "metadata", spreadsheetId], { account });
+    return runOrDiagnose(["sheets", "metadata", pos(spreadsheetId)], { account });
   });
   server.registerTool("gog_sheets_create", {
     description: "Create a new Google Spreadsheet. Returns JSON with the new spreadsheetId and URL.",
@@ -35842,7 +36943,7 @@ function registerSheetsTools(server) {
       account: accountParam
     })
   }, async ({ title, account }) => {
-    return runOrDiagnose(["sheets", "create", title], { account });
+    return runOrDiagnose(["sheets", "create", pos(title)], { account });
   });
   server.registerTool("gog_sheets_find_replace", {
     description: "Find and replace text across an entire Google Spreadsheet.",
@@ -35854,7 +36955,7 @@ function registerSheetsTools(server) {
       account: accountParam
     })
   }, async ({ spreadsheetId, find, replace, account }) => {
-    return runOrDiagnose(["sheets", "find-replace", spreadsheetId, find, replace], { account });
+    return runOrDiagnose(["sheets", "find-replace", pos(spreadsheetId), pos(find), pos(replace)], { account });
   });
   registerRunTool(server, { service: "sheets", examples: '"freeze", "add-tab", "rename-tab"' });
 }
@@ -35862,8 +36963,9 @@ function registerSheetsTools(server) {
 // src/tools/slides.ts
 function registerSlidesTools(server) {
   server.registerTool("gog_slides_export", {
-    description: "Export a Google Slides presentation to a local file (pdf or pptx).",
-    annotations: { readOnlyHint: true },
+    description: "Export a Google Slides presentation to a local file (pdf or pptx). The out path must be inside the server's GOG_FILE_ROOTS directories.",
+    // Writes a file on the gog host and can overwrite one: not read-only.
+    annotations: { readOnlyHint: false, destructiveHint: true },
     inputSchema: external_exports.object({
       presentationId: external_exports.string().describe("Presentation ID"),
       out: external_exports.string().optional().describe("Output file path"),
@@ -35872,7 +36974,8 @@ function registerSlidesTools(server) {
       account: accountParam
     })
   }, async ({ presentationId, out, format, overwrite, account }) => {
-    const args = ["slides", "export", presentationId];
+    if (out) confinePath(out, "out");
+    const args = ["slides", "export", pos(presentationId)];
     if (out) args.push(`--out=${out}`);
     if (format) args.push(`--format=${format}`);
     if (overwrite) args.push("--overwrite");
@@ -35886,7 +36989,7 @@ function registerSlidesTools(server) {
       account: accountParam
     })
   }, async ({ presentationId, account }) => {
-    return runOrDiagnose(["slides", "info", presentationId], { account });
+    return runOrDiagnose(["slides", "info", pos(presentationId)], { account });
   });
   server.registerTool("gog_slides_create", {
     description: "Create a new Google Slides presentation, optionally in a folder or copying from a template.",
@@ -35898,7 +37001,7 @@ function registerSlidesTools(server) {
       account: accountParam
     })
   }, async ({ title, parent, template, account }) => {
-    const args = ["slides", "create", title];
+    const args = ["slides", "create", pos(title)];
     if (parent) args.push(`--parent=${parent}`);
     if (template) args.push(`--template=${template}`);
     return runOrDiagnose(args, { account });
@@ -35913,7 +37016,7 @@ function registerSlidesTools(server) {
       account: accountParam
     })
   }, async ({ presentationId, title, parent, account }) => {
-    const args = ["slides", "copy", presentationId, title];
+    const args = ["slides", "copy", pos(presentationId), pos(title)];
     if (parent) args.push(`--parent=${parent}`);
     return runOrDiagnose(args, { account });
   });
@@ -35925,7 +37028,7 @@ function registerSlidesTools(server) {
       account: accountParam
     })
   }, async ({ presentationId, account }) => {
-    return runOrDiagnose(["slides", "list-slides", presentationId], { account });
+    return runOrDiagnose(["slides", "list-slides", pos(presentationId)], { account });
   });
   server.registerTool("gog_slides_read_slide", {
     description: "Read the content of a slide (text, shapes, speaker notes). Set detail=true to also include normalized element geometry, styled text runs, paragraphs, table-cell content, and image source URLs.",
@@ -35937,11 +37040,11 @@ function registerSlidesTools(server) {
       account: accountParam
     })
   }, async ({ presentationId, slideId, detail, account }) => {
-    const args = ["slides", "read-slide", presentationId, slideId];
+    const args = ["slides", "read-slide", pos(presentationId), pos(slideId)];
     if (detail) args.push("--detail");
     return runOrDiagnose(args, { account });
   });
-  registerRunTool(server, { service: "slides", examples: '"add-slide", "delete-slide", "update-notes"' });
+  registerRunTool(server, { service: "slides", examples: '"delete-slide", "update-notes"' });
 }
 
 // src/tools/tasks.ts
@@ -35963,7 +37066,7 @@ function registerTasksTools(server) {
       account: accountParam
     })
   }, async ({ tasklistId, account }) => {
-    return runOrDiagnose(["tasks", "list", tasklistId], { account });
+    return runOrDiagnose(["tasks", "list", pos(tasklistId)], { account });
   });
   server.registerTool("gog_tasks_get", {
     description: "Get a specific task by ID.",
@@ -35974,7 +37077,7 @@ function registerTasksTools(server) {
       account: accountParam
     })
   }, async ({ tasklistId, taskId, account }) => {
-    return runOrDiagnose(["tasks", "get", tasklistId, taskId], { account });
+    return runOrDiagnose(["tasks", "get", pos(tasklistId), pos(taskId)], { account });
   });
   server.registerTool("gog_tasks_add", {
     description: "Add a task to a Google Task list.",
@@ -35987,7 +37090,7 @@ function registerTasksTools(server) {
       account: accountParam
     })
   }, async ({ tasklistId, title, notes, due, account }) => {
-    const args = ["tasks", "add", tasklistId, `--title=${title}`];
+    const args = ["tasks", "add", pos(tasklistId), `--title=${title}`];
     if (notes) args.push(`--notes=${notes}`);
     if (due) args.push(`--due=${due}`);
     return runOrDiagnose(args, { account });
@@ -36001,7 +37104,7 @@ function registerTasksTools(server) {
       account: accountParam
     })
   }, async ({ tasklistId, taskId, account }) => {
-    return runOrDiagnose(["tasks", "done", tasklistId, taskId], { account });
+    return runOrDiagnose(["tasks", "done", pos(tasklistId), pos(taskId)], { account });
   });
   server.registerTool("gog_tasks_delete", {
     description: "Delete a task.",
@@ -36012,13 +37115,13 @@ function registerTasksTools(server) {
       account: accountParam
     })
   }, async ({ tasklistId, taskId, account }) => {
-    return runOrDiagnose(["tasks", "delete", tasklistId, taskId, "--force"], { account });
+    return runOrDiagnose(["tasks", "delete", pos(tasklistId), pos(taskId), "--force"], { account });
   });
   registerRunTool(server, { service: "tasks", examples: '"update", "undo", "clear"' });
 }
 
 // src/server.ts
-var VERSION = true ? "4.2.5" : "0.0.0";
+var VERSION = true ? "4.4.0" : "0.0.0";
 var BASE_TOOL_REGISTRARS = [
   registerApiTools,
   registerAppScriptTools,
@@ -36036,7 +37139,7 @@ var BASE_TOOL_REGISTRARS = [
 ];
 
 // src/bootstrap-auth.ts
-import { join as join2 } from "node:path";
+import { join as join5 } from "node:path";
 var AUTH_BOOTSTRAP_MARKER = "auth-bootstrap.sha256";
 var VARS = ["GOG_CLIENT_ID", "GOG_CLIENT_SECRET", "GOG_REFRESH_TOKEN", "GOG_ACCOUNT"];
 var log = (line) => {
@@ -36070,12 +37173,12 @@ async function bootstrapGogAuth(env = process.env, options = {}) {
   const [clientId, clientSecret, refreshToken, account] = values;
   const { spawner } = options;
   try {
-    const { createHash } = await import("node:crypto");
+    const { createHash: createHash4 } = await import("node:crypto");
     const { mkdir, readFile, writeFile, chmod } = await import("node:fs/promises");
     const home = options.home ?? (await import("node:os")).homedir();
-    const dir = join2(home, ".gogcli-mcp");
-    const marker = join2(dir, AUTH_BOOTSTRAP_MARKER);
-    const fingerprint = createHash("sha256").update(values.join("\0")).digest("hex");
+    const dir = join5(home, ".gogcli-mcp");
+    const marker = join5(dir, AUTH_BOOTSTRAP_MARKER);
+    const fingerprint = createHash4("sha256").update(values.join("\0")).digest("hex");
     const previous = await readFile(marker, "utf8").catch(() => void 0);
     if (previous === fingerprint && await accountListed(account, spawner)) return "present";
     await run(
@@ -36100,7 +37203,7 @@ async function bootstrapGogAuth(env = process.env, options = {}) {
 }
 
 // src/blob-urls.ts
-import { createHmac } from "node:crypto";
+import { createHmac as createHmac3 } from "node:crypto";
 var BLOB_URL_MAX_TTL_MS = 24 * 60 * 60 * 1e3;
 var BLOB_URL_CEILING_MARGIN_MS = 60 * 1e3;
 var BLOB_URL_DEFAULT_TTL_MS = 60 * 60 * 1e3;
@@ -36112,8 +37215,8 @@ ${exp}`;
 function writePayload(objectKey, contentType, exp) {
   return `put\0${objectKey}\0${contentType}\0${exp}`;
 }
-function sign(signingKey, payload) {
-  return createHmac("sha256", signingKey).update(payload, "utf8").digest("base64url");
+function sign2(signingKey, payload) {
+  return createHmac3("sha256", signingKey).update(payload, "utf8").digest("base64url");
 }
 function objectPathSegments(rest) {
   const segments = rest.split("/");
@@ -36149,7 +37252,7 @@ function createBlobUrlMinter(config2) {
   function mint(rest, exp, payload) {
     const segments = objectPathSegments(rest);
     const url2 = `${basePrefix}/${segments.map(encodeURIComponent).join("/")}`;
-    const signature = sign(config2.signingKey, payload(`${registrationId}/${segments.join("/")}`));
+    const signature = sign2(config2.signingKey, payload(`${registrationId}/${segments.join("/")}`));
     return `${url2}?exp=${exp}&sig=${signature}`;
   }
   return {
@@ -36175,7 +37278,6 @@ function blobStoreFromEnv() {
 }
 
 // src/blob-upload.ts
-var ATTACHMENT_DOWNLOAD_ROOT = "/tmp/gog-attachments";
 var MAX_BLOB_UPLOAD_BYTES = 100 * 1024 * 1024;
 var BLOB_UPLOAD_TIMEOUT_MS = 12e4;
 var ERROR_BODY_SNIPPET = 512;
@@ -36190,10 +37292,10 @@ var UploadError = class extends Error {
 async function resolveConfined(root, requested) {
   const path = await import("node:path");
   const { realpath, stat } = await import("node:fs/promises");
-  const isInside = (base, candidate2) => candidate2 === base || candidate2.startsWith(base + path.sep);
+  const isInside3 = (base, candidate2) => candidate2 === base || candidate2.startsWith(base + path.sep);
   const lexicalRoot = path.resolve(root);
   const candidate = path.resolve(lexicalRoot, requested);
-  if (!isInside(lexicalRoot, candidate)) {
+  if (!isInside3(lexicalRoot, candidate)) {
     throw new UploadError(`the attachment path must be inside ${lexicalRoot}`);
   }
   let realFile;
@@ -36204,7 +37306,7 @@ async function resolveConfined(root, requested) {
   } catch (err) {
     throw new UploadError(`the downloaded attachment could not be found: ${err.message}`);
   }
-  if (!isInside(realRoot, realFile)) {
+  if (!isInside3(realRoot, realFile)) {
     throw new UploadError(`the attachment path must be inside ${realRoot}`);
   }
   const info = await stat(realFile);
@@ -36231,7 +37333,7 @@ async function putFile(target, file2, bytes, contentType, timeoutMs) {
   const { createReadStream } = await import("node:fs");
   const { pipeline } = await import("node:stream");
   const transport = target.protocol === "https:" ? await import("node:https") : await import("node:http");
-  return new Promise((resolve, reject) => {
+  return new Promise((resolve4, reject) => {
     let settled = false;
     const source = createReadStream(file2);
     const req = transport.request(target, {
@@ -36261,7 +37363,7 @@ async function putFile(target, file2, bytes, contentType, timeoutMs) {
         held += chunk.length;
       });
       res.on("error", fail);
-      res.on("end", () => finish2(() => resolve({
+      res.on("end", () => finish2(() => resolve4({
         status: res.statusCode,
         body: Buffer.concat(chunks).toString().slice(0, ERROR_BODY_SNIPPET)
       })));
@@ -36293,11 +37395,14 @@ async function uploadToBlobStore(request, options = {}) {
 }
 export {
   ATTACHMENT_DOWNLOAD_ROOT,
+  ATTACHMENT_TTL_MS,
   AUTH_BOOTSTRAP_MARKER,
   BASE_TOOL_REGISTRARS,
   BLOB_UPLOAD_TIMEOUT_MS,
   BLOB_URL_DEFAULT_TTL_MS,
   BLOB_URL_MAX_TTL_MS,
+  CONFIRM_FALLBACK_DESCRIPTION,
+  FILE_ROOTS_ENV,
   INLINE_ATTACHMENT_LIMITS_TEXT,
   MAX_BLOB_UPLOAD_BYTES,
   MAX_INLINE_ATTACHMENT_BYTES,
@@ -36311,14 +37416,24 @@ export {
   appendReplyFlags,
   assertNotBoth,
   attachInlineParam,
+  attachmentDetails,
+  attachmentNames,
+  attachmentPreview,
   authToolsFor,
   blobStoreFromEnv,
+  bodyPreview,
   bootstrapGogAuth,
+  confineAtFile,
+  confinePath,
+  confinePaths,
+  confirmTokenParam,
   createBlobUrlMinter,
+  defaultFileRoot,
   diagnose,
   errorText,
   extractEmails,
   fetchGmailPages,
+  fileRoots,
   finalizeGmailSearch,
   ids,
   inlineAttachmentArgs,
@@ -36331,7 +37446,10 @@ export {
   pageTokenParam,
   paginationParams,
   payloadArg,
+  pos,
+  prepareDownloadRoot,
   pushPaginationFlags,
+  readCourse,
   registerApiTools,
   registerAppScriptTools,
   registerAuthTools,
@@ -36346,13 +37464,16 @@ export {
   registerSheetsTools,
   registerSlidesTools,
   registerTasksTools,
+  removeDownload,
   replySchema,
+  requireDispatchConfirmation,
   requireGmailDispatchConfirmation,
   resolvePageToken,
   resultText,
   run,
   runBinary,
   runOrDiagnose,
+  senderPreview,
   stripConsumedPageToken,
   uploadToBlobStore
 };