@mulmoclaude/google-plugin 0.3.4 → 1.0.1

package/dist/index.js

@@ -1,5 +1,52 @@
 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
+/**
+* Identity function for type inference. Same philosophy as
+* `defineComponent` in Vue: it does nothing at runtime, just lets
+* TypeScript thread the runtime/result types so the plugin author
+* gets full IntelliSense on `runtime.X` without manual annotations.
+*
+* Generic placement (T inferred from setup's return) lets
+* `StrictPluginResult<T>` extract `TOOL_DEFINITION.name` and require
+* a matching named handler — Codex review #10 iter-2 caught that an
+* earlier `<N extends string, T extends PluginFactoryResult<N>>`
+* shape would not actually narrow `N` at the call site.
+*
+* Plugin authors should declare `name` as a literal (`as const`) so
+* the strict handler check fires:
+*
+*   TOOL_DEFINITION: { type: "function" as const, name: "myTool" as const, ... }
+*
+* Without `as const`, `N` widens to `string` and the strict check
+* gracefully degrades to the loose runtime warn (see
+* `StrictPluginResult` above).
+*
+* **Annotate the handler parameter explicitly** as `args: unknown`.
+* TypeScript can't propagate the contextual type into the method
+* parameter when it's still inferring `T` from the same return value
+* (circular), so leaving `args` un-annotated trips `noImplicitAny`.
+* Always:
+*
+*   async myTool(args: unknown) { ... }
+*
+* @example
+* ```ts
+* export default definePlugin(({ pubsub, files, locale }) => ({
+*   TOOL_DEFINITION: {
+*     type: "function" as const,
+*     name: "myTool" as const,
+*     description: "...",
+*     parameters: { type: "object", properties: {}, required: [] },
+*   },
+*   async myTool(args: unknown) {
+*     // narrow `args` here — typically with Zod
+*     await files.data.write("state.json", JSON.stringify(args));
+*     pubsub.publish("changed", {});
+*     return { ok: true };
+*   },
+* }));
+* ```
+*/
 function definePlugin(setup) {
 	return setup;
 }