feat(browser-use): embedded APP-053 host plane + Composer slash command

.github/workflows/release-desktop-electron.yml

@@ -35,8 +35,8 @@ on:
         type: choice
         options:
           - "all"
-          - "macos-14"
-          - "macos-15-intel"
+          - "macos-26"
+          - "macos-26-intel"
           - "ubuntu-22.04"
           - "windows-latest"
       create_release:
@@ -126,13 +126,14 @@ jobs:
             case "$1" in
               "all" )
                 # electron-builder arch is selected via CLI on each runner OS.
-                printf '%s\n' '{"include":[{"platform":"macos-14","target":"aarch64-apple-darwin","builder_args":"--mac --arm64"},{"platform":"macos-15-intel","target":"x86_64-apple-darwin","builder_args":"--mac --x64"},{"platform":"ubuntu-22.04","target":"x86_64-unknown-linux-gnu","builder_args":"--linux --x64"},{"platform":"windows-latest","target":"x86_64-pc-windows-msvc","builder_args":"--win --x64"}]}'
+                # macOS 26 runners ship Xcode 26+ actool for Liquid Glass .icon → Assets.car.
+                printf '%s\n' '{"include":[{"platform":"macos-26","target":"aarch64-apple-darwin","builder_args":"--mac --arm64"},{"platform":"macos-26-intel","target":"x86_64-apple-darwin","builder_args":"--mac --x64"},{"platform":"ubuntu-22.04","target":"x86_64-unknown-linux-gnu","builder_args":"--linux --x64"},{"platform":"windows-latest","target":"x86_64-pc-windows-msvc","builder_args":"--win --x64"}]}'
                 ;;
-              "macos-14" )
-                printf '%s\n' '{"include":[{"platform":"macos-14","target":"aarch64-apple-darwin","builder_args":"--mac --arm64"}]}'
+              "macos-26" )
+                printf '%s\n' '{"include":[{"platform":"macos-26","target":"aarch64-apple-darwin","builder_args":"--mac --arm64"}]}'
                 ;;
-              "macos-15-intel" )
-                printf '%s\n' '{"include":[{"platform":"macos-15-intel","target":"x86_64-apple-darwin","builder_args":"--mac --x64"}]}'
+              "macos-26-intel" )
+                printf '%s\n' '{"include":[{"platform":"macos-26-intel","target":"x86_64-apple-darwin","builder_args":"--mac --x64"}]}'
                 ;;
               "ubuntu-22.04" )
                 printf '%s\n' '{"include":[{"platform":"ubuntu-22.04","target":"x86_64-unknown-linux-gnu","builder_args":"--linux --x64"}]}'
@@ -280,6 +281,46 @@ jobs:
       - name: Install dependencies
         run: bun install --frozen-lockfile
 
+      # Liquid Glass icons: electron-builder compiles resources/icons/icon.icon via actool ≥ 26.
+      - name: Select Xcode 26+ and verify actool (macOS)
+        if: runner.os == 'macOS'
+        shell: bash
+        run: |
+          set -euo pipefail
+          # Prefer newest Xcode_26* if multiple are installed on the image.
+          XCODE_APP=""
+          for candidate in \
+            /Applications/Xcode.app \
+            /Applications/Xcode_26.6.app \
+            /Applications/Xcode_26.6.0.app \
+            /Applications/Xcode_26.5.app \
+            /Applications/Xcode_26.4.1.app \
+            /Applications/Xcode_26.4.app \
+            /Applications/Xcode_26.3.app \
+            /Applications/Xcode_26.2.app \
+            /Applications/Xcode_26.1.app \
+            /Applications/Xcode_26.0.app; do
+            if [ -d "$candidate" ]; then
+              XCODE_APP="$candidate"
+              break
+            fi
+          done
+          if [ -z "$XCODE_APP" ]; then
+            # Fallback: first Xcode_26* directory
+            XCODE_APP="$(ls -d /Applications/Xcode_26*.app 2>/dev/null | sort -V | tail -1 || true)"
+          fi
+          if [ -z "${XCODE_APP:-}" ] || [ ! -d "$XCODE_APP" ]; then
+            echo "❌ No Xcode 26+ app found under /Applications (required for Liquid Glass .icon)"
+            ls /Applications/Xcode*.app 2>/dev/null || true
+            exit 1
+          fi
+          echo "Using Xcode at $XCODE_APP"
+          sudo xcode-select -s "$XCODE_APP"
+          xcodebuild -version
+          actool --version
+          # Fail early if actool is too old for Icon Composer (electron-builder check).
+          bun ./apps/desktop-electron/scripts/check-macos-icon-toolchain.ts
+
       # electron-builder AppImage on Ubuntu 22.04 needs libfuse2 + packaging tools.
       # Without these the Linux matrix fails during `appimagetool` / fpm steps.
       - name: Install Linux packaging dependencies

AGENTS.md

@@ -145,6 +145,15 @@ Full conventions (zones, naming, the 4-file rule, optional spec logs, review che
 - **Keep meaning aligned**: Locale variants should express the same product meaning and UI scope, even when the wording is not a literal translation.
 - **Avoid hardcoded copy**: Prefer existing i18n lookup patterns for labels, titles, tooltips, empty states, and error text instead of hardcoded strings in components.
 
+### English UI casing (strict)
+
+**Do not set English UI words to ALL CAPS** (e.g. `OPEN`, `MERGED`, `DRAFT`, `SAVE ALL`). Agents default to this too often.
+
+- **Use sentence case or leading capital only**: `Open`, `Merged`, `Draft`, `Closed` — first letter capital, rest lowercase (unless a multi-word product name needs standard title case, e.g. `Pull Request`).
+- **Forbidden for labels, chips, badges, buttons, and status text**: CSS `uppercase` / `text-transform: uppercase` that forces full upcase, and source strings written as `OPEN` / `MERGED` solely for display.
+- **Exceptions** (narrow): true acronyms that are conventionally all-caps in product copy (`API`, `PR` as a short form when space-constrained, `CI`, `TUI`), keyboard shortcuts display (`⌘K`), or third-party brand marks that require a specific casing.
+- When in doubt, match nearby existing UI that is **not** all-caps.
+
 ---
 
 ## 🔌 Transport Rules

NOTICE

@@ -267,6 +267,17 @@ not re-license those weights.
 
 Full Apache-2.0 text: https://www.apache.org/licenses/LICENSE-2.0
 
+-------------------------------------------------------------------------------
+8. AIcss Orbs (agent activity indicators)
+-------------------------------------------------------------------------------
+
+Source:   https://www.aicss.dev/components/orbs
+Location: apps/web/src/features/agent/components/orbs/
+Author:   Kevin (@kvnkld) / AIcss
+Notes:    Free-tier copy-paste UI component (React + CSS Module), vendored
+          and lightly adapted for Atmos theme (html.dark) and sizing.
+          No external runtime dependency beyond the vendored source.
+
 -------------------------------------------------------------------------------
 End of NOTICE
 -------------------------------------------------------------------------------

apps/api/src/api/hooks/mod.rs

@@ -6,6 +6,7 @@ use axum::{
     Json, Router,
 };
 use core_service::service::agent_hooks::AtmosContext;
+use serde::Deserialize;
 use serde_json::Value;
 
 use crate::app_state::AppState;
@@ -66,6 +67,9 @@ pub fn routes() -> Router<AppState> {
             post(force_session_idle),
         )
         .route("/sessions/{session_id}", delete(remove_hook_session))
+        // Attention routes before `/{tool}/…` so "attention" is not parsed as a tool name.
+        .route("/attention", get(list_attention))
+        .route("/attention/clear", post(clear_attention))
         .route("/install", post(install_hooks))
         .route("/uninstall", post(uninstall_hooks))
         .route("/status", get(hooks_status))
@@ -240,6 +244,40 @@ async fn list_hook_sessions(State(state): State<AppState>) -> Json<Value> {
     Json(serde_json::json!({ "sessions": sessions }))
 }
 
+async fn list_attention(State(state): State<AppState>) -> Json<Value> {
+    let attention = state.agent_hooks_service.get_all_attention();
+    Json(serde_json::json!({ "attention": attention }))
+}
+
+#[derive(Debug, Deserialize)]
+struct ClearAttentionBody {
+    /// Prefer the stable pane id (`{context}:{tmux_window}`) the client focuses.
+    #[serde(default)]
+    stable_pane_id: Option<String>,
+    #[serde(default)]
+    stable_pane_ids: Option<Vec<String>>,
+}
+
+async fn clear_attention(
+    State(state): State<AppState>,
+    Json(body): Json<ClearAttentionBody>,
+) -> Json<Value> {
+    let mut ids: Vec<String> = body.stable_pane_ids.unwrap_or_default();
+    if let Some(id) = body.stable_pane_id {
+        if !id.trim().is_empty() {
+            ids.push(id);
+        }
+    }
+    let cleared = if ids.len() == 1 {
+        state
+            .agent_hooks_service
+            .clear_attention_for_pane(ids[0].as_str())
+    } else {
+        state.agent_hooks_service.clear_attention_matching_ids(&ids)
+    };
+    Json(serde_json::json!({ "cleared": cleared }))
+}
+
 async fn clear_idle_sessions(State(state): State<AppState>) -> Json<Value> {
     let cleared = state.agent_hooks_service.clear_idle_sessions();
     Json(serde_json::json!({ "cleared": cleared }))

apps/api/src/api/ws/message.rs

@@ -726,6 +726,10 @@ pub enum WsEvent {
     AgentHookStateChanged,
     /// Idle agent hook sessions were cleared; payload contains removed session IDs
     AgentHookSessionsCleared,
+    /// Sticky need-attention latch raised (permission / task complete)
+    AgentAttentionRaised,
+    /// Sticky need-attention latch(es) cleared after user acknowledge
+    AgentAttentionCleared,
     /// Agent notification (permission request, task complete, etc.)
     AgentNotification,
     /// Current branch PR status should be refreshed

apps/api/src/main.rs

@@ -99,6 +99,13 @@ fn spawn_agent_hook_forwarder(
                             WsEvent::AgentHookSessionsCleared,
                             json!({ "session_ids": session_ids }),
                         ),
+                        AgentHookEvent::AttentionRaised(latch) => {
+                            (WsEvent::AgentAttentionRaised, json!(latch))
+                        }
+                        AgentHookEvent::AttentionCleared { stable_pane_ids } => (
+                            WsEvent::AgentAttentionCleared,
+                            json!({ "stable_pane_ids": stable_pane_ids }),
+                        ),
                     };
                     if let Err(error) = ws_manager
                         .broadcast(&WsMessage::notification(ws_event, data))

apps/cli/AGENTS.md

@@ -8,7 +8,8 @@
 
 - **Dev**: `just dev-cli`
 - **Build**: `just build-cli`
-- **Install**: `just install-cli`
+- **Install (cargo bin)**: `just install-cli` → `~/.cargo/bin/atmos`
+- **Use local CLI**: `just use-local-cli` → release build + replace `~/.atmos/bin/atmos` (and `~/.cargo/bin` if present)
 - **Test**: `cargo test -p atmos`
 
 ---

apps/cli/src/commands/browser_use.rs

@@ -40,7 +40,7 @@ pub async fn execute_cmd(command: BrowserUseCommand) -> Result<Value, String> {
             target_id: Some(a.target_id),
             tab_id: Some(a.tab_id),
             text: Some(a.text),
-            element_ref: Some(a.element_ref),
+            element_ref: a.element_ref,
             session: a.session,
             ..Default::default()
         },
@@ -59,17 +59,13 @@ pub async fn execute_cmd(command: BrowserUseCommand) -> Result<Value, String> {
 }
 
 fn parse_backend(s: &str) -> Result<BrowserBackendKind, String> {
-    BrowserBackendKind::parse(s).ok_or_else(|| {
-        format!(
-            "invalid --backend {:?} (use cua|external|embedded|atmos)",
-            s
-        )
-    })
+    BrowserBackendKind::parse(s)
+        .ok_or_else(|| format!("invalid --backend {:?} (use external|embedded)", s))
 }
 
 #[derive(Debug, Subcommand)]
 pub enum BrowserUseCommand {
-    /// Attach / prepare a browser CDP endpoint (CUA external Chromium).
+    /// Attach / prepare a system Chrome or Chromium page for Browser Use.
     Prepare(PrepareArgs),
     /// Read browser state / tabs / snapshot refs.
     State(StateArgs),
@@ -83,12 +79,12 @@ pub enum BrowserUseCommand {
 
 #[derive(Debug, Args)]
 pub struct PrepareArgs {
-    /// Backend: cua (system Chromium) | embedded (Atmos webview stub until APP-053).
-    #[arg(long, default_value = "cua")]
+    /// Backend: `external` (system Chrome/Chromium) | `embedded` (Atmos in-app browser).
+    #[arg(long, default_value = "external")]
     pub backend: String,
     #[arg(long)]
     pub pid: Option<i32>,
-    /// Required when --strategy existing_profile (engine 0.17).
+    /// Required when --strategy existing_profile.
     #[arg(long)]
     pub window_id: Option<i64>,
     #[arg(long)]
@@ -100,7 +96,7 @@ pub struct PrepareArgs {
 
 #[derive(Debug, Args)]
 pub struct StateArgs {
-    #[arg(long, default_value = "cua")]
+    #[arg(long, default_value = "external")]
     pub backend: String,
     /// Bind mode: native browser pid (with --window-id).
     #[arg(long)]
@@ -120,7 +116,7 @@ pub struct StateArgs {
 
 #[derive(Debug, Args)]
 pub struct ClickArgs {
-    #[arg(long, default_value = "cua")]
+    #[arg(long, default_value = "external")]
     pub backend: String,
     #[arg(long)]
     pub target_id: String,
@@ -134,24 +130,24 @@ pub struct ClickArgs {
 
 #[derive(Debug, Args)]
 pub struct TypeArgs {
-    #[arg(long, default_value = "cua")]
+    #[arg(long, default_value = "external")]
     pub backend: String,
     #[arg(long)]
     pub target_id: String,
     #[arg(long)]
     pub tab_id: String,
     #[arg(long)]
     pub text: String,
-    /// Required by engine 0.17 browser_type.
+    /// Element ref from state (required for external; optional for embedded active element).
     #[arg(long = "ref")]
-    pub element_ref: String,
+    pub element_ref: Option<String>,
     #[arg(long)]
     pub session: Option<String>,
 }
 
 #[derive(Debug, Args)]
 pub struct NavigateArgs {
-    #[arg(long, default_value = "cua")]
+    #[arg(long, default_value = "external")]
     pub backend: String,
     #[arg(long)]
     pub target_id: String,
@@ -170,7 +166,7 @@ pub fn product_note() -> Value {
         "product": "Browser Use",
         "no_mcp": true,
         "desktop_use": "separate — OS windows / keys / AX",
-        "backends": ["cua", "embedded"],
-        "embedded": "stub until APP-053 / PR #203",
+        "backends": ["external", "embedded"],
+        "embedded": "Atmos Desktop in-app browser via host control plane",
     })
 }

apps/cli/src/commands/desktop_use/args.rs

@@ -375,10 +375,10 @@ pub struct ClickArgs {
     /// Border highlight: auto (default) | desktop | clear | off
     #[arg(long, default_value = "auto")]
     pub highlight: String,
-    /// Under-arrow status text (what the agent is doing). Overrides auto copy.
+    /// Under-arrow operation text. Combined as "{agent} - {status}". Also used alone when already prefixed.
     #[arg(long)]
     pub status: Option<String>,
-    /// Agent display name for fallback "{name} Operating". Also reads ATMOS_DESKTOP_USE_AGENT_NAME.
+    /// Agent display name for "{name} - …". Also reads ATMOS_DESKTOP_USE_AGENT_NAME / AGENT_NAME.
     #[arg(long)]
     pub agent_name: Option<String>,
 }
@@ -387,13 +387,22 @@ pub struct ClickArgs {
 pub struct TypeArgs {
     #[arg(long)]
     pub text: String,
+    /// Optional pixel focus before type (engine 0.17). Use after a click fails to keep focus,
+    /// or for empty-AX apps: same coordinate rules as `drive click`.
+    #[arg(long)]
+    pub x: Option<i32>,
+    #[arg(long)]
+    pub y: Option<i32>,
     #[arg(long)]
     pub pid: Option<i32>,
     #[arg(long)]
     pub window_id: Option<i64>,
     /// background (default) or foreground.
     #[arg(long, default_value = "background")]
     pub delivery_mode: String,
+    /// Desktop/window coord space for --x/--y: `png` (default) or `points` (screen/AX logical).
+    #[arg(long, default_value = "png")]
+    pub coord_space: String,
     /// AX element token from `drive window-state` (preferred for focused fields).
     #[arg(long)]
     pub element_token: Option<String>,

apps/cli/src/commands/desktop_use/drive.rs

@@ -145,12 +145,17 @@ pub(super) fn drive_cmd(command: DriveCommand) -> Result<Value, String> {
                     a.highlight
                 )
             })?;
+            let coord_space = CoordSpace::parse(&a.coord_space)
+                .ok_or_else(|| format!("invalid --coord-space {:?}", a.coord_space))?;
             DriveRequest {
                 action: DriveAction::Type,
                 text: Some(a.text),
+                x: a.x,
+                y: a.y,
                 pid: a.pid,
                 window_id: a.window_id,
                 delivery_mode: Some(a.delivery_mode),
+                coord_space,
                 element_token: a.element_token,
                 element_index: a.element_index,
                 snapshot_id: a.snapshot_id,