From 781825e1cc2698798a339e12e7e79cd805239f02 Mon Sep 17 00:00:00 2001
From: Bryant <bulls23mj1991@gmail.com>
Date: Mon, 13 Jul 2026 19:42:50 +0800
Subject: [PATCH 1/3] =?UTF-8?q?=F0=9F=93=9D=20(docs):=20Tab=20pip/uv=20nat?=
 =?UTF-8?q?ive-runtime=20install=20in=20troubleshooting?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Convert the two alternative ways to enable the native runtime (pip vs.
uv+maturin) from one plain bash block into pymdownx.tabbed pip/uv tabs,
matching quick-start's install pattern.

Refs AAASM-4558
---
 docs/troubleshooting.md | 15 +++++++++++----
 1 file changed, 11 insertions(+), 4 deletions(-)

diff --git a/docs/troubleshooting.md b/docs/troubleshooting.md
index 7f5ccfb5..194ff924 100644
--- a/docs/troubleshooting.md
+++ b/docs/troubleshooting.md
@@ -50,10 +50,17 @@ still works.
 
 To enable it:
 
-```bash
-pip install --pre 'agent-assembly[runtime]'   # bundled platform wheel, or
-uv tool run maturin develop --manifest-path native/aa-ffi-python/Cargo.toml --release  # build locally (needs Rust)
-```
+=== "pip"
+
+    ```bash
+    pip install --pre 'agent-assembly[runtime]'   # bundled platform wheel
+    ```
+
+=== "uv"
+
+    ```bash
+    uv tool run maturin develop --manifest-path native/aa-ffi-python/Cargo.toml --release  # build locally (needs Rust)
+    ```
 
 ## Still stuck?
 

From 6dace3e5fa0e88ff705ad7e103e92102550adeb9 Mon Sep 17 00:00:00 2001
From: Bryant <bulls23mj1991@gmail.com>
Date: Mon, 13 Jul 2026 19:42:50 +0800
Subject: [PATCH 2/3] =?UTF-8?q?=F0=9F=93=9D=20(docs):=20Tab=20docker=20bui?=
 =?UTF-8?q?ld=20variants=20in=20container-base-image?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Convert the default vs. pinned --build-arg SDK_VERSION docker build
invocations from one plain bash block into Default/Pinned version tabs.

Refs AAASM-4559
---
 docs/guides/container-base-image.md | 18 ++++++++++++------
 1 file changed, 12 insertions(+), 6 deletions(-)

diff --git a/docs/guides/container-base-image.md b/docs/guides/container-base-image.md
index 95157393..13773aed 100644
--- a/docs/guides/container-base-image.md
+++ b/docs/guides/container-base-image.md
@@ -101,13 +101,19 @@ which `agent-assembly` SDK release gets baked in.
 | *unset* (default) | Installs the **latest stable** SDK release; if no stable release exists yet, the **latest pre-release**. |
 | set to a version | Installs **exactly** that version — e.g. `SDK_VERSION=0.0.1b5`. |
 
-```bash
-# Default — let the image resolve the newest appropriate SDK release:
-docker build -t my-agent .
+=== "Default"
 
-# Pin an exact SDK version for a fully reproducible build:
-docker build --build-arg SDK_VERSION=0.0.1b5 -t my-agent .
-```
+    ```bash
+    # Let the image resolve the newest appropriate SDK release:
+    docker build -t my-agent .
+    ```
+
+=== "Pinned version"
+
+    ```bash
+    # Pin an exact SDK version for a fully reproducible build:
+    docker build --build-arg SDK_VERSION=0.0.1b5 -t my-agent .
+    ```
 
 !!! tip "Published images already pin the SDK"
     The images published to GHCR are built with `SDK_VERSION` pinned to a specific SDK

From 77d6b0daf9a374d06a108b7a88b4f728088f2d8c Mon Sep 17 00:00:00 2001
From: Bryant <bulls23mj1991@gmail.com>
Date: Mon, 13 Jul 2026 19:42:51 +0800
Subject: [PATCH 3/3] =?UTF-8?q?=F0=9F=8E=A8=20(docs):=20Shrink=20content-t?=
 =?UTF-8?q?ab=20title=20font-size=20in=20brand=20CSS?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Add an explicit smaller/tighter font-size for pymdownx.tabbed tab labels
so short tab titles read as a quiet control rather than a heading.

Refs AAASM-4560
---
 docs/stylesheets/aaasm-brand.css | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/docs/stylesheets/aaasm-brand.css b/docs/stylesheets/aaasm-brand.css
index faa2923c..3776eb37 100644
--- a/docs/stylesheets/aaasm-brand.css
+++ b/docs/stylesheets/aaasm-brand.css
@@ -45,3 +45,13 @@
     overflow-x: auto;
   }
 }
+
+/* AAASM-4560: content-tab titles (pymdownx.tabbed, alternate_style) default to the
+   full body size, which reads as heavy for short labels like "pip"/"uv"/"Default".
+   Render them a step smaller and tighter than body text so the tab strip stays a
+   quiet control, not a heading. Scoped to the tab labels only — tab *content* keeps
+   body sizing. */
+.md-typeset .tabbed-set > .tabbed-labels > label {
+  font-size: 0.68rem;
+  letter-spacing: -0.005em;
+}