@notionhq/apps 0.0.27 → 0.0.29

package/src/mail.generated.ts

@@ -0,0 +1,5095 @@
+// Generated by notion tool-core codegen-script-types --connections. Do not edit.
+import type { ConnectionActionInvoker } from "./connection-actions.js"
+/**
+ * Script input for the "Add Sender to Notion Mail Notification Allowlist" effect (`mail.addSenderNotificationPreferences`),
+ * derived from its Tool Core definition's call_function input projection.
+ *
+ * Add sender email addresses to the Notion Mail notification allowlist. When a sender is on the allowlist, their emails will always trigger push notifications regardless of view-level settings. This tool is specific to Notion Mail notification settings only. Takes effect immediately.
+ */
+export type AddSenderNotificationPreferencesScriptInput = {
+	/**
+	 * The Notion Mail email address of the account. Must be an account connected to Notion Mail.
+	 */
+	userEmailAddress: string
+	/**
+	 * Sender email addresses to add to the notification allowlist
+	 */
+	senderAddresses: Array<string>
+}
+
+/**
+ * Canonical Tool Core output for the "Add Sender to Notion Mail Notification Allowlist" effect (`mail.addSenderNotificationPreferences`).
+ * This is the definition's output schema; the effect's script surface may
+ * re-encode it before returning.
+ */
+export type AddSenderNotificationPreferencesScriptOutput = {
+	/**
+	 * Tool output content.
+	 */
+	content: unknown
+	/**
+	 * Name of the Mail tool that ran.
+	 */
+	name: string
+	/**
+	 * Whether the Mail service reported a tool error.
+	 */
+	isError?: boolean
+	/**
+	 * Execution metadata reported by the MCP server.
+	 */
+	metadata?: {
+		/**
+		 * Tool execution time in milliseconds.
+		 */
+		executionTimeMs?: number
+		/**
+		 * Number of bytes processed by the tool.
+		 */
+		bytesProcessed?: number
+		/**
+		 * Tool execution cost reported by the MCP server.
+		 */
+		cost?: number
+	}
+	/**
+	 * Mail module name used for display.
+	 */
+	moduleName?: string
+	/**
+	 * Structured tool output when provided by the Mail service.
+	 */
+	structuredContent?: unknown
+	/**
+	 * Bounded HTTP-like Mail service error code.
+	 */
+	toolErrorCode?: number
+}
+
+/**
+ * Script input for the "Analyze Recent Email Activities" effect (`mail.analyzeRecentEmailActivities`),
+ * derived from its Tool Core definition's call_function input projection.
+ *
+ * Returns a structured snapshot of the user's mailbox for the last 7 days including labels with message counts, contacts registry, threads registry, drafts, sent messages grouped by recipient, and Gmail filter rules. Use this as a first step to understand a user's mailbox before taking actions.
+ */
+export type AnalyzeRecentEmailActivitiesScriptInput = {
+	/**
+	 * The email address of the account to get context for
+	 */
+	userEmailAddress: string
+}
+
+/**
+ * Canonical Tool Core output for the "Analyze Recent Email Activities" effect (`mail.analyzeRecentEmailActivities`).
+ * This is the definition's output schema; the effect's script surface may
+ * re-encode it before returning.
+ */
+export type AnalyzeRecentEmailActivitiesScriptOutput = {
+	/**
+	 * Tool output content.
+	 */
+	content: unknown
+	/**
+	 * Name of the Mail tool that ran.
+	 */
+	name: string
+	/**
+	 * Whether the Mail service reported a tool error.
+	 */
+	isError?: boolean
+	/**
+	 * Execution metadata reported by the MCP server.
+	 */
+	metadata?: {
+		/**
+		 * Tool execution time in milliseconds.
+		 */
+		executionTimeMs?: number
+		/**
+		 * Number of bytes processed by the tool.
+		 */
+		bytesProcessed?: number
+		/**
+		 * Tool execution cost reported by the MCP server.
+		 */
+		cost?: number
+	}
+	/**
+	 * Mail module name used for display.
+	 */
+	moduleName?: string
+	/**
+	 * Structured tool output when provided by the Mail service.
+	 */
+	structuredContent?: unknown
+	/**
+	 * Bounded HTTP-like Mail service error code.
+	 */
+	toolErrorCode?: number
+}
+
+/**
+ * Script input for the "Apply Outlook Categories" effect (`mail.applyOutlookCategories`),
+ * derived from its Tool Core definition's call_function input projection.
+ *
+ * Apply categories to all messages in the specified Outlook conversations. Merges with existing categories.
+ */
+export type ApplyOutlookCategoriesScriptInput = {
+	/**
+	 * The Outlook email address
+	 */
+	userEmailAddress: string
+	/**
+	 * Outlook conversation IDs (from search_emails threadId)
+	 */
+	conversationIDs: Array<string>
+	/**
+	 * Category display names to apply (case-sensitive)
+	 */
+	categoryNames: Array<string>
+}
+
+/**
+ * Canonical Tool Core output for the "Apply Outlook Categories" effect (`mail.applyOutlookCategories`).
+ * This is the definition's output schema; the effect's script surface may
+ * re-encode it before returning.
+ */
+export type ApplyOutlookCategoriesScriptOutput = {
+	/**
+	 * Tool output content.
+	 */
+	content: unknown
+	/**
+	 * Name of the Mail tool that ran.
+	 */
+	name: string
+	/**
+	 * Whether the Mail service reported a tool error.
+	 */
+	isError?: boolean
+	/**
+	 * Execution metadata reported by the MCP server.
+	 */
+	metadata?: {
+		/**
+		 * Tool execution time in milliseconds.
+		 */
+		executionTimeMs?: number
+		/**
+		 * Number of bytes processed by the tool.
+		 */
+		bytesProcessed?: number
+		/**
+		 * Tool execution cost reported by the MCP server.
+		 */
+		cost?: number
+	}
+	/**
+	 * Mail module name used for display.
+	 */
+	moduleName?: string
+	/**
+	 * Structured tool output when provided by the Mail service.
+	 */
+	structuredContent?: unknown
+	/**
+	 * Bounded HTTP-like Mail service error code.
+	 */
+	toolErrorCode?: number
+}
+
+/**
+ * Script input for the "Apply Labels" effect (`mail.applyUserLabelsWithLazyCreate`),
+ * derived from its Tool Core definition's call_function input projection.
+ *
+ * Apply labels to email threads, creating them if they don't exist
+ */
+export type ApplyUserLabelsWithLazyCreateScriptInput = {
+	/**
+	 * The email address of the mailbox
+	 */
+	userEmailAddress: string
+	/**
+	 * Array of thread IDs to label
+	 */
+	threadIds: Array<string>
+	/**
+	 * Names of labels to apply
+	 */
+	labelNames: Array<string>
+}
+
+/**
+ * Canonical Tool Core output for the "Apply Labels" effect (`mail.applyUserLabelsWithLazyCreate`).
+ * This is the definition's output schema; the effect's script surface may
+ * re-encode it before returning.
+ */
+export type ApplyUserLabelsWithLazyCreateScriptOutput = {
+	/**
+	 * Tool output content.
+	 */
+	content: unknown
+	/**
+	 * Name of the Mail tool that ran.
+	 */
+	name: string
+	/**
+	 * Whether the Mail service reported a tool error.
+	 */
+	isError?: boolean
+	/**
+	 * Execution metadata reported by the MCP server.
+	 */
+	metadata?: {
+		/**
+		 * Tool execution time in milliseconds.
+		 */
+		executionTimeMs?: number
+		/**
+		 * Number of bytes processed by the tool.
+		 */
+		bytesProcessed?: number
+		/**
+		 * Tool execution cost reported by the MCP server.
+		 */
+		cost?: number
+	}
+	/**
+	 * Mail module name used for display.
+	 */
+	moduleName?: string
+	/**
+	 * Structured tool output when provided by the Mail service.
+	 */
+	structuredContent?: unknown
+	/**
+	 * Bounded HTTP-like Mail service error code.
+	 */
+	toolErrorCode?: number
+}
+
+/**
+ * Script input for the "Archive Threads by ID" effect (`mail.archiveThreadsById`),
+ * derived from its Tool Core definition's call_function input projection.
+ *
+ * Archive one or more email threads (remove from inbox)
+ */
+export type ArchiveThreadsByIdScriptInput = {
+	/**
+	 * The email address of the mailbox
+	 */
+	userEmailAddress: string
+	/**
+	 * Array of thread IDs to archive
+	 */
+	threadIds: Array<string>
+}
+
+/**
+ * Canonical Tool Core output for the "Archive Threads by ID" effect (`mail.archiveThreadsById`).
+ * This is the definition's output schema; the effect's script surface may
+ * re-encode it before returning.
+ */
+export type ArchiveThreadsByIdScriptOutput = {
+	/**
+	 * Tool output content.
+	 */
+	content: unknown
+	/**
+	 * Name of the Mail tool that ran.
+	 */
+	name: string
+	/**
+	 * Whether the Mail service reported a tool error.
+	 */
+	isError?: boolean
+	/**
+	 * Execution metadata reported by the MCP server.
+	 */
+	metadata?: {
+		/**
+		 * Tool execution time in milliseconds.
+		 */
+		executionTimeMs?: number
+		/**
+		 * Number of bytes processed by the tool.
+		 */
+		bytesProcessed?: number
+		/**
+		 * Tool execution cost reported by the MCP server.
+		 */
+		cost?: number
+	}
+	/**
+	 * Mail module name used for display.
+	 */
+	moduleName?: string
+	/**
+	 * Structured tool output when provided by the Mail service.
+	 */
+	structuredContent?: unknown
+	/**
+	 * Bounded HTTP-like Mail service error code.
+	 */
+	toolErrorCode?: number
+}
+
+/**
+ * Script input for the "Archive Threads by Search Query" effect (`mail.archiveThreadsByQuery`),
+ * derived from its Tool Core definition's call_function input projection.
+ *
+ * Archives threads matching a Gmail-style search query
+ */
+export type ArchiveThreadsByQueryScriptInput = {
+	/**
+	 * The email address of the mailbox
+	 */
+	userEmailAddress: string
+	/**
+	 * Gmail search query to match threads to archive
+	 */
+	query: string
+	/**
+	 * Pagination token from previous archive results
+	 */
+	pageToken?: string
+}
+
+/**
+ * Canonical Tool Core output for the "Archive Threads by Search Query" effect (`mail.archiveThreadsByQuery`).
+ * This is the definition's output schema; the effect's script surface may
+ * re-encode it before returning.
+ */
+export type ArchiveThreadsByQueryScriptOutput = {
+	/**
+	 * Tool output content.
+	 */
+	content: unknown
+	/**
+	 * Name of the Mail tool that ran.
+	 */
+	name: string
+	/**
+	 * Whether the Mail service reported a tool error.
+	 */
+	isError?: boolean
+	/**
+	 * Execution metadata reported by the MCP server.
+	 */
+	metadata?: {
+		/**
+		 * Tool execution time in milliseconds.
+		 */
+		executionTimeMs?: number
+		/**
+		 * Number of bytes processed by the tool.
+		 */
+		bytesProcessed?: number
+		/**
+		 * Tool execution cost reported by the MCP server.
+		 */
+		cost?: number
+	}
+	/**
+	 * Mail module name used for display.
+	 */
+	moduleName?: string
+	/**
+	 * Structured tool output when provided by the Mail service.
+	 */
+	structuredContent?: unknown
+	/**
+	 * Bounded HTTP-like Mail service error code.
+	 */
+	toolErrorCode?: number
+}
+
+/**
+ * Script input for the "Block Sender" effect (`mail.blockSender`),
+ * derived from its Tool Core definition's call_function input projection.
+ *
+ * Block a sender from sending emails to this mailbox by adding them to the mailbox's blocked-senders list. Works for any mail provider.
+ */
+export type BlockSenderScriptInput = {
+	/**
+	 * The email address of the mailbox
+	 */
+	userEmailAddress: string
+	/**
+	 * Email address of the sender to block
+	 */
+	senderEmail: string
+	/**
+	 * Optional array of thread IDs to immediately trash (from this sender)
+	 */
+	threadIds?: Array<string>
+}
+
+/**
+ * Canonical Tool Core output for the "Block Sender" effect (`mail.blockSender`).
+ * This is the definition's output schema; the effect's script surface may
+ * re-encode it before returning.
+ */
+export type BlockSenderScriptOutput = {
+	/**
+	 * Tool output content.
+	 */
+	content: unknown
+	/**
+	 * Name of the Mail tool that ran.
+	 */
+	name: string
+	/**
+	 * Whether the Mail service reported a tool error.
+	 */
+	isError?: boolean
+	/**
+	 * Execution metadata reported by the MCP server.
+	 */
+	metadata?: {
+		/**
+		 * Tool execution time in milliseconds.
+		 */
+		executionTimeMs?: number
+		/**
+		 * Number of bytes processed by the tool.
+		 */
+		bytesProcessed?: number
+		/**
+		 * Tool execution cost reported by the MCP server.
+		 */
+		cost?: number
+	}
+	/**
+	 * Mail module name used for display.
+	 */
+	moduleName?: string
+	/**
+	 * Structured tool output when provided by the Mail service.
+	 */
+	structuredContent?: unknown
+	/**
+	 * Bounded HTTP-like Mail service error code.
+	 */
+	toolErrorCode?: number
+}
+
+/**
+ * Script input for the "Create Gmail Filter" effect (`mail.createGmailFilter`),
+ * derived from its Tool Core definition's call_function input projection.
+ *
+ * Create a new Gmail filter rule
+ */
+export type CreateGmailFilterScriptInput = {
+	/**
+	 * The email address of the Gmail account
+	 */
+	userEmailAddress: string
+	/**
+	 * Filter criteria (at least one field required)
+	 */
+	criteria: {
+		/**
+		 * Match emails from this sender
+		 */
+		from?: string
+		/**
+		 * Match emails sent to this address
+		 */
+		to?: string
+		/**
+		 * Match emails with this in subject
+		 */
+		subject?: string
+		/**
+		 * Full Gmail search query
+		 */
+		query?: string
+		/**
+		 * Exclude emails matching this query
+		 */
+		negatedQuery?: string
+		/**
+		 * Match only emails with attachments
+		 */
+		hasAttachment?: boolean
+		/**
+		 * Exclude chat messages
+		 */
+		excludeChats?: boolean
+		/**
+		 * Size threshold in bytes
+		 */
+		size?: number
+		/**
+		 * Compare against size threshold
+		 */
+		sizeComparison?: "SMALLER" | "LARGER"
+	}
+	/**
+	 * Actions to perform (at least one required)
+	 */
+	action: {
+		/**
+		 * Gmail system label IDs or IDs returned by list_labels. Never use Notion record, survey option, or category IDs.
+		 */
+		addLabelIds?: Array<string>
+		/**
+		 * Gmail system label IDs or IDs returned by list_labels. Use INBOX to auto-archive matching future mail.
+		 */
+		removeLabelIds?: Array<string>
+		/**
+		 * Email address to forward to (must be pre-verified)
+		 */
+		forward?: string
+	}
+}
+
+/**
+ * Canonical Tool Core output for the "Create Gmail Filter" effect (`mail.createGmailFilter`).
+ * This is the definition's output schema; the effect's script surface may
+ * re-encode it before returning.
+ */
+export type CreateGmailFilterScriptOutput = {
+	/**
+	 * Tool output content.
+	 */
+	content: unknown
+	/**
+	 * Name of the Mail tool that ran.
+	 */
+	name: string
+	/**
+	 * Whether the Mail service reported a tool error.
+	 */
+	isError?: boolean
+	/**
+	 * Execution metadata reported by the MCP server.
+	 */
+	metadata?: {
+		/**
+		 * Tool execution time in milliseconds.
+		 */
+		executionTimeMs?: number
+		/**
+		 * Number of bytes processed by the tool.
+		 */
+		bytesProcessed?: number
+		/**
+		 * Tool execution cost reported by the MCP server.
+		 */
+		cost?: number
+	}
+	/**
+	 * Mail module name used for display.
+	 */
+	moduleName?: string
+	/**
+	 * Structured tool output when provided by the Mail service.
+	 */
+	structuredContent?: unknown
+	/**
+	 * Bounded HTTP-like Mail service error code.
+	 */
+	toolErrorCode?: number
+}
+
+/**
+ * Script input for the "Create Label" effect (`mail.createLabel`),
+ * derived from its Tool Core definition's call_function input projection.
+ *
+ * Create a new label in the mailbox
+ */
+export type CreateLabelScriptInput = {
+	/**
+	 * The email address of the mailbox
+	 */
+	userEmailAddress: string
+	/**
+	 * Name of the label to create
+	 */
+	labelName: string
+	/**
+	 * Optional color for the label
+	 */
+	color?:
+		| "light-gray"
+		| "gray"
+		| "brown"
+		| "orange"
+		| "yellow"
+		| "green"
+		| "blue"
+		| "purple"
+		| "pink"
+		| "red"
+}
+
+/**
+ * Canonical Tool Core output for the "Create Label" effect (`mail.createLabel`).
+ * This is the definition's output schema; the effect's script surface may
+ * re-encode it before returning.
+ */
+export type CreateLabelScriptOutput = {
+	/**
+	 * Tool output content.
+	 */
+	content: unknown
+	/**
+	 * Name of the Mail tool that ran.
+	 */
+	name: string
+	/**
+	 * Whether the Mail service reported a tool error.
+	 */
+	isError?: boolean
+	/**
+	 * Execution metadata reported by the MCP server.
+	 */
+	metadata?: {
+		/**
+		 * Tool execution time in milliseconds.
+		 */
+		executionTimeMs?: number
+		/**
+		 * Number of bytes processed by the tool.
+		 */
+		bytesProcessed?: number
+		/**
+		 * Tool execution cost reported by the MCP server.
+		 */
+		cost?: number
+	}
+	/**
+	 * Mail module name used for display.
+	 */
+	moduleName?: string
+	/**
+	 * Structured tool output when provided by the Mail service.
+	 */
+	structuredContent?: unknown
+	/**
+	 * Bounded HTTP-like Mail service error code.
+	 */
+	toolErrorCode?: number
+}
+
+/**
+ * Script input for the "Create Mail Block" effect (`mail.createMailBlock`),
+ * derived from its Tool Core definition's call_function input projection.
+ *
+ * Create a Notion Mail block for a Gmail thread in a specified location.
+ */
+export type CreateMailBlockScriptInput = {
+	/**
+	 * The email address of the mailbox
+	 */
+	userEmailAddress: string
+	/**
+	 * The Gmail thread ID to create a mail block for
+	 */
+	threadId: string
+	/**
+	 * Where to create the mail block (private, page, or database)
+	 */
+	locationType: "private" | "page" | "database"
+	/**
+	 * Required when locationType is page or database. Not used for private.
+	 */
+	locationUrl?: string
+}
+
+/**
+ * Canonical Tool Core output for the "Create Mail Block" effect (`mail.createMailBlock`).
+ * This is the definition's output schema; the effect's script surface may
+ * re-encode it before returning.
+ */
+export type CreateMailBlockScriptOutput = {
+	/**
+	 * Tool output content.
+	 */
+	content: unknown
+	/**
+	 * Name of the Mail tool that ran.
+	 */
+	name: string
+	/**
+	 * Whether the Mail service reported a tool error.
+	 */
+	isError?: boolean
+	/**
+	 * Execution metadata reported by the MCP server.
+	 */
+	metadata?: {
+		/**
+		 * Tool execution time in milliseconds.
+		 */
+		executionTimeMs?: number
+		/**
+		 * Number of bytes processed by the tool.
+		 */
+		bytesProcessed?: number
+		/**
+		 * Tool execution cost reported by the MCP server.
+		 */
+		cost?: number
+	}
+	/**
+	 * Mail module name used for display.
+	 */
+	moduleName?: string
+	/**
+	 * Structured tool output when provided by the Mail service.
+	 */
+	structuredContent?: unknown
+	/**
+	 * Bounded HTTP-like Mail service error code.
+	 */
+	toolErrorCode?: number
+}
+
+/**
+ * Script input for the "Create Draft (Notion Mail)" effect (`mail.createOrUpdateDraft`),
+ * derived from its Tool Core definition's call_function input projection.
+ *
+ * Create or update a draft email in Notion Mail. For replies, automatically finds and updates existing agent drafts on the same thread.
+ */
+export type CreateOrUpdateDraftScriptInput = {
+	/**
+	 * The user's email address (for mailbox identification)
+	 */
+	userEmailAddress: string
+	/**
+	 * Draft intent: "reply" for responding to existing thread, "standalone_draft" for new email, "forward" to forward an existing message
+	 */
+	draftType: "reply" | "standalone_draft" | "forward"
+	/**
+	 * Sender address owned by the user
+	 */
+	from: {
+		address: string
+		name?: string
+	}
+	/**
+	 * Primary recipients. Required for standalone drafts and forwards, optional for replies.
+	 */
+	to?: Array<{
+		address: string
+		name?: string
+	}>
+	/**
+	 * CC recipients
+	 */
+	cc?: Array<{
+		address: string
+		name?: string
+	}>
+	/**
+	 * BCC recipients
+	 */
+	bcc?: Array<{
+		address: string
+		name?: string
+	}>
+	/**
+	 * Subject line. Required for standalone drafts. Auto-generated for replies and forwards (Re:/FWD: prefix).
+	 */
+	subject?: string
+	/**
+	 * Plain text email body
+	 */
+	text?: string
+	/**
+	 * HTML email body
+	 */
+	html?: string
+	/**
+	 * Gmail thread ID for replies or forwards. Required when draftType is reply or forward.
+	 */
+	parentThreadId?: string
+	/**
+	 * Specific message ID to reply to. Defaults to latest message when omitted.
+	 */
+	parentMessageId?: string
+	/**
+	 * ID of an existing Notion Mail draft to update (the messageID field from a prior create_or_update_draft response). Applicable to standalone_draft type only. Omit to create a new draft.
+	 */
+	draftId?: string
+}
+
+/**
+ * Canonical Tool Core output for the "Create Draft (Notion Mail)" effect (`mail.createOrUpdateDraft`).
+ * This is the definition's output schema; the effect's script surface may
+ * re-encode it before returning.
+ */
+export type CreateOrUpdateDraftScriptOutput = {
+	/**
+	 * Tool output content.
+	 */
+	content: unknown
+	/**
+	 * Name of the Mail tool that ran.
+	 */
+	name: string
+	/**
+	 * Whether the Mail service reported a tool error.
+	 */
+	isError?: boolean
+	/**
+	 * Execution metadata reported by the MCP server.
+	 */
+	metadata?: {
+		/**
+		 * Tool execution time in milliseconds.
+		 */
+		executionTimeMs?: number
+		/**
+		 * Number of bytes processed by the tool.
+		 */
+		bytesProcessed?: number
+		/**
+		 * Tool execution cost reported by the MCP server.
+		 */
+		cost?: number
+	}
+	/**
+	 * Mail module name used for display.
+	 */
+	moduleName?: string
+	/**
+	 * Structured tool output when provided by the Mail service.
+	 */
+	structuredContent?: unknown
+	/**
+	 * Bounded HTTP-like Mail service error code.
+	 */
+	toolErrorCode?: number
+}
+
+/**
+ * Script input for the "Create Draft (Gmail + Notion Mail)" effect (`mail.createOrUpdateDraftAllClients`),
+ * derived from its Tool Core definition's call_function input projection.
+ *
+ * Create or update a draft email in both Gmail and Notion Mail in a single step, keeping the draft in sync across both mail clients. Creates the Gmail draft first, then the Notion Mail draft linked to it (serial, not parallel).
+ */
+export type CreateOrUpdateDraftAllClientsScriptInput = {
+	/**
+	 * The user's email address (for mailbox identification)
+	 */
+	userEmailAddress: string
+	/**
+	 * Draft intent: "reply" for responding to existing thread, "standalone_draft" for new email, "forward" to forward an existing message
+	 */
+	draftType: "reply" | "standalone_draft" | "forward"
+	/**
+	 * Sender address owned by the user
+	 */
+	from: {
+		address: string
+		name?: string
+	}
+	/**
+	 * Primary recipients. Required for standalone drafts and forwards, optional for replies.
+	 */
+	to?: Array<{
+		address: string
+		name?: string
+	}>
+	/**
+	 * CC recipients
+	 */
+	cc?: Array<{
+		address: string
+		name?: string
+	}>
+	/**
+	 * BCC recipients
+	 */
+	bcc?: Array<{
+		address: string
+		name?: string
+	}>
+	/**
+	 * Subject line. Required for standalone drafts. Auto-generated for replies and forwards.
+	 */
+	subject?: string
+	/**
+	 * Plain text email body
+	 */
+	text?: string
+	/**
+	 * HTML email body
+	 */
+	html?: string
+	/**
+	 * Gmail thread ID for replies or forwards. Required when draftType is reply or forward.
+	 */
+	threadId?: string
+	/**
+	 * Specific message ID to reply to. Defaults to latest message when omitted.
+	 */
+	parentMessageId?: string
+	/**
+	 * Opaque draft ID from a prior create_or_update_draft_all_clients response. Pass this to update existing drafts in both Gmail and Notion Mail. Omit to create new drafts.
+	 */
+	draftId?: string
+}
+
+/**
+ * Canonical Tool Core output for the "Create Draft (Gmail + Notion Mail)" effect (`mail.createOrUpdateDraftAllClients`).
+ * This is the definition's output schema; the effect's script surface may
+ * re-encode it before returning.
+ */
+export type CreateOrUpdateDraftAllClientsScriptOutput = {
+	/**
+	 * Tool output content.
+	 */
+	content: unknown
+	/**
+	 * Name of the Mail tool that ran.
+	 */
+	name: string
+	/**
+	 * Whether the Mail service reported a tool error.
+	 */
+	isError?: boolean
+	/**
+	 * Execution metadata reported by the MCP server.
+	 */
+	metadata?: {
+		/**
+		 * Tool execution time in milliseconds.
+		 */
+		executionTimeMs?: number
+		/**
+		 * Number of bytes processed by the tool.
+		 */
+		bytesProcessed?: number
+		/**
+		 * Tool execution cost reported by the MCP server.
+		 */
+		cost?: number
+	}
+	/**
+	 * Mail module name used for display.
+	 */
+	moduleName?: string
+	/**
+	 * Structured tool output when provided by the Mail service.
+	 */
+	structuredContent?: unknown
+	/**
+	 * Bounded HTTP-like Mail service error code.
+	 */
+	toolErrorCode?: number
+}
+
+/**
+ * Script input for the "Create Draft (Gmail)" effect (`mail.createOrUpdateGmailDraft`),
+ * derived from its Tool Core definition's call_function input projection.
+ *
+ * Create or update a draft email in Gmail's drafts folder.
+ */
+export type CreateOrUpdateGmailDraftScriptInput = {
+	/**
+	 * The user's email address
+	 */
+	userEmailAddress: string
+	/**
+	 * Draft intent: "reply" for replies, "standalone_draft" for new emails, "forward" to forward a message.
+	 */
+	draftType: "reply" | "standalone_draft" | "forward"
+	/**
+	 * Existing Gmail draft ID from a prior create_or_update_gmail_draft response. REQUIRED to update an existing draft (any draftType). OMIT to create a new draft.
+	 */
+	draftId?: string
+	/**
+	 * Gmail thread ID. Per draftType: reply=REQUIRED, forward=REQUIRED, standalone_draft=OMIT.
+	 */
+	threadId?: string
+	/**
+	 * Specific Gmail message ID to reply to (requires threadId)
+	 */
+	parentMessageId?: string
+	/**
+	 * Gmail send-as address controlled by the user
+	 */
+	from: {
+		address: string
+		name?: string
+	}
+	/**
+	 * Primary recipients
+	 */
+	to?: Array<{
+		address: string
+		name?: string
+	}>
+	/**
+	 * CC recipients
+	 */
+	cc?: Array<{
+		address: string
+		name?: string
+	}>
+	/**
+	 * BCC recipients
+	 */
+	bcc?: Array<{
+		address: string
+		name?: string
+	}>
+	/**
+	 * Subject line for the draft. Optional for replies/forwards when the subject is auto-generated.
+	 */
+	subject?: string
+	/**
+	 * Plain text email body
+	 */
+	text?: string
+	/**
+	 * HTML email body
+	 */
+	html?: string
+}
+
+/**
+ * Canonical Tool Core output for the "Create Draft (Gmail)" effect (`mail.createOrUpdateGmailDraft`).
+ * This is the definition's output schema; the effect's script surface may
+ * re-encode it before returning.
+ */
+export type CreateOrUpdateGmailDraftScriptOutput = {
+	/**
+	 * Tool output content.
+	 */
+	content: unknown
+	/**
+	 * Name of the Mail tool that ran.
+	 */
+	name: string
+	/**
+	 * Whether the Mail service reported a tool error.
+	 */
+	isError?: boolean
+	/**
+	 * Execution metadata reported by the MCP server.
+	 */
+	metadata?: {
+		/**
+		 * Tool execution time in milliseconds.
+		 */
+		executionTimeMs?: number
+		/**
+		 * Number of bytes processed by the tool.
+		 */
+		bytesProcessed?: number
+		/**
+		 * Tool execution cost reported by the MCP server.
+		 */
+		cost?: number
+	}
+	/**
+	 * Mail module name used for display.
+	 */
+	moduleName?: string
+	/**
+	 * Structured tool output when provided by the Mail service.
+	 */
+	structuredContent?: unknown
+	/**
+	 * Bounded HTTP-like Mail service error code.
+	 */
+	toolErrorCode?: number
+}
+
+/**
+ * Script input for the "Create Draft (Outlook)" effect (`mail.createOrUpdateOutlookDraft`),
+ * derived from its Tool Core definition's call_function input projection.
+ *
+ * Create or update a draft email in Outlook's drafts folder via Microsoft Graph. To send an Outlook draft, pass the returned draftId to send_existing_draft.
+ */
+export type CreateOrUpdateOutlookDraftScriptInput = {
+	/**
+	 * The user's email address
+	 */
+	userEmailAddress: string
+	/**
+	 * Draft intent: "reply" for replies, "standalone_draft" for new emails, "forward" to forward a message.
+	 */
+	draftType: "reply" | "standalone_draft" | "forward"
+	/**
+	 * Existing Outlook draft ID from a prior create_or_update_outlook_draft response. REQUIRED to update an existing draft (any draftType). OMIT to create a new draft.
+	 */
+	draftId?: string
+	/**
+	 * Outlook conversation ID. Per draftType: reply=REQUIRED, forward=REQUIRED, standalone_draft=OMIT.
+	 */
+	conversationId?: string
+	/**
+	 * Specific Outlook message ID to reply to or forward (requires conversationId)
+	 */
+	parentMessageId?: string
+	/**
+	 * Outlook send-as address controlled by the user
+	 */
+	from: {
+		address: string
+		name?: string
+	}
+	/**
+	 * Primary recipients
+	 */
+	to?: Array<{
+		address: string
+		name?: string
+	}>
+	/**
+	 * CC recipients
+	 */
+	cc?: Array<{
+		address: string
+		name?: string
+	}>
+	/**
+	 * BCC recipients
+	 */
+	bcc?: Array<{
+		address: string
+		name?: string
+	}>
+	/**
+	 * Subject line for the draft. Optional for replies/forwards when the subject is auto-generated.
+	 */
+	subject?: string
+	/**
+	 * Plain text email body
+	 */
+	text?: string
+	/**
+	 * HTML email body
+	 */
+	html?: string
+}
+
+/**
+ * Canonical Tool Core output for the "Create Draft (Outlook)" effect (`mail.createOrUpdateOutlookDraft`).
+ * This is the definition's output schema; the effect's script surface may
+ * re-encode it before returning.
+ */
+export type CreateOrUpdateOutlookDraftScriptOutput = {
+	/**
+	 * Tool output content.
+	 */
+	content: unknown
+	/**
+	 * Name of the Mail tool that ran.
+	 */
+	name: string
+	/**
+	 * Whether the Mail service reported a tool error.
+	 */
+	isError?: boolean
+	/**
+	 * Execution metadata reported by the MCP server.
+	 */
+	metadata?: {
+		/**
+		 * Tool execution time in milliseconds.
+		 */
+		executionTimeMs?: number
+		/**
+		 * Number of bytes processed by the tool.
+		 */
+		bytesProcessed?: number
+		/**
+		 * Tool execution cost reported by the MCP server.
+		 */
+		cost?: number
+	}
+	/**
+	 * Mail module name used for display.
+	 */
+	moduleName?: string
+	/**
+	 * Structured tool output when provided by the Mail service.
+	 */
+	structuredContent?: unknown
+	/**
+	 * Bounded HTTP-like Mail service error code.
+	 */
+	toolErrorCode?: number
+}
+
+/**
+ * Script input for the "Create Outlook Category" effect (`mail.createOutlookCategory`),
+ * derived from its Tool Core definition's call_function input projection.
+ *
+ * Create a new category in the user's Outlook master category list. Categories can then be applied to messages.
+ */
+export type CreateOutlookCategoryScriptInput = {
+	/**
+	 * The Outlook email address
+	 */
+	userEmailAddress: string
+	/**
+	 * The category name. Must be unique. Immutable after creation.
+	 */
+	displayName: string
+	/**
+	 * Color preset. Common: preset0=Red, preset1=Orange, preset4=Green, preset7=Blue, preset8=Purple.
+	 */
+	color?:
+		| "None"
+		| "preset0"
+		| "preset1"
+		| "preset2"
+		| "preset3"
+		| "preset4"
+		| "preset5"
+		| "preset6"
+		| "preset7"
+		| "preset8"
+		| "preset9"
+		| "preset10"
+		| "preset11"
+		| "preset12"
+		| "preset13"
+		| "preset14"
+		| "preset15"
+		| "preset16"
+		| "preset17"
+		| "preset18"
+		| "preset19"
+		| "preset20"
+		| "preset21"
+		| "preset22"
+		| "preset23"
+		| "preset24"
+}
+
+/**
+ * Canonical Tool Core output for the "Create Outlook Category" effect (`mail.createOutlookCategory`).
+ * This is the definition's output schema; the effect's script surface may
+ * re-encode it before returning.
+ */
+export type CreateOutlookCategoryScriptOutput = {
+	/**
+	 * Tool output content.
+	 */
+	content: unknown
+	/**
+	 * Name of the Mail tool that ran.
+	 */
+	name: string
+	/**
+	 * Whether the Mail service reported a tool error.
+	 */
+	isError?: boolean
+	/**
+	 * Execution metadata reported by the MCP server.
+	 */
+	metadata?: {
+		/**
+		 * Tool execution time in milliseconds.
+		 */
+		executionTimeMs?: number
+		/**
+		 * Number of bytes processed by the tool.
+		 */
+		bytesProcessed?: number
+		/**
+		 * Tool execution cost reported by the MCP server.
+		 */
+		cost?: number
+	}
+	/**
+	 * Mail module name used for display.
+	 */
+	moduleName?: string
+	/**
+	 * Structured tool output when provided by the Mail service.
+	 */
+	structuredContent?: unknown
+	/**
+	 * Bounded HTTP-like Mail service error code.
+	 */
+	toolErrorCode?: number
+}
+
+/**
+ * Script input for the "Create Outlook Folder" effect (`mail.createOutlookFolder`),
+ * derived from its Tool Core definition's call_function input projection.
+ *
+ * Create a new mail folder in the user's Outlook mailbox
+ */
+export type CreateOutlookFolderScriptInput = {
+	/**
+	 * The email address of the Outlook mailbox
+	 */
+	userEmailAddress: string
+	/**
+	 * Name of the folder to create
+	 */
+	folderName: string
+	/**
+	 * Optional parent folder ID to create a subfolder. Omit to create at the top level.
+	 */
+	parentFolderId?: string
+}
+
+/**
+ * Canonical Tool Core output for the "Create Outlook Folder" effect (`mail.createOutlookFolder`).
+ * This is the definition's output schema; the effect's script surface may
+ * re-encode it before returning.
+ */
+export type CreateOutlookFolderScriptOutput = {
+	/**
+	 * Tool output content.
+	 */
+	content: unknown
+	/**
+	 * Name of the Mail tool that ran.
+	 */
+	name: string
+	/**
+	 * Whether the Mail service reported a tool error.
+	 */
+	isError?: boolean
+	/**
+	 * Execution metadata reported by the MCP server.
+	 */
+	metadata?: {
+		/**
+		 * Tool execution time in milliseconds.
+		 */
+		executionTimeMs?: number
+		/**
+		 * Number of bytes processed by the tool.
+		 */
+		bytesProcessed?: number
+		/**
+		 * Tool execution cost reported by the MCP server.
+		 */
+		cost?: number
+	}
+	/**
+	 * Mail module name used for display.
+	 */
+	moduleName?: string
+	/**
+	 * Structured tool output when provided by the Mail service.
+	 */
+	structuredContent?: unknown
+	/**
+	 * Bounded HTTP-like Mail service error code.
+	 */
+	toolErrorCode?: number
+}
+
+/**
+ * Script input for the "Create Outlook Rule" effect (`mail.createOutlookRule`),
+ * derived from its Tool Core definition's call_function input projection.
+ *
+ * Create a new inbox rule in the user's Outlook mailbox to automatically process incoming messages
+ */
+export type CreateOutlookRuleScriptInput = {
+	/**
+	 * Display name for the rule
+	 */
+	displayName: string
+	/**
+	 * Execution order (lower = earlier). Omit to append at end.
+	 */
+	sequence?: number
+	/**
+	 * Whether the rule is active (defaults to enabled when omitted)
+	 */
+	isEnabled?: boolean
+	conditions: {
+		bodyContains?: Array<string>
+		bodyOrSubjectContains?: Array<string>
+		categories?: Array<string>
+		fromAddresses?: Array<{
+			address: string
+			name?: string
+		}>
+		hasAttachments?: boolean
+		headerContains?: Array<string>
+		importance?: "low" | "normal" | "high"
+		isApprovalRequest?: boolean
+		isAutomaticForward?: boolean
+		isAutomaticReply?: boolean
+		isEncrypted?: boolean
+		isMeetingRequest?: boolean
+		isMeetingResponse?: boolean
+		isNonDeliveryReport?: boolean
+		isPermissionControlled?: boolean
+		isReadReceipt?: boolean
+		isSigned?: boolean
+		isVoicemail?: boolean
+		messageActionFlag?:
+			| "any"
+			| "call"
+			| "doNotForward"
+			| "followUp"
+			| "fyi"
+			| "forward"
+			| "noResponseNecessary"
+			| "read"
+			| "reply"
+			| "replyToAll"
+			| "review"
+		notSentToMe?: boolean
+		recipientContains?: Array<string>
+		senderContains?: Array<string>
+		sensitivity?: "normal" | "personal" | "private" | "confidential"
+		sentCcMe?: boolean
+		sentOnlyToMe?: boolean
+		sentToMe?: boolean
+		sentToOrCcMe?: boolean
+		sentToAddresses?: Array<{
+			address: string
+			name?: string
+		}>
+		subjectContains?: Array<string>
+		withinSizeRange?: {
+			minimumSize?: number
+			maximumSize?: number
+		}
+	}
+	/**
+	 * Actions to take when conditions are met (at least one non-empty field required)
+	 */
+	actions: {
+		/**
+		 * Categories to assign
+		 */
+		assignCategories?: Array<string>
+		/**
+		 * Folder ID to copy to (use list_outlook_folders to find IDs)
+		 */
+		copyToFolder?: string
+		/**
+		 * Move to Deleted Items
+		 */
+		delete?: boolean
+		/**
+		 * Forward as attachment to these addresses
+		 */
+		forwardAsAttachmentTo?: Array<{
+			/**
+			 * Email address
+			 */
+			address: string
+			/**
+			 * Display name (optional)
+			 */
+			name?: string
+		}>
+		/**
+		 * Forward to these addresses
+		 */
+		forwardTo?: Array<{
+			/**
+			 * Email address
+			 */
+			address: string
+			/**
+			 * Display name (optional)
+			 */
+			name?: string
+		}>
+		/**
+		 * Mark as read
+		 */
+		markAsRead?: boolean
+		/**
+		 * Set importance level
+		 */
+		markImportance?: "low" | "normal" | "high"
+		/**
+		 * Folder ID to move to (use list_outlook_folders to find IDs)
+		 */
+		moveToFolder?: string
+		/**
+		 * Permanently delete (skip Deleted Items)
+		 */
+		permanentDelete?: boolean
+		/**
+		 * Redirect to these addresses
+		 */
+		redirectTo?: Array<{
+			/**
+			 * Email address
+			 */
+			address: string
+			/**
+			 * Display name (optional)
+			 */
+			name?: string
+		}>
+		/**
+		 * Stop processing subsequent rules
+		 */
+		stopProcessingRules?: boolean
+	}
+	exceptions?: {
+		bodyContains?: Array<string>
+		bodyOrSubjectContains?: Array<string>
+		categories?: Array<string>
+		fromAddresses?: Array<{
+			address: string
+			name?: string
+		}>
+		hasAttachments?: boolean
+		headerContains?: Array<string>
+		importance?: "low" | "normal" | "high"
+		isApprovalRequest?: boolean
+		isAutomaticForward?: boolean
+		isAutomaticReply?: boolean
+		isEncrypted?: boolean
+		isMeetingRequest?: boolean
+		isMeetingResponse?: boolean
+		isNonDeliveryReport?: boolean
+		isPermissionControlled?: boolean
+		isReadReceipt?: boolean
+		isSigned?: boolean
+		isVoicemail?: boolean
+		messageActionFlag?:
+			| "any"
+			| "call"
+			| "doNotForward"
+			| "followUp"
+			| "fyi"
+			| "forward"
+			| "noResponseNecessary"
+			| "read"
+			| "reply"
+			| "replyToAll"
+			| "review"
+		notSentToMe?: boolean
+		recipientContains?: Array<string>
+		senderContains?: Array<string>
+		sensitivity?: "normal" | "personal" | "private" | "confidential"
+		sentCcMe?: boolean
+		sentOnlyToMe?: boolean
+		sentToMe?: boolean
+		sentToOrCcMe?: boolean
+		sentToAddresses?: Array<{
+			address: string
+			name?: string
+		}>
+		subjectContains?: Array<string>
+		withinSizeRange?: {
+			minimumSize?: number
+			maximumSize?: number
+		}
+	}
+	/**
+	 * The Outlook email address
+	 */
+	userEmailAddress: string
+}
+
+/**
+ * Canonical Tool Core output for the "Create Outlook Rule" effect (`mail.createOutlookRule`).
+ * This is the definition's output schema; the effect's script surface may
+ * re-encode it before returning.
+ */
+export type CreateOutlookRuleScriptOutput = {
+	/**
+	 * Tool output content.
+	 */
+	content: unknown
+	/**
+	 * Name of the Mail tool that ran.
+	 */
+	name: string
+	/**
+	 * Whether the Mail service reported a tool error.
+	 */
+	isError?: boolean
+	/**
+	 * Execution metadata reported by the MCP server.
+	 */
+	metadata?: {
+		/**
+		 * Tool execution time in milliseconds.
+		 */
+		executionTimeMs?: number
+		/**
+		 * Number of bytes processed by the tool.
+		 */
+		bytesProcessed?: number
+		/**
+		 * Tool execution cost reported by the MCP server.
+		 */
+		cost?: number
+	}
+	/**
+	 * Mail module name used for display.
+	 */
+	moduleName?: string
+	/**
+	 * Structured tool output when provided by the Mail service.
+	 */
+	structuredContent?: unknown
+	/**
+	 * Bounded HTTP-like Mail service error code.
+	 */
+	toolErrorCode?: number
+}
+
+/**
+ * Script input for the "Create Status Column" effect (`mail.createStatusColumn`),
+ * derived from its Tool Core definition's call_function input projection.
+ *
+ * Create a new status property column for emails
+ */
+export type CreateStatusColumnScriptInput = {
+	/**
+	 * The email address of the mailbox
+	 */
+	userEmailAddress: string
+	/**
+	 * Name of the status column
+	 */
+	propertyName: string
+	/**
+	 * Status options for the column
+	 */
+	options: Array<{
+		/**
+		 * Display name for the option
+		 */
+		name: string
+		style: {
+			color:
+				| "light-gray"
+				| "gray"
+				| "brown"
+				| "orange"
+				| "yellow"
+				| "green"
+				| "blue"
+				| "purple"
+				| "pink"
+				| "red"
+			icon:
+				| "star"
+				| "xmark"
+				| "check"
+				| "warning"
+				| "play"
+				| "reply"
+				| "dot"
+				| "noStatus"
+				| "todoReply"
+				| "waitingClock"
+		}
+		/**
+		 * Whether this is the default option
+		 */
+		isDefault?: boolean
+	}>
+	/**
+	 * Optional layout ID to attach the column to
+	 */
+	layoutID?: string
+}
+
+/**
+ * Canonical Tool Core output for the "Create Status Column" effect (`mail.createStatusColumn`).
+ * This is the definition's output schema; the effect's script surface may
+ * re-encode it before returning.
+ */
+export type CreateStatusColumnScriptOutput = {
+	/**
+	 * Tool output content.
+	 */
+	content: unknown
+	/**
+	 * Name of the Mail tool that ran.
+	 */
+	name: string
+	/**
+	 * Whether the Mail service reported a tool error.
+	 */
+	isError?: boolean
+	/**
+	 * Execution metadata reported by the MCP server.
+	 */
+	metadata?: {
+		/**
+		 * Tool execution time in milliseconds.
+		 */
+		executionTimeMs?: number
+		/**
+		 * Number of bytes processed by the tool.
+		 */
+		bytesProcessed?: number
+		/**
+		 * Tool execution cost reported by the MCP server.
+		 */
+		cost?: number
+	}
+	/**
+	 * Mail module name used for display.
+	 */
+	moduleName?: string
+	/**
+	 * Structured tool output when provided by the Mail service.
+	 */
+	structuredContent?: unknown
+	/**
+	 * Bounded HTTP-like Mail service error code.
+	 */
+	toolErrorCode?: number
+}
+
+/**
+ * Script input for the "Delete Gmail Filter" effect (`mail.deleteGmailFilter`),
+ * derived from its Tool Core definition's call_function input projection.
+ *
+ * Delete an existing Gmail filter
+ */
+export type DeleteGmailFilterScriptInput = {
+	/**
+	 * The email address of the Gmail account
+	 */
+	userEmailAddress: string
+	/**
+	 * The ID of the filter to delete
+	 */
+	filterId: string
+}
+
+/**
+ * Canonical Tool Core output for the "Delete Gmail Filter" effect (`mail.deleteGmailFilter`).
+ * This is the definition's output schema; the effect's script surface may
+ * re-encode it before returning.
+ */
+export type DeleteGmailFilterScriptOutput = {
+	/**
+	 * Tool output content.
+	 */
+	content: unknown
+	/**
+	 * Name of the Mail tool that ran.
+	 */
+	name: string
+	/**
+	 * Whether the Mail service reported a tool error.
+	 */
+	isError?: boolean
+	/**
+	 * Execution metadata reported by the MCP server.
+	 */
+	metadata?: {
+		/**
+		 * Tool execution time in milliseconds.
+		 */
+		executionTimeMs?: number
+		/**
+		 * Number of bytes processed by the tool.
+		 */
+		bytesProcessed?: number
+		/**
+		 * Tool execution cost reported by the MCP server.
+		 */
+		cost?: number
+	}
+	/**
+	 * Mail module name used for display.
+	 */
+	moduleName?: string
+	/**
+	 * Structured tool output when provided by the Mail service.
+	 */
+	structuredContent?: unknown
+	/**
+	 * Bounded HTTP-like Mail service error code.
+	 */
+	toolErrorCode?: number
+}
+
+/**
+ * Script input for the "Delete Label" effect (`mail.deleteLabel`),
+ * derived from its Tool Core definition's call_function input projection.
+ *
+ * Delete a label from the mailbox
+ */
+export type DeleteLabelScriptInput = {
+	/**
+	 * The email address of the mailbox
+	 */
+	userEmailAddress: string
+	/**
+	 * ID of the label to delete
+	 */
+	labelID: string
+}
+
+/**
+ * Canonical Tool Core output for the "Delete Label" effect (`mail.deleteLabel`).
+ * This is the definition's output schema; the effect's script surface may
+ * re-encode it before returning.
+ */
+export type DeleteLabelScriptOutput = {
+	/**
+	 * Tool output content.
+	 */
+	content: unknown
+	/**
+	 * Name of the Mail tool that ran.
+	 */
+	name: string
+	/**
+	 * Whether the Mail service reported a tool error.
+	 */
+	isError?: boolean
+	/**
+	 * Execution metadata reported by the MCP server.
+	 */
+	metadata?: {
+		/**
+		 * Tool execution time in milliseconds.
+		 */
+		executionTimeMs?: number
+		/**
+		 * Number of bytes processed by the tool.
+		 */
+		bytesProcessed?: number
+		/**
+		 * Tool execution cost reported by the MCP server.
+		 */
+		cost?: number
+	}
+	/**
+	 * Mail module name used for display.
+	 */
+	moduleName?: string
+	/**
+	 * Structured tool output when provided by the Mail service.
+	 */
+	structuredContent?: unknown
+	/**
+	 * Bounded HTTP-like Mail service error code.
+	 */
+	toolErrorCode?: number
+}
+
+/**
+ * Script input for the "Delete Outlook Category" effect (`mail.deleteOutlookCategory`),
+ * derived from its Tool Core definition's call_function input projection.
+ *
+ * Permanently remove a category from the user's Outlook master category list. Messages already tagged retain the category name.
+ */
+export type DeleteOutlookCategoryScriptInput = {
+	/**
+	 * The Outlook email address
+	 */
+	userEmailAddress: string
+	/**
+	 * The category ID (from list_outlook_categories).
+	 */
+	categoryId: string
+}
+
+/**
+ * Canonical Tool Core output for the "Delete Outlook Category" effect (`mail.deleteOutlookCategory`).
+ * This is the definition's output schema; the effect's script surface may
+ * re-encode it before returning.
+ */
+export type DeleteOutlookCategoryScriptOutput = {
+	/**
+	 * Tool output content.
+	 */
+	content: unknown
+	/**
+	 * Name of the Mail tool that ran.
+	 */
+	name: string
+	/**
+	 * Whether the Mail service reported a tool error.
+	 */
+	isError?: boolean
+	/**
+	 * Execution metadata reported by the MCP server.
+	 */
+	metadata?: {
+		/**
+		 * Tool execution time in milliseconds.
+		 */
+		executionTimeMs?: number
+		/**
+		 * Number of bytes processed by the tool.
+		 */
+		bytesProcessed?: number
+		/**
+		 * Tool execution cost reported by the MCP server.
+		 */
+		cost?: number
+	}
+	/**
+	 * Mail module name used for display.
+	 */
+	moduleName?: string
+	/**
+	 * Structured tool output when provided by the Mail service.
+	 */
+	structuredContent?: unknown
+	/**
+	 * Bounded HTTP-like Mail service error code.
+	 */
+	toolErrorCode?: number
+}
+
+/**
+ * Script input for the "Delete Outlook Rule" effect (`mail.deleteOutlookRule`),
+ * derived from its Tool Core definition's call_function input projection.
+ *
+ * Permanently delete an inbox rule from the user's Outlook mailbox
+ */
+export type DeleteOutlookRuleScriptInput = {
+	/**
+	 * Rule ID to delete (use list_outlook_rules to find IDs)
+	 */
+	ruleId: string
+	/**
+	 * Opaque etag from a prior list_outlook_rules response. If provided, the delete fails with an ABORTED error when the rule was modified since you listed it. Omit for last-write-wins.
+	 */
+	etag?: string
+	/**
+	 * The Outlook email address
+	 */
+	userEmailAddress: string
+}
+
+/**
+ * Canonical Tool Core output for the "Delete Outlook Rule" effect (`mail.deleteOutlookRule`).
+ * This is the definition's output schema; the effect's script surface may
+ * re-encode it before returning.
+ */
+export type DeleteOutlookRuleScriptOutput = {
+	/**
+	 * Tool output content.
+	 */
+	content: unknown
+	/**
+	 * Name of the Mail tool that ran.
+	 */
+	name: string
+	/**
+	 * Whether the Mail service reported a tool error.
+	 */
+	isError?: boolean
+	/**
+	 * Execution metadata reported by the MCP server.
+	 */
+	metadata?: {
+		/**
+		 * Tool execution time in milliseconds.
+		 */
+		executionTimeMs?: number
+		/**
+		 * Number of bytes processed by the tool.
+		 */
+		bytesProcessed?: number
+		/**
+		 * Tool execution cost reported by the MCP server.
+		 */
+		cost?: number
+	}
+	/**
+	 * Mail module name used for display.
+	 */
+	moduleName?: string
+	/**
+	 * Structured tool output when provided by the Mail service.
+	 */
+	structuredContent?: unknown
+	/**
+	 * Bounded HTTP-like Mail service error code.
+	 */
+	toolErrorCode?: number
+}
+
+/**
+ * Script input for the "Flag Outlook Thread" effect (`mail.flagOutlookThread`),
+ * derived from its Tool Core definition's call_function input projection.
+ *
+ * Set or clear the Outlook follow-up flag on one or more conversations, optionally with a reminder. Outlook's flag is the unified primitive for Gmail's star + reminder: pass flagged=true without reminderDateTime to 'star' the thread; pass flagged=true with reminderDateTime to schedule a reminder; pass flagged=false to clear both. Outlook accounts only — for Gmail accounts use star_thread or set_reminder / unset_reminder instead.
+ */
+export type FlagOutlookThreadScriptInput = {
+	/**
+	 * The Outlook email address
+	 */
+	userEmailAddress: string
+	/**
+	 * One or more Outlook conversation IDs (obtained from search_emails as threadId).
+	 */
+	conversationIDs: Array<string>
+	/**
+	 * true to flag the conversation, false to clear the flag and any reminder.
+	 */
+	flagged: boolean
+	/**
+	 * Optional ISO 8601 datetime (with offset) to fire a reminder at. Only honored when flagged=true.
+	 */
+	reminderDateTime?: string
+}
+
+/**
+ * Canonical Tool Core output for the "Flag Outlook Thread" effect (`mail.flagOutlookThread`).
+ * This is the definition's output schema; the effect's script surface may
+ * re-encode it before returning.
+ */
+export type FlagOutlookThreadScriptOutput = {
+	/**
+	 * Tool output content.
+	 */
+	content: unknown
+	/**
+	 * Name of the Mail tool that ran.
+	 */
+	name: string
+	/**
+	 * Whether the Mail service reported a tool error.
+	 */
+	isError?: boolean
+	/**
+	 * Execution metadata reported by the MCP server.
+	 */
+	metadata?: {
+		/**
+		 * Tool execution time in milliseconds.
+		 */
+		executionTimeMs?: number
+		/**
+		 * Number of bytes processed by the tool.
+		 */
+		bytesProcessed?: number
+		/**
+		 * Tool execution cost reported by the MCP server.
+		 */
+		cost?: number
+	}
+	/**
+	 * Mail module name used for display.
+	 */
+	moduleName?: string
+	/**
+	 * Structured tool output when provided by the Mail service.
+	 */
+	structuredContent?: unknown
+	/**
+	 * Bounded HTTP-like Mail service error code.
+	 */
+	toolErrorCode?: number
+}
+
+/**
+ * Script input for the "Get Notion Mail Notification Preferences" effect (`mail.getNotificationPreferences`),
+ * derived from its Tool Core definition's call_function input projection.
+ *
+ * Retrieve the Notion Mail notification preferences for the user's email accounts across all levels (account, view, and sender). This tool is specific to Notion Mail notification settings only — it does not read or modify notification settings for Gmail, Outlook, or any other email provider.
+ */
+export type GetNotificationPreferencesScriptInput = {
+	/**
+	 * The Notion Mail email address of the account to get notification preferences for. Must be an account connected to Notion Mail.
+	 */
+	userEmailAddress: string
+	/**
+	 * Filter which preference levels to return. Valid values: "account", "view", "sender". Omit to return all levels.
+	 */
+	levels?: Array<"account" | "view" | "sender">
+}
+
+/**
+ * Canonical Tool Core output for the "Get Notion Mail Notification Preferences" effect (`mail.getNotificationPreferences`).
+ * This is the definition's output schema; the effect's script surface may
+ * re-encode it before returning.
+ */
+export type GetNotificationPreferencesScriptOutput = {
+	/**
+	 * Tool output content.
+	 */
+	content: unknown
+	/**
+	 * Name of the Mail tool that ran.
+	 */
+	name: string
+	/**
+	 * Whether the Mail service reported a tool error.
+	 */
+	isError?: boolean
+	/**
+	 * Execution metadata reported by the MCP server.
+	 */
+	metadata?: {
+		/**
+		 * Tool execution time in milliseconds.
+		 */
+		executionTimeMs?: number
+		/**
+		 * Number of bytes processed by the tool.
+		 */
+		bytesProcessed?: number
+		/**
+		 * Tool execution cost reported by the MCP server.
+		 */
+		cost?: number
+	}
+	/**
+	 * Mail module name used for display.
+	 */
+	moduleName?: string
+	/**
+	 * Structured tool output when provided by the Mail service.
+	 */
+	structuredContent?: unknown
+	/**
+	 * Bounded HTTP-like Mail service error code.
+	 */
+	toolErrorCode?: number
+}
+
+/**
+ * Script input for the "Health Check" effect (`mail.healthCheck`),
+ * derived from its Tool Core definition's call_function input projection.
+ *
+ * Check if the mail service is healthy and accessible
+ */
+export type HealthCheckScriptInput = Record<string, unknown>
+
+/**
+ * Canonical Tool Core output for the "Health Check" effect (`mail.healthCheck`).
+ * This is the definition's output schema; the effect's script surface may
+ * re-encode it before returning.
+ */
+export type HealthCheckScriptOutput = {
+	/**
+	 * Tool output content.
+	 */
+	content: unknown
+	/**
+	 * Name of the Mail tool that ran.
+	 */
+	name: string
+	/**
+	 * Whether the Mail service reported a tool error.
+	 */
+	isError?: boolean
+	/**
+	 * Execution metadata reported by the MCP server.
+	 */
+	metadata?: {
+		/**
+		 * Tool execution time in milliseconds.
+		 */
+		executionTimeMs?: number
+		/**
+		 * Number of bytes processed by the tool.
+		 */
+		bytesProcessed?: number
+		/**
+		 * Tool execution cost reported by the MCP server.
+		 */
+		cost?: number
+	}
+	/**
+	 * Mail module name used for display.
+	 */
+	moduleName?: string
+	/**
+	 * Structured tool output when provided by the Mail service.
+	 */
+	structuredContent?: unknown
+	/**
+	 * Bounded HTTP-like Mail service error code.
+	 */
+	toolErrorCode?: number
+}
+
+/**
+ * Script input for the "List Gmail Filters" effect (`mail.listGmailFilters`),
+ * derived from its Tool Core definition's call_function input projection.
+ *
+ * List all Gmail filters for the user's account
+ */
+export type ListGmailFiltersScriptInput = {
+	/**
+	 * The email address of the Gmail account
+	 */
+	userEmailAddress: string
+}
+
+/**
+ * Canonical Tool Core output for the "List Gmail Filters" effect (`mail.listGmailFilters`).
+ * This is the definition's output schema; the effect's script surface may
+ * re-encode it before returning.
+ */
+export type ListGmailFiltersScriptOutput = {
+	/**
+	 * Tool output content.
+	 */
+	content: unknown
+	/**
+	 * Name of the Mail tool that ran.
+	 */
+	name: string
+	/**
+	 * Whether the Mail service reported a tool error.
+	 */
+	isError?: boolean
+	/**
+	 * Execution metadata reported by the MCP server.
+	 */
+	metadata?: {
+		/**
+		 * Tool execution time in milliseconds.
+		 */
+		executionTimeMs?: number
+		/**
+		 * Number of bytes processed by the tool.
+		 */
+		bytesProcessed?: number
+		/**
+		 * Tool execution cost reported by the MCP server.
+		 */
+		cost?: number
+	}
+	/**
+	 * Mail module name used for display.
+	 */
+	moduleName?: string
+	/**
+	 * Structured tool output when provided by the Mail service.
+	 */
+	structuredContent?: unknown
+	/**
+	 * Bounded HTTP-like Mail service error code.
+	 */
+	toolErrorCode?: number
+}
+
+/**
+ * Script input for the "List Labels" effect (`mail.listLabels`),
+ * derived from its Tool Core definition's call_function input projection.
+ *
+ * List all labels in the mailbox
+ */
+export type ListLabelsScriptInput = {
+	/**
+	 * The email address of the mailbox
+	 */
+	userEmailAddress: string
+}
+
+/**
+ * Canonical Tool Core output for the "List Labels" effect (`mail.listLabels`).
+ * This is the definition's output schema; the effect's script surface may
+ * re-encode it before returning.
+ */
+export type ListLabelsScriptOutput = {
+	/**
+	 * Tool output content.
+	 */
+	content: unknown
+	/**
+	 * Name of the Mail tool that ran.
+	 */
+	name: string
+	/**
+	 * Whether the Mail service reported a tool error.
+	 */
+	isError?: boolean
+	/**
+	 * Execution metadata reported by the MCP server.
+	 */
+	metadata?: {
+		/**
+		 * Tool execution time in milliseconds.
+		 */
+		executionTimeMs?: number
+		/**
+		 * Number of bytes processed by the tool.
+		 */
+		bytesProcessed?: number
+		/**
+		 * Tool execution cost reported by the MCP server.
+		 */
+		cost?: number
+	}
+	/**
+	 * Mail module name used for display.
+	 */
+	moduleName?: string
+	/**
+	 * Structured tool output when provided by the Mail service.
+	 */
+	structuredContent?: unknown
+	/**
+	 * Bounded HTTP-like Mail service error code.
+	 */
+	toolErrorCode?: number
+}
+
+/**
+ * Script input for the "List Mailbox Views" effect (`mail.listMailboxViews`),
+ * derived from its Tool Core definition's call_function input projection.
+ *
+ * List the user's notification-eligible mailbox views: the Inbox plus custom user-created views. Other system views (Sent, Drafts, Trash, Spam) and suggested views are NOT returned.
+ */
+export type ListMailboxViewsScriptInput = {
+	/**
+	 * The email address of the mailbox
+	 */
+	userEmailAddress: string
+}
+
+/**
+ * Canonical Tool Core output for the "List Mailbox Views" effect (`mail.listMailboxViews`).
+ * This is the definition's output schema; the effect's script surface may
+ * re-encode it before returning.
+ */
+export type ListMailboxViewsScriptOutput = {
+	/**
+	 * Tool output content.
+	 */
+	content: unknown
+	/**
+	 * Name of the Mail tool that ran.
+	 */
+	name: string
+	/**
+	 * Whether the Mail service reported a tool error.
+	 */
+	isError?: boolean
+	/**
+	 * Execution metadata reported by the MCP server.
+	 */
+	metadata?: {
+		/**
+		 * Tool execution time in milliseconds.
+		 */
+		executionTimeMs?: number
+		/**
+		 * Number of bytes processed by the tool.
+		 */
+		bytesProcessed?: number
+		/**
+		 * Tool execution cost reported by the MCP server.
+		 */
+		cost?: number
+	}
+	/**
+	 * Mail module name used for display.
+	 */
+	moduleName?: string
+	/**
+	 * Structured tool output when provided by the Mail service.
+	 */
+	structuredContent?: unknown
+	/**
+	 * Bounded HTTP-like Mail service error code.
+	 */
+	toolErrorCode?: number
+}
+
+/**
+ * Script input for the "List Outlook Categories" effect (`mail.listOutlookCategories`),
+ * derived from its Tool Core definition's call_function input projection.
+ *
+ * List all categories in the user's Outlook master category list
+ */
+export type ListOutlookCategoriesScriptInput = {
+	/**
+	 * The Outlook email address
+	 */
+	userEmailAddress: string
+}
+
+/**
+ * Canonical Tool Core output for the "List Outlook Categories" effect (`mail.listOutlookCategories`).
+ * This is the definition's output schema; the effect's script surface may
+ * re-encode it before returning.
+ */
+export type ListOutlookCategoriesScriptOutput = {
+	/**
+	 * Tool output content.
+	 */
+	content: unknown
+	/**
+	 * Name of the Mail tool that ran.
+	 */
+	name: string
+	/**
+	 * Whether the Mail service reported a tool error.
+	 */
+	isError?: boolean
+	/**
+	 * Execution metadata reported by the MCP server.
+	 */
+	metadata?: {
+		/**
+		 * Tool execution time in milliseconds.
+		 */
+		executionTimeMs?: number
+		/**
+		 * Number of bytes processed by the tool.
+		 */
+		bytesProcessed?: number
+		/**
+		 * Tool execution cost reported by the MCP server.
+		 */
+		cost?: number
+	}
+	/**
+	 * Mail module name used for display.
+	 */
+	moduleName?: string
+	/**
+	 * Structured tool output when provided by the Mail service.
+	 */
+	structuredContent?: unknown
+	/**
+	 * Bounded HTTP-like Mail service error code.
+	 */
+	toolErrorCode?: number
+}
+
+/**
+ * Script input for the "List Outlook Folders" effect (`mail.listOutlookFolders`),
+ * derived from its Tool Core definition's call_function input projection.
+ *
+ * List all mail folders in the user's Outlook mailbox
+ */
+export type ListOutlookFoldersScriptInput = {
+	/**
+	 * The email address of the Outlook mailbox
+	 */
+	userEmailAddress: string
+}
+
+/**
+ * Canonical Tool Core output for the "List Outlook Folders" effect (`mail.listOutlookFolders`).
+ * This is the definition's output schema; the effect's script surface may
+ * re-encode it before returning.
+ */
+export type ListOutlookFoldersScriptOutput = {
+	/**
+	 * Tool output content.
+	 */
+	content: unknown
+	/**
+	 * Name of the Mail tool that ran.
+	 */
+	name: string
+	/**
+	 * Whether the Mail service reported a tool error.
+	 */
+	isError?: boolean
+	/**
+	 * Execution metadata reported by the MCP server.
+	 */
+	metadata?: {
+		/**
+		 * Tool execution time in milliseconds.
+		 */
+		executionTimeMs?: number
+		/**
+		 * Number of bytes processed by the tool.
+		 */
+		bytesProcessed?: number
+		/**
+		 * Tool execution cost reported by the MCP server.
+		 */
+		cost?: number
+	}
+	/**
+	 * Mail module name used for display.
+	 */
+	moduleName?: string
+	/**
+	 * Structured tool output when provided by the Mail service.
+	 */
+	structuredContent?: unknown
+	/**
+	 * Bounded HTTP-like Mail service error code.
+	 */
+	toolErrorCode?: number
+}
+
+/**
+ * Script input for the "List Outlook Rules" effect (`mail.listOutlookRules`),
+ * derived from its Tool Core definition's call_function input projection.
+ *
+ * List all inbox rules configured in the user's Outlook mailbox
+ */
+export type ListOutlookRulesScriptInput = {
+	/**
+	 * The Outlook email address
+	 */
+	userEmailAddress: string
+}
+
+/**
+ * Canonical Tool Core output for the "List Outlook Rules" effect (`mail.listOutlookRules`).
+ * This is the definition's output schema; the effect's script surface may
+ * re-encode it before returning.
+ */
+export type ListOutlookRulesScriptOutput = {
+	/**
+	 * Tool output content.
+	 */
+	content: unknown
+	/**
+	 * Name of the Mail tool that ran.
+	 */
+	name: string
+	/**
+	 * Whether the Mail service reported a tool error.
+	 */
+	isError?: boolean
+	/**
+	 * Execution metadata reported by the MCP server.
+	 */
+	metadata?: {
+		/**
+		 * Tool execution time in milliseconds.
+		 */
+		executionTimeMs?: number
+		/**
+		 * Number of bytes processed by the tool.
+		 */
+		bytesProcessed?: number
+		/**
+		 * Tool execution cost reported by the MCP server.
+		 */
+		cost?: number
+	}
+	/**
+	 * Mail module name used for display.
+	 */
+	moduleName?: string
+	/**
+	 * Structured tool output when provided by the Mail service.
+	 */
+	structuredContent?: unknown
+	/**
+	 * Bounded HTTP-like Mail service error code.
+	 */
+	toolErrorCode?: number
+}
+
+/**
+ * Script input for the "List Status Properties" effect (`mail.listStatusProperties`),
+ * derived from its Tool Core definition's call_function input projection.
+ *
+ * List available status properties (columns) for emails
+ */
+export type ListStatusPropertiesScriptInput = {
+	/**
+	 * The email address of the mailbox
+	 */
+	userEmailAddress: string
+}
+
+/**
+ * Canonical Tool Core output for the "List Status Properties" effect (`mail.listStatusProperties`).
+ * This is the definition's output schema; the effect's script surface may
+ * re-encode it before returning.
+ */
+export type ListStatusPropertiesScriptOutput = {
+	/**
+	 * Tool output content.
+	 */
+	content: unknown
+	/**
+	 * Name of the Mail tool that ran.
+	 */
+	name: string
+	/**
+	 * Whether the Mail service reported a tool error.
+	 */
+	isError?: boolean
+	/**
+	 * Execution metadata reported by the MCP server.
+	 */
+	metadata?: {
+		/**
+		 * Tool execution time in milliseconds.
+		 */
+		executionTimeMs?: number
+		/**
+		 * Number of bytes processed by the tool.
+		 */
+		bytesProcessed?: number
+		/**
+		 * Tool execution cost reported by the MCP server.
+		 */
+		cost?: number
+	}
+	/**
+	 * Mail module name used for display.
+	 */
+	moduleName?: string
+	/**
+	 * Structured tool output when provided by the Mail service.
+	 */
+	structuredContent?: unknown
+	/**
+	 * Bounded HTTP-like Mail service error code.
+	 */
+	toolErrorCode?: number
+}
+
+/**
+ * Script input for the "Mark as Spam" effect (`mail.markThreadSpam`),
+ * derived from its Tool Core definition's call_function input projection.
+ *
+ * Mark one or more email threads as spam
+ */
+export type MarkThreadSpamScriptInput = {
+	/**
+	 * The email address of the mailbox
+	 */
+	userEmailAddress: string
+	/**
+	 * Array of thread IDs to mark as spam
+	 */
+	threadIds: Array<string>
+}
+
+/**
+ * Canonical Tool Core output for the "Mark as Spam" effect (`mail.markThreadSpam`).
+ * This is the definition's output schema; the effect's script surface may
+ * re-encode it before returning.
+ */
+export type MarkThreadSpamScriptOutput = {
+	/**
+	 * Tool output content.
+	 */
+	content: unknown
+	/**
+	 * Name of the Mail tool that ran.
+	 */
+	name: string
+	/**
+	 * Whether the Mail service reported a tool error.
+	 */
+	isError?: boolean
+	/**
+	 * Execution metadata reported by the MCP server.
+	 */
+	metadata?: {
+		/**
+		 * Tool execution time in milliseconds.
+		 */
+		executionTimeMs?: number
+		/**
+		 * Number of bytes processed by the tool.
+		 */
+		bytesProcessed?: number
+		/**
+		 * Tool execution cost reported by the MCP server.
+		 */
+		cost?: number
+	}
+	/**
+	 * Mail module name used for display.
+	 */
+	moduleName?: string
+	/**
+	 * Structured tool output when provided by the Mail service.
+	 */
+	structuredContent?: unknown
+	/**
+	 * Bounded HTTP-like Mail service error code.
+	 */
+	toolErrorCode?: number
+}
+
+/**
+ * Script input for the "Move to Inbox" effect (`mail.moveThreadToInbox`),
+ * derived from its Tool Core definition's call_function input projection.
+ *
+ * Move threads that aren't currently in the inbox back to the inbox, i.e. threads in Archive, Trash or Spam. Note that finding threads in Spam or Trash requires the use of relevant search parameters: Gmail, pass includeSpamTrash to searchEmails; Outlook, search searchOutlookEmails with filters.folder: "deleted" or "junk".
+ */
+export type MoveThreadToInboxScriptInput = {
+	/**
+	 * The email address of the mailbox
+	 */
+	userEmailAddress: string
+	/**
+	 * Array of thread IDs to move to inbox
+	 */
+	threadIds: Array<string>
+}
+
+/**
+ * Canonical Tool Core output for the "Move to Inbox" effect (`mail.moveThreadToInbox`).
+ * This is the definition's output schema; the effect's script surface may
+ * re-encode it before returning.
+ */
+export type MoveThreadToInboxScriptOutput = {
+	/**
+	 * Tool output content.
+	 */
+	content: unknown
+	/**
+	 * Name of the Mail tool that ran.
+	 */
+	name: string
+	/**
+	 * Whether the Mail service reported a tool error.
+	 */
+	isError?: boolean
+	/**
+	 * Execution metadata reported by the MCP server.
+	 */
+	metadata?: {
+		/**
+		 * Tool execution time in milliseconds.
+		 */
+		executionTimeMs?: number
+		/**
+		 * Number of bytes processed by the tool.
+		 */
+		bytesProcessed?: number
+		/**
+		 * Tool execution cost reported by the MCP server.
+		 */
+		cost?: number
+	}
+	/**
+	 * Mail module name used for display.
+	 */
+	moduleName?: string
+	/**
+	 * Structured tool output when provided by the Mail service.
+	 */
+	structuredContent?: unknown
+	/**
+	 * Bounded HTTP-like Mail service error code.
+	 */
+	toolErrorCode?: number
+}
+
+/**
+ * Script input for the "Move to Outlook Folder" effect (`mail.moveToOutlookFolder`),
+ * derived from its Tool Core definition's call_function input projection.
+ *
+ * Move one or more email threads to a specific folder in the user's Outlook mailbox
+ */
+export type MoveToOutlookFolderScriptInput = {
+	/**
+	 * The email address of the Outlook mailbox
+	 */
+	userEmailAddress: string
+	/**
+	 * Array of thread IDs to move
+	 */
+	threadIds: Array<string>
+	/**
+	 * The ID of the destination folder, or a well-known folder name: inbox, archive, deleteditems, junkemail, sentitems, drafts
+	 */
+	destinationFolderId: string
+}
+
+/**
+ * Canonical Tool Core output for the "Move to Outlook Folder" effect (`mail.moveToOutlookFolder`).
+ * This is the definition's output schema; the effect's script surface may
+ * re-encode it before returning.
+ */
+export type MoveToOutlookFolderScriptOutput = {
+	/**
+	 * Tool output content.
+	 */
+	content: unknown
+	/**
+	 * Name of the Mail tool that ran.
+	 */
+	name: string
+	/**
+	 * Whether the Mail service reported a tool error.
+	 */
+	isError?: boolean
+	/**
+	 * Execution metadata reported by the MCP server.
+	 */
+	metadata?: {
+		/**
+		 * Tool execution time in milliseconds.
+		 */
+		executionTimeMs?: number
+		/**
+		 * Number of bytes processed by the tool.
+		 */
+		bytesProcessed?: number
+		/**
+		 * Tool execution cost reported by the MCP server.
+		 */
+		cost?: number
+	}
+	/**
+	 * Mail module name used for display.
+	 */
+	moduleName?: string
+	/**
+	 * Structured tool output when provided by the Mail service.
+	 */
+	structuredContent?: unknown
+	/**
+	 * Bounded HTTP-like Mail service error code.
+	 */
+	toolErrorCode?: number
+}
+
+/**
+ * Script input for the "Read Attachment" effect (`mail.readAttachment`),
+ * derived from its Tool Core definition's call_function input projection.
+ *
+ * Fetch the content of an email attachment by its attachment ID. Use after view_thread_content to read a specific attachment. Images are returned visually. Text files are returned as readable text. PDFs are uploaded as thread attachments you can read. Other binary files (docx, xlsx, zip, etc.) cannot be read directly.
+ */
+export type ReadAttachmentScriptInput = {
+	/**
+	 * The email address of the mailbox
+	 */
+	userEmailAddress: string
+	/**
+	 * Gmail message ID containing the attachment (from view_thread_content)
+	 */
+	messageId: string
+	/**
+	 * Attachment ID (from the attachments array in view_thread_content)
+	 */
+	attachmentId: string
+}
+
+/**
+ * Canonical Tool Core output for the "Read Attachment" effect (`mail.readAttachment`).
+ * This is the definition's output schema; the effect's script surface may
+ * re-encode it before returning.
+ */
+export type ReadAttachmentScriptOutput = {
+	/**
+	 * Tool output content.
+	 */
+	content: unknown
+	/**
+	 * Name of the Mail tool that ran.
+	 */
+	name: string
+	/**
+	 * Whether the Mail service reported a tool error.
+	 */
+	isError?: boolean
+	/**
+	 * Execution metadata reported by the MCP server.
+	 */
+	metadata?: {
+		/**
+		 * Tool execution time in milliseconds.
+		 */
+		executionTimeMs?: number
+		/**
+		 * Number of bytes processed by the tool.
+		 */
+		bytesProcessed?: number
+		/**
+		 * Tool execution cost reported by the MCP server.
+		 */
+		cost?: number
+	}
+	/**
+	 * Mail module name used for display.
+	 */
+	moduleName?: string
+	/**
+	 * Structured tool output when provided by the Mail service.
+	 */
+	structuredContent?: unknown
+	/**
+	 * Bounded HTTP-like Mail service error code.
+	 */
+	toolErrorCode?: number
+}
+
+/**
+ * Script input for the "Remove Outlook Categories" effect (`mail.removeOutlookCategories`),
+ * derived from its Tool Core definition's call_function input projection.
+ *
+ * Remove categories from all messages in the specified Outlook conversations.
+ */
+export type RemoveOutlookCategoriesScriptInput = {
+	/**
+	 * The Outlook email address
+	 */
+	userEmailAddress: string
+	/**
+	 * Outlook conversation IDs (from search_emails threadId)
+	 */
+	conversationIDs: Array<string>
+	/**
+	 * Category display names to remove (case-sensitive)
+	 */
+	categoryNames: Array<string>
+}
+
+/**
+ * Canonical Tool Core output for the "Remove Outlook Categories" effect (`mail.removeOutlookCategories`).
+ * This is the definition's output schema; the effect's script surface may
+ * re-encode it before returning.
+ */
+export type RemoveOutlookCategoriesScriptOutput = {
+	/**
+	 * Tool output content.
+	 */
+	content: unknown
+	/**
+	 * Name of the Mail tool that ran.
+	 */
+	name: string
+	/**
+	 * Whether the Mail service reported a tool error.
+	 */
+	isError?: boolean
+	/**
+	 * Execution metadata reported by the MCP server.
+	 */
+	metadata?: {
+		/**
+		 * Tool execution time in milliseconds.
+		 */
+		executionTimeMs?: number
+		/**
+		 * Number of bytes processed by the tool.
+		 */
+		bytesProcessed?: number
+		/**
+		 * Tool execution cost reported by the MCP server.
+		 */
+		cost?: number
+	}
+	/**
+	 * Mail module name used for display.
+	 */
+	moduleName?: string
+	/**
+	 * Structured tool output when provided by the Mail service.
+	 */
+	structuredContent?: unknown
+	/**
+	 * Bounded HTTP-like Mail service error code.
+	 */
+	toolErrorCode?: number
+}
+
+/**
+ * Script input for the "Remove Sender from Notion Mail Notification Allowlist" effect (`mail.removeSenderNotificationPreferences`),
+ * derived from its Tool Core definition's call_function input projection.
+ *
+ * Remove sender email addresses from the Notion Mail notification allowlist. Once removed, notifications for their emails will follow the standard view-level settings. This tool is specific to Notion Mail notification settings only. Takes effect immediately.
+ */
+export type RemoveSenderNotificationPreferencesScriptInput = {
+	/**
+	 * The Notion Mail email address of the account. Must be an account connected to Notion Mail.
+	 */
+	userEmailAddress: string
+	/**
+	 * Sender email addresses to remove from the notification allowlist. Required unless removeAll is true.
+	 */
+	senderAddresses?: Array<string>
+	/**
+	 * Set to true to clear the entire notification allowlist. Either senderAddresses or removeAll must be provided.
+	 */
+	removeAll?: boolean
+}
+
+/**
+ * Canonical Tool Core output for the "Remove Sender from Notion Mail Notification Allowlist" effect (`mail.removeSenderNotificationPreferences`).
+ * This is the definition's output schema; the effect's script surface may
+ * re-encode it before returning.
+ */
+export type RemoveSenderNotificationPreferencesScriptOutput = {
+	/**
+	 * Tool output content.
+	 */
+	content: unknown
+	/**
+	 * Name of the Mail tool that ran.
+	 */
+	name: string
+	/**
+	 * Whether the Mail service reported a tool error.
+	 */
+	isError?: boolean
+	/**
+	 * Execution metadata reported by the MCP server.
+	 */
+	metadata?: {
+		/**
+		 * Tool execution time in milliseconds.
+		 */
+		executionTimeMs?: number
+		/**
+		 * Number of bytes processed by the tool.
+		 */
+		bytesProcessed?: number
+		/**
+		 * Tool execution cost reported by the MCP server.
+		 */
+		cost?: number
+	}
+	/**
+	 * Mail module name used for display.
+	 */
+	moduleName?: string
+	/**
+	 * Structured tool output when provided by the Mail service.
+	 */
+	structuredContent?: unknown
+	/**
+	 * Bounded HTTP-like Mail service error code.
+	 */
+	toolErrorCode?: number
+}
+
+/**
+ * Script input for the "Remove Labels" effect (`mail.removeUserLabels`),
+ * derived from its Tool Core definition's call_function input projection.
+ *
+ * Remove user-created labels from email threads
+ */
+export type RemoveUserLabelsScriptInput = {
+	/**
+	 * The email address of the mailbox
+	 */
+	userEmailAddress: string
+	/**
+	 * Array of thread IDs to unlabel
+	 */
+	threadIds: Array<string>
+	/**
+	 * Names of labels to remove
+	 */
+	labelNames: Array<string>
+}
+
+/**
+ * Canonical Tool Core output for the "Remove Labels" effect (`mail.removeUserLabels`).
+ * This is the definition's output schema; the effect's script surface may
+ * re-encode it before returning.
+ */
+export type RemoveUserLabelsScriptOutput = {
+	/**
+	 * Tool output content.
+	 */
+	content: unknown
+	/**
+	 * Name of the Mail tool that ran.
+	 */
+	name: string
+	/**
+	 * Whether the Mail service reported a tool error.
+	 */
+	isError?: boolean
+	/**
+	 * Execution metadata reported by the MCP server.
+	 */
+	metadata?: {
+		/**
+		 * Tool execution time in milliseconds.
+		 */
+		executionTimeMs?: number
+		/**
+		 * Number of bytes processed by the tool.
+		 */
+		bytesProcessed?: number
+		/**
+		 * Tool execution cost reported by the MCP server.
+		 */
+		cost?: number
+	}
+	/**
+	 * Mail module name used for display.
+	 */
+	moduleName?: string
+	/**
+	 * Structured tool output when provided by the Mail service.
+	 */
+	structuredContent?: unknown
+	/**
+	 * Bounded HTTP-like Mail service error code.
+	 */
+	toolErrorCode?: number
+}
+
+/**
+ * Script input for the "Search Emails" effect (`mail.searchEmails`),
+ * derived from its Tool Core definition's call_function input projection.
+ *
+ * Search for emails in the user's mailbox using Gmail query syntax.
+ */
+export type SearchEmailsScriptInput = {
+	/**
+	 * The email address of the mailbox to search in
+	 */
+	userEmailAddress: string
+	/**
+	 * Search query string using Gmail-style search operators (e.g. from:, is:unread, newer_than:1d, after:/before:, subject:). For topic or digest requests, prefer recency (newer_than:1d) and/or sender (from:) filters over subject: keyword filtering: subjects don't reliably contain the topic word, so don't rely on subject alone, and when filtering by subject/body cover synonyms rather than over-filtering one term. For Gmail date bounds, after:/before: take a plain date with no time component (slashes or dashes both work) — GOOD: before:2026/05/08 or before:2026-05-08; BAD: before:2026-05-08T16:00 (a time component is not valid Gmail syntax and silently returns nothing); prefer newer_than:Nd for recency.
+	 */
+	query: string
+	/**
+	 * Number of results to return (default: 20, max: 500)
+	 */
+	count?: number
+	/**
+	 * Pagination token from previous search results
+	 */
+	pageToken?: string
+	/**
+	 * Whether to include spam and trash in results
+	 */
+	includeSpamTrash?: boolean
+}
+
+/**
+ * Canonical Tool Core output for the "Search Emails" effect (`mail.searchEmails`).
+ * This is the definition's output schema; the effect's script surface may
+ * re-encode it before returning.
+ */
+export type SearchEmailsScriptOutput = {
+	/**
+	 * Tool output content.
+	 */
+	content: unknown
+	/**
+	 * Name of the Mail tool that ran.
+	 */
+	name: string
+	/**
+	 * Whether the Mail service reported a tool error.
+	 */
+	isError?: boolean
+	/**
+	 * Execution metadata reported by the MCP server.
+	 */
+	metadata?: {
+		/**
+		 * Tool execution time in milliseconds.
+		 */
+		executionTimeMs?: number
+		/**
+		 * Number of bytes processed by the tool.
+		 */
+		bytesProcessed?: number
+		/**
+		 * Tool execution cost reported by the MCP server.
+		 */
+		cost?: number
+	}
+	/**
+	 * Mail module name used for display.
+	 */
+	moduleName?: string
+	/**
+	 * Structured tool output when provided by the Mail service.
+	 */
+	structuredContent?: unknown
+	/**
+	 * Bounded HTTP-like Mail service error code.
+	 */
+	toolErrorCode?: number
+}
+
+/**
+ * Script input for the "Search Outlook Emails" effect (`mail.searchOutlookEmails`),
+ * derived from its Tool Core definition's call_function input projection.
+ *
+ * Search an Outlook mailbox using structured filters and/or keyword queries. Use this instead of search_emails for Outlook accounts. For multi-sender (OR), negation (NOT), or complex boolean queries that structured filters cannot express, use query with KQL operators.
+ */
+export type SearchOutlookEmailsScriptInput = {
+	/**
+	 * The email address of the Outlook mailbox to search
+	 */
+	userEmailAddress: string
+	/**
+	 * KQL keyword query string. Use for keyword/semantic search and complex boolean logic (OR, NOT, parentheses). Use filters for metadata constraints. When combining with filters, the backend merges them optimally.
+	 */
+	query?: string
+	/**
+	 * Number of results to return (default: 20, max: 500)
+	 */
+	count?: number
+	/**
+	 * Pagination token from previous search results
+	 */
+	pageToken?: string
+	/**
+	 * Structured filters for metadata-based search. The backend picks the optimal API strategy ($search, $filter, or both). All filters are AND-combined. Array fields use OR within the array.
+	 */
+	filters?: {
+		/**
+		 * Sender email addresses (OR within array). E.g., ['alice@co.com', 'bob@co.com'] matches emails from either sender. If only the display name is known, use query with 'from:Name' instead.
+		 */
+		fromAddresses?: Array<string>
+		/**
+		 * Recipient email addresses (OR within array). Note: forces full-text search mode (OData cannot filter recipients).
+		 */
+		toAddresses?: Array<string>
+		/**
+		 * Start of date range in ISO 8601 format (e.g., '2026-01-01' or '2026-01-01T00:00:00Z')
+		 */
+		dateFrom?: string
+		/**
+		 * End of date range in ISO 8601 format. Inclusive — '2026-03-23' includes the full day (through 23:59:59Z).
+		 */
+		dateTo?: string
+		/**
+		 * Filter for emails with/without attachments
+		 */
+		hasAttachments?: boolean
+		/**
+		 * Filter by read status. ONLY available via filters (not in KQL).
+		 */
+		isRead?: boolean
+		/**
+		 * Filter by importance level
+		 */
+		importance?: "high" | "normal" | "low"
+		/**
+		 * Scope search to a specific folder. Use well-known names (inbox, sent, drafts, archive, deleted, junk) or a folder ID from listOutlookFolders for user-created folders. Omit to search all folders.
+		 */
+		folder?: string
+		/**
+		 * Filter for draft messages. Scopes to the drafts folder. ONLY available via filters (not in KQL).
+		 */
+		isDraft?: boolean
+		/**
+		 * Outlook user-defined category tags (OR within array). E.g., ['Project X', 'Urgent'] matches emails with either category. ONLY available via filters (not in KQL).
+		 */
+		categories?: Array<string>
+	}
+}
+
+/**
+ * Canonical Tool Core output for the "Search Outlook Emails" effect (`mail.searchOutlookEmails`).
+ * This is the definition's output schema; the effect's script surface may
+ * re-encode it before returning.
+ */
+export type SearchOutlookEmailsScriptOutput = {
+	/**
+	 * Tool output content.
+	 */
+	content: unknown
+	/**
+	 * Name of the Mail tool that ran.
+	 */
+	name: string
+	/**
+	 * Whether the Mail service reported a tool error.
+	 */
+	isError?: boolean
+	/**
+	 * Execution metadata reported by the MCP server.
+	 */
+	metadata?: {
+		/**
+		 * Tool execution time in milliseconds.
+		 */
+		executionTimeMs?: number
+		/**
+		 * Number of bytes processed by the tool.
+		 */
+		bytesProcessed?: number
+		/**
+		 * Tool execution cost reported by the MCP server.
+		 */
+		cost?: number
+	}
+	/**
+	 * Mail module name used for display.
+	 */
+	moduleName?: string
+	/**
+	 * Structured tool output when provided by the Mail service.
+	 */
+	structuredContent?: unknown
+	/**
+	 * Bounded HTTP-like Mail service error code.
+	 */
+	toolErrorCode?: number
+}
+
+/**
+ * Script input for the "Send Draft" effect (`mail.sendExistingDraft`),
+ * derived from its Tool Core definition's call_function input projection.
+ *
+ * Send an existing draft email (often from the return value of a create-or-update draft tool, but may also be explicitly provided by the user or a data source within the workspace).
+ */
+export type SendExistingDraftScriptInput = {
+	/**
+	 * The user's email address
+	 */
+	userEmailAddress: string
+	/**
+	 * Draft identifier to send. Usually gmailDraft.draftID from create_or_update_draft_all_clients or draftId from create_or_update_outlook_draft; may also be an existing provider draft ID the user explicitly gave you.
+	 */
+	draftId: string
+}
+
+/**
+ * Canonical Tool Core output for the "Send Draft" effect (`mail.sendExistingDraft`).
+ * This is the definition's output schema; the effect's script surface may
+ * re-encode it before returning.
+ */
+export type SendExistingDraftScriptOutput = {
+	/**
+	 * Tool output content.
+	 */
+	content: unknown
+	/**
+	 * Name of the Mail tool that ran.
+	 */
+	name: string
+	/**
+	 * Whether the Mail service reported a tool error.
+	 */
+	isError?: boolean
+	/**
+	 * Execution metadata reported by the MCP server.
+	 */
+	metadata?: {
+		/**
+		 * Tool execution time in milliseconds.
+		 */
+		executionTimeMs?: number
+		/**
+		 * Number of bytes processed by the tool.
+		 */
+		bytesProcessed?: number
+		/**
+		 * Tool execution cost reported by the MCP server.
+		 */
+		cost?: number
+	}
+	/**
+	 * Mail module name used for display.
+	 */
+	moduleName?: string
+	/**
+	 * Structured tool output when provided by the Mail service.
+	 */
+	structuredContent?: unknown
+	/**
+	 * Bounded HTTP-like Mail service error code.
+	 */
+	toolErrorCode?: number
+}
+
+/**
+ * Script input for the "Send Email" effect (`mail.sendNewEmail`),
+ * derived from its Tool Core definition's call_function input projection.
+ *
+ * Send a new email immediately. Supports both standalone emails and direct replies to threads.
+ */
+export type SendNewEmailScriptInput = {
+	/**
+	 * The user's email address
+	 */
+	userEmailAddress: string
+	/**
+	 * Sender address owned by the user
+	 */
+	from: {
+		address: string
+		name?: string
+	}
+	/**
+	 * Primary recipients. Required for all emails.
+	 */
+	to: Array<{
+		address: string
+		name?: string
+	}>
+	/**
+	 * CC recipients
+	 */
+	cc?: Array<{
+		address: string
+		name?: string
+	}>
+	/**
+	 * BCC recipients
+	 */
+	bcc?: Array<{
+		address: string
+		name?: string
+	}>
+	/**
+	 * Subject line. Required for new threads, optional for replies.
+	 */
+	subject?: string
+	/**
+	 * Plain text email body
+	 */
+	text?: string
+	/**
+	 * HTML email body
+	 */
+	html?: string
+	/**
+	 * Thread ID for replies
+	 */
+	parentThreadId?: string
+	/**
+	 * Specific message ID to reply to. Defaults to latest message.
+	 */
+	parentMessageId?: string
+}
+
+/**
+ * Canonical Tool Core output for the "Send Email" effect (`mail.sendNewEmail`).
+ * This is the definition's output schema; the effect's script surface may
+ * re-encode it before returning.
+ */
+export type SendNewEmailScriptOutput = {
+	/**
+	 * Tool output content.
+	 */
+	content: unknown
+	/**
+	 * Name of the Mail tool that ran.
+	 */
+	name: string
+	/**
+	 * Whether the Mail service reported a tool error.
+	 */
+	isError?: boolean
+	/**
+	 * Execution metadata reported by the MCP server.
+	 */
+	metadata?: {
+		/**
+		 * Tool execution time in milliseconds.
+		 */
+		executionTimeMs?: number
+		/**
+		 * Number of bytes processed by the tool.
+		 */
+		bytesProcessed?: number
+		/**
+		 * Tool execution cost reported by the MCP server.
+		 */
+		cost?: number
+	}
+	/**
+	 * Mail module name used for display.
+	 */
+	moduleName?: string
+	/**
+	 * Structured tool output when provided by the Mail service.
+	 */
+	structuredContent?: unknown
+	/**
+	 * Bounded HTTP-like Mail service error code.
+	 */
+	toolErrorCode?: number
+}
+
+/**
+ * Script input for the "Set Notion Mail Notification Preference" effect (`mail.setAccountNotificationPreference`),
+ * derived from its Tool Core definition's call_function input projection.
+ *
+ * Enable or disable Notion Mail push notifications at the account level for a specific email account. This is an account-level setting that applies to all notifications for the account across all channels (iOS, Android, web push, desktop). This tool is specific to Notion Mail notification settings only — it does not modify notification settings for Gmail, Outlook, or any other email provider. Takes effect immediately.
+ */
+export type SetAccountNotificationPreferenceScriptInput = {
+	/**
+	 * The Notion Mail email address of the account to update notification preferences for. Must be an account connected to Notion Mail.
+	 */
+	userEmailAddress: string
+	/**
+	 * Whether to enable (true) or disable (false) Notion Mail push notifications for this account
+	 */
+	enabled: boolean
+}
+
+/**
+ * Canonical Tool Core output for the "Set Notion Mail Notification Preference" effect (`mail.setAccountNotificationPreference`).
+ * This is the definition's output schema; the effect's script surface may
+ * re-encode it before returning.
+ */
+export type SetAccountNotificationPreferenceScriptOutput = {
+	/**
+	 * Tool output content.
+	 */
+	content: unknown
+	/**
+	 * Name of the Mail tool that ran.
+	 */
+	name: string
+	/**
+	 * Whether the Mail service reported a tool error.
+	 */
+	isError?: boolean
+	/**
+	 * Execution metadata reported by the MCP server.
+	 */
+	metadata?: {
+		/**
+		 * Tool execution time in milliseconds.
+		 */
+		executionTimeMs?: number
+		/**
+		 * Number of bytes processed by the tool.
+		 */
+		bytesProcessed?: number
+		/**
+		 * Tool execution cost reported by the MCP server.
+		 */
+		cost?: number
+	}
+	/**
+	 * Mail module name used for display.
+	 */
+	moduleName?: string
+	/**
+	 * Structured tool output when provided by the Mail service.
+	 */
+	structuredContent?: unknown
+	/**
+	 * Bounded HTTP-like Mail service error code.
+	 */
+	toolErrorCode?: number
+}
+
+/**
+ * Script input for the "Set Read Status" effect (`mail.setReadStatus`),
+ * derived from its Tool Core definition's call_function input projection.
+ *
+ * Mark one or more email threads as read or unread
+ */
+export type SetReadStatusScriptInput = {
+	/**
+	 * The email address of the mailbox
+	 */
+	userEmailAddress: string
+	/**
+	 * Array of thread IDs to update (Gmail thread IDs or Outlook conversation IDs)
+	 */
+	threadIds: Array<string>
+	/**
+	 * Whether to mark as read (true) or unread (false)
+	 */
+	read: boolean
+}
+
+/**
+ * Canonical Tool Core output for the "Set Read Status" effect (`mail.setReadStatus`).
+ * This is the definition's output schema; the effect's script surface may
+ * re-encode it before returning.
+ */
+export type SetReadStatusScriptOutput = {
+	/**
+	 * Tool output content.
+	 */
+	content: unknown
+	/**
+	 * Name of the Mail tool that ran.
+	 */
+	name: string
+	/**
+	 * Whether the Mail service reported a tool error.
+	 */
+	isError?: boolean
+	/**
+	 * Execution metadata reported by the MCP server.
+	 */
+	metadata?: {
+		/**
+		 * Tool execution time in milliseconds.
+		 */
+		executionTimeMs?: number
+		/**
+		 * Number of bytes processed by the tool.
+		 */
+		bytesProcessed?: number
+		/**
+		 * Tool execution cost reported by the MCP server.
+		 */
+		cost?: number
+	}
+	/**
+	 * Mail module name used for display.
+	 */
+	moduleName?: string
+	/**
+	 * Structured tool output when provided by the Mail service.
+	 */
+	structuredContent?: unknown
+	/**
+	 * Bounded HTTP-like Mail service error code.
+	 */
+	toolErrorCode?: number
+}
+
+/**
+ * Script input for the "Set Reminder" effect (`mail.setReminder`),
+ * derived from its Tool Core definition's call_function input projection.
+ *
+ * Set a reminder (snooze) for email threads. Gmail accounts only — for Outlook accounts use flag_outlook_thread with a reminderDateTime instead.
+ */
+export type SetReminderScriptInput = {
+	/**
+	 * The email address of the mailbox
+	 */
+	userEmailAddress: string
+	/**
+	 * Array of thread IDs to set reminder on
+	 */
+	threadIds: Array<string>
+	/**
+	 * ISO 8601 datetime with UTC offset for when to remind (e.g., 2024-11-17T18:00:00-05:00)
+	 */
+	remindDate: string
+	/**
+	 * When to trigger reminder: IF_NO_REPLY (only if no reply received) or REGARDLESS
+	 */
+	remindCondition?: "IF_NO_REPLY" | "REGARDLESS"
+}
+
+/**
+ * Canonical Tool Core output for the "Set Reminder" effect (`mail.setReminder`).
+ * This is the definition's output schema; the effect's script surface may
+ * re-encode it before returning.
+ */
+export type SetReminderScriptOutput = {
+	/**
+	 * Tool output content.
+	 */
+	content: unknown
+	/**
+	 * Name of the Mail tool that ran.
+	 */
+	name: string
+	/**
+	 * Whether the Mail service reported a tool error.
+	 */
+	isError?: boolean
+	/**
+	 * Execution metadata reported by the MCP server.
+	 */
+	metadata?: {
+		/**
+		 * Tool execution time in milliseconds.
+		 */
+		executionTimeMs?: number
+		/**
+		 * Number of bytes processed by the tool.
+		 */
+		bytesProcessed?: number
+		/**
+		 * Tool execution cost reported by the MCP server.
+		 */
+		cost?: number
+	}
+	/**
+	 * Mail module name used for display.
+	 */
+	moduleName?: string
+	/**
+	 * Structured tool output when provided by the Mail service.
+	 */
+	structuredContent?: unknown
+	/**
+	 * Bounded HTTP-like Mail service error code.
+	 */
+	toolErrorCode?: number
+}
+
+/**
+ * Script input for the "Set Notion Mail View Notification Preferences" effect (`mail.setViewNotificationPreferences`),
+ * derived from its Tool Core definition's call_function input projection.
+ *
+ * Enable or disable Notion Mail push notifications for specific mailbox views (e.g., Priority, Other, Newsletters). This tool is specific to Notion Mail notification settings only — it does not modify notification settings for Gmail, Outlook, or any other email provider. Takes effect immediately.
+ */
+export type SetViewNotificationPreferencesScriptInput = {
+	/**
+	 * The Notion Mail email address of the account to update view notification preferences for. Must be an account connected to Notion Mail.
+	 */
+	userEmailAddress: string
+	/**
+	 * Array of view notification preference updates
+	 */
+	preferences: Array<{
+		/**
+		 * The mailbox view layout ID — get valid IDs from list_mailbox_views
+		 */
+		layoutId: string
+		/**
+		 * Whether to enable (true) or disable (false) notifications for this view
+		 */
+		enabled: boolean
+	}>
+}
+
+/**
+ * Canonical Tool Core output for the "Set Notion Mail View Notification Preferences" effect (`mail.setViewNotificationPreferences`).
+ * This is the definition's output schema; the effect's script surface may
+ * re-encode it before returning.
+ */
+export type SetViewNotificationPreferencesScriptOutput = {
+	/**
+	 * Tool output content.
+	 */
+	content: unknown
+	/**
+	 * Name of the Mail tool that ran.
+	 */
+	name: string
+	/**
+	 * Whether the Mail service reported a tool error.
+	 */
+	isError?: boolean
+	/**
+	 * Execution metadata reported by the MCP server.
+	 */
+	metadata?: {
+		/**
+		 * Tool execution time in milliseconds.
+		 */
+		executionTimeMs?: number
+		/**
+		 * Number of bytes processed by the tool.
+		 */
+		bytesProcessed?: number
+		/**
+		 * Tool execution cost reported by the MCP server.
+		 */
+		cost?: number
+	}
+	/**
+	 * Mail module name used for display.
+	 */
+	moduleName?: string
+	/**
+	 * Structured tool output when provided by the Mail service.
+	 */
+	structuredContent?: unknown
+	/**
+	 * Bounded HTTP-like Mail service error code.
+	 */
+	toolErrorCode?: number
+}
+
+/**
+ * Script input for the "Star Thread" effect (`mail.starThread`),
+ * derived from its Tool Core definition's call_function input projection.
+ *
+ * Star or unstar one or more email threads. Gmail accounts only — for Outlook accounts use flag_outlook_thread instead.
+ */
+export type StarThreadScriptInput = {
+	/**
+	 * The email address of the mailbox
+	 */
+	userEmailAddress: string
+	/**
+	 * Array of thread IDs to star/unstar
+	 */
+	threadIds: Array<string>
+	/**
+	 * Whether to star (true) or unstar (false)
+	 */
+	starred: boolean
+}
+
+/**
+ * Canonical Tool Core output for the "Star Thread" effect (`mail.starThread`).
+ * This is the definition's output schema; the effect's script surface may
+ * re-encode it before returning.
+ */
+export type StarThreadScriptOutput = {
+	/**
+	 * Tool output content.
+	 */
+	content: unknown
+	/**
+	 * Name of the Mail tool that ran.
+	 */
+	name: string
+	/**
+	 * Whether the Mail service reported a tool error.
+	 */
+	isError?: boolean
+	/**
+	 * Execution metadata reported by the MCP server.
+	 */
+	metadata?: {
+		/**
+		 * Tool execution time in milliseconds.
+		 */
+		executionTimeMs?: number
+		/**
+		 * Number of bytes processed by the tool.
+		 */
+		bytesProcessed?: number
+		/**
+		 * Tool execution cost reported by the MCP server.
+		 */
+		cost?: number
+	}
+	/**
+	 * Mail module name used for display.
+	 */
+	moduleName?: string
+	/**
+	 * Structured tool output when provided by the Mail service.
+	 */
+	structuredContent?: unknown
+	/**
+	 * Bounded HTTP-like Mail service error code.
+	 */
+	toolErrorCode?: number
+}
+
+/**
+ * Script input for the "Trash Thread" effect (`mail.trashThread`),
+ * derived from its Tool Core definition's call_function input projection.
+ *
+ * Move one or more email threads to trash
+ */
+export type TrashThreadScriptInput = {
+	/**
+	 * The email address of the mailbox
+	 */
+	userEmailAddress: string
+	/**
+	 * Array of thread IDs to trash
+	 */
+	threadIds: Array<string>
+}
+
+/**
+ * Canonical Tool Core output for the "Trash Thread" effect (`mail.trashThread`).
+ * This is the definition's output schema; the effect's script surface may
+ * re-encode it before returning.
+ */
+export type TrashThreadScriptOutput = {
+	/**
+	 * Tool output content.
+	 */
+	content: unknown
+	/**
+	 * Name of the Mail tool that ran.
+	 */
+	name: string
+	/**
+	 * Whether the Mail service reported a tool error.
+	 */
+	isError?: boolean
+	/**
+	 * Execution metadata reported by the MCP server.
+	 */
+	metadata?: {
+		/**
+		 * Tool execution time in milliseconds.
+		 */
+		executionTimeMs?: number
+		/**
+		 * Number of bytes processed by the tool.
+		 */
+		bytesProcessed?: number
+		/**
+		 * Tool execution cost reported by the MCP server.
+		 */
+		cost?: number
+	}
+	/**
+	 * Mail module name used for display.
+	 */
+	moduleName?: string
+	/**
+	 * Structured tool output when provided by the Mail service.
+	 */
+	structuredContent?: unknown
+	/**
+	 * Bounded HTTP-like Mail service error code.
+	 */
+	toolErrorCode?: number
+}
+
+/**
+ * Script input for the "Unblock Sender" effect (`mail.unblockSender`),
+ * derived from its Tool Core definition's call_function input projection.
+ *
+ * Unblock a previously blocked sender
+ */
+export type UnblockSenderScriptInput = {
+	/**
+	 * The email address of the mailbox
+	 */
+	userEmailAddress: string
+	/**
+	 * Email address of the sender to unblock
+	 */
+	senderEmail: string
+}
+
+/**
+ * Canonical Tool Core output for the "Unblock Sender" effect (`mail.unblockSender`).
+ * This is the definition's output schema; the effect's script surface may
+ * re-encode it before returning.
+ */
+export type UnblockSenderScriptOutput = {
+	/**
+	 * Tool output content.
+	 */
+	content: unknown
+	/**
+	 * Name of the Mail tool that ran.
+	 */
+	name: string
+	/**
+	 * Whether the Mail service reported a tool error.
+	 */
+	isError?: boolean
+	/**
+	 * Execution metadata reported by the MCP server.
+	 */
+	metadata?: {
+		/**
+		 * Tool execution time in milliseconds.
+		 */
+		executionTimeMs?: number
+		/**
+		 * Number of bytes processed by the tool.
+		 */
+		bytesProcessed?: number
+		/**
+		 * Tool execution cost reported by the MCP server.
+		 */
+		cost?: number
+	}
+	/**
+	 * Mail module name used for display.
+	 */
+	moduleName?: string
+	/**
+	 * Structured tool output when provided by the Mail service.
+	 */
+	structuredContent?: unknown
+	/**
+	 * Bounded HTTP-like Mail service error code.
+	 */
+	toolErrorCode?: number
+}
+
+/**
+ * Script input for the "Unset Reminder" effect (`mail.unsetReminder`),
+ * derived from its Tool Core definition's call_function input projection.
+ *
+ * Remove a reminder (unsnooze) from email threads. Gmail accounts only — for Outlook accounts use flag_outlook_thread with flagged=false instead.
+ */
+export type UnsetReminderScriptInput = {
+	/**
+	 * The email address of the mailbox
+	 */
+	userEmailAddress: string
+	/**
+	 * Array of thread IDs to unset reminder on
+	 */
+	threadIds: Array<string>
+}
+
+/**
+ * Canonical Tool Core output for the "Unset Reminder" effect (`mail.unsetReminder`).
+ * This is the definition's output schema; the effect's script surface may
+ * re-encode it before returning.
+ */
+export type UnsetReminderScriptOutput = {
+	/**
+	 * Tool output content.
+	 */
+	content: unknown
+	/**
+	 * Name of the Mail tool that ran.
+	 */
+	name: string
+	/**
+	 * Whether the Mail service reported a tool error.
+	 */
+	isError?: boolean
+	/**
+	 * Execution metadata reported by the MCP server.
+	 */
+	metadata?: {
+		/**
+		 * Tool execution time in milliseconds.
+		 */
+		executionTimeMs?: number
+		/**
+		 * Number of bytes processed by the tool.
+		 */
+		bytesProcessed?: number
+		/**
+		 * Tool execution cost reported by the MCP server.
+		 */
+		cost?: number
+	}
+	/**
+	 * Mail module name used for display.
+	 */
+	moduleName?: string
+	/**
+	 * Structured tool output when provided by the Mail service.
+	 */
+	structuredContent?: unknown
+	/**
+	 * Bounded HTTP-like Mail service error code.
+	 */
+	toolErrorCode?: number
+}
+
+/**
+ * Script input for the "Unsubscribe" effect (`mail.unsubscribeSender`),
+ * derived from its Tool Core definition's call_function input projection.
+ *
+ * Unsubscribe from a mailing list using List-Unsubscribe metadata
+ */
+export type UnsubscribeSenderScriptInput = {
+	/**
+	 * The email address of the mailbox
+	 */
+	userEmailAddress: string
+	/**
+	 * Gmail thread ID containing the message with unsubscribe metadata
+	 */
+	threadId?: string
+	/**
+	 * Optional specific Gmail message ID
+	 */
+	messageId?: string
+	/**
+	 * Optional explicit HTTPS or mailto unsubscribe URL
+	 */
+	explicitUnsubscribeUrl?: string
+	/**
+	 * Optional raw List-Unsubscribe header value
+	 */
+	listUnsubscribeHeader?: string
+	/**
+	 * Optional raw List-Unsubscribe-Post header value
+	 */
+	listUnsubscribePostHeader?: string
+	/**
+	 * Optional sender email for logging/context
+	 */
+	senderEmail?: string
+}
+
+/**
+ * Canonical Tool Core output for the "Unsubscribe" effect (`mail.unsubscribeSender`).
+ * This is the definition's output schema; the effect's script surface may
+ * re-encode it before returning.
+ */
+export type UnsubscribeSenderScriptOutput = {
+	/**
+	 * Tool output content.
+	 */
+	content: unknown
+	/**
+	 * Name of the Mail tool that ran.
+	 */
+	name: string
+	/**
+	 * Whether the Mail service reported a tool error.
+	 */
+	isError?: boolean
+	/**
+	 * Execution metadata reported by the MCP server.
+	 */
+	metadata?: {
+		/**
+		 * Tool execution time in milliseconds.
+		 */
+		executionTimeMs?: number
+		/**
+		 * Number of bytes processed by the tool.
+		 */
+		bytesProcessed?: number
+		/**
+		 * Tool execution cost reported by the MCP server.
+		 */
+		cost?: number
+	}
+	/**
+	 * Mail module name used for display.
+	 */
+	moduleName?: string
+	/**
+	 * Structured tool output when provided by the Mail service.
+	 */
+	structuredContent?: unknown
+	/**
+	 * Bounded HTTP-like Mail service error code.
+	 */
+	toolErrorCode?: number
+}
+
+/**
+ * Script input for the "Update Gmail Filter" effect (`mail.updateGmailFilter`),
+ * derived from its Tool Core definition's call_function input projection.
+ *
+ * Update an existing Gmail filter (deletes and recreates with new settings)
+ */
+export type UpdateGmailFilterScriptInput = {
+	/**
+	 * The email address of the Gmail account
+	 */
+	userEmailAddress: string
+	/**
+	 * The ID of the filter to update
+	 */
+	filterId: string
+	/**
+	 * New filter criteria (at least one field required)
+	 */
+	criteria: {
+		/**
+		 * Match emails from this sender
+		 */
+		from?: string
+		/**
+		 * Match emails sent to this address
+		 */
+		to?: string
+		/**
+		 * Match emails with this in subject
+		 */
+		subject?: string
+		/**
+		 * Full Gmail search query
+		 */
+		query?: string
+		/**
+		 * Exclude emails matching this query
+		 */
+		negatedQuery?: string
+		/**
+		 * Match only emails with attachments
+		 */
+		hasAttachment?: boolean
+		/**
+		 * Exclude chat messages
+		 */
+		excludeChats?: boolean
+		/**
+		 * Size threshold in bytes
+		 */
+		size?: number
+		/**
+		 * Compare against size threshold
+		 */
+		sizeComparison?: "SMALLER" | "LARGER"
+	}
+	/**
+	 * New actions to perform (at least one required)
+	 */
+	action: {
+		/**
+		 * Gmail system label IDs or IDs returned by list_labels. Never use Notion record, survey option, or category IDs.
+		 */
+		addLabelIds?: Array<string>
+		/**
+		 * Gmail system label IDs or IDs returned by list_labels. Use INBOX to auto-archive matching future mail.
+		 */
+		removeLabelIds?: Array<string>
+		/**
+		 * Email address to forward to (must be pre-verified)
+		 */
+		forward?: string
+	}
+}
+
+/**
+ * Canonical Tool Core output for the "Update Gmail Filter" effect (`mail.updateGmailFilter`).
+ * This is the definition's output schema; the effect's script surface may
+ * re-encode it before returning.
+ */
+export type UpdateGmailFilterScriptOutput = {
+	/**
+	 * Tool output content.
+	 */
+	content: unknown
+	/**
+	 * Name of the Mail tool that ran.
+	 */
+	name: string
+	/**
+	 * Whether the Mail service reported a tool error.
+	 */
+	isError?: boolean
+	/**
+	 * Execution metadata reported by the MCP server.
+	 */
+	metadata?: {
+		/**
+		 * Tool execution time in milliseconds.
+		 */
+		executionTimeMs?: number
+		/**
+		 * Number of bytes processed by the tool.
+		 */
+		bytesProcessed?: number
+		/**
+		 * Tool execution cost reported by the MCP server.
+		 */
+		cost?: number
+	}
+	/**
+	 * Mail module name used for display.
+	 */
+	moduleName?: string
+	/**
+	 * Structured tool output when provided by the Mail service.
+	 */
+	structuredContent?: unknown
+	/**
+	 * Bounded HTTP-like Mail service error code.
+	 */
+	toolErrorCode?: number
+}
+
+/**
+ * Script input for the "Update Label" effect (`mail.updateLabel`),
+ * derived from its Tool Core definition's call_function input projection.
+ *
+ * Update a label's name or color
+ */
+export type UpdateLabelScriptInput = {
+	/**
+	 * The email address of the mailbox
+	 */
+	userEmailAddress: string
+	/**
+	 * ID of the label to update
+	 */
+	labelID: string
+	/**
+	 * New label name (optional)
+	 */
+	labelName?: string
+	/**
+	 * New label color (optional)
+	 */
+	color?:
+		| "light-gray"
+		| "gray"
+		| "brown"
+		| "orange"
+		| "yellow"
+		| "green"
+		| "blue"
+		| "purple"
+		| "pink"
+		| "red"
+}
+
+/**
+ * Canonical Tool Core output for the "Update Label" effect (`mail.updateLabel`).
+ * This is the definition's output schema; the effect's script surface may
+ * re-encode it before returning.
+ */
+export type UpdateLabelScriptOutput = {
+	/**
+	 * Tool output content.
+	 */
+	content: unknown
+	/**
+	 * Name of the Mail tool that ran.
+	 */
+	name: string
+	/**
+	 * Whether the Mail service reported a tool error.
+	 */
+	isError?: boolean
+	/**
+	 * Execution metadata reported by the MCP server.
+	 */
+	metadata?: {
+		/**
+		 * Tool execution time in milliseconds.
+		 */
+		executionTimeMs?: number
+		/**
+		 * Number of bytes processed by the tool.
+		 */
+		bytesProcessed?: number
+		/**
+		 * Tool execution cost reported by the MCP server.
+		 */
+		cost?: number
+	}
+	/**
+	 * Mail module name used for display.
+	 */
+	moduleName?: string
+	/**
+	 * Structured tool output when provided by the Mail service.
+	 */
+	structuredContent?: unknown
+	/**
+	 * Bounded HTTP-like Mail service error code.
+	 */
+	toolErrorCode?: number
+}
+
+/**
+ * Script input for the "Update Outlook Rule" effect (`mail.updateOutlookRule`),
+ * derived from its Tool Core definition's call_function input projection.
+ *
+ * Update an existing inbox rule in the user's Outlook mailbox. Only the fields you provide are changed; unspecified top-level fields remain unchanged. conditions, actions, and exceptions are REPLACED entirely when provided.
+ */
+export type UpdateOutlookRuleScriptInput = {
+	/**
+	 * Rule ID (use list_outlook_rules to find IDs)
+	 */
+	ruleId: string
+	/**
+	 * New display name
+	 */
+	displayName?: string
+	/**
+	 * New execution order
+	 */
+	sequence?: number
+	/**
+	 * Enable or disable the rule
+	 */
+	isEnabled?: boolean
+	conditions?: {
+		bodyContains?: Array<string>
+		bodyOrSubjectContains?: Array<string>
+		categories?: Array<string>
+		fromAddresses?: Array<{
+			address: string
+			name?: string
+		}>
+		hasAttachments?: boolean
+		headerContains?: Array<string>
+		importance?: "low" | "normal" | "high"
+		isApprovalRequest?: boolean
+		isAutomaticForward?: boolean
+		isAutomaticReply?: boolean
+		isEncrypted?: boolean
+		isMeetingRequest?: boolean
+		isMeetingResponse?: boolean
+		isNonDeliveryReport?: boolean
+		isPermissionControlled?: boolean
+		isReadReceipt?: boolean
+		isSigned?: boolean
+		isVoicemail?: boolean
+		messageActionFlag?:
+			| "any"
+			| "call"
+			| "doNotForward"
+			| "followUp"
+			| "fyi"
+			| "forward"
+			| "noResponseNecessary"
+			| "read"
+			| "reply"
+			| "replyToAll"
+			| "review"
+		notSentToMe?: boolean
+		recipientContains?: Array<string>
+		senderContains?: Array<string>
+		sensitivity?: "normal" | "personal" | "private" | "confidential"
+		sentCcMe?: boolean
+		sentOnlyToMe?: boolean
+		sentToMe?: boolean
+		sentToOrCcMe?: boolean
+		sentToAddresses?: Array<{
+			address: string
+			name?: string
+		}>
+		subjectContains?: Array<string>
+		withinSizeRange?: {
+			minimumSize?: number
+			maximumSize?: number
+		}
+	}
+	/**
+	 * New actions (replaces existing; must have at least one non-empty field when provided)
+	 */
+	actions?: {
+		/**
+		 * Categories to assign
+		 */
+		assignCategories?: Array<string>
+		/**
+		 * Folder ID to copy to (use list_outlook_folders to find IDs)
+		 */
+		copyToFolder?: string
+		/**
+		 * Move to Deleted Items
+		 */
+		delete?: boolean
+		/**
+		 * Forward as attachment to these addresses
+		 */
+		forwardAsAttachmentTo?: Array<{
+			/**
+			 * Email address
+			 */
+			address: string
+			/**
+			 * Display name (optional)
+			 */
+			name?: string
+		}>
+		/**
+		 * Forward to these addresses
+		 */
+		forwardTo?: Array<{
+			/**
+			 * Email address
+			 */
+			address: string
+			/**
+			 * Display name (optional)
+			 */
+			name?: string
+		}>
+		/**
+		 * Mark as read
+		 */
+		markAsRead?: boolean
+		/**
+		 * Set importance level
+		 */
+		markImportance?: "low" | "normal" | "high"
+		/**
+		 * Folder ID to move to (use list_outlook_folders to find IDs)
+		 */
+		moveToFolder?: string
+		/**
+		 * Permanently delete (skip Deleted Items)
+		 */
+		permanentDelete?: boolean
+		/**
+		 * Redirect to these addresses
+		 */
+		redirectTo?: Array<{
+			/**
+			 * Email address
+			 */
+			address: string
+			/**
+			 * Display name (optional)
+			 */
+			name?: string
+		}>
+		/**
+		 * Stop processing subsequent rules
+		 */
+		stopProcessingRules?: boolean
+	}
+	exceptions?: {
+		bodyContains?: Array<string>
+		bodyOrSubjectContains?: Array<string>
+		categories?: Array<string>
+		fromAddresses?: Array<{
+			address: string
+			name?: string
+		}>
+		hasAttachments?: boolean
+		headerContains?: Array<string>
+		importance?: "low" | "normal" | "high"
+		isApprovalRequest?: boolean
+		isAutomaticForward?: boolean
+		isAutomaticReply?: boolean
+		isEncrypted?: boolean
+		isMeetingRequest?: boolean
+		isMeetingResponse?: boolean
+		isNonDeliveryReport?: boolean
+		isPermissionControlled?: boolean
+		isReadReceipt?: boolean
+		isSigned?: boolean
+		isVoicemail?: boolean
+		messageActionFlag?:
+			| "any"
+			| "call"
+			| "doNotForward"
+			| "followUp"
+			| "fyi"
+			| "forward"
+			| "noResponseNecessary"
+			| "read"
+			| "reply"
+			| "replyToAll"
+			| "review"
+		notSentToMe?: boolean
+		recipientContains?: Array<string>
+		senderContains?: Array<string>
+		sensitivity?: "normal" | "personal" | "private" | "confidential"
+		sentCcMe?: boolean
+		sentOnlyToMe?: boolean
+		sentToMe?: boolean
+		sentToOrCcMe?: boolean
+		sentToAddresses?: Array<{
+			address: string
+			name?: string
+		}>
+		subjectContains?: Array<string>
+		withinSizeRange?: {
+			minimumSize?: number
+			maximumSize?: number
+		}
+	}
+	etag?: string
+	/**
+	 * The Outlook email address
+	 */
+	userEmailAddress: string
+}
+
+/**
+ * Canonical Tool Core output for the "Update Outlook Rule" effect (`mail.updateOutlookRule`).
+ * This is the definition's output schema; the effect's script surface may
+ * re-encode it before returning.
+ */
+export type UpdateOutlookRuleScriptOutput = {
+	/**
+	 * Tool output content.
+	 */
+	content: unknown
+	/**
+	 * Name of the Mail tool that ran.
+	 */
+	name: string
+	/**
+	 * Whether the Mail service reported a tool error.
+	 */
+	isError?: boolean
+	/**
+	 * Execution metadata reported by the MCP server.
+	 */
+	metadata?: {
+		/**
+		 * Tool execution time in milliseconds.
+		 */
+		executionTimeMs?: number
+		/**
+		 * Number of bytes processed by the tool.
+		 */
+		bytesProcessed?: number
+		/**
+		 * Tool execution cost reported by the MCP server.
+		 */
+		cost?: number
+	}
+	/**
+	 * Mail module name used for display.
+	 */
+	moduleName?: string
+	/**
+	 * Structured tool output when provided by the Mail service.
+	 */
+	structuredContent?: unknown
+	/**
+	 * Bounded HTTP-like Mail service error code.
+	 */
+	toolErrorCode?: number
+}
+
+/**
+ * Script input for the "Update Status" effect (`mail.updateStatus`),
+ * derived from its Tool Core definition's call_function input projection.
+ *
+ * Update the status property value for email threads. Gmail accounts only — status updates are not supported for Outlook accounts.
+ */
+export type UpdateStatusScriptInput = {
+	/**
+	 * The email address of the mailbox
+	 */
+	userEmailAddress: string
+	/**
+	 * Array of thread IDs to update
+	 */
+	threadIds: Array<string>
+	/**
+	 * The UUID of the status property
+	 */
+	statusID: string
+	/**
+	 * The name of the status option to set
+	 */
+	optionValue: string
+}
+
+/**
+ * Canonical Tool Core output for the "Update Status" effect (`mail.updateStatus`).
+ * This is the definition's output schema; the effect's script surface may
+ * re-encode it before returning.
+ */
+export type UpdateStatusScriptOutput = {
+	/**
+	 * Tool output content.
+	 */
+	content: unknown
+	/**
+	 * Name of the Mail tool that ran.
+	 */
+	name: string
+	/**
+	 * Whether the Mail service reported a tool error.
+	 */
+	isError?: boolean
+	/**
+	 * Execution metadata reported by the MCP server.
+	 */
+	metadata?: {
+		/**
+		 * Tool execution time in milliseconds.
+		 */
+		executionTimeMs?: number
+		/**
+		 * Number of bytes processed by the tool.
+		 */
+		bytesProcessed?: number
+		/**
+		 * Tool execution cost reported by the MCP server.
+		 */
+		cost?: number
+	}
+	/**
+	 * Mail module name used for display.
+	 */
+	moduleName?: string
+	/**
+	 * Structured tool output when provided by the Mail service.
+	 */
+	structuredContent?: unknown
+	/**
+	 * Bounded HTTP-like Mail service error code.
+	 */
+	toolErrorCode?: number
+}
+
+/**
+ * Script input for the "View Thread Content" effect (`mail.viewThreadContent`),
+ * derived from its Tool Core definition's call_function input projection.
+ *
+ * View the full content of an email thread including all messages. The returned threadId follows the mail thread-id format: The id is a single opaque string; a verification stamp may be appended after a "." (e.g. 1894c2bd0f58f2b7.a83f92c1) and that stamp is part of the value, not a separate field. Pass the whole value to other tools exactly as received. A bare id with no stamp still works — tools just verify it more slowly. Thread identity is the part before the "." — a missing or different stamp never means a different thread — so if you specifically need the raw provider id for another purpose (e.g. matching a Notion mail block that stores the untagged id), it is that leading part (for Gmail, a hex string like 1894c2bd0f58f2b7). The response includes url when a direct provider link is available. When a link would help the user, including when they ask for one, cite that exact URL directly in citation syntax ([^<url>]) so it renders as a provider chip; never construct a provider URL from threadId or message IDs.
+ */
+export type ViewThreadContentScriptInput = {
+	/**
+	 * The email address of the mailbox
+	 */
+	userEmailAddress: string
+	/**
+	 * The thread ID to view (from search_emails or view_thread_content). A stamped ref is accepted as-is.
+	 */
+	threadId: string
+	/**
+	 * If true, returns only the most recent message. If false, returns all messages.
+	 */
+	mostRecentMessageOnly?: boolean
+}
+
+/**
+ * Canonical Tool Core output for the "View Thread Content" effect (`mail.viewThreadContent`).
+ * This is the definition's output schema; the effect's script surface may
+ * re-encode it before returning.
+ */
+export type ViewThreadContentScriptOutput = {
+	/**
+	 * Tool output content.
+	 */
+	content: unknown
+	/**
+	 * Name of the Mail tool that ran.
+	 */
+	name: string
+	/**
+	 * Whether the Mail service reported a tool error.
+	 */
+	isError?: boolean
+	/**
+	 * Execution metadata reported by the MCP server.
+	 */
+	metadata?: {
+		/**
+		 * Tool execution time in milliseconds.
+		 */
+		executionTimeMs?: number
+		/**
+		 * Number of bytes processed by the tool.
+		 */
+		bytesProcessed?: number
+		/**
+		 * Tool execution cost reported by the MCP server.
+		 */
+		cost?: number
+	}
+	/**
+	 * Mail module name used for display.
+	 */
+	moduleName?: string
+	/**
+	 * Structured tool output when provided by the Mail service.
+	 */
+	structuredContent?: unknown
+	/**
+	 * Bounded HTTP-like Mail service error code.
+	 */
+	toolErrorCode?: number
+}
+
+export class MailConnectionClient {
+	constructor(private readonly invoke: ConnectionActionInvoker) {}
+	addSenderNotificationPreferences(
+		args: AddSenderNotificationPreferencesScriptInput,
+	): Promise<AddSenderNotificationPreferencesScriptOutput> {
+		return this.invoke<AddSenderNotificationPreferencesScriptOutput>(
+			"addSenderNotificationPreferences",
+			args,
+		)
+	}
+	analyzeRecentEmailActivities(
+		args: AnalyzeRecentEmailActivitiesScriptInput,
+	): Promise<AnalyzeRecentEmailActivitiesScriptOutput> {
+		return this.invoke<AnalyzeRecentEmailActivitiesScriptOutput>(
+			"analyzeRecentEmailActivities",
+			args,
+		)
+	}
+	applyOutlookCategories(
+		args: ApplyOutlookCategoriesScriptInput,
+	): Promise<ApplyOutlookCategoriesScriptOutput> {
+		return this.invoke<ApplyOutlookCategoriesScriptOutput>(
+			"applyOutlookCategories",
+			args,
+		)
+	}
+	applyUserLabelsWithLazyCreate(
+		args: ApplyUserLabelsWithLazyCreateScriptInput,
+	): Promise<ApplyUserLabelsWithLazyCreateScriptOutput> {
+		return this.invoke<ApplyUserLabelsWithLazyCreateScriptOutput>(
+			"applyUserLabelsWithLazyCreate",
+			args,
+		)
+	}
+	archiveThreadsById(
+		args: ArchiveThreadsByIdScriptInput,
+	): Promise<ArchiveThreadsByIdScriptOutput> {
+		return this.invoke<ArchiveThreadsByIdScriptOutput>(
+			"archiveThreadsById",
+			args,
+		)
+	}
+	archiveThreadsByQuery(
+		args: ArchiveThreadsByQueryScriptInput,
+	): Promise<ArchiveThreadsByQueryScriptOutput> {
+		return this.invoke<ArchiveThreadsByQueryScriptOutput>(
+			"archiveThreadsByQuery",
+			args,
+		)
+	}
+	blockSender(args: BlockSenderScriptInput): Promise<BlockSenderScriptOutput> {
+		return this.invoke<BlockSenderScriptOutput>("blockSender", args)
+	}
+	createGmailFilter(
+		args: CreateGmailFilterScriptInput,
+	): Promise<CreateGmailFilterScriptOutput> {
+		return this.invoke<CreateGmailFilterScriptOutput>("createGmailFilter", args)
+	}
+	createLabel(args: CreateLabelScriptInput): Promise<CreateLabelScriptOutput> {
+		return this.invoke<CreateLabelScriptOutput>("createLabel", args)
+	}
+	createMailBlock(
+		args: CreateMailBlockScriptInput,
+	): Promise<CreateMailBlockScriptOutput> {
+		return this.invoke<CreateMailBlockScriptOutput>("createMailBlock", args)
+	}
+	createOrUpdateDraft(
+		args: CreateOrUpdateDraftScriptInput,
+	): Promise<CreateOrUpdateDraftScriptOutput> {
+		return this.invoke<CreateOrUpdateDraftScriptOutput>(
+			"createOrUpdateDraft",
+			args,
+		)
+	}
+	createOrUpdateDraftAllClients(
+		args: CreateOrUpdateDraftAllClientsScriptInput,
+	): Promise<CreateOrUpdateDraftAllClientsScriptOutput> {
+		return this.invoke<CreateOrUpdateDraftAllClientsScriptOutput>(
+			"createOrUpdateDraftAllClients",
+			args,
+		)
+	}
+	createOrUpdateGmailDraft(
+		args: CreateOrUpdateGmailDraftScriptInput,
+	): Promise<CreateOrUpdateGmailDraftScriptOutput> {
+		return this.invoke<CreateOrUpdateGmailDraftScriptOutput>(
+			"createOrUpdateGmailDraft",
+			args,
+		)
+	}
+	createOrUpdateOutlookDraft(
+		args: CreateOrUpdateOutlookDraftScriptInput,
+	): Promise<CreateOrUpdateOutlookDraftScriptOutput> {
+		return this.invoke<CreateOrUpdateOutlookDraftScriptOutput>(
+			"createOrUpdateOutlookDraft",
+			args,
+		)
+	}
+	createOutlookCategory(
+		args: CreateOutlookCategoryScriptInput,
+	): Promise<CreateOutlookCategoryScriptOutput> {
+		return this.invoke<CreateOutlookCategoryScriptOutput>(
+			"createOutlookCategory",
+			args,
+		)
+	}
+	createOutlookFolder(
+		args: CreateOutlookFolderScriptInput,
+	): Promise<CreateOutlookFolderScriptOutput> {
+		return this.invoke<CreateOutlookFolderScriptOutput>(
+			"createOutlookFolder",
+			args,
+		)
+	}
+	createOutlookRule(
+		args: CreateOutlookRuleScriptInput,
+	): Promise<CreateOutlookRuleScriptOutput> {
+		return this.invoke<CreateOutlookRuleScriptOutput>("createOutlookRule", args)
+	}
+	createStatusColumn(
+		args: CreateStatusColumnScriptInput,
+	): Promise<CreateStatusColumnScriptOutput> {
+		return this.invoke<CreateStatusColumnScriptOutput>(
+			"createStatusColumn",
+			args,
+		)
+	}
+	deleteGmailFilter(
+		args: DeleteGmailFilterScriptInput,
+	): Promise<DeleteGmailFilterScriptOutput> {
+		return this.invoke<DeleteGmailFilterScriptOutput>("deleteGmailFilter", args)
+	}
+	deleteLabel(args: DeleteLabelScriptInput): Promise<DeleteLabelScriptOutput> {
+		return this.invoke<DeleteLabelScriptOutput>("deleteLabel", args)
+	}
+	deleteOutlookCategory(
+		args: DeleteOutlookCategoryScriptInput,
+	): Promise<DeleteOutlookCategoryScriptOutput> {
+		return this.invoke<DeleteOutlookCategoryScriptOutput>(
+			"deleteOutlookCategory",
+			args,
+		)
+	}
+	deleteOutlookRule(
+		args: DeleteOutlookRuleScriptInput,
+	): Promise<DeleteOutlookRuleScriptOutput> {
+		return this.invoke<DeleteOutlookRuleScriptOutput>("deleteOutlookRule", args)
+	}
+	flagOutlookThread(
+		args: FlagOutlookThreadScriptInput,
+	): Promise<FlagOutlookThreadScriptOutput> {
+		return this.invoke<FlagOutlookThreadScriptOutput>("flagOutlookThread", args)
+	}
+	getNotificationPreferences(
+		args: GetNotificationPreferencesScriptInput,
+	): Promise<GetNotificationPreferencesScriptOutput> {
+		return this.invoke<GetNotificationPreferencesScriptOutput>(
+			"getNotificationPreferences",
+			args,
+		)
+	}
+	healthCheck(args: HealthCheckScriptInput): Promise<HealthCheckScriptOutput> {
+		return this.invoke<HealthCheckScriptOutput>("healthCheck", args)
+	}
+	listGmailFilters(
+		args: ListGmailFiltersScriptInput,
+	): Promise<ListGmailFiltersScriptOutput> {
+		return this.invoke<ListGmailFiltersScriptOutput>("listGmailFilters", args)
+	}
+	listLabels(args: ListLabelsScriptInput): Promise<ListLabelsScriptOutput> {
+		return this.invoke<ListLabelsScriptOutput>("listLabels", args)
+	}
+	listMailboxViews(
+		args: ListMailboxViewsScriptInput,
+	): Promise<ListMailboxViewsScriptOutput> {
+		return this.invoke<ListMailboxViewsScriptOutput>("listMailboxViews", args)
+	}
+	listOutlookCategories(
+		args: ListOutlookCategoriesScriptInput,
+	): Promise<ListOutlookCategoriesScriptOutput> {
+		return this.invoke<ListOutlookCategoriesScriptOutput>(
+			"listOutlookCategories",
+			args,
+		)
+	}
+	listOutlookFolders(
+		args: ListOutlookFoldersScriptInput,
+	): Promise<ListOutlookFoldersScriptOutput> {
+		return this.invoke<ListOutlookFoldersScriptOutput>(
+			"listOutlookFolders",
+			args,
+		)
+	}
+	listOutlookRules(
+		args: ListOutlookRulesScriptInput,
+	): Promise<ListOutlookRulesScriptOutput> {
+		return this.invoke<ListOutlookRulesScriptOutput>("listOutlookRules", args)
+	}
+	listStatusProperties(
+		args: ListStatusPropertiesScriptInput,
+	): Promise<ListStatusPropertiesScriptOutput> {
+		return this.invoke<ListStatusPropertiesScriptOutput>(
+			"listStatusProperties",
+			args,
+		)
+	}
+	markThreadSpam(
+		args: MarkThreadSpamScriptInput,
+	): Promise<MarkThreadSpamScriptOutput> {
+		return this.invoke<MarkThreadSpamScriptOutput>("markThreadSpam", args)
+	}
+	moveThreadToInbox(
+		args: MoveThreadToInboxScriptInput,
+	): Promise<MoveThreadToInboxScriptOutput> {
+		return this.invoke<MoveThreadToInboxScriptOutput>("moveThreadToInbox", args)
+	}
+	moveToOutlookFolder(
+		args: MoveToOutlookFolderScriptInput,
+	): Promise<MoveToOutlookFolderScriptOutput> {
+		return this.invoke<MoveToOutlookFolderScriptOutput>(
+			"moveToOutlookFolder",
+			args,
+		)
+	}
+	readAttachment(
+		args: ReadAttachmentScriptInput,
+	): Promise<ReadAttachmentScriptOutput> {
+		return this.invoke<ReadAttachmentScriptOutput>("readAttachment", args)
+	}
+	removeOutlookCategories(
+		args: RemoveOutlookCategoriesScriptInput,
+	): Promise<RemoveOutlookCategoriesScriptOutput> {
+		return this.invoke<RemoveOutlookCategoriesScriptOutput>(
+			"removeOutlookCategories",
+			args,
+		)
+	}
+	removeSenderNotificationPreferences(
+		args: RemoveSenderNotificationPreferencesScriptInput,
+	): Promise<RemoveSenderNotificationPreferencesScriptOutput> {
+		return this.invoke<RemoveSenderNotificationPreferencesScriptOutput>(
+			"removeSenderNotificationPreferences",
+			args,
+		)
+	}
+	removeUserLabels(
+		args: RemoveUserLabelsScriptInput,
+	): Promise<RemoveUserLabelsScriptOutput> {
+		return this.invoke<RemoveUserLabelsScriptOutput>("removeUserLabels", args)
+	}
+	searchEmails(
+		args: SearchEmailsScriptInput,
+	): Promise<SearchEmailsScriptOutput> {
+		return this.invoke<SearchEmailsScriptOutput>("searchEmails", args)
+	}
+	searchOutlookEmails(
+		args: SearchOutlookEmailsScriptInput,
+	): Promise<SearchOutlookEmailsScriptOutput> {
+		return this.invoke<SearchOutlookEmailsScriptOutput>(
+			"searchOutlookEmails",
+			args,
+		)
+	}
+	sendExistingDraft(
+		args: SendExistingDraftScriptInput,
+	): Promise<SendExistingDraftScriptOutput> {
+		return this.invoke<SendExistingDraftScriptOutput>("sendExistingDraft", args)
+	}
+	sendNewEmail(
+		args: SendNewEmailScriptInput,
+	): Promise<SendNewEmailScriptOutput> {
+		return this.invoke<SendNewEmailScriptOutput>("sendNewEmail", args)
+	}
+	setAccountNotificationPreference(
+		args: SetAccountNotificationPreferenceScriptInput,
+	): Promise<SetAccountNotificationPreferenceScriptOutput> {
+		return this.invoke<SetAccountNotificationPreferenceScriptOutput>(
+			"setAccountNotificationPreference",
+			args,
+		)
+	}
+	setReadStatus(
+		args: SetReadStatusScriptInput,
+	): Promise<SetReadStatusScriptOutput> {
+		return this.invoke<SetReadStatusScriptOutput>("setReadStatus", args)
+	}
+	setReminder(args: SetReminderScriptInput): Promise<SetReminderScriptOutput> {
+		return this.invoke<SetReminderScriptOutput>("setReminder", args)
+	}
+	setViewNotificationPreferences(
+		args: SetViewNotificationPreferencesScriptInput,
+	): Promise<SetViewNotificationPreferencesScriptOutput> {
+		return this.invoke<SetViewNotificationPreferencesScriptOutput>(
+			"setViewNotificationPreferences",
+			args,
+		)
+	}
+	starThread(args: StarThreadScriptInput): Promise<StarThreadScriptOutput> {
+		return this.invoke<StarThreadScriptOutput>("starThread", args)
+	}
+	trashThread(args: TrashThreadScriptInput): Promise<TrashThreadScriptOutput> {
+		return this.invoke<TrashThreadScriptOutput>("trashThread", args)
+	}
+	unblockSender(
+		args: UnblockSenderScriptInput,
+	): Promise<UnblockSenderScriptOutput> {
+		return this.invoke<UnblockSenderScriptOutput>("unblockSender", args)
+	}
+	unsetReminder(
+		args: UnsetReminderScriptInput,
+	): Promise<UnsetReminderScriptOutput> {
+		return this.invoke<UnsetReminderScriptOutput>("unsetReminder", args)
+	}
+	unsubscribeSender(
+		args: UnsubscribeSenderScriptInput,
+	): Promise<UnsubscribeSenderScriptOutput> {
+		return this.invoke<UnsubscribeSenderScriptOutput>("unsubscribeSender", args)
+	}
+	updateGmailFilter(
+		args: UpdateGmailFilterScriptInput,
+	): Promise<UpdateGmailFilterScriptOutput> {
+		return this.invoke<UpdateGmailFilterScriptOutput>("updateGmailFilter", args)
+	}
+	updateLabel(args: UpdateLabelScriptInput): Promise<UpdateLabelScriptOutput> {
+		return this.invoke<UpdateLabelScriptOutput>("updateLabel", args)
+	}
+	updateOutlookRule(
+		args: UpdateOutlookRuleScriptInput,
+	): Promise<UpdateOutlookRuleScriptOutput> {
+		return this.invoke<UpdateOutlookRuleScriptOutput>("updateOutlookRule", args)
+	}
+	updateStatus(
+		args: UpdateStatusScriptInput,
+	): Promise<UpdateStatusScriptOutput> {
+		return this.invoke<UpdateStatusScriptOutput>("updateStatus", args)
+	}
+	viewThreadContent(
+		args: ViewThreadContentScriptInput,
+	): Promise<ViewThreadContentScriptOutput> {
+		return this.invoke<ViewThreadContentScriptOutput>("viewThreadContent", args)
+	}
+}