gws-axi 0.1.0 → 0.3.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:** early release. **Calendar reads** (`calendar events`) are implemented with real TOON output. Other subcommands (`calendar get|create|update|…`, `gmail`, `docs`, `drive`, `slides`) are scaffolded but return `NOT_IMPLEMENTED`. Auth, doctor, and multi-account management are complete.
+> **Status (v0.3):** **Calendar is complete** — all 9 subcommands (5 reads + 4 writes) are implemented. Gmail, Docs, Drive, and Slides are scaffolded stubs that exercise auth + account resolution but return `NOT_IMPLEMENTED` on their concrete operations. Auth, doctor (with live per-account API probes), and multi-account management are stable.
 
 ## Requirements
 
@@ -37,16 +37,46 @@ Typical flow: set project → enable APIs → create OAuth client → download J
 
 Every subcommand supports `--help`. The bare `gws-axi` command prints current state, authenticated accounts, and top suggestions.
 
+### Home / auth / health
+
 ```bash
-gws-axi                                  # home view
-gws-axi calendar events                  # list upcoming events
-gws-axi calendar events --query standup  # full-text search
-gws-axi calendar events --fields attendees,location
+gws-axi                                  # home view — current state + suggestions
 gws-axi auth accounts                    # list authenticated Google accounts
-gws-axi auth login --account <email>     # add another account
-gws-axi doctor                           # full health check
+gws-axi auth login --account <email>     # add another account (prepare + --wait)
+gws-axi auth use <email>                 # set the default account
+gws-axi doctor                           # prerequisites + setup + live API probes
 ```
 
+### Calendar reads
+
+```bash
+gws-axi calendar events                  # upcoming 7 days on primary
+gws-axi calendar events --from 2026-04-20T00:00 --to 2026-04-27T00:00
+gws-axi calendar events --fields attendees,location,status
+gws-axi calendar get <event-id>          # full detail + attendees
+gws-axi calendar get <event-id> --full   # don't truncate description
+gws-axi calendar calendars               # list calendars accessible to this account
+gws-axi calendar search --query "standup"  # primary calendar by default
+gws-axi calendar search --query "chris" --include-shared  # include delegated + subscribed
+gws-axi calendar freebusy --calendars primary,team@jarv.us  # cross-calendar availability
+```
+
+### Calendar writes
+
+```bash
+gws-axi calendar create \
+  --summary "Team sync" --start 2026-04-22T14:00 --duration 30m
+
+gws-axi calendar update <event-id> \
+  --summary "Team sync (rescheduled)" --start 2026-04-22T15:00
+
+gws-axi calendar delete <event-id>       # idempotent (404/410 → noop)
+
+gws-axi calendar respond <event-id> --response accepted
+```
+
+Writes default `--send-updates` to `none` so agent-created events don't spam attendees. Pass `--send-updates all` for production-style invite behavior.
+
 ### Multi-account with write protection
 
 gws-axi supports multiple Google accounts under one OAuth client. When two or more are authenticated, write operations require `--account <email>` explicitly — silent wrong-account mutations are impossible:
@@ -77,10 +107,11 @@ help[2]:
 - [`docs/design.md`](https://github.com/JarvusInnovations/gws-axi/blob/main/docs/design.md) — architecture, auth model, doctor tiers, command surface
 - [`docs/shared-client-future.md`](https://github.com/JarvusInnovations/gws-axi/blob/main/docs/shared-client-future.md) — why BYO-only for v1, what a shared-client public distribution would involve
 
-## Known issues
+## Known issues & roadmap
 
-- **Testing-mode tokens expire every 7 days.** Google's OAuth policy. Re-run `gws-axi auth login --wait` when it happens. A future `gws-axi auth publish` helper will walk single-developer verification to eliminate this.
-- **Most service subcommands are not yet implemented.** Only `calendar events` does real work as of v0.1. The rest will follow — see the design doc for the order.
+- **Testing-mode tokens expire every 7 days.** Google's OAuth policy for unpublished apps. Re-run `gws-axi auth login --account <email>` + `auth login --wait` when it happens. A future `gws-axi auth publish` helper will walk single-developer verification to eliminate this.
+- **Gmail, Docs, Drive, Slides**: not yet implemented. Stubs exercise auth + account resolution so write-protection errors still surface correctly; actual operations return `NOT_IMPLEMENTED`. Gmail is next.
+- **Tests**: not yet — coming alongside Gmail.
 
 ## Contributing
 

package/dist/src/commands/calendar/create.d.ts

@@ -0,0 +1,2 @@
+export declare const CREATE_HELP = "usage: gws-axi calendar create --summary <text> --start <iso> [flags]\nflags[13]:\n  --summary <text>       REQUIRED \u2014 event title\n  --start <iso>          REQUIRED \u2014 event start (ISO datetime or YYYY-MM-DD for all-day)\n  --end <iso>            End time (default: start + 1h for timed, start + 1d for all-day)\n  --duration <h|m>       Alternative to --end, e.g. \"1h\", \"30m\", \"90m\", \"1h30m\"\n  --all-day              Treat --start as a date (not datetime); all-day event\n  --description <text>   Multi-line ok; pass via shell heredoc or quoted string\n  --location <text>      Freeform location string\n  --attendees <emails>   Comma-separated emails (no spaces). Invites sent per --send-updates\n  --timezone <tz>        IANA TZ (e.g. America/New_York) for timed events (default: calendar's tz)\n  --recurrence <rrule>   RFC 5545 RRULE (e.g. \"RRULE:FREQ=WEEKLY;BYDAY=MO,WE,FR\")\n  --send-updates <mode>  none | all | externalOnly (default: none \u2014 agent-safe)\n  --calendar <id>        Calendar to write to (default: primary)\n  --account <email>      REQUIRED when 2+ accounts are authenticated\nexamples:\n  gws-axi calendar create --summary \"Team sync\" --start 2026-04-22T14:00 --duration 30m\n  gws-axi calendar create --summary \"Holiday\" --start 2026-05-26 --all-day\n  gws-axi calendar create --summary \"1:1\" --start 2026-04-22T10:00 --end 2026-04-22T10:30 --attendees alice@x.com,bob@x.com --send-updates all\nnotes:\n  --send-updates defaults to \"none\" so agent-created events don't spam\n  invited guests with notifications unless explicitly requested. Pass\n  --send-updates all for production-style invite behavior.\noutput:\n  Returns the newly-created event's key fields (id, summary, start, end,\n  organizer, attendees count, htmlLink) plus an `action: created` line.\n";
+export declare function calendarCreateCommand(account: string, args: string[]): Promise<string>;

package/dist/src/commands/calendar/create.js

@@ -0,0 +1,247 @@
+import { AxiError } from "axi-sdk-js";
+import { calendarClient, translateGoogleError } from "../../google/client.js";
+import { joinBlocks, renderObject } from "../../output/index.js";
+import { formatEventTime, parseDateishFlag } from "./dateish.js";
+export const CREATE_HELP = `usage: gws-axi calendar create --summary <text> --start <iso> [flags]
+flags[13]:
+  --summary <text>       REQUIRED — event title
+  --start <iso>          REQUIRED — event start (ISO datetime or YYYY-MM-DD for all-day)
+  --end <iso>            End time (default: start + 1h for timed, start + 1d for all-day)
+  --duration <h|m>       Alternative to --end, e.g. "1h", "30m", "90m", "1h30m"
+  --all-day              Treat --start as a date (not datetime); all-day event
+  --description <text>   Multi-line ok; pass via shell heredoc or quoted string
+  --location <text>      Freeform location string
+  --attendees <emails>   Comma-separated emails (no spaces). Invites sent per --send-updates
+  --timezone <tz>        IANA TZ (e.g. America/New_York) for timed events (default: calendar's tz)
+  --recurrence <rrule>   RFC 5545 RRULE (e.g. "RRULE:FREQ=WEEKLY;BYDAY=MO,WE,FR")
+  --send-updates <mode>  none | all | externalOnly (default: none — agent-safe)
+  --calendar <id>        Calendar to write to (default: primary)
+  --account <email>      REQUIRED when 2+ accounts are authenticated
+examples:
+  gws-axi calendar create --summary "Team sync" --start 2026-04-22T14:00 --duration 30m
+  gws-axi calendar create --summary "Holiday" --start 2026-05-26 --all-day
+  gws-axi calendar create --summary "1:1" --start 2026-04-22T10:00 --end 2026-04-22T10:30 --attendees alice@x.com,bob@x.com --send-updates all
+notes:
+  --send-updates defaults to "none" so agent-created events don't spam
+  invited guests with notifications unless explicitly requested. Pass
+  --send-updates all for production-style invite behavior.
+output:
+  Returns the newly-created event's key fields (id, summary, start, end,
+  organizer, attendees count, htmlLink) plus an \`action: created\` line.
+`;
+function parseDurationMs(value) {
+    // Accept forms like "90m", "1h", "1h30m", "45min"
+    const re = /^(?:(\d+)h)?(?:(\d+)(?:m|min)?)?$/i;
+    const m = value.trim().match(re);
+    if (!m || (!m[1] && !m[2])) {
+        throw new AxiError(`Cannot parse duration: ${value}`, "VALIDATION_ERROR", ["Use forms like 1h, 30m, 90m, or 1h30m"]);
+    }
+    const hours = parseInt(m[1] ?? "0", 10);
+    const minutes = parseInt(m[2] ?? "0", 10);
+    return (hours * 60 + minutes) * 60 * 1000;
+}
+function parseFlags(args) {
+    const flags = {
+        summary: undefined,
+        start: undefined,
+        end: undefined,
+        duration: undefined,
+        allDay: false,
+        description: undefined,
+        location: undefined,
+        attendees: [],
+        timezone: undefined,
+        recurrence: undefined,
+        sendUpdates: "none",
+        calendar: "primary",
+    };
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        const next = args[i + 1];
+        switch (arg) {
+            case "--summary":
+                flags.summary = next;
+                i++;
+                break;
+            case "--start":
+                flags.start = next;
+                i++;
+                break;
+            case "--end":
+                flags.end = next;
+                i++;
+                break;
+            case "--duration":
+                flags.duration = next;
+                i++;
+                break;
+            case "--all-day":
+                flags.allDay = true;
+                break;
+            case "--description":
+                flags.description = next;
+                i++;
+                break;
+            case "--location":
+                flags.location = next;
+                i++;
+                break;
+            case "--attendees":
+                flags.attendees = next.split(",").map((s) => s.trim()).filter(Boolean);
+                i++;
+                break;
+            case "--timezone":
+                flags.timezone = next;
+                i++;
+                break;
+            case "--recurrence":
+                flags.recurrence = next;
+                i++;
+                break;
+            case "--send-updates":
+                if (next === "all" || next === "externalOnly" || next === "none") {
+                    flags.sendUpdates = next;
+                }
+                else {
+                    throw new AxiError(`Invalid --send-updates value: ${next}`, "VALIDATION_ERROR", ["Valid values: none, all, externalOnly"]);
+                }
+                i++;
+                break;
+            case "--calendar":
+                flags.calendar = next;
+                i++;
+                break;
+        }
+    }
+    return flags;
+}
+/** Format a Date to `YYYY-MM-DD` in local time. */
+function toDateOnly(d) {
+    const pad = (n) => String(n).padStart(2, "0");
+    return `${d.getFullYear()}-${pad(d.getMonth() + 1)}-${pad(d.getDate())}`;
+}
+function buildEventBody(flags) {
+    if (!flags.summary) {
+        throw new AxiError("--summary is required", "VALIDATION_ERROR", [
+            "Pass --summary 'Event title'",
+        ]);
+    }
+    if (!flags.start) {
+        throw new AxiError("--start is required", "VALIDATION_ERROR", [
+            "Pass --start 2026-04-22T14:00 (timed) or --start 2026-04-22 --all-day",
+        ]);
+    }
+    const body = {
+        summary: flags.summary,
+    };
+    if (flags.description !== undefined)
+        body.description = flags.description;
+    if (flags.location !== undefined)
+        body.location = flags.location;
+    if (flags.attendees.length > 0) {
+        body.attendees = flags.attendees.map((email) => ({ email }));
+    }
+    if (flags.recurrence) {
+        const line = flags.recurrence.startsWith("RRULE:")
+            ? flags.recurrence
+            : `RRULE:${flags.recurrence}`;
+        body.recurrence = [line];
+    }
+    if (flags.allDay) {
+        // All-day events use the date field; Google expects exclusive end date,
+        // so default end = start + 1 day if neither --end nor --duration given.
+        if (!/^\d{4}-\d{2}-\d{2}$/.test(flags.start)) {
+            throw new AxiError("--all-day requires --start in YYYY-MM-DD form", "VALIDATION_ERROR", [`Got: ${flags.start}`]);
+        }
+        body.start = { date: flags.start };
+        let endDate;
+        if (flags.end) {
+            if (!/^\d{4}-\d{2}-\d{2}$/.test(flags.end)) {
+                throw new AxiError("--all-day requires --end in YYYY-MM-DD form", "VALIDATION_ERROR", [`Got: ${flags.end}`]);
+            }
+            endDate = flags.end;
+        }
+        else {
+            // Google's all-day end date is exclusive — default to start + 1 day
+            const d = new Date(`${flags.start}T00:00:00`);
+            d.setDate(d.getDate() + 1);
+            endDate = toDateOnly(d);
+        }
+        body.end = { date: endDate };
+    }
+    else {
+        // Timed event: parse via parseDateishFlag (handles ISO, local, date-only)
+        const startIso = parseDateishFlag(flags.start);
+        let endIso;
+        if (flags.end) {
+            endIso = parseDateishFlag(flags.end);
+        }
+        else if (flags.duration) {
+            const ms = parseDurationMs(flags.duration);
+            endIso = new Date(new Date(startIso).getTime() + ms).toISOString();
+        }
+        else {
+            // Default: 1 hour after start
+            endIso = new Date(new Date(startIso).getTime() + 60 * 60 * 1000).toISOString();
+        }
+        body.start = flags.timezone
+            ? { dateTime: startIso, timeZone: flags.timezone }
+            : { dateTime: startIso };
+        body.end = flags.timezone
+            ? { dateTime: endIso, timeZone: flags.timezone }
+            : { dateTime: endIso };
+    }
+    return body;
+}
+export async function calendarCreateCommand(account, args) {
+    const flags = parseFlags(args);
+    const body = buildEventBody(flags);
+    const api = await calendarClient(account);
+    let created;
+    try {
+        const res = await api.events.insert({
+            calendarId: flags.calendar,
+            requestBody: body,
+            sendUpdates: flags.sendUpdates,
+        });
+        created = res.data;
+    }
+    catch (err) {
+        throw translateGoogleError(err, {
+            account,
+            operation: "calendar.events.insert",
+        });
+    }
+    const blocks = [];
+    blocks.push(renderObject({
+        action: "created",
+        account,
+        calendar: flags.calendar,
+    }));
+    const attendees = created.attendees ?? [];
+    const event = {
+        id: created.id ?? "",
+        summary: created.summary ?? "",
+        start: formatEventTime(created.start),
+        end: formatEventTime(created.end),
+        status: created.status ?? "",
+        organizer: created.organizer?.email ?? "",
+        attendee_count: attendees.length,
+        send_updates: flags.sendUpdates,
+    };
+    if (created.location)
+        event.location = created.location;
+    if (created.htmlLink)
+        event.html_link = created.htmlLink;
+    if (created.recurrence?.length)
+        event.recurrence = created.recurrence;
+    blocks.push(renderObject({ event }));
+    const suggestions = [];
+    suggestions.push(`Run \`gws-axi calendar get ${created.id} --calendar ${flags.calendar}\` to view full details`);
+    if (attendees.length > 0 && flags.sendUpdates === "none") {
+        suggestions.push(`Attendees were NOT notified (--send-updates none). Run \`calendar update ${created.id} --send-updates all\` to resend`);
+    }
+    blocks.push(renderObject({ help: suggestions }));
+    return joinBlocks(...blocks);
+}
+//# sourceMappingURL=create.js.map

package/dist/src/commands/calendar/create.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.js","sourceRoot":"","sources":["../../../../src/commands/calendar/create.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9E,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEjE,MAAM,CAAC,MAAM,WAAW,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;CA0B1B,CAAC;AAiBF,SAAS,eAAe,CAAC,KAAa;IACpC,kDAAkD;IAClD,MAAM,EAAE,GAAG,oCAAoC,CAAC;IAChD,MAAM,CAAC,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACjC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,QAAQ,CAChB,0BAA0B,KAAK,EAAE,EACjC,kBAAkB,EAClB,CAAC,uCAAuC,CAAC,CAC1C,CAAC;IACJ,CAAC;IACD,MAAM,KAAK,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,EAAE,EAAE,CAAC,CAAC;IACxC,MAAM,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,EAAE,EAAE,CAAC,CAAC;IAC1C,OAAO,CAAC,KAAK,GAAG,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;AAC5C,CAAC;AAED,SAAS,UAAU,CAAC,IAAc;IAChC,MAAM,KAAK,GAAgB;QACzB,OAAO,EAAE,SAAS;QAClB,KAAK,EAAE,SAAS;QAChB,GAAG,EAAE,SAAS;QACd,QAAQ,EAAE,SAAS;QACnB,MAAM,EAAE,KAAK;QACb,WAAW,EAAE,SAAS;QACtB,QAAQ,EAAE,SAAS;QACnB,SAAS,EAAE,EAAE;QACb,QAAQ,EAAE,SAAS;QACnB,UAAU,EAAE,SAAS;QACrB,WAAW,EAAE,MAAM;QACnB,QAAQ,EAAE,SAAS;KACpB,CAAC;IAEF,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QACzB,QAAQ,GAAG,EAAE,CAAC;YACZ,KAAK,WAAW;gBACd,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC;gBACrB,CAAC,EAAE,CAAC;gBACJ,MAAM;YACR,KAAK,SAAS;gBACZ,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC;gBACnB,CAAC,EAAE,CAAC;gBACJ,MAAM;YACR,KAAK,OAAO;gBACV,KAAK,CAAC,GAAG,GAAG,IAAI,CAAC;gBACjB,CAAC,EAAE,CAAC;gBACJ,MAAM;YACR,KAAK,YAAY;gBACf,KAAK,CAAC,QAAQ,GAAG,IAAI,CAAC;gBACtB,CAAC,EAAE,CAAC;gBACJ,MAAM;YACR,KAAK,WAAW;gBACd,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC;gBACpB,MAAM;YACR,KAAK,eAAe;gBAClB,KAAK,CAAC,WAAW,GAAG,IAAI,CAAC;gBACzB,CAAC,EAAE,CAAC;gBACJ,MAAM;YACR,KAAK,YAAY;gBACf,KAAK,CAAC,QAAQ,GAAG,IAAI,CAAC;gBACtB,CAAC,EAAE,CAAC;gBACJ,MAAM;YACR,KAAK,aAAa;gBAChB,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;gBACvE,CAAC,EAAE,CAAC;gBACJ,MAAM;YACR,KAAK,YAAY;gBACf,KAAK,CAAC,QAAQ,GAAG,IAAI,CAAC;gBACtB,CAAC,EAAE,CAAC;gBACJ,MAAM;YACR,KAAK,cAAc;gBACjB,KAAK,CAAC,UAAU,GAAG,IAAI,CAAC;gBACxB,CAAC,EAAE,CAAC;gBACJ,MAAM;YACR,KAAK,gBAAgB;gBACnB,IAAI,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,cAAc,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;oBACjE,KAAK,CAAC,WAAW,GAAG,IAAI,CAAC;gBAC3B,CAAC;qBAAM,CAAC;oBACN,MAAM,IAAI,QAAQ,CAChB,iCAAiC,IAAI,EAAE,EACvC,kBAAkB,EAClB,CAAC,uCAAuC,CAAC,CAC1C,CAAC;gBACJ,CAAC;gBACD,CAAC,EAAE,CAAC;gBACJ,MAAM;YACR,KAAK,YAAY;gBACf,KAAK,CAAC,QAAQ,GAAG,IAAI,CAAC;gBACtB,CAAC,EAAE,CAAC;gBACJ,MAAM;QACV,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,mDAAmD;AACnD,SAAS,UAAU,CAAC,CAAO;IACzB,MAAM,GAAG,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACtD,OAAO,GAAG,CAAC,CAAC,WAAW,EAAE,IAAI,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;AAC3E,CAAC;AAED,SAAS,cAAc,CAAC,KAAkB;IACxC,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;QACnB,MAAM,IAAI,QAAQ,CAAC,uBAAuB,EAAE,kBAAkB,EAAE;YAC9D,8BAA8B;SAC/B,CAAC,CAAC;IACL,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACjB,MAAM,IAAI,QAAQ,CAAC,qBAAqB,EAAE,kBAAkB,EAAE;YAC5D,uEAAuE;SACxE,CAAC,CAAC;IACL,CAAC;IAED,MAAM,IAAI,GAA6B;QACrC,OAAO,EAAE,KAAK,CAAC,OAAO;KACvB,CAAC;IACF,IAAI,KAAK,CAAC,WAAW,KAAK,SAAS;QAAE,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC,WAAW,CAAC;IAC1E,IAAI,KAAK,CAAC,QAAQ,KAAK,SAAS;QAAE,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;IACjE,IAAI,KAAK,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC/B,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;IAC/D,CAAC;IACD,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;QACrB,MAAM,IAAI,GAAG,KAAK,CAAC,UAAU,CAAC,UAAU,CAAC,QAAQ,CAAC;YAChD,CAAC,CAAC,KAAK,CAAC,UAAU;YAClB,CAAC,CAAC,SAAS,KAAK,CAAC,UAAU,EAAE,CAAC;QAChC,IAAI,CAAC,UAAU,GAAG,CAAC,IAAI,CAAC,CAAC;IAC3B,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;QACjB,wEAAwE;QACxE,wEAAwE;QACxE,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;YAC7C,MAAM,IAAI,QAAQ,CAChB,+CAA+C,EAC/C,kBAAkB,EAClB,CAAC,QAAQ,KAAK,CAAC,KAAK,EAAE,CAAC,CACxB,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,KAAK,GAAG,EAAE,IAAI,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC;QACnC,IAAI,OAAe,CAAC;QACpB,IAAI,KAAK,CAAC,GAAG,EAAE,CAAC;YACd,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC3C,MAAM,IAAI,QAAQ,CAChB,6CAA6C,EAC7C,kBAAkB,EAClB,CAAC,QAAQ,KAAK,CAAC,GAAG,EAAE,CAAC,CACtB,CAAC;YACJ,CAAC;YACD,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC;QACtB,CAAC;aAAM,CAAC;YACN,oEAAoE;YACpE,MAAM,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,KAAK,CAAC,KAAK,WAAW,CAAC,CAAC;YAC9C,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC;YAC3B,OAAO,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;QAC1B,CAAC;QACD,IAAI,CAAC,GAAG,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;IAC/B,CAAC;SAAM,CAAC;QACN,0EAA0E;QAC1E,MAAM,QAAQ,GAAG,gBAAgB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC/C,IAAI,MAAc,CAAC;QACnB,IAAI,KAAK,CAAC,GAAG,EAAE,CAAC;YACd,MAAM,GAAG,gBAAgB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACvC,CAAC;aAAM,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;YAC1B,MAAM,EAAE,GAAG,eAAe,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;YAC3C,MAAM,GAAG,IAAI,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;QACrE,CAAC;aAAM,CAAC;YACN,8BAA8B;YAC9B,MAAM,GAAG,IAAI,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;QACjF,CAAC;QACD,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,QAAQ;YACzB,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE;YAClD,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC;QAC3B,IAAI,CAAC,GAAG,GAAG,KAAK,CAAC,QAAQ;YACvB,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE;YAChD,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;IAC3B,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,OAAe,EACf,IAAc;IAEd,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;IAC/B,MAAM,IAAI,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;IACnC,MAAM,GAAG,GAAG,MAAM,cAAc,CAAC,OAAO,CAAC,CAAC;IAE1C,IAAI,OAAiC,CAAC;IACtC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC;YAClC,UAAU,EAAE,KAAK,CAAC,QAAQ;YAC1B,WAAW,EAAE,IAAI;YACjB,WAAW,EAAE,KAAK,CAAC,WAAW;SAC/B,CAAC,CAAC;QACH,OAAO,GAAG,GAAG,CAAC,IAAI,CAAC;IACrB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,oBAAoB,CAAC,GAAG,EAAE;YAC9B,OAAO;YACP,SAAS,EAAE,wBAAwB;SACpC,CAAC,CAAC;IACL,CAAC;IAED,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,CAAC,IAAI,CACT,YAAY,CAAC;QACX,MAAM,EAAE,SAAS;QACjB,OAAO;QACP,QAAQ,EAAE,KAAK,CAAC,QAAQ;KACzB,CAAC,CACH,CAAC;IAEF,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,EAAE,CAAC;IAC1C,MAAM,KAAK,GAA4B;QACrC,EAAE,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE;QACpB,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,EAAE;QAC9B,KAAK,EAAE,eAAe,CAAC,OAAO,CAAC,KAAK,CAAC;QACrC,GAAG,EAAE,eAAe,CAAC,OAAO,CAAC,GAAG,CAAC;QACjC,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,EAAE;QAC5B,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,KAAK,IAAI,EAAE;QACzC,cAAc,EAAE,SAAS,CAAC,MAAM;QAChC,YAAY,EAAE,KAAK,CAAC,WAAW;KAChC,CAAC;IACF,IAAI,OAAO,CAAC,QAAQ;QAAE,KAAK,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;IACxD,IAAI,OAAO,CAAC,QAAQ;QAAE,KAAK,CAAC,SAAS,GAAG,OAAO,CAAC,QAAQ,CAAC;IACzD,IAAI,OAAO,CAAC,UAAU,EAAE,MAAM;QAAE,KAAK,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IACtE,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;IAErC,MAAM,WAAW,GAAa,EAAE,CAAC;IACjC,WAAW,CAAC,IAAI,CACd,8BAA8B,OAAO,CAAC,EAAE,eAAe,KAAK,CAAC,QAAQ,yBAAyB,CAC/F,CAAC;IACF,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,WAAW,KAAK,MAAM,EAAE,CAAC;QACzD,WAAW,CAAC,IAAI,CACd,4EAA4E,OAAO,CAAC,EAAE,iCAAiC,CACxH,CAAC;IACJ,CAAC;IACD,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC;IAEjD,OAAO,UAAU,CAAC,GAAG,MAAM,CAAC,CAAC;AAC/B,CAAC"}

package/dist/src/commands/calendar/dateish.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Parse a date-ish flag value into an ISO 8601 string.
+ *
+ * Rules:
+ * - Date-only (`YYYY-MM-DD`) → LOCAL midnight of that date, expressed as
+ *   ISO. We deliberately do NOT use `new Date("YYYY-MM-DD")` because the
+ *   JS spec parses that as UTC midnight (a well-known footgun), which
+ *   contradicts our docs ("midnight local").
+ * - Datetime with offset (`YYYY-MM-DDTHH:MM:SS±HH:MM` or trailing `Z`)
+ *   → parsed as-is, timezone preserved.
+ * - Datetime without offset (`YYYY-MM-DDTHH:MM`) → parsed as local time
+ *   per the JS spec (which for this format does use local).
+ * - Anything else → AxiError with a clear format hint.
+ *
+ * Returns an ISO string (with timezone info) suitable for Google API
+ * `timeMin` / `timeMax` parameters.
+ */
+export declare function parseDateishFlag(value: string): string;
+/**
+ * Format a Google Calendar dateTime/date field for detail-view output.
+ * Timed events: datetime + "(IANA tz)" suffix when timeZone is set.
+ * All-day events: "YYYY-MM-DD (all-day)".
+ * Missing/empty: empty string.
+ *
+ * Use for single-event detail views (get, create, update, respond).
+ * List views should stick to offset-only for compact columns.
+ */
+export declare function formatEventTime(value: {
+    dateTime?: string | null;
+    date?: string | null;
+    timeZone?: string | null;
+} | null | undefined): string;
+/**
+ * Convert a UTC timestamp string (e.g. "2026-04-22T13:00:00Z") to an ISO
+ * string with the system's local timezone offset (e.g.
+ * "2026-04-22T09:00:00-04:00"). Useful for making freebusy output
+ * consistent with events output, which already comes back in
+ * offset-preserving form from Google.
+ *
+ * Invalid input returns the original string unchanged.
+ */
+export declare function toLocalOffsetISO(input: string): string;

package/dist/src/commands/calendar/dateish.js

@@ -0,0 +1,86 @@
+import { AxiError } from "axi-sdk-js";
+/**
+ * Parse a date-ish flag value into an ISO 8601 string.
+ *
+ * Rules:
+ * - Date-only (`YYYY-MM-DD`) → LOCAL midnight of that date, expressed as
+ *   ISO. We deliberately do NOT use `new Date("YYYY-MM-DD")` because the
+ *   JS spec parses that as UTC midnight (a well-known footgun), which
+ *   contradicts our docs ("midnight local").
+ * - Datetime with offset (`YYYY-MM-DDTHH:MM:SS±HH:MM` or trailing `Z`)
+ *   → parsed as-is, timezone preserved.
+ * - Datetime without offset (`YYYY-MM-DDTHH:MM`) → parsed as local time
+ *   per the JS spec (which for this format does use local).
+ * - Anything else → AxiError with a clear format hint.
+ *
+ * Returns an ISO string (with timezone info) suitable for Google API
+ * `timeMin` / `timeMax` parameters.
+ */
+export function parseDateishFlag(value) {
+    if (!value) {
+        throw new AxiError("Missing date/time value", "VALIDATION_ERROR", ["Use ISO format: 2026-04-20T14:00 or just 2026-04-20"]);
+    }
+    if (/^\d{4}-\d{2}-\d{2}$/.test(value)) {
+        // Date-only: force local midnight instead of the spec-mandated UTC
+        // midnight, matching our --help docs.
+        const [y, m, d] = value.split("-").map((part) => Number(part));
+        const local = new Date(y, m - 1, d, 0, 0, 0, 0);
+        if (Number.isNaN(local.getTime())) {
+            throw new AxiError(`Cannot parse date: ${value}`, "VALIDATION_ERROR", ["Use YYYY-MM-DD (e.g. 2026-04-20)"]);
+        }
+        return local.toISOString();
+    }
+    const parsed = new Date(value);
+    if (Number.isNaN(parsed.getTime())) {
+        throw new AxiError(`Cannot parse date/time: ${value}`, "VALIDATION_ERROR", [
+            "Use ISO 8601 format: 2026-04-20T14:00:00-04:00",
+            "Local time: 2026-04-20T14:00 (no offset — interpreted as local)",
+            "Date-only: 2026-04-20 (midnight local)",
+        ]);
+    }
+    return parsed.toISOString();
+}
+/**
+ * Format a Google Calendar dateTime/date field for detail-view output.
+ * Timed events: datetime + "(IANA tz)" suffix when timeZone is set.
+ * All-day events: "YYYY-MM-DD (all-day)".
+ * Missing/empty: empty string.
+ *
+ * Use for single-event detail views (get, create, update, respond).
+ * List views should stick to offset-only for compact columns.
+ */
+export function formatEventTime(value) {
+    if (!value)
+        return "";
+    if (value.dateTime) {
+        return value.timeZone ? `${value.dateTime} (${value.timeZone})` : value.dateTime;
+    }
+    if (value.date)
+        return `${value.date} (all-day)`;
+    return "";
+}
+/**
+ * Convert a UTC timestamp string (e.g. "2026-04-22T13:00:00Z") to an ISO
+ * string with the system's local timezone offset (e.g.
+ * "2026-04-22T09:00:00-04:00"). Useful for making freebusy output
+ * consistent with events output, which already comes back in
+ * offset-preserving form from Google.
+ *
+ * Invalid input returns the original string unchanged.
+ */
+export function toLocalOffsetISO(input) {
+    if (!input)
+        return input;
+    const d = new Date(input);
+    if (Number.isNaN(d.getTime()))
+        return input;
+    const pad = (n) => String(n).padStart(2, "0");
+    const offsetMin = -d.getTimezoneOffset();
+    const sign = offsetMin >= 0 ? "+" : "-";
+    const absMin = Math.abs(offsetMin);
+    const offsetStr = `${sign}${pad(Math.floor(absMin / 60))}:${pad(absMin % 60)}`;
+    return (`${d.getFullYear()}-${pad(d.getMonth() + 1)}-${pad(d.getDate())}` +
+        `T${pad(d.getHours())}:${pad(d.getMinutes())}:${pad(d.getSeconds())}` +
+        offsetStr);
+}
+//# sourceMappingURL=dateish.js.map

package/dist/src/commands/calendar/dateish.js.map

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

package/dist/src/commands/calendar/delete.d.ts

@@ -0,0 +1,2 @@
+export declare const DELETE_HELP = "usage: gws-axi calendar delete <event-id> [flags]\nargs[1]:\n  <event-id>             Event ID to delete\nflags[4]:\n  --calendar <id>        Calendar containing the event (default: primary)\n  --send-updates <mode>  none | all | externalOnly (default: none)\n  --account <email>      REQUIRED when 2+ accounts are authenticated\n  --yes                  Don't warn; just delete (no-op currently \u2014 writes\n                         are already explicit via --account + this command)\nexamples:\n  gws-axi calendar delete abc_123\n  gws-axi calendar delete abc_123 --send-updates all --calendar team@jarv.us\nnotes:\n  Idempotent: deleting an already-deleted or non-existent event returns\n  exit 0 with `action: noop` rather than an error. If you need a hard\n  guarantee the event existed before deletion, run `calendar get` first.\n";
+export declare function calendarDeleteCommand(account: string, args: string[]): Promise<string>;

package/dist/src/commands/calendar/delete.js

@@ -0,0 +1,97 @@
+import { AxiError } from "axi-sdk-js";
+import { calendarClient, translateGoogleError } from "../../google/client.js";
+import { renderObject } from "../../output/index.js";
+export const DELETE_HELP = `usage: gws-axi calendar delete <event-id> [flags]
+args[1]:
+  <event-id>             Event ID to delete
+flags[4]:
+  --calendar <id>        Calendar containing the event (default: primary)
+  --send-updates <mode>  none | all | externalOnly (default: none)
+  --account <email>      REQUIRED when 2+ accounts are authenticated
+  --yes                  Don't warn; just delete (no-op currently — writes
+                         are already explicit via --account + this command)
+examples:
+  gws-axi calendar delete abc_123
+  gws-axi calendar delete abc_123 --send-updates all --calendar team@jarv.us
+notes:
+  Idempotent: deleting an already-deleted or non-existent event returns
+  exit 0 with \`action: noop\` rather than an error. If you need a hard
+  guarantee the event existed before deletion, run \`calendar get\` first.
+`;
+function parseFlags(args) {
+    let eventId;
+    let calendar = "primary";
+    let sendUpdates = "none";
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        const next = args[i + 1];
+        switch (arg) {
+            case "--calendar":
+                calendar = next;
+                i++;
+                break;
+            case "--send-updates":
+                if (next === "all" || next === "externalOnly" || next === "none") {
+                    sendUpdates = next;
+                }
+                else {
+                    throw new AxiError(`Invalid --send-updates value: ${next}`, "VALIDATION_ERROR", ["Valid values: none, all, externalOnly"]);
+                }
+                i++;
+                break;
+            case "--yes":
+                // no-op — reserved for future confirmation prompts
+                break;
+            default:
+                if (!arg.startsWith("--") && eventId === undefined) {
+                    eventId = arg;
+                }
+        }
+    }
+    if (!eventId) {
+        throw new AxiError("Missing event ID argument", "VALIDATION_ERROR", [
+            "Usage: gws-axi calendar delete <event-id> [flags]",
+            "Get an ID from `gws-axi calendar events`",
+        ]);
+    }
+    return { eventId, calendar, sendUpdates };
+}
+export async function calendarDeleteCommand(account, args) {
+    const flags = parseFlags(args);
+    const api = await calendarClient(account);
+    try {
+        await api.events.delete({
+            calendarId: flags.calendar,
+            eventId: flags.eventId,
+            sendUpdates: flags.sendUpdates,
+        });
+        return renderObject({
+            action: "deleted",
+            account,
+            calendar: flags.calendar,
+            event_id: flags.eventId,
+            send_updates: flags.sendUpdates,
+            help: [
+                `Run \`gws-axi calendar events --calendar ${flags.calendar}\` to verify`,
+            ],
+        });
+    }
+    catch (err) {
+        const translated = translateGoogleError(err, {
+            account,
+            operation: "calendar.events.delete",
+        });
+        if (translated.code === "NOT_FOUND" || translated.code === "GOOGLE_API_ERROR_410") {
+            // 404 or 410 (gone) — already deleted. Idempotent success.
+            return renderObject({
+                action: "noop",
+                account,
+                calendar: flags.calendar,
+                event_id: flags.eventId,
+                reason: "event was already deleted or never existed",
+            });
+        }
+        throw translated;
+    }
+}
+//# sourceMappingURL=delete.js.map

package/dist/src/commands/calendar/delete.js.map

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

package/dist/src/commands/calendar/events.js

@@ -1,6 +1,7 @@
 import { AxiError } from "axi-sdk-js";
 import { calendarClient, translateGoogleError } from "../../google/client.js";
 import { field, mapEnum, pluck, renderListResponse, truncated, } from "../../output/index.js";
+import { parseDateishFlag } from "./dateish.js";
 export const EVENTS_HELP = `usage: gws-axi calendar events [flags]
 flags[8]:
   --calendar <id>      Calendar to query (default: "primary")
@@ -50,11 +51,11 @@ function parseEventsFlags(args) {
                 i++;
                 break;
             case "--from":
-                flags.from = parseDateish(next);
+                flags.from = parseDateishFlag(next);
                 i++;
                 break;
             case "--to":
-                flags.to = parseDateish(next);
+                flags.to = parseDateishFlag(next);
                 i++;
                 break;
             case "--limit":
@@ -78,23 +79,6 @@ function parseEventsFlags(args) {
     }
     return flags;
 }
-function parseDateish(value) {
-    if (!value) {
-        throw new AxiError("Missing date/time value", "VALIDATION_ERROR", ["Use ISO format: 2026-04-20T14:00 or just 2026-04-20"]);
-    }
-    // Accept ISO 8601 directly. If it parses, use the parsed form (normalizes
-    // time zone). If not, raise a clear error — we're deliberately not doing
-    // natural-language parsing in v1.
-    const parsed = new Date(value);
-    if (Number.isNaN(parsed.getTime())) {
-        throw new AxiError(`Cannot parse date/time: ${value}`, "VALIDATION_ERROR", [
-            "Use ISO 8601 format: 2026-04-20T14:00:00-04:00",
-            "Or date-only: 2026-04-20",
-            "Natural-language dates (e.g. 'tomorrow 2pm') are not supported in v1",
-        ]);
-    }
-    return parsed.toISOString();
-}
 function baseSchema() {
     return [
         field("id"),