@mulmoclaude/google-plugin 1.0.2 → 1.2.0

package/README.md

@@ -12,9 +12,17 @@ dispatch). Server-only — no Vue View.
   OAuth client secret Google requires and stores nothing; tokens stay on the
   user's machine. A `~/.secrets/client_secret_*.json` (advanced) keeps the
   whole flow local instead.
-- Kinds: `status`; Calendar (`calendarListEvents`, `calendarCreateEvent`);
-  Tasks (`taskListsList`, `tasksList`, `tasksCreate`, `tasksComplete`);
+- Kinds: `status`; Calendar (`calendarListCalendars`, `calendarColors`,
+  `calendarListEvents`, `calendarSync`, `calendarCreateEvent`,
+  `calendarUpdateEvent`, `calendarDeleteEvent`); Tasks (`taskListsList`,
+  `tasksList`, `tasksCreate`, `tasksUpdate`, `tasksComplete`, `tasksDelete`);
   Drive (`driveList`, `driveCreate`, `driveRead`).
+- Editing is a **patch**: omitted fields keep their value, and `""` clears a
+  description / notes. Deletes are irreversible, so the tool tells the agent to
+  confirm with the user first.
+- Date-times must carry a **timezone offset** (`2026-07-17T09:00:00+09:00`);
+  Calendar rejects date-only and offset-less values with an opaque 400, so the
+  schema rejects them first with an actionable message.
 - **Drive is `drive.file`-scoped** — the app only ever sees files it created,
   never the user's wider Drive. That's what keeps the scope non-sensitive.
 - Not linked yet? The tool's errors tell the LLM to guide the user to this
@@ -22,9 +30,28 @@ dispatch). Server-only — no Vue View.
   per host (MulmoClaude: Settings → Plugins → Google or `yarn google:auth`;
   MulmoTerminal: Settings → Google account or `npx mulmoterminal google login`).
 
+## About MulmoClaude and MulmoTerminal
+
+- **[MulmoClaude](https://github.com/receptron/mulmoclaude)** — an AI-native
+  application platform built on Claude Code. Chat summons the right GUI for each
+  task (documents, charts, forms, wikis, spreadsheets, 3D scenes), and
+  everything your assistant accumulates stays as plain files in your own
+  workspace, on your own machine.
+- **[MulmoTerminal](https://github.com/receptron/mulmoterminal)** — run a whole
+  team of coding agents from your browser. Many Claude Code / Codex sessions at
+  once in a grid, colour-coded so you see which are working, which need you and
+  which are done, plus git worktrees, one-click PRs and cost readouts. One `npx`
+  command, no Electron, no config.
+
+📖 **User guide**: <https://receptron.github.io/mulmoterminal/> (日本語 / English)
+
 ## Dev loop
 
 ```bash
 yarn workspace @mulmoclaude/google-plugin run build
 yarn workspace @mulmoclaude/google-plugin run test
 ```
+
+## License
+
+MIT

package/dist/args.d.ts

@@ -22,6 +22,19 @@ export declare const GoogleArgs: z.ZodDiscriminatedUnion<[z.ZodObject<{
     description: z.ZodOptional<z.ZodString>;
     calendarId: z.ZodOptional<z.ZodString>;
     colorId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"calendarUpdateEvent">;
+    eventId: z.ZodString;
+    summary: z.ZodOptional<z.ZodString>;
+    start: z.ZodOptional<z.ZodString>;
+    end: z.ZodOptional<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<"calendarDeleteEvent">;
+    eventId: z.ZodString;
+    calendarId: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>, z.ZodObject<{
     kind: z.ZodLiteral<"taskListsList">;
 }, z.core.$strip>, z.ZodObject<{
@@ -35,10 +48,25 @@ export declare const GoogleArgs: z.ZodDiscriminatedUnion<[z.ZodObject<{
     notes: z.ZodOptional<z.ZodString>;
     due: z.ZodOptional<z.ZodString>;
     taskListId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"tasksUpdate">;
+    taskId: z.ZodString;
+    title: z.ZodOptional<z.ZodString>;
+    notes: z.ZodOptional<z.ZodString>;
+    due: z.ZodOptional<z.ZodString>;
+    taskListId: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>, z.ZodObject<{
     kind: z.ZodLiteral<"tasksComplete">;
     taskId: z.ZodString;
     taskListId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"tasksUncomplete">;
+    taskId: z.ZodString;
+    taskListId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"tasksDelete">;
+    taskId: z.ZodString;
+    taskListId: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>, z.ZodObject<{
     kind: z.ZodLiteral<"driveList">;
     maxResults: z.ZodOptional<z.ZodNumber>;

package/dist/definition.d.ts

@@ -18,6 +18,10 @@ export declare const TOOL_DEFINITION: {
                 type: string;
                 description: string;
             };
+            eventId: {
+                type: string;
+                description: string;
+            };
             timeMin: {
                 type: string;
                 description: string;

package/dist/index.d.ts

@@ -21,6 +21,10 @@ declare const _default: (runtime: import('gui-chat-protocol').PluginRuntime) =>
                     type: string;
                     description: string;
                 };
+                eventId: {
+                    type: string;
+                    description: string;
+                };
                 timeMin: {
                     type: string;
                     description: string;

package/dist/index.js

@@ -1,4 +1,4 @@
-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";
+import { DEFAULT_LIST_MAX_RESULTS, MAX_LIST_RESULTS, clearCalendarSyncToken, clientSecretPresence, completeTask, createCalendarEvent, createDriveFile, createTask, deleteCalendarEvent, deleteTask, getCalendarColors, getGoogleAccessToken, isIsoDateTimeWithOffset, listCalendarEvents, listCalendars, listDriveFiles, listTaskLists, listTasks, loadCalendarSyncToken, loadGoogleTokens, readDriveFile, saveCalendarSyncToken, syncCalendarEvents, uncompleteTask, updateCalendarEvent, updateTask } from "@mulmoclaude/core/google";
 //#region ../../../node_modules/gui-chat-protocol/dist/index.js
 /**
 * Identity function for type inference. Same philosophy as
@@ -4165,6 +4165,18 @@ var IsoDateTimeWithOffset = string().refine(isIsoDateTimeWithOffset, { error: "m
 var MaxResults = number().int().min(1).max(MAX_LIST_RESULTS).optional();
 var NonEmpty = string().min(1);
 var OptionalNonEmpty = string().trim().min(1).optional();
+var EDITABLE_EVENT_FIELDS = [
+	"summary",
+	"start",
+	"end",
+	"description",
+	"colorId"
+];
+var EDITABLE_TASK_FIELDS = [
+	"title",
+	"notes",
+	"due"
+];
 var GoogleArgs = discriminatedUnion("kind", [
 	object({ kind: literal("status") }),
 	object({ kind: literal("calendarListCalendars") }),
@@ -4189,10 +4201,25 @@ var GoogleArgs = discriminatedUnion("kind", [
 		calendarId: OptionalNonEmpty,
 		colorId: OptionalNonEmpty
 	}),
+	object({
+		kind: literal("calendarUpdateEvent"),
+		eventId: NonEmpty,
+		summary: NonEmpty.optional(),
+		start: IsoDateTimeWithOffset.optional(),
+		end: IsoDateTimeWithOffset.optional(),
+		description: string().optional(),
+		calendarId: OptionalNonEmpty,
+		colorId: OptionalNonEmpty
+	}).refine((args) => EDITABLE_EVENT_FIELDS.some((field) => args[field] !== void 0), { error: `pass at least one field to change (${EDITABLE_EVENT_FIELDS.join(", ")})` }),
+	object({
+		kind: literal("calendarDeleteEvent"),
+		eventId: NonEmpty,
+		calendarId: OptionalNonEmpty
+	}),
 	object({ kind: literal("taskListsList") }),
 	object({
 		kind: literal("tasksList"),
-		taskListId: string().optional(),
+		taskListId: OptionalNonEmpty,
 		maxResults: MaxResults,
 		showCompleted: boolean().optional()
 	}),
@@ -4201,12 +4228,30 @@ var GoogleArgs = discriminatedUnion("kind", [
 		title: NonEmpty,
 		notes: string().optional(),
 		due: IsoDateTimeWithOffset.optional(),
-		taskListId: string().optional()
+		taskListId: OptionalNonEmpty
 	}),
+	object({
+		kind: literal("tasksUpdate"),
+		taskId: NonEmpty,
+		title: NonEmpty.optional(),
+		notes: string().optional(),
+		due: IsoDateTimeWithOffset.optional(),
+		taskListId: OptionalNonEmpty
+	}).refine((args) => EDITABLE_TASK_FIELDS.some((field) => args[field] !== void 0), { error: `pass at least one field to change (${EDITABLE_TASK_FIELDS.join(", ")})` }),
 	object({
 		kind: literal("tasksComplete"),
 		taskId: NonEmpty,
-		taskListId: string().optional()
+		taskListId: OptionalNonEmpty
+	}),
+	object({
+		kind: literal("tasksUncomplete"),
+		taskId: NonEmpty,
+		taskListId: OptionalNonEmpty
+	}),
+	object({
+		kind: literal("tasksDelete"),
+		taskId: NonEmpty,
+		taskListId: OptionalNonEmpty
 	}),
 	object({
 		kind: literal("driveList"),
@@ -4228,8 +4273,8 @@ var GoogleArgs = discriminatedUnion("kind", [
 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 - `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.",
+	prompt: "The user's Google account is linked LOCALLY on this machine — the refresh token is stored in ~/.config/mulmo/ and goes only to Google to mint access tokens, never to claude.ai or any other service. 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 - `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 - `calendarUpdateEvent`: edit an existing event. Requires `eventId` (from `calendarListEvents` / `calendarSync`) plus AT LEAST ONE of `summary`, `start`, `end`, `description`, `colorId`; fields you omit keep their current value, and `description: \"\"` clears the body. Optional `calendarId`. Moving only one end of the event still has to leave start before end, or Calendar rejects it.\n - `calendarDeleteEvent`: delete an event. Requires `eventId`; optional `calendarId`. This removes it for every attendee and cannot be undone — confirm with the user before calling. For a recurring event, an instance id (as returned by the list kinds) deletes that single occurrence.\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 - `tasksUpdate`: edit a task. Requires `taskId` (from `tasksList`) plus AT LEAST ONE of `title`, `notes`, `due`; omitted fields keep their value and `notes: \"\"` clears them. Use `tasksComplete` / `tasksUncomplete` to change status — this kind does not. Optional `taskListId`.\n - `tasksComplete`: mark a task done. Requires `taskId` (from `tasksList`); optional `taskListId`.\n - `tasksUncomplete`: put a completed task back on the to-do list. Requires `taskId`; optional `taskListId`. Completed tasks are hidden from `tasksList` unless you pass `showCompleted: true`, so list with that first to find the id.\n - `tasksDelete`: delete a task. Requires `taskId`; optional `taskListId`. Cannot be undone — confirm with the user before calling.\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: {
@@ -4242,10 +4287,15 @@ var TOOL_DEFINITION = {
 					"calendarListEvents",
 					"calendarSync",
 					"calendarCreateEvent",
+					"calendarUpdateEvent",
+					"calendarDeleteEvent",
 					"taskListsList",
 					"tasksList",
 					"tasksCreate",
+					"tasksUpdate",
 					"tasksComplete",
+					"tasksUncomplete",
+					"tasksDelete",
 					"driveList",
 					"driveCreate",
 					"driveRead"
@@ -4257,7 +4307,11 @@ var TOOL_DEFINITION = {
 			},
 			colorId: {
 				type: "string",
-				description: "calendarCreateEvent: optional event palette colour id \"1\"-\"11\""
+				description: "calendarCreateEvent / calendarUpdateEvent: optional event palette colour id \"1\"-\"11\""
+			},
+			eventId: {
+				type: "string",
+				description: "calendarUpdateEvent / calendarDeleteEvent: id of the event, from calendarListEvents or calendarSync"
 			},
 			timeMin: {
 				type: "string",
@@ -4273,19 +4327,19 @@ var TOOL_DEFINITION = {
 			},
 			summary: {
 				type: "string",
-				description: "calendarCreateEvent: event title"
+				description: "calendarCreateEvent / calendarUpdateEvent: event title"
 			},
 			start: {
 				type: "string",
-				description: "calendarCreateEvent: start, ISO 8601 with timezone offset"
+				description: "calendarCreateEvent / calendarUpdateEvent: start, ISO 8601 with timezone offset"
 			},
 			end: {
 				type: "string",
-				description: "calendarCreateEvent: end, ISO 8601 with timezone offset"
+				description: "calendarCreateEvent / calendarUpdateEvent: end, ISO 8601 with timezone offset"
 			},
 			description: {
 				type: "string",
-				description: "calendarCreateEvent: optional event body"
+				description: "calendarCreateEvent / calendarUpdateEvent: event body (\"\" on update clears it)"
 			},
 			taskListId: {
 				type: "string",
@@ -4297,19 +4351,19 @@ var TOOL_DEFINITION = {
 			},
 			title: {
 				type: "string",
-				description: "tasksCreate: task title"
+				description: "tasksCreate / tasksUpdate: task title"
 			},
 			notes: {
 				type: "string",
-				description: "tasksCreate: optional task notes"
+				description: "tasksCreate / tasksUpdate: task notes (\"\" on update clears them)"
 			},
 			due: {
 				type: "string",
-				description: "tasksCreate: optional due date, ISO 8601 with offset (Google keeps the date only)"
+				description: "tasksCreate / tasksUpdate: due date, ISO 8601 with offset (Google keeps the date only)"
 			},
 			taskId: {
 				type: "string",
-				description: "tasksComplete: id of the task to mark done"
+				description: "tasksUpdate / tasksComplete / tasksUncomplete / tasksDelete: id of the task, from tasksList"
 			},
 			name: {
 				type: "string",
@@ -4411,6 +4465,32 @@ var src_default = definePlugin(({ log }) => {
 					event
 				};
 			}
+			case "calendarUpdateEvent": {
+				const event = await updateCalendarEvent(await getGoogleAccessToken(), {
+					eventId: args.eventId,
+					summary: args.summary,
+					startDateTime: args.start,
+					endDateTime: args.end,
+					description: args.description,
+					calendarId: args.calendarId,
+					colorId: args.colorId
+				});
+				log.info("calendar event updated", { id: event.id });
+				return {
+					ok: true,
+					event
+				};
+			}
+			case "calendarDeleteEvent":
+				await deleteCalendarEvent(await getGoogleAccessToken(), {
+					eventId: args.eventId,
+					calendarId: args.calendarId
+				});
+				log.info("calendar event deleted", { id: args.eventId });
+				return {
+					ok: true,
+					deleted: args.eventId
+				};
 			case "taskListsList": return {
 				ok: true,
 				taskLists: await listTaskLists(await getGoogleAccessToken())
@@ -4436,6 +4516,20 @@ var src_default = definePlugin(({ log }) => {
 					task
 				};
 			}
+			case "tasksUpdate": {
+				const task = await updateTask(await getGoogleAccessToken(), {
+					taskId: args.taskId,
+					title: args.title,
+					notes: args.notes,
+					due: args.due,
+					taskListId: args.taskListId
+				});
+				log.info("task updated", { id: task.id });
+				return {
+					ok: true,
+					task
+				};
+			}
 			case "tasksComplete": return {
 				ok: true,
 				task: await completeTask(await getGoogleAccessToken(), {
@@ -4443,6 +4537,23 @@ var src_default = definePlugin(({ log }) => {
 					taskListId: args.taskListId
 				})
 			};
+			case "tasksUncomplete": return {
+				ok: true,
+				task: await uncompleteTask(await getGoogleAccessToken(), {
+					taskId: args.taskId,
+					taskListId: args.taskListId
+				})
+			};
+			case "tasksDelete":
+				await deleteTask(await getGoogleAccessToken(), {
+					taskId: args.taskId,
+					taskListId: args.taskListId
+				});
+				log.info("task deleted", { id: args.taskId });
+				return {
+					ok: true,
+					deleted: args.taskId
+				};
 			case "driveList": return {
 				ok: true,
 				files: await listDriveFiles(await getGoogleAccessToken(), { maxResults: args.maxResults ?? DEFAULT_LIST_MAX_RESULTS })