@mulmoclaude/google-plugin 0.2.1 → 0.3.2

package/dist/args.d.ts

@@ -1,16 +1,27 @@
 import { z } from 'zod';
 export declare const GoogleArgs: z.ZodDiscriminatedUnion<[z.ZodObject<{
     kind: z.ZodLiteral<"status">;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"calendarListCalendars">;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"calendarColors">;
 }, z.core.$strip>, z.ZodObject<{
     kind: z.ZodLiteral<"calendarListEvents">;
+    calendarId: z.ZodOptional<z.ZodString>;
     timeMin: z.ZodOptional<z.ZodString>;
     maxResults: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"calendarSync">;
+    calendarId: z.ZodOptional<z.ZodString>;
+    fullResync: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>, z.ZodObject<{
     kind: z.ZodLiteral<"calendarCreateEvent">;
     summary: z.ZodString;
     start: z.ZodString;
     end: z.ZodString;
     description: z.ZodOptional<z.ZodString>;
+    calendarId: z.ZodOptional<z.ZodString>;
+    colorId: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>, z.ZodObject<{
     kind: z.ZodLiteral<"taskListsList">;
 }, z.core.$strip>, z.ZodObject<{

package/dist/definition.d.ts

@@ -10,10 +10,22 @@ export declare const TOOL_DEFINITION: {
                 type: string;
                 enum: string[];
             };
+            calendarId: {
+                type: string;
+                description: string;
+            };
+            colorId: {
+                type: string;
+                description: string;
+            };
             timeMin: {
                 type: string;
                 description: string;
             };
+            fullResync: {
+                type: string;
+                description: string;
+            };
             maxResults: {
                 type: string;
                 description: string;

package/dist/index.d.ts

@@ -13,10 +13,22 @@ declare const _default: (runtime: import('gui-chat-protocol').PluginRuntime) =>
                     type: string;
                     enum: string[];
                 };
+                calendarId: {
+                    type: string;
+                    description: string;
+                };
+                colorId: {
+                    type: string;
+                    description: string;
+                };
                 timeMin: {
                     type: string;
                     description: string;
                 };
+                fullResync: {
+                    type: string;
+                    description: string;
+                };
                 maxResults: {
                     type: string;
                     description: string;

package/dist/index.js

@@ -1,4 +1,4 @@
-import { DEFAULT_LIST_MAX_RESULTS, MAX_LIST_RESULTS, clientSecretPresence, completeTask, createCalendarEvent, createDriveFile, createTask, getGoogleAccessToken, isIsoDateTimeWithOffset, listCalendarEvents, listDriveFiles, listTaskLists, listTasks, loadGoogleTokens, readDriveFile } from "@mulmoclaude/core/google";
+import { DEFAULT_LIST_MAX_RESULTS, MAX_LIST_RESULTS, clearCalendarSyncToken, clientSecretPresence, completeTask, createCalendarEvent, createDriveFile, createTask, getCalendarColors, getGoogleAccessToken, isIsoDateTimeWithOffset, listCalendarEvents, listCalendars, listDriveFiles, listTaskLists, listTasks, loadCalendarSyncToken, loadGoogleTokens, readDriveFile, saveCalendarSyncToken, syncCalendarEvents } from "@mulmoclaude/core/google";
 //#region ../../../node_modules/gui-chat-protocol/dist/index.js
 function definePlugin(setup) {
 	return setup;
@@ -4117,19 +4117,30 @@ function superRefine(fn, params) {
 var IsoDateTimeWithOffset = string().refine(isIsoDateTimeWithOffset, { error: "must be an ISO 8601 date-time with a timezone offset (e.g. 2026-07-17T09:00:00+09:00)" });
 var MaxResults = number().int().min(1).max(MAX_LIST_RESULTS).optional();
 var NonEmpty = string().min(1);
+var OptionalNonEmpty = string().trim().min(1).optional();
 var GoogleArgs = discriminatedUnion("kind", [
 	object({ kind: literal("status") }),
+	object({ kind: literal("calendarListCalendars") }),
+	object({ kind: literal("calendarColors") }),
 	object({
 		kind: literal("calendarListEvents"),
+		calendarId: OptionalNonEmpty,
 		timeMin: IsoDateTimeWithOffset.optional(),
 		maxResults: MaxResults
 	}),
+	object({
+		kind: literal("calendarSync"),
+		calendarId: OptionalNonEmpty,
+		fullResync: boolean().optional()
+	}),
 	object({
 		kind: literal("calendarCreateEvent"),
 		summary: NonEmpty,
 		start: IsoDateTimeWithOffset,
 		end: IsoDateTimeWithOffset,
-		description: string().optional()
+		description: string().optional(),
+		calendarId: OptionalNonEmpty,
+		colorId: OptionalNonEmpty
 	}),
 	object({ kind: literal("taskListsList") }),
 	object({
@@ -4171,7 +4182,7 @@ var TOOL_DEFINITION = {
 	type: "function",
 	name: "google",
 	prompt: "The user's Google account is linked LOCALLY on this machine — the refresh token lives in ~/.config/mulmo/ and never reaches any cloud. This is independent of claude.ai Google connectors; the tool works without them. If a call fails with 'Google account not linked', ask the user to link their Google account in this app's settings, then retry the original call.",
-	description: "Operate the user's Google services through the locally linked Google account: Calendar (primary calendar), Tasks, and Drive. Supported kinds:\n - `status`: report whether the Google account is linked on this machine — call this first when unsure.\n\nCalendar:\n - `calendarListEvents`: list upcoming events. Optional `timeMin` (ISO 8601 date-time with timezone offset; default now) and `maxResults` (1-50, default 10).\n - `calendarCreateEvent`: create an event. Requires `summary`, `start`, `end` — ISO 8601 date-times WITH a timezone offset (e.g. 2026-07-17T09:00:00+09:00); optional `description`.\n\nTasks:\n - `taskListsList`: list the user's task lists (`id`, `title`). Only needed when the user means a list other than their default one.\n - `tasksList`: list tasks. Optional `taskListId` (default: the user's default list), `maxResults` (1-50, default 10), `showCompleted` (default false).\n - `tasksCreate`: add a task. Requires `title`; optional `notes`, `due` (ISO 8601 with offset — Google keeps the DATE only, so do not promise a time of day), `taskListId`.\n - `tasksComplete`: mark a task done. Requires `taskId` (from `tasksList`); optional `taskListId`.\n\nDrive — IMPORTANT: this app can only see files IT created, never the user's wider Drive. Never claim you searched their whole Drive:\n - `driveList`: list files this app created. Optional `maxResults` (1-50, default 10).\n - `driveCreate`: create a text file. Requires `name` and `content`; optional `mimeType` (default text/plain).\n - `driveRead`: read one of this app's files. Requires `fileId` (from `driveList` or `driveCreate`). Text files only.",
+	description: "Operate the user's Google services through the locally linked Google account: Calendar, Tasks, and Drive. Supported kinds:\n - `status`: report whether the Google account is linked on this machine — call this first when unsure.\n\nCalendar (events default to the primary calendar; pass `calendarId` — from `calendarListCalendars` — to target another):\n - `calendarListCalendars`: list the calendars the user has added/subscribed to (`id`, `summary`, `primary`, `backgroundColor`/`foregroundColor` hex, `colorId`, `accessRole`). Call this to work with a non-primary calendar.\n - `calendarColors`: palettes that map an event/calendar `colorId` to hex — `event` for per-event colours, `calendar` for calendar colours.\n - `calendarListEvents`: list upcoming events (each carries `colorId`, empty when it inherits the calendar colour). Optional `calendarId`, `timeMin` (ISO 8601 date-time with timezone offset; default now), `maxResults` (1-50, default 10).\n - `calendarSync`: fetch only what CHANGED since the last sync of this calendar, using a stored sync token. Use this for repeated/periodic syncing — it does not re-fetch the whole calendar, so it stays cheap. The FIRST call (or after `fullResync: true`) walks the entire calendar to establish the token. Returns counts (`changed`, `cancelled`) plus a capped `events` sample — never the full list, so it will not flood the conversation; `truncated: true` means more changed than are shown. Deletions are reported as the `cancelled` count. Optional `calendarId`, `fullResync` (discard the stored token and start over).\n - `calendarCreateEvent`: create an event. Requires `summary`, `start`, `end` — ISO 8601 date-times WITH a timezone offset (e.g. 2026-07-17T09:00:00+09:00); optional `description`, `calendarId`, `colorId` (event palette id \"1\"-\"11\").\n\nTasks:\n - `taskListsList`: list the user's task lists (`id`, `title`). Only needed when the user means a list other than their default one.\n - `tasksList`: list tasks. Optional `taskListId` (default: the user's default list), `maxResults` (1-50, default 10), `showCompleted` (default false).\n - `tasksCreate`: add a task. Requires `title`; optional `notes`, `due` (ISO 8601 with offset — Google keeps the DATE only, so do not promise a time of day), `taskListId`.\n - `tasksComplete`: mark a task done. Requires `taskId` (from `tasksList`); optional `taskListId`.\n\nDrive — IMPORTANT: this app can only see files IT created, never the user's wider Drive. Never claim you searched their whole Drive:\n - `driveList`: list files this app created. Optional `maxResults` (1-50, default 10).\n - `driveCreate`: create a text file. Requires `name` and `content`; optional `mimeType` (default text/plain).\n - `driveRead`: read one of this app's files. Requires `fileId` (from `driveList` or `driveCreate`). Text files only.",
 	parameters: {
 		type: "object",
 		properties: {
@@ -4179,7 +4190,10 @@ var TOOL_DEFINITION = {
 				type: "string",
 				enum: [
 					"status",
+					"calendarListCalendars",
+					"calendarColors",
 					"calendarListEvents",
+					"calendarSync",
 					"calendarCreateEvent",
 					"taskListsList",
 					"tasksList",
@@ -4190,10 +4204,22 @@ var TOOL_DEFINITION = {
 					"driveRead"
 				]
 			},
+			calendarId: {
+				type: "string",
+				description: "calendar kinds: target calendar id from calendarListCalendars (default: the user's primary)"
+			},
+			colorId: {
+				type: "string",
+				description: "calendarCreateEvent: optional event palette colour id \"1\"-\"11\""
+			},
 			timeMin: {
 				type: "string",
 				description: "calendarListEvents: lower bound, ISO 8601 with timezone offset (default: now)"
 			},
+			fullResync: {
+				type: "boolean",
+				description: "calendarSync: discard the stored sync token and re-walk the whole calendar (default false)"
+			},
 			maxResults: {
 				type: "number",
 				description: "list kinds: max items to return, 1-50 (default 10)"
@@ -4261,6 +4287,38 @@ var TOOL_DEFINITION = {
 //#endregion
 //#region src/index.ts
 var LINK_GUIDANCE = "Ask the user to link their Google account in this app's settings, then retry.";
+var SYNC_SAMPLE_LIMIT = 20;
+var summarizeSync = (result, incremental) => {
+	const active = result.events.filter((event) => event.status !== "cancelled");
+	const cancelled = result.events.length - active.length;
+	return {
+		ok: true,
+		incremental,
+		changed: active.length,
+		cancelled,
+		events: active.slice(0, SYNC_SAMPLE_LIMIT),
+		truncated: active.length > SYNC_SAMPLE_LIMIT
+	};
+};
+async function restartFullSync(accessToken, calendarId) {
+	await clearCalendarSyncToken(calendarId);
+	return await syncCalendarEvents(accessToken, { calendarId });
+}
+async function runCalendarSync(calendarId, fullResync) {
+	const accessToken = await getGoogleAccessToken();
+	if (fullResync) await clearCalendarSyncToken(calendarId);
+	const storedToken = fullResync ? null : await loadCalendarSyncToken(calendarId);
+	const first = await syncCalendarEvents(accessToken, {
+		calendarId,
+		syncToken: storedToken ?? void 0
+	});
+	const result = first.fullResyncRequired ? await restartFullSync(accessToken, calendarId) : first;
+	if (result.nextSyncToken) await saveCalendarSyncToken(calendarId, result.nextSyncToken);
+	return {
+		...summarizeSync(result, Boolean(storedToken) && !first.fullResyncRequired),
+		expiredToken: first.fullResyncRequired
+	};
+}
 var src_default = definePlugin(({ log }) => {
 	const dispatch = async (args) => {
 		switch (args.kind) {
@@ -4274,19 +4332,31 @@ var src_default = definePlugin(({ log }) => {
 					...linked ? {} : { guidance: LINK_GUIDANCE }
 				};
 			}
+			case "calendarListCalendars": return {
+				ok: true,
+				calendars: await listCalendars(await getGoogleAccessToken())
+			};
+			case "calendarColors": return {
+				ok: true,
+				colors: await getCalendarColors(await getGoogleAccessToken())
+			};
 			case "calendarListEvents": return {
 				ok: true,
 				events: await listCalendarEvents(await getGoogleAccessToken(), {
+					calendarId: args.calendarId,
 					timeMin: args.timeMin,
 					maxResults: args.maxResults ?? DEFAULT_LIST_MAX_RESULTS
 				})
 			};
+			case "calendarSync": return await runCalendarSync(args.calendarId, args.fullResync ?? false);
 			case "calendarCreateEvent": {
 				const event = await createCalendarEvent(await getGoogleAccessToken(), {
 					summary: args.summary,
 					startDateTime: args.start,
 					endDateTime: args.end,
-					description: args.description
+					description: args.description,
+					calendarId: args.calendarId,
+					colorId: args.colorId
 				});
 				log.info("calendar event created", { id: event.id });
 				return {