@chrysb/alphaclaw 0.4.1-beta.0 → 0.4.1-beta.2

package/lib/server/gog-skill.js

@@ -0,0 +1,169 @@
+const path = require("path");
+const { readGoogleState } = require("./google-state");
+
+const kSkillPartsDir = path.join(__dirname, "..", "setup", "skills", "gog-cli");
+
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+
+const uniqueServiceLabels = (scopes) =>
+  Array.from(
+    new Set(
+      (scopes || [])
+        .map((scope) => String(scope || "").split(":")[0])
+        .filter(Boolean),
+    ),
+  );
+
+const collectConnectedServices = (accounts) => {
+  const serviceSet = new Set();
+  for (const account of accounts) {
+    if (!account.authenticated) continue;
+    for (const label of uniqueServiceLabels(account.services)) {
+      serviceSet.add(label);
+    }
+  }
+  return serviceSet;
+};
+
+const kServiceDisplayNames = {
+  gmail: "Gmail",
+  calendar: "Calendar",
+  drive: "Drive",
+  sheets: "Sheets",
+  docs: "Docs",
+  tasks: "Tasks",
+  contacts: "Contacts",
+  meet: "Meet",
+};
+
+// Stable ordering for service sections
+const kServiceOrder = [
+  "gmail",
+  "calendar",
+  "drive",
+  "sheets",
+  "docs",
+  "tasks",
+  "contacts",
+  "meet",
+];
+
+const readServiceSection = (fs, service) => {
+  try {
+    return fs.readFileSync(path.join(kSkillPartsDir, `${service}.md`), "utf8");
+  } catch {
+    return null;
+  }
+};
+
+// ---------------------------------------------------------------------------
+// Skill content builder
+// ---------------------------------------------------------------------------
+
+const buildGogSkillContent = ({ fs, accounts }) => {
+  const authenticatedAccounts = accounts.filter((a) => a.authenticated);
+  if (!authenticatedAccounts.length) return null;
+
+  const connectedServices = collectConnectedServices(authenticatedAccounts);
+  if (!connectedServices.size) return null;
+
+  const serviceNames = kServiceOrder
+    .filter((svc) => connectedServices.has(svc))
+    .map((svc) => kServiceDisplayNames[svc] || svc);
+
+  const lines = [];
+
+  // Frontmatter
+  lines.push("---");
+  lines.push("name: gog-cli");
+  lines.push(
+    `description: Google Workspace CLI (gog) — command reference for ${serviceNames.join(", ")}.`,
+  );
+  lines.push("---");
+  lines.push("");
+
+  // Header
+  lines.push("# gog — Google Workspace CLI");
+  lines.push("");
+  lines.push(
+    "Fast, script-friendly CLI for Google Workspace. All commands output structured JSON with `--json` or stable TSV with `--plain`.",
+  );
+  lines.push("");
+
+  // Global flags
+  lines.push("## Global Flags");
+  lines.push("");
+  lines.push("```");
+  lines.push("--account <email>   Account to use (or set GOG_ACCOUNT)");
+  lines.push("--client <name>     OAuth client (default: \"default\")");
+  lines.push("--json              Structured JSON output");
+  lines.push("--plain             Stable TSV output (no colors)");
+  lines.push("--force             Skip confirmations");
+  lines.push("--verbose           Verbose logging");
+  lines.push("```");
+  lines.push("");
+
+  // Account table
+  lines.push("## Connected Accounts");
+  lines.push("");
+  lines.push("| Email | Client | Services |");
+  lines.push("| ----- | ------ | -------- |");
+  for (const account of authenticatedAccounts) {
+    const email = String(account.email || "").trim() || "(unknown)";
+    const client = String(account.client || "default").trim();
+    const services = uniqueServiceLabels(account.services).join(", ");
+    lines.push(`| ${email} | ${client} | ${services} |`);
+  }
+  lines.push("");
+  lines.push(
+    "Always pass `--account <email>` (and `--client <name>` if not \"default\") so gog targets the correct account.",
+  );
+  lines.push("");
+
+  // Per-service sections (read from markdown files)
+  for (const svc of kServiceOrder) {
+    if (!connectedServices.has(svc)) continue;
+    const section = readServiceSection(fs, svc);
+    if (section) {
+      lines.push(section.trimEnd());
+      lines.push("");
+    }
+  }
+
+  return lines.join("\n");
+};
+
+// ---------------------------------------------------------------------------
+// Installer (reads state, writes SKILL.md)
+// ---------------------------------------------------------------------------
+
+const installGogCliSkill = ({ fs, openclawDir }) => {
+  try {
+    const statePath = path.join(openclawDir, "gogcli", "state.json");
+    const state = readGoogleState({ fs, statePath });
+    const accounts = Array.isArray(state.accounts) ? state.accounts : [];
+    const content = buildGogSkillContent({ fs, accounts });
+
+    const skillDir = path.join(openclawDir, "skills", "gog-cli");
+
+    if (!content) {
+      // No authenticated accounts — remove stale skill if present
+      const skillPath = path.join(skillDir, "SKILL.md");
+      if (fs.existsSync(skillPath)) {
+        fs.unlinkSync(skillPath);
+        console.log("[gog-skill] Removed stale gog-cli skill (no connected accounts)");
+      }
+      return;
+    }
+
+    fs.mkdirSync(skillDir, { recursive: true });
+    fs.writeFileSync(path.join(skillDir, "SKILL.md"), content);
+    console.log("[gog-skill] gog-cli skill installed");
+  } catch (e) {
+    console.error("[gog-skill] Install error:", e.message);
+  }
+};
+
+module.exports = { buildGogSkillContent, installGogCliSkill };

package/lib/server/onboarding/openclaw.js

@@ -177,7 +177,15 @@ const writeSanitizedOpenclawConfig = ({ fs, openclawDir, varMap }) => {
   const replacements = buildSecretReplacements(varMap, process.env);
   for (const [secret, envRef] of replacements) {
     if (secret) {
-      content = content.split(secret).join(envRef);
+      // Only replace exact JSON string values so path substrings are never mutated.
+      const secretJson = JSON.stringify(secret);
+      content = content.replace(
+        new RegExp(
+          secretJson.replace(/[-\/\\^$*+?.()|[\]{}]/g, "\\$&"),
+          "g",
+        ),
+        JSON.stringify(envRef),
+      );
     }
   }
   fs.writeFileSync(configPath, content);

package/lib/server/routes/browse/index.js

@@ -576,6 +576,121 @@ const registerBrowseRoutes = ({ app, fs, kRootDir }) => {
     }
   });
 
+  app.post("/api/browse/create-file", (req, res) => {
+    const targetPath = String(req.body?.path || "").trim();
+    if (!targetPath) {
+      return res.status(400).json({ ok: false, error: "path is required" });
+    }
+    const resolvedPath = resolveSafePath(
+      targetPath,
+      kRootResolved,
+      kRootWithSep,
+      kRootDisplayName,
+    );
+    if (!resolvedPath.ok) {
+      return res.status(400).json({ ok: false, error: resolvedPath.error });
+    }
+    const normalizedPolicyPath = normalizePolicyPath(resolvedPath.relativePath);
+    if (matchesPolicyPath(kLockedBrowsePaths, normalizedPolicyPath)) {
+      return res.status(403).json({
+        ok: false,
+        error: "Cannot create files in a locked path.",
+      });
+    }
+    try {
+      if (fs.existsSync(resolvedPath.absolutePath)) {
+        return res
+          .status(409)
+          .json({ ok: false, error: "A file or folder already exists at this path" });
+      }
+      const parentDir = path.dirname(resolvedPath.absolutePath);
+      fs.mkdirSync(parentDir, { recursive: true });
+      fs.writeFileSync(resolvedPath.absolutePath, "", "utf8");
+      return res.json({ ok: true, path: resolvedPath.relativePath });
+    } catch (error) {
+      return res
+        .status(500)
+        .json({ ok: false, error: error.message || "Could not create file" });
+    }
+  });
+
+  app.post("/api/browse/create-folder", (req, res) => {
+    const targetPath = String(req.body?.path || "").trim();
+    if (!targetPath) {
+      return res.status(400).json({ ok: false, error: "path is required" });
+    }
+    const resolvedPath = resolveSafePath(
+      targetPath,
+      kRootResolved,
+      kRootWithSep,
+      kRootDisplayName,
+    );
+    if (!resolvedPath.ok) {
+      return res.status(400).json({ ok: false, error: resolvedPath.error });
+    }
+    const normalizedPolicyPath = normalizePolicyPath(resolvedPath.relativePath);
+    if (matchesPolicyPath(kLockedBrowsePaths, normalizedPolicyPath)) {
+      return res.status(403).json({
+        ok: false,
+        error: "Cannot create folders in a locked path.",
+      });
+    }
+    try {
+      if (fs.existsSync(resolvedPath.absolutePath)) {
+        return res
+          .status(409)
+          .json({ ok: false, error: "A file or folder already exists at this path" });
+      }
+      fs.mkdirSync(resolvedPath.absolutePath, { recursive: true });
+      return res.json({ ok: true, path: resolvedPath.relativePath });
+    } catch (error) {
+      return res
+        .status(500)
+        .json({ ok: false, error: error.message || "Could not create folder" });
+    }
+  });
+
+  app.post("/api/browse/move", (req, res) => {
+    const fromPath = String(req.body?.from || "").trim();
+    const toPath = String(req.body?.to || "").trim();
+    if (!fromPath || !toPath) {
+      return res.status(400).json({ ok: false, error: "from and to are required" });
+    }
+    const resolvedFrom = resolveSafePath(fromPath, kRootResolved, kRootWithSep, kRootDisplayName);
+    if (!resolvedFrom.ok) {
+      return res.status(400).json({ ok: false, error: resolvedFrom.error });
+    }
+    const resolvedTo = resolveSafePath(toPath, kRootResolved, kRootWithSep, kRootDisplayName);
+    if (!resolvedTo.ok) {
+      return res.status(400).json({ ok: false, error: resolvedTo.error });
+    }
+    const normalizedFromPolicy = normalizePolicyPath(resolvedFrom.relativePath);
+    const normalizedToPolicy = normalizePolicyPath(resolvedTo.relativePath);
+    if (
+      matchesPolicyPath(kLockedBrowsePaths, normalizedFromPolicy) ||
+      matchesPolicyPath(kProtectedBrowsePaths, normalizedFromPolicy)
+    ) {
+      return res.status(403).json({ ok: false, error: "Source path is protected and cannot be moved." });
+    }
+    if (matchesPolicyPath(kLockedBrowsePaths, normalizedToPolicy)) {
+      return res.status(403).json({ ok: false, error: "Cannot move into a locked path." });
+    }
+    try {
+      if (!fs.existsSync(resolvedFrom.absolutePath)) {
+        return res.status(404).json({ ok: false, error: "Source path does not exist" });
+      }
+      if (fs.existsSync(resolvedTo.absolutePath)) {
+        return res.status(409).json({ ok: false, error: "A file or folder already exists at the destination" });
+      }
+      const parentDir = path.dirname(resolvedTo.absolutePath);
+      fs.mkdirSync(parentDir, { recursive: true });
+      fs.renameSync(resolvedFrom.absolutePath, resolvedTo.absolutePath);
+      return res.json({ ok: true, from: resolvedFrom.relativePath, to: resolvedTo.relativePath });
+    } catch (error) {
+      return res.status(500).json({ ok: false, error: error.message || "Could not move path" });
+    }
+  });
+
   app.delete("/api/browse/delete", (req, res) => {
     const targetPath = String(req.body?.path || "").trim();
     const resolvedPath = resolveSafePath(
@@ -594,26 +709,28 @@ const registerBrowseRoutes = ({ app, fs, kRootDir }) => {
     ) {
       return res.status(403).json({
         ok: false,
-        error: "This file cannot be deleted from the explorer.",
+        error: "This path cannot be deleted from the explorer.",
       });
     }
     try {
       if (!fs.existsSync(resolvedPath.absolutePath)) {
-        return res.status(404).json({ ok: false, error: "File does not exist" });
+        return res.status(404).json({ ok: false, error: "Path does not exist" });
       }
       const stats = fs.statSync(resolvedPath.absolutePath);
-      if (!stats.isFile()) {
-        return res.status(400).json({ ok: false, error: "Path is not a file" });
+      const isDirectory = stats.isDirectory();
+      if (!stats.isFile() && !isDirectory) {
+        return res.status(400).json({ ok: false, error: "Path is not a file or folder" });
       }
-      fs.rmSync(resolvedPath.absolutePath, { force: true });
+      fs.rmSync(resolvedPath.absolutePath, { recursive: isDirectory, force: true });
       return res.json({
         ok: true,
         path: resolvedPath.relativePath,
+        type: isDirectory ? "folder" : "file",
       });
     } catch (error) {
       return res.status(500).json({
         ok: false,
-        error: error.message || "Could not delete file",
+        error: error.message || "Could not delete path",
       });
     }
   });

package/lib/server/routes/browse/path-utils.js

@@ -36,7 +36,9 @@ const matchesPolicyPath = (policyPathSet, normalizedPath) => {
   for (const policyPath of policyPathSet) {
     if (
       safeNormalizedPath === policyPath ||
-      safeNormalizedPath.endsWith(`/${policyPath}`)
+      safeNormalizedPath.endsWith(`/${policyPath}`) ||
+      safeNormalizedPath.startsWith(`${policyPath}/`) ||
+      safeNormalizedPath.includes(`/${policyPath}/`)
     ) {
       return true;
     }

package/lib/server/routes/google.js

@@ -11,6 +11,7 @@ const {
   removeGoogleAccount,
 } = require("../google-state");
 const { syncBootstrapPromptFiles } = require("../onboarding/workspace");
+const { installGogCliSkill } = require("../gog-skill");
 
 const quoteShellArg = (value) => `"${String(value || "").replace(/(["\\$`])/g, "\\$1")}"`;
 
@@ -62,6 +63,9 @@ const registerGoogleRoutes = ({
         baseUrl: getBaseUrl(req),
       });
     } catch {}
+    try {
+      installGogCliSkill({ fs, openclawDir: constants.OPENCLAW_DIR });
+    } catch {}
   };
 
   const listAuthenticatedAccounts = async (state) => {

package/lib/server/routes/webhooks.js

@@ -52,15 +52,13 @@ const normalizeStatusFilter = (rawStatus) => {
 
 const buildWebhookUrls = ({ baseUrl, name }) => {
   const fullUrl = `${baseUrl}/hooks/${name}`;
-  const token = String(
-    process.env.OPENCLAW_HOOKS_TOKEN || process.env.WEBHOOK_TOKEN || "",
-  ).trim();
+  const token = String(process.env.WEBHOOK_TOKEN || "").trim();
   const queryStringUrl = token
     ? `${fullUrl}?token=${encodeURIComponent(token)}`
-    : `${fullUrl}?token=<OPENCLAW_HOOKS_TOKEN>`;
+    : `${fullUrl}?token=<WEBHOOK_TOKEN>`;
   const authHeaderValue = token
     ? `Authorization: Bearer ${token}`
-    : "Authorization: Bearer <OPENCLAW_HOOKS_TOKEN>";
+    : "Authorization: Bearer <WEBHOOK_TOKEN>";
   return { fullUrl, queryStringUrl, authHeaderValue, hasRuntimeToken: !!token };
 };
 

package/lib/server/webhooks.js

@@ -53,7 +53,7 @@ const ensureHooksRoot = (cfg) => {
   if (typeof cfg.hooks.path !== "string" || !cfg.hooks.path.trim())
     cfg.hooks.path = "/hooks";
   if (typeof cfg.hooks.token !== "string" || !cfg.hooks.token.trim()) {
-    cfg.hooks.token = "${OPENCLAW_HOOKS_TOKEN}";
+    cfg.hooks.token = "${WEBHOOK_TOKEN}";
   }
   if (
     typeof cfg.hooks.defaultSessionKey !== "string" ||

package/lib/server.js

@@ -79,6 +79,7 @@ const {
 const {
   migrateManagedInternalFiles,
 } = require("./server/internal-files-migration");
+const { installGogCliSkill } = require("./server/gog-skill");
 const { createTelegramApi } = require("./server/telegram-api");
 const { createDiscordApi } = require("./server/discord-api");
 const { createWatchdogNotifier } = require("./server/watchdog-notify");
@@ -282,6 +283,7 @@ const doSyncPromptFiles = () => {
     openclawDir: constants.OPENCLAW_DIR,
     baseUrl: setupUiUrl,
   });
+  installGogCliSkill({ fs, openclawDir: constants.OPENCLAW_DIR });
 };
 doSyncPromptFiles();
 registerTelegramRoutes({

package/lib/setup/skills/gog-cli/calendar.md

@@ -0,0 +1,63 @@
+## Calendar
+
+```bash
+# List calendars
+gog calendar calendars
+
+# Today's events
+gog calendar events <calendarId> --today
+gog calendar events <calendarId> --tomorrow
+gog calendar events <calendarId> --week
+gog calendar events <calendarId> --days 3
+
+# Events from all calendars
+gog calendar events --all --today
+
+# Date range
+gog calendar events <calendarId> --from 2025-01-15T00:00:00Z --to 2025-01-22T00:00:00Z
+
+# Search events
+gog calendar search "meeting" --today
+gog calendar search "standup" --days 30
+
+# Get single event
+gog calendar event <calendarId> <eventId>
+
+# Create event
+gog calendar create <calendarId> --summary "Meeting" --from 2025-01-15T10:00:00Z --to 2025-01-15T11:00:00Z
+gog calendar create <calendarId> --summary "Team Sync" --from 2025-01-15T14:00:00Z --to 2025-01-15T15:00:00Z --attendees "alice@example.com,bob@example.com" --location "Zoom"
+
+# Recurrence + reminders
+gog calendar create <calendarId> --summary "Weekly" --from 2025-01-15T09:00:00Z --to 2025-01-15T09:30:00Z --rrule "RRULE:FREQ=WEEKLY" --reminder "popup:15m"
+
+# Update event
+gog calendar update <calendarId> <eventId> --summary "Updated" --from 2025-01-15T11:00:00Z --to 2025-01-15T12:00:00Z
+
+# Add attendees without replacing existing
+gog calendar update <calendarId> <eventId> --add-attendee "alice@example.com"
+
+# Send notifications
+gog calendar create <calendarId> --summary "Sync" --from ... --to ... --send-updates all
+gog calendar update <calendarId> <eventId> --send-updates externalOnly
+
+# Delete event
+gog calendar delete <calendarId> <eventId>
+
+# RSVP to invitation
+gog calendar respond <calendarId> <eventId> --status accepted
+gog calendar respond <calendarId> <eventId> --status declined
+gog calendar respond <calendarId> <eventId> --status tentative
+
+# Free/busy check
+gog calendar freebusy --calendars "primary,work@example.com" --from 2025-01-15T00:00:00Z --to 2025-01-16T00:00:00Z
+
+# Conflict detection
+gog calendar conflicts --calendars "primary" --today
+
+# Special event types
+gog calendar create primary --event-type focus-time --from ... --to ...
+gog calendar create primary --event-type out-of-office --from ... --to ... --all-day
+```
+
+JSON output includes `startDayOfWeek`, `endDayOfWeek`, `timezone`, and `startLocal`/`endLocal` fields.
+Use `primary` as calendarId for the user's default calendar.

package/lib/setup/skills/gog-cli/contacts.md

@@ -0,0 +1,30 @@
+## Contacts
+
+```bash
+# List personal contacts
+gog contacts list --max 50
+
+# Search contacts
+gog contacts search "Ada" --max 50
+
+# Get contact by resource name or email
+gog contacts get people/<resourceName>
+gog contacts get user@example.com
+
+# Create contact
+gog contacts create --given "John" --family "Doe" --email "john@example.com" --phone "+1234567890"
+
+# Update contact
+gog contacts update people/<resourceName> --given "Jane" --email "jane@example.com" --notes "Updated"
+
+# Delete contact
+gog contacts delete people/<resourceName>
+
+# Other contacts (people you've interacted with)
+gog contacts other list --max 50
+gog contacts other search "John" --max 50
+
+# Workspace directory (Google Workspace only)
+gog contacts directory list --max 50
+gog contacts directory search "Jane" --max 50
+```

package/lib/setup/skills/gog-cli/docs.md

@@ -0,0 +1,46 @@
+## Docs
+
+```bash
+# Document info
+gog docs info <docId>
+
+# Read document text
+gog docs cat <docId>
+gog docs cat <docId> --max-bytes 10000
+gog docs cat <docId> --tab "Notes"
+gog docs cat <docId> --all-tabs
+
+# List tabs
+gog docs list-tabs <docId>
+
+# Create document
+gog docs create "My Doc"
+gog docs create "My Doc" --file ./doc.md
+
+# Copy document
+gog docs copy <docId> "My Doc Copy"
+
+# Export
+gog docs export <docId> --format pdf --out ./doc.pdf
+gog docs export <docId> --format docx --out ./doc.docx
+gog docs export <docId> --format txt --out ./doc.txt
+
+# Update document content (markdown)
+gog docs update <docId> --format markdown --content-file ./doc.md
+gog docs write <docId> --replace --markdown --file ./doc.md
+
+# Find and replace
+gog docs find-replace <docId> "old text" "new text"
+
+# Sed-style editing (sedmat) with markdown formatting
+gog docs sed <docId> 's/hello/**hello**/'          # bold
+gog docs sed <docId> 's/hello/*hello*/'             # italic
+gog docs sed <docId> 's/hello/`hello`/'             # monospace
+gog docs sed <docId> 's/hello/__hello__/'           # underline
+gog docs sed <docId> 's/Google/[Google](https://google.com)/'  # link
+gog docs sed <docId> 's/{{LOGO}}/![](https://example.com/logo.png)/'  # image
+
+# Tables via sedmat
+gog docs sed <docId> 's/{{TABLE}}/|3x4|/'           # create 3-row, 4-col table
+gog docs sed <docId> 's/|1|[A1]/**Name**/'          # set cell A1
+```

package/lib/setup/skills/gog-cli/drive.md

@@ -0,0 +1,48 @@
+## Drive
+
+```bash
+# List files (default: all accessible files including shared drives)
+gog drive ls --max 20
+gog drive ls --parent <folderId> --max 20
+gog drive ls --no-all-drives
+
+# Search files
+gog drive search "invoice" --max 20
+gog drive search "mimeType = 'application/pdf'" --raw-query
+
+# Get file metadata
+gog drive get <fileId>
+gog drive url <fileId>
+
+# Download file
+gog drive download <fileId> --out ./downloaded.bin
+
+# Export Google Workspace files
+gog drive download <fileId> --format pdf --out ./exported.pdf
+gog drive download <fileId> --format docx --out ./doc.docx
+
+# Upload file
+gog drive upload ./path/to/file --parent <folderId>
+gog drive upload ./file.docx --convert
+gog drive upload ./file --replace <fileId>
+
+# Copy file
+gog drive copy <fileId> "Copy Name"
+
+# Organize
+gog drive mkdir "New Folder"
+gog drive mkdir "New Folder" --parent <parentFolderId>
+gog drive rename <fileId> "New Name"
+gog drive move <fileId> --parent <destinationFolderId>
+gog drive delete <fileId>
+gog drive delete <fileId> --permanent
+
+# Permissions
+gog drive permissions <fileId>
+gog drive share <fileId> --to user --email user@example.com --role reader
+gog drive share <fileId> --to user --email user@example.com --role writer
+gog drive unshare <fileId> --permission-id <permissionId>
+
+# Shared drives
+gog drive drives --max 100
+```

package/lib/setup/skills/gog-cli/gmail.md

@@ -0,0 +1,64 @@
+## Gmail
+
+```bash
+# Search threads (returns thread IDs + snippets)
+gog gmail search 'newer_than:7d' --max 10
+gog gmail search 'from:alice@example.com subject:invoice' --max 20
+
+# Search individual messages (add --include-body to fetch bodies)
+gog gmail messages search 'newer_than:7d' --max 10 --include-body
+
+# Read a thread and optionally download attachments
+gog gmail thread get <threadId>
+gog gmail thread get <threadId> --download --out-dir ./attachments
+
+# Read a single message
+gog gmail get <messageId>
+
+# Modify labels on a thread
+gog gmail thread modify <threadId> --add STARRED --remove INBOX
+
+# Send email (plain text)
+gog gmail send --to recipient@example.com --subject "Subject" --body "Body text"
+
+# Send email (HTML)
+gog gmail send --to recipient@example.com --subject "Subject" --body "Plain fallback" --body-html "<p>Hello</p>"
+
+# Reply to a message (with quoted original)
+gog gmail send --reply-to-message-id <messageId> --quote --to recipient@example.com --subject "Re: Subject" --body "Reply text"
+
+# Send with body from file or stdin
+gog gmail send --to recipient@example.com --subject "Subject" --body-file ./message.txt
+gog gmail send --to recipient@example.com --subject "Subject" --body-file -
+
+# Labels
+gog gmail labels list
+gog gmail labels get INBOX --json
+gog gmail labels create "My Label"
+gog gmail labels delete <labelIdOrName>
+
+# Drafts
+gog gmail drafts list
+gog gmail drafts create --to recipient@example.com --subject "Draft" --body "Body"
+gog gmail drafts update <draftId> --subject "Updated" --body "New body"
+gog gmail drafts send <draftId>
+
+# Batch operations
+gog gmail batch modify <messageId1> <messageId2> --add STARRED --remove INBOX
+gog gmail batch delete <messageId1> <messageId2>
+
+# Filters
+gog gmail filters list
+gog gmail filters create --from 'noreply@example.com' --add-label 'Notifications'
+gog gmail filters delete <filterId>
+
+# Vacation / auto-reply
+gog gmail vacation get
+gog gmail vacation enable --subject "Out of office" --message "I'm away"
+gog gmail vacation disable
+
+# History (for incremental sync)
+gog gmail history --since <historyId>
+```
+
+Output: use `--json` for structured output, `--plain` for TSV.

package/lib/setup/skills/gog-cli/meet.md

@@ -0,0 +1,6 @@
+## Meet
+
+```bash
+# List meeting spaces
+gog meet spaces list
+```