Merge branch 'main' into feat/doctor-command

Signed-off-by: Galymzhan <zhangazy2004@gmail.com>

Author: IamGalymzhan

.github/scripts/upsert-pr-bot-comment.cjs

@@ -0,0 +1,45 @@
+/**
+ * Upserts the sticky "PR bot" comment built by the pr-template-artifact job:
+ * the evals-monitor link plus the run-anywhere command to scaffold an app from
+ * this PR's template artifact.
+ *
+ * Invoked via `actions/github-script`. The comment body is read from the file
+ * at COMMENT_PATH (built by the workflow step so the run id, artifact name, and
+ * output dir are interpolated from CI context). The body carries the marker
+ * below as its first line, which we reuse to find and update an existing
+ * comment instead of posting a new one on every push.
+ */
+
+const fs = require("node:fs");
+
+const MARKER = "<!-- pr-bot -->";
+
+module.exports = async ({ github, context }) => {
+  const { owner, repo } = context.repo;
+  const issue_number = context.issue.number;
+  const body = fs.readFileSync(process.env.COMMENT_PATH, "utf-8");
+
+  const comments = await github.paginate(github.rest.issues.listComments, {
+    owner,
+    repo,
+    issue_number,
+    per_page: 100,
+  });
+  const existing = comments.find((c) => c.body?.includes(MARKER));
+
+  if (existing) {
+    await github.rest.issues.updateComment({
+      owner,
+      repo,
+      comment_id: existing.id,
+      body,
+    });
+  } else {
+    await github.rest.issues.createComment({
+      owner,
+      repo,
+      issue_number,
+      body,
+    });
+  }
+};

.github/workflows/ci.yml

@@ -171,6 +171,13 @@ jobs:
     runs-on:
       group: databricks-protected-runner-group
       labels: linux-ubuntu-latest
+    # Job-level permissions REPLACE (not merge with) the top-level set, so all
+    # three must be listed: pull-requests: write for the sticky comment step,
+    # and id-token: write which setup-jfrog-npm needs for its OIDC token.
+    permissions:
+      contents: read
+      pull-requests: write
+      id-token: write
 
     steps:
       - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
@@ -226,6 +233,55 @@ jobs:
           name: appkit-template-${{ steps.version.outputs.version }}
           path: appkit-template-${{ steps.version.outputs.version }}.zip
 
+      # Build the PR-bot comment: a link to the evals-monitor app, plus a
+      # self-contained, run-anywhere command that downloads this run's artifact
+      # and scaffolds an app from it. Every value (run id, repo, artifact name,
+      # output dir) is baked in so the reader can paste it into any folder — no
+      # repo checkout or specific cwd required.
+      - name: Build PR-bot comment
+        env:
+          VERSION: ${{ steps.version.outputs.version }}
+          RUN_ID: ${{ github.run_id }}
+          REPO: ${{ github.repository }}
+          PR_NUMBER: ${{ github.event.pull_request.number }}
+        run: |
+          ARTIFACT="appkit-template-${VERSION}"
+          OUT="appkit-pr-${PR_NUMBER}"
+          EVALS_URL="https://evals-monitor-6051921418418893.staging.aws.databricksapps.com/prs/appkit/${PR_NUMBER}"
+          {
+            echo "<!-- pr-bot -->"
+            echo "## 🤖 AppKit PR bot"
+            echo ""
+            echo "### 🔬 Run evals"
+            echo ""
+            echo "Start an eval for this PR from the evals-monitor app: [**Go to Evals Monitor →**](${EVALS_URL})"
+            echo ""
+            echo "### 📦 Try this PR's app template"
+            echo ""
+            echo "Scaffolds a new app from this PR's SDK build. Run it in **any** folder (requires the GitHub CLI — \`gh auth login\` — and the Databricks CLI):"
+            echo ""
+            echo '```bash'
+            echo "gh run download ${RUN_ID} -R ${REPO} -n ${ARTIFACT} -D ${OUT} \\"
+            echo "  && unzip -o \"${OUT}/${ARTIFACT}.zip\" -d \"${OUT}\" \\"
+            echo "  && databricks apps init --template \"${OUT}\""
+            echo '```'
+            echo ""
+            echo "The template pins \`@databricks/appkit\` and \`@databricks/appkit-ui\` to tarballs built from this branch, so the scaffolded app runs against this PR's code."
+          } > pr-bot-comment.md
+
+      # Fork PRs get a read-only GITHUB_TOKEN, so commenting would 403 and fail
+      # a job the author can't fix. Skip for forks — the command is still in the
+      # job log above. Matches bundle-size.yml.
+      - name: Upsert PR-bot comment
+        if: github.event.pull_request.head.repo.full_name == github.repository
+        uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0
+        env:
+          COMMENT_PATH: pr-bot-comment.md
+        with:
+          script: |
+            const upsert = require('./.github/scripts/upsert-pr-bot-comment.cjs');
+            await upsert({ github, context });
+
   docs-build:
     name: Docs Build
     needs: detect-changes

.github/workflows/eval-pr-comment.yml

@@ -82,6 +82,53 @@ All notable changes to this project will be documented in this file.
 
 # Changelog
 
+# Changelog
+
+# Changelog
+
+# Changelog
+
+# Changelog
+
+## [0.48.0](https://github.com/databricks/appkit/compare/v0.47.1...v0.48.0) (2026-07-24)
+
+### appkit
+
+* **appkit:** /ui visual variant picker ([#476](https://github.com/databricks/appkit/issues/476)) ([8f62d59](https://github.com/databricks/appkit/commit/8f62d594428fd79818a2b336d7502917cef3a6ea))
+
+
+## [0.47.1](https://github.com/databricks/appkit/compare/v0.47.0...v0.47.1) (2026-07-23)
+
+### cli
+
+* **cli:** match lint test-file exclusion relative to scan root ([#490](https://github.com/databricks/appkit/issues/490)) ([716a219](https://github.com/databricks/appkit/commit/716a2196bc7123e4f1341f3da3c4e299b857fef7))
+
+
+## [0.47.0](https://github.com/databricks/appkit/compare/v0.46.0...v0.47.0) (2026-07-23)
+
+* metric-view runtime ([#474](https://github.com/databricks/appkit/issues/474)) ([1b1a122](https://github.com/databricks/appkit/commit/1b1a122d3e08baf600df982b5f52d4c37d93aa04)), closes [#341](https://github.com/databricks/appkit/issues/341) [#484](https://github.com/databricks/appkit/issues/484) [#487](https://github.com/databricks/appkit/issues/487)
+
+
+## [0.46.0](https://github.com/databricks/appkit/compare/v0.45.0...v0.46.0) (2026-07-22)
+
+### appkit
+
+* **appkit:** forward async handler rejections to a terminal error middleware instead of crashing ([#439](https://github.com/databricks/appkit/issues/439)) ([5ef5404](https://github.com/databricks/appkit/commit/5ef5404d9b4497cd3b399b03f7027705d5e20314))
+* **appkit:** report only the actually-missing env vars in resource errors ([#486](https://github.com/databricks/appkit/issues/486)) ([2e2af02](https://github.com/databricks/appkit/commit/2e2af02acb61d639b793764ac5c663244d0608d8))
+
+### server
+
+* **server:** invoke plugin shutdown hooks and close connections during graceful shutdown ([#441](https://github.com/databricks/appkit/issues/441)) ([f8cd9ec](https://github.com/databricks/appkit/commit/f8cd9ecb00071c2f4b11c5a3cb029f89b0377ba7))
+
+### stream
+
+* **stream:** remove completed/errored streams from registry after buffer TTL ([#438](https://github.com/databricks/appkit/issues/438)) ([e606900](https://github.com/databricks/appkit/commit/e6069008547caf156f3077b7bb02d9f460349053))
+
+### agents
+
+* **agents:** forward generation params (temperature/top_p/stop/...) to the serving adapter ([#450](https://github.com/databricks/appkit/issues/450)) ([44cb589](https://github.com/databricks/appkit/commit/44cb5891be997c1acb63873a4da74cd6de236df8))
+
+
 ## [0.45.0](https://github.com/databricks/appkit/compare/v0.44.0...v0.45.0) (2026-07-09)
 
 * decode inline Arrow IPC + warehouse-compat fallback ([#329](https://github.com/databricks/appkit/issues/329)) ([86bebff](https://github.com/databricks/appkit/commit/86bebffa389bcbac087edd200954b7efe3123a9f))

CHANGELOG.md

@@ -13,6 +13,7 @@ import {
   SearchIcon,
   ServerIcon,
   ShieldIcon,
+  Wand2Icon,
   ZapIcon,
 } from "lucide-react";
 
@@ -162,6 +163,13 @@ export const NAV_GROUPS: ReadonlyArray<NavGroup> = [
           "Resilient SSE streams: automatic Last-Event-ID tracking and reconnection.",
         icon: RadioIcon,
       },
+      {
+        to: "/ui-variants",
+        label: "UI Variants",
+        description:
+          "Author UI in variants, pick one live in the browser, and let the agent finalize it into source.",
+        icon: Wand2Icon,
+      },
     ],
   },
 ];

apps/dev-playground/client/src/lib/nav.ts

@@ -10,6 +10,7 @@
 
 import { Route as rootRouteImport } from './routes/__root'
 import { Route as VectorSearchRouteRouteImport } from './routes/vector-search.route'
+import { Route as UiVariantsRouteRouteImport } from './routes/ui-variants.route'
 import { Route as TypeSafetyRouteRouteImport } from './routes/type-safety.route'
 import { Route as TelemetryRouteRouteImport } from './routes/telemetry.route'
 import { Route as SqlHelpersRouteRouteImport } from './routes/sql-helpers.route'
@@ -33,6 +34,11 @@ const VectorSearchRouteRoute = VectorSearchRouteRouteImport.update({
   path: '/vector-search',
   getParentRoute: () => rootRouteImport,
 } as any)
+const UiVariantsRouteRoute = UiVariantsRouteRouteImport.update({
+  id: '/ui-variants',
+  path: '/ui-variants',
+  getParentRoute: () => rootRouteImport,
+} as any)
 const TypeSafetyRouteRoute = TypeSafetyRouteRouteImport.update({
   id: '/type-safety',
   path: '/type-safety',
@@ -137,6 +143,7 @@ export interface FileRoutesByFullPath {
   '/sql-helpers': typeof SqlHelpersRouteRoute
   '/telemetry': typeof TelemetryRouteRoute
   '/type-safety': typeof TypeSafetyRouteRoute
+  '/ui-variants': typeof UiVariantsRouteRoute
   '/vector-search': typeof VectorSearchRouteRoute
 }
 export interface FileRoutesByTo {
@@ -157,6 +164,7 @@ export interface FileRoutesByTo {
   '/sql-helpers': typeof SqlHelpersRouteRoute
   '/telemetry': typeof TelemetryRouteRoute
   '/type-safety': typeof TypeSafetyRouteRoute
+  '/ui-variants': typeof UiVariantsRouteRoute
   '/vector-search': typeof VectorSearchRouteRoute
 }
 export interface FileRoutesById {
@@ -178,6 +186,7 @@ export interface FileRoutesById {
   '/sql-helpers': typeof SqlHelpersRouteRoute
   '/telemetry': typeof TelemetryRouteRoute
   '/type-safety': typeof TypeSafetyRouteRoute
+  '/ui-variants': typeof UiVariantsRouteRoute
   '/vector-search': typeof VectorSearchRouteRoute
 }
 export interface FileRouteTypes {
@@ -200,6 +209,7 @@ export interface FileRouteTypes {
     | '/sql-helpers'
     | '/telemetry'
     | '/type-safety'
+    | '/ui-variants'
     | '/vector-search'
   fileRoutesByTo: FileRoutesByTo
   to:
@@ -220,6 +230,7 @@ export interface FileRouteTypes {
     | '/sql-helpers'
     | '/telemetry'
     | '/type-safety'
+    | '/ui-variants'
     | '/vector-search'
   id:
     | '__root__'
@@ -240,6 +251,7 @@ export interface FileRouteTypes {
     | '/sql-helpers'
     | '/telemetry'
     | '/type-safety'
+    | '/ui-variants'
     | '/vector-search'
   fileRoutesById: FileRoutesById
 }
@@ -261,6 +273,7 @@ export interface RootRouteChildren {
   SqlHelpersRouteRoute: typeof SqlHelpersRouteRoute
   TelemetryRouteRoute: typeof TelemetryRouteRoute
   TypeSafetyRouteRoute: typeof TypeSafetyRouteRoute
+  UiVariantsRouteRoute: typeof UiVariantsRouteRoute
   VectorSearchRouteRoute: typeof VectorSearchRouteRoute
 }
 
@@ -273,6 +286,13 @@ declare module '@tanstack/react-router' {
       preLoaderRoute: typeof VectorSearchRouteRouteImport
       parentRoute: typeof rootRouteImport
     }
+    '/ui-variants': {
+      id: '/ui-variants'
+      path: '/ui-variants'
+      fullPath: '/ui-variants'
+      preLoaderRoute: typeof UiVariantsRouteRouteImport
+      parentRoute: typeof rootRouteImport
+    }
     '/type-safety': {
       id: '/type-safety'
       path: '/type-safety'
@@ -413,6 +433,7 @@ const rootRouteChildren: RootRouteChildren = {
   SqlHelpersRouteRoute: SqlHelpersRouteRoute,
   TelemetryRouteRoute: TelemetryRouteRoute,
   TypeSafetyRouteRoute: TypeSafetyRouteRoute,
+  UiVariantsRouteRoute: UiVariantsRouteRoute,
   VectorSearchRouteRoute: VectorSearchRouteRoute,
 }
 export const routeTree = rootRouteImport