The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
docs	Ready	Preview, Comment	May 1, 2026 2:53am

PR Summary

Medium Risk
Adds a new Gmail draft-update API endpoint and wires it into the Gmail block, including attachment handling and threading headers, which could impact email composition behavior if misused. Changes are mostly additive but touch external Gmail API calls and auth-gated routes.

Overview
Adds a new Gmail capability to edit an existing draft in place via gmail_edit_draft_v2, including a new /api/tools/gmail/edit-draft route that builds raw MIME messages (with optional attachments) and updates drafts using Gmail’s PUT /drafts/{id}.

Wires Edit Draft into the Gmail block UI/operation selector (adds required draftId, reuses send/draft fields, and exposes draft outputs for both draft+edit), and updates the integration catalog operation count.

Introduces a tool-only gmail_update_label_v2 for patch-updating Gmail labels (rename/visibility) via PATCH /labels/{id}, registers both new tools in the tool barrel/registry, and updates docs (Gmail tool docs, Linear trigger doc trimming, and a knowledge tool doc/model description fix).

^{Reviewed by Cursor Bugbot for commit 44b97ad. Configure here.}

Greptile Summary

This PR adds two new Gmail tools — gmail_edit_draft_v2 (in-place draft update via PUT /drafts/{id}, with a server-side proxy route and block UI integration) and gmail_update_label_v2 (partial label update via PATCH /labels/{id}, tool-only/agent-facing) — and makes a collateral hardening change to the knowledge search tool description.

• knowledge.mdx docs regression: The rerankerModel description row now literally renders ${SUPPORTED_RERANKER_MODELS.join(', ')} as user-visible text instead of the actual model names (rerank-v4.0-pro, rerank-v4.0-fast, rerank-v3.5). This appears to have been introduced when the docs were regenerated after the search.ts description changed from a template literal to a static string.

Confidence Score: 4/5

Safe to merge after fixing the knowledge.mdx docs regression; all Gmail wiring is correct

One P1 finding (knowledge.mdx shows raw JS expression in public docs) caps the score at 4. The Gmail tool implementations, contract schemas, block wiring, and registry entries are all correct. The P2 error-detail finding in edit-draft/route.ts is non-blocking.

apps/docs/content/docs/en/tools/knowledge.mdx — rerankerModel description renders raw JS instead of model names

Important Files Changed

Sequence Diagram

sequenceDiagram
    participant UI as Gmail Block (V1/V2)
    participant Tool as gmail_edit_draft_v2
    participant Route as /api/tools/gmail/edit-draft
    participant Gmail as Gmail API

    UI->>Tool: params (draftId, to, body, ...)
    Tool->>Route: POST /api/tools/gmail/edit-draft
    Route->>Route: checkInternalAuth()
    Route->>Route: parseRequest(gmailEditDraftContract)
    alt has attachments
        Route->>Route: processFilesToUserFiles()
        Route->>Route: downloadFileFromStorage()
        Route->>Route: buildMimeMessage()
    else no attachments
        Route->>Route: buildSimpleEmailMessage()
    end
    Route->>Gmail: PUT /drafts/{draftId}
    Gmail-->>Route: { id, message: { id, threadId, labelIds } }
    Route-->>Tool: { success, output: { draftId, messageId, threadId, labelIds } }
    Tool-->>UI: output

    Note over UI,Gmail: gmail_update_label_v2 (tool-only / agent-facing)
    participant Agent as Agent/MCP
    participant LabelTool as gmail_update_label_v2
    Agent->>LabelTool: params (labelId, name, visibility)
    LabelTool->>Gmail: PATCH /labels/{labelId}
    Gmail-->>LabelTool: { id, name, messageListVisibility, labelListVisibility, type }
    LabelTool-->>Agent: output

_{Reviews (2): Last reviewed commit: "fix(knowledge): inline reranker model li..." | Re-trigger Greptile}

@greptile

@cursor review