bn-google-workspace-mcp-server 0.0.1

package/dist/schemas.js

@@ -0,0 +1,611 @@
+/**
+ * Zod schemas for all Google Workspace MCP tools
+ * Each schema includes comprehensive .describe() annotations for LLM understanding
+ *
+ * These descriptions are designed to help LLMs understand:
+ * - When to use each tool
+ * - What parameters are available and their exact syntax
+ * - Examples of common use cases
+ * - Relationships between tools (e.g., get IDs from list tools to use in detail tools)
+ */
+import { z } from "zod";
+// ============================================================================
+// GMAIL TOOLS (4 tools)
+// ============================================================================
+/**
+ * Schema for gmail_list_labels tool
+ * Lists all Gmail labels in the user's mailbox
+ */
+export const GmailListLabelsSchema = z.object({}).describe("List all Gmail labels in the user's mailbox. Use this tool to discover available labels before filtering emails by label. Returns both system labels (INBOX, SENT, DRAFT, SPAM, TRASH, STARRED, IMPORTANT, CATEGORY_PERSONAL, CATEGORY_SOCIAL, CATEGORY_PROMOTIONS, CATEGORY_UPDATES, CATEGORY_FORUMS) and custom user-created labels. The returned label IDs can be used with gmail_search_messages using the 'label:' operator.");
+/**
+ * Schema for gmail_search_messages tool
+ * Search Gmail messages using Gmail search operators
+ */
+export const GmailSearchMessagesSchema = z.object({
+    query: z
+        .string()
+        .optional()
+        .describe(`Gmail search query using Gmail's powerful search operators. Leave empty to list recent messages.
+
+SEARCH OPERATORS (combine multiple with spaces for AND logic, use OR for alternatives):
+
+**Sender/Recipient:**
+- from:sender@example.com - Messages from specific sender
+- to:recipient@example.com - Messages sent to specific recipient
+- cc:user@example.com - Messages where user is CC'd
+- bcc:user@example.com - Messages where user is BCC'd
+- deliveredto:me@example.com - Delivered to specific address
+
+**Labels & Categories:**
+- label:INBOX - Messages in inbox
+- label:SENT - Sent messages
+- label:STARRED - Starred messages
+- label:IMPORTANT - Important messages
+- label:custom-label - Messages with custom label (use exact label name)
+- category:primary - Primary inbox category
+- category:social - Social category
+- category:promotions - Promotions category
+- category:updates - Updates category
+- category:forums - Forums category
+- in:anywhere - Search all mail including spam and trash
+
+**Status:**
+- is:unread - Unread messages
+- is:read - Read messages
+- is:starred - Starred messages
+- is:important - Marked important
+- is:snoozed - Snoozed messages
+
+**Attachments:**
+- has:attachment - Has any attachment
+- has:drive - Has Google Drive attachment
+- has:document - Has Google Docs attachment
+- has:spreadsheet - Has Google Sheets attachment
+- has:presentation - Has Google Slides attachment
+- has:youtube - Has YouTube video
+- filename:pdf - Has attachment with specific extension
+- filename:report.xlsx - Has attachment with specific filename
+
+**Content:**
+- subject:meeting - Word in subject line
+- "exact phrase" - Exact phrase match (use quotes)
+- word1 word2 - Both words anywhere in message (AND)
+- word1 OR word2 - Either word (must use uppercase OR)
+- -word - Exclude messages containing word
+- +word - Exact word match (no synonyms)
+
+**Size:**
+- larger:10M - Larger than 10 megabytes
+- smaller:1M - Smaller than 1 megabyte
+- size:5M - Approximately 5 megabytes
+
+**Dates:**
+- after:2024/01/15 - Messages after date (YYYY/MM/DD)
+- before:2024/12/31 - Messages before date
+- older_than:7d - Older than 7 days
+- newer_than:3d - Newer than 3 days
+- older_than:1m - Older than 1 month
+- older_than:1y - Older than 1 year
+
+**Thread:**
+- in:inbox - In inbox (not archived)
+- in:trash - In trash
+- in:spam - In spam folder
+- in:sent - In sent folder
+- in:draft - Draft messages
+- in:chats - Chat messages
+
+**EXAMPLE QUERIES:**
+- "from:boss@company.com is:unread" - Unread emails from boss
+- "has:attachment filename:pdf after:2024/01/01" - PDFs received this year
+- "subject:invoice from:accounting@company.com" - Invoices from accounting
+- "is:starred label:important" - Starred and important messages
+- "larger:5M has:attachment" - Large attachments
+- "from:@amazon.com subject:order" - Amazon order confirmations
+- "to:me -category:promotions newer_than:7d" - Recent non-promotional emails to me`),
+    maxResults: z
+        .number()
+        .int()
+        .positive()
+        .max(500)
+        .optional()
+        .default(10)
+        .describe("Maximum number of messages to return (1-500, default: 10). Note: For performance, only the first 5 messages include detailed headers (subject, from, snippet). For full message content including body text, use gmail_get_message_content with the returned message ID."),
+});
+/**
+ * Schema for gmail_get_message_content tool
+ * Get detailed information about a specific Gmail message
+ */
+export const GmailGetMessageContentSchema = z.object({
+    messageId: z
+        .string()
+        .describe("The unique Gmail message ID (alphanumeric string like '18d4a2b3c4d5e6f7'). IMPORTANT: First use gmail_search_messages to find messages and obtain their IDs. This tool returns the complete message including: full headers (Subject, From, To, Date, CC, BCC), complete body content (plain text extracted from the message), thread ID for related messages, and all metadata."),
+});
+/**
+ * Schema for gmail_send_message tool
+ * Send an email via Gmail
+ */
+export const GmailSendMessageSchema = z.object({
+    to: z
+        .string()
+        .describe("Recipient email address in standard format. Examples: 'user@example.com' for single recipient. For multiple recipients, send separate messages or use comma-separated addresses."),
+    subject: z
+        .string()
+        .describe("Email subject line. Plain text only (no HTML tags). Best practices: Keep under 60 characters for full visibility in email clients. Avoid spam trigger words in all caps. Be specific and descriptive."),
+    body: z
+        .string()
+        .describe("Email body content in plain text format. Line breaks are preserved. For basic formatting, use plain text conventions: *asterisks* for emphasis, - or * for bullet points, numbered lists with 1. 2. 3., and clear paragraph breaks with double newlines. HTML is not supported in this version."),
+});
+// ============================================================================
+// DRIVE TOOLS (3 tools)
+// ============================================================================
+/**
+ * Schema for drive_list_files tool
+ * List Google Drive files
+ */
+export const DriveListFilesSchema = z.object({
+    query: z
+        .string()
+        .optional()
+        .describe(`Google Drive search query to filter files. Leave empty to list all recent files.
+
+SEARCH SYNTAX (Google Drive Query Language):
+
+**By Name:**
+- name contains 'budget' - Files with 'budget' in name
+- name = 'Quarterly Report' - Exact file name match
+- fullText contains 'deadline' - Search file contents (Google Docs, Sheets, Slides, PDFs)
+
+**By File Type (mimeType):**
+- mimeType = 'application/vnd.google-apps.document' - Google Docs
+- mimeType = 'application/vnd.google-apps.spreadsheet' - Google Sheets
+- mimeType = 'application/vnd.google-apps.presentation' - Google Slides
+- mimeType = 'application/vnd.google-apps.folder' - Folders
+- mimeType = 'application/pdf' - PDF files
+- mimeType contains 'image/' - All image files
+- mimeType contains 'video/' - All video files
+- mimeType = 'application/vnd.openxmlformats-officedocument.wordprocessingml.document' - Word docs (.docx)
+- mimeType = 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet' - Excel files (.xlsx)
+
+**By Location:**
+- 'FOLDER_ID' in parents - Files in specific folder (get folder ID from URL or previous search)
+- 'root' in parents - Files in My Drive root
+- sharedWithMe = true - Files shared with me
+- not 'FOLDER_ID' in parents - Files NOT in specific folder
+
+**By Owner/Sharing:**
+- 'user@example.com' in owners - Files owned by specific user
+- 'user@example.com' in writers - Files user can edit
+- 'user@example.com' in readers - Files user can view
+
+**By Date:**
+- modifiedTime > '2024-01-01T00:00:00' - Modified after date (RFC 3339)
+- createdTime > '2024-06-01T00:00:00' - Created after date
+- viewedByMeTime > '2024-01-01T00:00:00' - Viewed by me after date
+- modifiedTime >= '2024-01-01' and modifiedTime < '2024-02-01' - Modified in date range
+
+**By Status:**
+- starred = true - Starred files
+- trashed = true - Files in trash
+- trashed = false - Files not in trash (default behavior)
+
+**Combining Conditions:**
+- Use 'and' to combine: name contains 'report' and mimeType = 'application/vnd.google-apps.document'
+- Use 'or' for alternatives: mimeType = 'application/pdf' or mimeType contains 'image/'
+- Use 'not' for negation: not mimeType = 'application/vnd.google-apps.folder'
+
+**EXAMPLE QUERIES:**
+- "name contains 'Q4' and mimeType = 'application/vnd.google-apps.spreadsheet'" - Q4 spreadsheets
+- "fullText contains 'project deadline'" - Files mentioning project deadline
+- "modifiedTime > '2024-12-01T00:00:00' and mimeType = 'application/vnd.google-apps.document'" - Recent Google Docs
+- "sharedWithMe = true and mimeType contains 'image/'" - Images shared with me
+- "starred = true" - All starred files
+- "'root' in parents and mimeType = 'application/vnd.google-apps.folder'" - Folders in My Drive root
+
+**SIMPLE SEARCH (if you don't need query syntax):**
+Just enter a search term like 'budget' and it will be automatically converted to: name contains 'budget'`),
+    maxResults: z
+        .number()
+        .int()
+        .positive()
+        .max(1000)
+        .optional()
+        .default(10)
+        .describe("Maximum number of files to return (1-1000, default: 10). Results are sorted by most recently modified. Returns file ID, name, MIME type, modification time, size, and web view link for each file."),
+});
+/**
+ * Schema for drive_get_file_content tool
+ * Get Google Drive file content
+ */
+export const DriveGetFileContentSchema = z.object({
+    fileId: z
+        .string()
+        .describe(`The unique Google Drive file ID. How to obtain:
+
+1. **From drive_list_files**: Search for files and use the returned 'id' field
+2. **From URL**: Extract from the file URL pattern:
+   - Google Docs: docs.google.com/document/d/{fileId}/edit
+   - Google Sheets: docs.google.com/spreadsheets/d/{fileId}/edit
+   - Google Slides: docs.google.com/presentation/d/{fileId}/edit
+   - Google Drive: drive.google.com/file/d/{fileId}/view
+
+**Supported file types for content reading:**
+- Text files (.txt, .md, .csv, .json, .xml, .html, .css, .js, etc.)
+- Google Docs (exported as plain text)
+- PDF files (text extraction)
+
+**Not directly readable** (use specific tools instead):
+- Google Sheets → Use sheets_read_values tool
+- Google Slides → Use slides_get_presentation tool
+- Google Docs → Use docs_get_document tool for better formatting
+- Binary files (images, videos, archives)`),
+});
+/**
+ * Schema for drive_create_file tool
+ * Create a new file in Google Drive
+ */
+export const DriveCreateFileSchema = z.object({
+    name: z
+        .string()
+        .describe("Filename including extension. Examples: 'meeting-notes.txt', 'report.md', 'data.csv', 'config.json'. The extension determines how the file is handled. Avoid special characters: < > : \" / \\ | ? * as they may cause issues."),
+    content: z
+        .string()
+        .describe("Text content for the file. The file is created as plain text (MIME type: text/plain). For structured data, format appropriately: use CSV format for tabular data, JSON for structured objects, Markdown for formatted documents."),
+    parentFolderId: z
+        .string()
+        .optional()
+        .describe("Google Drive folder ID where the file should be created. If omitted, file is created in 'My Drive' root. To get folder ID: use drive_list_files with query \"mimeType = 'application/vnd.google-apps.folder'\" or extract from folder URL: drive.google.com/drive/folders/{folderId}"),
+});
+// ============================================================================
+// CALENDAR TOOLS (3 tools)
+// ============================================================================
+/**
+ * Schema for calendar_list_events tool
+ * List Google Calendar events
+ */
+export const CalendarListEventsSchema = z.object({
+    maxResults: z
+        .number()
+        .int()
+        .positive()
+        .max(2500)
+        .optional()
+        .default(10)
+        .describe("Maximum number of upcoming events to return (1-2500, default: 10). Events are sorted chronologically by start time. Only future events from the current moment are returned. For past events, you would need to specify a timeMin parameter (not yet supported in this version)."),
+    calendarId: z
+        .string()
+        .optional()
+        .default("primary")
+        .describe(`Calendar to list events from. Options:
+
+- 'primary' (default) - User's main/default calendar
+- Specific calendar ID - Use the ID returned from calendar_list_calendars
+
+**Common calendar IDs:**
+- primary - User's primary calendar
+- user@example.com - Calendar for specific Google account
+- calendar_id@group.calendar.google.com - Shared/secondary calendars
+- addressbook#contacts@group.v.calendar.google.com - Contacts' birthdays
+- en.usa#holiday@group.v.calendar.google.com - US Holidays
+
+First use calendar_list_calendars to discover available calendars and their IDs.`),
+});
+/**
+ * Schema for calendar_list_calendars tool
+ * List all calendars accessible to the user
+ */
+export const CalendarListCalendarsSchema = z.object({}).describe("List all Google Calendars accessible to the user. Returns calendar ID, name, description, time zone, and whether it's the primary calendar. Use this to discover: user's own calendars, shared team calendars, subscribed calendars (holidays, sports, etc.), and resource calendars (meeting rooms). The returned calendar IDs can be used with calendar_list_events and calendar_create_event.");
+/**
+ * Schema for calendar_create_event tool
+ * Create a new calendar event
+ */
+export const CalendarCreateEventSchema = z.object({
+    summary: z
+        .string()
+        .describe("Event title displayed on the calendar. Best practices: Be descriptive but concise (e.g., 'Q4 Planning Meeting' not just 'Meeting'). Include key context like project name or team if relevant."),
+    startTime: z
+        .string()
+        .describe(`Event start time. Two formats supported:
+
+**For timed events (specific time):**
+ISO 8601 format with timezone offset or UTC:
+- '2024-12-25T09:00:00-05:00' (with timezone offset, EST)
+- '2024-12-25T14:00:00Z' (UTC)
+- '2024-12-25T09:00:00+01:00' (with timezone offset, CET)
+
+**For all-day events:**
+Date only format:
+- '2024-12-25' (starts at midnight in calendar's timezone)
+
+**Timezone offset reference:**
+- UTC/GMT: +00:00 or Z
+- US Eastern: -05:00 (EST) or -04:00 (EDT)
+- US Central: -06:00 (CST) or -05:00 (CDT)
+- US Pacific: -08:00 (PST) or -07:00 (PDT)
+- Europe Central: +01:00 (CET) or +02:00 (CEST)
+- Asia Tokyo: +09:00 (JST)`),
+    endTime: z
+        .string()
+        .describe(`Event end time. Must be after startTime and use the same format:
+
+**For timed events:** ISO 8601 format matching startTime's format
+- Example: '2024-12-25T10:00:00-05:00' (1-hour meeting)
+
+**For all-day events:** Date format (YYYY-MM-DD)
+- IMPORTANT: The end date is exclusive. For a single all-day event on Dec 25th, use:
+  startTime: '2024-12-25', endTime: '2024-12-26'
+- For a 3-day event (Dec 25-27):
+  startTime: '2024-12-25', endTime: '2024-12-28'`),
+    description: z
+        .string()
+        .optional()
+        .describe("Event description/notes. Appears in the event details when opened. Plain text format. Good for: meeting agenda, dial-in information, links to documents, preparation notes, or any additional context attendees need."),
+    calendarId: z
+        .string()
+        .optional()
+        .default("primary")
+        .describe("Calendar to create the event in. Default: 'primary' (user's main calendar). Use calendar_list_calendars to find other calendar IDs for shared or secondary calendars."),
+});
+// ============================================================================
+// DOCS TOOLS (2 tools)
+// ============================================================================
+/**
+ * Schema for docs_get_document tool
+ * Get Google Docs document content
+ */
+export const DocsGetDocumentSchema = z.object({
+    documentId: z
+        .string()
+        .describe(`The unique Google Docs document ID. How to obtain:
+
+1. **From drive_list_files**: Search for Google Docs using query "mimeType = 'application/vnd.google-apps.document'" and use the returned file ID
+2. **From document URL**: Extract the ID from the URL pattern:
+   docs.google.com/document/d/{documentId}/edit
+
+**Example URL:** docs.google.com/document/d/1AbCdEfGhIjKlMnOpQrStUvWxYz/edit
+**Document ID:** 1AbCdEfGhIjKlMnOpQrStUvWxYz
+
+Returns: Document title and full text content extracted from all paragraphs. Note: Complex formatting (tables, images, drawings) may not be fully represented in the extracted text.`),
+});
+/**
+ * Schema for docs_create_document tool
+ * Create a new Google Docs document
+ */
+export const DocsCreateDocumentSchema = z.object({
+    title: z
+        .string()
+        .describe("Title for the new Google Doc. This becomes the document name in Google Drive and appears at the top of the document. Choose a descriptive name for easy discovery later."),
+    content: z
+        .string()
+        .optional()
+        .describe("Initial text content to add to the document. Plain text format - the content is inserted at the beginning of the document. If omitted, creates an empty document. For complex formatting, create the document first, then use Google Docs directly to format."),
+});
+// ============================================================================
+// SHEETS TOOLS (3 tools)
+// ============================================================================
+/**
+ * Schema for sheets_get_spreadsheet tool
+ * Get Google Sheets spreadsheet information
+ */
+export const SheetsGetSpreadsheetSchema = z.object({
+    spreadsheetId: z
+        .string()
+        .describe(`The unique Google Sheets spreadsheet ID. How to obtain:
+
+1. **From drive_list_files**: Search using query "mimeType = 'application/vnd.google-apps.spreadsheet'" and use the returned file ID
+2. **From spreadsheet URL**: Extract from the URL pattern:
+   docs.google.com/spreadsheets/d/{spreadsheetId}/edit
+
+**Example URL:** docs.google.com/spreadsheets/d/1AbCdEfGhIjKlMnOpQrStUvWxYz/edit#gid=0
+**Spreadsheet ID:** 1AbCdEfGhIjKlMnOpQrStUvWxYz
+
+Returns: Spreadsheet title and list of all sheets (tabs) with their sheet IDs and names. Use sheet names with sheets_read_values to read data from specific sheets.`),
+});
+/**
+ * Schema for sheets_read_values tool
+ * Read values from a Google Sheets range
+ */
+export const SheetsReadValuesSchema = z.object({
+    spreadsheetId: z
+        .string()
+        .describe("The spreadsheet ID (see sheets_get_spreadsheet for how to obtain). Required to identify which spreadsheet to read from."),
+    range: z
+        .string()
+        .describe(`Cell range to read in A1 notation. Returns values as a 2D array (rows × columns).
+
+**A1 NOTATION SYNTAX:**
+
+**Basic ranges:**
+- 'A1' - Single cell A1
+- 'A1:C3' - Rectangle from A1 to C3 (3 rows × 3 columns)
+- 'A:A' - Entire column A
+- '1:1' - Entire row 1
+- 'A:C' - Columns A through C
+- '1:5' - Rows 1 through 5
+
+**With sheet name (required for multi-sheet spreadsheets):**
+- 'Sheet1!A1:C10' - Range in sheet named "Sheet1"
+- 'Sales Data!A:B' - Columns A-B in sheet named "Sales Data"
+- "'Sheet Name With Spaces'!A1:B5" - Use quotes for sheet names with spaces
+
+**Open-ended ranges:**
+- 'A1:A' - Column A starting from row 1 to end of data
+- 'A1:1' - Row 1 starting from column A to end of data
+- 'Sheet1!A:A' - Entire column A in Sheet1
+
+**EXAMPLE SCENARIOS:**
+- Read headers: 'Sheet1!1:1' (first row)
+- Read first column: 'Sheet1!A:A'
+- Read data table: 'Sheet1!A1:D100' (adjust range to your data)
+- Read all data: 'Sheet1!A:Z' (reads columns A-Z with data)
+
+**TIPS:**
+- First use sheets_get_spreadsheet to see available sheet names
+- Start with a larger range than needed - empty cells return empty strings
+- Row 1 typically contains headers in most spreadsheets`),
+});
+/**
+ * Schema for sheets_create_spreadsheet tool
+ * Create a new Google Sheets spreadsheet
+ */
+export const SheetsCreateSpreadsheetSchema = z.object({
+    title: z
+        .string()
+        .describe("Title for the new spreadsheet. This becomes the filename in Google Drive. The spreadsheet is created with one empty sheet named 'Sheet1'. After creation, use the Google Sheets UI or API to add data and additional sheets."),
+});
+// ============================================================================
+// SLIDES TOOLS (2 tools)
+// ============================================================================
+/**
+ * Schema for slides_get_presentation tool
+ * Get Google Slides presentation information
+ */
+export const SlidesGetPresentationSchema = z.object({
+    presentationId: z
+        .string()
+        .describe(`The unique Google Slides presentation ID. How to obtain:
+
+1. **From drive_list_files**: Search using query "mimeType = 'application/vnd.google-apps.presentation'" and use the returned file ID
+2. **From presentation URL**: Extract from the URL pattern:
+   docs.google.com/presentation/d/{presentationId}/edit
+
+**Example URL:** docs.google.com/presentation/d/1AbCdEfGhIjKlMnOpQrStUvWxYz/edit
+**Presentation ID:** 1AbCdEfGhIjKlMnOpQrStUvWxYz
+
+Returns: Presentation title, slide count, and list of slides with their object IDs and layout references. Note: Full slide content (text, images, shapes) requires additional API calls not yet implemented in this version.`),
+});
+/**
+ * Schema for slides_create_presentation tool
+ * Create a new Google Slides presentation
+ */
+export const SlidesCreatePresentationSchema = z.object({
+    title: z
+        .string()
+        .describe("Title for the new presentation. This becomes the filename in Google Drive and the presentation title. Creates a blank presentation with a single blank slide. Use the Google Slides UI to add content and additional slides."),
+});
+// ============================================================================
+// TASKS TOOLS (3 tools)
+// ============================================================================
+/**
+ * Schema for tasks_list_task_lists tool
+ * List all Google Tasks task lists
+ */
+export const TasksListTaskListsSchema = z.object({}).describe("List all Google Tasks task lists for the user. Every Google account has at least one task list. Returns task list IDs, titles, and last updated timestamps. Use the returned task list ID with tasks_list_tasks to view tasks or tasks_create_task to add tasks. The special ID '@default' can be used to reference the user's default task list without calling this tool first.");
+/**
+ * Schema for tasks_list_tasks tool
+ * List tasks from a specific task list
+ */
+export const TasksListTasksSchema = z.object({
+    taskListId: z
+        .string()
+        .describe(`The task list ID to retrieve tasks from. Options:
+
+- '@default' - User's default/primary task list (use this if you don't need a specific list)
+- Specific task list ID - Obtained from tasks_list_task_lists results
+
+Returns all tasks in the list with: task ID, title, completion status (needsAction or completed), notes/description if any, due date if set, and last update timestamp. Tasks are returned in the order they appear in the list.`),
+});
+/**
+ * Schema for tasks_create_task tool
+ * Create a new task in a task list
+ */
+export const TasksCreateTaskSchema = z.object({
+    taskListId: z
+        .string()
+        .describe("The task list ID to add the task to. Use '@default' for the user's default task list, or a specific ID from tasks_list_task_lists."),
+    title: z
+        .string()
+        .describe("Task title - the main task description. Keep it concise and actionable (e.g., 'Review Q4 budget proposal' rather than 'Budget'). This is the primary text shown in the task list."),
+    notes: z
+        .string()
+        .optional()
+        .describe("Additional notes or details about the task. Use for: context, sub-tasks listed as text, links to relevant resources, or any information needed to complete the task. Displayed when viewing task details."),
+    due: z
+        .string()
+        .optional()
+        .describe(`Due date in RFC 3339 timestamp format. Only the date portion is used (time is ignored by Google Tasks).
+
+**Format:** YYYY-MM-DDTHH:MM:SS.000Z
+
+**Examples:**
+- '2024-12-31T00:00:00.000Z' - Due December 31, 2024
+- '2025-01-15T00:00:00.000Z' - Due January 15, 2025
+
+**Note:** Setting a time is not meaningful - Google Tasks only tracks the date. The task will appear as due on that calendar date.`),
+});
+// ============================================================================
+// FORMS TOOLS (2 tools)
+// ============================================================================
+/**
+ * Schema for forms_create_form tool
+ * Create a new Google Form
+ */
+export const FormsCreateFormSchema = z.object({
+    title: z
+        .string()
+        .describe("Title for the new Google Form. This appears at the top of the form and as the filename in Google Drive. Creates an empty form with no questions. Use the Google Forms UI at the returned edit URL to add questions, sections, and configure settings."),
+});
+/**
+ * Schema for forms_get_form tool
+ * Get Google Form information
+ */
+export const FormsGetFormSchema = z.object({
+    formId: z
+        .string()
+        .describe(`The unique Google Forms form ID. How to obtain:
+
+1. **From drive_list_files**: Search using query "mimeType = 'application/vnd.google-apps.form'" and use the returned file ID
+2. **From form URL**: Extract from the URL pattern:
+   - Edit URL: docs.google.com/forms/d/{formId}/edit
+   - View URL: docs.google.com/forms/d/{formId}/viewform
+
+**Example URL:** docs.google.com/forms/d/1AbCdEfGhIjKlMnOpQrStUvWxYz/edit
+**Form ID:** 1AbCdEfGhIjKlMnOpQrStUvWxYz
+
+Returns: Form title, document title, description, and the responder URI (the URL to share with people who should fill out the form).`),
+});
+// ============================================================================
+// CHAT TOOLS (2 tools)
+// ============================================================================
+/**
+ * Schema for chat_list_spaces tool
+ * List Google Chat spaces
+ */
+export const ChatListSpacesSchema = z.object({}).describe("List all Google Chat spaces accessible to the user. Returns spaces including: direct message conversations (DMs), group conversations, and named spaces (rooms). For each space, returns the space resource name (spaces/{spaceId}), display name, and space type (DIRECT_MESSAGE, GROUP_CHAT, or SPACE). Use the space resource name with chat_send_message to send messages. Note: Requires the user's Google Workspace account to have Google Chat enabled.");
+/**
+ * Schema for chat_send_message tool
+ * Send a message to a Google Chat space
+ */
+export const ChatSendMessageSchema = z.object({
+    spaceName: z
+        .string()
+        .describe(`The Google Chat space resource name. Format: 'spaces/{spaceId}'
+
+**How to obtain:**
+1. Use chat_list_spaces to list available spaces
+2. Use the 'name' field from the results (e.g., 'spaces/AAAA1234567')
+
+**Space types you can message:**
+- Direct messages (DMs) with individuals
+- Group conversations
+- Named spaces (rooms) where you're a member
+
+The space name is NOT the display name - it's the technical resource identifier.`),
+    text: z
+        .string()
+        .describe(`Message text to send. Plain text with optional basic formatting:
+
+**Formatting options:**
+- *bold text* - Surround with asterisks
+- _italic text_ - Surround with underscores
+- ~strikethrough~ - Surround with tildes
+- \`inline code\` - Surround with backticks
+- \`\`\`code block\`\`\` - Triple backticks for code blocks
+
+**Best practices:**
+- Keep messages concise and actionable
+- Use formatting sparingly for emphasis
+- Break long content into multiple messages if needed
+- @mentions are not supported via this API`),
+});
+//# sourceMappingURL=schemas.js.map

package/dist/schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../src/schemas.ts"],"names":[],"mappings":"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"}

package/dist/tool-loader.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Tool configuration loader
+ * Loads tool definitions from tools.json and validates them
+ *
+ * Supports loading from (in priority order):
+ * 1. Custom path via TOOLS_CONFIG_PATH environment variable
+ * 2. tools.json in current working directory (for development)
+ * 3. tools.json in package installation directory (for npx/installed usage)
+ */
+export interface ToolDefinition {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: Record<string, unknown>;
+        required?: string[];
+    };
+}
+export interface ToolsConfig {
+    [toolName: string]: ToolDefinition;
+}
+/**
+ * Load tool definitions from tools.json
+ * Uses caching in production, always reloads in development
+ */
+export declare function loadToolDefinitions(forceReload?: boolean): ToolDefinition[];
+/**
+ * Get a specific tool definition by name
+ */
+export declare function getToolDefinition(toolName: string): ToolDefinition | undefined;
+/**
+ * Clear the tool cache (useful for testing or forced reloads)
+ */
+export declare function clearToolCache(): void;
+//# sourceMappingURL=tool-loader.d.ts.map

package/dist/tool-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-loader.d.ts","sourceRoot":"","sources":["../src/tool-loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAOH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE;QACX,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACpC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;KACrB,CAAC;CACH;AAED,MAAM,WAAW,WAAW;IAC1B,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,CAAC;CACpC;AAmDD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,UAAQ,GAAG,cAAc,EAAE,CAwDzE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAG9E;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAIrC"}