@mulmoclaude/google-plugin 0.3.0 → 0.3.3

package/dist/args.d.ts

@@ -10,6 +10,10 @@ export declare const GoogleArgs: z.ZodDiscriminatedUnion<[z.ZodObject<{
     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;

package/dist/definition.d.ts

@@ -22,6 +22,10 @@ export declare const TOOL_DEFINITION: {
                 type: string;
                 description: string;
             };
+            fullResync: {
+                type: string;
+                description: string;
+            };
             maxResults: {
                 type: string;
                 description: string;

package/dist/index.d.ts

@@ -25,6 +25,10 @@ declare const _default: (runtime: import('gui-chat-protocol').PluginRuntime) =>
                     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, getCalendarColors, getGoogleAccessToken, isIsoDateTimeWithOffset, listCalendarEvents, listCalendars, 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;
@@ -4128,6 +4128,11 @@ var GoogleArgs = discriminatedUnion("kind", [
 		timeMin: IsoDateTimeWithOffset.optional(),
 		maxResults: MaxResults
 	}),
+	object({
+		kind: literal("calendarSync"),
+		calendarId: OptionalNonEmpty,
+		fullResync: boolean().optional()
+	}),
 	object({
 		kind: literal("calendarCreateEvent"),
 		summary: NonEmpty,
@@ -4177,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, 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 - `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.",
+	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: {
@@ -4188,6 +4193,7 @@ var TOOL_DEFINITION = {
 					"calendarListCalendars",
 					"calendarColors",
 					"calendarListEvents",
+					"calendarSync",
 					"calendarCreateEvent",
 					"taskListsList",
 					"tasksList",
@@ -4210,6 +4216,10 @@ var TOOL_DEFINITION = {
 				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)"
@@ -4277,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) {
@@ -4306,6 +4348,7 @@ var src_default = definePlugin(({ log }) => {
 					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,