improvement(kb-connectors): multi-select fields + Slack bot/app message extraction (#4711)

* improvement(kb-connectors): multi-select fields + Slack bot/app message extraction

Adds multi-value support to KB connector configuration fields and applies it
across 8 connectors: Jira (projects), Confluence (spaces), Slack (channels),
Microsoft Teams (channels), Google Calendar (calendars), Gmail (labels),
Notion (databases), and Linear (teams + projects). Each connector emits
byte-identical externalId for legacy single-value configs so existing rows
reconcile in place via the sync engine's externalId-keyed matching.

Framework changes:
- ConnectorConfigField gains `multi?: boolean`
- New `parseMultiValue` helper in @/connectors/utils
- useConnectorConfigFields state model upgraded to string|string[]
- ConnectorSelectorField renders Combobox in multi-select mode when `field.multi`
- Add/edit connector modals handle array values end-to-end

Per-connector specifics:
- Jira: JQL `project in (...)` for 2+ keys, `project = X` for one
- Confluence: routes through CQL `space in (...)` when multi; v2 fast path stays
  for single+no-label; also fixes selector returning space.id instead of space.key
- Slack: loops per channel emitting one document each; extracts text from
  attachments and Block Kit blocks (incl. nested attachment.blocks where GitHub
  embeds PR bodies); contentHash bumped to slack-v2: to force one-time re-embed
- Microsoft Teams: loops per channel within a single team
- Google Calendar: compound cursor across calendars; single-calendar keeps
  legacy externalId/contentHash for zero-churn
- Gmail: (label:A OR label:B) with quoted-form for labels with spaces
- Notion: sequential walk via JSON compound cursor; single-DB keeps bare cursor
- Linear: GraphQL IdComparator.in for multi, eq for single

* fix(kb-connectors): valuesEqual treats legacy scalar as equal to multi-array

Existing connectors created before multi-select store sourceConfig values as
scalars (e.g. projectKey: "ENG"). With the field now declared multi: true,
resolveSourceConfig returns an array (["ENG"]), and the original valuesEqual
fell through to a strict reference comparison — falsely flagging unsaved
changes on open and triggering an unnecessary string→array shape rewrite on
save.

valuesEqual now normalizes both sides to string[] via CSV-split when either
is an array, so persisted scalar and in-memory array of the same content
compare equal. Single-value (non-multi) fields keep strict string equality.

* fix(kb-connectors): GCal externalId on config downgrade, Slack silent skip, valuesEqual order

- google-calendar getDocument: derive isMultiCalendar from the externalId's
  `:` separator instead of the current config count. Prevents duplicates when
  a user downgrades from multi to single calendar — previously the returned
  doc lost its `calendarId:` prefix and was treated as a new row by the sync
  engine, orphaning the original.
- slack listDocuments: throw on unresolvable channel instead of silently
  skipping. Matches MS Teams behaviour. Silent skip would let the sync
  engine orphan-delete the previously indexed channel content if a bot was
  removed or a channel was archived/renamed mid-life.
- edit-connector-modal valuesEqual: order-insensitive comparison for multi-
  select arrays via Set membership. Multi-select UI doesn't guarantee
  insertion order matches the server-returned order, so `["A","B"]` vs
  `["B","A"]` would otherwise flag false unsaved changes.

* chore(kb-connectors): use emptyValue() fallback in isFieldPopulated for consistency

Behavior unchanged — isValuePopulated('') and isValuePopulated([]) both return
false — but reading the field-typed fallback inline matches the convention
used elsewhere in the hook (coerceForField, handleFieldChange, resolveSourceConfig).

* fix(kb-connectors): Linear projects selector loads across all selected teams

When the team selector is in multi-select mode, the basic-mode projects
dropdown was passing only the first team ID into the linear.projects
selector context (via readFirst in resolveDepValue), so projects from other
selected teams were invisible.

resolveDepValue now joins multi-value parents into a CSV string so dependent
selectors receive every selected parent ID. The /api/tools/linear/projects
route splits the CSV teamId, fetches projects from each team in parallel,
and dedupes by project ID. Single-team configs pass through unchanged
(`split(",")` on a bare ID yields a one-element array).

The AND-of-filters semantics in buildIssuesQuery is intentional and matches
standard GraphQL filter behavior — a user filtering on teams [A,B] and
projects [X,Y] gets issues in (A or B) AND (X or Y). With this fix the
project dropdown now shows every project under any selected team so the
user can compose the right project set.

* fix(gmail-connector): always wrap OR-containing custom query, not just unwrapped ones

The previous check `!/^\(.*\)$/.test(trimmedCustom)` was supposed to avoid
double-wrapping an already-parenthesized expression, but it false-positives
on inputs like `(from:alice) OR (from:bob)` where the parens don't bracket
the whole string. Those would skip wrapping and the top-level OR would bind
across the preceding label / category / date filters instead of the custom
clause.

Always wrap when an OR is present — double-parens are a no-op in Gmail
search syntax, so `((from:a OR from:b))` parses the same as `(from:a OR
from:b)`. Simpler than walking parens depth and provably safe.

Author: waleedlatif1

apps/sim/app/api/tools/linear/projects/route.ts

@@ -45,17 +45,40 @@ export const POST = withRouteHandler(async (request: NextRequest) => {
     }
 
     const linearClient = new LinearClient({ accessToken })
-    let projects: Array<{ id: string; name: string }> = []
 
-    const team = await linearClient.team(teamId)
-    const projectsResult = await team.projects()
-    projects = projectsResult.nodes.map((project: Project) => ({
-      id: project.id,
-      name: project.name,
-    }))
+    /**
+     * teamId may be a single ID or a comma-separated list when the basic-mode
+     * team selector is in multi-select. Fetch projects from each team in
+     * parallel and dedupe by project ID (Linear projects can be cross-team).
+     */
+    const teamIds = teamId
+      .split(',')
+      .map((s) => s.trim())
+      .filter(Boolean)
+
+    const perTeam = await Promise.all(
+      teamIds.map(async (id) => {
+        const team = await linearClient.team(id)
+        const result = await team.projects()
+        return result.nodes.map((project: Project) => ({
+          id: project.id,
+          name: project.name,
+        }))
+      })
+    )
+
+    const seen = new Set<string>()
+    const projects: Array<{ id: string; name: string }> = []
+    for (const teamProjects of perTeam) {
+      for (const project of teamProjects) {
+        if (seen.has(project.id)) continue
+        seen.add(project.id)
+        projects.push(project)
+      }
+    }
 
     if (projects.length === 0) {
-      logger.info('No projects found for team', { teamId })
+      logger.info('No projects found for team(s)', { teamIds })
     }
 
     return NextResponse.json({ projects })

apps/sim/app/workspace/[workspaceId]/knowledge/[id]/components/add-connector-modal/add-connector-modal.tsx

@@ -29,6 +29,7 @@ import { OAuthModal } from '@/app/workspace/[workspaceId]/components/oauth-modal
 import { ConnectorSelectorField } from '@/app/workspace/[workspaceId]/knowledge/[id]/components/connector-selector-field'
 import { SYNC_INTERVALS } from '@/app/workspace/[workspaceId]/knowledge/[id]/components/consts'
 import { MaxBadge } from '@/app/workspace/[workspaceId]/knowledge/[id]/components/max-badge'
+import type { ConfigFieldValue } from '@/app/workspace/[workspaceId]/knowledge/[id]/hooks/use-connector-config-fields'
 import { useConnectorConfigFields } from '@/app/workspace/[workspaceId]/knowledge/[id]/hooks/use-connector-config-fields'
 import { isBillingEnabled } from '@/app/workspace/[workspaceId]/settings/navigation'
 import { CONNECTOR_REGISTRY } from '@/connectors/registry'
@@ -108,6 +109,7 @@ export function AddConnectorModal({
     setCanonicalModes,
     canonicalGroups,
     isFieldVisible,
+    isFieldPopulated,
     handleFieldChange,
     toggleCanonicalMode,
     resolveSourceConfig,
@@ -150,16 +152,16 @@ export function AddConnectorModal({
     for (const field of connectorConfig.configFields) {
       if (!field.required) continue
       if (!isFieldVisible(field)) continue
-      if (!sourceConfig[field.id]?.trim()) return false
+      if (!isFieldPopulated(field)) return false
     }
     return true
   }, [
     connectorConfig,
     isApiKeyMode,
     apiKeyValue,
     effectiveCredentialId,
-    sourceConfig,
     isFieldVisible,
+    isFieldPopulated,
   ])
 
   const handleSubmit = () => {
@@ -169,7 +171,13 @@ export function AddConnectorModal({
 
     const resolvedConfig: Record<string, unknown> = {}
     for (const [key, value] of Object.entries(resolveSourceConfig())) {
-      if (value) resolvedConfig[key] = value
+      if (Array.isArray(value)) {
+        if (value.length > 0) resolvedConfig[key] = value
+      } else if (typeof value === 'string') {
+        if (value) resolvedConfig[key] = value
+      } else if (value !== undefined && value !== null) {
+        resolvedConfig[key] = value
+      }
     }
     if (disabledTagIds.size > 0) {
       resolvedConfig.disabledTagIds = Array.from(disabledTagIds)
@@ -370,8 +378,8 @@ export function AddConnectorModal({
                       {field.type === 'selector' && field.selectorKey ? (
                         <ConnectorSelectorField
                           field={field as ConnectorConfigField & { selectorKey: SelectorKey }}
-                          value={sourceConfig[field.id] || ''}
-                          onChange={(value) => handleFieldChange(field.id, value)}
+                          value={sourceConfig[field.id] ?? (field.multi ? [] : '')}
+                          onChange={(value: ConfigFieldValue) => handleFieldChange(field.id, value)}
                           credentialId={effectiveCredentialId}
                           sourceConfig={sourceConfig}
                           configFields={connectorConfig.configFields}
@@ -385,13 +393,21 @@ export function AddConnectorModal({
                             label: opt.label,
                             value: opt.id,
                           }))}
-                          value={sourceConfig[field.id] || undefined}
+                          value={
+                            typeof sourceConfig[field.id] === 'string'
+                              ? (sourceConfig[field.id] as string) || undefined
+                              : undefined
+                          }
                           onChange={(value) => handleFieldChange(field.id, value)}
                           placeholder={field.placeholder || `Select ${field.title.toLowerCase()}`}
                         />
                       ) : (
                         <Input
-                          value={sourceConfig[field.id] || ''}
+                          value={
+                            Array.isArray(sourceConfig[field.id])
+                              ? (sourceConfig[field.id] as string[]).join(', ')
+                              : (sourceConfig[field.id] as string) || ''
+                          }
                           onChange={(e) => handleFieldChange(field.id, e.target.value)}
                           placeholder={field.placeholder}
                         />

apps/sim/app/workspace/[workspaceId]/knowledge/[id]/components/connector-selector-field/connector-selector-field.tsx

@@ -3,17 +3,21 @@
 import { useMemo } from 'react'
 import { Combobox, type ComboboxOption, Loader } from '@/components/emcn'
 import { SELECTOR_CONTEXT_FIELDS } from '@/lib/workflows/subblocks/context'
+import type {
+  ConfigFieldMap,
+  ConfigFieldValue,
+} from '@/app/workspace/[workspaceId]/knowledge/[id]/hooks/use-connector-config-fields'
 import { getDependsOnFields } from '@/blocks/utils'
 import type { ConnectorConfigField } from '@/connectors/types'
 import type { SelectorContext, SelectorKey } from '@/hooks/selectors/types'
 import { useSelectorOptions } from '@/hooks/selectors/use-selector-query'
 
 interface ConnectorSelectorFieldProps {
   field: ConnectorConfigField & { selectorKey: SelectorKey }
-  value: string
-  onChange: (value: string) => void
+  value: ConfigFieldValue
+  onChange: (value: ConfigFieldValue) => void
   credentialId: string | null
-  sourceConfig: Record<string, string>
+  sourceConfig: ConfigFieldMap
   configFields: ConnectorConfigField[]
   canonicalModes: Record<string, 'basic' | 'advanced'>
   disabled?: boolean
@@ -29,6 +33,8 @@ export function ConnectorSelectorField({
   canonicalModes,
   disabled,
 }: ConnectorSelectorFieldProps) {
+  const isMulti = Boolean(field.multi)
+
   const context = useMemo<SelectorContext>(() => {
     const ctx: SelectorContext = {}
     if (credentialId) ctx.oauthCredential = credentialId
@@ -73,11 +79,34 @@ export function ConnectorSelectorField({
     )
   }
 
+  if (isMulti) {
+    const multiValues = Array.isArray(value) ? value : value ? [value] : []
+    return (
+      <Combobox
+        multiSelect
+        options={comboboxOptions}
+        multiSelectValues={multiValues}
+        onMultiSelectChange={(values) => onChange(values)}
+        searchable
+        searchPlaceholder={`Search ${field.title.toLowerCase()}...`}
+        placeholder={
+          !credentialId
+            ? 'Connect an account first'
+            : !depsResolved
+              ? `Select ${getDependencyLabel(field, configFields)} first`
+              : field.placeholder || `Select ${field.title.toLowerCase()}`
+        }
+        disabled={disabled || !credentialId || !depsResolved}
+      />
+    )
+  }
+
+  const singleValue = Array.isArray(value) ? value[0] : value
   return (
     <Combobox
       options={comboboxOptions}
-      value={value || undefined}
-      onChange={onChange}
+      value={singleValue || undefined}
+      onChange={(next) => onChange(next)}
       searchable
       searchPlaceholder={`Search ${field.title.toLowerCase()}...`}
       placeholder={
@@ -96,18 +125,28 @@ function resolveDepValue(
   depFieldId: string,
   configFields: ConnectorConfigField[],
   canonicalModes: Record<string, 'basic' | 'advanced'>,
-  sourceConfig: Record<string, string>
+  sourceConfig: ConfigFieldMap
 ): string {
   const depField = configFields.find((f) => f.id === depFieldId)
-  if (!depField?.canonicalParamId) return sourceConfig[depFieldId] ?? ''
+  /**
+   * For multi-value parent fields, pass all selected values to dependent
+   * selectors as a comma-joined string so the downstream selector can load
+   * options across every selected parent (e.g. Linear projects across multiple
+   * selected teams). Single-value parents pass through unchanged.
+   */
+  const readDep = (raw: ConfigFieldValue | undefined): string => {
+    if (Array.isArray(raw)) return raw.join(',')
+    return raw ?? ''
+  }
+  if (!depField?.canonicalParamId) return readDep(sourceConfig[depFieldId])
 
   const activeMode = canonicalModes[depField.canonicalParamId] ?? 'basic'
-  if (depField.mode === activeMode) return sourceConfig[depFieldId] ?? ''
+  if (depField.mode === activeMode) return readDep(sourceConfig[depFieldId])
 
   const activeField = configFields.find(
     (f) => f.canonicalParamId === depField.canonicalParamId && f.mode === activeMode
   )
-  return activeField ? (sourceConfig[activeField.id] ?? '') : (sourceConfig[depFieldId] ?? '')
+  return activeField ? readDep(sourceConfig[activeField.id]) : readDep(sourceConfig[depFieldId])
 }
 
 function getDependencyLabel(