@sentry/junior-google 0.238.1 → 0.240.0

package/dist/tools/shared.d.ts

@@ -3,16 +3,21 @@ import { z } from "zod";
 import { type GoogleOperation } from "../credentials";
 /** Runtime capabilities the Calendar tools use. */
 export interface GoogleToolContext {
+    /** The Workspace account Junior acts as, in lowercase. */
+    accountEmail: string;
     allowedDomains: string[];
     egress: PluginEgress;
     users: {
         resolveActor(): Promise<{
             user?: User;
         } | undefined>;
+        resolveTimezone(): Promise<string>;
     };
 }
 export declare const emailListSchema: (max: number) => z.ZodArray<z.ZodPipe<z.ZodString, z.ZodEmail>>;
-export declare const timeZoneSchema: z.ZodString;
+export declare const timeZoneSchema: z.ZodOptional<z.ZodString>;
+/** True when the runtime knows this IANA time zone. */
+export declare function isTimeZone(value: string): boolean;
 /** Reject people outside the domains Junior may look up or invite. */
 export declare function requireAllowedEmails(emails: string[], allowedDomains: string[]): void;
 /** Return the requester's email in lowercase, when Junior knows it. */
@@ -41,32 +46,124 @@ export declare function googleApiError(operation: GoogleOperation, response: {
 export declare function formatInterval(startMs: number, endMs: number, timeZone: string): string;
 /** Longest event Junior may create or move an event to. */
 export declare const MAX_EVENT_MS: number;
+/** Google attendee fields that tools read and return. */
+export declare const googleAttendeeSchema: z.ZodObject<{
+    displayName: z.ZodOptional<z.ZodString>;
+    email: z.ZodString;
+    optional: z.ZodOptional<z.ZodBoolean>;
+    resource: z.ZodOptional<z.ZodBoolean>;
+    responseStatus: z.ZodOptional<z.ZodString>;
+}, z.core.$loose>;
+/** One attendee in a tool result. */
+export declare const attendeeOutputSchema: z.ZodObject<{
+    email: z.ZodString;
+    optional: z.ZodOptional<z.ZodBoolean>;
+    response: z.ZodOptional<z.ZodEnum<{
+        accepted: "accepted";
+        declined: "declined";
+        tentative: "tentative";
+        needsAction: "needsAction";
+    }>>;
+}, z.core.$strip>;
+/** Shape Google attendees for a tool result. Room resources are left out. */
+export declare function attendeeResults(attendees: Array<z.infer<typeof googleAttendeeSchema>> | undefined): Array<z.infer<typeof attendeeOutputSchema>>;
 /** Event fields that Junior reads back from its own calendar. */
 export declare const ownEventSchema: z.ZodObject<{
     attendees: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        displayName: z.ZodOptional<z.ZodString>;
         email: z.ZodString;
+        optional: z.ZodOptional<z.ZodBoolean>;
+        resource: z.ZodOptional<z.ZodBoolean>;
         responseStatus: z.ZodOptional<z.ZodString>;
     }, z.core.$loose>>>;
+    description: z.ZodOptional<z.ZodString>;
     end: z.ZodObject<{
         dateTime: z.ZodString;
     }, z.core.$strip>;
     hangoutLink: z.ZodOptional<z.ZodString>;
     htmlLink: z.ZodOptional<z.ZodString>;
     id: z.ZodString;
+    location: z.ZodOptional<z.ZodString>;
     organizer: z.ZodOptional<z.ZodObject<{
         self: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strip>>;
+    recurrence: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    recurringEventId: z.ZodOptional<z.ZodString>;
     start: z.ZodObject<{
         dateTime: z.ZodString;
     }, z.core.$strip>;
     summary: z.ZodOptional<z.ZodString>;
+    updated: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
-/** Shape one event on Junior's calendar for a tool result. */
-export declare function ownEventResult(event: z.infer<typeof ownEventSchema>, timeZone: string): {
+export type OwnEvent = z.infer<typeof ownEventSchema>;
+/**
+ * Shape one event on Junior's calendar for a tool result.
+ *
+ * Core saves the Calendar event annotation and shows its card with the next
+ * reply. The event id is the key, so a change replaces the saved card. The
+ * label is the short date for the sidebar; the card shows the full time.
+ */
+export declare function ownEventResult(event: OwnEvent, timeZone: string): {
     videoCallUrl?: string | undefined;
     url?: string | undefined;
+    seriesEventId?: string | undefined;
+    repeats?: boolean | undefined;
+    location?: string | undefined;
     title?: string | undefined;
-    attendees: string[];
+    objectAnnotations: {
+        kind: "object";
+        key: string;
+        label: string;
+        objectType: "code_change" | "task" | "deployment" | "calendar_event" | "automation" | "item";
+        title: string;
+        url: string | null;
+        description?: string | undefined;
+        status?: string | undefined;
+        trigger?: string | undefined;
+        warning?: string | undefined;
+        displayType?: string | undefined;
+        sourceUpdatedAt?: string | undefined;
+        facts?: {
+            type: "code_change";
+            author?: string | undefined;
+            sourceBranch?: string | undefined;
+            targetBranch?: string | undefined;
+            reviewers?: string[] | undefined;
+            review?: "required" | "approved" | "changes_requested" | undefined;
+            checks?: {
+                passed: number;
+                failed: number;
+                pending: number;
+            } | undefined;
+            mergeable?: boolean | undefined;
+            changedFiles?: number | undefined;
+            additions?: number | undefined;
+            deletions?: number | undefined;
+        } | {
+            type: "task";
+            assignees?: string[] | undefined;
+            priority?: string | undefined;
+            project?: string | undefined;
+            cycle?: string | undefined;
+            dueDate?: string | undefined;
+            labels?: string[] | undefined;
+        } | {
+            type: "deployment";
+            project?: string | undefined;
+            environment?: string | undefined;
+            revision?: string | undefined;
+            branch?: string | undefined;
+        } | {
+            type: "calendar_event";
+            when?: string | undefined;
+            attendees?: string[] | undefined;
+        } | undefined;
+    }[];
+    attendees: {
+        email: string;
+        optional?: boolean | undefined;
+        response?: "accepted" | "declined" | "tentative" | "needsAction" | undefined;
+    }[];
     end: string;
     eventId: string;
     label: string;
@@ -74,12 +171,54 @@ export declare function ownEventResult(event: z.infer<typeof ownEventSchema>, ti
 };
 /** Output fields shared by the tools that create or change Junior's events. */
 export declare const ownEventOutputFields: {
-    attendees: z.ZodArray<z.ZodString>;
+    attendees: z.ZodArray<z.ZodObject<{
+        email: z.ZodString;
+        optional: z.ZodOptional<z.ZodBoolean>;
+        response: z.ZodOptional<z.ZodEnum<{
+            accepted: "accepted";
+            declined: "declined";
+            tentative: "tentative";
+            needsAction: "needsAction";
+        }>>;
+    }, z.core.$strip>>;
     end: z.ZodString;
     eventId: z.ZodString;
     label: z.ZodString;
+    location: z.ZodOptional<z.ZodString>;
+    repeats: z.ZodOptional<z.ZodBoolean>;
+    seriesEventId: z.ZodOptional<z.ZodString>;
     start: z.ZodString;
     title: z.ZodOptional<z.ZodString>;
     url: z.ZodOptional<z.ZodString>;
     videoCallUrl: z.ZodOptional<z.ZodString>;
 };
+/** Event id or link input for tools that act on an event Junior organizes. */
+export declare const ownEventIdSchema: z.ZodString;
+/**
+ * Return the event id from an id or a Google Calendar event link.
+ *
+ * A link's `eid` value is base64 for `<eventId> <calendar email>`.
+ */
+export declare function parseEventId(value: string): string;
+/** Result of reading an event that Junior organizes. */
+export type OwnEventRead = {
+    event: OwnEvent;
+    eventId: string;
+    path: string;
+    status: "active";
+} | {
+    eventId: string;
+    path: string;
+    status: "cancelled";
+};
+/**
+ * Read an event that Junior organizes, for a requester who is invited to it.
+ *
+ * Only invited people may change or cancel an event. This keeps one requester
+ * from moving or cancelling a meeting that Junior set up for others.
+ *
+ * A deleted event on Junior's calendar comes back as `cancelled`. Google
+ * returns it as HTTP 410, or as a stub with only `id` and `status`, so it has
+ * no organizer or attendees to check. Callers must not change it.
+ */
+export declare function readOwnEventForRequester(ctx: GoogleToolContext, eventIdOrLink: string, action: "change" | "cancel"): Promise<OwnEventRead>;

package/dist/tools/update-event.d.ts

@@ -2,21 +2,27 @@ import { type GoogleToolContext } from "./shared";
 /**
  * Change an event that Junior organizes and email the attendees.
  *
- * Only people already invited to the event may change it. This keeps one
- * requester from moving or rewriting a meeting that Junior set up for others.
+ * Only people already invited to the event may change it.
  */
 export declare function createUpdateCalendarEventTool(ctx: GoogleToolContext): import("@sentry/junior-plugin-api").PluginToolDefinition<{
     eventId: string;
-    timeZone: string;
     addAttendees: string[];
+    addOptionalAttendees: string[];
     removeAttendees: string[];
     title?: string | undefined;
     description?: string | undefined;
     start?: string | undefined;
     end?: string | undefined;
+    timeZone?: string | undefined;
+    location?: string | undefined;
+    addVideoCall?: true | undefined;
 }, {
     [x: string]: unknown;
-    attendees: string[];
+    attendees: {
+        email: string;
+        optional?: boolean | undefined;
+        response?: "accepted" | "declined" | "tentative" | "needsAction" | undefined;
+    }[];
     end: string;
     eventId: string;
     label: string;
@@ -26,7 +32,7 @@ export declare function createUpdateCalendarEventTool(ctx: GoogleToolContext): i
         kind: "object";
         key: string;
         label: string;
-        objectType: "code_change" | "task" | "deployment" | "automation" | "item";
+        objectType: "code_change" | "task" | "deployment" | "calendar_event" | "automation" | "item";
         title: string;
         url: string | null;
         description?: string | undefined;
@@ -65,6 +71,10 @@ export declare function createUpdateCalendarEventTool(ctx: GoogleToolContext): i
             environment?: string | undefined;
             revision?: string | undefined;
             branch?: string | undefined;
+        } | {
+            type: "calendar_event";
+            when?: string | undefined;
+            attendees?: string[] | undefined;
         } | undefined;
     }[] | undefined;
     truncated?: boolean | undefined;
@@ -72,12 +82,19 @@ export declare function createUpdateCalendarEventTool(ctx: GoogleToolContext): i
         arguments: Record<string, unknown>;
         reason?: string | undefined;
     } | undefined;
+    location?: string | undefined;
+    repeats?: boolean | undefined;
+    seriesEventId?: string | undefined;
     title?: string | undefined;
     url?: string | undefined;
     videoCallUrl?: string | undefined;
 }, {
     [x: string]: unknown;
-    attendees: string[];
+    attendees: {
+        email: string;
+        optional?: boolean | undefined;
+        response?: "accepted" | "declined" | "tentative" | "needsAction" | undefined;
+    }[];
     end: string;
     eventId: string;
     label: string;
@@ -87,7 +104,7 @@ export declare function createUpdateCalendarEventTool(ctx: GoogleToolContext): i
         kind: "object";
         key: string;
         label: string;
-        objectType: "code_change" | "task" | "deployment" | "automation" | "item";
+        objectType: "code_change" | "task" | "deployment" | "calendar_event" | "automation" | "item";
         title: string;
         url: string | null;
         description?: string | undefined;
@@ -126,6 +143,10 @@ export declare function createUpdateCalendarEventTool(ctx: GoogleToolContext): i
             environment?: string | undefined;
             revision?: string | undefined;
             branch?: string | undefined;
+        } | {
+            type: "calendar_event";
+            when?: string | undefined;
+            attendees?: string[] | undefined;
         } | undefined;
     }[] | undefined;
     truncated?: boolean | undefined;
@@ -133,6 +154,9 @@ export declare function createUpdateCalendarEventTool(ctx: GoogleToolContext): i
         arguments: Record<string, unknown>;
         reason?: string | undefined;
     } | undefined;
+    location?: string | undefined;
+    repeats?: boolean | undefined;
+    seriesEventId?: string | undefined;
     title?: string | undefined;
     url?: string | undefined;
     videoCallUrl?: string | undefined;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sentry/junior-google",
-  "version": "0.238.1",
+  "version": "0.240.0",
   "private": false,
   "publishConfig": {
     "access": "public"
@@ -25,7 +25,7 @@
     "commander": "^14.0.3",
     "drizzle-orm": "^0.45.2",
     "zod": "^4.5.4",
-    "@sentry/junior-plugin-api": "0.238.1"
+    "@sentry/junior-plugin-api": "0.240.0"
   },
   "devDependencies": {
     "@oxlint/plugins": "1.79.0",