Title: feat(connectors): add Bitbucket, Databricks, Google Chat, and Workday Help KB connectors by waleedlatif1 · Pull Request #6895 · simstudioai/sim · GitHub
Open Graph Title: feat(connectors): add Bitbucket, Databricks, Google Chat, and Workday Help KB connectors by waleedlatif1 · Pull Request #6895 · simstudioai/sim
X Title: feat(connectors): add Bitbucket, Databricks, Google Chat, and Workday Help KB connectors by waleedlatif1 · Pull Request #6895 · simstudioai/sim
Description: Adds four knowledge base connectors. Each closes a gap where Sim already shipped tool blocks for the service but could not index its content — the same four sources Glean indexes natively that we did not.
What's here
Connector
Auth
Indexes
Bitbucket
Existing bitbucket OAuth credential
Repository source files + pull request descriptions
Databricks
PAT (mode: 'apiKey')
Notebooks (Workspace API) + saved SQL queries
Google Chat
New google-chat OAuth service
Spaces, as chronological message transcripts
Workday Help
Client ID + clientSecret:refreshToken
Knowledge article versions (helpArticle/v1)
Every response shape is derived from an official spec — Atlassian's swagger.v3.json, the generated Databricks Python SDK (same OpenAPI source as the rendered reference, which is an unfetchable SPA), Google's Chat REST reference, and Workday's published helpArticle_v1 Swagger. Nothing was inferred from partial docs; deliberate exclusions are documented in TSDoc at each site.
Deliberate exclusions
Bitbucket wiki — Cloud REST 2.0 has no wiki endpoints. Verified programmatically: 0 of 193 spec paths match, and the wiki OAuth scope exists with no resource under it.
Bitbucket issues — endpoints exist under an issue scope guarding 18 paths, none of which this connector touches. Our Bitbucket OAuth service does not request that scope, and adding it would flag every existing Bitbucket credential as needing re-consent.
Databricks Lakeview dashboards, Unity Catalog comments, workspace FILE objects — not prose, or not exportable.
Google Chat attachments — would need media.download plus Drive scopes and turns one document per space into unbounded per-message fan-out. Files shared in Chat belong to the Drive connector.
Workday workers/orgs/comp, Journeys, RaaS reports — PII, no content endpoint, or tenant-defined schema with no documented id/title/content field.
Review history
Two validation passes ran over all four connectors, plus a combined-change regression audit. Highlights of what they caught:
Silent data loss (Bitbucket). The 555 timeout fallback rewrote the opaque next pagination URL, pairing a depth-5 cursor with a depth-1 result set — files drop out of the listing and, with listingCapped unset, reconciliation then deletes them from the KB. Same class: PR paging used sort=-updated_on, where a PR touched mid-pagination pushes another past the page boundary. Now sort=-id.
Silently missing content (Databricks). Notebooks inside Git folders were never indexed — the tree walk enqueued only DIRECTORY, not REPO, so with the default / root everything under /Repos was absent with no error.
Crash on a valid config (Workday). maxVersions was read with (value as string)?.trim(), which does not guard a number — a config persisted with maxVersions: 500 threw value.trim is not a function on every sync.
Availability misreporting (Google Chat). The service was missing from GOOGLE_OAUTH_SERVICES, so isOAuthServiceDeploymentAvailable fell through to true and advertised the connector on self-hosts with no Google OAuth client configured.
Tests that could not fail. Mutation testing on the Workday suite found six "verified" fixes whose tests passed regardless of the fix. Coverage was rewritten; every load-bearing test is now confirmed red-on-revert.
Test coverage across the four went from 33 tests to 118.
Sync fidelity
Three connectors have a change-detection limit rooted in a missing upstream revision field. None are papered over — each degrades loudly and self-heals on an explicit full resync (rehydrateOnFullSync), and each logs a warning naming the consequence:
Google Chat — lastActiveTime does not advance on edits or deletes.
Databricks — ObjectInfo.modified_at is documented as "only applicable to files", so notebooks may carry no timestamp.
Bitbucket — a tree entry's commit is explicitly not the commit that last modified the file. Files re-hydrate when the branch advances; path/extension filters are the intended bound.
Bitbucket declares supportsIncrementalSync: false deliberately: the sync engine disables deletion reconciliation for every incremental run, and the file walk is already full each run, so declaring support would leave upstream-deleted files indexed indefinitely on the default code configuration.
Before merge
1. Google consent screen — operational, outside this repo. Google Chat requests chat.messages.readonly under the same GOOGLE_CLIENT_ID as our 13 existing Google services. In code this is safe: Better Auth sends each provider's own scopes at authorize time, and the computed scope-resolution table for all 58 pre-existing services is byte-identical before and after. But chat.messages.readonly is a Google restricted/sensitive scope, and adding it to a published consent screen forces the whole OAuth client back through verification — during which Google can throttle or warn on the client, affecting every existing Google connector and "Sign in with Google". Confirm the hosted project has the Chat API enabled and both scopes approved, or gate the service until it does.
2. Workday status filter — one live-tenant probe. /articleVersions returns one row per revision with no latest/current filter, so the required-status dropdown is the only guard against indexing every historical revision. Whether status accepts an /articleStatuses WID or a literal keyword cannot be settled from the spec: status has no x-workday-populated-by while audience does, and sibling specs (learning_v1, recruiting_v4) document literal keywords for identically-shaped status params — which argues for the keyword form we did not implement. Mitigated so the wrong guess fails loudly: validateConfig reads the filtered response back and refuses a config whose returned status does not match the chosen one. The probe is one call — ?limit=1&status=
Open Graph Description: Adds four knowledge base connectors. Each closes a gap where Sim already shipped tool blocks for the service but could not index its content — the same four sources Glean indexes natively that we d...
X Description: Adds four knowledge base connectors. Each closes a gap where Sim already shipped tool blocks for the service but could not index its content — the same four sources Glean indexes natively that we d...
Opengraph URL: https://github.com/simstudioai/sim/pull/6895
X: @github
Domain: github.com
| react-profiling | 0 |
| react-import-map | react,react-dom,react-dom/client,react-dom/profiling,react-is,react-reconciler,react/compiler-runtime,react/jsx-dev-runtime,react/jsx-runtime,scheduler@d5750093facf |
| route-pattern | /:user_id/:repository/pull/:id/files(.:format) |
| route-controller | pull_requests |
| route-action | files |
| fetch-nonce | v2:09566eca-6437-3ce2-265b-a5f3d5c9d550 |
| current-catalog-service-hash | ae870bc5e265a340912cde392f23dad3671a0a881730ffdadd82f2f57d81641b |
| request-id | D156:6449C:F38A0F:14F420F:6AFB63DE |
| html-safe-nonce | ebaefe034f1fd7dc2cfaa3065ed160e67336c43aab7b45c6d453d8ec674f3a68 |
| visitor-payload | eyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiJEMTU2OjY0NDlDOkYzOEEwRjoxNEY0MjBGOjZBRkI2M0RFIiwidmlzaXRvcl9pZCI6Ijg3NzY3NjE2NDI0OTE1MzYzNTAiLCJyZWdpb25fZWRnZSI6ImlhZCIsInJlZ2lvbl9yZW5kZXIiOiJpYWQifQ== |
| visitor-hmac | 2a88bcb79c525a631ff0091182fca21456f86fd9717e863d62da0d44b9a6b90d |
| hovercard-subject-tag | pull_request:4325961745 |
| github-keyboard-shortcuts | repository,pull-request-list,pull-request-conversation,pull-request-files-changed,copilot |
| google-site-verification | Apib7-x98H0j5cPqHWwSMm6dNU4GmODRoqxLiDzdx9I |
| octolytics-url | https://collector.github.com/github/collect |
| analytics-location | / |
| fb:app_id | 1401488693436528 |
| apple-itunes-app | app-id=1477376905, app-argument=https://github.com/simstudioai/sim/pull/6895/files |
| twitter:image | https://avatars.githubusercontent.com/u/40672544?s=400&v=4 |
| twitter:card | summary_large_image |
| og:image | https://avatars.githubusercontent.com/u/40672544?s=400&v=4 |
| og:image:alt | Adds four knowledge base connectors. Each closes a gap where Sim already shipped tool blocks for the service but could not index its content — the same four sources Glean indexes natively that we d... |
| og:site_name | GitHub |
| og:type | object |
| hostname | github.com |
| expected-hostname | github.com |
| None | ea33d13c96d0ff66bd8fa906b193d2213536b78cb06b0c50a4632c58b1418f94 |
| turbo-cache-control | no-preview |
| diff-view | unified |
| go-import | github.com/simstudioai/sim git https://github.com/simstudioai/sim.git |
| octolytics-dimension-user_id | 199344406 |
| octolytics-dimension-user_login | simstudioai |
| octolytics-dimension-repository_id | 912559512 |
| octolytics-dimension-repository_nwo | simstudioai/sim |
| octolytics-dimension-repository_public | true |
| octolytics-dimension-repository_is_fork | false |
| octolytics-dimension-repository_network_root_id | 912559512 |
| octolytics-dimension-repository_network_root_nwo | simstudioai/sim |
| turbo-body-classes | logged-out env-production page-responsive full-width |
| disable-turbo | true |
| browser-stats-url | https://api.github.com/_private/browser/stats |
| browser-errors-url | https://api.github.com/_private/browser/errors |
| release | 59ef97164c52cf59bd10558ddec9c4f482763988 |
| ui-target | full |
| theme-color | #1e2327 |
| color-scheme | light dark |
Links:
Viewport: width=device-width