gws-axi 0.6.2 → 0.8.0

package/dist/src/cli.js

@@ -8,8 +8,8 @@ import { doctorCommand, DOCTOR_HELP } from "./commands/doctor.js";
 import { calendarCommand } from "./commands/calendar.js";
 import { gmailCommand } from "./commands/gmail.js";
 import { docsCommand } from "./commands/docs.js";
-import { driveCommand, DRIVE_HELP } from "./commands/drive.js";
-import { slidesCommand, SLIDES_HELP } from "./commands/slides.js";
+import { driveCommand } from "./commands/drive.js";
+import { slidesCommand } 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.";
 const VERSION = readPackageVersion();
 export const TOP_HELP = `usage: gws-axi [command] [args] [flags]
@@ -29,8 +29,6 @@ examples:
 const COMMAND_HELP = {
     auth: AUTH_HELP,
     doctor: DOCTOR_HELP,
-    drive: DRIVE_HELP,
-    slides: SLIDES_HELP,
 };
 export async function main() {
     await runAxiCli({

package/dist/src/cli.js.map

@@ -1 +1 @@
-{"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,MAAM,qBAAqB,CAAC;AACnD,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,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"}
+{"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,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD,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;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/drive/get.d.ts

@@ -0,0 +1,2 @@
+export declare const GET_HELP = "usage: gws-axi drive get <file-id> [flags]\nargs[1]:\n  <file-id>            The Drive file ID (from the URL or `drive search` / ls output)\nflags[1]:\n  --account <email>    Account override when 2+ are configured\nexamples:\n  gws-axi drive get 1AbC...\noutput:\n  A `file{...}` object with name, mime_type, size, owners, parents,\n  modified/created times, and view-link. For native Google files\n  (Docs, Sheets, Slides) we include hints pointing at `docs read` /\n  `docs download`; for other types, `drive download`.\n";
+export declare function driveGetCommand(account: string, args: string[]): Promise<string>;

package/dist/src/commands/drive/get.js

@@ -0,0 +1,112 @@
+import { AxiError } from "axi-sdk-js";
+import { driveClient, translateGoogleError } from "../../google/client.js";
+import { joinBlocks, renderHelp, renderObject } from "../../output/index.js";
+export const GET_HELP = `usage: gws-axi drive get <file-id> [flags]
+args[1]:
+  <file-id>            The Drive file ID (from the URL or \`drive search\` / ls output)
+flags[1]:
+  --account <email>    Account override when 2+ are configured
+examples:
+  gws-axi drive get 1AbC...
+output:
+  A \`file{...}\` object with name, mime_type, size, owners, parents,
+  modified/created times, and view-link. For native Google files
+  (Docs, Sheets, Slides) we include hints pointing at \`docs read\` /
+  \`docs download\`; for other types, \`drive download\`.
+`;
+function parseFlags(args) {
+    let fileId;
+    for (const arg of args) {
+        if (!arg.startsWith("--") && fileId === undefined) {
+            fileId = arg;
+        }
+    }
+    if (!fileId) {
+        throw new AxiError("Missing file ID argument", "VALIDATION_ERROR", ["Usage: gws-axi drive get <file-id>"]);
+    }
+    return { fileId };
+}
+const GET_FIELDS = "id,name,mimeType,size,createdTime,modifiedTime,owners(emailAddress,displayName),parents,description,trashed,starred,shared,webViewLink,iconLink,sha256Checksum,fileExtension";
+export async function driveGetCommand(account, args) {
+    const flags = parseFlags(args);
+    const api = await driveClient(account);
+    let file;
+    try {
+        const res = await api.files.get({
+            fileId: flags.fileId,
+            fields: GET_FIELDS,
+            supportsAllDrives: true,
+        });
+        file = res.data;
+    }
+    catch (err) {
+        const translated = translateGoogleError(err, {
+            account,
+            operation: "drive.files.get",
+        });
+        if (translated.code === "NOT_FOUND") {
+            throw new AxiError(`File '${flags.fileId}' not found (or ${account} doesn't have access)`, "FILE_NOT_FOUND", [
+                `Verify the file ID is correct (from a Drive URL or \`drive search\`)`,
+                `Confirm ${account} has at least view access`,
+            ]);
+        }
+        throw translated;
+    }
+    const isNative = (file.mimeType ?? "").startsWith("application/vnd.google-apps.");
+    const isFolder = file.mimeType === "application/vnd.google-apps.folder";
+    const details = {
+        id: file.id ?? flags.fileId,
+        name: file.name ?? "",
+        mime_type: file.mimeType ?? "",
+    };
+    if (file.size)
+        details.size_bytes = parseInt(file.size, 10);
+    if (file.createdTime)
+        details.created = file.createdTime;
+    if (file.modifiedTime)
+        details.modified = file.modifiedTime;
+    if (file.owners?.length) {
+        details.owners = file.owners
+            .map((o) => o.emailAddress ?? o.displayName ?? "")
+            .filter(Boolean)
+            .join(", ");
+    }
+    if (file.parents?.length)
+        details.parents = file.parents.join(", ");
+    if (file.description)
+        details.description = file.description;
+    if (file.shared !== undefined)
+        details.shared = file.shared;
+    if (file.starred)
+        details.starred = true;
+    if (file.trashed)
+        details.trashed = true;
+    if (file.webViewLink)
+        details.web_view_link = file.webViewLink;
+    if (file.fileExtension)
+        details.file_extension = file.fileExtension;
+    const blocks = [];
+    blocks.push(renderObject({ account }));
+    blocks.push(renderObject({ file: details }));
+    const suggestions = [];
+    if (isFolder) {
+        suggestions.push(`Run \`gws-axi drive ls ${file.id} --recursive\` to walk this folder's contents`);
+    }
+    else if (file.mimeType === "application/vnd.google-apps.document") {
+        suggestions.push(`Run \`gws-axi docs read ${file.id}\` to read this Doc as markdown`);
+        suggestions.push(`Run \`gws-axi docs comments ${file.id}\` to see review comments`);
+    }
+    else if (isNative) {
+        suggestions.push(`Native Google file — run \`gws-axi docs download ${file.id} --as <mime>\` to export (e.g. application/pdf, text/csv)`);
+    }
+    else {
+        suggestions.push(`Run \`gws-axi docs download ${file.id} --out <path>\` to fetch the raw file`);
+    }
+    suggestions.push(`Run \`gws-axi drive permissions ${file.id}\` to see who has access`);
+    if (file.webViewLink) {
+        suggestions.push(`Open in browser: ${file.webViewLink}`);
+    }
+    blocks.push(renderHelp(suggestions));
+    return joinBlocks(...blocks);
+}
+//# sourceMappingURL=get.js.map

package/dist/src/commands/drive/get.js.map

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

package/dist/src/commands/drive/ls.d.ts

@@ -0,0 +1,2 @@
+export declare const LS_HELP = "usage: gws-axi drive ls [<folder-id>] [flags]\nargs[1]:\n  <folder-id>          Folder ID to list (default: \"root\", aka My Drive).\n                       Pass \"shared-with-me\" to list files shared with you\n                       but not in any of your folders.\nflags[6]:\n  --recursive, -r      Walk the tree and emit a flat list with full paths\n                       relative to the queried folder. Off by default; for\n                       a quality overview of an entire client/project\n                       folder, pass --recursive.\n  --depth <n>          Cap recursion depth (default: unlimited \u2014 the\n                       --limit safety bound stops runaway walks). Only\n                       meaningful with --recursive; useful for \"give me\n                       a 2-level overview without diving into every\n                       subfolder.\"\n  --limit <n>          Max items to return (default: 500, max: 5000).\n                       For --recursive, this is the total file count\n                       across the walk; for non-recursive, it's the page\n                       size against the API.\n  --page <token>       Fetch next page (non-recursive only \u2014 recursive\n                       walks paginate internally).\n  --include-trashed    Include trashed files (default: trashed excluded)\n  --account <email>    Account override when 2+ are configured\nexamples:\n  gws-axi drive ls                                            # root contents\n  gws-axi drive ls 1AbC...folder-id                           # one folder\n  gws-axi drive ls 1AbC...folder-id --recursive               # whole tree\n  gws-axi drive ls 1AbC... --recursive --depth 3 --limit 1000 # constrained walk\noutput:\n  A `files[N]{path,id,mime_type,size_bytes,modified}` table. `path` is\n  the name for non-recursive listings; the relative path within the walk\n  for recursive ones (`Subfolder/file.pdf`). Folders have an empty\n  size_bytes. `mime_type` is the raw Google MIME (`application/vnd.google-apps.folder`,\n  `application/vnd.google-apps.document`, etc.) \u2014 use it to filter.\nnotes:\n  Recursive walks make one API call per folder (Drive doesn't support\n  recursive list natively). A folder with 10 subfolders \u00D7 3 levels deep\n  \u2248 1+10+100+1000 calls \u2014 bounded by --depth and --limit. Trashed and\n  shortcut items are skipped unless --include-trashed.\n";
+export declare function driveLsCommand(account: string, args: string[]): Promise<string>;

package/dist/src/commands/drive/ls.js

@@ -0,0 +1,268 @@
+import { AxiError } from "axi-sdk-js";
+import { driveClient, translateGoogleError } from "../../google/client.js";
+import { field, renderListResponse, } from "../../output/index.js";
+export const LS_HELP = `usage: gws-axi drive ls [<folder-id>] [flags]
+args[1]:
+  <folder-id>          Folder ID to list (default: "root", aka My Drive).
+                       Pass "shared-with-me" to list files shared with you
+                       but not in any of your folders.
+flags[6]:
+  --recursive, -r      Walk the tree and emit a flat list with full paths
+                       relative to the queried folder. Off by default; for
+                       a quality overview of an entire client/project
+                       folder, pass --recursive.
+  --depth <n>          Cap recursion depth (default: unlimited — the
+                       --limit safety bound stops runaway walks). Only
+                       meaningful with --recursive; useful for "give me
+                       a 2-level overview without diving into every
+                       subfolder."
+  --limit <n>          Max items to return (default: 500, max: 5000).
+                       For --recursive, this is the total file count
+                       across the walk; for non-recursive, it's the page
+                       size against the API.
+  --page <token>       Fetch next page (non-recursive only — recursive
+                       walks paginate internally).
+  --include-trashed    Include trashed files (default: trashed excluded)
+  --account <email>    Account override when 2+ are configured
+examples:
+  gws-axi drive ls                                            # root contents
+  gws-axi drive ls 1AbC...folder-id                           # one folder
+  gws-axi drive ls 1AbC...folder-id --recursive               # whole tree
+  gws-axi drive ls 1AbC... --recursive --depth 3 --limit 1000 # constrained walk
+output:
+  A \`files[N]{path,id,mime_type,size_bytes,modified}\` table. \`path\` is
+  the name for non-recursive listings; the relative path within the walk
+  for recursive ones (\`Subfolder/file.pdf\`). Folders have an empty
+  size_bytes. \`mime_type\` is the raw Google MIME (\`application/vnd.google-apps.folder\`,
+  \`application/vnd.google-apps.document\`, etc.) — use it to filter.
+notes:
+  Recursive walks make one API call per folder (Drive doesn't support
+  recursive list natively). A folder with 10 subfolders × 3 levels deep
+  ≈ 1+10+100+1000 calls — bounded by --depth and --limit. Trashed and
+  shortcut items are skipped unless --include-trashed.
+`;
+const DEFAULT_LIMIT = 500;
+const MAX_LIMIT = 5000;
+// Recursion defaults to unlimited depth; --limit (total file count)
+// is the practical safety bound. Most folder trees aren't deeper
+// than 5-6 levels anyway, so a depth cap rarely fires before --limit
+// does. Callers who want a "shallow overview" pass --depth explicitly.
+const DEFAULT_DEPTH = Number.POSITIVE_INFINITY;
+const FOLDER_MIME = "application/vnd.google-apps.folder";
+function parseFlags(args) {
+    let folderId;
+    let recursive = false;
+    let depth = DEFAULT_DEPTH;
+    let limit = DEFAULT_LIMIT;
+    let page;
+    let includeTrashed = false;
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        const next = args[i + 1];
+        switch (arg) {
+            case "--recursive":
+            case "-r":
+                recursive = true;
+                break;
+            case "--depth": {
+                const parsed = parseInt(next, 10);
+                depth = Number.isFinite(parsed) && parsed >= 0 ? parsed : DEFAULT_DEPTH;
+                i++;
+                break;
+            }
+            case "--limit":
+                limit = Math.max(1, Math.min(MAX_LIMIT, parseInt(next, 10) || DEFAULT_LIMIT));
+                i++;
+                break;
+            case "--page":
+                page = next;
+                i++;
+                break;
+            case "--include-trashed":
+                includeTrashed = true;
+                break;
+            default:
+                if (!arg.startsWith("--") && folderId === undefined) {
+                    folderId = arg;
+                }
+        }
+    }
+    return {
+        folderId: folderId ?? "root",
+        recursive,
+        depth,
+        limit,
+        page,
+        includeTrashed,
+    };
+}
+const FILES_FIELDS = "id,name,mimeType,size,modifiedTime,trashed";
+async function listOneFolder(api, folderId, pageToken, pageSize, includeTrashed) {
+    const q = includeTrashed
+        ? `'${folderId}' in parents`
+        : `'${folderId}' in parents and trashed = false`;
+    const res = await api.files.list({
+        q,
+        fields: `nextPageToken, files(${FILES_FIELDS})`,
+        pageSize,
+        pageToken,
+        supportsAllDrives: true,
+        includeItemsFromAllDrives: true,
+        orderBy: "folder, name",
+    });
+    return {
+        files: res.data.files ?? [],
+        nextPageToken: res.data.nextPageToken ?? undefined,
+    };
+}
+function toRow(file, path) {
+    return {
+        path,
+        id: file.id ?? "",
+        mime_type: file.mimeType ?? "",
+        size_bytes: file.size ? parseInt(file.size, 10) : "",
+        modified: file.modifiedTime ?? "",
+    };
+}
+async function recursiveWalk(api, folderId, flags) {
+    const rows = [];
+    let foldersWalked = 0;
+    // BFS keyed by (folderId, prefixPath, depthFromRoot). Stable
+    // ordering means a folder's own row is emitted before its children's,
+    // which matches what humans expect from `ls -R`.
+    const queue = [
+        { id: folderId, prefix: "", depth: 0 },
+    ];
+    while (queue.length > 0 && rows.length < flags.limit) {
+        const { id, prefix, depth } = queue.shift();
+        foldersWalked += 1;
+        let pageToken;
+        do {
+            // 1000 is Drive's max pageSize and lets us drain a folder quickly.
+            const { files, nextPageToken } = await listOneFolder(api, id, pageToken, 1000, flags.includeTrashed);
+            for (const file of files) {
+                if (rows.length >= flags.limit)
+                    break;
+                const path = prefix + (file.name ?? "");
+                rows.push(toRow(file, path));
+                if (file.mimeType === FOLDER_MIME && depth < flags.depth) {
+                    queue.push({
+                        id: file.id ?? "",
+                        prefix: `${path}/`,
+                        depth: depth + 1,
+                    });
+                }
+            }
+            pageToken = nextPageToken;
+        } while (pageToken && rows.length < flags.limit);
+    }
+    return {
+        rows,
+        truncated: rows.length >= flags.limit && queue.length > 0,
+        foldersWalked,
+    };
+}
+function fileSchema() {
+    return [
+        field("path"),
+        field("id"),
+        field("mime_type"),
+        field("size_bytes"),
+        field("modified"),
+    ];
+}
+export async function driveLsCommand(account, args) {
+    const flags = parseFlags(args);
+    const api = await driveClient(account);
+    let rows;
+    let nextPage;
+    let truncated = false;
+    let foldersWalked = 0;
+    if (flags.recursive) {
+        try {
+            const result = await recursiveWalk(api, flags.folderId, flags);
+            rows = result.rows;
+            truncated = result.truncated;
+            foldersWalked = result.foldersWalked;
+        }
+        catch (err) {
+            const translated = translateGoogleError(err, {
+                account,
+                operation: "drive.files.list",
+            });
+            if (translated.code === "NOT_FOUND") {
+                throw new AxiError(`Folder '${flags.folderId}' not found (or ${account} doesn't have access)`, "FOLDER_NOT_FOUND", [
+                    `Pass "root" or omit the argument to list My Drive root`,
+                    `Verify the folder ID is correct (from a Drive URL or \`drive search\`)`,
+                ]);
+            }
+            throw translated;
+        }
+    }
+    else {
+        try {
+            const result = await listOneFolder(api, flags.folderId, flags.page, flags.limit, flags.includeTrashed);
+            rows = result.files.map((f) => toRow(f, f.name ?? ""));
+            nextPage = result.nextPageToken;
+        }
+        catch (err) {
+            const translated = translateGoogleError(err, {
+                account,
+                operation: "drive.files.list",
+            });
+            if (translated.code === "NOT_FOUND") {
+                throw new AxiError(`Folder '${flags.folderId}' not found (or ${account} doesn't have access)`, "FOLDER_NOT_FOUND", [
+                    `Pass "root" or omit the argument to list My Drive root`,
+                    `Verify the folder ID is correct (from a Drive URL or \`drive search\`)`,
+                ]);
+            }
+            throw translated;
+        }
+    }
+    const header = {
+        account,
+        folder: flags.folderId,
+        mode: flags.recursive ? "recursive" : "shallow",
+    };
+    if (flags.recursive && foldersWalked > 0) {
+        header.folders_walked = foldersWalked;
+    }
+    if (nextPage)
+        header.next_page = nextPage;
+    const summary = { count: rows.length };
+    if (truncated) {
+        summary.truncated = true;
+        summary.note = `Hit --limit ${flags.limit} before walk completed — increase --limit or narrow --depth`;
+    }
+    const suggestions = [];
+    if (rows.length > 0) {
+        if (!flags.recursive) {
+            const folderCount = rows.filter((r) => r.mime_type === FOLDER_MIME).length;
+            if (folderCount > 0) {
+                suggestions.push(`${folderCount} folder${folderCount === 1 ? "" : "s"} in this listing — run \`gws-axi drive ls ${flags.folderId} --recursive\` for the full tree (or \`drive ls <subfolder-id>\` to dive into one)`);
+            }
+            else {
+                // Even with no folders to descend into, mention recursion exists for
+                // the case where this is a flat folder of files.
+                suggestions.push(`Run with --recursive for a deep listing (if subfolders exist this would expand them; this folder appears flat)`);
+            }
+        }
+        suggestions.push(`Run \`gws-axi drive get <id>\` for full file metadata (sharing, owners, descriptions)`);
+        suggestions.push(`Run \`gws-axi docs read <id>\` or \`drive download <id>\` to read file contents`);
+        if (nextPage) {
+            suggestions.push(`More items available — paginate with \`drive ls ${flags.folderId} --page ${nextPage}\``);
+        }
+    }
+    return renderListResponse({
+        header,
+        summary,
+        name: "files",
+        items: rows,
+        schema: fileSchema(),
+        suggestions,
+        emptyMessage: flags.recursive
+            ? `no files in or under \`${flags.folderId}\``
+            : `no files in \`${flags.folderId}\` (try --recursive if you want subfolder contents, or --include-trashed)`,
+    });
+}
+//# sourceMappingURL=ls.js.map

package/dist/src/commands/drive/ls.js.map

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

package/dist/src/commands/drive/permissions.d.ts

@@ -0,0 +1,2 @@
+export declare const PERMISSIONS_HELP = "usage: gws-axi drive permissions <file-id> [flags]\nargs[1]:\n  <file-id>            The Drive file ID (from URL or `drive get` / `drive ls`)\nflags[1]:\n  --account <email>    Account override when 2+ are configured\nexamples:\n  gws-axi drive permissions 1AbC...\noutput:\n  A `file{id,name,shared}` header plus a `permissions[N]{role,type,\n  email_or_domain,display_name,deleted}` table. `role` is owner/\n  organizer/fileOrganizer/writer/commenter/reader; `type` is user/\n  group/domain/anyone.\nnotes:\n  Permissions only enumerate explicit grants \u2014 inherited folder\n  permissions and shared-drive memberships aren't surfaced. Pass\n  `supportsAllDrives: true` is automatic; shared-drive ACLs may\n  include a longer chain than what shows here.\n";
+export declare function drivePermissionsCommand(account: string, args: string[]): Promise<string>;

package/dist/src/commands/drive/permissions.js

@@ -0,0 +1,117 @@
+import { AxiError } from "axi-sdk-js";
+import { driveClient, translateGoogleError } from "../../google/client.js";
+import { field, renderList, renderObject, joinBlocks, renderHelp, } from "../../output/index.js";
+export const PERMISSIONS_HELP = `usage: gws-axi drive permissions <file-id> [flags]
+args[1]:
+  <file-id>            The Drive file ID (from URL or \`drive get\` / \`drive ls\`)
+flags[1]:
+  --account <email>    Account override when 2+ are configured
+examples:
+  gws-axi drive permissions 1AbC...
+output:
+  A \`file{id,name,shared}\` header plus a \`permissions[N]{role,type,
+  email_or_domain,display_name,deleted}\` table. \`role\` is owner/
+  organizer/fileOrganizer/writer/commenter/reader; \`type\` is user/
+  group/domain/anyone.
+notes:
+  Permissions only enumerate explicit grants — inherited folder
+  permissions and shared-drive memberships aren't surfaced. Pass
+  \`supportsAllDrives: true\` is automatic; shared-drive ACLs may
+  include a longer chain than what shows here.
+`;
+function parseFlags(args) {
+    let fileId;
+    for (const arg of args) {
+        if (!arg.startsWith("--") && fileId === undefined)
+            fileId = arg;
+    }
+    if (!fileId) {
+        throw new AxiError("Missing file ID argument", "VALIDATION_ERROR", ["Usage: gws-axi drive permissions <file-id>"]);
+    }
+    return { fileId };
+}
+function permissionSchema() {
+    return [
+        field("role"),
+        field("type"),
+        field("email_or_domain"),
+        field("display_name"),
+        field("deleted"),
+    ];
+}
+export async function drivePermissionsCommand(account, args) {
+    const flags = parseFlags(args);
+    const api = await driveClient(account);
+    // File metadata first so we can show name + shared flag alongside.
+    let file;
+    try {
+        const res = await api.files.get({
+            fileId: flags.fileId,
+            fields: "id,name,shared,owners(emailAddress)",
+            supportsAllDrives: true,
+        });
+        file = res.data;
+    }
+    catch (err) {
+        const translated = translateGoogleError(err, {
+            account,
+            operation: "drive.files.get",
+        });
+        if (translated.code === "NOT_FOUND") {
+            throw new AxiError(`File '${flags.fileId}' not found (or ${account} doesn't have access)`, "FILE_NOT_FOUND", [`Verify the file ID is correct (from a Drive URL or \`drive search\`)`]);
+        }
+        throw translated;
+    }
+    let perms = [];
+    try {
+        const res = await api.permissions.list({
+            fileId: flags.fileId,
+            fields: "permissions(id,type,role,emailAddress,domain,displayName,deleted,pendingOwner)",
+            supportsAllDrives: true,
+        });
+        perms = res.data.permissions ?? [];
+    }
+    catch (err) {
+        throw translateGoogleError(err, {
+            account,
+            operation: "drive.permissions.list",
+        });
+    }
+    const rows = perms.map((p) => ({
+        role: p.role ?? "",
+        type: p.type ?? "",
+        email_or_domain: p.emailAddress ?? p.domain ?? (p.type === "anyone" ? "anyone with link" : ""),
+        display_name: p.displayName ?? "",
+        deleted: p.deleted ? "✓" : "",
+    }));
+    const blocks = [];
+    blocks.push(renderObject({ account }));
+    blocks.push(renderObject({
+        file: {
+            id: file.id ?? flags.fileId,
+            name: file.name ?? "",
+            shared: file.shared ?? false,
+        },
+    }));
+    if (rows.length === 0) {
+        blocks.push(renderObject({ permissions: "no explicit permissions" }));
+    }
+    else {
+        blocks.push(renderList("permissions", rows, permissionSchema()));
+    }
+    const suggestions = [];
+    const anyone = perms.find((p) => p.type === "anyone");
+    if (anyone) {
+        suggestions.push(`"anyone with link" (role: ${anyone.role}) — this file is accessible without sign-in`);
+    }
+    const externalUsers = perms.filter((p) => p.type === "user" &&
+        p.emailAddress &&
+        !p.emailAddress.endsWith(`@${account.split("@")[1] ?? ""}`));
+    if (externalUsers.length > 0) {
+        suggestions.push(`${externalUsers.length} external user${externalUsers.length === 1 ? "" : "s"} have access (not on ${account.split("@")[1] ?? "your"} domain)`);
+    }
+    if (suggestions.length > 0)
+        blocks.push(renderHelp(suggestions));
+    return joinBlocks(...blocks);
+}
+//# sourceMappingURL=permissions.js.map

package/dist/src/commands/drive/permissions.js.map

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

package/dist/src/commands/drive/search.d.ts

@@ -0,0 +1,2 @@
+export declare const SEARCH_HELP = "usage: gws-axi drive search [flags]\nflags[5]:\n  --query <text>             Full-text search across file names AND content\n                             (Drive's fullText index). Quote multi-word\n                             phrases. Default when omitted: all files\n                             modified in the last 30 days.\n  --mime <type>              Filter by mime type (e.g.,\n                             \"application/vnd.google-apps.document\" for\n                             only Google Docs; \"application/pdf\" for PDFs).\n  --limit <n>                Max files to return (default: 100, max: 1000).\n  --page <token>             Fetch the next page (from prior `next_page`).\n  --account <email>          Account override when 2+ are configured.\nexamples:\n  gws-axi drive search --query \"smart data hub\"\n  gws-axi drive search --query \"tides\" --mime application/vnd.google-apps.document\n  gws-axi drive search --query \"invoice\" --mime application/pdf --limit 25\noutput:\n  A `files[N]{id,name,mime_type,size_bytes,modified,owners}` table.\n  Pass any `id` to `drive get` for full metadata, `docs read` (for\n  Docs), or `docs download` (any file). The `mime_type` lets agents\n  filter for the file type they care about.\nnotes:\n  fullText matching uses Drive's index, which lags edits by minutes.\n  Recently-modified docs may not be indexed yet \u2014 for those, use\n  `drive ls` on the parent folder instead.\n";
+export declare function driveSearchCommand(account: string, args: string[]): Promise<string>;