Merge branch 'dev' into add-fix-command

Author: aadesh18

.claude/CLAUDE-KNOWLEDGE.md

@@ -400,3 +400,9 @@ A: Root `dev` starts the OpenAPI docs watcher at the same time as package `dev`
 
 ## Q: How do SDK source tests replace the compile-time client version sentinel?
 A: `packages/template/vitest.config.ts` installs a Vite transform plugin for Vitest that replaces `STACK_COMPILE_TIME_CLIENT_PACKAGE_VERSION_SENTINEL` with `js <package-name>@<version>` from the local package.json. Keep the plugin in `packages/template` so `pnpm pre`/`scripts/generate-sdks.ts` propagates it to `packages/js`, `packages/react`, and `packages/stack`; otherwise tests importing `common.ts` throw `Client version was not replaced` before test collection.
+
+## Q: How does the Mintlify apps sidebar filter stay in sync with theme changes?
+A: `docs-mintlify/apps-sidebar-filter.js` injects the Apps filter with inline styles, so the MutationObserver must reapply `applySidebarAppsFilterTheme` when an existing input is found. Theme detection should handle both `html.dark` and `data-theme="dark"` signals.
+
+## Q: How should `StackAssertionError` preserve an underlying thrown error?
+A: Pass the underlying error as the `cause` property in the second argument. The `StackAssertionError` constructor only forwards `cause` into `ErrorOptions`, so storing a caught error under an `error` property captures it as ordinary metadata instead of preserving the error cause chain.

.github/workflows/db-migration-backwards-compatibility.yaml

@@ -169,6 +169,16 @@ jobs:
           wait-for: 30s
           log-output-if: true
 
+      - name: Start stack-mcp in background
+        uses: JarvusInnovations/background-action@v1.0.7
+        with:
+          run: pnpm run start:mcp --log-order=stream &
+          wait-on: |
+            http://localhost:8144/health
+          tail: true
+          wait-for: 30s
+          log-output-if: true
+
       - name: Start stack-dashboard in background
         uses: JarvusInnovations/background-action@v1.0.7
         with:
@@ -366,6 +376,16 @@ jobs:
           wait-for: 30s
           log-output-if: true
 
+      - name: Start stack-mcp in background
+        uses: JarvusInnovations/background-action@v1.0.7
+        with:
+          run: pnpm run start:mcp --log-order=stream &
+          wait-on: |
+            http://localhost:8144/health
+          tail: true
+          wait-for: 30s
+          log-output-if: true
+
       - name: Start stack-dashboard in background
         uses: JarvusInnovations/background-action@v1.0.7
         with:

.github/workflows/e2e-api-tests-local-emulator.yaml

@@ -119,6 +119,15 @@ jobs:
           tail: true
           wait-for: 30s
           log-output-if: true
+      - name: Start stack-mcp in background
+        uses: JarvusInnovations/background-action@v1.0.7
+        with:
+          run: pnpm run start:mcp --log-order=stream &
+          wait-on: |
+            http://localhost:8144/health
+          tail: true
+          wait-for: 30s
+          log-output-if: true
 
       - name: Start stack-dashboard in background
         uses: JarvusInnovations/background-action@v1.0.7

.github/workflows/e2e-api-tests.yaml

@@ -125,6 +125,15 @@ jobs:
           tail: true
           wait-for: 30s
           log-output-if: true
+      - name: Start stack-mcp in background
+        uses: JarvusInnovations/background-action@v1.0.7
+        with:
+          run: pnpm run start:mcp --log-order=stream &
+          wait-on: |
+            http://localhost:8144/health
+          tail: true
+          wait-for: 30s
+          log-output-if: true
       - name: Start stack-dashboard in background
         uses: JarvusInnovations/background-action@v1.0.7
         with:

.github/workflows/e2e-custom-base-port-api-tests.yaml

@@ -118,6 +118,15 @@ jobs:
           tail: true
           wait-for: 30s
           log-output-if: true
+      - name: Start stack-mcp in background
+        uses: JarvusInnovations/background-action@v1.0.7
+        with:
+          run: pnpm run start:mcp --log-order=stream &
+          wait-on: |
+            http://localhost:6744/health
+          tail: true
+          wait-for: 30s
+          log-output-if: true
       - name: Start stack-dashboard in background
         uses: JarvusInnovations/background-action@v1.0.7
         with:

apps/backend/package.json

@@ -87,7 +87,6 @@
     "@stackframe/stack-shared": "workspace:*",
     "@upstash/qstash": "^2.8.2",
     "@vercel/functions": "^2.0.0",
-    "@vercel/mcp-adapter": "^1.0.0",
     "@vercel/otel": "^1.10.4",
     "@vercel/sandbox": "^1.2.0",
     "ai": "^6.0.0",

apps/backend/src/app/api/internal/[transport]/route.ts

@@ -26,7 +26,6 @@ function captureOAuthAccessTokenRefreshIssue(options: {
       attempts: options.refreshError.attempts,
       retryCount: options.refreshError.retryCount,
       sawAmbiguousRefreshAttempt: options.refreshError.sawAmbiguousRefreshAttempt,
-      error: options.refreshError.cause,
       causes: options.refreshError.causes,
     },
   ));
@@ -197,7 +196,7 @@ export async function retrieveOrRefreshAccessToken(options: {
             refreshError: tokenSetResult.error,
           });
           const assertionError = new StackAssertionError('Unexpected error refreshing access token — this may indicate a bug or misconfiguration', {
-            error: tokenSetResult.error.cause,
+            cause: tokenSetResult.error.cause,
             providerClass: providerInstance.constructor.name,
             refreshErrorType: tokenSetResult.error.type,
             attempts: tokenSetResult.error.attempts,
@@ -210,7 +209,7 @@ export async function retrieveOrRefreshAccessToken(options: {
         }
         default: {
           const _: never = tokenSetResult.error;
-          throw new StackAssertionError("Unhandled OAuth access token refresh error", { error: _ });
+          throw new StackAssertionError("Unhandled OAuth access token refresh error", { cause: _ });
         }
       }
     }

apps/backend/src/app/api/latest/connected-accounts/access-token-helpers.tsx

@@ -882,7 +882,7 @@ export const usersCrudHandlers = createLazyProxy(() => createCrudHandlers(usersC
               }
             });
             throw new StackAssertionError("Failed to update team member", {
-              error: e,
+              cause: e,
               tenancy_id: auth.tenancy.id,
               user_id: params.user_id,
               team_id: data.selected_team_id,

apps/backend/src/app/api/latest/users/crud.tsx

@@ -154,7 +154,7 @@ export async function renderEmailWithTemplate(
         // This can happen with complex or invalid JSX
         captureError("email-transpilation-template-error", new StackAssertionError(
           "Failed to transpile template for editable markers",
-          { error: e instanceof Error ? e.message : String(e) }
+          { cause: e }
         ));
       }
     }
@@ -169,7 +169,7 @@ export async function renderEmailWithTemplate(
         // If transpilation fails, fall back to original source
         captureError("email-transpilation-theme-error", new StackAssertionError(
           "Failed to transpile theme for editable markers",
-          { error: e instanceof Error ? e.message : String(e) }
+          { cause: e }
         ));
       }
     }