@mulmoclaude/google-plugin 0.1.2 → 0.2.1

package/README.md

@@ -5,11 +5,18 @@ account** to the chat agent as one `google` tool (kind-discriminated
 dispatch). Server-only — no Vue View.
 
 - Engine: `@mulmoclaude/core/google` (OAuth loopback + PKCE, token store at
-  the host-neutral `~/.config/mulmo/google-token.json`, Calendar v3 REST).
-  The host's settings UI, remote commands, auth CLI, and this tool share one
-  link state — across hosts, too.
-- Kinds: `status`, `calendarListEvents`, `calendarCreateEvent`. Tasks / Drive
-  (`drive.file`) ride the same consent grant later (issue #2115).
+  the host-neutral `~/.config/mulmo/google-token.json`, Calendar / Tasks /
+  Drive REST). The host's settings UI, remote commands, auth CLI, and this
+  tool share one link state — across hosts, too.
+- Linking needs **no Google Cloud setup**: the mulmoserver broker applies the
+  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`);
+  Drive (`driveList`, `driveCreate`, `driveRead`).
+- **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
   app's settings — wording is host-neutral (#2128) because link flows differ
   per host (MulmoClaude: Settings → Plugins → Google or `yarn google:auth`;

package/dist/args.d.ts

@@ -11,5 +11,33 @@ export declare const GoogleArgs: z.ZodDiscriminatedUnion<[z.ZodObject<{
     start: z.ZodString;
     end: z.ZodString;
     description: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"taskListsList">;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"tasksList">;
+    taskListId: z.ZodOptional<z.ZodString>;
+    maxResults: z.ZodOptional<z.ZodNumber>;
+    showCompleted: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"tasksCreate">;
+    title: 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<"driveList">;
+    maxResults: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"driveCreate">;
+    name: z.ZodString;
+    content: z.ZodString;
+    mimeType: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"driveRead">;
+    fileId: z.ZodString;
 }, z.core.$strip>], "kind">;
 export type GoogleArgs = z.infer<typeof GoogleArgs>;

package/dist/definition.d.ts

@@ -34,6 +34,46 @@ export declare const TOOL_DEFINITION: {
                 type: string;
                 description: string;
             };
+            taskListId: {
+                type: string;
+                description: string;
+            };
+            showCompleted: {
+                type: string;
+                description: string;
+            };
+            title: {
+                type: string;
+                description: string;
+            };
+            notes: {
+                type: string;
+                description: string;
+            };
+            due: {
+                type: string;
+                description: string;
+            };
+            taskId: {
+                type: string;
+                description: string;
+            };
+            name: {
+                type: string;
+                description: string;
+            };
+            content: {
+                type: string;
+                description: string;
+            };
+            mimeType: {
+                type: string;
+                description: string;
+            };
+            fileId: {
+                type: string;
+                description: string;
+            };
         };
         required: string[];
     };

package/dist/index.d.ts

@@ -37,25 +37,50 @@ declare const _default: (runtime: import('gui-chat-protocol').PluginRuntime) =>
                     type: string;
                     description: string;
                 };
+                taskListId: {
+                    type: string;
+                    description: string;
+                };
+                showCompleted: {
+                    type: string;
+                    description: string;
+                };
+                title: {
+                    type: string;
+                    description: string;
+                };
+                notes: {
+                    type: string;
+                    description: string;
+                };
+                due: {
+                    type: string;
+                    description: string;
+                };
+                taskId: {
+                    type: string;
+                    description: string;
+                };
+                name: {
+                    type: string;
+                    description: string;
+                };
+                content: {
+                    type: string;
+                    description: string;
+                };
+                mimeType: {
+                    type: string;
+                    description: string;
+                };
+                fileId: {
+                    type: string;
+                    description: string;
+                };
             };
             required: string[];
         };
     };
-    google(rawArgs: unknown): Promise<{
-        guidance?: string | undefined;
-        ok: boolean;
-        linked: boolean;
-        clientSecret: import('@mulmoclaude/core/google').ClientSecretPresence;
-        events?: undefined;
-        event?: undefined;
-    } | {
-        ok: boolean;
-        events: import('@mulmoclaude/core/google').CalendarEventSummary[];
-        event?: undefined;
-    } | {
-        ok: boolean;
-        event: import('@mulmoclaude/core/google').CalendarEventSummary;
-        events?: undefined;
-    }>;
+    google(rawArgs: unknown): Promise<unknown>;
 };
 export default _default;

package/dist/index.js

@@ -1,4 +1,4 @@
-import { DEFAULT_LIST_MAX_RESULTS, MAX_LIST_RESULTS, clientSecretPresence, createCalendarEvent, getGoogleAccessToken, isIsoDateTimeWithOffset, listCalendarEvents, loadGoogleTokens } from "@mulmoclaude/core/google";
+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";
 //#region ../../../node_modules/gui-chat-protocol/dist/index.js
 function definePlugin(setup) {
 	return setup;
@@ -612,6 +612,7 @@ var string$1 = (params) => {
 };
 var integer = /^-?\d+$/;
 var number$1 = /^-?\d+(?:\.\d+)?$/;
+var boolean$1 = /^(?:true|false)$/i;
 var lowercase = /^[^A-Z]*$/;
 var uppercase = /^[^a-z]*$/;
 //#endregion
@@ -1406,6 +1407,24 @@ var $ZodNumberFormat = /*@__PURE__*/ $constructor("$ZodNumberFormat", (inst, def
 	$ZodCheckNumberFormat.init(inst, def);
 	$ZodNumber.init(inst, def);
 });
+var $ZodBoolean = /*@__PURE__*/ $constructor("$ZodBoolean", (inst, def) => {
+	$ZodType.init(inst, def);
+	inst._zod.pattern = boolean$1;
+	inst._zod.parse = (payload, _ctx) => {
+		if (def.coerce) try {
+			payload.value = Boolean(payload.value);
+		} catch (_) {}
+		const input = payload.value;
+		if (typeof input === "boolean") return payload;
+		payload.issues.push({
+			expected: "boolean",
+			code: "invalid_type",
+			input,
+			inst
+		});
+		return payload;
+	};
+});
 var $ZodUnknown = /*@__PURE__*/ $constructor("$ZodUnknown", (inst, def) => {
 	$ZodType.init(inst, def);
 	inst._zod.parse = (payload) => payload;
@@ -2512,6 +2531,13 @@ function _int(Class, params) {
 	});
 }
 // @__NO_SIDE_EFFECTS__
+function _boolean(Class, params) {
+	return new Class({
+		type: "boolean",
+		...normalizeParams(params)
+	});
+}
+// @__NO_SIDE_EFFECTS__
 function _unknown(Class) {
 	return new Class({ type: "unknown" });
 }
@@ -3057,6 +3083,9 @@ var numberProcessor = (schema, ctx, _json, _params) => {
 	else if (typeof maximum === "number") json.maximum = maximum;
 	if (typeof multipleOf === "number") json.multipleOf = multipleOf;
 };
+var booleanProcessor = (_schema, _ctx, json, _params) => {
+	json.type = "boolean";
+};
 var neverProcessor = (_schema, _ctx, json, _params) => {
 	json.not = {};
 };
@@ -3706,6 +3735,14 @@ var ZodNumberFormat = /*@__PURE__*/ $constructor("ZodNumberFormat", (inst, def)
 function int(params) {
 	return /* @__PURE__ */ _int(ZodNumberFormat, params);
 }
+var ZodBoolean = /*@__PURE__*/ $constructor("ZodBoolean", (inst, def) => {
+	$ZodBoolean.init(inst, def);
+	ZodType.init(inst, def);
+	inst._zod.processJSONSchema = (ctx, json, params) => booleanProcessor(inst, ctx, json, params);
+});
+function boolean(params) {
+	return /* @__PURE__ */ _boolean(ZodBoolean, params);
+}
 var ZodUnknown = /*@__PURE__*/ $constructor("ZodUnknown", (inst, def) => {
 	$ZodUnknown.init(inst, def);
 	ZodType.init(inst, def);
@@ -4078,19 +4115,54 @@ function superRefine(fn, params) {
 //#endregion
 //#region src/args.ts
 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 GoogleArgs = discriminatedUnion("kind", [
 	object({ kind: literal("status") }),
 	object({
 		kind: literal("calendarListEvents"),
 		timeMin: IsoDateTimeWithOffset.optional(),
-		maxResults: number().int().min(1).max(MAX_LIST_RESULTS).optional()
+		maxResults: MaxResults
 	}),
 	object({
 		kind: literal("calendarCreateEvent"),
-		summary: string().min(1),
+		summary: NonEmpty,
 		start: IsoDateTimeWithOffset,
 		end: IsoDateTimeWithOffset,
 		description: string().optional()
+	}),
+	object({ kind: literal("taskListsList") }),
+	object({
+		kind: literal("tasksList"),
+		taskListId: string().optional(),
+		maxResults: MaxResults,
+		showCompleted: boolean().optional()
+	}),
+	object({
+		kind: literal("tasksCreate"),
+		title: NonEmpty,
+		notes: string().optional(),
+		due: IsoDateTimeWithOffset.optional(),
+		taskListId: string().optional()
+	}),
+	object({
+		kind: literal("tasksComplete"),
+		taskId: NonEmpty,
+		taskListId: string().optional()
+	}),
+	object({
+		kind: literal("driveList"),
+		maxResults: MaxResults
+	}),
+	object({
+		kind: literal("driveCreate"),
+		name: NonEmpty,
+		content: string(),
+		mimeType: string().optional()
+	}),
+	object({
+		kind: literal("driveRead"),
+		fileId: NonEmpty
 	})
 ]);
 //#endregion
@@ -4099,7 +4171,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. Currently Google Calendar (the primary calendar). Supported kinds:\n - `status`: report whether the Google account is linked on this machine — call this first when unsure.\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`.",
+	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.",
 	parameters: {
 		type: "object",
 		properties: {
@@ -4108,7 +4180,14 @@ var TOOL_DEFINITION = {
 				enum: [
 					"status",
 					"calendarListEvents",
-					"calendarCreateEvent"
+					"calendarCreateEvent",
+					"taskListsList",
+					"tasksList",
+					"tasksCreate",
+					"tasksComplete",
+					"driveList",
+					"driveCreate",
+					"driveRead"
 				]
 			},
 			timeMin: {
@@ -4117,7 +4196,7 @@ var TOOL_DEFINITION = {
 			},
 			maxResults: {
 				type: "number",
-				description: "calendarListEvents: max events to return, 1-50 (default 10)"
+				description: "list kinds: max items to return, 1-50 (default 10)"
 			},
 			summary: {
 				type: "string",
@@ -4134,6 +4213,46 @@ var TOOL_DEFINITION = {
 			description: {
 				type: "string",
 				description: "calendarCreateEvent: optional event body"
+			},
+			taskListId: {
+				type: "string",
+				description: "tasks kinds: target list id (default: the user's default list)"
+			},
+			showCompleted: {
+				type: "boolean",
+				description: "tasksList: include completed tasks (default false)"
+			},
+			title: {
+				type: "string",
+				description: "tasksCreate: task title"
+			},
+			notes: {
+				type: "string",
+				description: "tasksCreate: optional task notes"
+			},
+			due: {
+				type: "string",
+				description: "tasksCreate: optional due date, ISO 8601 with offset (Google keeps the date only)"
+			},
+			taskId: {
+				type: "string",
+				description: "tasksComplete: id of the task to mark done"
+			},
+			name: {
+				type: "string",
+				description: "driveCreate: file name"
+			},
+			content: {
+				type: "string",
+				description: "driveCreate: file body"
+			},
+			mimeType: {
+				type: "string",
+				description: "driveCreate: optional MIME type (default text/plain)"
+			},
+			fileId: {
+				type: "string",
+				description: "driveRead: id of a file this app created"
 			}
 		},
 		required: ["kind"]
@@ -4143,43 +4262,101 @@ var TOOL_DEFINITION = {
 //#region src/index.ts
 var LINK_GUIDANCE = "Ask the user to link their Google account in this app's settings, then retry.";
 var src_default = definePlugin(({ log }) => {
-	return {
-		TOOL_DEFINITION,
-		async google(rawArgs) {
-			const args = GoogleArgs.parse(rawArgs);
-			switch (args.kind) {
-				case "status": {
-					const [tokens, clientSecret] = await Promise.all([loadGoogleTokens(), clientSecretPresence()]);
-					const linked = Boolean(tokens?.refresh_token);
-					return {
-						ok: true,
-						linked,
-						clientSecret,
-						...linked ? {} : { guidance: LINK_GUIDANCE }
-					};
-				}
-				case "calendarListEvents": return {
+	const dispatch = async (args) => {
+		switch (args.kind) {
+			case "status": {
+				const [tokens, clientSecret] = await Promise.all([loadGoogleTokens(), clientSecretPresence()]);
+				const linked = Boolean(tokens?.refresh_token);
+				return {
 					ok: true,
-					events: await listCalendarEvents(await getGoogleAccessToken(), {
-						timeMin: args.timeMin,
-						maxResults: args.maxResults ?? DEFAULT_LIST_MAX_RESULTS
-					})
+					linked,
+					clientSecret,
+					...linked ? {} : { guidance: LINK_GUIDANCE }
+				};
+			}
+			case "calendarListEvents": return {
+				ok: true,
+				events: await listCalendarEvents(await getGoogleAccessToken(), {
+					timeMin: args.timeMin,
+					maxResults: args.maxResults ?? DEFAULT_LIST_MAX_RESULTS
+				})
+			};
+			case "calendarCreateEvent": {
+				const event = await createCalendarEvent(await getGoogleAccessToken(), {
+					summary: args.summary,
+					startDateTime: args.start,
+					endDateTime: args.end,
+					description: args.description
+				});
+				log.info("calendar event created", { id: event.id });
+				return {
+					ok: true,
+					event
 				};
-				case "calendarCreateEvent": {
-					const event = await createCalendarEvent(await getGoogleAccessToken(), {
-						summary: args.summary,
-						startDateTime: args.start,
-						endDateTime: args.end,
-						description: args.description
-					});
-					log.info("calendar event created", { id: event.id });
-					return {
-						ok: true,
-						event
-					};
-				}
-				default: throw new Error(`unknown kind: ${JSON.stringify(args)}`);
 			}
+			case "taskListsList": return {
+				ok: true,
+				taskLists: await listTaskLists(await getGoogleAccessToken())
+			};
+			case "tasksList": return {
+				ok: true,
+				tasks: await listTasks(await getGoogleAccessToken(), {
+					taskListId: args.taskListId,
+					maxResults: args.maxResults ?? DEFAULT_LIST_MAX_RESULTS,
+					showCompleted: args.showCompleted
+				})
+			};
+			case "tasksCreate": {
+				const task = await createTask(await getGoogleAccessToken(), {
+					title: args.title,
+					notes: args.notes,
+					due: args.due,
+					taskListId: args.taskListId
+				});
+				log.info("task created", { id: task.id });
+				return {
+					ok: true,
+					task
+				};
+			}
+			case "tasksComplete": return {
+				ok: true,
+				task: await completeTask(await getGoogleAccessToken(), {
+					taskId: args.taskId,
+					taskListId: args.taskListId
+				})
+			};
+			case "driveList": return {
+				ok: true,
+				files: await listDriveFiles(await getGoogleAccessToken(), { maxResults: args.maxResults ?? DEFAULT_LIST_MAX_RESULTS })
+			};
+			case "driveCreate": {
+				const file = await createDriveFile(await getGoogleAccessToken(), {
+					name: args.name,
+					content: args.content,
+					mimeType: args.mimeType
+				});
+				log.info("drive file created", { id: file.id });
+				return {
+					ok: true,
+					file
+				};
+			}
+			case "driveRead": {
+				const { file, content } = await readDriveFile(await getGoogleAccessToken(), { fileId: args.fileId });
+				return {
+					ok: true,
+					file,
+					content
+				};
+			}
+			default: throw new Error(`unknown kind: ${JSON.stringify(args)}`);
+		}
+	};
+	return {
+		TOOL_DEFINITION,
+		async google(rawArgs) {
+			return await dispatch(GoogleArgs.parse(rawArgs));
 		}
 	};
 });