improvement(self-host): simplify capability setup configuration by TheodoreSpeaks · Pull Request #6230 · simstudioai/sim

TheodoreSpeaks · 2026-08-03T22:37:48Z

Summary

Separate runtime capability definitions from CLI prompts and status decoration
Make provider setup generic and drift-checked against application configuration
Update integration authoring skills to capture deployment requirements

Type of Change

Improvement

Testing

bun run test:setup
Focused environment capability and integration availability tests
bun run type-check
bun run lint
Full pre-ship audit suite

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)

vercel · 2026-08-03T22:37:54Z

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

1 Skipped Deployment

Project	Deployment	Actions	Updated (UTC)
docs	Skipped		Aug 4, 2026 7:37pm

cursor · 2026-08-03T22:38:11Z

PR Summary

High Risk
Changes authentication flows, deployment availability semantics, and copilot tool exposure across many integrations; misconfiguration now throws or hides integrations rather than silently offering broken OAuth.

Overview
Self-hosted deployments now fail closed on OAuth and integration availability instead of advertising integrations whose client credentials are missing or misconfigured.

Runtime capability model ties visible integration blocks to OAUTH_CLIENT_CAPABILITIES / env schema, with CLI setup fields in capability-config.ts kept in sync. OAuth authorize/callback routes use requireConfiguredOAuthClient; connector providers are filtered to configured clients only.

integrationAvailability (ready / limited / unavailable / misconfigured) is exposed from /api/settings/allowed-integrations and drives the integrations UI (disabled rows, connect deep-links), permission config block filtering, and copilot integration tools / OAuth link generation. Copilot also intersects workspace and env integration allowlists and can expose tools for limited integrations without advertising OAuth when the client is not configured.

CI and authoring: integration-catalog:check validates integrations.json against the block registry; ship/validate-integration skills add deployment-availability steps and expanded audit lists. README/setup docs cover per-capability bun run setup commands and explicit STORAGE_PROVIDER / OCR_PROVIDER env behavior.

^{Reviewed by Cursor Bugbot for commit babb8c0. Bugbot is set up for automated code reviews on this repo. Configure here.}

greptile-apps · 2026-08-03T22:40:54Z

Greptile Summary

The PR centralizes self-hosted deployment capability definitions and separates runtime configuration from setup presentation.

Adds generic capability inspection, provider setup, status reporting, and drift checks.
Projects OAuth and service-account deployment requirements into integration availability across UI, API, and copilot paths.
Updates Redis, storage, jobs, sandbox, email, and related runtime consumers to use centralized configuration.
Expands setup tests, integration availability tests, Helm examples, documentation, and authoring guidance.

Confidence Score: 5/5

The PR appears safe to merge because no eligible blocking follow-up finding or outstanding prior finding remains.

No blocking failure remains.

Important Files Changed

Filename	Overview
apps/sim/lib/core/config/env-capabilities.ts	Introduces the central runtime model for inspecting and requiring deployment capabilities and OAuth client configuration.
scripts/setup/capability-config.ts	Separates setup field presentation from runtime capability definitions with exhaustive drift checking.
scripts/setup/capability-setup.ts	Implements generic provider setup using the centralized capability and setup-field catalogs.
apps/sim/lib/integrations/availability.ts	Resolves integration deployment availability from generated OAuth and service-account metadata.
apps/sim/lib/integrations/availability.server.ts	Provides cached server bindings for integration and OAuth-service deployment availability.
apps/sim/lib/integrations/service-account-metadata.ts	Defines service-account provider projections and their deployment requirements.
apps/sim/lib/core/config/redis.ts	Routes Redis configuration through the centralized cache capability.
scripts/check-integration-catalog.ts	Adds drift validation between executable integration definitions and the committed client-safe catalog.
apps/sim/lib/core/config/env-capabilities.test.ts	Covers provider selection, partial and invalid configurations, defaults, and OAuth aliases.
scripts/setup/capability-config.test.ts	Verifies setup metadata remains exhaustive and aligned with runtime capability fields.

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart LR
  Env[Environment and Helm values] --> Cap[Runtime capability definitions]
  Setup[Self-host setup CLI] --> SetupMap[Setup field presentation]
  SetupMap -. drift checks .-> Cap
  Cap --> Runtime[Runtime resource consumers]
  Cap --> OAuth[OAuth client capability resolution]
  OAuth --> Catalog[Generated integration catalog]
  Catalog --> Availability[Integration availability]
  Availability --> UI[Workspace UI]
  Availability --> API[API and OAuth tooling]
  Availability --> Copilot[Copilot integration tools]
  Runtime --> Resources[Cache, storage, jobs, email, sandbox, OCR]

_{Reviews (9): Last reviewed commit: "fix(integrations): preserve connect deep..." | Re-trigger Greptile}

TheodoreSpeaks · 2026-08-03T23:30:36Z

@cursor review

TheodoreSpeaks · 2026-08-03T23:30:40Z

@greptile

TheodoreSpeaks · 2026-08-04T00:01:52Z

@cursor review

TheodoreSpeaks · 2026-08-04T03:10:47Z

@greptile

TheodoreSpeaks · 2026-08-04T03:10:56Z

@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 a3d7f63. Configure here.}

TheodoreSpeaks · 2026-08-04T03:35:15Z

@greptile

TheodoreSpeaks · 2026-08-04T03:35:24Z

@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 1e9a71f. Configure here.}

TheodoreSpeaks · 2026-08-04T17:18:56Z

@cursor review

TheodoreSpeaks · 2026-08-04T17:19:01Z

@greptile

TheodoreSpeaks · 2026-08-04T17:25:00Z

@greptile

TheodoreSpeaks · 2026-08-04T17:25:02Z

@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 64736a0. Configure here.}

# Conflicts: # apps/sim/app/workspace/[workspaceId]/w/components/sidebar/sidebar.tsx # apps/sim/lib/copilot/chat/process-contents.ts

TheodoreSpeaks · 2026-08-04T19:03:35Z

@greptile

TheodoreSpeaks · 2026-08-04T19:03:44Z

@cursor review

TheodoreSpeaks · 2026-08-04T19:22:55Z

@greptile

TheodoreSpeaks · 2026-08-04T19:23:01Z

@cursor review

TheodoreSpeaks · 2026-08-04T19:38:08Z

@greptile

TheodoreSpeaks · 2026-08-04T19:38:14Z

@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 babb8c0. Configure here.}

TheodoreSpeaks requested a review from a team as a code owner August 3, 2026 22:37

cursor Bot reviewed Aug 3, 2026

View reviewed changes

Comment thread apps/sim/lib/core/config/env-capabilities.server.ts

Comment thread apps/sim/hooks/use-permission-config.ts

vercel Bot deployed to Preview August 3, 2026 22:42 View deployment

cursor Bot reviewed Aug 3, 2026

View reviewed changes

Comment thread apps/sim/lib/integrations/availability.server.ts

vercel Bot deployed to Preview August 3, 2026 23:34 View deployment

vercel Bot temporarily deployed to Preview August 3, 2026 23:55 Inactive

cursor Bot reviewed Aug 3, 2026

View reviewed changes

Comment thread apps/sim/lib/integrations/availability.ts

Comment thread apps/sim/hooks/use-permission-config.ts

cursor Bot reviewed Aug 4, 2026

View reviewed changes

Comment thread apps/sim/lib/integrations/credential-visibility.server.ts

TheodoreSpeaks force-pushed the feat/self-host-link branch from ce77755 to 662cd15 Compare August 4, 2026 01:36

vercel Bot deployed to Preview August 4, 2026 01:41 View deployment

TheodoreSpeaks added 5 commits August 3, 2026 20:04

feat(self-host): add capability-aware setup

a185193

fix(self-host): preserve capability compatibility

74e4bd7

fix(copilot): honor preview availability server-side

cee0332

improvement(self-host): centralize capability resolution

166422a

fix(self-host): preserve integration availability paths

a3d7f63

TheodoreSpeaks force-pushed the feat/self-host-link branch from 662cd15 to a3d7f63 Compare August 4, 2026 03:09

vercel Bot deployed to Preview August 4, 2026 03:13 View deployment

cursor Bot reviewed Aug 4, 2026

View reviewed changes

fix(testing): align capability-aware config mocks

1e9a71f

vercel Bot temporarily deployed to Preview August 4, 2026 03:35 Inactive

cursor Bot reviewed Aug 4, 2026

View reviewed changes

improvement(self-host): simplify capability setup configuration

e76b794

TheodoreSpeaks changed the title ~~feat(self-host): add capability-aware setup~~ improvement(self-host): simplify capability setup configuration Aug 4, 2026

cursor Bot reviewed Aug 4, 2026

View reviewed changes

Comment thread scripts/setup/capability-setup.ts

vercel Bot deployed to Preview August 4, 2026 17:19 View deployment

fix(setup): preserve unowned storage overrides

64736a0

cursor Bot reviewed Aug 4, 2026

View reviewed changes

vercel Bot deployed to Preview August 4, 2026 17:27 View deployment

Merge remote-tracking branch 'origin/staging' into feat/self-host-link

6ca1662

# Conflicts: # apps/sim/app/workspace/[workspaceId]/w/components/sidebar/sidebar.tsx # apps/sim/lib/copilot/chat/process-contents.ts

vercel Bot deployed to Preview August 4, 2026 19:07 View deployment

cursor Bot reviewed Aug 4, 2026

View reviewed changes

Comment thread apps/sim/lib/core/config/env-capabilities.ts

Comment thread apps/sim/lib/copilot/chat/payload.ts

TheodoreSpeaks added 2 commits August 4, 2026 12:17

fix(self-host): reconcile storage and allowlists

fd4c580

Merge remote-tracking branch 'origin/staging' into feat/self-host-link

0155a61

vercel Bot deployed to Preview August 4, 2026 19:26 View deployment

cursor Bot reviewed Aug 4, 2026

View reviewed changes

Comment thread apps/sim/app/workspace/[workspaceId]/integrations/[block]/integration-block-detail.tsx

fix(integrations): preserve connect deep links

babb8c0

vercel Bot temporarily deployed to Preview August 4, 2026 19:37 Inactive

cursor Bot reviewed Aug 4, 2026

View reviewed changes

TheodoreSpeaks merged commit 35fd4ef into staging Aug 4, 2026
33 checks passed

TheodoreSpeaks deleted the feat/self-host-link branch August 4, 2026 19:47

Uh oh!

Conversation

TheodoreSpeaks commented Aug 3, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Type of Change

Testing

Checklist

Uh oh!

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

Uh oh!

Uh oh!

cursor Bot commented Aug 3, 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 Aug 3, 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

Flowchart

Uh oh!

TheodoreSpeaks commented Aug 3, 2026

Uh oh!

TheodoreSpeaks commented Aug 3, 2026

Uh oh!

Uh oh!

Uh oh!

Uh oh!

TheodoreSpeaks commented Aug 4, 2026

Uh oh!

Uh oh!

TheodoreSpeaks commented Aug 4, 2026

Uh oh!

TheodoreSpeaks commented Aug 4, 2026

Uh oh!

cursor Bot left a comment

Choose a reason for hiding this comment

Uh oh!

TheodoreSpeaks commented Aug 4, 2026

Uh oh!

TheodoreSpeaks commented Aug 4, 2026

Uh oh!

cursor Bot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

TheodoreSpeaks commented Aug 4, 2026

Uh oh!

TheodoreSpeaks commented Aug 4, 2026

Uh oh!

TheodoreSpeaks commented Aug 4, 2026

Uh oh!

TheodoreSpeaks commented Aug 4, 2026

Uh oh!

cursor Bot left a comment

Choose a reason for hiding this comment

Uh oh!

TheodoreSpeaks commented Aug 4, 2026

Uh oh!

TheodoreSpeaks commented Aug 4, 2026

Uh oh!

Uh oh!

Uh oh!

TheodoreSpeaks commented Aug 4, 2026

Uh oh!

TheodoreSpeaks commented Aug 4, 2026

Uh oh!

Uh oh!

TheodoreSpeaks commented Aug 4, 2026

Uh oh!

TheodoreSpeaks commented Aug 4, 2026

Uh oh!

cursor Bot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

TheodoreSpeaks commented Aug 3, 2026 •

edited

Loading

vercel Bot commented Aug 3, 2026 •

edited

Loading

cursor Bot commented Aug 3, 2026 •

edited

Loading

greptile-apps Bot commented Aug 3, 2026 •

edited

Loading