Improvement(gmail-tools): added search and read

[aadamgough]

Screen.Recording.2025-07-14.at.7.21.59.PM.mov

Description

Added search and read for gmail

Fixes # (issue)

Type of change

Please delete options that are not relevant.

• New feature (non-breaking change which adds functionality)

How Has This Been Tested?

Added search and read, confirmed that both tools were running.

Checklist:

• My code follows the style guidelines of this project
• I have performed a self-review of my own code
• I have commented my code, particularly in hard-to-understand areas
• I have added tests that prove my fix is effective or that my feature works
• All tests pass locally and in CI (bun run test)
• My changes generate no new warnings
• Any dependent changes have been merged and published in downstream modules
• I have updated version numbers as needed (if needed)
• I confirm that I have read and agree to the terms outlined in the Contributor License Agreement (CLA)

Security Considerations:

• My changes do not introduce any new security vulnerabilities
• I have considered the security implications of my changes

[vercel]

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name	Status	Preview	Comments	Updated (UTC)
docs	✅ Ready (Inspect)	Visit Preview	💬 Add feedback	Jul 14, 2025 9:54pm
sim	✅ Ready (Inspect)	Visit Preview	💬 Add feedback	Jul 14, 2025 9:54pm

[delve-auditor]

✅ No security or compliance issues detected. Reviewed everything up to 026b628.

Security Overview

• 🔎 Scanned files: 4 changed file(s)

Detected Code Changes

Change Type	Relevant files
Refactor	► lib/env.ts Consolidate environment variable handling ► environment.ts Update environment detection ► auth-client.ts Refactor environment variable usage ► middleware.ts Update environment checks
Enhancement	► gmail.ts Add Gmail read and search functionality ► gmail.mdx Add Gmail read and search documentation
Bug Fix	► api/files/parse/route.ts Fix import paths ► api/files/serve/[...path]/route.ts Fix import paths

Reply to this PR with @delve-auditor followed by a description of what change you want and we'll auto-submit a change to this PR to implement it.

[greptile-apps]

Greptile Summary

This PR implements new Gmail integration features by adding read and search capabilities to complement the existing send and draft functionality. Key changes include:

1. Implementation of gmail_read tool with user-controlled folder access
2. Addition of gmail_search tool with comprehensive message detail fetching
3. Updates to the Gmail block component to support new operations
4. Extended documentation in gmail.mdx for the new features

The most significant architectural change is the folder parameter visibility modification from 'user-or-llm' to 'user-only' in the read tool, enhancing security by ensuring only end users can specify which folders to access.

Confidence score: 3/5

1. This PR is moderately safe to merge but requires attention to the error handling implementation
2. Score reflects concerns about the comprehensive error handling in search.ts and potential edge cases in message processing
3. Files needing attention:
   • apps/sim/tools/gmail/search.ts: Error handling in message detail fetching needs review
   • apps/sim/blocks/blocks/gmail.ts: Operation state management needs validation

_{4 files reviewed, 5 comments
Edit PR Review Bot Settings | Greptile}

[greptile-apps]

logic: Duplicate maxResults field ID with the one at line 93. This could cause conflicts in the UI.

Suggested change

	id: 'maxResults',
	title: 'Max Results',
	type: 'short-input',
	layout: 'full',
	placeholder: 'Maximum number of results (default: 10)',
	condition: {field: 'operation',value: 'search_gmail'},
	id: 'searchMaxResults',
	title: 'Max Results',
	type: 'short-input',
	layout: 'full',
	placeholder: 'Maximum number of results (default: 10)',
	condition: {field: 'operation',value: 'search_gmail'},

[greptile-apps]

style: Specify the maximum allowed value for maxResults in the search API