gws-axi 0.3.0 → 0.4.0

package/README.md

@@ -12,26 +12,68 @@ Designed for use by AI agents. Every response is structured, every error names a
 - A Google account (personal or Workspace)
 - `gcloud` CLI (optional — speeds up initial setup, not required)
 
-## Install
+## Getting started
+
+### 1. Install
 
 ```bash
 npm install -g gws-axi
 ```
 
-## First-run setup
+### 2. Let an agent walk you through setup
+
+`gws-axi` is designed to be driven by an AI coding agent (Claude Code, Cursor, anything that can run shell commands). The setup flow is progressive — the CLI emits structured TOON output telling the agent what to do next, and the agent coordinates with you through the handful of Google Cloud Console steps that can't be automated.
+
+Start a fresh agent session and paste a prompt like:
+
+```
+Run `gws-axi auth setup` and walk me through the progressive setup
+flow it describes. The CLI's output will tell you exactly what to do
+at each step — relay the instructions to me, and run follow-up
+commands as you go.
+
+I want to authenticate the following Google accounts:
+  - you@example.com
+  - personal@gmail.com
+```
+
+The explicit `gws-axi auth setup` in the prompt matters: this is your very first session, so the agent doesn't yet have any ambient context about `gws-axi`. Naming the first command gets the agent into the structured flow, where the CLI's output takes over. Every subsequent session auto-loads a compact `gws-axi` status line via a session-start hook (installed on first invocation) — so after this one, you can skip the command and just say "use gws-axi to ..." and the agent knows.
+
+Expect ~10 minutes end-to-end for a fresh Google Cloud project; ~3 minutes if you already have one you want to reuse.
 
-`gws-axi` uses a **bring-your-own OAuth client** model: you create your own Google Cloud project with OAuth credentials, and tokens live locally at `~/.config/gws-axi/`. This avoids verification/CASA overhead for public apps and keeps the blast radius of any token revocation scoped to you.
+**What happens during setup:** you create your own Google Cloud project with OAuth credentials, enable the Workspace APIs, configure the consent screen, and add your Google accounts as test users. This is the [**bring-your-own OAuth client**](docs/shared-client-future.md) model — avoids public-app verification overhead and keeps the blast radius of any token revocation scoped to you. Tokens live locally at `~/.config/gws-axi/`.
 
-The setup is progressive — run `gws-axi auth setup` repeatedly and each invocation walks you through the next step:
+The CLI generates an auto-refreshing HTML helper page (`~/.config/gws-axi/setup.html`) with clickable Console deep-links — so you never copy long URLs from terminal to browser and you stay in the right browser profile throughout.
+
+### 3. Check it works
 
 ```bash
-gws-axi auth setup   # start or continue — 7 steps, mostly automated
-gws-axi doctor       # check setup + live API health at any time
+gws-axi doctor                           # setup + live API health
+gws-axi calendar events                  # upcoming 7 days on your primary calendar
 ```
 
-The CLI generates a styled, auto-refreshing HTML helper page at `~/.config/gws-axi/setup.html` with clickable Console deep-links — so you never copy long URLs from terminal to browser and you stay in the right browser profile throughout.
+### 4. Make gws-axi your agent's default for Google Workspace
+
+On first invocation (which already happened during step 2), `gws-axi` auto-installed a **SessionStart hook** into your agent's config (Claude Code's `~/.claude/settings.json`, Codex's `~/.codex/hooks.json`). From now on, every new agent session will see a compact `gws-axi` status line in ambient context — authenticated accounts, write-protection status, setup health — with no extra wiring. Nothing for you to configure.
+
+To make sure agents reach for `gws-axi` instead of stale alternatives, also consider:
+
+- **Remove existing Google Workspace MCP servers and skills.** If you already have Gmail / Calendar / Drive / Docs / Slides integrations installed (community MCP servers, bespoke skills, etc.), disable them. Keeping both creates ambiguity — agents may pick whichever they noticed first, and the tools have different auth models, flag names, and output shapes. Typical candidates to disable: `google-calendar-mcp`, `gmail-mcp`, `google-docs-mcp`, any `@modelcontextprotocol/server-google-*`, and skills with similar names.
+
+- **Add a directive to your `CLAUDE.md`.** A short note in your project-level (`.claude/CLAUDE.md`) or user-level (`~/.claude/CLAUDE.md`) file nudges agents to consistently use `gws-axi`. Example:
+
+  ```markdown
+  ## Google Workspace
+
+  Use `gws-axi` for ALL Google Calendar, Gmail, Docs, Drive, and Slides
+  interactions. Check the SessionStart `gws-axi` line for current auth
+  state; run `gws-axi --help` for the command surface. Prefer this over
+  any other Google integrations.
+  ```
+
+### Prefer to drive it manually?
 
-Typical flow: set project → enable APIs → create OAuth client → download JSON → configure consent screen → add test users → authenticate. See the in-CLI guidance as you go; every step tells you exactly what to do next.
+The CLI works fine without an agent — each `gws-axi auth setup` invocation prints its own instructions and updates `setup.html`. Run it repeatedly as you complete each step; no state is lost between invocations.
 
 ## Usage
 

package/dist/src/cli.js

@@ -7,7 +7,7 @@ import { authCommand, AUTH_HELP } from "./commands/auth.js";
 import { doctorCommand, DOCTOR_HELP } from "./commands/doctor.js";
 import { calendarCommand } from "./commands/calendar.js";
 import { gmailCommand, GMAIL_HELP } from "./commands/gmail.js";
-import { docsCommand, DOCS_HELP } from "./commands/docs.js";
+import { docsCommand } from "./commands/docs.js";
 import { driveCommand, DRIVE_HELP } from "./commands/drive.js";
 import { slidesCommand, SLIDES_HELP } from "./commands/slides.js";
 const DESCRIPTION = "Agent ergonomic CLI for Google Workspace. Unified interface for Gmail, Calendar, Docs, Drive, and Slides with agent-guided OAuth setup.";
@@ -30,7 +30,6 @@ const COMMAND_HELP = {
     auth: AUTH_HELP,
     doctor: DOCTOR_HELP,
     gmail: GMAIL_HELP,
-    docs: DOCS_HELP,
     drive: DRIVE_HELP,
     slides: SLIDES_HELP,
 };

package/dist/src/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/cli.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/cli.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAElE,MAAM,WAAW,GACf,yIAAyI,CAAC;AAE5I,MAAM,OAAO,GAAG,kBAAkB,EAAE,CAAC;AAErC,MAAM,CAAC,MAAM,QAAQ,GAAG;;;;;;;;;;CAUvB,CAAC;AAEF,0EAA0E;AAC1E,0EAA0E;AAC1E,iEAAiE;AACjE,MAAM,YAAY,GAA2B;IAC3C,IAAI,EAAE,SAAS;IACf,MAAM,EAAE,WAAW;IACnB,KAAK,EAAE,UAAU;IACjB,KAAK,EAAE,UAAU;IACjB,MAAM,EAAE,WAAW;CACpB,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,IAAI;IACxB,MAAM,SAAS,CAAC;QACd,WAAW,EAAE,WAAW;QACxB,OAAO,EAAE,OAAO;QAChB,YAAY,EAAE,QAAQ;QACtB,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,qBAAqB,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACtE,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC,WAAW,EAAE;QAC/B,QAAQ,EAAE;YACR,IAAI,EAAE,WAAW;YACjB,MAAM,EAAE,aAAa;YACrB,QAAQ,EAAE,eAAe;YACzB,KAAK,EAAE,YAAY;YACnB,IAAI,EAAE,WAAW;YACjB,KAAK,EAAE,YAAY;YACnB,MAAM,EAAE,aAAa;SACtB;QACD,cAAc,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,YAAY,CAAC,OAAO,CAAC;KACnD,CAAC,CAAC;AACL,CAAC;AAED,SAAS,kBAAkB;IACzB,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAErD,KAAK,MAAM,SAAS,IAAI;QACtB,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,cAAc,CAAC;QAChC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,cAAc,CAAC;KACvC,EAAE,CAAC;QACF,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC3B,SAAS;QACX,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,CAEzD,CAAC;QACF,IAAI,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpE,OAAO,MAAM,CAAC,OAAO,CAAC;QACxB,CAAC;IACH,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;AACjE,CAAC"}

package/dist/src/commands/docs/comments.d.ts

@@ -0,0 +1,2 @@
+export declare const COMMENTS_HELP = "usage: gws-axi docs comments <documentId> [flags]\nargs[1]:\n  <documentId>         The Google Doc ID (from the URL after /d/)\nflags[4]:\n  --include-resolved   Also show comments that have been resolved\n  --full               Don't truncate comment/reply bodies (default cap: 500 chars)\n  --limit <n>          Max comments to return (default: 50)\n  --account <email>    Account override when 2+ are configured\nexamples:\n  gws-axi docs comments 1BxAbc...\n  gws-axi docs comments 1BxAbc... --include-resolved --full\noutput:\n  A `comments[N]{id,author,created,resolved,quoted_content,body,reply_count}`\n  list and (when any comment has replies) a sibling `replies[N]{comment,author,created,body}`\n  table keyed by parent comment id. Bodies and quoted_content are truncated\n  at 500 chars unless --full is passed.\nnotes:\n  `quoted_content` is the exact text in the doc that the comment is anchored\n  to \u2014 important for agents to know what the comment is *about*. Comments\n  without an anchor (overall-document comments) will have an empty value.\n";
+export declare function docsCommentsCommand(account: string, args: string[]): Promise<string>;

package/dist/src/commands/docs/comments.js

@@ -0,0 +1,172 @@
+import { AxiError } from "axi-sdk-js";
+import { driveClient, translateGoogleError } from "../../google/client.js";
+import { field, joinBlocks, renderHelp, renderList, renderObject, } from "../../output/index.js";
+export const COMMENTS_HELP = `usage: gws-axi docs comments <documentId> [flags]
+args[1]:
+  <documentId>         The Google Doc ID (from the URL after /d/)
+flags[4]:
+  --include-resolved   Also show comments that have been resolved
+  --full               Don't truncate comment/reply bodies (default cap: 500 chars)
+  --limit <n>          Max comments to return (default: 50)
+  --account <email>    Account override when 2+ are configured
+examples:
+  gws-axi docs comments 1BxAbc...
+  gws-axi docs comments 1BxAbc... --include-resolved --full
+output:
+  A \`comments[N]{id,author,created,resolved,quoted_content,body,reply_count}\`
+  list and (when any comment has replies) a sibling \`replies[N]{comment,author,created,body}\`
+  table keyed by parent comment id. Bodies and quoted_content are truncated
+  at 500 chars unless --full is passed.
+notes:
+  \`quoted_content\` is the exact text in the doc that the comment is anchored
+  to — important for agents to know what the comment is *about*. Comments
+  without an anchor (overall-document comments) will have an empty value.
+`;
+const DEFAULT_LIMIT = 50;
+const BODY_TRUNCATE = 500;
+function parseFlags(args) {
+    let documentId;
+    let includeResolved = false;
+    let full = false;
+    let limit = DEFAULT_LIMIT;
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        const next = args[i + 1];
+        switch (arg) {
+            case "--include-resolved":
+                includeResolved = true;
+                break;
+            case "--full":
+                full = true;
+                break;
+            case "--limit":
+                limit = Math.max(1, Math.min(100, parseInt(next, 10) || DEFAULT_LIMIT));
+                i++;
+                break;
+            default:
+                if (!arg.startsWith("--") && documentId === undefined) {
+                    documentId = arg;
+                }
+        }
+    }
+    if (!documentId) {
+        throw new AxiError("Missing documentId argument", "VALIDATION_ERROR", ["Usage: gws-axi docs comments <documentId>"]);
+    }
+    return { documentId, includeResolved, full, limit };
+}
+function truncate(value, max) {
+    if (!value)
+        return "";
+    if (value.length <= max)
+        return value;
+    return `${value.slice(0, max - 1)}…`;
+}
+function commentSchema(truncateAt) {
+    return [
+        field("id"),
+        field("author"),
+        field("created"),
+        field("resolved"),
+        {
+            name: "quoted_content",
+            extract: (item) => truncate(item.quoted_content, truncateAt),
+        },
+        {
+            name: "body",
+            extract: (item) => truncate(item.body, truncateAt),
+        },
+        field("reply_count"),
+    ];
+}
+function replySchema(truncateAt) {
+    return [
+        field("comment"),
+        field("author"),
+        field("created"),
+        {
+            name: "body",
+            extract: (item) => truncate(item.body, truncateAt),
+        },
+    ];
+}
+export async function docsCommentsCommand(account, args) {
+    const flags = parseFlags(args);
+    const api = await driveClient(account);
+    let data;
+    try {
+        const res = await api.comments.list({
+            fileId: flags.documentId,
+            includeDeleted: false,
+            pageSize: Math.min(100, flags.limit),
+            // Request every field we surface. Drive requires explicit `fields`
+            // projection on comments.list — the default response omits replies.
+            fields: "comments(id,content,quotedFileContent,author(displayName,emailAddress),createdTime,modifiedTime,resolved,anchor,replies(id,content,author(displayName,emailAddress),createdTime))",
+        });
+        data = res.data;
+    }
+    catch (err) {
+        const translated = translateGoogleError(err, {
+            account,
+            operation: "drive.comments.list",
+        });
+        if (translated.code === "NOT_FOUND") {
+            throw new AxiError(`Document '${flags.documentId}' not found (or ${account} doesn't have access)`, "DOCUMENT_NOT_FOUND", [
+                `Verify the document ID is correct (the portion of the URL after /d/)`,
+                `Confirm ${account} has at least view access to the document`,
+            ]);
+        }
+        throw translated;
+    }
+    const raw = data.comments ?? [];
+    const filtered = flags.includeResolved
+        ? raw
+        : raw.filter((c) => !c.resolved);
+    const truncateAt = flags.full ? Number.POSITIVE_INFINITY : BODY_TRUNCATE;
+    const commentRows = filtered.map((c) => ({
+        id: c.id ?? "",
+        author: c.author?.displayName ?? c.author?.emailAddress ?? "",
+        created: c.createdTime ?? "",
+        resolved: c.resolved ?? false,
+        quoted_content: c.quotedFileContent?.value ?? "",
+        body: c.content ?? "",
+        reply_count: c.replies?.length ?? 0,
+    }));
+    const replyRows = filtered.flatMap((c) => (c.replies ?? []).map((r) => ({
+        comment: c.id ?? "",
+        author: r.author?.displayName ?? r.author?.emailAddress ?? "",
+        created: r.createdTime ?? "",
+        body: r.content ?? "",
+    })));
+    const blocks = [];
+    blocks.push(renderObject({ account, document: flags.documentId }));
+    if (commentRows.length === 0) {
+        blocks.push(renderObject({ comments: [] }));
+        blocks.push(renderObject({
+            message: flags.includeResolved
+                ? "no comments on this document"
+                : "no open comments (pass --include-resolved to include resolved)",
+        }));
+    }
+    else {
+        blocks.push(renderList("comments", commentRows, commentSchema(truncateAt)));
+        if (replyRows.length > 0) {
+            blocks.push(renderList("replies", replyRows, replySchema(truncateAt)));
+        }
+    }
+    const suggestions = [];
+    const resolvedHidden = raw.length - filtered.length;
+    if (!flags.includeResolved && resolvedHidden > 0) {
+        suggestions.push(`${resolvedHidden} resolved comment${resolvedHidden === 1 ? "" : "s"} hidden — add --include-resolved to see them`);
+    }
+    if (commentRows.length > 0 && !flags.full) {
+        const someTruncated = commentRows.some((r) => (typeof r.body === "string" && r.body.length > BODY_TRUNCATE) ||
+            (typeof r.quoted_content === "string" && r.quoted_content.length > BODY_TRUNCATE));
+        if (someTruncated) {
+            suggestions.push(`Add --full to see complete bodies / quoted content`);
+        }
+    }
+    if (suggestions.length > 0)
+        blocks.push(renderHelp(suggestions));
+    return joinBlocks(...blocks);
+}
+//# sourceMappingURL=comments.js.map

package/dist/src/commands/docs/comments.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"comments.js","sourceRoot":"","sources":["../../../../src/commands/docs/comments.ts"],"names":[],"mappings":"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"}

package/dist/src/commands/docs/download.d.ts

@@ -0,0 +1,2 @@
+export declare const DOWNLOAD_HELP = "usage: gws-axi docs download <documentId> [flags]\nargs[1]:\n  <documentId>         The Google Doc / Drive file ID (from the URL after /d/)\nflags[3]:\n  --out <path>         Where to save (default: ./<sanitized file name>; pass a\n                       directory to save inside with the native name)\n  --as <mime>          Export format for native Google files (default: docx for\n                       Docs, xlsx for Sheets, pptx for Slides, png for Drawings).\n                       Ignored for uploaded files (they download as-is).\n  --account <email>    Account override when 2+ are configured\nexamples:\n  gws-axi docs download 1RxHZ...\n  gws-axi docs download 1RxHZ... --out /tmp/source.docx\n  gws-axi docs download 1Native... --as application/pdf --out ./spec.pdf\nnotes:\n  Works on any Drive file, not just docs. Native Google files are exported\n  on the server side (via Drive files.export); uploaded files (.docx, .pdf,\n  images, etc.) are downloaded as-is. After download, agents can inspect\n  the file with tools like `file`, `pandoc`, `textutil -convert html`,\n  or language-specific parsers for the file's format.\n";
+export declare function docsDownloadCommand(account: string, args: string[]): Promise<string>;

package/dist/src/commands/docs/download.js

@@ -0,0 +1,213 @@
+import { writeFile, mkdir } from "node:fs/promises";
+import { basename, dirname, extname } from "node:path";
+import { AxiError } from "axi-sdk-js";
+import { driveClient, translateGoogleError } from "../../google/client.js";
+import { joinBlocks, renderHelp, renderObject } from "../../output/index.js";
+import { resolveOutputPath } from "./paths.js";
+export const DOWNLOAD_HELP = `usage: gws-axi docs download <documentId> [flags]
+args[1]:
+  <documentId>         The Google Doc / Drive file ID (from the URL after /d/)
+flags[3]:
+  --out <path>         Where to save (default: ./<sanitized file name>; pass a
+                       directory to save inside with the native name)
+  --as <mime>          Export format for native Google files (default: docx for
+                       Docs, xlsx for Sheets, pptx for Slides, png for Drawings).
+                       Ignored for uploaded files (they download as-is).
+  --account <email>    Account override when 2+ are configured
+examples:
+  gws-axi docs download 1RxHZ...
+  gws-axi docs download 1RxHZ... --out /tmp/source.docx
+  gws-axi docs download 1Native... --as application/pdf --out ./spec.pdf
+notes:
+  Works on any Drive file, not just docs. Native Google files are exported
+  on the server side (via Drive files.export); uploaded files (.docx, .pdf,
+  images, etc.) are downloaded as-is. After download, agents can inspect
+  the file with tools like \`file\`, \`pandoc\`, \`textutil -convert html\`,
+  or language-specific parsers for the file's format.
+`;
+// Default export mime types for native Google file types.
+const NATIVE_EXPORT_DEFAULTS = {
+    "application/vnd.google-apps.document": {
+        mime: "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
+        extension: ".docx",
+    },
+    "application/vnd.google-apps.spreadsheet": {
+        mime: "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
+        extension: ".xlsx",
+    },
+    "application/vnd.google-apps.presentation": {
+        mime: "application/vnd.openxmlformats-officedocument.presentationml.presentation",
+        extension: ".pptx",
+    },
+    "application/vnd.google-apps.drawing": {
+        mime: "image/png",
+        extension: ".png",
+    },
+};
+// When the user passes --as, try to guess a file extension from the mime.
+const EXTENSION_BY_MIME = {
+    "application/pdf": ".pdf",
+    "text/plain": ".txt",
+    "text/markdown": ".md",
+    "text/html": ".html",
+    "text/csv": ".csv",
+    "application/rtf": ".rtf",
+    "image/png": ".png",
+    "image/jpeg": ".jpg",
+    "image/svg+xml": ".svg",
+    "application/epub+zip": ".epub",
+    "application/vnd.openxmlformats-officedocument.wordprocessingml.document": ".docx",
+    "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet": ".xlsx",
+    "application/vnd.openxmlformats-officedocument.presentationml.presentation": ".pptx",
+    "application/vnd.oasis.opendocument.text": ".odt",
+};
+function parseFlags(args) {
+    let documentId;
+    let out;
+    let as;
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        const next = args[i + 1];
+        switch (arg) {
+            case "--out":
+                out = next;
+                i++;
+                break;
+            case "--as":
+                as = next;
+                i++;
+                break;
+            default:
+                if (!arg.startsWith("--") && documentId === undefined) {
+                    documentId = arg;
+                }
+        }
+    }
+    if (!documentId) {
+        throw new AxiError("Missing documentId argument", "VALIDATION_ERROR", ["Usage: gws-axi docs download <documentId>"]);
+    }
+    return { documentId, out, as };
+}
+export async function docsDownloadCommand(account, args) {
+    const flags = parseFlags(args);
+    const api = await driveClient(account);
+    // Step 1: metadata — we need name, mimeType, and size to decide whether
+    // to export or media-download and to build a useful response.
+    let meta;
+    try {
+        const res = await api.files.get({
+            fileId: flags.documentId,
+            fields: "id,name,mimeType,size",
+            supportsAllDrives: true,
+        });
+        meta = {
+            name: res.data.name ?? "download",
+            mimeType: res.data.mimeType ?? "application/octet-stream",
+            size: res.data.size ?? undefined,
+        };
+    }
+    catch (err) {
+        const translated = translateGoogleError(err, {
+            account,
+            operation: "drive.files.get",
+        });
+        if (translated.code === "NOT_FOUND") {
+            throw new AxiError(`File '${flags.documentId}' not found (or ${account} doesn't have access)`, "FILE_NOT_FOUND", [
+                `Verify the file ID is correct (the portion of the URL after /d/)`,
+                `Confirm ${account} has at least view access to the file`,
+            ]);
+        }
+        throw translated;
+    }
+    const isNative = meta.mimeType.startsWith("application/vnd.google-apps.");
+    const nativeDefault = NATIVE_EXPORT_DEFAULTS[meta.mimeType];
+    if (isNative && !nativeDefault && !flags.as) {
+        throw new AxiError(`No default export format for native mime type ${meta.mimeType}`, "EXPORT_FORMAT_REQUIRED", [
+            "Pass --as <mime> to choose an export format",
+            "Common options: application/pdf, text/plain, text/html",
+        ]);
+    }
+    // Step 2: fetch bytes.
+    let bytes;
+    let effectiveMime;
+    let extension;
+    if (isNative) {
+        effectiveMime = flags.as ?? nativeDefault.mime;
+        extension = EXTENSION_BY_MIME[effectiveMime] ?? nativeDefault?.extension ?? "";
+        try {
+            const res = await api.files.export({ fileId: flags.documentId, mimeType: effectiveMime }, { responseType: "arraybuffer" });
+            bytes = Buffer.from(res.data);
+        }
+        catch (err) {
+            throw translateGoogleError(err, {
+                account,
+                operation: "drive.files.export",
+            });
+        }
+    }
+    else {
+        if (flags.as) {
+            throw new AxiError(`--as is only valid for native Google files; this is ${meta.mimeType}`, "VALIDATION_ERROR", [
+                "Drop --as to download the file as-is",
+                `The file will be saved with its original mime type (${meta.mimeType})`,
+            ]);
+        }
+        effectiveMime = meta.mimeType;
+        extension = extname(meta.name) || EXTENSION_BY_MIME[effectiveMime] || "";
+        try {
+            const res = await api.files.get({ fileId: flags.documentId, alt: "media", supportsAllDrives: true }, { responseType: "arraybuffer" });
+            bytes = Buffer.from(res.data);
+        }
+        catch (err) {
+            throw translateGoogleError(err, {
+                account,
+                operation: "drive.files.get(alt=media)",
+            });
+        }
+    }
+    // Step 3: compute output path. For native files we might need to append
+    // the extension because meta.name doesn't carry one for Google-native
+    // files (e.g., "My Doc" rather than "My Doc.docx").
+    let baseName = meta.name;
+    if (isNative && extension && !baseName.toLowerCase().endsWith(extension.toLowerCase())) {
+        baseName += extension;
+    }
+    const outPath = await resolveOutputPath(flags.out, baseName);
+    await mkdir(dirname(outPath), { recursive: true });
+    await writeFile(outPath, bytes);
+    // Step 4: response.
+    const blocks = [];
+    blocks.push(renderObject({ account }));
+    blocks.push(renderObject({
+        file: {
+            id: flags.documentId,
+            name: meta.name,
+            source_mime_type: meta.mimeType,
+            saved_mime_type: effectiveMime,
+            size_bytes: bytes.length,
+        },
+    }));
+    blocks.push(renderObject({ saved: outPath }));
+    const suggestions = [];
+    if (effectiveMime === "application/vnd.openxmlformats-officedocument.wordprocessingml.document") {
+        suggestions.push(`This is a .docx — extract text with \`pandoc "${basename(outPath)}" -t plain\` or \`textutil -convert txt "${basename(outPath)}"\``);
+    }
+    else if (effectiveMime === "application/pdf") {
+        suggestions.push(`This is a PDF — inspect with \`pdftotext "${basename(outPath)}" -\` or open in Preview`);
+    }
+    else if (effectiveMime.startsWith("text/")) {
+        suggestions.push(`Text file — \`cat "${outPath}"\` to view`);
+    }
+    else if (effectiveMime.startsWith("image/")) {
+        suggestions.push(`Image file — open with \`open "${outPath}"\` on macOS`);
+    }
+    else {
+        suggestions.push(`Inspect with \`file "${outPath}"\` to identify the format`);
+    }
+    if (isNative) {
+        suggestions.push(`Native Google file exported as ${effectiveMime} — use --as <mime> to pick a different format (e.g. application/pdf, text/plain)`);
+    }
+    blocks.push(renderHelp(suggestions));
+    return joinBlocks(...blocks);
+}
+//# sourceMappingURL=download.js.map

package/dist/src/commands/docs/download.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"download.js","sourceRoot":"","sources":["../../../../src/commands/docs/download.ts"],"names":[],"mappings":"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"}

package/dist/src/commands/docs/find.d.ts

@@ -0,0 +1,2 @@
+export declare const FIND_HELP = "usage: gws-axi docs find <documentId> --query <text> [flags]\nargs[1]:\n  <documentId>         The Google Doc ID (from the URL after /d/)\nflags[4]:\n  --query <text>       Text to search for (case-insensitive; required)\n  --tab <id>           Tab to search within (default: first tab)\n  --limit <n>          Max matches to return (default: 50)\n  --account <email>    Account override when 2+ are configured\nexamples:\n  gws-axi docs find 1BxAbc... --query \"sprint goal\"\n  gws-axi docs find 1BxAbc... --query foo --tab t.1 --limit 10\noutput:\n  A `matches[N]{ref,paragraph,start,end,context}` table. The `ref`\n  column holds compact `@N` handles that future mutation subcommands\n  (insert-text, delete-range) will accept as shorthand for the matched\n  range. `start` and `end` are raw Docs API character offsets.\nnotes:\n  Search is restricted to one tab per call \u2014 v1 does not fan out across\n  sibling tabs. Use `gws-axi docs read <id>` (no --tab) to see the tabs\n  list and pick one.\n";
+export declare function docsFindCommand(account: string, args: string[]): Promise<string>;