feat(connector-google): combined Google connection (Mail/Calendar/Tasks/Contacts) + Connector.products SDK#222

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged

KrisBraun merged 24 commits into main from connector-google-clean

Jun 24, 2026

.changeset/connector-products.md

-Original file line number
+Diff line change
@@ -0,0 +1,5 @@
+---
+"@plotday/twister": minor
+---
+Added: Connector.products metadata for combined (multi-product) connectors.

.changeset/deploy-hide-internal-perms.md

-Original file line number
+Diff line change
@@ -0,0 +1,5 @@
+---
+"@plotday/twister": patch
+---
+Fixed: the `plot deploy` permissions summary no longer prints internal underscore-prefixed runtime markers (`_products`, `_dynamic_link_types`, `_providers`, `_ai_required`, …) — only user-facing tool permissions are shown.

connectors/gmail/src/channels.ts

-Original file line number
+Diff line change
@@ -0,0 +1,76 @@
+import type { AuthToken, Channel } from "@plotday/twister/tools/integrations";
+import type { LinkTypeConfig } from "@plotday/twister/tools/integrations";
+import { GmailApi } from "./gmail-api";
+// ---------------------------------------------------------------------------
+// Scope constants
+// ---------------------------------------------------------------------------
+export const GMAIL_MODIFY_SCOPE = "https://www.googleapis.com/auth/gmail.modify";
+// ---------------------------------------------------------------------------
+// Link types
+// ---------------------------------------------------------------------------
+export const GMAIL_LINK_TYPES: LinkTypeConfig[] = [
+ {
+ type: "email",
+ label: "Thread",
+ noteLabel: "Reply",
+ sharingModel: "message" as const,
+ composePlaceholder: "Send a Gmail email",
+ composeVerb: "Send",
+ replyPlaceholder: "Reply",
+ replyVerb: "Send",
+ supportsFileAttachments: true,
+ logo: "https://api.iconify.design/logos/google-gmail.svg",
+ logoMono: "https://api.iconify.design/simple-icons/gmail.svg",
+ contactRoles: [
+ { id: "to", label: "To", default: true },
+ { id: "cc", label: "CC" },
+ { id: "bcc", label: "BCC", hidden: true },
+ ],
+ supportsContactChanges: true,
+ // Gmail composes target any address — a Plot contact (with or without
+ // a Gmail-connection row) or a free-form typed email delivered via
+ // `inviteEmails`. The runtime fills `recipients` from the
+ // connection-scoped row when available and falls back to
+ // `contact.email` otherwise.
+ compose: {
+ targets: "addresses" as const,
+ },
+ },
+];
+// ---------------------------------------------------------------------------
+// Channel listing
+// ---------------------------------------------------------------------------
+/**
+ * Returns available Gmail labels as channel resources for a given token.
+ *
+ * Filters out system labels except for INBOX, SENT, DRAFT, IMPORTANT, and
+ * STARRED. Defaults to enabling INBOX and SENT only.
+ */
+export async function getGmailChannels(token: AuthToken): Promise<Channel[]> {
+ const api = new GmailApi(token.token);
+ const labels = await api.getLabels();
+ return labels
+ .filter(
+ (l: any) =>
+ l.type !== "system" ||
+ ["INBOX", "SENT", "DRAFT", "IMPORTANT", "STARRED"].includes(l.id)
+ )
+ // Default to syncing the user's actual conversations: Inbox (incoming)
+ // and Sent (outgoing). Important/Starred are overlapping views of mail
+ // that's mostly already in the Inbox, so enabling them by default would
+ // largely re-sync the same threads; Draft and user-created labels would
+ // crowd the view. They're all still available to enable manually, and
+ // Spam/Trash aren't even listed (filtered above).
+ .map((l: any) => ({
+ id: l.id,
+ title: l.name,
+ enabledByDefault: l.id === "INBOX" || l.id === "SENT",
+ }));
+}

blocks\n(function() {\n function addCopyButtons() {\n document.querySelectorAll('pre code').forEach(function(codeBlock) {\n if (codeBlock.parentElement.hasAttribute('data-copy-added')) return;\n codeBlock.parentElement.setAttribute('data-copy-added', 'true');\n \n var btn = document.createElement('button');\n btn.textContent = 'Copy';\n btn.style.cssText = 'position:absolute;top:4px;right:4px;padding:2px 8px;font-size:11px;background:#4ecdc4;border:none;border-radius:4px;color:#1a1a2e;cursor:pointer;opacity:0.7;transition:opacity 0.2s;';\n btn.onmouseover = function() { this.style.opacity = '1'; };\n btn.onmouseout = function() { this.style.opacity = '0.7'; };\n btn.onclick = function() {\n navigator.clipboard.writeText(codeBlock.textContent).then(function() {\n btn.textContent = 'Copied!';\n setTimeout(function() { btn.textContent = 'Copy'; }, 1500);\n });\n };\n codeBlock.parentElement.style.position = 'relative';\n codeBlock.parentElement.appendChild(btn);\n });\n }\n \n addCopyButtons();\n \n // Re-run on dynamic content\n var observer = new MutationObserver(addCopyButtons);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Add Copy Buttons to Code Blocks"); } } catch(__e) { console.warn('[Userscript:Add Copy Buttons to Code Blocks]', __e); } })(); (function(){ try { var __m = "github.com"; var __re = new RegExp('^' + "github\\.com" + ' Skip to contentNavigation Menu Sign inAppearance settings AI CODE CREATIONGitHub CopilotWrite better code with AI GitHub Copilot appDirect agents from issue to merge MCP RegistryIntegrate external tools DEVELOPER WORKFLOWSActionsAutomate any workflow CodespacesInstant dev environments IssuesPlan and track work Code ReviewManage code changes Code QualityEnforce quality at merge APPLICATION SECURITYGitHub Advanced SecurityFind and fix vulnerabilities Code securitySecure your code as you build Secret protectionStop leaks before they start EXPLOREWhy GitHub Documentation Blog Changelog Marketplace View all features BY COMPANY SIZEEnterprises Small and medium teams Startups Nonprofits BY USE CASEApp Modernization DevSecOps DevOps CI/CD View all use cases BY INDUSTRYHealthcare Financial services Manufacturing Government View all industries View all solutions EXPLORE BY TOPICAI Software Development DevOps Security View all topics EXPLORE BY TYPECustomer stories Events & webinars Ebooks & reports Business insights GitHub Skills SUPPORT & SERVICESDocumentation Customer support Community forum Trust center Partners View all resources COMMUNITYGitHub SponsorsFund open source developers PROGRAMSSecurity Lab Maintainer Community GitHub Stars Archive Program REPOSITORIESTopics Trending Collections ENTERPRISE SOLUTIONSEnterprise platformAI-powered developer platform AVAILABLE ADD-ONSGitHub Advanced SecurityEnterprise-grade security features Copilot for BusinessEnterprise-grade AI features Premium SupportEnterprise-grade 24/7 support Pricing Sign in Sign upAppearance settings You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert Uh oh! There was an error while loading. Please reload this page. plotday /plotPublic Notifications You must be signed in to change notification settings Fork 0 Star 2 Code Issues0 Pull requests0 Actions Projects Security and quality0 Insights Additional navigation options Code Issues Pull requests Actions Projects Security and quality Insights feat(connector-google): combined Google connection (Mail/Calendar/Tasks/Contacts) + Connector.products SDK#222 New issue Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community. Sign up for GitHub By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails. Already on GitHub? Sign in to your account Merged KrisBraun merged 24 commits into main from connector-google-cleanJun 24, 2026 Conversation 0 Commits 24 Checks 1 Files changed Uh oh! There was an error while loading. Please reload this page. Merged feat(connector-google): combined Google connection (Mail/Calendar/Tasks/Contacts) + Connector.products SDK #222 Show file tree Hide file tree Changes from all commits Commits Show all changes 24 commits Select commit Hold shift + click to select a range e0fdcb3 feat(connector-google): scaffold combined Google connector package KrisBraun Jun 23, 2026b690682 feat(connector-google): product channel-id namespacing KrisBraun Jun 23, 2026a49a813 feat(connector-google): per-product optional scope groups + products … KrisBraun Jun 23, 2026c9d8bde feat(connector-google): product module interface + registry KrisBraun Jun 23, 2026d972e7d feat(connector-google): scope-gated composition, demux, and Google class KrisBraun Jun 23, 202676b2cf7 refactor(connector-google-calendar): extract channel listing + scopes… KrisBraun Jun 23, 2026e3d8ba5 feat(connector-google): wire calendar product (channel listing, reuse… KrisBraun Jun 23, 2026e2cea3e chore(connector-google-calendar): drop dead listCalendarsWithApi afte… KrisBraun Jun 23, 20266e36fb1 refactor(connector-gmail): extract channel listing + scopes + link ty… KrisBraun Jun 23, 202655075d8 refactor(connector-google-tasks): extract channel listing + scopes + … KrisBraun Jun 23, 20264f40ef3 refactor(connector-google-contacts): export channel listing + scopes … KrisBraun Jun 23, 2026837e2f6 feat(connector-google): wire mail, tasks, contacts products (channel … KrisBraun Jun 23, 20268a6737f feat(connector-google): pure per-product status derivation (spec 2.4/… KrisBraun Jun 23, 2026f7bfc60 refactor(connector-google-calendar): extract initial-backfill sync in… KrisBraun Jun 23, 2026f450ca1 chore(connector-google-calendar): drop dead methods/imports orphaned … KrisBraun Jun 23, 20260f876ac feat(twister): add Connector.products metadata for combined connectors KrisBraun Jun 23, 202640e42e5 fix(twister): hide internal underscore-prefixed markers from deploy p… KrisBraun Jun 23, 202677548f7 fix(connector-google): combine product descriptions with scope reason… KrisBraun Jun 23, 20265386140 fix(connector-google): use the Google Contacts brand logo KrisBraun Jun 23, 2026b78287c fix(connector-google): point Contacts icon at hosted plot.day asset (… KrisBraun Jun 24, 2026eafc404 feat(google): re-home calendar live-updates (watch/webhook) + RSVP wr… KrisBraun Jun 24, 2026f2b0027 feat(google): re-home Mail (Gmail) sync into the combined connector KrisBraun Jun 24, 202601bdae0 feat(google): re-home Tasks sync into the combined connector KrisBraun Jun 24, 2026e2e02b2 feat(google): re-home Contacts sync into the combined connector KrisBraun Jun 24, 2026 File filter Filter by extension Filter by extension .json (2) .md (3) .ts (37) .yaml (1) All 4 file types selected Only manifest files Viewed files Clear filters Conversations Failed to load comments. Loading Uh oh! There was an error while loading. Please reload this page. Jump to Jump to file Failed to load files. Loading Uh oh! There was an error while loading. Please reload this page. Diff view Unified Split Hide whitespace Diff view Unified Split Hide whitespace .changeset/connector-products.md connector-products.md .changeset/deploy-hide-internal-perms.md deploy-hide-internal-perms.md connectors/gmail/src/channels.ts channels.ts connectors/gmail/src/gmail.ts gmail.ts connectors/gmail/src/index.ts index.ts connectors/gmail/src/sync.ts sync.ts connectors/google-calendar/src/channels.ts channels.ts connectors/google-calendar/src/google-calendar.ts google-calendar.ts connectors/google-calendar/src/index.ts index.ts connectors/google-calendar/src/sync.test.ts sync.test.ts connectors/google-calendar/src/sync.ts sync.ts connectors/google-contacts/src/channels.ts channels.ts connectors/google-contacts/src/google-contacts.ts google-contacts.ts connectors/google-contacts/src/index.ts index.ts connectors/google-contacts/src/sync.ts sync.ts connectors/google-tasks/src/channels.ts channels.ts connectors/google-tasks/src/google-tasks.ts google-tasks.ts connectors/google-tasks/src/index.ts index.ts connectors/google-tasks/src/sync.ts sync.ts connectors/google/README.md README.md connectors/google/package.json package.json connectors/google/src/compose.ts compose.ts connectors/google/src/google.ts google.ts connectors/google/src/index.ts index.ts connectors/google/src/product-channel.ts product-channel.ts connectors/google/src/product-status.ts product-status.ts connectors/google/src/products/calendar.ts calendar.ts connectors/google/src/products/contacts.ts contacts.ts connectors/google/src/products/mail.ts mail.ts connectors/google/src/products/product.ts product.ts connectors/google/src/products/tasks.ts tasks.ts connectors/google/src/scopes.ts scopes.ts connectors/google/test/calendar.test.ts calendar.test.ts connectors/google/test/compose.test.ts compose.test.ts connectors/google/test/product-channel.test.ts product-channel.test.ts connectors/google/test/product-status.test.ts product-status.test.ts connectors/google/test/products.test.ts products.test.ts connectors/google/test/scopes.test.ts scopes.test.ts connectors/google/tsconfig.json tsconfig.json connectors/google/vitest.config.ts vitest.config.ts pnpm-lock.yaml pnpm-lock.yaml twister/cli/commands/deploy.ts deploy.ts twister/src/connector.ts connector.ts There are no files selected for viewing 5 changes: 5 additions & 0 deletions 5 .changeset/connector-products.md Show comments View file Open in desktop Original file line number Diff line number Diff line change @@ -0,0 +1,5 @@ --- "@plotday/twister": minor --- Added: Connector.products metadata for combined (multi-product) connectors. 5 changes: 5 additions & 0 deletions 5 .changeset/deploy-hide-internal-perms.md Show comments View file Open in desktop Original file line number Diff line number Diff line change @@ -0,0 +1,5 @@ --- "@plotday/twister": patch --- Fixed: the `plot deploy` permissions summary no longer prints internal underscore-prefixed runtime markers (`_products`, `_dynamic_link_types`, `_providers`, `_ai_required`, …) — only user-facing tool permissions are shown. 76 changes: 76 additions & 0 deletions 76 connectors/gmail/src/channels.ts Show comments View file Open in desktop Original file line number Diff line number Diff line change @@ -0,0 +1,76 @@ import type { AuthToken, Channel } from "@plotday/twister/tools/integrations"; import type { LinkTypeConfig } from "@plotday/twister/tools/integrations"; import { GmailApi } from "./gmail-api"; // --------------------------------------------------------------------------- // Scope constants // --------------------------------------------------------------------------- export const GMAIL_MODIFY_SCOPE = "https://www.googleapis.com/auth/gmail.modify"; // --------------------------------------------------------------------------- // Link types // --------------------------------------------------------------------------- export const GMAIL_LINK_TYPES: LinkTypeConfig[] = [ { type: "email", label: "Thread", noteLabel: "Reply", sharingModel: "message" as const, composePlaceholder: "Send a Gmail email", composeVerb: "Send", replyPlaceholder: "Reply", replyVerb: "Send", supportsFileAttachments: true, logo: "https://api.iconify.design/logos/google-gmail.svg", logoMono: "https://api.iconify.design/simple-icons/gmail.svg", contactRoles: [ { id: "to", label: "To", default: true }, { id: "cc", label: "CC" }, { id: "bcc", label: "BCC", hidden: true }, ], supportsContactChanges: true, // Gmail composes target any address — a Plot contact (with or without // a Gmail-connection row) or a free-form typed email delivered via // `inviteEmails`. The runtime fills `recipients` from the // connection-scoped row when available and falls back to // `contact.email` otherwise. compose: { targets: "addresses" as const, }, }, ]; // --------------------------------------------------------------------------- // Channel listing // --------------------------------------------------------------------------- /** * Returns available Gmail labels as channel resources for a given token. * * Filters out system labels except for INBOX, SENT, DRAFT, IMPORTANT, and * STARRED. Defaults to enabling INBOX and SENT only. */ export async function getGmailChannels(token: AuthToken): Promise<Channel[]> { const api = new GmailApi(token.token); const labels = await api.getLabels(); return labels .filter( (l: any) => l.type !== "system" || ["INBOX", "SENT", "DRAFT", "IMPORTANT", "STARRED"].includes(l.id) ) // Default to syncing the user's actual conversations: Inbox (incoming) // and Sent (outgoing). Important/Starred are overlapping views of mail // that's mostly already in the Inbox, so enabling them by default would // largely re-sync the same threads; Draft and user-created labels would // crowd the view. They're all still available to enable manually, and // Spam/Trash aren't even listed (filtered above). .map((l: any) => ({ id: l.id, title: l.name, enabledByDefault: l.id === "INBOX" || l.id === "SENT", })); } Loading Oops, something went wrong. Uh oh! There was an error while loading. Please reload this page. Loading Oops, something went wrong. Uh oh! There was an error while loading. Please reload this page. Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later. Footer © 2026 GitHub, Inc. Footer navigation Terms Privacy Security Status Community Docs Contact You can’t perform that action at this time. , 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Force GitHub README to respect dark mode\n(function() {\n var style = document.createElement('style');\n style.textContent = '\n .markdown-body {\n color-scheme: dark light;\n }\n .markdown-body pre { background: #161b22 !important; }\n .markdown-body code { background: rgba(110, 118, 129, 0.4) !important; }\n .markdown-body table th, .markdown-body table td { border-color: #30363d !important; }\n .markdown-body img { background: #0d1117; }\n .markdown-body blockquote { border-left-color: #8b949e; }\n .markdown-body hr { border-color: #30363d; }\n ';\n document.head.appendChild(style);\n})();", "GitHub Dark Mode README Fix"); } } catch(__e) { console.warn('[Userscript:GitHub Dark Mode README Fix]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + ' Skip to contentNavigation Menu Sign inAppearance settings AI CODE CREATIONGitHub CopilotWrite better code with AI GitHub Copilot appDirect agents from issue to merge MCP RegistryIntegrate external tools DEVELOPER WORKFLOWSActionsAutomate any workflow CodespacesInstant dev environments IssuesPlan and track work Code ReviewManage code changes Code QualityEnforce quality at merge APPLICATION SECURITYGitHub Advanced SecurityFind and fix vulnerabilities Code securitySecure your code as you build Secret protectionStop leaks before they start EXPLOREWhy GitHub Documentation Blog Changelog Marketplace View all features BY COMPANY SIZEEnterprises Small and medium teams Startups Nonprofits BY USE CASEApp Modernization DevSecOps DevOps CI/CD View all use cases BY INDUSTRYHealthcare Financial services Manufacturing Government View all industries View all solutions EXPLORE BY TOPICAI Software Development DevOps Security View all topics EXPLORE BY TYPECustomer stories Events & webinars Ebooks & reports Business insights GitHub Skills SUPPORT & SERVICESDocumentation Customer support Community forum Trust center Partners View all resources COMMUNITYGitHub SponsorsFund open source developers PROGRAMSSecurity Lab Maintainer Community GitHub Stars Archive Program REPOSITORIESTopics Trending Collections ENTERPRISE SOLUTIONSEnterprise platformAI-powered developer platform AVAILABLE ADD-ONSGitHub Advanced SecurityEnterprise-grade security features Copilot for BusinessEnterprise-grade AI features Premium SupportEnterprise-grade 24/7 support Pricing Sign in Sign upAppearance settings You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert Uh oh! There was an error while loading. Please reload this page. plotday /plotPublic Notifications You must be signed in to change notification settings Fork 0 Star 2 Code Issues0 Pull requests0 Actions Projects Security and quality0 Insights Additional navigation options Code Issues Pull requests Actions Projects Security and quality Insights feat(connector-google): combined Google connection (Mail/Calendar/Tasks/Contacts) + Connector.products SDK#222 New issue Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community. Sign up for GitHub By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails. Already on GitHub? Sign in to your account Merged KrisBraun merged 24 commits into main from connector-google-cleanJun 24, 2026 Conversation 0 Commits 24 Checks 1 Files changed Uh oh! There was an error while loading. Please reload this page. Merged feat(connector-google): combined Google connection (Mail/Calendar/Tasks/Contacts) + Connector.products SDK #222 Show file tree Hide file tree Changes from all commits Commits Show all changes 24 commits Select commit Hold shift + click to select a range e0fdcb3 feat(connector-google): scaffold combined Google connector package KrisBraun Jun 23, 2026b690682 feat(connector-google): product channel-id namespacing KrisBraun Jun 23, 2026a49a813 feat(connector-google): per-product optional scope groups + products … KrisBraun Jun 23, 2026c9d8bde feat(connector-google): product module interface + registry KrisBraun Jun 23, 2026d972e7d feat(connector-google): scope-gated composition, demux, and Google class KrisBraun Jun 23, 202676b2cf7 refactor(connector-google-calendar): extract channel listing + scopes… KrisBraun Jun 23, 2026e3d8ba5 feat(connector-google): wire calendar product (channel listing, reuse… KrisBraun Jun 23, 2026e2cea3e chore(connector-google-calendar): drop dead listCalendarsWithApi afte… KrisBraun Jun 23, 20266e36fb1 refactor(connector-gmail): extract channel listing + scopes + link ty… KrisBraun Jun 23, 202655075d8 refactor(connector-google-tasks): extract channel listing + scopes + … KrisBraun Jun 23, 20264f40ef3 refactor(connector-google-contacts): export channel listing + scopes … KrisBraun Jun 23, 2026837e2f6 feat(connector-google): wire mail, tasks, contacts products (channel … KrisBraun Jun 23, 20268a6737f feat(connector-google): pure per-product status derivation (spec 2.4/… KrisBraun Jun 23, 2026f7bfc60 refactor(connector-google-calendar): extract initial-backfill sync in… KrisBraun Jun 23, 2026f450ca1 chore(connector-google-calendar): drop dead methods/imports orphaned … KrisBraun Jun 23, 20260f876ac feat(twister): add Connector.products metadata for combined connectors KrisBraun Jun 23, 202640e42e5 fix(twister): hide internal underscore-prefixed markers from deploy p… KrisBraun Jun 23, 202677548f7 fix(connector-google): combine product descriptions with scope reason… KrisBraun Jun 23, 20265386140 fix(connector-google): use the Google Contacts brand logo KrisBraun Jun 23, 2026b78287c fix(connector-google): point Contacts icon at hosted plot.day asset (… KrisBraun Jun 24, 2026eafc404 feat(google): re-home calendar live-updates (watch/webhook) + RSVP wr… KrisBraun Jun 24, 2026f2b0027 feat(google): re-home Mail (Gmail) sync into the combined connector KrisBraun Jun 24, 202601bdae0 feat(google): re-home Tasks sync into the combined connector KrisBraun Jun 24, 2026e2e02b2 feat(google): re-home Contacts sync into the combined connector KrisBraun Jun 24, 2026 File filter Filter by extension Filter by extension .json (2) .md (3) .ts (37) .yaml (1) All 4 file types selected Only manifest files Viewed files Clear filters Conversations Failed to load comments. Loading Uh oh! There was an error while loading. Please reload this page. Jump to Jump to file Failed to load files. Loading Uh oh! There was an error while loading. Please reload this page. Diff view Unified Split Hide whitespace Diff view Unified Split Hide whitespace .changeset/connector-products.md connector-products.md .changeset/deploy-hide-internal-perms.md deploy-hide-internal-perms.md connectors/gmail/src/channels.ts channels.ts connectors/gmail/src/gmail.ts gmail.ts connectors/gmail/src/index.ts index.ts connectors/gmail/src/sync.ts sync.ts connectors/google-calendar/src/channels.ts channels.ts connectors/google-calendar/src/google-calendar.ts google-calendar.ts connectors/google-calendar/src/index.ts index.ts connectors/google-calendar/src/sync.test.ts sync.test.ts connectors/google-calendar/src/sync.ts sync.ts connectors/google-contacts/src/channels.ts channels.ts connectors/google-contacts/src/google-contacts.ts google-contacts.ts connectors/google-contacts/src/index.ts index.ts connectors/google-contacts/src/sync.ts sync.ts connectors/google-tasks/src/channels.ts channels.ts connectors/google-tasks/src/google-tasks.ts google-tasks.ts connectors/google-tasks/src/index.ts index.ts connectors/google-tasks/src/sync.ts sync.ts connectors/google/README.md README.md connectors/google/package.json package.json connectors/google/src/compose.ts compose.ts connectors/google/src/google.ts google.ts connectors/google/src/index.ts index.ts connectors/google/src/product-channel.ts product-channel.ts connectors/google/src/product-status.ts product-status.ts connectors/google/src/products/calendar.ts calendar.ts connectors/google/src/products/contacts.ts contacts.ts connectors/google/src/products/mail.ts mail.ts connectors/google/src/products/product.ts product.ts connectors/google/src/products/tasks.ts tasks.ts connectors/google/src/scopes.ts scopes.ts connectors/google/test/calendar.test.ts calendar.test.ts connectors/google/test/compose.test.ts compose.test.ts connectors/google/test/product-channel.test.ts product-channel.test.ts connectors/google/test/product-status.test.ts product-status.test.ts connectors/google/test/products.test.ts products.test.ts connectors/google/test/scopes.test.ts scopes.test.ts connectors/google/tsconfig.json tsconfig.json connectors/google/vitest.config.ts vitest.config.ts pnpm-lock.yaml pnpm-lock.yaml twister/cli/commands/deploy.ts deploy.ts twister/src/connector.ts connector.ts There are no files selected for viewing 5 changes: 5 additions & 0 deletions 5 .changeset/connector-products.md Show comments View file Open in desktop Original file line number Diff line number Diff line change @@ -0,0 +1,5 @@ --- "@plotday/twister": minor --- Added: Connector.products metadata for combined (multi-product) connectors. 5 changes: 5 additions & 0 deletions 5 .changeset/deploy-hide-internal-perms.md Show comments View file Open in desktop Original file line number Diff line number Diff line change @@ -0,0 +1,5 @@ --- "@plotday/twister": patch --- Fixed: the `plot deploy` permissions summary no longer prints internal underscore-prefixed runtime markers (`_products`, `_dynamic_link_types`, `_providers`, `_ai_required`, …) — only user-facing tool permissions are shown. 76 changes: 76 additions & 0 deletions 76 connectors/gmail/src/channels.ts Show comments View file Open in desktop Original file line number Diff line number Diff line change @@ -0,0 +1,76 @@ import type { AuthToken, Channel } from "@plotday/twister/tools/integrations"; import type { LinkTypeConfig } from "@plotday/twister/tools/integrations"; import { GmailApi } from "./gmail-api"; // --------------------------------------------------------------------------- // Scope constants // --------------------------------------------------------------------------- export const GMAIL_MODIFY_SCOPE = "https://www.googleapis.com/auth/gmail.modify"; // --------------------------------------------------------------------------- // Link types // --------------------------------------------------------------------------- export const GMAIL_LINK_TYPES: LinkTypeConfig[] = [ { type: "email", label: "Thread", noteLabel: "Reply", sharingModel: "message" as const, composePlaceholder: "Send a Gmail email", composeVerb: "Send", replyPlaceholder: "Reply", replyVerb: "Send", supportsFileAttachments: true, logo: "https://api.iconify.design/logos/google-gmail.svg", logoMono: "https://api.iconify.design/simple-icons/gmail.svg", contactRoles: [ { id: "to", label: "To", default: true }, { id: "cc", label: "CC" }, { id: "bcc", label: "BCC", hidden: true }, ], supportsContactChanges: true, // Gmail composes target any address — a Plot contact (with or without // a Gmail-connection row) or a free-form typed email delivered via // `inviteEmails`. The runtime fills `recipients` from the // connection-scoped row when available and falls back to // `contact.email` otherwise. compose: { targets: "addresses" as const, }, }, ]; // --------------------------------------------------------------------------- // Channel listing // --------------------------------------------------------------------------- /** * Returns available Gmail labels as channel resources for a given token. * * Filters out system labels except for INBOX, SENT, DRAFT, IMPORTANT, and * STARRED. Defaults to enabling INBOX and SENT only. */ export async function getGmailChannels(token: AuthToken): Promise<Channel[]> { const api = new GmailApi(token.token); const labels = await api.getLabels(); return labels .filter( (l: any) => l.type !== "system" || ["INBOX", "SENT", "DRAFT", "IMPORTANT", "STARRED"].includes(l.id) ) // Default to syncing the user's actual conversations: Inbox (incoming) // and Sent (outgoing). Important/Starred are overlapping views of mail // that's mostly already in the Inbox, so enabling them by default would // largely re-sync the same threads; Draft and user-created labels would // crowd the view. They're all still available to enable manually, and // Spam/Trash aren't even listed (filtered above). .map((l: any) => ({ id: l.id, title: l.name, enabledByDefault: l.id === "INBOX" || l.id === "SENT", })); } Loading Oops, something went wrong. Uh oh! There was an error while loading. Please reload this page. Loading Oops, something went wrong. Uh oh! There was an error while loading. Please reload this page. Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later. Footer © 2026 GitHub, Inc. Footer navigation Terms Privacy Security Status Community Docs Contact You can’t perform that action at this time. , 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Highlight search terms from Google/DuckDuckGo/Bing referrer\n(function() {\n var ref = document.referrer;\n var terms = [];\n \n if (ref.includes('google.com') || ref.includes('duckduckgo.com') || ref.includes('bing.com')) {\n var url = new URL(ref);\n var q = url.searchParams.get('q') || url.searchParams.get('p');\n if (q) {\n terms = q.split(/\\s+/).filter(function(t) { return t.length > 2; });\n }\n }\n \n if (terms.length === 0) return;\n \n var style = document.createElement('style');\n style.textContent = '.userscript-highlight { background: #fbbf24; color: #1a1a2e; padding: 1px 3px; border-radius: 2px; }';\n document.head.appendChild(style);\n \n function highlight(node) {\n if (node.nodeType === 3) { // text node\n var text = node.textContent;\n var found = false;\n terms.forEach(function(term) {\n var regex = new RegExp('(' + term.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\') + ')', 'gi');\n if (regex.test(text)) {\n found = true;\n var frag = document.createDocumentFragment();\n var parts = text.split(regex);\n parts.forEach(function(part, i) {\n if (i % 2 === 0) {\n frag.appendChild(document.createTextNode(part));\n } else {\n var span = document.createElement('span');\n span.className = 'userscript-highlight';\n span.textContent = part;\n frag.appendChild(span);\n }\n });\n node.parentNode.replaceChild(frag, node);\n }\n });\n } else if (node.nodeType === 1 && node.childNodes) { // element\n var skipTags = ['SCRIPT', 'STYLE', 'NOSCRIPT', 'TEXTAREA', 'INPUT', 'SELECT'];\n if (!skipTags.includes(node.tagName)) {\n Array.from(node.childNodes).forEach(highlight);\n }\n }\n }\n \n highlight(document.body);\n \n // Re-highlight on dynamic content\n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1 || node.nodeType === 3) highlight(node);\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Highlight Search Terms"); } } catch(__e) { console.warn('[Userscript:Highlight Search Terms]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + ' Skip to contentNavigation Menu Sign inAppearance settings AI CODE CREATIONGitHub CopilotWrite better code with AI GitHub Copilot appDirect agents from issue to merge MCP RegistryIntegrate external tools DEVELOPER WORKFLOWSActionsAutomate any workflow CodespacesInstant dev environments IssuesPlan and track work Code ReviewManage code changes Code QualityEnforce quality at merge APPLICATION SECURITYGitHub Advanced SecurityFind and fix vulnerabilities Code securitySecure your code as you build Secret protectionStop leaks before they start EXPLOREWhy GitHub Documentation Blog Changelog Marketplace View all features BY COMPANY SIZEEnterprises Small and medium teams Startups Nonprofits BY USE CASEApp Modernization DevSecOps DevOps CI/CD View all use cases BY INDUSTRYHealthcare Financial services Manufacturing Government View all industries View all solutions EXPLORE BY TOPICAI Software Development DevOps Security View all topics EXPLORE BY TYPECustomer stories Events & webinars Ebooks & reports Business insights GitHub Skills SUPPORT & SERVICESDocumentation Customer support Community forum Trust center Partners View all resources COMMUNITYGitHub SponsorsFund open source developers PROGRAMSSecurity Lab Maintainer Community GitHub Stars Archive Program REPOSITORIESTopics Trending Collections ENTERPRISE SOLUTIONSEnterprise platformAI-powered developer platform AVAILABLE ADD-ONSGitHub Advanced SecurityEnterprise-grade security features Copilot for BusinessEnterprise-grade AI features Premium SupportEnterprise-grade 24/7 support Pricing Sign in Sign upAppearance settings You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert Uh oh! There was an error while loading. Please reload this page. plotday /plotPublic Notifications You must be signed in to change notification settings Fork 0 Star 2 Code Issues0 Pull requests0 Actions Projects Security and quality0 Insights Additional navigation options Code Issues Pull requests Actions Projects Security and quality Insights feat(connector-google): combined Google connection (Mail/Calendar/Tasks/Contacts) + Connector.products SDK#222 New issue Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community. Sign up for GitHub By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails. Already on GitHub? Sign in to your account Merged KrisBraun merged 24 commits into main from connector-google-cleanJun 24, 2026 Conversation 0 Commits 24 Checks 1 Files changed Uh oh! There was an error while loading. Please reload this page. Merged feat(connector-google): combined Google connection (Mail/Calendar/Tasks/Contacts) + Connector.products SDK #222 Show file tree Hide file tree Changes from all commits Commits Show all changes 24 commits Select commit Hold shift + click to select a range e0fdcb3 feat(connector-google): scaffold combined Google connector package KrisBraun Jun 23, 2026b690682 feat(connector-google): product channel-id namespacing KrisBraun Jun 23, 2026a49a813 feat(connector-google): per-product optional scope groups + products … KrisBraun Jun 23, 2026c9d8bde feat(connector-google): product module interface + registry KrisBraun Jun 23, 2026d972e7d feat(connector-google): scope-gated composition, demux, and Google class KrisBraun Jun 23, 202676b2cf7 refactor(connector-google-calendar): extract channel listing + scopes… KrisBraun Jun 23, 2026e3d8ba5 feat(connector-google): wire calendar product (channel listing, reuse… KrisBraun Jun 23, 2026e2cea3e chore(connector-google-calendar): drop dead listCalendarsWithApi afte… KrisBraun Jun 23, 20266e36fb1 refactor(connector-gmail): extract channel listing + scopes + link ty… KrisBraun Jun 23, 202655075d8 refactor(connector-google-tasks): extract channel listing + scopes + … KrisBraun Jun 23, 20264f40ef3 refactor(connector-google-contacts): export channel listing + scopes … KrisBraun Jun 23, 2026837e2f6 feat(connector-google): wire mail, tasks, contacts products (channel … KrisBraun Jun 23, 20268a6737f feat(connector-google): pure per-product status derivation (spec 2.4/… KrisBraun Jun 23, 2026f7bfc60 refactor(connector-google-calendar): extract initial-backfill sync in… KrisBraun Jun 23, 2026f450ca1 chore(connector-google-calendar): drop dead methods/imports orphaned … KrisBraun Jun 23, 20260f876ac feat(twister): add Connector.products metadata for combined connectors KrisBraun Jun 23, 202640e42e5 fix(twister): hide internal underscore-prefixed markers from deploy p… KrisBraun Jun 23, 202677548f7 fix(connector-google): combine product descriptions with scope reason… KrisBraun Jun 23, 20265386140 fix(connector-google): use the Google Contacts brand logo KrisBraun Jun 23, 2026b78287c fix(connector-google): point Contacts icon at hosted plot.day asset (… KrisBraun Jun 24, 2026eafc404 feat(google): re-home calendar live-updates (watch/webhook) + RSVP wr… KrisBraun Jun 24, 2026f2b0027 feat(google): re-home Mail (Gmail) sync into the combined connector KrisBraun Jun 24, 202601bdae0 feat(google): re-home Tasks sync into the combined connector KrisBraun Jun 24, 2026e2e02b2 feat(google): re-home Contacts sync into the combined connector KrisBraun Jun 24, 2026 File filter Filter by extension Filter by extension .json (2) .md (3) .ts (37) .yaml (1) All 4 file types selected Only manifest files Viewed files Clear filters Conversations Failed to load comments. Loading Uh oh! There was an error while loading. Please reload this page. Jump to Jump to file Failed to load files. Loading Uh oh! There was an error while loading. Please reload this page. Diff view Unified Split Hide whitespace Diff view Unified Split Hide whitespace .changeset/connector-products.md connector-products.md .changeset/deploy-hide-internal-perms.md deploy-hide-internal-perms.md connectors/gmail/src/channels.ts channels.ts connectors/gmail/src/gmail.ts gmail.ts connectors/gmail/src/index.ts index.ts connectors/gmail/src/sync.ts sync.ts connectors/google-calendar/src/channels.ts channels.ts connectors/google-calendar/src/google-calendar.ts google-calendar.ts connectors/google-calendar/src/index.ts index.ts connectors/google-calendar/src/sync.test.ts sync.test.ts connectors/google-calendar/src/sync.ts sync.ts connectors/google-contacts/src/channels.ts channels.ts connectors/google-contacts/src/google-contacts.ts google-contacts.ts connectors/google-contacts/src/index.ts index.ts connectors/google-contacts/src/sync.ts sync.ts connectors/google-tasks/src/channels.ts channels.ts connectors/google-tasks/src/google-tasks.ts google-tasks.ts connectors/google-tasks/src/index.ts index.ts connectors/google-tasks/src/sync.ts sync.ts connectors/google/README.md README.md connectors/google/package.json package.json connectors/google/src/compose.ts compose.ts connectors/google/src/google.ts google.ts connectors/google/src/index.ts index.ts connectors/google/src/product-channel.ts product-channel.ts connectors/google/src/product-status.ts product-status.ts connectors/google/src/products/calendar.ts calendar.ts connectors/google/src/products/contacts.ts contacts.ts connectors/google/src/products/mail.ts mail.ts connectors/google/src/products/product.ts product.ts connectors/google/src/products/tasks.ts tasks.ts connectors/google/src/scopes.ts scopes.ts connectors/google/test/calendar.test.ts calendar.test.ts connectors/google/test/compose.test.ts compose.test.ts connectors/google/test/product-channel.test.ts product-channel.test.ts connectors/google/test/product-status.test.ts product-status.test.ts connectors/google/test/products.test.ts products.test.ts connectors/google/test/scopes.test.ts scopes.test.ts connectors/google/tsconfig.json tsconfig.json connectors/google/vitest.config.ts vitest.config.ts pnpm-lock.yaml pnpm-lock.yaml twister/cli/commands/deploy.ts deploy.ts twister/src/connector.ts connector.ts There are no files selected for viewing 5 changes: 5 additions & 0 deletions 5 .changeset/connector-products.md Show comments View file Open in desktop Original file line number Diff line number Diff line change @@ -0,0 +1,5 @@ --- "@plotday/twister": minor --- Added: Connector.products metadata for combined (multi-product) connectors. 5 changes: 5 additions & 0 deletions 5 .changeset/deploy-hide-internal-perms.md Show comments View file Open in desktop Original file line number Diff line number Diff line change @@ -0,0 +1,5 @@ --- "@plotday/twister": patch --- Fixed: the `plot deploy` permissions summary no longer prints internal underscore-prefixed runtime markers (`_products`, `_dynamic_link_types`, `_providers`, `_ai_required`, …) — only user-facing tool permissions are shown. 76 changes: 76 additions & 0 deletions 76 connectors/gmail/src/channels.ts Show comments View file Open in desktop Original file line number Diff line number Diff line change @@ -0,0 +1,76 @@ import type { AuthToken, Channel } from "@plotday/twister/tools/integrations"; import type { LinkTypeConfig } from "@plotday/twister/tools/integrations"; import { GmailApi } from "./gmail-api"; // --------------------------------------------------------------------------- // Scope constants // --------------------------------------------------------------------------- export const GMAIL_MODIFY_SCOPE = "https://www.googleapis.com/auth/gmail.modify"; // --------------------------------------------------------------------------- // Link types // --------------------------------------------------------------------------- export const GMAIL_LINK_TYPES: LinkTypeConfig[] = [ { type: "email", label: "Thread", noteLabel: "Reply", sharingModel: "message" as const, composePlaceholder: "Send a Gmail email", composeVerb: "Send", replyPlaceholder: "Reply", replyVerb: "Send", supportsFileAttachments: true, logo: "https://api.iconify.design/logos/google-gmail.svg", logoMono: "https://api.iconify.design/simple-icons/gmail.svg", contactRoles: [ { id: "to", label: "To", default: true }, { id: "cc", label: "CC" }, { id: "bcc", label: "BCC", hidden: true }, ], supportsContactChanges: true, // Gmail composes target any address — a Plot contact (with or without // a Gmail-connection row) or a free-form typed email delivered via // `inviteEmails`. The runtime fills `recipients` from the // connection-scoped row when available and falls back to // `contact.email` otherwise. compose: { targets: "addresses" as const, }, }, ]; // --------------------------------------------------------------------------- // Channel listing // --------------------------------------------------------------------------- /** * Returns available Gmail labels as channel resources for a given token. * * Filters out system labels except for INBOX, SENT, DRAFT, IMPORTANT, and * STARRED. Defaults to enabling INBOX and SENT only. */ export async function getGmailChannels(token: AuthToken): Promise<Channel[]> { const api = new GmailApi(token.token); const labels = await api.getLabels(); return labels .filter( (l: any) => l.type !== "system" || ["INBOX", "SENT", "DRAFT", "IMPORTANT", "STARRED"].includes(l.id) ) // Default to syncing the user's actual conversations: Inbox (incoming) // and Sent (outgoing). Important/Starred are overlapping views of mail // that's mostly already in the Inbox, so enabling them by default would // largely re-sync the same threads; Draft and user-created labels would // crowd the view. They're all still available to enable manually, and // Spam/Trash aren't even listed (filtered above). .map((l: any) => ({ id: l.id, title: l.name, enabledByDefault: l.id === "INBOX" || l.id === "SENT", })); } Loading Oops, something went wrong. Uh oh! There was an error while loading. Please reload this page. Loading Oops, something went wrong. Uh oh! There was an error while loading. Please reload this page. Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later. Footer © 2026 GitHub, Inc. Footer navigation Terms Privacy Security Status Community Docs Contact You can’t perform that action at this time. , 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Strip utm_, fbclid, gclid, etc. from all links on page\n(function() {\n var trackingParams = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content',\n 'fbclid', 'gclid', 'dclid', 'msclkid', 'yclid',\n 'ref', 'ref_src', 'source', 'medium', 'campaign'];\n \n function cleanUrl(url) {\n try {\n var u = new URL(url, window.location.origin);\n var changed = false;\n trackingParams.forEach(function(p) {\n if (u.searchParams.has(p)) {\n u.searchParams.delete(p);\n changed = true;\n }\n });\n return changed ? u.toString() : url;\n } catch (e) {\n return url;\n }\n }\n \n function cleanLinks() {\n document.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n \n cleanLinks();\n \n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1) {\n if (node.tagName === 'A') cleanLinks();\n node.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Remove Tracking Parameters from Links"); } } catch(__e) { console.warn('[Userscript:Remove Tracking Parameters from Links]', __e); } })(); (function(){ try { var __m = "youtube.com"; var __re = new RegExp('^' + "youtube\\.com" + ' Skip to contentNavigation Menu Sign inAppearance settings AI CODE CREATIONGitHub CopilotWrite better code with AI GitHub Copilot appDirect agents from issue to merge MCP RegistryIntegrate external tools DEVELOPER WORKFLOWSActionsAutomate any workflow CodespacesInstant dev environments IssuesPlan and track work Code ReviewManage code changes Code QualityEnforce quality at merge APPLICATION SECURITYGitHub Advanced SecurityFind and fix vulnerabilities Code securitySecure your code as you build Secret protectionStop leaks before they start EXPLOREWhy GitHub Documentation Blog Changelog Marketplace View all features BY COMPANY SIZEEnterprises Small and medium teams Startups Nonprofits BY USE CASEApp Modernization DevSecOps DevOps CI/CD View all use cases BY INDUSTRYHealthcare Financial services Manufacturing Government View all industries View all solutions EXPLORE BY TOPICAI Software Development DevOps Security View all topics EXPLORE BY TYPECustomer stories Events & webinars Ebooks & reports Business insights GitHub Skills SUPPORT & SERVICESDocumentation Customer support Community forum Trust center Partners View all resources COMMUNITYGitHub SponsorsFund open source developers PROGRAMSSecurity Lab Maintainer Community GitHub Stars Archive Program REPOSITORIESTopics Trending Collections ENTERPRISE SOLUTIONSEnterprise platformAI-powered developer platform AVAILABLE ADD-ONSGitHub Advanced SecurityEnterprise-grade security features Copilot for BusinessEnterprise-grade AI features Premium SupportEnterprise-grade 24/7 support Pricing Sign in Sign upAppearance settings You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert Uh oh! There was an error while loading. Please reload this page. plotday /plotPublic Notifications You must be signed in to change notification settings Fork 0 Star 2 Code Issues0 Pull requests0 Actions Projects Security and quality0 Insights Additional navigation options Code Issues Pull requests Actions Projects Security and quality Insights feat(connector-google): combined Google connection (Mail/Calendar/Tasks/Contacts) + Connector.products SDK#222 New issue Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community. Sign up for GitHub By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails. Already on GitHub? Sign in to your account Merged KrisBraun merged 24 commits into main from connector-google-cleanJun 24, 2026 Conversation 0 Commits 24 Checks 1 Files changed Uh oh! There was an error while loading. Please reload this page. Merged feat(connector-google): combined Google connection (Mail/Calendar/Tasks/Contacts) + Connector.products SDK #222 Show file tree Hide file tree Changes from all commits Commits Show all changes 24 commits Select commit Hold shift + click to select a range e0fdcb3 feat(connector-google): scaffold combined Google connector package KrisBraun Jun 23, 2026b690682 feat(connector-google): product channel-id namespacing KrisBraun Jun 23, 2026a49a813 feat(connector-google): per-product optional scope groups + products … KrisBraun Jun 23, 2026c9d8bde feat(connector-google): product module interface + registry KrisBraun Jun 23, 2026d972e7d feat(connector-google): scope-gated composition, demux, and Google class KrisBraun Jun 23, 202676b2cf7 refactor(connector-google-calendar): extract channel listing + scopes… KrisBraun Jun 23, 2026e3d8ba5 feat(connector-google): wire calendar product (channel listing, reuse… KrisBraun Jun 23, 2026e2cea3e chore(connector-google-calendar): drop dead listCalendarsWithApi afte… KrisBraun Jun 23, 20266e36fb1 refactor(connector-gmail): extract channel listing + scopes + link ty… KrisBraun Jun 23, 202655075d8 refactor(connector-google-tasks): extract channel listing + scopes + … KrisBraun Jun 23, 20264f40ef3 refactor(connector-google-contacts): export channel listing + scopes … KrisBraun Jun 23, 2026837e2f6 feat(connector-google): wire mail, tasks, contacts products (channel … KrisBraun Jun 23, 20268a6737f feat(connector-google): pure per-product status derivation (spec 2.4/… KrisBraun Jun 23, 2026f7bfc60 refactor(connector-google-calendar): extract initial-backfill sync in… KrisBraun Jun 23, 2026f450ca1 chore(connector-google-calendar): drop dead methods/imports orphaned … KrisBraun Jun 23, 20260f876ac feat(twister): add Connector.products metadata for combined connectors KrisBraun Jun 23, 202640e42e5 fix(twister): hide internal underscore-prefixed markers from deploy p… KrisBraun Jun 23, 202677548f7 fix(connector-google): combine product descriptions with scope reason… KrisBraun Jun 23, 20265386140 fix(connector-google): use the Google Contacts brand logo KrisBraun Jun 23, 2026b78287c fix(connector-google): point Contacts icon at hosted plot.day asset (… KrisBraun Jun 24, 2026eafc404 feat(google): re-home calendar live-updates (watch/webhook) + RSVP wr… KrisBraun Jun 24, 2026f2b0027 feat(google): re-home Mail (Gmail) sync into the combined connector KrisBraun Jun 24, 202601bdae0 feat(google): re-home Tasks sync into the combined connector KrisBraun Jun 24, 2026e2e02b2 feat(google): re-home Contacts sync into the combined connector KrisBraun Jun 24, 2026 File filter Filter by extension Filter by extension .json (2) .md (3) .ts (37) .yaml (1) All 4 file types selected Only manifest files Viewed files Clear filters Conversations Failed to load comments. Loading Uh oh! There was an error while loading. Please reload this page. Jump to Jump to file Failed to load files. Loading Uh oh! There was an error while loading. Please reload this page. Diff view Unified Split Hide whitespace Diff view Unified Split Hide whitespace .changeset/connector-products.md connector-products.md .changeset/deploy-hide-internal-perms.md deploy-hide-internal-perms.md connectors/gmail/src/channels.ts channels.ts connectors/gmail/src/gmail.ts gmail.ts connectors/gmail/src/index.ts index.ts connectors/gmail/src/sync.ts sync.ts connectors/google-calendar/src/channels.ts channels.ts connectors/google-calendar/src/google-calendar.ts google-calendar.ts connectors/google-calendar/src/index.ts index.ts connectors/google-calendar/src/sync.test.ts sync.test.ts connectors/google-calendar/src/sync.ts sync.ts connectors/google-contacts/src/channels.ts channels.ts connectors/google-contacts/src/google-contacts.ts google-contacts.ts connectors/google-contacts/src/index.ts index.ts connectors/google-contacts/src/sync.ts sync.ts connectors/google-tasks/src/channels.ts channels.ts connectors/google-tasks/src/google-tasks.ts google-tasks.ts connectors/google-tasks/src/index.ts index.ts connectors/google-tasks/src/sync.ts sync.ts connectors/google/README.md README.md connectors/google/package.json package.json connectors/google/src/compose.ts compose.ts connectors/google/src/google.ts google.ts connectors/google/src/index.ts index.ts connectors/google/src/product-channel.ts product-channel.ts connectors/google/src/product-status.ts product-status.ts connectors/google/src/products/calendar.ts calendar.ts connectors/google/src/products/contacts.ts contacts.ts connectors/google/src/products/mail.ts mail.ts connectors/google/src/products/product.ts product.ts connectors/google/src/products/tasks.ts tasks.ts connectors/google/src/scopes.ts scopes.ts connectors/google/test/calendar.test.ts calendar.test.ts connectors/google/test/compose.test.ts compose.test.ts connectors/google/test/product-channel.test.ts product-channel.test.ts connectors/google/test/product-status.test.ts product-status.test.ts connectors/google/test/products.test.ts products.test.ts connectors/google/test/scopes.test.ts scopes.test.ts connectors/google/tsconfig.json tsconfig.json connectors/google/vitest.config.ts vitest.config.ts pnpm-lock.yaml pnpm-lock.yaml twister/cli/commands/deploy.ts deploy.ts twister/src/connector.ts connector.ts There are no files selected for viewing 5 changes: 5 additions & 0 deletions 5 .changeset/connector-products.md Show comments View file Open in desktop Original file line number Diff line number Diff line change @@ -0,0 +1,5 @@ --- "@plotday/twister": minor --- Added: Connector.products metadata for combined (multi-product) connectors. 5 changes: 5 additions & 0 deletions 5 .changeset/deploy-hide-internal-perms.md Show comments View file Open in desktop Original file line number Diff line number Diff line change @@ -0,0 +1,5 @@ --- "@plotday/twister": patch --- Fixed: the `plot deploy` permissions summary no longer prints internal underscore-prefixed runtime markers (`_products`, `_dynamic_link_types`, `_providers`, `_ai_required`, …) — only user-facing tool permissions are shown. 76 changes: 76 additions & 0 deletions 76 connectors/gmail/src/channels.ts Show comments View file Open in desktop Original file line number Diff line number Diff line change @@ -0,0 +1,76 @@ import type { AuthToken, Channel } from "@plotday/twister/tools/integrations"; import type { LinkTypeConfig } from "@plotday/twister/tools/integrations"; import { GmailApi } from "./gmail-api"; // --------------------------------------------------------------------------- // Scope constants // --------------------------------------------------------------------------- export const GMAIL_MODIFY_SCOPE = "https://www.googleapis.com/auth/gmail.modify"; // --------------------------------------------------------------------------- // Link types // --------------------------------------------------------------------------- export const GMAIL_LINK_TYPES: LinkTypeConfig[] = [ { type: "email", label: "Thread", noteLabel: "Reply", sharingModel: "message" as const, composePlaceholder: "Send a Gmail email", composeVerb: "Send", replyPlaceholder: "Reply", replyVerb: "Send", supportsFileAttachments: true, logo: "https://api.iconify.design/logos/google-gmail.svg", logoMono: "https://api.iconify.design/simple-icons/gmail.svg", contactRoles: [ { id: "to", label: "To", default: true }, { id: "cc", label: "CC" }, { id: "bcc", label: "BCC", hidden: true }, ], supportsContactChanges: true, // Gmail composes target any address — a Plot contact (with or without // a Gmail-connection row) or a free-form typed email delivered via // `inviteEmails`. The runtime fills `recipients` from the // connection-scoped row when available and falls back to // `contact.email` otherwise. compose: { targets: "addresses" as const, }, }, ]; // --------------------------------------------------------------------------- // Channel listing // --------------------------------------------------------------------------- /** * Returns available Gmail labels as channel resources for a given token. * * Filters out system labels except for INBOX, SENT, DRAFT, IMPORTANT, and * STARRED. Defaults to enabling INBOX and SENT only. */ export async function getGmailChannels(token: AuthToken): Promise<Channel[]> { const api = new GmailApi(token.token); const labels = await api.getLabels(); return labels .filter( (l: any) => l.type !== "system" || ["INBOX", "SENT", "DRAFT", "IMPORTANT", "STARRED"].includes(l.id) ) // Default to syncing the user's actual conversations: Inbox (incoming) // and Sent (outgoing). Important/Starred are overlapping views of mail // that's mostly already in the Inbox, so enabling them by default would // largely re-sync the same threads; Draft and user-created labels would // crowd the view. They're all still available to enable manually, and // Spam/Trash aren't even listed (filtered above). .map((l: any) => ({ id: l.id, title: l.name, enabledByDefault: l.id === "INBOX" || l.id === "SENT", })); } Loading Oops, something went wrong. Uh oh! There was an error while loading. Please reload this page. Loading Oops, something went wrong. Uh oh! There was an error while loading. Please reload this page. Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later. Footer © 2026 GitHub, Inc. Footer navigation Terms Privacy Security Status Community Docs Contact You can’t perform that action at this time. , 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Auto-enable theater mode on YouTube\n(function() {\n function tryTheater() {\n var btn = document.querySelector('button[aria-label=\"Theater mode\"], ytd-player #player button[title=\"Theater mode\"]');\n if (btn && !btn.classList.contains('activated')) {\n btn.click();\n }\n }\n \n // Try immediately\n tryTheater();\n \n // Try after navigation (SPA)\n var lastUrl = location.href;\n setInterval(function() {\n if (location.href !== lastUrl) {\n lastUrl = location.href;\n setTimeout(tryTheater, 500);\n }\n }, 1000);\n \n // Also try on player load\n var observer = new MutationObserver(tryTheater);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "YouTube Theater Mode Default"); } } catch(__e) { console.warn('[Userscript:YouTube Theater Mode Default]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + ' Skip to contentNavigation Menu Sign inAppearance settings AI CODE CREATIONGitHub CopilotWrite better code with AI GitHub Copilot appDirect agents from issue to merge MCP RegistryIntegrate external tools DEVELOPER WORKFLOWSActionsAutomate any workflow CodespacesInstant dev environments IssuesPlan and track work Code ReviewManage code changes Code QualityEnforce quality at merge APPLICATION SECURITYGitHub Advanced SecurityFind and fix vulnerabilities Code securitySecure your code as you build Secret protectionStop leaks before they start EXPLOREWhy GitHub Documentation Blog Changelog Marketplace View all features BY COMPANY SIZEEnterprises Small and medium teams Startups Nonprofits BY USE CASEApp Modernization DevSecOps DevOps CI/CD View all use cases BY INDUSTRYHealthcare Financial services Manufacturing Government View all industries View all solutions EXPLORE BY TOPICAI Software Development DevOps Security View all topics EXPLORE BY TYPECustomer stories Events & webinars Ebooks & reports Business insights GitHub Skills SUPPORT & SERVICESDocumentation Customer support Community forum Trust center Partners View all resources COMMUNITYGitHub SponsorsFund open source developers PROGRAMSSecurity Lab Maintainer Community GitHub Stars Archive Program REPOSITORIESTopics Trending Collections ENTERPRISE SOLUTIONSEnterprise platformAI-powered developer platform AVAILABLE ADD-ONSGitHub Advanced SecurityEnterprise-grade security features Copilot for BusinessEnterprise-grade AI features Premium SupportEnterprise-grade 24/7 support Pricing Sign in Sign upAppearance settings You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert Uh oh! There was an error while loading. Please reload this page. plotday /plotPublic Notifications You must be signed in to change notification settings Fork 0 Star 2 Code Issues0 Pull requests0 Actions Projects Security and quality0 Insights Additional navigation options Code Issues Pull requests Actions Projects Security and quality Insights feat(connector-google): combined Google connection (Mail/Calendar/Tasks/Contacts) + Connector.products SDK#222 New issue Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community. Sign up for GitHub By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails. Already on GitHub? Sign in to your account Merged KrisBraun merged 24 commits into main from connector-google-cleanJun 24, 2026 Conversation 0 Commits 24 Checks 1 Files changed Uh oh! There was an error while loading. Please reload this page. Merged feat(connector-google): combined Google connection (Mail/Calendar/Tasks/Contacts) + Connector.products SDK #222 Show file tree Hide file tree Changes from all commits Commits Show all changes 24 commits Select commit Hold shift + click to select a range e0fdcb3 feat(connector-google): scaffold combined Google connector package KrisBraun Jun 23, 2026b690682 feat(connector-google): product channel-id namespacing KrisBraun Jun 23, 2026a49a813 feat(connector-google): per-product optional scope groups + products … KrisBraun Jun 23, 2026c9d8bde feat(connector-google): product module interface + registry KrisBraun Jun 23, 2026d972e7d feat(connector-google): scope-gated composition, demux, and Google class KrisBraun Jun 23, 202676b2cf7 refactor(connector-google-calendar): extract channel listing + scopes… KrisBraun Jun 23, 2026e3d8ba5 feat(connector-google): wire calendar product (channel listing, reuse… KrisBraun Jun 23, 2026e2cea3e chore(connector-google-calendar): drop dead listCalendarsWithApi afte… KrisBraun Jun 23, 20266e36fb1 refactor(connector-gmail): extract channel listing + scopes + link ty… KrisBraun Jun 23, 202655075d8 refactor(connector-google-tasks): extract channel listing + scopes + … KrisBraun Jun 23, 20264f40ef3 refactor(connector-google-contacts): export channel listing + scopes … KrisBraun Jun 23, 2026837e2f6 feat(connector-google): wire mail, tasks, contacts products (channel … KrisBraun Jun 23, 20268a6737f feat(connector-google): pure per-product status derivation (spec 2.4/… KrisBraun Jun 23, 2026f7bfc60 refactor(connector-google-calendar): extract initial-backfill sync in… KrisBraun Jun 23, 2026f450ca1 chore(connector-google-calendar): drop dead methods/imports orphaned … KrisBraun Jun 23, 20260f876ac feat(twister): add Connector.products metadata for combined connectors KrisBraun Jun 23, 202640e42e5 fix(twister): hide internal underscore-prefixed markers from deploy p… KrisBraun Jun 23, 202677548f7 fix(connector-google): combine product descriptions with scope reason… KrisBraun Jun 23, 20265386140 fix(connector-google): use the Google Contacts brand logo KrisBraun Jun 23, 2026b78287c fix(connector-google): point Contacts icon at hosted plot.day asset (… KrisBraun Jun 24, 2026eafc404 feat(google): re-home calendar live-updates (watch/webhook) + RSVP wr… KrisBraun Jun 24, 2026f2b0027 feat(google): re-home Mail (Gmail) sync into the combined connector KrisBraun Jun 24, 202601bdae0 feat(google): re-home Tasks sync into the combined connector KrisBraun Jun 24, 2026e2e02b2 feat(google): re-home Contacts sync into the combined connector KrisBraun Jun 24, 2026 File filter Filter by extension Filter by extension .json (2) .md (3) .ts (37) .yaml (1) All 4 file types selected Only manifest files Viewed files Clear filters Conversations Failed to load comments. Loading Uh oh! There was an error while loading. Please reload this page. Jump to Jump to file Failed to load files. Loading Uh oh! There was an error while loading. Please reload this page. Diff view Unified Split Hide whitespace Diff view Unified Split Hide whitespace .changeset/connector-products.md connector-products.md .changeset/deploy-hide-internal-perms.md deploy-hide-internal-perms.md connectors/gmail/src/channels.ts channels.ts connectors/gmail/src/gmail.ts gmail.ts connectors/gmail/src/index.ts index.ts connectors/gmail/src/sync.ts sync.ts connectors/google-calendar/src/channels.ts channels.ts connectors/google-calendar/src/google-calendar.ts google-calendar.ts connectors/google-calendar/src/index.ts index.ts connectors/google-calendar/src/sync.test.ts sync.test.ts connectors/google-calendar/src/sync.ts sync.ts connectors/google-contacts/src/channels.ts channels.ts connectors/google-contacts/src/google-contacts.ts google-contacts.ts connectors/google-contacts/src/index.ts index.ts connectors/google-contacts/src/sync.ts sync.ts connectors/google-tasks/src/channels.ts channels.ts connectors/google-tasks/src/google-tasks.ts google-tasks.ts connectors/google-tasks/src/index.ts index.ts connectors/google-tasks/src/sync.ts sync.ts connectors/google/README.md README.md connectors/google/package.json package.json connectors/google/src/compose.ts compose.ts connectors/google/src/google.ts google.ts connectors/google/src/index.ts index.ts connectors/google/src/product-channel.ts product-channel.ts connectors/google/src/product-status.ts product-status.ts connectors/google/src/products/calendar.ts calendar.ts connectors/google/src/products/contacts.ts contacts.ts connectors/google/src/products/mail.ts mail.ts connectors/google/src/products/product.ts product.ts connectors/google/src/products/tasks.ts tasks.ts connectors/google/src/scopes.ts scopes.ts connectors/google/test/calendar.test.ts calendar.test.ts connectors/google/test/compose.test.ts compose.test.ts connectors/google/test/product-channel.test.ts product-channel.test.ts connectors/google/test/product-status.test.ts product-status.test.ts connectors/google/test/products.test.ts products.test.ts connectors/google/test/scopes.test.ts scopes.test.ts connectors/google/tsconfig.json tsconfig.json connectors/google/vitest.config.ts vitest.config.ts pnpm-lock.yaml pnpm-lock.yaml twister/cli/commands/deploy.ts deploy.ts twister/src/connector.ts connector.ts There are no files selected for viewing 5 changes: 5 additions & 0 deletions 5 .changeset/connector-products.md Show comments View file Open in desktop Original file line number Diff line number Diff line change @@ -0,0 +1,5 @@ --- "@plotday/twister": minor --- Added: Connector.products metadata for combined (multi-product) connectors. 5 changes: 5 additions & 0 deletions 5 .changeset/deploy-hide-internal-perms.md Show comments View file Open in desktop Original file line number Diff line number Diff line change @@ -0,0 +1,5 @@ --- "@plotday/twister": patch --- Fixed: the `plot deploy` permissions summary no longer prints internal underscore-prefixed runtime markers (`_products`, `_dynamic_link_types`, `_providers`, `_ai_required`, …) — only user-facing tool permissions are shown. 76 changes: 76 additions & 0 deletions 76 connectors/gmail/src/channels.ts Show comments View file Open in desktop Original file line number Diff line number Diff line change @@ -0,0 +1,76 @@ import type { AuthToken, Channel } from "@plotday/twister/tools/integrations"; import type { LinkTypeConfig } from "@plotday/twister/tools/integrations"; import { GmailApi } from "./gmail-api"; // --------------------------------------------------------------------------- // Scope constants // --------------------------------------------------------------------------- export const GMAIL_MODIFY_SCOPE = "https://www.googleapis.com/auth/gmail.modify"; // --------------------------------------------------------------------------- // Link types // --------------------------------------------------------------------------- export const GMAIL_LINK_TYPES: LinkTypeConfig[] = [ { type: "email", label: "Thread", noteLabel: "Reply", sharingModel: "message" as const, composePlaceholder: "Send a Gmail email", composeVerb: "Send", replyPlaceholder: "Reply", replyVerb: "Send", supportsFileAttachments: true, logo: "https://api.iconify.design/logos/google-gmail.svg", logoMono: "https://api.iconify.design/simple-icons/gmail.svg", contactRoles: [ { id: "to", label: "To", default: true }, { id: "cc", label: "CC" }, { id: "bcc", label: "BCC", hidden: true }, ], supportsContactChanges: true, // Gmail composes target any address — a Plot contact (with or without // a Gmail-connection row) or a free-form typed email delivered via // `inviteEmails`. The runtime fills `recipients` from the // connection-scoped row when available and falls back to // `contact.email` otherwise. compose: { targets: "addresses" as const, }, }, ]; // --------------------------------------------------------------------------- // Channel listing // --------------------------------------------------------------------------- /** * Returns available Gmail labels as channel resources for a given token. * * Filters out system labels except for INBOX, SENT, DRAFT, IMPORTANT, and * STARRED. Defaults to enabling INBOX and SENT only. */ export async function getGmailChannels(token: AuthToken): Promise<Channel[]> { const api = new GmailApi(token.token); const labels = await api.getLabels(); return labels .filter( (l: any) => l.type !== "system" || ["INBOX", "SENT", "DRAFT", "IMPORTANT", "STARRED"].includes(l.id) ) // Default to syncing the user's actual conversations: Inbox (incoming) // and Sent (outgoing). Important/Starred are overlapping views of mail // that's mostly already in the Inbox, so enabling them by default would // largely re-sync the same threads; Draft and user-created labels would // crowd the view. They're all still available to enable manually, and // Spam/Trash aren't even listed (filtered above). .map((l: any) => ({ id: l.id, title: l.name, enabledByDefault: l.id === "INBOX" || l.id === "SENT", })); } Loading Oops, something went wrong. Uh oh! There was an error while loading. Please reload this page. Loading Oops, something went wrong. Uh oh! There was an error while loading. Please reload this page. Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later. Footer © 2026 GitHub, Inc. Footer navigation Terms Privacy Security Status Community Docs Contact You can’t perform that action at this time. , 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Remove or un-stick sticky/fixed headers that block content\n(function() {\n function unstick() {\n document.querySelectorAll('header, nav, [role=\"banner\"], .header, .navbar, .sticky, .fixed-top, [style*=\"position: fixed\"], [style*=\"position:sticky\"]').forEach(function(el) {\n if (el.style.position === 'fixed' || el.style.position === 'sticky' || \n getComputedStyle(el).position === 'fixed' || getComputedStyle(el).position === 'sticky') {\n el.style.position = 'static';\n el.style.top = 'auto';\n el.style.zIndex = 'auto';\n }\n });\n }\n \n unstick();\n \n var observer = new MutationObserver(unstick);\n observer.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ['style', 'class'] });\n})();", "Kill Sticky Headers"); } } catch(__e) { console.warn('[Userscript:Kill Sticky Headers]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + ' Skip to contentNavigation Menu Sign inAppearance settings AI CODE CREATIONGitHub CopilotWrite better code with AI GitHub Copilot appDirect agents from issue to merge MCP RegistryIntegrate external tools DEVELOPER WORKFLOWSActionsAutomate any workflow CodespacesInstant dev environments IssuesPlan and track work Code ReviewManage code changes Code QualityEnforce quality at merge APPLICATION SECURITYGitHub Advanced SecurityFind and fix vulnerabilities Code securitySecure your code as you build Secret protectionStop leaks before they start EXPLOREWhy GitHub Documentation Blog Changelog Marketplace View all features BY COMPANY SIZEEnterprises Small and medium teams Startups Nonprofits BY USE CASEApp Modernization DevSecOps DevOps CI/CD View all use cases BY INDUSTRYHealthcare Financial services Manufacturing Government View all industries View all solutions EXPLORE BY TOPICAI Software Development DevOps Security View all topics EXPLORE BY TYPECustomer stories Events & webinars Ebooks & reports Business insights GitHub Skills SUPPORT & SERVICESDocumentation Customer support Community forum Trust center Partners View all resources COMMUNITYGitHub SponsorsFund open source developers PROGRAMSSecurity Lab Maintainer Community GitHub Stars Archive Program REPOSITORIESTopics Trending Collections ENTERPRISE SOLUTIONSEnterprise platformAI-powered developer platform AVAILABLE ADD-ONSGitHub Advanced SecurityEnterprise-grade security features Copilot for BusinessEnterprise-grade AI features Premium SupportEnterprise-grade 24/7 support Pricing Sign in Sign upAppearance settings You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert Uh oh! There was an error while loading. Please reload this page. plotday /plotPublic Notifications You must be signed in to change notification settings Fork 0 Star 2 Code Issues0 Pull requests0 Actions Projects Security and quality0 Insights Additional navigation options Code Issues Pull requests Actions Projects Security and quality Insights feat(connector-google): combined Google connection (Mail/Calendar/Tasks/Contacts) + Connector.products SDK#222 New issue Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community. Sign up for GitHub By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails. Already on GitHub? Sign in to your account Merged KrisBraun merged 24 commits into main from connector-google-cleanJun 24, 2026 Conversation 0 Commits 24 Checks 1 Files changed Uh oh! There was an error while loading. Please reload this page. Merged feat(connector-google): combined Google connection (Mail/Calendar/Tasks/Contacts) + Connector.products SDK #222 Show file tree Hide file tree Changes from all commits Commits Show all changes 24 commits Select commit Hold shift + click to select a range e0fdcb3 feat(connector-google): scaffold combined Google connector package KrisBraun Jun 23, 2026b690682 feat(connector-google): product channel-id namespacing KrisBraun Jun 23, 2026a49a813 feat(connector-google): per-product optional scope groups + products … KrisBraun Jun 23, 2026c9d8bde feat(connector-google): product module interface + registry KrisBraun Jun 23, 2026d972e7d feat(connector-google): scope-gated composition, demux, and Google class KrisBraun Jun 23, 202676b2cf7 refactor(connector-google-calendar): extract channel listing + scopes… KrisBraun Jun 23, 2026e3d8ba5 feat(connector-google): wire calendar product (channel listing, reuse… KrisBraun Jun 23, 2026e2cea3e chore(connector-google-calendar): drop dead listCalendarsWithApi afte… KrisBraun Jun 23, 20266e36fb1 refactor(connector-gmail): extract channel listing + scopes + link ty… KrisBraun Jun 23, 202655075d8 refactor(connector-google-tasks): extract channel listing + scopes + … KrisBraun Jun 23, 20264f40ef3 refactor(connector-google-contacts): export channel listing + scopes … KrisBraun Jun 23, 2026837e2f6 feat(connector-google): wire mail, tasks, contacts products (channel … KrisBraun Jun 23, 20268a6737f feat(connector-google): pure per-product status derivation (spec 2.4/… KrisBraun Jun 23, 2026f7bfc60 refactor(connector-google-calendar): extract initial-backfill sync in… KrisBraun Jun 23, 2026f450ca1 chore(connector-google-calendar): drop dead methods/imports orphaned … KrisBraun Jun 23, 20260f876ac feat(twister): add Connector.products metadata for combined connectors KrisBraun Jun 23, 202640e42e5 fix(twister): hide internal underscore-prefixed markers from deploy p… KrisBraun Jun 23, 202677548f7 fix(connector-google): combine product descriptions with scope reason… KrisBraun Jun 23, 20265386140 fix(connector-google): use the Google Contacts brand logo KrisBraun Jun 23, 2026b78287c fix(connector-google): point Contacts icon at hosted plot.day asset (… KrisBraun Jun 24, 2026eafc404 feat(google): re-home calendar live-updates (watch/webhook) + RSVP wr… KrisBraun Jun 24, 2026f2b0027 feat(google): re-home Mail (Gmail) sync into the combined connector KrisBraun Jun 24, 202601bdae0 feat(google): re-home Tasks sync into the combined connector KrisBraun Jun 24, 2026e2e02b2 feat(google): re-home Contacts sync into the combined connector KrisBraun Jun 24, 2026 File filter Filter by extension Filter by extension .json (2) .md (3) .ts (37) .yaml (1) All 4 file types selected Only manifest files Viewed files Clear filters Conversations Failed to load comments. Loading Uh oh! There was an error while loading. Please reload this page. Jump to Jump to file Failed to load files. Loading Uh oh! There was an error while loading. Please reload this page. Diff view Unified Split Hide whitespace Diff view Unified Split Hide whitespace .changeset/connector-products.md connector-products.md .changeset/deploy-hide-internal-perms.md deploy-hide-internal-perms.md connectors/gmail/src/channels.ts channels.ts connectors/gmail/src/gmail.ts gmail.ts connectors/gmail/src/index.ts index.ts connectors/gmail/src/sync.ts sync.ts connectors/google-calendar/src/channels.ts channels.ts connectors/google-calendar/src/google-calendar.ts google-calendar.ts connectors/google-calendar/src/index.ts index.ts connectors/google-calendar/src/sync.test.ts sync.test.ts connectors/google-calendar/src/sync.ts sync.ts connectors/google-contacts/src/channels.ts channels.ts connectors/google-contacts/src/google-contacts.ts google-contacts.ts connectors/google-contacts/src/index.ts index.ts connectors/google-contacts/src/sync.ts sync.ts connectors/google-tasks/src/channels.ts channels.ts connectors/google-tasks/src/google-tasks.ts google-tasks.ts connectors/google-tasks/src/index.ts index.ts connectors/google-tasks/src/sync.ts sync.ts connectors/google/README.md README.md connectors/google/package.json package.json connectors/google/src/compose.ts compose.ts connectors/google/src/google.ts google.ts connectors/google/src/index.ts index.ts connectors/google/src/product-channel.ts product-channel.ts connectors/google/src/product-status.ts product-status.ts connectors/google/src/products/calendar.ts calendar.ts connectors/google/src/products/contacts.ts contacts.ts connectors/google/src/products/mail.ts mail.ts connectors/google/src/products/product.ts product.ts connectors/google/src/products/tasks.ts tasks.ts connectors/google/src/scopes.ts scopes.ts connectors/google/test/calendar.test.ts calendar.test.ts connectors/google/test/compose.test.ts compose.test.ts connectors/google/test/product-channel.test.ts product-channel.test.ts connectors/google/test/product-status.test.ts product-status.test.ts connectors/google/test/products.test.ts products.test.ts connectors/google/test/scopes.test.ts scopes.test.ts connectors/google/tsconfig.json tsconfig.json connectors/google/vitest.config.ts vitest.config.ts pnpm-lock.yaml pnpm-lock.yaml twister/cli/commands/deploy.ts deploy.ts twister/src/connector.ts connector.ts There are no files selected for viewing 5 changes: 5 additions & 0 deletions 5 .changeset/connector-products.md Show comments View file Open in desktop Original file line number Diff line number Diff line change @@ -0,0 +1,5 @@ --- "@plotday/twister": minor --- Added: Connector.products metadata for combined (multi-product) connectors. 5 changes: 5 additions & 0 deletions 5 .changeset/deploy-hide-internal-perms.md Show comments View file Open in desktop Original file line number Diff line number Diff line change @@ -0,0 +1,5 @@ --- "@plotday/twister": patch --- Fixed: the `plot deploy` permissions summary no longer prints internal underscore-prefixed runtime markers (`_products`, `_dynamic_link_types`, `_providers`, `_ai_required`, …) — only user-facing tool permissions are shown. 76 changes: 76 additions & 0 deletions 76 connectors/gmail/src/channels.ts Show comments View file Open in desktop Original file line number Diff line number Diff line change @@ -0,0 +1,76 @@ import type { AuthToken, Channel } from "@plotday/twister/tools/integrations"; import type { LinkTypeConfig } from "@plotday/twister/tools/integrations"; import { GmailApi } from "./gmail-api"; // --------------------------------------------------------------------------- // Scope constants // --------------------------------------------------------------------------- export const GMAIL_MODIFY_SCOPE = "https://www.googleapis.com/auth/gmail.modify"; // --------------------------------------------------------------------------- // Link types // --------------------------------------------------------------------------- export const GMAIL_LINK_TYPES: LinkTypeConfig[] = [ { type: "email", label: "Thread", noteLabel: "Reply", sharingModel: "message" as const, composePlaceholder: "Send a Gmail email", composeVerb: "Send", replyPlaceholder: "Reply", replyVerb: "Send", supportsFileAttachments: true, logo: "https://api.iconify.design/logos/google-gmail.svg", logoMono: "https://api.iconify.design/simple-icons/gmail.svg", contactRoles: [ { id: "to", label: "To", default: true }, { id: "cc", label: "CC" }, { id: "bcc", label: "BCC", hidden: true }, ], supportsContactChanges: true, // Gmail composes target any address — a Plot contact (with or without // a Gmail-connection row) or a free-form typed email delivered via // `inviteEmails`. The runtime fills `recipients` from the // connection-scoped row when available and falls back to // `contact.email` otherwise. compose: { targets: "addresses" as const, }, }, ]; // --------------------------------------------------------------------------- // Channel listing // --------------------------------------------------------------------------- /** * Returns available Gmail labels as channel resources for a given token. * * Filters out system labels except for INBOX, SENT, DRAFT, IMPORTANT, and * STARRED. Defaults to enabling INBOX and SENT only. */ export async function getGmailChannels(token: AuthToken): Promise<Channel[]> { const api = new GmailApi(token.token); const labels = await api.getLabels(); return labels .filter( (l: any) => l.type !== "system" || ["INBOX", "SENT", "DRAFT", "IMPORTANT", "STARRED"].includes(l.id) ) // Default to syncing the user's actual conversations: Inbox (incoming) // and Sent (outgoing). Important/Starred are overlapping views of mail // that's mostly already in the Inbox, so enabling them by default would // largely re-sync the same threads; Draft and user-created labels would // crowd the view. They're all still available to enable manually, and // Spam/Trash aren't even listed (filtered above). .map((l: any) => ({ id: l.id, title: l.name, enabledByDefault: l.id === "INBOX" || l.id === "SENT", })); } Loading Oops, something went wrong. Uh oh! There was an error while loading. Please reload this page. Loading Oops, something went wrong. Uh oh! There was an error while loading. Please reload this page. Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later. Footer © 2026 GitHub, Inc. Footer navigation Terms Privacy Security Status Community Docs Contact You can’t perform that action at this time. , 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Universal Dark Mode - works on any site\n(function() {\n var enabled = true;\n \n function applyDarkMode() {\n if (!enabled) return;\n \n // Create style element if it doesn't exist\n var style = document.getElementById('universal-dark-mode-style');\n if (!style) {\n style = document.createElement('style');\n style.id = 'universal-dark-mode-style';\n document.head.appendChild(style);\n }\n \n // Dark mode CSS - inverts colors but preserves images/video\n style.textContent = '\n /* Invert everything except media */\n html {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #1a1a2e !important;\n }\n \n /* Restore images, videos, iframes, canvas */\n img, video, iframe, canvas, svg, picture, [style*=\"background-image\"] {\n filter: invert(1) hue-rotate(180deg) !important;\n }\n \n /* Preserve specific elements that should not be inverted */\n .no-dark-mode, .no-dark-mode *,\n [data-theme=\"light\"], [data-theme=\"light\"],\n .ace_editor, .ace_editor *,\n .CodeMirror, .CodeMirror *,\n .monaco-editor, .monaco-editor *,\n .markdown-body pre, .markdown-body pre *,\n .highlight, .highlight *,\n pre code, pre code * {\n filter: none !important;\n }\n \n /* Fix common UI elements */\n .modal, .popup, .dropdown-menu, .tooltip, .popover {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #2d2d44 !important;\n border-color: #444 !important;\n }\n \n /* Scrollbars */\n ::-webkit-scrollbar { background: #1a1a2e !important; }\n ::-webkit-scrollbar-thumb { background: #444 !important; }\n ::-webkit-scrollbar-thumb:hover { background: #555 !important; }\n \n /* Selection */\n ::selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ::-moz-selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ';\n }\n \n function removeDarkMode() {\n var style = document.getElementById('universal-dark-mode-style');\n if (style) style.remove();\n }\n \n // Toggle with Alt+Shift+D\n document.addEventListener('keydown', function(e) {\n if (e.altKey && e.shiftKey && e.key === 'D') {\n e.preventDefault();\n enabled = !enabled;\n if (enabled) {\n applyDarkMode();\n console.log('[Universal Dark Mode] Enabled');\n } else {\n removeDarkMode();\n console.log('[Universal Dark Mode] Disabled');\n }\n }\n });\n \n // Apply on load\n applyDarkMode();\n \n // Re-apply on dynamic content\n var observer = new MutationObserver(function(mutations) {\n if (enabled && !document.getElementById('universal-dark-mode-style')) {\n applyDarkMode();\n }\n });\n observer.observe(document.head, { childList: true });\n \n console.log('[Universal Dark Mode] Loaded - Press Alt+Shift+D to toggle');\n})();", "Universal Dark Mode"); } } catch(__e) { console.warn('[Userscript:Universal Dark Mode]', __e); } })(); })(); Skip to contentNavigation Menu Sign inAppearance settings AI CODE CREATIONGitHub CopilotWrite better code with AI GitHub Copilot appDirect agents from issue to merge MCP RegistryIntegrate external tools DEVELOPER WORKFLOWSActionsAutomate any workflow CodespacesInstant dev environments IssuesPlan and track work Code ReviewManage code changes Code QualityEnforce quality at merge APPLICATION SECURITYGitHub Advanced SecurityFind and fix vulnerabilities Code securitySecure your code as you build Secret protectionStop leaks before they start EXPLOREWhy GitHub Documentation Blog Changelog Marketplace View all features BY COMPANY SIZEEnterprises Small and medium teams Startups Nonprofits BY USE CASEApp Modernization DevSecOps DevOps CI/CD View all use cases BY INDUSTRYHealthcare Financial services Manufacturing Government View all industries View all solutions EXPLORE BY TOPICAI Software Development DevOps Security View all topics EXPLORE BY TYPECustomer stories Events & webinars Ebooks & reports Business insights GitHub Skills SUPPORT & SERVICESDocumentation Customer support Community forum Trust center Partners View all resources COMMUNITYGitHub SponsorsFund open source developers PROGRAMSSecurity Lab Maintainer Community GitHub Stars Archive Program REPOSITORIESTopics Trending Collections ENTERPRISE SOLUTIONSEnterprise platformAI-powered developer platform AVAILABLE ADD-ONSGitHub Advanced SecurityEnterprise-grade security features Copilot for BusinessEnterprise-grade AI features Premium SupportEnterprise-grade 24/7 support Pricing Sign in Sign upAppearance settings You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert Uh oh! There was an error while loading. Please reload this page. plotday /plotPublic Notifications You must be signed in to change notification settings Fork 0 Star 2 Code Issues0 Pull requests0 Actions Projects Security and quality0 Insights Additional navigation options Code Issues Pull requests Actions Projects Security and quality Insights feat(connector-google): combined Google connection (Mail/Calendar/Tasks/Contacts) + Connector.products SDK#222 New issue Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community. Sign up for GitHub By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails. Already on GitHub? Sign in to your account Merged KrisBraun merged 24 commits into main from connector-google-cleanJun 24, 2026 Conversation 0 Commits 24 Checks 1 Files changed Uh oh! There was an error while loading. Please reload this page. Merged feat(connector-google): combined Google connection (Mail/Calendar/Tasks/Contacts) + Connector.products SDK #222 Show file tree Hide file tree Changes from all commits Commits Show all changes 24 commits Select commit Hold shift + click to select a range e0fdcb3 feat(connector-google): scaffold combined Google connector package KrisBraun Jun 23, 2026b690682 feat(connector-google): product channel-id namespacing KrisBraun Jun 23, 2026a49a813 feat(connector-google): per-product optional scope groups + products … KrisBraun Jun 23, 2026c9d8bde feat(connector-google): product module interface + registry KrisBraun Jun 23, 2026d972e7d feat(connector-google): scope-gated composition, demux, and Google class KrisBraun Jun 23, 202676b2cf7 refactor(connector-google-calendar): extract channel listing + scopes… KrisBraun Jun 23, 2026e3d8ba5 feat(connector-google): wire calendar product (channel listing, reuse… KrisBraun Jun 23, 2026e2cea3e chore(connector-google-calendar): drop dead listCalendarsWithApi afte… KrisBraun Jun 23, 20266e36fb1 refactor(connector-gmail): extract channel listing + scopes + link ty… KrisBraun Jun 23, 202655075d8 refactor(connector-google-tasks): extract channel listing + scopes + … KrisBraun Jun 23, 20264f40ef3 refactor(connector-google-contacts): export channel listing + scopes … KrisBraun Jun 23, 2026837e2f6 feat(connector-google): wire mail, tasks, contacts products (channel … KrisBraun Jun 23, 20268a6737f feat(connector-google): pure per-product status derivation (spec 2.4/… KrisBraun Jun 23, 2026f7bfc60 refactor(connector-google-calendar): extract initial-backfill sync in… KrisBraun Jun 23, 2026f450ca1 chore(connector-google-calendar): drop dead methods/imports orphaned … KrisBraun Jun 23, 20260f876ac feat(twister): add Connector.products metadata for combined connectors KrisBraun Jun 23, 202640e42e5 fix(twister): hide internal underscore-prefixed markers from deploy p… KrisBraun Jun 23, 202677548f7 fix(connector-google): combine product descriptions with scope reason… KrisBraun Jun 23, 20265386140 fix(connector-google): use the Google Contacts brand logo KrisBraun Jun 23, 2026b78287c fix(connector-google): point Contacts icon at hosted plot.day asset (… KrisBraun Jun 24, 2026eafc404 feat(google): re-home calendar live-updates (watch/webhook) + RSVP wr… KrisBraun Jun 24, 2026f2b0027 feat(google): re-home Mail (Gmail) sync into the combined connector KrisBraun Jun 24, 202601bdae0 feat(google): re-home Tasks sync into the combined connector KrisBraun Jun 24, 2026e2e02b2 feat(google): re-home Contacts sync into the combined connector KrisBraun Jun 24, 2026 File filter Filter by extension Filter by extension .json (2) .md (3) .ts (37) .yaml (1) All 4 file types selected Only manifest files Viewed files Clear filters Conversations Failed to load comments. Loading Uh oh! There was an error while loading. Please reload this page. Jump to Jump to file Failed to load files. Loading Uh oh! There was an error while loading. Please reload this page. Diff view Unified Split Hide whitespace Diff view Unified Split Hide whitespace .changeset/connector-products.md connector-products.md .changeset/deploy-hide-internal-perms.md deploy-hide-internal-perms.md connectors/gmail/src/channels.ts channels.ts connectors/gmail/src/gmail.ts gmail.ts connectors/gmail/src/index.ts index.ts connectors/gmail/src/sync.ts sync.ts connectors/google-calendar/src/channels.ts channels.ts connectors/google-calendar/src/google-calendar.ts google-calendar.ts connectors/google-calendar/src/index.ts index.ts connectors/google-calendar/src/sync.test.ts sync.test.ts connectors/google-calendar/src/sync.ts sync.ts connectors/google-contacts/src/channels.ts channels.ts connectors/google-contacts/src/google-contacts.ts google-contacts.ts connectors/google-contacts/src/index.ts index.ts connectors/google-contacts/src/sync.ts sync.ts connectors/google-tasks/src/channels.ts channels.ts connectors/google-tasks/src/google-tasks.ts google-tasks.ts connectors/google-tasks/src/index.ts index.ts connectors/google-tasks/src/sync.ts sync.ts connectors/google/README.md README.md connectors/google/package.json package.json connectors/google/src/compose.ts compose.ts connectors/google/src/google.ts google.ts connectors/google/src/index.ts index.ts connectors/google/src/product-channel.ts product-channel.ts connectors/google/src/product-status.ts product-status.ts connectors/google/src/products/calendar.ts calendar.ts connectors/google/src/products/contacts.ts contacts.ts connectors/google/src/products/mail.ts mail.ts connectors/google/src/products/product.ts product.ts connectors/google/src/products/tasks.ts tasks.ts connectors/google/src/scopes.ts scopes.ts connectors/google/test/calendar.test.ts calendar.test.ts connectors/google/test/compose.test.ts compose.test.ts connectors/google/test/product-channel.test.ts product-channel.test.ts connectors/google/test/product-status.test.ts product-status.test.ts connectors/google/test/products.test.ts products.test.ts connectors/google/test/scopes.test.ts scopes.test.ts connectors/google/tsconfig.json tsconfig.json connectors/google/vitest.config.ts vitest.config.ts pnpm-lock.yaml pnpm-lock.yaml twister/cli/commands/deploy.ts deploy.ts twister/src/connector.ts connector.ts There are no files selected for viewing 5 changes: 5 additions & 0 deletions 5 .changeset/connector-products.md Show comments View file Open in desktop Original file line number Diff line number Diff line change @@ -0,0 +1,5 @@ --- "@plotday/twister": minor --- Added: Connector.products metadata for combined (multi-product) connectors. 5 changes: 5 additions & 0 deletions 5 .changeset/deploy-hide-internal-perms.md Show comments View file Open in desktop Original file line number Diff line number Diff line change @@ -0,0 +1,5 @@ --- "@plotday/twister": patch --- Fixed: the `plot deploy` permissions summary no longer prints internal underscore-prefixed runtime markers (`_products`, `_dynamic_link_types`, `_providers`, `_ai_required`, …) — only user-facing tool permissions are shown. 76 changes: 76 additions & 0 deletions 76 connectors/gmail/src/channels.ts Show comments View file Open in desktop Original file line number Diff line number Diff line change @@ -0,0 +1,76 @@ import type { AuthToken, Channel } from "@plotday/twister/tools/integrations"; import type { LinkTypeConfig } from "@plotday/twister/tools/integrations"; import { GmailApi } from "./gmail-api"; // --------------------------------------------------------------------------- // Scope constants // --------------------------------------------------------------------------- export const GMAIL_MODIFY_SCOPE = "https://www.googleapis.com/auth/gmail.modify"; // --------------------------------------------------------------------------- // Link types // --------------------------------------------------------------------------- export const GMAIL_LINK_TYPES: LinkTypeConfig[] = [ { type: "email", label: "Thread", noteLabel: "Reply", sharingModel: "message" as const, composePlaceholder: "Send a Gmail email", composeVerb: "Send", replyPlaceholder: "Reply", replyVerb: "Send", supportsFileAttachments: true, logo: "https://api.iconify.design/logos/google-gmail.svg", logoMono: "https://api.iconify.design/simple-icons/gmail.svg", contactRoles: [ { id: "to", label: "To", default: true }, { id: "cc", label: "CC" }, { id: "bcc", label: "BCC", hidden: true }, ], supportsContactChanges: true, // Gmail composes target any address — a Plot contact (with or without // a Gmail-connection row) or a free-form typed email delivered via // `inviteEmails`. The runtime fills `recipients` from the // connection-scoped row when available and falls back to // `contact.email` otherwise. compose: { targets: "addresses" as const, }, }, ]; // --------------------------------------------------------------------------- // Channel listing // --------------------------------------------------------------------------- /** * Returns available Gmail labels as channel resources for a given token. * * Filters out system labels except for INBOX, SENT, DRAFT, IMPORTANT, and * STARRED. Defaults to enabling INBOX and SENT only. */ export async function getGmailChannels(token: AuthToken): Promise<Channel[]> { const api = new GmailApi(token.token); const labels = await api.getLabels(); return labels .filter( (l: any) => l.type !== "system" || ["INBOX", "SENT", "DRAFT", "IMPORTANT", "STARRED"].includes(l.id) ) // Default to syncing the user's actual conversations: Inbox (incoming) // and Sent (outgoing). Important/Starred are overlapping views of mail // that's mostly already in the Inbox, so enabling them by default would // largely re-sync the same threads; Draft and user-created labels would // crowd the view. They're all still available to enable manually, and // Spam/Trash aren't even listed (filtered above). .map((l: any) => ({ id: l.id, title: l.name, enabledByDefault: l.id === "INBOX" || l.id === "SENT", })); } Loading Oops, something went wrong. Uh oh! There was an error while loading. Please reload this page. Loading Oops, something went wrong. Uh oh! There was an error while loading. Please reload this page. Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later. Footer © 2026 GitHub, Inc. Footer navigation Terms Privacy Security Status Community Docs Contact You can’t perform that action at this time.