gws-axi 0.8.4 → 0.9.0

package/README.md

@@ -4,7 +4,7 @@ Agent-ergonomic CLI for Google Workspace — Gmail, Calendar, Docs, Drive, and S
 
 Designed for use by AI agents. Every response is structured, every error names a specific fix, and write operations lock to the explicit account when multiple are authenticated — so two agents in parallel sessions can't silently touch the wrong mailbox.
 
-> **Status:** Read coverage is in across all five services — Calendar, Gmail, Docs, Drive, and Slides — and Calendar has full write support (`create`, `update`, `delete`, `respond`). Gmail writes (`send`, `draft`, `modify`) and Docs writes (`append`, `insert-text`, `delete-range`) are the next frontier. Auth (including a single-developer `auth publish` walkthrough that retires the 7-day Testing-token expiry), doctor with live per-account API probes, and multi-account write-protection are stable.
+> **Status:** Read coverage is in across all five services — Calendar, Gmail, Docs, Drive, and Slides. **Calendar** and **Gmail** both have full write support: Calendar does `create` / `update` / `delete` / `respond`, and Gmail does triage (`modify`, `batch-modify`), drafting (`draft`), label CRUD (`label-create` / `label-update` / `label-delete`), and server-side filters (`filter-create` / `filter-delete` / `filter-list`). Gmail **`send` is intentionally out of scope** — gws-axi drafts mail for human review but never sends it. Docs writes (`append`, `insert-text`, `delete-range`) are the next frontier. Auth (including a single-developer `auth publish` walkthrough that retires the 7-day Testing-token expiry), doctor with live per-account API probes, and multi-account write-protection are stable.
 
 ## Requirements
 
@@ -123,6 +123,8 @@ Writes default `--send-updates` to `none` so agent-created events don't spam att
 
 ### Gmail
 
+**Reads:**
+
 ```bash
 gws-axi gmail search                              # in:inbox by default
 gws-axi gmail search --query "from:alice has:attachment"
@@ -134,8 +136,41 @@ gws-axi gmail labels                              # list labels with IDs
 gws-axi gmail download <message-id> <attachment-id>  # fetch attachment bytes
 ```
 
+**Writes** (triage, drafting, labels, filters — but never *send*):
+
+```bash
+# Triage — Gmail state IS labels, so archive/read/star are label edits:
+gws-axi gmail modify <message-id> --remove-label INBOX        # archive
+gws-axi gmail modify <message-id> --remove-label UNREAD       # mark read
+gws-axi gmail modify <message-id> --add-label STARRED         # star
+gws-axi gmail modify <message-id> --add-label "Work/Clients" --remove-label INBOX
+gws-axi gmail modify <thread-id> --thread --remove-label UNREAD  # whole thread
+
+# Bulk triage by query:
+gws-axi gmail batch-modify --query "from:news@x.com" --remove-label INBOX
+gws-axi gmail batch-modify --query "is:unread older_than:30d" --remove-label UNREAD
+
+# Drafts (composed for you; you send from Gmail):
+gws-axi gmail draft --to alice@x.com --subject "Re: budget" --body "Approved."
+gws-axi gmail draft --to a@x.com,b@x.com --subject Hi --body-file ./note.txt --thread <id>
+
+# Label management:
+gws-axi gmail label-create --name "Work/Clients"
+gws-axi gmail label-update <label-id|name> --name "Archive"
+gws-axi gmail label-delete <label-id|name>
+
+# Server-side auto-sort filters:
+gws-axi gmail filter-list
+gws-axi gmail filter-create --from news@x.com --remove-label INBOX --add-label News
+gws-axi gmail filter-delete <filter-id>
+```
+
 Bodies are decoded per declared `Content-Type` charset (UTF-8, latin-1, ascii, utf-16). HTML-only messages convert to markdown via turndown. Address headers parse with `addressparser` so display names with commas don't get split.
 
+**On `send`:** gws-axi has no `send` command by design — an agent can triage, label, and draft replies, but a human reviews and sends from Gmail. This is a guardrail against *accidental* sends, not a hard security boundary (the OAuth token is send-capable; there is no Gmail scope that grants drafting + label edits while withholding send). `gws-axi gmail send` returns a `NOT_SUPPORTED` error pointing at `draft`.
+
+**Scope note:** the filter commands need the `gmail.settings.basic` scope, which `gmail.modify` does not include. Accounts authenticated before this release will get a `SCOPE_MISSING` (403) on filter commands until you re-run `gws-axi auth login --account <email>` once to re-consent.
+
 ### Docs
 
 ```bash
@@ -198,8 +233,9 @@ help[2]:
 
 ## Known issues & roadmap
 
-- **Gmail writes** (`send`, `draft`, `modify`, label add/remove): scaffolded as `NOT_IMPLEMENTED`. Coming next.
-- **Docs writes** (`append`, `insert-text`, `delete-range`, etc.): scaffolded as `NOT_IMPLEMENTED`. Coming alongside Gmail writes.
+- **Gmail `send`**: intentionally unsupported — gws-axi drafts mail but leaves sending to a human in the Gmail UI. See the Gmail section above.
+- **Docs writes** (`append`, `insert-text`, `delete-range`, etc.): scaffolded as `NOT_IMPLEMENTED`. The next frontier.
+- **Drive/Slides writes**: still scaffolded as `NOT_IMPLEMENTED` (reads are complete).
 - **Testing-mode tokens** still expire every 7 days *if* you haven't published your OAuth app yet. Run `gws-axi auth publish` for the walkthrough — it covers the single-developer Production flow and removes the expiry once you've re-auth'd each account.
 
 ## Contributing

package/dist/src/auth/scopes.d.ts

@@ -6,6 +6,7 @@ export declare const SERVICE_SCOPES: {
     readonly drive: "https://www.googleapis.com/auth/drive";
     readonly slides: "https://www.googleapis.com/auth/presentations";
 };
+export declare const ADDITIONAL_SCOPES: readonly ["https://www.googleapis.com/auth/gmail.settings.basic"];
 export type ServiceName = keyof typeof SERVICE_SCOPES;
 export declare const SERVICES: ServiceName[];
 export declare const REQUIRED_APIS: Record<ServiceName, string>;

package/dist/src/auth/scopes.js

@@ -6,6 +6,14 @@ export const SERVICE_SCOPES = {
     drive: "https://www.googleapis.com/auth/drive",
     slides: "https://www.googleapis.com/auth/presentations",
 };
+// Scopes layered on top of the representative per-service scope above.
+// gmail.settings.basic is required for Gmail filter management
+// (users.settings.filters.*); it is NOT covered by gmail.modify. Kept
+// separate so the per-service probe/health checks keep keying off the
+// single representative scope in SERVICE_SCOPES.
+export const ADDITIONAL_SCOPES = [
+    "https://www.googleapis.com/auth/gmail.settings.basic",
+];
 export const SERVICES = [
     "gmail",
     "calendar",
@@ -21,7 +29,7 @@ export const REQUIRED_APIS = {
     slides: "slides.googleapis.com",
 };
 export function allScopes() {
-    return [...BASE_SCOPES, ...Object.values(SERVICE_SCOPES)];
+    return [...BASE_SCOPES, ...Object.values(SERVICE_SCOPES), ...ADDITIONAL_SCOPES];
 }
 export function allApis() {
     return Object.values(REQUIRED_APIS);

package/dist/src/auth/scopes.js.map

@@ -1 +1 @@
-{"version":3,"file":"scopes.js","sourceRoot":"","sources":["../../../src/auth/scopes.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,QAAQ,EAAE,OAAO,EAAE,SAAS,CAAU,CAAC;AAEnE,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,KAAK,EAAE,8CAA8C;IACrD,QAAQ,EAAE,0CAA0C;IACpD,IAAI,EAAE,2CAA2C;IACjD,KAAK,EAAE,uCAAuC;IAC9C,MAAM,EAAE,+CAA+C;CAC/C,CAAC;AAIX,MAAM,CAAC,MAAM,QAAQ,GAAkB;IACrC,OAAO;IACP,UAAU;IACV,MAAM;IACN,OAAO;IACP,QAAQ;CACT,CAAC;AAEF,MAAM,CAAC,MAAM,aAAa,GAAgC;IACxD,KAAK,EAAE,sBAAsB;IAC7B,QAAQ,EAAE,8BAA8B;IACxC,IAAI,EAAE,qBAAqB;IAC3B,KAAK,EAAE,sBAAsB;IAC7B,MAAM,EAAE,uBAAuB;CAChC,CAAC;AAEF,MAAM,UAAU,SAAS;IACvB,OAAO,CAAC,GAAG,WAAW,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC;AAC5D,CAAC;AAED,MAAM,UAAU,OAAO;IACrB,OAAO,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;AACtC,CAAC"}
+{"version":3,"file":"scopes.js","sourceRoot":"","sources":["../../../src/auth/scopes.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,QAAQ,EAAE,OAAO,EAAE,SAAS,CAAU,CAAC;AAEnE,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,KAAK,EAAE,8CAA8C;IACrD,QAAQ,EAAE,0CAA0C;IACpD,IAAI,EAAE,2CAA2C;IACjD,KAAK,EAAE,uCAAuC;IAC9C,MAAM,EAAE,+CAA+C;CAC/C,CAAC;AAEX,uEAAuE;AACvE,+DAA+D;AAC/D,sEAAsE;AACtE,sEAAsE;AACtE,iDAAiD;AACjD,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,sDAAsD;CAC9C,CAAC;AAIX,MAAM,CAAC,MAAM,QAAQ,GAAkB;IACrC,OAAO;IACP,UAAU;IACV,MAAM;IACN,OAAO;IACP,QAAQ;CACT,CAAC;AAEF,MAAM,CAAC,MAAM,aAAa,GAAgC;IACxD,KAAK,EAAE,sBAAsB;IAC7B,QAAQ,EAAE,8BAA8B;IACxC,IAAI,EAAE,qBAAqB;IAC3B,KAAK,EAAE,sBAAsB;IAC7B,MAAM,EAAE,uBAAuB;CAChC,CAAC;AAEF,MAAM,UAAU,SAAS;IACvB,OAAO,CAAC,GAAG,WAAW,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,EAAE,GAAG,iBAAiB,CAAC,CAAC;AAClF,CAAC;AAED,MAAM,UAAU,OAAO;IACrB,OAAO,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;AACtC,CAAC"}

package/dist/src/commands/gmail/batch-modify.d.ts

@@ -0,0 +1,2 @@
+export declare const BATCH_MODIFY_HELP = "usage: gws-axi gmail batch-modify --query <text> [--add-label <name>...] [--remove-label <name>...] [flags]\nflags[6]:\n  --query <text>         REQUIRED \u2014 Gmail search query selecting the messages\n                         to modify (full Gmail syntax: from:, is:unread, etc.)\n  --add-label <name>     Label to apply to every match. Repeatable / comma list.\n                         Accepts user + system labels (INBOX, UNREAD, STARRED\u2026)\n  --remove-label <name>  Label to remove from every match. Same name rules\n  --limit <n>            Max messages to affect (default: 100, max: 1000)\n  --include-spam-trash   Include spam/trash in the selection\n  --account <email>      REQUIRED when 2+ accounts are authenticated\nexamples:\n  gws-axi gmail batch-modify --query \"from:newsletters@x.com\" --remove-label INBOX\n  gws-axi gmail batch-modify --query \"is:unread older_than:30d\" --remove-label UNREAD\n  gws-axi gmail batch-modify --query \"from:boss@x.com\" --add-label \"Important/Boss\"\nnotes:\n  Operates on MESSAGES matching --query (not threads). At least one of\n  --add-label / --remove-label is required. If more messages match than\n  --limit, only the first --limit are modified and the response says so \u2014\n  re-run to continue. Idempotent per message (see `gmail modify`).\n";
+export declare function gmailBatchModifyCommand(account: string, args: string[]): Promise<string>;

package/dist/src/commands/gmail/batch-modify.js

@@ -0,0 +1,158 @@
+import { AxiError } from "axi-sdk-js";
+import { gmailClient, translateGoogleError } from "../../google/client.js";
+import { joinBlocks, renderHelp, renderObject } from "../../output/index.js";
+import { fetchLabels, labelNamesFor, resolveLabelIds, } from "./labels-shared.js";
+const DEFAULT_LIMIT = 100;
+const MAX_LIMIT = 1000; // messages.batchModify accepts up to 1000 ids per call.
+export const BATCH_MODIFY_HELP = `usage: gws-axi gmail batch-modify --query <text> [--add-label <name>...] [--remove-label <name>...] [flags]
+flags[6]:
+  --query <text>         REQUIRED — Gmail search query selecting the messages
+                         to modify (full Gmail syntax: from:, is:unread, etc.)
+  --add-label <name>     Label to apply to every match. Repeatable / comma list.
+                         Accepts user + system labels (INBOX, UNREAD, STARRED…)
+  --remove-label <name>  Label to remove from every match. Same name rules
+  --limit <n>            Max messages to affect (default: 100, max: 1000)
+  --include-spam-trash   Include spam/trash in the selection
+  --account <email>      REQUIRED when 2+ accounts are authenticated
+examples:
+  gws-axi gmail batch-modify --query "from:newsletters@x.com" --remove-label INBOX
+  gws-axi gmail batch-modify --query "is:unread older_than:30d" --remove-label UNREAD
+  gws-axi gmail batch-modify --query "from:boss@x.com" --add-label "Important/Boss"
+notes:
+  Operates on MESSAGES matching --query (not threads). At least one of
+  --add-label / --remove-label is required. If more messages match than
+  --limit, only the first --limit are modified and the response says so —
+  re-run to continue. Idempotent per message (see \`gmail modify\`).
+`;
+function collect(target, value) {
+    if (!value)
+        return;
+    for (const part of value.split(",")) {
+        const t = part.trim();
+        if (t)
+            target.push(t);
+    }
+}
+function parseFlags(args) {
+    const flags = {
+        query: undefined,
+        add: [],
+        remove: [],
+        limit: DEFAULT_LIMIT,
+        includeSpamTrash: false,
+    };
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        const next = args[i + 1];
+        switch (arg) {
+            case "--query":
+                flags.query = next;
+                i++;
+                break;
+            case "--add-label":
+                collect(flags.add, next);
+                i++;
+                break;
+            case "--remove-label":
+                collect(flags.remove, next);
+                i++;
+                break;
+            case "--limit":
+                flags.limit = Math.max(1, Math.min(MAX_LIMIT, parseInt(next, 10) || DEFAULT_LIMIT));
+                i++;
+                break;
+            case "--include-spam-trash":
+                flags.includeSpamTrash = true;
+                break;
+        }
+    }
+    return flags;
+}
+/** Page through messages.list until we hit `limit` ids or run out. */
+async function collectMessageIds(api, account, query, limit, includeSpamTrash) {
+    const ids = [];
+    let pageToken;
+    try {
+        while (ids.length < limit) {
+            const res = await api.users.messages.list({
+                userId: "me",
+                q: query,
+                includeSpamTrash,
+                maxResults: Math.min(500, limit - ids.length),
+                pageToken,
+            });
+            for (const m of res.data.messages ?? []) {
+                if (m.id)
+                    ids.push(m.id);
+            }
+            pageToken = res.data.nextPageToken ?? undefined;
+            if (!pageToken)
+                return { ids, more: false };
+        }
+    }
+    catch (err) {
+        throw translateGoogleError(err, {
+            account,
+            operation: "gmail.messages.list",
+        });
+    }
+    // Reached the limit; `more` is true iff another page exists.
+    return { ids: ids.slice(0, limit), more: Boolean(pageToken) };
+}
+export async function gmailBatchModifyCommand(account, args) {
+    const flags = parseFlags(args);
+    if (!flags.query) {
+        throw new AxiError("--query is required", "VALIDATION_ERROR", [
+            "Usage: gws-axi gmail batch-modify --query <text> [--add-label <name>] [--remove-label <name>]",
+        ]);
+    }
+    if (flags.add.length === 0 && flags.remove.length === 0) {
+        throw new AxiError("Nothing to do — pass --add-label and/or --remove-label", "VALIDATION_ERROR", ["Archive matches: --remove-label INBOX · Mark read: --remove-label UNREAD"]);
+    }
+    const api = await gmailClient(account);
+    const labels = await fetchLabels(api, account);
+    const addLabelIds = resolveLabelIds(flags.add, labels);
+    const removeLabelIds = resolveLabelIds(flags.remove, labels);
+    const { ids, more } = await collectMessageIds(api, account, flags.query, flags.limit, flags.includeSpamTrash);
+    if (ids.length === 0) {
+        return joinBlocks(renderObject({
+            action: "noop",
+            account,
+            query: flags.query,
+            matched: 0,
+            reason: "no messages matched the query",
+        }), renderHelp([
+            `Preview matches first with \`gws-axi gmail search --query ${JSON.stringify(flags.query)}\``,
+        ]));
+    }
+    try {
+        await api.users.messages.batchModify({
+            userId: "me",
+            requestBody: { ids, addLabelIds, removeLabelIds },
+        });
+    }
+    catch (err) {
+        throw translateGoogleError(err, {
+            account,
+            operation: "gmail.messages.batchModify",
+        });
+    }
+    const result = {
+        action: "batch_modified",
+        account,
+        query: flags.query,
+        matched: ids.length,
+    };
+    if (flags.add.length)
+        result.added = labelNamesFor(addLabelIds, labels).join(", ");
+    if (flags.remove.length) {
+        result.removed = labelNamesFor(removeLabelIds, labels).join(", ");
+    }
+    const suggestions = [];
+    if (more) {
+        suggestions.push(`More messages match than --limit ${flags.limit} — re-run the same command to modify the next batch`);
+    }
+    suggestions.push(`Verify with \`gws-axi gmail search --query ${JSON.stringify(flags.query)}\``);
+    return joinBlocks(renderObject(result), renderHelp(suggestions));
+}
+//# sourceMappingURL=batch-modify.js.map

package/dist/src/commands/gmail/batch-modify.js.map

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

package/dist/src/commands/gmail/compose.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Minimal RFC 5322 message builder for draft creation. We only need the
+ * plain-text single-part case: agents draft text bodies for human review,
+ * and Gmail's web composer handles any rich formatting on send. The raw
+ * message is base64url-encoded as the Gmail API's `raw` field expects.
+ */
+export interface ComposeFields {
+    /** Sender — the authenticated account's address. */
+    from: string;
+    to: string[];
+    cc?: string[];
+    bcc?: string[];
+    subject: string;
+    body: string;
+}
+/** Split a comma-separated recipient flag into trimmed, non-empty addresses. */
+export declare function parseRecipients(value: string): string[];
+/**
+ * Build a base64url-encoded RFC 5322 message suitable for
+ * `users.drafts.create` / `users.messages.send` `raw` fields. Body is sent
+ * as a single text/plain part with base64 transfer-encoding so any UTF-8
+ * content survives intact.
+ */
+export declare function buildRawMessage(fields: ComposeFields): string;

package/dist/src/commands/gmail/compose.js

@@ -0,0 +1,47 @@
+/**
+ * Minimal RFC 5322 message builder for draft creation. We only need the
+ * plain-text single-part case: agents draft text bodies for human review,
+ * and Gmail's web composer handles any rich formatting on send. The raw
+ * message is base64url-encoded as the Gmail API's `raw` field expects.
+ */
+/** Split a comma-separated recipient flag into trimmed, non-empty addresses. */
+export function parseRecipients(value) {
+    return value
+        .split(",")
+        .map((s) => s.trim())
+        .filter(Boolean);
+}
+/**
+ * RFC 2047 "encoded-word" wrap a header value when it carries non-ASCII.
+ * Pure-ASCII values pass through untouched so common subjects stay readable
+ * on the wire.
+ */
+function encodeHeaderValue(value) {
+    if (/^[\x00-\x7F]*$/.test(value))
+        return value;
+    return `=?UTF-8?B?${Buffer.from(value, "utf8").toString("base64")}?=`;
+}
+/**
+ * Build a base64url-encoded RFC 5322 message suitable for
+ * `users.drafts.create` / `users.messages.send` `raw` fields. Body is sent
+ * as a single text/plain part with base64 transfer-encoding so any UTF-8
+ * content survives intact.
+ */
+export function buildRawMessage(fields) {
+    const headers = [`From: ${fields.from}`, `To: ${fields.to.join(", ")}`];
+    if (fields.cc?.length)
+        headers.push(`Cc: ${fields.cc.join(", ")}`);
+    if (fields.bcc?.length)
+        headers.push(`Bcc: ${fields.bcc.join(", ")}`);
+    headers.push(`Subject: ${encodeHeaderValue(fields.subject)}`);
+    headers.push("MIME-Version: 1.0");
+    headers.push('Content-Type: text/plain; charset="UTF-8"');
+    headers.push("Content-Transfer-Encoding: base64");
+    // Wrap the base64 body at 76 columns (RFC 2045) with CRLF line endings.
+    const encodedBody = Buffer.from(fields.body, "utf8")
+        .toString("base64")
+        .replace(/(.{76})/g, "$1\r\n");
+    const raw = `${headers.join("\r\n")}\r\n\r\n${encodedBody}`;
+    return Buffer.from(raw, "utf8").toString("base64url");
+}
+//# sourceMappingURL=compose.js.map

package/dist/src/commands/gmail/compose.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compose.js","sourceRoot":"","sources":["../../../../src/commands/gmail/compose.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAYH,gFAAgF;AAChF,MAAM,UAAU,eAAe,CAAC,KAAa;IAC3C,OAAO,KAAK;SACT,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;SACpB,MAAM,CAAC,OAAO,CAAC,CAAC;AACrB,CAAC;AAED;;;;GAIG;AACH,SAAS,iBAAiB,CAAC,KAAa;IACtC,IAAI,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC/C,OAAO,aAAa,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC;AACxE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,MAAqB;IACnD,MAAM,OAAO,GAAa,CAAC,SAAS,MAAM,CAAC,IAAI,EAAE,EAAE,OAAO,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAClF,IAAI,MAAM,CAAC,EAAE,EAAE,MAAM;QAAE,OAAO,CAAC,IAAI,CAAC,OAAO,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACnE,IAAI,MAAM,CAAC,GAAG,EAAE,MAAM;QAAE,OAAO,CAAC,IAAI,CAAC,QAAQ,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACtE,OAAO,CAAC,IAAI,CAAC,YAAY,iBAAiB,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAC9D,OAAO,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;IAClC,OAAO,CAAC,IAAI,CAAC,2CAA2C,CAAC,CAAC;IAC1D,OAAO,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAC;IAElD,wEAAwE;IACxE,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC;SACjD,QAAQ,CAAC,QAAQ,CAAC;SAClB,OAAO,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IAEjC,MAAM,GAAG,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,WAAW,EAAE,CAAC;IAC5D,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;AACxD,CAAC"}

package/dist/src/commands/gmail/compose.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/commands/gmail/compose.test.js

@@ -0,0 +1,75 @@
+import { describe, expect, it } from "vitest";
+import { buildRawMessage, parseRecipients } from "./compose.js";
+/** Decode a base64url raw message back into its header block and body. */
+function decodeRaw(raw) {
+    const text = Buffer.from(raw, "base64url").toString("utf8");
+    const idx = text.indexOf("\r\n\r\n");
+    const header = text.slice(0, idx);
+    const bodyB64 = text.slice(idx + 4).replace(/\r\n/g, "");
+    return { header, body: Buffer.from(bodyB64, "base64").toString("utf8") };
+}
+describe("parseRecipients", () => {
+    it("splits, trims, and drops empties", () => {
+        expect(parseRecipients("a@x.com, b@x.com ,, c@x.com")).toEqual([
+            "a@x.com",
+            "b@x.com",
+            "c@x.com",
+        ]);
+    });
+    it("handles a single address", () => {
+        expect(parseRecipients("solo@x.com")).toEqual(["solo@x.com"]);
+    });
+});
+describe("buildRawMessage", () => {
+    it("emits the core headers and round-trips the body", () => {
+        const raw = buildRawMessage({
+            from: "me@x.com",
+            to: ["alice@x.com", "bob@x.com"],
+            subject: "Hello",
+            body: "Line one\nLine two",
+        });
+        const { header, body } = decodeRaw(raw);
+        expect(header).toContain("From: me@x.com");
+        expect(header).toContain("To: alice@x.com, bob@x.com");
+        expect(header).toContain("Subject: Hello");
+        expect(header).toContain('Content-Type: text/plain; charset="UTF-8"');
+        expect(body).toBe("Line one\nLine two");
+    });
+    it("includes Cc/Bcc only when provided", () => {
+        const withCc = decodeRaw(buildRawMessage({
+            from: "me@x.com",
+            to: ["a@x.com"],
+            cc: ["c@x.com"],
+            bcc: ["d@x.com"],
+            subject: "s",
+            body: "b",
+        })).header;
+        expect(withCc).toContain("Cc: c@x.com");
+        expect(withCc).toContain("Bcc: d@x.com");
+        const without = decodeRaw(buildRawMessage({ from: "me@x.com", to: ["a@x.com"], subject: "s", body: "b" })).header;
+        expect(without).not.toContain("Cc:");
+        expect(without).not.toContain("Bcc:");
+    });
+    it("RFC 2047 encodes non-ASCII subjects but leaves the body decodable", () => {
+        const { header, body } = decodeRaw(buildRawMessage({
+            from: "me@x.com",
+            to: ["a@x.com"],
+            subject: "café ☕",
+            body: "naïve résumé — ☕",
+        }));
+        expect(header).toContain("Subject: =?UTF-8?B?");
+        expect(header).not.toContain("café");
+        expect(body).toBe("naïve résumé — ☕");
+    });
+    it("produces valid base64url (no +,/,= padding chars)", () => {
+        const raw = buildRawMessage({
+            from: "me@x.com",
+            to: ["a@x.com"],
+            subject: "s",
+            body: "x".repeat(200), // force base64 line wrapping
+        });
+        expect(raw).not.toMatch(/[+/=]/);
+        expect(decodeRaw(raw).body).toBe("x".repeat(200));
+    });
+});
+//# sourceMappingURL=compose.test.js.map

package/dist/src/commands/gmail/compose.test.js.map

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

package/dist/src/commands/gmail/draft.d.ts

@@ -0,0 +1,3 @@
+export declare const DRAFT_HELP = "usage: gws-axi gmail draft --to <emails> --subject <text> --body <markdown> [flags]\nflags[8]:\n  --to <emails>        REQUIRED \u2014 comma-separated recipient addresses\n  --subject <text>     Subject line (default: empty)\n  --body <text>        Body text. Pass via quoted string or shell heredoc\n  --body-file <path>   Read the body from a file instead of --body (mutually\n                       exclusive with --body; use for long/multi-line bodies)\n  --cc <emails>        Comma-separated Cc addresses\n  --bcc <emails>       Comma-separated Bcc addresses\n  --thread <thread-id> Attach the draft to an existing thread (reply draft)\n  --account <email>    REQUIRED when 2+ accounts are authenticated\nexamples:\n  gws-axi gmail draft --to alice@x.com --subject \"Re: budget\" --body \"Looks good \u2014 approving.\"\n  gws-axi gmail draft --to a@x.com,b@x.com --subject Hi --body-file ./note.txt\n  gws-axi gmail draft --to alice@x.com --subject \"Re: thread\" --body \"...\" --thread 1899abcd\nnotes:\n  Creates a DRAFT only \u2014 gws-axi never sends mail. Review and send from the\n  Gmail UI. Body is sent as plain text (text/plain; UTF-8); any markdown is\n  preserved verbatim, not rendered to HTML.\noutput:\n  Returns `action: drafted` plus the new draft_id, message_id, recipients,\n  and subject. A help line links to where to review/send it.\n";
+export declare const SEND_HELP = "usage: gws-axi gmail send \u2014 INTENTIONALLY OUT OF SCOPE\nstatus: not supported by design\nnotes:\n  gws-axi deliberately does not send mail. It can draft messages for you, but\n  sending is left to a human in the Gmail UI so an automated agent can't email\n  people on your behalf. Use `gws-axi gmail draft` to compose, then review and\n  send the draft yourself in Gmail.\n";
+export declare function gmailDraftCommand(account: string, args: string[]): Promise<string>;

package/dist/src/commands/gmail/draft.js

@@ -0,0 +1,148 @@
+import { readFileSync } from "node:fs";
+import { AxiError } from "axi-sdk-js";
+import { gmailClient, translateGoogleError } from "../../google/client.js";
+import { joinBlocks, renderHelp, renderObject } from "../../output/index.js";
+import { buildRawMessage, parseRecipients } from "./compose.js";
+export const DRAFT_HELP = `usage: gws-axi gmail draft --to <emails> --subject <text> --body <markdown> [flags]
+flags[8]:
+  --to <emails>        REQUIRED — comma-separated recipient addresses
+  --subject <text>     Subject line (default: empty)
+  --body <text>        Body text. Pass via quoted string or shell heredoc
+  --body-file <path>   Read the body from a file instead of --body (mutually
+                       exclusive with --body; use for long/multi-line bodies)
+  --cc <emails>        Comma-separated Cc addresses
+  --bcc <emails>       Comma-separated Bcc addresses
+  --thread <thread-id> Attach the draft to an existing thread (reply draft)
+  --account <email>    REQUIRED when 2+ accounts are authenticated
+examples:
+  gws-axi gmail draft --to alice@x.com --subject "Re: budget" --body "Looks good — approving."
+  gws-axi gmail draft --to a@x.com,b@x.com --subject Hi --body-file ./note.txt
+  gws-axi gmail draft --to alice@x.com --subject "Re: thread" --body "..." --thread 1899abcd
+notes:
+  Creates a DRAFT only — gws-axi never sends mail. Review and send from the
+  Gmail UI. Body is sent as plain text (text/plain; UTF-8); any markdown is
+  preserved verbatim, not rendered to HTML.
+output:
+  Returns \`action: drafted\` plus the new draft_id, message_id, recipients,
+  and subject. A help line links to where to review/send it.
+`;
+export const SEND_HELP = `usage: gws-axi gmail send — INTENTIONALLY OUT OF SCOPE
+status: not supported by design
+notes:
+  gws-axi deliberately does not send mail. It can draft messages for you, but
+  sending is left to a human in the Gmail UI so an automated agent can't email
+  people on your behalf. Use \`gws-axi gmail draft\` to compose, then review and
+  send the draft yourself in Gmail.
+`;
+function parseFlags(args) {
+    const flags = {
+        to: [],
+        cc: [],
+        bcc: [],
+        subject: "",
+        body: undefined,
+        bodyFile: undefined,
+        thread: undefined,
+    };
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        const next = args[i + 1];
+        switch (arg) {
+            case "--to":
+                flags.to = parseRecipients(next ?? "");
+                i++;
+                break;
+            case "--cc":
+                flags.cc = parseRecipients(next ?? "");
+                i++;
+                break;
+            case "--bcc":
+                flags.bcc = parseRecipients(next ?? "");
+                i++;
+                break;
+            case "--subject":
+                flags.subject = next ?? "";
+                i++;
+                break;
+            case "--body":
+                flags.body = next;
+                i++;
+                break;
+            case "--body-file":
+                flags.bodyFile = next;
+                i++;
+                break;
+            case "--thread":
+                flags.thread = next;
+                i++;
+                break;
+        }
+    }
+    return flags;
+}
+function resolveBody(flags) {
+    if (flags.body !== undefined && flags.bodyFile !== undefined) {
+        throw new AxiError("--body and --body-file are mutually exclusive", "VALIDATION_ERROR", ["Pass the body inline with --body OR from a file with --body-file, not both"]);
+    }
+    if (flags.bodyFile !== undefined) {
+        try {
+            return readFileSync(flags.bodyFile, "utf8");
+        }
+        catch {
+            throw new AxiError(`Cannot read --body-file: ${flags.bodyFile}`, "VALIDATION_ERROR", ["Check the path exists and is readable"]);
+        }
+    }
+    return flags.body ?? "";
+}
+export async function gmailDraftCommand(account, args) {
+    const flags = parseFlags(args);
+    if (flags.to.length === 0) {
+        throw new AxiError("--to is required", "VALIDATION_ERROR", [
+            `Usage: gws-axi gmail draft --to <emails> --subject <text> --body <text>`,
+        ]);
+    }
+    const body = resolveBody(flags);
+    const raw = buildRawMessage({
+        from: account,
+        to: flags.to,
+        cc: flags.cc.length ? flags.cc : undefined,
+        bcc: flags.bcc.length ? flags.bcc : undefined,
+        subject: flags.subject,
+        body,
+    });
+    const message = { raw };
+    if (flags.thread)
+        message.threadId = flags.thread;
+    const api = await gmailClient(account);
+    let draft;
+    try {
+        const res = await api.users.drafts.create({
+            userId: "me",
+            requestBody: { message },
+        });
+        draft = res.data;
+    }
+    catch (err) {
+        throw translateGoogleError(err, {
+            account,
+            operation: "gmail.drafts.create",
+        });
+    }
+    const result = {
+        action: "drafted",
+        account,
+        draft_id: draft.id ?? "",
+        message_id: draft.message?.id ?? "",
+        to: flags.to.join(", "),
+        subject: flags.subject || "(no subject)",
+    };
+    if (flags.cc.length)
+        result.cc = flags.cc.join(", ");
+    if (flags.thread)
+        result.thread_id = flags.thread;
+    return joinBlocks(renderObject(result), renderHelp([
+        "Draft saved — NOT sent. Review and send it from the Gmail UI (Drafts folder)",
+        `Edit or delete it later via the draft_id (${draft.id ?? ""})`,
+    ]));
+}
+//# sourceMappingURL=draft.js.map

package/dist/src/commands/gmail/draft.js.map

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

package/dist/src/commands/gmail/filters.d.ts

@@ -0,0 +1,6 @@
+export declare const FILTER_LIST_HELP = "usage: gws-axi gmail filter-list [flags]\nflags[1]:\n  --account <email>    Account override when 2+ are configured\noutput:\n  A `filters[N]{id,criteria,action}` table. Each row summarizes one\n  server-side rule. Pass an `id` to `gws-axi gmail filter-delete <id>`.\nnotes:\n  Filters are server-side auto-sort rules that run continuously on Google's\n  side (separate from labels). Filters require the gmail.settings.basic scope. If this 403s, run `gws-axi auth login --account <email>` to re-consent.\n";
+export declare const FILTER_CREATE_HELP = "usage: gws-axi gmail filter-create <criteria> <action> [flags]\ncriteria (>=1 required):\n  --from <text>          Match sender\n  --to <text>            Match recipient\n  --subject <text>       Match subject\n  --query <text>         Match an arbitrary Gmail search query\n  --has-attachment       Match only messages with attachments\naction (>=1 required):\n  --add-label <name>     Apply a label. Repeatable / comma list. Accepts user\n                         + system labels (e.g. STARRED, IMPORTANT)\n  --remove-label <name>  Remove a label. Use INBOX to skip-inbox (archive),\n                         UNREAD to mark read\n  --forward <email>      Forward matching mail to this address (must be a\n                         verified forwarding address in Gmail settings)\nflags:\n  --account <email>      REQUIRED when 2+ accounts are authenticated\nexamples:\n  gws-axi gmail filter-create --from newsletters@x.com --remove-label INBOX --add-label News\n  gws-axi gmail filter-create --subject \"[ALERT]\" --add-label STARRED --add-label IMPORTANT\nnotes:\n  Idempotent: an existing filter with identical criteria + action returns\n  `action: exists`. Filters require the gmail.settings.basic scope. If this 403s, run `gws-axi auth login --account <email>` to re-consent.\n";
+export declare const FILTER_DELETE_HELP = "usage: gws-axi gmail filter-delete <filter-id> [flags]\nargs[1]:\n  <filter-id>          Filter ID (from `gws-axi gmail filter-list`)\nflags[1]:\n  --account <email>    REQUIRED when 2+ accounts are authenticated\nnotes:\n  Idempotent: deleting an unknown filter id returns `action: noop`.\n  Filters require the gmail.settings.basic scope. If this 403s, run `gws-axi auth login --account <email>` to re-consent.\n";
+export declare function gmailFilterListCommand(account: string, _args: string[]): Promise<string>;
+export declare function gmailFilterCreateCommand(account: string, args: string[]): Promise<string>;
+export declare function gmailFilterDeleteCommand(account: string, args: string[]): Promise<string>;