feat(connectors): default-enable channels via enabledByDefault

.changeset/channel-enabled-by-default.md

@@ -0,0 +1,5 @@
+---
+"@plotday/twister": minor
+---
+
+Added: `enabledByDefault?: boolean` (tri-state) on the `Channel` type returned by `getChannels()`. Lets a connector influence which channels are pre-selected when a connection is first added: `true` pre-selects, `false` excludes a low-value/irrelevant channel or a too-broad container (e.g. a holiday or someone-else's shared calendar, a GitHub org that cascades to every repo, a Teams team container), and `undefined` leaves the choice to the client (which enables the channel unless its title looks low-value). The setup UI now defaults to enabling all top-level channels and filtering out the low-value ones, rather than picking a single "primary."

connectors/github/src/github.ts

@@ -337,6 +337,10 @@ export class GitHub extends Connector<GitHub> {
  channels.push({
  id: owner,
  title: owner,
+ // Enabling an owner cascades to EVERY repo under it (orgs can have
+ // hundreds), so don't pre-select it. The user opts in to the specific
+ // owner or repos they want to sync.
+ enabledByDefault: false,
  children: ownerRepos.map((repo) => ({
  id: repo.full_name,
  title: repo.full_name,

connectors/gmail/src/gmail.ts

@@ -400,7 +400,17 @@ export class Gmail extends Connector<Gmail> {
  l.type !== "system" ||
  ["INBOX", "SENT", "DRAFT", "IMPORTANT", "STARRED"].includes(l.id)
  )
- .map((l: any) => ({ id: l.id, title: l.name }));
+ // 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",
+ }));
  }
 
  async onChannelEnabled(channel: Channel, context?: SyncContext): Promise<void> {

connectors/google-calendar/src/google-calendar.ts

@@ -44,6 +44,14 @@ type Calendar = {
  name: string;
  description: string | null;
  primary: boolean;
+ /**
+ * The user's access level on this calendar: "owner", "writer", "reader",
+ * or "freeBusyReader". Calendars the user owns (their primary + any
+ * secondary calendars they created) are "owner"; subscribed holiday/
+ * birthday calendars and someone-else's shared calendars are "reader"/
+ * "writer". Drives the default-enable decision in getChannels.
+ */
+ accessRole: string | null;
 };
 
 /**
@@ -203,7 +211,17 @@ export class GoogleCalendar extends Connector<GoogleCalendar> {
  ): Promise<Channel[]> {
  const api = new GoogleApi(token.token);
  const calendars = await this.listCalendarsWithApi(api);
- return calendars.map((c) => ({ id: c.id, title: c.name }));
+ // Default to syncing the user's OWN calendars (their primary + any
+ // secondary calendars they created — accessRole "owner"). Calendars the
+ // user merely subscribes to (holidays, birthdays) or that are shared with
+ // them by someone else are "reader"/"writer"; exclude those from the
+ // default selection so they don't crowd the user's view. The user can
+ // still enable any of them manually.
+ return calendars.map((c) => ({
+ id: c.id,
+ title: c.name,
+ enabledByDefault: c.accessRole === "owner",
+ }));
  }
 
  /**
@@ -372,13 +390,15 @@ export class GoogleCalendar extends Connector<GoogleCalendar> {
  summary: string;
  description?: string;
  primary?: boolean;
+ accessRole?: string;
  }>;
  };
 
  return data.items.map((item) => ({
  id: item.id,
  name: item.summary,
  description: item.description || null,
+ accessRole: item.accessRole ?? null,
  primary: item.primary || false,
  }));
  }
@@ -440,6 +460,7 @@ export class GoogleCalendar extends Connector<GoogleCalendar> {
  summary: string;
  description?: string;
  primary?: boolean;
+ accessRole?: string;
  }>;
  };
 
@@ -448,6 +469,7 @@ export class GoogleCalendar extends Connector<GoogleCalendar> {
  name: item.summary,
  description: item.description || null,
  primary: item.primary || false,
+ accessRole: item.accessRole ?? null,
  }));
  }
 

connectors/google-drive/src/google-drive.ts

@@ -275,6 +275,10 @@ export class GoogleDrive extends Connector<GoogleDrive> {
  },
  ];
 
+ // My Drive, Shared drives, and Shared with me are all enabled by default
+ // (the client default for top-level channels) — a Drive user generally
+ // wants their documents from all three. Individual sub-folders stay
+ // collapsed under each, so the user can still narrow the scope.
  if (sharedDriveMap.size > 0) {
  result.push({
  id: VIRTUAL_SHARED_DRIVES,

connectors/ms-teams/src/ms-teams.ts

@@ -157,6 +157,9 @@ export class MsTeams extends Connector<MsTeams> {
  channels.push({
  id: team.id,
  title: team.displayName,
+ // A team is a container, not a syncable resource — the user picks the
+ // specific channels under it. Don't pre-select the team itself.
+ enabledByDefault: false,
  children: teamChannels.map((ch) => ({
  id: ch.id,
  title: ch.displayName,

twister/src/tools/integrations.ts

@@ -17,6 +17,26 @@ export type Channel = {
  id: string;
  /** Display name shown in the UI */
  title: string;
+ /**
+ * Whether this channel should be selected by default when the user first
+ * adds the connection. Tri-state:
+ * - `true` — pre-select it (e.g. the user's own/primary calendar).
+ * - `false` — exclude it from the default selection (low-value or
+ * irrelevant resources that would crowd the user's view, or containers
+ * whose contents are too broad to sync wholesale — e.g. a holiday or
+ * someone-else's shared calendar, a GitHub org that cascades to every
+ * repo, a Microsoft Teams team container). The user can still enable it
+ * manually.
+ * - `undefined` — no opinion; the client decides. The client defaults to
+ * enabling the channel unless its title looks low-value (holidays,
+ * birthdays, spam/sent/draft, …).
+ *
+ * The guiding principle is "sync everything the user would reasonably want
+ * by default" — for most connectors that's all channels, so only set this
+ * where the connector can distinguish the user's own/relevant channels from
+ * low-value ones (e.g. Google Calendar via `accessRole === "owner"`).
+ */
+ enabledByDefault?: boolean;
  /** Optional nested channel resources (e.g., subfolders) */
  children?: Channel[];
  /** Per-channel link type configs. Overrides twist-level linkTypes when present. */

.changeset/channel-enabled-by-default.md

@@ -0,0 +1,5 @@
+---
+"@plotday/twister": minor
+---
+
+Added: `enabledByDefault?: boolean` (tri-state) on the `Channel` type returned by `getChannels()`. Lets a connector influence which channels are pre-selected when a connection is first added: `true` pre-selects, `false` excludes a low-value/irrelevant channel or a too-broad container (e.g. a holiday or someone-else's shared calendar, a GitHub org that cascades to every repo, a Teams team container), and `undefined` leaves the choice to the client (which enables the channel unless its title looks low-value). The setup UI now defaults to enabling all top-level channels and filtering out the low-value ones, rather than picking a single "primary."

connectors/github/src/github.ts

@@ -337,6 +337,10 @@ export class GitHub extends Connector<GitHub> {
  channels.push({
  id: owner,
  title: owner,
+ // Enabling an owner cascades to EVERY repo under it (orgs can have
+ // hundreds), so don't pre-select it. The user opts in to the specific
+ // owner or repos they want to sync.
+ enabledByDefault: false,
  children: ownerRepos.map((repo) => ({
  id: repo.full_name,
  title: repo.full_name,

connectors/gmail/src/gmail.ts

@@ -400,7 +400,17 @@ export class Gmail extends Connector<Gmail> {
  l.type !== "system" ||
  ["INBOX", "SENT", "DRAFT", "IMPORTANT", "STARRED"].includes(l.id)
  )
- .map((l: any) => ({ id: l.id, title: l.name }));
+ // 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",
+ }));
  }
 
  async onChannelEnabled(channel: Channel, context?: SyncContext): Promise<void> {

connectors/google-calendar/src/google-calendar.ts

@@ -44,6 +44,14 @@ type Calendar = {
  name: string;
  description: string | null;
  primary: boolean;
+ /**
+ * The user's access level on this calendar: "owner", "writer", "reader",
+ * or "freeBusyReader". Calendars the user owns (their primary + any
+ * secondary calendars they created) are "owner"; subscribed holiday/
+ * birthday calendars and someone-else's shared calendars are "reader"/
+ * "writer". Drives the default-enable decision in getChannels.
+ */
+ accessRole: string | null;
 };
 
 /**
@@ -203,7 +211,17 @@ export class GoogleCalendar extends Connector<GoogleCalendar> {
  ): Promise<Channel[]> {
  const api = new GoogleApi(token.token);
  const calendars = await this.listCalendarsWithApi(api);
- return calendars.map((c) => ({ id: c.id, title: c.name }));
+ // Default to syncing the user's OWN calendars (their primary + any
+ // secondary calendars they created — accessRole "owner"). Calendars the
+ // user merely subscribes to (holidays, birthdays) or that are shared with
+ // them by someone else are "reader"/"writer"; exclude those from the
+ // default selection so they don't crowd the user's view. The user can
+ // still enable any of them manually.
+ return calendars.map((c) => ({
+ id: c.id,
+ title: c.name,
+ enabledByDefault: c.accessRole === "owner",
+ }));
  }
 
  /**
@@ -372,13 +390,15 @@ export class GoogleCalendar extends Connector<GoogleCalendar> {
  summary: string;
  description?: string;
  primary?: boolean;
+ accessRole?: string;
  }>;
  };
 
  return data.items.map((item) => ({
  id: item.id,
  name: item.summary,
  description: item.description || null,
+ accessRole: item.accessRole ?? null,
  primary: item.primary || false,
  }));
  }
@@ -440,6 +460,7 @@ export class GoogleCalendar extends Connector<GoogleCalendar> {
  summary: string;
  description?: string;
  primary?: boolean;
+ accessRole?: string;
  }>;
  };
 
@@ -448,6 +469,7 @@ export class GoogleCalendar extends Connector<GoogleCalendar> {
  name: item.summary,
  description: item.description || null,
  primary: item.primary || false,
+ accessRole: item.accessRole ?? null,
  }));
  }
 

connectors/google-drive/src/google-drive.ts

@@ -275,6 +275,10 @@ export class GoogleDrive extends Connector<GoogleDrive> {
  },
  ];
 
+ // My Drive, Shared drives, and Shared with me are all enabled by default
+ // (the client default for top-level channels) — a Drive user generally
+ // wants their documents from all three. Individual sub-folders stay
+ // collapsed under each, so the user can still narrow the scope.
  if (sharedDriveMap.size > 0) {
  result.push({
  id: VIRTUAL_SHARED_DRIVES,

connectors/ms-teams/src/ms-teams.ts

@@ -157,6 +157,9 @@ export class MsTeams extends Connector<MsTeams> {
  channels.push({
  id: team.id,
  title: team.displayName,
+ // A team is a container, not a syncable resource — the user picks the
+ // specific channels under it. Don't pre-select the team itself.
+ enabledByDefault: false,
  children: teamChannels.map((ch) => ({
  id: ch.id,
  title: ch.displayName,

twister/src/tools/integrations.ts

@@ -17,6 +17,26 @@ export type Channel = {
  id: string;
  /** Display name shown in the UI */
  title: string;
+ /**
+ * Whether this channel should be selected by default when the user first
+ * adds the connection. Tri-state:
+ * - `true` — pre-select it (e.g. the user's own/primary calendar).
+ * - `false` — exclude it from the default selection (low-value or
+ * irrelevant resources that would crowd the user's view, or containers
+ * whose contents are too broad to sync wholesale — e.g. a holiday or
+ * someone-else's shared calendar, a GitHub org that cascades to every
+ * repo, a Microsoft Teams team container). The user can still enable it
+ * manually.
+ * - `undefined` — no opinion; the client decides. The client defaults to
+ * enabling the channel unless its title looks low-value (holidays,
+ * birthdays, spam/sent/draft, …).
+ *
+ * The guiding principle is "sync everything the user would reasonably want
+ * by default" — for most connectors that's all channels, so only set this
+ * where the connector can distinguish the user's own/relevant channels from
+ * low-value ones (e.g. Google Calendar via `accessRole === "owner"`).
+ */
+ enabledByDefault?: boolean;
  /** Optional nested channel resources (e.g., subfolders) */
  children?: Channel[];
  /** Per-channel link type configs. Overrides twist-level linkTypes when present. */

.changeset/channel-enabled-by-default.md

@@ -0,0 +1,5 @@
+---
+"@plotday/twister": minor
+---
+
+Added: `enabledByDefault?: boolean` (tri-state) on the `Channel` type returned by `getChannels()`. Lets a connector influence which channels are pre-selected when a connection is first added: `true` pre-selects, `false` excludes a low-value/irrelevant channel or a too-broad container (e.g. a holiday or someone-else's shared calendar, a GitHub org that cascades to every repo, a Teams team container), and `undefined` leaves the choice to the client (which enables the channel unless its title looks low-value). The setup UI now defaults to enabling all top-level channels and filtering out the low-value ones, rather than picking a single "primary."

connectors/github/src/github.ts

@@ -337,6 +337,10 @@ export class GitHub extends Connector<GitHub> {
  channels.push({
  id: owner,
  title: owner,
+ // Enabling an owner cascades to EVERY repo under it (orgs can have
+ // hundreds), so don't pre-select it. The user opts in to the specific
+ // owner or repos they want to sync.
+ enabledByDefault: false,
  children: ownerRepos.map((repo) => ({
  id: repo.full_name,
  title: repo.full_name,

connectors/gmail/src/gmail.ts

@@ -400,7 +400,17 @@ export class Gmail extends Connector<Gmail> {
  l.type !== "system" ||
  ["INBOX", "SENT", "DRAFT", "IMPORTANT", "STARRED"].includes(l.id)
  )
- .map((l: any) => ({ id: l.id, title: l.name }));
+ // 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",
+ }));
  }
 
  async onChannelEnabled(channel: Channel, context?: SyncContext): Promise<void> {

connectors/google-calendar/src/google-calendar.ts

@@ -44,6 +44,14 @@ type Calendar = {
  name: string;
  description: string | null;
  primary: boolean;
+ /**
+ * The user's access level on this calendar: "owner", "writer", "reader",
+ * or "freeBusyReader". Calendars the user owns (their primary + any
+ * secondary calendars they created) are "owner"; subscribed holiday/
+ * birthday calendars and someone-else's shared calendars are "reader"/
+ * "writer". Drives the default-enable decision in getChannels.
+ */
+ accessRole: string | null;
 };
 
 /**
@@ -203,7 +211,17 @@ export class GoogleCalendar extends Connector<GoogleCalendar> {
  ): Promise<Channel[]> {
  const api = new GoogleApi(token.token);
  const calendars = await this.listCalendarsWithApi(api);
- return calendars.map((c) => ({ id: c.id, title: c.name }));
+ // Default to syncing the user's OWN calendars (their primary + any
+ // secondary calendars they created — accessRole "owner"). Calendars the
+ // user merely subscribes to (holidays, birthdays) or that are shared with
+ // them by someone else are "reader"/"writer"; exclude those from the
+ // default selection so they don't crowd the user's view. The user can
+ // still enable any of them manually.
+ return calendars.map((c) => ({
+ id: c.id,
+ title: c.name,
+ enabledByDefault: c.accessRole === "owner",
+ }));
  }
 
  /**
@@ -372,13 +390,15 @@ export class GoogleCalendar extends Connector<GoogleCalendar> {
  summary: string;
  description?: string;
  primary?: boolean;
+ accessRole?: string;
  }>;
  };
 
  return data.items.map((item) => ({
  id: item.id,
  name: item.summary,
  description: item.description || null,
+ accessRole: item.accessRole ?? null,
  primary: item.primary || false,
  }));
  }
@@ -440,6 +460,7 @@ export class GoogleCalendar extends Connector<GoogleCalendar> {
  summary: string;
  description?: string;
  primary?: boolean;
+ accessRole?: string;
  }>;
  };
 
@@ -448,6 +469,7 @@ export class GoogleCalendar extends Connector<GoogleCalendar> {
  name: item.summary,
  description: item.description || null,
  primary: item.primary || false,
+ accessRole: item.accessRole ?? null,
  }));
  }
 

connectors/google-drive/src/google-drive.ts

@@ -275,6 +275,10 @@ export class GoogleDrive extends Connector<GoogleDrive> {
  },
  ];
 
+ // My Drive, Shared drives, and Shared with me are all enabled by default
+ // (the client default for top-level channels) — a Drive user generally
+ // wants their documents from all three. Individual sub-folders stay
+ // collapsed under each, so the user can still narrow the scope.
  if (sharedDriveMap.size > 0) {
  result.push({
  id: VIRTUAL_SHARED_DRIVES,

connectors/ms-teams/src/ms-teams.ts

@@ -157,6 +157,9 @@ export class MsTeams extends Connector<MsTeams> {
  channels.push({
  id: team.id,
  title: team.displayName,
+ // A team is a container, not a syncable resource — the user picks the
+ // specific channels under it. Don't pre-select the team itself.
+ enabledByDefault: false,
  children: teamChannels.map((ch) => ({
  id: ch.id,
  title: ch.displayName,

twister/src/tools/integrations.ts

@@ -17,6 +17,26 @@ export type Channel = {
  id: string;
  /** Display name shown in the UI */
  title: string;
+ /**
+ * Whether this channel should be selected by default when the user first
+ * adds the connection. Tri-state:
+ * - `true` — pre-select it (e.g. the user's own/primary calendar).
+ * - `false` — exclude it from the default selection (low-value or
+ * irrelevant resources that would crowd the user's view, or containers
+ * whose contents are too broad to sync wholesale — e.g. a holiday or
+ * someone-else's shared calendar, a GitHub org that cascades to every
+ * repo, a Microsoft Teams team container). The user can still enable it
+ * manually.
+ * - `undefined` — no opinion; the client decides. The client defaults to
+ * enabling the channel unless its title looks low-value (holidays,
+ * birthdays, spam/sent/draft, …).
+ *
+ * The guiding principle is "sync everything the user would reasonably want
+ * by default" — for most connectors that's all channels, so only set this
+ * where the connector can distinguish the user's own/relevant channels from
+ * low-value ones (e.g. Google Calendar via `accessRole === "owner"`).
+ */
+ enabledByDefault?: boolean;
  /** Optional nested channel resources (e.g., subfolders) */
  children?: Channel[];
  /** Per-channel link type configs. Overrides twist-level linkTypes when present. */

.changeset/channel-enabled-by-default.md

@@ -0,0 +1,5 @@
+---
+"@plotday/twister": minor
+---
+
+Added: `enabledByDefault?: boolean` (tri-state) on the `Channel` type returned by `getChannels()`. Lets a connector influence which channels are pre-selected when a connection is first added: `true` pre-selects, `false` excludes a low-value/irrelevant channel or a too-broad container (e.g. a holiday or someone-else's shared calendar, a GitHub org that cascades to every repo, a Teams team container), and `undefined` leaves the choice to the client (which enables the channel unless its title looks low-value). The setup UI now defaults to enabling all top-level channels and filtering out the low-value ones, rather than picking a single "primary."

connectors/github/src/github.ts

@@ -337,6 +337,10 @@ export class GitHub extends Connector<GitHub> {
  channels.push({
  id: owner,
  title: owner,
+ // Enabling an owner cascades to EVERY repo under it (orgs can have
+ // hundreds), so don't pre-select it. The user opts in to the specific
+ // owner or repos they want to sync.
+ enabledByDefault: false,
  children: ownerRepos.map((repo) => ({
  id: repo.full_name,
  title: repo.full_name,

connectors/gmail/src/gmail.ts

@@ -400,7 +400,17 @@ export class Gmail extends Connector<Gmail> {
  l.type !== "system" ||
  ["INBOX", "SENT", "DRAFT", "IMPORTANT", "STARRED"].includes(l.id)
  )
- .map((l: any) => ({ id: l.id, title: l.name }));
+ // 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",
+ }));
  }
 
  async onChannelEnabled(channel: Channel, context?: SyncContext): Promise<void> {

connectors/google-calendar/src/google-calendar.ts

@@ -44,6 +44,14 @@ type Calendar = {
  name: string;
  description: string | null;
  primary: boolean;
+ /**
+ * The user's access level on this calendar: "owner", "writer", "reader",
+ * or "freeBusyReader". Calendars the user owns (their primary + any
+ * secondary calendars they created) are "owner"; subscribed holiday/
+ * birthday calendars and someone-else's shared calendars are "reader"/
+ * "writer". Drives the default-enable decision in getChannels.
+ */
+ accessRole: string | null;
 };
 
 /**
@@ -203,7 +211,17 @@ export class GoogleCalendar extends Connector<GoogleCalendar> {
  ): Promise<Channel[]> {
  const api = new GoogleApi(token.token);
  const calendars = await this.listCalendarsWithApi(api);
- return calendars.map((c) => ({ id: c.id, title: c.name }));
+ // Default to syncing the user's OWN calendars (their primary + any
+ // secondary calendars they created — accessRole "owner"). Calendars the
+ // user merely subscribes to (holidays, birthdays) or that are shared with
+ // them by someone else are "reader"/"writer"; exclude those from the
+ // default selection so they don't crowd the user's view. The user can
+ // still enable any of them manually.
+ return calendars.map((c) => ({
+ id: c.id,
+ title: c.name,
+ enabledByDefault: c.accessRole === "owner",
+ }));
  }
 
  /**
@@ -372,13 +390,15 @@ export class GoogleCalendar extends Connector<GoogleCalendar> {
  summary: string;
  description?: string;
  primary?: boolean;
+ accessRole?: string;
  }>;
  };
 
  return data.items.map((item) => ({
  id: item.id,
  name: item.summary,
  description: item.description || null,
+ accessRole: item.accessRole ?? null,
  primary: item.primary || false,
  }));
  }
@@ -440,6 +460,7 @@ export class GoogleCalendar extends Connector<GoogleCalendar> {
  summary: string;
  description?: string;
  primary?: boolean;
+ accessRole?: string;
  }>;
  };
 
@@ -448,6 +469,7 @@ export class GoogleCalendar extends Connector<GoogleCalendar> {
  name: item.summary,
  description: item.description || null,
  primary: item.primary || false,
+ accessRole: item.accessRole ?? null,
  }));
  }
 

connectors/google-drive/src/google-drive.ts

@@ -275,6 +275,10 @@ export class GoogleDrive extends Connector<GoogleDrive> {
  },
  ];
 
+ // My Drive, Shared drives, and Shared with me are all enabled by default
+ // (the client default for top-level channels) — a Drive user generally
+ // wants their documents from all three. Individual sub-folders stay
+ // collapsed under each, so the user can still narrow the scope.
  if (sharedDriveMap.size > 0) {
  result.push({
  id: VIRTUAL_SHARED_DRIVES,

connectors/ms-teams/src/ms-teams.ts

@@ -157,6 +157,9 @@ export class MsTeams extends Connector<MsTeams> {
  channels.push({
  id: team.id,
  title: team.displayName,
+ // A team is a container, not a syncable resource — the user picks the
+ // specific channels under it. Don't pre-select the team itself.
+ enabledByDefault: false,
  children: teamChannels.map((ch) => ({
  id: ch.id,
  title: ch.displayName,

twister/src/tools/integrations.ts

@@ -17,6 +17,26 @@ export type Channel = {
  id: string;
  /** Display name shown in the UI */
  title: string;
+ /**
+ * Whether this channel should be selected by default when the user first
+ * adds the connection. Tri-state:
+ * - `true` — pre-select it (e.g. the user's own/primary calendar).
+ * - `false` — exclude it from the default selection (low-value or
+ * irrelevant resources that would crowd the user's view, or containers
+ * whose contents are too broad to sync wholesale — e.g. a holiday or
+ * someone-else's shared calendar, a GitHub org that cascades to every
+ * repo, a Microsoft Teams team container). The user can still enable it
+ * manually.
+ * - `undefined` — no opinion; the client decides. The client defaults to
+ * enabling the channel unless its title looks low-value (holidays,
+ * birthdays, spam/sent/draft, …).
+ *
+ * The guiding principle is "sync everything the user would reasonably want
+ * by default" — for most connectors that's all channels, so only set this
+ * where the connector can distinguish the user's own/relevant channels from
+ * low-value ones (e.g. Google Calendar via `accessRole === "owner"`).
+ */
+ enabledByDefault?: boolean;
  /** Optional nested channel resources (e.g., subfolders) */
  children?: Channel[];
  /** Per-channel link type configs. Overrides twist-level linkTypes when present. */

.changeset/channel-enabled-by-default.md

@@ -0,0 +1,5 @@
+---
+"@plotday/twister": minor
+---
+
+Added: `enabledByDefault?: boolean` (tri-state) on the `Channel` type returned by `getChannels()`. Lets a connector influence which channels are pre-selected when a connection is first added: `true` pre-selects, `false` excludes a low-value/irrelevant channel or a too-broad container (e.g. a holiday or someone-else's shared calendar, a GitHub org that cascades to every repo, a Teams team container), and `undefined` leaves the choice to the client (which enables the channel unless its title looks low-value). The setup UI now defaults to enabling all top-level channels and filtering out the low-value ones, rather than picking a single "primary."

connectors/github/src/github.ts

@@ -337,6 +337,10 @@ export class GitHub extends Connector<GitHub> {
  channels.push({
  id: owner,
  title: owner,
+ // Enabling an owner cascades to EVERY repo under it (orgs can have
+ // hundreds), so don't pre-select it. The user opts in to the specific
+ // owner or repos they want to sync.
+ enabledByDefault: false,
  children: ownerRepos.map((repo) => ({
  id: repo.full_name,
  title: repo.full_name,

connectors/gmail/src/gmail.ts

@@ -400,7 +400,17 @@ export class Gmail extends Connector<Gmail> {
  l.type !== "system" ||
  ["INBOX", "SENT", "DRAFT", "IMPORTANT", "STARRED"].includes(l.id)
  )
- .map((l: any) => ({ id: l.id, title: l.name }));
+ // 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",
+ }));
  }
 
  async onChannelEnabled(channel: Channel, context?: SyncContext): Promise<void> {

connectors/google-calendar/src/google-calendar.ts

@@ -44,6 +44,14 @@ type Calendar = {
  name: string;
  description: string | null;
  primary: boolean;
+ /**
+ * The user's access level on this calendar: "owner", "writer", "reader",
+ * or "freeBusyReader". Calendars the user owns (their primary + any
+ * secondary calendars they created) are "owner"; subscribed holiday/
+ * birthday calendars and someone-else's shared calendars are "reader"/
+ * "writer". Drives the default-enable decision in getChannels.
+ */
+ accessRole: string | null;
 };
 
 /**
@@ -203,7 +211,17 @@ export class GoogleCalendar extends Connector<GoogleCalendar> {
  ): Promise<Channel[]> {
  const api = new GoogleApi(token.token);
  const calendars = await this.listCalendarsWithApi(api);
- return calendars.map((c) => ({ id: c.id, title: c.name }));
+ // Default to syncing the user's OWN calendars (their primary + any
+ // secondary calendars they created — accessRole "owner"). Calendars the
+ // user merely subscribes to (holidays, birthdays) or that are shared with
+ // them by someone else are "reader"/"writer"; exclude those from the
+ // default selection so they don't crowd the user's view. The user can
+ // still enable any of them manually.
+ return calendars.map((c) => ({
+ id: c.id,
+ title: c.name,
+ enabledByDefault: c.accessRole === "owner",
+ }));
  }
 
  /**
@@ -372,13 +390,15 @@ export class GoogleCalendar extends Connector<GoogleCalendar> {
  summary: string;
  description?: string;
  primary?: boolean;
+ accessRole?: string;
  }>;
  };
 
  return data.items.map((item) => ({
  id: item.id,
  name: item.summary,
  description: item.description || null,
+ accessRole: item.accessRole ?? null,
  primary: item.primary || false,
  }));
  }
@@ -440,6 +460,7 @@ export class GoogleCalendar extends Connector<GoogleCalendar> {
  summary: string;
  description?: string;
  primary?: boolean;
+ accessRole?: string;
  }>;
  };
 
@@ -448,6 +469,7 @@ export class GoogleCalendar extends Connector<GoogleCalendar> {
  name: item.summary,
  description: item.description || null,
  primary: item.primary || false,
+ accessRole: item.accessRole ?? null,
  }));
  }
 

connectors/google-drive/src/google-drive.ts

@@ -275,6 +275,10 @@ export class GoogleDrive extends Connector<GoogleDrive> {
  },
  ];
 
+ // My Drive, Shared drives, and Shared with me are all enabled by default
+ // (the client default for top-level channels) — a Drive user generally
+ // wants their documents from all three. Individual sub-folders stay
+ // collapsed under each, so the user can still narrow the scope.
  if (sharedDriveMap.size > 0) {
  result.push({
  id: VIRTUAL_SHARED_DRIVES,

connectors/ms-teams/src/ms-teams.ts

@@ -157,6 +157,9 @@ export class MsTeams extends Connector<MsTeams> {
  channels.push({
  id: team.id,
  title: team.displayName,
+ // A team is a container, not a syncable resource — the user picks the
+ // specific channels under it. Don't pre-select the team itself.
+ enabledByDefault: false,
  children: teamChannels.map((ch) => ({
  id: ch.id,
  title: ch.displayName,

twister/src/tools/integrations.ts

@@ -17,6 +17,26 @@ export type Channel = {
  id: string;
  /** Display name shown in the UI */
  title: string;
+ /**
+ * Whether this channel should be selected by default when the user first
+ * adds the connection. Tri-state:
+ * - `true` — pre-select it (e.g. the user's own/primary calendar).
+ * - `false` — exclude it from the default selection (low-value or
+ * irrelevant resources that would crowd the user's view, or containers
+ * whose contents are too broad to sync wholesale — e.g. a holiday or
+ * someone-else's shared calendar, a GitHub org that cascades to every
+ * repo, a Microsoft Teams team container). The user can still enable it
+ * manually.
+ * - `undefined` — no opinion; the client decides. The client defaults to
+ * enabling the channel unless its title looks low-value (holidays,
+ * birthdays, spam/sent/draft, …).
+ *
+ * The guiding principle is "sync everything the user would reasonably want
+ * by default" — for most connectors that's all channels, so only set this
+ * where the connector can distinguish the user's own/relevant channels from
+ * low-value ones (e.g. Google Calendar via `accessRole === "owner"`).
+ */
+ enabledByDefault?: boolean;
  /** Optional nested channel resources (e.g., subfolders) */
  children?: Channel[];
  /** Per-channel link type configs. Overrides twist-level linkTypes when present. */

.changeset/channel-enabled-by-default.md

@@ -0,0 +1,5 @@
+---
+"@plotday/twister": minor
+---
+
+Added: `enabledByDefault?: boolean` (tri-state) on the `Channel` type returned by `getChannels()`. Lets a connector influence which channels are pre-selected when a connection is first added: `true` pre-selects, `false` excludes a low-value/irrelevant channel or a too-broad container (e.g. a holiday or someone-else's shared calendar, a GitHub org that cascades to every repo, a Teams team container), and `undefined` leaves the choice to the client (which enables the channel unless its title looks low-value). The setup UI now defaults to enabling all top-level channels and filtering out the low-value ones, rather than picking a single "primary."

connectors/github/src/github.ts

@@ -337,6 +337,10 @@ export class GitHub extends Connector<GitHub> {
  channels.push({
  id: owner,
  title: owner,
+ // Enabling an owner cascades to EVERY repo under it (orgs can have
+ // hundreds), so don't pre-select it. The user opts in to the specific
+ // owner or repos they want to sync.
+ enabledByDefault: false,
  children: ownerRepos.map((repo) => ({
  id: repo.full_name,
  title: repo.full_name,

connectors/gmail/src/gmail.ts

@@ -400,7 +400,17 @@ export class Gmail extends Connector<Gmail> {
  l.type !== "system" ||
  ["INBOX", "SENT", "DRAFT", "IMPORTANT", "STARRED"].includes(l.id)
  )
- .map((l: any) => ({ id: l.id, title: l.name }));
+ // 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",
+ }));
  }
 
  async onChannelEnabled(channel: Channel, context?: SyncContext): Promise<void> {

connectors/google-calendar/src/google-calendar.ts

@@ -44,6 +44,14 @@ type Calendar = {
  name: string;
  description: string | null;
  primary: boolean;
+ /**
+ * The user's access level on this calendar: "owner", "writer", "reader",
+ * or "freeBusyReader". Calendars the user owns (their primary + any
+ * secondary calendars they created) are "owner"; subscribed holiday/
+ * birthday calendars and someone-else's shared calendars are "reader"/
+ * "writer". Drives the default-enable decision in getChannels.
+ */
+ accessRole: string | null;
 };
 
 /**
@@ -203,7 +211,17 @@ export class GoogleCalendar extends Connector<GoogleCalendar> {
  ): Promise<Channel[]> {
  const api = new GoogleApi(token.token);
  const calendars = await this.listCalendarsWithApi(api);
- return calendars.map((c) => ({ id: c.id, title: c.name }));
+ // Default to syncing the user's OWN calendars (their primary + any
+ // secondary calendars they created — accessRole "owner"). Calendars the
+ // user merely subscribes to (holidays, birthdays) or that are shared with
+ // them by someone else are "reader"/"writer"; exclude those from the
+ // default selection so they don't crowd the user's view. The user can
+ // still enable any of them manually.
+ return calendars.map((c) => ({
+ id: c.id,
+ title: c.name,
+ enabledByDefault: c.accessRole === "owner",
+ }));
  }
 
  /**
@@ -372,13 +390,15 @@ export class GoogleCalendar extends Connector<GoogleCalendar> {
  summary: string;
  description?: string;
  primary?: boolean;
+ accessRole?: string;
  }>;
  };
 
  return data.items.map((item) => ({
  id: item.id,
  name: item.summary,
  description: item.description || null,
+ accessRole: item.accessRole ?? null,
  primary: item.primary || false,
  }));
  }
@@ -440,6 +460,7 @@ export class GoogleCalendar extends Connector<GoogleCalendar> {
  summary: string;
  description?: string;
  primary?: boolean;
+ accessRole?: string;
  }>;
  };
 
@@ -448,6 +469,7 @@ export class GoogleCalendar extends Connector<GoogleCalendar> {
  name: item.summary,
  description: item.description || null,
  primary: item.primary || false,
+ accessRole: item.accessRole ?? null,
  }));
  }
 

connectors/google-drive/src/google-drive.ts

@@ -275,6 +275,10 @@ export class GoogleDrive extends Connector<GoogleDrive> {
  },
  ];
 
+ // My Drive, Shared drives, and Shared with me are all enabled by default
+ // (the client default for top-level channels) — a Drive user generally
+ // wants their documents from all three. Individual sub-folders stay
+ // collapsed under each, so the user can still narrow the scope.
  if (sharedDriveMap.size > 0) {
  result.push({
  id: VIRTUAL_SHARED_DRIVES,

connectors/ms-teams/src/ms-teams.ts

@@ -157,6 +157,9 @@ export class MsTeams extends Connector<MsTeams> {
  channels.push({
  id: team.id,
  title: team.displayName,
+ // A team is a container, not a syncable resource — the user picks the
+ // specific channels under it. Don't pre-select the team itself.
+ enabledByDefault: false,
  children: teamChannels.map((ch) => ({
  id: ch.id,
  title: ch.displayName,

twister/src/tools/integrations.ts

@@ -17,6 +17,26 @@ export type Channel = {
  id: string;
  /** Display name shown in the UI */
  title: string;
+ /**
+ * Whether this channel should be selected by default when the user first
+ * adds the connection. Tri-state:
+ * - `true` — pre-select it (e.g. the user's own/primary calendar).
+ * - `false` — exclude it from the default selection (low-value or
+ * irrelevant resources that would crowd the user's view, or containers
+ * whose contents are too broad to sync wholesale — e.g. a holiday or
+ * someone-else's shared calendar, a GitHub org that cascades to every
+ * repo, a Microsoft Teams team container). The user can still enable it
+ * manually.
+ * - `undefined` — no opinion; the client decides. The client defaults to
+ * enabling the channel unless its title looks low-value (holidays,
+ * birthdays, spam/sent/draft, …).
+ *
+ * The guiding principle is "sync everything the user would reasonably want
+ * by default" — for most connectors that's all channels, so only set this
+ * where the connector can distinguish the user's own/relevant channels from
+ * low-value ones (e.g. Google Calendar via `accessRole === "owner"`).
+ */
+ enabledByDefault?: boolean;
  /** Optional nested channel resources (e.g., subfolders) */
  children?: Channel[];
  /** Per-channel link type configs. Overrides twist-level linkTypes when present. */

.changeset/channel-enabled-by-default.md

@@ -0,0 +1,5 @@
+---
+"@plotday/twister": minor
+---
+
+Added: `enabledByDefault?: boolean` (tri-state) on the `Channel` type returned by `getChannels()`. Lets a connector influence which channels are pre-selected when a connection is first added: `true` pre-selects, `false` excludes a low-value/irrelevant channel or a too-broad container (e.g. a holiday or someone-else's shared calendar, a GitHub org that cascades to every repo, a Teams team container), and `undefined` leaves the choice to the client (which enables the channel unless its title looks low-value). The setup UI now defaults to enabling all top-level channels and filtering out the low-value ones, rather than picking a single "primary."

connectors/github/src/github.ts

@@ -337,6 +337,10 @@ export class GitHub extends Connector<GitHub> {
  channels.push({
  id: owner,
  title: owner,
+ // Enabling an owner cascades to EVERY repo under it (orgs can have
+ // hundreds), so don't pre-select it. The user opts in to the specific
+ // owner or repos they want to sync.
+ enabledByDefault: false,
  children: ownerRepos.map((repo) => ({
  id: repo.full_name,
  title: repo.full_name,

connectors/gmail/src/gmail.ts

@@ -400,7 +400,17 @@ export class Gmail extends Connector<Gmail> {
  l.type !== "system" ||
  ["INBOX", "SENT", "DRAFT", "IMPORTANT", "STARRED"].includes(l.id)
  )
- .map((l: any) => ({ id: l.id, title: l.name }));
+ // 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",
+ }));
  }
 
  async onChannelEnabled(channel: Channel, context?: SyncContext): Promise<void> {

connectors/google-calendar/src/google-calendar.ts

@@ -44,6 +44,14 @@ type Calendar = {
  name: string;
  description: string | null;
  primary: boolean;
+ /**
+ * The user's access level on this calendar: "owner", "writer", "reader",
+ * or "freeBusyReader". Calendars the user owns (their primary + any
+ * secondary calendars they created) are "owner"; subscribed holiday/
+ * birthday calendars and someone-else's shared calendars are "reader"/
+ * "writer". Drives the default-enable decision in getChannels.
+ */
+ accessRole: string | null;
 };
 
 /**
@@ -203,7 +211,17 @@ export class GoogleCalendar extends Connector<GoogleCalendar> {
  ): Promise<Channel[]> {
  const api = new GoogleApi(token.token);
  const calendars = await this.listCalendarsWithApi(api);
- return calendars.map((c) => ({ id: c.id, title: c.name }));
+ // Default to syncing the user's OWN calendars (their primary + any
+ // secondary calendars they created — accessRole "owner"). Calendars the
+ // user merely subscribes to (holidays, birthdays) or that are shared with
+ // them by someone else are "reader"/"writer"; exclude those from the
+ // default selection so they don't crowd the user's view. The user can
+ // still enable any of them manually.
+ return calendars.map((c) => ({
+ id: c.id,
+ title: c.name,
+ enabledByDefault: c.accessRole === "owner",
+ }));
  }
 
  /**
@@ -372,13 +390,15 @@ export class GoogleCalendar extends Connector<GoogleCalendar> {
  summary: string;
  description?: string;
  primary?: boolean;
+ accessRole?: string;
  }>;
  };
 
  return data.items.map((item) => ({
  id: item.id,
  name: item.summary,
  description: item.description || null,
+ accessRole: item.accessRole ?? null,
  primary: item.primary || false,
  }));
  }
@@ -440,6 +460,7 @@ export class GoogleCalendar extends Connector<GoogleCalendar> {
  summary: string;
  description?: string;
  primary?: boolean;
+ accessRole?: string;
  }>;
  };
 
@@ -448,6 +469,7 @@ export class GoogleCalendar extends Connector<GoogleCalendar> {
  name: item.summary,
  description: item.description || null,
  primary: item.primary || false,
+ accessRole: item.accessRole ?? null,
  }));
  }
 

connectors/google-drive/src/google-drive.ts

@@ -275,6 +275,10 @@ export class GoogleDrive extends Connector<GoogleDrive> {
  },
  ];
 
+ // My Drive, Shared drives, and Shared with me are all enabled by default
+ // (the client default for top-level channels) — a Drive user generally
+ // wants their documents from all three. Individual sub-folders stay
+ // collapsed under each, so the user can still narrow the scope.
  if (sharedDriveMap.size > 0) {
  result.push({
  id: VIRTUAL_SHARED_DRIVES,

connectors/ms-teams/src/ms-teams.ts

@@ -157,6 +157,9 @@ export class MsTeams extends Connector<MsTeams> {
  channels.push({
  id: team.id,
  title: team.displayName,
+ // A team is a container, not a syncable resource — the user picks the
+ // specific channels under it. Don't pre-select the team itself.
+ enabledByDefault: false,
  children: teamChannels.map((ch) => ({
  id: ch.id,
  title: ch.displayName,

twister/src/tools/integrations.ts

@@ -17,6 +17,26 @@ export type Channel = {
  id: string;
  /** Display name shown in the UI */
  title: string;
+ /**
+ * Whether this channel should be selected by default when the user first
+ * adds the connection. Tri-state:
+ * - `true` — pre-select it (e.g. the user's own/primary calendar).
+ * - `false` — exclude it from the default selection (low-value or
+ * irrelevant resources that would crowd the user's view, or containers
+ * whose contents are too broad to sync wholesale — e.g. a holiday or
+ * someone-else's shared calendar, a GitHub org that cascades to every
+ * repo, a Microsoft Teams team container). The user can still enable it
+ * manually.
+ * - `undefined` — no opinion; the client decides. The client defaults to
+ * enabling the channel unless its title looks low-value (holidays,
+ * birthdays, spam/sent/draft, …).
+ *
+ * The guiding principle is "sync everything the user would reasonably want
+ * by default" — for most connectors that's all channels, so only set this
+ * where the connector can distinguish the user's own/relevant channels from
+ * low-value ones (e.g. Google Calendar via `accessRole === "owner"`).
+ */
+ enabledByDefault?: boolean;
  /** Optional nested channel resources (e.g., subfolders) */
  children?: Channel[];
  /** Per-channel link type configs. Overrides twist-level linkTypes when present. */

.changeset/channel-enabled-by-default.md

@@ -0,0 +1,5 @@
+---
+"@plotday/twister": minor
+---
+
+Added: `enabledByDefault?: boolean` (tri-state) on the `Channel` type returned by `getChannels()`. Lets a connector influence which channels are pre-selected when a connection is first added: `true` pre-selects, `false` excludes a low-value/irrelevant channel or a too-broad container (e.g. a holiday or someone-else's shared calendar, a GitHub org that cascades to every repo, a Teams team container), and `undefined` leaves the choice to the client (which enables the channel unless its title looks low-value). The setup UI now defaults to enabling all top-level channels and filtering out the low-value ones, rather than picking a single "primary."

connectors/github/src/github.ts

@@ -337,6 +337,10 @@ export class GitHub extends Connector<GitHub> {
  channels.push({
  id: owner,
  title: owner,
+ // Enabling an owner cascades to EVERY repo under it (orgs can have
+ // hundreds), so don't pre-select it. The user opts in to the specific
+ // owner or repos they want to sync.
+ enabledByDefault: false,
  children: ownerRepos.map((repo) => ({
  id: repo.full_name,
  title: repo.full_name,

connectors/gmail/src/gmail.ts

@@ -400,7 +400,17 @@ export class Gmail extends Connector<Gmail> {
  l.type !== "system" ||
  ["INBOX", "SENT", "DRAFT", "IMPORTANT", "STARRED"].includes(l.id)
  )
- .map((l: any) => ({ id: l.id, title: l.name }));
+ // 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",
+ }));
  }
 
  async onChannelEnabled(channel: Channel, context?: SyncContext): Promise<void> {

connectors/google-calendar/src/google-calendar.ts

@@ -44,6 +44,14 @@ type Calendar = {
  name: string;
  description: string | null;
  primary: boolean;
+ /**
+ * The user's access level on this calendar: "owner", "writer", "reader",
+ * or "freeBusyReader". Calendars the user owns (their primary + any
+ * secondary calendars they created) are "owner"; subscribed holiday/
+ * birthday calendars and someone-else's shared calendars are "reader"/
+ * "writer". Drives the default-enable decision in getChannels.
+ */
+ accessRole: string | null;
 };
 
 /**
@@ -203,7 +211,17 @@ export class GoogleCalendar extends Connector<GoogleCalendar> {
  ): Promise<Channel[]> {
  const api = new GoogleApi(token.token);
  const calendars = await this.listCalendarsWithApi(api);
- return calendars.map((c) => ({ id: c.id, title: c.name }));
+ // Default to syncing the user's OWN calendars (their primary + any
+ // secondary calendars they created — accessRole "owner"). Calendars the
+ // user merely subscribes to (holidays, birthdays) or that are shared with
+ // them by someone else are "reader"/"writer"; exclude those from the
+ // default selection so they don't crowd the user's view. The user can
+ // still enable any of them manually.
+ return calendars.map((c) => ({
+ id: c.id,
+ title: c.name,
+ enabledByDefault: c.accessRole === "owner",
+ }));
  }
 
  /**
@@ -372,13 +390,15 @@ export class GoogleCalendar extends Connector<GoogleCalendar> {
  summary: string;
  description?: string;
  primary?: boolean;
+ accessRole?: string;
  }>;
  };
 
  return data.items.map((item) => ({
  id: item.id,
  name: item.summary,
  description: item.description || null,
+ accessRole: item.accessRole ?? null,
  primary: item.primary || false,
  }));
  }
@@ -440,6 +460,7 @@ export class GoogleCalendar extends Connector<GoogleCalendar> {
  summary: string;
  description?: string;
  primary?: boolean;
+ accessRole?: string;
  }>;
  };
 
@@ -448,6 +469,7 @@ export class GoogleCalendar extends Connector<GoogleCalendar> {
  name: item.summary,
  description: item.description || null,
  primary: item.primary || false,
+ accessRole: item.accessRole ?? null,
  }));
  }
 

connectors/google-drive/src/google-drive.ts

@@ -275,6 +275,10 @@ export class GoogleDrive extends Connector<GoogleDrive> {
  },
  ];
 
+ // My Drive, Shared drives, and Shared with me are all enabled by default
+ // (the client default for top-level channels) — a Drive user generally
+ // wants their documents from all three. Individual sub-folders stay
+ // collapsed under each, so the user can still narrow the scope.
  if (sharedDriveMap.size > 0) {
  result.push({
  id: VIRTUAL_SHARED_DRIVES,

connectors/ms-teams/src/ms-teams.ts

@@ -157,6 +157,9 @@ export class MsTeams extends Connector<MsTeams> {
  channels.push({
  id: team.id,
  title: team.displayName,
+ // A team is a container, not a syncable resource — the user picks the
+ // specific channels under it. Don't pre-select the team itself.
+ enabledByDefault: false,
  children: teamChannels.map((ch) => ({
  id: ch.id,
  title: ch.displayName,

twister/src/tools/integrations.ts

@@ -17,6 +17,26 @@ export type Channel = {
  id: string;
  /** Display name shown in the UI */
  title: string;
+ /**
+ * Whether this channel should be selected by default when the user first
+ * adds the connection. Tri-state:
+ * - `true` — pre-select it (e.g. the user's own/primary calendar).
+ * - `false` — exclude it from the default selection (low-value or
+ * irrelevant resources that would crowd the user's view, or containers
+ * whose contents are too broad to sync wholesale — e.g. a holiday or
+ * someone-else's shared calendar, a GitHub org that cascades to every
+ * repo, a Microsoft Teams team container). The user can still enable it
+ * manually.
+ * - `undefined` — no opinion; the client decides. The client defaults to
+ * enabling the channel unless its title looks low-value (holidays,
+ * birthdays, spam/sent/draft, …).
+ *
+ * The guiding principle is "sync everything the user would reasonably want
+ * by default" — for most connectors that's all channels, so only set this
+ * where the connector can distinguish the user's own/relevant channels from
+ * low-value ones (e.g. Google Calendar via `accessRole === "owner"`).
+ */
+ enabledByDefault?: boolean;
  /** Optional nested channel resources (e.g., subfolders) */
  children?: Channel[];
  /** Per-channel link type configs. Overrides twist-level linkTypes when present. */