@flrande/bak-extension 0.3.8 → 0.5.0

package/dist/.bak-e2e-build-stamp

@@ -1 +1 @@
-2026-03-09T16:21:56.905Z
+2026-03-11T07:35:54.292Z

package/dist/background.global.js

@@ -30,26 +30,79 @@
     return Math.min(maxDelayMs, baseDelayMs * 2 ** safeAttempt);
   }
 
+  // src/session-binding-storage.ts
+  var STORAGE_KEY_SESSION_BINDINGS = "sessionBindings";
+  var LEGACY_STORAGE_KEY_WORKSPACES = "agentWorkspaces";
+  var LEGACY_STORAGE_KEY_WORKSPACE = "agentWorkspace";
+  function isWorkspaceRecord(value) {
+    if (typeof value !== "object" || value === null) {
+      return false;
+    }
+    const candidate = value;
+    return typeof candidate.id === "string" && Array.isArray(candidate.tabIds) && (typeof candidate.windowId === "number" || candidate.windowId === null) && (typeof candidate.groupId === "number" || candidate.groupId === null) && (typeof candidate.activeTabId === "number" || candidate.activeTabId === null) && (typeof candidate.primaryTabId === "number" || candidate.primaryTabId === null);
+  }
+  function cloneWorkspaceRecord(state) {
+    return {
+      ...state,
+      tabIds: [...state.tabIds]
+    };
+  }
+  function normalizeWorkspaceRecordMap(value) {
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+      return {
+        found: false,
+        map: {}
+      };
+    }
+    const normalizedEntries = [];
+    for (const [workspaceId, entry] of Object.entries(value)) {
+      if (!isWorkspaceRecord(entry)) {
+        continue;
+      }
+      normalizedEntries.push([workspaceId, cloneWorkspaceRecord(entry)]);
+    }
+    return {
+      found: true,
+      map: Object.fromEntries(normalizedEntries)
+    };
+  }
+  function resolveSessionBindingStateMap(stored) {
+    const current = normalizeWorkspaceRecordMap(stored[STORAGE_KEY_SESSION_BINDINGS]);
+    if (current.found) {
+      return current.map;
+    }
+    const legacyMap = normalizeWorkspaceRecordMap(stored[LEGACY_STORAGE_KEY_WORKSPACES]);
+    if (legacyMap.found) {
+      return legacyMap.map;
+    }
+    const legacySingle = stored[LEGACY_STORAGE_KEY_WORKSPACE];
+    if (isWorkspaceRecord(legacySingle)) {
+      return {
+        [legacySingle.id]: cloneWorkspaceRecord(legacySingle)
+      };
+    }
+    return {};
+  }
+
   // src/workspace.ts
-  var DEFAULT_WORKSPACE_ID = "default";
   var DEFAULT_WORKSPACE_LABEL = "bak agent";
   var DEFAULT_WORKSPACE_COLOR = "blue";
   var DEFAULT_WORKSPACE_URL = "about:blank";
-  var WorkspaceManager = class {
+  var SessionBindingManager = class {
     storage;
     browser;
     constructor(storage, browser) {
       this.storage = storage;
       this.browser = browser;
     }
-    async getWorkspaceInfo(workspaceId = DEFAULT_WORKSPACE_ID) {
+    async getWorkspaceInfo(workspaceId) {
       return this.inspectWorkspace(workspaceId);
     }
     async ensureWorkspace(options = {}) {
       const workspaceId = this.normalizeWorkspaceId(options.workspaceId);
       const repairActions = [];
       const initialUrl = options.initialUrl ?? DEFAULT_WORKSPACE_URL;
-      const persisted = await this.storage.load();
+      const persisted = await this.storage.load(workspaceId);
       const created = !persisted;
       let state = this.normalizeState(persisted, workspaceId);
       const originalWindowId = state.windowId;
@@ -263,7 +316,7 @@
         tab
       };
     }
-    async listTabs(workspaceId = DEFAULT_WORKSPACE_ID) {
+    async listTabs(workspaceId) {
       const ensured = await this.inspectWorkspace(workspaceId);
       if (!ensured) {
         throw new Error(`Workspace ${workspaceId} does not exist`);
@@ -273,7 +326,7 @@
         tabs: ensured.tabs
       };
     }
-    async getActiveTab(workspaceId = DEFAULT_WORKSPACE_ID) {
+    async getActiveTab(workspaceId) {
       const ensured = await this.inspectWorkspace(workspaceId);
       if (!ensured) {
         const normalizedWorkspaceId = this.normalizeWorkspaceId(workspaceId);
@@ -290,7 +343,7 @@
         tab: ensured.tabs.find((tab) => tab.id === ensured.activeTabId) ?? null
       };
     }
-    async setActiveTab(tabId, workspaceId = DEFAULT_WORKSPACE_ID) {
+    async setActiveTab(tabId, workspaceId) {
       const ensured = await this.ensureWorkspace({ workspaceId });
       if (!ensured.workspace.tabIds.includes(tabId)) {
         throw new Error(`Tab ${tabId} does not belong to workspace ${workspaceId}`);
@@ -319,7 +372,7 @@
         tab
       };
     }
-    async focus(workspaceId = DEFAULT_WORKSPACE_ID) {
+    async focus(workspaceId) {
       const ensured = await this.ensureWorkspace({ workspaceId, focus: false });
       if (ensured.workspace.activeTabId !== null) {
         await this.browser.updateTab(ensured.workspace.activeTabId, { active: true });
@@ -331,16 +384,20 @@
       return { ok: true, workspace: refreshed.workspace };
     }
     async reset(options = {}) {
-      await this.close(options.workspaceId);
-      return this.ensureWorkspace(options);
+      const workspaceId = this.normalizeWorkspaceId(options.workspaceId);
+      await this.close(workspaceId);
+      return this.ensureWorkspace({
+        ...options,
+        workspaceId
+      });
     }
-    async close(workspaceId = DEFAULT_WORKSPACE_ID) {
-      const state = await this.storage.load();
-      if (!state || state.id !== workspaceId) {
-        await this.storage.save(null);
+    async close(workspaceId) {
+      const state = await this.loadWorkspaceRecord(workspaceId);
+      if (!state) {
+        await this.storage.delete(workspaceId);
         return { ok: true };
       }
-      await this.storage.save(null);
+      await this.storage.delete(workspaceId);
       if (state.windowId !== null) {
         const existingWindow = await this.browser.getWindow(state.windowId);
         if (existingWindow) {
@@ -366,19 +423,11 @@
       }
       const explicitWorkspaceId = typeof options.workspaceId === "string" ? this.normalizeWorkspaceId(options.workspaceId) : void 0;
       if (explicitWorkspaceId) {
-        const ensured2 = await this.ensureWorkspace({
+        const ensured = await this.ensureWorkspace({
           workspaceId: explicitWorkspaceId,
           focus: false
         });
-        return this.buildWorkspaceResolution(ensured2, "explicit-workspace");
-      }
-      const existingWorkspace = await this.loadWorkspaceRecord(DEFAULT_WORKSPACE_ID);
-      if (existingWorkspace) {
-        const ensured2 = await this.ensureWorkspace({
-          workspaceId: existingWorkspace.id,
-          focus: false
-        });
-        return this.buildWorkspaceResolution(ensured2, "default-workspace");
+        return this.buildWorkspaceResolution(ensured, "explicit-workspace");
       }
       if (options.createIfMissing !== true) {
         const activeTab = await this.browser.getActiveTab();
@@ -394,19 +443,12 @@
           repairActions: []
         };
       }
-      const ensured = await this.ensureWorkspace({
-        workspaceId: DEFAULT_WORKSPACE_ID,
-        focus: false
-      });
-      return this.buildWorkspaceResolution(ensured, "default-workspace");
+      throw new Error("workspaceId is required when createIfMissing is true");
     }
     normalizeWorkspaceId(workspaceId) {
       const candidate = workspaceId?.trim();
       if (!candidate) {
-        return DEFAULT_WORKSPACE_ID;
-      }
-      if (candidate !== DEFAULT_WORKSPACE_ID) {
-        throw new Error(`Unsupported workspace id: ${candidate}`);
+        throw new Error("workspaceId is required");
       }
       return candidate;
     }
@@ -422,9 +464,12 @@
         primaryTabId: state?.primaryTabId ?? null
       };
     }
-    async loadWorkspaceRecord(workspaceId = DEFAULT_WORKSPACE_ID) {
+    async listWorkspaceRecords() {
+      return await this.storage.list();
+    }
+    async loadWorkspaceRecord(workspaceId) {
       const normalizedWorkspaceId = this.normalizeWorkspaceId(workspaceId);
-      const state = await this.storage.load();
+      const state = await this.storage.load(normalizedWorkspaceId);
       if (!state || state.id !== normalizedWorkspaceId) {
         return null;
       }
@@ -659,7 +704,7 @@
       }
       throw lastError2 ?? new Error(`No window with id: ${options.windowId}.`);
     }
-    async inspectWorkspace(workspaceId = DEFAULT_WORKSPACE_ID) {
+    async inspectWorkspace(workspaceId) {
       const state = await this.loadWorkspaceRecord(workspaceId);
       if (!state) {
         return null;
@@ -755,7 +800,6 @@
   var STORAGE_KEY_TOKEN = "pairToken";
   var STORAGE_KEY_PORT = "cliPort";
   var STORAGE_KEY_DEBUG_RICH_TEXT = "debugRichText";
-  var STORAGE_KEY_WORKSPACE = "agentWorkspace";
   var DEFAULT_TAB_LOAD_TIMEOUT_MS = 4e4;
   var ws = null;
   var reconnectTimer = null;
@@ -817,6 +861,12 @@
     if (lower.includes("no tab with id") || lower.includes("no window with id")) {
       return toError("E_NOT_FOUND", message);
     }
+    if (lower.includes("workspace") && lower.includes("does not exist")) {
+      return toError("E_NOT_FOUND", message);
+    }
+    if (lower.includes("does not belong to workspace") || lower.includes("is missing from workspace")) {
+      return toError("E_NOT_FOUND", message);
+    }
     if (lower.includes("invalid url") || lower.includes("url is invalid")) {
       return toError("E_INVALID_PARAMS", message);
     }
@@ -838,20 +888,36 @@
       groupId: typeof tab.groupId === "number" && tab.groupId >= 0 ? tab.groupId : null
     };
   }
-  async function loadWorkspaceState() {
-    const stored = await chrome.storage.local.get(STORAGE_KEY_WORKSPACE);
-    const state = stored[STORAGE_KEY_WORKSPACE];
-    if (!state || typeof state !== "object") {
-      return null;
-    }
-    return state;
+  async function loadWorkspaceStateMap() {
+    const stored = await chrome.storage.local.get([
+      STORAGE_KEY_SESSION_BINDINGS,
+      LEGACY_STORAGE_KEY_WORKSPACES,
+      LEGACY_STORAGE_KEY_WORKSPACE
+    ]);
+    return resolveSessionBindingStateMap(stored);
+  }
+  async function loadWorkspaceState(workspaceId) {
+    const stateMap = await loadWorkspaceStateMap();
+    return stateMap[workspaceId] ?? null;
+  }
+  async function listWorkspaceStates() {
+    return Object.values(await loadWorkspaceStateMap());
   }
   async function saveWorkspaceState(state) {
-    if (state === null) {
-      await chrome.storage.local.remove(STORAGE_KEY_WORKSPACE);
+    const stateMap = await loadWorkspaceStateMap();
+    stateMap[state.id] = state;
+    await chrome.storage.local.set({ [STORAGE_KEY_SESSION_BINDINGS]: stateMap });
+    await chrome.storage.local.remove([LEGACY_STORAGE_KEY_WORKSPACES, LEGACY_STORAGE_KEY_WORKSPACE]);
+  }
+  async function deleteWorkspaceState(workspaceId) {
+    const stateMap = await loadWorkspaceStateMap();
+    delete stateMap[workspaceId];
+    if (Object.keys(stateMap).length === 0) {
+      await chrome.storage.local.remove([STORAGE_KEY_SESSION_BINDINGS, LEGACY_STORAGE_KEY_WORKSPACES, LEGACY_STORAGE_KEY_WORKSPACE]);
       return;
     }
-    await chrome.storage.local.set({ [STORAGE_KEY_WORKSPACE]: state });
+    await chrome.storage.local.set({ [STORAGE_KEY_SESSION_BINDINGS]: stateMap });
+    await chrome.storage.local.remove([LEGACY_STORAGE_KEY_WORKSPACES, LEGACY_STORAGE_KEY_WORKSPACE]);
   }
   var workspaceBrowser = {
     async getTab(tabId) {
@@ -983,10 +1049,12 @@
       };
     }
   };
-  var workspaceManager = new WorkspaceManager(
+  var bindingManager = new SessionBindingManager(
     {
       load: loadWorkspaceState,
-      save: saveWorkspaceState
+      save: saveWorkspaceState,
+      delete: deleteWorkspaceState,
+      list: listWorkspaceStates
     },
     workspaceBrowser
   );
@@ -1094,7 +1162,7 @@
     } catch {
       refreshedTab = await workspaceBrowser.getTab(opened.tab.id) ?? opened.tab;
     }
-    const refreshedWorkspace = await workspaceManager.getWorkspaceInfo(opened.workspace.id) ?? {
+    const refreshedWorkspace = await bindingManager.getWorkspaceInfo(opened.workspace.id) ?? {
       ...opened.workspace,
       tabs: opened.workspace.tabs.map((tab) => tab.id === refreshedTab.id ? refreshedTab : tab)
     };
@@ -1121,7 +1189,7 @@
       const tab2 = await chrome.tabs.get(target.tabId);
       return validate(tab2);
     }
-    const resolved = await workspaceManager.resolveTarget({
+    const resolved = await bindingManager.resolveTarget({
       tabId: target.tabId,
       workspaceId: typeof target.workspaceId === "string" ? target.workspaceId : void 0,
       createIfMissing: false
@@ -1254,6 +1322,8 @@
       "mouse.click",
       "mouse.wheel",
       "file.upload",
+      "context.get",
+      "context.set",
       "context.enterFrame",
       "context.exitFrame",
       "context.enterShadow",
@@ -1301,24 +1371,6 @@
         return { ok: true };
       }
       case "tabs.new": {
-        if (typeof params.workspaceId === "string" || params.windowId === void 0) {
-          const expectedUrl = params.url ?? "about:blank";
-          const opened = await preserveHumanFocus(true, async () => {
-            return await workspaceManager.openTab({
-              workspaceId: typeof params.workspaceId === "string" ? params.workspaceId : DEFAULT_WORKSPACE_ID,
-              url: expectedUrl,
-              active: params.active === true,
-              focus: false
-            });
-          });
-          const stabilized = await finalizeOpenedWorkspaceTab(opened, expectedUrl);
-          return {
-            tabId: stabilized.tab.id,
-            windowId: stabilized.tab.windowId,
-            groupId: stabilized.workspace.groupId,
-            workspaceId: stabilized.workspace.id
-          };
-        }
         const tab = await chrome.tabs.create({
           url: params.url ?? "about:blank",
           windowId: typeof params.windowId === "number" ? params.windowId : void 0,
@@ -1344,8 +1396,8 @@
       }
       case "workspace.ensure": {
         return preserveHumanFocus(params.focus !== true, async () => {
-          return await workspaceManager.ensureWorkspace({
-            workspaceId: typeof params.workspaceId === "string" ? params.workspaceId : void 0,
+          return await bindingManager.ensureWorkspace({
+            workspaceId: String(params.workspaceId ?? ""),
             focus: params.focus === true,
             initialUrl: typeof params.url === "string" ? params.url : void 0
           });
@@ -1353,14 +1405,14 @@
       }
       case "workspace.info": {
         return {
-          workspace: await workspaceManager.getWorkspaceInfo(typeof params.workspaceId === "string" ? params.workspaceId : void 0)
+          workspace: await bindingManager.getWorkspaceInfo(String(params.workspaceId ?? ""))
         };
       }
       case "workspace.openTab": {
         const expectedUrl = typeof params.url === "string" ? params.url : void 0;
         const opened = await preserveHumanFocus(params.focus !== true, async () => {
-          return await workspaceManager.openTab({
-            workspaceId: typeof params.workspaceId === "string" ? params.workspaceId : void 0,
+          return await bindingManager.openTab({
+            workspaceId: String(params.workspaceId ?? ""),
             url: expectedUrl,
             active: params.active === true,
             focus: params.focus === true
@@ -1369,28 +1421,28 @@
         return await finalizeOpenedWorkspaceTab(opened, expectedUrl);
       }
       case "workspace.listTabs": {
-        return await workspaceManager.listTabs(typeof params.workspaceId === "string" ? params.workspaceId : void 0);
+        return await bindingManager.listTabs(String(params.workspaceId ?? ""));
       }
       case "workspace.getActiveTab": {
-        return await workspaceManager.getActiveTab(typeof params.workspaceId === "string" ? params.workspaceId : void 0);
+        return await bindingManager.getActiveTab(String(params.workspaceId ?? ""));
       }
       case "workspace.setActiveTab": {
-        return await workspaceManager.setActiveTab(Number(params.tabId), typeof params.workspaceId === "string" ? params.workspaceId : void 0);
+        return await bindingManager.setActiveTab(Number(params.tabId), String(params.workspaceId ?? ""));
       }
       case "workspace.focus": {
-        return await workspaceManager.focus(typeof params.workspaceId === "string" ? params.workspaceId : void 0);
+        return await bindingManager.focus(String(params.workspaceId ?? ""));
       }
       case "workspace.reset": {
         return await preserveHumanFocus(params.focus !== true, async () => {
-          return await workspaceManager.reset({
-            workspaceId: typeof params.workspaceId === "string" ? params.workspaceId : void 0,
+          return await bindingManager.reset({
+            workspaceId: String(params.workspaceId ?? ""),
             focus: params.focus === true,
             initialUrl: typeof params.url === "string" ? params.url : void 0
           });
         });
       }
       case "workspace.close": {
-        return await workspaceManager.close(typeof params.workspaceId === "string" ? params.workspaceId : void 0);
+        return await bindingManager.close(String(params.workspaceId ?? ""));
       }
       case "page.goto": {
         return await preserveHumanFocus(typeof target.tabId !== "number", async () => {
@@ -1619,7 +1671,7 @@
       ws?.send(JSON.stringify({
         type: "hello",
         role: "extension",
-        version: "0.3.8",
+        version: "0.5.0",
         ts: Date.now()
       }));
     });
@@ -1654,43 +1706,49 @@
     });
   }
   chrome.tabs.onRemoved.addListener((tabId) => {
-    void loadWorkspaceState().then(async (state) => {
-      if (!state || !state.tabIds.includes(tabId)) {
-        return;
+    void listWorkspaceStates().then(async (states) => {
+      for (const state of states) {
+        if (!state.tabIds.includes(tabId)) {
+          continue;
+        }
+        const nextTabIds = state.tabIds.filter((id) => id !== tabId);
+        await saveWorkspaceState({
+          ...state,
+          tabIds: nextTabIds,
+          activeTabId: state.activeTabId === tabId ? null : state.activeTabId,
+          primaryTabId: state.primaryTabId === tabId ? null : state.primaryTabId
+        });
       }
-      const nextTabIds = state.tabIds.filter((id) => id !== tabId);
-      await saveWorkspaceState({
-        ...state,
-        tabIds: nextTabIds,
-        activeTabId: state.activeTabId === tabId ? null : state.activeTabId,
-        primaryTabId: state.primaryTabId === tabId ? null : state.primaryTabId
-      });
     });
   });
   chrome.tabs.onActivated.addListener((activeInfo) => {
-    void loadWorkspaceState().then(async (state) => {
-      if (!state || state.windowId !== activeInfo.windowId || !state.tabIds.includes(activeInfo.tabId)) {
-        return;
+    void listWorkspaceStates().then(async (states) => {
+      for (const state of states) {
+        if (state.windowId !== activeInfo.windowId || !state.tabIds.includes(activeInfo.tabId)) {
+          continue;
+        }
+        await saveWorkspaceState({
+          ...state,
+          activeTabId: activeInfo.tabId
+        });
       }
-      await saveWorkspaceState({
-        ...state,
-        activeTabId: activeInfo.tabId
-      });
     });
   });
   chrome.windows.onRemoved.addListener((windowId) => {
-    void loadWorkspaceState().then(async (state) => {
-      if (!state || state.windowId !== windowId) {
-        return;
+    void listWorkspaceStates().then(async (states) => {
+      for (const state of states) {
+        if (state.windowId !== windowId) {
+          continue;
+        }
+        await saveWorkspaceState({
+          ...state,
+          windowId: null,
+          groupId: null,
+          tabIds: [],
+          activeTabId: null,
+          primaryTabId: null
+        });
       }
-      await saveWorkspaceState({
-        ...state,
-        windowId: null,
-        groupId: null,
-        tabIds: [],
-        activeTabId: null,
-        primaryTabId: null
-      });
     });
   });
   chrome.runtime.onInstalled.addListener(() => {

package/dist/content.global.js

@@ -1962,6 +1962,35 @@
         dispatchInputEvents(target);
         return { ok: true, fileCount: transfer.files.length };
       }
+      case "context.get":
+        return {
+          ok: true,
+          frameDepth: contextState.framePath.length,
+          shadowDepth: contextState.shadowPath.length,
+          framePath: [...contextState.framePath],
+          shadowPath: [...contextState.shadowPath]
+        };
+      case "context.set": {
+        const framePath = Array.isArray(params.framePath) ? params.framePath.map(String) : [];
+        const shadowPath = Array.isArray(params.shadowPath) ? params.shadowPath.map(String) : [];
+        const frameResult = resolveFrameDocument(framePath);
+        if (!frameResult.ok) {
+          throw frameResult.error;
+        }
+        const shadowResult = resolveShadowRoot(frameResult.document, shadowPath);
+        if (!shadowResult.ok) {
+          throw shadowResult.error;
+        }
+        contextState.framePath = framePath;
+        contextState.shadowPath = shadowPath;
+        return {
+          ok: true,
+          frameDepth: contextState.framePath.length,
+          shadowDepth: contextState.shadowPath.length,
+          framePath: [...contextState.framePath],
+          shadowPath: [...contextState.shadowPath]
+        };
+      }
       case "context.enterFrame": {
         if (params.reset === true) {
           contextState.framePath = [];

package/dist/manifest.json

@@ -1,7 +1,7 @@
 {
   "manifest_version": 3,
   "name": "Browser Agent Kit",
-  "version": "0.3.8",
+  "version": "0.5.0",
   "action": {
     "default_popup": "popup.html"
   },

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "@flrande/bak-extension",
-  "version": "0.3.8",
+  "version": "0.5.0",
   "type": "module",
   "dependencies": {
-    "@flrande/bak-protocol": "0.3.8"
+    "@flrande/bak-protocol": "0.5.0"
   },
   "devDependencies": {
     "@types/chrome": "^0.1.14",

package/public/manifest.json

@@ -1,7 +1,7 @@
 {
   "manifest_version": 3,
   "name": "Browser Agent Kit",
-  "version": "0.3.8",
+  "version": "0.5.0",
   "action": {
     "default_popup": "popup.html"
   },