@sentry/junior-google 0.243.0 → 0.245.0

package/dist/tools/files.d.ts

@@ -0,0 +1,76 @@
+import { z } from "zod";
+import type { GoogleOperation } from "../credentials";
+import { type GoogleToolContext } from "./shared";
+/** Google file types that the tools read, with their Drive MIME types. */
+declare const FILE_TYPES: {
+    readonly document: {
+        readonly label: "Google Doc";
+        readonly mimeType: "application/vnd.google-apps.document";
+    };
+    readonly presentation: {
+        readonly label: "Google Slides presentation";
+        readonly mimeType: "application/vnd.google-apps.presentation";
+    };
+    readonly spreadsheet: {
+        readonly label: "Google Sheet";
+        readonly mimeType: "application/vnd.google-apps.spreadsheet";
+    };
+};
+export type GoogleFileType = keyof typeof FILE_TYPES;
+export declare const GOOGLE_FILE_TYPES: GoogleFileType[];
+/** Return the Drive MIME type of one file type. */
+export declare function googleFileMimeType(type: GoogleFileType): string;
+/** Return the file type of a Drive MIME type, when the tools read it. */
+export declare function googleFileType(mimeType: string): GoogleFileType | undefined;
+/** File id or link input for the tools that use one file. */
+export declare function fileReferenceSchema(name: string): z.ZodString;
+/** One Drive file, and the resource key that a link-shared file can need. */
+export interface FileReference {
+    fileId: string;
+    resourceKey?: string;
+}
+/**
+ * Return the file id and resource key from a file id or link.
+ *
+ * Links look like `docs.google.com/document/d/<id>/edit`,
+ * `docs.google.com/spreadsheets/d/<id>/edit`,
+ * `docs.google.com/presentation/d/<id>/edit`,
+ * `drive.google.com/file/d/<id>/view`, or `drive.google.com/open?id=<id>`.
+ * Older files shared by link also need the link's `resourcekey` value.
+ */
+export declare function parseFileReference(value: string): FileReference;
+/** Call one Google operation on a file, with its resource key when known. */
+export declare function googleFileRequest(ctx: GoogleToolContext, file: FileReference, input: {
+    headers?: Record<string, string>;
+    operation: GoogleOperation;
+    path: string;
+    query?: Record<string, string | string[]>;
+}): Promise<{
+    body: unknown;
+    status: number;
+}>;
+/**
+ * Read the Drive metadata of one file, and require one of the given types.
+ *
+ * `drive.readonly` can read any Drive file, so each tool checks the type
+ * before it reads content or comments.
+ */
+export declare function readGoogleFile(ctx: GoogleToolContext, file: FileReference, types: readonly GoogleFileType[]): Promise<{
+    type: "document" | "presentation" | "spreadsheet";
+    id: string;
+    mimeType: string;
+    name: string;
+    modifiedTime?: string | undefined;
+    webViewLink?: string | undefined;
+}>;
+/** Optional output fields shared by the tools that read one file. */
+export declare function fileOutputFields(file: {
+    modifiedTime?: string;
+    webViewLink?: string;
+}): {
+    url?: string | undefined;
+    modifiedTime?: string | undefined;
+};
+/** Longest file text that one tool result returns. */
+export declare const MAX_CONTENT_CHARS = 100000;
+export {};

package/dist/tools/{list-doc-comments.d.ts → list-file-comments.d.ts}

@@ -1,11 +1,11 @@
 import type { GoogleToolContext } from "./shared";
-/** List the comments and replies on one Google Doc. */
-export declare function createListGoogleDocCommentsTool(ctx: GoogleToolContext): import("@sentry/junior-plugin-api").PluginToolDefinition<{
-    document: string;
+/** List the comments and replies on one Google Doc, Sheet, or Slides file. */
+export declare function createListGoogleFileCommentsTool(ctx: GoogleToolContext): import("@sentry/junior-plugin-api").PluginToolDefinition<{
+    file: string;
     pageToken?: string | undefined;
 }, {
     [x: string]: unknown;
-    target: "listGoogleDocComments";
+    target: "listGoogleFileComments";
     comments: {
         commentId: string;
         content: string;
@@ -20,7 +20,7 @@ export declare function createListGoogleDocCommentsTool(ctx: GoogleToolContext):
         createdTime?: string | undefined;
         quotedText?: string | undefined;
     }[];
-    documentId: string;
+    fileId: string;
     objectAnnotations?: {
         kind: "object";
         key: string;
@@ -78,7 +78,7 @@ export declare function createListGoogleDocCommentsTool(ctx: GoogleToolContext):
     nextPageToken?: string | undefined;
 }, {
     [x: string]: unknown;
-    target: "listGoogleDocComments";
+    target: "listGoogleFileComments";
     comments: {
         commentId: string;
         content: string;
@@ -93,7 +93,7 @@ export declare function createListGoogleDocCommentsTool(ctx: GoogleToolContext):
         createdTime?: string | undefined;
         quotedText?: string | undefined;
     }[];
-    documentId: string;
+    fileId: string;
     objectAnnotations?: {
         kind: "object";
         key: string;

package/dist/tools/read-doc.d.ts

@@ -3,7 +3,7 @@ import type { GoogleToolContext } from "./shared";
  * Read one Google Doc as Markdown.
  *
  * Drive exports the Doc, so this needs no Docs API. Comments are not in the
- * export; `listGoogleDocComments` reads them.
+ * export; `listGoogleFileComments` reads them.
  */
 export declare function createReadGoogleDocTool(ctx: GoogleToolContext): import("@sentry/junior-plugin-api").PluginToolDefinition<{
     document: string;

package/dist/tools/read-sheet.d.ts

@@ -0,0 +1,145 @@
+import type { GoogleToolContext } from "./shared";
+/**
+ * Read the cells of one Google Sheet as CSV, one entry per range.
+ *
+ * A Drive CSV export has only the first tab, so this uses the Sheets API. It
+ * accepts the same `drive.readonly` scope as the Drive tools.
+ */
+export declare function createReadGoogleSheetTool(ctx: GoogleToolContext): import("@sentry/junior-plugin-api").PluginToolDefinition<{
+    spreadsheet: string;
+    range?: string | undefined;
+}, {
+    [x: string]: unknown;
+    target: "readGoogleSheet";
+    ranges: {
+        content: string;
+        range: string;
+        truncated: boolean;
+    }[];
+    spreadsheetId: string;
+    tabs: string[];
+    title: string;
+    truncated: boolean;
+    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;
+    }[] | undefined;
+    continuation?: {
+        arguments: Record<string, unknown>;
+        reason?: string | undefined;
+    } | undefined;
+    modifiedTime?: string | undefined;
+    url?: string | undefined;
+}, {
+    [x: string]: unknown;
+    target: "readGoogleSheet";
+    ranges: {
+        content: string;
+        range: string;
+        truncated: boolean;
+    }[];
+    spreadsheetId: string;
+    tabs: string[];
+    title: string;
+    truncated: boolean;
+    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;
+    }[] | undefined;
+    continuation?: {
+        arguments: Record<string, unknown>;
+        reason?: string | undefined;
+    } | undefined;
+    modifiedTime?: string | undefined;
+    url?: string | undefined;
+}>;

package/dist/tools/read-slides.d.ts

@@ -0,0 +1,144 @@
+import type { GoogleToolContext } from "./shared";
+/**
+ * Read the text and speaker notes of each slide in one Google Slides file.
+ *
+ * This uses the Slides API to keep slide numbers and speaker notes. It
+ * accepts the same `drive.readonly` scope as the Drive tools.
+ */
+export declare function createReadGoogleSlidesTool(ctx: GoogleToolContext): import("@sentry/junior-plugin-api").PluginToolDefinition<{
+    presentation: string;
+}, {
+    [x: string]: unknown;
+    target: "readGoogleSlides";
+    presentationId: string;
+    slideCount: number;
+    slides: {
+        slideNumber: number;
+        text: string;
+        notes?: string | undefined;
+    }[];
+    title: string;
+    truncated: boolean;
+    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;
+    }[] | undefined;
+    continuation?: {
+        arguments: Record<string, unknown>;
+        reason?: string | undefined;
+    } | undefined;
+    modifiedTime?: string | undefined;
+    url?: string | undefined;
+}, {
+    [x: string]: unknown;
+    target: "readGoogleSlides";
+    presentationId: string;
+    slideCount: number;
+    slides: {
+        slideNumber: number;
+        text: string;
+        notes?: string | undefined;
+    }[];
+    title: string;
+    truncated: boolean;
+    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;
+    }[] | undefined;
+    continuation?: {
+        arguments: Record<string, unknown>;
+        reason?: string | undefined;
+    } | undefined;
+    modifiedTime?: string | undefined;
+    url?: string | undefined;
+}>;

package/dist/tools/{search-docs.d.ts → search-files.d.ts}

@@ -1,14 +1,16 @@
 import { type GoogleToolContext } from "./shared";
-/** Find Google Docs that Junior's account can open, by title or text. */
-export declare function createSearchGoogleDocsTool(ctx: GoogleToolContext): import("@sentry/junior-plugin-api").PluginToolDefinition<{
+/** Find Docs, Sheets, and Slides that Junior's account can open. */
+export declare function createSearchGoogleFilesTool(ctx: GoogleToolContext): import("@sentry/junior-plugin-api").PluginToolDefinition<{
     query: string;
     maxResults: number;
+    types?: ("document" | "presentation" | "spreadsheet")[] | undefined;
 }, {
     [x: string]: unknown;
-    target: "searchGoogleDocs";
-    documents: {
-        documentId: string;
+    target: "searchGoogleFiles";
+    files: {
+        fileId: string;
         title: string;
+        type: "document" | "presentation" | "spreadsheet";
         modifiedTime?: string | undefined;
         url?: string | undefined;
     }[];
@@ -68,10 +70,11 @@ export declare function createSearchGoogleDocsTool(ctx: GoogleToolContext): impo
     } | undefined;
 }, {
     [x: string]: unknown;
-    target: "searchGoogleDocs";
-    documents: {
-        documentId: string;
+    target: "searchGoogleFiles";
+    files: {
+        fileId: string;
         title: string;
+        type: "document" | "presentation" | "spreadsheet";
         modifiedTime?: string | undefined;
         url?: string | undefined;
     }[];

package/dist/tools/shared.d.ts

@@ -38,7 +38,8 @@ export declare function googleApiRequest(ctx: GoogleToolContext, input: {
     headers?: Record<string, string>;
     operation: GoogleOperation;
     path: string;
-    query?: Record<string, string>;
+    /** A list value repeats the parameter, as Sheets `ranges` needs. */
+    query?: Record<string, string | string[]>;
 }): Promise<{
     body: unknown;
     status: number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sentry/junior-google",
-  "version": "0.243.0",
+  "version": "0.245.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.243.0"
+    "@sentry/junior-plugin-api": "0.245.0"
   },
   "devDependencies": {
     "@oxlint/plugins": "1.79.0",

package/dist/tools/docs.d.ts

@@ -1,37 +0,0 @@
-import { z } from "zod";
-import type { GoogleOperation } from "../credentials";
-import { type GoogleToolContext } from "./shared";
-export declare const GOOGLE_DOC_MIME_TYPE = "application/vnd.google-apps.document";
-/** Doc id or link input for the tools that read one Doc. */
-export declare const docReferenceSchema: z.ZodString;
-/** One Drive file, and the resource key that a link-shared file can need. */
-export interface DocReference {
-    fileId: string;
-    resourceKey?: string;
-}
-/**
- * Return the file id and resource key from a Doc id or link.
- *
- * Links look like `docs.google.com/document/d/<id>/edit`,
- * `drive.google.com/file/d/<id>/view`, or `drive.google.com/open?id=<id>`.
- * Older Docs shared by link also need the link's `resourcekey` value.
- */
-export declare function parseDocReference(value: string): DocReference;
-/** Call one Drive operation on a file, with its resource key when known. */
-export declare function driveFileRequest(ctx: GoogleToolContext, doc: DocReference, input: {
-    headers?: Record<string, string>;
-    operation: GoogleOperation;
-    path: string;
-    query?: Record<string, string>;
-}): Promise<{
-    body: unknown;
-    status: number;
-}>;
-/** Read the Drive metadata of one file, and require it to be a Google Doc. */
-export declare function readDocFile(ctx: GoogleToolContext, doc: DocReference): Promise<{
-    id: string;
-    mimeType: string;
-    name: string;
-    modifiedTime?: string | undefined;
-    webViewLink?: string | undefined;
-}>;