feat(connectors): add Google Meet knowledge base connector by waleedlatif1 · Pull Request #5149 · simstudioai/sim

waleedlatif1 · 2026-06-20T06:01:33Z

Summary

Add a Google Meet knowledge base connector that syncs meeting transcripts into a knowledge base
Uses the Meet REST API v2: lists conference records, fetches transcript entries lazily per meeting (contentDeferred), resolves speaker display names, and links back to the exported transcript Doc
Maps participants, duration, and meeting-date tags
OAuth via the existing google-meet provider (meetings.space.readonly scope) — no new auth wiring
Registered in both the server registry and the client-safe meta registry

Type of Change

New feature (Google Meet connector)

Testing

Tested manually: TypeScript compiles clean, Biome clean. Every endpoint, field shape, OAuth scope, and the conferenceRecords.list filter syntax verified against the live Meet REST v2 docs.

Note: Google retains Meet conference records/transcripts for ~30 days, and conferenceRecords.list returns meetings the connected user organized.

Checklist

Code follows project style guidelines
Self-reviewed my changes
Tests added/updated and passing
No new warnings introduced
I confirm that I have read and agree to the terms outlined in the Contributor License Agreement (CLA)

Syncs Google Meet meeting transcripts into a knowledge base via the Meet REST API v2. Lists conference records, fetches transcript entries lazily per meeting (contentDeferred), resolves speaker display names, and maps participants/duration/meeting-date tags. OAuth via the existing google-meet provider (meetings.space.readonly).

vercel · 2026-06-20T06:01:39Z

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

1 Skipped Deployment

Project	Deployment	Actions	Updated (UTC)
docs	Skipped		Jun 20, 2026 6:19am

cursor · 2026-06-20T06:01:42Z

PR Summary

Medium Risk
New third-party sync path handles OAuth-backed meeting/transcript data and sync-engine edge cases (caps, deferred content, hash-based change detection), though it follows existing connector patterns without new auth wiring.

Overview
Adds a Google Meet knowledge-base connector so users can sync meeting transcripts into a knowledge base, wired through the existing google-meet OAuth provider (meetings.space.readonly).

Listing uses Meet REST API v2 conferenceRecords with optional lookback (start_time filter) and max meetings caps; sync context tracks totals and only sets listingCapped when truncation actually hides upstream records (so deletion reconciliation still works when the source exactly hits the cap).

Content is loaded lazily: listDocuments returns deferred stubs keyed by a hash on conference endTime; getDocument pulls transcripts and entries, waits until every transcript is FILE_GENERATED (avoids indexing partial text that would never refresh), merges multi-transcript entries by start time, resolves speaker display names (bounded concurrency), and can attach the exported Google Doc exportUri as sourceUrl.

Metadata exposes participants, duration, and meetingDate tags; config validation checks numeric fields and probes the API. The connector is registered as google_meet in both server and client meta registries.

^{Reviewed by Cursor Bugbot for commit 412217f. Configure here.}

greptile-apps · 2026-06-20T06:05:50Z

Greptile Summary

This PR adds a Google Meet knowledge base connector that syncs meeting transcripts into a knowledge base using the Meet REST API v2. It follows the established connector pattern with deferred loading, a FILE_GENERATED-only guard to prevent partial transcript indexing, batched participant name resolution, and full pagination for all sub-resources.

Introduces apps/sim/connectors/google-meet/google-meet.ts with listDocuments (stub-based deferred loading), getDocument (transcript hydration with speaker attribution), validateConfig, and mapTags.
Registers the connector in both the server registry (registry.server.ts) and the client-safe meta registry (registry.ts), with metadata and OAuth wiring in meta.ts.

Confidence Score: 5/5

This PR adds a self-contained connector with no changes to shared infrastructure, and all edge cases (partial transcripts, expired records, empty meetings) are handled correctly.

The connector follows the established deferred-loading pattern, correctly guards against partial transcript indexing with a FILE_GENERATED-only check, handles all pagination loops safely, and uses the existing OAuth provider without any new auth wiring.

No files require special attention.

Important Files Changed

Filename	Overview
apps/sim/connectors/google-meet/google-meet.ts	Core connector implementation; well-structured with proper pagination, FILE_GENERATED state guard, deferred content loading, and batched participant resolution. No functional issues found.
apps/sim/connectors/google-meet/meta.ts	Client-safe connector metadata with correct OAuth provider reference, config fields, and tag definitions. Follows established meta.ts pattern.
apps/sim/connectors/google-meet/index.ts	Minimal re-export barrel file, consistent with other connectors in the directory.
apps/sim/connectors/registry.server.ts	Adds google_meet to the server registry in alphabetical order, consistent with surrounding entries.
apps/sim/connectors/registry.ts	Adds google_meet to the client-safe meta registry, matching the server registry entry.

Sequence Diagram

%%{init: {'theme': 'neutral'}}%%
sequenceDiagram
    participant SE as Sync Engine
    participant C as GoogleMeetConnector
    participant API as Meet REST API v2

    SE->>C: listDocuments(accessToken, sourceConfig, cursor)
    C->>API: "GET /conferenceRecords?pageSize=100&filter=..."
    API-->>C: ConferenceRecordsListResponse (stubs, nextPageToken)
    C-->>SE: "ExternalDocumentList (contentDeferred=true stubs)"

    SE->>C: getDocument(accessToken, sourceConfig, externalId)
    C->>API: "GET /conferenceRecords/{id}"
    API-->>C: ConferenceRecord
    C->>API: "GET /conferenceRecords/{id}/transcripts"
    API-->>C: Transcripts[]
    Note over C: Guard: all transcripts must be FILE_GENERATED
    C->>API: "GET /transcripts/{id}/entries (per transcript, parallel)"
    API-->>C: TranscriptEntry[][]
    C->>API: "GET /participants/{id} (batched, concurrency=5)"
    API-->>C: Participant display names
    C-->>SE: ExternalDocument (formatted transcript text, metadata)

%%{init: {'theme': 'base', 'themeVariables': {"darkMode": true, "background": "#0d1117", "primaryColor": "#21262d", "primaryTextColor": "#e6edf3", "primaryBorderColor": "#8b949e", "lineColor": "#8b949e", "textColor": "#e6edf3", "edgeLabelBackground": "#161b22", "actorBkg": "#21262d", "actorBorder": "#8b949e", "actorTextColor": "#e6edf3", "actorLineColor": "#8b949e", "signalColor": "#8b949e", "signalTextColor": "#e6edf3", "noteBkgColor": "#373320", "noteBorderColor": "#d4a72c", "noteTextColor": "#f0e6c0", "labelBoxBkgColor": "#21262d", "labelBoxBorderColor": "#8b949e", "labelTextColor": "#e6edf3", "loopTextColor": "#e6edf3", "activationBkgColor": "#30363d", "activationBorderColor": "#8b949e"}}}%%
sequenceDiagram
    participant SE as Sync Engine
    participant C as GoogleMeetConnector
    participant API as Meet REST API v2

    SE->>C: listDocuments(accessToken, sourceConfig, cursor)
    C->>API: "GET /conferenceRecords?pageSize=100&filter=..."
    API-->>C: ConferenceRecordsListResponse (stubs, nextPageToken)
    C-->>SE: "ExternalDocumentList (contentDeferred=true stubs)"

    SE->>C: getDocument(accessToken, sourceConfig, externalId)
    C->>API: "GET /conferenceRecords/{id}"
    API-->>C: ConferenceRecord
    C->>API: "GET /conferenceRecords/{id}/transcripts"
    API-->>C: Transcripts[]
    Note over C: Guard: all transcripts must be FILE_GENERATED
    C->>API: "GET /transcripts/{id}/entries (per transcript, parallel)"
    API-->>C: TranscriptEntry[][]
    C->>API: "GET /participants/{id} (batched, concurrency=5)"
    API-->>C: Participant display names
    C-->>SE: ExternalDocument (formatted transcript text, metadata)

_{Reviews (3): Last reviewed commit: "fix(connectors): only flag Meet listing ..." | Re-trigger Greptile}

- Only index a meeting once every transcript is FILE_GENERATED, so a partial transcript is never stored under an endTime-keyed hash that would never refresh - Sort merged transcript entries by start time to preserve chronology across multiple transcripts in one conference

…et transcripts

waleedlatif1 · 2026-06-20T06:09:56Z

@greptile

waleedlatif1 · 2026-06-20T06:09:57Z

@cursor review

Previously listingCapped was set whenever the fetched count reached maxMeetings, even when the API returned every record and no next page existed. That suppressed the sync engine's deletion reconciliation when the cap happened to equal the true source size. Now flag only when more pages remain or records were dropped from the page.

waleedlatif1 · 2026-06-20T06:19:48Z

@greptile

waleedlatif1 · 2026-06-20T06:19:49Z

@cursor review

cursor

✅ Bugbot reviewed your changes and found no new issues!

Comment @cursor review or bugbot run to trigger another review on this PR

^{Reviewed by Cursor Bugbot for commit 412217f. Configure here.}

cursor Bot reviewed Jun 20, 2026

View reviewed changes

Comment thread apps/sim/connectors/google-meet/google-meet.ts

Comment thread apps/sim/connectors/google-meet/google-meet.ts

greptile-apps Bot reviewed Jun 20, 2026

View reviewed changes

Comment thread apps/sim/connectors/google-meet/google-meet.ts

Comment thread apps/sim/connectors/google-meet/google-meet.ts

vercel Bot temporarily deployed to Preview June 20, 2026 06:08 Inactive

refactor(connectors): dedicated TRANSCRIPTS_PAGE_SIZE constant for Me…

1291db0

…et transcripts

vercel Bot temporarily deployed to Preview June 20, 2026 06:09 Inactive

cursor Bot reviewed Jun 20, 2026

View reviewed changes

Comment thread apps/sim/connectors/google-meet/google-meet.ts Outdated

vercel Bot temporarily deployed to Preview June 20, 2026 06:19 Inactive

cursor Bot reviewed Jun 20, 2026

View reviewed changes

waleedlatif1 merged commit 3ebb9a5 into staging Jun 20, 2026
16 checks passed

waleedlatif1 deleted the worktree-add-connectors-survey branch June 20, 2026 06:35

waleedlatif1 mentioned this pull request Jun 20, 2026

v0.7.11: parallel subagents, new tools, rich markdown editor, governance, file sharing #5145

Open

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

feat(connectors): add Google Meet knowledge base connector#5149

feat(connectors): add Google Meet knowledge base connector#5149
waleedlatif1 merged 4 commits into
stagingfrom
worktree-add-connectors-survey

waleedlatif1 commented Jun 20, 2026

Uh oh!

vercel Bot commented Jun 20, 2026 •

edited

Loading

Uh oh!

cursor Bot commented Jun 20, 2026 •

edited

Loading

Uh oh!

Uh oh!

Uh oh!

greptile-apps Bot commented Jun 20, 2026 •

edited

Loading

Uh oh!

Uh oh!

Uh oh!

waleedlatif1 commented Jun 20, 2026

Uh oh!

waleedlatif1 commented Jun 20, 2026

Uh oh!

Uh oh!

waleedlatif1 commented Jun 20, 2026

Uh oh!

waleedlatif1 commented Jun 20, 2026

Uh oh!

cursor Bot left a comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

Conversation

waleedlatif1 commented Jun 20, 2026

Summary

Type of Change

Testing

Checklist

Uh oh!

vercel Bot commented Jun 20, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

cursor Bot commented Jun 20, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

PR Summary

Uh oh!

Uh oh!

Uh oh!

greptile-apps Bot commented Jun 20, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Greptile Summary

Confidence Score: 5/5

Important Files Changed

Sequence Diagram

Uh oh!

Uh oh!

Uh oh!

waleedlatif1 commented Jun 20, 2026

Uh oh!

waleedlatif1 commented Jun 20, 2026

Uh oh!

Uh oh!

waleedlatif1 commented Jun 20, 2026

Uh oh!

waleedlatif1 commented Jun 20, 2026

Uh oh!

cursor Bot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

vercel Bot commented Jun 20, 2026 •

edited

Loading

cursor Bot commented Jun 20, 2026 •

edited

Loading

greptile-apps Bot commented Jun 20, 2026 •

edited

Loading