ring-cli 0.10.0__tar.gz → 0.11.0__tar.gz

{ring_cli-0.10.0 → ring_cli-0.11.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ring-cli
-Version: 0.10.0
+Version: 0.11.0
 Summary: RiNG — Realtime Instance Notification Grid for active agent CLI sessions.
 Keywords: claude-code,codex,tui,dashboard,session,monitor,rich
 Author: Wei Lee
@@ -59,6 +59,7 @@ RiNG puts them on one board, with sessions waiting for you sorted first.
 - **Waiting first**: sessions that need your response are highlighted and sorted above the rest.
 - **Jump back to the terminal**: in the TUI, select a session and press `Enter` / `Space` to focus tmux, iTerm2, Terminal.app (macOS), or a Linux X11 window (`wmctrl`).
 - **Notifies you without the board open**: with hooks installed, the moment a session turns 🔴 waiting it beeps and fires a system notification — even with no RiNG board running. With `terminal-notifier`, clicking the notification jumps back.
+- **Reply to permission requests in place**: with the cursor on a 🔴 waiting row, press `p` — RiNG reads the permission dialog from that session's terminal screen, pops the numbered options in a modal, and presses your choice for you, so you don't have to jump over one by one (sessions inside tmux, plus plain iTerm2 tabs on macOS).
 - **Name your sessions**: press `n` in the TUI to name a session, e.g. "auth refactor"; once named, the board and notifications show the name instead of the workspace directory.
 - **See what it is waiting for**: in hook mode, a 🔴 waiting session carries the concrete pending item (the command to run, the question asked) — shown in the TUI and in the notification body.
 - **Fits your status bar**: `ring --format oneline` prints a `🔴2 🟢1 🟡3` one-liner for tmux / SwiftBar / waybar; `--format json` feeds scripts.
@@ -153,7 +154,7 @@ Completes subcommands, flags, and `config set` keys; `ring focus` prompts for a
 ## Watch Mode
 
 - With **Textual** (`[tui]` extra) in a real terminal: interactive TUI.
-  Use `↑/↓` to select, `Enter` / `Space` to jump, `n` to name a session, `a` to toggle ended sessions, `dd` to hide a session (it reappears automatically once it has new activity), `r` to refresh, and `q` to quit.
+  Use `↑/↓` to select, `Enter` / `Space` to jump, `p` to reply to a permission request in place, `n` to name a session, `a` to toggle ended sessions, `dd` to hide a session (it reappears automatically once it has new activity), `r` to refresh, and `q` to quit.
   If you have vim muscle memory like I do, `j/k` move up/down and `g/G` jump to the first/last row.
   When the selected row is 🔴 waiting, a line under the table shows **what it is concretely waiting for** (the command to run, the question asked; hook mode only).
 - Otherwise: Rich polling; without Rich, plain text.
@@ -172,6 +173,30 @@ hands the request to the TUI so it selects that session; otherwise it focuses th
 TTY matching is most accurate in hook mode. Without hooks, Codex falls back to zero-config matching:
 one live Codex session per cwd can jump correctly; multiple live Codex sessions in the same cwd are shown conservatively to avoid focusing the wrong tab.
 
+### Reply To Permission Requests In Place (`p`)
+
+With the cursor on a 🔴 waiting row, press `p`. RiNG reads that session's screen, parses the
+permission dialog (Claude Code's "Do you want to proceed?" box, including background-subagent
+ones with a "from the … agent" header), and lists the numbered options verbatim in a modal.
+After you pick one, RiNG **captures the screen again** to confirm the dialog is still there and
+unchanged (it may have been answered while you were deciding), only then sends that single
+digit, and re-checks that the dialog actually disappeared.
+
+- **Sessions inside tmux**: reads the screen with `tmux capture-pane` and sends keys with
+  `tmux send-keys`.
+- **Sessions in a plain iTerm2 tab on macOS** (no tmux): locates the matching iTerm2 session by
+  its `tty` via AppleScript, and both reads the screen and sends keys through `osascript`. The
+  first use triggers the macOS Automation permission prompt ("allow control of iTerm2") — allow
+  it once.
+
+Safety first: if no recognizable dialog can be parsed (missing markers, numbering, or cursor),
+RiNG only shows a toast and **never sends a key** — without the dialog, keystrokes would land in
+the chat input box as text. If the dialog happens to vanish in the instant the digit is sent and
+the digit lands in the input box, RiNG sends a Backspace to clean it up and warns you.
+
+**Limits**: reading the screen requires a tmux pane coordinate, or (on macOS) an iTerm2 session
+with a detectable tty; for other sessions, press `Enter` to jump over and reply there.
+
 ### Notifications
 
 Default behavior: with hooks installed, the moment a session changes to 🔴 waiting, the hook beeps

{ring_cli-0.10.0 → ring_cli-0.11.0}/README.en.md

@@ -34,6 +34,7 @@ RiNG puts them on one board, with sessions waiting for you sorted first.
 - **Waiting first**: sessions that need your response are highlighted and sorted above the rest.
 - **Jump back to the terminal**: in the TUI, select a session and press `Enter` / `Space` to focus tmux, iTerm2, Terminal.app (macOS), or a Linux X11 window (`wmctrl`).
 - **Notifies you without the board open**: with hooks installed, the moment a session turns 🔴 waiting it beeps and fires a system notification — even with no RiNG board running. With `terminal-notifier`, clicking the notification jumps back.
+- **Reply to permission requests in place**: with the cursor on a 🔴 waiting row, press `p` — RiNG reads the permission dialog from that session's terminal screen, pops the numbered options in a modal, and presses your choice for you, so you don't have to jump over one by one (sessions inside tmux, plus plain iTerm2 tabs on macOS).
 - **Name your sessions**: press `n` in the TUI to name a session, e.g. "auth refactor"; once named, the board and notifications show the name instead of the workspace directory.
 - **See what it is waiting for**: in hook mode, a 🔴 waiting session carries the concrete pending item (the command to run, the question asked) — shown in the TUI and in the notification body.
 - **Fits your status bar**: `ring --format oneline` prints a `🔴2 🟢1 🟡3` one-liner for tmux / SwiftBar / waybar; `--format json` feeds scripts.
@@ -128,7 +129,7 @@ Completes subcommands, flags, and `config set` keys; `ring focus` prompts for a
 ## Watch Mode
 
 - With **Textual** (`[tui]` extra) in a real terminal: interactive TUI.
-  Use `↑/↓` to select, `Enter` / `Space` to jump, `n` to name a session, `a` to toggle ended sessions, `dd` to hide a session (it reappears automatically once it has new activity), `r` to refresh, and `q` to quit.
+  Use `↑/↓` to select, `Enter` / `Space` to jump, `p` to reply to a permission request in place, `n` to name a session, `a` to toggle ended sessions, `dd` to hide a session (it reappears automatically once it has new activity), `r` to refresh, and `q` to quit.
   If you have vim muscle memory like I do, `j/k` move up/down and `g/G` jump to the first/last row.
   When the selected row is 🔴 waiting, a line under the table shows **what it is concretely waiting for** (the command to run, the question asked; hook mode only).
 - Otherwise: Rich polling; without Rich, plain text.
@@ -147,6 +148,30 @@ hands the request to the TUI so it selects that session; otherwise it focuses th
 TTY matching is most accurate in hook mode. Without hooks, Codex falls back to zero-config matching:
 one live Codex session per cwd can jump correctly; multiple live Codex sessions in the same cwd are shown conservatively to avoid focusing the wrong tab.
 
+### Reply To Permission Requests In Place (`p`)
+
+With the cursor on a 🔴 waiting row, press `p`. RiNG reads that session's screen, parses the
+permission dialog (Claude Code's "Do you want to proceed?" box, including background-subagent
+ones with a "from the … agent" header), and lists the numbered options verbatim in a modal.
+After you pick one, RiNG **captures the screen again** to confirm the dialog is still there and
+unchanged (it may have been answered while you were deciding), only then sends that single
+digit, and re-checks that the dialog actually disappeared.
+
+- **Sessions inside tmux**: reads the screen with `tmux capture-pane` and sends keys with
+  `tmux send-keys`.
+- **Sessions in a plain iTerm2 tab on macOS** (no tmux): locates the matching iTerm2 session by
+  its `tty` via AppleScript, and both reads the screen and sends keys through `osascript`. The
+  first use triggers the macOS Automation permission prompt ("allow control of iTerm2") — allow
+  it once.
+
+Safety first: if no recognizable dialog can be parsed (missing markers, numbering, or cursor),
+RiNG only shows a toast and **never sends a key** — without the dialog, keystrokes would land in
+the chat input box as text. If the dialog happens to vanish in the instant the digit is sent and
+the digit lands in the input box, RiNG sends a Backspace to clean it up and warns you.
+
+**Limits**: reading the screen requires a tmux pane coordinate, or (on macOS) an iTerm2 session
+with a detectable tty; for other sessions, press `Enter` to jump over and reply there.
+
 ### Notifications
 
 Default behavior: with hooks installed, the moment a session changes to 🔴 waiting, the hook beeps

{ring_cli-0.10.0 → ring_cli-0.11.0}/pyproject.toml

@@ -2,7 +2,7 @@
 # import 的 module（見 [tool.uv.build-backend] module-name）與 CLI 指令仍是 `ring`。
 [project]
 name = "ring-cli"
-version = "0.10.0"
+version = "0.11.0"
 description = "RiNG — Realtime Instance Notification Grid for active agent CLI sessions."
 readme = "README.en.md"
 requires-python = ">=3.13"

{ring_cli-0.10.0 → ring_cli-0.11.0}/src/ring/locale/en/LC_MESSAGES/ring.po

@@ -653,3 +653,42 @@ msgstr "total wait"
 
 msgid "⚠️ 其中 {n} 段還在 🔴 等你（計到現在為止）。"
 msgstr "⚠️ {n} of these are still 🔴 waiting for you (counted up to now)."
+
+msgid "回覆權限"
+msgstr "reply perm"
+
+msgid "回覆 {project} 的權限請求"
+msgstr "Reply to the permission request from {project}"
+
+msgid "Enter 或數字鍵送出、Esc 取消"
+msgstr "Enter or a digit key sends, Esc cancels"
+
+msgid "{project}：沒有 tmux 座標，且非 macOS 上的 iTerm2 session，無法就地回覆"
+msgstr "{project}: no tmux coordinates, and not a macOS iTerm2 session either — cannot reply in place"
+
+msgid "{project}：讀不到 {backend} 畫面"
+msgstr "{project}: cannot read the {backend} screen"
+
+msgid "{project}：畫面上沒有可辨識的權限對話框，未送出任何按鍵"
+msgstr "{project}: no recognizable permission dialog on screen; no key was sent"
+
+msgid "→ {project}：已回覆權限（{option}）"
+msgstr "→ {project}: permission answered ({option})"
+
+msgid "{project}：權限對話框已不在，未送出任何按鍵"
+msgstr "{project}: the permission dialog is gone; no key was sent"
+
+msgid "{project}：對話框內容已變化，未送出；請再按一次 p"
+msgstr "{project}: the dialog changed; nothing sent — press p again"
+
+msgid "{project}：tmux send-keys 失敗，沒能回覆"
+msgstr "{project}: tmux send-keys failed; could not reply"
+
+msgid "{project}：已送出但對話框還在，請跳過去確認"
+msgstr "{project}: key sent but the dialog is still there — jump over to check"
+
+msgid "{project}：對話框已不在，數字落進輸入框，已補 Backspace 清掉"
+msgstr "{project}: the dialog was gone and the digit landed in the input box — sent Backspace to clean it up"
+
+msgid "{project}：已送出但拿不到畫面驗證，請跳過去確認"
+msgstr "{project}: key sent but the screen could not be re-read to verify — jump over to check"

{ring_cli-0.10.0 → ring_cli-0.11.0}/src/ring/locale/ring.pot

@@ -8,7 +8,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: PROJECT VERSION\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2026-07-10 15:32+0800\n"
+"POT-Creation-Date: 2026-07-12 09:22+0800\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language-Team: LANGUAGE <LL@li.org>\n"
@@ -52,7 +52,7 @@ msgstr[1] ""
 msgid "🎤 RiNG — {sess} · {proc}"
 msgstr ""
 
-#: src/ring/cli.py:163 src/ring/cli.py:216 src/ring/tui.py:213
+#: src/ring/cli.py:163 src/ring/cli.py:216 src/ring/tui.py:274
 msgid "圖例"
 msgstr ""
 
@@ -63,32 +63,32 @@ msgstr ""
 #: src/ring/cli.py:184 src/ring/cli.py:338 src/ring/commands/doctor.py:31
 #: src/ring/commands/doctor.py:68 src/ring/commands/doctor.py:70
 #: src/ring/commands/doctor.py:72 src/ring/commands/doctor.py:134
-#: src/ring/tui.py:168
+#: src/ring/tui.py:229
 msgid "狀態"
 msgstr ""
 
-#: src/ring/cli.py:186 src/ring/cli.py:235 src/ring/tui.py:170
+#: src/ring/cli.py:186 src/ring/cli.py:235 src/ring/tui.py:231
 msgid "工具"
 msgstr ""
 
 #: src/ring/cli.py:187 src/ring/cli.py:235 src/ring/commands/stats.py:60
-#: src/ring/tui.py:171
+#: src/ring/tui.py:232
 msgid "專案"
 msgstr ""
 
-#: src/ring/cli.py:188 src/ring/cli.py:235 src/ring/tui.py:171
+#: src/ring/cli.py:188 src/ring/cli.py:235 src/ring/tui.py:232
 msgid "進度"
 msgstr ""
 
-#: src/ring/cli.py:189 src/ring/cli.py:235 src/ring/tui.py:171
+#: src/ring/cli.py:189 src/ring/cli.py:235 src/ring/tui.py:232
 msgid "閒置"
 msgstr ""
 
-#: src/ring/cli.py:190 src/ring/cli.py:235 src/ring/tui.py:171
+#: src/ring/cli.py:190 src/ring/cli.py:235 src/ring/tui.py:232
 msgid "去哪"
 msgstr ""
 
-#: src/ring/cli.py:192 src/ring/cli.py:235 src/ring/tui.py:171
+#: src/ring/cli.py:192 src/ring/cli.py:235 src/ring/tui.py:232
 msgid "動作"
 msgstr ""
 
@@ -305,41 +305,41 @@ msgstr ""
 msgid "重開 Codex session、並在它詢問時「信任」這個 hook，🔴 等你狀態才會精準起來（Codex 不會執行未信任的 hook）。"
 msgstr ""
 
-#: src/ring/hook.py:406
+#: src/ring/hook.py:438
 #, python-brace-format
 msgid "⚠️ 偵測到其他工具也掛在 {events}：{cmds}"
 msgstr ""
 
-#: src/ring/hook.py:407
+#: src/ring/hook.py:439
 msgid "它們會跟 RiNG 的通知重複觸發；要完全改用 RiNG，建議移除它們。"
 msgstr ""
 
-#: src/ring/hook.py:455 src/ring/hook.py:531
+#: src/ring/hook.py:487 src/ring/hook.py:563
 #, python-brace-format
 msgid "⚠️ {path} 不是合法 JSON，先處理它再來。"
 msgstr ""
 
-#: src/ring/hook.py:493
+#: src/ring/hook.py:525
 #, python-brace-format
 msgid "✅ RiNG hooks 已經裝過了，沒有變更。（{path}）"
 msgstr ""
 
-#: src/ring/hook.py:506
+#: src/ring/hook.py:538
 #, python-brace-format
 msgid "✅ 已註冊 RiNG hooks（{events}）到 {path}"
 msgstr ""
 
-#: src/ring/hook.py:525
+#: src/ring/hook.py:557
 #, python-brace-format
 msgid "ℹ️ {path} 不存在，沒有可移除的 hook。"
 msgstr ""
 
-#: src/ring/hook.py:552
+#: src/ring/hook.py:584
 #, python-brace-format
 msgid "ℹ️ 沒有找到 RiNG hook 條目，無需移除。（{path}）"
 msgstr ""
 
-#: src/ring/hook.py:556
+#: src/ring/hook.py:588
 #, python-brace-format
 msgid "✅ 已移除 RiNG hooks（{events}）從 {path}"
 msgstr ""
@@ -349,103 +349,167 @@ msgstr ""
 msgid "⚠️ ring plugin '{name}' 載入失敗：{error}"
 msgstr ""
 
-#: src/ring/tui.py:88
+#: src/ring/tui.py:91
 #, python-brace-format
 msgid "為 {project} 命名（Enter 存、Esc 取消、清空移除）"
 msgstr ""
 
-#: src/ring/tui.py:89
+#: src/ring/tui.py:92
 msgid "這個 session 在做什麼…"
 msgstr ""
 
-#: src/ring/tui.py:106
+#: src/ring/tui.py:136
+#, python-brace-format
+msgid "回覆 {project} 的權限請求"
+msgstr ""
+
+#: src/ring/tui.py:141
+msgid "Enter 或數字鍵送出、Esc 取消"
+msgstr ""
+
+#: src/ring/tui.py:164
 msgid "離場"
 msgstr ""
 
-#: src/ring/tui.py:107
+#: src/ring/tui.py:165
 msgid "刷新"
 msgstr ""
 
-#: src/ring/tui.py:108
+#: src/ring/tui.py:166
 msgid "含已離場"
 msgstr ""
 
-#: src/ring/tui.py:109
+#: src/ring/tui.py:167
 msgid "命名"
 msgstr ""
 
-#: src/ring/tui.py:110
+#: src/ring/tui.py:168
 msgid "隱藏"
 msgstr ""
 
-#: src/ring/tui.py:111
+#: src/ring/tui.py:169
 msgid "最久等待"
 msgstr ""
 
-#: src/ring/tui.py:112 src/ring/tui.py:113
+#: src/ring/tui.py:170
+msgid "回覆權限"
+msgstr ""
+
+#: src/ring/tui.py:171 src/ring/tui.py:172
 msgid "跳過去"
 msgstr ""
 
-#: src/ring/tui.py:189
+#: src/ring/tui.py:250
 msgid "💡 同專案開了多個 session，裝 hook 跳轉才精準：ring install-hooks"
 msgstr ""
 
-#: src/ring/tui.py:191
+#: src/ring/tui.py:252
 msgid "↑/↓ 選一列，Enter 或 Space 跳到那個 session 的終端"
 msgstr ""
 
-#: src/ring/tui.py:227
+#: src/ring/tui.py:288
 #, python-brace-format
 msgid "🔔 {names} 在等你回話"
 msgstr ""
 
-#: src/ring/tui.py:268
+#: src/ring/tui.py:329
 #, python-brace-format
 msgid "→ 已跳到 {project}（來自通知）"
 msgstr ""
 
-#: src/ring/tui.py:273
+#: src/ring/tui.py:334
 msgid "那個 session 已不在場"
 msgstr ""
 
-#: src/ring/tui.py:332
+#: src/ring/tui.py:393
 msgid "  ⚠ hook 可能失效：來源檔有更新但沒有 heartbeat"
 msgstr ""
 
-#: src/ring/tui.py:361 src/ring/tui.py:385 src/ring/tui.py:411
+#: src/ring/tui.py:422 src/ring/tui.py:446 src/ring/tui.py:479
+#: src/ring/tui.py:544
 msgid "（沒有選到 session）"
 msgstr ""
 
-#: src/ring/tui.py:392
+#: src/ring/tui.py:453
 #, python-brace-format
 msgid "→ {project}（{where}）"
 msgstr ""
 
-#: src/ring/tui.py:394
+#: src/ring/tui.py:455
 #, python-brace-format
 msgid "{project}：{msg}"
 msgstr ""
 
-#: src/ring/tui.py:402
+#: src/ring/tui.py:463
 msgid "（沒有正在等待的 session）"
 msgstr ""
 
-#: src/ring/tui.py:419
+#: src/ring/tui.py:486
+#, python-brace-format
+msgid "{project}：沒有 tmux 座標，且非 macOS 上的 iTerm2 session，無法就地回覆"
+msgstr ""
+
+#: src/ring/tui.py:493
+#, python-brace-format
+msgid "{project}：讀不到 {backend} 畫面"
+msgstr ""
+
+#: src/ring/tui.py:497
+#, python-brace-format
+msgid "{project}：畫面上沒有可辨識的權限對話框，未送出任何按鍵"
+msgstr ""
+
+#: src/ring/tui.py:526
+#, python-brace-format
+msgid "→ {project}：已回覆權限（{option}）"
+msgstr ""
+
+#: src/ring/tui.py:530
+#, python-brace-format
+msgid "{project}：權限對話框已不在，未送出任何按鍵"
+msgstr ""
+
+#: src/ring/tui.py:531
+#, python-brace-format
+msgid "{project}：對話框內容已變化，未送出；請再按一次 p"
+msgstr ""
+
+#: src/ring/tui.py:532
+#, python-brace-format
+msgid "{project}：tmux send-keys 失敗，沒能回覆"
+msgstr ""
+
+#: src/ring/tui.py:533
+#, python-brace-format
+msgid "{project}：已送出但對話框還在，請跳過去確認"
+msgstr ""
+
+#: src/ring/tui.py:535
+#, python-brace-format
+msgid "{project}：對話框已不在，數字落進輸入框，已補 Backspace 清掉"
+msgstr ""
+
+#: src/ring/tui.py:537
+#, python-brace-format
+msgid "{project}：已送出但拿不到畫面驗證，請跳過去確認"
+msgstr ""
+
+#: src/ring/tui.py:552
 #, python-brace-format
 msgid "再按一次 d 隱藏 {project}（有新活動會自動重新出現）"
 msgstr ""
 
-#: src/ring/tui.py:424
+#: src/ring/tui.py:557
 #, python-brace-format
 msgid "{project} 是仍在執行的 process，無法隱藏；請跳過去結束它"
 msgstr ""
 
-#: src/ring/tui.py:432
+#: src/ring/tui.py:565
 #, python-brace-format
 msgid "已隱藏 {project}，並清掉 RiNG 狀態；有新活動會自動重新出現"
 msgstr ""
 
-#: src/ring/tui.py:434
+#: src/ring/tui.py:567
 #, python-brace-format
 msgid "已隱藏 {project}（沒有 RiNG registry 可清；有新活動會自動重新出現）"
 msgstr ""

ring_cli-0.11.0/src/ring/permission.py

@@ -0,0 +1,334 @@
+"""面板內回覆權限請求——讀終端上的 Claude Code 權限對話框、代你按下選項。
+
+流程：``backend.capture()`` 抓畫面 → ``parse_permission_dialog()`` 解析出編號選項 →
+TUI 開浮層讓你選 → ``send_permission_reply()`` 送出前再抓一次確認對話框還在且沒變
+（防 race），才送單一數字（**不帶 Enter**——對話框上按數字即選中；帶了 Enter 反而會
+在對話框剛好消失時把字送進聊天輸入框）。
+
+安全底線：任何解析不確定（抓不到對話框標記、選項編號不連續、沒有游標）一律回
+``None`` / 不送鍵。誤送偵測：對話框不在時數字會落進聊天輸入框（``❯ 2``），此時補送
+Backspace 清掉。
+
+``send_permission_reply()`` 的流程本體只有一份，實際怎麼抓畫面／怎麼送鍵由
+``PermissionBackend``（tmux / iTerm2）決定——照 ``focus/base.py`` 的 Protocol 形狀走。
+tmux 互動集中在這裡（照 ``focus/tmux.py`` 的形狀走 subprocess），iTerm2 互動走
+``ring.osascript``（照 ``focus/applescript.py`` 的形狀）。解析器是純函式，測試直接餵
+PoC 抓下來的真實畫面（``tests/fixtures/permission/``）。
+"""
+
+from __future__ import annotations
+
+import re
+import shutil
+import subprocess
+import sys
+import time
+from dataclasses import dataclass
+from enum import Enum
+from typing import Protocol
+
+from ring.osascript import osascript
+from ring.registry import Session
+
+# 對話框 footer：「 Esc to cancel · Tab to amend · ctrl+e to explain」。
+# 注意大小寫——工作中狀態列的「esc to interrupt」是小寫 e，不會誤中。
+_FOOTER_RE = re.compile(r"\bEsc to cancel\b")
+# 編號選項列：「 ❯ 1. Yes」（游標）或「   2. Yes, and …」。
+_OPTION_RE = re.compile(r"^\s*(?:❯\s*)?(\d)\.\s+(\S.*?)\s*$")
+# 對話框標題列的 subagent 標頭：「Bash command · from the general-purpose agent」。
+_AGENT_RE = re.compile(r"·\s*from the (.+?) agent\b")
+# 對話框上緣的水平分隔線（整列 ─）。
+_SEPARATOR_RE = re.compile(r"^\s*─{10,}\s*$")
+# 聊天輸入框的提示列：「❯ <內容>」。誤送時數字會出現在這裡。
+_INPUT_LINE_RE = re.compile(r"^\s*❯\s*(.+?)\s*$")
+
+# 送出數字後等 UI 反應的秒數，之後再抓一次畫面驗證。
+_VERIFY_DELAY = 0.4
+
+
+@dataclass(frozen=True)
+class PermissionDialog:
+    """解析出來的權限對話框。``options`` 是 (編號, 原文) 的序列，編號從 1 連續。"""
+
+    options: tuple[tuple[int, str], ...]
+    question: str = ""  # e.g. "Do you want to proceed?"
+    title: str = ""  # e.g. "Bash command · from the general-purpose agent"
+    agent: str = ""  # subagent 名稱（標題帶 "from the … agent" 才有），e.g. "general-purpose"
+
+
+class ReplyOutcome(Enum):
+    """``send_permission_reply()`` 的結果。只有 OK / MISFIRE 真的送過鍵。"""
+
+    OK = "ok"  # 送出後對話框消失（或換成下一個請求）→ 成功
+    NO_DIALOG = "no_dialog"  # 送出前的確認抓不到對話框 → 沒送
+    CHANGED = "changed"  # 送出前的確認發現對話框變了 → 沒送
+    SEND_FAILED = "send_failed"  # tmux send-keys 失敗
+    STILL_PRESENT = "still_present"  # 送了，但同一個對話框還在 → 請跳過去確認
+    MISFIRE = "misfire"  # 送了，數字落進聊天輸入框；已補 Backspace 清掉
+    UNVERIFIED = "unverified"  # 送了，但驗證用的 capture 失敗 → 請跳過去確認
+
+
+# ---------------------------------------------------------------------------
+# 純解析（不碰 tmux）
+# ---------------------------------------------------------------------------
+
+
+def parse_permission_dialog(screen: str) -> PermissionDialog | None:
+    """從 capture-pane 的畫面解析權限對話框；任何標記缺失就回 ``None``（絕不猜）。
+
+    由下往上找，要求四個標記同時成立：
+    1. footer 列（``Esc to cancel``）
+    2. footer 上方是連續的編號選項列，編號從 1 起連續、至少 2 個
+    3. 至少一個選項列帶游標 ``❯``
+    4. 選項上方第一個非空白列是問句（以 ``?`` 結尾，如 ``Do you want to proceed?``）
+    """
+    lines = screen.splitlines()
+    footer_idx = next((i for i in range(len(lines) - 1, -1, -1) if _FOOTER_RE.search(lines[i])), None)
+    if footer_idx is None:
+        return None
+
+    # footer 上方跳過空白列，往上收集連續的編號選項列。
+    i = footer_idx - 1
+    while i >= 0 and not lines[i].strip():
+        i -= 1
+    collected: list[tuple[int, str]] = []
+    saw_cursor = False
+    while i >= 0:
+        m = _OPTION_RE.match(lines[i])
+        if m is None:
+            break
+        collected.append((int(m.group(1)), m.group(2)))
+        if "❯" in lines[i]:
+            saw_cursor = True
+        i -= 1
+    options = tuple(reversed(collected))
+    if len(options) < 2 or not saw_cursor:
+        return None
+    if [n for n, _text in options] != list(range(1, len(options) + 1)):
+        return None
+
+    # 問句：選項上方第一個非空白列，必須以 ? 結尾。
+    while i >= 0 and not lines[i].strip():
+        i -= 1
+    if i < 0 or not lines[i].rstrip().endswith("?"):
+        return None
+    question = lines[i].strip()
+
+    # 標題：往上找到對話框上緣的分隔線，其下第一個非空白列
+    # （e.g. "Bash command · from the general-purpose agent"）。找不到就留空，不影響判定。
+    title = ""
+    sep_idx = next((j for j in range(i - 1, -1, -1) if _SEPARATOR_RE.match(lines[j])), None)
+    if sep_idx is not None:
+        title = next((lines[j].strip() for j in range(sep_idx + 1, i) if lines[j].strip()), "")
+    agent_match = _AGENT_RE.search(title)
+    agent = agent_match.group(1) if agent_match else ""
+    return PermissionDialog(options=options, question=question, title=title, agent=agent)
+
+
+def digit_in_input_line(screen: str, digit: str) -> bool:
+    """對話框不在時送出的數字會落進聊天輸入框，變成一行「``❯ 2``」——偵測這種誤送。"""
+    for line in screen.splitlines():
+        m = _INPUT_LINE_RE.match(line)
+        if m is not None and m.group(1) == digit:
+            return True
+    return False
+
+
+# ---------------------------------------------------------------------------
+# backend 協定——capture/send 可替換，流程本體（下面 send_permission_reply）只有一份
+# ---------------------------------------------------------------------------
+
+
+class PermissionBackend(Protocol):
+    """一個終端的「抓畫面 / 送鍵」能力。照 ``focus/base.py`` 的 Protocol 形狀走。
+
+    ``name`` 宣告成 read-only property：實作是 frozen dataclass，欄位不可寫，
+    宣告成一般屬性會被 mypy 判定不相容。
+    """
+
+    @property
+    def name(self) -> str: ...
+
+    def capture(self) -> str | None: ...
+    def send_digit(self, digit: str) -> bool: ...
+    def send_backspace(self) -> bool: ...
+
+
+# ---------------------------------------------------------------------------
+# tmux 互動（全部走 subprocess，測試一律 mock）
+# ---------------------------------------------------------------------------
+
+
+def _run_tmux(args: list[str]) -> subprocess.CompletedProcess[str] | None:
+    if not shutil.which("tmux"):
+        return None
+    try:
+        return subprocess.run(["tmux", *args], capture_output=True, text=True, timeout=3)
+    except (OSError, subprocess.SubprocessError):
+        return None
+
+
+def capture_pane(target: str) -> str | None:
+    """抓 pane 目前的可見畫面；tmux 不在 / target 無效 → ``None``。"""
+    result = _run_tmux(["capture-pane", "-p", "-t", target])
+    if result is None or result.returncode != 0:
+        return None
+    return result.stdout
+
+
+def send_key(target: str, key: str) -> bool:
+    """對 pane 送一個鍵（tmux key 名，如 ``2`` / ``BSpace``）。"""
+    result = _run_tmux(["send-keys", "-t", target, key])
+    return result is not None and result.returncode == 0
+
+
+@dataclass(frozen=True)
+class TmuxBackend:
+    """tmux pane 的 backend：``capture_pane`` / ``send_key`` 包一層給流程本體用。"""
+
+    target: str
+    name: str = "tmux"
+
+    def capture(self) -> str | None:
+        return capture_pane(self.target)
+
+    def send_digit(self, digit: str) -> bool:
+        return send_key(self.target, digit)
+
+    def send_backspace(self) -> bool:
+        return send_key(self.target, "BSpace")
+
+
+# ---------------------------------------------------------------------------
+# iTerm2 互動（走 osascript，測試一律 mock）
+# ---------------------------------------------------------------------------
+
+# 依 tty 找到對應 session 後執行 {action}；找不到就回 sentinel（真實畫面內容不可能剛好
+# 撞上這個字串）。tty 定位邏輯與 ``focus/iterm2.py`` 的 focuser 同形，各自獨立維護——
+# 一個是「聚焦分頁」，一個是「抓畫面／送鍵」，職責不同，硬併會讓兩邊都難改。
+_ITERM_NO_SESSION = "__ring_no_session__"
+_ITERM_SCRIPT = """
+if application "iTerm2" is running then
+  tell application "iTerm2"
+    repeat with w in windows
+      repeat with t in tabs of w
+        repeat with s in sessions of t
+          if tty of s is "{tty}" then
+            {action}
+          end if
+        end repeat
+      end repeat
+    end repeat
+  end tell
+end if
+return "{sentinel}"
+"""
+
+
+def _iterm_run(tty: str, action: str) -> tuple[int, str, str] | None:
+    if not tty or not shutil.which("osascript"):
+        return None
+    return osascript(_ITERM_SCRIPT.format(tty=tty, action=action, sentinel=_ITERM_NO_SESSION))
+
+
+def iterm_capture(tty: str) -> str | None:
+    """抓 iTerm2 session 目前的可見畫面（``contents of session``）；找不到 → ``None``。"""
+    result = _iterm_run(tty, "return contents of s")
+    if result is None:
+        return None
+    rc, out, _err = result
+    if rc != 0 or out == _ITERM_NO_SESSION:
+        return None
+    return out
+
+
+def _iterm_write(tty: str, payload: str) -> bool:
+    result = _iterm_run(tty, f'tell s to write text {payload} newline NO\n            return "ok"')
+    return result is not None and result[0] == 0 and result[1] == "ok"
+
+
+def iterm_send_digit(tty: str, digit: str) -> bool:
+    """對 iTerm2 session 送一個數字——單一數字直接觸發選項，不帶 Enter。"""
+    return _iterm_write(tty, f'"{digit}"')
+
+
+def iterm_send_backspace(tty: str) -> bool:
+    """對 iTerm2 session 送 Backspace（誤送補救用）。"""
+    return _iterm_write(tty, "(ASCII character 8)")
+
+
+@dataclass(frozen=True)
+class ITermBackend:
+    """iTerm2 session 的 backend：依 tty 定位 session，抓畫面／送鍵都透過 osascript。"""
+
+    tty: str
+    name: str = "iTerm2"
+
+    def capture(self) -> str | None:
+        return iterm_capture(self.tty)
+
+    def send_digit(self, digit: str) -> bool:
+        return iterm_send_digit(self.tty, digit)
+
+    def send_backspace(self) -> bool:
+        return iterm_send_backspace(self.tty)
+
+
+def select_backend(session: Session) -> PermissionBackend | None:
+    """依 session 現有座標選 backend：tmux 座標優先，其次 macOS 上有 tty 就用 iTerm2。
+
+    都沒有 → ``None``，呼叫端走既有的 toast（不送鍵）路徑。
+    """
+    target = session.tmux_pane or session.tmux_target
+    if target:
+        return TmuxBackend(target)
+    if session.tty and sys.platform == "darwin":
+        return ITermBackend(session.tty)
+    return None
+
+
+# ---------------------------------------------------------------------------
+# 送鍵流程本體——backend 換 tmux / iTerm2，流程只有這一份
+# ---------------------------------------------------------------------------
+
+
+def send_permission_reply(
+    backend: PermissionBackend,
+    expected: PermissionDialog,
+    number: int,
+    *,
+    delay: float = _VERIFY_DELAY,
+) -> ReplyOutcome:
+    """把選定的選項編號送進終端上的權限對話框，送出前後都驗證。
+
+    1. 再 capture 一次：對話框不在 → ``NO_DIALOG``；跟 ``expected`` 不同 → ``CHANGED``。
+       兩者都**不送鍵**（使用者在浮層裡想的期間，對話框可能已被本人回掉或換內容）。
+    2. 送單一數字（不帶 Enter）。
+    3. 等 ``delay`` 秒再 capture 驗證：對話框消失 → ``OK``；數字落進輸入框 → 補
+       Backspace、``MISFIRE``；同一個對話框還在 → ``STILL_PRESENT``。
+    """
+    if not any(number == n for n, _text in expected.options):
+        return ReplyOutcome.CHANGED  # 編號不在選項裡，視同對話框對不上，不送
+    screen = backend.capture()
+    if screen is None:
+        return ReplyOutcome.NO_DIALOG
+    current = parse_permission_dialog(screen)
+    if current is None:
+        return ReplyOutcome.NO_DIALOG
+    if current != expected:
+        return ReplyOutcome.CHANGED
+    if not backend.send_digit(str(number)):
+        return ReplyOutcome.SEND_FAILED
+    time.sleep(delay)
+    after = backend.capture()
+    if after is None:
+        return ReplyOutcome.UNVERIFIED
+    after_dialog = parse_permission_dialog(after)
+    if after_dialog is None:
+        if digit_in_input_line(after, str(number)):
+            backend.send_backspace()
+            return ReplyOutcome.MISFIRE
+        return ReplyOutcome.OK
+    if after_dialog == expected:
+        return ReplyOutcome.STILL_PRESENT
+    return ReplyOutcome.OK  # 對話框換成下一個請求 → 原請求已被回覆

{ring_cli-0.10.0 → ring_cli-0.11.0}/src/ring/tui.py

@@ -3,7 +3,8 @@
 需要 textual（``pip install 'ring[tui]'``）。沒裝時 CLI 會自動退回 Rich poll。
 
 鍵：↑/↓（或 vim 的 j/k、g/G 跳頭尾）選 session、Enter/Space 跳到它所在的終端、
-a 切換是否顯示已離場、dd 隱藏 session（有新活動會自動重新出現）、r 刷新、q 離場。
+p 就地回覆權限請求（tmux 內的 session）、a 切換是否顯示已離場、dd 隱藏 session
+（有新活動會自動重新出現）、r 刷新、q 離場。
 """
 
 from __future__ import annotations
@@ -13,12 +14,14 @@ import time
 from typing import ClassVar
 
 from rich.text import Text
+from textual import events
 from textual.app import App, ComposeResult
 from textual.binding import Binding, BindingType
 from textual.containers import Vertical
 from textual.screen import ModalScreen
-from textual.widgets import DataTable, Footer, Header, Input, Static
+from textual.widgets import DataTable, Footer, Header, Input, OptionList, Static
 
+from ring import permission
 from ring.cli import (
     _LOC_MAX,
     _STATUS_STYLE,
@@ -98,6 +101,61 @@ class _NameModal(ModalScreen[str | None]):
         self.dismiss(None)
 
 
+class _PermissionModal(ModalScreen[int | None]):
+    """就地回覆權限請求的浮層：列出對話框原文選項，↑/↓＋Enter 或直接按數字鍵選、Esc 取消。
+
+    dismiss 回傳：選項編號（int）或 ``None``（取消，不送任何鍵）。
+    """
+
+    DEFAULT_CSS = """
+    _PermissionModal {
+        align: center middle;
+    }
+    _PermissionModal #perm-box {
+        width: 90;
+        max-width: 100%;
+        height: auto;
+        padding: 1 2;
+        background: $panel;
+        border: round $accent;
+    }
+    _PermissionModal OptionList {
+        height: auto;
+        background: $panel;
+        border: none;
+    }
+    """
+
+    def __init__(self, project: str, dialog: permission.PermissionDialog) -> None:
+        super().__init__()
+        self._project = project
+        self._dialog = dialog
+
+    def compose(self) -> ComposeResult:
+        with Vertical(id="perm-box"):
+            yield Static(Text(_("回覆 {project} 的權限請求", project=self._project), style="bold"))
+            context = " · ".join(part for part in (self._dialog.title, self._dialog.question) if part)
+            if context:
+                yield Static(Text(context, style="grey50"))
+            yield OptionList(*(f"{n}. {text}" for n, text in self._dialog.options))
+            yield Static(Text(_("Enter 或數字鍵送出、Esc 取消"), style="grey50"))
+
+    def on_mount(self) -> None:
+        self.query_one(OptionList).focus()
+
+    def on_option_list_option_selected(self, event: OptionList.OptionSelected) -> None:
+        self.dismiss(self._dialog.options[event.option_index][0])
+
+    def on_key(self, event: events.Key) -> None:
+        # 跟真的對話框一樣，直接按選項數字也行。
+        if event.key.isdigit() and any(int(event.key) == n for n, _text in self._dialog.options):
+            event.stop()
+            self.dismiss(int(event.key))
+
+    def key_escape(self) -> None:
+        self.dismiss(None)
+
+
 class RingApp(App[None]):
     """場館的即時看板。"""
 
@@ -109,6 +167,7 @@ class RingApp(App[None]):
         Binding("n", "name_session", _("命名")),
         Binding("d", "delete_session", _("隱藏"), key_display="dd"),
         Binding("w", "jump_oldest_waiting", _("最久等待")),
+        Binding("p", "permission_reply", _("回覆權限")),
         Binding("enter", "jump", _("跳過去")),
         Binding("space", "jump", _("跳過去"), show=False),
     ]
@@ -407,6 +466,78 @@ class RingApp(App[None]):
         self.query_one(DataTable).move_cursor(row=idx)
         self.action_jump()
 
+    def action_permission_reply(self) -> None:
+        """游標列的 session 掛著權限對話框時，就地讀出選項讓你選、代按，不必跳過去。
+
+        支援 tmux 內的 session，以及（macOS 上）直接開在 iTerm2 分頁、沒有 tmux 的
+        session——backend 選擇見 ``permission.select_backend``。解析不到可辨識的權限
+        對話框就只 toast、絕不送鍵——沒有對話框時按鍵會落進聊天輸入框變成文字。
+        """
+        self._clear_delete_armed()
+        s = self._selected()
+        if s is None:
+            self._set_status(_("（沒有選到 session）"))
+            return
+        name = self._display_name(s)
+        backend = permission.select_backend(s)
+        if backend is None:
+            self._toast(
+                _(
+                    "{project}：沒有 tmux 座標，且非 macOS 上的 iTerm2 session，無法就地回覆",
+                    project=name,
+                )
+            )
+            return
+        screen = backend.capture()
+        if screen is None:
+            self._toast(_("{project}：讀不到 {backend} 畫面", project=name, backend=backend.name))
+            return
+        dialog = permission.parse_permission_dialog(screen)
+        if dialog is None:
+            self._toast(_("{project}：畫面上沒有可辨識的權限對話框，未送出任何按鍵", project=name))
+            return
+
+        def _submit(number: int | None) -> None:
+            if number is None:
+                return  # Esc 取消，不送
+            self._finish_permission_reply(s, name, backend, dialog, number)
+
+        self.push_screen(_PermissionModal(name, dialog), _submit)
+
+    def _toast(self, text: str, *, ok: bool = False) -> None:
+        """status 列＋toast 一次到位（權限回覆路徑的訊息都成對出現）。"""
+        self._set_status(text)
+        self.notify(text, severity="information" if ok else "warning", timeout=8)
+
+    def _finish_permission_reply(
+        self,
+        s: Session,
+        name: str,
+        backend: permission.PermissionBackend,
+        dialog: permission.PermissionDialog,
+        number: int,
+    ) -> None:
+        """浮層選定後：再驗證一次、送鍵、依結果回報（見 permission.send_permission_reply）。"""
+        outcome = permission.send_permission_reply(backend, dialog, number)
+        option = next((f"{n}. {text}" for n, text in dialog.options if n == number), str(number))
+        if outcome is permission.ReplyOutcome.OK:
+            if s.session_id == self._focused_sid:
+                self._focused_sid = None  # 已就地回覆，解除通知標記
+            self._toast(_("→ {project}：已回覆權限（{option}）", project=name, option=option), ok=True)
+            self._reload()
+            return
+        messages = {
+            permission.ReplyOutcome.NO_DIALOG: _("{project}：權限對話框已不在，未送出任何按鍵", project=name),
+            permission.ReplyOutcome.CHANGED: _("{project}：對話框內容已變化，未送出；請再按一次 p", project=name),
+            permission.ReplyOutcome.SEND_FAILED: _("{project}：tmux send-keys 失敗，沒能回覆", project=name),
+            permission.ReplyOutcome.STILL_PRESENT: _("{project}：已送出但對話框還在，請跳過去確認", project=name),
+            permission.ReplyOutcome.MISFIRE: _(
+                "{project}：對話框已不在，數字落進輸入框，已補 Backspace 清掉", project=name
+            ),
+            permission.ReplyOutcome.UNVERIFIED: _("{project}：已送出但拿不到畫面驗證，請跳過去確認", project=name),
+        }
+        self._toast(messages[outcome])
+
     def action_delete_session(self) -> None:
         s = self._selected()
         if s is None: