From 321acf9dbcf71f20b93c7c5372942961845deb2b Mon Sep 17 00:00:00 2001
From: "Tommy D. Rossi" <beats.by.morse@gmail.com>
Date: Wed, 4 Feb 2026 17:24:36 +0100
Subject: [PATCH] Update ghost-browser-api.d.ts

---
 extension/src/ghost-browser-api.d.ts | 10 +++++++++-
 1 file changed, 9 insertions(+), 1 deletion(-)

diff --git a/extension/src/ghost-browser-api.d.ts b/extension/src/ghost-browser-api.d.ts
index 5d526e7..ac1e299 100644
--- a/extension/src/ghost-browser-api.d.ts
+++ b/extension/src/ghost-browser-api.d.ts
@@ -37,7 +37,7 @@
  * ## API Namespaces
  *
  * - `chrome.ghostPublicAPI` - Open tabs in specific identities
- * - `chrome.ghostProxies` - Manage and assign proxies per tab/identity/session
+ * - `chrome.ghostProxies` - Manage and assign proxies per tab/identity/session (Pro plan only)
  * - `chrome.projects` - List/manage identities, sessions, workspaces
  *
  * ## Use Cases
@@ -47,6 +47,13 @@
  * - Testing with different user sessions simultaneously
  * - Automation requiring isolated cookies/storage per identity
  *
+ * ## Plan Requirements
+ *
+ * - `chrome.ghostPublicAPI` and `chrome.projects` - All plans (including Free)
+ * - `chrome.ghostProxies` methods - **Pro plan required** ($46/mo). Free plan only exposes
+ *   constants (DIRECT_PROXY, SYSTEM_PROXY). Methods like getList(), add(), setTabProxy()
+ *   throw "permission" error on Free/Basic plans.
+ *
  * Note: These APIs only work in Ghost Browser. In regular Chrome, calls fail with "not available".
  */
 
@@ -94,6 +101,7 @@ declare namespace chrome {
 
   // ============================================================================
   // GHOST PROXIES API (chrome.ghostProxies)
+  // **Requires Ghost Browser Pro plan.** Free/Basic plans only have constants.
   // ============================================================================
 
   export namespace ghostProxies {