From 0b4eb6b49a6df4e9827c5bd888173041f03e4144 Mon Sep 17 00:00:00 2001
From: Simon <10131203+gaomeng1900@users.noreply.github.com>
Date: Mon, 30 Mar 2026 22:08:09 +0800
Subject: [PATCH] docs(ext): experimentalIncludeAllTabs

---
 packages/extension/docs/extension_api.md                    | 6 ++++++
 .../src/pages/docs/features/chrome-extension/page.tsx       | 3 +++
 2 files changed, 9 insertions(+)

diff --git a/packages/extension/docs/extension_api.md b/packages/extension/docs/extension_api.md
index d49272d..d7dc902 100644
--- a/packages/extension/docs/extension_api.md
+++ b/packages/extension/docs/extension_api.md
@@ -121,6 +121,11 @@ export interface ExecuteConfig {
   // Include the initial tab where page JS starts. Default: true.
   includeInitialTab?: boolean
 
+  // Control all unpinned tabs in the window instead of only the tab group.
+  // When enabled, agent sees and can switch to every non-pinned tab.
+  // Default: false. Experimental.
+  experimentalIncludeAllTabs?: boolean
+
   onStatusChange?: (status: AgentStatus) => void
   onActivity?: (activity: AgentActivity) => void
   onHistoryUpdate?: (history: HistoricalEvent[]) => void
@@ -208,6 +213,7 @@ interface ExecuteConfig {
   model: string
   apiKey?: string
   includeInitialTab?: boolean
+  experimentalIncludeAllTabs?: boolean
   onStatusChange?: (status: AgentStatus) => void
   onActivity?: (activity: AgentActivity) => void
   onHistoryUpdate?: (history: HistoricalEvent[]) => void
diff --git a/packages/website/src/pages/docs/features/chrome-extension/page.tsx b/packages/website/src/pages/docs/features/chrome-extension/page.tsx
index b97f9d7..acee2a6 100644
--- a/packages/website/src/pages/docs/features/chrome-extension/page.tsx
+++ b/packages/website/src/pages/docs/features/chrome-extension/page.tsx
@@ -200,6 +200,7 @@ interface ExecuteConfig {
 	apiKey?: string   // LLM AK
 
 	includeInitialTab?: boolean
+	experimentalIncludeAllTabs?: boolean // Control all unpinned tabs in the window
 	onStatusChange?: (status: AgentStatus) => void
 	onActivity?: (activity: AgentActivity) => void
 	onHistoryUpdate?: (history: HistoricalEvent[]) => void
@@ -233,6 +234,7 @@ const result = await window.PAGE_AGENT_EXT.execute(
 		apiKey: 'your-api-key',
 		model: 'gpt-5.2',
 		// includeInitialTab: false, // 设为 false 排除初始标签页
+		// experimentalIncludeAllTabs: true, // 控制窗口内所有非固定标签页
 		onStatusChange: status => console.log('状态变化:', status),
 		onActivity: activity => console.log('活动:', activity),
 		onHistoryUpdate: history => console.log('历史更新:', history)
@@ -248,6 +250,7 @@ const result = await window.PAGE_AGENT_EXT.execute(
 		apiKey: 'your-api-key',
 		model: 'gpt-5.2',
 		// includeInitialTab: false, // Set to false to exclude initial tab
+		// experimentalIncludeAllTabs: true, // Control all unpinned tabs in the window
 		onStatusChange: status => console.log('Status change:', status),
 		onActivity: activity => console.log('Activity:', activity),
 		onHistoryUpdate: history => console.log('History update:', history)