fix: address review — handle session re-attach, remove dead code

- ConsoleCollector.attach() now updates session mapping on re-attach
  instead of early-returning, preventing silent event drops after
  target detach/re-attach (e.g. tab crash, cross-process navigation)
- Remove unused clearConsoleLogs() and ConsoleCollector.clear()

.gitattributes

@@ -9,6 +9,4 @@ packages/browseros/chromium_patches/**/*.py linguist-generated
 scripts/*.py linguist-generated
 # Mark build directories as generated
 build/* linguist-generated
-# Mark eval/test framework as vendored so it's excluded from language stats
-packages/browseros-agent/apps/eval/** linguist-vendored
 docs/videos/** filter=lfs diff=lfs merge=lfs -text

.github/workflows/cla.yml

@@ -1,11 +1,11 @@
-name: CLA Assistant
-
+name: 'CLA Assistant'
 on:
   issue_comment:
     types: [created]
   pull_request_target:
     types: [opened, closed, synchronize]
 
+# Explicitly configure permissions
 permissions:
   actions: write
   contents: write
@@ -13,46 +13,47 @@ permissions:
   statuses: write
 
 jobs:
-  cla:
+  CLAAssistant:
     runs-on: ubuntu-latest
-    if: |
-      (github.event_name == 'pull_request_target') ||
-      (github.event_name == 'issue_comment' && github.event.issue.pull_request &&
-       (github.event.comment.body == 'recheck' ||
-        github.event.comment.body == 'I have read the CLA Document and I hereby sign the CLA'))
     steps:
-      - name: CLA Assistant
+      - name: 'CLA Assistant'
+        if: (github.event.comment.body == 'recheck' || github.event.comment.body == 'I have read the CLA Document and I hereby sign the CLA') || github.event_name == 'pull_request_target'
         uses: contributor-assistant/github-action@v2.6.1
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-          PERSONAL_ACCESS_TOKEN: ${{ secrets.CLA_SIGNATURES_TOKEN }}
         with:
-          path-to-signatures: 'cla-signatures.json'
-          path-to-document: 'https://github.com/${{ github.repository }}/blob/main/CLA.md'
+          # Path where signatures will be stored
+          path-to-signatures: 'signatures/version1/cla.json'
+
+          # Path to your CLA document
+          path-to-document: 'https://github.com/browseros-ai/BrowserOS/blob/main/CLA.md'
+
+          # Branch to store signatures (should not be protected)
           branch: 'main'
-          remote-organization-name: 'browseros-ai'
-          remote-repository-name: 'cla-signatures'
-          allowlist: 'shadowfax92,felarof99,bot*,*[bot],dependabot,renovate,github-actions,snyk-bot,imgbot,greenkeeper,semantic-release-bot,allcontributors'
-          lock-pullrequest-aftermerge: false
+
+          # Allowlist for users who don't need to sign (bots, core team members)
+          allowlist: shadowfax92,felarof99,dependabot[bot],renovate[bot],github-actions[bot]
+
+          # Optional: Custom messages
           custom-notsigned-prcomment: |
-            Thank you for your contribution! Before we can merge this PR, we need you to sign our [Contributor License Agreement](https://github.com/${{ github.repository }}/blob/main/CLA.md).
+            **CLA Assistant Lite bot** Thank you for your submission! We require contributors to sign our [Contributor License Agreement](https://github.com/browseros-ai/BrowserOS/blob/main/CLA.md) before we can accept your contribution.
 
-            **To sign the CLA**, please add a comment to this PR with the following text:
+            By signing the CLA, you confirm that:
+            - You have read and agree to the AGPL-3.0 license terms
+            - Your contribution is your original work
+            - You grant us the rights to use your contribution under the AGPL-3.0 license
 
-            ```
-            I have read the CLA Document and I hereby sign the CLA
-            ```
+            **To sign the CLA, please comment on this PR with:**
+            `I have read the CLA Document and I hereby sign the CLA`
 
-            You only need to sign once. After signing, this check will pass automatically.
-
-            ---
-            <details>
-            <summary>Troubleshooting</summary>
-
-            - **Already signed but still failing?** Comment `recheck` to trigger a re-verification.
-            - **Signed with a different email?** Make sure your commit email matches your GitHub account email, or add your commit email to your GitHub account.
-
-            </details>
           custom-pr-sign-comment: 'I have read the CLA Document and I hereby sign the CLA'
+
           custom-allsigned-prcomment: |
-            All contributors have signed the CLA. Thank you!
+            **CLA Assistant Lite bot** ✅ All contributors have signed the CLA. Thank you for helping make BrowserOS better!
+
+          # Lock PR after merge to prevent signature tampering
+          lock-pullrequest-aftermerge: true
+
+          # Custom commit messages
+          create-file-commit-message: 'docs: Create CLA signatures file'
+          signed-commit-message: 'docs: $contributorName signed the CLA in $owner/$repo#$pullRequestNo'

.github/workflows/eval-weekly.yml

@@ -1,98 +0,0 @@
-name: Weekly Eval
-
-on:
-  schedule:
-    # Every Saturday at 06:00 UTC
-    - cron: '0 6 * * 6'
-  push:
-    branches: [main]
-    paths:
-      - 'packages/browseros-agent/apps/server/src/agent/**'
-      - 'packages/browseros-agent/apps/server/src/tools/**'
-  workflow_dispatch:
-    inputs:
-      config:
-        description: 'Eval config file (relative to apps/eval/)'
-        required: false
-        default: 'configs/browseros-agent-weekly.json'
-
-permissions:
-  contents: read
-
-jobs:
-  eval:
-    runs-on: ubuntu-latest
-    timeout-minutes: 360
-
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-
-      - name: Install BrowserOS
-        run: |
-          wget -q https://github.com/browseros-ai/BrowserOS/releases/download/v0.44.0.1/BrowserOS_v0.44.0.1_amd64.deb
-          sudo dpkg -i BrowserOS_v0.44.0.1_amd64.deb
-          browseros --version || echo "BrowserOS installed at $(which browseros)"
-
-      - name: Install Bun
-        uses: oven-sh/setup-bun@v2
-        with:
-          bun-version: latest
-
-      - name: Install dependencies
-        working-directory: packages/browseros-agent
-        run: bun install --ignore-scripts && bun run build:agent-sdk
-
-      - name: Install xvfb
-        run: sudo apt-get update && sudo apt-get install -y xvfb
-
-      - name: Install captcha solver extension
-        working-directory: packages/browseros-agent/apps/eval
-        run: |
-          mkdir -p extensions
-          curl -sL -o /tmp/nopecha.zip https://github.com/NopeCHALLC/nopecha-extension/releases/latest/download/chromium_automation.zip
-          unzip -qo /tmp/nopecha.zip -d extensions/nopecha
-
-      - name: Run eval
-        working-directory: packages/browseros-agent/apps/eval
-        env:
-          FIREWORKS_API_KEY: ${{ secrets.FIREWORKS_API_KEY }}
-          CLAUDE_CODE_OAUTH_TOKEN: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
-          NOPECHA_API_KEY: ${{ secrets.NOPECHA_API_KEY }}
-          BROWSEROS_BINARY: /usr/bin/browseros
-          EVAL_CONFIG: ${{ github.event.inputs.config || 'configs/browseros-agent-weekly.json' }}
-        run: |
-          echo "Running eval with config: $EVAL_CONFIG"
-          xvfb-run --auto-servernum --server-args="-screen 0 1440x900x24" bun run src/index.ts -c "$EVAL_CONFIG"
-
-      - name: Upload runs to R2
-        if: success()
-        working-directory: packages/browseros-agent/apps/eval
-        env:
-          EVAL_R2_ACCOUNT_ID: ${{ secrets.EVAL_R2_ACCOUNT_ID }}
-          EVAL_R2_ACCESS_KEY_ID: ${{ secrets.EVAL_R2_ACCESS_KEY_ID }}
-          EVAL_R2_SECRET_ACCESS_KEY: ${{ secrets.EVAL_R2_SECRET_ACCESS_KEY }}
-          EVAL_R2_BUCKET: ${{ secrets.EVAL_R2_BUCKET }}
-          EVAL_R2_CDN_BASE_URL: ${{ secrets.EVAL_R2_CDN_BASE_URL }}
-          EVAL_CONFIG: ${{ github.event.inputs.config || 'configs/browseros-agent-weekly.json' }}
-        run: |
-          CONFIG_NAME=$(basename "$EVAL_CONFIG" .json)
-          bun scripts/upload-run.ts "results/$CONFIG_NAME"
-
-      - name: Generate trend report
-        if: success()
-        working-directory: packages/browseros-agent
-        env:
-          EVAL_R2_ACCOUNT_ID: ${{ secrets.EVAL_R2_ACCOUNT_ID }}
-          EVAL_R2_ACCESS_KEY_ID: ${{ secrets.EVAL_R2_ACCESS_KEY_ID }}
-          EVAL_R2_SECRET_ACCESS_KEY: ${{ secrets.EVAL_R2_SECRET_ACCESS_KEY }}
-          EVAL_R2_BUCKET: ${{ secrets.EVAL_R2_BUCKET }}
-          EVAL_R2_CDN_BASE_URL: ${{ secrets.EVAL_R2_CDN_BASE_URL }}
-        run: bun apps/eval/scripts/weekly-report.ts /tmp/eval-report.html
-
-      - name: Upload report as artifact
-        if: success()
-        uses: actions/upload-artifact@v4
-        with:
-          name: eval-report-${{ github.run_id }}
-          path: /tmp/eval-report.html

.github/workflows/release-agent-extension.yml

@@ -1,148 +0,0 @@
-name: Release BrowserOS Extension
-
-on:
-  workflow_dispatch:
-
-concurrency:
-  group: release-agent-extension
-  cancel-in-progress: false
-
-jobs:
-  release:
-    if: github.ref == 'refs/heads/main'
-    runs-on: ubuntu-latest
-    permissions:
-      contents: write
-      pull-requests: write
-    defaults:
-      run:
-        working-directory: packages/browseros-agent/apps/agent
-
-    steps:
-      - uses: actions/checkout@v6
-        with:
-          fetch-depth: 0
-
-      - uses: oven-sh/setup-bun@v2
-
-      - name: Install dependencies
-        run: bun ci
-        working-directory: packages/browseros-agent
-
-      - name: Build and zip extension
-        run: bun run codegen && bun run zip
-        env:
-          VITE_PUBLIC_BROWSEROS_API: https://api.browseros.com
-
-      - name: Get version and zip path
-        id: version
-        run: |
-          echo "version=$(node -p "require('./package.json').version")" >> "$GITHUB_OUTPUT"
-          echo "release_sha=$(git rev-parse HEAD)" >> "$GITHUB_OUTPUT"
-          ZIP_FILE=$(ls "$(pwd)/dist/"*-chrome.zip | head -n 1)
-          echo "zip_path=$ZIP_FILE" >> "$GITHUB_OUTPUT"
-          echo "zip_name=$(basename "$ZIP_FILE")" >> "$GITHUB_OUTPUT"
-
-      - name: Generate release notes
-        env:
-          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-        run: |
-          AGENT_PATH="packages/browseros-agent/apps/agent"
-          CURRENT_TAG="agent-extension-v${{ steps.version.outputs.version }}"
-          PREV_TAG=$(git tag -l "agent-extension-v*" --sort=-v:refname | grep -v "^${CURRENT_TAG}$" | head -n 1)
-
-          if [ -z "$PREV_TAG" ]; then
-            echo "Initial release" > /tmp/release-notes.md
-          else
-            COMMITS=$(git log "$PREV_TAG"..HEAD --pretty=format:"%H" -- "$AGENT_PATH")
-
-            if [ -z "$COMMITS" ]; then
-              echo "No notable changes." > /tmp/release-notes.md
-            else
-              echo "## What's Changed" > /tmp/release-notes.md
-              echo "" >> /tmp/release-notes.md
-
-              while IFS= read -r SHA; do
-                SUBJECT=$(git log -1 --pretty=format:"%s" "$SHA")
-                PR_NUM=$(gh api "/repos/${{ github.repository }}/commits/${SHA}/pulls" --jq '.[0].number // empty' 2>/dev/null)
-
-                # Skip PR number if already in the commit subject (squash merges include it)
-                if [ -n "$PR_NUM" ] && ! echo "$SUBJECT" | grep -qF "(#${PR_NUM})"; then
-                  echo "- ${SUBJECT} (#${PR_NUM})" >> /tmp/release-notes.md
-                else
-                  echo "- ${SUBJECT}" >> /tmp/release-notes.md
-                fi
-              done <<< "$COMMITS"
-            fi
-          fi
-        working-directory: ${{ github.workspace }}
-
-      - name: Create GitHub release
-        env:
-          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-        run: |
-          TAG="agent-extension-v${{ steps.version.outputs.version }}"
-          RELEASE_SHA="${{ steps.version.outputs.release_sha }}"
-          TITLE="BrowserOS Extension - v${{ steps.version.outputs.version }}"
-
-          if git rev-parse "$TAG" >/dev/null 2>&1; then
-            echo "Tag $TAG already exists, skipping tag creation"
-          else
-            git tag "$TAG" "$RELEASE_SHA"
-          fi
-
-          if git ls-remote --tags origin "$TAG" | grep -q "$TAG"; then
-            echo "Tag $TAG already on remote, skipping push"
-          else
-            git push origin "$TAG"
-          fi
-
-          if gh release view "$TAG" >/dev/null 2>&1; then
-            echo "Release $TAG already exists, updating"
-            gh release edit "$TAG" --title "$TITLE" --notes-file /tmp/release-notes.md
-            gh release upload "$TAG" "${{ steps.version.outputs.zip_path }}" --clobber
-          else
-            gh release create "$TAG" \
-              --title "$TITLE" \
-              --notes-file /tmp/release-notes.md \
-              "${{ steps.version.outputs.zip_path }}"
-          fi
-        working-directory: ${{ github.workspace }}
-
-      - name: Update CHANGELOG.md via PR
-        env:
-          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-        run: |
-          VERSION="${{ steps.version.outputs.version }}"
-          DATE=$(date -u +"%Y-%m-%d")
-          BRANCH="docs/agent-extension-changelog-v${VERSION}"
-          CHANGELOG="packages/browseros-agent/apps/agent/CHANGELOG.md"
-
-          git checkout main
-
-          {
-            head -n 1 "$CHANGELOG"
-            echo ""
-            echo "## v${VERSION} (${DATE})"
-            echo ""
-            cat /tmp/release-notes.md
-            echo ""
-            tail -n +2 "$CHANGELOG"
-          } > /tmp/new-changelog.md
-          mv /tmp/new-changelog.md "$CHANGELOG"
-
-          git config user.name "github-actions[bot]"
-          git config user.email "github-actions[bot]@users.noreply.github.com"
-          git checkout -b "$BRANCH"
-          git add "$CHANGELOG"
-          git commit -m "docs: update agent extension changelog for v${VERSION}"
-          git push origin "$BRANCH"
-
-          gh pr create \
-            --title "docs: update agent extension changelog for v${VERSION}" \
-            --body "Auto-generated changelog update for BrowserOS Extension v${VERSION}." \
-            --base main \
-            --head "$BRANCH"
-
-          gh pr merge "$BRANCH" --squash --auto || true
-        working-directory: ${{ github.workspace }}

.github/workflows/release-agent-sdk.yml

@@ -1,168 +0,0 @@
-name: Release BrowserOS Agent SDK
-
-on:
-  workflow_dispatch:
-
-concurrency:
-  group: release-agent-sdk
-  cancel-in-progress: false
-
-jobs:
-  publish:
-    if: github.ref == 'refs/heads/main'
-    runs-on: ubuntu-latest
-    permissions:
-      contents: write
-      pull-requests: write
-    defaults:
-      run:
-        working-directory: packages/browseros-agent/packages/agent-sdk
-
-    steps:
-      - uses: actions/checkout@v6
-        with:
-          fetch-depth: 0
-
-      - uses: oven-sh/setup-bun@v2
-
-      - uses: actions/setup-node@v6
-        with:
-          node-version: "20"
-          registry-url: "https://registry.npmjs.org"
-
-      - name: Install dependencies
-        run: bun ci
-        working-directory: packages/browseros-agent
-
-      - name: Build
-        run: bun run build
-
-      - name: Test
-        run: bun test
-
-      - name: Get version
-        id: version
-        run: |
-          echo "version=$(node -p "require('./package.json').version")" >> "$GITHUB_OUTPUT"
-          echo "release_sha=$(git rev-parse HEAD)" >> "$GITHUB_OUTPUT"
-
-      - name: Generate release notes
-        env:
-          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-        run: |
-          SDK_PATH="packages/browseros-agent/packages/agent-sdk"
-          CURRENT_TAG="agent-sdk-v${{ steps.version.outputs.version }}"
-          # Find the previous tag, excluding the current version's tag
-          # (which may already exist from a prior failed run)
-          PREV_TAG=$(git tag -l "agent-sdk-v*" --sort=-v:refname | grep -v "^${CURRENT_TAG}$" | head -n 1)
-
-          if [ -z "$PREV_TAG" ]; then
-            echo "Initial release" > /tmp/release-notes.md
-          else
-            # Get commits scoped to the SDK directory
-            COMMITS=$(git log "$PREV_TAG"..HEAD --pretty=format:"%H" -- "$SDK_PATH")
-
-            if [ -z "$COMMITS" ]; then
-              echo "No notable changes." > /tmp/release-notes.md
-            else
-              echo "## What's Changed" > /tmp/release-notes.md
-              echo "" >> /tmp/release-notes.md
-
-              # For each commit, find the associated PR and format with author
-              CONTRIBUTORS=""
-              while IFS= read -r SHA; do
-                # Get commit subject and author
-                SUBJECT=$(git log -1 --pretty=format:"%s" "$SHA")
-                AUTHOR=$(git log -1 --pretty=format:"%an" "$SHA")
-                GITHUB_USER=$(gh api "/repos/${{ github.repository }}/commits/${SHA}" --jq '.author.login // empty' 2>/dev/null)
-
-                # Find associated PR number
-                PR_NUM=$(gh api "/repos/${{ github.repository }}/commits/${SHA}/pulls" --jq '.[0].number // empty' 2>/dev/null)
-
-                # Format line: skip PR number if already in the commit subject
-                # (squash merges include "(#123)" in the subject automatically)
-                if [ -n "$PR_NUM" ] && ! echo "$SUBJECT" | grep -qF "(#${PR_NUM})"; then
-                  echo "- ${SUBJECT} (#${PR_NUM})" >> /tmp/release-notes.md
-                else
-                  echo "- ${SUBJECT}" >> /tmp/release-notes.md
-                fi
-              done <<< "$COMMITS"
-            fi
-          fi
-        working-directory: ${{ github.workspace }}
-
-      - name: Publish
-        run: npm publish --access public
-        env:
-          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
-
-      - name: Create GitHub release
-        env:
-          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-        run: |
-          TAG="agent-sdk-v${{ steps.version.outputs.version }}"
-          RELEASE_SHA="${{ steps.version.outputs.release_sha }}"
-          TITLE="BrowserOS Agent SDK - v${{ steps.version.outputs.version }}"
-
-          # Create or reuse tag (idempotent for re-runs)
-          if git rev-parse "$TAG" >/dev/null 2>&1; then
-            echo "Tag $TAG already exists, skipping tag creation"
-          else
-            git tag "$TAG" "$RELEASE_SHA"
-          fi
-
-          # Push tag (skip if already on remote)
-          if git ls-remote --tags origin "$TAG" | grep -q "$TAG"; then
-            echo "Tag $TAG already on remote, skipping push"
-          else
-            git push origin "$TAG"
-          fi
-
-          # Create or update release
-          if gh release view "$TAG" >/dev/null 2>&1; then
-            echo "Release $TAG already exists, updating"
-            gh release edit "$TAG" --title "$TITLE" --notes-file /tmp/release-notes.md
-          else
-            gh release create "$TAG" --title "$TITLE" --notes-file /tmp/release-notes.md
-          fi
-        working-directory: ${{ github.workspace }}
-
-      - name: Update CHANGELOG.md via PR
-        env:
-          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-        run: |
-          VERSION="${{ steps.version.outputs.version }}"
-          DATE=$(date -u +"%Y-%m-%d")
-          BRANCH="docs/agent-sdk-changelog-v${VERSION}"
-          CHANGELOG="packages/browseros-agent/packages/agent-sdk/CHANGELOG.md"
-
-          # Return to main before branching
-          git checkout main
-
-          # Use head/tail to safely insert without sed quoting issues
-          {
-            head -n 1 "$CHANGELOG"
-            echo ""
-            echo "## v${VERSION} (${DATE})"
-            echo ""
-            cat /tmp/release-notes.md
-            echo ""
-            tail -n +2 "$CHANGELOG"
-          } > /tmp/new-changelog.md
-          mv /tmp/new-changelog.md "$CHANGELOG"
-
-          git config user.name "github-actions[bot]"
-          git config user.email "github-actions[bot]@users.noreply.github.com"
-          git checkout -b "$BRANCH"
-          git add "$CHANGELOG"
-          git commit -m "docs: update agent-sdk changelog for v${VERSION}"
-          git push origin "$BRANCH"
-
-          gh pr create \
-            --title "docs: update agent-sdk changelog for v${VERSION}" \
-            --body "Auto-generated changelog update for BrowserOS Agent SDK v${VERSION}." \
-            --base main \
-            --head "$BRANCH"
-
-          gh pr merge "$BRANCH" --squash --auto || true
-        working-directory: ${{ github.workspace }}

.github/workflows/release-cli.yml

@@ -1,161 +0,0 @@
-name: Release BrowserOS CLI
-
-on:
-  workflow_dispatch:
-    inputs:
-      version:
-        description: "Release version (e.g. 0.1.0)"
-        required: true
-        type: string
-
-concurrency:
-  group: release-cli
-  cancel-in-progress: false
-
-jobs:
-  release:
-    if: github.ref == 'refs/heads/main'
-    runs-on: ubuntu-latest
-    environment: release-core
-    permissions:
-      contents: write
-      pull-requests: write
-    defaults:
-      run:
-        working-directory: packages/browseros-agent/apps/cli
-
-    steps:
-      - uses: actions/checkout@v6
-        with:
-          fetch-depth: 0
-
-      - uses: actions/setup-go@v5
-        with:
-          go-version-file: packages/browseros-agent/apps/cli/go.mod
-
-      - uses: oven-sh/setup-bun@v2
-        with:
-          bun-version: "1.3.6"
-
-      - name: Run tests
-        run: make test
-
-      - name: Run vet
-        run: make vet
-
-      - name: Build all platforms
-        run: make release VERSION=${{ inputs.version }} POSTHOG_API_KEY=${{ secrets.POSTHOG_API_KEY }}
-
-      - name: Install dependencies
-        run: bun install
-        working-directory: packages/browseros-agent
-
-      - name: Upload to CDN
-        env:
-          R2_ACCOUNT_ID: ${{ secrets.R2_ACCOUNT_ID }}
-          R2_ACCESS_KEY_ID: ${{ secrets.R2_ACCESS_KEY_ID }}
-          R2_SECRET_ACCESS_KEY: ${{ secrets.R2_SECRET_ACCESS_KEY }}
-          R2_BUCKET: ${{ secrets.R2_BUCKET }}
-          R2_UPLOAD_PREFIX: cli
-          CLI_VERSION: ${{ inputs.version }}
-        run: |
-          bun scripts/build/cli.ts \
-            --release \
-            --version "$CLI_VERSION" \
-            --binaries-dir apps/cli/dist
-        working-directory: packages/browseros-agent
-
-      - name: Generate release notes
-        env:
-          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-        run: |
-          CLI_PATH="packages/browseros-agent/apps/cli"
-          TAG="browseros-cli-v${{ inputs.version }}"
-          CHANGELOG_FILE="/tmp/release-changelog.md"
-          PREV_TAG=$(git tag -l "browseros-cli-v*" --sort=-v:refname | grep -v "^${TAG}$" | head -n 1)
-
-          if [ -z "$PREV_TAG" ]; then
-            echo "Initial release of browseros-cli." > "$CHANGELOG_FILE"
-          else
-            COMMITS=$(git log "$PREV_TAG"..HEAD --pretty=format:"%H" -- "$CLI_PATH")
-
-            if [ -z "$COMMITS" ]; then
-              echo "No notable changes." > "$CHANGELOG_FILE"
-            else
-              echo "## What's Changed" > "$CHANGELOG_FILE"
-              echo "" >> "$CHANGELOG_FILE"
-
-              while IFS= read -r SHA; do
-                SUBJECT=$(git log -1 --pretty=format:"%s" "$SHA")
-                PR_NUM=$(gh api "/repos/${{ github.repository }}/commits/${SHA}/pulls" --jq '.[0].number // empty' 2>/dev/null)
-
-                if [ -n "$PR_NUM" ] && ! echo "$SUBJECT" | grep -qF "(#${PR_NUM})"; then
-                  echo "- ${SUBJECT} (#${PR_NUM})" >> "$CHANGELOG_FILE"
-                else
-                  echo "- ${SUBJECT}" >> "$CHANGELOG_FILE"
-                fi
-              done <<< "$COMMITS"
-            fi
-          fi
-
-          cat "$CHANGELOG_FILE" > /tmp/release-notes.md
-          cat >> /tmp/release-notes.md <<'EOF'
-
-          ## Install `browseros-cli`
-
-          ### npm / npx
-
-          ```bash
-          npx browseros-cli --help
-          npm install -g browseros-cli
-          ```
-
-          ### macOS / Linux
-
-          ```bash
-          curl -fsSL https://cdn.browseros.com/cli/install.sh | bash
-          ```
-
-          ### Windows
-
-          ```powershell
-          irm https://cdn.browseros.com/cli/install.ps1 | iex
-          ```
-
-          After install, run `browseros-cli init` to point the CLI at your BrowserOS MCP server.
-          EOF
-        working-directory: ${{ github.workspace }}
-
-      - name: Create tag and release
-        env:
-          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-        run: |
-          TAG="browseros-cli-v${{ inputs.version }}"
-          git config user.name "github-actions[bot]"
-          git config user.email "github-actions[bot]@users.noreply.github.com"
-
-          if ! git rev-parse "$TAG" >/dev/null 2>&1; then
-            git tag -a "$TAG" -m "browseros-cli v${{ inputs.version }}"
-            git push origin "$TAG"
-          fi
-
-          CLI_DIST="packages/browseros-agent/apps/cli/dist"
-          gh release create "$TAG" \
-            --title "BrowserOS CLI - v${{ inputs.version }}" \
-            --notes-file /tmp/release-notes.md \
-            ${CLI_DIST}/*
-        working-directory: ${{ github.workspace }}
-
-      - name: Setup Node.js
-        uses: actions/setup-node@v4
-        with:
-          node-version: "20"
-          registry-url: "https://registry.npmjs.org"
-
-      - name: Publish to npm
-        env:
-          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
-        run: |
-          make npm-version VERSION=${{ inputs.version }}
-          cd npm
-          npm publish --access public

.github/workflows/release-server.yml

@@ -1,147 +0,0 @@
-name: Release BrowserOS Server
-
-on:
-  workflow_dispatch:
-    inputs:
-      version:
-        description: "Release version (e.g. 0.0.80)"
-        required: true
-        type: string
-
-concurrency:
-  group: release-server
-  cancel-in-progress: false
-
-jobs:
-  release:
-    if: github.ref == 'refs/heads/main'
-    runs-on: ubuntu-latest
-    environment: release-core
-    permissions:
-      contents: write
-    defaults:
-      run:
-        working-directory: packages/browseros-agent
-
-    steps:
-      - uses: actions/checkout@v6
-        with:
-          fetch-depth: 0
-
-      - uses: oven-sh/setup-bun@v2
-        with:
-          bun-version: "1.3.6"
-
-      - name: Install dependencies
-        run: bun ci
-
-      - name: Prepare production env file
-        run: cp apps/server/.env.production.example apps/server/.env.production
-
-      - name: Validate version
-        id: version
-        env:
-          REQUESTED_VERSION: ${{ inputs.version }}
-        run: |
-          PACKAGE_VERSION=$(node -p "require('./apps/server/package.json').version")
-          echo "package_version=$PACKAGE_VERSION" >> "$GITHUB_OUTPUT"
-          echo "release_sha=$(git rev-parse HEAD)" >> "$GITHUB_OUTPUT"
-
-          if [ "$PACKAGE_VERSION" != "$REQUESTED_VERSION" ]; then
-            echo "Requested version $REQUESTED_VERSION does not match apps/server/package.json ($PACKAGE_VERSION)"
-            exit 1
-          fi
-
-      - name: Build release artifacts
-        run: bun run build:server:ci
-
-      - name: Verify release artifacts
-        run: |
-          mapfile -t ZIP_FILES < <(find dist/prod/server -maxdepth 1 -type f -name 'browseros-server-resources-*.zip' | sort)
-
-          if [ "${#ZIP_FILES[@]}" -eq 0 ]; then
-            echo "No server release zip files were produced"
-            exit 1
-          fi
-
-          printf 'Found release artifacts:\n%s\n' "${ZIP_FILES[@]}"
-
-      - name: Generate release notes
-        env:
-          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-          PACKAGE_VERSION: ${{ steps.version.outputs.package_version }}
-        run: |
-          SERVER_APP_PATH="packages/browseros-agent/apps/server"
-          SERVER_BUILD_DIR="packages/browseros-agent/scripts/build/server"
-          SERVER_BUILD_ENTRY="packages/browseros-agent/scripts/build/server.ts"
-          SERVER_RESOURCE_MANIFEST="packages/browseros-agent/scripts/build/config/server-prod-resources.json"
-          SERVER_WORKSPACE_PKG="packages/browseros-agent/package.json"
-          CURRENT_TAG="browseros-server-v$PACKAGE_VERSION"
-          PREV_TAG=$(git tag -l "browseros-server-v*" --sort=-v:refname | grep -v "^${CURRENT_TAG}$" | head -n 1)
-
-          if [ -z "$PREV_TAG" ]; then
-            echo "Initial release of browseros-server." > /tmp/release-notes.md
-          else
-            COMMITS=$(git log "$PREV_TAG"..HEAD --pretty=format:"%H" -- \
-              "$SERVER_APP_PATH" \
-              "$SERVER_BUILD_DIR" \
-              "$SERVER_BUILD_ENTRY" \
-              "$SERVER_RESOURCE_MANIFEST" \
-              "$SERVER_WORKSPACE_PKG")
-
-            if [ -z "$COMMITS" ]; then
-              echo "No notable changes." > /tmp/release-notes.md
-            else
-              echo "## What's Changed" > /tmp/release-notes.md
-              echo "" >> /tmp/release-notes.md
-
-              while IFS= read -r SHA; do
-                SUBJECT=$(git log -1 --pretty=format:"%s" "$SHA")
-                PR_NUM=$(gh api "/repos/${{ github.repository }}/commits/${SHA}/pulls" --jq '.[0].number // empty' 2>/dev/null)
-
-                if [ -n "$PR_NUM" ] && ! echo "$SUBJECT" | grep -qF "(#${PR_NUM})"; then
-                  echo "- ${SUBJECT} (#${PR_NUM})" >> /tmp/release-notes.md
-                else
-                  echo "- ${SUBJECT}" >> /tmp/release-notes.md
-                fi
-              done <<< "$COMMITS"
-            fi
-          fi
-        working-directory: ${{ github.workspace }}
-
-      - name: Create GitHub release
-        env:
-          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-          PACKAGE_VERSION: ${{ steps.version.outputs.package_version }}
-          RELEASE_SHA: ${{ steps.version.outputs.release_sha }}
-        run: |
-          TAG="browseros-server-v$PACKAGE_VERSION"
-          TITLE="BrowserOS Server - v$PACKAGE_VERSION"
-          mapfile -t ZIP_FILES < <(find packages/browseros-agent/dist/prod/server -maxdepth 1 -type f -name 'browseros-server-resources-*.zip' | sort)
-
-          git config user.name "github-actions[bot]"
-          git config user.email "github-actions[bot]@users.noreply.github.com"
-
-          if git rev-parse "$TAG" >/dev/null 2>&1; then
-            echo "Tag $TAG already exists, skipping tag creation"
-          else
-            git tag -a "$TAG" -m "browseros-server v$PACKAGE_VERSION" "$RELEASE_SHA"
-          fi
-
-          if git ls-remote --tags origin "$TAG" | grep -q "$TAG"; then
-            echo "Tag $TAG already on remote, skipping push"
-          else
-            git push origin "$TAG"
-          fi
-
-          if gh release view "$TAG" >/dev/null 2>&1; then
-            echo "Release $TAG already exists, updating"
-            gh release edit "$TAG" --title "$TITLE" --notes-file /tmp/release-notes.md
-            gh release upload "$TAG" "${ZIP_FILES[@]}" --clobber
-          else
-            gh release create "$TAG" \
-              --title "$TITLE" \
-              --notes-file /tmp/release-notes.md \
-              "${ZIP_FILES[@]}"
-          fi
-        working-directory: ${{ github.workspace }}

.github/workflows/test.yml

@@ -1,141 +0,0 @@
-name: Tests
-
-on:
-  pull_request:
-    types:
-      - opened
-      - synchronize
-      - reopened
-      - ready_for_review
-    paths:
-      - .github/workflows/test.yml
-      - packages/browseros-agent/**
-  workflow_dispatch:
-
-permissions:
-  contents: read
-
-env:
-  BROWSEROS_APPIMAGE_URL: https://files.browseros.com/download/BrowserOS.AppImage
-
-jobs:
-  test:
-    name: Tests / ${{ matrix.suite }}
-    runs-on: ubuntu-latest
-    timeout-minutes: 20
-    defaults:
-      run:
-        working-directory: packages/browseros-agent
-    strategy:
-      fail-fast: false
-      matrix:
-        include:
-          - suite: tools
-            test_path: tests/tools
-            junit_path: test-results/tools.xml
-          - suite: integration
-            test_path: tests/server.integration.test.ts
-            junit_path: test-results/integration.xml
-          - suite: sdk
-            test_path: tests/sdk
-            junit_path: test-results/sdk.xml
-
-    steps:
-      - name: Checkout code
-        uses: actions/checkout@v6
-
-      - name: Setup Bun
-        uses: oven-sh/setup-bun@v2
-
-      - name: Install dependencies
-        run: bun ci
-
-      - name: Resolve BrowserOS cache key
-        id: browseros-cache-key
-        run: |
-          set -euo pipefail
-          headers="$(curl -fsSI "$BROWSEROS_APPIMAGE_URL")"
-          etag="$(printf '%s\n' "$headers" | awk 'BEGIN{IGNORECASE=1} /^etag:/ {sub(/\r$/, "", $2); gsub(/"/, "", $2); print $2; exit}')"
-          last_modified="$(printf '%s\n' "$headers" | awk 'BEGIN{IGNORECASE=1} /^last-modified:/ {$1=""; sub(/^ /, ""); sub(/\r$/, ""); print; exit}')"
-          raw_key="${etag:-$last_modified}"
-          if [ -z "$raw_key" ]; then
-            raw_key="$BROWSEROS_APPIMAGE_URL"
-          fi
-          cache_key="$(printf '%s' "$raw_key" | shasum -a 256 | awk '{print $1}')"
-          echo "key=browseros-appimage-${{ runner.os }}-$cache_key" >> "$GITHUB_OUTPUT"
-
-      - name: Restore BrowserOS cache
-        id: browseros-cache
-        uses: actions/cache@v4
-        with:
-          path: packages/browseros-agent/.ci/bin/BrowserOS.AppImage
-          key: ${{ steps.browseros-cache-key.outputs.key }}
-
-      - name: Download BrowserOS
-        if: steps.browseros-cache.outputs.cache-hit != 'true'
-        run: |
-          mkdir -p .ci/bin
-          curl -fsSL "$BROWSEROS_APPIMAGE_URL" -o .ci/bin/BrowserOS.AppImage
-          chmod +x .ci/bin/BrowserOS.AppImage
-
-      - name: Prepare BrowserOS wrapper
-        run: |
-          mkdir -p .ci/bin
-          cat > .ci/bin/browseros <<'EOF'
-          #!/usr/bin/env bash
-          set -euo pipefail
-          export APPIMAGE_EXTRACT_AND_RUN=1
-          exec "$(dirname "$0")/BrowserOS.AppImage" "$@"
-          EOF
-          chmod +x .ci/bin/browseros
-
-      - name: Create server env file
-        working-directory: packages/browseros-agent/apps/server
-        run: cp .env.example .env.development
-
-      - name: Run ${{ matrix.suite }} tests
-        id: test
-        env:
-          BROWSEROS_BINARY: ${{ github.workspace }}/packages/browseros-agent/.ci/bin/browseros
-          BROWSEROS_TEST_HEADLESS: "true"
-          BROWSEROS_TEST_EXTRA_ARGS: --no-sandbox --disable-dev-shm-usage
-        run: |
-          set +e
-          mkdir -p test-results
-          cd apps/server
-          bun run test:cleanup
-          bun --env-file=.env.development test "${{ matrix.test_path }}" --reporter=junit --reporter-outfile="../../${{ matrix.junit_path }}"
-          exit_code=$?
-          cd ../..
-          if [ ! -f "${{ matrix.junit_path }}" ]; then
-            cat > "${{ matrix.junit_path }}" <<EOF
-          <?xml version="1.0" encoding="UTF-8"?>
-          <testsuites tests="1" failures="1">
-            <testsuite name="${{ matrix.suite }}" tests="1" failures="1">
-              <testcase classname="workflow" name="${{ matrix.suite }} setup">
-                <failure message="Test run failed before JUnit output was written">See workflow logs for details.</failure>
-              </testcase>
-            </testsuite>
-          </testsuites>
-          EOF
-          fi
-          echo "exit_code=$exit_code" >> "$GITHUB_OUTPUT"
-
-      - name: Upload JUnit XML
-        if: always()
-        uses: actions/upload-artifact@v4
-        with:
-          name: junit-${{ matrix.suite }}
-          path: packages/browseros-agent/${{ matrix.junit_path }}
-
-      - name: Summarize suite result
-        if: always()
-        run: |
-          if [ "${{ steps.test.outputs.exit_code }}" = "0" ]; then
-            echo "### :white_check_mark: ${{ matrix.suite }} suite passed" >> "$GITHUB_STEP_SUMMARY"
-          else
-            echo "### :x: ${{ matrix.suite }} suite failed (exit code ${{ steps.test.outputs.exit_code }})" >> "$GITHUB_STEP_SUMMARY"
-            echo "" >> "$GITHUB_STEP_SUMMARY"
-            echo "See the uploaded \`junit-${{ matrix.suite }}\` artifact for details." >> "$GITHUB_STEP_SUMMARY"
-            exit 1
-          fi

.gitignore

@@ -23,11 +23,6 @@ nxtscape-cli-access.json
 gclient.json
 .env
 .grove/
-AGENTS.md
 **/resources/binaries/
 
 packages/browseros/build/tools/
-
-# AI SDK DevTools traces
-.devtools/
-.omc/

.vscode/settings.json

@@ -1,4 +0,0 @@
-{
-  "terminal.integrated.tabs.title": "${sequence} ${process}",
-  "terminal.integrated.tabs.description": "${cwd}"
-}

README.md

@@ -6,7 +6,6 @@
 [![Slack](https://img.shields.io/badge/Slack-Join%20us-4A154B?logo=slack&logoColor=white)](https://dub.sh/browserOS-slack)
 [![Twitter](https://img.shields.io/twitter/follow/browserOS_ai?style=social)](https://twitter.com/browseros_ai)
 [![License: AGPL v3](https://img.shields.io/badge/License-AGPL%20v3-blue.svg)](LICENSE)
-[![Docs](https://img.shields.io/badge/Docs-docs.browseros.com-blue)](https://docs.browseros.com)
 <br></br>
 <a href="https://files.browseros.com/download/BrowserOS.dmg">
   <img src="https://img.shields.io/badge/Download-macOS-black?style=flat&logo=apple&logoColor=white" alt="Download for macOS (beta)" />
@@ -23,183 +22,146 @@
 <br />
 </div>
 
-BrowserOS is an open-source Chromium fork that runs AI agents natively. **The privacy-first alternative to ChatGPT Atlas, Perplexity Comet, and Dia.**
+##
+🌐 BrowserOS is an open-source Chromium fork that runs AI agents natively. **The privacy-first alternative to ChatGPT Atlas, Perplexity Comet, and Dia.**
 
-Use your own API keys or run local models with Ollama. Your data never leaves your machine.
+🔒 Use your own API keys or run local models with Ollama. Your data never leaves your machine.
 
-> **[Documentation](https://docs.browseros.com)** · **[Discord](https://discord.gg/YKwjt5vuKr)** · **[Slack](https://dub.sh/browserOS-slack)** · **[Twitter](https://x.com/browserOS_ai)** · **[Feature Requests](https://github.com/browseros-ai/BrowserOS/issues/99)**
+💡 Join our [Discord](https://discord.gg/YKwjt5vuKr) or [Slack](https://dub.sh/browserOS-slack) and help us build! Have feature requests? [Suggest here](https://github.com/browseros-ai/BrowserOS/issues/99).
 
-## Quick Start
+## Quick start
 
-1. **Download and install** BrowserOS — [macOS](https://files.browseros.com/download/BrowserOS.dmg) · [Windows](https://files.browseros.com/download/BrowserOS_installer.exe) · [Linux (AppImage)](https://files.browseros.com/download/BrowserOS.AppImage) · [Linux (Debian)](https://cdn.browseros.com/download/BrowserOS.deb)
-2. **Import your Chrome data** (optional) — bookmarks, passwords, extensions all carry over
-3. **Connect your AI provider** — Claude, OpenAI, Gemini, ChatGPT Pro via OAuth, or local models via Ollama/LM Studio
+1. Download and install BrowserOS:
+   - [macOS](https://files.browseros.com/download/BrowserOS.dmg)
+   - [Windows](https://files.browseros.com/download/BrowserOS_installer.exe)
+   - [Linux (AppImage)](https://files.browseros.com/download/BrowserOS.AppImage)
+   - [Linux (Debian)](https://cdn.browseros.com/download/BrowserOS.deb)
 
-## Features
+2. Import your Chrome data (optional)
 
-| Feature | Description | Docs |
-|---------|-------------|------|
-| **AI Agent** | 53+ browser automation tools — navigate, click, type, extract data, all with natural language | [Guide](https://docs.browseros.com/getting-started) |
-| **MCP Server** | Control the browser from Claude Code, Gemini CLI, or any MCP client | [Setup](https://docs.browseros.com/features/use-with-claude-code) |
-| **Workflows** | Build repeatable browser automations with a visual graph builder | [Docs](https://docs.browseros.com/features/workflows) |
-| **Cowork** | Combine browser automation with local file operations — research the web, save reports to your folder | [Docs](https://docs.browseros.com/features/cowork) |
-| **Scheduled Tasks** | Run agents on autopilot — daily, hourly, or every few minutes | [Docs](https://docs.browseros.com/features/scheduled-tasks) |
-| **Memory** | Persistent memory across conversations — your assistant remembers context over time | [Docs](https://docs.browseros.com/features/memory) |
-| **SOUL.md** | Define your AI's personality and instructions in a single markdown file | [Docs](https://docs.browseros.com/features/soul-md) |
-| **LLM Hub** | Compare Claude, ChatGPT, and Gemini responses side-by-side on any page | [Docs](https://docs.browseros.com/features/llm-chat-hub) |
-| **40+ App Integrations** | Gmail, Slack, GitHub, Linear, Notion, Figma, Salesforce, and more via MCP | [Docs](https://docs.browseros.com/features/connect-apps) |
-| **Vertical Tabs** | Side-panel tab management — stay organized even with 100+ tabs open | [Docs](https://docs.browseros.com/features/vertical-tabs) |
-| **Ad Blocking** | uBlock Origin + Manifest V2 support — [10x more protection](https://docs.browseros.com/features/ad-blocking) than Chrome | [Docs](https://docs.browseros.com/features/ad-blocking) |
-| **Cloud Sync** | Sync browser config and agent history across devices | [Docs](https://docs.browseros.com/features/sync) |
-| **Skills** | Custom instruction sets that shape how your AI assistant behaves | [Docs](https://docs.browseros.com/features/skills) |
-| **Smart Nudges** | Contextual suggestions to connect apps and use features at the right moment | [Docs](https://docs.browseros.com/features/smart-nudges) |
+3. Connect your AI provider — use Claude, OpenAI, Gemini, or local models via Ollama and LMStudio.
+
+4. Start automating!
+
+## What makes BrowserOS special
+- 🏠 Feels like home — same Chrome interface, all your extensions just work
+- 🤖 AI agents that run on YOUR browser, not in the cloud
+- 🔒 Privacy first — bring your own keys or run local models with Ollama. Your browsing history stays on your machine
+- 🤝 [BrowserOS as MCP server](https://docs.browseros.com/features/use-with-claude-code) — control the browser from `claude-code`, `gemini-cli`, or any MCP client (31 tools)
+- 🔄 [Workflows](https://docs.browseros.com/features/workflows) — build repeatable browser automations with a visual graph builder
+- 📂 [Cowork](https://docs.browseros.com/features/cowork) — combine browser automation with local file operations. Research the web, save reports to your folder
+- ⏰ [Scheduled Tasks](https://docs.browseros.com/features/scheduled-tasks) — run the agent on autopilot, daily or every few minutes
+- 💬 [LLM Hub](https://docs.browseros.com/features/llm-chat-hub) — compare Claude, ChatGPT, and Gemini side-by-side on any page
+- 🛡️ Built-in ad blocker — [10x more protection than Chrome](https://docs.browseros.com/features/ad-blocking) with uBlock Origin + Manifest V2 support
+- 🚀 100% open source under AGPL-3.0
 
 ## Demos
 
-### BrowserOS agent in action
+### 🤖 BrowserOS agent in action
 [![BrowserOS agent in action](docs/videos/browserOS-agent-in-action.gif)](https://www.youtube.com/watch?v=SoSFev5R5dI)
 <br/><br/>
 
-### Install [BrowserOS as MCP](https://docs.browseros.com/features/use-with-claude-code) and control it from `claude-code`
+### 🎇 Install [BrowserOS as MCP](https://docs.browseros.com/features/use-with-claude-code) and control it from `claude-code`
 
 https://github.com/user-attachments/assets/c725d6df-1a0d-40eb-a125-ea009bf664dc
 
 <br/><br/>
 
-### Use BrowserOS to chat
+### 💬 Use BrowserOS to chat
 
 https://github.com/user-attachments/assets/726803c5-8e36-420e-8694-c63a2607beca
 
 <br/><br/>
 
-### Use BrowserOS to scrape data
+### ⚡ Use BrowserOS to scrape data
 
 https://github.com/user-attachments/assets/9f038216-bc24-4555-abf1-af2adcb7ebc0
 
 <br/><br/>
 
-## Install `browseros-cli`
+## Why We're Building BrowserOS
 
-Use `browseros-cli` to launch and control BrowserOS from the terminal or from AI coding agents like Claude Code.
+For the first time since Netscape pioneered the web in 1994, AI gives us the chance to completely reimagine the browser. We've seen tools like Cursor deliver 10x productivity gains for developers—yet everyday browsing remains frustratingly archaic.
 
-**macOS / Linux:**
+You're likely juggling 70+ tabs, battling your browser instead of having it assist you. Routine tasks, like ordering something from amazon or filling a form should be handled seamlessly by AI agents.
 
-```bash
-curl -fsSL https://cdn.browseros.com/cli/install.sh | bash
-```
+At BrowserOS, we're convinced that AI should empower you by automating tasks locally and securely—keeping your data private. We are building the best browser for this future!
 
-**Windows:**
+## How we compare
 
-```powershell
-irm https://cdn.browseros.com/cli/install.ps1 | iex
-```
+<details>
+<summary><b>vs Chrome</b></summary>
+<br>
+While we're grateful for Google open-sourcing Chromium, but Chrome hasn't evolved much in 10 years. No AI features, no automation, no MCP support.
+</details>
 
-After install, run `browseros-cli init` to connect the CLI to your running BrowserOS instance.
+<details>
+<summary><b>vs Brave</b></summary>
+<br>
+We love what Brave started, but they've spread themselves too thin with crypto, search, VPNs. We're laser-focused on AI-powered browsing.
+</details>
 
-## LLM Providers
+<details>
+<summary><b>vs Arc/Dia</b></summary>
+<br>
+Many loved Arc, but it was closed source. When they abandoned users, there was no recourse. We're 100% open source - fork it anytime!
+</details>
 
-BrowserOS works with any LLM. Bring your own keys, use OAuth, or run models locally.
+<details>
+<summary><b>vs Perplexity Comet</b></summary>
+<br>
+They're a search/ad company. Your browser history becomes their product. We keep everything local.
+</details>
 
-| Provider | Type | Auth |
-|----------|------|------|
-| Kimi K2.5 | Cloud (default) | Built-in |
-| ChatGPT Pro/Plus | Cloud | [OAuth](https://docs.browseros.com/features/chatgpt) |
-| GitHub Copilot | Cloud | [OAuth](https://docs.browseros.com/features/github-copilot) |
-| Qwen Code | Cloud | [OAuth](https://docs.browseros.com/features/qwen-code) |
-| Claude (Anthropic) | Cloud | API key |
-| GPT-4o / o3 (OpenAI) | Cloud | API key |
-| Gemini (Google) | Cloud | API key |
-| Azure OpenAI | Cloud | API key |
-| AWS Bedrock | Cloud | IAM credentials |
-| OpenRouter | Cloud | API key |
-| Ollama | Local | [Setup](https://docs.browseros.com/features/ollama) |
-| LM Studio | Local | [Setup](https://docs.browseros.com/features/lm-studio) |
-
-## How We Compare
-
-| | BrowserOS | Chrome | Brave | Dia | Comet | Atlas |
-|---|:---:|:---:|:---:|:---:|:---:|:---:|
-| Open Source | ✅ | ❌ | ✅ | ❌ | ❌ | ❌ |
-| AI Agent | ✅ | ❌ | ❌ | ❌ | ✅ | ✅ |
-| MCP Server | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ |
-| Visual Workflows | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ |
-| Cowork (files + browser) | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ |
-| Scheduled Tasks | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ |
-| Bring Your Own Keys | ✅ | ❌ | ✅ | ❌ | ❌ | ❌ |
-| Local Models (Ollama) | ✅ | ❌ | ✅ | ❌ | ❌ | ❌ |
-| Local-first Privacy | ✅ | ❌ | ✅ | ❌ | ❌ | ❌ |
-| Ad Blocking (MV2) | ✅ | ❌ | ✅ | ❌ | ✅ | ❌ |
-
-**Detailed comparisons:**
-- [BrowserOS vs Chrome DevTools MCP](https://docs.browseros.com/comparisons/chrome-devtools-mcp) — developer-focused comparison for browser automation
-- [BrowserOS vs Claude Cowork](https://docs.browseros.com/comparisons/claude-cowork) — getting real work done with AI
-- [BrowserOS vs OpenClaw](https://docs.browseros.com/comparisons/openclaw) — everyday AI assistance
-
-## Architecture
-
-BrowserOS is a monorepo with two main subsystems: the **browser** (Chromium fork) and the **agent platform** (TypeScript/Go).
-
-```
-BrowserOS/
-├── packages/browseros/              # Chromium fork + build system (Python)
-│   ├── chromium_patches/            # Patches applied to Chromium source
-│   ├── build/                       # Build CLI and modules
-│   └── resources/                   # Icons, entitlements, signing
-│
-├── packages/browseros-agent/        # Agent platform (TypeScript/Go)
-│   ├── apps/
-│   │   ├── server/                  # MCP server + AI agent loop (Bun)
-│   │   ├── agent/                   # Browser extension UI (WXT + React)
-│   │   ├── cli/                     # CLI tool (Go)
-│   │   ├── eval/                    # Benchmark framework
-│   │   └── controller-ext/          # Chrome API bridge extension
-│   │
-│   └── packages/
-│       ├── agent-sdk/               # Node.js SDK (npm: @browseros-ai/agent-sdk)
-│       ├── cdp-protocol/            # CDP type bindings
-│       └── shared/                  # Shared constants
-```
-
-| Package | What it does |
-|---------|-------------|
-| [`packages/browseros`](packages/browseros/) | Chromium fork — patches, build system, signing |
-| [`apps/server`](packages/browseros-agent/apps/server/) | Bun server exposing 53+ MCP tools and running the AI agent loop |
-| [`apps/agent`](packages/browseros-agent/apps/agent/) | Browser extension — new tab, side panel chat, onboarding, settings |
-| [`apps/cli`](packages/browseros-agent/apps/cli/) | Go CLI — control BrowserOS from the terminal or AI coding agents |
-| [`apps/eval`](packages/browseros-agent/apps/eval/) | Benchmark framework — WebVoyager, Mind2Web evaluation |
-| [`agent-sdk`](packages/browseros-agent/packages/agent-sdk/) | Node.js SDK for browser automation with natural language |
-| [`cdp-protocol`](packages/browseros-agent/packages/cdp-protocol/) | Type-safe Chrome DevTools Protocol bindings |
+<details>
+<summary><b>vs ChatGPT Atlas</b></summary>
+<br>
+Your browsing data could be used for ads or to train their models. We keep your history and agent interactions strictly local.
+</details>
 
 ## Contributing
 
-We'd love your help making BrowserOS better! See our [Contributing Guide](CONTRIBUTING.md) for details.
+We'd love your help making BrowserOS better!
 
-- [Report bugs](https://github.com/browseros-ai/BrowserOS/issues)
-- [Suggest features](https://github.com/browseros-ai/BrowserOS/issues/99)
-- [Join Discord](https://discord.gg/YKwjt5vuKr) · [Join Slack](https://dub.sh/browserOS-slack)
-- [Follow on Twitter](https://x.com/browserOS_ai)
-
-**Agent development** (TypeScript/Go) — see the [agent monorepo README](packages/browseros-agent/README.md) for setup instructions.
-
-**Browser development** (C++/Python) — requires ~100GB disk space. See [`packages/browseros`](packages/browseros/) for build instructions.
-
-## Credits
-
-- [ungoogled-chromium](https://github.com/ungoogled-software/ungoogled-chromium) — BrowserOS uses some patches for enhanced privacy. Thanks to everyone behind this project!
-- [The Chromium Project](https://www.chromium.org/) — at the core of BrowserOS, making it possible to exist in the first place.
+- 🐛 [Report bugs](https://github.com/browseros-ai/BrowserOS/issues)
+- 💡 [Suggest features](https://github.com/browseros-ai/BrowserOS/issues/99)
+- 💬 [Join Discord](https://discord.gg/YKwjt5vuKr)
+- 🐦 [Follow on Twitter](https://x.com/browserOS_ai)
 
 ## License
 
 BrowserOS is open source under the [AGPL-3.0 license](LICENSE).
 
-Copyright &copy; 2026 Felafax, Inc.
+## Credits
+
+- [ungoogled-chromium](https://github.com/ungoogled-software/ungoogled-chromium) - BrowserOS uses some patches for enhanced privacy. Thanks to everyone behind this project!
+- [The Chromium Project](https://www.chromium.org/) - At the core of BrowserOS, making it possible to exist in the first place.
+
+## Citation
+
+If you use BrowserOS in your research or project, please cite:
+
+```bibtex
+@software{browseros2025,
+  author = {Sonti, Nithin and Sonti, Nikhil and {BrowserOS-team}},
+  title = {BrowserOS: The open-source Agentic browser},
+  url = {https://github.com/browseros-ai/BrowserOS},
+  year = {2025},
+  publisher = {GitHub},
+  license = {AGPL-3.0},
+}
+```
+
+Copyright &copy; 2025 Felafax, Inc.
 
 ## Stargazers
-
 Thank you to all our supporters!
 
 [![Star History Chart](https://api.star-history.com/svg?repos=browseros-ai/BrowserOS&type=Date)](https://www.star-history.com/#browseros-ai/BrowserOS&Date)
 
+## 
 <p align="center">
 Built with ❤️ from San Francisco
 </p>
+
+

docs/docs.json

@@ -23,9 +23,6 @@
         "group": "Core Features",
         "pages": [
           "features/bring-your-own-llm",
-          "features/chatgpt-pro-oauth",
-          "features/github-copilot-oauth",
-          "features/qwen-code-oauth",
           "features/local-models",
           "features/workflows",
           "features/scheduled-tasks",

docs/features/ad-blocking.mdx

@@ -3,17 +3,13 @@ title: "Ad Blocking"
 description: "BrowserOS supports full ad blocking with uBlock Origin"
 ---
 
-BrowserOS supports full ad blocking through [uBlock Origin](https://ublockorigin.com/), the most powerful open-source ad blocker available — the full extension, not the watered-down "Lite" version.
+BrowserOS supports full ad blocking through [uBlock Origin](https://ublockorigin.com/), the most effective open-source ad blocker available.
 
-## Why BrowserOS?
+## How It Works
 
-Chrome [killed support](https://developer.chrome.com/docs/extensions/develop/migrate/mv2-deprecation-timeline) for uBlock Origin by phasing out Manifest V2 extensions. The only option left on Chrome is "uBlock Origin Lite," a significantly weaker version that can't use advanced filtering rules.
+Chrome has been [phasing out support](https://developer.chrome.com/docs/extensions/develop/migrate/mv2-deprecation-timeline) for Manifest V2 extensions, which uBlock Origin relies on for its full blocking capabilities. We re-enabled Manifest V2 support in BrowserOS so uBlock Origin can run at full power.
 
-**BrowserOS re-enabled full Manifest V2 support**, so you can install and run the original uBlock Origin at full power — the same extension Chrome no longer allows.
-
-<Card title="Install uBlock Origin" icon="shield-check" href="https://chromewebstore.google.com/detail/ublock-origin/cjpalhdlnbpafiamejdnhcphjbkeiagm">
-  Install the full uBlock Origin extension from the Chrome Web Store. Works on BrowserOS out of the box.
-</Card>
+Install it from the Chrome Web Store: [uBlock Origin](https://chromewebstore.google.com/detail/ublock-origin/cjpalhdlnbpafiamejdnhcphjbkeiagm)
 
 ## BrowserOS vs Chrome
 

docs/features/bring-your-own-llm.mdx

@@ -13,33 +13,6 @@ See how to connect your own LLM in under a minute:
   src="https://pub-80f8a01e6e8b4239ae53a7652ef85877.r2.dev/resources/feature-videos/1-bring-your-own-LLM.mov"
 ></video>
 
-## Use Your Existing Subscription
-
-Already paying for ChatGPT Pro, GitHub Copilot, or Qwen Code? Connect your existing account to BrowserOS with a single sign-in — no API keys, no extra cost.
-
-<CardGroup cols={3}>
-  <Card href="/features/chatgpt-pro-oauth">
-    <svg fill="currentColor" fillRule="evenodd" height="24" width="24" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"><path d="M9.205 8.658v-2.26c0-.19.072-.333.238-.428l4.543-2.616c.619-.357 1.356-.523 2.117-.523 2.854 0 4.662 2.212 4.662 4.566 0 .167 0 .357-.024.547l-4.71-2.759a.797.797 0 00-.856 0l-5.97 3.473zm10.609 8.8V12.06c0-.333-.143-.57-.429-.737l-5.97-3.473 1.95-1.118a.433.433 0 01.476 0l4.543 2.617c1.309.76 2.189 2.378 2.189 3.948 0 1.808-1.07 3.473-2.76 4.163zM7.802 12.703l-1.95-1.142c-.167-.095-.239-.238-.239-.428V5.899c0-2.545 1.95-4.472 4.591-4.472 1 0 1.927.333 2.712.928L8.23 5.067c-.285.166-.428.404-.428.737v6.898zM12 15.128l-2.795-1.57v-3.33L12 8.658l2.795 1.57v3.33L12 15.128zm1.796 7.23c-1 0-1.927-.332-2.712-.927l4.686-2.712c.285-.166.428-.404.428-.737v-6.898l1.974 1.142c.167.095.238.238.238.428v5.233c0 2.545-1.974 4.472-4.614 4.472zm-5.637-5.303l-4.544-2.617c-1.308-.761-2.188-2.378-2.188-3.948A4.482 4.482 0 014.21 6.327v5.423c0 .333.143.571.428.738l5.947 3.449-1.95 1.118a.432.432 0 01-.476 0zm-.262 3.9c-2.688 0-4.662-2.021-4.662-4.519 0-.19.024-.38.047-.57l4.686 2.71c.286.167.571.167.856 0l5.97-3.448v2.26c0 .19-.07.333-.237.428l-4.543 2.616c-.619.357-1.356.523-2.117.523zm5.899 2.83a5.947 5.947 0 005.827-4.756C22.287 18.339 24 15.84 24 13.296c0-1.665-.713-3.282-1.998-4.448.119-.5.19-.999.19-1.498 0-3.401-2.759-5.947-5.946-5.947-.642 0-1.26.095-1.88.31A5.962 5.962 0 0010.205 0a5.947 5.947 0 00-5.827 4.757C1.713 5.447 0 7.945 0 10.49c0 1.666.713 3.283 1.998 4.448-.119.5-.19 1-.19 1.499 0 3.401 2.759 5.946 5.946 5.946.642 0 1.26-.095 1.88-.309a5.96 5.96 0 004.162 1.713z"></path></svg>
-    **ChatGPT Pro / Plus**
-
-    Sign in with your OpenAI account. Access GPT-5 Codex, GPT-5.4, and the full Codex lineup with up to 400K context.
-  </Card>
-  <Card href="/features/github-copilot-oauth">
-    <svg fill="currentColor" fillRule="evenodd" height="24" width="24" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"><path d="M19.245 5.364c1.322 1.36 1.877 3.216 2.11 5.817.622 0 1.2.135 1.592.654l.73.964c.21.278.323.61.323.955v2.62c0 .339-.173.669-.453.868C20.239 19.602 16.157 21.5 12 21.5c-4.6 0-9.205-2.583-11.547-4.258-.28-.2-.452-.53-.453-.868v-2.62c0-.345.113-.679.321-.956l.73-.963c.392-.517.974-.654 1.593-.654l.029-.297c.25-2.446.81-4.213 2.082-5.52 2.461-2.54 5.71-2.851 7.146-2.864h.198c1.436.013 4.685.323 7.146 2.864zm-7.244 4.328c-.284 0-.613.016-.962.05-.123.447-.305.85-.57 1.108-1.05 1.023-2.316 1.18-2.994 1.18-.638 0-1.306-.13-1.851-.464-.516.165-1.012.403-1.044.996a65.882 65.882 0 00-.063 2.884l-.002.48c-.002.563-.005 1.126-.013 1.69.002.326.204.63.51.765 2.482 1.102 4.83 1.657 6.99 1.657 2.156 0 4.504-.555 6.985-1.657a.854.854 0 00.51-.766c.03-1.682.006-3.372-.076-5.053-.031-.596-.528-.83-1.046-.996-.546.333-1.212.464-1.85.464-.677 0-1.942-.157-2.993-1.18-.266-.258-.447-.661-.57-1.108-.32-.032-.64-.049-.96-.05zm-2.525 4.013c.539 0 .976.426.976.95v1.753c0 .525-.437.95-.976.95a.964.964 0 01-.976-.95v-1.752c0-.525.437-.951.976-.951zm5 0c.539 0 .976.426.976.95v1.753c0 .525-.437.95-.976.95a.964.964 0 01-.976-.95v-1.752c0-.525.437-.951.976-.951zM7.635 5.087c-1.05.102-1.935.438-2.385.906-.975 1.037-.765 3.668-.21 4.224.405.394 1.17.657 1.995.657h.09c.649-.013 1.785-.176 2.73-1.11.435-.41.705-1.433.675-2.47-.03-.834-.27-1.52-.63-1.813-.39-.336-1.275-.482-2.265-.394zm6.465.394c-.36.292-.6.98-.63 1.813-.03 1.037.24 2.06.675 2.47.968.957 2.136 1.104 2.776 1.11h.044c.825 0 1.59-.263 1.995-.657.555-.556.765-3.187-.21-4.224-.45-.468-1.335-.804-2.385-.906-.99-.088-1.875.058-2.265.394zM12 7.615c-.24 0-.525.015-.84.044.03.16.045.336.06.526l-.001.159a2.94 2.94 0 01-.014.25c.225-.022.425-.027.612-.028h.366c.187 0 .387.006.612.028-.015-.146-.015-.277-.015-.409.015-.19.03-.365.06-.526a9.29 9.29 0 00-.84-.044z"></path></svg>
-    **GitHub Copilot**
-
-    Sign in with your GitHub account. Access 19+ models including Claude, GPT-5, and Gemini through one subscription.
-  </Card>
-  <Card href="/features/qwen-code-oauth">
-    <svg fill="currentColor" fillRule="evenodd" height="24" width="24" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"><path d="M12.604 1.34c.393.69.784 1.382 1.174 2.075a.18.18 0 00.157.091h5.552c.174 0 .322.11.446.327l1.454 2.57c.19.337.24.478.024.837-.26.43-.513.864-.76 1.3l-.367.658c-.106.196-.223.28-.04.512l2.652 4.637c.172.301.111.494-.043.77-.437.785-.882 1.564-1.335 2.34-.159.272-.352.375-.68.37-.777-.016-1.552-.01-2.327.016a.099.099 0 00-.081.05 575.097 575.097 0 01-2.705 4.74c-.169.293-.38.363-.725.364-.997.003-2.002.004-3.017.002a.537.537 0 01-.465-.271l-1.335-2.323a.09.09 0 00-.083-.049H4.982c-.285.03-.553-.001-.805-.092l-1.603-2.77a.543.543 0 01-.002-.54l1.207-2.12a.198.198 0 000-.197 550.951 550.951 0 01-1.875-3.272l-.79-1.395c-.16-.31-.173-.496.095-.965.465-.813.927-1.625 1.387-2.436.132-.234.304-.334.584-.335a338.3 338.3 0 012.589-.001.124.124 0 00.107-.063l2.806-4.895a.488.488 0 01.422-.246c.524-.001 1.053 0 1.583-.006L11.704 1c.341-.003.724.032.9.34zm-3.432.403a.06.06 0 00-.052.03L6.254 6.788a.157.157 0 01-.135.078H3.253c-.056 0-.07.025-.041.074l5.81 10.156c.025.042.013.062-.034.063l-2.795.015a.218.218 0 00-.2.116l-1.32 2.31c-.044.078-.021.118.068.118l5.716.008c.046 0 .08.02.104.061l1.403 2.454c.046.081.092.082.139 0l5.006-8.76.783-1.382a.055.055 0 01.096 0l1.424 2.53a.122.122 0 00.107.062l2.763-.02a.04.04 0 00.035-.02.041.041 0 000-.04l-2.9-5.086a.108.108 0 010-.113l.293-.507 1.12-1.977c.024-.041.012-.062-.035-.062H9.2c-.059 0-.073-.026-.043-.077l1.434-2.505a.107.107 0 000-.114L9.225 1.774a.06.06 0 00-.053-.031zm6.29 8.02c.046 0 .058.02.034.06l-.832 1.465-2.613 4.585a.056.056 0 01-.05.029.058.058 0 01-.05-.029L8.498 9.841c-.02-.034-.01-.052.028-.054l.216-.012 6.722-.012z"></path></svg>
-    **Qwen Code**
-
-    Sign in with your Qwen account. Access Qwen 3 Coder with a 1 million token context window.
-  </Card>
-</CardGroup>
-
----
-
 ## Which Model Should I Use?
 
 | Mode | What works | Recommendation |

docs/features/chatgpt-pro-oauth.mdx

@@ -1,56 +0,0 @@
----
-title: "ChatGPT Pro / Plus"
-description: "Use your ChatGPT subscription to power BrowserOS"
----
-
-Connect your ChatGPT Pro or Plus subscription to BrowserOS and access GPT-5 Codex, GPT-5.4, and the full lineup of OpenAI's most advanced models — with up to 400K context. No API keys needed.
-
-## Setup
-
-**1.** Open BrowserOS and go to **Settings** (`chrome://browseros/settings`). You'll see the AI Providers section.
-
-![AI Settings screen](/images/setting-up-chatgpt/llm-screen.png)
-
-**2.** Click **USE** on the **ChatGPT Plus/Pro** card. You'll be prompted to sign in with your OpenAI account.
-
-![Login screen](/images/setting-up-chatgpt/login-screen.png)
-
-**3.** Sign in with the OpenAI account that has your ChatGPT Pro or Plus subscription active, and accept the authorization.
-
-![Accept authorization](/images/setting-up-chatgpt/accept-screen.png)
-
-**4.** Once authorized, ChatGPT will appear as a provider in your settings. Select a model and start using it.
-
-## Available Models
-
-| Model | Context Window |
-|-------|---------------|
-| `gpt-5.4` | 400K |
-| `gpt-5.3-codex` | 400K |
-| `gpt-5.2-codex` | 400K |
-| `gpt-5.2` | 200K |
-| `gpt-5.1-codex` | 400K |
-| `gpt-5.1-codex-max` | 400K |
-| `gpt-5.1-codex-mini` | 400K |
-| `gpt-5.1` | 200K |
-
-<Info>
-ChatGPT Pro subscribers have access to the full model lineup. ChatGPT Plus subscribers can access a subset of models depending on their plan. The available models will be shown automatically after you connect.
-</Info>
-
-<Tip>
-The Codex models (e.g., `gpt-5.3-codex`) are optimized for code and reasoning tasks — ideal for complex browser automation workflows that involve form filling, data extraction, and multi-step navigation.
-</Tip>
-
-## Reasoning Settings
-
-ChatGPT Pro includes additional settings for models that support reasoning:
-
-- **Reasoning Effort** — Control how much the model "thinks" before responding. Options: none, low, medium, high.
-- **Reasoning Summary** — Choose how reasoning is displayed. Options: auto, concise, detailed.
-
-These settings are available in the provider configuration after connecting.
-
-## Disconnecting
-
-To disconnect your OpenAI account, go to **Settings**, find the ChatGPT Plus/Pro provider, and click **Disconnect**. Your OAuth tokens will be immediately deleted from your machine.

docs/features/github-copilot-oauth.mdx

@@ -1,60 +0,0 @@
----
-title: "GitHub Copilot"
-description: "Use your GitHub Copilot subscription to power BrowserOS"
----
-
-Connect your GitHub Copilot subscription to BrowserOS and access 19+ models — including Claude, GPT-5, and Gemini — through a single GitHub sign-in. No API keys needed.
-
-<Info>
-**Free tier** includes GPT-5 Mini, Claude Haiku 4.5, GPT-4o, and GPT-4.1. **Copilot Pro** ($10/month) unlocks Claude Sonnet 4.6, Claude Opus 4.6, Gemini 3 Pro, GPT-5.4, and more.
-</Info>
-
-## Setup
-
-**1.** Open BrowserOS and go to **Settings** (`chrome://browseros/settings`). You'll see the AI Providers section.
-
-![AI Settings screen](/images/setting-up-copilot/llm-screen.png)
-
-**2.** Click **USE** on the **GitHub Copilot** card. A device code will appear — copy it, then click the link to open GitHub's device authorization page.
-
-![Device code displayed](/images/setting-up-copilot/device-code.png)
-
-**3.** Select your GitHub account to authorize.
-
-![Select GitHub account](/images/setting-up-copilot/select-account.png)
-
-**4.** Paste the device code and authorize BrowserOS to access your Copilot subscription.
-
-![Authorize device](/images/setting-up-copilot/authorize-device.png)
-
-**5.** Once authorized, GitHub Copilot will appear as a provider in your settings. Select a model and start using it.
-
-## Available Models
-
-### Free Tier
-| Model | Context Window |
-|-------|---------------|
-| `gpt-5-mini` | 128K |
-| `claude-haiku-4.5` | 128K |
-| `gpt-4o` | 64K |
-| `gpt-4.1` | 64K |
-
-### Copilot Pro / Pro+
-| Model | Context Window |
-|-------|---------------|
-| `claude-sonnet-4.6` | 200K |
-| `claude-opus-4.6` | 200K |
-| `gemini-2.5-pro` | 1M |
-| `gemini-3-pro-preview` | 1M |
-| `gpt-5.4` | 400K |
-| `gpt-5.3-codex` | 400K |
-| `gpt-5.2-codex` | 400K |
-| `grok-code-fast-1` | 128K |
-
-<Tip>
-GitHub Copilot is the most versatile provider — one subscription gives you access to models from OpenAI, Anthropic, Google, and xAI. Great if you want to switch between models for different tasks.
-</Tip>
-
-## Disconnecting
-
-To disconnect your GitHub account, go to **Settings**, find the GitHub Copilot provider, and click **Disconnect**. Your OAuth tokens will be immediately deleted from your machine.

docs/features/qwen-code-oauth.mdx

@@ -1,39 +0,0 @@
----
-title: "Qwen Code"
-description: "Use your Qwen Code account to power BrowserOS"
----
-
-Connect your Qwen Code account to BrowserOS and access Alibaba's coding models with up to a **1 million token context window** — the largest of any provider we support. No API keys needed.
-
-## Setup
-
-**1.** Open BrowserOS and go to **Settings** (`chrome://browseros/settings`). You'll see the AI Providers section.
-
-![AI Settings screen](/images/setting-up-qwen/llm-screen.png)
-
-**2.** Click **USE** on the **Qwen Code** card. You'll be prompted to sign in with your Qwen account.
-
-![Select Qwen Code](/images/setting-up-qwen/select-qwen.png)
-
-**3.** Sign in with your Alibaba Cloud / Qwen account to authorize BrowserOS.
-
-![Qwen sign in](/images/setting-up-qwen/qwen-signin.png)
-
-**4.** Once authorized, Qwen Code will appear as a provider in your settings. Select a model and start using it.
-
-## Available Models
-
-| Model | Context Window |
-|-------|---------------|
-| `coder-model` | 1M |
-| `qwen3-coder-plus` | 1M |
-| `qwen3-coder-flash` | 1M |
-| `qwen3.5-plus` | 1M |
-
-<Tip>
-Qwen Code's 1 million token context window is ideal for tasks that involve long documents, entire documentation sites, or working across many browser tabs simultaneously — the agent can hold everything in context at once.
-</Tip>
-
-## Disconnecting
-
-To disconnect your Qwen account, go to **Settings**, find the Qwen Code provider, and click **Disconnect**. Your OAuth tokens will be immediately deleted from your machine.

docs/images/icons/githubcopilot.svg

@@ -1 +0,0 @@
-<svg fill="currentColor" fill-rule="evenodd" height="1em" style="flex:none;line-height:1" viewBox="0 0 24 24" width="1em" xmlns="http://www.w3.org/2000/svg"><title>GithubCopilot</title><path d="M19.245 5.364c1.322 1.36 1.877 3.216 2.11 5.817.622 0 1.2.135 1.592.654l.73.964c.21.278.323.61.323.955v2.62c0 .339-.173.669-.453.868C20.239 19.602 16.157 21.5 12 21.5c-4.6 0-9.205-2.583-11.547-4.258-.28-.2-.452-.53-.453-.868v-2.62c0-.345.113-.679.321-.956l.73-.963c.392-.517.974-.654 1.593-.654l.029-.297c.25-2.446.81-4.213 2.082-5.52 2.461-2.54 5.71-2.851 7.146-2.864h.198c1.436.013 4.685.323 7.146 2.864zm-7.244 4.328c-.284 0-.613.016-.962.05-.123.447-.305.85-.57 1.108-1.05 1.023-2.316 1.18-2.994 1.18-.638 0-1.306-.13-1.851-.464-.516.165-1.012.403-1.044.996a65.882 65.882 0 00-.063 2.884l-.002.48c-.002.563-.005 1.126-.013 1.69.002.326.204.63.51.765 2.482 1.102 4.83 1.657 6.99 1.657 2.156 0 4.504-.555 6.985-1.657a.854.854 0 00.51-.766c.03-1.682.006-3.372-.076-5.053-.031-.596-.528-.83-1.046-.996-.546.333-1.212.464-1.85.464-.677 0-1.942-.157-2.993-1.18-.266-.258-.447-.661-.57-1.108-.32-.032-.64-.049-.96-.05zm-2.525 4.013c.539 0 .976.426.976.95v1.753c0 .525-.437.95-.976.95a.964.964 0 01-.976-.95v-1.752c0-.525.437-.951.976-.951zm5 0c.539 0 .976.426.976.95v1.753c0 .525-.437.95-.976.95a.964.964 0 01-.976-.95v-1.752c0-.525.437-.951.976-.951zM7.635 5.087c-1.05.102-1.935.438-2.385.906-.975 1.037-.765 3.668-.21 4.224.405.394 1.17.657 1.995.657h.09c.649-.013 1.785-.176 2.73-1.11.435-.41.705-1.433.675-2.47-.03-.834-.27-1.52-.63-1.813-.39-.336-1.275-.482-2.265-.394zm6.465.394c-.36.292-.6.98-.63 1.813-.03 1.037.24 2.06.675 2.47.968.957 2.136 1.104 2.776 1.11h.044c.825 0 1.59-.263 1.995-.657.555-.556.765-3.187-.21-4.224-.45-.468-1.335-.804-2.385-.906-.99-.088-1.875.058-2.265.394zM12 7.615c-.24 0-.525.015-.84.044.03.16.045.336.06.526l-.001.159a2.94 2.94 0 01-.014.25c.225-.022.425-.027.612-.028h.366c.187 0 .387.006.612.028-.015-.146-.015-.277-.015-.409.015-.19.03-.365.06-.526a9.29 9.29 0 00-.84-.044z"></path></svg>

docs/images/icons/openai.svg

@@ -1 +0,0 @@
-<svg fill="currentColor" fill-rule="evenodd" height="1em" style="flex:none;line-height:1" viewBox="0 0 24 24" width="1em" xmlns="http://www.w3.org/2000/svg"><title>OpenAI</title><path d="M9.205 8.658v-2.26c0-.19.072-.333.238-.428l4.543-2.616c.619-.357 1.356-.523 2.117-.523 2.854 0 4.662 2.212 4.662 4.566 0 .167 0 .357-.024.547l-4.71-2.759a.797.797 0 00-.856 0l-5.97 3.473zm10.609 8.8V12.06c0-.333-.143-.57-.429-.737l-5.97-3.473 1.95-1.118a.433.433 0 01.476 0l4.543 2.617c1.309.76 2.189 2.378 2.189 3.948 0 1.808-1.07 3.473-2.76 4.163zM7.802 12.703l-1.95-1.142c-.167-.095-.239-.238-.239-.428V5.899c0-2.545 1.95-4.472 4.591-4.472 1 0 1.927.333 2.712.928L8.23 5.067c-.285.166-.428.404-.428.737v6.898zM12 15.128l-2.795-1.57v-3.33L12 8.658l2.795 1.57v3.33L12 15.128zm1.796 7.23c-1 0-1.927-.332-2.712-.927l4.686-2.712c.285-.166.428-.404.428-.737v-6.898l1.974 1.142c.167.095.238.238.238.428v5.233c0 2.545-1.974 4.472-4.614 4.472zm-5.637-5.303l-4.544-2.617c-1.308-.761-2.188-2.378-2.188-3.948A4.482 4.482 0 014.21 6.327v5.423c0 .333.143.571.428.738l5.947 3.449-1.95 1.118a.432.432 0 01-.476 0zm-.262 3.9c-2.688 0-4.662-2.021-4.662-4.519 0-.19.024-.38.047-.57l4.686 2.71c.286.167.571.167.856 0l5.97-3.448v2.26c0 .19-.07.333-.237.428l-4.543 2.616c-.619.357-1.356.523-2.117.523zm5.899 2.83a5.947 5.947 0 005.827-4.756C22.287 18.339 24 15.84 24 13.296c0-1.665-.713-3.282-1.998-4.448.119-.5.19-.999.19-1.498 0-3.401-2.759-5.947-5.946-5.947-.642 0-1.26.095-1.88.31A5.962 5.962 0 0010.205 0a5.947 5.947 0 00-5.827 4.757C1.713 5.447 0 7.945 0 10.49c0 1.666.713 3.283 1.998 4.448-.119.5-.19 1-.19 1.499 0 3.401 2.759 5.946 5.946 5.946.642 0 1.26-.095 1.88-.309a5.96 5.96 0 004.162 1.713z"></path></svg>

docs/images/icons/qwen.svg

@@ -1 +0,0 @@
-<svg fill="currentColor" fill-rule="evenodd" height="1em" style="flex:none;line-height:1" viewBox="0 0 24 24" width="1em" xmlns="http://www.w3.org/2000/svg"><title>Qwen</title><path d="M12.604 1.34c.393.69.784 1.382 1.174 2.075a.18.18 0 00.157.091h5.552c.174 0 .322.11.446.327l1.454 2.57c.19.337.24.478.024.837-.26.43-.513.864-.76 1.3l-.367.658c-.106.196-.223.28-.04.512l2.652 4.637c.172.301.111.494-.043.77-.437.785-.882 1.564-1.335 2.34-.159.272-.352.375-.68.37-.777-.016-1.552-.01-2.327.016a.099.099 0 00-.081.05 575.097 575.097 0 01-2.705 4.74c-.169.293-.38.363-.725.364-.997.003-2.002.004-3.017.002a.537.537 0 01-.465-.271l-1.335-2.323a.09.09 0 00-.083-.049H4.982c-.285.03-.553-.001-.805-.092l-1.603-2.77a.543.543 0 01-.002-.54l1.207-2.12a.198.198 0 000-.197 550.951 550.951 0 01-1.875-3.272l-.79-1.395c-.16-.31-.173-.496.095-.965.465-.813.927-1.625 1.387-2.436.132-.234.304-.334.584-.335a338.3 338.3 0 012.589-.001.124.124 0 00.107-.063l2.806-4.895a.488.488 0 01.422-.246c.524-.001 1.053 0 1.583-.006L11.704 1c.341-.003.724.032.9.34zm-3.432.403a.06.06 0 00-.052.03L6.254 6.788a.157.157 0 01-.135.078H3.253c-.056 0-.07.025-.041.074l5.81 10.156c.025.042.013.062-.034.063l-2.795.015a.218.218 0 00-.2.116l-1.32 2.31c-.044.078-.021.118.068.118l5.716.008c.046 0 .08.02.104.061l1.403 2.454c.046.081.092.082.139 0l5.006-8.76.783-1.382a.055.055 0 01.096 0l1.424 2.53a.122.122 0 00.107.062l2.763-.02a.04.04 0 00.035-.02.041.041 0 000-.04l-2.9-5.086a.108.108 0 010-.113l.293-.507 1.12-1.977c.024-.041.012-.062-.035-.062H9.2c-.059 0-.073-.026-.043-.077l1.434-2.505a.107.107 0 000-.114L9.225 1.774a.06.06 0 00-.053-.031zm6.29 8.02c.046 0 .058.02.034.06l-.832 1.465-2.613 4.585a.056.056 0 01-.05.029.058.058 0 01-.05-.029L8.498 9.841c-.02-.034-.01-.052.028-.054l.216-.012 6.722-.012z"></path></svg>

docs/onboarding.mdx

@@ -42,10 +42,6 @@ Welcome to BrowserOS! Let's get you set up.
 
 ## You're all set!
 
-<Tip>
-**Block ads with uBlock Origin** — Chrome dropped support for the full uBlock Origin extension, but BrowserOS brought it back. [Install it from the Chrome Web Store](https://chromewebstore.google.com/detail/ublock-origin/cjpalhdlnbpafiamejdnhcphjbkeiagm) and browse ad-free. [Learn more →](/features/ad-blocking)
-</Tip>
-
 Explore what BrowserOS can do:
 
 <Columns cols={2}>

lefthook.yml

@@ -1,57 +0,0 @@
-commit-msg:
-  commands:
-    conventional:
-      run: |
-        msg=$(head -1 {1})
-        if [[ ! "$msg" =~ ^(feat|fix|docs|style|refactor|perf|test|chore|ci|build|revert)(\(.+\))?\!?:\ .+ ]]; then
-          echo "Commit message must follow Conventional Commits format:"
-          echo "  <type>(<optional scope>): <description>"
-          echo "  Types: feat, fix, docs, style, refactor, perf, test, chore, ci, build, revert"
-          echo ""
-          echo "Examples:"
-          echo "  feat(auth): add OAuth2 support"
-          echo "  fix: resolve null pointer exception"
-          exit 1
-        fi
-
-pre-commit:
-  commands:
-    biome-check:
-      root: "packages/browseros-agent/"
-      glob: "*.{js,ts,cjs,mjs,d.cts,d.mts,jsx,tsx,json,jsonc}"
-      run: npx @biomejs/biome check --write --no-errors-on-unmatched --files-ignore-unknown=true --colors=off {staged_files}
-      stage_fixed: true
-
-    file-length:
-      root: "packages/browseros-agent/"
-      glob: "*.{ts,tsx}"
-      exclude: "*.{test,spec,d}.ts|*.{test,spec}.tsx|**/__tests__/**|**/tests/**|**/*.generated.*"
-      run: |
-        for file in {staged_files}; do
-          if [[ -f "$file" ]]; then
-            lines=$(wc -l < "$file" | tr -d ' ')
-            if [[ $lines -gt 400 ]]; then
-              echo "⚠️  Warning: $file has $lines lines (threshold: 400)"
-              echo "   Consider splitting this file if it has multiple responsibilities."
-            fi
-          fi
-        done
-
-pre-push:
-  commands:
-    branch-name:
-      run: |
-        branch=$(git rev-parse --abbrev-ref HEAD)
-        if [[ "$branch" == "main" || "$branch" == "master" ]]; then
-          exit 0
-        fi
-        if [[ ! "$branch" =~ ^(feat|fix|bugfix|hotfix|release|docs|refactor|test|chore|experiment)/[a-z0-9-]+$ ]]; then
-          echo "⚠️  Warning: Branch name '$branch' doesn't match recommended format."
-          echo "   Use: <type>/<short-description>"
-          echo "   Types: feat, fix, bugfix, hotfix, release, docs, refactor, test, chore, experiment"
-          echo "   Example: feat/add-auth, fix/login-crash"
-          echo ""
-          echo "   To rename your branch:"
-          echo "     git branch -m <new-name>"
-          echo "     git push -u origin <new-name>"
-        fi

packages/browseros-agent/.claude/skills/test-ui/SKILL.md

@@ -1,286 +0,0 @@
----
-name: test-ui
-description: Test the BrowserOS agent extension UI by starting the dev environment and visually verifying changes via CDP. Covers the new tab page (left sidebar — Home, Scheduled Tasks, Settings, etc.) and the right side panel (chat interface). Use after making UI changes to apps/agent/.
-argument-hint: [what to test, e.g. "verify the new settings page renders correctly"]
----
-
-# Test Agent UI
-
-Visually test the BrowserOS agent extension UI — both the new tab page (left sidebar) and the right side panel (chat) — by starting the dev environment and inspecting via CDP.
-
-## When to use
-
-After making code changes to `apps/agent/` (the Chrome extension), use this skill to:
-- Verify new UI components render correctly
-- Check navigation between views works
-- Confirm layout/styling changes look right
-- Test interactive elements (buttons, inputs, forms)
-
-## Prerequisites
-
-- **Go** must be installed (`brew install go`) — the dev tool is written in Go
-- **BrowserOS.app** must be installed at `/Applications/BrowserOS.app/`
-- The `scripts/dev/inspect-ui.ts` utility must exist (CDP inspector script)
-
-## Step 1: Start the dev environment
-
-```bash
-bun run dev:watch -- --new
-```
-
-This single command handles everything:
-- Builds the Go dev CLI tool
-- Picks random available ports (avoids conflicts)
-- Creates a fresh browser profile
-- Builds controller-ext
-- Runs GraphQL codegen if `apps/agent/generated/graphql/` doesn't exist
-- Starts the agent extension with WXT HMR (hot module replacement)
-- Waits for CDP to be ready
-- Starts the MCP server
-
-Run it in the background and **read the output to find the CDP port**:
-
-```
-[info] Ports: CDP=9552 Server=9065 Extension=9929
-```
-
-The CDP port is randomized. You MUST extract it from the output and set it for all subsequent commands:
-
-```bash
-export BROWSEROS_CDP_PORT=<port from output>
-```
-
-Wait for these messages before proceeding:
-1. `[server] CDP ready`
-2. `[server] HTTP server listening`
-
-## Step 2: Discover targets
-
-```bash
-bun scripts/dev/inspect-ui.ts targets
-```
-
-You will see targets like:
-- `[service_worker]` — extension background scripts (not directly testable for UI)
-- `[page] chrome-extension://bflpfmnmnokmjhmgnolecpppdbdophmk/app.html#/...` — **New tab page (left sidebar)**
-- `[page] sidepanel.html` — **Right side panel (chat)**
-
-The two main testable surfaces:
-- **`app.html`** — the new tab page with left sidebar (Home, Connect Apps, Scheduled Tasks, Skills, Memory, Soul, Settings)
-- **`sidepanel.html`** — the right side panel chat interface
-
-## Step 3: Navigate to the main UI
-
-A fresh profile opens the **onboarding page** (`app.html#/onboarding`). Navigate to the home page first:
-
-```bash
-bun scripts/dev/inspect-ui.ts eval app.html "window.location.hash = '#/home'"
-```
-
-Verify with a snapshot (not screenshot — snapshot is faster and sufficient for structural checks):
-```bash
-bun scripts/dev/inspect-ui.ts snapshot app.html
-```
-
-## Snapshot vs Screenshot
-
-**Prefer `snapshot` for most checks** — it's fast, text-based, and tells you what elements exist, their text, and their IDs. Use it after every navigation or interaction to verify state.
-
-**Use `screenshot` only when you need visual verification** — layout changes, CSS/styling, colors, images, or a final "does it look right" check. Screenshots are expensive (capture → save → read image).
-
-| Check | Use |
-|-------|-----|
-| Did the page navigate? | `snapshot` — look for new elements |
-| Does my new component render? | `snapshot` — look for its text/role |
-| Did a click change state? | `snapshot` — check element names/values |
-| Is the layout correct? | `screenshot` — visual check needed |
-| Do CSS changes look right? | `screenshot` — visual check needed |
-| Final verification before committing | `screenshot` — one visual confirmation |
-
-## Step 4: Test the new tab page (left sidebar)
-
-### Get element IDs
-
-```bash
-bun scripts/dev/inspect-ui.ts snapshot app.html
-```
-
-Output shows interactive elements with IDs:
-```
-[52] link "Home"
-[57] link "Connect Apps"
-[65] link "Scheduled Tasks"
-[74] link "Skills"
-[103] link "Settings"
-```
-
-### Navigate via click or hash routing
-
-**Click-based** (use element IDs from snapshot):
-```bash
-bun scripts/dev/inspect-ui.ts click app.html 65    # Click "Scheduled Tasks"
-```
-
-**Hash routing** (faster, no snapshot needed):
-```bash
-bun scripts/dev/inspect-ui.ts eval app.html "window.location.hash = '#/settings'"
-bun scripts/dev/inspect-ui.ts eval app.html "window.location.hash = '#/scheduled-tasks'"
-bun scripts/dev/inspect-ui.ts eval app.html "window.location.hash = '#/home'"
-```
-
-### Verify navigation
-
-```bash
-# Snapshot to confirm the page changed (fast, preferred)
-bun scripts/dev/inspect-ui.ts snapshot app.html
-
-# Screenshot only if you need to check visual layout
-bun scripts/dev/inspect-ui.ts screenshot app.html /tmp/settings.png
-```
-
-### CRITICAL: Re-snapshot after every navigation
-
-React re-renders change element IDs. **Always run snapshot again** before clicking/filling after navigating to a new view. Using stale IDs will fail.
-
-## Step 5: Open and test the right side panel
-
-The side panel starts **disabled** in a fresh profile. Open it using BrowserOS-specific APIs:
-
-```bash
-bun scripts/dev/inspect-ui.ts open-sidepanel
-```
-
-Wait 2 seconds for it to appear as a target, then:
-
-```bash
-bun scripts/dev/inspect-ui.ts screenshot sidepanel /tmp/panel.png
-bun scripts/dev/inspect-ui.ts snapshot sidepanel
-```
-
-### Interact with the side panel
-
-```bash
-# Get element IDs
-bun scripts/dev/inspect-ui.ts snapshot sidepanel
-# Output: [37] textbox "What should I do?"
-#         [124] button "Send"
-#         [60] link "Chat history"
-#         [99] button "Agent Mode ON"
-
-# Fill the chat input and press Enter to send
-bun scripts/dev/inspect-ui.ts fill sidepanel 37 "Hello world"
-bun scripts/dev/inspect-ui.ts press_key sidepanel Enter
-
-# Or click the Send button
-bun scripts/dev/inspect-ui.ts click sidepanel 124
-
-# Wait for a response to appear
-bun scripts/dev/inspect-ui.ts wait_for sidepanel text "response text"
-
-# Scroll down to see more content
-bun scripts/dev/inspect-ui.ts scroll sidepanel down 3
-
-# Hover over an element to test hover states
-bun scripts/dev/inspect-ui.ts hover sidepanel 99
-
-# Snapshot to verify state changed (fast, preferred)
-bun scripts/dev/inspect-ui.ts snapshot sidepanel
-
-# Screenshot only for visual/layout verification
-bun scripts/dev/inspect-ui.ts screenshot sidepanel /tmp/result.png
-```
-
-## Step 6: Verify and iterate
-
-### The core loop
-
-```
-snapshot → identify element IDs → click/fill/press_key → snapshot → verify
-```
-
-Use `screenshot` only when visual layout verification is needed (CSS changes, final check).
-
-### After making code changes
-
-1. Fix the code in `apps/agent/`
-2. WXT HMR will hot-reload the extension automatically (watch mode)
-3. Wait 2-3 seconds for the reload to complete
-4. **Re-snapshot** — element IDs WILL change after HMR reload
-5. Verify the fix with snapshot (or screenshot if visual)
-
-### Check server logs
-
-The dev server output (running in background) contains useful diagnostics:
-- `[agent]` — WXT build/HMR status, compilation errors
-- `[server]` — MCP server logs, tool execution, errors
-- `[build]` — Extension build output
-
-If the UI isn't rendering, check for build errors in the `[agent]` output.
-
-### Check for JavaScript errors
-
-```bash
-bun scripts/dev/inspect-ui.ts eval sidepanel "JSON.stringify(window.__errors || 'no errors')"
-```
-
-Or check the console for React errors:
-```bash
-bun scripts/dev/inspect-ui.ts eval app.html "document.querySelector('#root')?.innerHTML?.substring(0, 200)"
-```
-
-### Verify API connectivity
-
-The extension talks to the MCP server. Verify the server is reachable:
-```bash
-bun scripts/dev/inspect-ui.ts eval sidepanel "fetch('http://127.0.0.1:<serverPort>/health').then(r => r.ok).catch(() => false)"
-```
-
-### Common issues
-
-| Symptom | Cause | Fix |
-|---------|-------|-----|
-| Blank page after navigation | React render error | Check `eval` for JS errors |
-| Element IDs don't match | Page re-rendered (HMR/navigation) | Re-run `snapshot` before interacting |
-| `open-sidepanel` fails | Extension not fully loaded | Wait longer after dev server starts |
-| Click does nothing | Element not visible (below fold) | Use `scroll` first, then re-snapshot |
-| `wait_for` times out | Content hasn't loaded yet | Check server logs for API errors |
-
-## Available commands reference
-
-| Command | Description |
-|---------|-------------|
-| `targets` | List all CDP targets, marks extension pages with `[EXTENSION]` |
-| `screenshot <target> [file]` | Capture PNG screenshot (default: `screenshot.png`) |
-| `snapshot <target>` | Print accessibility tree with `[elementId] role "name"` |
-| `click <target> <elementId>` | Click element by ID (3-tier coordinate fallback + JS click) |
-| `fill <target> <elementId> <text>` | Focus element, clear, type text |
-| `press_key <target> <key>` | Press key or combo: `Enter`, `Escape`, `Tab`, `Control+A`, `Meta+Shift+P` |
-| `scroll <target> <dir> [amount]` | Scroll `up`/`down`/`left`/`right`, amount in ticks (default 3) |
-| `hover <target> <elementId>` | Hover over element (for tooltips, hover states) |
-| `select_option <target> <id> <val>` | Select dropdown option by value or visible text |
-| `wait_for <target> text\|selector <v>` | Wait up to 10s for text or CSS selector to appear |
-| `eval <target> <expression>` | Run JavaScript in the target's context |
-| `open-sidepanel` | Enable and open the right side panel |
-
-`<target>` is a URL substring (e.g., `sidepanel`, `app.html`) or numeric index from `targets` output.
-
-## Known app.html routes
-
-These can be used with `eval app.html "window.location.hash = '#/<route>'"`:
-
-| Route | View |
-|-------|------|
-| `/home` | Home page with search bar and top sites |
-| `/settings` | Settings (LLM providers, customization, workflows, MCP) |
-| `/scheduled-tasks` | Scheduled Tasks management |
-| `/onboarding` | Onboarding flow (first-run experience) |
-
-## Gotchas learned from real testing
-
-1. **Ports are randomized** with `--new` — always extract from dev server output
-2. **Fresh profile = onboarding page** — navigate to `#/home` to see the main UI
-3. **Element IDs change after navigation** — always re-snapshot before clicking
-4. **Side panel starts disabled** — `open-sidepanel` handles the BrowserOS-specific enable + toggle API
-5. **`Input.enable` does not exist** — the CDP Input domain has no enable method (already handled in the script)
-6. **`DOM.getDocument` required** — must be called before DOM operations like `pushNodesByBackendIdsToFrontend` (already handled in the script)
-7. **Settings sub-navigation** — the settings page has its own left sidebar (BrowserOS AI, Chat & Council Provider, Search Provider, Customize BrowserOS, BrowserOS as MCP, Workflows) — use snapshot + click to navigate within settings

packages/browseros-agent/.github/dependabot.yml

@@ -0,0 +1,41 @@
+version: 2
+updates:
+  - package-ecosystem: bun
+    directory: /
+    schedule:
+      interval: weekly
+      day: 'sunday'
+      time: '02:00'
+      timezone: Europe/Berlin
+    open-pull-requests-limit: 10
+    groups:
+      dependencies:
+        applies-to: security-updates
+        dependency-type: production
+        exclude-patterns:
+          - 'puppeteer*'
+        patterns:
+          - '*'
+      dev-dependencies:
+        applies-to: security-updates
+        dependency-type: development
+        exclude-patterns:
+          - 'puppeteer*'
+        patterns:
+          - '*'
+      puppeteer:
+        patterns:
+          - 'puppeteer*'
+  - package-ecosystem: github-actions
+    directory: /
+    schedule:
+      interval: weekly
+      day: 'sunday'
+      time: '04:00'
+      timezone: Europe/Berlin
+    open-pull-requests-limit: 10
+    groups:
+      all:
+        applies-to: security-updates
+        patterns:
+          - '*'

packages/browseros-agent/.github/workflows/audit.yml

@@ -9,9 +9,6 @@ on:
 jobs:
   security-audit:
     runs-on: ubuntu-latest
-    defaults:
-      run:
-        working-directory: packages/browseros-agent
 
     steps:
       - name: Checkout code

packages/browseros-agent/.github/workflows/cla.yml

@@ -0,0 +1,58 @@
+name: CLA Assistant
+
+on:
+  issue_comment:
+    types: [created]
+  pull_request_target:
+    types: [opened, closed, synchronize]
+
+permissions:
+  actions: write
+  contents: write
+  pull-requests: write
+  statuses: write
+
+jobs:
+  cla:
+    runs-on: ubuntu-latest
+    if: |
+      (github.event_name == 'pull_request_target') ||
+      (github.event_name == 'issue_comment' && github.event.issue.pull_request &&
+       (github.event.comment.body == 'recheck' ||
+        github.event.comment.body == 'I have read the CLA Document and I hereby sign the CLA'))
+    steps:
+      - name: CLA Assistant
+        uses: contributor-assistant/github-action@v2.6.1
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          PERSONAL_ACCESS_TOKEN: ${{ secrets.CLA_SIGNATURES_TOKEN }}
+        with:
+          path-to-signatures: 'cla-signatures.json'
+          path-to-document: 'https://github.com/${{ github.repository }}/blob/main/CLA.md'
+          branch: 'main'
+          remote-organization-name: 'browseros-ai'
+          remote-repository-name: 'cla-signatures'
+          allowlist: 'bot*,*[bot],dependabot,renovate,github-actions,snyk-bot,imgbot,greenkeeper,semantic-release-bot,allcontributors'
+          lock-pullrequest-aftermerge: false
+          custom-notsigned-prcomment: |
+            Thank you for your contribution! Before we can merge this PR, we need you to sign our [Contributor License Agreement](https://github.com/${{ github.repository }}/blob/main/CLA.md).
+
+            **To sign the CLA**, please add a comment to this PR with the following text:
+
+            ```
+            I have read the CLA Document and I hereby sign the CLA
+            ```
+
+            You only need to sign once. After signing, this check will pass automatically.
+
+            ---
+            <details>
+            <summary>Troubleshooting</summary>
+
+            - **Already signed but still failing?** Comment `recheck` to trigger a re-verification.
+            - **Signed with a different email?** Make sure your commit email matches your GitHub account email, or add your commit email to your GitHub account.
+
+            </details>
+          custom-pr-sign-comment: 'I have read the CLA Document and I hereby sign the CLA'
+          custom-allsigned-prcomment: |
+            All contributors have signed the CLA. Thank you!

packages/browseros-agent/.github/workflows/claude.yml

@@ -22,11 +22,11 @@ jobs:
       (github.event_name == 'issues' && (contains(github.event.issue.body, '@claude') || contains(github.event.issue.title, '@claude')))
     runs-on: ubuntu-latest
     permissions:
-      contents: write
-      pull-requests: write
+      contents: write        # Can push branches and create commits
+      pull-requests: write   # Can create and update PRs
       issues: read
       id-token: write
-      actions: read
+      actions: read          # Required for Claude to read CI results on PRs
     steps:
       - name: Checkout repository
         uses: actions/checkout@v6
@@ -38,5 +38,11 @@ jobs:
         uses: anthropics/claude-code-action@v1
         with:
           claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
+
+          # This is an optional setting that allows Claude to read CI results on PRs
           additional_permissions: |
             actions: read
+
+          # Allow all tools - branch protection rules at repo level prevent direct pushes to main/master
+          # Omitting --allowedTools means all tools are available by default
+

packages/browseros-agent/.github/workflows/code-quality.yml

@@ -4,17 +4,11 @@ on:
   pull_request:
     branches:
       - main
-      - dev
-    paths:
-      - "packages/browseros-agent/**"
 
 jobs:
   biome:
     name: runner / Biome
     runs-on: ubuntu-latest
-    defaults:
-      run:
-        working-directory: packages/browseros-agent
     permissions:
       contents: read
     steps:
@@ -34,9 +28,6 @@ jobs:
   typecheck:
     name: runner / Typecheck
     runs-on: ubuntu-latest
-    defaults:
-      run:
-        working-directory: packages/browseros-agent
     permissions:
       contents: read
     steps:
@@ -51,9 +42,6 @@ jobs:
       - name: Install dependencies
         run: bun ci
 
-      - name: Prepare wxt
-        run: VITE_PUBLIC_BROWSEROS_API=http://localhost:3000 bun run --cwd apps/agent wxt prepare
-
       - name: Run codegen
         run: bun run --cwd apps/agent codegen
 

packages/browseros-agent/.github/workflows/pr-title.yml

@@ -2,12 +2,12 @@ name: PR Conventional Commit Validation
 
 on:
   pull_request:
-    types: [opened, edited]
+    types: [opened, synchronize, reopened, edited]
 
 permissions:
-  pull-requests: write
-  issues: write
-  contents: read
+  pull-requests: write  # Read PR details and add labels
+  issues: write         # Labels are managed via issues API
+  contents: read        # Read repository content
 
 jobs:
   validate-pr-title:

packages/browseros-agent/.github/workflows/release-agent-sdk.yml

@@ -0,0 +1,37 @@
+name: Release Agent SDK
+
+on:
+  workflow_dispatch:
+
+jobs:
+  publish:
+    if: github.ref == 'refs/heads/main'
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: packages/agent-sdk
+
+    steps:
+      - uses: actions/checkout@v6
+
+      - uses: oven-sh/setup-bun@v2
+
+      - uses: actions/setup-node@v6
+        with:
+          node-version: "20"
+          registry-url: "https://registry.npmjs.org"
+
+      - name: Install dependencies
+        run: bun ci
+        working-directory: .
+
+      - name: Build
+        run: bun run build
+
+      - name: Test
+        run: bun test
+
+      - name: Publish
+        run: npm publish --access public
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

packages/browseros-agent/.github/workflows/test.yml

@@ -0,0 +1,24 @@
+name: Tests
+
+on: []
+
+jobs:
+  test:
+    name: Run Tests
+    runs-on: macos-latest
+    timeout-minutes: 10
+
+    steps:
+      - name: 📥 Checkout code
+        uses: actions/checkout@v6
+
+      - name: 🧰 Setup Bun
+        uses: oven-sh/setup-bun@v2
+
+      - name: 📦 Install dependencies
+        run: bun ci
+
+      - name: 🧪 Run all tests
+        run: bun test:all
+        env:
+          PUPPETEER_EXECUTABLE_PATH: /Applications/Google Chrome.app/Contents/MacOS/Google Chrome

packages/browseros-agent/.gitignore

@@ -1,4 +1,3 @@
-CLAUDE.md
 # Logs
 logs
 *.log
@@ -188,12 +187,7 @@ log.txt
 # Testing iteration temp files
 tmp/
 
-# CI artifacts
-.ci/
-test-results/
-
 # Coding agent artifacts
 .agent/
 .llm/
 .grove/
-docs/plans/2026-03-24-models-dev-integration.md

packages/browseros-agent/CLAUDE.md

@@ -32,7 +32,7 @@ Use **kebab-case** for all file and folder names:
 | Multi-word files | kebab-case | `gemini-agent.ts`, `mcp-context.ts` |
 | Single-word files | lowercase | `types.ts`, `browser.ts`, `index.ts` |
 | Test files | `.test.ts` suffix | `mcp-context.test.ts` |
-| Folders | kebab-case | `rate-limiter/`, `browser-tools/` |
+| Folders | kebab-case | `controller-server/`, `rate-limiter/` |
 
 Classes remain PascalCase in code, but live in kebab-case files:
 ```typescript
@@ -81,9 +81,6 @@ bun run dev:server               # Build server for development
 bun run dev:ext                  # Build extension for development
 bun run dist:server              # Build server for production (all targets)
 bun run dist:ext                 # Build extension for production
-
-# Refresh models.dev data
-bun run generate:models          # Fetches latest from models.dev/api.json
 ```
 
 ## Architecture
@@ -97,16 +94,21 @@ The main MCP server that exposes browser automation tools via HTTP/SSE.
 
 **Key components:**
 - `src/tools/` - MCP tool definitions, split into:
-  - `cdp-based/` - Tools using Chrome DevTools Protocol (navigation, DOM interaction, network, console, emulation, input, etc.)
+  - `cdp-based/` - Tools using Chrome DevTools Protocol (network, console, emulation, input, etc.)
+  - `controller-based/` - Tools using the browser extension (navigation, clicks, screenshots, tabs, history, bookmarks)
+- `src/controller-server/` - WebSocket server that bridges to the browser extension
+  - `ControllerBridge` handles WebSocket connections with extension clients
+  - `ControllerContext` wraps the bridge for tool handlers
 - `src/common/` - Shared utilities (McpContext, PageCollector, browser connection, identity, db)
 - `src/agent/` - AI agent functionality (Gemini adapter, rate limiting, session management)
 - `src/http/` - Hono HTTP server with MCP, health, and provider routes
 
 **Tool types:**
 - CDP tools require a direct CDP connection (`--cdp-port`)
+- Controller tools work via the browser extension over WebSocket
 
 ### Shared (`packages/shared`)
-Shared constants, types, and configuration used across packages. Avoids magic numbers.
+Shared constants, types, and configuration used by both server and extension. Avoids magic numbers.
 
 **Structure:**
 - `src/constants/` - Configuration values (ports, timeouts, limits, urls, paths)
@@ -114,12 +116,22 @@ Shared constants, types, and configuration used across packages. Avoids magic nu
 
 **Exports:** `@browseros/shared/constants/*`, `@browseros/shared/types/*`
 
+### Controller Extension (`apps/controller-ext`)
+Chrome extension that receives commands from the server via WebSocket.
+
+**Entry point:** `src/background/index.ts` → `BrowserOSController`
+
+**Structure:**
+- `src/actions/` - Action handlers organized by domain (browser/, tab/, bookmark/, history/)
+- `src/adapters/` - Chrome API adapters (TabAdapter, BookmarkAdapter, HistoryAdapter)
+- `src/websocket/` - WebSocket client that connects to the server
+
 ### Communication Flow
 
 ```
 AI Agent/MCP Client → HTTP Server (Hono) → Tool Handler
                                               ↓
-                                   CDP → BrowserOS / Chrome APIs
+                        CDP (direct) ←── or ──→ WebSocket → Extension → Chrome APIs
 ```
 
 ## Creating Packages
@@ -148,73 +160,8 @@ When creating new packages in this monorepo:
 ## Test Organization
 
 Tests are in `apps/server/tests/`:
-- `tools/` - Tool tests (require BrowserOS running with CDP), plus ACL scorer tests (standalone)
+- `tools/` - Tool tests (require BrowserOS running with CDP)
 - `browser/` - Browser backend tests
 - `agent/` - Agent tests (compaction, rate limiter)
 - `sdk/` - Agent SDK tests
 - `__helpers__/` - Test utilities and fixtures
-
-## Self-Testing UI Changes
-
-After making UI changes to the agent extension (`apps/agent/`), you can visually verify them using the CDP inspector script. This connects directly to the browser via Chrome DevTools Protocol and can inspect extension pages (side panel, new tab, etc.) that the agent's own tools cannot see.
-
-### Prerequisites
-
-The dev server must be running:
-```bash
-bun run dev:watch -- --new
-```
-Read the output to find the randomized CDP port, then:
-```bash
-export BROWSEROS_CDP_PORT=<port from output>
-```
-
-### Workflow
-
-1. **List all targets** to see what's available:
-   ```bash
-   bun scripts/dev/inspect-ui.ts targets
-   ```
-
-2. **Open the side panel** if it's not already open:
-   ```bash
-   bun scripts/dev/inspect-ui.ts open-sidepanel
-   ```
-
-3. **Take a screenshot** of the side panel:
-   ```bash
-   bun scripts/dev/inspect-ui.ts screenshot sidepanel /tmp/panel.png
-   ```
-   Then read `/tmp/panel.png` to view the result.
-
-4. **Get the accessibility tree** for structural verification:
-   ```bash
-   bun scripts/dev/inspect-ui.ts snapshot sidepanel
-   ```
-
-5. **Click an element** by its ID from the snapshot:
-   ```bash
-   bun scripts/dev/inspect-ui.ts click sidepanel 142
-   ```
-
-6. **Fill a text input** by its ID from the snapshot:
-   ```bash
-   bun scripts/dev/inspect-ui.ts fill sidepanel 85 "search query"
-   ```
-
-7. **Evaluate JavaScript** in the extension context:
-   ```bash
-   bun scripts/dev/inspect-ui.ts eval sidepanel "document.title"
-   ```
-
-### Interaction workflow
-
-The typical loop is: snapshot → identify element IDs → click/fill → screenshot to verify.
-Element IDs come from the `[number]` in snapshot output (these are `backendDOMNodeId` values).
-This uses the same element resolution as the server's MCP tools — no coordinate guessing.
-
-### Target selection
-
-The `<target>` argument can be:
-- An **index** from the `targets` output (e.g., `3`)
-- A **URL substring** (e.g., `sidepanel`, `newtab`, `chrome-extension://`)

packages/browseros-agent/README.md

@@ -1,6 +1,8 @@
 # BrowserOS Agent
 
-The agent platform powering [BrowserOS](https://github.com/browseros-ai/BrowserOS) — contains the MCP server, agent UI, CLI, evaluation framework, and SDK.
+Monorepo for the BrowserOS-agent -- contains 3 packages: agent-UI, server (which contains the agent loop) and controller-extension (which is used by the tools within the agent loop).
+
+> **⚠️ NOTE:** This is only a submodule, the main project is at -- https://github.com/browseros-ai/BrowserOS
 
 ## Monorepo Structure
 
@@ -8,29 +10,24 @@ The agent platform powering [BrowserOS](https://github.com/browseros-ai/BrowserO
 apps/
   server/          # Bun server - MCP endpoints + agent loop
   agent/           # Agent UI (Chrome extension)
-  cli/             # Go CLI for controlling BrowserOS from the terminal
-  eval/            # Evaluation framework for benchmarking agents
+  controller-ext/  # BrowserOS Controller (Chrome extension for chrome.* APIs)
 
 packages/
-  agent-sdk/       # Node.js SDK (@browseros-ai/agent-sdk)
-  cdp-protocol/    # Type-safe Chrome DevTools Protocol bindings
   shared/          # Shared constants (ports, timeouts, limits)
 ```
 
 | Package | Description |
 |---------|-------------|
 | `apps/server` | Bun server exposing MCP tools and running the agent loop |
-| `apps/agent` | Agent UI — Chrome extension for the chat interface |
-| `apps/cli` | Go CLI — control BrowserOS from the terminal or AI coding agents |
-| `apps/eval` | Benchmark framework — WebVoyager, Mind2Web evaluation |
-| `packages/agent-sdk` | Node.js SDK for browser automation with natural language |
-| `packages/cdp-protocol` | Auto-generated CDP type bindings used by the server |
+| `apps/agent` | Agent UI - Chrome extension for the chat interface |
+| `apps/controller-ext` | BrowserOS Controller - Chrome extension that bridges `chrome.*` APIs (tabs, bookmarks, history) to the server via WebSocket |
 | `packages/shared` | Shared constants used across packages |
 
 ## Architecture
 
 - `apps/server`: Bun server which contains the agent loop and tools.
 - `apps/agent`: Agent UI (Chrome extension).
+- `apps/controller-ext`: BrowserOS Controller - a Chrome extension that bridges `chrome.*` APIs to the server. Controller tools within the server communicate with this extension via WebSocket.
 
 ```
 ┌──────────────────────────────────────────────────────────────────────────┐
@@ -48,19 +45,19 @@ packages/
 │   /health ─── Health check                                               │
 │                                                                          │
 │   Tools:                                                                 │
-│   └── CDP-backed browser tools (tabs, navigation, input, screenshots,   │
-│       bookmarks, history, console, DOM, tab groups, windows, ...)       │
+│   ├── CDP Tools (console, network, input, screenshot, ...)              │
+│   └── Controller Tools (tabs, navigation, clicks, bookmarks, history)   │
 └──────────────────────────────────────────────────────────────────────────┘
-                                    │
-                                    │ CDP (client)
-                                    ▼
-                         ┌─────────────────────┐
-                         │   Chromium CDP      │
-                         │  (cdpPort: 9000)    │
-                         │                     │
-                         │ Server connects     │
-                         │ TO this as client   │
-                         └─────────────────────┘
+          │                                         │
+          │ CDP (client)                            │ WebSocket (server)
+          ▼                                         ▼
+┌─────────────────────┐              ┌─────────────────────────────────────┐
+│   Chromium CDP      │              │   BrowserOS Controller Extension    │
+│  (cdpPort: 9000)    │              │     (extensionPort: 9300)           │
+│                     │              │                                     │
+│ Server connects     │              │ Bridges chrome.tabs, chrome.history │
+│ TO this as client   │              │ chrome.bookmarks to the server      │
+└─────────────────────┘              └─────────────────────────────────────┘
 ```
 
 ### Ports
@@ -69,7 +66,7 @@ packages/
 |------|--------------|---------|
 | 9100 | `BROWSEROS_SERVER_PORT` | HTTP server - MCP endpoints, agent chat, health |
 | 9000 | `BROWSEROS_CDP_PORT` | Chromium CDP server (BrowserOS Server connects as client) |
-| 9300 | `BROWSEROS_EXTENSION_PORT` | Legacy BrowserOS launch arg kept for compatibility; not used by the server |
+| 9300 | `BROWSEROS_EXTENSION_PORT` | WebSocket server for controller extension |
 
 ## Development
 
@@ -93,8 +90,9 @@ process-compose up
 
 The `process-compose up` command runs the following in order:
 1. `bun install` — installs dependencies
-2. `bun --cwd apps/agent codegen` — generates agent code
-3. `bun --cwd apps/server start` and `bun --cwd apps/agent dev` — starts server and agent in parallel
+2. `bun --cwd apps/controller-ext build` — builds the controller extension
+3. `bun --cwd apps/agent codegen` — generates agent code
+4. `bun --cwd apps/server start` and `bun --cwd apps/agent dev` — starts server and agent in parallel
 
 ### Environment Variables
 
@@ -110,7 +108,7 @@ Runtime uses `.env.development`, while production artifact builds use `.env.prod
 |----------|---------|-------------|
 | `BROWSEROS_SERVER_PORT` | 9100 | HTTP server port (MCP, chat, health) |
 | `BROWSEROS_CDP_PORT` | 9000 | Chromium CDP port (server connects as client) |
-| `BROWSEROS_EXTENSION_PORT` | 9300 | Legacy BrowserOS launch arg kept for compatibility |
+| `BROWSEROS_EXTENSION_PORT` | 9300 | WebSocket port for controller extension |
 | `BROWSEROS_CONFIG_URL` | - | Remote config endpoint for rate limits |
 | `BROWSEROS_INSTALL_ID` | - | Unique installation identifier (analytics) |
 | `BROWSEROS_CLIENT_ID` | - | Client identifier (analytics) |
@@ -142,7 +140,7 @@ Copy from `apps/server/.env.production.example` before running `build:server`.
 |----------|---------|-------------|
 | `BROWSEROS_SERVER_PORT` | 9100 | Passed to BrowserOS via CLI args |
 | `BROWSEROS_CDP_PORT` | 9000 | Passed to BrowserOS via CLI args |
-| `BROWSEROS_EXTENSION_PORT` | 9300 | Legacy BrowserOS CLI arg still passed for compatibility |
+| `BROWSEROS_EXTENSION_PORT` | 9300 | Passed to BrowserOS via CLI args |
 | `VITE_BROWSEROS_SERVER_PORT` | 9100 | Agent UI connects to server (must match `BROWSEROS_SERVER_PORT`) |
 | `BROWSEROS_BINARY` | - | Path to BrowserOS binary |
 | `USE_BROWSEROS_BINARY` | true | Use BrowserOS instead of default Chrome |
@@ -159,13 +157,15 @@ bun run start:server          # Start the server
 bun run start:agent           # Start agent extension (dev mode)
 
 # Build
-bun run build                 # Build server and agent
+bun run build                 # Build server, agent, and controller extension
 bun run build:server          # Build production server resource artifacts and upload zips to R2
 bun run build:agent           # Build agent extension
+bun run build:ext             # Build controller extension
 
 # Test
 bun run test                  # Run standard tests
 bun run test:cdp              # Run CDP-based tests
+bun run test:controller       # Run controller-based tests
 bun run test:integration      # Run integration tests
 
 # Quality

packages/browseros-agent/apps/agent/.env.example

@@ -15,6 +15,9 @@ VITE_PUBLIC_SENTRY_DSN=
 # BrowserOS API URL
 VITE_PUBLIC_BROWSEROS_API=https://api.browseros.com
 
+# Launch feature flags
+VITE_PUBLIC_KIMI_LAUNCH=false
+
 # GraphQL Schema Path (optional — falls back to schema/schema.graphql)
 GRAPHQL_SCHEMA_PATH=
 

packages/browseros-agent/apps/agent/CHANGELOG.md

@@ -1,30 +0,0 @@
-# BrowserOS Agent Extension
-
-## v0.0.99 (2026-04-08)
-
-## What's Changed
-
-- chore: bump server and extension version (#659)
-- chore(agent): remove workflows feature (#656)
-- feat: replace model picker with shadcn Combobox + fuse.js fuzzy search (#617)
-- feat: clean-up - remove obsolete controller extension (#610)
-- docs: update agent extension changelog for v0.0.98 (#609)
-
-
-## v0.0.98 (2026-03-27)
-
-## What's Changed
-
-- chore: update agent version (#608)
-- chore: fix version number for extension (#606)
-- fix: improve chat history freshness and reduce query payload (#598)
-- feat: isolate new-tab agent navigation from origin tab (#593)
-- docs: overhaul READMEs across all major packages (#594)
-- fix(ui): resolve MCP promo banner dismiss button overlapping with text (#581)
-- docs: update agent extension changelog for v0.0.52 (#573)
-
-
-## v0.0.52 (2026-03-26)
-
-Initial release
-

packages/browseros-agent/apps/agent/CLAUDE.md

@@ -12,7 +12,7 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 |------|------------|---------|
 | Folders | kebab-case | `ai-settings/`, `jtbd-popup/`, `llm-hub/` |
 | React components (.tsx) | PascalCase | `AISettingsPage.tsx`, `SurveyHeader.tsx` |
-| Hooks (.ts) | camelCase with `use` prefix | `useVoiceInput.ts`, `useMessageTree.ts` |
+| Hooks (.ts) | camelCase with `use` prefix | `useRunWorkflow.ts`, `useVoiceInput.ts` |
 | Non-component files (.ts) | lowercase | `types.ts`, `models.ts`, `storage.ts` |
 
 ## Project Overview

packages/browseros-agent/apps/agent/README.md

@@ -1,24 +1,16 @@
-# BrowserOS Agent Extension
+# BrowserOS Agent Chrome Extension
 
-[![License: AGPL v3](https://img.shields.io/badge/License-AGPL%20v3-blue.svg)](../../../../LICENSE)
-
-The built-in browser extension that powers BrowserOS's AI interface — new tab with unified search, side panel chat, onboarding, and settings. Built with [WXT](https://wxt.dev) and React.
-
-> For user-facing feature documentation, see [docs.browseros.com](https://docs.browseros.com).
+The official Chrome extension for BrowserOS Agent, providing the UI layer for interacting with BrowserOS Core and Controllers. This extension enables intelligent browser automation, AI-powered search, and seamless integration with multiple LLM providers.
 
 ## Features
 
 - **AI-Powered New Tab**: Custom new tab page with unified search across Google and AI assistants
-- **Side Panel Chat**: Full-featured chat interface for interacting with BrowserOS
+- **Side Panel Chat**: Full-featured chat interface for interacting with BrowserOS Core
 - **Multi-Provider Support**: Connect to various LLM providers (OpenAI, Anthropic, Azure, Bedrock, and more)
 - **MCP Integration**: Model Context Protocol support for extending AI capabilities
 - **Visual Feedback**: Animated glow effect on tabs during AI agent operations
 - **Privacy-First**: Local data handling with configurable provider settings
 
-## How It Connects
-
-The extension communicates with the [BrowserOS Server](../../apps/server/) running locally. The server handles the AI agent loop, MCP tools, and CDP connections — the extension provides the UI layer.
-
 ## Project Structure
 
 ```
@@ -88,20 +80,47 @@ Settings dashboard with multiple sections:
 
 Content script that creates a visual indicator (pulsing orange glow) around the browser viewport when an AI agent is actively working on a tab.
 
+## How Tools Are Used
+
+### Bun
+
+Bun is the exclusive runtime and package manager:
+- All scripts use `bun run <script>` instead of npm
+- Package installation via `bun install`
+- Environment files automatically loaded (no dotenv needed)
+- Enforced via `engines` field in `package.json`
+
+```bash
+bun install          # Install dependencies
+bun run dev          # Development mode
+bun run build        # Production build
+bun run lint         # Run Biome linting
+```
+
+### Biome
+
+Unified linter and formatter configured in `biome.json`:
+- **Formatting**: 2-space indentation, single quotes, no semicolons
+- **Linting**: Recommended rules plus custom rules for unused imports/variables
+- **CSS Support**: Tailwind directives parsing enabled
+- **Import Organization**: Automatic import sorting via assist actions
+
+```bash
+bun run lint         # Check for issues
+bun run lint:fix     # Auto-fix issues
+```
+
 ## Development
 
 ### Prerequisites
 
 - [Bun](https://bun.sh) installed
 - Chrome or Chromium-based browser
-- BrowserOS Server running locally (for full functionality)
+- BrowserOS Core running locally (for full functionality)
 
 ### Setup
 
 ```bash
-# Copy environment file
-cp .env.example .env.development
-
 # Install dependencies
 bun install
 
@@ -134,30 +153,12 @@ SENTRY_AUTH_TOKEN=your-token
 
 ### GraphQL Schema
 
-Codegen requires a GraphQL schema. By default it uses the bundled `schema/schema.graphql`, so no extra setup is needed. If you have access to the original API source, you can set the following environment variable:
+Codegen requires a GraphQL schema. By default it uses the bundled `schema/schema.graphql`, so no extra setup is needed. If you have access to the original API source, you can set the following environment variable
 
 ```env
 GRAPHQL_SCHEMA_PATH=/path/to/api-repo/.../schema.graphql
 ```
 
-## Development Tooling
-
-### Bun
-
-Bun is the exclusive runtime and package manager:
-- All scripts use `bun run <script>` instead of npm
-- Package installation via `bun install`
-- Environment files automatically loaded (no dotenv needed)
-- Enforced via `engines` field in `package.json`
-
-### Biome
-
-Unified linter and formatter configured in `biome.json`:
-- **Formatting**: 2-space indentation, single quotes, no semicolons
-- **Linting**: Recommended rules plus custom rules for unused imports/variables
-- **CSS Support**: Tailwind directives parsing enabled
-- **Import Organization**: Automatic import sorting via assist actions
-
 ## Scripts
 
 | Script | Description |
@@ -168,5 +169,4 @@ Unified linter and formatter configured in `biome.json`:
 | `bun run lint` | Run Biome linter |
 | `bun run lint:fix` | Auto-fix linting issues |
 | `bun run typecheck` | Run TypeScript type checking |
-| `bun run codegen` | Generate GraphQL types |
 | `bun run clean:cache` | Clear build caches |

packages/browseros-agent/apps/agent/biome.json

@@ -1,5 +1,5 @@
 {
-  "$schema": "https://biomejs.dev/schemas/2.4.8/schema.json",
+  "$schema": "https://biomejs.dev/schemas/2.4.5/schema.json",
   "root": false,
   "extends": "//",
   "vcs": {

packages/browseros-agent/apps/agent/components/ai-elements/run-result-dialog.tsx

@@ -66,7 +66,7 @@ export const RunResultDialog: FC<RunResultDialogProps> = ({
 
   return (
     <Dialog open={!!run} onOpenChange={onOpenChange}>
-      <DialogContent className="sm:w-[70vw] sm:max-w-4xl">
+      <DialogContent className="sm:max-w-2xl">
         <DialogHeader>
           <DialogTitle className="flex items-center gap-2">
             {run.status === 'completed' ? (
@@ -94,7 +94,7 @@ export const RunResultDialog: FC<RunResultDialogProps> = ({
               <p className="text-destructive text-sm">{run.result}</p>
             </div>
           ) : run.result ? (
-            <div className="prose prose-sm dark:prose-invert [&_[data-streamdown='code-block']]:!w-full [&_[data-streamdown='table-wrapper']]:!w-full max-w-none break-words rounded-lg border border-border bg-muted/50 p-4 [&_[data-streamdown='table-wrapper']]:overflow-x-auto">
+            <div className="prose prose-sm dark:prose-invert [&_[data-streamdown='code-block']]:!w-full [&_[data-streamdown='table-wrapper']]:!w-full max-w-none break-words rounded-lg border border-border bg-muted/50 p-4">
               <MessageResponse>{run.result}</MessageResponse>
             </div>
           ) : (

packages/browseros-agent/apps/agent/components/chat/ChatProviderSelector.tsx

@@ -1,4 +1,4 @@
-import { Check, Plus } from 'lucide-react'
+import { Check } from 'lucide-react'
 import type { FC, PropsWithChildren } from 'react'
 import { useState } from 'react'
 import {
@@ -77,19 +77,6 @@ export const ChatProviderSelector: FC<
                 )
               })}
             </CommandGroup>
-            <div className="border-border border-t p-1">
-              <button
-                type="button"
-                className="flex w-full items-center gap-3 rounded-md p-2 text-muted-foreground text-sm transition-colors hover:bg-accent hover:text-foreground"
-                onClick={() => {
-                  window.open('/app.html#/settings/ai', '_blank')
-                  setOpen(false)
-                }}
-              >
-                <Plus className="h-4 w-4" />
-                Add Provider
-              </button>
-            </div>
           </CommandList>
         </Command>
       </PopoverContent>

packages/browseros-agent/apps/agent/components/credits/CreditBadge.tsx

@@ -1,26 +0,0 @@
-import { Coins } from 'lucide-react'
-import type { FC } from 'react'
-import { getCreditTextColor } from '@/lib/credits/credit-colors'
-import { cn } from '@/lib/utils'
-
-interface CreditBadgeProps {
-  credits: number
-  onClick?: () => void
-}
-
-export const CreditBadge: FC<CreditBadgeProps> = ({ credits, onClick }) => {
-  return (
-    <button
-      type="button"
-      onClick={onClick}
-      className={cn(
-        'inline-flex cursor-pointer items-center gap-1 rounded-md px-1.5 py-0.5 font-medium text-xs transition-colors hover:bg-muted/50',
-        getCreditTextColor(credits),
-      )}
-      title={`${credits} credits remaining`}
-    >
-      <Coins className="h-3.5 w-3.5" />
-      <span>{credits}</span>
-    </button>
-  )
-}

packages/browseros-agent/apps/agent/components/execution-history/ExecutionStepItem.tsx

@@ -1,143 +0,0 @@
-import {
-  CheckCircle2,
-  ChevronDown,
-  CircleDotDashed,
-  Clock3,
-  ShieldAlert,
-  ShieldCheck,
-  XCircle,
-} from 'lucide-react'
-import { type FC, useState } from 'react'
-import { ToolInput, ToolOutput } from '@/components/ai-elements/tool'
-import { Badge } from '@/components/ui/badge'
-import {
-  Collapsible,
-  CollapsibleContent,
-  CollapsibleTrigger,
-} from '@/components/ui/collapsible'
-import type { ExecutionStepRecord } from '@/lib/execution-history/types'
-import { cn } from '@/lib/utils'
-
-const formatToolName = (name: string) =>
-  name
-    .replace(/_/g, ' ')
-    .replace(/([a-z])([A-Z])/g, '$1 $2')
-    .replace(/^./, (value) => value.toUpperCase())
-
-const formatStateLabel = (state: ExecutionStepRecord['state']) => {
-  if (state === 'input-streaming') return 'Preparing'
-  if (state === 'input-available') return 'Running'
-  if (state === 'approval-requested') return 'Approval Needed'
-  if (state === 'approval-responded') return 'Approval Responded'
-  if (state === 'output-available') return 'Completed'
-  if (state === 'output-denied') return 'Denied'
-  return 'Error'
-}
-
-const getStateIcon = (step: ExecutionStepRecord) => {
-  if (step.state === 'output-available') {
-    return <CheckCircle2 className="h-4 w-4 text-green-500" />
-  }
-
-  if (
-    step.state === 'input-streaming' ||
-    step.state === 'input-available' ||
-    step.state === 'approval-requested'
-  ) {
-    return <Clock3 className="h-4 w-4 text-[var(--accent-orange)]" />
-  }
-
-  if (step.state === 'approval-responded') {
-    return <ShieldCheck className="h-4 w-4 text-blue-500" />
-  }
-
-  if (step.state === 'output-denied') {
-    return <ShieldAlert className="h-4 w-4 text-orange-500" />
-  }
-
-  if (step.state === 'output-error') {
-    return <XCircle className="h-4 w-4 text-destructive" />
-  }
-
-  return <CircleDotDashed className="h-4 w-4 text-muted-foreground" />
-}
-
-const isAclBlocked = (step: ExecutionStepRecord) =>
-  Boolean(
-    step.errorText?.includes('Action blocked by ACL rule') ||
-      step.approval?.reason?.includes('Action blocked by ACL rule') ||
-      step.previewText === 'Blocked by ACL rule',
-  )
-
-const shouldShowPreview = (step: ExecutionStepRecord) =>
-  step.state === 'input-streaming' ||
-  step.state === 'input-available' ||
-  step.state === 'approval-requested' ||
-  step.state === 'approval-responded'
-
-export const ExecutionStepItem: FC<{
-  step: ExecutionStepRecord
-  defaultOpen?: boolean
-}> = ({ step, defaultOpen = false }) => {
-  const [open, setOpen] = useState(defaultOpen)
-  const deniedReason =
-    step.state === 'output-denied' ? step.approval?.reason : undefined
-
-  return (
-    <Collapsible open={open} onOpenChange={setOpen}>
-      <div className="rounded-xl border border-border/60 bg-card/60">
-        <CollapsibleTrigger asChild>
-          <button
-            type="button"
-            className="flex w-full items-start gap-3 px-4 py-3 text-left"
-          >
-            <div className="mt-0.5 shrink-0">{getStateIcon(step)}</div>
-            <div className="min-w-0 flex-1">
-              <div className="flex flex-wrap items-center gap-2">
-                <p className="font-medium text-foreground text-sm">
-                  {formatToolName(step.toolName)}
-                </p>
-                <Badge variant="secondary">
-                  {formatStateLabel(step.state)}
-                </Badge>
-                {isAclBlocked(step) && (
-                  <Badge variant="outline">ACL Blocked</Badge>
-                )}
-              </div>
-              {shouldShowPreview(step) && (
-                <p className="mt-1 text-muted-foreground text-xs">
-                  {step.previewText}
-                </p>
-              )}
-            </div>
-            <ChevronDown
-              className={cn(
-                'mt-0.5 h-4 w-4 shrink-0 text-muted-foreground transition-transform',
-                open && 'rotate-180',
-              )}
-            />
-          </button>
-        </CollapsibleTrigger>
-        <CollapsibleContent className="border-border/60 border-t">
-          {step.input !== undefined && <ToolInput input={step.input} />}
-          {step.state === 'output-denied' ? (
-            <div className="space-y-2 p-4">
-              <h4 className="font-medium text-muted-foreground text-xs uppercase tracking-wide">
-                Result
-              </h4>
-              <div className="rounded-md bg-orange-500/10 p-3 text-orange-700 text-sm dark:text-orange-300">
-                {deniedReason ?? 'The requested action was denied.'}
-              </div>
-            </div>
-          ) : (
-            <ToolOutput
-              output={step.output}
-              errorText={step.errorText}
-              className="pt-0"
-            />
-          )}
-        </CollapsibleContent>
-      </div>
-    </Collapsible>
-  )
-}

packages/browseros-agent/apps/agent/components/execution-history/ExecutionTaskCard.tsx

@@ -1,168 +0,0 @@
-import dayjs from 'dayjs'
-import duration from 'dayjs/plugin/duration'
-import relativeTime from 'dayjs/plugin/relativeTime'
-import {
-  CheckCircle2,
-  ChevronDown,
-  CircleDot,
-  CircleSlash2,
-  MessageSquareText,
-  Trash2,
-  XCircle,
-} from 'lucide-react'
-import { type FC, useMemo, useState } from 'react'
-import { Badge } from '@/components/ui/badge'
-import { Button } from '@/components/ui/button'
-import {
-  Collapsible,
-  CollapsibleContent,
-  CollapsibleTrigger,
-} from '@/components/ui/collapsible'
-import type { ExecutionTaskRecord } from '@/lib/execution-history/types'
-import { cn } from '@/lib/utils'
-import { ExecutionStepItem } from './ExecutionStepItem'
-
-dayjs.extend(relativeTime)
-dayjs.extend(duration)
-
-function getTaskStatusIcon(status: ExecutionTaskRecord['status']) {
-  if (status === 'completed') {
-    return <CheckCircle2 className="h-4 w-4 text-green-500" />
-  }
-
-  if (status === 'running') {
-    return <CircleDot className="h-4 w-4 text-[var(--accent-orange)]" />
-  }
-
-  if (status === 'stopped') {
-    return <CircleSlash2 className="h-4 w-4 text-orange-500" />
-  }
-
-  return <XCircle className="h-4 w-4 text-destructive" />
-}
-
-function getTaskStatusLabel(status: ExecutionTaskRecord['status']) {
-  if (status === 'completed') return 'Completed'
-  if (status === 'running') return 'Running'
-  if (status === 'stopped') return 'Stopped'
-  if (status === 'interrupted') return 'Interrupted'
-  return 'Failed'
-}
-
-function formatDuration(task: ExecutionTaskRecord): string | null {
-  if (!task.completedAt) return null
-  const diff = dayjs(task.completedAt).diff(task.startedAt)
-  const parsed = dayjs.duration(diff)
-  const minutes = Math.floor(parsed.asMinutes())
-  const seconds = parsed.seconds()
-  if (minutes === 0) return `${seconds}s`
-  return `${minutes}m ${seconds}s`
-}
-
-export const ExecutionTaskCard: FC<{
-  task: ExecutionTaskRecord
-  defaultOpen?: boolean
-  onDelete?: (task: ExecutionTaskRecord) => void
-}> = ({ task, defaultOpen = false, onDelete }) => {
-  const [open, setOpen] = useState(defaultOpen)
-  const startedAgo = useMemo(
-    () => dayjs(task.startedAt).fromNow(),
-    [task.startedAt],
-  )
-
-  return (
-    <Collapsible open={open} onOpenChange={setOpen}>
-      <div className="rounded-2xl border border-border/60 bg-card shadow-sm">
-        <div className="flex items-start gap-2 px-5 py-5">
-          <CollapsibleTrigger asChild>
-            <button
-              type="button"
-              className="flex min-w-0 flex-1 items-start gap-3 text-left"
-            >
-              <div className="mt-0.5 shrink-0">
-                {getTaskStatusIcon(task.status)}
-              </div>
-              <div className="min-w-0 flex-1">
-                <div className="flex flex-wrap items-center gap-2">
-                  <p className="line-clamp-2 font-medium text-base text-foreground">
-                    {task.promptText}
-                  </p>
-                  <Badge variant="secondary">
-                    {getTaskStatusLabel(task.status)}
-                  </Badge>
-                </div>
-                <div className="mt-2 flex flex-wrap items-center gap-2 text-muted-foreground text-xs">
-                  <span>{startedAgo}</span>
-                  <span>•</span>
-                  <span>
-                    {task.actionCount} action{task.actionCount === 1 ? '' : 's'}
-                  </span>
-                  {formatDuration(task) && (
-                    <>
-                      <span>•</span>
-                      <span>{formatDuration(task)}</span>
-                    </>
-                  )}
-                  {task.deniedCount > 0 && (
-                    <Badge variant="outline" className="h-5 rounded-full px-2">
-                      {task.deniedCount} denied
-                    </Badge>
-                  )}
-                  {task.errorCount > 0 && (
-                    <Badge variant="outline" className="h-5 rounded-full px-2">
-                      {task.errorCount} error
-                      {task.errorCount === 1 ? '' : 's'}
-                    </Badge>
-                  )}
-                </div>
-                {task.responsePreview ? (
-                  <div className="mt-4 flex items-start gap-2 rounded-xl bg-muted/40 px-3 py-2 text-muted-foreground text-sm">
-                    <MessageSquareText className="mt-0.5 h-4 w-4 shrink-0" />
-                    <p className="line-clamp-2">{task.responsePreview}</p>
-                  </div>
-                ) : null}
-              </div>
-              <ChevronDown
-                className={cn(
-                  'mt-1 h-4 w-4 shrink-0 text-muted-foreground transition-transform',
-                  open && 'rotate-180',
-                )}
-              />
-            </button>
-          </CollapsibleTrigger>
-          {onDelete ? (
-            <Button
-              type="button"
-              variant="ghost"
-              size="icon-sm"
-              className="mt-0.5 shrink-0 text-muted-foreground hover:text-foreground"
-              onClick={() => onDelete(task)}
-              aria-label={`Delete ${task.promptText}`}
-            >
-              <Trash2 className="size-4" />
-            </Button>
-          ) : null}
-        </div>
-        <CollapsibleContent className="border-border/60 border-t px-5 py-5">
-          {task.steps.length === 0 ? (
-            <div className="rounded-xl border border-border/70 border-dashed bg-muted/30 px-4 py-6 text-center text-muted-foreground text-sm">
-              No tool actions were recorded for this task.
-            </div>
-          ) : (
-            <div className="space-y-3">
-              {task.steps.map((step, index) => (
-                <ExecutionStepItem
-                  key={step.id}
-                  step={step}
-                  defaultOpen={
-                    task.status === 'running' && index === task.steps.length - 1
-                  }
-                />
-              ))}
-            </div>
-          )}
-        </CollapsibleContent>
-      </div>
-    </Collapsible>
-  )
-}

packages/browseros-agent/apps/agent/components/sidebar/SettingsSidebar.tsx

@@ -3,14 +3,12 @@ import {
   BookOpen,
   Bot,
   Compass,
-  CreditCard,
+  GitBranch,
   MessageSquare,
   Palette,
   RotateCcw,
   Search,
   Server,
-  ShieldAlert,
-  ShieldCheck,
 } from 'lucide-react'
 import type { FC } from 'react'
 import { NavLink } from 'react-router'
@@ -80,14 +78,12 @@ const primarySettingsSections: NavSection[] = [
         icon: Palette,
         feature: Feature.CUSTOMIZATION_SUPPORT,
       },
-      { name: 'Tool Approvals', to: '/settings/approvals', icon: ShieldCheck },
       { name: 'BrowserOS as MCP', to: '/settings/mcp', icon: Server },
-      { name: 'ACL Rules', to: '/settings/acl', icon: ShieldAlert },
       {
-        name: 'Usage & Billing',
-        to: '/settings/usage',
-        icon: CreditCard,
-        feature: Feature.CREDITS_SUPPORT,
+        name: 'Workflows',
+        to: '/workflows',
+        icon: GitBranch,
+        feature: Feature.WORKFLOW_SUPPORT,
       },
     ],
   },

packages/browseros-agent/apps/agent/components/sidebar/SidebarNavigation.tsx

@@ -1,11 +1,9 @@
 import {
   Brain,
   CalendarClock,
-  Cpu,
   Home,
   PlugZap,
   Settings,
-  Shield,
   Sparkles,
   Wand2,
 } from 'lucide-react'
@@ -41,7 +39,6 @@ const primaryNavItems: NavItem[] = [
     feature: Feature.MANAGED_MCP_SUPPORT,
   },
   { name: 'Scheduled Tasks', to: '/scheduled', icon: CalendarClock },
-  { name: 'Agents', to: '/agents', icon: Cpu },
   {
     name: 'Skills',
     to: '/home/skills',
@@ -60,7 +57,6 @@ const primaryNavItems: NavItem[] = [
     icon: Sparkles,
     feature: Feature.SOUL_SUPPORT,
   },
-  { name: 'Governance', to: '/admin', icon: Shield },
   { name: 'Settings', to: '/settings/ai', icon: Settings },
 ]
 

packages/browseros-agent/apps/agent/components/ui/alert-dialog.tsx

@@ -176,14 +176,14 @@ function AlertDialogCancel({
 
 export {
   AlertDialog,
+  AlertDialogPortal,
+  AlertDialogOverlay,
+  AlertDialogTrigger,
+  AlertDialogContent,
+  AlertDialogHeader,
+  AlertDialogFooter,
+  AlertDialogTitle,
+  AlertDialogDescription,
   AlertDialogAction,
   AlertDialogCancel,
-  AlertDialogContent,
-  AlertDialogDescription,
-  AlertDialogFooter,
-  AlertDialogHeader,
-  AlertDialogOverlay,
-  AlertDialogPortal,
-  AlertDialogTitle,
-  AlertDialogTrigger,
 }

packages/browseros-agent/apps/agent/components/ui/alert.tsx

@@ -72,4 +72,4 @@ function AlertDescription({
   )
 }
 
-export { Alert, AlertDescription, AlertTitle }
+export { Alert, AlertTitle, AlertDescription }

packages/browseros-agent/apps/agent/components/ui/card.tsx

@@ -104,10 +104,10 @@ function CardFooter({ className, ...props }: React.ComponentProps<'div'>) {
 
 export {
   Card,
-  CardAction,
-  CardContent,
-  CardDescription,
-  CardFooter,
   CardHeader,
+  CardFooter,
   CardTitle,
+  CardAction,
+  CardDescription,
+  CardContent,
 }

packages/browseros-agent/apps/agent/components/ui/carousel.tsx

@@ -251,10 +251,10 @@ function CarouselNext({
 }
 
 export {
-  Carousel,
   type CarouselApi,
+  Carousel,
   CarouselContent,
   CarouselItem,
-  CarouselNext,
   CarouselPrevious,
+  CarouselNext,
 }

packages/browseros-agent/apps/agent/components/ui/collapsible.tsx

@@ -39,4 +39,4 @@ function CollapsibleContent({
   )
 }
 
-export { Collapsible, CollapsibleContent, CollapsibleTrigger }
+export { Collapsible, CollapsibleTrigger, CollapsibleContent }

packages/browseros-agent/apps/agent/components/ui/command.tsx

@@ -198,11 +198,11 @@ function CommandShortcut({
 export {
   Command,
   CommandDialog,
+  CommandInput,
+  CommandList,
   CommandEmpty,
   CommandGroup,
-  CommandInput,
   CommandItem,
-  CommandList,
-  CommandSeparator,
   CommandShortcut,
+  CommandSeparator,
 }

packages/browseros-agent/apps/agent/components/ui/dropdown-menu.tsx

@@ -283,18 +283,18 @@ function DropdownMenuSubContent({
 
 export {
   DropdownMenu,
-  DropdownMenuCheckboxItem,
+  DropdownMenuPortal,
+  DropdownMenuTrigger,
   DropdownMenuContent,
   DropdownMenuGroup,
-  DropdownMenuItem,
   DropdownMenuLabel,
-  DropdownMenuPortal,
+  DropdownMenuItem,
+  DropdownMenuCheckboxItem,
   DropdownMenuRadioGroup,
   DropdownMenuRadioItem,
   DropdownMenuSeparator,
   DropdownMenuShortcut,
   DropdownMenuSub,
-  DropdownMenuSubContent,
   DropdownMenuSubTrigger,
-  DropdownMenuTrigger,
+  DropdownMenuSubContent,
 }

packages/browseros-agent/apps/agent/components/ui/form.tsx

@@ -179,12 +179,12 @@ function FormMessage({ className, ...props }: React.ComponentProps<'p'>) {
 }
 
 export {
+  useFormField,
   Form,
-  FormControl,
-  FormDescription,
-  FormField,
   FormItem,
   FormLabel,
+  FormControl,
+  FormDescription,
   FormMessage,
-  useFormField,
+  FormField,
 }

packages/browseros-agent/apps/agent/components/ui/hover-card.tsx

@@ -50,4 +50,4 @@ function HoverCardContent({
   )
 }
 
-export { HoverCard, HoverCardContent, HoverCardTrigger }
+export { HoverCard, HoverCardTrigger, HoverCardContent }

packages/browseros-agent/apps/agent/components/ui/input-group.tsx

@@ -184,7 +184,7 @@ export {
   InputGroup,
   InputGroupAddon,
   InputGroupButton,
-  InputGroupInput,
   InputGroupText,
+  InputGroupInput,
   InputGroupTextarea,
 }

packages/browseros-agent/apps/agent/components/ui/popover.tsx

@@ -55,4 +55,4 @@ function PopoverAnchor({
   return <PopoverPrimitive.Anchor data-slot="popover-anchor" {...props} />
 }
 
-export { Popover, PopoverAnchor, PopoverContent, PopoverTrigger }
+export { Popover, PopoverTrigger, PopoverContent, PopoverAnchor }

packages/browseros-agent/apps/agent/components/ui/resizable.tsx

@@ -49,4 +49,4 @@ function ResizableHandle({
   )
 }
 
-export { ResizableHandle, ResizablePanel, ResizablePanelGroup }
+export { ResizablePanelGroup, ResizablePanel, ResizableHandle }

packages/browseros-agent/apps/agent/components/ui/sheet.tsx

@@ -129,11 +129,11 @@ function SheetDescription({
 
 export {
   Sheet,
+  SheetTrigger,
   SheetClose,
   SheetContent,
-  SheetDescription,
-  SheetFooter,
   SheetHeader,
+  SheetFooter,
   SheetTitle,
-  SheetTrigger,
+  SheetDescription,
 }

packages/browseros-agent/apps/agent/components/ui/sonner.tsx

@@ -18,7 +18,6 @@ const Toaster = ({ ...props }: ToasterProps) => {
     <Sonner
       theme={theme as ToasterProps['theme']}
       className="toaster group"
-      closeButton
       icons={{
         success: <CircleCheckIcon className="size-4" />,
         info: <InfoIcon className="size-4" />,

packages/browseros-agent/apps/agent/components/ui/tabs.tsx

@@ -86,4 +86,4 @@ function TabsContent({
   )
 }
 
-export { Tabs, TabsContent, TabsList, TabsTrigger, tabsListVariants }
+export { Tabs, TabsList, TabsTrigger, TabsContent, tabsListVariants }

packages/browseros-agent/apps/agent/components/ui/tooltip.tsx

@@ -68,4 +68,4 @@ function TooltipContent({
   )
 }
 
-export { Tooltip, TooltipContent, TooltipProvider, TooltipTrigger }
+export { Tooltip, TooltipTrigger, TooltipContent, TooltipProvider }

packages/browseros-agent/apps/agent/entrypoints/app/App.tsx

@@ -1,20 +1,16 @@
 import type { FC } from 'react'
 import { HashRouter, Navigate, Route, Routes, useParams } from 'react-router'
-import { NewTabChat } from '../newtab/index/NewTabChat'
+
+import { NewTab } from '../newtab/index/NewTab'
 import { NewTabLayout } from '../newtab/layout/NewTabLayout'
 import { Personalize } from '../newtab/personalize/Personalize'
 import { OnboardingDemo } from '../onboarding/demo/OnboardingDemo'
 import { FeaturesPage } from '../onboarding/features/Features'
 import { Onboarding } from '../onboarding/index/Onboarding'
 import { StepsLayout } from '../onboarding/steps/StepsLayout'
-import { AclSettingsPage } from './acl-settings/AclSettingsPage'
-import { AdminDashboardPage } from './admin-dashboard/AdminDashboardPage'
-import { AgentCommandConversation } from './agent-command/AgentCommandConversation'
-import { AgentCommandHome } from './agent-command/AgentCommandHome'
-import { AgentCommandLayout } from './agent-command/agent-command-layout'
-import { AgentsPage } from './agents/AgentsPage'
 import { AISettingsPage } from './ai-settings/AISettingsPage'
 import { ConnectMCP } from './connect-mcp/ConnectMCP'
+import { CreateGraphWrapper } from './create-graph/CreateGraphWrapper'
 import { CustomizationPage } from './customization/CustomizationPage'
 import { SurveyPage } from './jtbd-agent/SurveyPage'
 import { AuthLayout } from './layout/AuthLayout'
@@ -31,8 +27,7 @@ import { ScheduledTasksPage } from './scheduled-tasks/ScheduledTasksPage'
 import { SearchProviderPage } from './search-provider/SearchProviderPage'
 import { SkillsPage } from './skills/SkillsPage'
 import { SoulPage } from './soul/SoulPage'
-import { ToolApprovalsPage } from './tool-approvals/ToolApprovalsPage'
-import { UsagePage } from './usage/UsagePage'
+import { WorkflowsPageWrapper } from './workflows/WorkflowsPageWrapper'
 
 function getSurveyParams(): { maxTurns?: number; experimentId?: string } {
   const params = new URLSearchParams(window.location.search)
@@ -56,7 +51,9 @@ const OptionsRedirect: FC = () => {
     soul: '/home/soul',
     skills: '/home/skills',
     'jtbd-agent': '/settings/survey',
+    workflows: '/workflows',
     scheduled: '/scheduled',
+    'create-graph': '/workflows/create-graph',
   }
 
   const newPath = routeMap[path] || '/settings/ai'
@@ -81,14 +78,7 @@ export const App: FC = () => {
         <Route element={<SidebarLayout />}>
           {/* Home routes */}
           <Route path="home" element={<NewTabLayout />}>
-            <Route element={<AgentCommandLayout />}>
-              <Route index element={<AgentCommandHome />} />
-              <Route
-                path="agents/:agentId"
-                element={<AgentCommandConversation />}
-              />
-            </Route>
-            <Route path="chat" element={<NewTabChat />} />
+            <Route index element={<NewTab />} />
             <Route path="personalize" element={<Personalize />} />
             <Route path="soul" element={<SoulPage />} />
             <Route path="skills" element={<SkillsPage />} />
@@ -97,9 +87,8 @@ export const App: FC = () => {
 
           {/* Primary nav routes */}
           <Route path="connect-apps" element={<ConnectMCP />} />
+          <Route path="workflows" element={<WorkflowsPageWrapper />} />
           <Route path="scheduled" element={<ScheduledTasksPage />} />
-          <Route path="agents" element={<AgentsPage />} />
-          <Route path="admin" element={<AdminDashboardPage />} />
         </Route>
 
         {/* Settings with dedicated sidebar */}
@@ -112,12 +101,12 @@ export const App: FC = () => {
             <Route path="customization" element={<CustomizationPage />} />
             <Route path="search" element={<SearchProviderPage />} />
             <Route path="survey" element={<SurveyPage {...surveyParams} />} />
-            <Route path="usage" element={<UsagePage />} />
-            <Route path="acl" element={<AclSettingsPage />} />
-            <Route path="approvals" element={<ToolApprovalsPage />} />
           </Route>
         </Route>
 
+        {/* Full-screen without sidebar */}
+        <Route path="workflows/create-graph" element={<CreateGraphWrapper />} />
+
         {/* Onboarding routes - no sidebar, no auth required */}
         <Route path="onboarding">
           <Route index element={<Onboarding />} />
@@ -144,12 +133,6 @@ export const App: FC = () => {
           path="/settings/skills"
           element={<Navigate to="/home/skills" replace />}
         />
-        <Route path="/audit" element={<Navigate to="/admin" replace />} />
-        <Route
-          path="/observability"
-          element={<Navigate to="/admin" replace />}
-        />
-        <Route path="/executions" element={<Navigate to="/admin" replace />} />
         <Route path="/options/*" element={<OptionsRedirect />} />
 
         {/* Fallback to home */}

packages/browseros-agent/apps/agent/entrypoints/app/acl-settings/AclRuleCard.tsx

@@ -1,57 +0,0 @@
-import type { AclRule } from '@browseros/shared/types/acl'
-import { Globe, Trash2 } from 'lucide-react'
-import type { FC } from 'react'
-import { Badge } from '@/components/ui/badge'
-import { Button } from '@/components/ui/button'
-import { Switch } from '@/components/ui/switch'
-import { cn } from '@/lib/utils'
-
-interface AclRuleCardProps {
-  rule: AclRule
-  onToggle: (id: string, enabled: boolean) => void
-  onDelete: (id: string) => void
-}
-
-export const AclRuleCard: FC<AclRuleCardProps> = ({
-  rule,
-  onToggle,
-  onDelete,
-}) => {
-  const summary =
-    rule.description ?? rule.textMatch ?? rule.selector ?? 'Block actions'
-
-  return (
-    <div
-      className={cn(
-        'flex items-center gap-4 rounded-xl border p-4 transition-all',
-        rule.enabled
-          ? 'border-red-300 bg-red-50/50 dark:border-red-800 dark:bg-red-950/20'
-          : 'border-border bg-card opacity-60',
-      )}
-    >
-      <Switch
-        checked={rule.enabled}
-        onCheckedChange={(checked) => onToggle(rule.id, checked)}
-      />
-
-      <div className="flex min-w-0 flex-1 flex-col gap-1">
-        <span className="truncate font-medium text-sm">{summary}</span>
-        <div className="flex flex-wrap items-center gap-2">
-          <Badge variant="secondary" className="gap-1 font-mono text-xs">
-            <Globe className="size-3" />
-            {rule.sitePattern}
-          </Badge>
-        </div>
-      </div>
-
-      <Button
-        variant="ghost"
-        size="icon"
-        className="shrink-0 text-muted-foreground hover:text-destructive"
-        onClick={() => onDelete(rule.id)}
-      >
-        <Trash2 className="size-4" />
-      </Button>
-    </div>
-  )
-}

packages/browseros-agent/apps/agent/entrypoints/app/acl-settings/AclSettingsPage.tsx

@@ -1,85 +0,0 @@
-import type { AclRule } from '@browseros/shared/types/acl'
-import { Plus, ShieldAlert } from 'lucide-react'
-import { type FC, useEffect, useState } from 'react'
-import { Button } from '@/components/ui/button'
-import { aclRulesStorage } from '@/lib/acl/storage'
-import { AclRuleCard } from './AclRuleCard'
-import { NewAclRuleDialog } from './NewAclRuleDialog'
-
-export const AclSettingsPage: FC = () => {
-  const [rules, setRules] = useState<AclRule[]>([])
-
-  useEffect(() => {
-    aclRulesStorage.getValue().then(setRules)
-    const unwatch = aclRulesStorage.watch(setRules)
-    return () => unwatch()
-  }, [])
-
-  const saveRules = (next: AclRule[]) => {
-    setRules(next)
-    aclRulesStorage.setValue(next)
-  }
-
-  const handleAddRule = (rule: AclRule) => {
-    saveRules([...rules, rule])
-  }
-
-  const handleToggle = (id: string, enabled: boolean) => {
-    saveRules(rules.map((r) => (r.id === id ? { ...r, enabled } : r)))
-  }
-
-  const handleDelete = (id: string) => {
-    saveRules(rules.filter((r) => r.id !== id))
-  }
-
-  return (
-    <div className="mx-auto max-w-2xl p-6">
-      <div className="mb-6 flex items-center justify-between">
-        <div>
-          <h1 className="font-semibold text-xl">ACL Rules</h1>
-          <p className="mt-1 text-muted-foreground text-sm">
-            Describe what the agent should avoid on a site and BrowserOS will
-            block matching actions.
-          </p>
-        </div>
-        <NewAclRuleDialog onSave={handleAddRule}>
-          <Button size="sm">
-            <Plus className="mr-1 size-4" />
-            Add Rule
-          </Button>
-        </NewAclRuleDialog>
-      </div>
-
-      {rules.length === 0 ? (
-        <div className="flex flex-col items-center gap-3 rounded-xl border border-dashed p-12 text-center">
-          <ShieldAlert className="size-10 text-muted-foreground" />
-          <div>
-            <p className="font-medium">No ACL rules defined</p>
-            <p className="mt-1 text-muted-foreground text-sm">
-              Add a plain-English rule like &ldquo;payments and checkout&rdquo;
-              or &ldquo;send email&rdquo; and BrowserOS will apply broad safety
-              blocking on that site.
-            </p>
-          </div>
-          <NewAclRuleDialog onSave={handleAddRule}>
-            <Button variant="outline" size="sm">
-              <Plus className="mr-1 size-4" />
-              Add your first rule
-            </Button>
-          </NewAclRuleDialog>
-        </div>
-      ) : (
-        <div className="flex flex-col gap-3">
-          {rules.map((rule) => (
-            <AclRuleCard
-              key={rule.id}
-              rule={rule}
-              onToggle={handleToggle}
-              onDelete={handleDelete}
-            />
-          ))}
-        </div>
-      )}
-    </div>
-  )
-}

packages/browseros-agent/apps/agent/entrypoints/app/acl-settings/NewAclRuleDialog.tsx

@@ -1,98 +0,0 @@
-import type { AclRule } from '@browseros/shared/types/acl'
-import { type FC, useState } from 'react'
-import { Button } from '@/components/ui/button'
-import {
-  Dialog,
-  DialogContent,
-  DialogFooter,
-  DialogHeader,
-  DialogTitle,
-  DialogTrigger,
-} from '@/components/ui/dialog'
-import { Input } from '@/components/ui/input'
-import { Label } from '@/components/ui/label'
-
-interface NewAclRuleDialogProps {
-  onSave: (rule: AclRule) => void
-  children: React.ReactNode
-}
-
-export const NewAclRuleDialog: FC<NewAclRuleDialogProps> = ({
-  onSave,
-  children,
-}) => {
-  const [open, setOpen] = useState(false)
-  const [sitePattern, setSitePattern] = useState('')
-  const [intent, setIntent] = useState('')
-
-  const reset = () => {
-    setSitePattern('')
-    setIntent('')
-  }
-
-  const handleSave = () => {
-    if (!sitePattern.trim() || !intent.trim()) return
-    onSave({
-      id: crypto.randomUUID(),
-      sitePattern: sitePattern.trim(),
-      description: intent.trim(),
-      enabled: true,
-    })
-    reset()
-    setOpen(false)
-  }
-
-  return (
-    <Dialog open={open} onOpenChange={setOpen}>
-      <DialogTrigger asChild>{children}</DialogTrigger>
-      <DialogContent>
-        <DialogHeader>
-          <DialogTitle>Add ACL Rule</DialogTitle>
-        </DialogHeader>
-        <div className="flex flex-col gap-4 py-4">
-          <div className="flex flex-col gap-2">
-            <Label htmlFor="site-pattern">
-              Domain <span className="text-destructive">*</span>
-            </Label>
-            <Input
-              id="site-pattern"
-              placeholder="amazon.com"
-              value={sitePattern}
-              onChange={(e) => setSitePattern(e.target.value)}
-            />
-            <p className="text-muted-foreground text-xs">
-              Matches the domain and all subdomains.
-            </p>
-          </div>
-          <div className="flex flex-col gap-2">
-            <Label htmlFor="intent">
-              What should BrowserOS block?{' '}
-              <span className="text-destructive">*</span>
-            </Label>
-            <Input
-              id="intent"
-              placeholder="Payments and checkout"
-              value={intent}
-              onChange={(e) => setIntent(e.target.value)}
-            />
-            <p className="text-muted-foreground text-xs">
-              Use plain English. BrowserOS will block matching actions on this
-              site.
-            </p>
-          </div>
-        </div>
-        <DialogFooter>
-          <Button variant="outline" onClick={() => setOpen(false)}>
-            Cancel
-          </Button>
-          <Button
-            onClick={handleSave}
-            disabled={!sitePattern.trim() || !intent.trim()}
-          >
-            Add Rule
-          </Button>
-        </DialogFooter>
-      </DialogContent>
-    </Dialog>
-  )
-}

packages/browseros-agent/apps/agent/entrypoints/app/admin-dashboard/AdminDashboardHeader.tsx

@@ -1,41 +0,0 @@
-import { Shield } from 'lucide-react'
-import type { FC } from 'react'
-import { Badge } from '@/components/ui/badge'
-
-interface AdminDashboardHeaderProps {
-  pendingCount: number
-  runningCount: number
-}
-
-export const AdminDashboardHeader: FC<AdminDashboardHeaderProps> = ({
-  pendingCount,
-  runningCount,
-}) => {
-  return (
-    <div className="rounded-xl border border-border bg-card p-6 shadow-sm transition-all hover:shadow-md">
-      <div className="flex items-start gap-4">
-        <div className="flex h-12 w-12 shrink-0 items-center justify-center rounded-xl bg-[var(--accent-orange)]/10">
-          <Shield className="h-6 w-6 text-[var(--accent-orange)]" />
-        </div>
-        <div className="flex-1">
-          <div className="mb-1 flex flex-wrap items-center gap-2">
-            <h2 className="font-semibold text-xl">Governance</h2>
-            {pendingCount > 0 && (
-              <Badge className="gap-1.5 rounded-full bg-yellow-500/10 text-yellow-600">
-                {pendingCount} pending
-              </Badge>
-            )}
-            {runningCount > 0 && (
-              <Badge className="gap-1.5 rounded-full">
-                {runningCount} live
-              </Badge>
-            )}
-          </div>
-          <p className="text-muted-foreground text-sm">
-            Control agent permissions and audit every action.
-          </p>
-        </div>
-      </div>
-    </div>
-  )
-}

packages/browseros-agent/apps/agent/entrypoints/app/admin-dashboard/AdminDashboardPage.tsx

@@ -1,199 +0,0 @@
-import dayjs from 'dayjs'
-import { Shield } from 'lucide-react'
-import { type FC, useEffect, useMemo, useState } from 'react'
-import { toast } from 'sonner'
-import { ExecutionTaskCard } from '@/components/execution-history/ExecutionTaskCard'
-import {
-  AlertDialog,
-  AlertDialogAction,
-  AlertDialogCancel,
-  AlertDialogContent,
-  AlertDialogDescription,
-  AlertDialogFooter,
-  AlertDialogHeader,
-  AlertDialogTitle,
-} from '@/components/ui/alert-dialog'
-import {
-  removeConversationExecutionTask,
-  useExecutionHistoryByConversation,
-} from '@/lib/execution-history/storage'
-import type { ExecutionTaskRecord } from '@/lib/execution-history/types'
-import { pendingToolApprovalsStorage } from '@/lib/tool-approvals/approval-sync-storage'
-import { AdminDashboardHeader } from './AdminDashboardHeader'
-import { PendingApprovals } from './PendingApprovals'
-
-type TaskGroup = {
-  label: string
-  tasks: ExecutionTaskRecord[]
-}
-
-function getGroupLabel(date: string) {
-  const startedAt = dayjs(date)
-  if (startedAt.isSame(dayjs(), 'day')) return 'Today'
-  if (startedAt.isSame(dayjs().subtract(1, 'day'), 'day')) return 'Yesterday'
-  return startedAt.format('MMMM D, YYYY')
-}
-
-function groupTasks(tasks: ExecutionTaskRecord[]): TaskGroup[] {
-  const grouped = new Map<string, ExecutionTaskRecord[]>()
-
-  for (const task of tasks) {
-    const label = getGroupLabel(task.startedAt)
-    const existing = grouped.get(label) ?? []
-    grouped.set(label, [...existing, task])
-  }
-
-  return Array.from(grouped.entries()).map(([label, groupItems]) => ({
-    label,
-    tasks: groupItems,
-  }))
-}
-
-export const AdminDashboardPage: FC = () => {
-  const [pendingCount, setPendingCount] = useState(0)
-  const historyByConversation = useExecutionHistoryByConversation()
-  const [taskToDelete, setTaskToDelete] = useState<ExecutionTaskRecord | null>(
-    null,
-  )
-
-  useEffect(() => {
-    pendingToolApprovalsStorage
-      .getValue()
-      .then((v) => setPendingCount(v.length))
-    const unwatch = pendingToolApprovalsStorage.watch((v) =>
-      setPendingCount(v.length),
-    )
-    return () => unwatch()
-  }, [])
-
-  const historyList = useMemo(
-    () => Object.values(historyByConversation),
-    [historyByConversation],
-  )
-
-  const tasks = useMemo(() => {
-    return historyList
-      .flatMap((history) => history.tasks)
-      .sort(
-        (left, right) =>
-          new Date(right.startedAt).getTime() -
-          new Date(left.startedAt).getTime(),
-      )
-  }, [historyList])
-
-  const groupedTasks = useMemo(() => groupTasks(tasks), [tasks])
-  const runningCount = useMemo(
-    () => tasks.filter((task) => task.status === 'running').length,
-    [tasks],
-  )
-  const conversationCount = historyList.length
-
-  const handleDeleteTask = async () => {
-    if (!taskToDelete) return
-
-    try {
-      await removeConversationExecutionTask({
-        conversationId: taskToDelete.conversationId,
-        taskId: taskToDelete.id,
-      })
-      toast.success('Run removed')
-    } catch {
-      toast.error('Failed to remove run')
-    } finally {
-      setTaskToDelete(null)
-    }
-  }
-
-  return (
-    <div className="fade-in slide-in-from-bottom-5 animate-in space-y-6 duration-500">
-      <AdminDashboardHeader
-        pendingCount={pendingCount}
-        runningCount={runningCount}
-      />
-
-      <section className="space-y-3">
-        <h3 className="font-semibold text-sm">Approvals</h3>
-        <PendingApprovals />
-      </section>
-
-      <section className="space-y-4">
-        <div>
-          <h3 className="font-semibold text-sm">Audit Trail</h3>
-          {tasks.length > 0 && (
-            <p className="mt-1 text-muted-foreground text-sm">
-              {tasks.length} recorded run{tasks.length === 1 ? '' : 's'}
-              {conversationCount > 1
-                ? ` across ${conversationCount} chats`
-                : ''}
-              . Newest first.
-            </p>
-          )}
-        </div>
-
-        {tasks.length === 0 ? (
-          <div className="rounded-xl border border-dashed px-6 py-14 text-center">
-            <div className="mx-auto mb-4 flex size-12 items-center justify-center rounded-2xl bg-[var(--accent-orange)]/10">
-              <Shield className="size-5 text-[var(--accent-orange)]" />
-            </div>
-            <h3 className="mb-1 font-medium text-lg">No agent runs yet</h3>
-            <p className="mx-auto max-w-sm text-muted-foreground text-sm">
-              Run a task in BrowserOS and the execution history will appear
-              here.
-            </p>
-          </div>
-        ) : (
-          <div className="space-y-6">
-            {groupedTasks.map((group, groupIndex) => (
-              <section key={group.label} className="space-y-3">
-                <div className="flex items-center gap-3">
-                  <h4 className="font-medium text-muted-foreground text-xs">
-                    {group.label}
-                  </h4>
-                  <div className="h-px flex-1 bg-border/60" />
-                  <span className="text-muted-foreground text-xs">
-                    {group.tasks.length} run
-                    {group.tasks.length === 1 ? '' : 's'}
-                  </span>
-                </div>
-                <div className="space-y-3">
-                  {group.tasks.map((task, index) => (
-                    <ExecutionTaskCard
-                      key={task.id}
-                      task={task}
-                      defaultOpen={
-                        task.status === 'running' ||
-                        (groupIndex === 0 && index === 0)
-                      }
-                      onDelete={setTaskToDelete}
-                    />
-                  ))}
-                </div>
-              </section>
-            ))}
-          </div>
-        )}
-      </section>
-
-      <AlertDialog
-        open={taskToDelete !== null}
-        onOpenChange={(open) => !open && setTaskToDelete(null)}
-      >
-        <AlertDialogContent>
-          <AlertDialogHeader>
-            <AlertDialogTitle>Delete Run</AlertDialogTitle>
-            <AlertDialogDescription>
-              Remove "{taskToDelete?.promptText}" from local history? This only
-              clears the recorded run on this device.
-            </AlertDialogDescription>
-          </AlertDialogHeader>
-          <AlertDialogFooter>
-            <AlertDialogCancel>Cancel</AlertDialogCancel>
-            <AlertDialogAction onClick={handleDeleteTask}>
-              Delete
-            </AlertDialogAction>
-          </AlertDialogFooter>
-        </AlertDialogContent>
-      </AlertDialog>
-    </div>
-  )
-}

packages/browseros-agent/apps/agent/entrypoints/app/admin-dashboard/PendingApprovals.tsx

@@ -1,103 +0,0 @@
-import { Clock, ShieldCheck, ShieldX } from 'lucide-react'
-import { type FC, useEffect, useState } from 'react'
-import { Badge } from '@/components/ui/badge'
-import { Button } from '@/components/ui/button'
-import {
-  type ApprovalResponse,
-  approvalResponsesStorage,
-  type PendingApproval,
-  pendingToolApprovalsStorage,
-  queueApprovalResponse,
-} from '@/lib/tool-approvals/approval-sync-storage'
-
-const formatToolName = (name: string) =>
-  name
-    .replace(/_/g, ' ')
-    .replace(/([a-z])([A-Z])/g, '$1 $2')
-    .replace(/^./, (s) => s.toUpperCase())
-
-export const PendingApprovals: FC = () => {
-  const [pending, setPending] = useState<PendingApproval[]>([])
-
-  useEffect(() => {
-    pendingToolApprovalsStorage.getValue().then(setPending)
-    const unwatch = pendingToolApprovalsStorage.watch(setPending)
-    return () => unwatch()
-  }, [])
-
-  const respond = async (approvalId: string, approved: boolean) => {
-    const response: ApprovalResponse = {
-      approvalId,
-      approved,
-      timestamp: Date.now(),
-    }
-    const existing = (await approvalResponsesStorage.getValue()) ?? []
-    await approvalResponsesStorage.setValue(
-      queueApprovalResponse(existing, response),
-    )
-  }
-
-  if (pending.length === 0) {
-    return (
-      <div className="rounded-xl border border-dashed px-6 py-14 text-center">
-        <div className="mx-auto mb-4 flex size-12 items-center justify-center rounded-2xl bg-[var(--accent-orange)]/10">
-          <ShieldCheck className="size-5 text-[var(--accent-orange)]" />
-        </div>
-        <h3 className="mb-1 font-medium text-lg">No pending approvals</h3>
-        <p className="mx-auto max-w-sm text-muted-foreground text-sm">
-          When the agent needs permission to execute a tool, approval requests
-          will appear here.
-        </p>
-      </div>
-    )
-  }
-
-  return (
-    <div className="space-y-3">
-      {pending.map((item) => (
-        <div
-          key={item.approvalId}
-          className="flex items-start gap-4 rounded-xl border border-yellow-500/20 bg-yellow-500/5 p-4"
-        >
-          <div className="mt-0.5 flex size-9 shrink-0 items-center justify-center rounded-full bg-yellow-500/10">
-            <Clock className="size-4 text-yellow-600" />
-          </div>
-          <div className="min-w-0 flex-1">
-            <div className="flex items-center gap-2">
-              <span className="font-medium text-sm">
-                {formatToolName(item.toolName)}
-              </span>
-              <Badge variant="outline" className="text-[10px]">
-                awaiting
-              </Badge>
-            </div>
-            {Object.keys(item.input).length > 0 && (
-              <pre className="mt-1 max-h-20 overflow-auto rounded bg-muted/50 p-2 font-mono text-muted-foreground text-xs">
-                {JSON.stringify(item.input, null, 2)}
-              </pre>
-            )}
-            <div className="mt-3 flex gap-2">
-              <Button
-                size="sm"
-                className="h-7 gap-1 px-3 text-xs"
-                onClick={() => respond(item.approvalId, true)}
-              >
-                <ShieldCheck className="size-3" />
-                Approve
-              </Button>
-              <Button
-                size="sm"
-                variant="outline"
-                className="h-7 gap-1 px-3 text-xs"
-                onClick={() => respond(item.approvalId, false)}
-              >
-                <ShieldX className="size-3" />
-                Deny
-              </Button>
-            </div>
-          </div>
-        </div>
-      ))}
-    </div>
-  )
-}

packages/browseros-agent/apps/agent/entrypoints/app/agent-command/AgentCard.tsx

@@ -1,114 +0,0 @@
-import { Bot } from 'lucide-react'
-import type { FC } from 'react'
-import type { AgentCardData } from '@/lib/agent-conversations/types'
-import { cn } from '@/lib/utils'
-
-interface AgentCardProps {
-  agent: AgentCardData
-  onClick: () => void
-  active?: boolean
-}
-
-function formatTimestamp(timestamp?: number): string {
-  if (!timestamp) return 'No activity yet'
-  const diff = Date.now() - timestamp
-  const minutes = Math.floor(diff / 60000)
-  if (minutes < 1) return 'just now'
-  if (minutes < 60) return `${minutes}m ago`
-  const hours = Math.floor(minutes / 60)
-  if (hours < 24) return `${hours}h ago`
-  return `${Math.floor(hours / 24)}d ago`
-}
-
-function getStatusLabel(status: AgentCardData['status']): string {
-  if (status === 'working') return 'Working'
-  if (status === 'error') return 'Error'
-  return 'Ready'
-}
-
-function getStatusTone(status: AgentCardData['status']): string {
-  if (status === 'working') return 'bg-amber-500'
-  if (status === 'error') return 'bg-destructive'
-  return 'bg-emerald-500'
-}
-
-export const AgentCardExpanded: FC<AgentCardProps> = ({
-  agent,
-  onClick,
-  active,
-}) => (
-  <button
-    type="button"
-    onClick={onClick}
-    className={cn(
-      'group flex min-h-32 w-full min-w-0 flex-col rounded-2xl border p-4 text-left shadow-sm transition-all duration-200',
-      active
-        ? 'border-border/80 bg-card shadow-md ring-1 ring-[var(--accent-orange)]/20'
-        : 'border-border/60 bg-card/85 hover:border-border hover:bg-card hover:shadow-md',
-    )}
-  >
-    <div className="flex items-start justify-between gap-3">
-      <div className="flex min-w-0 items-center gap-3">
-        <div
-          className={cn(
-            'flex size-10 shrink-0 items-center justify-center rounded-xl',
-            active
-              ? 'bg-[var(--accent-orange)]/10 text-[var(--accent-orange)]'
-              : 'bg-muted text-muted-foreground',
-          )}
-        >
-          <Bot className="size-5" />
-        </div>
-        <div className="min-w-0">
-          <div className="truncate font-semibold text-sm">{agent.name}</div>
-          <div className="truncate text-muted-foreground text-xs">
-            {agent.model ?? 'OpenClaw agent'}
-          </div>
-        </div>
-      </div>
-      <div className="flex items-center gap-2 rounded-full border border-border/60 bg-background/70 px-2.5 py-1 text-[11px] text-muted-foreground">
-        <span
-          className={cn('size-2 rounded-full', getStatusTone(agent.status))}
-        />
-        <span>{getStatusLabel(agent.status)}</span>
-      </div>
-    </div>
-
-    <div className="mt-4 flex-1">
-      <p className="line-clamp-2 text-foreground/90 text-sm">
-        {agent.lastMessage ??
-          'Start a conversation to see recent work and summaries.'}
-      </p>
-    </div>
-
-    <div className="mt-4 flex items-center justify-between gap-3 text-muted-foreground text-xs">
-      <span>{formatTimestamp(agent.lastMessageTimestamp)}</span>
-      <span>Open conversation</span>
-    </div>
-  </button>
-)
-
-export const AgentCardCompact: FC<AgentCardProps> = ({
-  agent,
-  onClick,
-  active,
-}) => (
-  <button
-    type="button"
-    onClick={onClick}
-    className={cn(
-      'inline-flex items-center gap-2 rounded-full border px-3 py-2 text-sm transition-colors',
-      active
-        ? 'border-border bg-card shadow-sm ring-1 ring-[var(--accent-orange)]/20'
-        : 'border-border/60 bg-card/85 text-foreground hover:border-border hover:bg-card',
-    )}
-  >
-    <span
-      className={cn(
-        'size-2 rounded-full',
-        active ? 'bg-[var(--accent-orange)]' : getStatusTone(agent.status),
-      )}
-    />
-    <span className="truncate">{agent.name}</span>
-  </button>
-)

packages/browseros-agent/apps/agent/entrypoints/app/agent-command/AgentCardDock.tsx

@@ -1,71 +0,0 @@
-import { Plus } from 'lucide-react'
-import type { FC } from 'react'
-import type { AgentCardData } from '@/lib/agent-conversations/types'
-import { cn } from '@/lib/utils'
-import { AgentCardCompact, AgentCardExpanded } from './AgentCard'
-
-interface AgentCardDockProps {
-  agents: AgentCardData[]
-  activeAgentId?: string
-  onSelectAgent: (agentId: string) => void
-  onCreateAgent?: () => void
-  compact?: boolean
-}
-
-function CreateAgentButton({
-  compact,
-  onCreateAgent,
-}: {
-  compact?: boolean
-  onCreateAgent: () => void
-}) {
-  return (
-    <button
-      type="button"
-      onClick={onCreateAgent}
-      className={cn(
-        'flex shrink-0 items-center justify-center gap-2 border border-dashed text-muted-foreground transition-colors hover:border-[var(--accent-orange)] hover:text-[var(--accent-orange)]',
-        compact
-          ? 'rounded-full px-3 py-2 text-sm'
-          : 'min-h-32 rounded-2xl px-5 py-4',
-      )}
-    >
-      <Plus className={compact ? 'size-3.5' : 'size-5'} />
-      <span>{compact ? 'New' : 'Create agent'}</span>
-    </button>
-  )
-}
-
-export const AgentCardDock: FC<AgentCardDockProps> = ({
-  agents,
-  activeAgentId,
-  onSelectAgent,
-  onCreateAgent,
-  compact,
-}) => {
-  if (agents.length === 0 && !onCreateAgent) return null
-
-  const Card = compact ? AgentCardCompact : AgentCardExpanded
-
-  return (
-    <div
-      className={cn(
-        compact
-          ? 'flex items-center gap-2 overflow-x-auto pb-1'
-          : 'grid gap-4 md:grid-cols-3',
-      )}
-    >
-      {agents.map((agent) => (
-        <Card
-          key={agent.agentId}
-          agent={agent}
-          active={agent.agentId === activeAgentId}
-          onClick={() => onSelectAgent(agent.agentId)}
-        />
-      ))}
-      {onCreateAgent ? (
-        <CreateAgentButton compact={compact} onCreateAgent={onCreateAgent} />
-      ) : null}
-    </div>
-  )
-}

packages/browseros-agent/apps/agent/entrypoints/app/agent-command/AgentCommandConversation.tsx

@@ -1,194 +0,0 @@
-import { Bot, Home, RotateCcw } from 'lucide-react'
-import { type FC, useEffect, useRef } from 'react'
-import { Navigate, useNavigate, useParams, useSearchParams } from 'react-router'
-import { Button } from '@/components/ui/button'
-import type { AgentEntry } from '@/entrypoints/app/agents/useOpenClaw'
-import { cn } from '@/lib/utils'
-import { useAgentCommandData } from './agent-command-layout'
-import { ConversationInput } from './ConversationInput'
-import { ConversationMessage } from './ConversationMessage'
-import { useAgentConversation } from './useAgentConversation'
-
-function ConversationHeader({
-  agentName,
-  status,
-  onGoHome,
-  onReset,
-}: {
-  agentName: string
-  status: string
-  onGoHome: () => void
-  onReset: () => void
-}) {
-  return (
-    <div className="overflow-hidden rounded-[1.5rem] border border-border/60 bg-card/95 shadow-sm backdrop-blur">
-      <div className="flex items-center justify-between gap-3 px-5 py-4">
-        <div className="flex min-w-0 items-center gap-3">
-          <Button
-            variant="ghost"
-            size="icon"
-            onClick={onGoHome}
-            className="rounded-xl"
-            title="Back to home"
-          >
-            <Home className="size-4" />
-          </Button>
-          <div className="flex size-11 shrink-0 items-center justify-center rounded-2xl bg-muted text-muted-foreground">
-            <Bot className="size-5" />
-          </div>
-          <div className="min-w-0">
-            <div className="truncate font-semibold text-sm">{agentName}</div>
-            <div className="truncate text-muted-foreground text-sm">
-              {status}
-            </div>
-          </div>
-        </div>
-        <Button
-          variant="ghost"
-          size="sm"
-          onClick={onReset}
-          className="rounded-xl text-muted-foreground"
-        >
-          <RotateCcw className="mr-2 size-4" />
-          New conversation
-        </Button>
-      </div>
-    </div>
-  )
-}
-
-function EmptyConversationState({ agentName }: { agentName: string }) {
-  return (
-    <div className="flex min-h-full items-center justify-center py-10">
-      <div className="max-w-md rounded-[1.5rem] border border-border/60 bg-card/90 px-8 py-10 text-center shadow-sm backdrop-blur">
-        <div className="mx-auto flex size-14 items-center justify-center rounded-2xl bg-muted text-muted-foreground">
-          <Bot className="size-6" />
-        </div>
-        <h2 className="mt-4 font-semibold text-lg">{agentName}</h2>
-        <p className="mt-2 text-muted-foreground text-sm">
-          Send a message to start a focused conversation with this agent.
-        </p>
-      </div>
-    </div>
-  )
-}
-
-function getConversationStatusCopy(
-  status: string | undefined,
-  streaming: boolean,
-): string {
-  if (streaming) return 'Working on your request'
-  if (status === 'running') return 'Ready for the next task'
-  if (status === 'starting') return 'Connecting to OpenClaw'
-  if (status === 'error') return 'OpenClaw needs attention'
-  if (status === 'stopped') return 'OpenClaw is offline'
-  return 'Open agent setup to continue'
-}
-
-export const AgentCommandConversation: FC = () => {
-  const { agentId } = useParams<{ agentId: string }>()
-  const [searchParams, setSearchParams] = useSearchParams()
-  const navigate = useNavigate()
-  const scrollRef = useRef<HTMLDivElement>(null)
-  const initialQuerySent = useRef(false)
-  const { status, agents } = useAgentCommandData()
-  const shouldRedirectHome = !agentId
-  const resolvedAgentId = agentId ?? ''
-  const agent = agents.find((entry) => entry.agentId === resolvedAgentId)
-  const agentName = agent?.name || resolvedAgentId || 'Agent'
-  const { turns, streaming, loading, send, resetConversation } =
-    useAgentConversation(resolvedAgentId, agentName)
-  const lastTurn = turns[turns.length - 1]
-  const lastTurnPartCount = lastTurn?.parts.length ?? 0
-
-  useEffect(() => {
-    if (shouldRedirectHome) return
-
-    const query = searchParams.get('q')
-    if (query && !initialQuerySent.current && !loading) {
-      initialQuerySent.current = true
-      setSearchParams({}, { replace: true })
-      void send(query)
-    }
-  }, [loading, searchParams, send, setSearchParams, shouldRedirectHome])
-
-  useEffect(() => {
-    if (
-      shouldRedirectHome ||
-      (turns.length === 0 && lastTurnPartCount === 0 && !streaming)
-    ) {
-      return
-    }
-
-    scrollRef.current?.scrollTo({
-      top: scrollRef.current.scrollHeight,
-      behavior: 'smooth',
-    })
-  }, [lastTurnPartCount, shouldRedirectHome, streaming, turns.length])
-
-  if (shouldRedirectHome) {
-    return <Navigate to="/home" replace />
-  }
-
-  const handleSelectAgent = (entry: AgentEntry) => {
-    navigate(`/home/agents/${entry.agentId}`)
-  }
-
-  const statusCopy = getConversationStatusCopy(status?.status, streaming)
-
-  return (
-    <div className="absolute inset-0 overflow-hidden">
-      <div className="fade-in slide-in-from-bottom-5 mx-auto flex h-full w-full max-w-3xl animate-in flex-col gap-3 px-4 pt-4 pb-2 duration-300">
-        <ConversationHeader
-          agentName={agentName}
-          status={statusCopy}
-          onGoHome={() => navigate('/home')}
-          onReset={resetConversation}
-        />
-
-        <main
-          ref={scrollRef}
-          className={cn(
-            'styled-scrollbar min-h-0 flex-1 overflow-y-auto overflow-x-hidden rounded-[1.5rem] border border-border/50 bg-card/85 px-5 py-5 shadow-sm',
-            '[&_[data-streamdown="code-block"]]:!max-w-full [&_[data-streamdown="table-wrapper"]]:!max-w-full [&_[data-streamdown="code-block"]]:overflow-x-auto [&_[data-streamdown="table-wrapper"]]:overflow-x-auto',
-          )}
-        >
-          {loading ? (
-            <div className="flex h-full items-center justify-center text-muted-foreground text-sm">
-              Loading conversation...
-            </div>
-          ) : turns.length === 0 ? (
-            <EmptyConversationState agentName={agentName} />
-          ) : (
-            <div className="w-full space-y-4">
-              {turns.map((turn, index) => (
-                <ConversationMessage
-                  key={turn.id}
-                  turn={turn}
-                  streaming={streaming && index === turns.length - 1}
-                />
-              ))}
-            </div>
-          )}
-        </main>
-
-        <div className="w-full flex-shrink-0">
-          <ConversationInput
-            variant="conversation"
-            agents={agents}
-            selectedAgentId={resolvedAgentId}
-            onSelectAgent={handleSelectAgent}
-            onSend={(text) => {
-              void send(text)
-            }}
-            onCreateAgent={() => navigate('/agents')}
-            streaming={streaming}
-            disabled={status?.status !== 'running'}
-            status={status?.status}
-            placeholder={`Message ${agentName}...`}
-          />
-        </div>
-      </div>
-    </div>
-  )
-}

packages/browseros-agent/apps/agent/entrypoints/app/agent-command/AgentCommandHome.tsx

@@ -1,182 +0,0 @@
-import { ArrowRight } from 'lucide-react'
-import { type FC, useEffect, useState } from 'react'
-import { useNavigate } from 'react-router'
-import { Button } from '@/components/ui/button'
-import { Card, CardContent } from '@/components/ui/card'
-import type { AgentEntry } from '@/entrypoints/app/agents/useOpenClaw'
-import { ImportDataHint } from '@/entrypoints/newtab/index/ImportDataHint'
-import { NewTabBranding } from '@/entrypoints/newtab/index/NewTabBranding'
-import { NewTabTip } from '@/entrypoints/newtab/index/NewTabTip'
-import { ScheduleResults } from '@/entrypoints/newtab/index/ScheduleResults'
-import { SignInHint } from '@/entrypoints/newtab/index/SignInHint'
-import { TopSites } from '@/entrypoints/newtab/index/TopSites'
-import { useActiveHint } from '@/entrypoints/newtab/index/useActiveHint'
-import { AgentCardDock } from './AgentCardDock'
-import { useAgentCommandData } from './agent-command-layout'
-import { ConversationInput } from './ConversationInput'
-import { useAgentCardData } from './useAgentCardData'
-
-function AgentCommandSetupState({
-  onOpenAgents,
-}: {
-  onOpenAgents: () => void
-}) {
-  return (
-    <Card className="border-border/60 bg-card/85 shadow-sm">
-      <CardContent className="flex flex-col items-center gap-4 p-6 text-center">
-        <p className="max-w-xl text-muted-foreground text-sm">
-          Set up OpenClaw agents to turn your new tab into an agent command
-          center.
-        </p>
-        <Button onClick={onOpenAgents} className="gap-2">
-          Open Agent Setup
-          <ArrowRight className="size-4" />
-        </Button>
-      </CardContent>
-    </Card>
-  )
-}
-
-function EmptyAgentsState({ onOpenAgents }: { onOpenAgents: () => void }) {
-  return (
-    <Card className="border-border/60 bg-card/85 shadow-sm">
-      <CardContent className="flex flex-col items-center gap-4 p-6 text-center">
-        <p className="max-w-xl text-muted-foreground text-sm">
-          OpenClaw is running, but you do not have any agents yet.
-        </p>
-        <Button variant="outline" onClick={onOpenAgents}>
-          Create your first agent
-        </Button>
-      </CardContent>
-    </Card>
-  )
-}
-
-function OpenClawUnavailableState({
-  onOpenAgents,
-}: {
-  onOpenAgents: () => void
-}) {
-  return (
-    <Card className="border-border/60 bg-card/85 shadow-sm">
-      <CardContent className="flex flex-col items-center gap-4 p-6 text-center">
-        <p className="max-w-xl text-muted-foreground text-sm">
-          OpenClaw is unavailable right now. Open the Agents page to restart the
-          gateway or review setup.
-        </p>
-        <Button onClick={onOpenAgents} className="gap-2">
-          Open Agent Setup
-          <ArrowRight className="size-4" />
-        </Button>
-      </CardContent>
-    </Card>
-  )
-}
-
-export const AgentCommandHome: FC = () => {
-  const navigate = useNavigate()
-  const activeHint = useActiveHint()
-  const { status, agents } = useAgentCommandData()
-  const [mounted, setMounted] = useState(false)
-  const [selectedAgentId, setSelectedAgentId] = useState<string | null>(null)
-  const cardData = useAgentCardData(agents, status?.status)
-
-  useEffect(() => {
-    setMounted(true)
-  }, [])
-
-  useEffect(() => {
-    if (agents.length === 0) {
-      if (selectedAgentId) {
-        setSelectedAgentId(null)
-      }
-      return
-    }
-
-    if (
-      !selectedAgentId ||
-      !agents.some((agent) => agent.agentId === selectedAgentId)
-    ) {
-      setSelectedAgentId(agents[0].agentId)
-    }
-  }, [agents, selectedAgentId])
-
-  const handleSend = (text: string) => {
-    if (!selectedAgentId) return
-    navigate(`/home/agents/${selectedAgentId}?q=${encodeURIComponent(text)}`)
-  }
-
-  const handleSelectAgent = (agent: AgentEntry) => {
-    setSelectedAgentId(agent.agentId)
-  }
-
-  const openClawStatus = status?.status
-  const isSetup = openClawStatus != null && openClawStatus !== 'uninitialized'
-  const shouldShowUnavailableState =
-    openClawStatus != null &&
-    openClawStatus !== 'running' &&
-    openClawStatus !== 'uninitialized' &&
-    cardData.length === 0
-
-  return (
-    <div className="pt-[max(25vh,16px)]">
-      <div className="relative w-full space-y-8 md:w-3xl">
-        <NewTabBranding />
-
-        <ConversationInput
-          variant="home"
-          agents={agents}
-          selectedAgentId={selectedAgentId}
-          onSelectAgent={handleSelectAgent}
-          onSend={handleSend}
-          onCreateAgent={() => navigate('/agents')}
-          streaming={false}
-          disabled={status?.status !== 'running'}
-          status={status?.status}
-          placeholder={
-            status?.status === 'running'
-              ? undefined
-              : 'OpenClaw is not running...'
-          }
-        />
-
-        {mounted ? <NewTabTip /> : null}
-
-        {isSetup ? (
-          shouldShowUnavailableState ? (
-            <OpenClawUnavailableState
-              onOpenAgents={() => navigate('/agents')}
-            />
-          ) : cardData.length > 0 ? (
-            <section className="space-y-3">
-              <div className="flex items-center justify-between">
-                <div>
-                  <h2 className="font-semibold text-base">Agents</h2>
-                  <p className="text-muted-foreground text-sm">
-                    Pick up where your agents left off.
-                  </p>
-                </div>
-              </div>
-              <AgentCardDock
-                agents={cardData}
-                activeAgentId={selectedAgentId ?? undefined}
-                onSelectAgent={(agentId) => navigate(`/home/agents/${agentId}`)}
-                onCreateAgent={() => navigate('/agents')}
-              />
-            </section>
-          ) : (
-            <EmptyAgentsState onOpenAgents={() => navigate('/agents')} />
-          )
-        ) : (
-          <AgentCommandSetupState onOpenAgents={() => navigate('/agents')} />
-        )}
-
-        {mounted ? <TopSites /> : null}
-        {mounted ? <ScheduleResults /> : null}
-      </div>
-
-      {activeHint === 'signin' ? <SignInHint /> : null}
-      {activeHint === 'import' ? <ImportDataHint /> : null}
-    </div>
-  )
-}

packages/browseros-agent/apps/agent/entrypoints/app/agent-command/AgentSelector.tsx

@@ -1,132 +0,0 @@
-import { Bot, Check, ChevronDown, Plus } from 'lucide-react'
-import type { FC } from 'react'
-import { useState } from 'react'
-import { Button } from '@/components/ui/button'
-import {
-  Command,
-  CommandEmpty,
-  CommandGroup,
-  CommandInput,
-  CommandItem,
-  CommandList,
-} from '@/components/ui/command'
-import {
-  Popover,
-  PopoverContent,
-  PopoverTrigger,
-} from '@/components/ui/popover'
-import {
-  type AgentEntry,
-  getModelDisplayName,
-} from '@/entrypoints/app/agents/useOpenClaw'
-import { cn } from '@/lib/utils'
-
-interface AgentSelectorProps {
-  agents: AgentEntry[]
-  selectedAgentId: string | null
-  onSelectAgent: (agent: AgentEntry) => void
-  onCreateAgent?: () => void
-  status?: string
-}
-
-function getStatusDot(status?: string) {
-  if (status === 'running') return 'bg-emerald-500'
-  if (status === 'starting') return 'bg-amber-500 animate-pulse'
-  if (status === 'error') return 'bg-destructive'
-  return 'bg-muted-foreground/50'
-}
-
-export const AgentSelector: FC<AgentSelectorProps> = ({
-  agents,
-  selectedAgentId,
-  onSelectAgent,
-  onCreateAgent,
-  status,
-}) => {
-  const [open, setOpen] = useState(false)
-  const selectedAgent = agents.find(
-    (agent) => agent.agentId === selectedAgentId,
-  )
-
-  return (
-    <Popover open={open} onOpenChange={setOpen}>
-      <PopoverTrigger asChild>
-        <Button
-          variant="ghost"
-          className={cn(
-            'flex items-center gap-2 rounded-lg px-3 py-1.5 font-medium text-sm transition-all',
-            'bg-transparent text-muted-foreground hover:bg-accent hover:text-accent-foreground',
-            'data-[state=open]:bg-accent',
-          )}
-        >
-          <Bot className="h-4 w-4" />
-          <span className={cn('size-2 rounded-full', getStatusDot(status))} />
-          <span className="max-w-32 truncate">
-            {selectedAgent?.name ?? 'Select agent'}
-          </span>
-          <ChevronDown className="h-3 w-3" />
-        </Button>
-      </PopoverTrigger>
-      <PopoverContent side="bottom" align="start" className="w-72 p-0">
-        <Command>
-          <CommandInput placeholder="Search agents..." className="h-9" />
-          <CommandList>
-            <CommandEmpty>No agents found</CommandEmpty>
-            <CommandGroup>
-              {agents.map((agent) => {
-                const isSelected = selectedAgentId === agent.agentId
-                const modelLabel = getModelDisplayName(agent.model)
-                return (
-                  <CommandItem
-                    key={agent.agentId}
-                    value={`${agent.agentId} ${agent.name}`}
-                    onSelect={() => {
-                      onSelectAgent(agent)
-                      setOpen(false)
-                    }}
-                    className={cn(
-                      'flex w-full items-center gap-3 rounded-md px-3 py-2',
-                      isSelected && 'bg-[var(--accent-orange)]/10',
-                    )}
-                  >
-                    <div className="flex size-8 shrink-0 items-center justify-center rounded-lg bg-[var(--accent-orange)]/10 text-[var(--accent-orange)]">
-                      <Bot className="size-4" />
-                    </div>
-                    <div className="min-w-0 flex-1">
-                      <span className="block truncate font-medium text-sm">
-                        {agent.name}
-                      </span>
-                      {modelLabel ? (
-                        <span className="block truncate text-muted-foreground text-xs">
-                          {modelLabel}
-                        </span>
-                      ) : null}
-                    </div>
-                    {isSelected ? (
-                      <Check className="size-4 shrink-0 text-[var(--accent-orange)]" />
-                    ) : null}
-                  </CommandItem>
-                )
-              })}
-            </CommandGroup>
-            {onCreateAgent ? (
-              <div className="border-border border-t p-1">
-                <button
-                  type="button"
-                  className="flex w-full items-center gap-3 rounded-md px-3 py-2 text-left text-muted-foreground text-sm transition-colors hover:bg-accent hover:text-foreground"
-                  onClick={() => {
-                    onCreateAgent()
-                    setOpen(false)
-                  }}
-                >
-                  <Plus className="size-4" />
-                  <span>Create agent</span>
-                </button>
-              </div>
-            ) : null}
-          </CommandList>
-        </Command>
-      </PopoverContent>
-    </Popover>
-  )
-}

packages/browseros-agent/apps/agent/entrypoints/app/agent-command/ConversationInput.tsx

@@ -1,371 +0,0 @@
-import {
-  ArrowRight,
-  Bot,
-  ChevronDown,
-  Folder,
-  Layers,
-  Loader2,
-  Mic,
-  Square,
-} from 'lucide-react'
-import { type FC, type ReactNode, useEffect, useState } from 'react'
-import { AppSelector } from '@/components/elements/AppSelector'
-import { TabPickerPopover } from '@/components/elements/tab-picker-popover'
-import { WorkspaceSelector } from '@/components/elements/workspace-selector'
-import { Button } from '@/components/ui/button'
-import type { AgentEntry } from '@/entrypoints/app/agents/useOpenClaw'
-import { McpServerIcon } from '@/entrypoints/app/connect-mcp/McpServerIcon'
-import { useGetUserMCPIntegrations } from '@/entrypoints/app/connect-mcp/useGetUserMCPIntegrations'
-import { Feature } from '@/lib/browseros/capabilities'
-import { useCapabilities } from '@/lib/browseros/useCapabilities'
-import { useMcpServers } from '@/lib/mcp/mcpServerStorage'
-import { cn } from '@/lib/utils'
-import { useVoiceInput } from '@/lib/voice/useVoiceInput'
-import { useWorkspace } from '@/lib/workspace/use-workspace'
-import { AgentSelector } from './AgentSelector'
-
-interface ConversationInputProps {
-  agents: AgentEntry[]
-  selectedAgentId: string | null
-  onSelectAgent: (agent: AgentEntry) => void
-  onSend: (text: string) => void
-  onCreateAgent?: () => void
-  streaming: boolean
-  disabled?: boolean
-  status?: string
-  placeholder?: string
-  variant?: 'home' | 'conversation'
-}
-
-function InputActionButton({
-  disabled,
-  onClick,
-  streaming,
-}: {
-  disabled: boolean
-  onClick: () => void
-  streaming: boolean
-}) {
-  return (
-    <Button
-      onClick={onClick}
-      size="icon"
-      disabled={disabled}
-      className="h-10 w-10 flex-shrink-0 rounded-xl bg-primary text-primary-foreground hover:bg-primary/90"
-    >
-      {streaming ? (
-        <Loader2 className="h-5 w-5 animate-spin" />
-      ) : (
-        <ArrowRight className="h-5 w-5" />
-      )}
-    </Button>
-  )
-}
-
-function VoiceButton({
-  isRecording,
-  isTranscribing,
-  onStart,
-  onStop,
-}: {
-  isRecording: boolean
-  isTranscribing: boolean
-  onStart: () => void
-  onStop: () => void
-}) {
-  if (isRecording) {
-    return (
-      <Button
-        type="button"
-        size="icon"
-        onClick={onStop}
-        className="h-10 w-10 flex-shrink-0 rounded-xl bg-red-600 text-white hover:bg-red-700"
-      >
-        <Square className="h-4 w-4" />
-      </Button>
-    )
-  }
-
-  if (isTranscribing) {
-    return (
-      <Button
-        type="button"
-        variant="ghost"
-        size="icon"
-        disabled
-        className="h-10 w-10 flex-shrink-0 rounded-xl"
-      >
-        <Loader2 className="h-5 w-5 animate-spin" />
-      </Button>
-    )
-  }
-
-  return (
-    <Button
-      type="button"
-      variant="ghost"
-      size="icon"
-      onClick={onStart}
-      className="h-10 w-10 flex-shrink-0 rounded-xl text-muted-foreground transition-colors hover:text-foreground"
-      title="Voice input"
-    >
-      <Mic className="h-5 w-5" />
-    </Button>
-  )
-}
-
-function ContextControls({
-  agents,
-  onCreateAgent,
-  onSelectAgent,
-  selectedAgentId,
-  selectedTabs,
-  onToggleTab,
-  showAgentSelector,
-  status,
-}: {
-  agents: AgentEntry[]
-  onCreateAgent?: () => void
-  onSelectAgent: (agent: AgentEntry) => void
-  selectedAgentId: string | null
-  selectedTabs: chrome.tabs.Tab[]
-  onToggleTab: (tab: chrome.tabs.Tab) => void
-  showAgentSelector: boolean
-  status?: string
-}) {
-  const { supports } = useCapabilities()
-  const { selectedFolder } = useWorkspace()
-  const { servers: mcpServers } = useMcpServers()
-  const { data: userMCPIntegrations } = useGetUserMCPIntegrations()
-
-  const connectedManagedServers = mcpServers.filter((server) => {
-    if (server.type !== 'managed' || !server.managedServerName) return false
-    return userMCPIntegrations?.integrations?.find(
-      (integration) => integration.name === server.managedServerName,
-    )?.is_authenticated
-  })
-
-  return (
-    <div className="flex items-center justify-between border-border/50 border-t px-5 py-3">
-      <div className="flex items-center gap-1">
-        {showAgentSelector ? (
-          <AgentSelector
-            agents={agents}
-            selectedAgentId={selectedAgentId}
-            onSelectAgent={onSelectAgent}
-            onCreateAgent={onCreateAgent}
-            status={status}
-          />
-        ) : null}
-        {supports(Feature.WORKSPACE_FOLDER_SUPPORT) ? (
-          <WorkspaceSelector>
-            <Button
-              variant="ghost"
-              className={cn(
-                'flex items-center gap-2 rounded-lg px-3 py-1.5 font-medium text-sm transition-all',
-                'bg-transparent text-muted-foreground hover:bg-accent hover:text-accent-foreground',
-                'data-[state=open]:bg-accent',
-              )}
-            >
-              <Folder className="h-4 w-4" />
-              <span>{selectedFolder?.name || 'Add workspace'}</span>
-              <ChevronDown className="h-3 w-3" />
-            </Button>
-          </WorkspaceSelector>
-        ) : null}
-        <TabPickerPopover
-          variant="selector"
-          selectedTabs={selectedTabs}
-          onToggleTab={onToggleTab}
-        >
-          <Button
-            className={cn(
-              'flex items-center gap-2 rounded-lg px-3 py-1.5 font-medium text-sm transition-all',
-              selectedTabs.length > 0
-                ? 'bg-[var(--accent-orange)]! text-white shadow-sm'
-                : 'bg-transparent text-muted-foreground hover:bg-accent hover:text-accent-foreground',
-              'data-[state=open]:bg-accent',
-            )}
-          >
-            <Layers className="h-4 w-4" />
-            <span>Tabs</span>
-          </Button>
-        </TabPickerPopover>
-      </div>
-
-      {supports(Feature.MANAGED_MCP_SUPPORT) ? (
-        <div className="ml-auto flex items-center gap-1.5">
-          <AppSelector side="bottom">
-            <Button
-              variant="ghost"
-              className={cn(
-                'flex items-center gap-2 rounded-lg px-3 py-1.5 font-medium text-sm transition-all',
-                'bg-transparent text-muted-foreground hover:bg-accent hover:text-accent-foreground',
-                'data-[state=open]:bg-accent',
-              )}
-            >
-              <div className="flex items-center -space-x-1.5">
-                {connectedManagedServers.slice(0, 4).map((server) => (
-                  <div
-                    key={server.id}
-                    className="rounded-full ring-2 ring-card"
-                  >
-                    <McpServerIcon
-                      serverName={server.managedServerName ?? ''}
-                      size={16}
-                    />
-                  </div>
-                ))}
-              </div>
-              {connectedManagedServers.length > 4 ? (
-                <span className="text-xs">
-                  +{connectedManagedServers.length - 4}
-                </span>
-              ) : null}
-              <span>Apps</span>
-              <ChevronDown className="h-3 w-3" />
-            </Button>
-          </AppSelector>
-        </div>
-      ) : null}
-    </div>
-  )
-}
-
-function HomeShell({ children }: { children: ReactNode }) {
-  return (
-    <div className="overflow-hidden rounded-[1.5rem] border border-border/60 bg-card/95 shadow-sm backdrop-blur">
-      {children}
-    </div>
-  )
-}
-
-function ConversationShell({ children }: { children: ReactNode }) {
-  return (
-    <div className="overflow-hidden rounded-[1.5rem] border border-border/60 bg-card/95 shadow-sm backdrop-blur">
-      {children}
-    </div>
-  )
-}
-
-export const ConversationInput: FC<ConversationInputProps> = ({
-  agents,
-  selectedAgentId,
-  onSelectAgent,
-  onSend,
-  onCreateAgent,
-  streaming,
-  disabled,
-  status,
-  placeholder,
-  variant = 'conversation',
-}) => {
-  const [input, setInput] = useState('')
-  const [selectedTabs, setSelectedTabs] = useState<chrome.tabs.Tab[]>([])
-  const voice = useVoiceInput()
-  const selectedAgent = agents.find(
-    (agent) => agent.agentId === selectedAgentId,
-  )
-
-  useEffect(() => {
-    if (voice.transcript && !voice.isTranscribing) {
-      setInput(voice.transcript)
-      voice.clearTranscript()
-    }
-  }, [voice.transcript, voice.isTranscribing, voice])
-
-  const toggleTab = (tab: chrome.tabs.Tab) => {
-    setSelectedTabs((prev) => {
-      const isSelected = prev.some((selected) => selected.id === tab.id)
-      if (isSelected) {
-        return prev.filter((selected) => selected.id !== tab.id)
-      }
-      return [...prev, tab]
-    })
-  }
-
-  const handleSend = () => {
-    const text = input.trim()
-    if (!text || streaming || disabled) return
-    onSend(text)
-    setInput('')
-  }
-
-  const shell = variant === 'home' ? HomeShell : ConversationShell
-  const Shell = shell
-
-  return (
-    <Shell>
-      <div className="flex items-center gap-3 px-5 py-4">
-        <BotInputIcon variant={variant} />
-        <input
-          type="text"
-          value={input}
-          onChange={(event) => setInput(event.currentTarget.value)}
-          onKeyDown={(event) => {
-            if (event.key === 'Enter') {
-              event.preventDefault()
-              handleSend()
-            }
-          }}
-          placeholder={
-            voice.isTranscribing
-              ? 'Transcribing...'
-              : (placeholder ?? `Message ${selectedAgent?.name ?? 'agent'}...`)
-          }
-          disabled={disabled || voice.isTranscribing}
-          className="flex-1 border-none bg-transparent text-base text-foreground outline-none placeholder:text-muted-foreground disabled:opacity-60"
-        />
-        <VoiceButton
-          isRecording={voice.isRecording}
-          isTranscribing={voice.isTranscribing}
-          onStart={() => {
-            void voice.startRecording()
-          }}
-          onStop={() => {
-            void voice.stopRecording()
-          }}
-        />
-        <InputActionButton
-          disabled={
-            !input.trim() ||
-            streaming ||
-            !!disabled ||
-            voice.isRecording ||
-            voice.isTranscribing
-          }
-          onClick={handleSend}
-          streaming={streaming}
-        />
-      </div>
-      {voice.error ? (
-        <div className="px-5 pb-2 text-destructive text-xs">{voice.error}</div>
-      ) : null}
-      <ContextControls
-        agents={agents}
-        onCreateAgent={onCreateAgent}
-        onSelectAgent={onSelectAgent}
-        selectedAgentId={selectedAgentId}
-        selectedTabs={selectedTabs}
-        onToggleTab={toggleTab}
-        showAgentSelector={variant === 'home'}
-        status={status}
-      />
-    </Shell>
-  )
-}
-
-function BotInputIcon({ variant }: { variant: 'home' | 'conversation' }) {
-  return (
-    <div
-      className={cn(
-        'flex items-center justify-center text-[var(--accent-orange)]',
-        variant === 'home'
-          ? 'h-10 w-10 rounded-xl bg-[var(--accent-orange)]/10'
-          : 'h-9 w-9 rounded-xl bg-[var(--accent-orange)]/12',
-      )}
-    >
-      <Bot className="h-4 w-4" />
-    </div>
-  )
-}

packages/browseros-agent/apps/agent/entrypoints/app/agent-command/ConversationMessage.tsx

@@ -1,105 +0,0 @@
-import { Bot, CheckCircle2, Loader2, XCircle } from 'lucide-react'
-import type { FC } from 'react'
-import {
-  Message,
-  MessageContent,
-  MessageResponse,
-} from '@/components/ai-elements/message'
-import {
-  Reasoning,
-  ReasoningContent,
-  ReasoningTrigger,
-} from '@/components/ai-elements/reasoning'
-import type { AgentConversationTurn } from '@/lib/agent-conversations/types'
-
-interface ConversationMessageProps {
-  turn: AgentConversationTurn
-  streaming: boolean
-}
-
-export const ConversationMessage: FC<ConversationMessageProps> = ({
-  turn,
-  streaming,
-}) => (
-  <div className="space-y-3">
-    <Message from="user">
-      <MessageContent>
-        <pre className="whitespace-pre-wrap font-sans text-sm">
-          {turn.userText}
-        </pre>
-      </MessageContent>
-    </Message>
-
-    {turn.parts.length > 0 && (
-      <Message from="assistant">
-        <MessageContent>
-          {turn.parts.map((part, i) => {
-            const key = `${turn.id}-part-${i}`
-
-            switch (part.kind) {
-              case 'thinking':
-                return (
-                  <Reasoning
-                    key={key}
-                    className="w-full"
-                    isStreaming={!part.done}
-                    defaultOpen={!part.done}
-                  >
-                    <ReasoningTrigger />
-                    <ReasoningContent>{part.text}</ReasoningContent>
-                  </Reasoning>
-                )
-
-              case 'tool-batch':
-                return (
-                  <div key={key} className="w-full space-y-1">
-                    {part.tools.map((tool) => (
-                      <div
-                        key={tool.id}
-                        className="flex items-center gap-2 rounded-md border px-3 py-2 text-sm"
-                      >
-                        {tool.status === 'running' && (
-                          <Loader2 className="size-3.5 animate-spin text-muted-foreground" />
-                        )}
-                        {tool.status === 'completed' && (
-                          <CheckCircle2 className="size-3.5 text-green-500" />
-                        )}
-                        {tool.status === 'error' && (
-                          <XCircle className="size-3.5 text-destructive" />
-                        )}
-                        <span className="font-mono text-xs">{tool.name}</span>
-                        {tool.durationMs != null && (
-                          <span className="ml-auto text-muted-foreground text-xs">
-                            {(tool.durationMs / 1000).toFixed(1)}s
-                          </span>
-                        )}
-                      </div>
-                    ))}
-                  </div>
-                )
-
-              case 'text':
-                return <MessageResponse key={key}>{part.text}</MessageResponse>
-
-              default:
-                return null
-            }
-          })}
-        </MessageContent>
-      </Message>
-    )}
-
-    {!turn.done && turn.parts.length === 0 && streaming && (
-      <div className="flex gap-2">
-        <div className="flex size-7 shrink-0 items-center justify-center rounded-full bg-[var(--accent-orange)] text-white">
-          <Bot className="size-3.5" />
-        </div>
-        <div className="flex items-center gap-1 rounded-xl rounded-tl-none border border-border/50 bg-card px-3 py-2.5 shadow-sm">
-          <span className="size-1.5 animate-bounce rounded-full bg-[var(--accent-orange)] [animation-delay:-0.3s]" />
-          <span className="size-1.5 animate-bounce rounded-full bg-[var(--accent-orange)] [animation-delay:-0.15s]" />
-          <span className="size-1.5 animate-bounce rounded-full bg-[var(--accent-orange)]" />
-        </div>
-      </div>
-    )}
-  </div>
-)

packages/browseros-agent/apps/agent/entrypoints/app/agent-command/agent-command-layout.tsx

@@ -1,39 +0,0 @@
-import type { FC } from 'react'
-import { Outlet, useOutletContext } from 'react-router'
-import {
-  type AgentEntry,
-  type OpenClawStatus,
-  useOpenClawAgents,
-  useOpenClawStatus,
-} from '@/entrypoints/app/agents/useOpenClaw'
-
-interface AgentCommandContextValue {
-  agents: AgentEntry[]
-  agentsLoading: boolean
-  status: OpenClawStatus | null
-  statusLoading: boolean
-}
-
-export const AgentCommandLayout: FC = () => {
-  const { status, loading: statusLoading } = useOpenClawStatus(5000)
-  const { agents, loading: agentsLoading } = useOpenClawAgents(
-    status?.status === 'running' && status.controlPlaneStatus === 'connected',
-  )
-
-  return (
-    <Outlet
-      context={
-        {
-          agents,
-          agentsLoading,
-          status,
-          statusLoading,
-        } satisfies AgentCommandContextValue
-      }
-    />
-  )
-}
-
-export function useAgentCommandData(): AgentCommandContextValue {
-  return useOutletContext<AgentCommandContextValue>()
-}

packages/browseros-agent/apps/agent/entrypoints/app/agent-command/useAgentCardData.ts

@@ -1,69 +0,0 @@
-import { useEffect, useState } from 'react'
-import {
-  type AgentEntry,
-  getModelDisplayName,
-  type OpenClawStatus,
-} from '@/entrypoints/app/agents/useOpenClaw'
-import { getLatestConversation } from '@/lib/agent-conversations/storage'
-import type { AgentCardData } from '@/lib/agent-conversations/types'
-
-function getAgentStatusTone(
-  status: OpenClawStatus['status'] | undefined,
-): AgentCardData['status'] {
-  if (status === 'error') return 'error'
-  if (status === 'starting') return 'working'
-  return 'idle'
-}
-
-async function getAgentCardData(
-  agent: AgentEntry,
-  status: OpenClawStatus['status'] | undefined,
-): Promise<AgentCardData> {
-  const conversation = await getLatestConversation(agent.agentId)
-  const lastTurn = conversation?.turns[conversation.turns.length - 1]
-  const lastTextPart = lastTurn?.parts.findLast((part) => part.kind === 'text')
-
-  return {
-    agentId: agent.agentId,
-    name: agent.name,
-    model: getModelDisplayName(agent.model),
-    status: getAgentStatusTone(status),
-    lastMessage:
-      lastTextPart?.kind === 'text'
-        ? lastTextPart.text.slice(0, 120)
-        : undefined,
-    lastMessageTimestamp: lastTurn?.timestamp,
-  }
-}
-
-export function useAgentCardData(
-  agents: AgentEntry[],
-  status: OpenClawStatus['status'] | undefined,
-) {
-  const [cardData, setCardData] = useState<AgentCardData[]>([])
-
-  useEffect(() => {
-    let active = true
-
-    const loadCardData = async () => {
-      const nextCardData = await Promise.all(
-        agents.map((agent) => getAgentCardData(agent, status)),
-      )
-      if (active) {
-        setCardData(nextCardData)
-      }
-    }
-
-    if (agents.length > 0) {
-      void loadCardData()
-    } else {
-      setCardData([])
-    }
-
-    return () => {
-      active = false
-    }
-  }, [agents, status])
-
-  return cardData
-}

packages/browseros-agent/apps/agent/entrypoints/app/agent-command/useAgentConversation.ts

@@ -1,256 +0,0 @@
-import { useEffect, useRef, useState } from 'react'
-import {
-  chatWithAgent,
-  type OpenClawStreamEvent,
-} from '@/entrypoints/app/agents/useOpenClaw'
-import {
-  getLatestConversation,
-  saveConversation,
-} from '@/lib/agent-conversations/storage'
-import type {
-  AgentConversation,
-  AgentConversationTurn,
-  AssistantPart,
-} from '@/lib/agent-conversations/types'
-import { consumeSSEStream } from '@/lib/sse'
-
-export function useAgentConversation(agentId: string, agentName: string) {
-  const [turns, setTurns] = useState<AgentConversationTurn[]>([])
-  const [streaming, setStreaming] = useState(false)
-  const [loading, setLoading] = useState(true)
-  const sessionKeyRef = useRef('')
-  const textAccRef = useRef('')
-  const thinkAccRef = useRef('')
-  const streamAbortRef = useRef<AbortController | null>(null)
-
-  useEffect(() => {
-    let active = true
-    getLatestConversation(agentId)
-      .then((conv) => {
-        if (!active) return
-        if (conv) {
-          setTurns(conv.turns)
-          sessionKeyRef.current = conv.sessionKey
-        } else {
-          sessionKeyRef.current = crypto.randomUUID()
-        }
-        setLoading(false)
-      })
-      .catch(() => {
-        if (active) {
-          sessionKeyRef.current = crypto.randomUUID()
-          setLoading(false)
-        }
-      })
-    return () => {
-      active = false
-    }
-  }, [agentId])
-
-  useEffect(() => {
-    return () => {
-      streamAbortRef.current?.abort()
-    }
-  }, [])
-
-  const persistTurns = (updatedTurns: AgentConversationTurn[]) => {
-    const conv: AgentConversation = {
-      agentId,
-      agentName,
-      sessionKey: sessionKeyRef.current,
-      turns: updatedTurns,
-      createdAt: updatedTurns[0]?.timestamp ?? Date.now(),
-      updatedAt: Date.now(),
-    }
-    saveConversation(conv).catch(() => {})
-  }
-
-  const updateCurrentTurnParts = (
-    updater: (parts: AssistantPart[]) => AssistantPart[],
-  ) => {
-    setTurns((prev) => {
-      const last = prev[prev.length - 1]
-      if (!last) return prev
-      return [...prev.slice(0, -1), { ...last, parts: updater(last.parts) }]
-    })
-  }
-
-  const processStreamEvent = (event: OpenClawStreamEvent) => {
-    switch (event.type) {
-      case 'text-delta': {
-        const delta = (event.data.text as string) ?? ''
-        textAccRef.current += delta
-        const text = textAccRef.current
-        updateCurrentTurnParts((parts) => {
-          const last = parts[parts.length - 1]
-          if (last?.kind === 'text') {
-            return [...parts.slice(0, -1), { ...last, text }]
-          }
-          return [...parts, { kind: 'text', text }]
-        })
-        break
-      }
-
-      case 'thinking': {
-        const delta = (event.data.text as string) ?? ''
-        thinkAccRef.current += delta
-        const text = thinkAccRef.current
-        updateCurrentTurnParts((parts) => {
-          const idx = parts.findIndex((p) => p.kind === 'thinking' && !p.done)
-          if (idx >= 0) {
-            return [
-              ...parts.slice(0, idx),
-              { ...parts[idx], text, done: false },
-              ...parts.slice(idx + 1),
-            ]
-          }
-          return [...parts, { kind: 'thinking', text, done: false }]
-        })
-        break
-      }
-
-      case 'tool-start': {
-        const tool = {
-          id: (event.data.toolCallId as string) ?? crypto.randomUUID(),
-          name: (event.data.toolName as string) ?? 'unknown',
-          status: 'running' as const,
-        }
-        updateCurrentTurnParts((parts) => {
-          const last = parts[parts.length - 1]
-          if (last?.kind === 'tool-batch') {
-            return [
-              ...parts.slice(0, -1),
-              { ...last, tools: [...last.tools, tool] },
-            ]
-          }
-          return [...parts, { kind: 'tool-batch', tools: [tool] }]
-        })
-        break
-      }
-
-      case 'tool-end': {
-        const toolId = event.data.toolCallId as string
-        const toolStatus: 'completed' | 'error' =
-          (event.data.status as string) === 'error' ? 'error' : 'completed'
-        const durationMs = event.data.durationMs as number | undefined
-        updateCurrentTurnParts((parts) => {
-          for (let i = parts.length - 1; i >= 0; i--) {
-            const part = parts[i]
-            if (
-              part.kind === 'tool-batch' &&
-              part.tools.some((t) => t.id === toolId)
-            ) {
-              const updatedTools = part.tools.map((t) =>
-                t.id === toolId ? { ...t, status: toolStatus, durationMs } : t,
-              )
-              return [
-                ...parts.slice(0, i),
-                { ...part, tools: updatedTools },
-                ...parts.slice(i + 1),
-              ]
-            }
-          }
-          return parts
-        })
-        break
-      }
-
-      case 'done': {
-        updateCurrentTurnParts((parts) =>
-          parts.map((part) =>
-            part.kind === 'thinking' ? { ...part, done: true } : part,
-          ),
-        )
-        setTurns((prev) => {
-          const last = prev[prev.length - 1]
-          if (!last) return prev
-          const updated = [...prev.slice(0, -1), { ...last, done: true }]
-          persistTurns(updated)
-          return updated
-        })
-        break
-      }
-
-      case 'error': {
-        const msg =
-          (event.data.message as string) ??
-          (event.data.error as string) ??
-          'Unknown error'
-        updateCurrentTurnParts((parts) => [
-          ...parts,
-          { kind: 'text', text: `Error: ${msg}` },
-        ])
-        break
-      }
-    }
-  }
-
-  const send = async (text: string) => {
-    if (!text.trim() || streaming) return
-
-    const turn: AgentConversationTurn = {
-      id: crypto.randomUUID(),
-      userText: text.trim(),
-      parts: [],
-      done: false,
-      timestamp: Date.now(),
-    }
-    setTurns((prev) => [...prev, turn])
-    setStreaming(true)
-    textAccRef.current = ''
-    thinkAccRef.current = ''
-    const abortController = new AbortController()
-    streamAbortRef.current = abortController
-
-    try {
-      const response = await chatWithAgent(
-        agentId,
-        text.trim(),
-        sessionKeyRef.current,
-        abortController.signal,
-      )
-      if (!response.ok) {
-        const err = await response.text()
-        updateCurrentTurnParts((parts) => [
-          ...parts,
-          { kind: 'text', text: `Error: ${err}` },
-        ])
-        return
-      }
-      await consumeSSEStream(
-        response,
-        processStreamEvent,
-        abortController.signal,
-      )
-    } catch (err) {
-      if (abortController.signal.aborted) return
-      const msg = err instanceof Error ? err.message : String(err)
-      updateCurrentTurnParts((parts) => [
-        ...parts,
-        { kind: 'text', text: `Error: ${msg}` },
-      ])
-    } finally {
-      if (streamAbortRef.current === abortController) {
-        streamAbortRef.current = null
-      }
-      setStreaming(false)
-    }
-  }
-
-  const resetConversation = () => {
-    streamAbortRef.current?.abort()
-    streamAbortRef.current = null
-    setTurns([])
-    setStreaming(false)
-    sessionKeyRef.current = crypto.randomUUID()
-  }
-
-  return {
-    turns,
-    streaming,
-    loading,
-    sessionKey: sessionKeyRef.current,
-    send,
-    resetConversation,
-  }
-}

packages/browseros-agent/apps/agent/entrypoints/app/agents/AgentChat.tsx

@@ -1,393 +0,0 @@
-import {
-  ArrowLeft,
-  Bot,
-  CheckCircle2,
-  Loader2,
-  Send,
-  XCircle,
-} from 'lucide-react'
-import { type FC, useEffect, useRef, useState } from 'react'
-import {
-  Message,
-  MessageContent,
-  MessageResponse,
-} from '@/components/ai-elements/message'
-import {
-  Reasoning,
-  ReasoningContent,
-  ReasoningTrigger,
-} from '@/components/ai-elements/reasoning'
-import { Button } from '@/components/ui/button'
-import { Textarea } from '@/components/ui/textarea'
-import { consumeSSEStream } from '@/lib/sse'
-import { chatWithAgent, type OpenClawStreamEvent } from './useOpenClaw'
-
-interface ToolEntry {
-  id: string
-  name: string
-  status: 'running' | 'completed' | 'error'
-  durationMs?: number
-}
-
-type AssistantPart =
-  | { kind: 'thinking'; text: string; done: boolean }
-  | { kind: 'tool-batch'; tools: ToolEntry[] }
-  | { kind: 'text'; text: string }
-
-interface ChatTurn {
-  id: string
-  userText: string
-  parts: AssistantPart[]
-  done: boolean
-}
-
-interface AgentChatProps {
-  agentId: string
-  agentName: string
-  onBack: () => void
-}
-
-export const AgentChat: FC<AgentChatProps> = ({
-  agentId,
-  agentName,
-  onBack,
-}) => {
-  const [turns, setTurns] = useState<ChatTurn[]>([])
-  const [input, setInput] = useState('')
-  const [streaming, setStreaming] = useState(false)
-  const scrollRef = useRef<HTMLDivElement>(null)
-  const sessionKeyRef = useRef(crypto.randomUUID())
-  const streamAbortRef = useRef<AbortController | null>(null)
-
-  const textAccRef = useRef('')
-  const thinkAccRef = useRef('')
-
-  const scrollToBottom = () => {
-    scrollRef.current?.scrollTo(0, scrollRef.current.scrollHeight)
-  }
-
-  // biome-ignore lint/correctness/useExhaustiveDependencies: scroll on every turns change
-  useEffect(() => {
-    scrollToBottom()
-  }, [turns])
-
-  useEffect(() => {
-    return () => {
-      streamAbortRef.current?.abort()
-    }
-  }, [])
-
-  const updateCurrentTurnParts = (
-    updater: (parts: AssistantPart[]) => AssistantPart[],
-  ) => {
-    setTurns((prev) => {
-      const last = prev[prev.length - 1]
-      if (!last) return prev
-      return [...prev.slice(0, -1), { ...last, parts: updater(last.parts) }]
-    })
-  }
-
-  const processStreamEvent = (event: OpenClawStreamEvent) => {
-    switch (event.type) {
-      case 'text-delta': {
-        const delta = (event.data.text as string) ?? ''
-        textAccRef.current += delta
-        const text = textAccRef.current
-        updateCurrentTurnParts((parts) => {
-          const last = parts[parts.length - 1]
-          if (last?.kind === 'text') {
-            return [...parts.slice(0, -1), { ...last, text }]
-          }
-          return [...parts, { kind: 'text', text }]
-        })
-        break
-      }
-
-      case 'thinking': {
-        const delta = (event.data.text as string) ?? ''
-        thinkAccRef.current += delta
-        const text = thinkAccRef.current
-        updateCurrentTurnParts((parts) => {
-          const idx = parts.findIndex((p) => p.kind === 'thinking' && !p.done)
-          if (idx >= 0) {
-            return [
-              ...parts.slice(0, idx),
-              { ...parts[idx], text, done: false },
-              ...parts.slice(idx + 1),
-            ]
-          }
-          return [...parts, { kind: 'thinking', text, done: false }]
-        })
-        break
-      }
-
-      case 'tool-start': {
-        const tool: ToolEntry = {
-          id: (event.data.toolCallId as string) ?? crypto.randomUUID(),
-          name: (event.data.toolName as string) ?? 'unknown',
-          status: 'running',
-        }
-        updateCurrentTurnParts((parts) => {
-          const last = parts[parts.length - 1]
-          if (last?.kind === 'tool-batch') {
-            return [
-              ...parts.slice(0, -1),
-              { ...last, tools: [...last.tools, tool] },
-            ]
-          }
-          return [...parts, { kind: 'tool-batch', tools: [tool] }]
-        })
-        break
-      }
-
-      case 'tool-end': {
-        const toolId = event.data.toolCallId as string
-        const status =
-          (event.data.status as string) === 'error' ? 'error' : 'completed'
-        const durationMs = event.data.durationMs as number | undefined
-        updateCurrentTurnParts((parts) => {
-          for (let i = parts.length - 1; i >= 0; i--) {
-            const part = parts[i]
-            if (
-              part.kind === 'tool-batch' &&
-              part.tools.some((t) => t.id === toolId)
-            ) {
-              const updatedTools = part.tools.map((t) =>
-                t.id === toolId
-                  ? {
-                      ...t,
-                      status: status as ToolEntry['status'],
-                      durationMs,
-                    }
-                  : t,
-              )
-              return [
-                ...parts.slice(0, i),
-                { ...part, tools: updatedTools },
-                ...parts.slice(i + 1),
-              ]
-            }
-          }
-          return parts
-        })
-        break
-      }
-
-      case 'done': {
-        updateCurrentTurnParts((parts) =>
-          parts.map((part) =>
-            part.kind === 'thinking' ? { ...part, done: true } : part,
-          ),
-        )
-        setTurns((prev) => {
-          const last = prev[prev.length - 1]
-          if (!last) return prev
-          return [...prev.slice(0, -1), { ...last, done: true }]
-        })
-        break
-      }
-
-      case 'error': {
-        const msg =
-          (event.data.message as string) ??
-          (event.data.error as string) ??
-          'Unknown error'
-        updateCurrentTurnParts((parts) => [
-          ...parts,
-          { kind: 'text', text: `Error: ${msg}` },
-        ])
-        break
-      }
-    }
-  }
-
-  const handleSend = async () => {
-    const text = input.trim()
-    if (!text || streaming) return
-
-    const turn: ChatTurn = {
-      id: crypto.randomUUID(),
-      userText: text,
-      parts: [],
-      done: false,
-    }
-    setTurns((prev) => [...prev, turn])
-    setInput('')
-    setStreaming(true)
-
-    textAccRef.current = ''
-    thinkAccRef.current = ''
-    const abortController = new AbortController()
-    streamAbortRef.current = abortController
-
-    try {
-      const response = await chatWithAgent(
-        agentId,
-        text,
-        sessionKeyRef.current,
-        abortController.signal,
-      )
-
-      if (!response.ok) {
-        const err = await response.text()
-        updateCurrentTurnParts((parts) => [
-          ...parts,
-          { kind: 'text', text: `Error: ${err}` },
-        ])
-        return
-      }
-
-      await consumeSSEStream(
-        response,
-        processStreamEvent,
-        abortController.signal,
-      )
-    } catch (err) {
-      if (abortController.signal.aborted) return
-      const msg = err instanceof Error ? err.message : String(err)
-      updateCurrentTurnParts((parts) => [
-        ...parts,
-        { kind: 'text', text: `Error: ${msg}` },
-      ])
-    } finally {
-      if (streamAbortRef.current === abortController) {
-        streamAbortRef.current = null
-      }
-      setStreaming(false)
-    }
-  }
-
-  return (
-    <div className="flex h-[calc(100vh-4rem)] flex-col">
-      <div className="flex items-center gap-2 border-b px-4 py-3">
-        <Button variant="ghost" size="icon" onClick={onBack}>
-          <ArrowLeft className="size-4" />
-        </Button>
-        <h2 className="font-semibold text-lg">{agentName}</h2>
-      </div>
-
-      <div ref={scrollRef} className="flex-1 space-y-4 overflow-y-auto p-4">
-        {turns.map((turn) => (
-          <div key={turn.id} className="space-y-3">
-            {/* User message */}
-            <Message from="user">
-              <MessageContent>
-                <pre className="whitespace-pre-wrap font-sans text-sm">
-                  {turn.userText}
-                </pre>
-              </MessageContent>
-            </Message>
-
-            {/* Assistant response — all parts grouped */}
-            {turn.parts.length > 0 && (
-              <Message from="assistant">
-                <MessageContent>
-                  {turn.parts.map((part, i) => {
-                    const key = `${turn.id}-part-${i}`
-
-                    switch (part.kind) {
-                      case 'thinking':
-                        return (
-                          <Reasoning
-                            key={key}
-                            className="w-full"
-                            isStreaming={!part.done}
-                            defaultOpen={!part.done}
-                          >
-                            <ReasoningTrigger />
-                            <ReasoningContent>{part.text}</ReasoningContent>
-                          </Reasoning>
-                        )
-
-                      case 'tool-batch':
-                        return (
-                          <div key={key} className="w-full space-y-1">
-                            {part.tools.map((tool) => (
-                              <div
-                                key={tool.id}
-                                className="flex items-center gap-2 rounded-md border px-3 py-2 text-sm"
-                              >
-                                {tool.status === 'running' && (
-                                  <Loader2 className="size-3.5 animate-spin text-muted-foreground" />
-                                )}
-                                {tool.status === 'completed' && (
-                                  <CheckCircle2 className="size-3.5 text-green-500" />
-                                )}
-                                {tool.status === 'error' && (
-                                  <XCircle className="size-3.5 text-destructive" />
-                                )}
-                                <span className="font-mono text-xs">
-                                  {tool.name}
-                                </span>
-                                {tool.durationMs != null && (
-                                  <span className="ml-auto text-muted-foreground text-xs">
-                                    {(tool.durationMs / 1000).toFixed(1)}s
-                                  </span>
-                                )}
-                              </div>
-                            ))}
-                          </div>
-                        )
-
-                      case 'text':
-                        return (
-                          <MessageResponse key={key}>
-                            {part.text}
-                          </MessageResponse>
-                        )
-                      default:
-                        return null
-                    }
-                  })}
-                </MessageContent>
-              </Message>
-            )}
-
-            {/* Streaming indicator when waiting for first part */}
-            {!turn.done && turn.parts.length === 0 && streaming && (
-              <div className="flex gap-2">
-                <div className="flex h-7 w-7 shrink-0 items-center justify-center rounded-full bg-[var(--accent-orange)] text-white">
-                  <Bot className="h-3.5 w-3.5" />
-                </div>
-                <div className="flex items-center gap-1 rounded-xl rounded-tl-none border border-border/50 bg-card px-3 py-2.5 shadow-sm">
-                  <span className="h-1.5 w-1.5 animate-bounce rounded-full bg-[var(--accent-orange)] [animation-delay:-0.3s]" />
-                  <span className="h-1.5 w-1.5 animate-bounce rounded-full bg-[var(--accent-orange)] [animation-delay:-0.15s]" />
-                  <span className="h-1.5 w-1.5 animate-bounce rounded-full bg-[var(--accent-orange)]" />
-                </div>
-              </div>
-            )}
-          </div>
-        ))}
-      </div>
-
-      <div className="border-t p-4">
-        <div className="flex gap-2">
-          <Textarea
-            value={input}
-            onChange={(e) => setInput(e.target.value)}
-            onKeyDown={(e) => {
-              if (e.key === 'Enter' && !e.shiftKey) {
-                e.preventDefault()
-                handleSend()
-              }
-            }}
-            placeholder="Send a message..."
-            className="min-h-[44px] resize-none"
-            rows={1}
-          />
-          <Button
-            onClick={handleSend}
-            disabled={!input.trim() || streaming}
-            size="icon"
-          >
-            {streaming ? (
-              <Loader2 className="size-4 animate-spin" />
-            ) : (
-              <Send className="size-4" />
-            )}
-          </Button>
-        </div>
-      </div>
-    </div>
-  )
-}

packages/browseros-agent/apps/agent/entrypoints/app/agents/AgentTerminal.tsx

@@ -1,280 +0,0 @@
-import {
-  OPENCLAW_CONTAINER_HOME,
-  OPENCLAW_TERMINAL_SHELL,
-} from '@browseros/shared/constants/openclaw'
-import { FitAddon } from '@xterm/addon-fit'
-import { WebLinksAddon } from '@xterm/addon-web-links'
-import { Terminal } from '@xterm/xterm'
-import { ArrowLeft } from 'lucide-react'
-import { type FC, useEffect, useRef } from 'react'
-import '@xterm/xterm/css/xterm.css'
-import { Button } from '@/components/ui/button'
-import { getAgentServerUrl } from '@/lib/browseros/helpers'
-
-interface AgentTerminalProps {
-  onBack: () => void
-}
-
-type TerminalServerMessage =
-  | { type: 'output'; data: string }
-  | { type: 'exit'; exitCode: number }
-  | { type: 'error'; message: string }
-
-const TERMINAL_HOME_DIR = OPENCLAW_CONTAINER_HOME
-const TERMINAL_FONT_FAMILY =
-  '"Geist Mono", Menlo, Monaco, "Courier New", monospace'
-
-function resolveCssColor(variableName: string): string {
-  const probe = document.createElement('div')
-  probe.style.position = 'fixed'
-  probe.style.visibility = 'hidden'
-  probe.style.pointerEvents = 'none'
-  probe.style.color = `var(${variableName})`
-  document.body.append(probe)
-  const color = window.getComputedStyle(probe).color
-  probe.remove()
-  return color
-}
-
-function withAlpha(color: string, alpha: number): string {
-  const channels = color.match(/[\d.]+/g)
-  if (!channels || channels.length < 3) return color
-  const [red, green, blue] = channels
-  return `rgb(${red} ${green} ${blue} / ${alpha})`
-}
-
-function createTerminalTheme() {
-  const isDark = document.documentElement.classList.contains('dark')
-  const background = resolveCssColor('--background')
-  const foreground = resolveCssColor('--foreground')
-  const muted = resolveCssColor('--muted-foreground')
-  const accent = resolveCssColor('--accent-orange')
-
-  return {
-    background,
-    foreground,
-    cursor: foreground,
-    cursorAccent: background,
-    selectionBackground: withAlpha(accent, isDark ? 0.3 : 0.2),
-    selectionForeground: foreground,
-    black: isDark ? '#16131a' : '#1f1b22',
-    red: isDark ? '#ef8c7c' : '#c25544',
-    green: isDark ? '#9ac67c' : '#5c8754',
-    yellow: isDark ? '#e5c07b' : '#b7791f',
-    blue: isDark ? '#8ba9ff' : '#4667d8',
-    magenta: isDark ? '#d2a8ff' : '#955ec7',
-    cyan: isDark ? '#7fd4d1' : '#0f766e',
-    white: isDark ? '#e8e0d9' : '#f7f1eb',
-    brightBlack: muted,
-    brightRed: isDark ? '#ffb0a4' : '#dc7b6d',
-    brightGreen: isDark ? '#b6d99e' : '#7bab74',
-    brightYellow: isDark ? '#f2d59b' : '#d49a44',
-    brightBlue: isDark ? '#b3c4ff' : '#6f8cf0',
-    brightMagenta: isDark ? '#e2c6ff' : '#b789dd',
-    brightCyan: isDark ? '#a6ece7' : '#3aa5a0',
-    brightWhite: isDark ? '#fff8f1' : '#ffffff',
-  }
-}
-
-function parseTerminalMessage(data: unknown): TerminalServerMessage | null {
-  if (typeof data !== 'string') return null
-
-  let parsed: unknown
-  try {
-    parsed = JSON.parse(data) as unknown
-  } catch {
-    return null
-  }
-  if (
-    parsed &&
-    typeof parsed === 'object' &&
-    'type' in parsed &&
-    parsed.type === 'output' &&
-    'data' in parsed &&
-    typeof parsed.data === 'string'
-  ) {
-    return { type: 'output', data: parsed.data }
-  }
-  if (
-    parsed &&
-    typeof parsed === 'object' &&
-    'type' in parsed &&
-    parsed.type === 'error' &&
-    'message' in parsed &&
-    typeof parsed.message === 'string'
-  ) {
-    return { type: 'error', message: parsed.message }
-  }
-  if (
-    parsed &&
-    typeof parsed === 'object' &&
-    'type' in parsed &&
-    parsed.type === 'exit' &&
-    'exitCode' in parsed &&
-    typeof parsed.exitCode === 'number'
-  ) {
-    return { type: 'exit', exitCode: parsed.exitCode }
-  }
-  return null
-}
-
-export const AgentTerminal: FC<AgentTerminalProps> = ({ onBack }) => {
-  const containerRef = useRef<HTMLDivElement>(null)
-
-  useEffect(() => {
-    if (!containerRef.current) return
-
-    const terminal = new Terminal({
-      fontSize: 14,
-      fontFamily: TERMINAL_FONT_FAMILY,
-      cursorBlink: true,
-      cursorStyle: 'block',
-      lineHeight: 1.25,
-      scrollback: 8000,
-      theme: createTerminalTheme(),
-    })
-
-    const fitAddon = new FitAddon()
-    terminal.loadAddon(fitAddon)
-    terminal.loadAddon(new WebLinksAddon())
-    terminal.open(containerRef.current)
-
-    let ws: WebSocket | null = null
-    let sawExit = false
-
-    const applyTheme = (): void => {
-      terminal.options.theme = createTerminalTheme()
-    }
-
-    const sendMessage = (
-      message:
-        | { type: 'input'; data: string }
-        | { type: 'resize'; cols: number; rows: number },
-    ): void => {
-      if (ws?.readyState !== WebSocket.OPEN) return
-      ws.send(JSON.stringify(message))
-    }
-
-    const sendResize = (cols = terminal.cols, rows = terminal.rows): void => {
-      sendMessage({ type: 'resize', cols, rows })
-    }
-
-    const connect = async () => {
-      const baseUrl = await getAgentServerUrl()
-      const wsUrl = new URL('/terminal/ws', baseUrl)
-      wsUrl.protocol = wsUrl.protocol === 'https:' ? 'wss:' : 'ws:'
-
-      ws = new WebSocket(wsUrl)
-
-      ws.onopen = () => {
-        fitAddon.fit()
-        terminal.focus()
-        sendResize()
-      }
-
-      ws.onmessage = (event) => {
-        const message = parseTerminalMessage(event.data)
-        if (!message) return
-
-        if (message.type === 'output') {
-          terminal.write(message.data)
-        } else if (message.type === 'error') {
-          terminal.write(`\r\n\x1b[31m${message.message}\x1b[0m\r\n`)
-        } else {
-          sawExit = true
-          terminal.write(
-            `\r\n\x1b[90m[session ended with exit ${message.exitCode}]\x1b[0m\r\n`,
-          )
-        }
-      }
-
-      ws.onclose = () => {
-        if (sawExit) return
-        terminal.write('\r\n\x1b[90m[session ended]\x1b[0m\r\n')
-      }
-
-      ws.onerror = () => {
-        terminal.write('\r\n\x1b[31m[connection error]\x1b[0m\r\n')
-      }
-
-      const inputDisposable = terminal.onData((data) => {
-        sendMessage({ type: 'input', data })
-      })
-
-      const resizeDisposable = terminal.onResize(({ cols, rows }) => {
-        sendResize(cols, rows)
-      })
-
-      return () => {
-        inputDisposable.dispose()
-        resizeDisposable.dispose()
-      }
-    }
-
-    let disposeSocketBindings: (() => void) | undefined
-    void connect().then((disposeBindings) => {
-      disposeSocketBindings = disposeBindings
-    })
-
-    const resizeObserver = new ResizeObserver(() => {
-      fitAddon.fit()
-      sendResize()
-    })
-    resizeObserver.observe(containerRef.current)
-
-    const themeObserver = new MutationObserver(() => {
-      applyTheme()
-    })
-    themeObserver.observe(document.documentElement, {
-      attributes: true,
-      attributeFilter: ['class'],
-    })
-
-    return () => {
-      resizeObserver.disconnect()
-      themeObserver.disconnect()
-      disposeSocketBindings?.()
-      ws?.close()
-      terminal.dispose()
-    }
-  }, [])
-
-  return (
-    <div className="flex h-[calc(100dvh-10rem)] min-h-[32rem] w-full flex-col py-2 sm:min-h-[42rem] sm:py-4">
-      <div className="flex min-h-0 flex-1 flex-col overflow-hidden rounded-xl border border-border bg-card shadow-sm">
-        <div className="flex items-center gap-3 border-border border-b px-4 py-3 sm:px-6">
-          <div className="flex min-w-0 items-center gap-3">
-            <Button variant="ghost" size="icon" onClick={onBack}>
-              <ArrowLeft className="size-4" />
-            </Button>
-            <div className="min-w-0">
-              <div className="truncate font-semibold text-sm">
-                Container Terminal
-              </div>
-              <div className="truncate text-muted-foreground text-sm">
-                OpenClaw shell in {TERMINAL_HOME_DIR}
-              </div>
-            </div>
-          </div>
-        </div>
-
-        <div className="min-h-0 flex-1 p-4 sm:p-6">
-          <div className="agent-terminal-shell flex h-full min-h-0 flex-col overflow-hidden rounded-lg border border-border bg-background">
-            <div className="flex items-center justify-between gap-3 border-border border-b px-4 py-2.5">
-              <div className="truncate font-mono text-muted-foreground text-xs">
-                {TERMINAL_HOME_DIR}
-              </div>
-              <div className="font-mono text-[11px] text-muted-foreground">
-                {OPENCLAW_TERMINAL_SHELL.split('/').pop()}
-              </div>
-            </div>
-
-            <div className="min-h-0 flex-1 px-4 py-4 sm:px-5 sm:py-5">
-              <div ref={containerRef} className="h-full w-full" />
-            </div>
-          </div>
-        </div>
-      </div>
-    </div>
-  )
-}

packages/browseros-agent/apps/agent/entrypoints/app/agents/useOpenClaw.ts

@@ -1,330 +0,0 @@
-import type {
-  BrowserOSAgentRoleId,
-  BrowserOSCustomRoleInput,
-} from '@browseros/shared/types/role-aware-agents'
-import { useMutation, useQuery, useQueryClient } from '@tanstack/react-query'
-import { getAgentServerUrl } from '@/lib/browseros/helpers'
-import { useAgentServerUrl } from '@/lib/browseros/useBrowserOSProviders'
-
-export interface AgentEntry {
-  agentId: string
-  name: string
-  workspace: string
-  model?: unknown
-  role?: {
-    roleSource: 'builtin' | 'custom'
-    roleId?: BrowserOSAgentRoleId
-    roleName: string
-    shortDescription: string
-  }
-}
-
-export interface RoleTemplateSummary {
-  id: BrowserOSAgentRoleId
-  name: string
-  shortDescription: string
-  longDescription: string
-  recommendedApps: string[]
-  defaultAgentName: string
-  boundaries: Array<{
-    key: string
-    label: string
-    description: string
-    defaultMode: 'allow' | 'ask' | 'block'
-  }>
-}
-
-export interface OpenClawStatus {
-  status: 'uninitialized' | 'starting' | 'running' | 'stopped' | 'error'
-  podmanAvailable: boolean
-  machineReady: boolean
-  port: number | null
-  agentCount: number
-  error: string | null
-  controlPlaneStatus:
-    | 'disconnected'
-    | 'connecting'
-    | 'connected'
-    | 'reconnecting'
-    | 'recovering'
-    | 'failed'
-  lastGatewayError: string | null
-  lastRecoveryReason:
-    | 'transient_disconnect'
-    | 'signature_expired'
-    | 'pairing_required'
-    | 'token_mismatch'
-    | 'container_not_ready'
-    | 'unknown'
-    | null
-}
-
-export interface OpenClawAgentMutationInput {
-  name: string
-  roleId?: BrowserOSAgentRoleId
-  customRole?: BrowserOSCustomRoleInput
-  providerType?: string
-  providerName?: string
-  baseUrl?: string
-  apiKey?: string
-  modelId?: string
-}
-
-export interface OpenClawSetupInput {
-  providerType?: string
-  providerName?: string
-  baseUrl?: string
-  apiKey?: string
-  modelId?: string
-}
-
-export function getModelDisplayName(model: unknown): string | undefined {
-  if (typeof model === 'string') return model.split('/').pop()
-  return undefined
-}
-
-export const OPENCLAW_QUERY_KEYS = {
-  status: 'openclaw-status',
-  agents: 'openclaw-agents',
-  roles: 'openclaw-roles',
-} as const
-
-async function clawFetch<T>(
-  baseUrl: string,
-  path: string,
-  init?: RequestInit,
-): Promise<T> {
-  const res = await fetch(`${baseUrl}/claw${path}`, init)
-  if (!res.ok) {
-    let message = `Request failed with status ${res.status}`
-    try {
-      const body = (await res.json()) as { error?: string }
-      if (body.error) {
-        message = body.error
-      }
-    } catch {}
-    throw new Error(message)
-  }
-  return res.json() as Promise<T>
-}
-
-async function fetchOpenClawStatus(baseUrl: string): Promise<OpenClawStatus> {
-  return clawFetch<OpenClawStatus>(baseUrl, '/status')
-}
-
-async function fetchOpenClawAgents(baseUrl: string): Promise<AgentEntry[]> {
-  const data = await clawFetch<{ agents: AgentEntry[] }>(baseUrl, '/agents')
-  return data.agents ?? []
-}
-
-async function fetchOpenClawRoles(
-  baseUrl: string,
-): Promise<RoleTemplateSummary[]> {
-  const data = await clawFetch<{ roles: RoleTemplateSummary[] }>(
-    baseUrl,
-    '/roles',
-  )
-  return data.roles ?? []
-}
-
-async function invalidateOpenClawQueries(
-  queryClient: ReturnType<typeof useQueryClient>,
-): Promise<void> {
-  await Promise.all([
-    queryClient.invalidateQueries({ queryKey: [OPENCLAW_QUERY_KEYS.status] }),
-    queryClient.invalidateQueries({ queryKey: [OPENCLAW_QUERY_KEYS.agents] }),
-  ])
-}
-
-export function useOpenClawStatus(pollMs = 5000) {
-  const {
-    baseUrl,
-    isLoading: urlLoading,
-    error: urlError,
-  } = useAgentServerUrl()
-
-  const query = useQuery<OpenClawStatus, Error>({
-    queryKey: [OPENCLAW_QUERY_KEYS.status, baseUrl],
-    queryFn: () => fetchOpenClawStatus(baseUrl as string),
-    enabled: !!baseUrl && !urlLoading,
-    refetchInterval: pollMs,
-  })
-
-  return {
-    status: query.data ?? null,
-    loading: query.isLoading || urlLoading,
-    error: query.error ?? urlError,
-    refetch: query.refetch,
-  }
-}
-
-export function useOpenClawAgents(enabled = true) {
-  const {
-    baseUrl,
-    isLoading: urlLoading,
-    error: urlError,
-  } = useAgentServerUrl()
-
-  const query = useQuery<AgentEntry[], Error>({
-    queryKey: [OPENCLAW_QUERY_KEYS.agents, baseUrl],
-    queryFn: () => fetchOpenClawAgents(baseUrl as string),
-    enabled: !!baseUrl && !urlLoading && enabled,
-  })
-
-  return {
-    agents: query.data ?? [],
-    loading: query.isLoading || urlLoading,
-    error: query.error ?? urlError,
-    refetch: query.refetch,
-  }
-}
-
-export function useOpenClawRoles() {
-  const {
-    baseUrl,
-    isLoading: urlLoading,
-    error: urlError,
-  } = useAgentServerUrl()
-
-  const query = useQuery<RoleTemplateSummary[], Error>({
-    queryKey: [OPENCLAW_QUERY_KEYS.roles, baseUrl],
-    queryFn: () => fetchOpenClawRoles(baseUrl as string),
-    enabled: !!baseUrl && !urlLoading,
-    staleTime: 60_000,
-  })
-
-  return {
-    roles: query.data ?? [],
-    loading: query.isLoading || urlLoading,
-    error: query.error ?? urlError,
-    refetch: query.refetch,
-  }
-}
-
-export function useOpenClawMutations() {
-  const { baseUrl, isLoading: urlLoading } = useAgentServerUrl()
-  const queryClient = useQueryClient()
-
-  const ensureBaseUrl = () => {
-    if (!baseUrl || urlLoading) {
-      throw new Error('BrowserOS agent server URL is not ready')
-    }
-    return baseUrl
-  }
-
-  const onSuccess = () => invalidateOpenClawQueries(queryClient)
-
-  const setupMutation = useMutation({
-    mutationFn: async (input: OpenClawSetupInput) =>
-      clawFetch<{ status: string; agents: AgentEntry[] }>(
-        ensureBaseUrl(),
-        '/setup',
-        {
-          method: 'POST',
-          headers: { 'Content-Type': 'application/json' },
-          body: JSON.stringify(input),
-        },
-      ),
-    onSuccess,
-  })
-
-  const createMutation = useMutation({
-    mutationFn: async (input: OpenClawAgentMutationInput) =>
-      clawFetch<{ agent: AgentEntry }>(ensureBaseUrl(), '/agents', {
-        method: 'POST',
-        headers: { 'Content-Type': 'application/json' },
-        body: JSON.stringify(input),
-      }),
-    onSuccess,
-  })
-
-  const deleteMutation = useMutation({
-    mutationFn: async (id: string) =>
-      clawFetch<{ success: boolean }>(ensureBaseUrl(), `/agents/${id}`, {
-        method: 'DELETE',
-      }),
-    onSuccess,
-  })
-
-  const startMutation = useMutation({
-    mutationFn: async () =>
-      clawFetch<{ status: string }>(ensureBaseUrl(), '/start', {
-        method: 'POST',
-      }),
-    onSuccess,
-  })
-
-  const stopMutation = useMutation({
-    mutationFn: async () =>
-      clawFetch<{ status: string }>(ensureBaseUrl(), '/stop', {
-        method: 'POST',
-      }),
-    onSuccess,
-  })
-
-  const restartMutation = useMutation({
-    mutationFn: async () =>
-      clawFetch<{ status: string }>(ensureBaseUrl(), '/restart', {
-        method: 'POST',
-      }),
-    onSuccess,
-  })
-
-  const reconnectMutation = useMutation({
-    mutationFn: async () =>
-      clawFetch<{ status: string }>(ensureBaseUrl(), '/reconnect', {
-        method: 'POST',
-      }),
-    onSuccess,
-  })
-
-  return {
-    setupOpenClaw: setupMutation.mutateAsync,
-    createAgent: createMutation.mutateAsync,
-    deleteAgent: deleteMutation.mutateAsync,
-    startOpenClaw: startMutation.mutateAsync,
-    stopOpenClaw: stopMutation.mutateAsync,
-    restartOpenClaw: restartMutation.mutateAsync,
-    reconnectOpenClaw: reconnectMutation.mutateAsync,
-    actionInProgress:
-      setupMutation.isPending ||
-      createMutation.isPending ||
-      deleteMutation.isPending ||
-      startMutation.isPending ||
-      stopMutation.isPending ||
-      restartMutation.isPending ||
-      reconnectMutation.isPending,
-    settingUp: setupMutation.isPending,
-    creating: createMutation.isPending,
-    deleting: deleteMutation.isPending,
-    reconnecting: reconnectMutation.isPending,
-  }
-}
-
-export interface OpenClawStreamEvent {
-  type:
-    | 'text-delta'
-    | 'thinking'
-    | 'tool-start'
-    | 'tool-end'
-    | 'tool-output'
-    | 'lifecycle'
-    | 'done'
-    | 'error'
-  data: Record<string, unknown>
-}
-
-export async function chatWithAgent(
-  agentId: string,
-  message: string,
-  sessionKey?: string,
-  signal?: AbortSignal,
-): Promise<Response> {
-  const baseUrl = await getAgentServerUrl()
-  return fetch(`${baseUrl}/claw/agents/${agentId}/chat`, {
-    method: 'POST',
-    headers: { 'Content-Type': 'application/json' },
-    body: JSON.stringify({ message, sessionKey }),
-    signal,
-  })
-}

packages/browseros-agent/apps/agent/entrypoints/app/ai-settings/AISettingsPage.tsx

@@ -13,17 +13,6 @@ import {
 } from '@/components/ui/alert-dialog'
 import { useSessionInfo } from '@/lib/auth/sessionStorage'
 import { useAgentServerUrl } from '@/lib/browseros/useBrowserOSProviders'
-import {
-  CHATGPT_PRO_OAUTH_COMPLETED_EVENT,
-  CHATGPT_PRO_OAUTH_DISCONNECTED_EVENT,
-  CHATGPT_PRO_OAUTH_STARTED_EVENT,
-  GITHUB_COPILOT_OAUTH_COMPLETED_EVENT,
-  GITHUB_COPILOT_OAUTH_DISCONNECTED_EVENT,
-  GITHUB_COPILOT_OAUTH_STARTED_EVENT,
-  QWEN_CODE_OAUTH_COMPLETED_EVENT,
-  QWEN_CODE_OAUTH_DISCONNECTED_EVENT,
-  QWEN_CODE_OAUTH_STARTED_EVENT,
-} from '@/lib/constants/analyticsEvents'
 import { GetProfileIdByUserIdDocument } from '@/lib/conversations/graphql/uploadConversationDocument'
 import { getQueryKeyFromDocument } from '@/lib/graphql/getQueryKeyFromDocument'
 import { useGraphqlMutation } from '@/lib/graphql/useGraphqlMutation'
@@ -32,13 +21,7 @@ import type { ProviderTemplate } from '@/lib/llm-providers/providerTemplates'
 import { testProvider } from '@/lib/llm-providers/testProvider'
 import type { LlmProviderConfig } from '@/lib/llm-providers/types'
 import { useLlmProviders } from '@/lib/llm-providers/useLlmProviders'
-import {
-  type OAuthProviderFlowConfig,
-  useOAuthProviderFlow,
-} from '@/lib/llm-providers/useOAuthProviderFlow'
-import { track } from '@/lib/metrics/track'
 import { ConfiguredProvidersList } from './ConfiguredProvidersList'
-import { DeviceCodeDialog } from './DeviceCodeDialog'
 import {
   DeleteRemoteLlmProviderDocument,
   GetRemoteLlmProvidersDocument,
@@ -46,51 +29,9 @@ import {
 import type { IncompleteProvider } from './IncompleteProviderCard'
 import { IncompleteProvidersList } from './IncompleteProvidersList'
 import { LlmProvidersHeader } from './LlmProvidersHeader'
-import { McpPromoBanner } from './McpPromoBanner'
 import { NewProviderDialog } from './NewProviderDialog'
 import { ProviderTemplatesSection } from './ProviderTemplatesSection'
 
-// All OAuth providers share the same flow via useOAuthProviderFlow
-const OAUTH_PROVIDERS_CONFIG: Record<string, OAuthProviderFlowConfig> = {
-  'chatgpt-pro': {
-    providerType: 'chatgpt-pro',
-    displayName: 'ChatGPT Plus/Pro',
-    startedEvent: CHATGPT_PRO_OAUTH_STARTED_EVENT,
-    completedEvent: CHATGPT_PRO_OAUTH_COMPLETED_EVENT,
-    disconnectedEvent: CHATGPT_PRO_OAUTH_DISCONNECTED_EVENT,
-  },
-  'github-copilot': {
-    providerType: 'github-copilot',
-    displayName: 'GitHub Copilot',
-    startedEvent: GITHUB_COPILOT_OAUTH_STARTED_EVENT,
-    completedEvent: GITHUB_COPILOT_OAUTH_COMPLETED_EVENT,
-    disconnectedEvent: GITHUB_COPILOT_OAUTH_DISCONNECTED_EVENT,
-    clientAuth: {
-      deviceCodeEndpoint: 'https://github.com/login/device/code',
-      tokenEndpoint: 'https://github.com/login/oauth/access_token',
-      clientId: 'Ov23li8tweQw6odWQebz',
-      scopes: 'read:user',
-      requiresPKCE: false,
-      contentType: 'json',
-    },
-  },
-  'qwen-code': {
-    providerType: 'qwen-code',
-    displayName: 'Qwen Code',
-    startedEvent: QWEN_CODE_OAUTH_STARTED_EVENT,
-    completedEvent: QWEN_CODE_OAUTH_COMPLETED_EVENT,
-    disconnectedEvent: QWEN_CODE_OAUTH_DISCONNECTED_EVENT,
-    clientAuth: {
-      deviceCodeEndpoint: 'https://chat.qwen.ai/api/v1/oauth2/device/code',
-      tokenEndpoint: 'https://chat.qwen.ai/api/v1/oauth2/token',
-      clientId: 'f0304373b74a44d2b584a3fb70ca9e56',
-      scopes: 'openid profile email model.completion',
-      requiresPKCE: true,
-      contentType: 'form',
-    },
-  },
-}
-
 /**
  * AI Settings page for managing LLM providers
  * @public
@@ -137,7 +78,9 @@ export const AISettingsPage: FC = () => {
 
   const incompleteProviders = useMemo<IncompleteProvider[]>(() => {
     if (!remoteProvidersData?.llmProviders?.nodes) return []
+
     const localProviderIds = new Set(providers.map((p) => p.id))
+
     return remoteProvidersData.llmProviders.nodes
       .filter((node): node is NonNullable<typeof node> => node !== null)
       .filter((node) => !localProviderIds.has(node.rowId))
@@ -158,71 +101,12 @@ export const AISettingsPage: FC = () => {
     null,
   )
 
-  // OAuth flows — shared hook eliminates per-provider duplication
-  const chatgptPro = useOAuthProviderFlow(
-    OAUTH_PROVIDERS_CONFIG['chatgpt-pro'],
-    providers,
-    saveProvider,
-  )
-  const copilot = useOAuthProviderFlow(
-    OAUTH_PROVIDERS_CONFIG['github-copilot'],
-    providers,
-    saveProvider,
-  )
-  const qwenCode = useOAuthProviderFlow(
-    OAUTH_PROVIDERS_CONFIG['qwen-code'],
-    providers,
-    saveProvider,
-  )
-
-  const activeDeviceCode =
-    chatgptPro.pendingDeviceCode ??
-    copilot.pendingDeviceCode ??
-    qwenCode.pendingDeviceCode
-  const clearActiveDeviceCode = () => {
-    chatgptPro.clearDeviceCode()
-    copilot.clearDeviceCode()
-    qwenCode.clearDeviceCode()
-  }
-
-  const oauthFlows: Record<
-    string,
-    {
-      startOAuthFlow: (url: string | undefined) => Promise<void>
-      disconnect: () => Promise<void>
-      disconnectedEvent: string
-    }
-  > = {
-    'chatgpt-pro': {
-      startOAuthFlow: chatgptPro.startOAuthFlow,
-      disconnect: chatgptPro.disconnect,
-      disconnectedEvent: CHATGPT_PRO_OAUTH_DISCONNECTED_EVENT,
-    },
-    'github-copilot': {
-      startOAuthFlow: copilot.startOAuthFlow,
-      disconnect: copilot.disconnect,
-      disconnectedEvent: GITHUB_COPILOT_OAUTH_DISCONNECTED_EVENT,
-    },
-    'qwen-code': {
-      startOAuthFlow: qwenCode.startOAuthFlow,
-      disconnect: qwenCode.disconnect,
-      disconnectedEvent: QWEN_CODE_OAUTH_DISCONNECTED_EVENT,
-    },
-  }
-
   const handleAddProvider = () => {
     setTemplateValues(undefined)
     setIsNewDialogOpen(true)
   }
 
   const handleUseTemplate = (template: ProviderTemplate) => {
-    // OAuth providers: trigger OAuth flow
-    const oauthFlow = oauthFlows[template.id]
-    if (oauthFlow) {
-      oauthFlow.startOAuthFlow(agentServerUrl ?? undefined)
-      return
-    }
-
     setTemplateValues({
       type: template.id,
       name: template.name,
@@ -245,18 +129,11 @@ export const AISettingsPage: FC = () => {
   }
 
   const confirmDeleteProvider = async () => {
-    if (!providerToDelete) return
-
-    // Clear OAuth tokens on server for OAuth-based providers
-    const oauthFlow = oauthFlows[providerToDelete.type]
-    if (oauthFlow) {
-      await oauthFlow.disconnect()
-      track(oauthFlow.disconnectedEvent)
+    if (providerToDelete) {
+      await deleteProvider(providerToDelete.id)
+      deleteRemoteProviderMutation.mutate({ rowId: providerToDelete.id })
+      setProviderToDelete(null)
     }
-
-    await deleteProvider(providerToDelete.id)
-    deleteRemoteProviderMutation.mutate({ rowId: providerToDelete.id })
-    setProviderToDelete(null)
   }
 
   const handleAddKeysToIncomplete = (provider: IncompleteProvider) => {
@@ -359,8 +236,6 @@ export const AISettingsPage: FC = () => {
         onAddProvider={handleAddProvider}
       />
 
-      <McpPromoBanner />
-
       <ProviderTemplatesSection onUseTemplate={handleUseTemplate} />
 
       <ConfiguredProvidersList
@@ -435,11 +310,6 @@ export const AISettingsPage: FC = () => {
           </AlertDialogFooter>
         </AlertDialogContent>
       </AlertDialog>
-
-      <DeviceCodeDialog
-        deviceCode={activeDeviceCode}
-        onClose={clearActiveDeviceCode}
-      />
     </div>
   )
 }

packages/browseros-agent/apps/agent/entrypoints/app/ai-settings/DeviceCodeDialog.tsx

@@ -1,81 +0,0 @@
-import { Check, Copy, ExternalLink } from 'lucide-react'
-import { type FC, useState } from 'react'
-import { Button } from '@/components/ui/button'
-import {
-  Dialog,
-  DialogContent,
-  DialogDescription,
-  DialogHeader,
-  DialogTitle,
-} from '@/components/ui/dialog'
-import type { PendingDeviceCode } from '@/lib/llm-providers/useOAuthProviderFlow'
-
-interface DeviceCodeDialogProps {
-  deviceCode: PendingDeviceCode | null
-  onClose: () => void
-}
-
-export const DeviceCodeDialog: FC<DeviceCodeDialogProps> = ({
-  deviceCode,
-  onClose,
-}) => {
-  const [copied, setCopied] = useState(false)
-
-  const handleCopy = async () => {
-    if (!deviceCode) return
-    try {
-      await navigator.clipboard.writeText(deviceCode.userCode)
-      setCopied(true)
-      setTimeout(() => setCopied(false), 2000)
-    } catch {
-      // Clipboard API failed
-    }
-  }
-
-  return (
-    <Dialog open={!!deviceCode} onOpenChange={(open) => !open && onClose()}>
-      <DialogContent className="sm:max-w-md">
-        <DialogHeader>
-          <DialogTitle>Connect to {deviceCode?.providerName}</DialogTitle>
-          <DialogDescription>
-            Paste this code on the {deviceCode?.providerName} page that just
-            opened in your browser.
-          </DialogDescription>
-        </DialogHeader>
-        <div className="flex flex-col items-center gap-4 py-4">
-          <div className="flex items-center gap-3 rounded-xl border-2 border-[var(--accent-orange)]/40 border-dashed bg-[var(--accent-orange)]/5 px-6 py-4">
-            <code className="font-bold font-mono text-2xl text-foreground tracking-widest">
-              {deviceCode?.userCode}
-            </code>
-            <Button
-              variant="ghost"
-              size="icon"
-              onClick={handleCopy}
-              className="shrink-0"
-            >
-              {copied ? (
-                <Check className="h-4 w-4 text-green-600" />
-              ) : (
-                <Copy className="h-4 w-4" />
-              )}
-            </Button>
-          </div>
-          <p className="text-center text-muted-foreground text-xs">
-            This dialog will close automatically once authentication completes.
-          </p>
-          {deviceCode?.verificationUri && (
-            <a
-              href={deviceCode.verificationUri}
-              target="_blank"
-              rel="noopener noreferrer"
-              className="flex items-center gap-1 text-[var(--accent-orange)] text-xs transition-colors hover:underline"
-            >
-              Open verification page
-              <ExternalLink className="h-3 w-3" />
-            </a>
-          )}
-        </div>
-      </DialogContent>
-    </Dialog>
-  )
-}

packages/browseros-agent/apps/agent/entrypoints/app/ai-settings/McpPromoBanner.tsx

@@ -1,57 +0,0 @@
-import { ArrowRight, Server, X } from 'lucide-react'
-import { type FC, useState } from 'react'
-import { useNavigate } from 'react-router'
-import { Button } from '@/components/ui/button'
-import { MCP_PROMO_BANNER_CLICKED_EVENT } from '@/lib/constants/analyticsEvents'
-import { track } from '@/lib/metrics/track'
-
-export const McpPromoBanner: FC = () => {
-  const [dismissed, setDismissed] = useState(false)
-  const navigate = useNavigate()
-
-  if (dismissed) return null
-
-  const handleClick = () => {
-    track(MCP_PROMO_BANNER_CLICKED_EVENT)
-    navigate('/settings/mcp')
-  }
-
-  return (
-    <div className="flex items-center gap-4 rounded-xl border border-border bg-card p-4 shadow-sm transition-all hover:shadow-md">
-      <div className="flex h-10 w-10 shrink-0 items-center justify-center rounded-lg bg-[var(--accent-orange)]/10">
-        <Server className="h-5 w-5 text-[var(--accent-orange)]" />
-      </div>
-      <div className="min-w-0 flex-1">
-        <p className="flex items-center gap-2 font-semibold text-sm">
-          Use BrowserOS with Claude Code, Cursor & more
-          <span className="text-[var(--accent-orange)] text-xs">
-            (66+ tools)
-          </span>
-          <span className="inline-flex items-center gap-1 rounded-full bg-[var(--accent-orange)]/10 px-2.5 py-1 font-semibold text-[var(--accent-orange)] text-xs">
-            <span className="h-1.5 w-1.5 rounded-full bg-[var(--accent-orange)]" />
-            New
-          </span>
-        </p>
-        <p className="text-muted-foreground text-xs">
-          Connect your favorite coding tools to BrowserOS as an MCP server
-        </p>
-      </div>
-      <Button
-        variant="outline"
-        size="sm"
-        onClick={handleClick}
-        className="shrink-0 border-[var(--accent-orange)] bg-[var(--accent-orange)]/10 text-[var(--accent-orange)] hover:bg-[var(--accent-orange)]/20 hover:text-[var(--accent-orange)]"
-      >
-        Set up
-        <ArrowRight className="ml-1 h-3 w-3" />
-      </Button>
-      <button
-        type="button"
-        onClick={() => setDismissed(true)}
-        className="shrink-0 rounded-sm p-1 text-muted-foreground opacity-50 transition-opacity hover:opacity-100"
-      >
-        <X className="h-3.5 w-3.5" />
-      </button>
-    </div>
-  )
-}

packages/browseros-agent/apps/agent/entrypoints/app/ai-settings/NewProviderDialog.tsx

@@ -1,26 +1,10 @@
 import { zodResolver } from '@hookform/resolvers/zod'
-import Fuse from 'fuse.js'
-import {
-  Check,
-  CheckCircle2,
-  ChevronDown,
-  ExternalLink,
-  Loader2,
-  XCircle,
-} from 'lucide-react'
-import { type FC, useEffect, useMemo, useRef, useState } from 'react'
+import { CheckCircle2, ExternalLink, Loader2, XCircle } from 'lucide-react'
+import { type FC, useEffect, useState } from 'react'
 import { useForm } from 'react-hook-form'
 import { z } from 'zod/v3'
 import { Button } from '@/components/ui/button'
 import { Checkbox } from '@/components/ui/checkbox'
-import {
-  Command,
-  CommandEmpty,
-  CommandGroup,
-  CommandInput,
-  CommandItem,
-  CommandList,
-} from '@/components/ui/command'
 import {
   Dialog,
   DialogContent,
@@ -39,11 +23,6 @@ import {
   FormMessage,
 } from '@/components/ui/form'
 import { Input } from '@/components/ui/input'
-import {
-  Popover,
-  PopoverContent,
-  PopoverTrigger,
-} from '@/components/ui/popover'
 import {
   Select,
   SelectContent,
@@ -56,11 +35,10 @@ import { useAgentServerUrl } from '@/lib/browseros/useBrowserOSProviders'
 import { useCapabilities } from '@/lib/browseros/useCapabilities'
 import {
   AI_PROVIDER_ADDED_EVENT,
-  AI_PROVIDER_UPDATED_EVENT,
   KIMI_API_KEY_CONFIGURED_EVENT,
   KIMI_API_KEY_GUIDE_CLICKED_EVENT,
-  MODEL_SELECTED_EVENT,
 } from '@/lib/constants/analyticsEvents'
+import { useKimiLaunch } from '@/lib/feature-flags/useKimiLaunch'
 import {
   getDefaultBaseUrlForProviders,
   getProviderTemplate,
@@ -69,8 +47,7 @@ import {
 import { type TestResult, testProvider } from '@/lib/llm-providers/testProvider'
 import type { LlmProviderConfig, ProviderType } from '@/lib/llm-providers/types'
 import { track } from '@/lib/metrics/track'
-import { cn } from '@/lib/utils'
-import { getModelContextLength, getModelsForProvider } from './models'
+import { getModelContextLength, getModelOptions } from './models'
 
 const providerTypeEnum = z.enum([
   'moonshot',
@@ -84,9 +61,6 @@ const providerTypeEnum = z.enum([
   'lmstudio',
   'bedrock',
   'browseros',
-  'chatgpt-pro',
-  'github-copilot',
-  'qwen-code',
 ])
 
 /**
@@ -110,9 +84,6 @@ export const providerFormSchema = z
     secretAccessKey: z.string().optional(),
     region: z.string().optional(),
     sessionToken: z.string().optional(),
-    // ChatGPT Pro (Codex)
-    reasoningEffort: z.enum(['none', 'low', 'medium', 'high']).optional(),
-    reasoningSummary: z.enum(['auto', 'concise', 'detailed']).optional(),
   })
   .superRefine((data, ctx) => {
     // Azure: require either resourceName or baseUrl
@@ -156,14 +127,6 @@ export const providerFormSchema = z
         })
       }
     }
-    // OAuth providers: no credentials needed (server-managed)
-    else if (
-      data.type === 'chatgpt-pro' ||
-      data.type === 'github-copilot' ||
-      data.type === 'qwen-code'
-    ) {
-      // No validation needed — OAuth tokens are on the server
-    }
     // Other providers: require baseUrl
     else if (!data.baseUrl) {
       ctx.addIssue({
@@ -186,13 +149,6 @@ export const providerFormSchema = z
  */
 export type ProviderFormValues = z.infer<typeof providerFormSchema>
 
-function formatContextWindow(tokens: number): string {
-  if (tokens >= 1000000)
-    return `${(tokens / 1000000).toFixed(tokens % 1000000 === 0 ? 0 : 1)}M`
-  if (tokens >= 1000) return `${Math.round(tokens / 1000)}K`
-  return `${tokens}`
-}
-
 /**
  * Props for NewProviderDialog
  * @public
@@ -218,20 +174,16 @@ export const NewProviderDialog: FC<NewProviderDialogProps> = ({
   initialValues,
   onSave,
 }) => {
+  const [isCustomModel, setIsCustomModel] = useState(false)
   const [isTesting, setIsTesting] = useState(false)
   const [testResult, setTestResult] = useState<TestResult | null>(null)
-  const [modelPickerOpen, setModelPickerOpen] = useState(false)
-  const [modelSearch, setModelSearch] = useState('')
-  const modelListRef = useRef<HTMLDivElement>(null)
   const { supports } = useCapabilities()
   const { baseUrl: agentServerUrl } = useAgentServerUrl()
+  const kimiLaunch = useKimiLaunch()
 
   const filteredProviderTypeOptions = providerTypeOptions.filter((opt) => {
-    if (opt.value === 'chatgpt-pro')
-      return supports(Feature.CHATGPT_PRO_SUPPORT)
-    if (opt.value === 'github-copilot')
-      return supports(Feature.GITHUB_COPILOT_SUPPORT)
-    if (opt.value === 'qwen-code') return supports(Feature.QWEN_CODE_SUPPORT)
+    if (opt.value === 'moonshot')
+      return kimiLaunch || initialValues?.type === 'moonshot'
     if (opt.value === 'openai-compatible') {
       return supports(Feature.OPENAI_COMPATIBLE_SUPPORT)
     }
@@ -257,8 +209,6 @@ export const NewProviderDialog: FC<NewProviderDialogProps> = ({
       secretAccessKey: initialValues?.secretAccessKey || '',
       region: initialValues?.region || '',
       sessionToken: initialValues?.sessionToken || '',
-      reasoningEffort: initialValues?.reasoningEffort || 'high',
-      reasoningSummary: initialValues?.reasoningSummary || 'auto',
     },
   })
 
@@ -290,24 +240,8 @@ export const NewProviderDialog: FC<NewProviderDialogProps> = ({
     watchedSessionToken,
   ])
 
-  const modelInfoList = getModelsForProvider(watchedType as ProviderType)
-
-  const modelFuse = useMemo(
-    () =>
-      new Fuse(modelInfoList, {
-        keys: ['modelId'],
-        threshold: 0.4,
-        distance: 100,
-      }),
-    [modelInfoList],
-  )
-
-  const filteredModels = modelSearch
-    ? modelFuse.search(modelSearch).map((r) => r.item)
-    : modelInfoList
-
-  const showCustomEntry =
-    modelSearch && !filteredModels.some((m) => m.modelId === modelSearch)
+  // Get model options for current provider type
+  const modelOptions = getModelOptions(watchedType as ProviderType)
 
   // Handle provider type change (user-initiated via Select)
   const handleTypeChange = (newType: ProviderType) => {
@@ -317,13 +251,14 @@ export const NewProviderDialog: FC<NewProviderDialogProps> = ({
       form.setValue('baseUrl', defaultUrl)
     }
     form.setValue('modelId', '')
+    setIsCustomModel(false)
   }
 
   // Auto-fill context window when model changes (only for new providers)
   useEffect(() => {
     if (initialValues?.id) return
 
-    if (watchedModelId) {
+    if (watchedModelId && watchedModelId !== 'custom') {
       const contextLength = getModelContextLength(
         watchedType as ProviderType,
         watchedModelId,
@@ -334,6 +269,17 @@ export const NewProviderDialog: FC<NewProviderDialogProps> = ({
     }
   }, [watchedModelId, watchedType, form, initialValues?.id])
 
+  // Handle model selection (including custom option)
+  const handleModelChange = (value: string) => {
+    if (value === 'custom') {
+      setIsCustomModel(true)
+      form.setValue('modelId', '')
+    } else {
+      setIsCustomModel(false)
+      form.setValue('modelId', value)
+    }
+  }
+
   // Reset form when initialValues change
   useEffect(() => {
     if (initialValues) {
@@ -355,9 +301,8 @@ export const NewProviderDialog: FC<NewProviderDialogProps> = ({
         secretAccessKey: initialValues.secretAccessKey || '',
         region: initialValues.region || '',
         sessionToken: initialValues.sessionToken || '',
-        reasoningEffort: initialValues.reasoningEffort || 'high',
-        reasoningSummary: initialValues.reasoningSummary || 'auto',
       })
+      setIsCustomModel(false)
     }
   }, [initialValues, form])
 
@@ -381,9 +326,8 @@ export const NewProviderDialog: FC<NewProviderDialogProps> = ({
         secretAccessKey: '',
         region: '',
         sessionToken: '',
-        reasoningEffort: 'high',
-        reasoningSummary: 'auto',
       })
+      setIsCustomModel(false)
     }
     // Clear test result when dialog opens/closes
     setTestResult(null)
@@ -404,11 +348,6 @@ export const NewProviderDialog: FC<NewProviderDialogProps> = ({
         provider_type: values.type,
         model: values.modelId,
       })
-    } else {
-      track(AI_PROVIDER_UPDATED_EVENT, {
-        provider_type: values.type,
-        model: values.modelId,
-      })
     }
     if (values.type === 'moonshot') {
       track(KIMI_API_KEY_CONFIGURED_EVENT, {
@@ -424,14 +363,6 @@ export const NewProviderDialog: FC<NewProviderDialogProps> = ({
   const canTest = (): boolean => {
     if (!watchedModelId) return false
 
-    // OAuth providers: always testable (server has the OAuth token)
-    if (
-      watchedType === 'chatgpt-pro' ||
-      watchedType === 'github-copilot' ||
-      watchedType === 'qwen-code'
-    )
-      return true
-
     if (watchedType === 'azure') {
       return !!(watchedResourceName || watchedBaseUrl) && !!watchedApiKey
     }
@@ -513,85 +444,6 @@ export const NewProviderDialog: FC<NewProviderDialogProps> = ({
   }
 
   const renderProviderSpecificFields = () => {
-    // OAuth-only providers (no API key needed)
-    if (watchedType === 'github-copilot' || watchedType === 'qwen-code') {
-      const name = watchedType === 'github-copilot' ? 'GitHub' : 'Qwen Code'
-      return (
-        <div className="rounded-lg border border-green-200 bg-green-50 p-3 text-green-700 text-sm dark:border-green-800 dark:bg-green-950 dark:text-green-300">
-          Credentials are managed via {name} OAuth. No API key needed.
-        </div>
-      )
-    }
-    // ChatGPT Pro: OAuth credentials + Codex reasoning settings
-    if (watchedType === 'chatgpt-pro') {
-      return (
-        <>
-          <div className="rounded-lg border border-green-200 bg-green-50 p-3 text-green-700 text-sm dark:border-green-800 dark:bg-green-950 dark:text-green-300">
-            Credentials are managed via OAuth. No API key needed.
-          </div>
-          <div className="grid gap-4 sm:grid-cols-2">
-            <FormField
-              control={form.control}
-              name="reasoningEffort"
-              render={({ field }) => (
-                <FormItem>
-                  <FormLabel>Reasoning Effort</FormLabel>
-                  <Select
-                    onValueChange={field.onChange}
-                    value={field.value || 'high'}
-                  >
-                    <FormControl>
-                      <SelectTrigger className="w-full">
-                        <SelectValue />
-                      </SelectTrigger>
-                    </FormControl>
-                    <SelectContent>
-                      <SelectItem value="none">None</SelectItem>
-                      <SelectItem value="low">Low</SelectItem>
-                      <SelectItem value="medium">Medium</SelectItem>
-                      <SelectItem value="high">High</SelectItem>
-                    </SelectContent>
-                  </Select>
-                  <FormDescription>
-                    How much the model thinks before responding
-                  </FormDescription>
-                  <FormMessage />
-                </FormItem>
-              )}
-            />
-            <FormField
-              control={form.control}
-              name="reasoningSummary"
-              render={({ field }) => (
-                <FormItem>
-                  <FormLabel>Reasoning Summary</FormLabel>
-                  <Select
-                    onValueChange={field.onChange}
-                    value={field.value || 'auto'}
-                  >
-                    <FormControl>
-                      <SelectTrigger className="w-full">
-                        <SelectValue />
-                      </SelectTrigger>
-                    </FormControl>
-                    <SelectContent>
-                      <SelectItem value="auto">Auto</SelectItem>
-                      <SelectItem value="concise">Concise</SelectItem>
-                      <SelectItem value="detailed">Detailed</SelectItem>
-                    </SelectContent>
-                  </Select>
-                  <FormDescription>
-                    Detail level of visible thinking steps
-                  </FormDescription>
-                  <FormMessage />
-                </FormItem>
-              )}
-            />
-          </div>
-        </>
-      )
-    }
-
     if (watchedType === 'azure') {
       return (
         <>
@@ -847,147 +699,52 @@ export const NewProviderDialog: FC<NewProviderDialogProps> = ({
               control={form.control}
               name="modelId"
               render={({ field }) => (
-                <FormItem className="flex flex-col">
+                <FormItem>
                   <FormLabel>Model *</FormLabel>
-                  {modelInfoList.length === 0 ? (
-                    <FormControl>
-                      <Input
-                        placeholder={
-                          watchedType === 'azure'
-                            ? 'Enter your deployment name'
-                            : watchedType === 'bedrock'
-                              ? 'e.g., anthropic.claude-3-5-sonnet-20241022-v2:0'
-                              : 'Enter model ID'
-                        }
-                        {...field}
-                      />
-                    </FormControl>
-                  ) : (
-                    <Popover
-                      open={modelPickerOpen}
-                      onOpenChange={(isOpen) => {
-                        setModelPickerOpen(isOpen)
-                        if (!isOpen) setModelSearch('')
-                      }}
-                    >
-                      <PopoverTrigger asChild>
-                        <button
+                  {isCustomModel || modelOptions.length === 1 ? (
+                    <>
+                      <FormControl>
+                        <Input
+                          placeholder={
+                            watchedType === 'azure'
+                              ? 'Enter your deployment name'
+                              : watchedType === 'bedrock'
+                                ? 'e.g., anthropic.claude-3-5-sonnet-20241022-v2:0'
+                                : 'Enter custom model ID'
+                          }
+                          {...field}
+                        />
+                      </FormControl>
+                      {modelOptions.length > 1 && (
+                        <Button
                           type="button"
-                          className={cn(
-                            'flex h-9 w-full items-center justify-between rounded-md border border-input bg-transparent px-3 py-1 text-sm shadow-xs',
-                            field.value
-                              ? 'text-foreground'
-                              : 'text-muted-foreground',
-                          )}
+                          variant="link"
+                          size="sm"
+                          className="h-auto p-0 text-xs"
+                          onClick={() => setIsCustomModel(false)}
                         >
-                          <span className="truncate">
-                            {field.value || 'Select a model...'}
-                          </span>
-                          <ChevronDown className="ml-2 h-4 w-4 shrink-0 opacity-50" />
-                        </button>
-                      </PopoverTrigger>
-                      <PopoverContent
-                        className="w-[var(--radix-popover-trigger-width)] p-0"
-                        align="start"
-                      >
-                        <Command shouldFilter={false}>
-                          <CommandInput
-                            placeholder="Search models..."
-                            value={modelSearch}
-                            onValueChange={(v) => {
-                              setModelSearch(v)
-                              requestAnimationFrame(() => {
-                                modelListRef.current?.scrollTo(0, 0)
-                              })
-                            }}
-                            onKeyDown={(e) => {
-                              if (e.key === 'Enter' && modelSearch) {
-                                e.preventDefault()
-                                e.stopPropagation()
-                                form.setValue('modelId', modelSearch)
-                                track(MODEL_SELECTED_EVENT, {
-                                  provider_type: watchedType,
-                                  model_id: modelSearch,
-                                  is_custom_model: !modelInfoList.some(
-                                    (m) => m.modelId === modelSearch,
-                                  ),
-                                })
-                                setModelPickerOpen(false)
-                                setModelSearch('')
-                              }
-                            }}
-                          />
-                          <CommandList ref={modelListRef}>
-                            <CommandEmpty>
-                              No models found. Press Enter to use &quot;
-                              {modelSearch}&quot;
-                            </CommandEmpty>
-                            {showCustomEntry && (
-                              <CommandGroup forceMount>
-                                <CommandItem
-                                  forceMount
-                                  value={`custom:${modelSearch}`}
-                                  onSelect={() => {
-                                    form.setValue('modelId', modelSearch)
-                                    track(MODEL_SELECTED_EVENT, {
-                                      provider_type: watchedType,
-                                      model_id: modelSearch,
-                                      is_custom_model: true,
-                                    })
-                                    setModelPickerOpen(false)
-                                    setModelSearch('')
-                                  }}
-                                >
-                                  <span className="flex-1 truncate">
-                                    {modelSearch}
-                                  </span>
-                                  {field.value === modelSearch && (
-                                    <Check className="ml-2 h-4 w-4 shrink-0" />
-                                  )}
-                                </CommandItem>
-                              </CommandGroup>
-                            )}
-                            {filteredModels.length > 0 && (
-                              <CommandGroup>
-                                {filteredModels.map((model) => (
-                                  <CommandItem
-                                    key={model.modelId}
-                                    value={model.modelId}
-                                    onSelect={() => {
-                                      form.setValue('modelId', model.modelId)
-                                      track(MODEL_SELECTED_EVENT, {
-                                        provider_type: watchedType,
-                                        model_id: model.modelId,
-                                        context_window: model.contextLength,
-                                        is_custom_model: !modelInfoList.some(
-                                          (m) => m.modelId === model.modelId,
-                                        ),
-                                      })
-                                      setModelPickerOpen(false)
-                                      setModelSearch('')
-                                    }}
-                                  >
-                                    <span className="flex-1 truncate">
-                                      {model.modelId}
-                                    </span>
-                                    {model.contextLength > 0 && (
-                                      <span className="ml-2 shrink-0 rounded-md bg-muted px-1.5 py-0.5 font-mono text-[10px] text-muted-foreground">
-                                        {formatContextWindow(
-                                          model.contextLength,
-                                        )}
-                                      </span>
-                                    )}
-                                    {field.value === model.modelId && (
-                                      <Check className="ml-2 h-4 w-4 shrink-0" />
-                                    )}
-                                  </CommandItem>
-                                ))}
-                              </CommandGroup>
-                            )}
-                          </CommandList>
-                        </Command>
-                      </PopoverContent>
-                    </Popover>
+                          ← Back to model list
+                        </Button>
+                      )}
+                    </>
+                  ) : (
+                    <Select
+                      onValueChange={handleModelChange}
+                      value={field.value}
+                    >
+                      <FormControl>
+                        <SelectTrigger className="w-full">
+                          <SelectValue placeholder="Select a model" />
+                        </SelectTrigger>
+                      </FormControl>
+                      <SelectContent>
+                        {modelOptions.map((modelId) => (
+                          <SelectItem key={modelId} value={modelId}>
+                            {modelId === 'custom' ? '+ Custom model' : modelId}
+                          </SelectItem>
+                        ))}
+                      </SelectContent>
+                    </Select>
                   )}
                   <FormMessage />
                 </FormItem>

packages/browseros-agent/apps/agent/entrypoints/app/ai-settings/ProviderCard.tsx

@@ -2,6 +2,7 @@ import { Check, Loader2, Trash2 } from 'lucide-react'
 import type { FC } from 'react'
 import { Badge } from '@/components/ui/badge'
 import { Button } from '@/components/ui/button'
+import { useKimiLaunch } from '@/lib/feature-flags/useKimiLaunch'
 import { BrowserOSIcon, ProviderIcon } from '@/lib/llm-providers/providerIcons'
 import type { LlmProviderConfig } from '@/lib/llm-providers/types'
 import { cn } from '@/lib/utils'
@@ -29,6 +30,7 @@ export const ProviderCard: FC<ProviderCardProps> = ({
   isTesting = false,
 }) => {
   const inputId = `provider-${provider.id}`
+  const kimiLaunch = useKimiLaunch()
 
   return (
     <label
@@ -77,25 +79,32 @@ export const ProviderCard: FC<ProviderCardProps> = ({
             </Badge>
           )}
         </div>
+        {isBuiltIn && provider.type === 'browseros' && kimiLaunch && (
+          <span className="mb-1 inline-block rounded-full border border-orange-300/60 bg-orange-100/70 px-3 py-0.5 font-semibold text-orange-700 text-xs dark:border-orange-400/40 dark:bg-orange-500/15 dark:text-orange-300">
+            In partnership with Moonshot AI
+          </span>
+        )}
         <p className="truncate text-muted-foreground text-sm">
           {isBuiltIn ? (
-            <>
-              BrowserOS-hosted model with strict rate limits.{' '}
-              <a
-                href="https://docs.browseros.com/features/bring-your-own-llm"
-                target="_blank"
-                rel="noopener noreferrer"
-                className="underline hover:text-foreground"
-                onClick={(e) => e.stopPropagation()}
-              >
-                Bring your own key
-              </a>{' '}
-              for better performance.
-            </>
-          ) : provider.baseUrl ? (
-            `${provider.modelId} • ${provider.baseUrl}`
+            kimiLaunch ? (
+              'Extended usage limits for the next 2 weeks!'
+            ) : (
+              <>
+                BrowserOS-hosted model with strict rate limits.{' '}
+                <a
+                  href="https://docs.browseros.com/features/bring-your-own-llm"
+                  target="_blank"
+                  rel="noopener noreferrer"
+                  className="underline hover:text-foreground"
+                  onClick={(e) => e.stopPropagation()}
+                >
+                  Bring your own key
+                </a>{' '}
+                for better performance.
+              </>
+            )
           ) : (
-            provider.modelId
+            `${provider.modelId} • ${provider.baseUrl}`
           )}
         </p>
       </div>