Support OSC clipboard selections

Author: SqlRush

docs/cc-100-roadmap.md

@@ -814,7 +814,7 @@ M7 补充：prompt history `LogEntry` 读取现在接受 `sessionID`/`session`/`
 
 本轮补充：terminal OSC helper 增加 iTerm2、Kitty、Ghostty notification 序列和 raw BEL helper，调用方可按环境选择是否 wrap multiplexer。
 
-本轮补充：terminal OSC helper 增加 OSC 52 clipboard 序列生成，固定 clipboard selection `c` 并按 UTF-8 base64 编码 payload；native clipboard/tmux buffer runtime 仍未接入。
+本轮补充：terminal OSC helper 增加 OSC 52 clipboard 序列生成，支持默认 `c` selection、显式 clipboard selection 和 clear 序列，并按 UTF-8 base64 编码 payload；native clipboard/tmux buffer runtime 仍未接入。
 
 本轮补充：terminal OSC helper 增加显式 ST (`ESC \\`) terminator 入口，可按官方 Kitty 避免 BEL 的路径生成 OSC 序列，同时默认 `OSCSequence` 仍保持 BEL terminator。
 

docs/claude-code-go-rewrite-plan.md

@@ -458,7 +458,7 @@ test/parity/                 # golden tests against TS/official behavior
 - 本轮补充：terminal OSC helper 增加 OSC 8 hyperlink 开始/结束序列，按官方 rolling hash 为 URL 自动生成 `id=`，并允许显式 params 覆盖。
 - 本轮补充：terminal OSC helper 增加 OSC 9;4 progress 序列，覆盖 clear/set/error/indeterminate，running/error 百分比按官方规则 clamp 到 0..100。
 - 本轮补充：terminal OSC helper 增加 iTerm2、Kitty、Ghostty notification 序列和 raw BEL helper，调用方可按环境选择是否 wrap multiplexer。
-- 本轮补充：terminal OSC helper 增加 OSC 52 clipboard 序列生成，固定 clipboard selection `c` 并按 UTF-8 base64 编码 payload；native clipboard/tmux buffer runtime 仍未接入。
+- 本轮补充：terminal OSC helper 增加 OSC 52 clipboard 序列生成，支持默认 `c` selection、显式 clipboard selection 和 clear 序列，并按 UTF-8 base64 编码 payload；native clipboard/tmux buffer runtime 仍未接入。
 - 本轮补充：terminal OSC helper 增加显式 ST (`ESC \\`) terminator 入口，可按官方 Kitty 避免 BEL 的路径生成 OSC 序列，同时默认 `OSCSequence` 仍保持 BEL terminator。
 - 本轮补充：terminal OSC helper 增加 OSC color parser，支持 `#RRGGBB` 和 XParseColor 风格 `rgb:R/G/B`，按官方规则把 1-4 位 hex component 缩放到 8-bit RGB。
 - 本轮补充：terminal OSC parser 把 OSC 10-19 dynamic color 设置/查询解析为结构化 color action，复用既有 OSC color parser，并支持同一序列内按官方递增规则连续设置多个 target；visible text/snapshot 继续剥离这些控制串。

docs/first-second-parity-audit.md

@@ -261,7 +261,7 @@ M7 progress now includes:
 - `internal/tui`: terminal OSC helpers now generate OSC 8 hyperlink start/end sequences with official URL-derived id parameters and explicit param overrides.
 - `internal/tui`: terminal OSC helpers now generate OSC 9;4 progress clear/set/error/indeterminate sequences with official 0..100 percentage clamping.
 - `internal/tui`: terminal OSC helpers now generate iTerm2, Kitty, and Ghostty notification sequences plus raw BEL notifications for caller-managed emission.
-- `internal/tui`: terminal OSC helpers now generate OSC 52 clipboard sequences using clipboard selection `c` and UTF-8 base64 payloads; native clipboard and tmux buffer runtime remain future work.
+- `internal/tui`: terminal OSC helpers now generate OSC 52 clipboard sequences using UTF-8 base64 payloads, support explicit clipboard selections and clear sequences, and still leave native clipboard and tmux buffer runtime for future work.
 - `internal/tui`: terminal OSC helpers now support explicit ST (`ESC \\`) terminators for Kitty-style no-BEL OSC output while preserving BEL as the default.
 - `internal/tui`: terminal OSC helpers now parse `#RRGGBB` and XParseColor-style `rgb:R/G/B` colors, scaling 1-4 digit hex components to 8-bit RGB like the official parser.
 - `internal/tui`: terminal OSC parsing now exposes OSC 10-19 dynamic color set/query sequences as structured color actions, including repeated payload parameters that advance to subsequent dynamic color targets while keeping visible text clean.

internal/tui/terminal_osc.go

@@ -853,7 +853,28 @@ func parseColonFields(value string) map[string]string {
 }
 
 func TerminalClipboardSequence(text string) string {
-	return OSCSequence(OSCClipboard, "c", base64.StdEncoding.EncodeToString([]byte(text)))
+	return TerminalClipboardSelectionSequence("c", text)
+}
+
+func TerminalClipboardSelectionSequence(selection string, text string) string {
+	return OSCSequence(OSCClipboard, normalizeClipboardSelection(selection), base64.StdEncoding.EncodeToString([]byte(text)))
+}
+
+func ClearTerminalClipboardSequence() string {
+	return ClearTerminalClipboardSelectionSequence("c")
+}
+
+func ClearTerminalClipboardSelectionSequence(selection string) string {
+	return OSCSequence(OSCClipboard, normalizeClipboardSelection(selection), "")
+}
+
+func normalizeClipboardSelection(selection string) string {
+	selection = strings.TrimSpace(selection)
+	selection = strings.ReplaceAll(selection, ";", "")
+	if selection == "" {
+		return "c"
+	}
+	return selection
 }
 
 func TerminalProgressSequence(state TerminalProgressState, percentage int) string {

internal/tui/tui_test.go

@@ -4865,6 +4865,32 @@ func TestTerminalClipboardSequence(t *testing.T) {
 	if seq != want {
 		t.Fatalf("clipboard = %q, want %q", seq, want)
 	}
+
+	primary := TerminalClipboardSelectionSequence("p", "primary")
+	wantPrimary := OSCPrefix + OSCClipboard + ";p;cHJpbWFyeQ==" + OSCTerminator
+	if primary != wantPrimary {
+		t.Fatalf("primary clipboard = %q, want %q", primary, wantPrimary)
+	}
+	parsed, ok := ParseOSCSequence(primary)
+	if !ok || parsed.Type != OSCActionClipboard || !parsed.Clipboard.Valid || parsed.Clipboard.Selection != "p" || parsed.Clipboard.Text != "primary" {
+		t.Fatalf("parsed primary clipboard = %#v ok=%v", parsed, ok)
+	}
+
+	clear := ClearTerminalClipboardSelectionSequence("p")
+	wantClear := OSCPrefix + OSCClipboard + ";p;" + OSCTerminator
+	if clear != wantClear {
+		t.Fatalf("clear clipboard = %q, want %q", clear, wantClear)
+	}
+	parsedClear, ok := ParseOSCSequence(clear)
+	if !ok || parsedClear.Type != OSCActionClipboard || !parsedClear.Clipboard.Valid || !parsedClear.Clipboard.Clear || parsedClear.Clipboard.Selection != "p" {
+		t.Fatalf("parsed clear clipboard = %#v ok=%v", parsedClear, ok)
+	}
+
+	defaultClear := ClearTerminalClipboardSelectionSequence("")
+	wantDefaultClear := OSCPrefix + OSCClipboard + ";c;" + OSCTerminator
+	if defaultClear != wantDefaultClear {
+		t.Fatalf("default clear clipboard = %q, want %q", defaultClear, wantDefaultClear)
+	}
 }
 
 func TestTerminalProgressSequence(t *testing.T) {